diff --git a/pr-2241/CMakeLists.txt b/pr-2241/CMakeLists.txt
new file mode 100644
index 0000000000..06199626e0
--- /dev/null
+++ b/pr-2241/CMakeLists.txt
@@ -0,0 +1,161 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# Add nvq++ compile + execution test of code examples
+# Args:
+#   TEST_NAME: name of the test executable. Test name is prefixed with "nvqpp"
+#   SOURCE_LOCATION: location of the source file (relative to 'sphinx/examples/cpp' directory by default) 
+# Optional keyword args:
+#   TARGET <TARGET_NAME>: name of the target to use
+#   TARGET_OPTION <Option>: extra option for the target
+#   SOURCE_DIR <DIR>: the directory that SOURCE_LOCATION is relative to (if not the default)
+#   LAUNCH_COMMAND <COMMAND>: the command to launch the test (e.g., mpirun)
+function(add_nvqpp_test TEST_NAME SOURCE_LOCATION)
+  cmake_parse_arguments(PARSED_ARGS "" "TARGET;LABELS;SOURCE_DIR;LAUNCH_COMMAND;APPLICATION_ARGS;TARGET_OPTION" "" ${ARGN}) 
+  set(NVQPP_COMPILE_ARGS "")
+  if(PARSED_ARGS_TARGET)
+    set(NVQPP_COMPILE_ARGS "${NVQPP_COMPILE_ARGS} --target ${PARSED_ARGS_TARGET}")
+    if (PARSED_ARGS_TARGET_OPTION)
+      set(NVQPP_COMPILE_ARGS "${NVQPP_COMPILE_ARGS} --${PARSED_ARGS_TARGET}-option ${PARSED_ARGS_TARGET_OPTION}")
+    endif()
+  endif()
+  if (NOT PARSED_ARGS_SOURCE_DIR)
+    set(PARSED_ARGS_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/sphinx/examples/cpp")
+  endif()
+  add_test(
+  NAME
+    nvqpp_${TEST_NAME}
+  COMMAND
+    bash -c "rm -f ${TEST_NAME}; ${CMAKE_BINARY_DIR}/bin/nvq++ ${NVQPP_COMPILE_ARGS} ${PARSED_ARGS_SOURCE_DIR}/${SOURCE_LOCATION} -o ${TEST_NAME} && \
+              ${PARSED_ARGS_LAUNCH_COMMAND} ${CMAKE_CURRENT_BINARY_DIR}/${TEST_NAME} ${PARSED_ARGS_APPLICATION_ARGS}"
+  )
+  if(PARSED_ARGS_LABELS)
+    set_tests_properties(nvqpp_${TEST_NAME} PROPERTIES LABELS "${PARSED_ARGS_LABELS}")
+  endif()
+endfunction()
+
+add_nvqpp_test(GHZ basics/static_kernel.cpp)
+add_nvqpp_test(MultiControlOps basics/multi_controlled_operations.cpp)
+add_nvqpp_test(ExpVals basics/expectation_values.cpp)
+add_nvqpp_test(MidCircuitMeasurements basics/mid_circuit_measurement.cpp)
+add_nvqpp_test(PhaseEstimation algorithms/phase_estimation.cpp)
+add_nvqpp_test(Grover algorithms/grover.cpp)
+add_nvqpp_test(QAOA algorithms/qaoa_maxcut.cpp)
+add_nvqpp_test(VQEH2 algorithms/vqe_h2.cpp)
+add_nvqpp_test(AmplitudeEstimation algorithms/amplitude_estimation.cpp)
+add_nvqpp_test(Builder other/builder/builder.cpp)
+add_nvqpp_test(QAOABuilder other/builder/qaoa_maxcut_builder.cpp)
+add_nvqpp_test(VQEH2Builder other/builder/vqe_h2_builder.cpp)
+add_nvqpp_test(ComputeAction other/compute_actions.cpp)
+add_nvqpp_test(Gradients other/gradients.cpp)
+add_nvqpp_test(IterativePhaseEstimation other/iterative_qpe.cpp)
+add_nvqpp_test(RandomWalkPhaseEstimation other/random_walk_qpe.cpp)
+
+if (CUSTATEVEC_ROOT AND CUDA_FOUND) 
+  add_nvqpp_test(CuQuantumGHZ basics/cuquantum_backends.cpp TARGET nvidia LABELS gpu_required)  
+  add_nvqpp_test(CuQuantumBernsteinVazirani algorithms/bernstein_vazirani.cpp TARGET nvidia LABELS gpu_required)  
+endif()
+
+# code snippets in docs
+add_nvqpp_test(QuickStart_default quick_start.cpp SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+add_nvqpp_test(FirstObserve using/first_observe.cpp SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+add_nvqpp_test(FirstSample using/first_sample.cpp SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+add_nvqpp_test(Timing using/time.cpp SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp APPLICATION_ARGS "10")
+
+set(NGPUS 0)
+if (CUSTATEVEC_ROOT AND CUDA_FOUND) 
+  add_nvqpp_test(QuickStart_nvidia quick_start.cpp TARGET nvidia LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+
+  # mqpu snippets need custatevec backend and optionally MPI
+  add_nvqpp_test(SampleAsync using/cudaq/platform/sample_async.cpp TARGET nvidia TARGET_OPTION mqpu LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+  add_nvqpp_test(ObserveMQPU using/cudaq/platform/observe_mqpu.cpp TARGET nvidia TARGET_OPTION mqpu LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+  add_nvqpp_test(StateAsyncMQPU using/cudaq/platform/get_state_async.cpp TARGET nvidia TARGET_OPTION mqpu LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+
+  # Legacy check for the `nvidia-mqpu` target
+  add_nvqpp_test(LegacySampleAsync using/cudaq/platform/sample_async.cpp TARGET nvidia-mqpu LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+  add_nvqpp_test(LegacyObserveMQPU using/cudaq/platform/observe_mqpu.cpp TARGET nvidia-mqpu LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+  add_nvqpp_test(LegacyStateAsyncMQPU using/cudaq/platform/get_state_async.cpp TARGET nvidia-mqpu LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+
+  # Add the MPI test if MPI was found and there are more than 2 GPUs
+  if (MPI_CXX_FOUND)
+    # Count the number of GPUs
+    find_program(NVIDIA_SMI "nvidia-smi")
+    if(NVIDIA_SMI)
+      execute_process(COMMAND bash -c "nvidia-smi --list-gpus | wc -l" OUTPUT_VARIABLE NGPUS)
+      # Only build this test if we have more than 1 GPU
+      if (${NGPUS} GREATER_EQUAL 2)
+        add_nvqpp_test(ObserveMQPU_MPI using/cudaq/platform/observe_mqpu_mpi.cpp
+                        TARGET nvidia 
+                        TARGET_OPTION mqpu 
+                        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp 
+                        LAUNCH_COMMAND "${MPIEXEC} --allow-run-as-root -np 2")
+        add_nvqpp_test(LegacyObserveMQPU_MPI using/cudaq/platform/observe_mqpu_mpi.cpp
+                        TARGET nvidia-mqpu 
+                        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp 
+                        LAUNCH_COMMAND "${MPIEXEC} --allow-run-as-root -np 2")
+      endif()
+    endif(NVIDIA_SMI)  
+  endif()   
+endif()
+
+add_nvqpp_test(photonics_sim providers/photonics.cpp TARGET photonics)
+add_nvqpp_test(SampleAsyncRemote using/cudaq/platform/sample_async_remote.cpp TARGET remote-mqpu SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/cpp)
+set_tests_properties(
+  nvqpp_SampleAsyncRemote
+    PROPERTIES
+      ENVIRONMENT_MODIFICATION PATH=path_list_append:${CMAKE_BINARY_DIR}/bin
+)
+
+# Only add the python tests if we built the python API
+if (CUDAQ_ENABLE_PYTHON)
+  function(add_pycudaq_test TEST_NAME SOURCE_LOCATION)
+    cmake_parse_arguments(PARSED_ARGS "" "LABELS;SOURCE_DIR;LAUNCH_COMMAND" "" ${ARGN}) 
+    if (NOT PARSED_ARGS_SOURCE_DIR)
+      set(PARSED_ARGS_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/sphinx/examples/python")
+    endif()
+    add_test(
+    NAME
+      pycudaq_${TEST_NAME}
+    COMMAND
+      bash -c "${PARSED_ARGS_LAUNCH_COMMAND} ${Python_EXECUTABLE} ${PARSED_ARGS_SOURCE_DIR}/${SOURCE_LOCATION}"
+    )
+    set_tests_properties(pycudaq_${TEST_NAME} PROPERTIES ENVIRONMENT "PYTHONPATH=${CMAKE_BINARY_DIR}/python")
+    if(PARSED_ARGS_LABELS)
+      set_tests_properties(pycudaq_${TEST_NAME} PROPERTIES LABELS "${PARSED_ARGS_LABELS}")
+    endif()
+  endfunction()
+
+  add_pycudaq_test(Intro intro.py)
+  add_pycudaq_test(BernsteinVazirani bernstein_vazirani.py)
+  add_pycudaq_test(QAOA qaoa_maxcut.py)
+  add_pycudaq_test(VQE simple_vqe.py)
+  add_pycudaq_test(VQEAdvanced advanced_vqe.py)
+
+  add_pycudaq_test(AmplitudeDampingNoise noise_amplitude_damping.py)
+  add_pycudaq_test(BitFlipNoise noise_bit_flip.py)
+  add_pycudaq_test(DepolarizingNoise noise_depolarization.py)
+  add_pycudaq_test(PhaseFlipNoise noise_phase_flip.py)
+  add_pycudaq_test(KrausNoise noise_kraus_operator.py)
+  add_pycudaq_test(NoiseCallback noise_callback.py)
+  
+  if (CUTENSORNET_ROOT AND CUDA_FOUND) 
+    # This example uses tensornet backend.
+    add_pycudaq_test(SampleAsyncRemote using/cudaq/platform/sample_async_remote.py SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/python)
+  endif()
+  
+  if (CUSTATEVEC_ROOT AND CUDA_FOUND) 
+    add_pycudaq_test(SampleAsync using/cudaq/platform/sample_async.py LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/python)
+    add_pycudaq_test(ObserveMQPU using/cudaq/platform/observe_mqpu.py LABELS gpu_required SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/python)
+    if (MPI_CXX_FOUND AND ${NGPUS} GREATER_EQUAL 2)
+      add_pycudaq_test(ObserveMQPU_MPI using/cudaq/platform/observe_mqpu_mpi.py 
+                        LABELS "gpu_required;mgpus_required"
+                        SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/sphinx/snippets/python
+                        LAUNCH_COMMAND "${MPIEXEC} --allow-run-as-root -np 2")
+    endif()
+  endif()
+endif()
diff --git a/pr-2241/Doxyfile.in b/pr-2241/Doxyfile.in
new file mode 100644
index 0000000000..8fa75de397
--- /dev/null
+++ b/pr-2241/Doxyfile.in
@@ -0,0 +1,2704 @@
+# Doxyfile 1.9.7
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project.
+#
+# All text after a double hash (##) is considered a comment and is placed in
+# front of the TAG it is preceding.
+#
+# All text after a single hash (#) is considered a comment and will be ignored.
+# The format is:
+# TAG = value [value, ...]
+# For lists, items can also be appended using:
+# TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (\" \").
+#
+# Note:
+#
+# Use doxygen to compare the used configuration file with the template
+# configuration file:
+# doxygen -x [configFile]
+# Use doxygen to compare the used configuration file with the template
+# configuration file without replacing the environment variables or CMake type
+# replacement variables:
+# doxygen -x_noenv [configFile]
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# This tag specifies the encoding used for all characters in the configuration
+# file that follow. The default is UTF-8 which is also the encoding used for all
+# text before the first occurrence of this tag. Doxygen uses libiconv (or the
+# iconv built into libc) for the transcoding. See
+# https://www.gnu.org/software/libiconv/ for the list of possible encodings.
+# The default value is: UTF-8.
+
+DOXYFILE_ENCODING      = UTF-8
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded by
+# double-quotes, unless you are using Doxywizard) that should identify the
+# project for which the documentation is generated. This name is used in the
+# title of most generated pages and in a few other places.
+# The default value is: My Project.
+
+PROJECT_NAME           = "CUDA-Q"
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number. This
+# could be handy for archiving the generated documentation or if some version
+# control system is used.
+
+PROJECT_NUMBER         =
+
+# Using the PROJECT_BRIEF tag one can provide an optional one line description
+# for a project that appears at the top of each page and should give viewer a
+# quick idea about the purpose of the project. Keep the description short.
+
+PROJECT_BRIEF          =
+
+# With the PROJECT_LOGO tag one can specify a logo or an icon that is included
+# in the documentation. The maximum height of the logo should not exceed 55
+# pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
+# the logo to the output directory.
+
+PROJECT_LOGO           =
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
+# into which the generated documentation will be written. If a relative path is
+# entered, it will be relative to the location where doxygen was started. If
+# left blank the current directory will be used.
+
+OUTPUT_DIRECTORY       = "${DOXYGEN_OUTPUT_PREFIX}"
+
+# If the CREATE_SUBDIRS tag is set to YES then doxygen will create up to 4096
+# sub-directories (in 2 levels) under the output directory of each output format
+# and will distribute the generated files over these directories. Enabling this
+# option can be useful when feeding doxygen a huge amount of source files, where
+# putting all generated files in the same directory would otherwise causes
+# performance problems for the file system. Adapt CREATE_SUBDIRS_LEVEL to
+# control the number of sub-directories.
+# The default value is: NO.
+
+CREATE_SUBDIRS         = NO
+
+# Controls the number of sub-directories that will be created when
+# CREATE_SUBDIRS tag is set to YES. Level 0 represents 16 directories, and every
+# level increment doubles the number of directories, resulting in 4096
+# directories at level 8 which is the default and also the maximum value. The
+# sub-directories are organized in 2 levels, the first level always has a fixed
+# number of 16 directories.
+# Minimum value: 0, maximum value: 8, default value: 8.
+# This tag requires that the tag CREATE_SUBDIRS is set to YES.
+
+CREATE_SUBDIRS_LEVEL   = 8
+
+# If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII
+# characters to appear in the names of generated files. If set to NO, non-ASCII
+# characters will be escaped, for example _xE3_x81_x84 will be used for Unicode
+# U+3044.
+# The default value is: NO.
+
+ALLOW_UNICODE_NAMES    = NO
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all
+# documentation generated by doxygen is written. Doxygen will use this
+# information to generate all constant output in the proper language.
+# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Bulgarian,
+# Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, Dutch, English
+# (United States), Esperanto, Farsi (Persian), Finnish, French, German, Greek,
+# Hindi, Hungarian, Indonesian, Italian, Japanese, Japanese-en (Japanese with
+# English messages), Korean, Korean-en (Korean with English messages), Latvian,
+# Lithuanian, Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese,
+# Romanian, Russian, Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish,
+# Swedish, Turkish, Ukrainian and Vietnamese.
+# The default value is: English.
+
+OUTPUT_LANGUAGE        = English
+
+# If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member
+# descriptions after the members that are listed in the file and class
+# documentation (similar to Javadoc). Set to NO to disable this.
+# The default value is: YES.
+
+BRIEF_MEMBER_DESC      = YES
+
+# If the REPEAT_BRIEF tag is set to YES, doxygen will prepend the brief
+# description of a member or function before the detailed description
+#
+# Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
+# brief descriptions will be completely suppressed.
+# The default value is: YES.
+
+REPEAT_BRIEF           = YES
+
+# This tag implements a quasi-intelligent brief description abbreviator that is
+# used to form the text in various listings. Each string in this list, if found
+# as the leading text of the brief description, will be stripped from the text
+# and the result, after processing the whole list, is used as the annotated
+# text. Otherwise, the brief description is used as-is. If left blank, the
+# following values are used ($name is automatically replaced with the name of
+# the entity):The $name class, The $name widget, The $name file, is, provides,
+# specifies, contains, represents, a, an and the.
+
+ABBREVIATE_BRIEF       = "The $name class" \
+                         "The $name widget" \
+                         "The $name file" \
+                         is \
+                         provides \
+                         specifies \
+                         contains \
+                         represents \
+                         a \
+                         an \
+                         the
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
+# doxygen will generate a detailed section even if there is only a brief
+# description.
+# The default value is: NO.
+
+ALWAYS_DETAILED_SEC    = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
+# inherited members of a class in the documentation of that class as if those
+# members were ordinary class members. Constructors, destructors and assignment
+# operators of the base classes will not be shown.
+# The default value is: NO.
+
+INLINE_INHERITED_MEMB  = NO
+
+# If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path
+# before files name in the file list and in the header files. If set to NO the
+# shortest path that makes the file name unique will be used
+# The default value is: YES.
+
+FULL_PATH_NAMES        = YES
+
+# The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.
+# Stripping is only done if one of the specified strings matches the left-hand
+# part of the path. The tag can be used to show relative paths in the file list.
+# If left blank the directory from which doxygen is run is used as the path to
+# strip.
+#
+# Note that you can specify absolute paths here, but also relative paths, which
+# will be relative from the directory where doxygen is started.
+# This tag requires that the tag FULL_PATH_NAMES is set to YES.
+
+STRIP_FROM_PATH        =
+
+# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the
+# path mentioned in the documentation of a class, which tells the reader which
+# header file to include in order to use a class. If left blank only the name of
+# the header file containing the class definition is used. Otherwise one should
+# specify the list of include paths that are normally passed to the compiler
+# using the -I flag.
+
+STRIP_FROM_INC_PATH    =
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
+# less readable) file names. This can be useful is your file systems doesn't
+# support long names like on DOS, Mac, or CD-ROM.
+# The default value is: NO.
+
+SHORT_NAMES            = NO
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
+# first line (until the first dot) of a Javadoc-style comment as the brief
+# description. If set to NO, the Javadoc-style will behave just like regular Qt-
+# style comments (thus requiring an explicit @brief command for a brief
+# description.)
+# The default value is: NO.
+
+JAVADOC_AUTOBRIEF      = NO
+
+# If the JAVADOC_BANNER tag is set to YES then doxygen will interpret a line
+# such as
+# /***************
+# as being the beginning of a Javadoc-style comment "banner". If set to NO, the
+# Javadoc-style will behave just like regular comments and it will not be
+# interpreted by doxygen.
+# The default value is: NO.
+
+JAVADOC_BANNER         = NO
+
+# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
+# line (until the first dot) of a Qt-style comment as the brief description. If
+# set to NO, the Qt-style will behave just like regular Qt-style comments (thus
+# requiring an explicit \brief command for a brief description.)
+# The default value is: NO.
+
+QT_AUTOBRIEF           = NO
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
+# multi-line C++ special comment block (i.e. a block of //! or /// comments) as
+# a brief description. This used to be the default behavior. The new default is
+# to treat a multi-line C++ comment block as a detailed description. Set this
+# tag to YES if you prefer the old behavior instead.
+#
+# Note that setting this tag to YES also means that rational rose comments are
+# not recognized any more.
+# The default value is: NO.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# By default Python docstrings are displayed as preformatted text and doxygen's
+# special commands cannot be used. By setting PYTHON_DOCSTRING to NO the
+# doxygen's special commands can be used and the contents of the docstring
+# documentation blocks is shown as doxygen documentation.
+# The default value is: YES.
+
+PYTHON_DOCSTRING       = YES
+
+# If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
+# documentation from any documented member that it re-implements.
+# The default value is: YES.
+
+INHERIT_DOCS           = YES
+
+# If the SEPARATE_MEMBER_PAGES tag is set to YES then doxygen will produce a new
+# page for each member. If set to NO, the documentation of a member will be part
+# of the file/class/namespace that contains it.
+# The default value is: NO.
+
+SEPARATE_MEMBER_PAGES  = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
+# uses this value to replace tabs by spaces in code fragments.
+# Minimum value: 1, maximum value: 16, default value: 4.
+
+TAB_SIZE               = 4
+
+# This tag can be used to specify a number of aliases that act as commands in
+# the documentation. An alias has the form:
+# name=value
+# For example adding
+# "sideeffect=@par Side Effects:^^"
+# will allow you to put the command \sideeffect (or @sideeffect) in the
+# documentation, which will result in a user-defined paragraph with heading
+# "Side Effects:". Note that you cannot put \n's in the value part of an alias
+# to insert newlines (in the resulting output). You can put ^^ in the value part
+# of an alias to insert a newline as if a physical newline was in the original
+# file. When you need a literal { or } or , in the value part of an alias you
+# have to escape them by means of a backslash (\), this can lead to conflicts
+# with the commands \{ and \} for these it is advised to use the version @{ and
+# @} or use a double escape (\\{ and \\})
+
+ALIASES                =
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
+# only. Doxygen will then generate output that is more tailored for C. For
+# instance, some of the names that are used will be different. The list of all
+# members will be omitted, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_FOR_C  = YES
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or
+# Python sources only. Doxygen will then generate output that is more tailored
+# for that language. For instance, namespaces will be presented as packages,
+# qualified scopes will look different, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_JAVA   = NO
+
+# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
+# sources. Doxygen will then generate output that is tailored for Fortran.
+# The default value is: NO.
+
+OPTIMIZE_FOR_FORTRAN   = NO
+
+# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
+# sources. Doxygen will then generate output that is tailored for VHDL.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_VHDL   = NO
+
+# Set the OPTIMIZE_OUTPUT_SLICE tag to YES if your project consists of Slice
+# sources only. Doxygen will then generate output that is more tailored for that
+# language. For instance, namespaces will be presented as modules, types will be
+# separated into more groups, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_SLICE  = NO
+
+# Doxygen selects the parser to use depending on the extension of the files it
+# parses. With this tag you can assign which parser to use for a given
+# extension. Doxygen has a built-in mapping, but you can override or extend it
+# using this tag. The format is ext=language, where ext is a file extension, and
+# language is one of the parsers supported by doxygen: IDL, Java, JavaScript,
+# Csharp (C#), C, C++, Lex, D, PHP, md (Markdown), Objective-C, Python, Slice,
+# VHDL, Fortran (fixed format Fortran: FortranFixed, free formatted Fortran:
+# FortranFree, unknown formatted Fortran: Fortran. In the later case the parser
+# tries to guess whether the code is fixed or free formatted code, this is the
+# default for Fortran type files). For instance to make doxygen treat .inc files
+# as Fortran files (default is PHP), and .f files as C (default is Fortran),
+# use: inc=Fortran f=C.
+#
+# Note: For files without extension you can use no_extension as a placeholder.
+#
+# Note that for custom extensions you also need to set FILE_PATTERNS otherwise
+# the files are not read by doxygen. When specifying no_extension you should add
+# * to the FILE_PATTERNS.
+#
+# Note see also the list of default file extension mappings.
+
+EXTENSION_MAPPING      =
+
+# If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
+# according to the Markdown format, which allows for more readable
+# documentation. See https://daringfireball.net/projects/markdown/ for details.
+# The output of markdown processing is further processed by doxygen, so you can
+# mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
+# case of backward compatibilities issues.
+# The default value is: YES.
+
+MARKDOWN_SUPPORT       = YES
+
+# When the TOC_INCLUDE_HEADINGS tag is set to a non-zero value, all headings up
+# to that level are automatically included in the table of contents, even if
+# they do not have an id attribute.
+# Note: This feature currently applies only to Markdown headings.
+# Minimum value: 0, maximum value: 99, default value: 5.
+# This tag requires that the tag MARKDOWN_SUPPORT is set to YES.
+
+TOC_INCLUDE_HEADINGS   = 3
+
+# When enabled doxygen tries to link words that correspond to documented
+# classes, or namespaces to their corresponding documentation. Such a link can
+# be prevented in individual cases by putting a % sign in front of the word or
+# globally by setting AUTOLINK_SUPPORT to NO.
+# The default value is: YES.
+
+AUTOLINK_SUPPORT       = YES
+
+# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
+# to include (a tag file for) the STL sources as input, then you should set this
+# tag to YES in order to let doxygen match functions declarations and
+# definitions whose arguments contain STL classes (e.g. func(std::string);
+# versus func(std::string) {}). This also make the inheritance and collaboration
+# diagrams that involve STL classes more complete and accurate.
+# The default value is: NO.
+
+BUILTIN_STL_SUPPORT    = NO
+
+# If you use Microsoft's C++/CLI language, you should set this option to YES to
+# enable parsing support.
+# The default value is: NO.
+
+CPP_CLI_SUPPORT        = NO
+
+# Set the SIP_SUPPORT tag to YES if your project consists of sip (see:
+# https://www.riverbankcomputing.com/software/sip/intro) sources only. Doxygen
+# will parse them like normal C++ but will assume all classes use public instead
+# of private inheritance when no explicit protection keyword is present.
+# The default value is: NO.
+
+SIP_SUPPORT            = NO
+
+# For Microsoft's IDL there are propget and propput attributes to indicate
+# getter and setter methods for a property. Setting this option to YES will make
+# doxygen to replace the get and set methods by a property in the documentation.
+# This will only work if the methods are indeed getting or setting a simple
+# type. If this is not the case, or you want to show the methods anyway, you
+# should set this option to NO.
+# The default value is: YES.
+
+IDL_PROPERTY_SUPPORT   = YES
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
+# tag is set to YES then doxygen will reuse the documentation of the first
+# member in the group (if any) for the other members of the group. By default
+# all members of a group must be documented explicitly.
+# The default value is: NO.
+
+DISTRIBUTE_GROUP_DOC   = NO
+
+# If one adds a struct or class to a group and this option is enabled, then also
+# any nested class or struct is added to the same group. By default this option
+# is disabled and one has to add nested compounds explicitly via \ingroup.
+# The default value is: NO.
+
+GROUP_NESTED_COMPOUNDS = NO
+
+# Set the SUBGROUPING tag to YES to allow class member groups of the same type
+# (for instance a group of public functions) to be put as a subgroup of that
+# type (e.g. under the Public Functions section). Set it to NO to prevent
+# subgrouping. Alternatively, this can be done per class using the
+# \nosubgrouping command.
+# The default value is: YES.
+
+SUBGROUPING            = YES
+
+# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions
+# are shown inside the group in which they are included (e.g. using \ingroup)
+# instead of on a separate page (for HTML and Man pages) or section (for LaTeX
+# and RTF).
+#
+# Note that this feature does not work in combination with
+# SEPARATE_MEMBER_PAGES.
+# The default value is: NO.
+
+INLINE_GROUPED_CLASSES = NO
+
+# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
+# with only public data fields or simple typedef fields will be shown inline in
+# the documentation of the scope in which they are defined (i.e. file,
+# namespace, or group documentation), provided this scope is documented. If set
+# to NO, structs, classes, and unions are shown on a separate page (for HTML and
+# Man pages) or section (for LaTeX and RTF).
+# The default value is: NO.
+
+INLINE_SIMPLE_STRUCTS  = NO
+
+# When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or
+# enum is documented as struct, union, or enum with the name of the typedef. So
+# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
+# with name TypeT. When disabled the typedef will appear as a member of a file,
+# namespace, or class. And the struct will be named TypeS. This can typically be
+# useful for C code in case the coding convention dictates that all compound
+# types are typedef'ed and only the typedef is referenced, never the tag name.
+# The default value is: NO.
+
+TYPEDEF_HIDES_STRUCT   = NO
+
+# The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
+# cache is used to resolve symbols given their name and scope. Since this can be
+# an expensive process and often the same symbol appears multiple times in the
+# code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small
+# doxygen will become slower. If the cache is too large, memory is wasted. The
+# cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range
+# is 0..9, the default is 0, corresponding to a cache size of 2^16=65536
+# symbols. At the end of a run doxygen will report the cache usage and suggest
+# the optimal cache size from a speed point of view.
+# Minimum value: 0, maximum value: 9, default value: 0.
+
+LOOKUP_CACHE_SIZE      = 0
+
+# The NUM_PROC_THREADS specifies the number of threads doxygen is allowed to use
+# during processing. When set to 0 doxygen will based this on the number of
+# cores available in the system. You can set it explicitly to a value larger
+# than 0 to get more control over the balance between CPU load and processing
+# speed. At this moment only the input processing can be done using multiple
+# threads. Since this is still an experimental feature the default is set to 1,
+# which effectively disables parallel processing. Please report any issues you
+# encounter. Generating dot graphs in parallel is controlled by the
+# DOT_NUM_THREADS setting.
+# Minimum value: 0, maximum value: 32, default value: 1.
+
+NUM_PROC_THREADS       = 0
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in
+# documentation are documented, even if no documentation was available. Private
+# class members and static file members will be hidden unless the
+# EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
+# Note: This will also disable the warnings about undocumented members that are
+# normally produced when WARNINGS is set to YES.
+# The default value is: NO.
+
+EXTRACT_ALL            = NO
+
+# If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will
+# be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PRIVATE        = NO
+
+# If the EXTRACT_PRIV_VIRTUAL tag is set to YES, documented private virtual
+# methods of a class will be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PRIV_VIRTUAL   = NO
+
+# If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal
+# scope will be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PACKAGE        = NO
+
+# If the EXTRACT_STATIC tag is set to YES, all static members of a file will be
+# included in the documentation.
+# The default value is: NO.
+
+EXTRACT_STATIC         = NO
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined
+# locally in source files will be included in the documentation. If set to NO,
+# only classes defined in header files are included. Does not have any effect
+# for Java sources.
+# The default value is: YES.
+
+EXTRACT_LOCAL_CLASSES  = YES
+
+# This flag is only useful for Objective-C code. If set to YES, local methods,
+# which are defined in the implementation section but not in the interface are
+# included in the documentation. If set to NO, only methods in the interface are
+# included.
+# The default value is: NO.
+
+EXTRACT_LOCAL_METHODS  = NO
+
+# If this flag is set to YES, the members of anonymous namespaces will be
+# extracted and appear in the documentation as a namespace called
+# 'anonymous_namespace{file}', where file will be replaced with the base name of
+# the file that contains the anonymous namespace. By default anonymous namespace
+# are hidden.
+# The default value is: NO.
+
+EXTRACT_ANON_NSPACES   = NO
+
+# If this flag is set to YES, the name of an unnamed parameter in a declaration
+# will be determined by the corresponding definition. By default unnamed
+# parameters remain unnamed in the output.
+# The default value is: YES.
+
+RESOLVE_UNNAMED_PARAMS = YES
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
+# undocumented members inside documented classes or files. If set to NO these
+# members will be included in the various overviews, but no documentation
+# section is generated. This option has no effect if EXTRACT_ALL is enabled.
+# The default value is: NO.
+
+HIDE_UNDOC_MEMBERS     = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
+# undocumented classes that are normally visible in the class hierarchy. If set
+# to NO, these classes will be included in the various overviews. This option
+# will also hide undocumented C++ concepts if enabled. This option has no effect
+# if EXTRACT_ALL is enabled.
+# The default value is: NO.
+
+HIDE_UNDOC_CLASSES     = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
+# declarations. If set to NO, these declarations will be included in the
+# documentation.
+# The default value is: NO.
+
+HIDE_FRIEND_COMPOUNDS  = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
+# documentation blocks found inside the body of a function. If set to NO, these
+# blocks will be appended to the function's detailed documentation block.
+# The default value is: NO.
+
+HIDE_IN_BODY_DOCS      = NO
+
+# The INTERNAL_DOCS tag determines if documentation that is typed after a
+# \internal command is included. If the tag is set to NO then the documentation
+# will be excluded. Set it to YES to include the internal documentation.
+# The default value is: NO.
+
+INTERNAL_DOCS          = NO
+
+# With the correct setting of option CASE_SENSE_NAMES doxygen will better be
+# able to match the capabilities of the underlying filesystem. In case the
+# filesystem is case sensitive (i.e. it supports files in the same directory
+# whose names only differ in casing), the option must be set to YES to properly
+# deal with such files in case they appear in the input. For filesystems that
+# are not case sensitive the option should be set to NO to properly deal with
+# output files written for symbols that only differ in casing, such as for two
+# classes, one named CLASS and the other named Class, and to also support
+# references to files without having to specify the exact matching casing. On
+# Windows (including Cygwin) and MacOS, users should typically set this option
+# to NO, whereas on Linux or other Unix flavors it should typically be set to
+# YES.
+# Possible values are: SYSTEM, NO and YES.
+# The default value is: SYSTEM.
+
+CASE_SENSE_NAMES       = YES
+
+# If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
+# their full class and namespace scopes in the documentation. If set to YES, the
+# scope will be hidden.
+# The default value is: NO.
+
+HIDE_SCOPE_NAMES       = NO
+
+# If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then doxygen will
+# append additional text to a page's title, such as Class Reference. If set to
+# YES the compound reference will be hidden.
+# The default value is: NO.
+
+HIDE_COMPOUND_REFERENCE= NO
+
+# If the SHOW_HEADERFILE tag is set to YES then the documentation for a class
+# will show which file needs to be included to use the class.
+# The default value is: YES.
+
+SHOW_HEADERFILE        = YES
+
+# If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
+# the files that are included by a file in the documentation of that file.
+# The default value is: YES.
+
+SHOW_INCLUDE_FILES     = YES
+
+# If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
+# grouped member an include statement to the documentation, telling the reader
+# which file to include in order to use the member.
+# The default value is: NO.
+
+SHOW_GROUPED_MEMB_INC  = NO
+
+# If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
+# files with double quotes in the documentation rather than with sharp brackets.
+# The default value is: NO.
+
+FORCE_LOCAL_INCLUDES   = NO
+
+# If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the
+# documentation for inline members.
+# The default value is: YES.
+
+INLINE_INFO            = YES
+
+# If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
+# (detailed) documentation of file and class members alphabetically by member
+# name. If set to NO, the members will appear in declaration order.
+# The default value is: YES.
+
+SORT_MEMBER_DOCS       = NO
+
+# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
+# descriptions of file, namespace and class members alphabetically by member
+# name. If set to NO, the members will appear in declaration order. Note that
+# this will also influence the order of the classes in the class list.
+# The default value is: NO.
+
+SORT_BRIEF_DOCS        = NO
+
+# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
+# (brief and detailed) documentation of class members so that constructors and
+# destructors are listed first. If set to NO the constructors will appear in the
+# respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.
+# Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief
+# member documentation.
+# Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting
+# detailed member documentation.
+# The default value is: NO.
+
+SORT_MEMBERS_CTORS_1ST = NO
+
+# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
+# of group names into alphabetical order. If set to NO the group names will
+# appear in their defined order.
+# The default value is: NO.
+
+SORT_GROUP_NAMES       = NO
+
+# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
+# fully-qualified names, including namespaces. If set to NO, the class list will
+# be sorted only by class name, not including the namespace part.
+# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
+# Note: This option applies only to the class list, not to the alphabetical
+# list.
+# The default value is: NO.
+
+SORT_BY_SCOPE_NAME     = NO
+
+# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper
+# type resolution of all parameters of a function it will reject a match between
+# the prototype and the implementation of a member function even if there is
+# only one candidate or it is obvious which candidate to choose by doing a
+# simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
+# accept a match between prototype and implementation in such cases.
+# The default value is: NO.
+
+STRICT_PROTO_MATCHING  = NO
+
+# The GENERATE_TODOLIST tag can be used to enable (YES) or disable (NO) the todo
+# list. This list is created by putting \todo commands in the documentation.
+# The default value is: YES.
+
+GENERATE_TODOLIST      = YES
+
+# The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test
+# list. This list is created by putting \test commands in the documentation.
+# The default value is: YES.
+
+GENERATE_TESTLIST      = YES
+
+# The GENERATE_BUGLIST tag can be used to enable (YES) or disable (NO) the bug
+# list. This list is created by putting \bug commands in the documentation.
+# The default value is: YES.
+
+GENERATE_BUGLIST       = YES
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or disable (NO)
+# the deprecated list. This list is created by putting \deprecated commands in
+# the documentation.
+# The default value is: YES.
+
+GENERATE_DEPRECATEDLIST= YES
+
+# The ENABLED_SECTIONS tag can be used to enable conditional documentation
+# sections, marked by \if <section_label> ... \endif and \cond <section_label>
+# ... \endcond blocks.
+
+ENABLED_SECTIONS       =
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the
+# initial value of a variable or macro / define can have for it to appear in the
+# documentation. If the initializer consists of more lines than specified here
+# it will be hidden. Use a value of 0 to hide initializers completely. The
+# appearance of the value of individual variables and macros / defines can be
+# controlled using \showinitializer or \hideinitializer command in the
+# documentation regardless of this setting.
+# Minimum value: 0, maximum value: 10000, default value: 30.
+
+MAX_INITIALIZER_LINES  = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
+# the bottom of the documentation of classes and structs. If set to YES, the
+# list will mention the files that were used to generate the documentation.
+# The default value is: YES.
+
+SHOW_USED_FILES        = YES
+
+# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
+# will remove the Files entry from the Quick Index and from the Folder Tree View
+# (if specified).
+# The default value is: YES.
+
+SHOW_FILES             = YES
+
+# Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces
+# page. This will remove the Namespaces entry from the Quick Index and from the
+# Folder Tree View (if specified).
+# The default value is: YES.
+
+SHOW_NAMESPACES        = YES
+
+# The FILE_VERSION_FILTER tag can be used to specify a program or script that
+# doxygen should invoke to get the current version for each file (typically from
+# the version control system). Doxygen will invoke the program by executing (via
+# popen()) the command command input-file, where command is the value of the
+# FILE_VERSION_FILTER tag, and input-file is the name of an input file provided
+# by doxygen. Whatever the program writes to standard output is used as the file
+# version. For an example see the documentation.
+
+FILE_VERSION_FILTER    =
+
+# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
+# by doxygen. The layout file controls the global structure of the generated
+# output files in an output format independent way. To create the layout file
+# that represents doxygen's defaults, run doxygen with the -l option. You can
+# optionally specify a file name after the option, if omitted DoxygenLayout.xml
+# will be used as the name of the layout file. See also section "Changing the
+# layout of pages" for information.
+#
+# Note that if you run doxygen from a directory containing a file called
+# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
+# tag is left empty.
+
+LAYOUT_FILE            =
+
+# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
+# the reference definitions. This must be a list of .bib files. The .bib
+# extension is automatically appended if omitted. This requires the bibtex tool
+# to be installed. See also https://en.wikipedia.org/wiki/BibTeX for more info.
+# For LaTeX the style of the bibliography can be controlled using
+# LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
+# search path. See also \cite for info how to create references.
+
+CITE_BIB_FILES         =
+
+#---------------------------------------------------------------------------
+# Configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated to
+# standard output by doxygen. If QUIET is set to YES this implies that the
+# messages are off.
+# The default value is: NO.
+
+QUIET                  = NO
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are
+# generated to standard error (stderr) by doxygen. If WARNINGS is set to YES
+# this implies that the warnings are on.
+#
+# Tip: Turn warnings on while writing the documentation.
+# The default value is: YES.
+
+WARNINGS               = YES
+
+# If the WARN_IF_UNDOCUMENTED tag is set to YES then doxygen will generate
+# warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
+# will automatically be disabled.
+# The default value is: YES.
+
+WARN_IF_UNDOCUMENTED   = NO
+
+# If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
+# potential errors in the documentation, such as documenting some parameters in
+# a documented function twice, or documenting parameters that don't exist or
+# using markup commands wrongly.
+# The default value is: YES.
+
+WARN_IF_DOC_ERROR      = YES
+
+# If WARN_IF_INCOMPLETE_DOC is set to YES, doxygen will warn about incomplete
+# function parameter documentation. If set to NO, doxygen will accept that some
+# parameters have no documentation without warning.
+# The default value is: YES.
+
+WARN_IF_INCOMPLETE_DOC = NO
+
+# This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
+# are documented, but have no documentation for their parameters or return
+# value. If set to NO, doxygen will only warn about wrong parameter
+# documentation, but not about the absence of documentation. If EXTRACT_ALL is
+# set to YES then this flag will automatically be disabled. See also
+# WARN_IF_INCOMPLETE_DOC
+# The default value is: NO.
+
+WARN_NO_PARAMDOC       = NO
+
+# If WARN_IF_UNDOC_ENUM_VAL option is set to YES, doxygen will warn about
+# undocumented enumeration values. If set to NO, doxygen will accept
+# undocumented enumeration values. If EXTRACT_ALL is set to YES then this flag
+# will automatically be disabled.
+# The default value is: NO.
+
+WARN_IF_UNDOC_ENUM_VAL = NO
+
+# If the WARN_AS_ERROR tag is set to YES then doxygen will immediately stop when
+# a warning is encountered. If the WARN_AS_ERROR tag is set to FAIL_ON_WARNINGS
+# then doxygen will continue running as if WARN_AS_ERROR tag is set to NO, but
+# at the end of the doxygen process doxygen will return with a non-zero status.
+# If the WARN_AS_ERROR tag is set to FAIL_ON_WARNINGS_PRINT then doxygen behaves
+# like FAIL_ON_WARNINGS but in case no WARN_LOGFILE is defined doxygen will not
+# write the warning messages in between other messages but write them at the end
+# of a run, in case a WARN_LOGFILE is defined the warning messages will be
+# besides being in the defined file also be shown at the end of a run, unless
+# the WARN_LOGFILE is defined as - i.e. standard output (stdout) in that case
+# the behavior will remain as with the setting FAIL_ON_WARNINGS.
+# Possible values are: NO, YES, FAIL_ON_WARNINGS and FAIL_ON_WARNINGS_PRINT.
+# The default value is: NO.
+
+WARN_AS_ERROR          = FAIL_ON_WARNINGS
+
+# The WARN_FORMAT tag determines the format of the warning messages that doxygen
+# can produce. The string should contain the $file, $line, and $text tags, which
+# will be replaced by the file and line number from which the warning originated
+# and the warning text. Optionally the format may contain $version, which will
+# be replaced by the version of the file (if it could be obtained via
+# FILE_VERSION_FILTER)
+# See also: WARN_LINE_FORMAT
+# The default value is: $file:$line: $text.
+
+WARN_FORMAT            = "$file:$line: $text"
+
+# In the $text part of the WARN_FORMAT command it is possible that a reference
+# to a more specific place is given. To make it easier to jump to this place
+# (outside of doxygen) the user can define a custom "cut" / "paste" string.
+# Example:
+# WARN_LINE_FORMAT = "'vi $file +$line'"
+# See also: WARN_FORMAT
+# The default value is: at line $line of file $file.
+
+WARN_LINE_FORMAT       = "at line $line of file $file"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning and error
+# messages should be written. If left blank the output is written to standard
+# error (stderr). In case the file specified cannot be opened for writing the
+# warning and error messages are written to standard error. When as file - is
+# specified the warning and error messages are written to standard output
+# (stdout).
+
+WARN_LOGFILE           =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag is used to specify the files and/or directories that contain
+# documented source files. You may enter file names like myfile.cpp or
+# directories like /usr/src/myproject. Separate the files or directories with
+# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
+# Note: If this tag is empty the current directory is searched.
+
+INPUT                  = "${CUDAQ_REPO_ROOT}/runtime"
+
+# This tag can be used to specify the character encoding of the source files
+# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
+# libiconv (or the iconv built into libc) for the transcoding. See the libiconv
+# documentation (see:
+# https://www.gnu.org/software/libiconv/) for the list of possible encodings.
+# See also: INPUT_FILE_ENCODING
+# The default value is: UTF-8.
+
+INPUT_ENCODING         = UTF-8
+
+# This tag can be used to specify the character encoding of the source files
+# that doxygen parses The INPUT_FILE_ENCODING tag can be used to specify
+# character encoding on a per file pattern basis. Doxygen will compare the file
+# name with each pattern and apply the encoding instead of the default
+# INPUT_ENCODING) if there is a match. The character encodings are a list of the
+# form: pattern=encoding (like *.php=ISO-8859-1). See cfg_input_encoding
+# "INPUT_ENCODING" for further information on supported encodings.
+
+INPUT_FILE_ENCODING    =
+
+# If the value of the INPUT tag contains directories, you can use the
+# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
+# *.h) to filter out the source-files in the directories.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# read by doxygen.
+#
+# Note the list of default checked file patterns might differ from the list of
+# default file extension mappings.
+#
+# If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp,
+# *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h,
+# *.hh, *.hxx, *.hpp, *.h++, *.l, *.cs, *.d, *.php, *.php4, *.php5, *.phtml,
+# *.inc, *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C
+# comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd,
+# *.vhdl, *.ucf, *.qsf and *.ice.
+
+FILE_PATTERNS          = *.h \
+                         *.hpp \
+                         *.inc
+
+# The RECURSIVE tag can be used to specify whether or not subdirectories should
+# be searched for input files as well.
+# The default value is: NO.
+
+RECURSIVE              = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should be
+# excluded from the INPUT source files. This way you can easily exclude a
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+#
+# Note that relative paths are relative to the directory from which doxygen is
+# run.
+
+EXCLUDE                = "${CUDAQ_REPO_ROOT}/runtime/cudaq/algorithms/optimizers"
+
+# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
+# directories that are symbolic links (a Unix file system feature) are excluded
+# from the input.
+# The default value is: NO.
+
+EXCLUDE_SYMLINKS       = NO
+
+# If the value of the INPUT tag contains directories, you can use the
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
+# certain files from those directories.
+#
+# Note that the wildcards are matched against the file with absolute path, so to
+# exclude all test directories for example use the pattern */test/*
+
+EXCLUDE_PATTERNS       = "Convert*"
+
+# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
+# (namespaces, classes, functions, etc.) that should be excluded from the
+# output. The symbol name can be a fully qualified name, a word, or if the
+# wildcard * is used, a substring. Examples: ANamespace, AClass,
+# ANamespace::AClass, ANamespace::*Test
+#
+# Note that the wildcards are matched against the file with absolute path, so to
+# exclude all test directories use the pattern */test/*
+
+EXCLUDE_SYMBOLS        = "classcudaq_1_1*"
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or directories
+# that contain example code fragments that are included (see the \include
+# command).
+
+EXAMPLE_PATH           =
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
+# *.h) to filter out the source-files in the directories. If left blank all
+# files are included.
+
+EXAMPLE_PATTERNS       = *
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
+# searched for input files to be used with the \include or \dontinclude commands
+# irrespective of the value of the RECURSIVE tag.
+# The default value is: NO.
+
+EXAMPLE_RECURSIVE      = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or directories
+# that contain images that are to be included in the documentation (see the
+# \image command).
+
+IMAGE_PATH             =
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should
+# invoke to filter for each input file. Doxygen will invoke the filter program
+# by executing (via popen()) the command:
+#
+# <filter> <input-file>
+#
+# where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the
+# name of an input file. Doxygen will then use the output that the filter
+# program writes to standard output. If FILTER_PATTERNS is specified, this tag
+# will be ignored.
+#
+# Note that the filter must not add or remove lines; it is applied before the
+# code is scanned, but not when the output code is generated. If lines are added
+# or removed, the anchors will not be placed correctly.
+#
+# Note that doxygen will use the data processed and written to standard output
+# for further processing, therefore nothing else, like debug statements or used
+# commands (so in case of a Windows batch file always use @echo OFF), should be
+# written to standard output.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# properly processed by doxygen.
+
+INPUT_FILTER           =
+
+# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
+# basis. Doxygen will compare the file name with each pattern and apply the
+# filter if there is a match. The filters are a list of the form: pattern=filter
+# (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how
+# filters are used. If the FILTER_PATTERNS tag is empty or if none of the
+# patterns match the file name, INPUT_FILTER is applied.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# properly processed by doxygen.
+
+FILTER_PATTERNS        =
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
+# INPUT_FILTER) will also be used to filter the input files that are used for
+# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
+# The default value is: NO.
+
+FILTER_SOURCE_FILES    = NO
+
+# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
+# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
+# it is also possible to disable source filtering for a specific pattern using
+# *.ext= (so without naming a filter).
+# This tag requires that the tag FILTER_SOURCE_FILES is set to YES.
+
+FILTER_SOURCE_PATTERNS =
+
+# If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that
+# is part of the input, its contents will be placed on the main page
+# (index.html). This can be useful if you have a project on for instance GitHub
+# and want to reuse the introduction page also for the doxygen output.
+
+USE_MDFILE_AS_MAINPAGE =
+
+# The Fortran standard specifies that for fixed formatted Fortran code all
+# characters from position 72 are to be considered as comment. A common
+# extension is to allow longer lines before the automatic comment starts. The
+# setting FORTRAN_COMMENT_AFTER will also make it possible that longer lines can
+# be processed before the automatic comment starts.
+# Minimum value: 7, maximum value: 10000, default value: 72.
+
+FORTRAN_COMMENT_AFTER  = 72
+
+#---------------------------------------------------------------------------
+# Configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will be
+# generated. Documented entities will be cross-referenced with these sources.
+#
+# Note: To get rid of all source code in the generated output, make sure that
+# also VERBATIM_HEADERS is set to NO.
+# The default value is: NO.
+
+SOURCE_BROWSER         = NO
+
+# Setting the INLINE_SOURCES tag to YES will include the body of functions,
+# classes and enums directly into the documentation.
+# The default value is: NO.
+
+INLINE_SOURCES         = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
+# special comment blocks from generated source code fragments. Normal C, C++ and
+# Fortran comments will always remain visible.
+# The default value is: YES.
+
+STRIP_CODE_COMMENTS    = YES
+
+# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
+# entity all documented functions referencing it will be listed.
+# The default value is: NO.
+
+REFERENCED_BY_RELATION = NO
+
+# If the REFERENCES_RELATION tag is set to YES then for each documented function
+# all documented entities called/used by that function will be listed.
+# The default value is: NO.
+
+REFERENCES_RELATION    = NO
+
+# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
+# to YES then the hyperlinks from functions in REFERENCES_RELATION and
+# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
+# link to the documentation.
+# The default value is: YES.
+
+REFERENCES_LINK_SOURCE = YES
+
+# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
+# source code will show a tooltip with additional information such as prototype,
+# brief description and links to the definition and documentation. Since this
+# will make the HTML file larger and loading of large files a bit slower, you
+# can opt to disable this feature.
+# The default value is: YES.
+# This tag requires that the tag SOURCE_BROWSER is set to YES.
+
+SOURCE_TOOLTIPS        = YES
+
+# If the USE_HTAGS tag is set to YES then the references to source code will
+# point to the HTML generated by the htags(1) tool instead of doxygen built-in
+# source browser. The htags tool is part of GNU's global source tagging system
+# (see https://www.gnu.org/software/global/global.html). You will need version
+# 4.8.6 or higher.
+#
+# To use it do the following:
+# - Install the latest version of global
+# - Enable SOURCE_BROWSER and USE_HTAGS in the configuration file
+# - Make sure the INPUT points to the root of the source tree
+# - Run doxygen as normal
+#
+# Doxygen will invoke htags (and that will in turn invoke gtags), so these
+# tools must be available from the command line (i.e. in the search path).
+#
+# The result: instead of the source browser generated by doxygen, the links to
+# source code will now point to the output of htags.
+# The default value is: NO.
+# This tag requires that the tag SOURCE_BROWSER is set to YES.
+
+USE_HTAGS              = NO
+
+# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
+# verbatim copy of the header file for each class for which an include is
+# specified. Set to NO to disable this.
+# See also: Section \class.
+# The default value is: YES.
+
+VERBATIM_HEADERS       = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
+# compounds will be generated. Enable this if the project contains a lot of
+# classes, structs, unions or interfaces.
+# The default value is: YES.
+
+ALPHABETICAL_INDEX     = YES
+
+# The IGNORE_PREFIX tag can be used to specify a prefix (or a list of prefixes)
+# that should be ignored while generating the index headers. The IGNORE_PREFIX
+# tag works for classes, function and member names. The entity will be placed in
+# the alphabetical list under the first letter of the entity name that remains
+# after removing the prefix.
+# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
+
+IGNORE_PREFIX          =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output
+# The default value is: YES.
+
+GENERATE_HTML          = NO
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: html.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_OUTPUT            = "${DOXYGEN_OUTPUT_PREFIX}/html"
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
+# generated HTML page (for example: .htm, .php, .asp).
+# The default value is: .html.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FILE_EXTENSION    = .html
+
+# The HTML_HEADER tag can be used to specify a user-defined HTML header file for
+# each generated HTML page. If the tag is left blank doxygen will generate a
+# standard header.
+#
+# To get valid HTML the header file that includes any scripts and style sheets
+# that doxygen needs, which is dependent on the configuration options used (e.g.
+# the setting GENERATE_TREEVIEW). It is highly recommended to start with a
+# default header using
+# doxygen -w html new_header.html new_footer.html new_stylesheet.css
+# YourConfigFile
+# and then modify the file new_header.html. See also section "Doxygen usage"
+# for information on how to generate the default header that doxygen normally
+# uses.
+# Note: The header is subject to change so you typically have to regenerate the
+# default header when upgrading to a newer version of doxygen. For a description
+# of the possible markers and block names see the documentation.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_HEADER            =
+
+# The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
+# generated HTML page. If the tag is left blank doxygen will generate a standard
+# footer. See HTML_HEADER for more information on how to generate a default
+# footer and what special commands can be used inside the footer. See also
+# section "Doxygen usage" for information on how to generate the default footer
+# that doxygen normally uses.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FOOTER            =
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
+# sheet that is used by each HTML page. It can be used to fine-tune the look of
+# the HTML output. If left blank doxygen will generate a default style sheet.
+# See also section "Doxygen usage" for information on how to generate the style
+# sheet that doxygen normally uses.
+# Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
+# it is more robust and this tag (HTML_STYLESHEET) will in the future become
+# obsolete.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_STYLESHEET        =
+
+# The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# cascading style sheets that are included after the standard style sheets
+# created by doxygen. Using this option one can overrule certain style aspects.
+# This is preferred over using HTML_STYLESHEET since it does not replace the
+# standard style sheet and is therefore more robust against future updates.
+# Doxygen will copy the style sheet files to the output directory.
+# Note: The order of the extra style sheet files is of importance (e.g. the last
+# style sheet in the list overrules the setting of the previous ones in the
+# list).
+# Note: Since the styling of scrollbars can currently not be overruled in
+# Webkit/Chromium, the styling will be left out of the default doxygen.css if
+# one or more extra stylesheets have been specified. So if scrollbar
+# customization is desired it has to be added explicitly. For an example see the
+# documentation.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_EXTRA_STYLESHEET  =
+
+# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
+# other source files which should be copied to the HTML output directory. Note
+# that these files will be copied to the base HTML output directory. Use the
+# $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
+# files. In the HTML_STYLESHEET file, use the file name only. Also note that the
+# files will be copied as-is; there are no commands or markers available.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_EXTRA_FILES       =
+
+# The HTML_COLORSTYLE tag can be used to specify if the generated HTML output
+# should be rendered with a dark or light theme.
+# Possible values are: LIGHT always generate light mode output, DARK always
+# generate dark mode output, AUTO_LIGHT automatically set the mode according to
+# the user preference, use light mode if no preference is set (the default),
+# AUTO_DARK automatically set the mode according to the user preference, use
+# dark mode if no preference is set and TOGGLE allow to user to switch between
+# light and dark mode via a button.
+# The default value is: AUTO_LIGHT.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE        = AUTO_LIGHT
+
+# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
+# will adjust the colors in the style sheet and background images according to
+# this color. Hue is specified as an angle on a color-wheel, see
+# https://en.wikipedia.org/wiki/Hue for more information. For instance the value
+# 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
+# purple, and 360 is red again.
+# Minimum value: 0, maximum value: 359, default value: 220.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_HUE    = 220
+
+# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors
+# in the HTML output. For a value of 0 the output will use gray-scales only. A
+# value of 255 will produce the most vivid colors.
+# Minimum value: 0, maximum value: 255, default value: 100.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_SAT    = 100
+
+# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
+# luminance component of the colors in the HTML output. Values below 100
+# gradually make the output lighter, whereas values above 100 make the output
+# darker. The value divided by 100 is the actual gamma applied, so 80 represents
+# a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
+# change the gamma.
+# Minimum value: 40, maximum value: 240, default value: 80.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_GAMMA  = 80
+
+# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
+# page will contain the date and time when the page was generated. Setting this
+# to YES can help to show when doxygen was last run and thus if the
+# documentation is up to date.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_TIMESTAMP         = NO
+
+# If the HTML_DYNAMIC_MENUS tag is set to YES then the generated HTML
+# documentation will contain a main index with vertical navigation menus that
+# are dynamically created via JavaScript. If disabled, the navigation index will
+# consists of multiple levels of tabs that are statically embedded in every HTML
+# page. Disable this option to support browsers that do not have JavaScript,
+# like the Qt help browser.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_DYNAMIC_MENUS     = YES
+
+# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
+# documentation will contain sections that can be hidden and shown after the
+# page has loaded.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_DYNAMIC_SECTIONS  = NO
+
+# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
+# shown in the various tree structured indices initially; the user can expand
+# and collapse entries dynamically later on. Doxygen will expand the tree to
+# such a level that at most the specified number of entries are visible (unless
+# a fully collapsed tree already exceeds this amount). So setting the number of
+# entries 1 will produce a full collapsed tree by default. 0 is a special value
+# representing an infinite number of entries and will result in a full expanded
+# tree by default.
+# Minimum value: 0, maximum value: 9999, default value: 100.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_INDEX_NUM_ENTRIES = 100
+
+# If the GENERATE_DOCSET tag is set to YES, additional index files will be
+# generated that can be used as input for Apple's Xcode 3 integrated development
+# environment (see:
+# https://developer.apple.com/xcode/), introduced with OSX 10.5 (Leopard). To
+# create a documentation set, doxygen will generate a Makefile in the HTML
+# output directory. Running make will produce the docset in that directory and
+# running make install will install the docset in
+# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
+# startup. See https://developer.apple.com/library/archive/featuredarticles/Doxy
+# genXcode/_index.html for more information.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_DOCSET        = NO
+
+# This tag determines the name of the docset feed. A documentation feed provides
+# an umbrella under which multiple documentation sets from a single provider
+# (such as a company or product suite) can be grouped.
+# The default value is: Doxygen generated docs.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_FEEDNAME        = "Doxygen generated docs"
+
+# This tag determines the URL of the docset feed. A documentation feed provides
+# an umbrella under which multiple documentation sets from a single provider
+# (such as a company or product suite) can be grouped.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_FEEDURL         =
+
+# This tag specifies a string that should uniquely identify the documentation
+# set bundle. This should be a reverse domain-name style string, e.g.
+# com.mycompany.MyDocSet. Doxygen will append .docset to the name.
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_BUNDLE_ID       = org.doxygen.Project
+
+# The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
+# the documentation publisher. This should be a reverse domain-name style
+# string, e.g. com.mycompany.MyDocSet.documentation.
+# The default value is: org.doxygen.Publisher.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_PUBLISHER_ID    = org.doxygen.Publisher
+
+# The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
+# The default value is: Publisher.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_PUBLISHER_NAME  = Publisher
+
+# If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three
+# additional HTML index files: index.hhp, index.hhc, and index.hhk. The
+# index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
+# on Windows. In the beginning of 2021 Microsoft took the original page, with
+# a.o. the download links, offline the HTML help workshop was already many years
+# in maintenance mode). You can download the HTML help workshop from the web
+# archives at Installation executable (see:
+# http://web.archive.org/web/20160201063255/http://download.microsoft.com/downlo
+# ad/0/A/9/0A939EF6-E31C-430F-A3DF-DFAE7960D564/htmlhelp.exe).
+#
+# The HTML Help Workshop contains a compiler that can convert all HTML output
+# generated by doxygen into a single compiled HTML file (.chm). Compiled HTML
+# files are now used as the Windows 98 help format, and will replace the old
+# Windows help format (.hlp) on all Windows platforms in the future. Compressed
+# HTML files also contain an index, a table of contents, and you can search for
+# words in the documentation. The HTML workshop also contains a viewer for
+# compressed HTML files.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_HTMLHELP      = NO
+
+# The CHM_FILE tag can be used to specify the file name of the resulting .chm
+# file. You can add a path in front of the file if the result should not be
+# written to the html output directory.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+CHM_FILE               =
+
+# The HHC_LOCATION tag can be used to specify the location (absolute path
+# including file name) of the HTML help compiler (hhc.exe). If non-empty,
+# doxygen will try to run the HTML help compiler on the generated index.hhp.
+# The file has to be specified with full path.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+HHC_LOCATION           =
+
+# The GENERATE_CHI flag controls if a separate .chi index file is generated
+# (YES) or that it should be included in the main .chm file (NO).
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+GENERATE_CHI           = NO
+
+# The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc)
+# and project file content.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+CHM_INDEX_ENCODING     =
+
+# The BINARY_TOC flag controls whether a binary table of contents is generated
+# (YES) or a normal table of contents (NO) in the .chm file. Furthermore it
+# enables the Previous and Next buttons.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+BINARY_TOC             = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members to
+# the table of contents of the HTML help documentation and to the tree view.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+TOC_EXPAND             = NO
+
+# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
+# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
+# can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
+# (.qch) of the generated HTML documentation.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_QHP           = NO
+
+# If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
+# the file name of the resulting .qch file. The path specified is relative to
+# the HTML output folder.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QCH_FILE               =
+
+# The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
+# Project output. For more information please see Qt Help Project / Namespace
+# (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#namespace).
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_NAMESPACE          = org.doxygen.Project
+
+# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
+# Help Project output. For more information please see Qt Help Project / Virtual
+# Folders (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#virtual-folders).
+# The default value is: doc.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_VIRTUAL_FOLDER     = doc
+
+# If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
+# filter to add. For more information please see Qt Help Project / Custom
+# Filters (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom-filters).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_CUST_FILTER_NAME   =
+
+# The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
+# custom filter to add. For more information please see Qt Help Project / Custom
+# Filters (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom-filters).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_CUST_FILTER_ATTRS  =
+
+# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
+# project's filter section matches. Qt Help Project / Filter Attributes (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#filter-attributes).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_SECT_FILTER_ATTRS  =
+
+# The QHG_LOCATION tag can be used to specify the location (absolute path
+# including file name) of Qt's qhelpgenerator. If non-empty doxygen will try to
+# run qhelpgenerator on the generated .qhp file.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHG_LOCATION           =
+
+# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
+# generated, together with the HTML files, they form an Eclipse help plugin. To
+# install this plugin and make it available under the help contents menu in
+# Eclipse, the contents of the directory containing the HTML and XML files needs
+# to be copied into the plugins directory of eclipse. The name of the directory
+# within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
+# After copying Eclipse needs to be restarted before the help appears.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_ECLIPSEHELP   = NO
+
+# A unique identifier for the Eclipse help plugin. When installing the plugin
+# the directory name containing the HTML and XML files should also have this
+# name. Each documentation set should have its own identifier.
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
+
+ECLIPSE_DOC_ID         = org.doxygen.Project
+
+# If you want full control over the layout of the generated HTML pages it might
+# be necessary to disable the index and replace it with your own. The
+# DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
+# of each HTML page. A value of NO enables the index and the value YES disables
+# it. Since the tabs in the index contain the same information as the navigation
+# tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+DISABLE_INDEX          = NO
+
+# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
+# structure should be generated to display hierarchical information. If the tag
+# value is set to YES, a side panel will be generated containing a tree-like
+# index structure (just like the one that is generated for HTML Help). For this
+# to work a browser that supports JavaScript, DHTML, CSS and frames is required
+# (i.e. any modern browser). Windows users are probably better off using the
+# HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can
+# further fine tune the look of the index (see "Fine-tuning the output"). As an
+# example, the default style sheet generated by doxygen has an example that
+# shows how to put an image at the root of the tree instead of the PROJECT_NAME.
+# Since the tree basically has the same information as the tab index, you could
+# consider setting DISABLE_INDEX to YES when enabling this option.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_TREEVIEW      = NO
+
+# When both GENERATE_TREEVIEW and DISABLE_INDEX are set to YES, then the
+# FULL_SIDEBAR option determines if the side bar is limited to only the treeview
+# area (value NO) or if it should extend to the full height of the window (value
+# YES). Setting this to YES gives a layout similar to
+# https://docs.readthedocs.io with more room for contents, but less room for the
+# project logo, title, and description. If either GENERATE_TREEVIEW or
+# DISABLE_INDEX is set to NO, this option has no effect.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FULL_SIDEBAR           = NO
+
+# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
+# doxygen will group on one line in the generated HTML documentation.
+#
+# Note that a value of 0 will completely suppress the enum values from appearing
+# in the overview section.
+# Minimum value: 0, maximum value: 20, default value: 4.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+ENUM_VALUES_PER_LINE   = 4
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
+# to set the initial width (in pixels) of the frame in which the tree is shown.
+# Minimum value: 0, maximum value: 1500, default value: 250.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+TREEVIEW_WIDTH         = 250
+
+# If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to
+# external symbols imported via tag files in a separate window.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+EXT_LINKS_IN_WINDOW    = NO
+
+# If the OBFUSCATE_EMAILS tag is set to YES, doxygen will obfuscate email
+# addresses.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+OBFUSCATE_EMAILS       = YES
+
+# If the HTML_FORMULA_FORMAT option is set to svg, doxygen will use the pdf2svg
+# tool (see https://github.com/dawbarton/pdf2svg) or inkscape (see
+# https://inkscape.org) to generate formulas as SVG images instead of PNGs for
+# the HTML output. These images will generally look nicer at scaled resolutions.
+# Possible values are: png (the default) and svg (looks nicer but requires the
+# pdf2svg or inkscape tool).
+# The default value is: png.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FORMULA_FORMAT    = png
+
+# Use this tag to change the font size of LaTeX formulas included as images in
+# the HTML documentation. When you change the font size after a successful
+# doxygen run you need to manually remove any form_*.png images from the HTML
+# output directory to force them to be regenerated.
+# Minimum value: 8, maximum value: 50, default value: 10.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FORMULA_FONTSIZE       = 10
+
+# The FORMULA_MACROFILE can contain LaTeX \newcommand and \renewcommand commands
+# to create new LaTeX commands to be used in formulas as building blocks. See
+# the section "Including formulas" for details.
+
+FORMULA_MACROFILE      =
+
+# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
+# https://www.mathjax.org) which uses client side JavaScript for the rendering
+# instead of using pre-rendered bitmaps. Use this if you do not have LaTeX
+# installed or if you want to formulas look prettier in the HTML output. When
+# enabled you may also need to install MathJax separately and configure the path
+# to it using the MATHJAX_RELPATH option.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+USE_MATHJAX            = NO
+
+# With MATHJAX_VERSION it is possible to specify the MathJax version to be used.
+# Note that the different versions of MathJax have different requirements with
+# regards to the different settings, so it is possible that also other MathJax
+# settings have to be changed when switching between the different MathJax
+# versions.
+# Possible values are: MathJax_2 and MathJax_3.
+# The default value is: MathJax_2.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_VERSION        = MathJax_2
+
+# When MathJax is enabled you can set the default output format to be used for
+# the MathJax output. For more details about the output format see MathJax
+# version 2 (see:
+# http://docs.mathjax.org/en/v2.7-latest/output.html) and MathJax version 3
+# (see:
+# http://docs.mathjax.org/en/latest/web/components/output.html).
+# Possible values are: HTML-CSS (which is slower, but has the best
+# compatibility. This is the name for Mathjax version 2, for MathJax version 3
+# this will be translated into chtml), NativeMML (i.e. MathML. Only supported
+# for NathJax 2. For MathJax version 3 chtml will be used instead.), chtml (This
+# is the name for Mathjax version 3, for MathJax version 2 this will be
+# translated into HTML-CSS) and SVG.
+# The default value is: HTML-CSS.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_FORMAT         = HTML-CSS
+
+# When MathJax is enabled you need to specify the location relative to the HTML
+# output directory using the MATHJAX_RELPATH option. The destination directory
+# should contain the MathJax.js script. For instance, if the mathjax directory
+# is located at the same level as the HTML output directory, then
+# MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
+# Content Delivery Network so you can quickly see the result without installing
+# MathJax. However, it is strongly recommended to install a local copy of
+# MathJax from https://www.mathjax.org before deployment. The default value is:
+# - in case of MathJax version 2: https://cdn.jsdelivr.net/npm/mathjax@2
+# - in case of MathJax version 3: https://cdn.jsdelivr.net/npm/mathjax@3
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
+
+# The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
+# extension names that should be enabled during MathJax rendering. For example
+# for MathJax version 2 (see
+# https://docs.mathjax.org/en/v2.7-latest/tex.html#tex-and-latex-extensions):
+# MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
+# For example for MathJax version 3 (see
+# http://docs.mathjax.org/en/latest/input/tex/extensions/index.html):
+# MATHJAX_EXTENSIONS = ams
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_EXTENSIONS     =
+
+# The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
+# of code that will be used on startup of the MathJax code. See the MathJax site
+# (see:
+# http://docs.mathjax.org/en/v2.7-latest/output.html) for more details. For an
+# example see the documentation.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_CODEFILE       =
+
+# When the SEARCHENGINE tag is enabled doxygen will generate a search box for
+# the HTML output. The underlying search engine uses javascript and DHTML and
+# should work on any modern browser. Note that when using HTML help
+# (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
+# there is already a search function so this one should typically be disabled.
+# For large projects the javascript based search engine can be slow, then
+# enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
+# search using the keyboard; to jump to the search box use <access key> + S
+# (what the <access key> is depends on the OS and browser, but it is typically
+# <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
+# key> to jump into the search results window, the results can be navigated
+# using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
+# the search. The filter options can be selected when the cursor is inside the
+# search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
+# to select a filter and <Enter> or <escape> to activate or cancel the filter
+# option.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+SEARCHENGINE           = YES
+
+# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
+# implemented using a web server instead of a web client using JavaScript. There
+# are two flavors of web server based searching depending on the EXTERNAL_SEARCH
+# setting. When disabled, doxygen will generate a PHP script for searching and
+# an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
+# and searching needs to be provided by external tools. See the section
+# "External Indexing and Searching" for details.
+# The default value is: NO.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SERVER_BASED_SEARCH    = NO
+
+# When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
+# script for searching. Instead the search results are written to an XML file
+# which needs to be processed by an external indexer. Doxygen will invoke an
+# external search engine pointed to by the SEARCHENGINE_URL option to obtain the
+# search results.
+#
+# Doxygen ships with an example indexer (doxyindexer) and search engine
+# (doxysearch.cgi) which are based on the open source search engine library
+# Xapian (see:
+# https://xapian.org/).
+#
+# See the section "External Indexing and Searching" for details.
+# The default value is: NO.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTERNAL_SEARCH        = NO
+
+# The SEARCHENGINE_URL should point to a search engine hosted by a web server
+# which will return the search results when EXTERNAL_SEARCH is enabled.
+#
+# Doxygen ships with an example indexer (doxyindexer) and search engine
+# (doxysearch.cgi) which are based on the open source search engine library
+# Xapian (see:
+# https://xapian.org/). See the section "External Indexing and Searching" for
+# details.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SEARCHENGINE_URL       =
+
+# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
+# search data is written to a file for indexing by an external tool. With the
+# SEARCHDATA_FILE tag the name of this file can be specified.
+# The default file is: searchdata.xml.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SEARCHDATA_FILE        = searchdata.xml
+
+# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
+# EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
+# useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
+# projects and redirect the results back to the right project.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTERNAL_SEARCH_ID     =
+
+# The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
+# projects other than the one defined by this configuration file, but that are
+# all added to the same external search index. Each project needs to have a
+# unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
+# to a relative location where the documentation can be found. The format is:
+# EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTRA_SEARCH_MAPPINGS  =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
+# The default value is: YES.
+
+GENERATE_LATEX         = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: latex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_OUTPUT           = "${DOXYGEN_OUTPUT_PREFIX}/latex"
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
+# invoked.
+#
+# Note that when not enabling USE_PDFLATEX the default is latex when enabling
+# USE_PDFLATEX the default is pdflatex and when in the later case latex is
+# chosen this is overwritten by pdflatex. For specific output languages the
+# default can have been set differently, this depends on the implementation of
+# the output language.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_CMD_NAME         = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
+# index for LaTeX.
+# Note: This tag is used in the Makefile / make.bat.
+# See also: LATEX_MAKEINDEX_CMD for the part in the generated output file
+# (.tex).
+# The default file is: makeindex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+MAKEINDEX_CMD_NAME     = makeindex
+
+# The LATEX_MAKEINDEX_CMD tag can be used to specify the command name to
+# generate index for LaTeX. In case there is no backslash (\) as first character
+# it will be automatically added in the LaTeX code.
+# Note: This tag is used in the generated output file (.tex).
+# See also: MAKEINDEX_CMD_NAME for the part in the Makefile / make.bat.
+# The default value is: makeindex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_MAKEINDEX_CMD    = makeindex
+
+# If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX
+# documents. This may be useful for small projects and may help to save some
+# trees in general.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+COMPACT_LATEX          = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used by the
+# printer.
+# Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
+# 14 inches) and executive (7.25 x 10.5 inches).
+# The default value is: a4.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+PAPER_TYPE             = a4
+
+# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
+# that should be included in the LaTeX output. The package can be specified just
+# by its name or with the correct syntax as to be used with the LaTeX
+# \usepackage command. To get the times font for instance you can specify :
+# EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}
+# To use the option intlimits with the amsmath package you can specify:
+# EXTRA_PACKAGES=[intlimits]{amsmath}
+# If left blank no extra packages will be included.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+EXTRA_PACKAGES         =
+
+# The LATEX_HEADER tag can be used to specify a user-defined LaTeX header for
+# the generated LaTeX document. The header should contain everything until the
+# first chapter. If it is left blank doxygen will generate a standard header. It
+# is highly recommended to start with a default header using
+# doxygen -w latex new_header.tex new_footer.tex new_stylesheet.sty
+# and then modify the file new_header.tex. See also section "Doxygen usage" for
+# information on how to generate the default header that doxygen normally uses.
+#
+# Note: Only use a user-defined header if you know what you are doing!
+# Note: The header is subject to change so you typically have to regenerate the
+# default header when upgrading to a newer version of doxygen. The following
+# commands have a special meaning inside the header (and footer): For a
+# description of the possible markers and block names see the documentation.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_HEADER           =
+
+# The LATEX_FOOTER tag can be used to specify a user-defined LaTeX footer for
+# the generated LaTeX document. The footer should contain everything after the
+# last chapter. If it is left blank doxygen will generate a standard footer. See
+# LATEX_HEADER for more information on how to generate a default footer and what
+# special commands can be used inside the footer. See also section "Doxygen
+# usage" for information on how to generate the default footer that doxygen
+# normally uses. Note: Only use a user-defined footer if you know what you are
+# doing!
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_FOOTER           =
+
+# The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# LaTeX style sheets that are included after the standard style sheets created
+# by doxygen. Using this option one can overrule certain style aspects. Doxygen
+# will copy the style sheet files to the output directory.
+# Note: The order of the extra style sheet files is of importance (e.g. the last
+# style sheet in the list overrules the setting of the previous ones in the
+# list).
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EXTRA_STYLESHEET =
+
+# The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
+# other source files which should be copied to the LATEX_OUTPUT output
+# directory. Note that the files will be copied as-is; there are no commands or
+# markers available.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EXTRA_FILES      =
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
+# prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
+# contain links (just like the HTML output) instead of page references. This
+# makes the output suitable for online browsing using a PDF viewer.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+PDF_HYPERLINKS         = YES
+
+# If the USE_PDFLATEX tag is set to YES, doxygen will use the engine as
+# specified with LATEX_CMD_NAME to generate the PDF file directly from the LaTeX
+# files. Set this option to YES, to get a higher quality PDF documentation.
+#
+# See also section LATEX_CMD_NAME for selecting the engine.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+USE_PDFLATEX           = YES
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
+# command to the generated LaTeX files. This will instruct LaTeX to keep running
+# if errors occur, instead of asking the user for help.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_BATCHMODE        = NO
+
+# If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
+# index chapters (such as File Index, Compound Index, etc.) in the output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_HIDE_INDICES     = NO
+
+# The LATEX_BIB_STYLE tag can be used to specify the style to use for the
+# bibliography, e.g. plainnat, or ieeetr. See
+# https://en.wikipedia.org/wiki/BibTeX and \cite for more info.
+# The default value is: plain.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_BIB_STYLE        = plain
+
+# If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
+# page will contain the date and time when the page was generated. Setting this
+# to NO can help when comparing the output of multiple runs.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_TIMESTAMP        = NO
+
+# The LATEX_EMOJI_DIRECTORY tag is used to specify the (relative or absolute)
+# path from which the emoji images will be read. If a relative path is entered,
+# it will be relative to the LATEX_OUTPUT directory. If left blank the
+# LATEX_OUTPUT directory will be used.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EMOJI_DIRECTORY  =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES, doxygen will generate RTF output. The
+# RTF output is optimized for Word 97 and may not look too pretty with other RTF
+# readers/editors.
+# The default value is: NO.
+
+GENERATE_RTF           = YES
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: rtf.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_OUTPUT             = "${DOXYGEN_OUTPUT_PREFIX}/rtf"
+
+# If the COMPACT_RTF tag is set to YES, doxygen generates more compact RTF
+# documents. This may be useful for small projects and may help to save some
+# trees in general.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+COMPACT_RTF            = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
+# contain hyperlink fields. The RTF file will contain links (just like the HTML
+# output) instead of page references. This makes the output suitable for online
+# browsing using Word or some other Word compatible readers that support those
+# fields.
+#
+# Note: WordPad (write) and others do not support links.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_HYPERLINKS         = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's
+# configuration file, i.e. a series of assignments. You only have to provide
+# replacements, missing definitions are set to their default value.
+#
+# See also section "Doxygen usage" for information on how to generate the
+# default style sheet that doxygen normally uses.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_STYLESHEET_FILE    =
+
+# Set optional variables used in the generation of an RTF document. Syntax is
+# similar to doxygen's configuration file. A template extensions file can be
+# generated using doxygen -e rtf extensionFile.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_EXTENSIONS_FILE    =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES, doxygen will generate man pages for
+# classes and files.
+# The default value is: NO.
+
+GENERATE_MAN           = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it. A directory man3 will be created inside the directory specified by
+# MAN_OUTPUT.
+# The default directory is: man.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_OUTPUT             = "${DOXYGEN_OUTPUT_PREFIX}/man"
+
+# The MAN_EXTENSION tag determines the extension that is added to the generated
+# man pages. In case the manual section does not start with a number, the number
+# 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
+# optional.
+# The default value is: .3.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_EXTENSION          = .3
+
+# The MAN_SUBDIR tag determines the name of the directory created within
+# MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
+# MAN_EXTENSION with the initial . removed.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_SUBDIR             =
+
+# If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
+# will generate one additional man file for each entity documented in the real
+# man page(s). These additional files only source the real man page, but without
+# them the man command would be unable to find the correct page.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_LINKS              = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that
+# captures the structure of the code including all documentation.
+# The default value is: NO.
+
+GENERATE_XML           = YES
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: xml.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_OUTPUT             = "${DOXYGEN_OUTPUT_PREFIX}/xml"
+
+# If the XML_PROGRAMLISTING tag is set to YES, doxygen will dump the program
+# listings (including syntax highlighting and cross-referencing information) to
+# the XML output. Note that enabling this will significantly increase the size
+# of the XML output.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_PROGRAMLISTING     = YES
+
+# If the XML_NS_MEMB_FILE_SCOPE tag is set to YES, doxygen will include
+# namespace members in file scope as well, matching the HTML output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_NS_MEMB_FILE_SCOPE = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the DOCBOOK output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_DOCBOOK tag is set to YES, doxygen will generate Docbook files
+# that can be used to generate PDF.
+# The default value is: NO.
+
+GENERATE_DOCBOOK       = NO
+
+# The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
+# front of it.
+# The default directory is: docbook.
+# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
+
+DOCBOOK_OUTPUT         = "${DOXYGEN_OUTPUT_PREFIX}/docbook"
+
+#---------------------------------------------------------------------------
+# Configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES, doxygen will generate an
+# AutoGen Definitions (see http://autogen.sourceforge.net/) file that captures
+# the structure of the code including all documentation. Note that this feature
+# is still experimental and incomplete at the moment.
+# The default value is: NO.
+
+GENERATE_AUTOGEN_DEF   = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES, doxygen will generate a Perl module
+# file that captures the structure of the code including all documentation.
+#
+# Note that this feature is still experimental and incomplete at the moment.
+# The default value is: NO.
+
+GENERATE_PERLMOD       = NO
+
+# If the PERLMOD_LATEX tag is set to YES, doxygen will generate the necessary
+# Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
+# output from the Perl module output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_LATEX          = NO
+
+# If the PERLMOD_PRETTY tag is set to YES, the Perl module output will be nicely
+# formatted so it can be parsed by a human reader. This is useful if you want to
+# understand what is going on. On the other hand, if this tag is set to NO, the
+# size of the Perl module output will be much smaller and Perl will parse it
+# just the same.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_PRETTY         = YES
+
+# The names of the make variables in the generated doxyrules.make file are
+# prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
+# so different doxyrules.make files included by the same Makefile don't
+# overwrite each other's variables.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_MAKEVAR_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES, doxygen will evaluate all
+# C-preprocessor directives found in the sources and include files.
+# The default value is: YES.
+
+ENABLE_PREPROCESSING   = YES
+
+# If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
+# in the source code. If set to NO, only conditional compilation will be
+# performed. Macro expansion can be done in a controlled way by setting
+# EXPAND_ONLY_PREDEF to YES.
+# The default value is: NO.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+MACRO_EXPANSION        = YES
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
+# the macro expansion is limited to the macros specified with the PREDEFINED and
+# EXPAND_AS_DEFINED tags.
+# The default value is: NO.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+EXPAND_ONLY_PREDEF     = YES
+
+# If the SEARCH_INCLUDES tag is set to YES, the include files in the
+# INCLUDE_PATH will be searched if a #include is found.
+# The default value is: YES.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+SEARCH_INCLUDES        = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that
+# contain include files that are not input files but should be processed by the
+# preprocessor. Note that the INCLUDE_PATH is not recursive, so the setting of
+# RECURSIVE has no effect here.
+# This tag requires that the tag SEARCH_INCLUDES is set to YES.
+
+INCLUDE_PATH           = "${CUDAQ_REPO_ROOT}/build/include" \
+                         "${CUDAQ_REPO_ROOT}/build/include/cudaq/Optimizer/CodeGen" \
+                         "${CUDAQ_REPO_ROOT}/build/include/cudaq/Optimizer/Transforms" \
+                         "${CUDAQ_REPO_ROOT}/build/include/cudaq/Optimizer/Dialect/CC" \
+                         "${CUDAQ_REPO_ROOT}/build/include/cudaq/Optimizer/Dialect/Quake"
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
+# patterns (like *.h and *.hpp) to filter out the header-files in the
+# directories. If left blank, the patterns specified with FILE_PATTERNS will be
+# used.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+INCLUDE_FILE_PATTERNS  =
+
+# The PREDEFINED tag can be used to specify one or more macro names that are
+# defined before the preprocessor is started (similar to the -D option of e.g.
+# gcc). The argument of the tag is a list of macros of the form: name or
+# name=definition (no spaces). If the definition and the "=" are omitted, "=1"
+# is assumed. To prevent a macro definition from being undefined via #undef or
+# recursively expanded use the := operator instead of the = operator.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+PREDEFINED             = __attribute__(x)=
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
+# tag can be used to specify a list of macro names that should be expanded. The
+# macro definition that is found in the sources will be used. Use the PREDEFINED
+# tag if you want to use a different macro definition that overrules the
+# definition found in the source code.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+EXPAND_AS_DEFINED      =
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
+# remove all references to function-like macros that are alone on a line, have
+# an all uppercase name, and do not end with a semicolon. Such function macros
+# are typically used for boiler-plate code, and will confuse the parser if not
+# removed.
+# The default value is: YES.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+SKIP_FUNCTION_MACROS   = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to external references
+#---------------------------------------------------------------------------
+
+# The TAGFILES tag can be used to specify one or more tag files. For each tag
+# file the location of the external documentation should be added. The format of
+# a tag file without this location is as follows:
+# TAGFILES = file1 file2 ...
+# Adding location for the tag files is done as follows:
+# TAGFILES = file1=loc1 "file2 = loc2" ...
+# where loc1 and loc2 can be relative or absolute paths or URLs. See the
+# section "Linking to external documentation" for more information about the use
+# of tag files.
+# Note: Each tag file must have a unique name (where the name does NOT include
+# the path). If a tag file is not located in the directory in which doxygen is
+# run, you must also specify the path to the tagfile here.
+
+TAGFILES               =
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create a
+# tag file that is based on the input files it reads. See section "Linking to
+# external documentation" for more information about the usage of tag files.
+
+GENERATE_TAGFILE       =
+
+# If the ALLEXTERNALS tag is set to YES, all external class will be listed in
+# the class index. If set to NO, only the inherited external classes will be
+# listed.
+# The default value is: NO.
+
+ALLEXTERNALS           = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES, all external groups will be listed
+# in the modules index. If set to NO, only the current project's groups will be
+# listed.
+# The default value is: YES.
+
+EXTERNAL_GROUPS        = YES
+
+# If the EXTERNAL_PAGES tag is set to YES, all external pages will be listed in
+# the related pages index. If set to NO, only the current project's pages will
+# be listed.
+# The default value is: YES.
+
+EXTERNAL_PAGES         = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+
+# You can include diagrams made with dia in doxygen documentation. Doxygen will
+# then run dia to produce the diagram and insert it in the documentation. The
+# DIA_PATH tag allows you to specify the directory where the dia binary resides.
+# If left empty dia is assumed to be found in the default search path.
+
+DIA_PATH               =
+
+# If set to YES the inheritance and collaboration graphs will hide inheritance
+# and usage relations if the target is undocumented or is not a class.
+# The default value is: YES.
+
+HIDE_UNDOC_RELATIONS   = YES
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
+# available from the path. This tool is part of Graphviz (see:
+# http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent
+# Bell Labs. The other options in this section have no effect if this option is
+# set to NO
+# The default value is: NO.
+
+HAVE_DOT               = NO
+
+# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed
+# to run in parallel. When set to 0 doxygen will base this on the number of
+# processors available in the system. You can set it explicitly to a value
+# larger than 0 to get control over the balance between CPU load and processing
+# speed.
+# Minimum value: 0, maximum value: 32, default value: 0.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_NUM_THREADS        = 0
+
+# DOT_COMMON_ATTR is common attributes for nodes, edges and labels of
+# subgraphs. When you want a differently looking font in the dot files that
+# doxygen generates you can specify fontname, fontcolor and fontsize attributes.
+# For details please see <a href=https://graphviz.org/doc/info/attrs.html>Node,
+# Edge and Graph Attributes specification</a> You need to make sure dot is able
+# to find the font, which can be done by putting it in a standard location or by
+# setting the DOTFONTPATH environment variable or by setting DOT_FONTPATH to the
+# directory containing the font. Default graphviz fontsize is 14.
+# The default value is: fontname=Helvetica,fontsize=10.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_COMMON_ATTR        = "fontname=Helvetica,fontsize=10"
+
+# DOT_EDGE_ATTR is concatenated with DOT_COMMON_ATTR. For elegant style you can
+# add 'arrowhead=open, arrowtail=open, arrowsize=0.5'. <a
+# href=https://graphviz.org/doc/info/arrows.html>Complete documentation about
+# arrows shapes.</a>
+# The default value is: labelfontname=Helvetica,labelfontsize=10.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_EDGE_ATTR          = "labelfontname=Helvetica,labelfontsize=10"
+
+# DOT_NODE_ATTR is concatenated with DOT_COMMON_ATTR. For view without boxes
+# around nodes set 'shape=plain' or 'shape=plaintext' <a
+# href=https://www.graphviz.org/doc/info/shapes.html>Shapes specification</a>
+# The default value is: shape=box,height=0.2,width=0.4.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_NODE_ATTR          = "shape=box,height=0.2,width=0.4"
+
+# You can set the path where dot can find font specified with fontname in
+# DOT_COMMON_ATTR and others dot attributes.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTPATH           =
+
+# If the CLASS_GRAPH tag is set to YES (or GRAPH) then doxygen will generate a
+# graph for each documented class showing the direct and indirect inheritance
+# relations. In case HAVE_DOT is set as well dot will be used to draw the graph,
+# otherwise the built-in generator will be used. If the CLASS_GRAPH tag is set
+# to TEXT the direct and indirect inheritance relations will be shown as texts /
+# links.
+# Possible values are: NO, YES, TEXT and GRAPH.
+# The default value is: YES.
+
+CLASS_GRAPH            = TEXT
+
+# If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
+# graph for each documented class showing the direct and indirect implementation
+# dependencies (inheritance, containment, and class references variables) of the
+# class with other documented classes.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+COLLABORATION_GRAPH    = YES
+
+# If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
+# groups, showing the direct groups dependencies. See also the chapter Grouping
+# in the manual.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GROUP_GRAPHS           = YES
+
+# If the UML_LOOK tag is set to YES, doxygen will generate inheritance and
+# collaboration diagrams in a style similar to the OMG's Unified Modeling
+# Language.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+UML_LOOK               = NO
+
+# If the UML_LOOK tag is enabled, the fields and methods are shown inside the
+# class node. If there are many fields or methods and many nodes the graph may
+# become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the
+# number of items for each type to make the size more manageable. Set this to 0
+# for no limit. Note that the threshold may be exceeded by 50% before the limit
+# is enforced. So when you set the threshold to 10, up to 15 fields may appear,
+# but if the number exceeds 15, the total amount of fields shown is limited to
+# 10.
+# Minimum value: 0, maximum value: 100, default value: 10.
+# This tag requires that the tag UML_LOOK is set to YES.
+
+UML_LIMIT_NUM_FIELDS   = 10
+
+# If the DOT_UML_DETAILS tag is set to NO, doxygen will show attributes and
+# methods without types and arguments in the UML graphs. If the DOT_UML_DETAILS
+# tag is set to YES, doxygen will add type and arguments for attributes and
+# methods in the UML graphs. If the DOT_UML_DETAILS tag is set to NONE, doxygen
+# will not generate fields with class member information in the UML graphs. The
+# class diagrams will look similar to the default class diagrams but using UML
+# notation for the relationships.
+# Possible values are: NO, YES and NONE.
+# The default value is: NO.
+# This tag requires that the tag UML_LOOK is set to YES.
+
+DOT_UML_DETAILS        = NO
+
+# The DOT_WRAP_THRESHOLD tag can be used to set the maximum number of characters
+# to display on a single line. If the actual line length exceeds this threshold
+# significantly it will wrapped across multiple lines. Some heuristics are apply
+# to avoid ugly line breaks.
+# Minimum value: 0, maximum value: 1000, default value: 17.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_WRAP_THRESHOLD     = 17
+
+# If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and
+# collaboration graphs will show the relations between templates and their
+# instances.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+TEMPLATE_RELATIONS     = NO
+
+# If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to
+# YES then doxygen will generate a graph for each documented file showing the
+# direct and indirect include dependencies of the file with other documented
+# files.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INCLUDE_GRAPH          = YES
+
+# If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are
+# set to YES then doxygen will generate a graph for each documented file showing
+# the direct and indirect include dependencies of the file with other documented
+# files.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INCLUDED_BY_GRAPH      = YES
+
+# If the CALL_GRAPH tag is set to YES then doxygen will generate a call
+# dependency graph for every global function or class method.
+#
+# Note that enabling this option will significantly increase the time of a run.
+# So in most cases it will be better to enable call graphs for selected
+# functions only using the \callgraph command. Disabling a call graph can be
+# accomplished by means of the command \hidecallgraph.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CALL_GRAPH             = NO
+
+# If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
+# dependency graph for every global function or class method.
+#
+# Note that enabling this option will significantly increase the time of a run.
+# So in most cases it will be better to enable caller graphs for selected
+# functions only using the \callergraph command. Disabling a caller graph can be
+# accomplished by means of the command \hidecallergraph.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CALLER_GRAPH           = NO
+
+# If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
+# hierarchy of all classes instead of a textual one.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GRAPHICAL_HIERARCHY    = YES
+
+# If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
+# dependencies a directory has on other directories in a graphical way. The
+# dependency relations are determined by the #include relations between the
+# files in the directories.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DIRECTORY_GRAPH        = YES
+
+# The DIR_GRAPH_MAX_DEPTH tag can be used to limit the maximum number of levels
+# of child directories generated in directory dependency graphs by dot.
+# Minimum value: 1, maximum value: 25, default value: 1.
+# This tag requires that the tag DIRECTORY_GRAPH is set to YES.
+
+DIR_GRAPH_MAX_DEPTH    = 1
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
+# generated by dot. For an explanation of the image formats see the section
+# output formats in the documentation of the dot tool (Graphviz (see:
+# http://www.graphviz.org/)).
+# Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
+# to make the SVG files visible in IE 9+ (other browsers do not have this
+# requirement).
+# Possible values are: png, jpg, gif, svg, png:gd, png:gd:gd, png:cairo,
+# png:cairo:gd, png:cairo:cairo, png:cairo:gdiplus, png:gdiplus and
+# png:gdiplus:gdiplus.
+# The default value is: png.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_IMAGE_FORMAT       = png
+
+# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
+# enable generation of interactive SVG images that allow zooming and panning.
+#
+# Note that this requires a modern browser other than Internet Explorer. Tested
+# and working are Firefox, Chrome, Safari, and Opera.
+# Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make
+# the SVG files visible. Older versions of IE do not have SVG support.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INTERACTIVE_SVG        = NO
+
+# The DOT_PATH tag can be used to specify the path where the dot tool can be
+# found. If left blank, it is assumed the dot tool can be found in the path.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_PATH               =
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that
+# contain dot files that are included in the documentation (see the \dotfile
+# command).
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOTFILE_DIRS           =
+
+# The MSCFILE_DIRS tag can be used to specify one or more directories that
+# contain msc files that are included in the documentation (see the \mscfile
+# command).
+
+MSCFILE_DIRS           =
+
+# The DIAFILE_DIRS tag can be used to specify one or more directories that
+# contain dia files that are included in the documentation (see the \diafile
+# command).
+
+DIAFILE_DIRS           =
+
+# When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the
+# path where java can find the plantuml.jar file or to the filename of jar file
+# to be used. If left blank, it is assumed PlantUML is not used or called during
+# a preprocessing step. Doxygen will generate a warning when it encounters a
+# \startuml command in this case and will not generate output for the diagram.
+
+PLANTUML_JAR_PATH      =
+
+# When using plantuml, the PLANTUML_CFG_FILE tag can be used to specify a
+# configuration file for plantuml.
+
+PLANTUML_CFG_FILE      =
+
+# When using plantuml, the specified paths are searched for files specified by
+# the !include statement in a plantuml block.
+
+PLANTUML_INCLUDE_PATH  =
+
+# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
+# that will be shown in the graph. If the number of nodes in a graph becomes
+# larger than this value, doxygen will truncate the graph, which is visualized
+# by representing a node as a red box. Note that doxygen if the number of direct
+# children of the root node in a graph is already larger than
+# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
+# the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
+# Minimum value: 0, maximum value: 10000, default value: 50.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_GRAPH_MAX_NODES    = 50
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs
+# generated by dot. A depth value of 3 means that only nodes reachable from the
+# root by following a path via at most 3 edges will be shown. Nodes that lay
+# further from the root node will be omitted. Note that setting this option to 1
+# or 2 may greatly reduce the computation time needed for large code bases. Also
+# note that the size of a graph can be further restricted by
+# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
+# Minimum value: 0, maximum value: 1000, default value: 0.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+MAX_DOT_GRAPH_DEPTH    = 0
+
+# Set the DOT_MULTI_TARGETS tag to YES to allow dot to generate multiple output
+# files in one run (i.e. multiple -o and -T options on the command line). This
+# makes dot run faster, but since only newer versions of dot (>1.8.10) support
+# this, this feature is disabled by default.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_MULTI_TARGETS      = NO
+
+# If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
+# explaining the meaning of the various boxes and arrows in the dot generated
+# graphs.
+# Note: This tag requires that UML_LOOK isn't set, i.e. the doxygen internal
+# graphical representation for inheritance and collaboration diagrams is used.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GENERATE_LEGEND        = YES
+
+# If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate
+# files that are used to generate the various graphs.
+#
+# Note: This setting is not only used for dot files but also for msc temporary
+# files.
+# The default value is: YES.
+
+DOT_CLEANUP            = YES
diff --git a/pr-2241/README.md b/pr-2241/README.md
new file mode 100644
index 0000000000..0b41e6f344
--- /dev/null
+++ b/pr-2241/README.md
@@ -0,0 +1,75 @@
+# CUDA-Q Documentation
+
+This folder contains tools and content to build the CUDA-Q documentation.
+The [script for building docs](../scripts/build_docs.sh) can be used to build
+the complete CUDA-Q documentation. Please see the comment in that script
+for more detail.
+
+We use [Sphinx](https://www.sphinx-doc.org/) to produce documentation in HTML
+format. This documentation includes conceptual documentation in the form of
+Markdown or reStructuredText format, API documentation generated based on doc
+comments in the source code, as well as potentially source code examples and
+snippets. Unfortunately, syntax highlighting for MLIR code snippets is currently
+not available in [Pygments](https://pygments.org/languages/).
+
+## API Documentation
+
+We use [Sphinx](https://www.sphinx-doc.org/) to include documentation defined in
+the form of doc comments in the source code for all of our APIs. The build is
+configured by the settings in the [sphinx/conf.py](./sphinx/conf.py) file.
+
+- **C++ source code**: <br/>
+  As part of the build [Doxygen](https://www.doxygen.org/) is used to generated
+  documentation based on doc comments. The documentation generation is
+  configured in the [Doxyfile.in](./Doxyfile.in) file - see the manual for
+  [possible configurations](https://www.doxygen.nl/manual/config.html). Our
+  build replaces the environment variables used in that file to produce the
+  final `Doxyfile` with which `doxygen` is invoked. We use the [Breathe
+  extension](https://breathe.readthedocs.io/) for Sphinx to incorporate content
+  from the generated XML files in our docs.
+
+- **TableGen files**: <br/>
+  Our CMake files define the `cudaq-doc` target that produces Markdown files
+  containing documentation for
+  [TableGen](https://llvm.org/docs/TableGen/index.html) files. We use the
+  [MyST-Parser extension](https://myst-parser.readthedocs.io/) for Sphinx to
+  incorporate content from the generated Markdown files in our docs.
+
+- **Python bindings**: <br/>
+  We use [pybind11](https://github.com/pybind/pybind11) to define Python
+  bindings for the CUDA-Q API. Doc comments are defined as part of
+  defining these bindings in C++. To incorporate the API documentation, the
+  `cudaq` Python package needs to be built and installed prior to generating the
+  CUDA-Q documentation. The [build_docs.sh](../scripts/build_docs.sh)
+  script will automatically do that if necessary. This project generates
+  ReStructuredText documentation from Python `docstrings` using `autodoc`.
+  The generated `.rst` files are in `docs/source/apidoc`. The files are
+  generated automatically by `doc-build` and `doc-clean` will remove them.
+
+## Sphinx Extensions
+
+The extensions we use to generate API docs are outlined and linked in the
+section above. The full list of built-in Sphinx tensions can be found
+[here](https://www.sphinx-doc.org/en/master/usage/extensions/index.html). The
+list of extensions that are enabled for building CUDA-Q documentation is
+defined by the value of the `extensions` configuration in
+[conf.py](./sphinx/conf.py).
+
+## References
+
+Additional links that may be helpful that are not listed above:
+
+- [References and automatic link generation in
+  Doxygen](https://www.star.bnl.gov/public/comp/sofi/doxygen/autolink.html)
+- [Using Napoleon style for Python doc
+  comments](https://docs.softwareheritage.org/devel/contributing/sphinx.html)
+- [Cross-referencing Python
+  objects](https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#cross-referencing-python-objects)
+- [Cross-referencing C++
+  objects](https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#cross-referencing)
+- [Sphinx configuration
+  options](https://www.sphinx-doc.org/en/master/usage/configuration.html)
+- [Syntax highlighting in inline
+  code](https://sphinxawesome.xyz/demo/inline-code/#syntax-highlighting-in-inline-code)
+- [Test examples in Python
+  documentation](https://docs.python.org/3/library/doctest.html)
diff --git a/pr-2241/_images/Bloch_sphere.png b/pr-2241/_images/Bloch_sphere.png
new file mode 100644
index 0000000000..36d9e393c1
Binary files /dev/null and b/pr-2241/_images/Bloch_sphere.png differ
diff --git a/pr-2241/_images/circsplit.png b/pr-2241/_images/circsplit.png
new file mode 100644
index 0000000000..785dda635b
Binary files /dev/null and b/pr-2241/_images/circsplit.png differ
diff --git a/pr-2241/_images/circuit_encoding.png b/pr-2241/_images/circuit_encoding.png
new file mode 100644
index 0000000000..20a889f9e6
Binary files /dev/null and b/pr-2241/_images/circuit_encoding.png differ
diff --git a/pr-2241/_images/circuit_pdf.png b/pr-2241/_images/circuit_pdf.png
new file mode 100644
index 0000000000..b5c85f495d
Binary files /dev/null and b/pr-2241/_images/circuit_pdf.png differ
diff --git a/pr-2241/_images/deutsch.png b/pr-2241/_images/deutsch.png
new file mode 100644
index 0000000000..6790e19328
Binary files /dev/null and b/pr-2241/_images/deutsch.png differ
diff --git a/pr-2241/_images/dialects.png b/pr-2241/_images/dialects.png
new file mode 100644
index 0000000000..9890d3d6dd
Binary files /dev/null and b/pr-2241/_images/dialects.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_Divisive_clustering_11_0.png b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_11_0.png
new file mode 100644
index 0000000000..60fd27f546
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_11_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_Divisive_clustering_29_0.png b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_29_0.png
new file mode 100644
index 0000000000..c32b1924a5
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_29_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_Divisive_clustering_31_0.png b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_31_0.png
new file mode 100644
index 0000000000..a37b6b65a9
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_31_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_Divisive_clustering_33_0.png b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_33_0.png
new file mode 100644
index 0000000000..de8f7919d5
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_33_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_Divisive_clustering_35_0.png b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_35_0.png
new file mode 100644
index 0000000000..45758e2697
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_35_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_Divisive_clustering_37_0.png b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_37_0.png
new file mode 100644
index 0000000000..e0c354941b
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_Divisive_clustering_37_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_afqmc_22_1.png b/pr-2241/_images/examples_python_tutorials_afqmc_22_1.png
new file mode 100644
index 0000000000..b4bfb3f42e
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_afqmc_22_1.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_cost_minimization_9_1.png b/pr-2241/_images/examples_python_tutorials_cost_minimization_9_1.png
new file mode 100644
index 0000000000..170e1e467d
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_cost_minimization_9_1.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_hybrid_qnns_15_0.png b/pr-2241/_images/examples_python_tutorials_hybrid_qnns_15_0.png
new file mode 100644
index 0000000000..e59b78afb1
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_hybrid_qnns_15_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_hybrid_qnns_9_0.png b/pr-2241/_images/examples_python_tutorials_hybrid_qnns_9_0.png
new file mode 100644
index 0000000000..4ee8bc793b
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_hybrid_qnns_9_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_maximum_vertex_weight_clique_10_0.png b/pr-2241/_images/examples_python_tutorials_maximum_vertex_weight_clique_10_0.png
new file mode 100644
index 0000000000..6b284b3f8b
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_maximum_vertex_weight_clique_10_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_21_0.png b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_21_0.png
new file mode 100644
index 0000000000..92721393db
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_21_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_27_1.png b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_27_1.png
new file mode 100644
index 0000000000..2b68c41ef7
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_27_1.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_28_0.png b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_28_0.png
new file mode 100644
index 0000000000..c413082e94
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_28_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_32_0.png b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_32_0.png
new file mode 100644
index 0000000000..8635ca32be
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_32_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_35_0.png b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_35_0.png
new file mode 100644
index 0000000000..838f7a9f7a
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_readout_error_mitigation_35_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_unitary_compilation_41_0.png b/pr-2241/_images/examples_python_tutorials_unitary_compilation_41_0.png
new file mode 100644
index 0000000000..e21507a84a
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_unitary_compilation_41_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_visualization_11_0.png b/pr-2241/_images/examples_python_tutorials_visualization_11_0.png
new file mode 100644
index 0000000000..3adccc2bf2
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_visualization_11_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_visualization_13_0.png b/pr-2241/_images/examples_python_tutorials_visualization_13_0.png
new file mode 100644
index 0000000000..82ab816fd5
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_visualization_13_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_visualization_17_0.png b/pr-2241/_images/examples_python_tutorials_visualization_17_0.png
new file mode 100644
index 0000000000..8cd0084371
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_visualization_17_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_visualization_7_0.png b/pr-2241/_images/examples_python_tutorials_visualization_7_0.png
new file mode 100644
index 0000000000..401ff99b73
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_visualization_7_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_visualization_9_0.png b/pr-2241/_images/examples_python_tutorials_visualization_9_0.png
new file mode 100644
index 0000000000..b88aa6e714
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_visualization_9_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_vqe_11_0.png b/pr-2241/_images/examples_python_tutorials_vqe_11_0.png
new file mode 100644
index 0000000000..9a453a6b50
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_vqe_11_0.png differ
diff --git a/pr-2241/_images/examples_python_tutorials_vqe_water_active_space_4_3.png b/pr-2241/_images/examples_python_tutorials_vqe_water_active_space_4_3.png
new file mode 100644
index 0000000000..f2af0ae9cb
Binary files /dev/null and b/pr-2241/_images/examples_python_tutorials_vqe_water_active_space_4_3.png differ
diff --git a/pr-2241/_images/getToWork.png b/pr-2241/_images/getToWork.png
new file mode 100644
index 0000000000..06eee986fb
Binary files /dev/null and b/pr-2241/_images/getToWork.png differ
diff --git a/pr-2241/_images/hsplit.png b/pr-2241/_images/hsplit.png
new file mode 100644
index 0000000000..b07d4a7e9a
Binary files /dev/null and b/pr-2241/_images/hsplit.png differ
diff --git a/pr-2241/_images/hybrid.png b/pr-2241/_images/hybrid.png
new file mode 100644
index 0000000000..1357c39c96
Binary files /dev/null and b/pr-2241/_images/hybrid.png differ
diff --git a/pr-2241/_images/inverse_qft.png b/pr-2241/_images/inverse_qft.png
new file mode 100644
index 0000000000..1a31e0cd12
Binary files /dev/null and b/pr-2241/_images/inverse_qft.png differ
diff --git a/pr-2241/_images/max-cut-illustration.png b/pr-2241/_images/max-cut-illustration.png
new file mode 100644
index 0000000000..ad2760b46f
Binary files /dev/null and b/pr-2241/_images/max-cut-illustration.png differ
diff --git a/pr-2241/_images/nvqpp_workflow.png b/pr-2241/_images/nvqpp_workflow.png
new file mode 100644
index 0000000000..2880e61675
Binary files /dev/null and b/pr-2241/_images/nvqpp_workflow.png differ
diff --git a/pr-2241/_images/oracle.png b/pr-2241/_images/oracle.png
new file mode 100644
index 0000000000..b29f12bd4c
Binary files /dev/null and b/pr-2241/_images/oracle.png differ
diff --git a/pr-2241/_images/orca_tbi.png b/pr-2241/_images/orca_tbi.png
new file mode 100644
index 0000000000..10907b1aa0
Binary files /dev/null and b/pr-2241/_images/orca_tbi.png differ
diff --git a/pr-2241/_images/pipeline_simplified.png b/pr-2241/_images/pipeline_simplified.png
new file mode 100644
index 0000000000..206be3f032
Binary files /dev/null and b/pr-2241/_images/pipeline_simplified.png differ
diff --git a/pr-2241/_images/qaoa-circuit-layers.png b/pr-2241/_images/qaoa-circuit-layers.png
new file mode 100644
index 0000000000..52671468c6
Binary files /dev/null and b/pr-2241/_images/qaoa-circuit-layers.png differ
diff --git a/pr-2241/_images/qaoa-problem-kernel.png b/pr-2241/_images/qaoa-problem-kernel.png
new file mode 100644
index 0000000000..c6ccd197df
Binary files /dev/null and b/pr-2241/_images/qaoa-problem-kernel.png differ
diff --git a/pr-2241/_images/qft.png b/pr-2241/_images/qft.png
new file mode 100644
index 0000000000..4fde4eeda5
Binary files /dev/null and b/pr-2241/_images/qft.png differ
diff --git a/pr-2241/_images/shor_circuit.png b/pr-2241/_images/shor_circuit.png
new file mode 100644
index 0000000000..f6d284ebda
Binary files /dev/null and b/pr-2241/_images/shor_circuit.png differ
diff --git a/pr-2241/_sources/api/api.rst.txt b/pr-2241/_sources/api/api.rst.txt
new file mode 100644
index 0000000000..9a4cc41308
--- /dev/null
+++ b/pr-2241/_sources/api/api.rst.txt
@@ -0,0 +1,10 @@
+Code documentation
+******************
+
+.. toctree::
+  :caption: CUDA-Q API
+  :maxdepth: 1
+
+  C++ API <languages/cpp_api.rst>
+  Python API <languages/python_api.rst>
+  Quantum Operations <default_ops.rst>
\ No newline at end of file
diff --git a/pr-2241/_sources/api/default_ops.rst.txt b/pr-2241/_sources/api/default_ops.rst.txt
new file mode 100644
index 0000000000..bbd2b37fa0
--- /dev/null
+++ b/pr-2241/_sources/api/default_ops.rst.txt
@@ -0,0 +1,718 @@
+Quantum Operations
+******************************
+
+CUDA-Q provides a default set of quantum operations on qubits. 
+These operations can be used to define custom kernels and libraries.
+Since the set of quantum intrinsic operations natively supported on a specific target 
+depends on the backends architecture, the :code:`nvq++` compiler automatically
+decomposes the default operations into the appropriate set of intrinsic operations 
+for that target.
+
+The sections `Unitary Operations on Qubits`_ and `Measurements on Qubits`_ list the default set of quantum operations on qubits.
+
+Operations that implement unitary transformations of the quantum state are templated.
+The template argument allows to invoke the adjoint and controlled version of the quantum transformation, see the section on `Adjoint and Controlled Operations`_.
+
+CUDA-Q additionally provides overloads to support broadcasting of
+single-qubit operations across a vector of qubits.  For example,
+:code:`x(cudaq::qvector<>&)` flips the state of each qubit in the provided
+:code:`cudaq::qvector`. 
+
+
+Unitary Operations on Qubits
+=============================
+
+:code:`x`
+---------------------
+
+This operation implements the transformation defined by the Pauli-X matrix. It is also known as the quantum version of a `NOT`-gate.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # X = | 0  1 |
+        #     | 1  0 |
+        x(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // X = | 0  1 |
+        //     | 1  0 |
+        x(qubit);
+
+:code:`y`
+---------------------
+
+This operation implements the transformation defined by the Pauli-Y matrix.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Y = | 0  -i |
+        #     | i   0 |
+        y(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Y = | 0  -i |
+        //     | i   0 |
+        y(qubit);
+
+:code:`z`
+---------------------
+
+This operation implements the transformation defined by the Pauli-Z matrix.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Z = | 1   0 |
+        #     | 0  -1 |
+        z(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Z = | 1   0 |
+        //     | 0  -1 |
+        z(qubit);
+
+:code:`h`
+---------------------
+
+This operation is a rotation by π about the X+Z axis, and 
+enables one to create a superposition of computational basis states.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # H = (1 / sqrt(2)) * | 1   1 |
+        #                     | 1  -1 |
+        h(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // H = (1 / sqrt(2)) * | 1   1 |
+        //                     | 1  -1 |
+        h(qubit);
+
+:code:`r1`
+---------------------
+
+This operation is an arbitrary rotation about the :code:`|1>` state.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # R1(λ) = | 1     0    |
+        #         | 0  exp(iλ) |
+        r1(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // R1(λ) = | 1     0    |
+        //         | 0  exp(iλ) |
+        r1(std::numbers::pi, qubit);
+
+:code:`rx`
+---------------------
+
+This operation is an arbitrary rotation about the X axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Rx(θ) = |  cos(θ/2)  -isin(θ/2) |
+        #         | -isin(θ/2)  cos(θ/2)  |
+        rx(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Rx(θ) = |  cos(θ/2)  -isin(θ/2) |
+        //         | -isin(θ/2)  cos(θ/2)  |
+        rx(std::numbers::pi, qubit);
+
+:code:`ry`
+---------------------
+
+This operation is an arbitrary rotation about the Y axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Ry(θ) = | cos(θ/2)  -sin(θ/2) |
+        #         | sin(θ/2)   cos(θ/2) |
+        ry(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Ry(θ) = | cos(θ/2)  -sin(θ/2) |
+        //         | sin(θ/2)   cos(θ/2) |
+        ry(std::numbers::pi, qubit);
+
+:code:`rz`
+---------------------
+
+This operation is an arbitrary rotation about the Z axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Rz(λ) = | exp(-iλ/2)      0     |
+        #         |     0       exp(iλ/2) |
+        rz(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Rz(λ) = | exp(-iλ/2)      0     |
+        //         |     0       exp(iλ/2) |
+        rz(std::numbers::pi, qubit);
+
+:code:`s`
+---------------------
+
+This operation applies to its target a rotation by π/2 about the Z axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # S = | 1   0 |
+        #     | 0   i |
+        s(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // S = | 1   0 |
+        //     | 0   i |
+        s(qubit);
+
+:code:`t`
+---------------------
+
+This operation applies to its target a π/4 rotation about the Z axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # T = | 1      0     |
+        #     | 0  exp(iπ/4) |
+        t(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // T = | 1      0     |
+        //     | 0  exp(iπ/4) |
+        t(qubit);
+
+:code:`swap`
+---------------------
+
+This operation swaps the states of two qubits.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit_1, qubit_2 = cudaq.qubit(), cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Swap = | 1 0 0 0 |
+        #        | 0 0 1 0 |
+        #        | 0 1 0 0 |
+        #        | 0 0 0 1 |
+        swap(qubit_1, qubit_2)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit_1, qubit_2;
+
+        // Apply the unitary transformation
+        // Swap = | 1 0 0 0 |
+        //        | 0 0 1 0 |
+        //        | 0 1 0 0 |
+        //        | 0 0 0 1 |
+        swap(qubit_1, qubit_2);
+
+:code:`u3`
+---------------------
+
+This operation applies the universal three-parameters operator to target qubit. The three parameters are Euler angles - theta (θ), phi (φ), and lambda (λ).
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # U3(θ,φ,λ) = | cos(θ/2)            -exp(iλ) * sin(θ/2)       |
+        #             | exp(iφ) * sin(θ/2)   exp(i(λ + φ)) * cos(θ/2) |
+        u3(np.pi, np.pi, np.pi / 2, q)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // U3(θ,φ,λ) = | cos(θ/2)            -exp(iλ) * sin(θ/2)       |
+        //             | exp(iφ) * sin(θ/2)   exp(i(λ + φ)) * cos(θ/2) |
+        u3(M_PI, M_PI, M_PI_2, q);
+
+
+Adjoint and Controlled Operations
+==================================
+
+.. tab:: Python
+
+    The :code:`adj` method of any gate can be used to invoke the 
+    `adjoint <https://en.wikipedia.org/wiki/Conjugate_transpose>`__ transformation:
+
+    .. code-block:: python
+
+        # Create a kernel and allocate a qubit in a |0> state.
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation defined by the matrix
+        # T = | 1      0     |
+        #     | 0  exp(iπ/4) |
+        # to the state of the qubit `q`:
+        t(qubit)
+
+        # Apply its adjoint transformation defined by the matrix
+        # T† = | 1      0     |
+        #      | 0  exp(-iπ/4) |
+        t.adj(qubit)
+        # `qubit` is now again in the initial state |0>.
+
+    The :code:`ctrl` method of any gate can be used to apply the transformation
+    conditional on the state of one or more control qubits, see also this 
+    `Wikipedia entry <https://en.wikipedia.org/wiki/Quantum_logic_gate#Controlled_gates>`__.
+
+    .. code-block:: python
+
+        # Create a kernel and allocate qubits in a |0> state.
+        ctrl_1, ctrl_2, target = cudaq.qubit(), cudaq.qubit(), cudaq.qubit()
+        # Create a superposition.
+        h(ctrl_1)
+        # `ctrl_1` is now in a state (|0> + |1>) / √2.
+
+        # Apply the unitary transformation
+        # | 1  0  0  0 |
+        # | 0  1  0  0 |
+        # | 0  0  0  1 |
+        # | 0  0  1  0 |
+        x.ctrl(ctrl_1, ctrl_2)
+        # `ctrl_1` and `ctrl_2` are in a state (|00> + |11>) / √2.
+
+        # Set the state of `target` to |1>:
+        x(target)
+        # Apply the transformation T only if both 
+        # control qubits are in a |1> state:
+        t.ctrl([ctrl_1, ctrl_2], target)
+        # The qubits ctrl_1, ctrl_2, and target are now in a state
+        # (|000> + exp(iπ/4)|111>) / √2.
+
+.. tab:: C++
+
+    The template argument :code:`cudaq::adj` can be used to invoke the 
+    `adjoint <https://en.wikipedia.org/wiki/Conjugate_transpose>`__ transformation:
+
+    .. code-block:: cpp
+
+        // Allocate a qubit in a |0> state.
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation defined by the matrix
+        // T = | 1      0     |
+        //     | 0  exp(iπ/4) |
+        // to the state of the qubit `q`:
+        t(qubit);
+
+        // Apply its adjoint transformation defined by the matrix
+        // T† = | 1      0     |
+        //      | 0  exp(-iπ/4) |
+        t<cudaq::adj>(qubit);
+        // Qubit `q` is now again in the initial state |0>.
+
+    The template argument :code:`cudaq::ctrl` can be used to apply the transformation
+    conditional on the state of one or more control qubits, see also this 
+    `Wikipedia entry <https://en.wikipedia.org/wiki/Quantum_logic_gate#Controlled_gates>`__.
+
+    .. code-block:: cpp
+
+        // Allocate qubits in a |0> state.
+        cudaq::qubit ctrl_1, ctrl_2, target;
+        // Create a superposition.
+        h(ctrl_1);
+        // Qubit ctrl_1 is now in a state (|0> + |1>) / √2.
+
+        // Apply the unitary transformation
+        // | 1  0  0  0 |
+        // | 0  1  0  0 |
+        // | 0  0  0  1 |
+        // | 0  0  1  0 |
+        x<cudaq::ctrl>(ctrl_1, ctrl_2);
+        // The qubits ctrl_1 and ctrl_2 are in a state (|00> + |11>) / √2.
+
+        // Set the state of `target` to |1>:
+        x(target);
+        // Apply the transformation T only if both 
+        // control qubits are in a |1> state:
+        t<cudaq::ctrl>(ctrl_1, ctrl_2, target);
+        // The qubits ctrl_1, ctrl_2, and target are now in a state
+        // (|000> + exp(iπ/4)|111>) / √2.
+
+
+Following common convention, by default the transformation is applied to the target qubit(s)
+if all control qubits are in a :code:`|1>` state. 
+However, that behavior can be changed to instead apply the transformation when a control qubit is in 
+a :code:`|0>` state by negating the polarity of the control qubit.
+The syntax for negating the polarity is the not-operator preceding the
+control qubit: 
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit c, q;
+        h(c);
+        x<cudaq::ctrl>(!c, q);
+        // The qubits c and q are in a state (|01> + |10>) / √2.
+
+This notation is only supported in the context of applying a controlled operation and is only valid for control qubits. For example, negating either of the target qubits in the
+:code:`swap` operation is not allowed.
+Negating the polarity of control qubits is similarly supported when using :code:`cudaq::control` to conditionally apply a custom quantum kernel.
+
+
+Measurements on Qubits
+=============================
+
+:code:`mz`
+---------------------
+
+This operation measures a qubit with respect to the computational basis, 
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-Z matrix.
+This is a non-linear transformation, and no template overloads are available.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+        mz(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+        mz(qubit);
+
+:code:`mx`
+---------------------
+
+This operation measures a qubit with respect to the Pauli-X basis, 
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-X matrix.
+This is a non-linear transformation, and no template overloads are available.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+        mx(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+        mx(qubit);
+
+:code:`my`
+---------------------
+
+This operation measures a qubit with respect to the Pauli-Y basis, 
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-Y matrix.
+This is a non-linear transformation, and no template overloads are available.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+        kernel.my(qubit)
+        
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+        my(qubit);
+
+
+User-Defined Custom Operations
+==============================
+
+Users can define a custom quantum operation by its unitary matrix. First use 
+the API to register a custom operation, outside of a CUDA-Q kernel. Then the 
+operation can be used within a CUDA-Q kernel like any of the built-in operations
+defined above.
+Custom operations are supported on qubits only (`qudit` with `level = 2`).
+
+.. tab:: Python
+
+    The :code:`cudaq.register_operation` API accepts an identifier string for 
+    the custom operation and its unitary matrix. The matrix can be a `list` or
+    `numpy` array of complex numbers. A 1D matrix is interpreted as row-major.
+    
+
+    .. code-block:: python
+
+        import cudaq
+        import numpy as np
+
+        cudaq.register_operation("custom_h", 1. / np.sqrt(2.) * np.array([1, 1, 1, -1]))
+
+        cudaq.register_operation("custom_x", np.array([0, 1, 1, 0]))
+
+        @cudaq.kernel
+        def bell():
+            qubits = cudaq.qvector(2)
+            custom_h(qubits[0])
+            custom_x.ctrl(qubits[0], qubits[1])
+
+        cudaq.sample(bell).dump()
+
+        
+.. tab:: C++
+
+    The macro :code:`CUDAQ_REGISTER_OPERATION` accepts a unique name for the 
+    operation, the number of target qubits, the number of rotation parameters 
+    (can be 0), and the unitary matrix as a 1D row-major `std::vector<complex>` 
+    representation.
+    
+    .. code-block:: cpp
+
+        #include <cudaq.h>
+
+        CUDAQ_REGISTER_OPERATION(custom_h, 1, 0,
+                                {M_SQRT1_2, M_SQRT1_2, M_SQRT1_2, -M_SQRT1_2})
+
+        CUDAQ_REGISTER_OPERATION(custom_x, 1, 0, {0, 1, 1, 0})
+
+        __qpu__ void bell_pair() {
+            cudaq::qubit q, r;
+            custom_h(q);
+            custom_x<cudaq::ctrl>(q, r);
+        }
+
+        int main() {
+            auto counts = cudaq::sample(bell_pair);
+            for (auto &[bits, count] : counts) {
+                printf("%s\n", bits.data());
+            }
+        }
+
+
+For multi-qubit operations, the matrix is interpreted with MSB qubit ordering,
+i.e. big-endian convention. The following example shows two different custom
+operations, each operating on 2 qubits.
+
+
+.. tab:: Python
+
+    .. literalinclude:: ../snippets/python/using/examples/two_qubit_custom_op.py
+      :language: python
+      :start-after: [Begin Docs]
+      :end-before: [End Docs]
+
+
+.. tab:: C++
+
+    .. literalinclude:: ../snippets/cpp/using/two_qubit_custom_op.cpp
+      :language: cpp
+      :start-after: [Begin Docs]
+      :end-before: [End Docs]
+
+
+.. note:: 
+
+  Custom operations are currently supported only on :doc:`../using/backends/simulators`.
+  Attempt to use with a hardware backend will result in runtime error.
+
+
+Photonic Operations on Qudits
+=============================
+
+These operations are valid only on the `photonics` target which does not support the quantum operations above.
+
+:code:`plus`
+---------------------
+
+This is a place-holder, to be updated later.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        q = qudit(3)
+        plus(q)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<3> q(1);
+        plus(q[0]);
+
+:code:`phase_shift`
+---------------------
+
+This is a place-holder, to be updated later.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        q = qudit(4)
+        phase_shift(q, 0.17)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<4> q(1);
+        phase_shift(q[0], 0.17);
+
+:code:`beam_splitter`
+---------------------
+
+This is a place-holder, to be updated later.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        q = [qudit(3) for _ in range(2)]
+        beam_splitter(q[0], q[1], 0.34)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<3> q(2);
+        beam_splitter(q[0], q[1], 0.34);
+
+:code:`mz`
+---------------------
+
+This operation returns the measurement results of the input qudit(s).
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qutrits = [qudit(3) for _ in range(2)]
+        mz(qutrits)
+
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<3> qutrits(2);
+        mz(qutrits);
diff --git a/pr-2241/_sources/api/languages/cpp_api.rst.txt b/pr-2241/_sources/api/languages/cpp_api.rst.txt
new file mode 100644
index 0000000000..99e0b2eb07
--- /dev/null
+++ b/pr-2241/_sources/api/languages/cpp_api.rst.txt
@@ -0,0 +1,233 @@
+CUDA-Q C++ API
+******************************
+
+Operators 
+=============
+
+.. doxygenclass:: cudaq::spin_op
+    :members:
+
+Quantum
+=========
+
+.. doxygenvariable:: cudaq::dyn
+
+.. doxygenclass:: cudaq::qudit
+    :members:
+
+.. doxygenclass:: cudaq::qreg
+    :members:
+
+.. doxygenclass:: cudaq::qvector
+    :members:
+
+.. doxygenclass:: cudaq::qspan
+    :members:
+
+.. doxygenclass:: cudaq::qview
+    :members:
+
+.. doxygentypedef:: cudaq::qubit
+    
+Common
+=========
+
+.. doxygenclass:: cudaq::observe_result
+    :members:
+
+.. doxygenclass:: cudaq::ExecutionContext
+    :members:
+
+.. doxygenclass:: cudaq::details::future
+    :members:
+
+.. doxygenclass:: cudaq::async_result
+    :members:
+
+
+.. doxygenstruct:: cudaq::ExecutionResult
+    :members:
+
+.. doxygenclass:: cudaq::sample_result
+    :members:
+
+.. doxygenclass:: cudaq::SimulationState
+
+.. doxygenstruct:: cudaq::SimulationState::Tensor
+    :members:
+
+.. doxygenenum:: cudaq::SimulationState::precision
+
+.. doxygenenum:: cudaq::simulation_precision
+
+.. doxygentypedef:: cudaq::tensor
+
+.. doxygentypedef:: cudaq::TensorStateData
+
+.. doxygentypedef:: cudaq::state_data
+
+.. doxygenclass:: cudaq::CusvState
+
+.. doxygenclass:: nvqir::MPSSimulationState
+
+.. doxygenclass:: nvqir::TensorNetSimulationState
+
+.. doxygenclass:: cudaq::RemoteSimulationState
+
+.. doxygenclass:: cudaq::registry::RegisteredType
+    :members:
+
+.. doxygenclass:: cudaq::complex_matrix
+    :members:
+
+.. doxygenclass:: cudaq::Trace
+
+.. doxygenfunction:: cudaq::range(ElementType total)
+.. doxygenfunction:: cudaq::range(ElementType begin, ElementType end, ElementType step)
+
+.. doxygenfunction:: cudaq::draw(QuantumKernel &&kernel, Args&&... args)
+
+.. doxygenclass:: cudaq::Resources
+
+.. doxygentypedef:: cudaq::complex_matrix::value_type
+
+Noise Modeling 
+================
+
+.. doxygenstruct:: cudaq::kraus_op
+    :members:
+
+.. doxygenclass:: cudaq::kraus_channel
+    :members:
+
+.. doxygenclass:: cudaq::amplitude_damping_channel
+    :members:
+
+.. doxygenclass:: cudaq::bit_flip_channel
+    :members:
+
+.. doxygenclass:: cudaq::phase_flip_channel
+    :members:
+
+.. doxygenclass:: cudaq::depolarization_channel
+    :members:
+
+.. doxygenclass:: cudaq::noise_model
+    :members:
+
+Kernel Builder
+===============
+
+.. doxygenclass:: cudaq::kernel_builder
+    :members:
+
+.. doxygenclass:: cudaq::QuakeValue
+    :members:
+
+.. doxygenclass:: cudaq::details::kernel_builder_base
+    :members:
+
+.. doxygenclass:: cudaq::details::KernelBuilderType
+    :members:
+
+Algorithms
+===========
+
+.. doxygenclass:: cudaq::optimizer
+    :members:
+
+.. doxygenclass:: cudaq::optimizable_function
+    :members:
+
+.. doxygentypedef:: cudaq::optimization_result
+
+.. doxygenclass:: cudaq::state
+    :members:
+
+.. doxygenclass:: cudaq::gradient
+    :members:
+
+.. doxygenclass:: cudaq::gradients::central_difference
+    :members:
+
+.. doxygenclass:: cudaq::gradients::parameter_shift
+    :members:
+
+.. doxygenclass:: cudaq::gradients::forward_difference
+    :members:
+
+Platform
+=========
+
+.. doxygenclass:: cudaq::QPU
+    :members:
+
+.. doxygenclass:: cudaq::BaseRemoteRESTQPU
+
+.. doxygenclass:: cudaq::BaseRemoteSimulatorQPU
+
+.. doxygenclass:: cudaq::BaseNvcfSimulatorQPU    
+
+.. doxygenclass:: cudaq::quantum_platform
+    :members:
+
+.. doxygenstruct:: cudaq::RemoteCapabilities
+    :members:
+
+.. doxygenclass:: cudaq::SerializedCodeExecutionContext
+
+.. doxygentypedef:: cudaq::QuantumTask
+
+.. doxygentypedef:: cudaq::QubitConnectivity
+
+.. doxygentypedef:: cudaq::QubitEdge
+
+.. doxygentypedef:: cudaq::KernelExecutionTask
+
+Utilities
+=========
+
+.. doxygentypedef:: cudaq::complex
+
+.. doxygentypedef:: cudaq::real 
+
+.. doxygenfunction:: cudaq::range(std::size_t)
+    
+Namespaces 
+===========
+
+.. doxygennamespace:: cudaq
+    :desc-only:
+
+.. doxygenfunction:: cudaq::num_available_gpus
+.. doxygenfunction:: cudaq::set_random_seed
+.. doxygenfunction:: cudaq::set_noise
+.. doxygenfunction:: cudaq::unset_noise
+
+.. doxygennamespace:: cudaq::details
+    :desc-only:
+
+.. doxygennamespace:: cudaq::registry
+    :desc-only:
+
+.. doxygennamespace:: cudaq::mpi
+    :desc-only:
+
+.. doxygenfunction:: cudaq::mpi::initialize()
+.. doxygenfunction:: cudaq::mpi::initialize(int argc, char **argv)
+.. doxygenfunction:: cudaq::mpi::is_initialized
+.. doxygenfunction:: cudaq::mpi::finalize
+.. doxygenfunction:: cudaq::mpi::rank
+.. doxygenfunction:: cudaq::mpi::num_ranks
+.. doxygenfunction:: cudaq::mpi::all_gather(std::vector<double> &global, const std::vector<double> &local)
+.. doxygenfunction:: cudaq::mpi::all_gather(std::vector<int> &global, const std::vector<int> &local)
+.. doxygenfunction:: cudaq::mpi::all_reduce(const T&, const Func&)
+.. doxygenfunction:: cudaq::mpi::all_reduce(const T &localValue, const BinaryFunction &function)
+.. doxygenfunction:: cudaq::mpi::broadcast(std::vector<double> &data, int rootRank)
+.. doxygenfunction:: cudaq::mpi::broadcast(std::string &data, int rootRank)
+
+.. doxygennamespace:: cudaq::orca
+    :desc-only:
+
+.. doxygenfunction:: cudaq::orca::sample(std::vector<std::size_t> &input_state, std::vector<std::size_t> &loop_lengths, std::vector<double> &bs_angles, int n_samples = 10000)
+.. doxygenfunction:: cudaq::orca::sample(std::vector<std::size_t> &input_state, std::vector<std::size_t> &loop_lengths, std::vector<double> &bs_angles, std::vector<double> &ps_angles, int n_samples = 10000)
diff --git a/pr-2241/_sources/api/languages/python_api.rst.txt b/pr-2241/_sources/api/languages/python_api.rst.txt
new file mode 100644
index 0000000000..1bd8884539
--- /dev/null
+++ b/pr-2241/_sources/api/languages/python_api.rst.txt
@@ -0,0 +1,235 @@
+CUDA-Q Python API
+******************************
+
+.. automodule:: cudaq
+
+Program Construction
+=============================
+
+.. autofunction:: cudaq::make_kernel
+.. [SKIP_TEST]: Reason - AttributeError: module 'cudaq' has no attribute 'from_state'
+.. .. autofunction:: cudaq::from_state
+
+.. autoclass:: cudaq::PyKernel
+.. autoclass:: cudaq::Kernel
+
+    .. automethod:: qalloc
+    .. automethod:: __str__
+    .. automethod:: __call__
+
+    .. automethod:: x
+    .. automethod:: cx
+    .. automethod:: y
+    .. automethod:: cy
+    .. automethod:: z
+    .. automethod:: cz
+    .. automethod:: h
+    .. automethod:: ch
+    .. automethod:: s
+    .. automethod:: sdg
+    .. automethod:: cs
+    .. automethod:: t
+    .. automethod:: tdg
+    .. automethod:: ct
+    .. automethod:: rx
+    .. automethod:: crx
+    .. automethod:: ry
+    .. automethod:: cry
+    .. automethod:: rz
+    .. automethod:: crz
+    .. automethod:: r1
+    .. automethod:: cr1
+    .. automethod:: swap
+    .. automethod:: cswap
+    .. automethod:: exp_pauli
+    .. automethod:: mx
+    .. automethod:: my
+    .. automethod:: mz
+    .. automethod:: c_if
+    .. automethod:: for_loop
+    .. automethod:: adjoint
+    .. automethod:: control
+    .. automethod:: apply_call
+    .. automethod:: u3
+
+.. autoclass:: cudaq::PyKernelDecorator
+    :members:
+    :special-members: __str__, __call__
+
+.. autofunction:: kernel
+    
+Kernel Execution
+=============================
+
+.. autofunction:: cudaq::sample
+.. autofunction:: cudaq::sample_async
+.. autofunction:: cudaq::observe
+.. autofunction:: cudaq::observe_async
+.. autofunction:: cudaq::get_state
+.. autofunction:: cudaq::get_state_async
+.. autofunction:: cudaq::vqe
+.. autofunction:: cudaq::draw
+.. autofunction:: cudaq::translate
+
+Backend Configuration
+=============================
+
+.. autofunction:: cudaq::has_target
+.. autofunction:: cudaq::get_target
+.. autofunction:: cudaq::get_targets
+.. autofunction:: cudaq::set_target
+.. autofunction:: cudaq::reset_target
+.. autofunction:: cudaq::set_noise
+.. autofunction:: cudaq::unset_noise
+.. automethod:: cudaq::initialize_cudaq
+.. automethod:: cudaq::num_available_gpus
+.. automethod:: cudaq::set_random_seed
+
+Data Types
+=============================
+
+.. autoclass:: cudaq::SimulationPrecision
+    :members:
+    
+.. autoclass:: cudaq::Target
+    :members:
+
+.. autoclass:: cudaq::State
+    :members:
+
+.. autoclass:: cudaq::Tensor
+
+.. autoclass:: cudaq::QuakeValue
+
+    .. automethod:: __add__
+    .. automethod:: __radd__
+    .. automethod:: __sub__
+    .. automethod:: __rsub__
+    .. automethod:: __neg__
+    .. automethod:: __mul__
+    .. automethod:: __rmul__
+    .. automethod:: __getitem__
+    .. automethod:: slice
+
+.. autoclass:: cudaq::qubit
+.. autoclass:: cudaq::qreg
+.. autoclass:: cudaq::qvector
+
+.. autoclass:: cudaq::ComplexMatrix
+    :members:
+    :special-members: __getitem__, __str__
+
+.. autoclass:: cudaq::SpinOperator
+    :members:
+
+    .. automethod:: __eq__
+    .. automethod:: __add__
+    .. automethod:: __radd__
+    .. automethod:: __sub__
+    .. automethod:: __rsub__
+    .. automethod:: __mul__
+    .. automethod:: __rmul__
+    .. automethod:: __iter__
+        
+.. autofunction:: cudaq::spin.i
+.. autofunction:: cudaq::spin.x
+.. autofunction:: cudaq::spin.y
+.. autofunction:: cudaq::spin.z
+
+.. autoclass:: cudaq::SampleResult
+    :members:
+    :special-members: __getitem__, __len__, __iter__
+
+.. autoclass:: cudaq::AsyncSampleResult
+    :members:
+
+.. autoclass:: cudaq::ObserveResult
+    :members:
+
+.. autoclass:: cudaq::AsyncObserveResult
+    :members:
+
+.. autoclass:: cudaq::AsyncStateResult
+    :members:
+
+.. autoclass:: cudaq::OptimizationResult
+    :members:
+
+
+Optimizers
+-----------------
+
+.. autoclass:: cudaq.optimizers::optimizer
+
+.. autoclass:: cudaq.optimizers::GradientDescent
+    :members:
+
+.. autoclass:: cudaq.optimizers::COBYLA
+    :members:
+
+.. autoclass:: cudaq.optimizers::NelderMead
+    :members:
+
+.. autoclass:: cudaq.optimizers::LBFGS
+    :members:
+
+Gradients
+-----------------
+
+.. autoclass:: cudaq.gradients::gradient
+    :members:
+
+.. autoclass:: cudaq.gradients::CentralDifference
+    :members:
+
+.. autoclass:: cudaq.gradients::ForwardDifference
+    :members:
+
+.. autoclass:: cudaq.gradients::ParameterShift
+    :members:
+
+Noisy Simulation
+-----------------
+
+.. autoclass:: cudaq::NoiseModel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::BitFlipChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::PhaseFlipChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::DepolarizationChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::AmplitudeDampingChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::KrausChannel
+    :members:
+    :special-members: __getitem__
+
+.. autoclass:: cudaq::KrausOperator
+    :members:
+
+MPI Submodule
+=============================
+
+.. automethod:: cudaq.mpi::initialize
+.. automethod:: cudaq.mpi::rank
+.. automethod:: cudaq.mpi::num_ranks
+.. automethod:: cudaq.mpi::all_gather
+.. automethod:: cudaq.mpi::broadcast
+.. automethod:: cudaq.mpi::is_initialized
+.. automethod:: cudaq.mpi::finalize
+
+ORCA Submodule
+=============================
+
+.. automethod:: cudaq.orca::sample
diff --git a/pr-2241/_sources/examples/python/tutorials/Divisive_clustering.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/Divisive_clustering.ipynb.txt
new file mode 100644
index 0000000000..bfb75e8bf4
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/Divisive_clustering.ipynb.txt
@@ -0,0 +1,1089 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Divisive Clustering With Coresets Using CUDA-Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This tutorial will explore a CUDA-Q implementation of recent research (ArXiv Paper: https://arxiv.org/pdf/2402.01529.pdf) performed by a team from the University of Edinburgh. This tutorial was jointly developed by NVIDIA and the authors so users can better understand their method and explore how CUDA-Q removed barriers to scaling. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The code for this tutorial is based off the MIT licensed code found here: https://github.com/Boniface316/bigdata_vqa"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Clustering is a common unsupervised learning technique aimed at grouping data with similar characteristics. The unique properties of quantum computers could allow for enhanced pattern finding in clustering applications and enable more reliable data analysis. However, quantum computers today are severely limited by qubit count and noise.  Performing practical clustering applications would require far too many qubits.  The Edinburgh team developed a new method (extending the work of Harrow) to leverage coresets for clustering applications on quantum computers and use far fewer qubits.  This tutorial will walk through an example using this approach for divisive clustering and emphasize the utility of CUDA-Q for scaling quantum simulations.\n",
+    "\n",
+    "The goal of divisive clustering is to begin with all data points as one set, and iteratively bipartition the data until each point is its own cluster.  The branching behavior of this process can be used to understand similarities in the data points.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# If you are running outside of a CUDA-Q container or CUDA-Q directory tree, you may need to uncomment these lines to fetch the files.\n",
+    "# If you are running inside a CUDA-Q tree, then this step can be skipped.\n",
+    "# !mkdir divisive_clustering_src\n",
+    "# !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py\n",
+    "# !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "!pip install mpi4py==3.1.6\n",
+    "!pip install networkx==2.8.8\n",
+    "!pip install pandas==2.2.2\n",
+    "!pip install scikit-learn==1.4.2\n",
+    "!pip install tqdm==4.66.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "\n",
+    "# Auxillary Imports\n",
+    "import os\n",
+    "import numpy as np\n",
+    "import networkx as nx\n",
+    "import pandas as pd\n",
+    "import matplotlib.pyplot as plt\n",
+    "import warnings\n",
+    "from typing import Tuple\n",
+    "from divisive_clustering_src.divisive_clustering import Coreset, DivisiveClustering, Dendrogram, Voironi_Tessalation\n",
+    "\n",
+    "warnings.filterwarnings(\"ignore\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The settings below are global parameters for the quantum simulation and can be toggled by the user.  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "circuit_depth = 1\n",
+    "max_iterations = 75\n",
+    "max_shots = 1000\n",
+    "np.random.seed(10)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "\n",
+    "Given a data set $X = (x_1, x_2, \\cdots, x_N)$, a coreset is weighted data set of much smaller size ($X', w$) that represents $X$ enough such that analysis of ($X', w$) can allow us to draw reasonable approximate conclusions about $X$. There are various approaches to build coresets. They can be found in Practical Coreset Construction for Machine Learning (https://arxiv.org/pdf/1703.06476.pdf) and New Streaming Algorithms for Coresets in Machine Learning (https://arxiv.org/pdf/1703.06476.pdf).\n",
+    "\n",
+    "\n",
+    "Essentially, coreset construction boils down to finding the optimal coreset size and weights given some error tolerance.  Given the constraints of a quantum computer, in this work, a coreset size is selected $a$ $priori$, and the error is determined for each model.\n",
+    "\n",
+    "\n",
+    "The following is an example $M=10$ coreset constructed from a 1000-point data set and loaded into a pandas data frame. See the image below where the coreset is represented by the black stars, the size of which corresponds to the weights.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "          X         Y     weights Name\n",
+      "0  7.028364  1.669787  234.230716    A\n",
+      "1  7.167441  0.354792  101.319288    B\n",
+      "2  1.022889 -0.921443  125.158339    C\n",
+      "3  2.706134 -2.636852   13.650774    D\n",
+      "4  6.998497  0.455847  116.758239    E\n",
+      "5  7.507918  0.630311  120.727176    F\n",
+      "6 -2.102508  2.297727   53.294127    G\n",
+      "7  5.722463  1.400433   77.415840    H\n",
+      "8 -1.425868  2.341136   42.847985    I\n",
+      "9  7.985373 -0.063209  240.116237    J\n"
+     ]
+    }
+   ],
+   "source": [
+    "raw_data = Coreset.create_dataset(1000)\n",
+    "coreset = Coreset(\n",
+    "    raw_data=raw_data,\n",
+    "    number_of_sampling_for_centroids=10,\n",
+    "    coreset_size=10,\n",
+    "    number_of_coresets_to_evaluate=4,\n",
+    "    coreset_method=\"BFL2\",\n",
+    ")\n",
+    "\n",
+    "\n",
+    "coreset_vectors, coreset_weights = coreset.get_best_coresets()\n",
+    "\n",
+    "coreset_df = pd.DataFrame(\n",
+    "    {\"X\": coreset_vectors[:, 0], \"Y\": coreset_vectors[:, 1], \"weights\": coreset_weights}\n",
+    ")\n",
+    "coreset_df[\"Name\"] = [chr(i + 65) for i in coreset_df.index]\n",
+    "print(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjUAAAHHCAYAAABHp6kXAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAACSRElEQVR4nO3dd1hTZ/sH8G8SIMwgIEtBlijiFmtbFYVqHbWOurVvlQ471NbRWu3b1tFfrW/VVm21jg7tckurtc5aUdS6tQ4UFyKiAoKyDZCc3x8xgZCc5GSejPtzXVyVk5NzHijn5D7Pcz/3I2AYhgEhhBBCiJ0T8t0AQgghhBBzoKCGEEIIIQ6BghpCCCGEOAQKagghhBDiECioIYQQQohDoKCGEEIIIQ6BghpCCCGEOAQKagghhBDiECioIYQQQohDoKCG2IW0tDQIBAKkpaXx3RSru3nzJgQCAdasWaNzP2v8jpTn2Lx5s8XOQcjs2bMhEAj4bgaxQxTUOJk1a9ZAIBCovlxcXNC4cWOkpKQgNzeX7+ZZxI4dOzB79my+m8GLtWvXYvHixXw3w2SG/hx79uzBq6++ilatWkEkEiEyMpJ1X7lcjvnz5yMqKgru7u5o06YN1q1bZ3qj7ZyzXjcpKSka98jw8HCMHDkSGRkZavsqg3xtXyNHjlTtl5SUhFatWuk87759+/DKK6+gWbNm8PT0RHR0NF577TXcvXvXIj+no3LhuwGEH5988gmioqLw6NEjHD16FGvWrMGhQ4dw4cIFuLu78908s9qxYweWLVvm8Dfobt26obKyEm5ubqpta9euxYULFzB58mT+GmYGhv4ca9euxYYNG9ChQwc0atRI574ffvgh/ve//2HcuHF44oknsHXrVowePVrjg8nZ8HndfPTRR5gxY4bVz6skFovx3XffAQBqampw/fp1rFixArt27UJGRobG39Q777yDJ554Qm2brkBam+nTp6OoqAjDhg1DbGwsbty4gaVLl2L79u04e/YsQkJCTPqZnAUFNU6qb9++6NixIwDgtddeQ8OGDfH5559j27ZtGD58OM+tI8YQCoUOF5Aa67PPPsO3334LV1dXPP/887hw4YLW/XJzc/HFF19gwoQJWLp0KQDF9dC9e3dMmzYNw4YNg0gksmbT1ZSXl8PLy4u38/PFxcUFLi78fTy5uLjgP//5j9q2p556Cs8//zz+/PNPjBs3Tu21xMREDB061KRzfvnll+jatSuEwtoBlD59+qB79+5YunQpPv30U5OO7yxo+IkAUFyUAHD9+nXVtqqqKsycORMJCQnw9fWFl5cXEhMTsX//frX3dujQAYMHD1bb1rp1awgEApw7d061bcOGDRAIBLh06ZLOtty+fRuDBg2Cl5cXgoKCMGXKFEilUo390tPTMWzYMDRp0gRisRjh4eGYMmUKKisrVfukpKRg2bJlAKDWNay0cOFCdO7cGQEBAfDw8EBCQgLnfBEu51e2wdvbG7m5uRg0aBC8vb0RGBiI9957DzKZTG3fhw8fIiUlBb6+vmjQoAHGjh2Lhw8fcmpP/ZyapKQk/Pnnn8jOzlb93HWfHr/++mu0bNkSnp6e8PPzQ8eOHbF27VpO55LJZPjvf/+LkJAQeHl5YcCAAcjJydHY79ixY+jTpw98fX3h6emJ7t274/Dhw2r7lJaWYvLkyYiMjIRYLEZQUBCeffZZnD59mtPPoU2jRo3g6uqq9+fYunUrqqurMX78eNU2gUCAt956C7dv38Y///yj9xiXL1/G8OHDERgYCA8PDzRv3hwffvih2j5nzpxB3759IZFI4O3tjR49euDo0aNq+yiHhg8cOIDx48cjKCgIYWFhqtd37tyJxMREeHl5wcfHB/369cPFixfVjnHv3j28/PLLCAsLg1gsRmhoKAYOHIibN2+q7afvWPquG20EAoHWXp3IyEikpKSovq+ursacOXMQGxsLd3d3BAQEoGvXrti7d69qH205NQKBABMnTsTvv/+OVq1aQSwWo2XLlti1a5fGOdPS0tCxY0e4u7sjJiYGK1euNDlPR9lTYqlgq1u3bmoBjXKbv7+/3nsmqUU9NQQAVDc9Pz8/1baSkhJ89913GDVqFMaNG4fS0lJ8//336N27N44fP4527doBUAREdXMQioqKcPHiRQiFQqSnp6NNmzYAFEFAYGAgWrRowdqOyspK9OjRA7du3cI777yDRo0a4eeff8bff/+tse+mTZtQUVGBt956CwEBATh+/Di+/vpr3L59G5s2bQIAvPHGG7hz5w727t2Ln3/+WeMYS5YswYABA/Diiy+iqqoK69evx7Bhw7B9+3b069dP5++My/mVZDIZevfujSeffBILFy7EX3/9hS+++AIxMTF46623AAAMw2DgwIE4dOgQ3nzzTbRo0QK//fYbxo4dq7MdbD788EMUFxfj9u3bWLRoEQDA29sbAPDtt9/inXfewdChQzFp0iQ8evQI586dw7FjxzB69Gi9x547dy4EAgGmT5+O/Px8LF68GD179sTZs2fh4eEBAPj777/Rt29fJCQkYNasWRAKhVi9ejWeeeYZpKeno1OnTgCAN998E5s3b8bEiRMRHx+PwsJCHDp0CJcuXUKHDh10/hymOnPmDLy8vDT+JpVtO3PmDLp27cr6/nPnziExMRGurq54/fXXERkZievXr+OPP/7A3LlzAQAXL15EYmIiJBIJ3n//fbi6umLlypVISkrCgQMH8OSTT6odc/z48QgMDMTMmTNRXl4OAPj5558xduxY9O7dG59//jkqKiqwfPlydO3aFWfOnFEFeUOGDMHFixfx9ttvIzIyEvn5+di7dy9u3bql2ofLsfRdN6aYPXs25s2bh9deew2dOnVCSUkJTp48idOnT+PZZ5/V+d5Dhw4hNTUV48ePh4+PD7766isMGTIEt27dQkBAAADF/7M+ffogNDQUc+bMgUwmwyeffILAwECD2nn//n0Aimv3xo0bmD59OgICAvD8889r7FtaWqraX8nf318jSDFUWVkZysrK0LBhQ5OO41QY4lRWr17NAGD++usvpqCggMnJyWE2b97MBAYGMmKxmMnJyVHtW1NTw0ilUrX3P3jwgAkODmZeeeUV1bZNmzYxAJiMjAyGYRhm27ZtjFgsZgYMGMCMGDFCtV+bNm2YF154QWf7Fi9ezABgNm7cqNpWXl7ONG3alAHA7N+/X7W9oqJC4/3z5s1jBAIBk52drdo2YcIEhu1Pvf4xqqqqmFatWjHPPPOMznYacv6xY8cyAJhPPvlEbd/27dszCQkJqu9///13BgAzf/581baamhomMTGRAcCsXr1aZ3v279+v8Tvq168fExERobHvwIEDmZYtW+r5CdnP0bhxY6akpES1fePGjQwAZsmSJQzDMIxcLmdiY2OZ3r17M3K5XLVfRUUFExUVxTz77LOqbb6+vsyECRN0npft5+BC13v79evHREdHa2wvLy9nADAzZszQeexu3boxPj4+av+/GYZR+5kHDRrEuLm5MdevX1dtu3PnDuPj48N069ZNtU15bXbt2pWpqalRbS8tLWUaNGjAjBs3Tu0c9+7dY3x9fVXbHzx4wABg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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.scatter(raw_data[:, 0], raw_data[:, 1], label=\"Raw Data\", c=\"#7eba00\")\n",
+    "plt.scatter(\n",
+    "    coreset_df[\"X\"],\n",
+    "    coreset_df[\"Y\"],\n",
+    "    s=coreset_df[\"weights\"],\n",
+    "    label=\"Coreset\",\n",
+    "    color=\"black\",\n",
+    "    marker=\"*\",\n",
+    ")\n",
+    "plt.xlabel(\"X\")\n",
+    "plt.ylabel(\"Y\")\n",
+    "plt.title(\"Raw data and its best 10 coreset using BFL2\")\n",
+    "plt.legend()\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Data preprocessing"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In order to cluster data on a quantum computer, the task needs to be cast into the form of a binary optimization problem.  Each qubit represents a coreset point, and the quantum algorithm determines how to bipartition the coreset points at each iteration of the divisive clustering routine. \n",
+    "\n",
+    "The first step is to convert coreset points into a fully connected graph. The edge weight is calculated by:\n",
+    "\n",
+    "$e_{ij} = w_iw_jd_{ij}$ where $d_{ij}$ is the Euclidean distance between points $i$ and $j$. \n",
+    "\n",
+    "This process is handled by `Coreset.coreset_to_graph()`. The function returns a fully connected graph $G$ with edge weights."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum functions"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The divisive clustering problem will be implemented on a quantum computer using a variational quantum algorithm (VQA) approach.  A VQA takes a Hamiltonian (encoded with the optimization problem) and a parameterized ansatz and evaluates expectation values (quantum computer) that inform updates to the ansatz parameters (classical computer).  The graph $G$ (Code in the \"src\" file) is used to construct the Hamiltonian, derived specifically for the divisive clustering problem, and motivated by a max-cut Hamiltonian.  The `spin.z(i)` method in CUDA-Q adds a Pauli Z operation that acts on qubit $i$ to the Hamiltonian."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_K2_Hamiltonian(G: nx.Graph) -> cudaq.SpinOperator:\n",
+    "    \"\"\"Returns the K2 Hamiltonian for the given graph G\n",
+    "\n",
+    "    Args:\n",
+    "        G (nx.Graph): Weighted graph\n",
+    "    \"\"\"\n",
+    "    H = 0\n",
+    "\n",
+    "    for i, j in G.edges():\n",
+    "        weight = G[i][j][\"weight\"]\n",
+    "        H += weight * (spin.z(i) * spin.z(j))\n",
+    "\n",
+    "    return H"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The code below constructs a quantum kernel, defining the circuit which will serve as an ansatz.  The structure of the circuit is a hardware efficient ansatz consisting of layers of parameterized $R_Z$ and $R_Y$ gate acting on each qubit, followed by a linear cascade of CNOT gates, and two more rotation gates.\n",
+    "\n",
+    "The `@cudaq.kernel` decorator allows us to define a quantum circuit in the new kernel mode syntax which provides performance benefits to JIT compilation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_VQE_circuit(number_of_qubits: int, circuit_depth: int) -> cudaq.Kernel:\n",
+    "    \"\"\"Returns the VQE circuit for the given number of qubits and circuit depth\n",
+    "\n",
+    "    Args:\n",
+    "        number_of_qubits (int): Number of qubits\n",
+    "        circuit_depth (int): Circuit depth\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq.Kernel: VQE Circuit\n",
+    "    \"\"\"\n",
+    "\n",
+    "    @cudaq.kernel\n",
+    "    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):\n",
+    "        \"\"\"VQE Circuit\n",
+    "\n",
+    "        Args:\n",
+    "            thetas (list[float]): List of parameters\n",
+    "            number_of_qubits (int): Number of qubits\n",
+    "            circuit_depth (int): Circuit depth\n",
+    "        \"\"\"\n",
+    "        qubits = cudaq.qvector(number_of_qubits)\n",
+    "\n",
+    "        theta_position = 0\n",
+    "\n",
+    "        for i in range(circuit_depth):\n",
+    "            for j in range(number_of_qubits):\n",
+    "                ry(thetas[theta_position], qubits[j])\n",
+    "                rz(thetas[theta_position + 1], qubits[j])\n",
+    "\n",
+    "                theta_position += 2\n",
+    "\n",
+    "            for j in range(number_of_qubits - 1):\n",
+    "                cx(qubits[j], qubits[j + 1])\n",
+    "\n",
+    "            for j in range(number_of_qubits):\n",
+    "                ry(thetas[theta_position], qubits[j])\n",
+    "                rz(thetas[theta_position + 1], qubits[j])\n",
+    "\n",
+    "                theta_position += 2\n",
+    "\n",
+    "    return kernel"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can visualize the circuit using the `cudaq.draw()` method. Below, we are drawing the circuit for 5 qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭────────────╮ ╭────────────╮      ╭────────────╮╭────────────╮»\n",
+      "q0 : ┤ ry(0.8904) ├─┤ rz(0.7335) ├───●──┤ ry(0.4343) ├┤ rz(0.2236) ├»\n",
+      "     ├────────────┤ ├────────────┤ ╭─┴─╮╰────────────╯├────────────┤»\n",
+      "q1 : ┤ ry(0.7937) ├─┤ rz(0.9981) ├─┤ x ├──────●───────┤ ry(0.3945) ├»\n",
+      "     ├───────────┬╯ ├────────────┤ ╰───╯    ╭─┴─╮     ╰────────────╯»\n",
+      "q2 : ┤ ry(0.696) ├──┤ rz(0.3352) ├──────────┤ x ├───────────●───────»\n",
+      "     ├───────────┴╮╭┴────────────┤          ╰───╯         ╭─┴─╮     »\n",
+      "q3 : ┤ ry(0.6658) ├┤ rz(0.05277) ├────────────────────────┤ x ├─────»\n",
+      "     ├───────────┬╯├─────────────┴╮                       ╰───╯     »\n",
+      "q4 : ┤ ry(0.791) ├─┤ rz(0.003569) ├─────────────────────────────────»\n",
+      "     ╰───────────╯ ╰──────────────╯                                 »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                                             \n",
+      "─────────────────────────────────────────────\n",
+      "╭────────────╮                               \n",
+      "┤ rz(0.4119) ├───────────────────────────────\n",
+      "├────────────┤╭────────────╮                 \n",
+      "┤ ry(0.3205) ├┤ rz(0.3504) ├─────────────────\n",
+      "╰────────────╯├────────────┤ ╭────────────╮  \n",
+      "──────●───────┤ ry(0.3913) ├─┤ rz(0.7392) ├──\n",
+      "    ╭─┴─╮     ├────────────┤╭┴────────────┴─╮\n",
+      "────┤ x ├─────┤ ry(0.3171) ├┤ rz(0.0008056) ├\n",
+      "    ╰───╯     ╰────────────╯╰───────────────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "parameter_count = 4 * circuit_depth * 5\n",
+    "parameters = np.random.rand(parameter_count)\n",
+    "\n",
+    "circuit = get_VQE_circuit(5, circuit_depth)\n",
+    "print(cudaq.draw(circuit, parameters, 5, circuit_depth))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The next step is to select a classical optimizer. There are multiple [optimizers](https://nvidia.github.io/cuda-quantum/latest/api/languages/python_api.html#optimizers) built-in to CUDA-Q that can be selected. The code below returns the optimizer with the proper number of initial parameters. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_optimizer(\n",
+    "    optimizer: cudaq.optimizers.optimizer, max_iterations, **kwargs\n",
+    ") -> Tuple[cudaq.optimizers.optimizer, int]:\n",
+    "    \"\"\"Returns the optimizer with the given parameters\n",
+    "\n",
+    "    Args:\n",
+    "        optimizer (cudaq.optimizers.optimizer): Optimizer\n",
+    "        max_iterations (int): Maximum number of iterations\n",
+    "        **kwargs: Additional arguments\n",
+    "\n",
+    "    Returns:\n",
+    "        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count\n",
+    "    \"\"\"\n",
+    "    parameter_count = 4 * kwargs[\"circuit_depth\"] * kwargs[\"qubits\"]\n",
+    "    initial_params = np.random.uniform(-np.pi / 8.0, np.pi / 8.0, parameter_count)\n",
+    "    optimizer.initial_parameters = initial_params\n",
+    "\n",
+    "    optimizer.max_iterations = max_iterations\n",
+    "    return optimizer, parameter_count"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Divisive Clustering Function"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The `DivisiveClusteringVQA` class enables the procedure to iteratively bipartition the coreset points until each is its own cluster. If you wish to develop on top of this or see how the underlying code works, please see the `divisive_clustering.py` file in the src directory. \n",
+    "\n",
+    "`run_divisive_clustering`, takes the current iteration's coreset points that will be bipartitioned as inputs, extracts the appropriate weights, and builds a graph $G$. The graph is then an input into the `get_counts_from_simulation` function. \n",
+    "\n",
+    "\n",
+    "`get_counts_from_simulation` handles preparation and execution of the quantum simulation. First, it takes $G$ and from it builds a spin Hamiltonian. Second, it defines a cost function, which in this case is a lambda function that returns the expectation value of our parameterized quantum circuit and the Hamiltonian. This value is obtained using the CUDA-Q `observe` command, accelerated by GPUs.  After the expectation value is minimized, the quantum circuit corresponding to the optimal parameters is sampled using the CUDA-Q `sample` function. The bitstrings and their associated counts are returned by `get_counts_from_simulation`.\n",
+    "\n",
+    "A subset of these counts is evaluated to compute their exact cost. The best bitstring is returned and later used to assign the coreset points to one of two clusters.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class DivisiveClusteringVQA(DivisiveClustering):\n",
+    "    def __init__(\n",
+    "        self,\n",
+    "        **kwargs,\n",
+    "    ):\n",
+    "        super().__init__(**kwargs)\n",
+    "\n",
+    "    def run_divisive_clustering(\n",
+    "        self,\n",
+    "        coreset_vectors_df_for_iteration: pd.DataFrame,\n",
+    "    ):\n",
+    "        \"\"\"Runs the Divisive Clustering algorithm\n",
+    "\n",
+    "        Args:\n",
+    "            coreset_vectors_df_for_iteration (pd.DataFrame): Coreset vectors for the iteration\n",
+    "\n",
+    "        Returns:\n",
+    "            str: Best bitstring\n",
+    "\n",
+    "        \"\"\"\n",
+    "        coreset_vectors_for_iteration_np, coreset_weights_for_iteration_np = (\n",
+    "            self._get_iteration_coreset_vectors_and_weights(coreset_vectors_df_for_iteration)\n",
+    "        )\n",
+    "\n",
+    "        G = Coreset.coreset_to_graph(\n",
+    "            coreset_vectors_for_iteration_np,\n",
+    "            coreset_weights_for_iteration_np,\n",
+    "            metric=self.coreset_to_graph_metric,\n",
+    "        )\n",
+    "\n",
+    "        counts = self.get_counts_from_simulation(\n",
+    "            G,\n",
+    "            self.circuit_depth,\n",
+    "            self.max_iterations,\n",
+    "            self.max_shots,\n",
+    "        )\n",
+    "\n",
+    "        return self._get_best_bitstring(counts, G)\n",
+    "\n",
+    "    def get_counts_from_simulation(\n",
+    "        self, G: nx.graph, circuit_depth: int, max_iterations: int, max_shots: int\n",
+    "    ) -> cudaq.SampleResult:\n",
+    "        \"\"\"\n",
+    "        Runs the VQA simulation\n",
+    "\n",
+    "        Args:\n",
+    "            G (nx.graph): Graph\n",
+    "            circuit_depth (int): Circuit depth\n",
+    "            max_iterations (int): Maximum number of iterations\n",
+    "            max_shots (int): Maximum number of shots\n",
+    "\n",
+    "        Returns:\n",
+    "            cudaq.SampleResult: Measurement from the experiment\n",
+    "        \"\"\"\n",
+    "\n",
+    "        qubits = len(G.nodes)\n",
+    "        Hamiltonian = self.create_Hamiltonian(G)\n",
+    "        optimizer, parameter_count = self.optimizer_function(\n",
+    "            self.optimizer, max_iterations, qubits=qubits, circuit_depth=circuit_depth\n",
+    "        )\n",
+    "\n",
+    "        kernel = self.create_circuit(qubits, circuit_depth)\n",
+    "\n",
+    "        def objective_function(\n",
+    "            parameter_vector: list[float],\n",
+    "            hamiltonian: cudaq.SpinOperator = Hamiltonian,\n",
+    "            kernel: cudaq.Kernel = kernel,\n",
+    "        ) -> float:\n",
+    "            \"\"\"\n",
+    "\n",
+    "            Objective function that returns the cost of the simulation\n",
+    "\n",
+    "            Args:\n",
+    "                parameter_vector (List[float]):\n",
+    "                hamiltonian (cudaq.SpinOperator): Circuit parameter values as a vector\n",
+    "                kernel (cudaq.Kernel) : Circuit configuration\n",
+    "\n",
+    "            Returns:\n",
+    "                float: Expectation value of the circuit\n",
+    "\n",
+    "            \"\"\"\n",
+    "\n",
+    "            get_result = lambda parameter_vector: cudaq.observe(\n",
+    "                kernel, hamiltonian, parameter_vector, qubits, circuit_depth\n",
+    "            ).expectation()\n",
+    "\n",
+    "            cost = get_result(parameter_vector)\n",
+    "\n",
+    "            return cost\n",
+    "\n",
+    "        energy, optimal_parameters = optimizer.optimize(\n",
+    "            dimensions=parameter_count, function=objective_function\n",
+    "        )\n",
+    "\n",
+    "        counts = cudaq.sample(\n",
+    "            kernel, optimal_parameters, qubits, circuit_depth, shots_count=max_shots\n",
+    "        )\n",
+    "\n",
+    "        return counts"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "An instance of the `DivisiveClusteringVQA` class is mostly constructed from variables previously discussed like the functions for building the Hamiltonians and quantum circuits. Parameters related to the quantum simulation can also be specified here such as `circuit_depth` and `max_shots`.  The ` threshold_for_max_cut` parameter specifies what percent of the sample results from the quantum computer are checked for the best bitstring value.\n",
+    "\n",
+    "The other options specify advanced features like if the data is normalized and how the graph weights are computed.\n",
+    "\n",
+    "\n",
+    "Finally, the `get_divisive_sequence` method performs the iterations and produces the clustering data which we will analyze below. Note that this postprocessing code is not exposed in this tutorial but can be found in the source code. \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 129/129 [00:00<00:00, 12075.19it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00<00:00, 35025.50it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 18/18 [00:00<00:00, 44254.09it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 15827.56it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 13617.87it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "divisive_clustering = DivisiveClusteringVQA(\n",
+    "    circuit_depth=circuit_depth,\n",
+    "    max_iterations=max_iterations,\n",
+    "    max_shots=max_shots,\n",
+    "    threshold_for_max_cut=0.75,\n",
+    "    create_Hamiltonian=get_K2_Hamiltonian,\n",
+    "    optimizer=optimizer,\n",
+    "    optimizer_function=get_optimizer,\n",
+    "    create_circuit=get_VQE_circuit,\n",
+    "    normalize_vectors=True,\n",
+    "    sort_by_descending=True,\n",
+    "    coreset_to_graph_metric=\"dist\",\n",
+    ")\n",
+    "\n",
+    "hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The data can be nicely visualized with a Dendrogram which maps where the bipartitionings occurred. Early splits generally mark divisions between the least similar data."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAy0AAANICAYAAADKKQDvAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9MElEQVR4nO3deXzU9Z348Xc4EsItCFUEOcQbRSueaAFLtQhatIpFLIqVWkUrtehP2vVAu6Xq6oquUnVV3AqLYLXrsWhVFrteVUHXo2qBB1i0CooSrhCOfH9/uJklJCABwnwgz+fjMQ+Yme985z1DSPLK90hBlmVZAAAAJKpevgcAAADYFNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAtQJnTp1inPPPTffY+zQnnrqqTjkkEOiUaNGUVBQEEuWLMn3SHVWQUFBXHvttfkeA2C7ES3ANjFhwoQoKCjIXRo1ahTt2rWLE088MW677bZYtmxZvkdkKyxevDgGDRoUxcXFcccdd8Tvfve7aNKkySYfM3fu3LjggguiS5cu0ahRo2jevHn07Nkzxo0bF6Wlpdtp8tqxcuXKuPbaa2PGjBn5HmW7ueWWW6KgoCCeffbZjS5zzz33REFBQTz22GO527Isi9/97nfxrW99K1q2bBmNGzeOgw46KH71q1/FypUrq6yjd+/elT6XrH/Zb7/9auW1AelrkO8BgJ3LddddF507d441a9bEp59+GjNmzIiRI0fGLbfcEo899lgcfPDB+R6RLfDaa6/FsmXL4vrrr4++fft+7fJPPvlknHHGGVFUVBRDhw6Nbt26xerVq+OFF16Iyy+/PN599924++67t8PktWPlypUxZsyYiPjqm+ztrbS0NBo02L5fwn/wgx/E5ZdfHpMmTdrox8CkSZOidevW0a9fv4iIWLduXZx11lkxZcqUOO644+Laa6+Nxo0bx3//93/HNddcE1OmTIlnn3022rZtW2k97du3j7Fjx1ZZf4sWLbb9CwN2CKIF2Kb69esXPXr0yF0fPXp0TJ8+PQYMGBCnnHJKvPfee1FcXJzHCTduxYoVX7v1YFtZtWpVFBYWRr16O8YG70WLFkVERMuWLb922Xnz5sUPfvCD6NixY0yfPj1233333H0jRoyIOXPmxJNPPrnVM2VZFqtWrUr246k2NWrUaLs/Z7t27aJPnz7xyCOPxPjx46OoqKjS/R9//HH86U9/ih//+MfRsGHDiIi48cYbY8qUKTFq1Ki46aabcsv++Mc/jkGDBsXAgQNj2LBhVT4eWrRoEWeffXbtvyhgh7FjfLUEdmjHH398XHXVVfHhhx/Ggw8+WOm+999/P04//fRo1apVNGrUKHr06FFp15KI/9v17MUXX4zLLrss2rRpE02aNIlTTz01Pvvss0rLZlkWv/rVr6J9+/bRuHHj6NOnT7z77rtVZqpY5/PPPx8XXXRRtG3bNtq3b5+7/84774wDDzwwioqKol27djFixIhqj+G44447okuXLlFcXBxHHHFE/Pd//3f07t270k/fZ8yYEQUFBTF58uT4h3/4h9hjjz2icePGsXTp0vjiiy9i1KhRcdBBB0XTpk2jefPm0a9fv/if//mfSs9TsY4pU6bEmDFjYo899ohmzZrF6aefHiUlJVFWVhYjR46Mtm3bRtOmTWPYsGFRVla2Wf8+U6dOjcMOOyyKi4tj1113jbPPPjs+/vjj3P29e/eOc845JyIiDj/88CgoKNjk8UE33nhjLF++PO69995KwVKha9eucemll+aur127Nq6//vrYa6+9oqioKDp16hS/+MUvqszfqVOnGDBgQDz99NPRo0ePKC4ujrvuuisiIpYsWRIjR46MDh06RFFRUXTt2jVuuOGGKC8vr7SOyZMnx2GHHRbNmjWL5s2bx0EHHRTjxo2rtMzXrWv+/PnRpk2biIgYM2ZMbtelTR1jcu2110ZBQUGV2ys+DufPn5+77fXXX48TTzwxdt111yguLo7OnTvHeeedV+lxGz5fxfrnzJkT5557brRs2TJatGgRw4YNq7ILVmlpafz0pz+NXXfdNZo1axannHJKfPzxx5t1nMzZZ58dJSUl1Ubn5MmTo7y8PIYMGZJ7nptuuin22WefareanHzyyXHOOefEf/7nf8arr766yecFsKUF2C5++MMfxi9+8Yv44x//GMOHD4+IiHfffTd69uwZe+yxR1x55ZXRpEmTmDJlSgwcODB+//vfx6mnnlppHZdccknssssucc0118T8+fPj1ltvjYsvvjgeeuih3DJXX311/OpXv4qTTjopTjrppJg1a1accMIJsXr16mrnuuiii6JNmzZx9dVXx4oVKyLiq28Ax4wZE3379o0L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mDHxz//8z9G7d+8YOHBgnHXWWVUOfK/Opv6PNG/ePPd+b/g+bvj+b0q/fv2iVatWMWnSpNyxTf/+7/8e3bt3jwMPPDC33MaCZH0V92149rAmTZps1lnqgLpDtADbxUcffRQlJSW5b44qDmoeNWpUlZ+cV9jwG6n1t4isL8uyLZ5re555qrrn+vWvfx1XXXVVnHfeeXH99ddHq1atol69ejFy5MgqB5FHbPw9qI33Zks0b9482rVrF++8806NHlfdQerVqe49LC8vj+985ztxxRVXVPuYffbZJyK++sb4zTffjKeffjqmTZsW06ZNi/vvvz+GDh0aDzzwQI3WVVMbe33rR2rFcg8//HC88sor8fjjj8fTTz8d5513Xtx8883xyiuvRNOmTTf5PNvj46Bhw4YxaNCguOeee2LhwoXxt7/9LWbPnh033nhjpeUOOOCAiIh46623YuDAgdWu66233oqIiC5dumyz+YCdk2gBtovf/e53ERG5QKn4JqVhw4bb7CeqHTt2jIivflq+/jdBn332WW5rzOau44MPPqi0jtWrV8e8efNys1YsN2fOnOjTp09uubVr18b8+fM3+6Dshx9+OPr06RP33ntvpduXLFkSu+6662atY0ut/1qPP/74Svd98MEHuftrasCAAXH33XfHyy+/HEcfffTXzlBeXh6zZ8+O/fffP3f7woULY8mSJZs1w1577RXLly/frI+jwsLCOPnkk+Pkk0+O8vLyuOiii+Kuu+6Kq666Krp27brZ69rcyKpQscVjyZIllU4bveGWpApHHXVUHHXUUfGP//iPMWnSpBgyZEhMnjw5zj///Bo974Yq3u958+ZV2iI5Z86cGq1nyJAh8dvf/jYeeuihmDdvXhQUFMTgwYMrLdOzZ89o2bJlTJo0KX75y19WG1T/9m//FhERZ5xxxha8GqAucUwLUOumT58e119/fXTu3Dm3z3vbtm2jd+/ecdddd8Unn3xS5TEbnsp4c/Tt2zcaNmwYt99+e6WfLFecPWpz11FYWBi33XZbpXXce++9UVJSkjvLUo8ePaJ169Zxzz33VDpuZOLEiZsdSBFf/WR8w5+CT506tcrxPLWhR48e0bZt2/jtb39b6fTC06ZNi/fee2+zzyi1oSuuuCKaNGkS559/fixcuLDK/XPnzs2dZvikk06KiKr/RrfccktExGbNMGjQoHj55Zfj6aefrnLfkiVLcv8+ixcvrnRfvXr1cnFZ8fo3d12NGzfO3bY5Ks62tv4xMStWrMht4anw5ZdfVvl4OOSQQyrNuDUqfmhw5513Vrr99ttvr9F6evbsGZ06dYoHH3wwHnrooejVq1eVM+Y1btw4rrjiivjggw/il7/8ZZV1PPnkkzFhwoQ4+eST46CDDqrhKwHqGltagG1q2rRp8f7778fatWtj4cKFMX369HjmmWeiY8eO8dhjj1U64PuOO+6IY489Ng466KAYPnx4dOnSJRYuXBgvv/xyfPTRR1V+V8nXadOmTYwaNSrGjh0bAwYMiJNOOineeOONmDZt2mZvtWjTpk2MHj06xowZE9/97nfjlFNOiQ8++CDuvPPOOPzww3O/8K6wsDCuvfbauOSSS+L444+PQYMGxfz582PChAmx1157bfZP4gcMGBDXXXddDBs2LI455ph4++23Y+LEidtld5mGDRvGDTfcEMOGDYtevXrF4MGDc6c87tSpU/zsZz/bovXutddeMWnSpDjzzDNj//33j6FDh0a3bt1i9erV8dJLL8XUqVNzx0J07949zjnnnLj77rtjyZIl0atXr3j11VfjgQceiIEDB1bairUxl19+eTz22GMxYMCAOPfcc+Owww6LFStWxNtvvx0PP/xwzJ8/P3bdddc4//zz44svvojjjz8+2rdvHx9++GHcfvvtccghh+S28mzuuoqLi+OAAw6Ihx56KPbZZ59o1apVdOvWLbp161btjCeccELsueee8aMf/Sguv/zyqF+/ftx3333Rpk2b+Nvf/pZb7oEHHog777wzTj311Nhrr71i2bJlcc8990Tz5s1zgbc1DjvssPj+978ft956ayxevDh3yuO//vWvEbH5W5AKCgrirLPOil//+tcREXHddddVu9wVV1wRb775Ztxwww3x8ssvx/e///0oLi6OF154IR588ME48MADY8KECVUeV1JSUuV3OlXwSyehjsrbecuAnUrFqVsrLoWFhdluu+2Wfec738nGjRuXLV26tNrHzZ07Nxs6dGi22267ZQ0bNsz22GOPbMCAAdnDDz9cZd0bnga24jTA//Vf/5W7bd26ddmYMWOy3XffPSsuLs569+6dvfPOO1nHjh2rPeXxxk4t+y//8i/ZfvvtlzVs2DD7xje+kV144YXZl19+WWW52267LevYsWNWVFSUHXHEEdmLL76YHXbYYdl3v/vdKnNOnTq1yuNXrVqV/fznP8/N27Nnz+zll1/OevXqVe1pkzdcx8ZeR8UpcD/77LNqX9/6HnrooezQQw/NioqKslatWmVDhgzJPvroo816nk3561//mg0fPjzr1KlTVlhYmDVr1izr2bNndvvtt1c6zfWaNWuyMWPGZJ07d84aNmyYdejQIRs9enSlZbLsq1Me9+/fv9rnWrZsWTZ69Oisa9euWWFhYbbrrrtmxxxzTPZP//RPuVNEP/zww9kJJ5yQtW3bNissLMz23HPP7IILLsg++eSTGq8ry7LspZdeyg477LCssLBws04XPHPmzOzII4/MPfctt9xS5ZTHs2bNygYPHpztueeeWVFRUda2bdtswIAB2euvv15pXRs+38b+vTdcf5Zl2YoVK7IRI0ZkrVq1ypo2bZoNHDgw++CDD7KIyH7zm99s8jWs7913380iIisqKqr2/0aF8vLybMKECVnPnj2zZs2a5T5H9O3bNysrK6uy/KZOeezbFqi7CrJsOx+lCbATKy8vjzZt2sRpp50W99xzT77Hgc3y5ptvxqGHHhoPPvhgpdMW14Y1a9bEySefHM8991w8/vjjlc7eBrAxjmkB2EKrVq2qcvzBv/3bv8UXX3wRvXv3zs9Q8DVKS0ur3HbrrbdGvXr14lvf+latP3/Dhg3j97//fRxyyCFxxhlnVPv7iAA2ZEsLwBaaMWNG/OxnP4szzjgjWrduHbNmzYp777039t9//5g5c2YUFhbme0SoYsyYMTFz5szo06dPNGjQIHf65x//+Mdx11135Xs8gGqJFoAtNH/+/PjpT38ar776anzxxRfRqlWrOOmkk+I3v/lNlV+WB6l45plnYsyYMfGXv/wlli9fHnvuuWf88Ic/jF/+8pfRoIHz8wBpEi0AAEDSHNMCAAAkTbQAAABJ2+47r5aXl8ff//73aNas2Wb/EisAAGDnk2VZLFu2LNq1axf16m18e8p2j5a///3v0aFDh+39tAAAQKIWLFgQ7du33+j92z1amjVrFhFfDda8efPt/fQAAEAili5dGh06dMg1wsZs92ip2CWsefPmogUAAPjaw0YciA8AACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQtAb5HgDyKcuyKF2zLt9jAMB2U9ywfhQUFOR7DKgR0UKdlWVZnP7bl2Pmh1/mexQA2G56dNwlpv7kaOHCDsXuYdRZpWvWCRYA6pzXP/zSXgbscGxpgYh4/R/6RuPC+vkeAwBqzcrV66LHr57N9xiwRUQLRETjwvrRuNB/BwCAFNk9DAAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJJWo2i59tpro6CgoNJlv/32q63ZAAAAokFNH3DggQfGs88++38raFDjVQAAAGy2GhdHgwYNYrfddquNWQAAAKqo8TEts2fPjnbt2kWXLl1iyJAh8be//a025gIAAIiIGm5pOfLII2PChAmx7777xieffBJjxoyJ4447Lt55551o1qxZtY8pKyuLsrKy3PWlS5du3cQAAECdUqNo6devX+7vBx98cBx55JHRsWPHmDJlSvzoRz+q9jFjx46NMWPGbN2UAABAnbVVpzxu2bJl7LPPPjFnzpyNLjN69OgoKSnJXRYsWLA1TwkAANQxWxUty5cvj7lz58buu+++0WWKioqiefPmlS4AAACbq0bRMmrUqHj++edj/vz58dJLL8Wpp54a9evXj8GDB9fWfAAAQB1Xo2NaPvrooxg8eHAsXrw42rRpE8cee2y88sor0aZNm9qaDwAAqONqFC2TJ0+urTkAAACqtVXHtAAAANQ20QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkLQG+R6Ar5dlWZSuWZfvMXY6K1evrfbvbDvFDetHQUFBvscAAHZwoiVxWZbF6b99OWZ++GW+R9mp9fjVc/keYafUo+MuMfUnRwsXAGCr2D0scaVr1gkWdlivf/ilrYQAwFazpWUH8vo/9I3GhfXzPQZ8rZWr10WPXz2b7zEAgJ2EaNmBNC6sH40L/ZMBAFC32D0MAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACStlXR8pvf/CYKCgpi5MiR22gcAACAyrY4Wl577bW466674uCDD96W8wAAAFSyRdGyfPnyGDJkSNxzzz2xyy67bOuZAAAAcrYoWkaMGBH9+/ePvn37but5AAAAKmlQ0wdMnjw5Zs2aFa+99tpmLV9WVhZlZWW560uXLq3pUwIAAHVYjba0LFiwIC699NKYOHFiNGrUaLMeM3bs2GjRokXu0qFDhy0aFAAAqJtqFC0zZ86MRYsWxTe/+c1o0KBBNGjQIJ5//vm47bbbokGDBrFu3boqjxk9enSUlJTkLgsWLNhmwwMAADu/Gu0e9u1vfzvefvvtSrcNGzYs9ttvv/h//+//Rf369as8pqioKIqKirZuSgAAoM6qUbQ0a9YsunXrVum2Jk2aROvWravcDgAAsC1s1S+XBAAAqG01PnvYhmbMmLENxgAAAKieLS0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJq1G0jB8/Pg4++OBo3rx5NG/ePI4++uiYNm1abc0GAABQs2hp3759/OY3v4mZM2fG66+/Hscff3x873vfi3fffbe25gMAAOq4BjVZ+OSTT650/R//8R9j/Pjx8corr8SBBx64TQcDAACIqGG0rG/dunUxderUWLFiRRx99NHbciYAAICcGkfL22+/HUcffXSsWrUqmjZtGo8++mgccMABG12+rKwsysrKcteXLl26ZZMCAAB1Uo3PHrbvvvvGm2++GX/+85/jwgsvjHPOOSf+8pe/bHT5sWPHRosWLXKXDh06bNXAAABA3VLjaCksLIyuXbvGYYcdFmPHjo3u3bvHuHHjNrr86NGjo6SkJHdZsGDBVg0MAADULVt8TEuF8vLySrt/baioqCiKioq29mkAAIA6qkbRMnr06OjXr1/sueeesWzZspg0aVLMmDEjnn766dqaDwAAqONqFC2LFi2KoUOHxieffBItWrSIgw8+OJ5++un4zne+U1vzAQAAdVyNouXee++trTkAAACqVeMD8QEAALYn0QIAACRtq88eBtRMlmVRurY032PUqpVr1q3399KIgvp5nGb7KG5QHAUFBfkeAwB2SqIFtqMsy2LotKHx5mdv5nuUWpWVN4yI6yMioveUXlFQb01+B9oODm17aDzw3QeECwDUAtEC21Hp2tKdPlgiIgrqrYlm+1+Z7zG2qzcWvRGla0ujccPG+R4FAHY6ogXyZMagGVHcoDjfY7CVSteWRu8pvfM9BgDs1EQL5Elxg2I/lQcA2AzOHgYAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASatRtIwdOzYOP/zwaNasWbRt2zYGDhwYH3zwQW3NBgAAULNoef7552PEiBHxyiuvxDPPPBNr1qyJE044IVasWFFb8wEAAHVcg5os/NRTT1W6PmHChGjbtm3MnDkzvvWtb23TwQAAACJqGC0bKikpiYiIVq1abXSZsrKyKCsry11funTp1jwlAABQx2zxgfjl5eUxcuTI6NmzZ3Tr1m2jy40dOzZatGiRu3To0GFLnxIAAKiDtjhaRowYEe+8805Mnjx5k8uNHj06SkpKcpcFCxZs6VMCAAB10BbtHnbxxRfHE088EX/605+iffv2m1y2qKgoioqKtmg4AACAGkVLlmVxySWXxKOPPhozZsyIzp0719ZcAAAAEVHDaBkxYkRMmjQp/uM//iOaNWsWn376aUREtGjRIoqLi2tlQAAAoG6r0TEt48ePj5KSkujdu3fsvvvuuctDDz1UW/MBAAB1XI13DwPIhyzLonRtab7HqGL9mVKcr7hBcRQUFOR7DADYKlv1e1oAtocsy2LotKHx5mdv5nuUTeo9pXe+R6ji0LaHxgPffUC4ALBD2+JTHgNsL6VrS5MPllS9seiNJLcAAUBN2NIC7FBmDJoRxQ2c+OPrlK4tTXLLDwBsCdEC7FCKGxRH44aN8z0GALAd2T0MAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACS1iDfAyQjyyLWrMz3FFWtXrfe31dGRP28jbJRDRtHFBTkewoAAHZSoiXiq2C578SIBX/O9yRVZUURcf9Xf7+pa0RBWV7HqVaHoyLOe0q4AABQK0RLxFdbWFIMlohoXFAW8xudle8xNm3BK1+9h4VN8j0JAAA7IdGyoVFzIgob53uKHcPqlRH/1DXfUwAAsJMTLRsqbGyLAQAAJMTZwwAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABIWoN8DwAAsL4syyIrLc33GDud8tXr/u/vK0ujfG39PE6zcyooLo6CgoJ8j7FTEi0AQDKyLIsPzxoSpW+8ke9Rdjqr6hdGnPzriIiY3fPYaLRudZ4n2vkUf/Ob0XHig8KlFogWACAZWWmpYKkljdatjml/GJXvMXZqpbNmRVZaGgWNG+d7lJ2OaAEAkrT3iy9EveLifI8BX6u8tDRm9zw232Ps1EQLAJCkesXFUc9PrIFw9jAAACBxNY6WP/3pT3HyySdHu3btoqCgIP7whz/UwlgAAABfqXG0rFixIrp37x533HFHbcwDAABQSY2PaenXr1/069evNmYBAACootYPxC8rK4uysrLc9aVLl9b2UwIAADuRWj8Qf+zYsdGiRYvcpUOHDrX9lAAAwE6k1qNl9OjRUVJSkrssWLCgtp8SAADYidT67mFFRUVRVFRU208DAADspPyeFgAAIGk13tKyfPnymDNnTu76vHnz4s0334xWrVrFnnvuuU2HAwAAqHG0vP7669GnT5/c9csuuywiIs4555yYMGHCNhsMAAAgYguipXfv3pFlWW3MAgAAUIVjWgAAgKTV+tnDAABgW8iyLLLS0nyPUUX5ejOVJzhfRERBcXEUFBTke4wtJloAAEhelmXx4VlDovSNN/I9yibN7nlsvkeoVvE3vxkdJz64w4aL3cMAAEheVlqafLCkrHTWrCS3Um0uW1oAANih7P3iC1GvuDjfY+wQyktLk936UxOiBQCAHUq94uKo17hxvsdgO7J7GAAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASWuQ7wEAgM2TZVlkpaX5HqNWla/3+sp38tcaEVFQXBwFBQX5HgOSJ1oAYAeQZVl8eNaQKH3jjXyPst3M7nlsvkeodcXf/GZ0nPigcIGvYfcwANgBZKWldSpY6orSWbN2+q1nsC3Y0gIAO5i9X3wh6hUX53sMtkJ5aWmd2JIE24poAYAdTL3i4qjXuHG+xwDYbuweBgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJc8pjAFhPlmVJ/rK/8vVmKk9wvoLiYr/VHag1ogUA/leWZfHhWUOS/83zKf5SwuJvfjM6TnxQuAC1wu5hAPC/stLS5IMlVaWzZiW5hQrYOdjSAgDV2PvFF6JecXG+x0heeWlpklt+gJ3LFkXLHXfcETfddFN8+umn0b1797j99tvjiCOO2NazAUDe1CsujnqNG+d7DABiC3YPe+ihh+Kyyy6La665JmbNmhXdu3ePE088MRYtWlQb8wEAAHVcjaPllltuieHDh8ewYcPigAMOiN/+9rfRuHHjuO+++2pjPgAAoI6r0e5hq1evjpkzZ8bo0aNzt9WrVy/69u0bL7/8crWPKSsri7Kystz1kpKSiIhYunTplsxbO1aviCjLvvr70qURhevyO8+OwvtWYyvXrIx1pV+9T0uXLo21DdfmeaIdg/et5rxnW6Z85cpYvu7/3rd6a71vX8d7tmW8bzXnPdsyqb9vFU2QZdmmF8xq4OOPP84iInvppZcq3X755ZdnRxxxRLWPueaaa7KIcHFxcXFxcXFxcXFxqfayYMGCTXZIrZ89bPTo0XHZZZflrpeXl8cXX3wRrVu3di53AACow7Isi2XLlkW7du02uVyNomXXXXeN+vXrx8KFCyvdvnDhwthtt92qfUxRUVEUFRVVuq1ly5Y1eVoAAGAn1aJFi69dpkYH4hcWFsZhhx0Wzz33XO628vLyeO655+Loo4+u+YQAAABfo8a7h1122WVxzjnnRI8ePeKII46IW2+9NVasWBHDhg2rjfkAAIA6rsbRcuaZZ8Znn30WV199dXz66adxyCGHxFNPPRXf+MY3amM+AACgjivIvvb8YgAAAPlT418uCQAAsD2JFgAAIGmiBQAASJpoAQAAkiZa/tedd94ZBQUFceSRR+Z7lORNmDAhCgoKKl3atm0bffr0iWnTpuV7vKTNnTs3LrjggujSpUs0atQomjdvHj179oxx48ZFaWlpvsdLSsXH2euvv17t/b17945u3bpt56l2PF/3PvJ/qvvcVnG58sor8z1e0nyc1cy8efPi4osvjn322ScaN24cjRs3jgMOOCBGjBgRb731Vr7HS86G/zcbNWoU7dq1ixNPPDFuu+22WLZsWb5HTNKmPqcVFBTEK6+8ku8Ra6TGpzzeWU2cODE6deoUr776asyZMye6du2a75GSd91110Xnzp0jy7JYuHBhTJgwIU466aR4/PHHY8CAAfkeLzlPPvlknHHGGVFUVBRDhw6Nbt26xerVq+OFF16Iyy+/PN599924++678z0m1HkVn9vWJ5DZVp544ok488wzo0GDBjFkyJDo3r171KtXL95///145JFHYvz48TFv3rzo2LFjvkdNTsX/zTVr1sSnn34aM2bMiJEjR8Ytt9wSjz32WBx88MH5HjFJ1X1Oi4gd7ntd0RJf/cTjpZdeikceeSQuuOCCmDhxYlxzzTX5Hit5/fr1ix49euSu/+hHP4pvfOMb8e///u+iZQPz5s2LH/zgB9GxY8eYPn167L777rn7RowYEXPmzIknn3wyjxMCFTb83Abbyty5c3NfC5577rlKXwsiIm644Ya48847o149O8JUZ8P/m6NHj47p06fHgAED4pRTTon33nsviouL8zhhmnaWz2n+V8RXW1l22WWX6N+/f5x++ukxceLEfI+0Q2rZsmUUFxdHgwZaeEM33nhjLF++PO69994qX6Qivvppx6WXXpqHyQDYXm688cZYsWJF3H///dV+LWjQoEH89Kc/jQ4dOuRhuh3T8ccfH1dddVV8+OGH8eCDD+Z7HGqRaImvouW0006LwsLCGDx4cMyePTtee+21fI+VvJKSkvj888/js88+i3fffTcuvPDCWL58eZx99tn5Hi05jz/+eHTp0iWOOeaYfI+yw6n4ONvwsmbNmnyPxk6quo852BaeeOKJ6Nq1q+Nnt7Ef/vCHERHxxz/+Mc+TpKm6z2mLFy/O91g1Vud/JD5z5sx4//334/bbb4+IiGOPPTbat28fEydOjMMPPzzP06Wtb9++la4XFRXFfffdF9/5znfyNFGali5dGh9//HF873vfy/coO6QNP87Wd+CBB27HSagrqvuYy7IsD5OwM1m6dGn8/e9/j4EDB1a5b8mSJbF27drc9SZNmtjNqQbat28fLVq0iLlz5+Z7lCRV9zmtqKgoVq1alYdptlydj5aJEyfGN77xjejTp09ERBQUFMSZZ54ZDz74YNx8881Rv379PE+YrjvuuCP22WefiIhYuHBhPPjgg3H++edHs2bN4rTTTsvzdOlYunRpREQ0a9Ysz5PsmNb/OFvfz3/+81i3bl0eJmJnt7GPOdgaFV8LmjZtWuW+3r17x//8z//krt90000xatSo7TbbzqBp06bOIrYR1X1O2xG/v63T0bJu3bqYPHly9OnTJ+bNm5e7/cgjj4ybb745nnvuuTjhhBPyOGHajjjiiEoHdg0ePDgOPfTQuPjii2PAgAFRWFiYx+nS0bx584gIn0y30IYfZxV22WUXu+1QKzb2MQdbo+IHV8uXL69y31133RXLli2LhQsX2sV6Cy1fvjzatm2b7zGStLN8TqvT0TJ9+vT45JNPYvLkyTF58uQq90+cOFG01EC9evWiT58+MW7cuJg9e7Zdd/5X8+bNo127dvHOO+/kexQA8qRFixax++67V/u1oOIYl/nz52/nqXYOH330UZSUlOxwp/ClZur0gfgTJ06Mtm3bxtSpU6tcBg8eHI8++qhf+FdDFfvkVveTpLpswIABMXfu3Hj55ZfzPQoAedK/f/+YM2dOvPrqq/keZafyu9/9LiIiTjzxxDxPQm2qs9FSWloajzzySAwYMCBOP/30KpeLL744li1bFo899li+R91hrFmzJv74xz9GYWFh7L///vkeJylXXHFFNGnSJM4///xYuHBhlfvnzp0b48aNy8NkAGwvV1xxRTRu3DjOO++8ar8WOOFDzU2fPj2uv/766Ny5cwwZMiTf41CL6uzuYY899lgsW7YsTjnllGrvP+qoo6JNmzYxceLEOPPMM7fzdDuGadOmxfvvvx8REYsWLYpJkybF7Nmz48orr8wdx8FX9tprr5g0aVKceeaZsf/++8fQoUOjW7dusXr16njppZdi6tSpce655+Z7TABq0d577x2TJk2KwYMHx7777htDhgyJ7t27R5ZlMW/evJg0aVLUq1cv2rdvn+9Rk1TxfcfatWtj4cKFMX369HjmmWeiY8eO8dhjj0WjRo3yPWKS1v9+bX3HHHNMdOnSJQ8TbZk6Gy0TJ06MRo0abfT0vPXq1Yv+/fvHxIkTY/HixdG6devtPGH6rr766tzfGzVqFPvtt1+MHz8+LrjggjxOla5TTjkl3nrrrbjpppviP/7jP2L8+PFRVFQUBx98cNx8880xfPjwfI8IsEUqthDsiGck2t6+973vxdtvvx0333xz/PGPf4z77rsvCgoKomPHjtG/f//4yU9+Et27d8/3mEmq+L6jsLAwWrVqFQcddFDceuutMWzYMGfo3IT1v19b3/33379DRUtBZlskALAVbrvttrj00ktjzpw5sddee+V7HGAnVGePaQEAto3XXnstmjRpEh07dsz3KMBOqs7uHgYAbJ3f//73MWPGjJg4cWKcf/750aCBbyuA2mH3MABgi3Tu3DmWLVsWp556atx6663RpEmTfI8E7KRECwAAkDTHtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJ+/9NVsdwRnDnBwAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 1000x1000 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "dendo = Dendrogram(coreset_df, hierarchial_clustering_sequence)\n",
+    "dendo.plot_dendrogram(plot_title=\"Dendrogram of Coreset using VQE\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Each branch point in the dendrogram aboves corresponds to one of the plots below. Notice the first iterations are the most complicated, and the final iterations become trivial bipartitioning of two points. Occasionally, especially in the first iteration, the partitioning might be puzzling at first glance. The data might seem to naturally cluster into two groups. However, there are cases where a stray point seems to belong in the wrong cluster.  There are two explanations for this.  1) The quantum sampling is approximate and stochastic. It is possible that too few shots were taken to sample the ground state of the problem. 2) It is important to remember that we are clustering coresets and not data points. There can be cases where it is optimal to pay a penalty by excluding a point based on proximity if the weights are small enough that the penalty has less impact. Usually, if a point looks unusually clustered and you go look at the original coresets plotted above, that point will have a small weight."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAABKUAAASmCAYAAAD/KRjlAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAEAAElEQVR4nOzdeVwV9f7H8fcAcsAFXNkUFbXct1wIbdEi0cwr1TX12nVJ7Wbq1Uub9CuXLM1WM00zt7pm2mplXdQw9Zq4R2qppbnLwRUQVEDO/P7geurEIhqcA4fX8/GYh57vfGfOZ0aZL/OZ7/c7hmmapgAAAAAAAAAn8nB1AAAAAAAAACh/SEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISqFY1a9fX4MHD3Z1GNdl0aJFMgxDhw4dcnUoxWbw4MGqX7++q8O4Jl26dFGXLl1cHQaAYkb7ULrQPgAoLWgfShfaBzgbSSkUyYEDB/SPf/xDDRo0kI+Pj/z8/NS5c2e98cYbunjxolNiuHDhgiZOnKi1a9c65ftKo40bN2rixIlKSUm5ru1Lyzn86aefNHHixFLXgNtsNr300ksKCwuTj4+PWrVqpQ8++MDVYQGlGu1D6UD7ULJeeOEF/eUvf1FgYKAMw9DEiRNdHRJQ6tE+lA60DyVn7969evLJJ9WmTRtVqVJFwcHB6tmzp7Zt2+bq0MoWE7iKFStWmL6+vmbVqlXNf/7zn+bcuXPNmTNnmv369TMrVKhgDh8+3F63Xr165qBBg0okjlOnTpmSzAkTJpTI/i9fvmxevHjRtNlsJbL/4vDyyy+bksyDBw8WqX5WVpZ56dIl++eSPodF9dFHH5mSzG+//TbPuszMTDMzM9P5QZmmOW7cOFOSOXz4cHPu3Llmz549TUnmBx984JJ4gNKO9qH0oH0oWZLMoKAgMyoqqlScJ6C0o30oPWgfSs5jjz1mVq1a1Rw6dKj59ttvmy+99JLZsGFD09PT01y9erXT4ymrvJyfBkNZcvDgQfXr10/16tXTmjVrFBwcbF83cuRI7d+/X1999ZULI/zzMjIyVKlSJXl6esrT09PV4RSrChUqOOV7rpzD4uDt7V0s+7lWx48f16uvvqqRI0dq5syZkqRhw4bp9ttv1xNPPKE+ffq43f8P4M+gfSjbaB+uzcGDB1W/fn2dPn1atWrVclkcQFlA+1C20T4UXf/+/TVx4kRVrlzZXvbQQw+padOmmjhxoiIjI10SV5nj6qwYSrdHHnnElGR+9913Rar/xycdEyZMMPP7b7Zw4cI8GfutW7ea3bp1M2vUqGH6+PiY9evXN4cMGWKapmkePHjQlJRn+X3Gfs+ePeb9999vVqtWzbRYLGa7du3Mzz//PN/vXbt2rTlixAizVq1aZtWqVQuMqV69embPnj3N//73v2aHDh1Mi8VihoWFme+++26eY/rhhx/M2267zfTx8TFr165tTp482VywYEGRnkz88MMP5qBBg8ywsDDTYrGYgYGB5pAhQ8zTp0/nOZd/XArb96BBg8x69eo57RweOnTIHDFihHnjjTeaPj4+ZvXq1c2//vWvDjFe2f6Py5WnHrfffrt5++23O3xncnKy+dBDD5kBAQGmxWIxW7VqZS5atMihzpXje/nll823337bbNCggent7W22b9/e3LJlS6Hn3zRNc9asWaYk88cff3QoX7JkiSnJ/O9//3vVfQDlCe0D7UN5aR9+r7T0GABKM9oH2ofy2D783n333WdWr179urcvb+gphUJ9+eWXatCggTp16lSi33Py5El169ZNtWrV0rhx41S1alUdOnRIn376qSSpVq1amj17tkaMGKF7771X9913nySpVatWkqQff/xRnTt3Vu3atTVu3DhVqlRJH374oaKjo/XJJ5/o3nvvdfi+Rx99VLVq1dL48eOVkZFRaGz79+/XX//6Vw0dOlSDBg3SggULNHjwYLVr107NmzeXlNvLpmvXrjIMQ7GxsapUqZLmzZsni8VSpONfvXq1fv31Vw0ZMkRBQUH68ccfNXfuXP3444/atGmTDMPQfffdp59//lkffPCBXn/9ddWsWdN+borCGedw69at2rhxo/r166c6dero0KFDmj17trp06aKffvpJFStW1G233aZ//vOfmjFjhp5++mk1bdpUkux//tHFixfVpUsX7d+/X6NGjVJYWJg++ugjDR48WCkpKRozZoxD/SVLluj8+fP6xz/+IcMw9NJLL+m+++7Tr7/+WuiTn++//16VKlXKE0fHjh3t62+55ZYinWugPKB9oH0oL+0DgGtD+0D7UN7bB6vVaj/XKAJXZ8VQeqWmppqSzN69exd5m+t90vHZZ5+ZksytW7cWuO/Cnk7eeeedZsuWLR3GP9tsNrNTp07mDTfckOd7b7nlFvPy5cuFxnTleCSZ69evt5edPHnStFgs5mOPPWYvGz16tGkYhvn999/by86cOWNWr169SE86Lly4kKfsgw8+yPPd1zom/PdPOkyz5M9hfseRkJBgSjLfe+89e1lhY8L/+KRj+vTppiRz8eLF9rKsrCwzIiLCrFy5spmWlmaa5m9POmrUqGGePXvWXvfzzz83JZlffvll3hP0Oz179jQbNGiQpzwjI8OUZI4bN67Q7YHyhPaB9qE8tQ+/R08poHC0D7QP5bV9uGL9+vWmYRjms88+e83blle8fQ8FSktLkyRVqVKlxL+ratWqkqQVK1YoOzv7mrY9e/as1qxZowceeEDnz5/X6dOndfr0aZ05c0ZRUVH65ZdfdPz4cYdthg8fXuTx382aNdOtt95q/1yrVi01btxYv/76q70sLi5OERERatOmjb2sevXqGjBgQJG+w9fX1/73S5cu6fTp07r55pslSTt27CjSPv6M4jqHvz+O7OxsnTlzRo0aNVLVqlWv+zi+/vprBQUFqX///vayChUq6J///KfS09O1bt06h/p9+/ZVtWrV7J+v/Nv9/t8rPxcvXsz3yZSPj499PYBctA+5aB/KR/sAoOhoH3LRPpTP9uHkyZP629/+prCwMD355JPXFXt5RFIKBfLz85MknT9/vsS/6/bbb9f999+vSZMmqWbNmurdu7cWLlyozMzMq267f/9+maapZ599VrVq1XJYJkyYICn3AvF7YWFhRY6tbt26ecqqVaumc+fO2T8fPnxYjRo1ylMvv7L8nD17VmPGjFFgYKB8fX1Vq1Yte4ypqalFjvV6Fdc5vHjxosaPH6/Q0FBZLBbVrFlTtWrVUkpKynUfx+HDh3XDDTfIw8PxcnWlu+7hw4cdyv/473Wlgfn9v1d+fH198/3/dunSJft6ALloH3LRPpSP9gFA0dE+5KJ9KH/tQ0ZGhu655x6dP39en3/+ucPk5ygcc0qhQH5+fgoJCdHu3buvex+GYeRbnpOTk6fexx9/rE2bNunLL7/UypUr9dBDD+nVV1/Vpk2bCv2httlskqTHH39cUVFR+db548X9WhIMBT0RMU2zyPu4mgceeEAbN27UE088oTZt2qhy5cqy2Wzq3r27/fhKUnGdw9GjR2vhwoUaO3asIiIi5O/vL8Mw1K9fP6cch3T9/17BwcH69ttvZZqmw//bpKQkSVJISEjxBQmUcbQPuWgfcrl7+wCg6GgfctE+5Cov7UNWVpbuu+8+7dy5UytXrlSLFi2KMzy3R1IKhbrnnns0d+5cJSQkKCIi4pq3v5JlTklJsXexlfJmp6+4+eabdfPNN+uFF17QkiVLNGDAAC1dulTDhg0rsIFq0KCBpNwuma567Wa9evW0f//+POX5lf3RuXPnFB8fr0mTJmn8+PH28l9++SVP3YLOQVGV9Dn8+OOPNWjQIL366qv2skuXLiklJaVIceSnXr162rlzp2w2m8PTjr1799rXF4c2bdpo3rx52rNnj5o1a2Yv37x5s309gN/QPhQN7UOustw+ALg2tA9FQ/uQq6y3DzabTQMHDlR8fLw+/PBD3X777cW27/KC4Xso1JNPPqlKlSpp2LBhSk5OzrP+wIEDeuONNwrcvmHDhpKk9evX28syMjL07rvvOtQ7d+5cnkz0lSTAlS64FStWlKQ8F6iAgAB16dJFb7/9tr1Xy++dOnWqwPiKS1RUlBISEpSYmGgvO3v2rN5///2rbnslM//H458+fXqeupUqVZKU9xwUVUmfQ09PzzzH8eabb+Z5snUtx3H33XfLarVq2bJl9rLLly/rzTffVOXKlYvtwt+7d29VqFBBb731lr3MNE3NmTNHtWvXLvE3yABlDe1D0dA+5CrL7QOAa0P7UDS0D7nKevswevRoLVu2TG+99Zb97YS4NvSUQqEaNmyoJUuWqG/fvmratKkGDhyoFi1aKCsrSxs3brS/WrMg3bp1U926dTV06FA98cQT8vT01IIFC1SrVi0dOXLEXu/dd9/VW2+9pXvvvVcNGzbU+fPn9c4778jPz0933323pNzuns2aNdOyZct04403qnr16mrRooVatGihWbNm6ZZbblHLli01fPhwNWjQQMnJyUpISNCxY8f0ww8/lOh5evLJJ7V48WLdddddGj16tP2VrnXr1tXZs2cLzez7+fnptttu00svvaTs7GzVrl1bq1at0sGDB/PUbdeunSTp//7v/9SvXz9VqFBBvXr1sl+kr6akz+E999yjf//73/L391ezZs2UkJCgb775RjVq1HCo16ZNG3l6emratGlKTU2VxWLRHXfc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vSw8PFyLFi1SXFycZs+erYMHD+rWW2/V+fPn891HZmam0tLSHJayzrzwkSTPAtdnZplKOrhIVqvVvpw+fdp5AQIoM9wqKTV79my1atVKfn5+9okJ//Of/xS6zUcffaQmTZrIx8dHLVu21Ndff+2kaIHSy3roZJ6yEzqk6gqQl1FBknT+XIYuZVySJN1///3atm2bdu7c6dQ4AXdgPXhSnhUcf7H/48+baTN16mjufB38vAGAcyxZskSTJk3Shx9+qICAAHt5jx491KdPH7Vq1UpRUVH6+uuvlZKSog8//DDf/UydOlX+/v72JTQ01FmHUHJyjkrKKXD1ym8vqHbL7xQcHGxfbrnlFufFB6DMcKukVJ06dfTiiy9q+/bt2rZtm+644w717t1bP/74Y771N27cqP79+2vo0KH6/vvvFR0drejoaO3evdvJkQOlS5VqlR3mtpGkNkZntTV++2XCy9tL3r7ekqSOHTvKNE21atXKqXEC7qBK9cqy5dgcyv7483alnsTPGwA4w9KlSzVs2DB9+OGHioyMLLRu1apVdeONN2r//v35ro+NjVVqaqp9OXr0aEmE7FweVVVQT6mFbwQpJ+kG5Vg7yDRN+7J3716nhgigbHCrpFSvXr10991364YbbtCNN96oF154QZUrV9amTZvyrf/GG2+oe/fueuKJJ9S0aVNNnjxZN910k2bOnOnkyIHSpWv/W5RzueCnXx5eHurar7M8PQvutg2gaG79682Frjc8DDXu0EhB9QMKrQcAKB4ffPCBhgwZog8++EA9e/a8av309HQdOHBAwcHB+a63WCz2kRxXlrLO8LlHhfWUkjwl32gnRQOgLHOrpNTv5eTkaOnSpcrIyFBERES+dRISEvI8+YiKilJCQkKh+3bHceHA7zXv1Fjto9rkmVdKkjw8PFTBu4L6PhXt/MCAfJTE0G3TNDV+/HgFBwfL19dXkZGR+uWXX0ok/poh1RU9uof+0DkxlyHJlB56oX+JfDcAuLv09HQlJiYqMTFRknTw4EElJibaJyaPjY3VwIED7fWXLFmigQMH6tVXX1V4eLh9PqTU1FR7nccff1zr1q3ToUOHtHHjRt17773y9PRU//7l6FptuV2q0Fr595bylIxKMioNdnJQAMoit0tK7dq1S5UrV5bFYtEjjzyizz77TM2aNcu3rtVqVWBgoENZYGCg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Zw4LANwKPaUAAG4lNTVVklS9evUib3PhwgVlZ2fn2Wbt2rUKCAhQ48aNNWLECJ05c6bAfWRmZiotLc1hAQCULRERERo4cKDatGmj22+/XZ9++qlq1aqlt99++7r3OXXqVPn7+9uX0NDQYowYAMo2klIAALdhs9k0duxYde7cWS1atCjydk899ZRCQkIchmN0795d7733nuLj4zVt2jStW7dOPXr0UE5OTr774KYDAEqXmjVrytPTU8nJyQ7lycnJRe4FW6FCBbVt21b79++XJPt217LP2NhYpaam2pejR49e66EAgNsiKQUAcBsjR47U7t27tXTp0iJv8+KLL2rp0qX67LPPHF773a9fP/3lL39Ry5YtFR0drRUrVmjr1q1au3ZtvvvhpgMAShdvb2+1a9dO8fHx9jKbzab4+HhFREQUaR85OTnatWuXgoODJUlhYWEKCgpy2GdaWpo2b95c4D4tFov8/PwcFgBALrdKSq1fv169evVSSEiIDMO46hsw1q5dm+fNSoZhFDgeHABQeo0aNUorVqzQt99+qzp16hRpm1deeUUvvviiVq1apVatWhVat0GDBqpZs6b9afkfcdMBAKVPTEyM3nnnHb377rvas2ePRowYoYyMDA0ZMkSSNHDgQMXGxtrrP/fcc1q1apV+/fVX7dixQw8++KAOHz6sYcOGScp9M9/YsWP1/PPP64svvtCuXbs0cOBAhYSEKDo62hWHCABlmltNdJ6RkaHWrVvroYce0n333Vfk7fbt2+dw8xAQEFAS4QEASoBpmho9erQ+++wzrV27VmFhYUXa7qWXXtILL7yglStXqn379letf+zYMZ05c8b+tBwAUPr17dtXp06d0vjx42W1WtWmTRvFxcXZJyo/cuSIPDx+e05/7tw5DR8+XFarVdWqVVO7du20ceNGNWvWzF7nySefVEZGhh5++GGlpKTolltuUVxcnENvWwBA0RimaZquDqIkGIahzz77rNAnFmvXrlXXrl117tw5Va1a9bq/Ky0tTf7+/kpNTeXJOIAyp6xfwx599FEtWbJEn3/+uRo3bmwv9/f3l6+vr6TcJ+G1a9fW1KlTJUnTpk3T+PHjtWTJEnXu3Nm+TeXKlVW5cmWlp6dr0qRJuv/++xUUFKQDBw7oySef1Pnz57Vr1y5ZLJarxlXWzysAcB0rGZxXAGVdcV7H3Gr43vVq06aNgoODddddd+m77767an3esAQApcfs2bOVmpqqLl26KDg42L4sW7bMXufIkSNKSkpy2CYrK0t//etfHbZ55ZVXJEmenp7auXOn/vKXv+jGG2/U0KFD1a5dO/33v/8tUkIKAAAAwNW51fC9axUcHKw5c+aoffv2yszM1Lx589SlSxdt3rxZN910U4HbTZ06VZMmTXJipACAghSlw+8fJyc/dOhQofV9fX21cuXKPxEVAAAAgKsp10mpxo0bOwz16NSpkw4cOKDXX39d//73vwvcLjY2VjExMfbPaWlpvPobAAAAAADgGpTrpFR+OnbsqA0bNhRax2KxMHwDAAAAAADgT2BOqT9ITEzkzUoAAAAAAAAlzK16SqWnp2v//v32zwcPHlRiYqKqV6+uunXrKjY2VsePH9d7770nSZo+fbrCwsLUvHlzXbp0SfPmzdOaNWu0atUqVx0CAAAAAABAueBWSalt27apa9eu9s9X5n0aNGiQFi1apKSkJB05csS+PisrS4899piOHz+uihUrqlWrVvrmm28c9gEAAAAAAIDiZ5hFeW0RCpWWliZ/f3+lpqbKz8/P1eEAwDXhGlYyOK8AyjquYyWD8wqgrCvO6xhzSgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAC4yePBgRUdH5ylfu3atDMNQSkqK02MCAMBZSEohX4MHD5ZhGHmW7t27uzo0AAAAAADgBtzq7XsoXt27d9fChQsdyiwWi4uiAQAAAAAA7oSkFApksVgUFBTk6jAAAAAAAIAbYvgeALfyx6GnNWrUUPfu3bVz505XhwYAgCTJNC/LzLHKtJ2VJK1YsUKVK1d2WHr06OHiKAEAKHkkpVCg/H5BmjJliqvDAq6qe/fuSkpKUlJSkuLj4+Xl5aV77rnH1WEBAMo507wk2/kZMk/dIvPUbTJP3izz0rfqensrJSYmOizz5s1zdbgAAJQ4hu9BpmlKWRtkXnhfyv5RMnxlZp9T1y6dNXvOfIe61atXd1GUQNH9fuhpUFCQxo0bp1tvvVWnTp1SrVq1XBwdAKA8Ms1MmWcfkrJ3SLL9bkWKKlY4o4bB/5VRaYi9+NixY84PEgAAJyMpVc6Zpikz7Tnp4vuSPCXl5K64nKyKFaSGdc/L8G7ryhCBPyU9PV2LFy9Wo0aNVKNGDVeHAwAory68L2Vvl2T+YUXuZ/P8i5LlLhledZweGgAArsLwvfLu0mf/S0hJ9oSUJMmUTJvMcw/LNC+6IjLguv1+6GmVKlX0xRdfaNmyZfLwKPlL3uDBgxUdHV3i3wMAKFvMC+8rb0Lq9zxkXvzYWeEAAFAq0FOqnDMzFkgylN8vSZlZNlmTz8jIWCyjYi9JkpeXl2rWrOncIIECJP2arM9nxWnDZ5uVnZmtG9o11OmLZ9W1a1fNnj1bknTu3Dm99dZb6tGjh7Zs2aJ69eq5OGoAQHljmpelnKNXqWWTLv/ilHgAACgtijUpdeLECYWEhBTnLlGCTNsF6fLPBa5f+e0F1W59UNLD9rLGjRtr7969TogOKNz3a3bpmXte1OXsy7Ll5M7NsfU/32vX5Z2q1aC6GjZsKMMwJEnz5s2Tv7+/3nnnHT3//POuDLvco50AUD55SqogKTvPmoVvBP3vbx6SUcle3qVLl9x5P8swrvkAgKsp1rEszZs315IlS4pzlyhJ/7thz8/CN4KUk3SDcpKaKCdlXO7cU6ZJQgqlQkZqhiZEv6TsrGx7QkqS/e9JvyZr7bKN9nLDMOTh4aGLFxmK6mq0EwDKI8MwJJ/uyk1OFSRHhk+Us0JyCq75AICrKdak1AsvvKB//OMf6tOnj86ePVucu0YJMAxfyau5Cv9vkCPDO9xZIQFFsvq99bqUkSnTlv8TZJtsem/aUlmtVu3Zs0ejR49Wenq6evXq5eRI8Ue0EwDKK6PSUOVOmZDfQ0FPyetGydLFuUGVMK75AICrKdak1KOPPqqdO3fqzJkzatasmb788svi3D1KQO4vSLYC1npIHjUknx7ODAm4qh837s3/d/r/OSOrFiXOVHBwsMLDw7V161Z99NFH6tKlS7HGYZqmtq/+QS/0f12jI57WhOiXlHz4VJkfblGSaCcAlFdGhWYyqs353RA9L9ln0vBqKqPaQhlGYT2pyh6u+QCAqyn2ic7DwsK0Zs0azZw5U/fdd5+aNm0qLy/Hr9mxY0dxfy2ul09P6fIeKeMd5XYpv/IGPg/JqCyj2jwZhsWFAQJ5GR6GDMOQmc8E/c2NDmquDjIM6T9ZS+XpWTK/4F/Ovqzn+72u7z7bIg8vD9ku2+Th6aFdl3+UTzVvZaRmqJJ/pavvqByinQBQXhmW26RaG6RLX8u8/JMkbxk+d0gVOtjnQXQ3XPMBAIUpkbfvHT58WJ9++qmqVaum3r1752l4UHoYhiGjyhMyLXfIvLBEyv5RMnxz5zSo+IAMj+quDhHIo03Xlvr2g+8KXO/h6aHmnRuXWEJKkhY9u1Qbl2+VJNku5/Y2vDKnVXpKhl4ZNlsTPnq8xL6/rKOdAFBeGR4VpYp/LazDr9vhmg8AKEixtwjvvPOOHnvsMUVGRurHH39UrVq1ivsrUAIM73YyvNu5OgygSLr276z5se8rPSVdtpy8vaVsOTb1eewvJfb9F9Mv6vNZcQUP0zOlDZ9uVtLBZAWHBZZYHFdjtVr1wgsv6KuvvtLx48cVEBCgNm3aaOzYsbrzzjtdFldxtxNTp07Vp59+qr1798rX11edOnXStGnT1Lhx40K3++ijj/Tss8/q0KFDuuGGGzRt2jTdfffd9vWmaWrChAl65513lJKSos6dO2v27Nm64YYb/lS8AFCecG8AAChMsc4p1b17dz311FOaOXOmPv30UxodACXCt5KPpnz9tHyr+Mrw+O1Zs6dX7iVt8OR+iujVvsS+f++W/bqUkVl4JVNKXLO7xGK4mkOHDqldu3Zas2aNXn75Ze3atUtxcXHq2rWrRo4c6bK4SqKdWLdunUaOHKlNmzZp9erVys7OVrdu3ZSRkVHgNhs3blT//v01dOhQff/994qOjlZ0dLR27/7t3+yll17SjBkzNGfOHG3evFmVKlVSVFSULl269KdjBoDyoLTcG8yaNUv169eXj4+PwsPDtWXLlgLrvvPOO7r11ltVrVo1VatWTZGRkXnqDx48OHe0we+W7t27l/RhAIBbKtaeUjk5Odq5c6fq1KlTnLsFgDwad2ikRftmKG7Bt/rus83KvJilxh0aqdeIbrqxXcMS/e4rw/Ty09zoYP97zuWC65W0Rx99VIZhaMuWLapU6be5rZo3b66HHnrIZXGVRDsRFxfn8HnRokUKCAjQ9u3bddttt+W7zRtvvKHu3bvriSeekCRNnjxZq1ev1syZMzVnzhyZpqnp06frmWeeUe/evSVJ7733ngIDA7V8+XL169ev2OIHAHdVGu4Nli1bppiYGM2ZM0fh4eGaPn26oqKitG/fPgUEBOSpv3btWvXv31+dOnWSj4+Ppk2bpm7duunHH39U7dq17fW6d++uhQsX2j9bLMzBCgDXo1iTUqtXry7O3QFAoarW8le/p6LV76lop35vo7Zh8vTyVM7lnELrNb3ZNcO8zp49q7i4OL3wwgsOCakrqlat6vyg/scZ7URqaqokqXr1gufES0hIUExMjENZVFSUli9fLkk6ePCgrFarIiMj7ev9/f0VHh6uhIQEklIAUASl4d7gtdde0/DhwzVkyBBJ0pw5c/TVV19pwYIFGjduXJ7677//vsPnefPm6ZNPPlF8fLwGDhxoL7dYLAoKCirZ4AGgHCjW4XsAUB741/TTHX+7RR6e+V9CPb081CziRjVsXd+5gf3P/v37ZZqmmjRp4pLvdyWbzaaxY8eqc+fOatGiRYH1rFarAgMd5/sKDAyU1Wq1r79SVlCdP8rMzFRaWprDAgBwnaysLG3fvt3hAYOHh4ciIyOVkJBQpH1cuHBB2dnZeR50rF27VgEBAWrcuLFGjBihM2fOFLgP2gcAKBivvgCA6/Do9CE6kHhIB3cdkSlT+t+c5x4ehqoFVVPs+2OcFotpmtr13z36aeM+eXh6yCPQdcMGXW3kyJHavXu3NmzY4PTvnjp1qiZNmuT07wUA5O/06dPKycnJ9wHD3r17i7SPp556SiEhIQ6Jre7du+u+++5TWFiYDhw4oKefflo9evRQQkJCvm/+pX0AgIKRlAKA61C5aiVN/+55xc1fo6/mrtapo2fkV7OKug+5Q71GdJNfjSpOiePYzyc08f5XdPjHo/aeW5mXcyfi3rH1e917771OiaM0GDVqlFasWKH169dfdf6SoKAgJScnO5QlJyfbh2Jc+TM5OVnBwcEOddq0aZPvPmNjYx2GBKalpSk0NPR6DgUAUAq8+OKLWrp0qdauXSsfHx97+e+HcLds2VKtWrVSw4YNtXbt2nzfbkv7AAAFY/geAFwn30o+uvefd2ve7tf1eep7+veBWRrwzP1OS0ilnEpVzO3jdXTvcUm5E7DbcmyqYHirphGk115+XefOnMu7XUqKU+JzFtM0NWrUKH322Wdas2aNwsLCrrpNRESE4uPjHcpWr16tiIgISVJYWJiCgoIc6qSlpWnz5s32On9ksVjk5+fnsAAAXKdmzZry9PQs9CFEQV555RW9+OKLWrVqlVq1alVo3QYNGqhmzZrav39/vutLqn2wWq0aM2aMGjVqJB8fHwUGBqpz586aPXu2Lly4UCzfAQAljaQUAJRRX85epdTT5/N9G+CNZhtdvnxZbVq11SeffKJffvlFe/bs0YwZMwpMqpRVI0eO1OLFi7VkyRJVqVJFVqtVVqtVFy9etNcZOHCgYmNj7Z/HjBmjuLg4vfrqq9q7d68mTpyobdu2adSoUZIkwzA0duxYPf/88/riiy+0a9cuDRw4UCEhIYqOjnb2IQIAroO3t7fatWvn8IDBZrMpPj6+0LbwpZde0uTJkxUXF6f27dtf9XuOHTumM2fOOPSsLWm//vqr2rZtq1WrVmnKlCn6/vvvlZCQoCeffFIrVqzQN99847RYAODPcKuk1Pr169WrVy+FhITIMAz7W5QKs3btWt10002yWCxq1KiRFi1aVOJxAkBx+Obf6/JNSElSRaOybvaIVA3PQD322GNq0aKF7rrrLsXHx2v27NlOjrRkzZ49W6mpqerSpYuCg4Pty7Jly+x1jhw5oqSkJPvnTp06acmSJZo7d65at26tjz/+WMuXL3eYHP3JJ5/U6NGj9fDDD6tDhw5KT09XXFycwxAOAEDpFhMTo3feeUfvvvuu9uzZoxEjRigjI8P+Nr4/PrSYNm2ann32WS1YsED169e3P+hIT0+XJKWnp+uJJ57Qpk2bdOjQIcXHx6t3795q1KiRoqKinHZcjz76qLy8vLRt2zY98MADatq0qRo0aKDevXvrq6++Uq9evZwWCwD8GW41p1RGRoZat26thx56SPfdd99V6x88eFA9e/bUI488ovfff1/x8fEaNmyYgoODndqoAMD1OH8uo9D13qaPOta8TXN2vOykiFzDNM2r1lm7dm2esj59+qhPnz4FbmMYhp577jk999xzfyY8AIAL9e3bV6dOndL48eNltVrVpk0bxcXF2Sc/P3LkiDw8fntOP3v2bGVlZemvf/2rw34mTJigiRMnytPTUzt37tS7776rlJQUhYSEqFu3bpo8ebIsFotTjunMmTP2HlKVKlXKt45hGE6JBQD+LLdKSvXo0UM9evQocv05c+YoLCxMr776qiSpadOm2rBhg15//XWSUgBKvZCGgfo5JUOmLf+kjKeXh+rc6LyhBAAAlEajRo2yD8/+oz8+tDh06FCh+/L19dXKlSuLKbLrs3//fpmmqcaNGzuU16xZU5cu5b7sZOTIkZo2bZorwgOAa+JWw/euVUJCgsPrXSUpKipKCQkJLooIAIrunn90KzAhJUk5l226e/hdTowIAACUhPPn0rXmgw36au5q/bLj13zrbNmyRYmJiWrevLkyMzOdHCEAXB+36il1raxWq73r7hWBgYFKS0vTxYsX5evrm+92mZmZDhf6tLS0Eo0TAPJz54O3avW/12n3f/fI9sfklCHd0f8Wtb2jRf4bAwCAUi8nJ0eLnl2mT17/UtmZlyVJWWbufcj6VRt077332us2aNBAkgq8hwGA0qhc95S6XlOnTpW/v799CQ0NdXVIAMqhCt4VNOXrp3Xf2HvkW/m3ybf9alTRkMn99eS7o5hTAgCAMmxOzLtaOu0ze0JKkrwNi2ooULPnzNbOhB9dGB0A/HnluqdUUFCQkpOTHcqSk5Pl5+dX6BOG2NhYxcTE2D+npaWRmALgEhZfi/7xykANeq6vDv90TJ6eHqrXvI4qeFdwdWgAAOBPsB46qeUz/yPlM1K/sdpqm9bqjm5dNWvem2rVqpU8PDy0detW7d27V+3atXN+wABwHcp1UioiIkJff/21Q9nq1asVERFR6HYWi8Vpb9cAgKLwqWhR4/YNXR0GAAAoJmuWbJCHh4dsObY86yoalRVu3qlDGfs07qlxOn7iuCwWi5o1a6bHH39cjz76qAsiBoBr51ZJqfT0dO3fv9/++eDBg0pMTFT16tVVt25dxcbG6vjx43rvvfckSY888ohmzpypJ598Ug899JDWrFmjDz/8UF999ZWrDgEAAAAAlHoqTR4ehmw5+a+3GL5qrDZ6N/5NhTQM+tPfN3jwYKWkpGj58uV/el8AUFRuNafUtm3b1LZtW7Vt21aSFBMTo7Zt22r8+PGSpKSkJB05csRePywsTF999ZVWr16t1q1b69VXX9W8efMUFRXlkvgBAAAAQJJqhdZQTj69pH7P08tTVQP8nRQRABQ/t+op1aVLF5lmwa9HX7RoUb7bfP/99yUYFQAAAABcmzv+dovmjVusnD++Yfd/PL08dPsDEapYhbftASi73KqnFAAAAAC4g+pB1TRwYt9813l4esi3iq8GTcp/PQCUFSSlAAAAAKAU6h97r0bPHJZniF6r25rpje9eKJa5pADAldxq+B4AAAAAuAvDMPSXR6N09/A7tWfTL7pw/qJCG4f86WRUekqGvpy9Sv+ZH69zySmqFlhVh/2PqEpQpWKKHACKhqQUAAAAAJRiXhW81PLWpsWyrzNJ5/SvW5+V9dBJmf+bryrp12T9ol/lVdFDZ63nVD2oWrF8FwBcDcP3AAAAAKCceHXoWzp55JQ9IWVnSpkXMvXq8DmuCQxAuURSCgAAAADKgaRfk7U1LlE5l235rjdNacvXO2Q9dNLJkQEor0hKAQAAAEA5sG/r/gLXmTJlyJBMad/WA06MCkB5RlIKAAAAAMoBTy/PAtdlK1Pe8vlfPW4TATgHVxsAAAAAKAda3tY0T2Iq28zSKfOEzumUqitAXhU81eq2Zi6KEEB5Q1IKAAAAAMqBqrX8FTWkiwwPw172k7Zpr75XXd2oAI/a6v7QHfKrUcV1QQIoV7xcHQAAAAAAwDkenT5EyYdOafvqnfLw9FDrnE7y8PKQ7bJN7e9qrRGvD3Z1iADKEZJSAAAAAFBOWHwtmvKf/9P21Tu1atG3OnXsjGrVqaFug7uq3V2t5OHBYBoAzkNSCgAAAADKEQ8PD3WIaqMOUW1cHQqAco40OAAAAAAAAJyOpBQAAAAAAACcjqQUAAAAAAAAnI6kFACgzFu/fr169eqlkJAQGYah5cuXF1p/8ODBMgwjz9K8eXN7nYkTJ+ZZ36RJkxI+EgAAAKD8ICkFACjzMjIy1Lp1a82aNatI9d944w0lJSXZl6NHj6p69erq06ePQ73mzZs71NuwYUNJhA8AAACUSySlAABlXo8ePfT888/r3nvvLVJ9f39/BQUF2Zdt27bp3LlzGjJkiEM9Ly8vh3o1a9YsifABACVo1qxZql+/vnx8fBQeHq4tW7YUWv+jjz5SkyZN5OPjo5YtW+rrr792WG+apsaPH6/g4GD5+voqMjJSv/zyS0keAgC4LZJSAIByb/78+YqMjFS9evUcyn/55ReFhISoQYMGGjBggI4cOeKiCAEA12PZsmWKiYnRhAkTtGPHDrVu3VpRUVE6efJkvvU3btyo/v37a+jQofr+++8VHR2t6Oho7d69217npZde0owZMzRnzhxt3rxZlSpVUlRUlC5duuSswwIAt0FSCgBQrp04cUL/+c9/NGzYMIfy8PBwLVq0SHFxcZo9e7YOHjyoW2+9VefPn893P5mZmUpLS3NYAACu9dprr2n48OEaMmSImjVrpjlz5qhixYpasGBBvvXfeOMNde/eXU888YSaNm2qyZMn66abbtLMmTMl5faSmj59up555hn17t1brVq10nvvvacTJ05cdT5DAEBeJKUAAOXau+++q6pVqyo6OtqhvEePHurTp49atWqlqKgoff3110pJSdGHH36Y736mTp0qf39/+xIaGuqE6AEABcnKytL27dsVGRlpL/Pw8FBkZKQSEhLy3SYhIcGhviRFRUXZ6x88eFBWq9Whjr+/v8LDwwvcJwCgYCSlAADllmmaWrBggf7+97/L29u70LpVq1bVjTfeqP379+e7PjY2Vqmpqfbl6NGjJREyAKCITp8+rZycHAUGBjqUBwYGymq15ruN1WottP6VP69ln/SkBYCCkZQCAJRb69at0/79+zV06NCr1k1PT9eBAwcUHByc73qLxSI/Pz+HBQAAetICQMFISgEAyrz09HQlJiYqMTFRUu7wisTERPvE5LGxsRo4cGCe7ebPn6/w8HC1aNEiz7rHH39c69at06FDh7Rx40bde++98vT0VP/+/Uv0WAAAxaNmzZry9PRUcnKyQ3lycrKCgoLy3SYoKKjQ+lf+vJZ90pMWAApGUgoAUOZt27ZNbdu2Vdu2bSVJMTExatu2rcaPHy9JSkpKyvPmvNTUVH3yyScF9pI6duyY+vfvr8aNG+uBBx5QjRo1tGnTJtWqVatkDwYAUCy8vb3Vrl07xcfH28tsNpvi4+MVERGR7zYREREO9SVp9erV9vphYWEKCgpyqJOWlqbNmzcXuE960gJAwbxcHQAAAH9Wly5dZJpmgesXLVqUp8zf318XLlwocJulS5cWR2gAABeKiYnRoEGD1L59e3Xs2FHTp09XRkaGhgwZIkkaOHCgateuralTp0qSxowZo9tvv12vvvqqevbsqaVLl2rbtm2aO3euJMkwDI0dO1bPP/+8brjhBoWFhenZZ59VSEhInhdmAACujqQUAAAAALfUt29fnTp1SuPHj5fValWbNm0UFxdnn6j8yJEj8vD4bfBIp06dtGTJEj3zzDN6+umndcMNN2j58uUOw7yffPJJZWRk6OGHH1ZKSopuueUWxcXFycfHx+nHBwBlnWEW9mi5jJo1a5ZefvllWa1WtW7dWm+++aY6duyYb91FixbZn5RcYbFYdOnSpSJ/X1pamvz9/ZWamkp3XABlDtewksF5BVDWcR0rGZxXAGVdcV7H3G5OqWXLlikmJkYTJkzQjh071Lp1a0VFRenkyZMFbuPn56ekpCT7cvjwYSdGDAAAAAAAUP64XVLqtdde0/DhwzVkyBA1a9ZMc+bMUcWKFbVgwYICtzEMQ0FBQfblSndeAAAAAAAAlAy3SkplZWVp+/btioyMtJd5eHgoMjJSCQkJBW6Xnp6uevXqKTQ0VL1799aPP/5Y6PdkZmYqLS3NYQEAAAAAAEDRuVVS6vTp08rJycnT0ykwMFBWqzXfbRo3bqwFCxbo888/1+LFi2Wz2dSpUycdO3aswO+ZOnWq/P397UtoaGixHgcAAAAAAIC7c6uk1PWIiIjQwIED1aZNG91+++369NNPVatWLb399tsFbhMbG6vU1FT7cvToUSdGDAAAAAAAUPZ5uTqA4lSzZk15enoqOTnZoTw5OVlBQUFF2keFChXUtm1b7d+/v8A6FotFFovlT8UKAAAAAABQnrlVTylvb2+1a9dO8fHx9jKbzab4+HhFREQUaR85OTnatWuXgoODSypMAAAAAACAcs+tekpJUkxMjAYNGqT27durY8eOmj59ujIyMjRkyBBJ0sCBA1W7dm1NnTpVkvTcc8/p5ptvVqNGjZSSkqKXX35Zhw8f1rBhw1x5GAAAAAAAAG7N7ZJSffv21alTpzR+/HhZrVa1adNGcXFx9snPjxw5Ig+P3zqInTt3TsOHD5fValW1atXUrl07bdy4Uc2aNXPVIQAAAAAAALg9wzRN09VBlHVpaWny9/dXamqq/Pz8XB0OAFwTrmElg/MKoKzjOlYyOK8AyrrivI651ZxSAAAAAAAAKBtISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKlRJWq1VjxoxRo0aN5OPjo8DAQHXu3FmzZ8/WhQsXXB0eAAAAAABAsfJydQCQfv31V3Xu3FlVq1bVlClT1LJlS1ksFu3atUtz585V7dq19Ze//MXVYQIAAAAAABQbklKlwKOPPiovLy9t27ZNlSpVspc3aNBAvXv3lmmaLowOAAAAAACg+DF8z8XOnDmjVatWaeTIkQ4Jqd8zDMPJUQEAAAAAAJQsklIutn//fpmmqcaNGzuU16xZU5UrV1blypX11FNPuSg6ACgb1q9fr169eikkJESGYWj58uWF1l+7dq0Mw8izWK1Wh3qzZs1S/fr15ePjo/DwcG3ZsqUEjwIAgNJp8ODB+bab+/fvd3VoAMo4klJOZuacku38a7KdvEU2ayvZzv0zt9yW6VBvy5YtSkxMVPPmzZWZmZnfrgo0ePBgRUdHF1fIAFDqZWRkqHXr1po1a9Y1bbdv3z4lJSXZl4CAAPu6ZcuWKSYmRhMmTNCOHTvUunVrRUVF6eTJk8UdPgAApV737t0d2sykpCSFhYW5OiwAZRxzSjmRefmgzLP9JVuKJJskqVHdCzIMaV/iJJn39pThUUVS7nxSkuTr6+uiaAGg7OjRo4d69OhxzdsFBASoatWq+a577bXXNHz4cA0ZMkSSNGfOHH311VdasGCBxo0b92fCBQCgzLFYLAoKCnJ1GADcDD2lnMQ0TZkp/5RsqbqSkJKkGtU9FHlbRc2av1/p1udcFyAAlENt2rRRcHCw7rrrLn333Xf28qysLG3fvl2RkZH2Mg8PD0VGRiohISHffWVmZiotLc1hAQAAAFAwklLOkv2DdHmfpJw8q2a9WEuXL5vqePsMLf1gofbs2aN9+/Zp8eLF2rt3rzw9PZ0fLwC4seDgYM2ZM0effPKJPvnkE4WGhqpLly7asWOHJOn06dPKyclRYGCgw3aBgYF55p26YurUqfL397cvoaGhJX4cAICCnT17VgMGDJCfn5+qVq2qoUOHKj09vdD6o0ePVuPGjeXr66u6devqn//8p1JTUx3q5Te30tKlS0v6cFxuxYoV9jlvK1eurD59+rg6JABugOF7zpK9U7k5QFueVQ3re2v76rqaOuOsnn76GR07fkoWi0XNmjXT448/rkcfffSquzfNHMl2VjK8iz92AHAzjRs3dnjBRKdOnXTgwAG9/vrr+ve//31d+4yNjVVMTIz9c1paGokpAHChAQMGKCkpSatXr1Z2draGDBmihx9+WEuWLMm3/okTJ3TixAm98soratasmQ4fPqxHHnlEJ06c0Mcff+xQd+HCherevbv9c0FDwcuq08fP6Ku532jTV9uVk52jny79rJs7RGjRvxfa6xT05nAAuBYkpZzF8JRkFrg6ONBLM14I0JvVl8rwvqnIuzXNS1LGOzIvvJ+blJJkZmZJOXX+bMQAUK507NhRGzZskJT7BlRPT08lJyc71ElOTi5wPg2LxSKLxVLicQIArm7Pnj2Ki4vT1q1b1b59e0nSm2++qbvvvluvvPKKQkJC8mzTokULffLJJ/bPDRs21AsvvKAHH3xQly9flpfXb7dOVatWddv5lRK/3a1ner2o7Mxs2XJyH6gfV5KyzSzt/s8vih597XM4AkBBGL7nLN6dVVhSSpJk+EkVWhR5l6aZKfPsEJnps+wJKUmS7ZzM7ESZGYuvL1YAKIcSExMVHBwsSfL29la7du0UHx9vX2+z2RQfH6+IiAhXhQgAKKKEhARVrVrVnpCSpMjISHl4eGjz5s1F3k9qaqr8/PwcElKSNHLkSNWsWVMdO3bUggULZJpX+T2/jEg9naZn//Kisi5l2RNSkuzHN2vMAu1c/5OrwgPghugp5SSGV32ZljukzHXKb14pSTIqDZZxLcPvLvxbyt6hvMmu3M/m+ecln0gZnu75FAcArkhPT9f+/fvtnw8ePKjExERVr15ddevWVWxsrI4fP6733ntPkjR9+nSFhYWpefPmunTpkubNm6c1a9Zo1apV9n3ExMRo0KBBat++vTp27Kjp06crIyPD/jY+AEDpZbVaFRAQ4FDm5eWl6tWrFzg34B+dPn1akydP1sMPP+xQ/txzz+mOO+5QxYoVtWrVKj366KNKT0/XP//5z3z3k5mZqczMTPvn0vwijLgF3yrzYpZMW/5JNk8vD33y+gq1uq2ZkyMD4K5ISjmR4f+SzHNDcyc9t88v5SkpR/LpLVUacU37y+0JdZWnMhc/kiqPvr6AAaCM2LZtm7p27Wr/fGVup0GDBmnRokVKSkrSkSNH7OuzsrL02GOP6fjx46pYsaJatWqlb775xmEfffv21alTpzR+/HhZrVa1adNGcXFxeSY/BwA4z7hx4zRt2rRC6+zZs+dPf09aWpp69uypZs2aaeLEiQ7rnn32Wfvf27Ztq4yMDL388ssFJqWmTp2qSZMm/emYnOH7+J0FJqQkKeeyTTvidzkxIgDuzjDdpa+pC6Wlpcnf39/evbcwpnlZyvxW5sUvcofceYXK8P2rVKGdDMMo8neaZpbM5PyH+g0abdWFi6Y+mldb8omSR9U3rul4AJQv13INQ9FxXgGUdaXxOnbq1CmdOXOm0DoNGjTQ4sWL9dhjj+ncuXP28suXL8vHx0cfffSR7r333gK3P3/+vKKiolSxYkWtWLFCPj4+hX7fV199pXvuuUeXLl3Kd27B/HpKhYaGlqrzesVT3Z7Tjm8KTzr5VLLoy/NMEwKUZ8XZPtBTyskMw0vyuUuGz11/ck9esvey+oOTp3PUKKyCJEMyKv7J7wEAAABKh1q1aqlWrVpXrRcREaGUlBRt375d7dq1kyStWbNGNptN4eHhBW6XlpamqKgoWSwWffHFF1dNSEm5cxJWq1atwJddlKUXYbS4pakS1+yWrYDeUh6eHmpxS1MnRwXAnTHReRllGB6S5S7lJqZynUvJ0YrV6VqXcFF33lpRUo4MSzeXxQgAAAC4QtOmTdW9e3cNHz5cW7Zs0XfffadRo0apX79+9jfvHT9+XE2aNNGWLVsk5SakunXrpoyMDM2fP19paWmyWq2yWq3Kycl9EPzll19q3rx52r17t/bv36/Zs2drypQpGj3aPabLuHt4pDwreEkFDOCw5dh039iezg0KgFujp1QZZlR+WGbmauW2GqaG/itZ237IVMw/qqp3dz/J6wbJcpurwwQAAACc7v3339eoUaN05513ysPDQ/fff79mzJhhX5+dna19+/bpwoULkqQdO3bY38zXqFEjh30dPHhQ9evXV4UKFTRr1iz961//kmmaatSokV577TUNHz7ceQdWgmoEV9OzH8boub++ItM0lXM59w18nl4eyrls06BJfdUhqo1rgwTgVtxyTqlZs2bp5ZdfltVqVevWrfXmm2+qY8eOBdb/6KOP9Oyzz+rQoUO64YYbNG3aNN19991F/j5Xjrc3L62RmRojmRf0W47xsuTVQka1t2V4Xr17M4DyrTTOGeIOOK8AyjquYyWjLJzXYz+f0Ocz45SwYpsuZ+WoeacbFT36brW8laF7AJhTqlDLli1TTEyM5syZo/DwcE2fPl1RUVHat29fntfCStLGjRvVv39/TZ06Vffcc4+WLFmi6Oho7dixQy1a5D+ReGli+NwheX8nXfpSZvZeyfCWYblD8g6/ponTAQAAAECS6twYopEzHtLIGQ+5OhQAbs7tekqFh4erQ4cOmjlzpiTJZrMpNDRUo0eP1rhx4/LU79u3rzIyMrRixQp72c0336w2bdpozpw5RfrOsvC0AwAKwjWsZHBeAZR1XMdKBucVQFlXnNcxt5roPCsrS9u3b1dkZKS9zMPDQ5GRkUpISMh3m4SEBIf6khQVFVVgfQAAAAAAAPx5bjV87/Tp08rJyVFgYKBDeWBgoPbu3ZvvNlarNd/6Vqu1wO/JzMxUZmam/XNaWtqfiBoAAAAAAKD8caueUs4ydepU+fv725fQ0FBXhwQAAAAAAFCmuFVSqmbNmvL09FRycrJDeXJysoKCgvLdJigo6JrqS1JsbKxSU1Pty9GjR/988AAAAAAAAOWIWyWlvL291a5dO8XHx9vLbDab4uPjFRERke82ERERDvUlafXq1QXWlySLxSI/Pz+HBQAAAAAAAEXnVnNKSVJMTIwGDRqk9u3bq2PHjpo+fboyMjI0ZMgQSdLAgQNVu3ZtTZ06VZI0ZswY3X777Xr11VfVs2dPLV26VNu2bdPcuXNdeRgAAAAAAABuze2SUn379tWpU6c0fvx4Wa1WtWnTRnFxcfbJzI8cOSIPj986iHXq1ElLlizRM888o6efflo33HCDli9frhYtWrjqEAAAAAAAANyeYZqm6eogyrq0tDT5+/srNTWVoXwAyhyuYSWD8wqgrOM6VjI4rwDKuuK8jrnVnFIAAAAAAAAoG0hKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKlUODBw+WYRh5lv3797s6NAAAAAAAUE54uToAuEb37t21cOFCh7JatWq5KBoAAAAAAFDekJQqpywWi4KCglwdBgAAAAAAKKcYvgcAAAAAAACnIylVTq1YsUKVK1e2L3369HF1SAAAAAAAoBxh+J6bM3OOy7ywRLoULylLqtBasp1R165dNXv2bHu9SpUquS5IAAAAAABQ7tBTyo2ZmZtknuohZcyXcn6Vco5Jl+JkZq5TJUuyGjVqZF+Cg4NdHS4AXLf169erV69eCgkJkWEYWr58eaH1P/30U911112qVauW/Pz8FBERoZUrVzrUmThxYp63lDZp0qQEjwIAAAAoX0hKuSnTlioz5RFJmZJsv1uTk7v+8q8yL33ritAAoNhlZGSodevWmjVrVpHqr1+/XnfddZe+/vprbd++XV27dlWvXr30/fffO9Rr3ry5kpKS7MuGDRtKInwAAACgXGL4nru6+KlkXpRkFlDBkHlhoQyfrs6MCgBKRI8ePdSjR48i158+fbrD5ylTpujzzz/Xl19+qbZt29rLvby8eFMpCjV48GC9++679s/Vq1dXhw4d9NJLL6lVq1YujAwAAKD0o6eUmzKztlythpS1TaZZUNIKAMoPm82m8+fPq3r16g7lv/zyi0JCQtSgQQMNGDBAR44ccVGEKM26d+9u700XHx8vLy8v3XPPPa4OCwAAoNSjp5TbMgpcs/ANnvoDwO+98sorSk9P1wMPPGAvCw8P16JFi9S4cWMlJSVp0qRJuvXWW7V7925VqVIlzz4yMzOVmZlp/5yWluaU2OF6FovF3qMuKChI48aN06233qpTp06pVq1aLo4OAACg9KKnlJsyvDtepYan5N1BhlFw8goAyoMlS5Zo0qRJ+vDDDxUQEGAv79Gjh/r06aNWrVopKipKX3/9tVJSUvThhx/mu5+pU6fK39/fvoSGhjrrEFCKpKena/HixWrUqJFq1Kjh6nAAAABKNXpKuSvfe6X06ZJ5SY4TnV+RI6PSECcHBQCly9KlSzVs2DB99NFHioyMLLRu1apVdeONN2r//v35ro+NjVVMTIz9c1paGokpN5R5MVM71/2ki+mXFNqktiRpxYoVqly5sqTcSfeDg4O1YsUKeXjw7A8AAKAw/LbkpgwPfxlV35ZkkeM/s2fu+spjZFi6uCAyACgdPvjgAw0ZMkQffPCBevbsedX66enpOnDggIKDg/Ndb7FY5Ofn57DAfZimqaXTluuB4If19N1TNPmB1/Rwq8e0+avturlDhBITE5WYmKgtW7YoKipKPXr00OHDh10dNlCunT17VgMGDJCfn5+qVq2qoUOHKj09vdBtunTpIsMwHJZHHnnEoc6RI0fUs2dPVaxYUQEBAXriiSd0+fLlkjwUAHBb9JRyY4YlXKq1UuaFJdKlbyRlSRXayKj4oAzvNq4ODwCKTXp6ukMPpoMHDyoxMVHVq1dX3bp1FRsbq+PHj+u9996TlDtkb9CgQXrjjTcUHh4uq9UqSfL19ZW/v78k6fHHH1evXr1Ur149nThxQhMmTJCnp6f69+/v/AOEyy34vw+09MXP8pSnnUlXSkqKfMxKqnNDbsJy3rx58vf31zvvvKPnn3/e2aEC+J8BAwYoKSlJq1evVnZ2toYMGaKHH35YS5YsKXS74cOH67nnnrN/rlixov3vOTk56tmzp4KCgrRx40YlJSVp4MCBqlChgqZMmVJixwIA7oqeUm7O8AySR5UYedT6Wh61vpFH1VdISAFwO9u2bVPbtm3Vtm1bSVJMTIzatm2r8ePHS5KSkpIc3pw3d+5cXb58WSNHjlRwcLB9GTNmjL3OsWPH1L9/fzVu3FgPPPCAatSooU2bNjFxdTl08uhpLZu2PN91pmkqJ8emf0/6ba4xwzDk4eGhixcvOilC9zJ48GBFR0e7OgyUcXv27FFcXJzmzZun8PBw3XLLLXrzzTe1dOlSnThxotBtK1asqKCgIPvy+56vq1at0k8//aTFixerTZs26tGjhyZPnqxZs2YpKyurpA8LANwOPaUAAGVely5dZJpmgesXLVrk8Hnt2rVX3efSpUv/ZFRwF/GL/yvDw5CZk///MZuZo1XL1qjfpL/oUtYlzZw5U+np6erVq5eTIwVwRUJCgqpWrar27dvbyyIjI+Xh4aHNmzfr3nvvLXDb999/X4sXL1ZQUJB69eqlZ5991t5bKiEhQS1btlRgYKC9flRUlEaMGKEff/zR/nDk93g7KwAUjKQUAABAIc6cOCvDw5ByClivZK29/IUaNPpCVapUUZMmTfTRRx+pS5cuTo0TwG+sVqvDG1UlycvLS9WrV7cP2c7P3/72N9WrV08hISHauXOnnnrqKe3bt0+ffvqpfb+/T0hJsn8uaL9Tp07VpEmT/szhAIDbIikFAABQiGpBVWXa8u8l1dzooObqIA9PD312dpEqVvF1cnRA+TJu3DhNmzat0Dp79uy57v0//PDD9r+3bNlSwcHBuvPOO3XgwAE1bNjwuvbJ21kBoGAkpQAAAApx54BbtWh8wcM5Pbw8dOt94SSkACd47LHHNHjw4ELrNGjQQEFBQTp58qRD+eXLl3X27FkFBQUV+fvCw8MlSfv371fDhg0VFBSkLVu2ONRJTk6WpAL3a7FYZLFYivydAFCekJQCAAAoRFD9AN0/9h598vqKPOs8PD1k8fHW3yc84ILIyj7TzJIufSMzc6VkS5e8Gko25ttBwWrVqlWkF05EREQoJSVF27dvV7t27SRJa9askc1msyeaiiIxMVGSFBwcbN/vCy+8oJMnT9qHB65evVp+fn5q1qzZNR4NAIC37wEAAFzFwy//XQMnPiCfSo69HcJahOq1dc+pXtM6Loqs7DJzkmWe7i0zdax0aaWU9V/pwr9lZn4jXf7V1eGhjGvatKm6d++u4cOHa8uWLfruu+80atQo9evXTyEhIZKk48ePq0mTJvaeTwcOHNDkyZO1fft2HTp0SF988YUGDhyo2267Ta1atZIkdevWTc2aNdPf//53/fDDD1q5cqWeeeYZjRw5kt5QAHAd6CkFAABwFR4eHvr7+D76a8w92vHNLl1Mv6S6TWvrhpsayDAMV4dX5pimKfPcCCnn0P9KbP/7M3c2efPyrzIvfiHD9y+uCA9u4v3339eoUaN05513ysPDQ/fff79mzJhhX5+dna19+/bpwoULkiRvb2998803mj59ujIyMhQaGqr7779fzzzzjH0bT09PrVixQiNGjFBERIQqVaqkQYMG6bnnnnP68QGAOyApBQAAUES+lX3VObqjq8Mo+7K3SZd3F1rFTJ8j+fQi6YfrVr16dS1ZsqTA9fXr15dp/vYSg9DQUK1bt+6q+61Xr56+/vrrYokRAMo7txq+d/bsWQ0YMEB+fn6qWrWqhg4dqvT09EK36dKliwzDcFgeeeQRJ0UMAABQ/piZa3XVZ6M5+yXbycLrAACAMs2tekoNGDBASUlJWr16tbKzszVkyBA9/PDDhT4hkaThw4c7dLmtWLFiSYcKAABQfpnZBa5a+EZQkeoBAICyz22SUnv27FFcXJy2bt2q9u3bS5LefPNN3X333XrllVfsExrmp2LFitf0algAAABcP6NCK5m6fJVK1STPQOcEBAAAXMJthu8lJCSoatWq9oSUJEVGRsrDw0ObN28udNv3339fNWvWVIsWLRQbG2uf7BAAAAAlwKdbbtKpwF9FPaSKf5NhVHBmVAAAwMncpqeU1WpVQECAQ5mXl5eqV68uq9Va4HZ/+9vfVK9ePYWEhGjnzp166qmntG/fPn366acFbpOZmanMzEz757S0tD9/AAAAAOWEYXhL1WbKPPuQpMu68tY96X+TmlfoIKMyc3wCAODuSn1Saty4cZo2bVqhdfbs2XPd+3/44Yftf2/ZsqWCg4N155136sCBA2rYsGG+20ydOlWTJk267u8EAAAo7wzvDlLNz2VmLJIurZDMi5JnfRkVB0gVH8hNXAEAALdW6ofvPfbYY9qzZ0+hS4MGDRQUFKSTJx3f0HL58mWdPXv2muaLCg8PlyTt37+/wDqxsbFKTU21L0ePHr2+gwOAazB48GD7W0IrVKigwMBA3XXXXVqwYIFsNpurwwOAa2Z4NZCH/3PyCNwhj6A98qj1HxmVHiQhVcKsVqtGjx6tBg0ayGKxKDQ0VL169VJ8fLyrQwMAuIAr7zNKfU+pWrVqqVatWletFxERoZSUFG3fvl3t2rWTJK1Zs0Y2m82eaCqKxMRESVJwcHCBdSwWiywWS5H3CQDFpXv37lq4cKFycnKUnJysuLg4jRkzRh9//LG++OILeXmV+ss6AMCFDh06pM6dO6tq1ap6+eWX1bJlS2VnZ2vlypUaOXKk9u7d6+oQAQAu4Kr7DLe5e2natKm6d++u4cOHa86cOcrOztaoUaPUr18/+5v3jh8/rjvvvFPvvfeeOnbsqAMHDmjJkiW6++67VaNGDe3cuVP/+te/dNttt6lVq1YuPiIAyMtisdh7f9auXVs33XSTbr75Zt15551atGiRhg0b5uIIAQCl2aOPPirDMLRlyxZVqlTJXt68eXM99NBDLowMAOBKrrrPKPXD967F+++/ryZNmujOO+/U3XffrVtuuUVz5861r8/Ozta+ffvsb9fz9vbWN998o27duqlJkyZ67LHHdP/99+vLL7901SEAwDW744471Lp160Jf0AAAwNmzZxUXF6eRI0c6JKSuqFq1qvODAgCUWs64z3CbnlKSVL16dS1ZsqTA9fXr15dpmvbPoaGhWrdunTNCA4AS1aRJE+3cudPVYQAASrH9+/fLNE01adLE1aEAAMqIkr7PcKukFAC4E9PMkjLXSzlWybOmfntlen51TRmG4bzgAABlgpm9W8reJclLtsu+rg4HAFAKmKYpZf8gXf5JkiX3DbiF1C3J+wySUgBQCpkXv5SZNlkyUyQZkkyZF89IOWH51t+zZ4/CwvJfBwAof8zLh2Wm/Eu6vNte1qiaTYYh7dmzU/fee68LowMAuIqZ/bPM1Bjp8s+/lV1KlpkdKNO8JMPwcahf0vcZbjWnFAC4A/PSf2SmPva/hJQkXRl2nC0ze6/MCx841F+zZo127dql+++/35lhAgBKKTPnlMyz/aXLexzKq1fzULculfTWzGlKTz+fZ7uUlBQnRQgAcAXz8jGZZ/8mXT7wxzVSTpLMlLEOUx454z6DpBQAlCKmaZOZ9mKB6zOzTCUdeFHHjh3Ujh07NGXKFPXu3Vv33HOPBg4c6MRIAQCllXnhPcl2VvkN+545tZZycrIU3rGVPvnkE/3yyy/as2ePZsyYoYiICOcHCwBwGvPCPMnMUH7tQ2aWTdajq3T80Eqn3mcwfA8ASpPsRMmWVODqld9eUO1WO+XldYOqVauu1q1ba8aMGRo0aJA8PHjOAACQdPFTSbZ8VzWoV0HbVoVpysxKeuyxx5SUlKRatWqpXbt2mj17tnPjBAA4jWma0sXPVNA8tSu/vaDarQ/Ky6unqlWr4bT7DMP8fd8sXJe0tDT5+/srNTVVfn5+rg4HQBlmXvpGZsqjV61n+L0go2KfYvlOrmElg/MKwFVs1uaSsguv5H2zPKq/V2gVrmMlg/MKwBVMM0tmcour1DIkSzd5VHuz0FrFeR3jsToAlCaeIcVbDwBQ/ngEXqWCp+RZxymhAABKiwqSUfUqdTwkz2BnBPP7bwQAlBpeTSWvG1Xw5dmQPAIk75udGVWpt379evXq1UshISEyDEPLly+/6jZr167VTTfdJIvFokaNGmnRokV56syaNUv169eXj4+PwsPDtWXLluIPHgCKmVGxr3Lf3FqQHBm+f3VWOACAUsAwDKniA5I8C6nl/PaBpBQAlCKGYcjwG6/cy/MfL9G5NxiG30QZRmGNSfmTkZGh1q1ba9asWUWqf/DgQfXs2VNdu3ZVYmKixo4dq2HDhmnlypX2OsuWLVNMTIwmTJigHTt2qHXr1oqKitLJkydL6jAAoHhUHCB5NlD+Nx6G5NNLqtDW2VEBAFzMqPSQ5BmkAhNTvgNkVLjRuTExp9Sfx7hwAMXNzNoqM+0F6fJPvxV6NpTh95QMS5di/S53u4YZhqHPPvtM0dHRBdZ56qmn9NVXX2n37t32sn79+iklJUVxcXGSpPDwcHXo0EEzZ86UJNlsNoWGhmr06NEaN27cVeNwt/MKoGwxbWdz25FLX8s+qa1RSao4SEblUTKMq7/viOtYyeC8AnAlM+ekzLTnpMxvZH8phuEvo9JQqdLDMoyr910qzusYb98DgFLI8O4go+Zymdk/Szar5FFT8mqa2+0Wf1pCQoIiIyMdyqKiojR27FhJUlZWlrZv367Y2Fj7eg8PD0VGRiohIcGZoQLAdTE8qsuo+qrMnKely3sleUnerWQYvq4ODQDgQoZngIxqM2XmJEuXf5EMi1ShtQzD2yXxkJQCgFIst/usc7vQlgdWq1WBgY4TAQcGBiotLU0XL17UuXPnlJOTk2+dvXv35rvPzMxMZWZm2j+npaUVf+AAcI0MzxqSZ2dXhwEAKGUMz0DJ82ovxih5zCkFAEAxmDp1qvz9/e1LaGioq0MCAAAASjWSUgCAcicoKEjJyckOZcnJyfLz85Ovr69q1qwpT0/PfOsEBQXlu8/Y2Filpqbal6NHj5ZY/AAAAIA7ICkFACh3IiIiFB8f71C2evVqRURESJK8vb3Vrl07hzo2m03x8fH2On9ksVjk5+fnsAAAAAAoGEkpAECZl56ersTERCUmJkqSDh48qMTERB05ckRSbi+mgQMH2us/8sgj+vXXX/Xkk09q7969euutt/Thhx/qX//6l71OTEyM3nnnHb377rvas2ePRowYoYyMDA0ZMsSpxwYAAAC4KyY6BwCUedu2bVPXrl3tn2NiYiRJgwYN0qJFi5SUlGRPUElSWFiYvvrqK/3rX//SG2+8oTp16mjevHmKioqy1+nbt69OnTql8ePHy2q1qk2bNoqLi8sz+TkAAACA62OYpmm6OoiyLi0tTf7+/kpNTWW4BoAyh2tYyeC8AijruI6VDM4rgLKuOK9jDN8DAAAAAACA0zF8rxhc6WyWlpbm4kgA4NpduXbRcbZ40TYAKOtoH0oG7QOAsq442weSUsXg/PnzkqTQ0FAXRwIA1+/8+fPy9/d3dRhug7YBgLugfShetA8A3EVxtA/MKVUMbDabTpw4oSpVqsgwDFeHU6C0tDSFhobq6NGj5XL8Osdffo+/PB+7dPXjN01T58+fV0hIiDw8GNVdXMpK2/BnlPefreLG+SxenM8/j/ahZJS19oGfpd9wLnJxHnKV5/NQnO0DPaWKgYeHh+rUqePqMIrMz8+v3P3Q/B7HX36Pvzwfu1T48fMEvPiVtbbhzyjvP1vFjfNZvDiffw7tQ/Erq+0DP0u/4Vzk4jzkKq/nobjaBx55AAAAAAAAwOlISgEAAAAAAMDpSEqVIxaLRRMmTJDFYnF1KC7B8Zff4y/Pxy5x/Cg5/N8qXpzP4sX5BIoHP0u/4Vzk4jzk4jwUDyY6BwAAAAAAgNPRUwoAAAAAAABOR1IKAAAAAAAATkdSCgAAAAAAAE5HUqocmTVrlurXry8fHx+Fh4dry5Ytrg7JKaZOnaoOHTqoSpUqCggIUHR0tPbt2+fqsFzixRdflGEYGjt2rKtDcZrjx4/rwQcfVI0aNeTr66uWLVtq27Ztrg7LKXJycvTss88qLCxMvr6+atiwoSZPniymEsSfNXHiRBmG4bA0adLE1WGVaeX5WlWc6tevn+f/pmEYGjlypKtDA8qs8noPcQX3Evkrj/cVV9BmFy+SUuXEsmXLFBMTowkTJmjHjh1q3bq1oqKidPLkSVeHVuLWrVunkSNHatOmTVq9erWys7PVrVs3ZWRkuDo0p9q6davefvtttWrVytWhOM25c+fUuXNnVahQQf/5z3/0008/6dVXX1W1atVcHZpTTJs2TbNnz9bMmTO1Z88eTZs2TS+99JLefPNNV4cGN9C8eXMlJSXZlw0bNrg6pDKrvF+ritPWrVsd/l+uXr1aktSnTx8XRwaUTeX5HuIK7iXyKo/3FVfQZhc/3r5XToSHh6tDhw6aOXOmJMlmsyk0NFSjR4/WuHHjXBydc506dUoBAQFat26dbrvtNleH4xTp6em66aab9NZbb+n5559XmzZtNH36dFeHVeLGjRun7777Tv/9739dHYpL3HPPPQoMDNT8+fPtZffff798fX21ePFiF0aGsm7ixIlavny5EhMTXR2KWyjv16qSNHbsWK1YsUK//PKLDMNwdThAmcM9RF7l8V7i98rrfcUVtNnFj55S5UBWVpa2b9+uyMhIe5mHh4ciIyOVkJDgwshcIzU1VZJUvXp1F0fiPCNHjlTPnj0d/g+UB1988YXat2+vPn36KCAgQG3bttU777zj6rCcplOnToqPj9fPP/8sSfrhhx+0YcMG9ejRw8WRwR388ssvCgkJUYMGDTRgwAAdOXLE1SGVWeX9WlVSsrKytHjxYj300EMkpIDrwD1E/srjvcTvldf7iitos4sfSaly4PTp08rJyVFgYKBDeWBgoKxWq4uicg2bzaaxY8eqc+fOatGihavDcYqlS5dqx44dmjp1qqtDcbpff/1Vs2fP1g033KCVK1dqxIgR+uc//6l3333X1aE5xbhx49SvXz81adJEFSpUUNu2bTV27FgNGDDA1aGhjAsPD9eiRYsUFxen2bNn6+DBg7r11lt1/vx5V4dWJpX3a1VJWb58uVJSUjR48GBXhwKUSdxD5FUe7yV+rzzfV1xBm138vFwdAOBMI0eO1O7du8vN3CdHjx7VmDFjtHr1avn4+Lg6HKez2Wxq3769pkyZIklq27atdu/erTlz5mjQoEEujq7kffjhh3r//fe1ZMkSNW/eXImJiRo7dqxCQkLKxfGj5Py+t12rVq0UHh6uevXq6cMPP9TQoUNdGFnZVN6vVSVl/vz56tGjh0JCQlwdCgA3Ud7uJX6vvN9XXEGbXfzoKVUO1KxZU56enkpOTnYoT05OVlBQkIuicr5Ro0ZpxYoV+vbbb1WnTh1Xh+MU27dv18mTJ3XTTTfJy8tLXl5eWrdunWbMmCEvLy/l5OS4OsQSFRwcrGbNmjmUNW3atNwMM3riiSfsvaVatmypv//97/rXv/5Vrp9uoWRUrVpVN954o/bv3+/qUMqk8n6tKgmHDx/WN998o2HDhrk6FKDM4h7CUXm8l/i98n5fcQVtdvEjKVUOeHt7q127doqPj7eX2Ww2xcfHKyIiwoWROYdpmho1apQ+++wzrVmzRmFhYa4OyWnuvPNO7dq1S4mJifalffv2GjBggBITE+Xp6enqEEtU586d87yy9+eff1a9evVcFJFzXbhwQR4ejpd5T09P2Ww2F0UEd5Wenq4DBw4oODjY1aGUSeX9WlUSFi5cqICAAPXs2dPVoQBlVnm/h7iiPN9L/F55v6+4gja7+DF8r5yIiYnRoEGD1L59e3Xs2FHTp09XRkaGhgwZ4urQStzIkSO1ZMkSff7556pSpYp9DLy/v798fX1dHF3JqlKlSp7x7pUqVVKNGjXKxTj4f/3rX+rUqZOmTJmiBx54QFu2bNHcuXM1d+5cV4fmFL169dILL7ygunXrqnnz5vr+++/12muv6aGHHnJ1aCjjHn/8cfXq1Uv16tXTiRMnNGHCBHl6eqp///6uDq1MKu/XquJms9m0cOFCDRo0SF5e/KoL/Bnl+R7iivJ8L/F75f2+4gra7BJgotx48803zbp165re3t5mx44dzU2bNrk6JKeQlO+ycOFCV4fmErfffrs5ZswYV4fhNF9++aXZokUL02KxmE2aNDHnzp3r6pCcJi0tzRwzZoxZt25d08fHx2zQoIH5f//3f2ZmZqarQ0MZ17dvXzM4ONj09vY2a9eubfbt29fcv3+/q8Mq08rztaq4rVy50pRk7tu3z9WhAG6hvN5DXMG9RMHK233FFbTZxcswTdN0STYMAAAAAAAA5RZzSgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgGlUE5Ojjp16qT77rvPoTw1NVWhoaH6v//7PxdFBgBwJdoHAEB+aB9QVhmmaZquDgJAXj///LPatGmjd955RwMGDJAkDRw4UD/88IO2bt0qb29vF0cIAHAF2gcAQH5oH1AWkZQCSrEZM2Zo4sSJ+vHHH7Vlyxb16dNHW7duVevWrV0dGgDAhWgfAAD5oX1AWUNSCijFTNPUHXfcIU9PT+3atUujR4/WM8884+qwAAAuRvsAAMgP7QPKGpJSQCm3d+9eNW3aVC1bttSOHTvk5eXl6pAAAKUA7QMAID+0DyhLmOgcKOUWLFigihUr6uDBgzp27JirwwEAlBK0DwCA/NA+oCyhpxRQim3cuFG33367Vq1apeeff16S9M0338gwDBdHBgBwJdoHAEB+aB9Q1tBTCiilLly4oMGDB2vEiBHq2rWr5s+fry1btmjOnDmuDg0A4EK0DwCA/NA+oCyipxRQSo0ZM0Zff/21fvjhB1WsWFGS9Pbbb+vxxx/Xrl27VL9+fdcGCABwCdoHAEB+aB9QFpGUAkqhdevW6c4779TatWt1yy23OKyLiorS5cuX6YYLAOUQ7QMAID+0DyirSEoBAAAAAADA6ZhTCgAAAAAAAE5HUgoAAAAAAABOR1IKAAAAAAAATkdSCgAAAAAAAE5HUgoAAAAAAABOR1IKAAAAAAAATkdSCgAAAAAAAE5HUgoAAAAAAABOR1IKAAAAAAAATkdSCgAAAAAAAE5HUgoAAAAAAABOR1IKAADg/9m77/CoyrSP479JQiaUFAIpBEJHilRpBgSCRgIia7ABohBAXDUgLJYVC2UtsaBiQRCk6GpEQQFFFkQQeIVQJSqgSJWaICUJCRAged4/WGYZUkggM5NJvp/rOpfOc55zzv2cYc49uecUAAAAOB1FKQAAAAAAADgdRSkAAAAAAAA4HUUpAAAAAAAAOB1FKQAAAAAAADgdRSkAAAAAAAA4HUUpFKvatWsrNjbW1WFclVmzZslisWjv3r2uDqXYxMbGqnbt2q4Oo0giIyMVGRnp6jAAFDPyQ8lCfgBQUpAfShbyA5yNohQKZdeuXfr73/+uunXrysfHR35+furYsaPefvttnT592ikxnDp1SuPGjdOKFSucsr2SaM2aNRo3bpxSU1OvavmSsg+3bdumcePGlagEfujQId1///1q2LChfH19FRAQoHbt2umjjz6SMcbV4QElFvmhZCA/OM+nn34qi8WiSpUquToUoEQjP5QM5AfH2bt3rywWS57T7NmzXR2e2/BydQAo+b799lvdc889slqtGjBggJo2baqzZ8/qxx9/1JNPPqmtW7dq6tSpDo/j1KlTGj9+vCQ5pBL+wAMPqG/fvrJarcW+7uKyZs0ajR8/XrGxsQoICLhi/2nTpiknJ8f22tH7sLC2bdum8ePHKzIyMtcvMd99951LYjp69KgOHDigu+++WzVr1tS5c+e0dOlSxcbGavv27Xr55ZddEhdQkpEfSg7yg3NkZGToqaeeUsWKFV0dClCikR9KDvKD4/Xr10+33XabXVtERISLonE/FKVQoD179qhv376qVauWli9frmrVqtnmxcXFaefOnfr2229dGOG1y8zMVMWKFeXp6SlPT09Xh1OsypUr55TtXNyHxcHb27tY1lNUzZs3z/UL0LBhw9SrVy+98847euGFF0rdvw/gWpAf3Bv54eq8+OKL8vX1VdeuXTV//nxXhwOUSOQH90Z+KLobbrhB999/v0tjcGsGKMDDDz9sJJnVq1cXqn+tWrXMwIEDba/Hjh1r8vpnNnPmTCPJ7Nmzx9a2YcMG061bN1OlShXj4+NjateubQYNGmSMMWbPnj1GUq5p7NixtuV/++03c9ddd5nKlSsbq9VqWrdubRYsWJDndlesWGEeeeQRExQUZAICAvKNqVatWqZnz57m//7v/0zbtm2N1Wo1derUMR999FGuMf3888+mc+fOxsfHx1SvXt288MILZsaMGbnWmZeff/7ZDBw40NSpU8dYrVYTEhJiBg0aZI4ePZprX14+FbTugQMHmlq1ajltH+7du9c88sgj5rrrrjM+Pj4mMDDQ3H333XYxXlz+8umHH34wxhjTpUsX06VLF7ttpqSkmMGDB5vg4GBjtVpN8+bNzaxZs+z6XBzf66+/bj744ANTt25d4+3tbdq0aWPWr19f4P4vyLBhw4zFYjGnTp266nUApRH5gfxQ1vLDH3/8Yby9vc23335rBg4caCpWrFjoZYGyhPxAfigr+eHS5TMyMkxWVtYVl0FunCmFAn3zzTeqW7euOnTo4NDtHDlyRN26dVNQUJCefvppBQQEaO/evfrqq68kSUFBQZo8ebIeeeQR9e7dW3feeaekC2e3SNLWrVvVsWNHVa9eXU8//bQqVqyoL774QjExMfryyy/Vu3dvu+09+uijCgoK0pgxY5SZmVlgbDt37tTdd9+tIUOGaODAgZoxY4ZiY2PVunVrXX/99ZKkgwcPqmvXrrJYLBo9erQqVqyoDz/8sNCn8i5dulS7d+/WoEGDFBoaajuleevWrVq7dq0sFovuvPNO/fHHH/rss8/01ltvqWrVqrZ9UxjO2IcbNmzQmjVr1LdvX9WoUUN79+7V5MmTFRkZqW3btqlChQrq3LmzHnvsMb3zzjt65pln1LhxY0my/fdyp0+fVmRkpHbu3Klhw4apTp06mjNnjmJjY5WamqoRI0bY9U9ISNDJkyf197//XRaLRa+99pruvPNO7d69u1C//Jw+fVqZmZnKyMjQypUrNXPmTEVERKh8+fKF2s9AWUF+ID+UtfwwcuRIde3aVbfddpu++OKLQu1boCwiP5Afylp+GD9+vJ588klZLBa1bt1aL730krp161aofQxxphTyl5aWZiSZO+64o9DLXO0vHfPmzTOSzIYNG/Jd919//ZWrMn/RLbfcYpo1a2bOnDlja8vJyTEdOnQwDRo0yLXdm266yZw/f77AmC6OR5JZtWqVre3IkSPGarWaxx9/3NY2fPhwY7FYzObNm21tx44dM4GBgYX6pSOvs3A+++yzXNt+/fXXC7W+iy79pcMYx+/DvMaRmJhoJJmPP/7Y1jZnzhy7XzcudfkvHRMnTjSSzCeffGJrO3v2rImIiDCVKlUy6enpxpj//VJRpUoVc/z4cVvfBQsWGEnmm2++yb2D8hAfH2/3C8wtt9xi9u3bV6hlgbKC/EB+KGv5YeHChcbLy8ts3brVGGM4UwrIB/mB/FCW8sOff/5punXrZiZPnmy+/vprM3HiRFOzZk3j4eFhFi5cWOCy+B+evod8paenS5J8fX0dvq2LN91buHChzp07V6Rljx8/ruXLl+vee+/VyZMndfToUR09elTHjh1TdHS0duzYoYMHD9otM3To0EJf/92kSRN16tTJ9jooKEgNGzbU7t27bW2LFy9WRESEWrZsaWsLDAxU//79C7WNS8/COXPmjI4ePaobb7xRkvTTTz8Vah3Xorj24aXjOHfunI4dO6b69esrICDgqsexaNEihYaGql+/fra2cuXK6bHHHrOdzXSpPn36qHLlyrbXF9+7S9+vgvTr109Lly5VQkKC7rvvPkly2hNiAHdBfriA/FA28sPZs2f1j3/8Qw8//LCaNGlyVbECZQX54QLyQ9nIDzVr1tSSJUv08MMPq1evXhoxYoQ2b96soKAgPf7441cVe1lEUQr58vPzkySdPHnS4dvq0qWL7rrrLo0fP15Vq1bVHXfcoZkzZyorK+uKy+7cuVPGGD3//PMKCgqym8aOHSvpwum9l6pTp06hY6tZs2autsqVK+vEiRO213/++afq16+fq19ebXk5fvy4RowYoZCQEJUvX15BQUG2GNPS0god69Uqrn14+vRpjRkzRuHh4bJarapataqCgoKUmpp61eP4888/1aBBA3l42B+uLp6u++eff9q1X/5+XUwwl75fBalVq5aioqLUr18/ffrpp6pbt66ioqIoTAGXID9cQH4oG/nhrbfe0tGjR21PnwKQP/LDBeSHspEf8hIYGKhBgwZp+/btOnDgQJGXL4u4pxTy5efnp7CwMG3ZsuWq12GxWPJsz87OztVv7ty5Wrt2rb755hstWbJEgwcP1htvvKG1a9eqUqVK+W7j4iNLn3jiCUVHR+fZ5/KDe1HuD5TfLyLGmEKv40ruvfderVmzRk8++aRatmypSpUqKScnR927d7d7JKujFNc+HD58uGbOnKmRI0cqIiJC/v7+slgs6tu3r1PGIRX/+3X33Xdr2rRpWrVqVb77BihryA8XkB8uKM35IS0tTS+++KIeffRRpaen284CycjIkDFGe/fuVYUKFRQcHOyQmAF3Q364gPxwQWnODwUJDw+XdKFwWKNGjauOq6ygKIUC3X777Zo6daoSExMVERFR5OUvVplTU1Ntp9hKuavTF91444268cYb9dJLLykhIUH9+/fX7Nmz9eCDD+aboOrWrSvpwimZUVFRRY6xONSqVUs7d+7M1Z5X2+VOnDihZcuWafz48RozZoytfceOHbn65rcPCsvR+3Du3LkaOHCg3njjDVvbmTNnlJqaWqg48lKrVi398ssvysnJsfu14/fff7fNd6SLZ0g54xcnwJ2QHwqH/HCBu+aHEydOKCMjQ6+99ppee+21XPPr1KmjO+64Q/Pnz7/mbQGlBfmhcMgPF7hrfijIxcv+CntD+bKOy/dQoKeeekoVK1bUgw8+qJSUlFzzd+3apbfffjvf5evVqydJWrVqla0tMzNTH330kV2/EydO5KpEX7y++uIpuBUqVJCkXAeo4OBgRUZG6oMPPtDhw4dzxfDXX3/lG19xiY6OVmJiopKSkmxtx48f16effnrFZS9W5i8f/8SJE3P1rVixoqTc+6CwHL0PPT09c43j3XffzfXLVlHGcdtttyk5OVmff/65re38+fN69913ValSJXXp0qVQsV1JfmOcPn26LBaLbrjhhmLZDlBakB8Kh/xwgbvmh+DgYM2bNy/X1LVrV/n4+GjevHkaPXr0NW8HKE3ID4VDfrjAXfODlPcYDx48qBkzZqh58+aqVq1asWyntONMKRSoXr16SkhIUJ8+fdS4cWMNGDBATZs21dmzZ7VmzRrbozXz061bN9WsWVNDhgzRk08+KU9PT82YMUNBQUHat2+frd9HH32k999/X71791a9evV08uRJTZs2TX5+frrtttskXTjds0mTJvr888913XXXKTAwUE2bNlXTpk01adIk3XTTTWrWrJmGDh2qunXrKiUlRYmJiTpw4IB+/vlnh+6np556Sp988oluvfVWDR8+3PZI15o1a+r48eMFVvb9/PzUuXNnvfbaazp37pyqV6+u7777Tnv27MnVt3Xr1pKkZ599Vn379lW5cuXUq1cv20H6Shy9D2+//Xb9+9//lr+/v5o0aaLExER9//33qlKlil2/li1bytPTU6+++qrS0tJktVp1880353n5w0MPPaQPPvhAsbGx2rRpk2rXrq25c+dq9erVmjhxYrHdSPOll17S6tWr1b17d9v79uWXX2rDhg0aPnx4oa/vB8oK8kPhkB8ucNf8UKFCBcXExORqnz9/vtavX5/nPKCsIz8UDvnhAnfND9KF93DXrl265ZZbFBYWpr179+qDDz5QZmZmgYVXXMaZj/qD+/rjjz/M0KFDTe3atY23t7fx9fU1HTt2NO+++67dI0Avf6SrMcZs2rTJtG/f3nh7e5uaNWuaN998M9fjU3/66SfTr18/U7NmTWO1Wk1wcLC5/fbbzcaNG+3WtWbNGtO6dWvj7e2d69Gku3btMgMGDDChoaGmXLlypnr16ub22283c+fOtfW5uN28Hh2b3yNde/bsmavv5Y8dNcaYzZs3m06dOhmr1Wpq1Khh4uPjzTvvvGMkmeTk5AL374EDB0zv3r1NQECA8ff3N/fcc485dOhQno9ffeGFF0z16tWNh4fHFR/vevkjXY1x7D48ceKEGTRokKlataqpVKmSiY6ONr///nue/y6mTZtm6tatazw9Pe0e75rXvk1JSbGt19vb2zRr1szMnDnTrs/FR7q+/vrrueLKaz9e7rvvvjO33367CQsLM+XKlbP9G585c6bJyckpcFmgLCM/2CM/lL78kJeBAweaihUrFnk5oCwhP9gjP5S+/JCQkGA6d+5sgoKCjJeXl6latarp3bu32bRpU4HLwZ7FmGK82xoA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tmypjz/+WLfccou2bNmiBg0aODzu4nK17/0//vEPdejQQXfccYejQ3Soqx3/pY4ePaoXXnhBDz30kCNCLDZHjx5VdnZ2nt+7fv/99zyXKZbvaUU/oQslwb59+0xwcLD5+eefbW1XuhSuQYMGJjw83Jw/f97W9sYbb5jQ0FBHhmpzNTH/8MMPJiQkxEybNs388ssv5quvvjLh4eHmX//6lxMitnfixAnj5+dnPvzwwzznlytXziQkJNi1TZo0yQQHBzsjvDxdKeZLxcfHm8qVK9u9P85WULzp6emmdu3aZtGiRbY2V18ecqX96+rP3OWuFG9J+rzhgnLlypmIiAi7tuHDh5sbb7wx32W2bt1qqlWrZl577TXz888/m8WLF5tmzZqZwYMHOzrcIuvWrZu5/fbbC+xTEo+tBSnMmC5VEo69V3KlMZXE4/OVFOZ9KmnH8CspzJg4zuNy//znP42kAqfffvvNvPTSS+a6667LtXxQUJB5//33813/sGHDTLt27cz3339vkpKSzLhx44y/v7/55ZdfHDmsQnHk2FevXm0kmdGjR9u1N2vWzDz99NMOGU9ROXL8CxYsMPXr1zcnT560tamEXb7n6H/7F6WlpZl27dqZ7t27l/jLwQ8ePGgkmTVr1ti1P/nkk6Zdu3Z5LlMc39M4U8pNbdq0SUeOHNENN9xga8vOztaqVav03nvvKSsrS56ennbLVKtWTeXKlbNrb9y4sZKTk3X27Fl5e3uXuJiff/55PfDAA3rwwQclSc2aNVNmZqYeeughPfvss069UWBAQICuu+467dy5M8/5oaGhSklJsWtLSUlx6emqV4r5ogkTJuiVV17R999/f8WbzztSQfHu2rVLe/fuVa9evWxtOTk5ki78WrF9+3bVq1fPabFKV96/rv7MXe5K8ZakzxsuqFatmpo0aWLX1rhx4wKfXBQfH6+OHTvqySeflCQ1b95cFStWVKdOnfTiiy+qWrVqDo25sP788099//33V7z5ekk8tuansGO6qKQcewtSmDGVxONzQQr7PpW0Y3hBCjsmjvO43OOPP37FMzvr1q2r0NBQHTlyxK79/PnzOn78eL7H4127dum9997Tli1bdP3110uSWrRoof/7v//TpEmTNGXKlGIZw9Vy5Ngv5tq8cnhRbq3hSI4c//Lly7Vr165cD4a466671KlTJ61YseIa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/LKzQgZchvzg3sgPRVPY/PC3v/1Nqamp8vX11YQJE5SUlOS8IN2Rq6tiKNkefvhhI8msXr26UP0v//Vj7NixJq9/ZjNnzsxVMd6wYYPp1q2bqVKlivHx8TG1a9c2gwYNMsYYs2fPHiMp13Rpdfq3334zd911l6lcubKxWq2mdevWZsGCBXlud8WKFeaRRx4xQUFBJiAgIN+YatWqZXr27Gn+7//+z7Rt29ZYrVZTp04d89FHH+Ua088//2w6d+5sfHx8TPXq1c0LL7xgZsyYUajK+M8//2wGDhxo6tSpY6xWqwkJCTGDBg2y+6X14r68fCpo3QMHDjS1atVy2j7cu3eveeSRR8x1111nfHx8TGBgoLn77rvtYry4/OXTxV9CunTpYrp06WK3zZSUFDN48GATHBxsrFarad68uZk1a5Zdn4vje/31180HH3xg6tata7y9vU2bNm3M+vXrC9z/xhjzn//8x0gyixYtMsYYk5mZac6fP3/F5YCygFxALigrueBSVzpjoG3btqZt27a52rt162bq1atXpG0B7or8QH4gPxSsqGevlUWcKYUCffPNN6pbt646dOjg0O0cOXJE3bp1U1BQkJ5++mkFBARo7969+uqrryRJQUFBmjx5sh555BH17t1bd955pySpefPmkqStW7eqY8eOql69up5++mlVrFhRX3zxhWJiYvTll1+qd+/edtt79NFHFRQUpDFjxigzM7PA2Hbu3Km7775bQ4YM0cCBAzVjxgzFxsaqdevWuv766yVduKdE165dZbFYNHr0aFWsWFEffvihrFZroca/dOlS7d69W4MGDVJoaKi2bt2qqVOnauvWrVq7dq0sFovuvPNO/fHHH/rss8/01ltvqWrVqrZ9UxjO2IcbNmzQmjVr1LdvX9WoUUN79+7V5MmTFRkZqW3btqlChQrq3LmzHnvsMb3zzjt65pln1LhxY0my/fdyp0+fVmRkpHbu3Klhw4apTp06mjNnjmJjY5WamqoRI0bY9U9ISNDJkyf197//XRaLRa+99pruvPNO7d69u8Bfg77//ntJktVqVZs2bbRp0yZ5e3urd+/eev/99xUYGFio/QyURuQCckFZyQWFlZOTo19++UWDBw/ONa9du3b67rvvdPLkSfn6+l7ztoCSjPxAfiA/4Jq5uiqGkistLc1IMnfccUehl7naXz/mzZtnJJkNGzbku+6CKtK33HKLadasmd010Tk5OaZDhw6mQYMGubZ700035ToLJr9fPySZVatW2dqOHDlirFarefzxx21tw4cPNxaLxWzevNnWduzYMRMYGFioyvipU6dytX322We5tl3USvulv34Y4/h9mNc4EhMTjSTz8ccf29oKuk788l8/Jk6caCSZTz75xNZ29uxZExERYSpVqmTS09ONMf/79aNKlSrm+PHjtr4LFiwwksw333yTewdd4m9/+5tt+f79+5u5c+ea559/3nh5eZkOHTqU6PsHAI5ELiAXlKVccKmC9tPFef/6179yzZs0aZKRZH7//fdCbwtwR+QH8gP5YewV+3Km1JXx9D3kKz09XZKc8itfQECAJGnhwoU6d+5ckZY9fvy4li9frnvvvVcnT57U0aNHdfToUR07dkzR0dHasWOHDh48aLfM0KFDC31NeJMmTdSpUyfb66CgIDVs2NDu6TqLFy9WRESEWrZsaWsLDAxU//79C7WNS+9fdObMGR09elQ33nijJOmnn34q1DquRXHtw0vHce7cOR07dkz169dXQEDAVY9j0aJFCg0NVb9+/Wxt5cqV02OPPaaMjAytXLnSrn+fPn1UuXJl2+uL792VnoaUkZEhSWrbtq0++eQT3XXXXfrXv/6lF154QWvWrNGyZcuuKn7A3ZELLiAXlI1cUFgXnyaW11kOPj4+dn2A0or8cAH5gfyAa0NRCvny8/OTJJ08edLh2+rSpYvuuusujR8/XlWrVtUdd9yhmTNnKisr64rL7ty5U8YYPf/88woKCrKbxo4dK+nCKb+XqlOnTqFjq1mzZq62ypUr68SJE7bXf/75p+rXr5+rX15teTl+/LhGjBihkJAQlS9fXkFBQbYY09LSCh3r1SqufXj69GmNGTNG4eHhslqtqlq1qoKCgpSamnrV4/jzzz/VoEEDeXjYH64unsL7559/2rVf/n5dTDqXvl95uZgkL01oknTfffdJuvCIXaAsIhdcQC4oG7mgsC7mjLz+bZ45c8auD1BakR8uID+QH3BtuKcU8uXn56ewsDBt2bLlqtdhsVjybM/Ozs7Vb+7cuVq7dq2++eYbLVmyRIMHD9Ybb7yhtWvXqlKlSvluIycnR5L0xBNPKDo6Os8+lx/wi/JFMb9fSYwxhV7Hldx7771as2aNnnzySbVs2VKVKlVSTk6OunfvbhufIxXXPhw+fLhmzpypkSNHKiIiQv7+/rJYLOrbt69TxiFd/fsVFhYmSQoJCbFrDw4OlkSiQtlFLriAXHBBac8FhRUYGCir1arDhw/nmnex7WJeAUor8sMF5IcLyA+4WhSlUKDbb79dU6dOVWJioiIiIoq8/MXKc2pqqu20Wyl3xfqiG2+8UTfeeKNeeuklJSQkqH///po9e7YefPDBfJNW3bp1JV04TTMqKqrIMRaHWrVqaefOnbna82q73IkTJ7Rs2TKNHz9eY8aMsbXv2LEjV9/89kFhOXofzp07VwMHDtQbb7xhaztz5oxSU1MLFUdeatWqpV9++UU5OTl2v4D8/vvvtvnFoXXr1po2bVquU48PHTokqfA3iQRKI3JB4ZALLnDnXFBYHh4eatasmTZu3Jhr3rp161S3bl1uco4ygfxQOOSHC8pCfkDRcfkeCvTUU0+pYsWKevDBB5WSkpJr/q5du/T222/nu3y9evUkSatWrbK1ZWZm6qOPPrLrd+LEiVzV6YvXXF88LbdChQqSlOugFRwcrMjISH3wwQd5/mL5119/5RtfcYmOjlZiYqKSkpJsbcePH9enn356xWUvVusvH//EiRNz9a1YsaKk3PugsBy9Dz09PXON49133831a1dRxnHbbbcpOTlZn3/+ua3t/Pnzevfdd1WpUiV16dKlULFdyR133CGr1aqZM2fa/VLz4YcfSpJuvfXWYtkO4I7IBYVDLrjAnXNBUdx9993asGGDXWFq+/btWr58ue655x6nxwO4AvmhcMgPF5SV/ICi4UwpFKhevXpKSEhQnz591LhxYw0YMEBNmzbV2bNntWbNGtvjNvPTrVs31axZU0OGDNGTTz4pT09PzZgxQ0FBQdq3b5+t30cffaT3339fvXv3Vr169XTy5ElNmzZNfn5+uu222yRdOAW0SZMm+vzzz3XdddcpMDBQTZs2VdOmTTVp0iTddNNNatasmYYOHaq6desqJSVFiYmJOnDggH7++WeH7qennnpKn3zyiW699VYNHz7c9pjXmjVr6vjx4wVW+/38/NS5c2e99tprOnfunKpXr67vvvtOe/bsydW3devWkqRnn31Wffv2Vbly5dSrVy/bgftKHL0Pb7/9dv373/+Wv7+/mjRposTERH3//feqUqWKXb+WLVvK09NTr776qtLS0mS1WnXzzTfbLpW71EMPPaQPPvhAsbGx2rRpk2rXrq25c+dq9erVmjhxYrH9Eh0aGqpnn31WY8aMUffu3RUTE6Off/5Z06ZNU79+/dS2bdti2Q7gjsgFhUMuuMCdc4Ek/fvf/9aff/6pU6dOSbrwx/KLL74oSXrggQdsv7o/+uijmjZtmnr27KknnnhC5cqV05tvvqmQkBA9/vjjxRYPUJKRHwqH/HBBWckPaWlpevfddyVJq1evliS99957CggIUEBAgIYNG1ZsMZUKTn3WH9zWH3/8YYYOHWpq165tvL29ja+vr+nYsaN599137R4LevljXo0xZtOmTaZ9+/bG29vb1KxZ07z55pu5Hqn6008/mX79+pmaNWsaq9VqgoODze233242btxot641a9aY1q1bG29v71yP4dy1a5cZMGCACQ0NNeXKlTPVq1c3t99+u5k7d66tz8Xt5vU42fwe89qzZ89cfS9/FKkxxmzevNl06tTJWK1WU6NGDRMfH2/eeecdI8kkJycXuH8PHDhgevfubQICAoy/v7+55557zKFDh/J81OgLL7xgqlevbjw8PK74eNHLH/NqjGP34YkTJ8ygQYNM1apVTaVKlUx0dLT5/fff8/x3MW3aNFO3bl3j6elp98jXvPZtSkqKbb3e3t6mWbNmZubMmXZ9Lj7m9fXXX88VV177MS85OTnm3XffNdddd50pV66cCQ8PN88995w5e/bsFZcFygJygT1yQenMBV26dDGS8pwufzz5/v37zd133238/PxMpUqVzO2332527NhxxW0ApQ35wR75oWznh4vbymu6fH/DGIsx3NELcJSRI0fqgw8+UEZGRqEfKwsAKF3IBQCAvJAfAO4pBRSb06dP270+duyY/v3vf+umm24iyQBAGUEuAADkhfwA5I17SgHFJCIiQpGRkWrcuLFSUlI0ffp0paen6/nnn3d1aAAAJyEXAADyQn4A8kZRCigmt912m+bOnaupU6fKYrHohhtu0PTp09W5c2dXhwYAcBJyAQAgL+QHIG/cUwoAAAAAAABOxz2lAAAAAAAA4HQUpQAAAAAAAOB03FOqGOTk5OjQoUPy9fWVxWJxdTgAUCTGGJ08eVJhYWHy8OC3iuJCbgDg7sgPjkF+AODuijM/UJQqBocOHVJ4eLirwwCAa7J//37VqFHD1WGUGuQGAKUF+aF4kR8AlBbFkR8o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L72kO++8U71791ZAgOsQe/bsadIEAQCtD8cbAGgZ2J8DAOrTqKKUJH311Vd666231LFjR91xxx01DioAADSFpjzebN++XfPnz1dBQYGKioq0YcMGjRo1qt4+DodDc+fO1WuvvSabzabOnTsrIyND99577yXnAQCtEX8/AADq0qgjwrJlyzRjxgwlJCRo//79CgsLc1deAIBWrKmPN+Xl5YqOjta9996rO++8s0F9fvWrX6m4uFjLly9Xjx49VFRUpOrq6svKAwBaG/5+AADUp8FFqaSkJOXn5+ull15ScnKyO3Oq15IlSzR//nzZbDZFR0dr8eLFGjRoUK2xy5Yt06uvvqp9+/ZJkmJjY/XMM8+4xE+YMEGrV6926ZeYmKjs7Gz3TQIAUCd3HG+GDx+u4cOHNzg+OztbH3zwgb788kuFhoZKkrp27dokuQBAa9Fc/n4AADRfDS5KVVVV6dNPP9VPfvITd+ZTr9dff11paWnKyspSXFycXnzxRSUmJurQoUMKDw+vEb9t2zbdfffduvHGGxUUFKTnnntOw4YN0/79+3XVVVc545KSkrRy5Urna7PZ7JH5AABqag7Hm02bNmngwIF6/vnn9f/+3//TFVdcof/6r//SvHnz1LZt21r7OBwOORwO52u73e6pdAGgWWoO+3MAQPPW4KJUTk6OO/NokIULFyolJUUTJ06UJGVlZelvf/ubVqxYoVmzZtWIX7NmjcvrP/3pT/rLX/6i3Nxcl29rzGazrFare5MHADRIczjefPnll/rwww8VFBSkDRs26PTp03rggQd05swZly8xfigzM1NPPvmkhzMFgOarOezPAQDNm5+3E2ioCxcuqKCgQAkJCc42Pz8/JSQkKC8vr0FjnD9/XhUVFc5LMb63bds2hYeHq2fPnrr//vt15syZesdxOByy2+0uCwCg5aiurpbJZNKaNWs0aNAgjRgxQgsXLtTq1av173//u9Y+6enpKi0tdS7Hjx/3cNYAAACAb/GZotTp06dVVVWliIgIl/aIiAjZbLYGjTFz5kxFRka6FLaSkpL06quvKjc3V88995w++OADDR8+XFVVVXWOk5mZqeDgYOcSFRV1aZMCADRLnTt31lVXXaXg4GBnW+/evWUYhr7++uta+5jNZlksFpcFAAAAQN1azfNYn332Wa1bt07btm1TUFCQs33s2LHOf/fr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",
+      "text/plain": [
+       "<Figure size 1200x1200 with 9 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "Dendrogram.plot_hierarchial_split(hierarchial_clustering_sequence, coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The hierarchical clustering can be converted to flat clustering by drawing a line perpendicular to the branches. Any data point that intersects the line is considered to be in the same cluster. The function below performs this task at threshold height of 1.5. If you want to use the number of clusters instead of height, you can use `dendo.get_clusters_using_k()` method. You pass the number of desired clusters as an argument. The figure below shows the clusters that are formed at threshold height of 1.5."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAy0AAANICAYAAADKKQDvAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA+1UlEQVR4nO3deZhcZYH3729n6c5CFgKJGAghgIDsDrsRA4hg2AQFFFE2QQaQETH4En1ZAjpRdHhBBEQGiCNk2JQZwAFEERyBsA6joALhl2hETFg7G1lIzu+PtjvpdCekk3TqSXLf13UuuqqeOvV0pbroT5+l6qqqqgIAAFCoLrWeAAAAwLKIFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRZgnbDZZpvlhBNOqPU01mj33ntvdt555/To0SN1dXV56623aj2ldVZdXV0uvPDCWk8DYLURLcAqMW7cuNTV1bUsPXr0yODBg3PggQfme9/7XmbMmFHrKbISXn/99Rx99NHp2bNnrrzyyvz4xz9O7969l3mfl156Kaeeemo233zz9OjRI3379s3w4cNz+eWX5+23315NM+8cs2fPzoUXXpgHH3yw1lNZbS699NLU1dXlF7/4xVLHXHvttamrq8udd97Zcl1VVfnxj3+cD3/4w+nfv3969eqVHXbYId/4xjcye/bsNuvYZ599Wr2XLL5ss802nfK9AeXrVusJAGuXiy66KMOGDcv8+fPzt7/9LQ8++GDOOuusXHrppbnzzjuz44471nqKrIAnnngiM2bMyMUXX5z999//Xcf/7Gc/y1FHHZWGhoYcd9xx2X777TNv3rz85je/yTnnnJPnnnsuP/zhD1fDzDvH7NmzM2bMmCRNv2Svbm+//Xa6dVu9/wv/9Kc/nXPOOSfjx49f6mtg/Pjx2WCDDTJy5MgkyYIFC/KZz3wmt956a/bee+9ceOGF6dWrV/77v/87F1xwQW699db84he/yKBBg1qtZ5NNNsnYsWPbrL9fv36r/hsD1giiBVilRo4cmV133bXl8ujRo/PAAw/kkEMOyWGHHZY//OEP6dmzZw1nuHSzZs16160Hq8qcOXNSX1+fLl3WjA3e06ZNS5L079//XcdOmjQpn/70pzN06NA88MADee9739ty2xlnnJGJEyfmZz/72UrPqaqqzJkzp9jXU2fq0aPHan/MwYMHZ999981Pf/rTXH311WloaGh1+8svv5xf//rX+cIXvpDu3bsnSS655JLceuutGTVqVL7zne+0jP3CF76Qo48+OocffnhOPPHENq+Hfv365bOf/Wznf1PAGmPN+L8lsEbbb7/9ct555+VPf/pTbrzxxla3/fGPf8yRRx6ZAQMGpEePHtl1111b7VqSLNr17OGHH87ZZ5+dgQMHpnfv3jniiCPy6quvthpbVVW+8Y1vZJNNNkmvXr2y77775rnnnmszp+Z1PvTQQzn99NMzaNCgbLLJJi23X3XVVdluu+3S0NCQwYMH54wzzmj3GI4rr7wym2++eXr27Jndd989//3f/5199tmn1V/fH3zwwdTV1eXmm2/O//2//zcbb7xxevXqlenTp+eNN97IqFGjssMOO2S99dZL3759M3LkyPzv//5vq8dpXsett96aMWPGZOONN06fPn1y5JFHprGxMXPnzs1ZZ52VQYMGZb311suJJ56YuXPnLte/z2233ZZddtklPXv2zIYbbpjPfvazefnll1tu32effXL88ccnSXbbbbfU1dUt8/igSy65JDNnzsx1113XKliabbnllvnSl77Ucvmdd97JxRdfnC222CINDQ3ZbLPN8rWvfa3N/DfbbLMccsghue+++7LrrrumZ8+eueaaa5Ikb731Vs4666wMGTIkDQ0N2XLLLfPtb387CxcubLWOm2++Obvsskv69OmTvn37Zocddsjll1/easy7rWvy5MkZOHBgkmTMmDEtuy4t6xiTCy+8MHV1dW2ub34dTp48ueW6J598MgceeGA23HDD9OzZM8OGDctJJ53U6n5LPl7z+idOnJgTTjgh/fv3T79+/XLiiSe22QXr7bffzj/90z9lww03TJ8+fXLYYYfl5ZdfXq7jZD772c+msbGx3ei8+eabs3Dhwhx77LEtj/Od73wnW221VbtbTQ499NAcf/zx+a//+q88/vjjy3xcAFtagNXic5/7XL72ta/l5z//eU455ZQkyXPPPZfhw4dn4403zrnnnpvevXvn1ltvzeGHH56f/OQnOeKII1qt48wzz8z666+fCy64IJMnT85ll12WL37xi7nllltaxpx//vn5xje+kYMOOigHHXRQnn766RxwwAGZN29eu/M6/fTTM3DgwJx//vmZNWtWkqZfAMeMGZP9998/p512Wp5//vlcffXVeeKJJ/Lwww+3/BX56quvzhe/+MXsvffe+fKXv5zJkyfn8MMPz/rrr98qgJpdfPHFqa+vz6hRozJ37tzU19fn97//ff7jP/4jRx11VIYNG5apU6fmmmuuyYgRI/L73/8+gwcPbrWOsWPHpmfPnjn33HMzceLEXHHFFenevXu6dOmSN998MxdeeGEmTJiQcePGZdiwYTn//POX+e8ybty4nHjiidltt90yduzYTJ06NZdffnkefvjh/M///E/69++fr3/969l6663zwx/+sGX3vy222GKp67zrrruy+eab54Mf/OAyH7vZySefnB/96Ec58sgj85WvfCWPPfZYxo4dmz/84Q+54447Wo19/vnnc8wxx+TUU0/NKaeckq233jqzZ8/OiBEj8vLLL+fUU0/NpptumkceeSSjR4/OK6+8kssuuyxJcv/99+eYY47JRz7ykXz7299OkvzhD3/Iww8/3BJRy7OugQMH5uqrr85pp52WI444Ip/4xCeSZJXs+jht2rQccMABGThwYM4999z0798/kydPzk9/+tPluv/RRx+dYcOGZezYsXn66afzr//6rxk0aFDL95skJ5xwQm699dZ87nOfy5577pmHHnooBx988HKt/xOf+EROO+20jB8/vuX7bjZ+/PgMHTo0w4cPT5L85je/yZtvvpkvfelLS92V7bjjjssNN9yQu+66K7vvvnvL9QsWLMhrr73WZnzPnj1X29ZQoDAVwCpwww03VEmqJ554Yqlj+vXrV33gAx9oufyRj3yk2mGHHao5c+a0XLdw4cLqgx/8YPW+972vzbr333//auHChS3Xf/nLX666du1avfXWW1VVVdW0adOq+vr66uCDD2417mtf+1qVpDr++OPbrPNDH/pQ9c4777Rc37yOAw44oFqwYEHL9d///verJNX1119fVVVVzZ07t9pggw2q3XbbrZo/f37LuHHjxlVJqhEjRrRc96tf/apKUm2++ebV7NmzWz0nc+bMafU4VVVVkyZNqhoaGqqLLrqozTq23377at68eS3XH3PMMVVdXV01cuTIVuvYa6+9qqFDh1bLMm/evGrQoEHV9ttvX7399tst1999991Vkur8889v83wt69+3qqqqsbGxSlJ9/OMfX+a4Zs8880yVpDr55JNbXT9q1KgqSfXAAw+0XDd06NAqSXXvvfe2GnvxxRdXvXv3rl544YVW15977rlV165dqz//+c9VVVXVl770papv376t/r2XtLzrevXVV6sk1QUXXLBc3+cFF1xQtfe/3ObnddKkSVVVVdUdd9yxXM/zko/dvP6TTjqp1bgjjjii2mCDDVouP/XUU1WS6qyzzmo17oQTTlju7+eoo46qevToUTU2NrZc98c//rFKUo0ePbrlussuu6xKUt1xxx1LXdcbb7xRJak+8YlPtFw3YsSIKkm7y6mnnvqu8wPWTnYPA1ab9dZbr+UsYm+88UYeeOCBHH300ZkxY0Zee+21vPbaa3n99ddz4IEH5sUXX2y1i1LStB/84rvY7L333lmwYEH+9Kc/JUl+8YtfZN68eTnzzDNbjTvrrLOWOqdTTjklXbt2bbncvI6zzjqr1fEmp5xySvr27duyW8yTTz6Z119/PaecckqrvyIfe+yxWX/99dt9rOOPP77N8RcNDQ0tj7NgwYK8/vrrWW+99bL11lvn6aefbrOO4447rmVLT5Lsscceqaqqze5De+yxR6ZMmZJ33nlnqd/7k08+mWnTpuX0009vdYzEwQcfnG222WaFjjuZPn16kqRPnz7LNf6//uu/kiRnn312q+u/8pWvJEmbOQwbNiwHHnhgq+tuu+227L333ll//fVbXkevvfZa9t9//yxYsCC//vWvkzQdjzNr1qzcf//9S53P8q6rszQfM3T33Xdn/vz5Hb7/P/7jP7a6vPfee+f1119v+Xe59957kzRtYVzcmWeeudyP8dnPfjZz5sxptfVn/PjxSdKya1iSlp/1Zb0Wmm9b8uyCm222We6///42y7J+loG1m93DgNVm5syZLWcJmjhxYqqqynnnnZfzzjuv3fHTpk3Lxhtv3HJ50003bXV7cxy8+eabSdISL+973/tajRs4cOBSQ2LYsGGtLjevY+utt251fX19fTbffPOW25v/u+WWW7Ya161bt2y22WbL9VhJsnDhwlx++eW56qqrMmnSpCxYsKDltg022KDN+CWfg+azKQ0ZMqTN9QsXLkxjY2O761n8e1jye02SbbbZJr/5zW/avd+y9O3bN0nbX0KX5k9/+lO6dOnS5nncaKON0r9//5Y5NmvvOXzxxRfz29/+tuU4kyU1n0Tg9NNPz6233pqRI0dm4403zgEHHJCjjz46H/vYxzq8rs4yYsSIfPKTn8yYMWPy//7f/8s+++yTww8/PJ/5zGfaHPjenmX9jPTt27fl+V7yeVzy+V+WkSNHZsCAARk/fnzLsU3//u//np122inbbbddy7ilBcnimm9b8uxhvXv3Xq6z1AHrDtECrBZ/+ctf0tjY2PLLUfNBzaNGjWrzl/NmS/4itfgWkcVVVbXC81qdZ55q77H++Z//Oeedd15OOumkXHzxxRkwYEC6dOmSs846q81B5MnSn4POeG5WRN++fTN48OA8++yzHbpfewept6e953DhwoX56Ec/mq9+9avt3merrbZK0vSL8TPPPJP77rsv99xzT+65557ccMMNOe644/KjH/2oQ+vqqKV9f4tHavO422+/PRMmTMhdd92V++67LyeddFL+5V/+JRMmTMh66623zMdZHa+D7t275+ijj861116bqVOn5s9//nNefPHFXHLJJa3GbbvttkmS3/72tzn88MPbXddvf/vbJMnmm2++yuYHrJ1EC7Ba/PjHP06SlkBp/iWle/fuq+wvqkOHDk3S9NfyxX8JevXVV1u2xizvOp5//vlW65g3b14mTZrUMtfmcRMnTsy+++7bMu6dd97J5MmTl/ug7Ntvvz377rtvrrvuulbXv/XWW9lwww2Xax0ravHvdb/99mt12/PPP99ye0cdcsgh+eEPf5hHH300e+2117vOYeHChXnxxRfz/ve/v+X6qVOn5q233lquOWyxxRaZOXPmcr2O6uvrc+ihh+bQQw/NwoULc/rpp+eaa67Jeeedly233HK517W8kdWseYvHW2+91eq00UtuSWq25557Zs8998w3v/nNjB8/Pscee2xuvvnmnHzyyR163CU1P9+TJk1qtUVy4sSJHVrPsccemx/84Ae55ZZbMmnSpNTV1eWYY45pNWb48OHp379/xo8fn69//evtBtW//du/JUmOOuqoFfhugHWJY1qATvfAAw/k4osvzrBhw1r2eR80aFD22WefXHPNNXnllVfa3GfJUxkvj/333z/du3fPFVdc0eovy81nj1reddTX1+d73/teq3Vcd911aWxsbDnL0q677poNNtgg1157bavjRm666ablDqSk6S/jS/4V/LbbbmtzPE9n2HXXXTNo0KD84Ac/aHV64XvuuSd/+MMflvuMUkv66le/mt69e+fkk0/O1KlT29z+0ksvtZxm+KCDDkrS9t/o0ksvTZLlmsPRRx+dRx99NPfdd1+b2956662Wf5/XX3+91W1dunRpicvm739519WrV6+W65ZH89nWFj8mZtasWS1beJq9+eabbV4PO++8c6s5rozmPxpcddVVra6/4oorOrSe4cOHZ7PNNsuNN96YW265JSNGjGhzxrxevXrlq1/9ap5//vl8/etfb7OOn/3sZxk3blwOPfTQ7LDDDh38ToB1jS0twCp1zz335I9//GPeeeedTJ06NQ888EDuv//+DB06NHfeeWerA76vvPLKfOhDH8oOO+yQU045JZtvvnmmTp2aRx99NH/5y1/afFbJuxk4cGBGjRqVsWPH5pBDDslBBx2U//mf/8k999yz3FstBg4cmNGjR2fMmDH52Mc+lsMOOyzPP/98rrrqquy2224tH3hXX1+fCy+8MGeeeWb222+/HH300Zk8eXLGjRuXLbbYYrn/En/IIYfkoosuyoknnpgPfvCD+d3vfpebbrpptewu071793z729/OiSeemBEjRuSYY45pOeXxZpttli9/+csrtN4tttgi48ePz6c+9am8//3vz3HHHZftt98+8+bNyyOPPJLbbrut5ViInXbaKccff3x++MMf5q233sqIESPy+OOP50c/+lEOP/zwVluxluacc87JnXfemUMOOSQnnHBCdtlll8yaNSu/+93vcvvtt2fy5MnZcMMNc/LJJ+eNN97Ifvvtl0022SR/+tOfcsUVV2TnnXdu2cqzvOvq2bNntt1229xyyy3ZaqutMmDAgGy//fbZfvvt253jAQcckE033TSf//znc84556Rr1665/vrrM3DgwPz5z39uGfejH/0oV111VY444ohsscUWmTFjRq699tr07du3JfBWxi677JJPfvKTueyyy/L666+3nPL4hRdeSLL8W5Dq6urymc98Jv/8z/+cJLnooovaHffVr341zzzzTL797W/n0UcfzSc/+cn07Nkzv/nNb3LjjTdmu+22y7hx49rcr7Gxsc1nOjXzoZOwjqrZecuAtUrzqVubl/r6+mqjjTaqPvrRj1aXX355NX369Hbv99JLL1XHHXdctdFGG1Xdu3evNt544+qQQw6pbr/99jbrXvI0sM2nAf7Vr37Vct2CBQuqMWPGVO9973urnj17Vvvss0/17LPPVkOHDm33lMdLO7Xs97///WqbbbapunfvXr3n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M2fmpZdeynvf+96ljmloaEjfvn1bLQAAAMurQ9EyatSoPPTQQ5k8eXIeeeSRHHHEEenatWuOOeaYzpofAACwjuvQMS1/+ctfcswxx+T111/PwIED86EPfSgTJkzIwIEDO2t+AADAOq5D0XLzzTd31jwAAADatVLHtAAAAHQ20QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAULRutZ4Ay6Gqkvmzaz2Ltc+82e1/zarTvVdSV1frWQAAazjRUrqqSq4/MJnyWK1nsnb77pa1nsHaacieyUn3ChcAYKXYPax082cLFtZcUybYSggArDRbWtYkoyYm9b1qPQt4d/Nm23oFAKwyomVNUt8rqe9d61kAAMBqZfcwAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAo2kpFy7e+9a3U1dXlrLPOWkXTAQAAaG2Fo+WJJ57INddckx133HFVzgcAAKCVFYqWmTNn5thjj821116b9ddff1XPCQAAoMUKRcsZZ5yRgw8+OPvvv/+qng8AAEAr3Tp6h5tvvjlPP/10nnjiieUaP3fu3MydO7fl8vTp0zv6kAAAwDqsQ1tapkyZki996Uu56aab0qNHj+W6z9ixY9OvX7+WZciQISs0UQAAYN3UoWh56qmnMm3atPzDP/xDunXrlm7duuWhhx7K9773vXTr1i0LFixoc5/Ro0ensbGxZZkyZcoqmzwAALD269DuYR/5yEfyu9/9rtV1J554YrbZZpv8n//zf9K1a9c292loaEhDQ8PKzRIAAFhndSha+vTpk+23377Vdb17984GG2zQ5noAAIBVYaU+XBIAAKCzdfjsYUt68MEHV8E0AAAA2mdLCwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNE6FC1XX311dtxxx/Tt2zd9+/bNXnvtlXvuuaez5gYAANCxaNlkk03yrW99K0899VSefPLJ7Lfffvn4xz+e5557rrPmBwAArOO6dWTwoYce2uryN7/5zVx99dWZMGFCtttuu1U6MQAAgKSD0bK4BQsW5LbbbsusWbOy1157rco5AQAAtOhwtPzud7/LXnvtlTlz5mS99dbLHXfckW233Xap4+fOnZu5c+e2XJ4+ffqKzRQAAFgndfjsYVtvvXWeeeaZPPbYYznttNNy/PHH5/e///1Sx48dOzb9+vVrWYYMGbJSEwYAANYtHY6W+vr6bLnlltlll10yduzY7LTTTrn88suXOn706NFpbGxsWaZMmbJSEwYAANYtK3xMS7OFCxe22v1rSQ0NDWloaFjZhwEAANZRHYqW0aNHZ+TIkdl0000zY8aMjB8/Pg8++GDuu+++zpofAACwjutQtEybNi3HHXdcXnnllfTr1y877rhj7rvvvnz0ox/trPkBAADruA5Fy3XXXddZ8wAAAGhXhw/EBwAAWJ1ECwAAULSVPnsY0EFVlcyfXetZdK55s9v/em3WvVdSV1frWQDAWkm0wOpUVcn1ByZTHqv1TFaf725Z6xmsHkP2TE66V7gAQCewexisTvNnr1vBsi6ZMmHt34IGADViSwvUyqiJSX2vWs+ClTVv9rqzNQkAakS0QK3U90rqe9d6FgAAxbN7GAAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUrUPRMnbs2Oy2227p06dPBg0alMMPPzzPP/98Z80NAACgY9Hy0EMP5YwzzsiECRNy//33Z/78+TnggAMya9aszpofAACwjuvWkcH33ntvq8vjxo3LoEGD8tRTT+XDH/7wKp0YAABA0sFoWVJjY2OSZMCAAUsdM3fu3MydO7fl8vTp01fmIQEAgHXMCh+Iv3Dhwpx11lkZPnx4tt9++6WOGzt2bPr169eyDBkyZEUfEgAAWAetcLScccYZefbZZ3PzzTcvc9zo0aPT2NjYskyZMmVFHxIAAFgHrdDuYV/84hdz991359e//nU22WSTZY5taGhIQ0PDCk0OAACgQ9FSVVXOPPPM3HHHHXnwwQczbNiwzpoXAABAkg5GyxlnnJHx48fnP//zP9OnT5/87W9/S5L069cvPXv27JQJAgAA67YOHdNy9dVXp7GxMfvss0/e+973tiy33HJLZ80PAABYx3V49zCAmqiqZP7sWs+irXmz2/+6FN17JXV1tZ4FAKyUlfqcFoDVoqqS6w9MpjxW65ks23e3rPUM2hqyZ3LSvcIFgDXaCp/yGGC1mT+7/GAp1ZQJZW6hAoAOsKUFWLOMmpjU96r1LMo3b3aZW34AYAWIFmDNUt8rqe9d61kAAKuR3cMAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBo3Wo9gWJUVTJ/dq1n0da82e1/XZLuvZK6ulrPAgCAtZRoSZqC5foDkymP1Xomy/bdLWs9g/YN2TM56V7hAgBAp7B7WNK0haX0YCnZlAllbqUCAGCtYEvLkkZNTOp71XoWa4Z5s8vd+gMAwFpDtCypvldS37vWswAAAP7O7mEAAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFK1brScAANBKVSXzZ9d6FmufebPb/5pVp3uvpK6u1rNYK4kWAKAcVZVcf2Ay5bFaz2Tt9t0taz2DtdOQPZOT7hUuncDuYQBAOebPFiysuaZMsJWwk9jSAgCUadTEpL5XrWcB727ebFuvOploAQDKVN8rqe9d61kABbB7GAAAULQOR8uvf/3rHHrooRk8eHDq6uryH//xH50wLQAAgCYdjpZZs2Zlp512ypVXXtkZ8wEAAGilw8e0jBw5MiNHjlz5R541K+nate31XbsmPXq0Hrc0XbokPXuu2NjZs5tOq5gk82Yl86pF63inLunVq/2xS6pbYuzbbycLFy59Hr17r9jYOXOSBQtWzdhei51DfO7c5J13Vmzsks9bt55Nz3OSzJuXzJ+/9PX27MDYHj0WvVY6Mnb+/KbxS9PQkHTr1vGx77zT9FwsTX190r17+2OXfM7qFhu7YEHTv93SdO/etO6Ojl24sOm1tirGduvW9FwkTT8Ts5dxhpSOjH23n/vFn7c5c1rv47463iOWtOTPfYnvEUu+1upr8B6xpI783K+r7xHLGruuvEcs+dqdn479blCL3yOWtCa8R6zMWO8RTdq8Ryzxul3aWO8RTV83/9wv6+ducdVKSFLdcccdyxwzZ86cqrGxsWWZMmVKlaRqbJpq2+Wgg1qvoFev9sclVTViROuxG2649LG77tp67NChSx+77batx2677dLHDh3aeuyuuy597IYbth47YsTSx/bq1XrsQQctfeyS/4xHHrnssTNnLhp7/PHLHjtt2qKxp5++7LGTJi0aO2rUssc+++yisRdcsOyxjz++aOwllyx77K9+tWjs97+/7LF3371o7A03LHvsrbcuGnvrrcsee8MNi8beffeyx37/+4vG/upXyx57ySWLxj7++LLHXnDBorHPPrvssaNGLRo7adKyx55++qKx06Yte+zxxy8aO3PmssceeWTVyrLGfuzA1mO9RzTxHtHEe0STdfk9wu8RTYv3iEXL6niPuPYHyx7rPaJpaec9ojGpklSNjY3VsnT6gfhjx45Nv379WpYhQ4Z09kMCAABrkbqqqqoVvnNdXe64444cfvjhSx0zd+7czF1ss9b06dMzZMiQNP71r+nbt2/bO9Rq97Dv/P3c2udMTBrWs1l3ecYu+bz123AN36y7mnYPW/w5W2/9NX+z7qoYuzy7hzU/b+dOSvpusPSxi1uXd/1Y8rW2/qClj12SXT+a2D2s42NX1e5hi79263vbPWxxa9PvEUtak98jZr2VfHPTpq+bX7dLG+s9ounrv//cT58+Pf0GD05jY2P7bdB816WvddVoaGhIQ/PkFte7d+sfkKVZnjErMnbxN4juSerrFq1jyQ+y6rXE5WVZ/A1tVY5d/A14VY5taFj04uno2CWfty6Lbbirr1/0An43nTW2e/dFP8ircmy3boveeDo6dsnnbPHH7Np1+V/DHRnbpUvnjK2r65yxSduxiz9vS76+V8d7xKocu7reI5Z8rS1r7LKszHvEsniP6PjYdeU9os3/k9tZR2f93K9L7xGraqz3iEVj3+1128x7RJPmn/tlBfLiq16+tQIAANRGh7e0zJw5MxMnTmy5PGnSpDzzzDMZMGBANt1001U6OQAAgA5Hy5NPPpl999235fLZZ5+dJDn++OMzbty4VTYxAACAZAWiZZ999slKHLsPAADQIY5pAQAAitbpZw8DAIBVoqqS+cs4lXatzJvd/tcl6b7Y6afXQKIFAIDyVVVy/YHJlMdqPZNl++6WtZ5B+4bsmZx07xobLnYPAwCgfPNnlx8sJZsyocytVMvJlhYAANYsoya2/TBw2jdvdrlbfzpAtAAAsGap77XsT51nrWP3MAAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAitat1hMA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",
+      "text/plain": [
+       "<Figure size 1000x1000 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "threshold_height = 1\n",
+    "clusters = dendo.get_clusters_using_height(threshold_height)\n",
+    "colors = [\"red\", \"blue\", \"green\", \"black\", \"purple\", \"orange\", \"yellow\"]\n",
+    "dendo.plot_dendrogram(\n",
+    "    plot_title=\"Dendrogram of Coreset using VQE\",\n",
+    "    colors=colors,\n",
+    "    clusters=clusters,\n",
+    "    color_threshold=threshold_height,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can visualize the flat clusters using `dendo.plot_clusters()` method. The function takes the clusters and colors as arguments. The clusters are represented by different colors."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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Z87YP7+SfE8lPZezWCwWJk2axMqVKwkODubee+/l73//e4mX96pdu7bD64JAWxCkCz7P+vXrO/SrVKnSNadUFLjtttvo1q0by5Yt49dffwXypzxUqlSJxx9/3N6vIPRe6+/C6dOnCQoKKtR+77330qVLF4etbdu2JapRRKS0NOdXbnl+fn7UqlWL77///rrPYRhGke02m61QvyVLlrBt2zb+85//sGrVKv7v//6PKVOmsG3btqvOj83LywPgpZdeolu3bkX2uTKoeHt7F+rz+OOP07FjR5YtW8bq1auZPHkykyZNIiEhgQcffPCq77OsNWrUiG+//ZZDhw5htVrL9NwWiwUPD8d/n+fl5REUFMSHH35Y5DGBgYFAyb6nkp6rtEr6dwlg2LBhdO/eneXLl7Nq1SrGjBlDfHw869ato2XLlle9zpW/EShgmmbpi76Kvn37smLFClasWMGjjz7K0qVL7fOpCzRo0IBKlSrx3XffFXue3Nxc9u7dS+vWrcu0PhGR0tLIr1QIjzzyCPv372fr1q3XdXzBqNmpU6cc2q8cjSxwzz33MHHiRL755hs+/PBDdu3axUcffQQUH34KphtUrly50ChXwVbSKQQhISG88MILLF++nAMHDnDbbbcxceLEYvsHBgZStWpV9u7dW2jfnj178PDwuK7w2r17dwA++OCDa/atU6cOQJE17N27177/aurVq8f//vc/2rdvX+Tn16JFC4f+V/ueSnOu4r7TopT271K9evUYOXIkq1ev5vvvv+f8+fNMmTKlxNcrTsHnmZaW5tB+8eJF0tPTS3yeRx99FF9fXxYuXMjKlSs5efKkw5QHgKpVq3L//fezadOmYt/n4sWLyc3N5bHHHivdGxERKWMKv1IhvPzyy/j4+PDss89y7NixQvv379/PtGnTij2+Xr16AGzatMnedvbsWRYsWODQ7+TJk4VG1u68804A+6/UC1YluDL8BAUF0blzZ+bMmUNmZmahGgrW170am81GdnZ2ofPWqlXrqlMvPD09eeCBB/j0008dgs+xY8dYuHAhHTp0sE8fKY3evXvTrFkzJk6cWOQ/PE6fPm1fIaFVq1YEBQUxe/Zsh1pXrlxJamoqDz/88DWv9/jjj2Oz2Rg/fnyhfRcvXrR/5iX5nkp6LgAfH59C32dx6tSpg6enp8PfJch/UMblzp07Z59KUKBe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DRtGrVq19N3ITUPhtwK7/fbb8fT05NixYw7tx44do2bNmi6qSq40ePBgVqxYwaZNmwgLC3N1OQLs2LGDn376ibvuusveZrPZ2LRpE2+//Ta5ubl4enq6sEL3FhISQuPGjR3aIiMjWbp0qYsqkgJ/+tOfGDVqFL///e8BaNasGQcPHiQ+Pl7hV24amvNbgXl5eREVFcXatWvtbXl5eaxdu5a2bdu6sDIBME2TwYMHs2zZMtatW0d4eLirS5JL7r//fnbu3ElKSop9a9WqFX369CElJUXB18Xat29faFnAH374gTp16rioIilw7tw5PDwco4Wnpyd5eXkuqkikMI38VnAjRoygf//+tGrVitatWzN16lTOnj3L008/7erS3F5cXBwLFy7k008/xdfXl6ysLAD8/f3x9vZ2cXXuzdfXt9Dcax8fH2677TbNyb4JDB8+nHbt2vH666/z+OOPs337dubOncvcuXNdXZrb6969OxMnTqR27do0adKEb7/9ln/84x/83//9n6tLE7HTUmdu4O2332by5MlkZWVx55138tZbb9GmTRtXl+X2DMMosv29995jwIAB5VuMXFPnzp211NlNZMWKFYwePZp9+/YRHh7OiBEjGDhwoKvLcnunT59mzJgxLFu2jJ9++olatWrx5JNP8sorr+Dl5eXq8kQAhV8RERERcSOa8ysiIiIibkPhV0RERETchsKviIiIiLgNhV8RERERcRsKvyIiIiLiNhR+RURERMRtKPyKiIiIiNtQ+BURERERt6HwKyIiIiJuQ+FXRERERNyGwq+IiIiIuI3/D41GRMsQk+8TAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "dendo.plot_clusters(\n",
+    "    clusters, colors, plot_title=\"Clusters of Coreset using VQE\", show_annotation=True\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The function below uses the `dendo.get_voronoi_tessalation()` method to convert the clusters into regions. `coreset_df`, `clusters` and `colors` need to be passed as the arguments to create the regions. This function creates a region for each coreset point separately and then colors them according to the clusters with colors passed as arguments. Another option is to create regions using the centroids of the clusters. You need to pass `tesslation_by_cluster=True` to the function to perform this task.\n",
+    "\n",
+    "Once the region creation is complete, you can use `plot_voironi()` method to plot the regions. The function takes the clusters and colors as arguments. \n",
+    "\n",
+    "Remembering that these regions were based on coresets, they can overlay the original data set and be used to cluster the data based on the coreset analysis."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAiUAAAJCCAYAAAAfnLcJAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAABqUElEQVR4nO3dd5hU5d0+8Puc6bM72/suu/QqRWkCKlIEsSdqFDWCMTEqiEpiIskbS14VNT9LbKh5jRAS7FHz+iYqIIoFpAliAVTa0stWdvrM8/tj3ZVl++zMPKfcn+va64LZ2Znvzs6cuecp36MIIQSIiIiIJFNlF0BEREQEMJQQERGRRjCUEBERkSYwlBAREZEmMJQQERGRJjCUEBERkSYwlBAREZEmMJQQERGRJjCUEBERkSYwlFDC7dy5E4qiYOHChVLuf+HChVAUBTt37pRy/4n0/vvvQ1EUvP/++3G9XUVRcNddd8X1NuNt7dq1GDt2LFJSUqAoCjZu3Ci7JNPq3r07Zs6cKbsMMgCGEmriggsugNvtRm1tbavXufLKK2G323H06NEkVpY4DaGpI19GCjb//ve/NR88WhMKhXDppZeioqICjzzyCBYvXoyysrI2f+bgwYP49a9/jf79+8PtdiMlJQXDhw/HPffcg6qqquQUnkD33Xcf3njjDdllJM0///lPKIqC//mf/2n1OkuXLoWiKHjssceaXP7WW2/h7LPPRnZ2NpxOJ/r27YvbbrsNFRUVzW5j5syZrR4PnE5n3H8vs1N47hs63ksvvYTLL78cixYtwtVXX93s+16vF3l5eZg4cSL+9a9/deg2hRAIBAKw2WywWCzxLrldkUgEoVAIDocDiqI0+35dXR1ef/31Jpc99NBD2LNnDx555JEml//oRz9CSkpKQuvtjPfffx8TJkzAihUrcOaZZ3bqZ2fPno0nn3wSLR0C/H4/rFYrrFZrnCqNry1btmDAgAH4y1/+gp///OftXn/t2rU455xzcOzYMVx11VUYPnw4AGDdunV48cUXMXbsWLz77ruJLjuhUlNTcckll0gZkQwEAlBVFTabLan3mZ+fj1NOOQXvvfdei9e55pprsHjxYuzbtw95eXkAgF//+td46KGHMHToUFxxxRXIysrChg0b8Ne//hV5eXlYvnw5+vTp03gbM2fOxIsvvthi+LFYLJg+fXpifkGzEkTH8Xq9wuPxiKlTp7b4/SVLlggA4sUXX4z7fR87dizutxmrc889V5SVlckuo10rVqwQAMSKFSs6/bOzZs0Sej0EfPDBBwKAeOWVV9q9bmVlpSguLhb5+fni66+/bvb9AwcOiP/+7/+OS111dXVxuZ1YpKSkiBkzZki7fxmuvfZaoaqq2Lt3b7Pv+Xw+kZ6eLs4+++zGyxqOX5dddpkIh8NNrv/pp58Kt9sthg4dKkKhUOPlM2bMECkpKYn7JagJfR6RKKFmzJghrFarOHjwYLPvnXfeecLj8Qiv1yuEEOK7774Tl1xyicjMzBQul0uMHj1avPXWW01+ZseOHQKAeP7555vcR0pKivj222/FtGnTRGpqqrjwwguFEPXhZO7cuaKkpETY7XbRt29f8ac//UlEo9EmtwtAzJo1S7z++uti0KBBwm63i4EDB4r//Oc/Ta73/PPPCwBix44dHX4MWgolfr9f3HHHHaJXr17CbreLkpIScdtttwm/39/keu+++64YN26cSE9PFykpKaJv375i3rx5Ta7z2GOPiYEDBwqXyyUyMjLE8OHDxT/+8Y/G7+/cuVPccMMNom/fvsLpdIqsrCxxySWXNPsdWgolK1euFJdccono1q1bY5233HJL499MiPrHH0Czr+Mf2zvvvLPJfW3YsEGcffbZwuPxiJSUFDFx4kSxatWqJtdpeKw/+ugjceutt4qcnBzhdrvFRRddJA4dOtTewy6EEGL58uXitNNOE263W6Snp4sLLrhAfPXVV23WPn78+FZv7/777xcAmjy+7XnyySfFwIEDhd1uF4WFheLGG28UlZWVTa4zfvx4MWjQILFu3Tpx+umnC5fLJW6++WYhRHyfKx25rZb+lm0FlNZeEy09n7Zt2yZ+/OMfi/z8fOFwOERxcbG47LLLRFVVVeN1ysrKmtxfZ54HkUhE3HnnnaKwsFC4XC5x5plnii+//LLZbbakod6HHnqo2fdeffVVAUAsXry48bJ+/fqJzMxMUV1d3eLt3X333QKAeOmllxovYyhJLm2OzZJUV155JRYtWoSXX34Zs2fPbry8oqIC77zzDqZPnw6Xy4WDBw9i7Nix8Hq9mDNnDrKzs7Fo0SJccMEFePXVV/GjH/2ozfsJh8OYOnUqTjvtNPy///f/4Ha7IYTABRdcgBUrVuDaa6/FsGHD8M477+C2227D3r17m02nfPTRR/jnP/+JG2+8ER6PB4899hguvvhi7N69G9nZ2XF7TKLRKC644AJ89NFHuO666zBgwABs3rwZjzzyCLZt29Y4l//ll1/ivPPOw5AhQ/DHP/4RDocD3377LT7++OPG2/rLX/6COXPm4JJLLsHNN98Mv9+Pzz//HJ9++imuuOIKAPXTDZ988gkuv/xylJSUYOfOnViwYAHOPPNMfPXVV3C73a3W+sorr8Dr9eKGG25AdnY21qxZg8cffxx79uzBK6+8AgD45S9/iX379mHp0qVYvHhxu7//l19+idNPPx1paWn4zW9+A5vNhmeeeQZnnnkmPvjgA4wePbrJ9W+66SZkZmbizjvvxM6dO/Hoo49i9uzZeOmll9q8n2XLlmHatGno2bMn7rrrLvh8Pjz++OMYN24cNmzYgO7du+OXv/wliouLcd9992HOnDkYOXIk8vPzW73Nf/3rX3C5XLjkkkva/T0B4K677sLdd9+NyZMn44YbbsDWrVuxYMECrF27Fh9//HGTKYqjR49i2rRpuPzyy3HVVVchPz8/rs+Vjt7W4sWL8fOf/xyjRo3CddddBwDo1atXh37ftgSDQUydOhWBQAA33XQTCgoKsHfvXrz11luoqqpCenp6mz/fkefBvHnz8OCDD+L888/H1KlTsWnTJkydOhV+v7/d+s444wyUlJRgyZIlmDt3bpPvLVmyBG63GxdddBEA4JtvvsHWrVsxc+ZMpKWltXh7V199Ne6880787//+L37yk580+d6RI0eaXd9ut7d6WxQj2amItCccDovCwkIxZsyYJpc//fTTAoB45513hBBC3HLLLQKA+PDDDxuvU1tbK3r06CG6d+8uIpGIEKL1kRIA4vbbb29yH2+88YYAIO65554ml19yySVCURTx7bffNl4GQNjt9iaXbdq0SQAQjz/+eONl8RgpWbx4sVBVtcnvevxj8vHHHwshhHjkkUcEAHH48OFWb/vCCy8UgwYNavP+jx/VaLBq1SoBQPztb39rvKylT7Yt/ez8+fOFoihi165djZe1NX2DE0ZKLrroImG328V3333XeNm+ffuEx+MRZ5xxRuNlDY/15MmTm4xs3XrrrcJisTT5dN2SYcOGiby8PHH06NHGyzZt2iRUVRVXX311s9+7I9M3mZmZYujQoe1eTwghDh06JOx2u5gyZUrj81cIIZ544gkBQPz1r39tvGz8+PECgHj66aeb3EY8nysdvS0hOjd909GRks8++6xDj3NrIyXtPQ8OHDggrFaruOiii5rc3l133dXuaE+D2267TQAQW7dubbysurpaOJ1OMX369MbLGo4tjzzySJu3l5aWJk455ZTG/7c2qgig1Wluih1331AzFosFl19+OVatWtVkt8mSJUuQn5+PSZMmAajfvTFq1CicdtppjddJTU3Fddddh507d+Krr75q975uuOGGJv//97//DYvFgjlz5jS5/Fe/+hWEEPjPf/7T5PLJkyc3+UQ4ZMgQpKWlYfv27R3+fTvilVdewYABA9C/f38cOXKk8WvixIkAgBUrVgAAMjIyAABvvvkmotFoi7eVkZGBPXv2YO3ata3en8vlavx3KBTC0aNH0bt3b2RkZGDDhg1t1nr8z9bV1eHIkSMYO3YshBD47LPPOvT7Hi8SieDdd9/FRRddhJ49ezZeXlhYiCuuuAIfffQRampqmvzMdddd12RR8emnn45IJIJdu3a1ej/79+/Hxo0bMXPmTGRlZTVePmTIEJx11ln497//3enaAaCmpgYej6dD1122bBmCwSBuueUWqOoPh8df/OIXSEtLw//93/81ub7D4cA111zT5LJ4Plc6eluJ0jAS8s4778Dr9Xb659t7HixfvhzhcBg33nhjk5+76aabOnwfV111FYD641OD1157DX6/H1deeWXjZQ07Ctt7Lng8nma7D51OJ5YuXdrs6/777+9wndQxDCXUooYXc8MLfc+ePfjwww9x+eWXN+6g2bVrF/r169fsZwcMGND4/bZYrVaUlJQ0uWzXrl0oKipqduBo7TZLS0ub3W5mZiYqKyvbvO/O+uabb/Dll18iNze3yVffvn0BAIcOHQIAXHbZZRg3bhx+/vOfIz8/H5dffjlefvnlJm86v/3tb5GamopRo0ahT58+mDVrVpMhewDw+Xy444470K1bNzgcDuTk5CA3NxdVVVWorq5us9bdu3c3vrGnpqYiNzcX48ePB4B2f7Ylhw8fhtfrbfVvHY1GUV5e3uTyE/8umZmZANDm36Xhb9va/Rw5cgR1dXWdrj8tLa3NLe4dqcFut6Nnz57Nnn/FxcWw2+1NLovnc6Wjt5UoPXr0wNy5c/E///M/yMnJwdSpU/Hkk092+HnU3vOg4fHs3bt3k+tlZWU1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20VRUZGYPn262LZtW+PtPPPMM+KMM84Q2dnZwuFwiF69eonbbrutSUOnyspKcc0114icnByRmpoqpk6dKrZs2dLsd2tpS/BXX30lJk+eLFJTU0VOTo74xS9+0bhV+vi/QTgcFjfddJPIzc0ViqJ0qHna1KlTRWpqqnC73WLChAnik08+aXKdhsd67dq1TS7vTOfZZcuWiXHjxgmXyyXS0tLE+eef36R52vG315EtwQ327dsnbr311saGdG63WwwfPlzce++9zZppPfHEE6J///7CZrOJ/Px8ccMNN7TaPK0l8XqudPS2hBBiy5Yt4owzzhAul6tD22m/++47MXnyZOFwOER+fr743e9+J5YuXdrk77R9+3bxs5/9TPTq1auxid+ECRPEsmXLmtxWa6+5jjwPwuGw+MMf/iAKCgqEy+USEydOFF9//bXIzs4W119/fZu/w/EqKiqEw+EQAJo9X070r3/9S0yePFlkZGQ0bu8dNGhQi03V2toS3NnjCrWP574hIiJNqaqqQmZmJu65555WRz3i6ec//zmee+65Dp9LiRKH0zdERCSNz+drtovp0UcfBYBOn2QyVs888wwOHjyIG264AUVFRTGvX6Ku40gJERFJs3DhQixcuBDnnHMOUlNT8dFHH+GFF17AlClT8M4778guj5KMIyVERCTNkCFDYLVa8eCDD6KmpqZx8WtXtxuTPnGkhIiIiDSBfUqIiIhIExhKiIiISBNMtaYkGo1i37598Hg8nWrKQ0RERLERQqC2thZFRUXtN9WU2COlS+bPny8AiJtvvrnDP1NeXt5mExx+8Ytf/OIXv/iVmK/y8vJ236d1OVKydu1aPPPMMxgyZEinfq6hhXd5+f1IS3MmojSiH2x1A594ZVdBZHj/HGxDtSUkuwxqhb/Oj9vPvb3FkyCeSHeh5NixY7jyyivxl7/8pdNbxhqmbNLSnEhLa37KcaK46m4HPhOyqyAytIiqIJQu4NLf25npdGTZhO4Wus6aNQvnnntuh04hHggEUFNT0+SLKGky+cmNKNGqU61g9DcOXUXLF198ERs2bMDatWs7dP358+fj7rvvTnBVRK2wRoFcG3CY4YQoUSo8VgB8jRmFbkZKysvLcfPNN+Mf//gHnM6OrQeZN28eqqurG7/Ky8sTXCXRCYp1lfuJdKeSM/GGopsj5vr163Ho0CGccsop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KiZPnoxVq1ZJrMy4qqurAQBZWVmSKzGmWbNm4dxzz23ynKb4+Ne//oURI0bg0ksvRV5eHk4++WT85S9/kV2W4YwdOxbLly/Htm3bAACbNm3CRx99hGnTpkmurONMdUI+ip8jR44gEokgPz+/yeX5+fnYsmWLpKqMKxqN4pZbbsG4ceNw0kknyS7HcF588UVs2LABa9eulV2KIW3fvh0LFizA3Llz8bvf/Q5r167FnDlzYLfbMWPGDNnlGcbtt9+Ompoa9O/fHxaLBZFIBPfeey+uvPJK2aV1GEMJkQ7MmjULX3zxBT766CPZpRhOeXk5br75ZixduhROp1N2OYYUjUYxYsQI3HfffQCAk08+GV988QWefvpphpI4evnll/GPf/wDS5YswaBBg7Bx40bccsstKCoq0s3jzFBCMcnJyYHFYsHBgwebXH7w4EEUFBRIqsqYZs+ejbfeegsrV65ESUmJ7HIMZ/369Th06BBOOeWUxssikQhWrlyJJ554AoFAABaLRWKF+ldYWIiBAwc2uWzAgAF47bXXJFVkTLfddhtuv/12XH755QCAwYMHY9euXZg/f75uQgnXlFBM7HY7hg8fjuXLlzdeFo1GsXz5cowZM0ZiZcYhhMDs2bPx+uuv47333kOPHj1kl2RIkyZNwubNm7Fx48bGrxEjRuDKK6/Exo0bGUjiYNy4cc22s2/btg1lZWWSKjImr9cLVW36tm6xWBCNRiVV1HkcKaGYzZ07FzNmzMCIESMwatQoPProo6irq8M111wjuzRDmDVrFpYsWYI333wTHo8HBw4cAACkp6fD5XJJrs44PB5Ps3U6KSkpyM7O5vqdOLn11lsxduxY3HffffjJT36CNWvW4Nlnn8Wzzz4ruzRDOf/883HvvfeitLQUgwYNwmeffYaHH34YP/vZz2SX1nGCqAsef/xxUVpaKux2uxg1apRYvXq17JIMA0CLX88//7zs0gxv/Pjx4uabb5ZdhqH87//+rzjppJOEw+EQ/fv3F88++6zskgynpqZG3HzzzaK0tFQ4nU7Rs2dP8fvf/14EAgHZpXUY+5QQERGRJnBNCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJEWnW4cOHUVBQgPvuu6/xsk8++QR2ux3Lly+XWBkRJQJPyEdEmvbvf/8bF110ET755BP069cPw4YNw4UXXoiHH35YdmlEFGcMJUSkebNmzcKyZcswYsQIbN68GWvXroXD4ZBdFhHFGUMJEWmez+fDSSedhPLycqxfvx6DBw+WXRIRJQDXlBCR5n333XfYt28fotEodu7cKbscIkoQjpQQkaYFg0GMGjUKw4YNQ79+/fDoo49i8+bNyMvLk10aEcUZQwkRadptt92GV199FZs2bUJqairGjx+P9PR0vPXWW7JLI6I44/QNEWnW+++/j0cffRSLFy9GWloaVFXF4sWL8eGHH2LBggWyyyOiOONICREREWkCR0qIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBP+P47pALgePnBfAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 800x800 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "vt = Voironi_Tessalation(coreset_df, clusters, colors, tesslation_by_cluster=False)\n",
+    "vt.plot_voironi(plot_title=\"Voironi Tessalation of Coreset using VQE\", show_annotation=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## QAOA Implementation\n",
+    "\n",
+    "CUDA-Q is designed to be a flexible tool for developers so they can test different implementations of the same code. For example, one can perform the same analysis, instead using a QAOA approach. Only the kernel needs to be changed as is done below."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "                                                                             »\n",
+      "q0 : ──●──────────────────●──────────────────────────────────────────────────»\n",
+      "     ╭─┴─╮╭────────────╮╭─┴─╮                                                »\n",
+      "q1 : ┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──────────────────────────»\n",
+      "     ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮                        »\n",
+      "q2 : ────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──»\n",
+      "                             ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮»\n",
+      "q3 : ────────────────────────────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├»\n",
+      "                                                     ╰───╯╰────────────╯╰───╯»\n",
+      "q4 : ────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                             »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                        ╭───╮╭────────────╮╭───╮╭───────────╮\n",
+      "────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├┤ rx(1.111) ├\n",
+      "                        ╰─┬─╯╰────────────╯╰─┬─╯├───────────┤\n",
+      "──────────────────────────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "                          │                  │  ├───────────┤\n",
+      "──────────────────────────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "                          │                  │  ├───────────┤\n",
+      "──●──────────────────●────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "╭─┴─╮╭────────────╮╭─┴─╮  │                  │  ├───────────┤\n",
+      "┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──┤ rx(1.111) ├\n",
+      "╰───╯╰────────────╯╰───╯                        ╰───────────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "def get_QAOA_circuit(number_of_qubits, circuit_depth) -> cudaq.Kernel:\n",
+    "    \"\"\"Returns the QAOA circuit for the given number of qubits and circuit depth\n",
+    "\n",
+    "\n",
+    "    Args:\n",
+    "        number_of_qubits (int): Number of qubits\n",
+    "        circuit_depth (int): Circuit depth\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq.Kernel: QAOA Circuit\n",
+    "    \"\"\"\n",
+    "\n",
+    "    @cudaq.kernel\n",
+    "    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):\n",
+    "        qubits = cudaq.qvector(number_of_qubits)\n",
+    "\n",
+    "        layers = circuit_depth\n",
+    "\n",
+    "        for layer in range(layers):\n",
+    "            for qubit in range(number_of_qubits):\n",
+    "                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])\n",
+    "                rz(2.0 * thetas[layer], qubits[(qubit + 1) % number_of_qubits])\n",
+    "                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])\n",
+    "\n",
+    "            rx(2.0 * thetas[layer + layers], qubits)\n",
+    "\n",
+    "    return kernel\n",
+    "\n",
+    "\n",
+    "circuit = get_QAOA_circuit(5, circuit_depth)\n",
+    "\n",
+    "print(cudaq.draw(circuit, np.random.rand(2 * circuit_depth), 5, circuit_depth))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_optimizer(\n",
+    "    optimizer: cudaq.optimizers.optimizer, max_iterations, **kwargs\n",
+    ") -> Tuple[cudaq.optimizers.optimizer, int]:\n",
+    "    \"\"\"\n",
+    "    Returns the optimizer with the given parameters\n",
+    "\n",
+    "    Args:\n",
+    "        optimizer (cudaq.optimizers.optimizer): Optimizer\n",
+    "        max_iterations (int): Maximum number of iterations\n",
+    "        **kwargs: Additional arguments\n",
+    "\n",
+    "    Returns:\n",
+    "        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count\n",
+    "    \"\"\"\n",
+    "\n",
+    "    parameter_count = 2 * kwargs[\"circuit_depth\"]\n",
+    "    optimizer.initial_parameters = np.random.uniform(-np.pi / 8.0, np.pi / 8.0, parameter_count)\n",
+    "    optimizer.max_iterations = max_iterations\n",
+    "    return optimizer, parameter_count"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 484/484 [00:00<00:00, 12163.89it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00<00:00, 52703.30it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 48/48 [00:00<00:00, 31987.07it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 36393.09it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 37957.50it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 42473.96it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "divisive_clustering = DivisiveClusteringVQA(\n",
+    "    circuit_depth=circuit_depth,\n",
+    "    max_iterations=max_iterations,\n",
+    "    max_shots=max_shots,\n",
+    "    threshold_for_max_cut=0.75,\n",
+    "    create_Hamiltonian=get_K2_Hamiltonian,\n",
+    "    optimizer=optimizer,\n",
+    "    optimizer_function=get_optimizer,\n",
+    "    create_circuit=get_QAOA_circuit,\n",
+    "    normalize_vectors=True,\n",
+    "    sort_by_descending=True,\n",
+    "    coreset_to_graph_metric=\"dist\",\n",
+    ")\n",
+    "\n",
+    "hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Scaling simulations with CUDA-Q\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The University of Edinburgh team quickly encountered scaling challenges when they were developing this method. By developing with CUDA-Q they were able to port their code to an HPC environment once GPUs became available. GPUs massively accelerated their development and testing and allowed them to produce the 25 qubit experiments presented in their publication. If you have a GPU available, run the following code examples and see how the times compare on your device. Each call executes the divisive clustering procedure using the QAOA method, 100000 simulated shots for each VQE loop, and maximum 75 VQE iterations."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "First, try a slightly larger N=18 problem using the CPU (`qpp-cpu`) backend."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Uncomment the following line if you want to explicitly execute this step on your system.\n",
+    "# !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 18"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now try the N=18 example on the GPU backend (`nvidia`)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "100%|███████████████████████████████████████| 751/751 [00:00<00:00, 3460.26it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 42771.74it/s]\n",
+      "100%|█████████████████████████████████████| 4064/4064 [00:00<00:00, 6862.37it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 56871.92it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 44979.13it/s]\n",
+      "100%|██████████████████████████████████████| 128/128 [00:00<00:00, 19366.94it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 53773.13it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 54648.91it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 51941.85it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 56111.09it/s]\n",
+      "Total time for the execution: 461.866833317\n",
+      "Total time spent on CUDA-Q: 10.452308367999706\n"
+     ]
+    }
+   ],
+   "source": [
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 18"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Scaling up to N=25, the task becomes even more onerous on a CPU. Depending on your device, the simulation may not even run. Try it and feel free to interrupt after your patience has worn out."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# target = 'qpp-cpu'\n",
+    "# Uncomment the following line if you want to explicitly execute this step on your system.\n",
+    "# !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 25"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "N=25 can still easily be completed by a single GPU."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "100%|█████████████████████████████████████| 7352/7352 [00:03<00:00, 2063.82it/s]\n",
+      "100%|███████████████████████████████████| 16492/16492 [00:03<00:00, 4739.44it/s]\n",
+      "100%|██████████████████████████████████████| 256/256 [00:00<00:00, 15185.58it/s]\n",
+      "100%|████████████████████████████████████████| 64/64 [00:00<00:00, 23728.05it/s]\n",
+      "100%|██████████████████████████████████████| 256/256 [00:00<00:00, 15437.97it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 50840.05it/s]\n",
+      "100%|████████████████████████████████████████| 32/32 [00:00<00:00, 33562.82it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 54120.05it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 54560.05it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 55924.05it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 42717.29it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 55007.27it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 53601.33it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 47127.01it/s]\n",
+      "Total time for the execution: 67.61674502899999\n",
+      "Total time spent on CUDA-Q: 21.439895901\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia'\n",
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 25"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If we want to push the simulation to an $N=34$ coreset, a single GPU (assuming A100) will run out of memory.  Run the code below to see for yourself. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "RuntimeError: NLOpt runtime error: nlopt failure\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia'\n",
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 34"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To compute a problem with 34 qubits, we need to pool the memory of multiple GPUs.  If you have multiple GPUs available, try the code below to run the same computation on 4 GPUs. You do not need to wait for the code to finish, just note how it does not fail immediately due to memory issues."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "^C\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia-mgpu'\n",
+    "gpu_count = !nvidia-smi -L | wc -l\n",
+    "try:\n",
+    "    gpu_count = int(gpu_count[0])\n",
+    "except:\n",
+    "    gpu_count = 0    \n",
+    "if gpu_count >= 4:\n",
+    "    !mpirun -np 4 python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia-mgpu --M 34\n",
+    "else:\n",
+    "    print(f'Not enough GPUs found on this system ({gpu_count}) to run this step')"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/H2-MRQKS.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/H2-MRQKS.ipynb.txt
new file mode 100644
index 0000000000..f919d08673
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/H2-MRQKS.ipynb.txt
@@ -0,0 +1,458 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Multi-Reference Quantum Krylov Algorithm (H2 Example)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Package installs\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermionpyscf==0.5\n",
+    "!pip install openfermion==1.6.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "import scipy\n",
+    "\n",
+    "# Single-node, single gpu\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "multi_gpu = False\n",
+    "\n",
+    "# Single-node, multi-GPU\n",
+    "#cudaq.set_target(\"nvidia\", option='mqpu,fp64')\n",
+    "#multi_gpu = True\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Ground state energy (classical simulation)=  (-1.1371757102406843+0j) , index=  3\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Define H2 molecule\n",
+    "geometry = [('H', (0.0, 0.0, 0.0)), ('H', (0.0, 0.0, 0.7474))]\n",
+    "\n",
+    "hamiltonian, data = cudaq.chemistry.create_molecular_hamiltonian(\n",
+    "    geometry, 'sto-3g', 1, 0)\n",
+    "\n",
+    "electron_count = data.n_electrons\n",
+    "qubits_num = 2 * data.n_orbitals\n",
+    "\n",
+    "spin_ham_matrix = hamiltonian.to_matrix()\n",
+    "e, c = np.linalg.eig(spin_ham_matrix)\n",
+    "\n",
+    "# Find the ground state energy and the corresponding eigenvector\n",
+    "print('Ground state energy (classical simulation)= ', np.min(e), ', index= ',\n",
+    "      np.argmin(e))\n",
+    "min_indices = np.argmin(e)\n",
+    "\n",
+    "# Eigen vector can be used to initialize the qubits\n",
+    "vec = c[:, min_indices]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Collect coefficients from a spin operator so we can pass them to a kernel\n",
+    "def termCoefficients(ham: cudaq.SpinOperator) -> list[complex]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.get_coefficient()))\n",
+    "    return result\n",
+    "\n",
+    "\n",
+    "# Collect Pauli words from a spin operator so we can pass them to a kernel\n",
+    "def termWords(ham: cudaq.SpinOperator) -> list[str]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.to_string(False)))\n",
+    "    return result\n",
+    "\n",
+    "\n",
+    "coefficient = termCoefficients(hamiltonian)\n",
+    "pauli_string = termWords(hamiltonian)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def U_psi(qubits: cudaq.qview, dt: float, coefficients: list[complex],\n",
+    "          words: list[cudaq.pauli_word]):\n",
+    "    # Compute U_m = exp(-i m dt H)\n",
+    "    for i in range(len(coefficients)):\n",
+    "        exp_pauli(dt * coefficients[i].real, qubits, words[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def U_phi(qubits: cudaq.qview, dt: float, coefficients: list[complex],\n",
+    "          words: list[cudaq.pauli_word]):\n",
+    "    # Compute U_n = exp(-i n dt H)\n",
+    "    for i in range(len(coefficients)):\n",
+    "        exp_pauli(dt * coefficients[i].real, qubits, words[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def apply_pauli(qubits: cudaq.qview, word: list[int]):\n",
+    "\n",
+    "    # Add H (Hamiltonian operator)\n",
+    "    for i in range(len(word)):\n",
+    "        if word[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "        if word[i] == 2:\n",
+    "            y(qubits[i])\n",
+    "        if word[i] == 3:\n",
+    "            z(qubits[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def qfd_kernel(dt_alpha: float, dt_beta: float, coefficients: list[complex],\n",
+    "               words: list[cudaq.pauli_word], word_list: list[int],\n",
+    "               vec: list[complex]):\n",
+    "\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    qreg = cudaq.qvector(vec)\n",
+    "\n",
+    "    h(ancilla)\n",
+    "\n",
+    "    x(ancilla)\n",
+    "    cudaq.control(U_psi, ancilla, qreg, dt_alpha, coefficients, words)\n",
+    "    x(ancilla)\n",
+    "\n",
+    "    cudaq.control(apply_pauli, ancilla, qreg, word_list)\n",
+    "    cudaq.control(U_phi, ancilla, qreg, dt_beta, coefficients, words)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def pauli_str(pauli_word, qubits_num):\n",
+    "\n",
+    "    my_list = []\n",
+    "    for i in range(qubits_num):\n",
+    "        if str(pauli_word[i]) == 'I':\n",
+    "            my_list.append(0)\n",
+    "        if str(pauli_word[i]) == 'X':\n",
+    "            my_list.append(1)\n",
+    "        if str(pauli_word[i]) == 'Y':\n",
+    "            my_list.append(2)\n",
+    "        if str(pauli_word[i]) == 'Z':\n",
+    "            my_list.append(3)\n",
+    "    return my_list"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define the spin-op x for real component and y for the imaginary component.\n",
+    "\n",
+    "x_0 = cudaq.spin.x(0)\n",
+    "y_0 = cudaq.spin.y(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#Define parameters for the quantum Krylov space\n",
+    "\n",
+    "dt = 0.5\n",
+    "\n",
+    "# Dimension of the Krylov space\n",
+    "m_qfd = 4"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Compute the basis overlap matrix\n",
+    "\n",
+    "\n",
+    "## Single GPU:\n",
+    "if not multi_gpu:\n",
+    "\n",
+    "    # Add identity operator to compute overlap of basis\n",
+    "\n",
+    "    observe_op = 1.0\n",
+    "    for m in range(qubits_num):\n",
+    "        observe_op *= cudaq.spin.i(m)\n",
+    "\n",
+    "    identity_word = observe_op.to_string(False)\n",
+    "\n",
+    "    pauli_list = pauli_str(identity_word, qubits_num)\n",
+    "    #print(pauli_list)\n",
+    "\n",
+    "    wf_overlap = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "            results = cudaq.observe(qfd_kernel, [x_0, y_0], dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec)\n",
+    "            temp = [result.expectation() for result in results]\n",
+    "            wf_overlap[m, n] = temp[0] + temp[1] * 1j\n",
+    "            if n != m:\n",
+    "                wf_overlap[n, m] = np.conj(wf_overlap[m, n])\n",
+    "\n",
+    "else:\n",
+    "\n",
+    "    ## Multi-GPU\n",
+    "\n",
+    "    # Compute the basis overlap matrix\n",
+    "\n",
+    "    # Add identity operator to compute overlap of basis\n",
+    "\n",
+    "    observe_op = 1.0\n",
+    "    for m in range(qubits_num):\n",
+    "        observe_op *= cudaq.spin.i(m)\n",
+    "\n",
+    "    identity_word = observe_op.to_string(False)\n",
+    "\n",
+    "    pauli_list = pauli_str(identity_word, qubits_num)\n",
+    "    #print(pauli_list)\n",
+    "\n",
+    "    wf_overlap = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    collect_overlap_real = []\n",
+    "    collect_overlap_img = []\n",
+    "\n",
+    "    count=0\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "            \n",
+    "            count_id=count%2\n",
+    "            #print(count_id)\n",
+    "            collect_overlap_real.append(cudaq.observe_async(qfd_kernel, x_0, dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec, qpu_id=count_id))\n",
+    "            \n",
+    "            collect_overlap_img.append(cudaq.observe_async(qfd_kernel, y_0, dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec, qpu_id=count_id+2))\n",
+    "            count += 1\n",
+    "\n",
+    "    tot_dim = 0\n",
+    "\n",
+    "    for n in range(m_qfd):\n",
+    "        for m in range(n,m_qfd):\n",
+    "            observe_result = collect_overlap_real[tot_dim].get()\n",
+    "            real_val = observe_result.expectation()  \n",
+    "        \n",
+    "            observe_result=collect_overlap_img[tot_dim].get()\n",
+    "            img_val=observe_result.expectation() \n",
+    "        \n",
+    "            wf_overlap[m, n] = real_val + img_val * 1j\n",
+    "            if n != m:\n",
+    "                wf_overlap[n, m] = np.conj(wf_overlap[m, n])\n",
+    "            \n",
+    "            tot_dim += 1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Compute the matrix Hamiltonian\n",
+    "\n",
+    "\n",
+    "## Single GPU:\n",
+    "if not multi_gpu:\n",
+    "    ham_matrx = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "\n",
+    "            tot_e = np.zeros(2)\n",
+    "            for coef, word in zip(coefficient, pauli_string):\n",
+    "                #print(coef,word)\n",
+    "\n",
+    "                pauli_list = pauli_str(word, qubits_num)\n",
+    "                #print(pauli_list)\n",
+    "\n",
+    "                results = cudaq.observe(qfd_kernel, [x_0, y_0], dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec)\n",
+    "\n",
+    "                temp = [result.expectation() for result in results]\n",
+    "                #print(temp)\n",
+    "                temp[0] = coef.real * temp[0]\n",
+    "                temp[1] = coef.imag * temp[1]\n",
+    "\n",
+    "                tot_e[0] += temp[0]\n",
+    "                tot_e[1] += temp[1]\n",
+    "\n",
+    "            ham_matrx[m, n] = tot_e[0] + tot_e[1] * 1j\n",
+    "            if n != m:\n",
+    "                ham_matrx[n, m] = np.conj(ham_matrx[m, n])\n",
+    "else:\n",
+    "    ## Multi-GPU\n",
+    "\n",
+    "    ham_matrx = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "\n",
+    "            ham_matrix_real = []\n",
+    "            ham_matrix_imag = []\n",
+    "            \n",
+    "            count=0\n",
+    "            tot_e = np.zeros(2)\n",
+    "            for coef, word in zip(coefficient, pauli_string):\n",
+    "                count_id=count%2\n",
+    "                #print(coef,word)\n",
+    "\n",
+    "                pauli_list = pauli_str(word, qubits_num)\n",
+    "                #print(pauli_list)\n",
+    "\n",
+    "                ham_matrix_real.append(cudaq.observe_async(qfd_kernel, x_0, dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec, qpu_id=count_id))\n",
+    "                ham_matrix_imag.append(cudaq.observe_async(qfd_kernel, y_0, dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec, qpu_id=count_id+2))\n",
+    "\n",
+    "                count += 1\n",
+    "            \n",
+    "            i = 0\n",
+    "            for coef in coefficient:\n",
+    "                \n",
+    "                observe_result = ham_matrix_real[i].get()\n",
+    "                real_val = observe_result.expectation()  \n",
+    "        \n",
+    "                observe_result=ham_matrix_imag[i].get()\n",
+    "                img_val=observe_result.expectation() \n",
+    "                \n",
+    "                tot_e[0] += real_val * coef.real \n",
+    "                tot_e[1] += img_val * coef.imag\n",
+    "                \n",
+    "                i+=1\n",
+    "            \n",
+    "            ham_matrx[m, n] = tot_e[0] + tot_e[1] * 1j\n",
+    "            if n != m:\n",
+    "                ham_matrx[n, m] = np.conj(ham_matrx[m, n])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Diagonalize the matrix\n",
+    "\n",
+    "\n",
+    "def eig(H, s):\n",
+    "    #Solver for generalized eigenvalue problem\n",
+    "\n",
+    "    # HC = SCE\n",
+    "\n",
+    "    THRESHOLD = 1e-20\n",
+    "    s_diag, u = scipy.linalg.eig(s)\n",
+    "    s_prime = []\n",
+    "    for sii in s_diag:\n",
+    "        if np.imag(sii) > 1e-7:\n",
+    "            raise ValueError(\n",
+    "                \"S may not be hermitian, large imag. eval component.\")\n",
+    "        if np.real(sii) > THRESHOLD:\n",
+    "            s_prime.append(np.real(sii))\n",
+    "\n",
+    "    X_prime = np.zeros((len(s_diag), len(s_prime)), dtype=complex)\n",
+    "\n",
+    "    for i in range(len(s_diag)):\n",
+    "        for j in range(len(s_prime)):\n",
+    "            X_prime[i][j] = u[i][j] / np.sqrt(s_prime[j])\n",
+    "\n",
+    "    H_prime = (((X_prime.conjugate()).transpose()).dot(H)).dot(X_prime)\n",
+    "    e_prime, C_prime = scipy.linalg.eig(H_prime)\n",
+    "    C = X_prime.dot(C_prime)\n",
+    "\n",
+    "    return e_prime, C"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Energy from QFD:\n",
+      "(-1.1367554712424826+3.373828079812224e-20j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "eigen_value, eigen_vect = eig(ham_matrx[0:m_qfd, 0:m_qfd], wf_overlap[0:m_qfd,\n",
+    "                                                                      0:m_qfd])\n",
+    "print('Energy from QFD:')\n",
+    "print(np.min(eigen_value))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/Shors.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/Shors.ipynb.txt
new file mode 100644
index 0000000000..dbfff32498
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/Shors.ipynb.txt
@@ -0,0 +1,987 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "628c747b-084c-4fb6-843e-7c7f4cbf07a1",
+   "metadata": {},
+   "source": [
+    "# Factoring Integers With Shor's Algorithm"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6d0627c4-95bd-47b9-9ab5-e8374d25508e",
+   "metadata": {},
+   "source": [
+    "The most famous application of quantum computers is factoring integers using Shor's algorithm. This algorithm is particularly significant because an efficient factorization algorithm could potentially break modern asymmetric encryption schemes, such as RSA.\n",
+    "\n",
+    "For small integers, this quantum algorithm can be simulated on classical computers. The main challenge in classical implementation lies in the order-finding algorithm. We will first introduce the classical implementation of this algorithm as a preliminary step, and then proceed to explain the quantum order-finding algorithm.\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "148568d8",
+   "metadata": {},
+   "source": [
+    "First let's install some libraries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "486fb3d4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install contfrac"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 156,
+   "id": "88619b35-624e-4853-8d2e-6d9952390e5e",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "from math import gcd, log2, ceil\n",
+    "import numpy as np\n",
+    "import random\n",
+    "import cudaq\n",
+    "from cudaq import *\n",
+    "import fractions\n",
+    "import matplotlib.pyplot as plt\n",
+    "import contfrac\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c8523c6f-d729-4d5e-8df9-1780c343a58e",
+   "metadata": {},
+   "source": [
+    "## Shor's algorithm\n",
+    "The factoring problem for an integer $N$ aims to find integers $a_1$, $a_2$ which are factors of $N$.  This problem is interesting when $N$ is not prime and the solutions $a_1$ and $a_2$ are non-trivial.  In other words, we will attempt to find integers $a_1$ and $a_2$ satisfying $N=a_1\\cdot a_2$ with $a_1\\neq 1$ and $a_2\\neq 1$.\n",
+    "\n",
+    "The algorithm consists of two ideas:\n",
+    "\n",
+    "* Reduce the problem of factoring the integer $N$ to the order-finding problem.\n",
+    "* Solve the order-finding problem: \n",
+    "Given integers $a$ and $N$ so that $a$ and $N$ share no common factors (i.e., the greatest common divisor of $a$ and $N$ is 1), find the smallest positive integer which satisfies $a^r \\equiv 1 \\mod N$.  This value $r$ is refered to as the *order of* $a \\mod N$.\n",
+    "\n",
+    "These two ideas are combined in the following steps in Shor's algorithm:\n",
+    "\n",
+    "0. Rule out the easy case that $N$ is even\n",
+    "1. Select a random integer $a$ between $2$ and $N-1$\n",
+    "2. Check to see if $a$ is a factor of $N$ (if so we're done!)\n",
+    "3. Find the order of $a \\mod N$, (i.e., find $r$ so that $a^r\\equiv 1 \\mod N$)\n",
+    "4. Check to see if $a^{\\frac{r}{2}}-1$ or $a^{\\frac{r}{2}}+1$ are integers and share common, non-trivial, divisors with $N$ (if so we're done!)\n",
+    "5. If no factor is found, repeat steps 1 through 4 above.\n",
+    "\n",
+    "The function `shors_algorithm` below outlines these steps for both the classical and the quantum implementation of Shor's algorithm. For the purposes of demonstration, we will also control the initial random integer selected in step 1 so that we can investigate cases in which the selected integer produces common divisors of $N$ in step 4 and others in which step 4 produces no common factors.\n",
+    "\n",
+    "\n",
+    "**Note about terminology:** Some literature refers to the \"period-finding problem\" in Shor's algorithm.  The order-finding problem, as we have described above, can be recast as finding the period of the function $f(x) = a^x\\mod N$, by noticing that the period of $f(x)$ is one more than the order of $a\\mod N$. The period finding problem is more general than the order-finding problem since it aims to find the period of any periodic function, not just modular exponentiation.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "7dd05729",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def shors_algorithm(N, initial, quantum):\n",
+    "    \"\"\" Factor N using Shor's algorithm with initial starting value and choice of \n",
+    "    using either classical or quantum approach for the period finding step\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    N: int \n",
+    "        Integer to be factored (assumed to be non-prime and >1)\n",
+    "    initial: int \n",
+    "        Initial choice of the random integer between 2 and N-1\n",
+    "    quantum: boolean\n",
+    "        True if we will call the quantum order-finding algorithm, and false if we call the classical one for step 3.   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    a1, a2: int\n",
+    "        Non-trivial factors of N\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # 0. Check to see if N is even.\n",
+    "    if N % 2 == 0:\n",
+    "        divisor1 = 2\n",
+    "        divisor2 = N // 2\n",
+    "        print(\"Found factors:\", divisor1, divisor2)\n",
+    "        return (divisor1, divisor2)\n",
+    "\n",
+    "    attempts = [initial]\n",
+    "    while (True):\n",
+    "        # 1. Select a random integer between 2 and N-1\n",
+    "        if len(attempts) == 1:\n",
+    "            a = initial\n",
+    "        else:\n",
+    "            a = random.choice(\n",
+    "                [n for n in range(N - 1) if n not in attempts and n != 1])\n",
+    "\n",
+    "        # 2. See if the integer selected in step 1 happens to factor N\n",
+    "        print(\"Trying a =\", a)\n",
+    "        divisor1 = gcd(a, N)\n",
+    "        if divisor1 != 1:\n",
+    "            divisor2 = N // divisor1\n",
+    "            print(\"Found factors of N={} by chance: {} and {}\".format(N, divisor1, divisor2))\n",
+    "            return (divisor1, divisor2)\n",
+    "\n",
+    "        # 3. Find the order of a mod N (i.e., r, where a^r = 1 (mod N))\n",
+    "        if quantum == True:\n",
+    "            r = find_order_quantum(a, N)\n",
+    "        else:\n",
+    "            r = find_order_classical(a, N)\n",
+    "        print(\"The order of a = {} is {}\".format(a,r))\n",
+    "\n",
+    "        # 4. If the order of a is found and it is\n",
+    "        # * even and\n",
+    "        # * not a^(r/2) = -1 (mod N),\n",
+    "        # then test a^(r/2)-1 and a^(r/2)+1 to see if they share factors with N.\n",
+    "        # We also want to rule out the case of finding the trivial factors: 1 and N.\n",
+    "        divisor1, divisor2 = test_order(a, r, N)\n",
+    "        if (divisor1 != 0):  # test_order will return a 0 if no factor is found\n",
+    "            print(\"Found factors of N = {}: {} and {}\".format(N,divisor1, divisor2))\n",
+    "            return divisor1, divisor2\n",
+    "\n",
+    "        # 5. Repeat\n",
+    "        print(\"retrying...\")\n",
+    "        attempts.append(a)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ed682e81",
+   "metadata": {},
+   "source": [
+    "Let's first explore the idea of reducing the factoring problem into the order-finding problem. This gets captured in step 4 described above.  In this step, we have already established that $a$ and $N$ share no factors other than $1$ (i.e., $\\gcd(a,N)=1$) and we have found $r$, the order of $a\\mod N.$  With this information we know that $a^r \\equiv 1 \\mod N.$  Rewritten in another way:\n",
+    "$$\n",
+    "a^r -1 \\equiv 0\\mod N\n",
+    "\\tag{1}.\n",
+    "$$ \n",
+    " \n",
+    " If $r$ is even, we can rewrite $a^r$ as $x^2$ where $x=a^\\frac{r}{2}$. Next, we can factor equation $(1)$ using the identity $x^2-1 = (x-1)(x+1)$:\n",
+    " $$ \n",
+    " (a^{\\frac{r}{2}} - 1)(a^{\\frac{r}{2}} + 1) \\equiv 0\\mod N\n",
+    "\\tag{2}.\n",
+    "$$  \n",
+    "\n",
+    "If, in addition, the equation\n",
+    "$$\n",
+    "a^{\\frac{r}{2}}  \\not\\equiv -1\\mod N\n",
+    "\\tag{3}\n",
+    "$$\n",
+    "is satisfied, then  at least one of the terms $a^{\\frac{r}{2}} - 1$ or $a^{\\frac{r}{2}} + 1$ must share a common factor with $N$. [Peter Shor](https://arxiv.org/abs/quant-ph/9508027) demonstrated that there is greater than a $50\\%$ chance of randomly selecting a value for $a$ satisfying these properties.\n",
+    "\n",
+    "The code block below defines a function that tests whether $r$ is even and whether equation $(3)$ is satisfied and searches for a non-trivial factor of $N$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 157,
+   "id": "6c8eed12",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def test_order(a, r, N):\n",
+    "    \"\"\"Checks whether or not a^(r/2)+1 or a^(r/2)-1 share a non-trivial common factor with N\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "    r: int\n",
+    "    N: int\n",
+    "    \n",
+    "    Returns\n",
+    "    -------\n",
+    "    int, int factors of N, if found; 0,0 otherwise  \n",
+    "    \"\"\"\n",
+    "\n",
+    "    if r != None and (r % 2 == 0) and a**r % N == 1:\n",
+    "        if (a**(int(r / 2))) % N != -1:\n",
+    "            possible_factors = [gcd(r - 1, N), gcd(r + 1, N)]\n",
+    "            for test_factor in possible_factors:\n",
+    "                if test_factor != 1 and test_factor != N:\n",
+    "                    return test_factor, N // test_factor\n",
+    "    # period did not produce a factor\n",
+    "    else:\n",
+    "        print('No non-trivial factor found')\n",
+    "        return 0, 0\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a43af433-905c-4070-94b3-0f6be6f67f6b",
+   "metadata": {},
+   "source": [
+    "### Solving the order-finding problem classically\n",
+    "\n",
+    "The key component of Shor's algorithm is an efficient quantum algorithm to find the order $r$ of $a \\mod N$. While a straightforward classical algorithm can solve this problem, it is notably inefficient:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 158,
+   "id": "14f4b0d8",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_order_classical(a, N):\n",
+    "    \"\"\"A naive classical method to find the order r of a (mod N).\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "        an integer in the interval [2,N-1]\n",
+    "    N: int\n",
+    "    \n",
+    "    Returns\n",
+    "    -------\n",
+    "    r: int \n",
+    "        Period of a^x (mod N)\n",
+    "    \"\"\"\n",
+    "    assert 1 < a and a < N\n",
+    "    r = 1\n",
+    "    y = a\n",
+    "    while y != 1:\n",
+    "        y = y * a % N\n",
+    "        r += 1\n",
+    "    return r"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "aae6b36d",
+   "metadata": {},
+   "source": [
+    "Let's see how Shor's algorithm works on a few examples using the classical order-finding problem.  Notice how often our choice of value for the initial guess for $a$ produces factors of $N$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 159,
+   "id": "3f75b314-9f0c-40c5-a7bc-58ae235fc183",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Trying a = 42\n",
+      "Found factors of N=123 by chance: 3 and 41\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "(3, 41)"
+      ]
+     },
+     "execution_count": 159,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "my_integer = 123  #edit this value to try out a few examples\n",
+    "# Edit the value in the line below to try out different initial guesses for a.\n",
+    "# What happens when you choose a = 42 for the integer 123?\n",
+    "# What happens when you choose a = 100 for the integer 123?\n",
+    "initial_value_to_start = 42  # edit this value; it should be less than my_integer\n",
+    "\n",
+    "shors_algorithm(my_integer, initial_value_to_start, False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "275efced-b10e-4438-9b5e-f3534079304b",
+   "metadata": {},
+   "source": [
+    "### Solving the order-finding problem with a quantum algorithm\n",
+    "\n",
+    "\n",
+    "The Fourier transform is a classical computation that provides a more efficient algorithm than the one encoded in `find_order_classical` for identifying the period of $f(x) = a^x\\mod N$. The quantum version of the Fourier transform is the central idea of Shor's Algorithm. This efficient quantum solution derives the period from a measurement of $n = \\lceil log2(N) \\rceil$ qubits. \n",
+    "\n",
+    "The image below outlines the quantum kernel used to find the order of $a$. Notice the last step involves applying the Inverse Quantum Fourier Transform."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "aba9fbd7",
+   "metadata": {},
+   "source": [
+    "![](images/shor_circuit.png)\n",
+    "\n",
+    "Figure. Circuit diagram for finding the phase of the modular multiplication gate $U|x\\rangle = |a^x\\mod N\\rangle $, which will be used to compute the order of $a$ modulo $N$.  The number of qubits in the control register determines the accuracy of estimating the phase of $U$. The size of the work register depends on $N$. The goal of this section is to code the  diagram as a kernel named `phase_kernel`. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d7eff3b6",
+   "metadata": {},
+   "source": [
+    "We will need to create a quantum kernel for the Inverse Quantum Fourier Transform.  Additionally we'll need to create a kernel for modular multiplication: $g(y) = ay \\mod N$, which can be repeatedly applied $x$-times to $y=1$ to carry our modular exponentation $f(x)=a^x\\mod N$."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "567e104e",
+   "metadata": {},
+   "source": [
+    "#### Inverse quantum Fourier transform\n",
+    "In the code block below we define a kernel for the quantum Fourier transform and then use `cudaq.adjoint` to create a kernel for the inverse quantum Fourier transform used in the quantum order-finding algorithm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 160,
+   "id": "0e04a0a4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define kernels for the quantum Fourier transform and the inverse quantum Fourier transform\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform(qubits: cudaq.qview):\n",
+    "    qubit_count = len(qubits)\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def inverse_qft(qubits: cudaq.qview):\n",
+    "    cudaq.adjoint(quantum_fourier_transform, qubits)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39db9e6a",
+   "metadata": {},
+   "source": [
+    "#### Quantum kernels for modular exponentiation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b8b8884",
+   "metadata": {},
+   "source": [
+    "\n",
+    "While Shor's algorithm provably can factor numbers faster than known classical techniques, the resources required for implementing Shor's algorithm are hefty. A full-scale implementation to factor an $L$-bit number could require a quantum kernel with $5L+1$ qubits to achieve accuracy for the continued fractions part of the algoirthm and as many as $72L^3$ quantum gates for the modular exponentiaion [(Beckman, Chari, Devabhaktuni, & Preskill, 1996)](https://arxiv.org/pdf/quant-ph/9602016).  Both of these are well beyond the capabilities of modern quantum hardware for numbers of interest. Advancements to reduce the number of gates and qubits required focus on optimizing the kernel for $f(x) = a\\cdot x \\mod N$ for properties of the number to be factored. The difficulty is to create efficient quantum kernels (in terms of qubit and gate count) that compute $a\\cdot x \\mod{N}$.  \n",
+    "\n",
+    "For the purposes of this demonstration, we will consider only the order-finding problem for the values of $a$ to be either $4$ or $5$ with $N=21$. We'll be using the quantum circuits depicted in [this paper](https://arxiv.org/abs/2103.13855) and [this report](https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf), respectively. \n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a48d6fa1",
+   "metadata": {},
+   "source": [
+    "##### The case N = 21 and a = 5:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 161,
+   "id": "c4b8e2e4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def modular_mult_5_21(work: cudaq.qview):\n",
+    "    \"\"\"\"Kernel for multiplying by 5 mod 21\n",
+    "    based off of the circuit diagram in \n",
+    "    https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf\n",
+    "    Modifications were made to change the ordering of the qubits\"\"\"\n",
+    "    x(work[0])\n",
+    "    x(work[2])\n",
+    "    x(work[4])\n",
+    "    \n",
+    "    swap(work[0], work[4])\n",
+    "    swap(work[0], work[2])\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def modular_exp_5_21(exponent: cudaq.qview, work: cudaq.qview,\n",
+    "                     control_size: int):\n",
+    "    \"\"\" Controlled modular exponentiation kernel used in Shor's algorithm\n",
+    "    |x> U^x |y> = |x> |(5^x)y mod 21>\n",
+    "    \"\"\"\n",
+    "    x(work[0])\n",
+    "    for exp in range(control_size):\n",
+    "        ctrl_qubit = exponent[exp]\n",
+    "        for _ in range(2**(exp)):\n",
+    "            cudaq.control(modular_mult_5_21, ctrl_qubit, work)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0c644786",
+   "metadata": {},
+   "source": [
+    "Verify in the code block below that the kernels defined above do in fact carry out multiplication and exponentiation with $a=5$ and $N=21$ by changing the `iterations` variable below. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 198,
+   "id": "e93fcf39",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮      \n",
+      "q0 : ┤ x ├┤ x ├─╳──╳─\n",
+      "     ╰───╯╰───╯ │  │ \n",
+      "q1 : ───────────┼──┼─\n",
+      "     ╭───╮      │  │ \n",
+      "q2 : ┤ x ├──────┼──╳─\n",
+      "     ╰───╯      │    \n",
+      "q3 : ───────────┼────\n",
+      "     ╭───╮      │    \n",
+      "q4 : ┤ x ├──────╳────\n",
+      "     ╰───╯           \n",
+      "\n",
+      "Measurement results from sampling: { 10100:200 }\n",
+      "\n",
+      "For x = 1, 5^x mod 21 = 5\n",
+      "For x = 1, the computed result of the circuit is 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Demonstrate iterated application of 5y mod 21 where y = 1\n",
+    "@cudaq.kernel\n",
+    "def demonstrate_mod_exponentiation(iterations: int):\n",
+    "    qubits = cudaq.qvector(5)\n",
+    "    x(qubits[0]) # initalizes the qubits in the state for y = 1 which is |10000>\n",
+    "    for _ in range(iterations):\n",
+    "        modular_mult_5_21(qubits)\n",
+    "\n",
+    "\n",
+    "shots = 200\n",
+    "\n",
+    "# The iterations variable determines the exponent in 5^x mod 21. \n",
+    "# Change this value to verify that the demonstrate_mod_exponentiation\n",
+    "# kernel carries out the desired calculation.\n",
+    "iterations = 1  \n",
+    "\n",
+    "print(cudaq.draw(demonstrate_mod_exponentiation, iterations))\n",
+    "\n",
+    "results = cudaq.sample(demonstrate_mod_exponentiation,\n",
+    "                       iterations,\n",
+    "                       shots_count=shots)\n",
+    "\n",
+    "print(\"Measurement results from sampling:\", results)\n",
+    "\n",
+    "# Reverse the order of the most probable measured bit string\n",
+    "# and convert the binary string to an integer\n",
+    "integer_result = int(results.most_probable()[::-1],2)\n",
+    "\n",
+    "print(\"For x = {}, 5^x mod 21 = {}\".format(iterations, (5**iterations) % 21))\n",
+    "print(\"For x = {}, the computed result of the circuit is {}\".format(\n",
+    "    iterations, integer_result))\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ff07579c",
+   "metadata": {},
+   "source": [
+    "##### The case N = 21 and a = 4:\n",
+    "\n",
+    "The example below is one where the work register has been optimized to use fewer gates and qubits than would have been necessary through a straightforward implementation of modular multiplication as seen in the previous case."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 199,
+   "id": "69963075",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def modular_exp_4_21(exponent: cudaq.qview, work: cudaq.qview):\n",
+    "    \"\"\" Controlled modular exponentiation kernel used in Shor's algorithm\n",
+    "     |x> U^x |y> = |x> |(4^x)y mod 21>\n",
+    "     based off of the circuit diagram in https://arxiv.org/abs/2103.13855\n",
+    "     Modifications were made to account for qubit ordering differences\"\"\"\n",
+    "    swap(exponent[0], exponent[2])\n",
+    "    # x = 1\n",
+    "    x.ctrl(exponent[2], work[1])\n",
+    "\n",
+    "    # x = 2\n",
+    "    x.ctrl(exponent[1], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    x.ctrl([exponent[1], work[0]], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "\n",
+    "    # x = 4\n",
+    "    x(work[1])\n",
+    "    x.ctrl([exponent[0], work[1]], work[0])\n",
+    "    x(work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    x.ctrl([exponent[0], work[0]], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    swap(exponent[0], exponent[2])\n",
+    "    "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "84a197e2",
+   "metadata": {},
+   "source": [
+    "Now we are ready to define the `phase_kernel` to carry out the instructions in the circuit diagram drawn at the beginning of this section."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 200,
+   "id": "206bcac3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def phase_kernel(control_register_size: int, work_register_size: int, a: int,\n",
+    "                 N: int):\n",
+    "    \"\"\" \n",
+    "    Kernel to estimate the phase of the modular multiplication gate |x> U |y> = |x> |a*y mod 21> for a = 4 or 5\n",
+    "    \"\"\"\n",
+    "\n",
+    "    qubits = cudaq.qvector(control_register_size + work_register_size)\n",
+    "    control_register = qubits[0:control_register_size]\n",
+    "    work_register = qubits[control_register_size:control_register_size +\n",
+    "                           work_register_size]\n",
+    "\n",
+    "    h(control_register)\n",
+    "\n",
+    "    if a == 4 and N == 21:\n",
+    "        modular_exp_4_21(control_register, work_register)\n",
+    "    if a == 5 and N == 21:\n",
+    "        modular_exp_5_21(control_register, work_register, control_register_size)\n",
+    "\n",
+    "    inverse_qft(control_register)\n",
+    "\n",
+    "    # Measure only the control_register and not the work_register\n",
+    "    mz(control_register)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 201,
+   "id": "ca9b570a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮                                                                    »\n",
+      "q0 : ┤ h ├──●────●────●───●──●────────────────────────────────────────────────»\n",
+      "     ├───┤  │    │    │   │  │                                                »\n",
+      "q1 : ┤ h ├──┼────┼────┼───┼──┼───●────●────●───●──●───●────●────●───●──●──────»\n",
+      "     ├───┤  │    │    │   │  │   │    │    │   │  │   │    │    │   │  │      »\n",
+      "q2 : ┤ h ├──┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───●──»\n",
+      "     ├───┤╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮»\n",
+      "q3 : ┤ x ├┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├»\n",
+      "     ╰───╯╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯»\n",
+      "q4 : ────────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼──────»\n",
+      "               ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      »\n",
+      "q5 : ──────────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────»\n",
+      "               ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         »\n",
+      "q6 : ─────────────────┼───┼────────────────┼───┼────────────────┼───┼─────────»\n",
+      "                    ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │         »\n",
+      "q7 : ───────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─────────»\n",
+      "                    ╰───╯                ╰───╯                ╰───╯           »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                                                                            »\n",
+      "────────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                            »\n",
+      "────────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                            »\n",
+      "──●────●───●──●───●────●────●───●──●───●────●────●───●──●───●────●────●───●─»\n",
+      "  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │ »\n",
+      "──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳─»\n",
+      "  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │ »\n",
+      "──┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼─»\n",
+      "╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │ »\n",
+      "┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼─»\n",
+      "╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │ »\n",
+      "───────┼───┼────────────────┼───┼────────────────┼───┼────────────────┼───┼─»\n",
+      "     ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │ »\n",
+      "─────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─»\n",
+      "     ╰───╯                ╰───╯                ╰───╯                ╰───╯   »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                           ╭─────────────╮╭────────────╮╭───╮\n",
+      "───────────────────────────┤ r1(-0.7854) ├┤ r1(-1.571) ├┤ h ├\n",
+      "        ╭────────────╮╭───╮╰──────┬──────╯╰─────┬──────╯╰───╯\n",
+      "────────┤ r1(-1.571) ├┤ h ├───────┼─────────────●────────────\n",
+      "   ╭───╮╰─────┬──────╯╰───╯       │                          \n",
+      "─●─┤ h ├──────●───────────────────●──────────────────────────\n",
+      " │ ╰───╯                                                     \n",
+      "─╳───────────────────────────────────────────────────────────\n",
+      " │                                                           \n",
+      "─┼───────────────────────────────────────────────────────────\n",
+      " │                                                           \n",
+      "─╳───────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "─────────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "─────────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "\n",
+      "Measurement results for a=5 and N=21 with 3 qubits in the control register \n",
+      "{ 000:2843 010:913 111:1850 001:1935 011:1830 100:2846 101:1861 110:922 }\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "control_register_size = 3\n",
+    "work_register_size = 5\n",
+    "values_for_a = [4, 5]\n",
+    "idx = 1  # change to 1 to select 5\n",
+    "N = 21\n",
+    "shots = 15000\n",
+    "\n",
+    "print(\n",
+    "    cudaq.draw(phase_kernel, control_register_size, work_register_size,\n",
+    "               values_for_a[idx], N))\n",
+    "\n",
+    "results = cudaq.sample(phase_kernel,\n",
+    "                       control_register_size,\n",
+    "                       work_register_size,\n",
+    "                       values_for_a[idx],\n",
+    "                       N,\n",
+    "                       shots_count=shots)\n",
+    "print(\n",
+    "    \"Measurement results for a={} and N={} with {} qubits in the control register \"\n",
+    "    .format(values_for_a[idx], N, control_register_size))\n",
+    "print(results)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4718d04f",
+   "metadata": {},
+   "source": [
+    "### Determining the order from the measurement results of the phase kernel\n",
+    "\n",
+    "The measurement results from sampling the `phase_kernel` can be used to estimate the phase of the operator $U|x\\rangle = ax\\mod N$. We will only be interested in the most probable non-zero outcomes of the sampling.  Therefore, we'll create a function `top_results` to extract those values."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 202,
+   "id": "9e96846f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def top_results(sample_results, zeros, threshold):\n",
+    "    \"\"\"Function to output the non-zero results whose counts are above the given threshold\n",
+    "    Returns\n",
+    "    -------\n",
+    "        dict[str, int]: keys are bit-strings and values are the respective counts  \n",
+    "    \"\"\"\n",
+    "    results_dictionary = {k: v for k, v in sample_results.items()}\n",
+    "    if zeros in results_dictionary.keys():\n",
+    "        results_dictionary.pop(zeros)\n",
+    "    sorted_results = {\n",
+    "        k: v for k, v in sorted(\n",
+    "            results_dictionary.items(), key=lambda item: item[1], reverse=True)\n",
+    "    }\n",
+    "    top_key = next(iter(sorted_results))\n",
+    "    max_value = sorted_results[top_key]\n",
+    "    top_results_dictionary = {top_key: max_value}\n",
+    "\n",
+    "    for key in sorted_results:\n",
+    "        if results_dictionary[key] > min(threshold, max_value):\n",
+    "            top_results_dictionary[key] = results_dictionary[key]\n",
+    "    return top_results_dictionary"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b55ab5a",
+   "metadata": {},
+   "source": [
+    "Let's see how the `top_results` extracts the top results from the measurement results for a=4 and N=21 with 3 qubits in the control register that we computed above.  One of these top result is likely to be an estimate for the phase of $U$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 203,
+   "id": "cb717231",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'100': 2846,\n",
+       " '001': 1935,\n",
+       " '101': 1861,\n",
+       " '111': 1850,\n",
+       " '011': 1830,\n",
+       " '110': 922,\n",
+       " '010': 913}"
+      ]
+     },
+     "execution_count": 203,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example\n",
+    "top_results(results, '000', 750)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "cda8137a",
+   "metadata": {},
+   "source": [
+    "The algorithm for translating the phase estimate of the operator $U|x\\rangle = ax\\mod N$ into the order of $a \\mod N$ involves continued fractions. The function `find_order_quantum` below carries out this computation.  To learn more about how the phase of $U$ relates to the period of $a \\mod N$, check out these three lectures by Scott Aaronson: lecture [19](https://www.scottaaronson.com/qclec/19.pdf), [20](https://www.scottaaronson.com/qclec/20.pdf), [21](https://www.scottaaronson.com/qclec/21.pdf)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 204,
+   "id": "a562fde9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_order_from_phase(phase, phase_nbits, a, N):\n",
+    "    \"\"\"Uses continued fractions to find the order of a mod N  \n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    phase: int\n",
+    "        Integer result from the phase estimate of U|x> = ax mod N\n",
+    "    phase_nbits: int\n",
+    "        Number of qubits used to estimate the phase\n",
+    "    a: int\n",
+    "        For this demonstration a is either 4 or 5\n",
+    "    N: int\n",
+    "        For this demonstration N = 21\n",
+    "    Returns\n",
+    "    -------\n",
+    "    int: period of a mod N if found, otherwise returns None\n",
+    "    \"\"\"\n",
+    "\n",
+    "    assert phase_nbits > 0\n",
+    "    assert a > 0\n",
+    "    assert N > 0\n",
+    "\n",
+    "    eigenphase = float(phase) / 2**(phase_nbits)\n",
+    "\n",
+    "    f = fractions.Fraction.from_float(eigenphase).limit_denominator(N)\n",
+    "\n",
+    "    if f.numerator == 1:\n",
+    "        return None\n",
+    "    eigenphase = float(f.numerator / f.denominator)\n",
+    "    print('eigenphase is ', eigenphase)\n",
+    "    coefficients_continued_fraction = list(\n",
+    "        contfrac.continued_fraction(eigenphase))\n",
+    "    \n",
+    "    convergents_continued_fraction = list(contfrac.convergents(eigenphase))\n",
+    "    print('convergent sequence of fractions for this eigenphase is', convergents_continued_fraction)\n",
+    "    for r in convergents_continued_fraction:\n",
+    "        print('using the denominators of the fractions in the convergent sequence, testing order =', r[1])\n",
+    "        if a**r[1] % N == 1:\n",
+    "            print('Found order:', r[1])\n",
+    "            return (r[1])\n",
+    "    return None\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "47511fbe",
+   "metadata": {},
+   "source": [
+    "We are now ready to combine all the elements above into a function to find the order of $a$ $\\mod N$ and test it in the factoring algoithm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 205,
+   "id": "7ad0abcf",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_order_quantum(a, N):\n",
+    "    \"\"\"The quantum algorithm to find the order of a mod N, when x = 4 or x =5 and N = 21\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "        For this demonstration a will be either 4 or 5\n",
+    "    N: int\n",
+    "        For this demonstration N will be 21\n",
+    "    Returns\n",
+    "    r: int the period if it is found, or None if no period is found\n",
+    "    -------\n",
+    "    \n",
+    "    \"\"\"\n",
+    "\n",
+    "    if (a == 4 and N == 21) or (a == 5 and N == 21):\n",
+    "        shots = 15000\n",
+    "        if a == 4 and N == 21:\n",
+    "            control_register_size = 3\n",
+    "            work_register_size = 2\n",
+    "        if a == 5 and N == 21:\n",
+    "            control_register_size = 5\n",
+    "            work_register_size = 5\n",
+    "\n",
+    "        #cudaq.set_random_seed(123)\n",
+    "        results = cudaq.sample(phase_kernel,\n",
+    "                               control_register_size,\n",
+    "                               work_register_size,\n",
+    "                               a,\n",
+    "                               N,\n",
+    "                               shots_count=shots)\n",
+    "        print(\"Measurement results:\")\n",
+    "        print(results)\n",
+    "\n",
+    "        # We will want to ignore the all zero result\n",
+    "        zero_result = ''.join(\n",
+    "            [str(elem) for elem in [0] * control_register_size])\n",
+    "        # We'll only consider the top results from the sampling\n",
+    "        threshold = shots * (.1)\n",
+    "        most_probable_bitpatterns = top_results(results, zero_result, threshold)\n",
+    "\n",
+    "        for key in most_probable_bitpatterns:\n",
+    "            # Convert the key bit string into an integer \n",
+    "            # This integer divided by 8 is an estimate for the phase\n",
+    "            reverse_result = key[::-1]\n",
+    "            phase = int(reverse_result, 2)\n",
+    "            \n",
+    "            print(\"Trying nonzero bitpattern from the phase estimation:\", key,\n",
+    "                  \"=\", phase)\n",
+    "            r = get_order_from_phase(phase, control_register_size, a, N)\n",
+    "            if r == None:\n",
+    "                print('No period found.')\n",
+    "\n",
+    "                continue\n",
+    "\n",
+    "            return r\n",
+    "            break\n",
+    "    else:\n",
+    "        print(\n",
+    "            \"A different quantum kernel is required for this choice of a and N.\"\n",
+    "        )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 206,
+   "id": "79927898",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Trying a = 5\n",
+      "Measurement results:\n",
+      "{ 11010:452 11001:92 11101:47 00000:2485 01001:96 00100:131 01011:1747 00101:1654 10101:1736 00110:475 11111:23 01000:50 01101:38 01110:35 01010:420 11110:22 01111:26 00011:50 01100:120 10011:35 00010:25 00001:22 11011:1710 00111:79 11100:113 10001:14 10010:29 10100:129 10110:467 10000:2536 10111:81 11000:61 }\n",
+      "\n",
+      "Trying nonzero bitpattern from the phase estimation: 10000 = 1\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 01011 = 26\n",
+      "eigenphase is  0.8125\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (4, 5), (13, 16)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 5\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 16\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 10101 = 21\n",
+      "eigenphase is  0.65\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (1, 2), (2, 3), (13, 20)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 2\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 3\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 20\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 11011 = 27\n",
+      "eigenphase is  0.8421052631578947\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (5, 6), (16, 19)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 6\n",
+      "Found order: 6\n",
+      "The order of a =5 is 6\n",
+      "Found factors of N = 21: 7 and 3\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "(7, 3)"
+      ]
+     },
+     "execution_count": 206,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "my_integer = 21\n",
+    "initial_value_to_start = 5  # Try replacing 5 with 4\n",
+    "quantum = True\n",
+    "shors_algorithm(my_integer, initial_value_to_start, quantum)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c243a5ee",
+   "metadata": {},
+   "source": [
+    "### Postscript\n",
+    "Recent [work of Oded Regev](https://arxiv.org/abs/2308.06572) improves Shor's Algorithm by reducing the number of gates needed.  You can read more about it [here](https://www.quantamagazine.org/thirty-years-later-a-speed-boost-for-quantum-factoring-20231017/)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "db11e690",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/afqmc.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/afqmc.ipynb.txt
new file mode 100644
index 0000000000..76d62e3014
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/afqmc.ipynb.txt
@@ -0,0 +1,531 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Quantum Enhanced Auxiliary Field Quantum Monte Carlo\n",
+    "\n",
+    "This work was done in collaboration with the Next Generation Computing team at [BASF](https://www.basf.com/global/en.html).\n",
+    "\n",
+    "In this tutorial we implement a quantum-classical hybrid workflow for computing the ground state energies of a strongly interacting molecular system. The algorithm consists of two parts:\n",
+    "\n",
+    "\n",
+    "1. A variational quantum eigensolver that uses the quantum-number-preserving ansatz proposed by [Anselmetti et al. (2021)](https://doi.org/10.1088/1367-2630/ac2cb3) to generate a quantum trial wave function $|\\Psi_T\\rangle$ using CUDA Quantum.\n",
+    "\n",
+    "2. An Auxiliary-Field Quantum Monte Carlo simulation that realizes a classical imaginary time evolution and collects the ground state energy estimates.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Package installs\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermion==1.6.1\n",
+    "!pip install ipie==0.7.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Relevant imports\n",
+    "\n",
+    "import cudaq\n",
+    "\n",
+    "import numpy as np\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "from pyscf import gto, scf, ao2mo, mcscf\n",
+    "\n",
+    "from afqmc_src.vqe_cudaq_qnp import VQE, get_cudaq_hamiltonian\n",
+    "from afqmc_src.utils_ipie import get_coeff_wf, gen_ipie_input_from_pyscf_chk\n",
+    "\n",
+    "from ipie.hamiltonians.generic import Generic as HamGeneric\n",
+    "from ipie.qmc.afqmc import AFQMC\n",
+    "from ipie.systems.generic import Generic\n",
+    "from ipie.trial_wavefunction.particle_hole import ParticleHole\n",
+    "from ipie.analysis.extraction import extract_observable\n",
+    "\n",
+    "from ipie.config import config\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "\n",
+    "# Ipie has recently added GPU support however this remains a bit tricky to use as it requires manual installation of several packages.\n",
+    "# Once this is streamlined, we can set the GPU option to True in the tutorial.\n",
+    "config.update_option(\"use_gpu\", False)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We start by defining the structure of the molecule, the basis set, and its spin. We build the molecule object with PySCF and run a preliminary Hartree-Fock computation. Here we choose as an example a [chelating agent](https://doi.org/10.1021/acs.jctc.3c01375) representing a relevant class of substances industrially produced at large scales. Their use ranges, among the others, from water softeners in cleaning applications, modulators of redox behaviour in oxidative bleaching, scale suppressants, soil remediation and ligands for catalysts. In particular we focus here in a Fe(III)-NTA complex whose structure is given in the file imported below.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define the molecular structure and the basis set for the Fenta molecule.\n",
+    "\n",
+    "atom = \"afqmc_src/geo_fenta.xyz\"\n",
+    "basis = \"cc-pVTZ\"\n",
+    "spin = 1\n",
+    "num_active_orbitals = 5\n",
+    "num_active_electrons = 5\n",
+    "\n",
+    "# You can swap to O3 which is a smaller system and takes less computational resources and time to run.\n",
+    "\n",
+    "atom = \"afqmc_src/geo_o3.xyz\"\n",
+    "basis = \"cc-pVTZ\"\n",
+    "spin = 0\n",
+    "num_active_orbitals = 9\n",
+    "num_active_electrons = 12\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "-224.34048064812262"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# PYSCF helps to build the molecule and run Hartree-Fock.\n",
+    "\n",
+    "# Define the molecule.\n",
+    "molecule = gto.M(atom=atom, spin=spin, basis=basis, verbose=0)\n",
+    "\n",
+    "# Restriced open shell HF.\n",
+    "hartee_fock = scf.ROHF(molecule)\n",
+    "hartee_fock.chkfile = \"afqmc_src/output.chk\"\n",
+    "\n",
+    "# Run Hartree-Fock.\n",
+    "hartee_fock.kernel()\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Hamiltonian preparation for VQE\n",
+    "\n",
+    "Since this molecule contains of around 600 orbitals (which would correspond to 1200 qubits) and 143 total electrons, it is impossible to perform a full VQE with full statevector simulation. Therefore, we need to identify an active space with fewer orbitals and electrons that contribute to the strongly interacting part of the whole molecule. We then run a post Hartree-Fock computation with the PySCF's built-in CASCI method in order to obtain the one-body ($t_{pq}$) and two-body \n",
+    "($V_{prqs}$) integrals that define the molecular Hamiltonian in the active space:\n",
+    "\n",
+    "$$ H= \\sum_{pq}t_{pq}\\hat{a}_{p}^\\dagger \\hat {a}_{q}+\\sum_{pqrs}  V_{prqs}\\hat a_{p}^\\dagger \\hat a_{q}^\\dagger \\hat a_{s}\\hat a_{r} \\tag{1}$$\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from openfermion.transforms import jordan_wigner\n",
+    "from openfermion import generate_hamiltonian\n",
+    "\n",
+    "# Run a CASCI simulation for computing the Hamiltonian in the active space.\n",
+    "casci = mcscf.CASCI(hartee_fock, num_active_orbitals, num_active_electrons)\n",
+    "casci.fix_spin_(ss=(molecule.spin / 2 * (molecule.spin / 2 + 1)))\n",
+    "\n",
+    "\n",
+    "# Executes the kernel to compute the hamiltonian in the active space.\n",
+    "casci.kernel()\n",
+    "\n",
+    "# Compute the one-body (h1) and two-body integrals (tbi) as shown in equation 1.\n",
+    "h1, energy_core = casci.get_h1eff()\n",
+    "\n",
+    "h2 = casci.get_h2eff()\n",
+    "h2_no_symmetry = ao2mo.restore('1', h2, num_active_orbitals)\n",
+    "\n",
+    "# V_pqrs terms in H.\n",
+    "tbi = np.asarray(h2_no_symmetry.transpose(0, 2, 3, 1), order='C')\n",
+    "\n",
+    "# Compute the hamiltonian and convert it to a CUDA-Q operator.\n",
+    "mol_ham = generate_hamiltonian(h1, tbi, energy_core.item())\n",
+    "jw_hamiltonian = jordan_wigner(mol_ham)\n",
+    "hamiltonian, constant_term = get_cudaq_hamiltonian(jw_hamiltonian)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Run VQE with CUDA-Q\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can now execute the VQE algorithm using the quantum number preserving ansatz. At the end of the VQE, we store the final statevector that will be used in the classical AFQMC computation as an initial guess.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Using cudaq optimizer\n",
+      "# Num Params: 16\n",
+      "# Qubits: 18\n",
+      "# N_layers: 1\n",
+      "# Energy after the VQE: -224.3901690611431\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Define some options for the VQE.\n",
+    "options = {\n",
+    " 'n_vqe_layers': 1,\n",
+    " 'maxiter': 100,\n",
+    " 'energy_core': constant_term,\n",
+    " 'return_final_state_vec': True\n",
+    "}\n",
+    "\n",
+    "n_qubits = 2 * num_active_orbitals\n",
+    "\n",
+    "vqe = VQE(n_qubits=n_qubits,\n",
+    " num_active_electrons=num_active_electrons,\n",
+    " spin=spin,\n",
+    " options=options\n",
+    ")\n",
+    "\n",
+    "results = vqe.execute(hamiltonian)\n",
+    "\n",
+    "# Best energy from VQE.\n",
+    "optimized_energy = results['energy_optimized']\n",
+    "\n",
+    "# Final state vector.\n",
+    "final_state_vector = results[\"state_vec\"]\n",
+    "\n",
+    "# Energies during the optimization loop.\n",
+    "vqe_energies = results[\"callback_energies\"]\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Auxiliary Field Quantum Monte Carlo (AFQMC)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "AFQMC is a numerical method for computing relevant properties of strongly interacting molecules. AFQMC is a type of Quantum Monte Carlo method that combines the use of random walks with an auxiliary field to simulate the imaginary-time evolution of a quantum system and drive it to the lowest energy state. This method can provide accurate results for ground-state properties of a wide range of physical systems, including atoms, molecules, and solids. Here we summarize the main features of AFQMC while a detailed introduction to can be found [here](https://www.cond-mat.de/events/correl13/manuscripts/zhang.pdf).\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We consider the electronic Hamiltonian in the second quantization\n",
+    "\\begin{equation}\n",
+    "H = {H}_1 + {H}_2 \n",
+    "=\\sum_{pq} h_{pq} {a}_{p}^{\\dagger} {a}_{q} + \\frac{1}{2} \\sum_{pqrs} v_{pqrs}{a}_{p}^{\\dagger} {a}_r {a}^{\\dagger}_{q} {a}_s \\tag{2}\n",
+    "\\end{equation}\n",
+    "where ${a}_{p}^{\\dagger}$ and ${a}_{q}$ are fermionic creation and annihilation operators of orbitals $p$ and $q$, respectively. The terms $h_{pq} $ and \n",
+    "$v_{pqrs}$ are the matrix elements of the one-body, $H_1$, and two-body, $H_2$, interactions of $H$, respectively. Here, we omit the spin indices for simplicity.\n",
+    "\n",
+    "AFQMC realizes an imaginary time propagation of an initial state (chosen as a Slater determinant) $\\ket{\\Psi_{I}}$ towards the ground state $\\ket{\\Psi_0}$ of a given hamiltonian, $H$, with\n",
+    "\\begin{equation}\n",
+    "\\ket{\\Psi_0} \\sim\\lim_{n \\to \\infty} \\left[ e^{-\\Delta\\tau H  }  \\right]^{n} \\ket{\\Psi_{I}}\n",
+    "\\tag{3}\n",
+    "\\end{equation} \n",
+    "where $\\Delta\\tau$ is the imaginary time step.\n",
+    "\n",
+    "AFQMC relies on decomposing the two-body interactions $H_2$ in terms of sum of squares of one-body operators ${v}_\\gamma$ such that the Hamiltonian ${H}$ becomes\n",
+    "\\begin{equation}\n",
+    "H = v_0 - \\frac{1}{2}\\sum_{\\gamma=1}^{N_\\gamma} {v}_\\gamma^2\n",
+    "\\tag{4}\n",
+    "\\end{equation}\n",
+    "with ${v}_0 = {H}_1 $ and $\n",
+    "{v}_\\gamma = i \\sum_{pq} L^{\\gamma}_{pq} {a}_{p}^{\\dagger}{a}_{q}.\n",
+    "$\n",
+    "The $N_\\gamma$ matrices $L^{\\gamma}_{pq}$ are called Cholesky vectors as they are  obtained via a Cholesky decomposition of the two-body matrix elements \n",
+    "$v_{pqrs}$ via $v_{pqrs} = \\sum_{\\gamma=1}^{N_\\gamma} L^{\\gamma}_{pr} L^{\\gamma}_{qs}$.\n",
+    "\n",
+    "The imaginary time propagation evolves an ensemble of walkers $\\{\\phi^{(n)}\\}$ (that are Slater determinants) and allows one to access observables of the system. For example, the local energy\n",
+    "\\begin{equation}\n",
+    "\\mathcal{E}_{\\text{loc}}(\\phi^{(n)}) = \\frac{\\bra{\\Psi_\\mathrm{T}}H\\ket{\\phi^{(n)}}}{\\braket{\\Psi_\\mathrm{T}| \\phi^{(n)}}}\n",
+    "\\tag{5}\n",
+    "\\end{equation}\n",
+    "defined as the mixed expectation value of the Hamiltonian with the trial wave function $\\ket{\\Psi_\\mathrm{T}}$.\n",
+    "\n",
+    "\n",
+    "The trial wavefunction can be in general a single or a multi-Slater determinant coming from VQE for example. This might help in achieving more accurate ground state energy estimates.\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "The implementation of AFQMC we use here is from [ipie](https://github.com/JoonhoLee-Group/ipie) that supports both CPUs and GPUs and requires the following steps:\n",
+    "\n",
+    "\n",
+    "1. Preparation of the molecular Hamiltonian by performing the Cholesky decomposition\n",
+    "\n",
+    "2. Preparation of the trial state from the VQE wavefunction\n",
+    "\n",
+    "3. Executing AFQMC\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Preparation of the molecular Hamiltonian\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Number of electrons in simulation: (12, 12)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# AFQMC.\n",
+    "\n",
+    "# Generate the input Hamiltonian for ipie from the checkpoint file from pyscf.\n",
+    "ipie_hamiltonian = gen_ipie_input_from_pyscf_chk(hartee_fock.chkfile,\n",
+    "            mcscf=True,\n",
+    "            chol_cut=1e-5)\n",
+    "\n",
+    "\n",
+    "h1e, cholesky_vectors, e0 = ipie_hamiltonian\n",
+    "\n",
+    "\n",
+    "num_basis = cholesky_vectors.shape[1]\n",
+    "num_chol = cholesky_vectors.shape[0]\n",
+    "\n",
+    "\n",
+    "system = Generic(nelec=molecule.nelec)\n",
+    "\n",
+    "\n",
+    "afqmc_hamiltonian = HamGeneric(\n",
+    " np.array([h1e, h1e]),\n",
+    " cholesky_vectors.transpose((1, 2, 0)).reshape((num_basis * num_basis, num_chol)),\n",
+    " e0\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Preparation of the trial wave function\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Build the trial wavefunction from the state vector computed via VQE.\n",
+    "wavefunction = get_coeff_wf(final_state_vector,\n",
+    " n_active_elec=num_active_electrons,\n",
+    " spin=spin\n",
+    ")\n",
+    "\n",
+    "\n",
+    "trial = ParticleHole(wavefunction,\n",
+    " molecule.nelec,\n",
+    " num_basis,\n",
+    " num_dets_for_props=len(wavefunction[0]),\n",
+    " verbose=False\n",
+    ")\n",
+    "\n",
+    "\n",
+    "trial.compute_trial_energy = True\n",
+    "trial.build()\n",
+    "trial.half_rotate(afqmc_hamiltonian)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Setup of the AFQMC parameters\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Here we can choose the input options like the timestep $\\Delta\\tau$, the total number of walkers `num_walkers` and the total number of AFQMC iterations `num_blocks`.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# random seed is 96264512\n",
+      "            Block                   Weight            WeightFactor            HybridEnergy                  ENumer                  EDenom                  ETotal                  E1Body                  E2Body\n",
+      "                0   1.0000000000000000e+02  1.0000000000000000e+02  0.0000000000000000e+00 -2.2440857214519274e+04  1.0000000000000000e+02 -2.2440857214519275e+02 -3.7639365236571126e+02  1.5198508022051851e+02\n",
+      "                1   4.2236163323978462e+02  1.4108003803708052e+03 -1.1705550836048852e+02 -2.2476129978632798e+04  9.9999999999999986e+01 -2.2476129978632804e+02 -3.7647651634374250e+02  1.5171521655741444e+02\n",
+      "                2   1.0031021642240592e+02  3.8270298551287897e+02 -1.1736348706942081e+02 -2.2491539833590265e+04  1.0000000000000001e+02 -2.2491539833590261e+02 -3.7652287235836400e+02  1.5160747402246139e+02\n",
+      "                3   9.9896411716010476e+01  1.0006803820092617e+02 -1.1729991834244650e+02 -2.2498086858011950e+04  1.0000000000000001e+02 -2.2498086858011945e+02 -3.7661217900078998e+02  1.5163131042067059e+02\n",
+      "                4   1.0008819642734720e+02  1.0003952238189274e+02 -1.1741988525943451e+02 -2.2497768126542338e+04  1.0000000000000001e+02 -2.2497768126542334e+02 -3.7677859321228260e+02  1.5180091194685932e+02\n",
+      "                5   9.9996395539611001e+01  1.0010162124437146e+02 -1.1745900551679516e+02 -2.2504859704025963e+04  1.0000000000000003e+02 -2.2504859704025955e+02 -3.7665382466690920e+02  1.5160522762664974e+02\n",
+      "                6   1.0011117020963695e+02  1.0017267435124782e+02 -1.1762740654751367e+02 -2.2514761055266557e+04  1.0000000000000000e+02 -2.2514761055266558e+02 -3.7663824192346226e+02  1.5149063137079673e+02\n",
+      "                7   9.9926957189505018e+01  9.9904869631265882e+01 -1.1757145502349162e+02 -2.2517665690169804e+04  1.0000000000000000e+02 -2.2517665690169804e+02 -3.7662872023157632e+02  1.5145206332987829e+02\n",
+      "                8   9.9902183781120897e+01  9.9910184942535295e+01 -1.1753639400107765e+02 -2.2518490004346189e+04  9.9999999999999986e+01 -2.2518490004346194e+02 -3.7677944704924283e+02  1.5159454700578092e+02\n",
+      "                9   1.0011182782239581e+02  1.0010647250586344e+02 -1.1771801521929217e+02 -2.2513893408438777e+04  1.0000000000000001e+02 -2.2513893408438773e+02 -3.7679469177919265e+02  1.5165575769480495e+02\n",
+      "               10   9.9639946364053955e+01  9.9242085331654422e+01 -1.1742082647888712e+02 -2.2519016506034994e+04  1.0000000000000003e+02 -2.2519016506034987e+02 -3.7690149012513956e+02  1.5171132506478972e+02\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Setup the AFQMC parameters.\n",
+    "afqmc_msd = AFQMC.build(molecule.nelec,\n",
+    " afqmc_hamiltonian,\n",
+    " trial,\n",
+    " num_walkers=100,\n",
+    " num_steps_per_block=25,\n",
+    " num_blocks=10,\n",
+    " timestep=0.005,\n",
+    " stabilize_freq=5,\n",
+    " seed=96264512,\n",
+    " pop_control_freq=5,\n",
+    " verbose=False\n",
+    ")\n",
+    "\n",
+    "\n",
+    "# Run the AFQMC.\n",
+    "afqmc_msd.run(estimator_filename = 'afqmc_src/estimates.0.h5')\n",
+    "afqmc_msd.finalise(verbose=False)\n",
+    "\n",
+    "\n",
+    "# Extract the energies.\n",
+    "qmc_data = extract_observable(afqmc_msd.estimators.filename, \"energy\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "<matplotlib.legend.Legend at 0x7ab848ece110>"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "data": {
+      "image/png": "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H4+8PN0L3KtXr6bpGRERERkfHz9jEIMDVZ8+fSAIAkRRlLaFhoYCgLRdEASoVKqm7yUREREZB+dQGcTgQHXjxo3m7AcRERGZImnIj4GqNgYHKj8/v+bsBxEREZkiDvkZxKBJ6efOnYNarTb4oBcvXkRZWVmDO0VEREQmgkN+BjEoUPXt2xdZWVkGHzQkJATJyckN7hQRERGZCIW95icDVa0MGvITRRH//ve/YWtra9BBS0pKGtUpIiIiMhEKVqgMYVCgevzxx5GQkGDwQUNCQnSe8UdERERminOoDGJQoIqNjW3mbhAREZFJsuTCnobgSulERERUM2nIjxWq2jBQERERUc045GcQBioiIiKqGYf8DMJARURERDWTVkpnhao29Q5U+fm8bZKIiKjN4LIJBql3oPLw8MC0adNw5MiR5ugPERERmRLtwp6lBUA9nprS1tQ7UH3xxRe4d+8e/vKXv6Br165YtmwZUlNTm6NvREREZGzaR89ABMoKjdoVU1bvQDV27Fjs2rULKSkpmDVrFr788kv4+fkhNDQUO3fu5DP8iIiIWhPLSk9J4TyqGjV4UrqbmxvmzZuHc+fOYeXKlfj111/x97//Hd7e3njrrbdQUMCLTkREZPZksopQVcp5VDUxaKV0fTIyMrBlyxZER0fj5s2b+Pvf/46IiAjcvn0by5cvx/Hjx7F3796m7CsREREZg6WtZg4VJ6bXqN6BaufOndi8eTN++eUXdO/eHS+99BImTZoEZ2dnqc2AAQMQHBzclP0kIiIiY1HYAQV3OeRXi3oHqqlTp+K5557D77//joceekhvG29vb7z55puN7hwRERGZAAUX96xLvQNVWloabG1ta21jY2ODJUuWNLhTREREZEL4+Jk61TtQlZWVQalUVtsuCAKsrKygUCiapGNERERkIiy5uGdd6h2onJ2dIQhCjft9fHwwZcoULFmyBDIZn2xDRERk9qQhPwaqmtQ7UEVHR+PNN9/ElClT8PDDDwMATpw4gS1btmDx4sXIzMxEVFQUrKys8K9//avJO0xEREQtjEN+dap3oNqyZQtWrFiBZ599Vto2ZswYPPDAA1i3bh3279+Pjh074t1332WgIiIiag045Feneo/JHT16FH379q22vW/fvjh27BgA4LHHHkNycnLje0dERETGp32eHwNVjeodqHx9fbFx48Zq2zdu3AhfX18AQFZWFtq1a9f43hEREZHxKVihqku9A1VUVBRWrVqF3r17Y/r06Zg+fTr69OmDDz/8ECtWrAAAxMXFYfz48U3WyaSkJERERMDf3x82NjYICAjAkiVLUFJSIrWJjY1FWFgYvLy8YGdnhz59+iAmJqbGY27btg2CIGDs2LF1nr+4uBhvvvkm/Pz8YGVlhU6dOmHTpk1N8dWIiIhMH+dQ1anec6ieeuopJCQkYN26dUhISAAAjBw5Ert27UKnTp0AAP/4xz+atJPx8fFQq9VYt24dunTpggsXLmDGjBnIz89HVFQUAM1QZK9evfDGG2/Aw8MDe/bsQXh4OJycnBAaGqpzvKSkJLz22msYNGiQQed/9tlnkZGRgY0bN6JLly5IS0uDWq1u0u9IRERksiy5sGddBFEURUMbl5aWYsSIEfjss88QGBjYnP2q0wcffIC1a9fi+vXrNbYZPXo0PDw8dKpJKpUKjz/+OKZNm4bDhw8jOzsbu3btqvEYP//8M5577jlcv34dLi4uDeqrUqmEk5MTcnJy4Ojo2KBjEBERGc2ZGGD3S0CXJ4FJXxu7Ny2mPn+/6zXkZ2lpiXPnzjWqc00lJyenzoCjr83SpUvh7u6OiIgIg87z3XffoX///nj//ffRoUMHdO3aFa+99hoKCwtr/ExxcTGUSqXOi4iIyGxp51BxyK9G9Z5DNWnSJL2T0ltSYmIiVq9ejRdffLHGNtu3b0dcXBymTp0qbTty5Ag2btyIDRs2GHyu69ev48iRI7hw4QK+/fZbfPjhh/j666/x0ksv1fiZyMhIODk5SS/tZH0iIiKzxCG/OjXo0TObNm3Cr7/+in79+sHOzk5n/8qVKw0+1sKFC7F8+fJa21y+fBlBQUHS+5SUFIwYMQLPPPMMZsyYofczBw8exNSpU7Fhwwb06NEDAJCbm4vJkydjw4YNaN++vcF9VKvVEAQBMTExcHJyAqD5jn//+9+xZs0a2NjYVPvMokWLMG/ePOm9UqlkqCIiIvMlrZTOClVN6h2oLly4gAcffBAAcOXKFZ19tT2SRp/58+djypQptbbp3Lmz9HtqaiqGDh2KAQMGYP369XrbHzp0CGPGjMGqVasQHh4ubb927RqSkpIwZswYaZt2YrmFhQUSEhIQEBBQ7XheXl7o0KGDFKYAIDg4GKIo4vbt23rnkllZWcHKyqrW70VERGQ2uGxCneodqA4ePNhkJ3dzc4Obm5tBbVNSUjB06FD069cPmzdv1vucwNjYWISGhmL58uWYOXOmzr6goCCcP39eZ9vixYuRm5uLjz76qMYK0sCBA7Fjxw7k5eXB3l6zsNmVK1cgk8ng4+NjUN+JiIjMmnZhz1IGqpo0+OnFiYmJ+OWXX6TJ2fW4WbDeUlJSMGTIEHTs2BFRUVHIzMxEeno60tPTpTYHDx7E6NGj8corr2DcuHHS/nv37gEArK2t0bNnT52Xs7MzHBwc0LNnTygUCgCa4brKla3nn38erq6umDp1Ki5duoTffvsNCxYswLRp0/QO9xEREbU6fPRMneodqLKysvDEE0+ga9euGDVqFNLS0gAAERERmD9/fpN3EAD27duHxMRE7N+/Hz4+PvDy8pJeWlu2bEFBQQEiIyN19j/99NP1OldaWprOY3Ps7e2xb98+ZGdno3///pg4cSLGjBmDjz/+uMm+HxERkUnTzqFSlwFlJbW3baPqtQ4VAISHh+POnTv4/PPPERwcjD///BOdO3fGL7/8gnnz5uHixYvN1VezxXWoiIjIrKlKgXfKb+h6IwmwaRuPl6vP3+96z6Hau3cvfvnll2rzhwIDA3Hz5s36Ho6IiIhMndwSkFkC6lLNsF8bCVT1Ue8hv/z8fNja2lbbfu/ePd7ZRkRE1Fpx6YRa1TtQDRo0CFu3bpXeC4IAtVqN999/H0OHDm3SzhEREZGJUHBxz9rUe8jv/fffxxNPPIGTJ0+ipKQEr7/+Oi5evIh79+7h999/b44+EhERkbFpAxUfP6NXvStUPXv2xJUrV/DYY48hLCwM+fn5ePrpp3HmzBm9C2MSERFRK8ClE2pV7woVADg5OeHNN99s6r4QERGRqdIu7slApVeDAlV2djZOnDiBO3fuSI9v0aq8KCYRERG1EtrHz3DIT696B6rvv/8eEydORF5eHhwdHXWe3ycIAgMVERFRa8Qhv1rVew7V/PnzMW3aNOTl5SE7Oxv379+XXtrHvBAREVErwyG/WtU7UKWkpOCVV17RuxYVERERtVIKVqhqU+9ANXz4cJw8ebI5+kJERESmissm1Krec6hGjx6NBQsW4NKlS3jggQdgaWmps/+pp55qss4RERGRibDkwp61qXegmjFjBgBg6dKl1fYJggCVStX4XhEREZFp4aNnalXvQFV1mQQiIiJqA7hsQq3qPYeKiIiI2iAO+dXK4EA1atQo5OTkSO+XLVuG7Oxs6X1WVha6d+/epJ0jIiIiE8Ehv1oZHKh++eUXFBcXS+/fe+89nXWnysrKkJCQ0LS9IyIiItPAZRNqZXCgEkWx1vdERETUimkX9ixloNKHc6iIiIiobnz0TK0MDlSCIOg8t0+7jYiIiNoAzqGqlcHLJoiiiClTpsDKygoAUFRUhFmzZsHOTnOBK8+vIiIiolZGG6jKCgG1CpDJjdsfE2NwoHrhhRd03k+aNKlam/Dw8Mb3iIiIiEyPZaVn+JYWAFYOxuuLCTI4UG3evLk5+0FERESmzNIGgABA1Az7MVDp4KR0IiIiqpsgVJpHxcU9q2KgIiIiIsNoAxUfP1MNAxUREREZhksn1IiBioiIiAyjXdyTgaoaBioiIiIyjPbxMxzyq4aBioiIiAzDIb8aMVARERGRYaS7/BioqmKgIiIiIsMwUNWIgYqIiIgMw2UTasRARURERIaR5lBxYc+qGKiIiIjIMNKyCaxQVcVARURERIbhsgk1YqAiIiIiw2gfiFyYbdRumCIGKiIiIjKMg5fmZ166cfthghioiIiIyDAOnpqfuQxUVTFQERERkWGkClUGoFYZty8mhoGKiIiIDGPnBggyQFQD+ZnG7o1JYaAiIiIiw8jkgL2H5vfcNOP2xcQwUBEREZHhtPOolAxUlZlFoEpKSkJERAT8/f1hY2ODgIAALFmyBCUlJVKb2NhYhIWFwcvLC3Z2dujTpw9iYmJqPOa2bdsgCALGjh1b5/ljYmLQu3dv2NrawsvLC9OmTUNWVlZTfDUiIiLz4uCt+ckKlQ6zCFTx8fFQq9VYt24dLl68iFWrVuGzzz7Dv/71L6nN0aNH0atXL3zzzTc4d+4cpk6divDwcOzZs6fa8ZKSkvDaa69h0KBBdZ77999/R3h4OCIiInDx4kXs2LEDJ06cwIwZM5r0OxIREZkF3umnlyCKomjsTjTEBx98gLVr1+L69es1thk9ejQ8PDywadMmaZtKpcLjjz+OadOm4fDhw8jOzsauXbtqPEZUVBTWrl2La9euSdtWr16N5cuX4/bt23o/U1xcjOLiYum9UqmEr68vcnJy4OjoWI9vSUREZGIOfQAc/C/QdzIQ9omxe9OslEolnJycDPr7bRYVKn1ycnLg4uJS7zZLly6Fu7s7IiIiDDpPSEgIbt26hR9//BGiKCIjIwNff/01Ro0aVeNnIiMj4eTkJL18fX0NOhcREZHJY4VKL7MMVImJiVi9ejVefPHFGtts374dcXFxmDp1qrTtyJEj2LhxIzZs2GDwuQYOHIiYmBiMHz8eCoUCnp6ecHJywqefflrjZxYtWoScnBzpdevWLYPPR0REZNK0a1FxDpUOowaqhQsXQhCEWl/x8fE6n0lJScGIESPwzDPP1DiP6eDBg5g6dSo2bNiAHj16AAByc3MxefJkbNiwAe3btze4j5cuXcKcOXPw1ltv4dSpU/j555+RlJSEWbNm1fgZKysrODo66ryIiIhaBUcGKn2MOocqMzOzzrvlOnfuDIVCAQBITU3FkCFD8OijjyI6OhoyWfU8eOjQIYwePRorV67EzJkzpe1nz55F3759IZfLpW1qtRoAIJPJkJCQgICAgGrHmzx5MoqKirBjxw5p25EjRzBo0CCkpqbCy8urzu9ZnzFYIiIik1ZwD3jfX/P74juAhZVx+9OM6vP326KF+qSXm5sb3NzcDGqbkpKCoUOHol+/fti8ebPeMBUbG4vQ0FAsX75cJ0wBQFBQEM6fP6+zbfHixcjNzcVHH31U4zyngoICWFjoXiZtKDPT+fxEREQNZ9MOkCsAVYnmETTOHY3dI5Ng1EBlqJSUFAwZMgR+fn6IiopCZmbFcveenprJcQcPHkRoaCjmzJmDcePGIT1dM1lOoVDAxcUF1tbW6Nmzp85xnZ2dAUBn+6JFi5CSkoKtW7cCAMaMGYMZM2Zg7dq1GD58ONLS0jB37lw8/PDD8Pb2bs6vTUREZHoEQTMxPTtZMzGdgQqAmQSqffv2ITExEYmJifDx8dHZp60SbdmyBQUFBYiMjERkZKS0f/DgwYiNjTX4XGlpaUhOTpbeT5kyBbm5ufjkk08wf/58ODs74y9/+QuWL1/euC9FRERkrhy8NIFKmWrsnpgMs12HypxwDhUREbUq28OBS7uBEcuBR2u+ScvctYl1qIiIiMhI+PiZahioiIiIqH64uGc1DFRERERUP1zcsxoGKiIiIqofVqiqYaAiIiKi+mGFqhoGKiIiIqofbYWqWAkU5xm3LyaCgYqIiIjqx9oRUNhrfs/LMG5fTAQDFREREdWfNI+Kw34AAxURERE1hDSPihPTAQYqIiIiaghthYqPnwHAQEVEREQNwaUTdDBQERERUf3x8TM6GKiIiIio/lih0sFARURERPXHxT11MFARERFR/VVeNkEUjdsXE8BARURERPWnDVRlRUBRtlG7YgoYqIiIiKj+LG0Aa2fN75xHxUBFREREDeTIO/20GKiIiIioYXinn4SBioiIiBqGd/pJGKiIiIioYaTHzzBQMVARERFRw7BCJWGgIiIioobRVqhybhu3HyaAgYqIiIgaxqOH5mfGRaC00Lh9MTIGKiIiImqYdv6AvSegLgVunzR2b4yKgYqIiIgaRhAAvwGa35OPGbcvRsZARURERA2nDVQ3fzduP4yMgYqIiIgaThuobsUBqlLj9sWIGKiIiIio4dyCNc/0K80H0s4ZuzdGw0BFREREDSeTcdgPDFRERETUWB1DND/b8MR0BioiIiJqHL+Bmp83jwJqtXH7YiQMVERERNQ4Xr0AS1ugKBvIjDd2b4yCgYqIiIgaR24J+D6s+b2NzqNioCIiIqLG0w77tdF5VAxURERE1Hjaiek3jwKiaNy+GAEDFRERETWeT39AZgnkpgH3k4zdmxbHQEVERESNZ2kDdHhQ8/vNo8btixFYGLsDRERE1Er4DQBu/QFc2g2U5AOpZ4C0PwHXAOCZaEAmN3YPmw0DFRERETUNv4HAkVXA1V80L607F4GMi5rlFVopDvkRERFR0/AbCHj2AuzcgcDhwOCFmvcAcPuEcfvWzMwiUCUlJSEiIgL+/v6wsbFBQEAAlixZgpKSEqlNbGwswsLC4OXlBTs7O/Tp0wcxMTE6x4mOjoYgCDova2vrOs8fGxuLBx98EFZWVujSpQuio6Ob+isSERGZP4UtMOswsOAqMHE7MHQR0HWEZt+tOOP2rZmZxZBffHw81Go11q1bhy5duuDChQuYMWMG8vPzERUVBQA4evQoevXqhTfeeAMeHh7Ys2cPwsPD4eTkhNDQUOlYjo6OSEhIkN4LglDruW/cuIHRo0dj1qxZiImJwf79+zF9+nR4eXlh+PDhzfOFiYiIWgvtgp+3W3egEkTRPBeL+OCDD7B27Vpcv369xjajR4+Gh4cHNm3aBEBToZo7dy6ys7MNPs8bb7yBH374ARcuXJC2Pffcc8jOzsbPP/9s0DGUSiWcnJyQk5MDR0dHg89NRERk9grvA8s7aX5fcB2wczVqd+qjPn+/zWLIT5+cnBy4uLjUu01eXh78/Pzg6+uLsLAwXLx4sdZjHDt2DMOGDdPZNnz4cBw7VvNKsMXFxVAqlTovIiKiNsmmHdC+q+b3VlylMstAlZiYiNWrV+PFF1+ssc327dsRFxeHqVOnStu6deuGTZs2Yffu3fjiiy+gVqsxYMAA3L59u8bjpKenw8PDQ2ebh4cHlEolCgsL9X4mMjISTk5O0svX17ee35CIiKgV8dEO+7XeielGDVQLFy6sNkm86is+Xvep1SkpKRgxYgSeeeYZzJgxQ+9xDx48iKlTp2LDhg3o0aOHtD0kJATh4eHo06cPBg8ejJ07d8LNzQ3r1q1r0u+1aNEi5OTkSK9bt2416fGJiIjMiu9Dmp+3Wm+gMuqk9Pnz52PKlCm1tuncubP0e2pqKoYOHYoBAwZg/fr1etsfOnQIY8aMwapVqxAeHl7rsS0tLdG3b18kJibW2MbT0xMZGRk62zIyMuDo6AgbGxu9n7GysoKVlVWt5yYiImozfMoDVcppQFUGyM3inrh6Meo3cnNzg5ubm0FtU1JSMHToUPTr1w+bN2+GTFa9uBYbG4vQ0FAsX74cM2fOrPOYKpUK58+fx6hRo2psExISgh9//FFn2759+xASEmJQv4mIiNo8tyBA4QCU5AKZlwHPB4zdoyZnFnOoUlJSMGTIEHTs2BFRUVHIzMxEeno60tPTpTYHDx7E6NGj8corr2DcuHHS/nv37kltli5dir179+L69es4ffo0Jk2ahJs3b2L69OlSm0WLFulUtmbNmoXr16/j9ddfR3x8PNasWYPt27fj1VdfbZkvT0REZO5kcsCnn+b3VjrsZxaBat++fUhMTMT+/fvh4+MDLy8v6aW1ZcsWFBQUIDIyUmf/008/LbW5f/8+ZsyYgeDgYIwaNQpKpRJHjx5F9+7dpTZpaWlITk6W3vv7++OHH37Avn370Lt3b6xYsQKff/4516AiIiKqD5/WvR6V2a5DZU64DhUREbV5V/cBMX8HXAKAV04buzcGaRPrUBEREZEZ6VA+5HfvGpCfZdy+NAMGKiIiImp+ti6Aa6Dm95STxu1LM2CgIiIiopahfa5fK5yYzkBFRERELUO7HlUrXDGdgYqIiIhahrZClXIaUKuM25cmxkBFRERELUNa4DMPuHPZ2L1pUgxURERE1DJkcsCj/Bm7mfG1tzUzDFRERETUctqX3+l394px+9HEGKiIiIio5bh10/zMTDBuP5oYAxURERG1nPblgYoVKiIiIqIGcuuq+ZmV2Kru9GOgIiIiopbj5AtYWAOqEuB+krF702QYqIiIiKjlyOQVj6BpRcN+DFRERETUsrTDfq1oYjoDFREREbWsVjgxnYGKiIiIWlYrXIuKgYqIiIhalrQW1RVAFI3blybCQEVEREQty7ULIMiA4hwgL8PYvWkSDFRERETUsiysgHadNL+3konpDFRERETU8tqX3+nXSuZRMVARERFRy2OgIiIiImqkVvaQZAYqIiIianmtbC0qBioiIiJqedq1qHLTgCKlcfvSBBioiIiIqOXZOAP2Hprf7141aleaAgMVERERGYc0Md3851ExUBEREZFxtKKJ6QxUREREZBxShYpDfkREREQN05AhP7UKOLYGyLjYPH1qIAYqIiIiMg7tkN+9G0BZiWGfOfMF8MsiYOeLzdevBmCgIiIiIuNw8AIUDoCoAu5dM+wzF77W/Mw4D9xParau1RcDFRERERmHIABu5cN+t/6ou31uBpB0pOJ9wk/N068GYKAiIiIi4wkeo/n52wqgtKj2tpd2A6IagKB5H/9Ds3atPhioiIiIyHgefhFw8AZykoG4z2tve+Gb8s/M0Py8eRQovN+8/TMQAxUREREZj8IWGLpI8/vhKKAwW3+7nNvAreMABOCxVwH37pq5V1f3tVRPa8VARURERMbV+3nALUhTbTqySn+bi99qfvoNABy9gW6jNO9NZNiPgYqIiIiMS24BDPuP5vc/PtNUo6rSDvf1+JvmpzZQJf4KlBU3exfrwkBFRERExtd1BNBxAFBWBByM1N2XdQ1IPQMIMqD7WM02776AvSdQkgckHW7x7lbFQEVERETGJwjAk0s1v//5JXD114p92uE+/8GAvZvmd5kM6DZS83v8jy3XzxowUBEREZFp8H0I6B6mWRohZhywdSyQcgq4sFOzv+c43fbaYb+EnwBRbNGuVmVh1LMTERERVfbUasDeAzi5Gbh+UPMCAJklEByq29b/ccDSDshN1QwJdniw5ftbjhUqIiIiMh3WTsCoD4CXTwF9JmrmTQFAlycAm3a6bS2tNdsBo6+abhaBKikpCREREfD394eNjQ0CAgKwZMkSlJRUPEgxNjYWYWFh8PLygp2dHfr06YOYmBid40RHR0MQBJ2XtbV1refeuXMnnnzySbi5ucHR0REhISH45ZdfmuV7EhERUbl2fsDYNcBLx4G/LAZGr9TfLmi05meCcedRmcWQX3x8PNRqNdatW4cuXbrgwoULmDFjBvLz8xEVFQUAOHr0KHr16oU33ngDHh4e2LNnD8LDw+Hk5ITQ0IoSoaOjIxISEqT3giDUeu7ffvsNTz75JN577z04Oztj8+bNGDNmDP744w/07du3eb4wERERabh1A9wW1Lw/8K+AIAcgAMV5gJV9i3WtMkEUjTyLq4E++OADrF27FtevX6+xzejRo+Hh4YFNmzYB0FSo5s6di+zs7Eadu0ePHhg/fjzeeustg9orlUo4OTkhJycHjo6OjTo3ERERVZF3B7B3b/LD1ufvt1kM+emTk5MDFxeXerfJy8uDn58ffH19ERYWhosXL9brvGq1Grm5ubWeu7i4GEqlUudFREREzaQZwlR9mWWgSkxMxOrVq/Hiiy/W2Gb79u2Ii4vD1KlTpW3dunXDpk2bsHv3bnzxxRdQq9UYMGAAbt/WsyJrDaKiopCXl4dnn322xjaRkZFwcnKSXr6+vgYfn4iIiMyPUYf8Fi5ciOXLl9fa5vLlywgKCpLep6SkYPDgwRgyZAg+/1z/U6kPHjyI0NBQrF27FuHh4TUeu7S0FMHBwZgwYQLeeeedOvv75ZdfYsaMGdi9ezeGDRtWY7vi4mIUF1csg69UKuHr68shPyIiIjNSnyE/o05Knz9/PqZMmVJrm86dO0u/p6amYujQoRgwYADWr1+vt/2hQ4cwZswYrFq1qtYwBQCWlpbo27cvEhMT6+zrtm3bMH36dOzYsaPWMAUAVlZWsLKyqvOYRERE1DoYNVC5ubnBzc3NoLYpKSkYOnQo+vXrh82bN0Mmqz5aGRsbi9DQUCxfvhwzZ86s85gqlQrnz5/HqFGjam331VdfYdq0adi2bRtGjx5tUH+JiIio7TCLZRNSUlIwZMgQ+Pn5ISoqCpmZmdI+T09PABXDfHPmzMG4ceOQnp4OAFAoFNIE8qVLl+LRRx9Fly5dkJ2djQ8++AA3b97E9OnTpeMtWrQIKSkp2Lp1KwDNMN8LL7yAjz76CI888oh0XBsbGzg5ObXI9yciIiLTZhaT0vft24fExETs378fPj4+8PLykl5aW7ZsQUFBASIjI3X2P/3001Kb+/fvY8aMGQgODsaoUaOgVCpx9OhRdO/eXWqTlpaG5ORk6f369etRVlaG2bNn6xx3zpw5LfPliYiIyOSZ7TpU5oTrUBEREZmfNrEOFREREZGpYKAiIiIiaiQGKiIiIqJGYqAiIiIiaiQGKiIiIqJGYqAiIiIiaiSzWNjT3GlXplAqlUbuCRERERlK+3fbkBWmGKhaQG5uLgDA19fXyD0hIiKi+srNza3z6Shc2LMFqNVqpKamwsHBAYIgNOmxlUolfH19cevWLS4a2ki8lk2D17Hp8Fo2HV7LptOWrqUoisjNzYW3t7feZwhXxgpVC5DJZPDx8WnWczg6Orb6/2C3FF7LpsHr2HR4LZsOr2XTaSvX0tDn9nJSOhEREVEjMVARERERNRIDlZmzsrLCkiVLYGVlZeyumD1ey6bB69h0eC2bDq9l0+G11I+T0omIiIgaiRUqIiIiokZioCIiIiJqJAYqIiIiokZioCIiIiJqJAYqM/bpp5+iU6dOsLa2xiOPPIITJ04Yu0smLzIyEg899BAcHBzg7u6OsWPHIiEhQadNUVERZs+eDVdXV9jb22PcuHHIyMgwUo/Nw7JlyyAIAubOnStt43U0XEpKCiZNmgRXV1fY2NjggQcewMmTJ6X9oijirbfegpeXF2xsbDBs2DBcvXrViD02TSqVCv/+97/h7+8PGxsbBAQE4J133tF5DhuvpX6//fYbxowZA29vbwiCgF27dunsN+S63bt3DxMnToSjoyOcnZ0RERGBvLy8FvwWxsVAZab+97//Yd68eViyZAlOnz6N3r17Y/jw4bhz546xu2bSDh06hNmzZ+P48ePYt28fSktL8de//hX5+flSm1dffRXff/89duzYgUOHDiE1NRVPP/20EXtt2uLi4rBu3Tr06tVLZzuvo2Hu37+PgQMHwtLSEj/99BMuXbqEFStWoF27dlKb999/Hx9//DE+++wz/PHHH7Czs8Pw4cNRVFRkxJ6bnuXLl2Pt2rX45JNPcPnyZSxfvhzvv/8+Vq9eLbXhtdQvPz8fvXv3xqeffqp3vyHXbeLEibh48SL27duHPXv24LfffsPMmTNb6isYn0hm6eGHHxZnz54tvVepVKK3t7cYGRlpxF6Znzt37ogAxEOHDomiKIrZ2dmipaWluGPHDqnN5cuXRQDisWPHjNVNk5WbmysGBgaK+/btEwcPHizOmTNHFEVex/p44403xMcee6zG/Wq1WvT09BQ/+OADaVt2drZoZWUlfvXVVy3RRbMxevRocdq0aTrbnn76aXHixImiKPJaGgqA+O2330rvDbluly5dEgGIcXFxUpuffvpJFARBTElJabG+GxMrVGaopKQEp06dwrBhw6RtMpkMw4YNw7Fjx4zYM/OTk5MDAHBxcQEAnDp1CqWlpTrXNigoCB07duS11WP27NkYPXq0zvUCeB3r47vvvkP//v3xzDPPwN3dHX379sWGDRuk/Tdu3EB6errOtXRycsIjjzzCa1nFgAEDsH//fly5cgUA8Oeff+LIkSMYOXIkAF7LhjLkuh07dgzOzs7o37+/1GbYsGGQyWT4448/WrzPxsCHI5uhu3fvQqVSwcPDQ2e7h4cH4uPjjdQr86NWqzF37lwMHDgQPXv2BACkp6dDoVDA2dlZp62HhwfS09ON0EvTtW3bNpw+fRpxcXHV9vE6Gu769etYu3Yt5s2bh3/961+Ii4vDK6+8AoVCgRdeeEG6Xvr++85rqWvhwoVQKpUICgqCXC6HSqXCu+++i4kTJwIAr2UDGXLd0tPT4e7urrPfwsICLi4ubebaMlBRmzV79mxcuHABR44cMXZXzM6tW7cwZ84c7Nu3D9bW1sbujllTq9Xo378/3nvvPQBA3759ceHCBXz22Wd44YUXjNw787J9+3bExMTgyy+/RI8ePXD27FnMnTsX3t7evJbU7DjkZ4bat28PuVxe7Y6pjIwMeHp6GqlX5uWf//wn9uzZg4MHD8LHx0fa7unpiZKSEmRnZ+u057XVderUKdy5cwcPPvggLCwsYGFhgUOHDuHjjz+GhYUFPDw8eB0N5OXlhe7du+tsCw4ORnJyMgBI14v/fa/bggULsHDhQjz33HN44IEHMHnyZLz66quIjIwEwGvZUIZcN09Pz2o3RZWVleHevXtt5toyUJkhhUKBfv36Yf/+/dI2tVqN/fv3IyQkxIg9M32iKOKf//wnvv32Wxw4cAD+/v46+/v16wdLS0uda5uQkIDk5GRe20qeeOIJnD9/HmfPnpVe/fv3x8SJE6XfeR0NM3DgwGpLd1y5cgV+fn4AAH9/f3h6eupcS6VSiT/++IPXsoqCggLIZLp/1uRyOdRqNQBey4Yy5LqFhIQgOzsbp06dktocOHAAarUajzzySIv32SiMPSueGmbbtm2ilZWVGB0dLV66dEmcOXOm6OzsLKanpxu7aybtH//4h+jk5CTGxsaKaWlp0qugoEBqM2vWLLFjx47igQMHxJMnT4ohISFiSEiIEXttHirf5SeKvI6GOnHihGhhYSG+++674tWrV8WYmBjR1tZW/OKLL6Q2y5YtE52dncXdu3eL586dE8PCwkR/f3+xsLDQiD03PS+88ILYoUMHcc+ePeKNGzfEnTt3iu3btxdff/11qQ2vpX65ubnimTNnxDNnzogAxJUrV4pnzpwRb968KYqiYddtxIgRYt++fcU//vhDPHLkiBgYGChOmDDBWF+pxTFQmbHVq1eLHTt2FBUKhfjwww+Lx48fN3aXTB4Ava/NmzdLbQoLC8WXXnpJbNeunWhrayv+7W9/E9PS0ozXaTNRNVDxOhru+++/F3v27ClaWVmJQUFB4vr163X2q9Vq8d///rfo4eEhWllZiU888YSYkJBgpN6aLqVSKc6ZM0fs2LGjaG1tLXbu3Fl88803xeLiYqkNr6V+Bw8e1Pu/jS+88IIoioZdt6ysLHHChAmivb296OjoKE6dOlXMzc01wrcxDkEUKy0hS0RERET1xjlURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURGQW/vOf/6BPnz6NOkZSUhIEQcDZs2ebpE81GTJkCObOndus5yAi08JARURN4tatW5g2bRq8vb2hUCjg5+eHOXPmICsrq97HEgQBu3bt0tn22muv6TyctSF8fX2RlpaGnj17Nuo4WrGxsRAEAdnZ2Trbd+7ciXfeeadJztEQLRUciagCAxURNdr169fRv39/XL16FV999RUSExPx2WefYf/+/QgJCcG9e/cafQ57e3u4uro26hhyuRyenp6wsLBodH9q4+LiAgcHh2Y9BxGZFgYqImq02bNnQ6FQYO/evRg8eDA6duyIkSNH4tdff0VKSgrefPNNqW2nTp3wzjvvYMKECbCzs0OHDh3w6aef6uwHgL/97W8QBEF6X3XIb8qUKRg7dizee+89eHh4wNnZGUuXLkVZWRkWLFgAFxcX+Pj4YPPmzdJnqlZupkyZAkEQqr1iY2MBAP/3f/+H/v37w8HBAZ6ennj++edx584d6VhDhw4FALRr1w6CIGDKlCkAqg/53b9/H+Hh4WjXrh1sbW0xcuRI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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plot the energies.\n",
+    "\n",
+    "vqe_y = vqe_energies\n",
+    "vqe_x = list(range(len(vqe_y)))\n",
+    "plt.plot(vqe_x, vqe_y, label=\"VQE\")\n",
+    "\n",
+    "afqmc_y = list(qmc_data[\"ETotal\"])\n",
+    "afqmc_x = [i + vqe_x[-1] for i in list(range(len(afqmc_y)))]\n",
+    "plt.plot(afqmc_x, afqmc_y, label=\"AFQMC\")\n",
+    "\n",
+    "plt.xlabel(\"Optimization steps\")\n",
+    "plt.ylabel(\"Energy [Ha]\")\n",
+    "plt.legend()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version proto-0.8.0 (https://github.com/NVIDIA/cuda-quantum 57e1893b9a5b57ef1a1c2662bcf4527f87b9ef89)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/cost_minimization.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/cost_minimization.ipynb.txt
new file mode 100644
index 0000000000..9bef09f466
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/cost_minimization.ipynb.txt
@@ -0,0 +1,220 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Cost Minimization\n",
+    "\n",
+    "Below we start with a basic example of a hybrid variational algorithm which involves flipping the Bloch vector of a qubit from the $\\ket{0}$ to the $\\ket{1}$ state. First we import the relevant packages and set our backend to simulate our workflow on NVIDIA GPUs. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from typing import List\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "                       \n",
+      "q0 : ──────────────────\n",
+      "                       \n",
+      "q1 : ──────────────────\n",
+      "     ╭───────╮╭───────╮\n",
+      "q2 : ┤ rx(0) ├┤ ry(0) ├\n",
+      "     ╰───────╯╰───────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Initialize a kernel/ ansatz and variational parameters.\n",
+    "@cudaq.kernel\n",
+    "def kernel(angles: List[float]):\n",
+    "    # Allocate a qubit that is initialized to the |0> state.\n",
+    "    qubit = cudaq.qubit()\n",
+    "    # Define gates and the qubits they act upon.\n",
+    "    rx(angles[0], qubit)\n",
+    "    ry(angles[1], qubit)\n",
+    "\n",
+    "\n",
+    "# Our Hamiltonian will be the Z expectation value of our qubit.\n",
+    "hamiltonian = cudaq.spin.z(0)\n",
+    "\n",
+    "# Initial gate parameters which intialize the qubit in the zero state\n",
+    "initial_parameters = [0, 0]\n",
+    "\n",
+    "print(cudaq.draw(kernel, initial_parameters))"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We build our cost function such that its minimal value corresponds to the qubit being in the $\\ket{1}$ state. The observe call below allows us to simulate our statevector $\\ket{\\psi}$, and calculate $\\bra{\\psi}Z\\ket{\\psi}$.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cost_values = []\n",
+    "\n",
+    "\n",
+    "def cost(parameters):\n",
+    "    \"\"\"Returns the expectation value as our cost.\"\"\"\n",
+    "    expectation_value = cudaq.observe(kernel, hamiltonian,\n",
+    "                                      parameters).expectation()\n",
+    "    cost_values.append(expectation_value)\n",
+    "    return expectation_value"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "1.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "# We see that the initial value of our cost function is one, demonstrating that our qubit is in the zero state\n",
+    "initial_cost_value = cost(initial_parameters)\n",
+    "print(initial_cost_value)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below we use our built-in optimization suite to minimize the cost function. We will be using the gradient-free COBYLA alogrithm. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define a CUDA-Q optimizer.\n",
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "optimizer.initial_parameters = initial_parameters\n",
+    "\n",
+    "result = optimizer.optimize(dimensions=2, function=cost)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install matplotlib"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {
+    "tags": [
+     "nbsphinx-thumbnail"
+    ]
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Text(0, 0.5, 'Cost Value')"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "data": {
+      "image/png": "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d96JN99802pbQECA9HNUVJTVvqioKBw6dAgAkJmZif79+8PLy0vaP2zYMJjNZpw4cQKCICA7OxvR0dE2a+jXr5/0s5eXF3x8fJCXlwcAmD59OsaMGYODBw8iNjYWCQkJGDp0aIveKxG1LYYlImoXvLy86lwWsxcPD48mHefq6mr1uyAIMJvNAICRI0fi999/x5dffont27cjOjoaM2bMwCuvvGL3eonIvjhmiYicwr59++r83qdPHwBAnz59cPjwYZSWlkr79+7dC5VKhV69esHb2xthYWFIS0u7rhqCgoIwYcIEvPfee1ixYgVWr159XecjorbBzhIRtQsVFRUwGAxW21xcXKRB1Fu2bMHgwYMxfPhwbNy4EQcOHMDatWsBAOPGjUNKSgomTJiAZ555BhcvXsSsWbPwyCOPQKfTAQCeeeYZTJs2DVqtFiNHjkRxcTH27t2LWbNmNam+RYsWYdCgQbjxxhtRUVGBzz//XAprRKRsDEtE1C6kpqYiODjYaluvXr1w/PhxADV3qm3evBmPPfYYgoOD8f777yMiIgIA4Onpif/97394/PHHccstt8DT0xNjxozB8uXLpXNNmDAB5eXlePXVV/Hkk08iMDAQf/7zn5tcn5ubG5KTk3H27Fl4eHjgtttuw+bNm+3wzomotQmiKIpyF0FE1JoEQcC2bduQkJAgdylE5IA4ZomIiIjIBoYlIiIiIhs4ZomI2j2ONiCi68HOEhEREZENDEtERERENjAsEREREdnAsERERERkA8MSERERkQ0MS0REREQ2MCwRERER2cCwRERERGTD/wNOOWlAeHvZ8QAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plotting how the value of the cost function decreases during the minimization procedure.\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "x_values = list(range(len(cost_values)))\n",
+    "y_values = cost_values\n",
+    "\n",
+    "plt.plot(x_values, y_values)\n",
+    "\n",
+    "plt.xlabel(\"Epochs\")\n",
+    "plt.ylabel(\"Cost Value\")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We see that the final value or our cost function, $\\bra{\\psi}Z\\ket{\\psi} = -1$ demonstrating that the qubit is in the $\\ket{1}$ state."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12 (main, Nov 20 2023, 15:14:05) [GCC 11.4.0]"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/deutschs_algorithm.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/deutschs_algorithm.ipynb.txt
new file mode 100644
index 0000000000..ad86630b41
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/deutschs_algorithm.ipynb.txt
@@ -0,0 +1,414 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Deutsch's Algorithm "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We have a function which takes in a bit and outputs a bit. This can be represented as $f: \\{0,1\\} \\longrightarrow \\{0,1\\}$. \n",
+    "\n",
+    "The function $f$ has a property; either it is constant or balanced. \n",
+    "\n",
+    "If constant, the outputs are the same regardless of the inputs, i.e., $f(0) = f(1) = 0$ or $f(0) = f(1) = 1$.\n",
+    "\n",
+    "If balanced, the ouputs are balanced across their possibilities, i.e,  if $f(0) = 0$ then $f(1) = 1$ or if $f(0) = 1$ then $f(1) = 0$.\n",
+    "\n",
+    "The question we would like to answer is if the function is constant or balanced. \n",
+    " \n",
+    "Classically, if we are given a function $f$, we can solve to find its property via the code below: \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Treat the code snippet below like a black box, i.e., you don't have access to the value of the property argument and can just query f with different inputs.\n",
+    "\n",
+    "\n",
+    "def f(x, property='constant'):\n",
+    "\n",
+    "    if property == 'constant':\n",
+    "\n",
+    "        # The output is a 1 regardless of the input; we can also make the output to be 0.\n",
+    "\n",
+    "        if x == 0:\n",
+    "            return 1\n",
+    "        elif x == 1:\n",
+    "            return 1\n",
+    "\n",
+    "    if property == 'balanced':\n",
+    "\n",
+    "        # The output depends on the input.\n",
+    "\n",
+    "        if x == 0:\n",
+    "            return 1\n",
+    "        elif x == 1:\n",
+    "            return 0"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let us now classically find out if the function we defined above is constant or balanced. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The function is constant\n"
+     ]
+    }
+   ],
+   "source": [
+    "if f(0) == 0:\n",
+    "    if f(1) == 0:\n",
+    "        print('The function is constant')\n",
+    "    elif f(1) == 1:\n",
+    "        print('The function is balanced')\n",
+    "\n",
+    "elif f(0) == 1:\n",
+    "    if f(1) == 1:\n",
+    "        print('The function is constant')\n",
+    "    elif f(1) == 0:\n",
+    "        print('The function is balanced')"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you step through the `if` statements above, one can see that we require 2 calls to the function to determine its property. That is, we have to query $f$ twice.\n",
+    "\n",
+    "The claim is that Deutsch's algorithm can solve for this property with 1 function evalulation, demonstrating quantum advantage. \n",
+    "\n",
+    "Below we first go through the math and then the implementation in CUDA Quantum. \n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## XOR $\\oplus$\n",
+    "\n",
+    "You may have seen the $\\oplus$ symbol floating around. This is the exclusive OR or the XOR operation. It follows the rules of addition modulo 2. For example, \n",
+    "\n",
+    "\n",
+    "1. $3\\oplus5 = (3+5)_{\\%2} = 8_{\\%2} = 0$\n",
+    "\n",
+    "2. $5\\oplus4 = (5+4)_{\\%2} = 9_{\\%2} = 1$\n",
+    "\n",
+    "A quick way to perform the $\\oplus$ calculation is if the result of the addition is an even number, the result is 0 otherwise 1. "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum oracles\n",
+    "\n",
+    "<img src=\"images/oracle.png\"  width=\"300\" height=\"150\">\n",
+    "\n",
+    "Suppose we have $f(x): \\{0,1\\} \\longrightarrow \\{0,1\\}$. 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 logic gates. \n",
+    "\n",
+    "Above you see an oracle represented as $U_f$ which allows us to transform the state $\\ket{x}\\ket{y}$ into: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{x}\\ket{y}  =  \\ket{x}\\ket{y \\oplus f(x)}\n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "If $y = 0$, then $U_f\\ket{x}\\ket{y} = U_f\\ket{x}\\ket{0}  =   \\ket{x}\\ket{0 \\oplus f(x)} =  \\ket{x}\\ket{f(x)}$ since $f(x)$ can either be $0/1$ and $0 \\oplus 0 = 0$ and $0 \\oplus 1 = 1$.\n",
+    "\n",
+    "This is remarkable because by setting $\\ket{y} = \\ket{0}$, we can extract the value of $f(x)$ by measuring the value of the second qubit. \n",
+    " \n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Phase oracle\n",
+    "\n",
+    "\n",
+    "Since $f(x)$ can be either $0$ or $1$, we have that $0 \\oplus f(x) = 0 \\oplus 0 =  0 = f(x)$ or $0 \\oplus f(x) = 0 \\oplus 1 =  1 = f(x)$. \n",
+    "\n",
+    "Similarly, $1 \\oplus f(x) = 1 \\oplus 0 =  1 = \\overline{f(x)}$ or $1 \\oplus f(x) = 1 \\oplus 1 =  0 = \\overline{f(x)}$ where the bar on top of $f(x)$ denotes 'not $f(x)$'. \n",
+    "\n",
+    "\n",
+    "Let us now prove a result which we shall use later: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{x}\\ket{-}  &=   U_f \\ket{x} \\tfrac{1}{\\sqrt{2}}(\\ket{0} - \\ket{1}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (U_f\\ket{x}\\ket{0} - U_f\\ket{x}\\ket{1}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{0 \\oplus f(x)} - \\ket{x}\\ket{1 \\oplus f(x)}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{f(x)} - \\ket{x}\\ket{\\overline{f(x)}}) \\\\\n",
+    "&= \n",
+    "\\begin{cases}\n",
+    "      \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{0} - \\ket{x}\\ket{1}) = \\ket{x}\\ket{-} &   f(x) = 0 \\\\\n",
+    "      \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{1} - \\ket{x}\\ket{0}) = -\\ket{x}\\ket{-} &   f(x) = 1 \\\\\n",
+    "\\end{cases} \\\\\n",
+    "&= (-1)^{f(x)}\\ket{x}\\ket{-}    \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "In summary, $U_f\\ket{x}\\ket{-} = (-1)^{f(x)}\\ket{x}\\ket{-}$ where the $\\ket{-}$ qubit was left unchanged and a phase was applied to $\\ket{x}$. \n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "## Quantum parallelism\n",
+    "\n",
+    "Consider: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{+}\\ket{0} &= U_f \\tfrac{1}{\\sqrt{2}}(\\ket{0}+\\ket{1}) \\ket{0} \\\\\n",
+    "&= U_f \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{0}+\\ket{1}\\ket{0}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}(U_f \\ket{0}\\ket{0} + U_f \\ket{1}\\ket{0})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(U_f \\ket{0}\\ket{0} + U_f \\ket{1}\\ket{0})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{0 \\oplus f(0)} + \\ket{1}\\ket{0 \\oplus f(1)})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{f(0)} + \\ket{1}\\ket{f(1)})  \\\\   \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We have calculated information about both $f(0)$ and $f(1)$ simultaneously. Quantum mechanics allows for parallelism by exploiting the ability of superposition states.  "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Deutschs' Algorithm: \n",
+    "\n",
+    "Our aim is to find out if $f: \\{0,1\\} \\longrightarrow \\{0,1\\}$ is a constant or a balanced function? If constant, $f(0) = f(1)$, and if balanced, $f(0) \\neq f(1)$.\n",
+    "\n",
+    "We step through the circuit diagram below and follow the math after the application of each gate.\n",
+    "\n",
+    "<img src=\"images/deutsch.png\"  width=\"500\" height=\"210\">\n",
+    "\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\ket{\\psi_0}  =  \\ket{01}\n",
+    "\\tag{1}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\\ket{\\psi_1}  =   H_1H_0\\ket{\\psi_0} = H_1H_0\\ket{01} = \\ket{+-} = \\frac{1}{\\sqrt{2}} (\\ket{0}+\\ket{1})\\ket{-}\n",
+    "\\tag{2}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\ket{\\psi_2}  =   U_f\\ket{\\psi_1} = \\frac{1}{\\sqrt{2}} (U_f\\ket{0}\\ket{-} + U_f\\ket{1}\\ket{-})\n",
+    "\\tag{3}\n",
+    "$$\n",
+    "\n",
+    "using $U_f\\ket{x}\\ket{-} = (-1)^{f(x)}\\ket{x}\\ket{-}$ which we proved in the phase oracle section above: \n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_2}  =  \\frac{1}{\\sqrt{2}} ((-1)^{f(0)}\\ket{0}\\ket{-} + (-1)^{f(1)}\\ket{1}\\ket{-}) \\\\\n",
+    "= \\frac{1}{\\sqrt{2}} ((-1)^{f(0)}\\ket{0} + (-1)^{f(1)}\\ket{1}) \\ket{-} \\\\\n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We now drop the second, qubit in the $\\ket{-}$ state from our derivations as the figure above has no further gate operations acting on it. Remember our aim is to find out if $f(x)$ is a constant or a balanced function. We have the following options: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned}\n",
+    "\\ket{\\psi_{2}}=\n",
+    "\\begin{cases}\n",
+    "      \\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1})  &   f(0) = 0, f(1) = 0, f(x)  \\text{ is constant} \\\\\n",
+    "      -\\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1})  &   f(0) = 1, f(1) = 1, f(x)  \\text{ is constant} \\\\\n",
+    "      \\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})  &   f(0) = 0, f(1) = 1, f(x)  \\text{ is balanced} \\\\\n",
+    "      -\\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})  &   f(0) = 1, f(1) = 0, f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_{2}} =\n",
+    "\\begin{cases}\n",
+    "      \\pm \\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1}) = \\pm \\ket{+}  &    f(x)  \\text{ is constant} \\\\\n",
+    "      \\pm \\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})= \\pm \\ket{-}  &    f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_{3}}= H\\ket{\\psi_{2}}\n",
+    "\\begin{cases}\n",
+    "      \\pm H\\ket{+} =  \\pm \\ket{0} &    f(x)  \\text{ is constant} \\\\\n",
+    "      \\pm H\\ket{-}  = \\pm \\ket{1}  &   f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We can now measure the first qubit to yield either a $0$ or a $1$ to determine if $f(x)$ is constant or balanced. \n",
+    "\n",
+    "Deutsch's algorithm may not be practically useful but does demonstrate quantum advantage since it uses one function call to determine the property of $f$ in comparison to two for classical methods. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Import the CUDA-Q package and set the target to run on NVIDIA GPUs.\n",
+    "\n",
+    "import cudaq\n",
+    "import numpy as np\n",
+    "\n",
+    "from typing import List\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Here we input the values of [f(0), f(1)] which allows us to represent constant or balanced functions.\n",
+    "\n",
+    "fx = [0, 1]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮          ╭───╮\n",
+      "q0 : ┤ h ├───────●──┤ h ├\n",
+      "     ├───┤╭───╮╭─┴─╮╰───╯\n",
+      "q1 : ┤ x ├┤ h ├┤ x ├─────\n",
+      "     ╰───╯╰───╯╰───╯     \n",
+      "\n",
+      "f(x) is a balanced function\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Let us now code up the circuit shown above following the state Psi after each step.\n",
+    "\n",
+    "qubit_count = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(fx: List[int]):\n",
+    "    qubit_0 = cudaq.qubit()\n",
+    "    qubit_1 = cudaq.qubit()\n",
+    "\n",
+    "    # Psi 0\n",
+    "    x(qubit_1)\n",
+    "\n",
+    "    # Psi 1\n",
+    "    h(qubit_0)\n",
+    "    h(qubit_1)\n",
+    "\n",
+    "    # Psi 2 - oracle\n",
+    "    if fx[0] == 1:\n",
+    "        x.ctrl(qubit_0, qubit_1)\n",
+    "        x(qubit_1)\n",
+    "\n",
+    "    if fx[1] == 1:\n",
+    "        x.ctrl(qubit_0, qubit_1)\n",
+    "\n",
+    "    # Psi 3\n",
+    "    h(qubit_0)\n",
+    "\n",
+    "    # Measure the qubit to yield if the function is constant or balanced.\n",
+    "    mz(qubit_0)\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(kernel, fx))\n",
+    "\n",
+    "result = cudaq.sample(kernel, fx, shots_count=1)\n",
+    "\n",
+    "if np.array(result)[0] == '0':\n",
+    "    print('f(x) is a constant function')\n",
+    "elif np.array(result)[0] == '1':\n",
+    "    print('f(x) is a balanced function')"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "916dbcbb3f70747c44a77c7bcd40155683ae19c65e1c03b4aa3499c5328201f1"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/hadamard_test.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/hadamard_test.ipynb.txt
new file mode 100644
index 0000000000..104d99ddb5
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/hadamard_test.ipynb.txt
@@ -0,0 +1,310 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hadamard Test and Application\n",
+    "\n",
+    "Consider the observable $O$ and two generic quantum states $\\ket{\\psi}$ and $\\ket{\\phi}$. We want to calculate the quantity\n",
+    "$$\n",
+    "\\braket{\\psi | O | \\psi}.\n",
+    "$$\n",
+    "where $O$ is a Pauli operator.\n",
+    "\n",
+    "First of all we shall prepare the states $\\ket{\\psi}$ and $\\ket{\\phi}$ using a quantum circuit for each of them. So we  have\n",
+    "$$\n",
+    "\\ket{\\psi} = U_{\\psi}\\ket{0} \\qquad \\ket{\\phi} = U_{\\phi}\\ket{0}\n",
+    "$$\n",
+    "\n",
+    "Let's define an observable we want to use:\n",
+    "$$\n",
+    "O = X_1X_2\n",
+    "$$\n",
+    "\n",
+    "Now we can evaluate the matrix element using the following fact:\n",
+    "$$\n",
+    "\\bra{\\psi}O\\ket{\\phi} = \\bra{0}U_\\psi^\\dagger O U_\\phi\\ket{0}\n",
+    "$$\n",
+    "This is just an expectation value which can be solved with a simple Hadamard test. The probability to measure $0$ or $1$ in the ancilla qubit is\n",
+    "\n",
+    "$$\n",
+    "P(0) = \\frac{1}{2} \\left[ I + \\operatorname{Re} \\bra{\\psi} O \\ket{\\phi} \\right]\n",
+    "$$\n",
+    "\n",
+    "$$\n",
+    "P(1) = \\frac{1}{2} \\left[ I - \\operatorname{Re} \\bra{\\psi} O \\ket{\\phi} \\right]\n",
+    "$$\n",
+    "\n",
+    "The difference between the probability of $0$ and $1$ gives \n",
+    "\n",
+    "$$\n",
+    "\\braket{X} = P(0)-P(1) = \\operatorname{Re} \\braket{\\psi | O | \n",
+    "\\phi}.\n",
+    "$$\n",
+    "\n",
+    "Similarly, the imaginary part can be obtained from Y measurement\n",
+    "$$\n",
+    "\\braket{Y} = \\operatorname{Im} \\braket{\\psi | O | \\phi}.\n",
+    "$$\n",
+    "\n",
+    "Combining these results, the quantity $\\braket{\\psi | O | \\psi}$ is obtained."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Numerical result as a reference: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Psi state:  [0.70710677+0.j 0.        +0.j 0.70710677+0.j 0.        +0.j]\n",
+      "          \n",
+      "q0 : ─────\n",
+      "     ╭───╮\n",
+      "q1 : ┤ h ├\n",
+      "     ╰───╯\n",
+      "\n",
+      "Phi state:  [0.+0.j 1.+0.j 0.+0.j 0.+0.j]\n",
+      "     ╭───╮\n",
+      "q0 : ┤ x ├\n",
+      "     ╰───╯\n",
+      "\n",
+      "hamiltonian:  [[0.+0.j 0.+0.j 0.+0.j 1.+0.j]\n",
+      " [0.+0.j 0.+0.j 1.+0.j 0.+0.j]\n",
+      " [0.+0.j 1.+0.j 0.+0.j 0.+0.j]\n",
+      " [1.+0.j 0.+0.j 0.+0.j 0.+0.j]] \n",
+      "\n",
+      "Numerical expectation value:  (0.7071067690849304+0j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "from functools import reduce\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "import cudaq\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "\n",
+    "num_qubits = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def psi(num_qubits: int):\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    h(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def phi(num_qubits: int):\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    x(q[0])\n",
+    "\n",
+    "\n",
+    "psi_state = cudaq.get_state(psi, num_qubits)\n",
+    "print(\"Psi state: \", np.array(psi_state))\n",
+    "print(cudaq.draw(psi, 2))\n",
+    "\n",
+    "phi_state = cudaq.get_state(phi, num_qubits)\n",
+    "print(\"Phi state: \", np.array(phi_state))\n",
+    "print(cudaq.draw(phi, 2))\n",
+    "\n",
+    "ham = cudaq.spin.x(0) * cudaq.spin.x(1)\n",
+    "ham_matrix = ham.to_matrix()\n",
+    "print(\"hamiltonian: \", np.array(ham_matrix), \"\\n\")\n",
+    "\n",
+    "ev_numerical = np.array(psi_state).conj() @ ham_matrix @ np.array(phi_state).T\n",
+    "\n",
+    "print(\"Numerical expectation value: \", ev_numerical)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using ``observe`` algorithmic primitive to compute the expectation value for ancilla qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "QC result: 0.705+-0.007i ± 0.002+0.003i\n",
+      "Numerical result (0.7071067690849304+0j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "@cudaq.kernel\n",
+    "def u_psi(q: cudaq.qview):\n",
+    "    h(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_phi(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def apply_pauli(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "    x(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(num_qubits: int):\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    h(ancilla)\n",
+    "    cudaq.control(u_phi, ancilla, q)\n",
+    "    cudaq.control(apply_pauli, ancilla, q)\n",
+    "    cudaq.control(u_psi, ancilla, q)\n",
+    "\n",
+    "\n",
+    "num_qubits = 2\n",
+    "shots = 100000\n",
+    "x_0 = cudaq.spin.x(0)\n",
+    "y_0 = cudaq.spin.y(0)\n",
+    "results = cudaq.observe(kernel, [x_0, y_0], num_qubits, shots_count=shots)\n",
+    "evs = np.array([result.expectation() for result in results])\n",
+    "std_errs = np.sqrt((1 - evs**2) / shots)\n",
+    "\n",
+    "print(f\"QC result: {evs[0]:.3f}+{evs[1]:.3f}i ± {std_errs[0]:.3f}+{std_errs[1]:.3f}i\")\n",
+    "print(\"Numerical result\", ev_numerical)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Use multi-GPUs to compute multiple Hadamard test in parallel"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Number of QPUs: 5\n",
+      "angles=array([[1.56322878, 3.09176639],\n",
+      "       [0.04025496, 5.59986135],\n",
+      "       [1.87024074, 0.93078226],\n",
+      "       [4.44015281, 5.05675948],\n",
+      "       [1.92402471, 2.12981374],\n",
+      "       [0.49704605, 3.6020906 ],\n",
+      "       [4.50280746, 2.78988978],\n",
+      "       [4.006956  , 3.7581442 ],\n",
+      "       [3.00524035, 3.10937881],\n",
+      "       [3.13405202, 1.33235091]])\n",
+      "0-th ev=-0.7042075991630554\n",
+      "1-th ev=-0.006743329111486673\n",
+      "2-th ev=-0.36111390590667725\n",
+      "3-th ev=-0.45839524269104004\n",
+      "4-th ev=-0.7175908088684082\n",
+      "5-th ev=-0.23948131501674652\n",
+      "6-th ev=-0.765204668045044\n",
+      "7-th ev=-0.865047037601471\n",
+      "8-th ev=-0.9975475072860718\n",
+      "9-th ev=-0.6179792881011963\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Use multi-QPUs\n",
+    "cudaq.set_target(\"nvidia-mqpu\")\n",
+    "\n",
+    "target = cudaq.get_target()\n",
+    "num_qpus = target.num_qpus()\n",
+    "print(\"Number of QPUs:\", num_qpus)\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_psi(q: cudaq.qview, theta: float):\n",
+    "    ry(theta, q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_phi(q: cudaq.qview, theta: float):\n",
+    "    s(q[0])\n",
+    "    rx(theta, q[0])\n",
+    "    s(q[0])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def ham_circuit(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "    x(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(angle0: float, angle1: float):\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    q = cudaq.qvector(2)\n",
+    "    h(ancilla)\n",
+    "    cudaq.control(u_phi, ancilla, q, angle0)\n",
+    "    cudaq.control(ham_circuit, ancilla, q)\n",
+    "    cudaq.control(u_psi, ancilla, q, angle1)\n",
+    "\n",
+    "\n",
+    "angles = 2 * np.pi * np.random.rand(10, 2)\n",
+    "print(f\"{angles=}\")\n",
+    "\n",
+    "async_results = [\n",
+    "    cudaq.observe_async(\n",
+    "        kernel,\n",
+    "        x_0,\n",
+    "        float(angle[0]),\n",
+    "        float(angle[1]),\n",
+    "        qpu_id=i % num_qpus,\n",
+    "    )\n",
+    "    for i, angle in enumerate(angles)\n",
+    "]\n",
+    "\n",
+    "for i, async_result in enumerate(async_results):\n",
+    "    ev = async_result.get().expectation()\n",
+    "    print(f\"{i}-th {ev=}\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/hybrid_qnns.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/hybrid_qnns.ipynb.txt
new file mode 100644
index 0000000000..20181d85ae
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/hybrid_qnns.ipynb.txt
@@ -0,0 +1,487 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hybrid Quantum Neural Networks\n",
+    "\n",
+    "The example below highlights a hybrid quantum neural network workflow with CUDA-Q and PyTorch where both layers can GPU accelerated to maximise performance."
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img src=\"images/hybrid.png\" alt=\"hybrid\" width=\"600\">\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We perform binary classification on the MNIST dataset where data flows through the neural network architecture to the quantum circuit whose output is used to classify hand written digits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install torch==2.2.2\n",
+    "!pip install torchvision==0.17.0\n",
+    "!pip install scikit-learn==1.4.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Import the relevant libraries \n",
+    "\n",
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "import torch\n",
+    "from torch.autograd import Function\n",
+    "from torchvision import datasets, transforms\n",
+    "import torch.optim as optim\n",
+    "import torch.nn as nn\n",
+    "import torchvision\n",
+    "\n",
+    "from sklearn.model_selection import train_test_split\n",
+    "\n",
+    "torch.manual_seed(22)\n",
+    "cudaq.set_random_seed(44)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Set CUDAQ and PyTorch to run on either CPU or GPU.\n",
+    "\n",
+    "device = torch.device('cpu')\n",
+    "cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "#cudaq.set_target(\"nvidia\")\n",
+    "#device = torch.device(\"cuda:0\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def prepare_data(target_digits, sample_count, test_size):\n",
+    "    \"\"\"Load and prepare the MNIST dataset to be used \n",
+    "    \n",
+    "    Args: \n",
+    "        target_digits (list): digits to perform classification of \n",
+    "        sample_count (int): total number of images to be used\n",
+    "        test_size (float): percentage of sample_count to be used as test set, the remainder is the training set\n",
+    "        \n",
+    "    Returns: \n",
+    "        dataset in train, test format with targets \n",
+    "    \n",
+    "    \"\"\"\n",
+    "\n",
+    "    transform = transforms.Compose(\n",
+    "        [transforms.ToTensor(),\n",
+    "         transforms.Normalize((0.1307), (0.3081))])\n",
+    "\n",
+    "    dataset = datasets.MNIST(\"./data\",\n",
+    "                             train=True,\n",
+    "                             download=True,\n",
+    "                             transform=transform)\n",
+    "\n",
+    "    # Filter out the required labels.\n",
+    "    idx = (dataset.targets == target_digits[0]) | (dataset.targets\n",
+    "                                                   == target_digits[1])\n",
+    "    dataset.data = dataset.data[idx]\n",
+    "    dataset.targets = dataset.targets[idx]\n",
+    "\n",
+    "    # Select a subset based on number of datapoints specified by sample_count.\n",
+    "    subset_indices = torch.randperm(dataset.data.size(0))[:sample_count]\n",
+    "\n",
+    "    x = dataset.data[subset_indices].float().unsqueeze(1).to(device)\n",
+    "\n",
+    "    y = dataset.targets[subset_indices].to(device).float().to(device)\n",
+    "\n",
+    "    # Relabel the targets as a 0 or a 1.\n",
+    "    y = torch.where(y == min(target_digits), 0.0, 1.0)\n",
+    "\n",
+    "    x_train, x_test, y_train, y_test = train_test_split(x,\n",
+    "                                                        y,\n",
+    "                                                        test_size=test_size /\n",
+    "                                                        100,\n",
+    "                                                        shuffle=True,\n",
+    "                                                        random_state=42)\n",
+    "\n",
+    "    return x_train, x_test, y_train, y_test"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Classical parameters.\n",
+    "\n",
+    "sample_count = 1000  # Total number of images to use.\n",
+    "target_digits = [5, 6]  # Hand written digits to classify.\n",
+    "test_size = 30  # Percentage of dataset to be used for testing.\n",
+    "classification_threshold = 0.5  # Classification boundary used to measure accuracy.\n",
+    "epochs = 1000  # Number of epochs to train for.\n",
+    "\n",
+    "# Quantum parmeters.\n",
+    "\n",
+    "qubit_count = 1\n",
+    "hamiltonian = spin.z(0)  # Measurement operator.\n",
+    "shift = torch.tensor(torch.pi / 2)  # Magnitude of parameter shift."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "x_train, x_test, y_train, y_test = prepare_data(target_digits, sample_count,\n",
+    "                                                test_size)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAgMAAADgCAYAAACelGVSAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAAAcxElEQVR4nO3dd5TU1f3/8YsoIEUMRYOAIk0RkSYqoUgHUQgQUJESQJrBKBIQJRRBAQUikAiCFCmiIkWKaGgiAU44hCKBwEosSAkckar09vvDn+/v6zPOsLPLzu7O3Ofjr9fsfj4z9+zszt5z37dkuXz58mUHAAC8dU1GNwAAAGQsOgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADguWujvTBLliyxbAcAAIiBaDYaZmQAAADP0RkAAMBzdAYAAPAcnQEAADxHZwAAAM/RGQAAwHN0BgAA8BydAQAAPEdnAAAAz9EZAADAc3QGAADwHJ0BAAA8R2cAAADP0RkAAMBzUR9hDMSKHo9dvXp1ywMHDrRco0YNyzNnzrTcpUuXGLcOkeTPn9/y5s2bLd96662WW7ZsaXnevHnp0zAAKcbIAAAAnqMzAACA5ygTIMPlyZPH8vTp0y2PHz/e8sSJEy1PmzbNMmWCjNO+fXvLRYoUsXzp0qWMaE6mpiWVpUuXWq5UqZLlL774wvK9994buP/kyZMxbB3AyAAAAN6jMwAAgOcoEyDDnThxwnLFihUtHz9+3PLo0aMtL1u2LH0ahoBatWoFHg8ZMiTsdXv37k2H1sSXOnXqWNbf8cuXL1suXbp02Oycc1u2bIlh6wBGBgAA8B6dAQAAPOddmeCZZ56x3KJFC8uFCxcOXPfOO+9Y1pnACxcuvKrXT0pKsrx///6req5EpKWBmjVrWu7Ro4dlXU2A2Kpdu7bluXPnBr6XM2dOy7NmzbKs79X1118fw9YBSCuMDAAA4Dk6AwAAeC7LZZ3OeqULZf/4ePbmm29a7tatW8xfL7QU0KdPH8vvv/9+zF8/3hQoUMDytm3bLB89etRylSpVLLMZS9rT8sySJUssa1nAueAmORUqVLB87ty52DUuTrVr185ypDLXxYsXLYduOvTvf/87Ju2CH6L5N8/IAAAAnqMzAACA5+gMAADgOS+WFt5xxx2WmzRpYvn8+fOWr7km2C+aPXu25TfeeCPVr611VeeCtW/8ROej6MFDBQsWtKy73TFPIO2VK1fO8qRJkyzrPIEDBw4E7mnZsqVl5glcWZs2bZK9ZuvWrZaZI5DYdCl7vnz5wl6jc6bSAyMDAAB4js4AAACeS9gyQbZs2SzPmDHDsu6I1rlzZ8t169YN3L9q1SrL69evj0UT8f81aNDA8tChQy3PnDnTsi4JRdrIlSuX5XXr1oX9+qVLlyz/5S9/Cdy/Y8eOGLYu/ml58sEHH0z2+k2bNsWyOUiFvHnzWtbdUe+55x7LeoCXLo3WkrRzzhUrVsxyjhw5LF+4cMHyokWLLEdTWkpLjAwAAOA5OgMAAHguYcsEw4cPt6w71umsdB2G/uCDD9KnYXDOBYffPvnkE8s7d+603L1793Rtkw9uvPFGy3PmzLGspQHVv39/y6NHj45ZuxLRE088YVnLlpG8+uqrV/V6jz76qOVOnTpZ/uGHHyzrIVLOOffdd99d1WsmgtDddbUc1rNnT8snTpywrJ9furufrqr573//G3hePcxr9erVlrU0cPbs2ZQ0PU0xMgAAgOfoDAAA4LmEKhM0b97c8mOPPWZ5165dliMdDpSRwzM+2rhxo+V9+/ZZ1vfw9OnT6dqmRJU1a1bLWj6rU6eOZR3q1FLaiBEjYty6xJI7d27L1apVS/Z6HXrWv4NQuvlTixYtLP/tb3+znCdPHsuRDpYL/bqWFnTlSKIrWrSo5dBVMr/73e8sf/vtt5b1f8fnn39uWVfVHDlyxHLoIXWZHSMDAAB4js4AAACei/sywS233GJZN6zRrz/11FOWk5KS0qdhCHj77bcDj4sXL25ZN2TRkg5SR2c6O+fcK6+8Yrlr166WtTTQr18/y5QGUk/P1qhdu3ay148cOdKybj4TelbK9OnTLWuZQGkJINL59VqGc8657NmzW070slz+/PktT5482XL9+vUD1+nZHL169bKc6GeiMDIAAIDn6AwAAOC5LJcjjSeFXhhhdmpGe/fddy0//vjjlpcsWWK5WbNmli9evJgu7fKVDm9q2aZv376B69q1a2dZN+PA1dMhUOec69ixY9jr9IjUChUqhL2matWqll944YXA9woVKhT2Ht1jX0sO33zzTfgGx7Frrw1WWpctW2Y50nkEeqx52bJlLVesWNHyRx99FLjn5ptvDvtcuqHQ0qVLLevx0leiqx8SsUygP9/58+dbLlmypOUxY8YE7nn++ectJ8r/i2j+zTMyAACA5+gMAADgubhfTaAbqqjXXnvNcqIM9cSDAQMGWNbSgJ4D4Zxzs2fPTtHz6pGfuv+3TxulXEm3bt0sd+jQIeJ1ug96pKHkPn36WNb99fXY1iupXLmyZd3cRWdmJ8qqkd/85jeBx9EcVTxv3jzLWn7V0kCksoBzwd/5KVOmWH799dctR3pvP/7448DjRNxs7b777rO8ePFiywULFrSsmz1VqlQpcP/LL79sedy4cZbjbROhlGJkAAAAz9EZAADAc3QGAADwXNzPGYikTZs2lteuXZuBLUl89erVs/ynP/3J8oYNGyzrzmzOBXdba9q0qWWtdZYrV85yrly5LGvN9c033ww87549e1LU9njWuXNny3/9618thy4D1kNVdG6BLjd65plnLPfv39+y1vZ1/oBzzh04cMBysWLFLOt78tBDD1neuXOnZZ2XEM9Cd/SL5Pvvv7es75XOnbnSPAGtcevfyObNmy0vXLgw7L36+xB6KE8izrk5duyY5VOnTlmeO3euZZ13FLqzoP5dPfvss5ZLlSpl+X//+1+atDUzYWQAAADP0RkAAMBzcb8DoS5d+vTTTy2XKFHCsp5JvXr16rDPs3z58sDjgwcPWl63bp3lM2fOpL6xCaRAgQKW169fb1mH/xs2bGj5+PHjgfv1HHbdOXLNmjWWP/vsM8u605vuKBk6zFmrVi3LOlyYKPT3WofddYmt7gDonHMPP/yw5UOHDllu3LixZV2C9cYbb1jW5aHR/u6PHj3aspYf9P3QQ2Pijf4uhi6RvO2228Leozul6s/6vffeC3t96O91o0aNLGv5TZ+rRo0aYZ/rq6++shy606QOo+MnWpKcOHGi5fLly1vWEmY8YAdCAACQLDoDAAB4Lu5XE+zdu9dygwYNLA8ZMsSynivevn37sM8T6evOOTdjxgzLV9rdzSfDhg2zXLx4ccv6HujQlB7O4lxw5rMOuSUlJSX72jqD+oMPPgh8r0iRIpYTsUzQpEkTy1oa0CH8p59+OnCPlgb0Z/3+++9b1p+VlnCiLQ1oqUdXLKjQUly8at26teVIZYFQeoCRrtaI5O233w48/u677yxHUxpQurKKskDydHXB7t27Lev7njdvXsuhJdB4xcgAAACeozMAAIDn4r5MoPS89Hbt2lnWmcu6cYQevHLDDTcEnmv48OGWW7VqZXnUqFGWt2/ffpUtji86+1zLJZMnT7a8YsUKyzqUpht+OBfcdCaaoUudwa0z1HUFiXOJ/57069cv7NePHDliWWebh6pfv75lnTXdvXt3y19++WXYe6tUqRJ4PGjQIMt16tSxnD17dsv6vifKRkO6SiZ0lZWWxiJtTFO2bNlkX+ORRx4JPNYh6pw5c4a9R1cgzJkzx7KW1ZAy58+ft3z06FHLiVIaUIwMAADgOToDAAB4LqHKBJEcPnw4bNbNckLdfffdlnWlQe7cudO4dfFDh5h12F5nnysdSuvRo0dUr6HPq8OpAwYMsKznlevseh9EGiK+Ei0H6F7rOgQ6adIky4ULF7asZ0r84Q9/CDyvlt90731dTaBlnHg+D15/L0uWLGn5Spu55MuXz7L+3KNxpXMKItHSQOg5EvEqdLWGnoeh5wukJX3ftNy8b9++mLxeZsHIAAAAnqMzAACA57woE6SGbqKis6s3btyYEc3J1FJzbLBufnP77bdb1uHNRx991PLWrVst6177kc6aSFS6l32nTp0s67CyHpHrXHA4Xzdl0tnnixYtsqxlmIIFC1q+ePFi4Hl1xc24ceMs61BuotAzN/TzQH9WzgXLBjly5LBcsWLFq3p9XbWgGxD17t3bcqRzDuLZiy++GHj8wAMPWB4/frxl3UBLj3uOhpaAnAuuetHPpunTp6foeeMNIwMAAHiOzgAAAJ6jMwAAgOeyXI7moGP3y522Eo3uMuicc7Nnz7a8YMECyy1atEivJmU6esCKHgSlB+HogSy63KxAgQKB59Id1fTAHT14atasWZa1Pp3SmmAi0fkSWudPS1qT1jkyI0aMCFy3Zs2amLx+ZlevXj3L8+bNC3wvrZYeh34sjxkzxvKECRMsR9otMlFcd911gceDBw+23LNnT8s6n2XlypWWIy0f1+WzlSpVCnxP54Horra1atWyHGl3ycwqmn/zjAwAAOA5OgMAAHjO6zLBvffea/njjz8OfE+XVFWtWtXylXYtTHS6BOfVV1+1XKJECcvVqlWzrKWBbdu2BZ5r7dq1lnWo9Z///Kfl06dPX2WLE48eAqTLypo1a2Y5dNgzEl1aOHToUMt68FSi77p2tXS3Reec69u3r+XQ3fPC0c9V/SjWHSGdCx4khZ/ozppt27a1rId56ZLbbNmyWT579qzl0KWwupOjvg/xXJKhTAAAAJJFZwAAAM95USbQHdh69eplWYdZQ2et6jB248aNLf/444+xaCKABHDjjTdaLl26tOXixYtb1l319EC0qVOnWtYVA845t2nTprRspjd01YAeQKQroA4ePJiubcoIlAkAAECy6AwAAOC5uCwT3HnnnZb1UImvv/7acpkyZSzXrl3bcqFChSx/9dVXlocNGxZ4DZ3h7vMmNwCA+EaZAAAAJIvOAAAAnovLMoFuHpGUlGS5WLFiYa/fvXu35blz51p+6aWXLJ86dSrN2gcAQGZBmQAAACSLzgAAAJ6LyzIBAACIDmUCAACQLDoDAAB4js4AAACeozMAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADgOToDAAB4js4AAACeozMAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADguWszugHwQ548eQKPFy1aZLlWrVqW77//fssbNmyIebsA+GHFihWW69SpY/nEiROB6+rWrWt506ZNsW9YJsHIAAAAnqMzAACA5ygTIF306NEj8LhmzZqWL126lN7NwRVUrlzZ8vLlyy0fO3YscF2jRo0s79q1K+bt8tlNN91kedWqVZZ37NhhuVWrVunapnigJUj9zLl8+bJl/R13zrlt27bFvF2ZESMDAAB4js4AAACe865McM01/9f/efLJJy0PGjQocF3hwoWTfa5Ro0ZZ7tatm+WJEydaPn36dOCe4cOHR/xeomnbtq3lgQMHRrxu6tSplrdu3RrTNiE8fX969uxp+YYbbgibnXNuzpw5lsuXLx+7xsFNmTLFcpkyZSyvXLkyI5oTNxo3bmw5a9aslg8dOmR58ODBgXvOnTsX+4ZlQowMAADgOToDAAB4zosyQalSpSy/9NJLlh9//HHLSUlJgXvGjh2b7PNqOaBIkSKWv/vuu4j3PP3005ZHjhyZ7GvEGy3DNG/e3HL27NkD1+nM9C5dusS8XfiJbv5UvXp1y/oe5M2b17LOug4VWjZA2unQoUPgsQ53q7lz56ZDa+LXXXfdFfbrBQsWtFyxYsXA97Zv3x7TNmVWjAwAAOA5OgMAAHjOizLB6NGjLRctWtRyr169LO/evTtwz8KFC1P0Gq1bt05d4xJMmzZtLDdr1izidR9++GE6tAahXnvtNctdu3ZN0b1nz54NPH7rrbfSpE34pdDPkyxZslieMGGC5XXr1qVbm+KRlgPUqVOnLB88eDC9mpOpMTIAAIDn6AwAAOC5hC0T3HrrrZbLli1r+bnnnrO8YMGC9GySF5o0aRLVdYsXL45xS/CzChUqWI72/QkndHOWESNGpPq58Ev9+vWzXL9+/cD39u3bZ3nmzJmWL168GPuGJaA9e/ZYDj2bwFeMDAAA4Dk6AwAAeC7uywQFChSwnDt3bst6VoCWDJ599lnLlAnSXtWqVcN+/V//+lfg8dKlS9OjOV7SI4idCw6D6oZCkejGUbqZ1v79+9OgdVAPPvig5eeff97y5s2bA9c1bNjQ8uHDh2PfsAQ3a9asjG5CpsPIAAAAnqMzAACA5+gMAADguUw7Z0DPni5RokTge4888ojlzp07W9Zap561/uc//9ny0aNH07SdCNaVr7/++rDXfPPNN4HHZ86ciWmbfKaHYTkXPFDoSgcP/axHjx6W2Z0t7ennlB6cpu9TgwYNAvccOXIk5u3yyY4dOzK6CZkOIwMAAHiOzgAAAJ7LVGUCLQ3cfffdlvVwFeecq1WrlmVdNnU1u6sh9e677z7Lv/rVr8JeE3rIDdKWLplt37594HvRlAbGjh1refz48Zbz589vOXRXvD/+8Y9hn6t3796WN23aZPncuXPJtsMH1apVs6xLCz/55BPLlAWQ3hgZAADAc3QGAADwXIaXCXRmre7ANXDgQMvffvtt4J5BgwZZDi0hIHOaNGlSRjch4egqm+7du0d1j5ZrRo0aZfmdd96xXLRoUcsTJkywrLvgXcnatWstDx06NGz2rWyUK1cuy/q3oD+H/v37p2ubAMXIAAAAnqMzAACA5zK8THDddddZfuWVV8Jeky9fvsDjd99913KfPn0sr1mzxvKuXbssMzM3tlq1ahWT59VDj0aPHm15586dlrt06RK458KFCzFpS2Y0bNgwy6VKlYrqHj0AR8ttv/3tby3Pnz/fcjQrEa6kX79+lnW1kG4E5gPdyKl06dKWBw8ebHnLli0R77///vstt2zZ0vLJkycta9nnxx9/TH1j49wdd9xh+ZZbbrGcJUuWjGhO3GBkAAAAz9EZAADAcxleJnjxxReTvUY3PnHOuVWrVlm+/fbbw96zbNkyyzNnzrTcoUOHqNo1efJkyxs2bLCcI0cOy0lJSVE9V6K76aab0uy59Oe7YMECywUKFLBcpUqVsNc751zr1q3TrC2ZkZZOdLhY6Qod55y7dOmS5ddff92y7os/YMCAsPfrvdGKdL9usOMbfa/Onz9v+dChQ5ZHjhxp+YEHHgjcrxsVKR36rlOnjmU9v+XEiROpaHH8uuuuuyxrmWDjxo2WP/roozR7vY4dO1rWz6x4OweHkQEAADxHZwAAAM9leJlgyJAhlnWzEl0lEGrJkiWW9+zZY7lcuXKWq1evblmHQ0OP0v2ZDkM751zPnj0t69GiWrL44osvLLdo0cIyqxdST8szoe9JOJGGTxNV+fLlLUea6R86tD9t2jTLWg645557wj6X3q9fP3z4cOB5P/3007Dt0tncev/VrkyIN7oCplKlSpZ1aF/PhNDVFnpOgXPOderUKexraOnl97//vWU9L2TFihUpaXbC0nNTtHyg/0OuRM/i6Nu3r+Wbb77Zctu2bS0/9thjgfu///776BubARgZAADAc3QGAADwHJ0BAAA8l+FzBrQ+qbWt1NS5dFmHKly4sOX9+/eHvUbrSc4Fz15v2rSp5bfeestyjRo1LJctW9ay7oTog9mzZ1uuVatW2Gt0uY9zzq1bty7sdSVLlgz7dd118t5777UcurRUl1dpTTtRtGvXLsX36Hty2223pejeTZs2Wdbd8pxzbuXKlZanTp1qWecM+KxevXqWQ5d7/kyXuOl8meXLlweu088jpUsTdc6AziVgzsBPihcvblnncITOGdD5L3qPzrcJXe7+M/1be++99wLfe+KJJyzr+5ZZMDIAAIDn6AwAAOC5DC8TpIdIpQF1pd2idLhHz3ofPny45blz51rWg0iOHz8edTvj1WeffWb5hx9+sJwnTx7LOnzvXPBMd/2ZatYS0gcffGBZSzJ60JVzzuXNmzclTY8LuutgNAcS6dJb5365m11yZs2aZblbt26WQ5cs9u/f33LoMqpwfPhbuPPOOy3r54B67rnnLE+YMMHy2bNnU/x6tWvXDvt1n5c36+eRHmpWpkwZy71797bcqFGjwP16aJfurqrlhM8//zzsaxcsWNBy6GeeLn3PjCVMRgYAAPAcnQEAADznRZkgLR08eDDs13W3PN1JzAe7du2yHKlMELpToK4u0J+pnsN+4MABy19++aXlYsWKXV2D40yRIkUs58uXL9nrCxUqFHicLVu2FL1e+/btLVeoUMFy6K6g0ZQGXn75Zcu6EidRNW/e3LKWsPSwoA8//NByakoDuXLlCvt6Z86csbx48eIUP2+i0JLvyZMnw16jpTfNzjl38eJFy/r7qwfeffXVV2GfV98PLR0759yTTz5pmTIBAADIdOgMAADgOcoESFPbt2+3rIeB6MZPzjn397//3bJuzvLQQw9Z1pKDbmSjKwZChwEjHUQVz/RgG82R6KZMzv1yFUByIh1aFK0tW7ZYHjNmjGUfVhPkzJkz7Nd1w6ZoD8aJRFcx6aZbgwYNsqxlNZ+lZnOfiRMnWtZD7qKhqwlC6QZGmREjAwAAeI7OAAAAnqNMkEI6uxq/1KxZM8urV6+2XKVKlcB1Wjb4z3/+Y/n999+3rEOgej670jMLnIu8GUg802F7zZGEDu1Hc0+k+6O9V3/udevWtexDaSAaV3teyVNPPWW5e/fulrUsNn78+Kt6jUTUpUsXy8uWLbMcelaK0s2BQsub4bzwwguW27ZtG/G60NUFmQ0jAwAAeI7OAAAAnqNMEIHO/OzVq5flrl27hr1+2rRplo8dOxarZmV6uomK7muvM6Cdc65hw4aW9XhXPeYzEj1romfPnqlpZlzRDUr03IGHH344Xduhqzucc65v376WdZMbSgO/pOdpbNy40bJuzKXHd+tnjnPOtW7d2rKuRtC/o8OHD6dNYxOIblym50Do55Fu4uRc8Gh6/Vnr51SkVTYXLlywrKtqnAse9Z4ZMTIAAIDn6AwAAOC5LJejnC4czWYn6aV+/fqW+/XrZ3ns2LGWFyxYYFlnuEfa175jx46Bx3pd7ty5k22T3j9jxoxkr/eNDoc651zTpk0tN2nSxHKrVq0snz592vKUKVMs6/HHusmRDypXrmxZf8f1PILQv9Vo/sS1tKUbOQ0ZMsTy119/Hbhn1apVyT6vb3TDJy2d6EZZ//jHPyzr+5k/f37L58+fDzzvvHnzLGt5Zu/evVfZYj/pzzq0JKOrA1SkMoGWHDZv3mx5/vz5V93OtBLNZwAjAwAAeI7OAAAAnqMzAACA5+JyzkD27Nktt2zZ0rKeS61nsufIkcNy1qxZr+q1dbe8Ro0aWT548KDl1BzuAqSUzsPQs9Jr1qwZuE7nZ0TSu3dvy3q4EFLv17/+tWWd25IvXz7LOg9jzpw5lseNGxd4rn379sWiifAEcwYAAECy6AwAAOC5uCwTRKJtvPba/9tcUXfvWr9+vWUdTi1atGjguSZPnmxZSwD649LdpgAAyIwoEwAAgGTRGQAAwHMJVSYAAABBlAkAAECy6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADgOToDAAB4js4AAACeozMAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA566N9sLLly/Hsh0AACCDMDIAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5/4f5kKbg4Vh3lIAAAAASUVORK5CYII=",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plot some images from the training set to visualise.\n",
+    "if device != 'cpu':\n",
+    "    sample_to_plot = x_train[:10].to(torch.device('cpu'))\n",
+    "else:\n",
+    "    sample_to_plot = x_train[:10]\n",
+    "    \n",
+    "grid_img = torchvision.utils.make_grid(sample_to_plot,\n",
+    "                                       nrow=5,\n",
+    "                                       padding=3,\n",
+    "                                       normalize=True)\n",
+    "plt.imshow(grid_img.permute(1, 2, 0))\n",
+    "plt.axis('off')\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class QuantumFunction(Function):\n",
+    "    \"\"\"Allows the quantum circuit to input data, output expectation values \n",
+    "    and calculate gradients of variational parameters via finite difference\"\"\"\n",
+    "\n",
+    "    def __init__(self, qubit_count: int, hamiltonian: cudaq.SpinOperator):\n",
+    "        \"\"\"Define the quantum circuit in CUDA Quantum\"\"\"\n",
+    "\n",
+    "        @cudaq.kernel\n",
+    "        def kernel(qubit_count: int, thetas: np.ndarray):\n",
+    "\n",
+    "            qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "            ry(thetas[0], qubits[0])\n",
+    "            rx(thetas[1], qubits[0])\n",
+    "\n",
+    "        self.kernel = kernel\n",
+    "        self.qubit_count = qubit_count\n",
+    "        self.hamiltonian = hamiltonian\n",
+    "\n",
+    "    def run(self, theta_vals: torch.tensor) -> torch.tensor:\n",
+    "        \"\"\"Excetute the quantum circuit to output an expectation value\"\"\"\n",
+    "\n",
+    "        #If running on GPU, thetas is a torch.tensor that will live on GPU memory. The observe function calls a .tolist() method on inputs which moves thetas from GPU to CPU.\n",
+    "\n",
+    "        qubit_count = [self.qubit_count for _ in range(theta_vals.shape[0])]\n",
+    "\n",
+    "        results = cudaq.observe(self.kernel, self.hamiltonian, qubit_count,\n",
+    "                                theta_vals)\n",
+    "\n",
+    "        exp_vals = [results[i].expectation() for i in range(len(results))]\n",
+    "        exp_vals = torch.Tensor(exp_vals).to(device)\n",
+    "\n",
+    "        return exp_vals\n",
+    "\n",
+    "    @staticmethod\n",
+    "    def forward(ctx, thetas: torch.tensor, quantum_circuit,\n",
+    "                shift) -> torch.tensor:\n",
+    "\n",
+    "        # Save shift and quantum_circuit in context to use in backward.\n",
+    "        ctx.shift = shift\n",
+    "        ctx.quantum_circuit = quantum_circuit\n",
+    "\n",
+    "        # Calculate expectation value.\n",
+    "        exp_vals = ctx.quantum_circuit.run(thetas).reshape(-1, 1)\n",
+    "\n",
+    "        ctx.save_for_backward(thetas, exp_vals)\n",
+    "\n",
+    "        return exp_vals\n",
+    "\n",
+    "    @staticmethod\n",
+    "    def backward(ctx, grad_output):\n",
+    "        \"\"\"Backward pass computation via finite difference\"\"\"\n",
+    "\n",
+    "        thetas, _ = ctx.saved_tensors\n",
+    "\n",
+    "        gradients = torch.zeros(thetas.shape, device=device)\n",
+    "\n",
+    "        for i in range(thetas.shape[1]):\n",
+    "\n",
+    "            thetas_plus = thetas.clone()\n",
+    "            thetas_plus[:, i] += ctx.shift\n",
+    "            exp_vals_plus = ctx.quantum_circuit.run(thetas_plus)\n",
+    "\n",
+    "            thetas_minus = thetas.clone()\n",
+    "            thetas_minus[:, i] -= ctx.shift\n",
+    "            exp_vals_minus = ctx.quantum_circuit.run(thetas_minus)\n",
+    "\n",
+    "            gradients[:, i] = (exp_vals_plus - exp_vals_minus) / (2 * ctx.shift)\n",
+    "\n",
+    "        gradients = torch.mul(grad_output, gradients)\n",
+    "\n",
+    "        return gradients, None, None"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class QuantumLayer(nn.Module):\n",
+    "    \"\"\"Encapsulates a quantum circuit into a quantum layer adhering PyTorch convention\"\"\"\n",
+    "\n",
+    "    def __init__(self, qubit_count: int, hamiltonian, shift: torch.tensor):\n",
+    "        super(QuantumLayer, self).__init__()\n",
+    "\n",
+    "        self.quantum_circuit = QuantumFunction(qubit_count, hamiltonian)\n",
+    "        self.shift = shift\n",
+    "\n",
+    "    def forward(self, input):\n",
+    "\n",
+    "        result = QuantumFunction.apply(input, self.quantum_circuit, self.shift)\n",
+    "\n",
+    "        return result"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class Hybrid_QNN(nn.Module):\n",
+    "    \"\"\"Structure of the hybrid neural network with classical fully connected layers and quantum layers\"\"\"\n",
+    "\n",
+    "    def __init__(self):\n",
+    "        super(Hybrid_QNN, self).__init__()\n",
+    "\n",
+    "        self.fc1 = nn.Linear(28 * 28, 256)\n",
+    "        self.fc2 = nn.Linear(256, 128)\n",
+    "        self.dropout = nn.Dropout(0.25)\n",
+    "\n",
+    "        self.fc3 = nn.Linear(128, 64)\n",
+    "        self.fc4 = nn.Linear(64, 32)\n",
+    "        self.fc5 = nn.Linear(32, 2)\n",
+    "        self.dropout = nn.Dropout(0.25)\n",
+    "\n",
+    "        # The 2 outputs from PyTorch fc5 layer feed into the 2 variational gates in the quantum circuit.\n",
+    "        self.quantum = QuantumLayer(qubit_count, hamiltonian, shift)\n",
+    "\n",
+    "    def forward(self, x):\n",
+    "\n",
+    "        x = x.view(-1, 28 * 28)  # Turns images into vectors.\n",
+    "\n",
+    "        x = torch.relu(self.fc1(x))\n",
+    "        x = torch.relu(self.fc2(x))\n",
+    "        x = self.dropout(x)\n",
+    "\n",
+    "        x = torch.relu(self.fc3(x))\n",
+    "        x = torch.relu(self.fc4(x))\n",
+    "        x = torch.relu(self.fc5(x))\n",
+    "        x = self.dropout(x)\n",
+    "\n",
+    "        # Quantum circuit outputs an expectation value which is fed into the sigmoid activation function to perform classification.\n",
+    "        x = torch.sigmoid(self.quantum(x))\n",
+    "\n",
+    "        return x.view(-1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def accuracy_score(y, y_hat):\n",
+    "    return sum((y == (y_hat >= classification_threshold))) / len(y)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "hybrid_model = Hybrid_QNN().to(device)\n",
+    "\n",
+    "optimizer = optim.Adadelta(hybrid_model.parameters(),\n",
+    "                           lr=0.001,\n",
+    "                           weight_decay=0.8)\n",
+    "\n",
+    "loss_function = nn.BCELoss().to(device)\n",
+    "\n",
+    "training_cost = []\n",
+    "testing_cost = []\n",
+    "training_accuracy = []\n",
+    "testing_accuracy = []\n",
+    "\n",
+    "hybrid_model.train()\n",
+    "for epoch in range(epochs):\n",
+    "\n",
+    "    optimizer.zero_grad()\n",
+    "\n",
+    "    y_hat_train = hybrid_model(x_train).to(device)\n",
+    "\n",
+    "    train_cost = loss_function(y_hat_train, y_train).to(device)\n",
+    "\n",
+    "    train_cost.backward()\n",
+    "\n",
+    "    optimizer.step()\n",
+    "\n",
+    "    training_accuracy.append(accuracy_score(y_train, y_hat_train))\n",
+    "    training_cost.append(train_cost.item())\n",
+    "\n",
+    "    hybrid_model.eval()\n",
+    "    with torch.no_grad():\n",
+    "\n",
+    "        y_hat_test = hybrid_model(x_test).to(device)\n",
+    "\n",
+    "        test_cost = loss_function(y_hat_test, y_test).to(device)\n",
+    "\n",
+    "        testing_accuracy.append(accuracy_score(y_test, y_hat_test))\n",
+    "        testing_cost.append(test_cost.item())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA9wAAAHpCAYAAABweDQqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAACj50lEQVR4nOzdd3hUVf7H8ffMpAeSkF4IJKGETiBAqNZAEBfFihVFRX8sroVVVyxgW7GyrMouiuCirgvKWtgVsQRBkSoR6SW0hJJOEhJIm5nfHwODWQIkIclN+bye5z4zc+beO5+ZnXX45px7jslut9sRERERERERkTplNjqAiIiIiIiISHOkgltERERERESkHqjgFhEREREREakHKrhFRERERERE6oEKbhEREREREZF6oIJbREREREREpB6o4BYRERERERGpByq4RUREREREROqBCm4RERERERGReqCCW0RERERERKQeGF5wz5o1i6ioKDw8PEhISGDdunXn3H/mzJnExsbi6elJZGQkDz/8MCUlJRd0ThEREREREZG65mLkiy9cuJDJkycze/ZsEhISmDlzJklJSezcuZPg4OAz9v/oo494/PHHmTdvHoMHD2bXrl3ceeedmEwmZsyYUatzVsVms3H48GFat26NyWSq0/csIiJSXXa7nWPHjhEeHo7ZbPjfyA2n32cREWkMavT7bDfQgAED7JMmTXI+tlqt9vDwcPv06dOr3H/SpEn2yy67rFLb5MmT7UOGDKn1OauSnp5uB7Rp06ZNm7ZGsaWnp1f7N6w50++zNm3atGlrTFt1fp8N6+EuKytjw4YNTJkyxdlmNptJTExk9erVVR4zePBgPvzwQ9atW8eAAQPYu3cvS5Ys4fbbb6/1OQFKS0spLS11Prbb7QCkp6fj4+NzQe9TRESktgoLC4mMjKR169ZGR2kUTn0O+n0WEREj1eT32bCCOycnB6vVSkhISKX2kJAQduzYUeUxt9xyCzk5OQwdOhS73U5FRQX/93//xxNPPFHrcwJMnz6dZ5999ox2Hx8f/aCLiIjhNHza4dTnoN9nERFpDKrz+9ykLghbvnw5L774In/7299ISUnh008/5csvv+T555+/oPNOmTKFgoIC55aenl5HiUVERERERKSlMqyHOzAwEIvFQmZmZqX2zMxMQkNDqzzm6aef5vbbb+eee+4BoGfPnhQXF3Pvvffy5JNP1uqcAO7u7ri7u1/gOxIRERERERE5zbAebjc3N+Lj40lOTna22Ww2kpOTGTRoUJXHHD9+/IxZ4CwWC+C47ro25xQRERERERGpD4YuCzZ58mTuuOMO+vXrx4ABA5g5cybFxcWMHz8egHHjxhEREcH06dMBGD16NDNmzKBPnz4kJCSQmprK008/zejRo52F9/nOKSIidcdms1FWVmZ0jCbL1dXV+fsldcdqtVJeXm50jCZL30sRkbpjaME9duxYsrOzmTp1KhkZGcTFxbF06VLnpGdpaWmVerSfeuopTCYTTz31FIcOHSIoKIjRo0fz5z//udrnFBGRulFWVsa+ffuw2WxGR2nS/Pz8CA0N1cRodcBut5ORkUF+fr7RUZo8fS9FROqGyX5qDSxxKiwsxNfXl4KCAs2CKiJSBbvdTlpaGuXl5YSHh59xuY+cn91u5/jx42RlZeHn50dYWNgZ++j3qLLzfR5HjhwhPz+f4OBgvLy8VCzWQnW+lyIiLV1Nfp8N7eEWEZGmqaKiguPHjxMeHo6Xl5fRcZosT09PALKysggODtYw3gtgtVqdxXZAQIDRcZo0fS9FROqOuiRERKTGrFYr4JgAUy7MqT9Y6JrjC3Pq89MfgOqGvpciInVDBbeIiNSahuxeOH2GdUufZ93Q5ygiUjdUcIuIiIiIiIjUAxXcIiIiFyAqKoqZM2caHUOkEn0vRUQaBxXcIiLSIphMpnNuzzzzTK3Ou379eu699966DSsthr6XIiLNm2YpFxGRFuHIkSPO+wsXLmTq1Kns3LnT2daqVSvnfbvdjtVqxcXl/D+TQUFBdRtUWhR9L0VEmjf1cIuISIsQGhrq3Hx9fTGZTM7HO3bsoHXr1nz11VfEx8fj7u7OypUr2bNnD1dffTUhISG0atWK/v37891331U67/8O3TWZTLz77rtcc801eHl50alTJxYvXtzA71aaCn0vRUSaNxXc9c1aYXQCEZF6Z7fbOV5WYchmt9vr7H08/vjjvPTSS2zfvp1evXpRVFTEqFGjSE5O5pdffmHkyJGMHj2atLS0c57n2Wef5cYbb2TTpk2MGjWKW2+9lby8vDrLKdVj1PeyLr+ToO+liEhTpiHl9W3ReLBVwMCJEDUMtMyGiDRDJ8qtdJv6tSGvve25JLzc6ubn7LnnnmP48OHOx/7+/vTu3dv5+Pnnn+ezzz5j8eLF3H///Wc9z5133snNN98MwIsvvsgbb7zBunXrGDlyZJ3klOox6ntZl99J0PdSRJqmbYcLmf7VdkrKrXV+7qTuodwzLOac+3yacpAF69KxU/mPoO/e0R9fT9c6z3Q2KrjrU1EW9h1fYrJbYecSCOkJQx6EHteBWYMLREQam379+lV6XFRUxDPPPMOXX37JkSNHqKio4MSJE+ftSezVq5fzvre3Nz4+PmRlZdVLZmn+9L0UkbqSUVDCf349TLnNVu+v9c3WTDam59fLuVPS8imtsJ2zL/PtFXspOFF+RnuFtf7f+2+p4K5PrYJZ0P8TKlb9jetcfsQrczN8eg+s/Atc9hTEXqEebxFpFjxdLWx7Lsmw164r3t7elR4/8sgjfPvtt7z22mt07NgRT09Prr/+esrKys55HlfXyn85N5lM2BrgHzdSmVHfy7r8ToK+lyJSN3KLSrnl3TXszS5u0Nd96squRPh51tn5Xv16J3tzinn1653n3dfX05WXru1Zqa2VR8OWwCq469lHe9zZXHEXr1XcyO2Wb7nX5Ut8srbCgpuh3WC48jUI6W50TBGRC2Iymep0CG1j8dNPP3HnnXdyzTXXAI6exf379xsbSqpN30sREYeDR49z+esrKK1w/JHtqt7heLjW/4jbziGtuXtoNKY67GQM8fXgk5/TsdrOPV+GCRNX9AzlktjgOnvt2mh+v0KNyLGScnZmHgPgyesG859NUQzbPZz7XP7LeMtSPNNWYZ89DNPAiXDJFHBvdZ4ziohIQ+rUqROffvopo0ePxmQy8fTTT6tHUAyn76VI87Iz4xh/+FcKx0rqb7LlE+VWZ7F9dVw4M8fG1WkR3JD6tmtD33ZtjI5RbSq461FrD1d+eXo4v6bnM7hjIDf2j+SXtM7M+DaKD3YP52nXDxhlWQer38K+cwmma96ByP5GxxYRkZNmzJjBXXfdxeDBgwkMDORPf/oThYWFRseSFk7fS5GmyW63M++n/aRmFVVq33KogF2ZRWc5qm69en0vbugX2SCvJQ4me12vXdEMFBYW4uvrS0FBAT4+PvXyGmv35vLsf7YRnPkDL7jOo60pB7vJgumiR+DiP4G5bq//EhGpSyUlJezbt4/o6Gg8PDyMjtOkneuzbIjfo6bkXJ+HvpN1S5+nyPnZ7XbW7curcmKuqhzKP8Gz/9l21udfvKYnvdr61lW8M3i5WYgO9G6yPduNSU1+n9XDbZCEmAD+84eh/HNtJDd+3ZVHre9yjeUnWPEy9oPrMV03F7z8jY4pIiIiIiK/cWqW66+2ZPCHf/1S4+N7R/qR2KXydcWhvh5cH99WxXAzpILbQBaziXGDohjeLYQ/fhzO9/sW85Lru3jtWYZtzmWYb/oIQroZHVNEREREpMkpt9q49d21+Hi4MGdcvzopZp/+fAsfrDlQqS3S35PAVu7VOt7T1cJTV3ajW7hGLbUUKrgbgTBfTz68O4F3VwZx49eR/N3yOpFH92GbOwLzLQsgaqjREUVEREREmpQ92UWs25cHwM1z1uBqufBZudfsza30uJW7C/8YP4AOQZr8WKqmgruRMJtN3HtRB3q3vZE7PgxmesUrJJTtwPbBtZhveA+6XGl0RBERERGRJiH/eBl//nK78/GavXl1du7OIa345L7BAHi4mXF30dxLcnYquBuZhJgA5t9/Bb//hw8PHJ3OcDZgX3g7phveg25XGx1PRERERKTRe3HJdn7cnQOAm4uZl6/rWSfnNWFiQLQ/vl6udXI+af5UcDdCkf5efPB/F3P3e+4UZrzCdZYfsX9yF6abP4LOSUbHExERERFptKw2O99uywQcvdF/vy1eQ77FMBd+IYPUCz8vNz6YMJjP2z3BF9bBmOwV2BbeDvt+MDqaiIiIiEijlJJ2lJ7PfM3R4+X4eLiw5IFhKrbFUOrhbsS83Fx4+44BjH93Cu5HnmMk67EuuB3LvcsgoIPR8UREREREGsTP+/NYsjkDO/Zz7rd6Ty7Hy6wAXNkrHJc6mChN5EKo4G7kvNxceGf8IMa9PYWQvMfoU5qK7Z83YJ6QDJ5tjI4nIiIiInJByipspKQdpdxqo0uoD0GtHUts7cw4RtaxEgAe/WQTGYUl1T7n82N6MLZfZL3kFakJFdxNgK+nK3PuGsIdbz7Ou2V/IiJvD/ZF92C69RMw6692IiIiItJ0vfTVDub9tA+AcF8PfnjsUjYfKuCav62qtJ+Xm4XxQ6LOe74OQa24tm/b+ogqUmMquJuIYB8P/nx7Ir9/+1EWuEzFc893sPotGPKA0dFERJoEk8l0zuenTZvGM888U+tzf/bZZ4wZM6ZWx0vLpe+ltHQzvtnpLLYBDheUEPv0Umx2x9DxwFZuBLX2wASM7R/JHYOjjAkqUksquJuQvu3aMPaqK3lu8W6mu87F/t2zmKKGQES80dFERBq9I0eOOO8vXLiQqVOnsnPnTmdbq1aaVEcanr6X0pLtyjzGG8tSAfDxcOGaPhHMX30Aq81RbFvMJt68uS+DOgQYGVPkgmg8chNz84BI8mJvZol1gGPm8kV3Q1mx0bFERBq90NBQ5+br64vJZKrUtmDBArp27YqHhwddunThb3/7m/PYsrIy7r//fsLCwvDw8KB9+/ZMnz4dgKioKACuueYaTCaT87FIdeh7KS1Ret5x/rUujac/3+JsW/9UIs9e3YOfn0pk7ROXs/aJy9k4dbiKbWny1MPdxJhMJl66rjc3zryf3mUPE3F0HyyfDiNeMDqaiLRkdjuUHzfmtV294DzDcs/nn//8J1OnTuWtt96iT58+/PLLL0yYMAFvb2/uuOMO3njjDRYvXszHH39Mu3btSE9PJz09HYD169cTHBzMe++9x8iRI7FYLHXxrqQuGPW9rIPvJOh7KU2f1WZ3Tnr2W/fM/5mdmcecj1++rifuLo7vaGAr9wbLJ9IQVHA3QW283Xji+kE8Of8u/uH2KvbVszD1uB7C44yOJiItVflxeDHcmNd+4jC4eV/QKaZNm8brr7/OtddeC0B0dDTbtm3j7bff5o477iAtLY1OnToxdOhQTCYT7du3dx4bFBQEgJ+fH6GhoReUQ+qYUd/LOvhOgr6X0rTZ7Xau+/sqNqbnV/m8i9nEZV2C6RzSmhs1m7g0YxpS3kRdGhuMT88r+Y91ICa7DfviP4C1wuhYIiJNTnFxMXv27OHuu++mVatWzu2FF15gz549ANx5551s3LiR2NhYHnjgAb755huDU0tzp++lNHVzV+5zFtuuFlOlzc1i5raB7XlnXD8eSYo97+SBIk2ZeribsKmju3Hjrru5yLYJ34xN8PNcSLjP6Fgi0hK5ejl69Yx67QtQVFQEwJw5c0hISKj03KlhuH379mXfvn189dVXfPfdd9x4440kJiayaNGiC3ptqWdGfS8v8DsJ+l5K0/fPtWkADIoJ4F/3DjQ4jYhxVHA3YYGt3BmflMCr/xnLC67vYVv+EuZeY8HTz+hoItLSmEx1MoTWCCEhIYSHh7N3715uvfXWs+7n4+PD2LFjGTt2LNdffz0jR44kLy8Pf39/XF1dsVqtDZhaqkXfS30vpUbS846TUXjmNdc1lVtUyr4cx6S+b9zc54LPJ9KUqeBu4m7uH8mon65id8E3dDpxCH58HUY8b3QsEZEm5dlnn+WBBx7A19eXkSNHUlpays8//8zRo0eZPHkyM2bMICwsjD59+mA2m/nkk08IDQ3Fz88PcMwInZyczJAhQ3B3d6dNmzbGviFpFvS9lIa0P6eY4X9ZQbnVXmfnHNoxkKDWmgRNWjYV3E2ci8XMlN/14MX5t/Ce26vY187G1P8eaNP+/AeLiAgA99xzD15eXrz66qs8+uijeHt707NnTx566CEAWrduzSuvvMLu3buxWCz079+fJUuWYDY7pkJ5/fXXmTx5MnPmzCEiIoL9+/cb92ak2dD3UhrSLXPWUG6109rDhaA6mCnczcXMxEs61EEyqRd2O/z7btjVAud+ePBX8G645eZMdru97v6M1UwUFhbi6+tLQUEBPj4+RsepllvnrOb3aX9kiGUrxN8Jo/9qdCQRacZKSkrYt28f0dHReHh4GB2nSTvXZ9kUf4/q07k+D30n65Y+z6Yvt6iUGd/uorDk/JPqWm02lmzOABxDwK/qbdCqE9JwThyFl6OMTmGMR/eAd+AFnaImv8/q4W4mHkyM5ZV3rmOIZSv2X/6J6aJHwbet0bFERERExACfbDjonLisuuIi/VRstxT5J78bXoFwz7fGZmlong17eY0K7mZiQLQ/lqjBrD7YjUFsg5Uz4crXjI4lIiIiIgZIzXLMdJ/YNYQhHc8/fNbFbGJEd63Z3uh8+Qhs/rjuz3tqOeE2UeAfU/fnF6dGUXDPmjWLV199lYyMDHr37s2bb77JgAEDqtz3kksuYcWKFWe0jxo1ii+//BJwrEs5f/78Ss8nJSWxdOnSug/fiDx4eSfemHcNgyzbsKe8j2nYH8EnzOhYIiIiItLA9mY7Cu6r48IZrV7rpslaAT/PA3s9rjYQPaz+zi1AIyi4Fy5cyOTJk5k9ezYJCQnMnDmTpKQkdu7cSXBw8Bn7f/rpp5SVlTkf5+bm0rt3b2644YZK+40cOZL33nvP+djdvfnPkDioQwAvhw9mXVYsA9gJq9+CpD8bHUtEREREGtCrX+8gJS0fgB4RvsaGkdorPOQoti1uMHEVYKrb81tcwE8TLdc3wwvuGTNmMGHCBMaPHw/A7Nmz+fLLL5k3bx6PP/74Gfv7+/tXerxgwQK8vLzOKLjd3d0JDW1Zw2JMJhN3DY3mbx9fxQC3Vx293Jc8Du6tjY4mIs2U5t28cE35M6zJCLXy8nKmT5/O/PnzOXToELGxsbz88suMHDmyTjM15c+zMdHn2DRtPljAt9szmfX9HgC6hLYmOrBprkXfLO37AT7/PZQVV29/28mebd9ICOxUf7mkXpmNfPGysjI2bNhAYmKis81sNpOYmMjq1aurdY65c+dy00034e1d+T8my5cvJzg4mNjYWCZOnEhubu5Zz1FaWkphYWGlraka1TOMHd4D2GMLw1RaCBv/ZXQkEWmGLBYLQKURR1I7x48fB8DV1dXgJDVzaoTatGnTSElJoXfv3iQlJZGVlVXl/k899RRvv/02b775Jtu2beP//u//uOaaa/jll1/qJM+pz+/U5ykXpql+L1sym83OPe+v543k3c62f96TYGAiOcPmT6AgHU7kVW8rLXAcFzXE2NxyQQzt4c7JycFqtRISElKpPSQkhB07dpz3+HXr1rFlyxbmzp1bqX3kyJFce+21REdHs2fPHp544gmuuOIKVq9e7fxH4m9Nnz6dZ5999sLeTCPhajFz++AY/vFdEs+b/3F6XW6zoX9bEZFmxsXFBS8vL7Kzs3F1dXWu+yvVZ7fbOX78OFlZWfj5+VX5+9SY1XSE2gcffMCTTz7JqFGjAJg4cSLfffcdr7/+Oh9++OEF57FYLPj5+TkLfi8vL0ymOh5+2QI09e9lS7bpUAGZhaV4uVm4Pr4tN/aLJKAO1tOWOnT0gOM28RnofEX1jjFbwF/rmTdlhg8pvxBz586lZ8+eZwxfu+mmm5z3e/bsSa9evejQoQPLly/n8ssvP+M8U6ZMYfLkyc7HhYWFREZG1l/wenbzgHZclnwJj9o/xidvD6R+C52TjI4lIs2IyWQiLCyMffv2ceDAAaPjNGl+fn5N7hKoUyPUpkyZ4mw73wi10tLSM9Zz9vT0ZOXKlWd9ndLSUkpLS52PzzcC7dTneLZedqm+pvi9bOmWbc8E4JLYIJ67uofBaVqoPd/Dfx6A8hNVP388z3HbdgAEd2m4XGIoQwvuwMBALBYLmZmZldozMzPP+x/54uJiFixYwHPPPXfe14mJiSEwMJDU1NQqC253d/dmNamav7cbF3WPYsHWS7nX5UtY83cV3CJS59zc3OjUqZOGlV8AV1fXJtmDWJsRaklJScyYMYOLLrqIDh06kJyczKefforVevbZd2s6Au3UH4KCg4MpLy+v9nFSWVP9XrZEH6w5wKb0fAB+3J0DwGVdQs5xhNSrTQtPr299Nu6+ENK9YfJIo2Bowe3m5kZ8fDzJycmMGTMGAJvNRnJyMvfff/85j/3kk08oLS3ltttuO+/rHDx4kNzcXMLCWs4SWTf1j+SxTSO4x7IE897vIW8f+EcbHUtEmhmz2XxGr6VIVf76178yYcIEunTpgslkokOHDowfP5558+ad9ZjajkCzWCwqGKXZ+/yXQzz9+ZZKba4WE5fEBhmUSJxDxoc/Dx3P7OQDwCcCPP0aLJIYz/Ah5ZMnT+aOO+6gX79+DBgwgJkzZ1JcXOy8JmzcuHFEREQwffr0SsfNnTuXMWPGEBAQUKm9qKiIZ599luuuu47Q0FD27NnDY489RseOHUlKajm9vANjArD4t2dlYQ8usmyGXz6Ey582OpaIiDQDtRmhFhQUxOeff05JSQm5ubmEh4fz+OOPExMTc9bXaW4j0ETqSmrWMR5auBFwzER+dVwEAL3b+hKo67YbxoFV8MX9lWccL8523LYbpF5scTK84B47dizZ2dlMnTqVjIwM4uLiWLp0qXOYWlpa2hmT8ezcuZOVK1fyzTffnHE+i8XCpk2bmD9/Pvn5+YSHhzNixAief/75FvWjbTabuLFfJP/69jJHwb3xn3DJFMd6eyIiIhfgQkaoeXh4EBERQXl5Of/+97+58cYbGyCxSPOy6WCB8/6L1/akb7s2BqZpoTYthLw9Z7Z7+EFQbIPHkcarUVRf999//1l/oJcvX35GW2xs7FnXh/T09OTrr7+uy3hN1vXxbfnrN/Hk2lsTcOwIpH4HsXW73qmIiLRMNR2htnbtWg4dOkRcXByHDh3imWeewWaz8dhjjxn5NkSapJe+csyVcPOAdiq2jXJq+PilT1WeK8mvHXj4GJNJGqVGUXBL/Qjx8aB/hxD+vf8ix+RpKe+r4BYRkTpR0xFqJSUlPPXUU+zdu5dWrVoxatQoPvjgA/z8/Ax6ByKNn9Vm59OUg+QVn56cstxqI+uYY/b+Xm19jYrW9H31J9j+n9ofX3Tykpp2AyGsV91kkmbJZD9bV3ELVlhYiK+vLwUFBfj4NO2/UH28Pp23P/2KZPdHsZssmCZvg9Za5kNEpCloTr9HdUGfh7QkecVlfPbLIZ7/77Yqn/d0tbD5mRG4WMxVPi/nUH4C/lwH/x52awUPbQYv/ws/lzQpNfk9Ug93MzeyZyhPfRFJiq0jfc2psPUzGDjR6FgiIiIichZ7sou4YuaPlFltAPSO9KNDkLfzeRezidsHRqnYrq38dMetWyu487+1P49vOxXbcl4quJs5Hw9XLosN5osdQxwF9+ZPVHCLiIiINBJFpRXcM3896XknnG3Hyyoos9pwdzHTto0nb93ch0h/LwNTNgCbDRbdCYd+qf/Xqihx3Pq1h/A+9f960qKp4G4Bro4L5+mtA5nq+gGWQxsgdw8EdDA6loiIiEiL9uGaAyzbkcWavXlVPj/jxjiu7BXWwKkMkrMLtn3RsK8ZOaBhX09aJBXcLcClXYIpdQ/gJ2t3xxJhW/4NF2tWWBERERGjbDlUwFOfb3E+HjeoPdf2bet83NrDhZhA76oObZ7y0xy3AZ3gmrfr//XMFgjtWf+vIy2eCu4WwMPVwmVdg/li0xBHwb35E7joUTCZjI4mIiIi0iIlb88CoHu4D2PiIrgloR3e7i3kn+ar/wbr3gF+M3dzaZHjNrAztI03JJZIfWgh/6+Wkd1DeXRjP17EFfecXZCxWUsYiIiIiNSjLYcKuGXOGgpLKs66z7hB7Rnbv10DpmoEVr0Bx45U/Vxk/4bNIlLPVHC3EBfHBlHu0opkax9GWdY5hpWr4BYRERGpM+VWG8//dxtpeccBOJB7/JzFdmArN4Z3a2HLtZaXnC62b/s3uP9mSSUXDw3zlmZHBXcL4eXmwkWdg1iyI8FRcG//DyQ+o2HlIiIiIhcoNauIVXty2JtdzPurD5zx/Ozb4ukf1eaM9tYerri5NNDSXmXHYeGtcPQAeAfCDf8An/DTz3/zNOz4sv5z2E7+AcLVGzpcrn+LSrOngrsFSeoeyrRtcZThglveHsjeAcFdjY4lIiIi0iTZ7XYO5Z/gjnnrOJR/elmvxK4hjOzh6LkObu3ORZ2DjIp42v6VsGeZ437eHtj+X0i41/G4/IRjmHdDahuvYltaBBXcLUhi12D+ZPbiR2tPLrf84ujlVsEtIiIiUisPLtjI4l8PA+DhaubyLiF4u1v444hYQnw8DE73P/IPnP1xwUHHrVsruHVR/WcxmSBUlzZKy6CCuwXx83JjYIw/S/f1P1lwL9byYCIiIiK18OPubGex3crdhbuHRvPw8M4NF2Dt27B+LpVm+j6X47mOW5MZ7DZIeR92f+NoKz/ZO+/XHtoPqvOoIi2ZCu4WJrFrCG+k9sXmasacsRmO7oc2UUbHEhEREWlS5q3cB4C/txspTw9v+AA/zoCijJoflzAR1syC0kLH9ltajkukzqngbmEujQ3m2f/4sNbWhUHmbY7rdwbfb3QsERERkSYj/3gZ3+/MBuCd2w0oUstPnC62b/kY3Lyrd5yHL4T0gH7joSiz8nNmFwjvW7c5RUQFd0sTFehNTKA3Xx3t7yi4d6jgFhEREamJhxZuBCDCz5P49mfOPn7Byorhk/FQkF7189Zyx61bK+g0ouaTjwV2cmwiUu9UcLdAl3YJ5quV8TznOh/S18LxPPDyNzqWiIiISKP3zOKtLD/Zu31jv0hM9THT9t4VsPvr8+8X0VczfYs0ciq4W6BLY4OZuzKQVNrR0Z7mWCKi5/VGxxIRERFptFbuzuGjdQf4ZqtjKHZ0oDd/uKxj/bxYfprjNmoYXPRo1fuYTBoCLtIEqOBugfpHt8HbzcK3Fb3p6JIGu5aq4BYRERGpQv7xMpbtyOL1b3Y519oObOXOtw9fhNlch73LJ/Lh33fDsczT12eHx0HMxXX3GiLS4FRwt0DuLhaGdAxk2fY+THT5D6R+BzYrmC1GRxMRERExXGFJOSXlVgCmfr6VpVsdBbCbxczU0d24uHMQLhZz3b7orq8d/yb7LfVgizR5KrhbqMu6BPPktk4cM7Wi9YmjcHA9tBtodCwRERERQy3dksHv/7kB2/8sbz2sUyCje4dzY7/I+nnh/AOO204jYOBE8PCD8D7181oi0mBUcLdQl3YJxoqF7yt6cpVlteOvqiq4RUREpIVbsSvLWWyfmo9saMdA3r9rQN1NkPb1k7D/x8ptBYcct237Q4fL6uZ1RMRwKrhbqBAfD7qEtmZZVh9Hwb37G0icZnQsEREREcPY7Xb+tc6xFNfMsXGM6RNR9y9SlAWr3zr78xpGLtKsqOBuwYZ2DOTfGb2wYcKcuQUKD4NPuNGxRERERAyxaMNB5/2Owa3q50WOnhw63ioErv5b5ee8AyAsrn5eV0QMoYK7BRvSKZB3V/qww9SBbvZU2Lsc4m4xOpaIiIhIgyspt/Look0AhPt60D3cp3YnytsH/30YSgrO8kIn2wM6QqfE2r2GiDQZKrhbsAFR/rhaTCwr7043l1TY870KbhEREWlR/rn2ADO+2UVZhc3Z9v7dCbW/XnvTQtj7/fn3U0+2SIuggrsF83Z3oU+7Nvy4vxf3u3zh+HGw2cBcx8tciIiIiDQyH/+czqrUHFbsyubo8XJn+6RLO1zYcPJTQ8bjboVuV1e9j8UN2g+u/WuISJOhgruFG9oxkDf3daLE5IFHcTZkbYXQnkbHEhEREak3uzOP8djJ4eMA3m4W/v37wXi7udC2jWftTlqcA1/cD2mrHI9jLoXOSXWQVkSaMnVltnBDOgZSjgvr7F0dDXuqMQRKREREpIkqq7Bx3wcbAIgK8OKpK7vyzwkD6RLqQ6S/V+2Hkm/7AnZ9dfoa7bDedZRYRJoyFdwtXO+2vrRyd2F5eQ9Hw55lxgYSERERqSf7c4rp/ew37M0pBuDh4Z25Z1gMcZF+F37y/JNDyWOvhP9bCUGdL/ycItLkaUh5C+diMTMwJoAfdpwcRp62GspLwNXD2GAiIiIidSg97ziXvLbc+Xh4txCujqvGOtulRfDFJDiWce798vY4bqOG6PI8EXFSwS0M7RjAd9sjyDMH4F+R6yi6O1xqdCwRERGROvPeT/ud91+7oTfXx7et3oG7v4Ztn1f/hTT7uIj8hgpuYUjHQMDE8oruXGv+wTFbuQpuERERaUaW7cgE4M7BUVzXtxo926cc3e+4jb4YBkw4976tQqBt/9oFFJFmSQW30DG4FQHebqw40YNr3X5wXMc9/DmjY4mIiIjUib3ZRezPPY6rxcQjSbE1mxgtP81x224gdB1dPwFFpNnSpGmCyWRiYEwAP9lOXm+UsdmxtIWIiIhIM7BsRxYAA2MCaOVew/6mU+tq+7Wr41Qi0hKo4BYABsb4k4MvaS7Rjob9K40NJCIiIlJHkrc7Cu7LugTX/OBTPdx+7eswkYi0FBpSLgAM6hAAwPKyWMaZ9zkK7u5jjA0lIiIiUksnyqys2ZvLiXIr6/fnAXBF673wwR/BWlb9E526hls93CJSCyq4BYAOQa0IbOXGT8e7Ms5tKez/0ehIIiIiIrX2wpfb+OfaNOfjjsGtCN30JuxJrvnJPP3BpwYTrYmInKSCWwDHddwJMQH8tKmLoyF7BxRlQ6sgY4OJiIiI1JDVZuerLY51s7uH++Dt7sK9w2Igeb9jh4sfh6DO1T9hWBxY9M9mEam5RnEN96xZs4iKisLDw4OEhATWrVt31n0vueQSTCbTGduVV17p3MdutzN16lTCwsLw9PQkMTGR3bt3N8RbadIGxgSQT2sOOK/jVi+3iIiIND2/Hswnr7iM1h4ufD5pCB/fN4jErsFQkO7YofdN0OO66m8BHYx9QyLSZBlecC9cuJDJkyczbdo0UlJS6N27N0lJSWRlZVW5/6effsqRI0ec25YtW7BYLNxwww3OfV555RXeeOMNZs+ezdq1a/H29iYpKYmSkpKGeltN0qAYfwCWl53s5dbEaSIiItLEFJaU84ePfgHgos5BuFpO/nO3KBMqSsBkBt+2BiYUkZbE8IJ7xowZTJgwgfHjx9OtWzdmz56Nl5cX8+bNq3J/f39/QkNDndu3336Ll5eXs+C22+3MnDmTp556iquvvppevXrx/vvvc/jwYT7//PMGfGdNj/M67goV3CIiItK0WG129uUUM33Jdg7lnwDg8t/OSn5qtnGfCLC4GpBQRFoiQy9GKSsrY8OGDUyZMsXZZjabSUxMZPXq1dU6x9y5c7npppvw9vYGYN++fWRkZJCYmOjcx9fXl4SEBFavXs1NN910xjlKS0spLS11Pi4sLKztW2rSTl3HvXJTV+yYMOXshGOZ0DrE6GgiIiIi53TP/PV8vzPb+fja4COM2fEBbD05I3nxyee0vJeINCBDe7hzcnKwWq2EhFQu6EJCQsjIyDjv8evWrWPLli3cc889zrZTx9XknNOnT8fX19e5RUZG1vStNBsDYwIooBUHXGMcDQfUyy0iIiKN16H8E4z4ywpnse3j4cKAKH9eDfse866vHLOS70mGjE2OA0J7GphWRFqaJj3d4ty5c+nZsycDBgy4oPNMmTKFyZMnOx8XFha22KLbeR13aWfuNO+BfT86JgsRERERaYS+2nyEXZlFAAyM8WfBvYMcT8x+1HE7+AEI6e64b3GDTsMNSCkiLZWhBXdgYCAWi4XMzMxK7ZmZmYSGhp7z2OLiYhYsWMBzzz1Xqf3UcZmZmYSFhVU6Z1xcXJXncnd3x93dvRbvoPk5dR33yuPduNPtK13HLSIiIo3ail2Onu3BHQKYe0f/008cPXnNdtwtENzVgGQiIgYPKXdzcyM+Pp7k5GRnm81mIzk5mUGDBp3z2E8++YTS0lJuu+22Su3R0dGEhoZWOmdhYSFr16497znl9HXc62yx2DFB7m44dv7h/SIiIiINLaOghB935wBwbd+2eLpZHE+cyIfSAsd9v3bGhBMRoRHMUj558mTmzJnD/Pnz2b59OxMnTqS4uJjx48cDMG7cuEqTqp0yd+5cxowZQ0BAQKV2k8nEQw89xAsvvMDixYvZvHkz48aNIzw8nDFjxjTEW2ryBsYEUEgr9rueXHNSvdwiIiLSCN353jrn/eFdfzN/T/4Bx61XILh5N3AqEZHTDL+Ge+zYsWRnZzN16lQyMjKIi4tj6dKlzknP0tLSMJsr/11g586drFy5km+++abKcz722GMUFxdz7733kp+fz9ChQ1m6dCkeHh71/n6ag1PXcX9fGku0ORX2/wg9rzc4lYiIiAjszDjGG8m7KSm3siOjkMkun3BteD6+n39weqdTM5K30YzkImIsk91utxsdorEpLCzE19eXgoICfHx8jI7T4Ox2O/3/nEzv46uY6/Y6+HeAB1KMjiUi0uK09N+j/6XPo2Xbl1PMqj05/HvDQVLS8gHoZDrIt+6Pnf2gvuPgqjcbJqCItBg1+T0yvIdbGh+TycTAGH9+2NTFsR533h6txy0iIiKGsdvt3PneOg7kHne2PZoUS6/jebAeaBMFw/5Y+SCLG3ROatCcIiL/SwW3VGlgTAD/3XSEAy7RRFXshbRV0P0ao2OJiIhIC7Qj4xgHco/j5mLmybANDLWtJybTG1P+yZnIQ3s5erNFRBoZFdxSpYEnr+P+sawTUea9cGC1Cm4RERExxLIdWQBc0rENd6T/FaxlkPubHUJ6GBNMROQ8VHBLlToEtSLA2401J2K53e1rRw+3iIiISAMrKbfy6tc7ARgVZYf9ZY7h4le84tjBzRu6XGlgQhGRs1PBLVUymUwMiPZn3ZZYR0PGFigpAA9fY4OJiIhIi5BVWMK+nGK+257pbBsWWOy44xsJ/cYblExEpPpUcMtZDYj256stbch0CSek4jCkr4NOw42OJSIiIs1cYUk5iTNWUFhS4Wy7NDaIgPJdjgd+7QxKJiJSM+bz7yItVUJ0AACryjs5Gg5oWLmIiIjUr6VbjtDrmW8oLKnA09VCTJA3A2P8mXFjHJyaJE3ra4tIE6Eebjmr2NDW+Hi4sKo8lmtcV0DaaqMjiYiISDP3acoh5/0HLuvIRNO/IXs7LAEO/+J4Qj3cItJEqOCWs7KYHddxr99x8jruQxugvARcPYwNJiIiIs3WvhzHddqvXN+LGyOOwtsvnrlTcPcGTiUiUjsquOWcBkT78932UPIt/vhZ8xxFd9QQo2OJiIhIM1RSbuVA7nEABsUEQEaK44k20TDw94773oHQaYRBCUVEakYFt5zTgOgAwMRaa2eSWONYHkwFt4iIiNSDNXtzKbdWMM37c9ou+xTy9jieiOgLCfcaG05EpBZUcMs59Qj3wcvNwqryWJJc18ABXcctIiIi9WPbkUL6mXYx3roItvzmieCuhmUSEbkQKrjlnFwsZuLbt2F96snruNPXgc0KZouxwURERKTZ2Z9TTJQ5w/EgqCvE3wFu3tD9WmODiYjUkgpuOa+BMQG8vrsdJ8zeeJYdg4zNEB5ndCwRERFpRo6k72Hs5gnEu+50NLQbCAMnGhtKROQCaR1uOa8B0f7YMJNi7+xo0PJgIiIiUoe2Hi4gbc4txJt2nm7UMHIRaQZUcMt59Wrri7uLmZ/KThbcB1YZG0hERESalf9uOkKCecfphv73QN9xxgUSEakjGlIu5+XuYqFPOz/W7Tt5HfeBVWC3g8lkbDARERFpuspPwPLpUJTNwN3ZlZ+77Clw9TQml4hIHVLBLdWSEB3A3/d2oNzkiuvxHMhNhcBORscSERGRpmr7f+GnvwJw8f8+5+HX0GlEROqFhpRLtSRE+1OGK5s5WWRrWLmIiIhciLy9jps2vZlefjPTy2+mJG483LtCo+hEpNlQwS3V0qddG1wtJn4q18RpIiIiUgfyDwCw0XMAb1tH8y/Xa/AYM1MroYhIs6KCW6rF081Cr7Z+rLf95jpuERERkdrKTwNg8X5XAKaM0qzkItL8qOCWahsQ7U+KrRM2zI6/ShceNjqSiIiINFVHHT3c6fYgAHpG+BqZRkSkXmjSNKm2hGh//r7ci92mKGLtex293D2vNzqWiIiINFZH98OavztmJP8f9sKDmICD9iBeGNODHiq4RaQZUsEt1Rbfvg1mE/xU3plYl72O67hVcIuIiMjZ/Pg6pLxf5VMmoNDuhbl1KLcmtGvYXCIiDUQFt1Rbaw9XekT4su5wF+5iKaStMTqSiIiINGa5jpnI6XEdBJ2+Rnt7RiFfbjrCKlt3fj+yEybNSi4izZQKbqmRAVH+fHHw5EzlmVuhpAA8NARMREREqnByJnIG3AftEpzN7yzcyGfWQ9x3cQy3D4oyJpuISAPQpGlSIwkxAWTjxyFTKGCH9PVGRxIREZHGyFoOhYcc99u0dzan5R7ns18c7Zd3CTEimYhIg1HBLTXSP6oNJhOsqejkaEjXsHIRERGpQuEhsNvA4g7ewQCUlFtJ/MsKAHw9Xenbzs/AgCIi9U8Ft9SIn5cbsSGtT6/Hreu4RUREpConl/3Crx2YHf/kXL0nl7IKGwBPjuqKi0X/FBWR5k3/lZMaS4j252fbyeu4D/7sGDImIiIi8lunhpP7tnU2Je/IBOC2ge24sX+kEalERBqUCm6psQHRAeyxh1Noag0VJyBjk9GRREREpLE5ke+49QpwNq3fdxSAizoFGRBIRKThqeCWGhsQ7Y8dM+srOjoaNKxcRERE/ldJgeP25GomNpudfbnFAMSGtjYqlYhIg1LBLTUW1NqdmCBvftZ13CIiLdqsWbOIiorCw8ODhIQE1q1bd879Z86cSWxsLJ6enkRGRvLwww9TUlLSQGmlwZXkO25PFtyHC05QVmHD1WIiws/TuFwiIg1IBbfUSkJ0AOtPXcedtgbsdmMDiYhIg1q4cCGTJ09m2rRppKSk0Lt3b5KSksjKyqpy/48++ojHH3+cadOmsX37dubOncvChQt54oknGji5NJj/6eHen3McgHb+XposTURaDP3XTmolIdqfzfYYynGB4iw4us/oSCIi0oBmzJjBhAkTGD9+PN26dWP27Nl4eXkxb968KvdftWoVQ4YM4ZZbbiEqKooRI0Zw8803n7NXvLS0lMLCwkqbNCGnCm5PPwD25RQBEB3YyqBAIiINTwW31MqAaH9KceNXW4yjQcPKRURajLKyMjZs2EBiYqKzzWw2k5iYyOrVq6s8ZvDgwWzYsMFZYO/du5clS5YwatSos77O9OnT8fX1dW6RkZrVukk5nue49fADYH+uo4c7KsDLoEAiIg1PBbfUSrifJ5H+nqeXB1PBLSLSYuTk5GC1WgkJCanUHhISQkZGRpXH3HLLLTz33HMMHToUV1dXOnTowCWXXHLOIeVTpkyhoKDAuaWnp9fp+5B6lp/muPV1/KEks9BxvX6or4dRiUREGpwKbqm1hOgANpwquNPXGhtGREQateXLl/Piiy/yt7/9jZSUFD799FO+/PJLnn/++bMe4+7ujo+PT6VNmohjGXDssOO+XzsAso6VAhDio4JbRFoOF6MDSNM1INqflzacLLizdziGjnn5GxtKRETqXWBgIBaLhczMzErtmZmZhIaGVnnM008/ze23384999wDQM+ePSkuLubee+/lySefxGxWH0Czsn7u6fvegQBknyy4g1u7G5FIRMQQhv+61XRJkfz8fCZNmkRYWBju7u507tyZJUuWOJ9/5plnMJlMlbYuXbrU99tokQZGB5CHD3vs4Y6G9HP/byciIs2Dm5sb8fHxJCcnO9tsNhvJyckMGjSoymOOHz9+RlFtsVgAsGuli+an9Jjjtm1/MJlYvSeXfTmONbjDtSSYiLQghvZwn1pSZPbs2SQkJDBz5kySkpLYuXMnwcHBZ+xfVlbG8OHDCQ4OZtGiRURERHDgwAH8/Pwq7de9e3e+++4752MXF3Xk14dIf09CfTxYf7wzHVwOQ9pqiB1pdCwREWkAkydP5o477qBfv34MGDCAmTNnUlxczPjx4wEYN24cERERTJ8+HYDRo0czY8YM+vTpQ0JCAqmpqTz99NOMHj3aWXhLM1LuKK7plEROUSk3z3HM9dLO34u2bVRwi0jLYWgl+tslRQBmz57Nl19+ybx583j88cfP2H/evHnk5eWxatUqXF1dAYiKijpjPxcXl7MOaZO6YzKZGBDtz4YtnbmJ5bqOW0SkBRk7dizZ2dlMnTqVjIwM4uLiWLp0qXMitbS0tEo92k899RQmk4mnnnqKQ4cOERQUxOjRo/nzn/9s1FuQ+lTmmJEcNy++33F6bfbnx/TAZDIZFEpEpOEZNqS8NkuKLF68mEGDBjFp0iRCQkLo0aMHL774IlartdJ+u3fvJjw8nJiYGG699VbS0tLOmUXrfNZeQow/P9tiHQ8OpUBFqbGBRESkwdx///0cOHCA0tJS1q5dS0JCgvO55cuX849//MP52MXFhWnTppGamsqJEydIS0tj1qxZZ4xSk2ai3FFwl5k9eHTRJgAeuLwTF3cOMjKViEiDM6zgrs2SInv37mXRokVYrVaWLFnC008/zeuvv84LL7zg3CchIYF//OMfLF26lL///e/s27ePYcOGcezYsbNm0TqftZcQ7c8+eyi5dh+wlsLhjUZHEhEREaOVOYaUb84qdzaN6qnRhyLS8hg+aVpN2Gw2goODeeedd4iPj2fs2LE8+eSTzJ4927nPFVdcwQ033ECvXr1ISkpiyZIl5Ofn8/HHH5/1vFrns/Y6BLUiwNv99Hrc6VqPW0REpMUrPwHALxllACR1D6FLqJZ1E5GWx7CCuzZLioSFhdG5c+dKk6t07dqVjIwMysrKqjzGz8+Pzp07k5qaetYsWuez9k5dx73+1LDyNBXcIiIiLd7JIeU/H3ZcajZhWIyRaUREDGNYwV2bJUWGDBlCamoqNpvN2bZr1y7CwsJwc3Or8piioiL27NlDWFhY3b4BcUqI9mfDqR7utDWg5V1ERERaLrsdMrcAkF1iwWI20autn7GZREQMYuiQ8smTJzNnzhzmz5/P9u3bmThx4hlLikyZMsW5/8SJE8nLy+PBBx9k165dfPnll7z44otMmjTJuc8jjzzCihUr2L9/P6tWreKaa67BYrFw8803N/j7aykGRAewxR5Nid0VTuRBzm6jI4mIiIhR9v/ovHuU1kS28cTNpUldxSgiUmcMXRaspkuKREZG8vXXX/Pwww/Tq1cvIiIiePDBB/nTn/7k3OfgwYPcfPPN5ObmEhQUxNChQ1mzZg1BQZoVs750CW2Np4cHv9o6kGDa4biOO6iz0bFERETECNk7nXf32sO5PKiVgWFERIxlaMENjiVF7r///iqfW758+RltgwYNYs2as18nvGDBgrqKJtVkNjuu4/55d2cSzDsgbS30HWd0LBEREWloWTtgySMAfOFxNZTA0E6BBocSETGOxvdInUiIDvjNxGlVr6MuIiIizdzi050oPx9rA8BlXYKNSiMiYjgV3FInBkT7k2Lr5HiQtweKso0NJCIiIg3LbncOJ19q7c9n1qEkdg2mfYC3wcFERIyjglvqRPdwH6xuvuy0tXU0aD1uERGRluXEUSgtBOCh8t9zZb9Y3r2jv8GhRESMpYJb6oSLxUx8lD8/az1uERGRlqngoOPG7EcJ7nQObW1wIBER46ngljqTEO3Pz6fW405fa2wYERERaVgnjgKQbXXMSj4oJsDINCIijYIKbqkzCdH+rLc7erjthzdC+QljA4mIiEjDKSkAIN/uhavFRBf1cIuIqOCWutOzrS/ZlhAy7X6YbOVwaIPRkURERKShnCy4C+1eBLf2wGw2GRxIRMR4Krilzri7WOjb7rfDytcZG0hEREQazqmCGy+CWrsbHEZEpHFQwS11qtLyYCq4RUREWo6SfAAK7d4quEVETlLBLXUqIcaflJM93PaD6xxrcoqIiEizZz/umDStEC8uiQ0yOI2ISOOgglvqVJ/INuwyR1Nqd8F0PBfy9hodSURERBpAeV4aAIftgVzXt63BaUREGgcV3FKnPN0sdGkbxGZ7jKNBw8pFRESav70rcNv7DQBlrdri4WoxOJCISOOgglvqXEKl67i1HreIiEizVpwLH17rfBge083AMCIijYsKbqlzA6L92XCq4D643tgwIiIiUr9yU8FWAcDz5bcSoYJbRMRJBbfUuX5R/my0Owpue+ZWKCk0OJGIiIjUmz3JAKSYezDXeiXRga0MDiQi0nio4JY618rdhZCIKNJtQZiww6ENRkcSERGR+rL2bQDSyn0BaOfvZWQaEZFGRQW31IuEaH9S7FqPW0REpFmzWaGsCICF1kswmSCwlZvBoUREGg8V3FIvBkQH/OY6bhXcIiIizdLOJWCrwGZ2Za2tKwHe7rhY9M9LEZFT9F9EqRcDovz55WQPty19HdhsBicSERGROmUth4W3AVDiFYYNMyE+7gaHEhFpXFRwS73w9XLFFtSd43Z3zKWFkLPL6EgiIiJSlwrSnXeXtH0YgJggTZgmIvJbKril3vTvEMIme4zjgdbjFhERaV7STv62B3bm3YyOAFzWJcjAQCIijY8Kbqk3ldfj1nXcIiIizcqqNwEo8wxiR8YxTCa4uHOwwaFERBoXFdxSb/pH+ZNysuC2HlAPt4iISLNiqwAgI2gYAJFtvPD31gzlIiK/pYJb6k1Qa3fy2sQBYMnbDcfzjA0kIiIidaekAIA39rcFIDrQ28g0IiKNkgpuqVddOkSz1xbqeHDwZ2PDiIi0cFFRUTz33HOkpaUZHUWag5J8ANYcsQLQLdzHwDAiIo2TCm6pVwNj/Emxd3Y80HXcIiKGeuihh/j000+JiYlh+PDhLFiwgNLSUqNjSVNUXgIVJQAU2r0AeGRErJGJREQaJRXcUq8GRJ++jrviwBqD04iItGwPPfQQGzduZN26dXTt2pU//OEPhIWFcf/995OSkmJ0PGlKSgsBsNlNHMOTzycNwWI2GRxKRKTxUcEt9SrM15PDrXs6HhxKAWuFsYFERIS+ffvyxhtvcPjwYaZNm8a7775L//79iYuLY968edjtdqMjSmN34igAx/Bk4iWdiIv0MzaPiEgjpYJb6l1QTG+O2T1xqSiGrG1GxxERafHKy8v5+OOPueqqq/jjH/9Iv379ePfdd7nuuut44oknuPXWW42OKI1dQToAR+wBDO4QaHAYEZHGy8XoANL8DYgJ4pfNHbnIstlxHXdYL6MjiYi0SCkpKbz33nv861//wmw2M27cOP7yl7/QpUsX5z7XXHMN/fv3NzClNAXWvP1YgHR7ED2CNTu5iMjZqIdb6l1CdAC/2E9dx631uEVEjNK/f392797N3//+dw4dOsRrr71WqdgGiI6O5qabbjIooTQV+Yf3AJBhCiaktYfBaUREGi/1cEu9i/T3ZJ9ndyj/lPL9a/SlExExyN69e2nfvv059/H29ua9995roETSVOUfTiUAMPu3x6zJ0kREzko93FLvTCYTnlEDAPAsSoOibIMTiYi0TFlZWaxde+ZIo7Vr1/Lzzz8bkEiaKpdCxzXcbSI6GpxERKRxU8EtDaJnxyh22to6Hmg9bhERQ0yaNIn09PQz2g8dOsSkSZMMSCRNkc1mx/vEIQB8QlVwi4iciwpuaRAJMVqPW0TEaNu2baNv375ntPfp04dt27SKhFTPt7/uJdDkWIc7PKqzwWlERBo3FdzSIGICvdnl1g2A43tWG5xGRKRlcnd3JzMz84z2I0eO4OKiGTakejI2/AeAIryJiWxrcBoRkcZNBbc0CJPJhKmd4zpur5xNUFFmcCIRkZZnxIgRTJkyhYKCAmdbfn4+TzzxBMOHDzcwmTQZpUXccXAaADa/c0/AJyIimqVcGlB0514c3deKNrYiyNgMbeONjiQi0qK89tprXHTRRbRv354+ffoAsHHjRkJCQvjggw8MTidNgT1vL6fmJC8a/Bg+hqYREWn81MMtDSahQxAbnNdxa1i5iEhDi4iIYNOmTbzyyit069aN+Ph4/vrXv7J582YiIyONjidNQMGRVAB+tcUQ0Pcqg9OIiDR+hhfcs2bNIioqCg8PDxISEli37twzWOfn5zNp0iTCwsJwd3enc+fOLFmy5ILOKQ2jY1Artro4ruM+tutHg9OIiLRM3t7e3HvvvcyaNYvXXnuNcePG4erqanQsaSIKDu8BINc1FHcXi8FpREQav1oV3M899xzHjx8/o/3EiRM899xz1T7PwoULmTx5MtOmTSMlJYXevXuTlJREVlZWlfuXlZUxfPhw9u/fz6JFi9i5cydz5swhIiKi1ueUhmM2mygNc1zH7X54HdjtBicSEWmZtm3bxtKlS1m8eHGlTeR8SnL2AXDCS5OliYhUh8lur3nVY7FYOHLkCMHBwZXac3NzCQ4Oxmq1Vus8CQkJ9O/fn7feegsAm81GZGQkf/jDH3j88cfP2H/27Nm8+uqr7Nix46x/ja/pOatSWFiIr68vBQUF+Pjo6qS69I8fdnJz8hDcTeXwhxQI6GB0JBGRRquuf4/27t3LNddcw+bNmzGZTJz6J4DJ5Lgqt7q/30bR77PxNr82ip5FP/FN1GOMuPNJo+OIiBiiJr9Hterhttvtzh/n3/r111/x9/ev1jnKysrYsGEDiYmJp8OYzSQmJrJ6ddXX9y5evJhBgwYxadIkQkJC6NGjBy+++KLzHwi1OSdAaWkphYWFlTapH/07hrLJHg2AVddxi4g0qAcffJDo6GiysrLw8vJi69at/PDDD/Tr14/ly5cbHU8auQqrDbeigwBEd+pqcBoRkaahRgV3mzZt8Pf3x2Qy0blzZ/z9/Z2br68vw4cP58Ybb6zWuXJycrBarYSEhFRqDwkJISMjo8pj9u7dy6JFi7BarSxZsoSnn36a119/nRdeeKHW5wSYPn06vr6+zk0Tx9SfLqE+bDI7fqTzd/xgcBoRkZZl9erVPPfccwQGBmI2mzGbzQwdOpTp06fzwAMPGB1PGrnthwsJtzsu0Yvp1N3gNCIiTUONlgWbOXMmdrudu+66i2effRZfX1/nc25ubkRFRTFo0KA6D3mKzWYjODiYd955B4vFQnx8PIcOHeLVV19l2rRptT7vlClTmDx5svNxYWGhiu56YjGbKA7pD5lfYDm41ug4IiItitVqpXXr1gAEBgZy+PBhYmNjad++PTt37jQ4nTR2Jw5upLXpBACWNu0MTiMi0jTUqOC+4447AIiOjmbIkCG4uNR+Ge/AwEAsFguZmZmV2jMzMwkNDa3ymLCwMFxdXbFYTs+K2bVrVzIyMigrK6vVOQHc3d1xd3ev9XuRmvHtPAQywe/4fijOAe9AoyOJiLQIPXr04NdffyU6OpqEhAReeeUV3NzceOedd4iJiTE6njRmdjvx314PQIHZD19XT4MDiYg0DbW6hrt169Zs377d+fiLL75gzJgxPPHEE5SVlVXrHG5ubsTHx5OcnOxss9lsJCcnn7WXfMiQIaSmpmKz2Zxtu3btIiwsDDc3t1qdUxpeXOcYdtocs5vqOm4RkYbz1FNPOX9Dn3vuOfbt28ewYcNYsmQJb7zxhsHppFErzsZiKwfgq6C7DA4jItJ01Krgvu+++9i1axfguK567NixeHl58cknn/DYY49V+zyTJ09mzpw5zJ8/n+3btzNx4kSKi4sZP348AOPGjWPKlCnO/SdOnEheXh4PPvggu3bt4ssvv+TFF19k0qRJ1T6nGK97uA+/mroAkLdD63GLiDSUpKQkrr32WgA6duzIjh07yMnJISsri8suu8zgdNKo7VkGwCF7ANvCrzM4jIhI01GrMeG7du0iLi4OgE8++YSLL76Yjz76iJ9++ombbrqJmTNnVus8Y8eOJTs7m6lTp5KRkUFcXBxLly51TnqWlpaG2Xz6bwKRkZF8/fXXPPzww/Tq1YuIiAgefPBB/vSnP1X7nGI8F4uZo4F9Ifc77OrhFhFpEOXl5Xh6erJx40Z69OjhbK/u6iLSgh3Pg8/uA+CgPQg/z6qXZhURkTPVquC22+3OIWnfffcdv/vd7wBHQZyTk1Ojc91///3cf//9VT5X1RIlgwYNYs2aNbU+pzQOXh2HQu4r+Bdsg7Lj4OZldCQRkWbN1dWVdu3aNfq1tqURyj49od7fK0Yzqo1+s0VEqqtWQ8r79evHCy+8wAcffMCKFSu48sorAdi3b596kqVaunXtSYa9DS5UYDu4weg4IiItwpNPPskTTzxBXl6e0VGkKTnyKwCrrN1YbutDdJC3wYFERJqOWvVwz5w5k1tvvZXPP/+cJ598ko4dOwKwaNEiBg8eXKcBpXnq2daPZHssV5jWkLv9B4JihhkdSUSk2XvrrbdITU0lPDyc9u3b4+1duXBKSUkxKJk0at89A8ARAgDoHNzawDAiIk1LrQruXr16sXnz5jPaX3311UpLdomcjZuLmew2faBgDaV7fzI6johIizBmzBijI0gTZDNbMAPLrb25JaEdvl66hltEpLpqv5A2sGHDBufyYN26daNv3751EkpaBvcOQyDl7wQc3Qg2K5j1xxoRkfo0bdo0oyNIU2K3w8GfMZcVAbDS1oNVV3YzOJSISNNSq4I7KyuLsWPHsmLFCvz8/ADIz8/n0ksvZcGCBQQFBdVlRmmmOvUayLENnrS2FWM7shlzRJzRkUREROSUnUtgwS3Ohwldo/F00x/HRURqolaTpv3hD3+gqKiIrVu3kpeXR15eHlu2bKGwsJAHHnigrjNKM9UrMoCNxAKQuWWZwWlERJo/s9mMxWI56yZSSW5qpYftg3wNCiIi0nTVqod76dKlfPfdd3Tt2tXZ1q1bN2bNmsWIESPqLJw0by4WMxlt4iF/IyWpP0LSZKMjiYg0a5999lmlx+Xl5fzyyy/Mnz+fZ5991qBU0miVn6j0MDpQs5OLiNRUrQpum82Gq+uZE2a4uro61+cWqQ63DkNhw1wCc392XCtmMhkdSUSk2br66qvPaLv++uvp3r07Cxcu5O677zYglTRaZcXOuza7SQW3iEgt1GpI+WWXXcaDDz7I4cOHnW2HDh3i4Ycf5vLLL6+zcNL8dew9jBN2N1rbCqnI2GZ0HBGRFmngwIEkJycbHUMam/LjzruPlt+n9bdFRGqhVgX3W2+9RWFhIVFRUXTo0IEOHToQHR1NYWEhb775Zl1nlGasS9tAfjU5ruM+skn/2BMRaWgnTpzgjTfeICIiwugo0tiUOQru6eU387XrZQS1cjc4kIhI01OrIeWRkZGkpKTw3XffsWPHDgC6du1KYmJinYaT5s9iNpHZpi8c3XzyOm5NuiciUl/atGmD6TeX7tjtdo4dO4aXlxcffvihgcmkMbKVFWMGjuNOpL9Xpe+OiIhUT40K7mXLlnH//fezZs0afHx8GD58OMOHDwegoKCA7t27M3v2bIYNG1YvYaV5cosZBhvmE6TruEVE6tVf/vKXSkWT2WwmKCiIhIQE2rRpY2AyaYwOZeUQCZTgxjOjtf62iEht1KjgnjlzJhMmTMDHx+eM53x9fbnvvvuYMWOGCm6pkQ59Lqb0Zxf8bHmUZe/GLbiz0ZFERJqlO++80+gI0kTkHy/jcHYukWYI9PcnISbA6EgiIk1Sja7h/vXXXxk5cuRZnx8xYgQbNmy44FDSsnSKCGKrqRMAh375zuA0IiLN13vvvccnn3xyRvsnn3zC/PnzDUgkjdXG9Hw8KQXg3st6GJxGRKTpqlHBnZmZWeVyYKe4uLiQnZ19waGkZTGZTGT69wOgJPUHg9OIiDRf06dPJzAw8Iz24OBgXnzxRQMSSWO1L6eYUNNRANqEtDU4jYhI01WjgjsiIoItW7ac9flNmzYRFhZ2waGk5XHrMBSAwDyNkBARqS9paWlER0ef0d6+fXvS0tIMSCSNVXpWHsGmfMcDv/aGZhERacpqVHCPGjWKp59+mpKSkjOeO3HiBNOmTeN3v/tdnYWTlqND38spt1sIsmZRmr3P6DgiIs1ScHAwmzZtOqP9119/JSBA1+jKacWZewEod/EGT02oJyJSWzUquJ966iny8vLo3Lkzr7zyCl988QVffPEFL7/8MrGxseTl5fHkk0/WV1ZpxtqHBrLTHAPAgV++NTiNiEjzdPPNN/PAAw/w/fffY7VasVqtLFu2jAcffJCbbrrJ6HjSSBzOP0Fm2i4AyltHavUQEZELUKNZykNCQli1ahUTJ05kypQp2O12wHENblJSErNmzSIkJKRegkrzZjKZyPLvB7m7Kdn9A4y41+hIIiLNzvPPP8/+/fu5/PLLcXFx/BPAZrMxbtw4XcMtThs2rCHBvB0At8AoY8OIiDRxNSq4wXGd15IlSzh69CipqanY7XY6deqk9TvlgrnEDIPcfxGU97PRUUREmiU3NzcWLlzICy+8wMaNG/H09KRnz560b69rdOWkzYsY/ePdzn8huvhHGRpHRKSpq3HBfUqbNm3o379/XWaRFq5D/OVY15kIsx6hOCcN78B2RkcSEWmWOnXqRKdOnYyOIY1RpmNy3EK7FxU+kfj31qUGIiIXokbXcIvUp4jQUFLNjtlz92/QddwiInXtuuuu4+WXXz6j/ZVXXuGGG24wIJE0NhXF+QDMs44k+9ZkCO9jbCARkSZOBbc0Kln+8QCU7vnR4CQiIs3PDz/8wKhRo85ov+KKK/jhhx9qfL5Zs2YRFRWFh4cHCQkJrFu37qz7XnLJJZhMpjO2K6+8ssavK/UnJzcLAJOHH51DWhmcRkSk6VPBLY2KW4dhAATm6jpuEZG6VlRUhJub2xntrq6uFBYW1uhcCxcuZPLkyUybNo2UlBR69+5NUlISWVlZVe7/6aefcuTIEee2ZcsWLBaLetYbEbvdzv6DhwGIDA/FpNnJRUQumApuaVSi44djs5toZ02nMOug0XFERJqVnj17snDhwjPaFyxYQLdu3Wp0rhkzZjBhwgTGjx9Pt27dmD17Nl5eXsybN6/K/f39/QkNDXVu3377LV5eXiq4G5Gt27fiW5ELQOf2bQ1OIyLSPNR60jSR+hAcEs4uSwydbXvY//MSeo3S8mAiInXl6aef5tprr2XPnj1cdtllACQnJ/PRRx+xaNGiap+nrKyMDRs2MGXKFGeb2WwmMTGR1atXV+scc+fO5aabbsLb2/us+5SWllJaWup8XNNeeKmB/T/R4+NRzq6YbtGauFREpC6oh1sanczABACsqd8bnEREpHkZPXo0n3/+Oampqfz+97/nj3/8I4cOHWLZsmV07Nix2ufJycnBarUSEhJSqT0kJISMjIzzHr9u3Tq2bNnCPffcc879pk+fjq+vr3OLjIysdkapGfvJ2clP2N3Y16ov5sh+BicSEWkeVHBLo+PWydHrEnF0HdjtBqcREWlerrzySn766SeKi4vZu3cvN954I4888gi9e/dusAxz586lZ8+eDBgw4Jz7TZkyhYKCAueWnp7eQAlbntyj+QB8aRvIzpH/AldPYwOJiDQTKril0enYL5FSuwvB9hyOpm83Oo6ISLPzww8/cMcddxAeHs7rr7/OZZddxpo1a6p9fGBgIBaLhczMzErtmZmZhIaGnvPY4uJiFixYwN13333e13F3d8fHx6fSJvVjQ+ohADy8WjOyx7n/NxQRkepTwS2NTkCbNmx3dUzec2jDVwanERFpHjIyMnjppZfo1KkTN9xwAz4+PpSWlvL555/z0ksv0b9//2qfy83Njfj4eJKTk51tNpuN5ORkBg0adM5jP/nkE0pLS7nttttq/V6kbqXnHedARg4A0WGBBqcREWleVHBLo5QXPNBxZ/8KY4OIiDQDo0ePJjY2lk2bNjFz5kwOHz7Mm2++eUHnnDx5MnPmzGH+/Pls376diRMnUlxczPjx4wEYN25cpUnVTpk7dy5jxowhICDggl5f6k7y9ky8KAGgY0SwwWlERJoXzVIujZJ3l0Q4/A7tC34GmxXMFqMjiYg0WV999RUPPPAAEydOpFOnTnVyzrFjx5Kdnc3UqVPJyMggLi6OpUuXOidSS0tLw2yu/Hf9nTt3snLlSr755ps6ySB1Y1dWEfEmx2zw7l6tDU4jItK8qOCWRqlrv4soTPbCx1RM5s61hHQdbHQkEZEma+XKlcydO5f4+Hi6du3K7bffzk033XTB573//vu5//77q3xu+fLlZ7TFxsZi12SYjU5WYSlenFx+zdXL2DAiIs2MhpRLo+Tj5ckOD8eMuUd+0XXcIiIXYuDAgcyZM4cjR45w3333sWDBAsLDw7HZbHz77bccO3bM6IhioJ2ZhacLbrezr4suIiI1p4JbGq0TbYcC4J6+0uAkIiLNg7e3N3fddRcrV65k8+bN/PGPf+Sll14iODiYq666yuh4YoDUrCLS807gYSpzNGg5MBGROqWCWxqt0D4jAYg5vpnykiKD04iINC+xsbG88sorHDx4kH/9619GxxGD/JqeD4APxx0N7lp6TUSkLqnglkarU9e+HCEQd1M5e9d/bXQcEZFmyWKxMGbMGBYvXmx0FDFA5jHH7OQh7ieHlHv4GRdGRKQZUsEtjZbZYmaPr2OytOItSwxOIyIi0vxkFToKbS/byZFkHr4GphERaX5UcEujZu48AoCI7B9BM9uKiIjUqczCEszY8LAWOxpUcIuI1KlGUXDPmjWLqKgoPDw8SEhIYN26dWfd9x//+Acmk6nS5uHhUWmfO++884x9Ro4cWd9vQ+pBx0GjKLW7EGLL5GjaVqPjiIiINCsHco/T6tT126CCW0SkjhlecC9cuJDJkyczbdo0UlJS6N27N0lJSWRlZZ31GB8fH44cOeLcDhw4cMY+I0eOrLSPJoRpmoL9A9jq2hOAg+t1faGIiEhdySgoYduRQnxNJ3u3Xb3Axc3YUCIizYzhBfeMGTOYMGEC48ePp1u3bsyePRsvLy/mzZt31mNMJhOhoaHOLSQk5Ix93N3dK+3Tpk2b+nwbUo/ywi8GwG3fdwYnERERaT4m/nMDAKEcdTS0CjYwjYhI82RowV1WVsaGDRtITEx0tpnNZhITE1m9evVZjysqKqJ9+/ZERkZy9dVXs3XrmUONly9fTnBwMLGxsUycOJHc3Nyznq+0tJTCwsJKmzQe/n1+B0BM8a/YSo4ZnEZERKTp2515jF/S8gGY0ONko197w/KIiDRXhhbcOTk5WK3WM3qoQ0JCyMjIqPKY2NhY5s2bxxdffMGHH36IzWZj8ODBHDx40LnPyJEjef/990lOTubll19mxYoVXHHFFVit1irPOX36dHx9fZ1bZGRk3b1JuWA9evQljRBcqWDvOs1WLiIicqG2Hj7duTB8z3THHb92BqUREWm+DB9SXlODBg1i3LhxxMXFcfHFF/Ppp58SFBTE22+/7dznpptu4qqrrqJnz56MGTOG//73v6xfv57ly5dXec4pU6ZQUFDg3NLT0xvo3Uh1uLla2Os3BICiLV8anEZERKTp25vjuG77pv6RmCyujsa2/QxMJCLSPBlacAcGBmKxWMjMzKzUnpmZSWhoaLXO4erqSp8+fUhNTT3rPjExMQQGBp51H3d3d3x8fCpt0ri4dxsFQLvsFWCreqSCiIiIVM/Bo46Zydv7uUL5yVnKu11tYCIRkebJ0ILbzc2N+Ph4kpOTnW02m43k5GQGDRpUrXNYrVY2b95MWFjYWfc5ePAgubm559xHGrdug0dRYPfG357P4S0rjI4jIiLSpGUVlgIQ6Vl2utFdHQ4iInXN8CHlkydPZs6cOcyfP5/t27czceJEiouLGT9+PADjxo1jypQpzv2fe+45vvnmG/bu3UtKSgq33XYbBw4c4J577gEcE6o9+uijrFmzhv3795OcnMzVV19Nx44dSUpKMuQ9yoXzbeXNJm/HH2Fy1y8yOI2IiEjTlnWsBIBQd8ct7r5gthiYSESkeXIxOsDYsWPJzs5m6tSpZGRkEBcXx9KlS50TqaWlpWE2n/67wNGjR5kwYQIZGRm0adOG+Ph4Vq1aRbdu3QCwWCxs2rSJ+fPnk5+fT3h4OCNGjOD555/H3d3dkPcodaO885Ww8TtCD30LdjuYTEZHEhERaXL2ZhexK7MIgGDXkwW3h6+BiUREmi+T3W63Gx2isSksLMTX15eCggJdz92IHMzOxf+trniZSim4/Vt8OwwwOpKISL3S71Fl+jwuTLnVxktf7eCn1Bx2ZDiW2dx1pytuC26AkJ4wcaXBCUVEmoaa/B4ZPqRcpLraBgWQ4uaYQfXQqoUGpxEREWlaftydzdyV+5zF9syxcbjZTg0pb2VgMhGR5ksFtzQpxR2vBKDNgaWOYeUiIiJSLalZjmHkvSP9mHVLX66OC4cKx+RpuOiyOxGR+qCCW5qUrhddR6ndhbCKg+Tv/9XoOCIiIk3CpoP5vLhkBwAXdwrkyl5hmEwmqDjh2MHFw8B0IiLNlwpuaVLahYXyq1tfANJXfmRwGhERkaZhxre7nPe7R/xmgjT1cIuI1CsV3NLkFHYaA0Dw/i80rFxERKQaXMynV/YY2jHw9BMVJ6/hVg+3iEi9UMEtTU6Xi8dSZPcgxJpB3k7NqCoiInI++3KKAXjxmp54u/9mVVhnwa0ebhGR+qCCW5qctiGBrPMYAkD2T+8bnEZERKRxO5R/gj3ZxVjMJq7sFVb5SeeQcvVwi4jUBxXc0iSVdr0OgLCDS6GizOA0IiIijdeBXEfvdvsAL3w9XSs/qR5uEZF6pYJbmqTeF11Flt0PH3shOb8uMTqOiIhIo5VV6OjFDmldRS+2erhFROqVCm5pksL9W/Nzq8sAOLr6Q4PTiIiINF4paUcBCPapohdbPdwiIvVKBbc0WW59bwagXc4K7CeOGpxGRESk8bHa7Ly/+gAAoT5V9GIX5zpu1cMtIlIvVHBLkzVoyKXsskfiThnpKzR5moiIyP/6Je30H6Rv6Ne28pP/nQw7v3TcV8EtIlIvVHBLk+Xt4cqWsGsAcN04X2tyi4iI/EZa7nGun70agKt6h9MxuHXlHbb/5/T9yIQGTCYi0nKo4JYmLXzYnZTYXQkr2UPpgXVGxxEREWk0Pv453Xl/VM/Qyk+Wn4DiLMf9R/dAWK8GTCYi0nKo4JYmbUDXGL63DAYg8/u3DU4jIiLSeOzNKQJgeLcQkrr/T8G95u+OW3cf8Apo4GQiIi2HCm5p0sxmE0e73gJASNp/oaTQ4EQiIiKNw95sx/rbNw+IxGQyVX7yyEbHrbsP/O9zIiJSZ1RwS5M39NLR7LZF4G4vJXe1Jk8TERGx2ezsz3UU3NGBrRyN1gooL3FsR/c72ka9YkxAEZEWQgW3NHntAr1ZHeCYPI21b4PNZmwgERERg2UUllBSbsPFbKJtG084lAIvR8GfQxzbkV8dO/q1NzSniEhzp4JbmoW2l9xNod2LgJI0ynd9Y3QcERERQx3IPQ5A2zaeuFrMkPodlB2rvFNgLAR2MiCdiEjLoYJbmoWLe0bzX5dEAI4m/9XgNCIiIsbKOlYCQKjvyfW1Tw0hv+hReDzdsf1+Dbi4GxNQRKSFUMEtzYLFbKK07z1Y7SaCs1dB1najI4mIiBgmq7AUgODWHlB6DDb+0/FEQCfw8HFsZv0zUESkvum/tNJsXDksgW/t/QE4+v2bBqcRERExzqke7uDW7nD4l9NPtB9sUCIRkZZJBbc0G8E+Hmxv51girNWOT6Ao2+BEIiIixsg65ujhDvHxgKMHHI1Rw8Av0sBUIiItjwpuaVYuHn41G20xuNrLKP5B13KLiEjLdGpIeZQlGxbf72gM6GBgIhGRlkkFtzQrfdv781Wb2wFw2TAPThw1OJGIiEjDyzw5pDz62PrTjR0TDUojItJyqeCWZifu8rFst0Xibi2mfNVso+OIiIg0uOyTPdwBZUccDb1vga6jDUwkItIyqeCWZmdEj3AWeNwIgG3N3x2zs4qIiLQQBSfKOVZagQUrbVLecjQGdzU2lIhIC6WCW5odi9lE9EW3sMcWhnt5AbZ1c42OJCIi0mD25xQD0K913unG6IsMSiMi0rKp4JZm6fr+Ucy3XANA+Y9/gZJCgxOJiIg0jN1ZRQDEtTr52+cfA+FxxgUSEWnBVHBLs9TK3YXgIeNItYXjXpaPfZXW5RYRkZZh15afWe8+kcePTnU0BGk4uYiIUVRwS7M1bmhH3jLfDID1p7egKMvgRCIiIvUv8MgKgkwFmLA7GjpeZmwgEZEWTAW3NFs+Hq60HzyWjbYOuFiPY//hVaMjiYiI1KuyChvuRekA5PUYD4/tg/73GJxKRKTlUsEtzdpdQ2P4q+lWAOzr34O8fQYnEhERqT+vLdnEHS7fAuAW1h28/A1OJCLSsqnglmbN18uV7oN/xw/Wnpjt5di/edroSCIiIvVm3eoVzvtenTQzuYiI0VRwS7M3YVgMMy13UGE3Y9rxH9jzvdGRRERE6lx63nHamrIBOOjeEXNwrMGJREREBbc0e75eriRdehkfWIcDYPvqT2AtNziViIhI3Vq2I4vIkwV329h+BqcRERFQwS0txB2Do/iX163k2ltjztkJ6981OpKIiEidWrUnx9nDjV87Y8OIiAiggltaCA9XC3cP78OrFWMBsC/7MxQeMTiViIhI3dmTXayCW0SkkVHBLS3GdX3bkuJ/JRttMZjKjsFXjxodSUREpE5YbXaKcw9zsWWTo6FNe2MDiYgI0EgK7lmzZhEVFYWHhwcJCQmsW7furPv+4x//wGQyVdo8PDwq7WO325k6dSphYWF4enqSmJjI7t276/ttSCPnYjHzxO968Hj5vZTbLbD9P7BtsdGxRERELlhucSkD7JtON4T2NC6MiIg4GV5wL1y4kMmTJzNt2jRSUlLo3bs3SUlJZGVlnfUYHx8fjhw54twOHDhQ6flXXnmFN954g9mzZ7N27Vq8vb1JSkqipKSkvt+ONHKXxAbTtkt/ZltHA2Bf8gicyDc2lIiIyAXKP17unDCN7teAZxtjA4mICNAICu4ZM2YwYcIExo8fT7du3Zg9ezZeXl7MmzfvrMeYTCZCQ0OdW0hIiPM5u93OzJkzeeqpp7j66qvp1asX77//PocPH+bzzz9vgHckjd3U33Xjba5ljy0MU1EmfP2k0ZFEREQuyNGiUh5x/cTxIKirsWFERMTJ0IK7rKyMDRs2kJiY6Gwzm80kJiayevXqsx5XVFRE+/btiYyM5Oqrr2br1q3O5/bt20dGRkalc/r6+pKQkHDWc5aWllJYWFhpk+arXYAX4y/qwp/KJ2DDBBs/1NByERFp0k7k/Ga0X/vBxgUREZFKDC24c3JysFqtlXqoAUJCQsjIyKjymNjYWObNm8cXX3zBhx9+iM1mY/DgwRw8eBDAeVxNzjl9+nR8fX2dW2Rk5IW+NWnkfn9JRw77xDG7wjG0nP88AIWHjQ0lIiJSS9a8/QAUmVtD9DBjw4iIiJPhQ8pratCgQYwbN464uDguvvhiPv30U4KCgnj77bdrfc4pU6ZQUFDg3NLT0+swsTRGnm4Wpl3Vnb9UXM9mWzScOAqf/R/YbEZHExERqb78dHhrAIPWTgLgiFcXgwOJiMhvGVpwBwYGYrFYyMzMrNSemZlJaGhotc7h6upKnz59SE1NBXAeV5Nzuru74+PjU2mT5i+peyiJPdryYPkkSnCHfSvgp5lGxxIREam+3V9Dzk68OAGAvf0QgwOJiMhvGVpwu7m5ER8fT3JysrPNZrORnJzMoEGDqnUOq9XK5s2bCQsLAyA6OprQ0NBK5ywsLGTt2rXVPqe0HM9e1Z1s93ZMKx/naFj2POz7wdhQIiIi1XXUce32v63DuLz8r3S4dprBgURE5LcMH1I+efJk5syZw/z589m+fTsTJ06kuLiY8ePHAzBu3DimTJni3P+5557jm2++Ye/evaSkpHDbbbdx4MAB7rnnHsAxg/lDDz3ECy+8wOLFi9m8eTPjxo0jPDycMWPGGPEWpREL9vHgiVFdWWi9hM9sF4PdBovugsIjRkcTERE5v/w0ALbaorgp6SIsFsP/aSciIr/hYnSAsWPHkp2dzdSpU8nIyCAuLo6lS5c6Jz1LS0vDbD7943H06FEmTJhARkYGbdq0IT4+nlWrVtGtWzfnPo899hjFxcXce++95OfnM3ToUJYuXYqHh0eDvz9p/Mb2i+TzXw4xZd+d9GmVRlTxPvjkTrjzv2BxNTqeiIjI2eU7ergP2gPp6qXfLBGRxsZkt9vtRodobAoLC/H19aWgoEDXc7cQabnHueKvPxBUfpCvvabhbi2CfnfDla+DyWR0PBFpofR7VJk+jyq8EgPHc7midDp/vP06EruFnP8YERG5IDX5PdK4IxEca3NPHd2N/fYwHiy9Dzsm+HkurHvH6GgiIiJVKy2C47kAHLQH0cZbPdwiIo2NCm6Rk27sF8nwbiEsrYhnrscdjsalj8Pub40NJiIiUpWT128X2L05hhe+nm4GBxIRkf+lglvkJJPJxPRrexLYyo0X8oeT4v87xyRqn4yHzK1GxxMREansZMGdbg8CIMTH3cg0IiJSBRXcIr8R2MqdV6/vDZgYe/hGcgP7Q9kx+OBaOLrf6HgiIiKnnZwwLd0eRFBrd1p7aEi5iEhjo4Jb5H9c2iWY+y6OoRwXrsqeSFlAFyjKgPfHQFGW0fFEREQAKMhKByDD7k/HoFYGpxERkaqo4BapwiMjYunXvg2HSj242zoFm287OLrP0dN9It/oeCIiIhzJzACgAG+mjOpicBoREamKCm6RKrhazLx5Sx/8vd34McOVv4S9At5BkLkZPrwOSgqMjigiIi1cybE8AHp3ak+vtn7GhhERkSqp4BY5izBfT2bc2BuTCd7caGNJ3N/Asw0c+tkxvFw93SIiYhCbzU5+Xg4Avn6BBqcREZGzUcEtcg6XxAbzyIhYAB74voLNl38Inv5wOAXevxqO5xmcUEREWqK1+/LwMRUDEBQcYnAaERE5GxXcIufx+0s68LteYVTY7Nzx1QkyrlkEXoFwZCO8fxUcyzQ6ooiItDDBK/5EX3MqAJFhYQanERGRs1HBLXIeJpOJV6/vTY8IH/KKy7hzSTHHb/nCcU13xmaYOxxy9xgdU0REWoriXDqkfQKAFQsEdDI4kIiInI0KbpFq8HSz8M7t/Qhs5c6OjGM8kFxCxZ1LoU2UYx3UuSPgUIrRMUVEpCXI3++8O7vvYmitIeUiIo2VCm6Ragr38+Tt2+NxczHz3fZMnv7xBPa7voGw3nA8B/7xO0j9zuiYIiLSzFnzDgDws60zvsGRBqcREZFzUcEtUgPx7dvwxk1xmEzwr3VpvLG2EO78EmIugfJi+OeNsPZtsNuNjioiUu9mzZpFVFQUHh4eJCQksG7dunPun5+fz6RJkwgLC8Pd3Z3OnTuzZMmSBkrbfKza8AsA6fYghnXSDOUiIo2ZCm6RGhrZI4znru4BwF++28WCX4/CLZ9A71vAboWvHoP/PAgVZQYnFRGpPwsXLmTy5MlMmzaNlJQUevfuTVJSEllZWVXuX1ZWxvDhw9m/fz+LFi1i586dzJkzh4iIiAZO3rR9/HM6+1O3AVDeqi3tA7wNTiQiIufiYnQAkabo9oHtySwo4a3vU3nis834e7sxYszfILgrfDsVUuZDbirc+D54q/dBRJqfGTNmMGHCBMaPHw/A7Nmz+fLLL5k3bx6PP/74GfvPmzePvLw8Vq1ahaurKwBRUVHnfI3S0lJKS0udjwsLC+vuDTRR3qtf40YXx+VLSUMGGJxGRETORz3cIrX0xxGdubFfW2x2mPRRCt/vyoYhD8AtC8GtNRz4Cd6+CNLXGx1VRKROlZWVsWHDBhITE51tZrOZxMREVq9eXeUxixcvZtCgQUyaNImQkBB69OjBiy++iNVqPevrTJ8+HV9fX+cWGdnCr1e2WRmR+6HzoW/HgQaGERGR6lDBLVJLJpOJF6/pyZU9wyi32rnvgw38lJoDnZPgnu8goCMUHoL3RsKav+u6bhFpNnJycrBarYSEVJ4dOyQkhIyMjCqP2bt3L4sWLcJqtbJkyRKefvppXn/9dV544YWzvs6UKVMoKChwbunp6XX6PpqcY0dwpQKAAzevgNAeBgcSEZHzUcEtcgFcLGZm3hTH8G4hlFXYuHv+etbuzYXgLjDhe+h+DdgqYOnj8MkdUFJgdGQREUPYbDaCg4N55513iI+PZ+zYsTz55JPMnj37rMe4u7vj4+NTaWvJTmTtBWC/LYSAKBXbIiJNgQpukQvkajHz1i19uCQ2iJJyG3f9Yz3r9uWBhw9c/x5c8QqYXWHbF/D3IbDvR6Mji4hckMDAQCwWC5mZmZXaMzMzCQ0NrfKYsLAwOnfujMVicbZ17dqVjIwMyso0yWR1FGU6Cu4jpiBauWsaHhGRpkAFt0gdcHexMPu2eIZ2DKS4zMq4eWtZsSsbTCZIuA/uWgptoqAgHeaPhq+fhPISo2OLiNSKm5sb8fHxJCcnO9tsNhvJyckMGjSoymOGDBlCamoqNpvN2bZr1y7CwsJwc3Or98zNQWm2o+DOc636jxoiItL4qOAWqSMerhbevaMfl57s6b5n/nqWbjnieLJtP/i/ldD3DsAOq9+COZfCkV8NzSwiUluTJ09mzpw5zJ8/n+3btzNx4kSKi4uds5aPGzeOKVOmOPefOHEieXl5PPjgg+zatYsvv/ySF198kUmTJhn1Fpoca94BAI55aCk1EZGmQgW3SB3ycLXw9u39nBOp/f6fKfx7w0HHk+6t4ao34OYF4B0EWdvgnUvhm6egrNjY4CIiNTR27Fhee+01pk6dSlxcHBs3bmTp0qXOidTS0tI4cuSIc//IyEi+/vpr1q9fT69evXjggQd48MEHq1xCTM7imOPzNPup4BYRaSpMdrumTv5fhYWF+Pr6UlBQ0OInaJHasdrsTPl0Ex//7Ci2/zSyC/93cQwmk8mxQ3EOLHkEtn7meOzXDq78C3RKPMsZRaQl0u9RZS358/hxdzatPxhBnHkvS3v+hZHX3WV0JBGRFqsmv0fq4RapBxaziZeu7cU9Q6MBeHnpDp78fAsV1pPXLnoHwg3/gFs+Bt9IyE+Df14Hi+6GY5lnP7GIiLQ4J8qs3D53HT4cByAiLMzgRCIiUl0quEXqidls4qnfdWPa6G6YTPDR2jTuef9nikorTu/UOQl+vwYGTgKTGbYsgjfj4ac3oEKz9oqICHy91bG2uY/JUXB3iWprZBwREakBFdwi9Wz8kGhm3xaPh6uZ5TuzuWH2atLzjp/ewb0VjHwRJiyD8L5Qdgy+fRr+Pgh2fWNccBERaRTmr94P2PE9WXC7evsbmkdERKpPBbdIA0jqHsqCewcR2MqN7UcK+d2bKx3Lhv1WeB+4JxmungXewZCbCh/dAB9eD5lbjQkuIiKGWrErm1/S8uliSseVkyOkPHyNDSUiItWmglukgcRF+vGfPwyld6QfBSfKufO9dcz6PpVK8xaazdDnNvjDBhj8BzC7Quq38Pch8Ol9cHS/YflFRKRhlVtt3DFvHQBjXNeefsLN26BEIiJSUyq4RRpQmK8nH983kJsHRGK3w6tf72TC+z9ztPh/rtf28IERLziu7+5+DWCHTQvgzX6w5DEoyjIkv4iINJxdmcec92/qfPLOwN/DqRUvRESk0VPBLdLA3F0sTL+2Fy9d2xM3i5nvtmcx8q8/sGpPzpk7B3Z0zGZ+73LocBnYymHd2/DXOFj2Apw42sDpRUSkoWQVlhJAAR96zcAvfZmjsW0/Y0OJiEiNqOAWMchNA9rx2aTBxAR5k1lYyq3vruXVr3dQfmrpsN8K7wO3fwbjFkNEPJQXww+vwl96wnfPQFH2mceIiEiTlnWshCss6xhq+xlKCwAThPY2OpaIiNSACm4RA3UP9+W/fxjK2H6OIeazvt/DjW//zyzmvxVzsWNitbEfQkgPx4zmK/8CM3vC0ilQeLhh34CIiNSbrMJSIk0nLyHq8jv4v5WOkU8iItJkqOAWMZiXmwsvX9+Lt27pQ2sPF35Jy+eKv/7IwvVplSdUO8Vkgq6jHf/wunmBo8e74gSs+Rv8tTf85yFNriYi0gyk5xVzn8uXjgdRwyC0h7GBRESkxlRwizQSv+sVzpIHhtGvfRuKSiv40783c+d76zlScKLqA0wmiL3C0eN9+2fQfghYy2DDe/BGX8es5hlbGvZNiIhInSnN3HX6QZiGkouINEUquEUakUh/LxbeN4gnRnXBzcXMil3ZjJjxAx+vT6+6txschXeHy2D8ErhzieO+3eqY1Xz2EHh/DKQmw9mOFxGRRunY0czTD9oPMi6IiIjUmgpukUbGYjZx70UdWPLAMOIi/ThWWsFj/97EuHnr2J9TfO6Do4Y4ersnLHMsJ2Yyw97v4cNrHWt5b/wIKsrOfQ4RETFcwYlybCcKALBqojQRkSZLBbdII9UxuBX/njiYKVc4ert/3J3DiJk/8EbybkorrOc+OCLesZzYA79AwkRw9YasrfD5RMcEa8tfgsIjDfI+RESk5vbnFOODYwJNi6evwWlERKS2VHCLNGIWs4n7Lu7A1w9dxNCOgZRV2Jjx7S6u+OuPVa/b/b/aRMEVL8HkrZD4DLQOg6IMWD4d/tIdPh4H+37QcHMRkUbm5wNH8TGdXLHCQwW3iEhT1SgK7lmzZhEVFYWHhwcJCQmsW7euWsctWLAAk8nEmDFjKrXfeeedmEymStvIkSPrIblIw4gO9OaDuwfw15viCGzlzt7sYm6Zs5ZJH6WcfQmx3/JsA0Mfhgc3wbXvQrtBjuu8t30B80fDrAGwZjacyK/39yIiIuf34/Y0XnB9z/FABbeISJNleMG9cOFCJk+ezLRp00hJSaF3794kJSWRlZV1zuP279/PI488wrBhw6p8fuTIkRw5csS5/etf/6qP+CINxmQycXVcBMl/vJjbBrbDbIIvNx3h8hkrePXrHRSVVpz/JC5u0OsGuGspTFwF/e4Gt1aQswuW/glmdHXMbr53Bdhs9f+mRETkDMdKynHZ/+PpBv8OxoUREZELYnjBPWPGDCZMmMD48ePp1q0bs2fPxsvLi3nz5p31GKvVyq233sqzzz5LTExMlfu4u7sTGhrq3Nq0aVNfb0GkQfl6uvLCmJ789w/DGBQTQFmFjVnf7+HS15bz8c/p2GzVHB4e0h1+NwP+uAOufB2Cu0H5ccfs5u9f5VjT+/sXIW9f/b4hERGpZOXuHHzsx043DJpkXBgREbkghhbcZWVlbNiwgcTERGeb2WwmMTGR1atXn/W45557juDgYO6+++6z7rN8+XKCg4OJjY1l4sSJ5ObmnnXf0tJSCgsLK20ijV23cB8+mpDAO7fH0z7Ai+xjpTy2aBNXzVrJT6nVuL77FPfW0P8eR4/3PckQPx7cfaEgDVa8DG/EwXuj4Jd/QmlRvb0fERFx2HK4AF/TyVUpul8LLu7GBhIRkVoztODOycnBarUSEhJSqT0kJISMjIwqj1m5ciVz585lzpw5Zz3vyJEjef/990lOTubll19mxYoVXHHFFVitVc/sPH36dHx9fZ1bZGRk7d+USAMymUyM6B7KNw9fxJOjutLa3YUthwq59d213PruGn5Nz6/JyaBtPxg9Ex7ZCdfNdazpjQkO/ARf/B5e6wT/vgd2fQPW8np6VyIiLdv+nOPOGcp1/baISNPmYnSAmjh27Bi33347c+bMITAw8Kz73XTTTc77PXv2pFevXnTo0IHly5dz+eWXn7H/lClTmDx5svNxYWGhim5pUtxdLEy4KIZr+0bw5rJUPlqbxk+puVyd+hNJ3UN4ZEQsnUJaV/+Erp7Q83rHVnDIMcx840eQmwqbP3Fsnv6Otb573gCRCWA2/AoVEZFmYXtGIX1PzVDu6WdoFhERuTCGFtyBgYFYLBYyMzMrtWdmZhIaGnrG/nv27GH//v2MHj3a2WY7ObGTi4sLO3fupEOHMycWiYmJITAwkNTU1CoLbnd3d9zdNVxLmr6AVu48c1V37h4azczvdvPZLwf5emsm327L5Nq+bXkosRNt23jV7KS+ETDsjzB0Mhza4Ci2t/wbirPh57mOzbcd9LzOUXyHdK+fNyci0gKk5R5nb3Yxd3t85WhQD7eISJNmaJeUm5sb8fHxJCcnO9tsNhvJyckMGjTojP27dOnC5s2b2bhxo3O76qqruPTSS9m4ceNZe6UPHjxIbm4uYWFh9fZeRBqTSH8vXr+xN18/dBFJ3UOw2WHRhoNc9toKnvxsMwePVmMpsf91asj5FS/D5B1w+2fQ+xZwa+243nvlX+Dvg+Fvg+HH1yF3T92/MRGRZm7Zjkz8+c1cMm2ijQsjIiIXzPAh5ZMnT+aOO+6gX79+DBgwgJkzZ1JcXMz48eMBGDduHBEREUyfPh0PDw969OhR6Xg/Pz8AZ3tRURHPPvss1113HaGhoezZs4fHHnuMjh07kpSU1KDvTcRonUJa8/bt/diYns8rS3ewak8u/1ybxsL16Vwf35bfX9KRdgE17PEGsLg4ru/ucJljpvNdXzt6vnd/A1lbIXkrJD8Hwd2h21XQ7WoI6uIo2kVE5KySd2QRafrN0qhdR599ZxERafQML7jHjh1LdnY2U6dOJSMjg7i4OJYuXeqcSC0tLQ1zDa4NtVgsbNq0ifnz55Ofn094eDgjRozg+eef17BxabHiIv34aMJA1uzN5c1lu/kpNZcF69P5ZMNBrukTwaRLOxId6F27k7t6Qvcxju3EUdi2GLZ+Bvt+cBTfWVth+XQI6OT4h2O3qyAsTsW3iMj/sNvtrNuXx59dvnM0tBsEZouxoURE5IKY7HZ7NRftbTkKCwvx9fWloKAAHx8fo+OI1Lmf9+fxxrJUftiVDYDZBFfHRfB/F3cgNrQGk6udy/E82PkVbF8Me5aBtez0c63DoNMI6DwSYi4Gt1oW+yLNnH6PKmvun8fR4jL6PP8ty90eJsqcCV2vgrEfGB1LRET+R01+j1RwV6G5/6CLnPJL2lHeXJbKsh2nhy8O6xTIPcNiuKhTIKa66oUuKXQMN9/2BaQmQ3nx6ecs7hB9EXROcmx+7ermNUWaAf0eVdbcP4+dGccYOXM5Oz3uxI0K+L+fILTH+Q8UEZEGVZPfI8OHlIuIcfq0a8O8O/uz+WABf1ueytdbM/hxdw4/7s6hc0gr7h4azdVxEXi4XuCQRg+f08uMVZTC/pWOAnznV5B/AFK/dWxLHoHgbo7Cu8PljuXGXNzq5s2KiDRyWcdKCKLAUWybLI65L0REpElTD3cVmvtf0EXOJj3vOO/9tJ+F69MoLrMCEODtxi0J7bh5QDvC/Tzr9gXtdsjZBbuWOiZeS1sDduvp5129IXqYo/jucBkEdNC139Ki6Peosub+eSxcn8bHny7i3+7POkb7PLTZ6EgiIlIF9XCLSK1E+nsxdXQ3HhreiYXr0nnvp30cLijhzWWpzPo+lcSuIdw2sD1DOwZiNtdB4WsyQVCsYxvyoOO67z3LHL3fe5Y51vretdSxgWO9744nZ0ePvgg821x4BhGRRmJfznHamhxza+DX3tgwIiJSJ1Rwi8gZfDxcmXBRDOOHRPH11kw+XHOA1Xtz+WZbJt9syyQqwIvbBrbn+vi2+HnV4ZBvL//TQ89tNsjc4ii89yyDtNWO9b43/MOxmcwQ0c9RfHe8HML7OpYrExFpovblFNFJBbeISLOif52KyFm5WMxc2SuMK3uFsTvzGP9cm8a/Nxxkf+5xXvhyO69+vZPRvcO5bWB7erf1rbtJ1gDMZgjr5diGPgRlxXBglWPStT3LIGcnHFzn2Fa8BO6+EHMRxFwC0Zdo+LmINDn7c45zqbPg1gSSIiLNgQpuEamWTiGteeaq7jyaFMviXw/zweoDbDtSyKINB1m04SBdw3y4sV9bxsRF0Ma7HiY6c/OGTsMdG0B+Ouz9/mQP+PdQkg/b/+PYAHwiHMPOoy92LD3mE173mURE6siv6fnszDxGpKsKbhGR5kSTplWhuU/KIlIX7HY7KWn5/HPNAf67+QhlFTYA3CxmhncPYWy/yLq71vt8bFY4vNFRfO9bAelrK6/7DRDQyVGAx1wMUcMcw9dFGjn9HlXWbD8PawVzpt1OhCmHoebN+JhOwPivoP1go5OJiEgVtA73BWq2P+gi9ST/eBlfbDzMwvXpbDtS6GyP8PPk+vi2XB/flkh/r4YLVH7CMeP5vhWw7wc4/AvYbZX3CeriWHas3SBoNxDaRGkIujQ6+j2qrLl+HiU7vsVjwfWnG8wuMHkHtAoyLpSIiJyVCu4L1Fx/0EUawpZDBXz8czqf/3KIwpIKwFHHDu4QwJi4CJJ6hOLj4dqwoU7kw4GfYO8KRxGevePMfVqFQrvfFOAhPTUJmxhOv0eVNdfP48h3bxG28km22KJoPeRu2ncd4PjvkIiINEoquC9Qc/1BF2lIJeVWvt6awSc/H2Rlao6z3c3FTGLXYK7qHcElsUF4uFoaPlxxrmPYedpqx+2hFLCVV97H1Rva9jtZgCdA2/7g3rrhs0qLpt+jyprr51H0UhdalRxhifcYRj063+g4IiJyHlqHW0QM5+Fq4eq4CK6OiyA97zhfbDzE5xsPk5pVxJLNGSzZnEFrDxeu6BHKVb0jSIjxx9Vibphw3gHQZZRjA8cQ9MO/OArwtDWOIryk4OSQ9BWOfUxmCO3pKLwj4h1bQCfHbOoiIrVVWkSrkiMAeEd0MziMiIjUNfVwV6G5/gVdxGh2u51tRwpZvPEwi389zJGCEudzfl6uJHYNYWT3UIZ2CjSm5/sUm80x7PxUAZ62xrEG+P9yaw3hcacL8Ih4x2zouhZc6oh+jyprlp9H5jb4+yAAlt+wlUu6tzU4kIiInI+GlF+gZvmDLtLI2Gx21u/P4/ONh/l6awZ5xadnFfd2s3Bpl2BG9gjlkthgWrk3gsE4BYdODj/f4BiCfmQjlB8/c79WoSeL776O2/A+4OnX0GmlmdDvUWXN8fOwbV+CeeHNbLZF0fqBVUQFehsdSUREzkMF9wVqjj/oIo1ZhdXG+v1H+XprBku3ZJBReLrn283FzNCOgVzeNZjLu4QQ6uthYNLfsFY4esEPbThdhGdtA7v1zH392kNYbwjrBWFxENoLWoc0eGRpevR7VFlz/DyKf3gL72VP8pW1P5dP+wY3F12mIiLS2OkabhFpUlwsZgZ1CGBQhwCm/q4bmw4VsHRLBku3HGF/7nGW7chi2Y4snmQLPSJ8uKxLCIldg+kR7vv/7d15WFNn3jfwbxLIBiQBAgkgCFbqvlWU4tI+HXlKbadTO3Ydaqnt1FerHa1dfVq17YyjTztXx7bj2OWt7bxPO9pxrtYuU+1j6aYd931B1IqgQMIaErYAyf3+cSAYASVKCMv3c13nysk5dw73+Sn8+HGfc+7umee7PYogwDxSWsZnSdsaagHL4dYi/PxewJbfuuR83vr5UJNUhJtHtxbjhoG8HJ2on6kvzUMIgLIgM4ttIqI+iCPc7eiLf0En6o2EEDhprcY3OVZ8k2PFwXM2XPgTKzpM5Rn5njzYCI0ygPd9d6S2ArAcAYoPScV48SGg7BSAdn70qvVSAW4eDZiGA9HDpfnCld04hzn1KMxH3vpcPIQAXjIAANZo5mL+s/8d2P4QEVGncISbiPoEmUyGIeYwDDGHYf5Ng1FW7cR3J0qQnVOCbadKUeJwYv3uc1i/+xxUQXJM7omXnmsjgEE3SksLZzVgPdZagBcfAkpypCejn90mLR4yICJJKr5NI6TX6OFAxCDOE07U25Wf9qxWhQ0OYEeIiMhfOMLdjj73F3SiPsjZ5MLOMxXIzrEiO6cEhbY6r/095tLzzmpqAEpzgOLDgPWoVJCXHAdqy9tvr1ABUUOaR8GHSIvxWiA8iYV4H8J85K2vxaP25A/Q/v1XAIAPMw7hgbTEwHaIiIg6hQ9Nu0p9LaET9XVCCORaHcjOKWn30nNjqBJTBhsxNTkKU5KNMOl6yOh3Z1SXNBffOUDJMWkKodIT7T8hHQDkwUDkNYAxGTA2F+FR10pzhqtCu7fvdNWYj7z1pXg0utz4y9o38ETZchyTJWPE8r2B7hIREXUSLyknon5FJpNhqFmHoWZdm0vPfzxVirLqBmw6WIRNB4sAAENMYZiSbMTUZCNSkyJ75r3fLUKjpeWam1q3ud2A7axUfJfkAGW5QNlJ6d7wxlqpIC89AeAL72PpBkjFeORg6TWieT18IKAI7s6zIur3lm46ioaiYkAJuFT6QHeHiIj8hAU3EfU5xlAV7k6Jx90p8XA2ubA/34btp0ux7VQZjhRWIdfqQK7Vgfe250GpkCMlMVwqwAdHYXisDoqefvm5XC7dwx0xCBj2y9btbjdgPy8V36Unm4vw5qWmVNpnPw/k/eB9PJkCMCS0FuMR1wCRg6RXQwIg78F/kCDqhSprGrBhzzk8pGi+UkXNgpuIqK/iJeXt6EuXrBGRt8qaBvz0cxm2nyrDtlNlbe79DlMHYWJiBK4fFInUQREYHqNDkKIPTNVTWyEV3uU/AxU/S68t6x1dng4ACqU0XVl4YvNywbphIKDmz0h/Yj7y1mvjcXA9kL9dus1j0uP49GAhnvl4H06pHwQAVA1/APp71gS4k0RE1Fm8pJyIqAPhIUr8cnQsfjk6FkII5JXVYNupMmw7VYpdZyrgqG9C9okSZJ8oAQCEqYIwISkCqUlSET4itpcW4NoIIOF6abmQEIDD0lyEn24uws9I6xV5gMsJlJ+SlvZoIjouxvUDeKk6kbMa+Gw+IFwAgIZB0/DEx2eRIT/gaaI3Jwaoc0RE5G8suImo35LJZBgUFYpBUaHImpQIl1vgeJEdO8+UY+eZcuw+KxXg354owbfNBXioKggpieGYkBiBcQkGjI03QKvsxT9KZTJAFyMtiVO897ldgL1QKrwrzwK2fOm1ZaktB+oqpKVofzvHVkhF98WFeHiStK6NkL4+UV9WV+kptgFg3/FTAIKRKLO0tpn4f7q/X0RE1C168W+JRERdSyGXYdQAPUYN0OPRGwbB5RbIKW4pwCuwO68c9vomfJ9biu9zSz2fGRYThusSwjF+YDiuSwjHgHANZH2hkJQ339ttSABwY9v9TgdQmd9OMZ4vvW+ql15t+UDej20/rwyTinFdHKCLlV71F6zrYgFliH/PkairnPwaOPEvaT0+FRiXKa3XV3k1c+/7G/4YJDBFcxZoBDD1Kd6aQUTUh/Ee7nb02nvEiMivWgrwXXkV2F9Qif35lSiuqm/TLipMhXHxBoyJN2BUnB6jB+hh0CoD0OMAcruBamvbQrxl3VHUueOoDe0U4i3rsdIT3NWGPjtSznzkrcfGQwjglSRpNBsAIAOeOSNdxXF2O/DBbR1/9tf/Fxh9d7d0k4iIugbv4SYi8gOFXIaRcXqMjNPjESQBAIpsddhfUIl9+VIBfqzIjlKHE/973Ir/PW71fHZgpBaj4vQYM8CAUQOkY4Sq+vCPYLm89VL1i+8bB4DGeqDqnFSE2wsBe1HzU9SLpKWqEGhwAPU2aSk51vHXUiiBUFPzFGrtvTavh0QDSq2/zpj6s7rK1mJbrZdGtSvy8O9iN77a+BP+cFFzpwhG0E3PQBFqBIbf0e3dJSKi7tOHf9sjIvK/WIMGsQYNfjk6FgBQ1+DCkcIqHDpnw+HCKhw+b0N+ea1n+fJwMQBpQHZwVKh0CXucHiNi9RgWE4YwdT95yFiwGjAmS0tH6u3tFOIt64XSw97qbYCrQSreq85d/usqwy5fmIeagJAoQMEUSZchBPDvN4Gi5geghZqkZxSc2wl8/0eIMi1uqfkZuGhmPWFIgOI/nun+/hIRUbfjbxNERF1Io1RgYlIEJiZFeLbZahtwpLAKh89LBfjh81UorqrHqZJqnCqpxif7Cz1tEyK0GBGrw/AYHYbHSotZp+4b94T7Sq2TluihHbdpcgLVJc2LtXnpYL2pXho1r3BIT2W/HE24VHhrjUCIUVpvedVGer/XhHO+8v6ocB+wdWnre+O1QMQgqeA+/Q0mA22KbQBQxwzrrh4SEVGAseAmIvIzg1aJqclRmJoc5dlW4qjHkfNVOHS+CseLqnC8yI6iqnoUVNSioKIWm4+2PsE4IkTZWoDH6DAiVodEYwiCe+P0ZF0tSAUY4qXlUoSQHvLWbjF+0baaEkC4L7hM+OTl+yGTS1OkeYpwIzDzPRbhfV35aek1YhAw9jfA8DsBVSgQMQhf7s/DSWs1AGDWlGREpfwaOP0N0FQHjLwrgJ0mIqLuxIKbiCgAosPUmDZMjWnDTJ5tFTUNyCm243iRHceL7ThWVIWfS2tQUdOA7afLsP10madtsEKGa6JCkWwKwxBTy2sY4iO0UMj74Wj45chkrSPmxsGXbut2AbUVQG0ZUFMG1JRKU6DVlDYvzdtrm/fVVUoFem3ztlJIl66z2O779rwnvQ6cBNzwtGfzNlMmFhTtBgBMTTbiiVsmSv8Ho64NRC+JiCiAWHATEfUQESFKTB5sxOTBRs+2+kYXTlodniL8eJEdOcV21DS4cMLiwAmLA19ccAxVkBzJplBcGx2Ga81huNYUimtNYYjVayBnId45cgUQGiUtneFqvKBAby7Im5z+7SMFnqsJOC8V1RvPBOOLdbs9u34ukUa2lUFy/L+HJ/bPW0KIiAgAC24ioh5NHazA6AEGjB5g8GxzuwUKbXU4VeJArqUap6wO5FodOF1SDWeTG0cL7ThaaPc6jiZYgURjCAYZQ5DUskRJ7/vdlGVdTREMhJmkhfoPe+uzF162TobDWtqmySfzJrHYJiLq51hwExH1MnK5DPERWsRHaPGLoa1FnsstcK6iFrlWR3MRLhXjP5dWo67RhZxiaXT8YuHa4OYiPBSDoloL8sTIEGiUvCya+qaKmgZU1DgRo9cgxJcp+txuYMdfUJ+/F2oAeW4zHNDiDzNGQhPc+v0SH6HFyDh913eciIh6FRbcRER9hEIuQ6IxBInGEGSMMHu2N7ncOF9Zh7yyGpwpq0FeWbW0XlqD4qp6VNY2orLAhv0FtjbHjNWrkRCpxcCIEOk1UouECOm9XttPpjCjPumet3fgdEk1/v7bVEy64DaOy8r7Hti6FOrmt6dFLHTqIGSmJnA0m4iI2mDBTUTUxwUp5J5C/KaL9tU2NOFsWS3ymgtxqSCXivGqukYUVdWjqKoeO89UtDmuXhOMgZHSSPvACG3remQIzDo1H95GPVp48x+MKmsbfftguTSl3El3HLaINGyW34DfpA5ksU1ERO1iwU1E1I9plUGe+b4vVlnTgDNl1SioqEV+eS0KyqUpy/IralHqcKKqrrF5bvGqNp9VKuQYEKFpHg3XIiEyBAkRWsRHaBBr0ECn5ug4BVbLswsqaxs6bmQrAPa+DzQ5ISBwotiBsLL9GABgm3s0Bt71MjaPjeueDhMRUa/EgpuIiNoVHqLE+JAIjB8Y0WZfbUOTNGd4SxFeLhXi5ypqcb6yFg0uN86USiPl7QlTByHOIBXfLa+xBjXiDBrEhWsQHcYRcvKvlhFu26UK7h/+GzjwIQBABmDYBbt+FrGYbA7zXweJiKhP6BEF95o1a/Dqq6/CYrFgzJgxePPNNzFx4sTLfm7Dhg24//77cccdd2DTpk2e7UIILF++HO+++y5sNhsmT56MtWvXIjk52Y9nQUTUf2iVQRhq1mGoue3IuMstUGSrw7nm0fD88loUVNQgv7wWRbY6VNY2wlHf5JnWrD1BchlMOjXiwlsKcjXiDFqY9SpEh6kRrVMhMkTFopyuWLhnhPsSl5SXnQYAiGG/wttHAbcAokJVMEabkDIiq93//0RERBcKeMH98ccfY/HixXjrrbeQmpqK1atXIyMjA7m5uYiOju7wc2fPnsVTTz2FqVOnttn3yiuv4I033sDf/vY3JCUlYenSpcjIyMDx48ehVqvbORoREXUVxQVPUZ/Uzv4aZxOKq+pQaKtHka0OhZV10mvzYqmqR1Pz1GeFtrpLfh1jqFIqwMNUiNZJryZdy3tpPTJEiSCF3H8nTL1SyyXl637Kw//syPdsj4cFd8m/RzCacI/8MHQyYOaRidjfNAgA8PkDk72m6SMiIroUmRBCBLIDqampmDBhAv7yl78AANxuN+Lj4/H444/jueeea/czLpcLN9xwAx5++GFs27YNNpvNM8IthEBsbCyefPJJPPXUUwCAqqoqmEwmfPDBB7jvvvsu2ye73Q69Xo+qqirodPzrNRFRd3K5BUodThTaaj1FeUthbrHXo8ThRHm1E+5OZi+ZDIgMUcGkU0mFeJgaJp0KUTo1jCFKRIaqEBmqhDFEBZ0mqEc9/Ir5yFtXxmPP2Qr85t2daHR5/0daE7watyl2e943CTlSnGthQxiy0gbipTtGXtXXJSKi3s+XfBTQEe6Ghgbs27cPS5Ys8WyTy+VIT0/Hjh07Ovzcyy+/jOjoaDzyyCPYtm2b1768vDxYLBakp6d7tun1eqSmpmLHjh3tFtxOpxNOp9Pz3m5vO08tERF1D4VcBrNeDbNejfED22/T5HKjvKYBJXYnShz1sF7wWuqQinKrvR5l1Q1wuQXKqp0oq3bi2GW+dpBchshQJSJCVDCGKhF5UUEeGdr8PkSJyFAltMqAXyhGV2hCYgT2Lf1P1DibvLYb/+f3QBlQN2QGXKGxaIy5DpuTfwmFTIaoMFWAektERL1VQH9TKCsrg8vlgslk8tpuMplw4sSJdj+zfft2vPfeezh48GC7+y0Wi+cYFx+zZd/FVq5ciZdeesnH3hMRUaAEKeQw6dQw6dQA9B22c7kFKmoaYLXXo7S5CC9xSMV5id2J8poGVNQ0oKzaCUd9E5rcAla7E1a7s8NjXkgdLEeEVonwECUiQpQI10qvESFKLLhpMOS8x7zn2vU2dPYitBmXsJ0FAGj+8wXAyGe/EBHR1elVf5p3OByYNWsW3n33XRiNxi477pIlS7B48WLPe7vdjvj4+C47PhERBYZCLo1KdmZk0tnkQkVNA8qrpQK8vLoB5TXO5vet6xU1DSitdqKhyY36RrdnrvILaYIV+N00Fms92sGPgOJD7e9TqAA9fw8gIqKrF9CC22g0QqFQwGq1em23Wq0wm81t2v/88884e/Ysbr/9ds82t9sNAAgKCkJubq7nc1arFTExMV7HHDt2bLv9UKlUUKl4mRgRUX+mClIgRq9BjF5z2bZCCFQ7m2CrbURFTQMqahtQ2TxaXlnbgKbO3mBOgTP6XiCx7YNXAQCJU4BgPmSViIiuXkALbqVSifHjxyM7OxszZswAIBXQ2dnZWLBgQZv2Q4cOxZEjR7y2vfDCC3A4HHj99dcRHx+P4OBgmM1mZGdnewpsu92OXbt2Yd68ef4+JSIi6gdkMhnC1MEIUwcjPkIb6O7QlUibH+geEBFRPxDwS8oXL16MrKwspKSkYOLEiVi9ejVqamowe/ZsAMCDDz6IuLg4rFy5Emq1GiNHej8d1GAwAIDX9kWLFuEPf/gDkpOTPdOCxcbGeop6IiIiIiIiIn8LeMF97733orS0FMuWLYPFYsHYsWOxZcsWz0PPCgoKIJf7Nn/qM888g5qaGsyZMwc2mw1TpkzBli1bOAc3ERERERERdZuAz8PdE3HeUyIi6gmYj7wxHkRE1BP4ko98GzomIiIiIiIiok5hwU1ERERERETkByy4iYiIiIiIiPyABTcRERFdkTVr1iAxMRFqtRqpqanYvXt3h20/+OADyGQyr4UPMyUior6OBTcRERH57OOPP8bixYuxfPly7N+/H2PGjEFGRgZKSko6/IxOp0NxcbFnyc/P78YeExERdT8W3EREROSz1157DY8++ihmz56N4cOH46233oJWq8W6des6/IxMJoPZbPYsLVOAEhER9VUsuImIiMgnDQ0N2LdvH9LT0z3b5HI50tPTsWPHjg4/V11djYEDByI+Ph533HEHjh07dsmv43Q6YbfbvRYiIqLehAU3ERER+aSsrAwul6vNCLXJZILFYmn3M0OGDMG6devw2Wef4cMPP4Tb7cakSZNw/vz5Dr/OypUrodfrPUt8fHyXngcREZG/seAmIiIiv0tLS8ODDz6IsWPH4sYbb8Qnn3yCqKgovP322x1+ZsmSJaiqqvIs586d68YeExERXb2gQHeAiIiIehej0QiFQgGr1eq13Wq1wmw2d+oYwcHBGDduHE6fPt1hG5VKBZVKdVV9JSIiCiSOcBMREZFPlEolxo8fj+zsbM82t9uN7OxspKWldeoYLpcLR44cQUxMjL+6SUREFHAc4SYiIiKfLV68GFlZWUhJScHEiROxevVq1NTUYPbs2QCABx98EHFxcVi5ciUA4OWXX8b111+PwYMHw2az4dVXX0V+fj5++9vfBvI0iIiI/IoFNxEREfns3nvvRWlpKZYtWwaLxYKxY8diy5YtngepFRQUQC5vvZCusrISjz76KCwWC8LDwzF+/Hj8+9//xvDhwwN1CkRERH4nE0KIQHeip6mqqoLBYMC5c+eg0+kC3R0iIuqn7HY74uPjYbPZoNfrA92dgGN+JiKinsCX/MwR7nY4HA4A4PQjRETUIzgcDhbcYH4mIqKepTP5mSPc7XC73SgqKkJYWBhkMtlVHavlrx/8a3znMWa+Ybx8w3j5jjHzTVfGSwgBh8OB2NhYr8uz+yvm58BizHzDePmOMfMN4+WbQOVnjnC3Qy6XY8CAAV16TJ1Ox28EHzFmvmG8fMN4+Y4x801XxYsj262Yn3sGxsw3jJfvGDPfMF6+6e78zD+XExEREREREfkBC24iIiIiIiIiP2DB7WcqlQrLly+HSqUKdFd6DcbMN4yXbxgv3zFmvmG8egf+O/mOMfMN4+U7xsw3jJdvAhUvPjSNiIiIiIiIyA84wk1ERERERETkByy4iYiIiIiIiPyABTcRERERERGRH7DgJiIiIiIiIvIDFtx+tmbNGiQmJkKtViM1NRW7d+8OdJe63cqVKzFhwgSEhYUhOjoaM2bMQG5urleb+vp6zJ8/H5GRkQgNDcXMmTNhtVq92hQUFOC2226DVqtFdHQ0nn76aTQ1NXXnqQTMqlWrIJPJsGjRIs82xsxbYWEhHnjgAURGRkKj0WDUqFHYu3evZ78QAsuWLUNMTAw0Gg3S09Nx6tQpr2NUVFQgMzMTOp0OBoMBjzzyCKqrq7v7VLqFy+XC0qVLkZSUBI1Gg2uuuQa///3vceFzNPtzzH788UfcfvvtiI2NhUwmw6ZNm7z2d1VsDh8+jKlTp0KtViM+Ph6vvPKKv0+NmjE/S5ijrw7z8+UxP/uG+fnSemV+FuQ3GzZsEEqlUqxbt04cO3ZMPProo8JgMAir1RrornWrjIwM8f7774ujR4+KgwcPiltvvVUkJCSI6upqT5u5c+eK+Ph4kZ2dLfbu3Suuv/56MWnSJM/+pqYmMXLkSJGeni4OHDggvvrqK2E0GsWSJUsCcUrdavfu3SIxMVGMHj1aLFy40LOdMWtVUVEhBg4cKB566CGxa9cucebMGfH111+L06dPe9qsWrVK6PV6sWnTJnHo0CHxq1/9SiQlJYm6ujpPm1tuuUWMGTNG7Ny5U2zbtk0MHjxY3H///YE4Jb9bsWKFiIyMFF9++aXIy8sTGzduFKGhoeL111/3tOnPMfvqq6/E888/Lz755BMBQHz66ade+7siNlVVVcJkMonMzExx9OhRsX79eqHRaMTbb7/dXafZbzE/t2KOvnLMz5fH/Ow75udL6435mQW3H02cOFHMnz/f897lconY2FixcuXKAPYq8EpKSgQA8cMPPwghhLDZbCI4OFhs3LjR0yYnJ0cAEDt27BBCSN9ccrlcWCwWT5u1a9cKnU4nnE5n955AN3I4HCI5OVls3bpV3HjjjZ6Ezph5e/bZZ8WUKVM63O92u4XZbBavvvqqZ5vNZhMqlUqsX79eCCHE8ePHBQCxZ88eT5vNmzcLmUwmCgsL/df5ALntttvEww8/7LXt17/+tcjMzBRCMGYXujihd1Vs/vrXv4rw8HCv78dnn31WDBkyxM9nRMzPHWOO7hzm585hfvYd83Pn9Zb8zEvK/aShoQH79u1Denq6Z5tcLkd6ejp27NgRwJ4FXlVVFQAgIiICALBv3z40NjZ6xWro0KFISEjwxGrHjh0YNWoUTCaTp01GRgbsdjuOHTvWjb3vXvPnz8dtt93mFRuAMbvY559/jpSUFNx9992Ijo7GuHHj8O6773r25+XlwWKxeMVLr9cjNTXVK14GgwEpKSmeNunp6ZDL5di1a1f3nUw3mTRpErKzs3Hy5EkAwKFDh7B9+3ZMnz4dAGN2KV0Vmx07duCGG26AUqn0tMnIyEBubi4qKyu76Wz6H+bnS2OO7hzm585hfvYd8/OV66n5OehKT4guraysDC6Xy+uHKQCYTCacOHEiQL0KPLfbjUWLFmHy5MkYOXIkAMBisUCpVMJgMHi1NZlMsFgsnjbtxbJlX1+0YcMG7N+/H3v27GmzjzHzdubMGaxduxaLFy/Gf/3Xf2HPnj343e9+B6VSiaysLM/5thePC+MVHR3ttT8oKAgRERF9Ll4A8Nxzz8Fut2Po0KFQKBRwuVxYsWIFMjMzAYAxu4Suio3FYkFSUlKbY7TsCw8P90v/+zvm544xR3cO83PnMT/7jvn5yvXU/MyCm7rV/PnzcfToUWzfvj3QXenRzp07h4ULF2Lr1q1Qq9WB7k6P53a7kZKSgj/+8Y8AgHHjxuHo0aN46623kJWVFeDe9Uz/+Mc/8NFHH+Hvf/87RowYgYMHD2LRokWIjY1lzIj6Keboy2N+9g3zs++Yn/seXlLuJ0ajEQqFos1TKa1WK8xmc4B6FVgLFizAl19+ie+++w4DBgzwbDebzWhoaIDNZvNqf2GszGZzu7Fs2dfX7Nu3DyUlJbjuuusQFBSEoKAg/PDDD3jjjTcQFBQEk8nEmF0gJiYGw4cP99o2bNgwFBQUAGg930t9P5rNZpSUlHjtb2pqQkVFRZ+LFwA8/fTTeO6553Dfffdh1KhRmDVrFp544gmsXLkSAGN2KV0Vm/70PdqTMD+3jzm6c5iffcP87Dvm5yvXU/MzC24/USqVGD9+PLKzsz3b3G43srOzkZaWFsCedT8hBBYsWIBPP/0U3377bZtLNMaPH4/g4GCvWOXm5qKgoMATq7S0NBw5csTrG2Tr1q3Q6XRtfpD3BdOmTcORI0dw8OBBz5KSkoLMzEzPOmPWavLkyW2msTl58iQGDhwIAEhKSoLZbPaKl91ux65du7ziZbPZsG/fPk+bb7/9Fm63G6mpqd1wFt2rtrYWcrl3ClAoFHC73QAYs0vpqtikpaXhxx9/RGNjo6fN1q1bMWTIEF5O7kfMz96Yo33D/Owb5mffMT9fuR6bn6/oUWvUKRs2bBAqlUp88MEH4vjx42LOnDnCYDB4PZWyP5g3b57Q6/Xi+++/F8XFxZ6ltrbW02bu3LkiISFBfPvtt2Lv3r0iLS1NpKWlefa3TKFx8803i4MHD4otW7aIqKioPjmFRkcufAqqEIzZhXbv3i2CgoLEihUrxKlTp8RHH30ktFqt+PDDDz1tVq1aJQwGg/jss8/E4cOHxR133NHuNBHjxo0Tu3btEtu3bxfJycl9YgqN9mRlZYm4uDjPtCOffPKJMBqN4plnnvG06c8xczgc4sCBA+LAgQMCgHjttdfEgQMHRH5+vhCia2Jjs9mEyWQSs2bNEkePHhUbNmwQWq2W04J1A+bnVszRV4/5uWPMz75jfr603pifWXD72ZtvvikSEhKEUqkUEydOFDt37gx0l7odgHaX999/39Omrq5OPPbYYyI8PFxotVpx5513iuLiYq/jnD17VkyfPl1oNBphNBrFk08+KRobG7v5bALn4oTOmHn74osvxMiRI4VKpRJDhw4V77zzjtd+t9stli5dKkwmk1CpVGLatGkiNzfXq015ebm4//77RWhoqNDpdGL27NnC4XB052l0G7vdLhYuXCgSEhKEWq0WgwYNEs8//7zXFBj9OWbfffdduz+3srKyhBBdF5tDhw6JKVOmCJVKJeLi4sSqVau66xT7PeZnCXP01WN+vjTmZ98wP19ab8zPMiGE8H1cnIiIiIiIiIguhfdwExEREREREfkBC24iIiIiIiIiP2DBTUREREREROQHLLiJiIiIiIiI/IAFNxEREREREZEfsOAmIiIiIiIi8gMW3ERERERERER+wIKbiIiIiIiIyA9YcBNRwMlkMmzatCnQ3SAiIqILMD8TXT0W3ET93EMPPQSZTNZmueWWWwLdNSIion6L+ZmobwgKdAeIKPBuueUWvP/++17bVCpVgHpDREREAPMzUV/AEW4igkqlgtls9lrCw8MBSJeTrV27FtOnT4dGo8GgQYPwz3/+0+vzR44cwS9+8QtoNBpERkZizpw5qK6u9mqzbt06jBgxAiqVCjExMViwYIHX/rKyMtx5553QarVITk7G559/7tlXWVmJzMxMREVFQaPRIDk5uc0vIERERH0N8zNR78eCm4gua+nSpZg5cyYOHTqEzMxM3HfffcjJyQEA1NTUICMjA+Hh4dizZw82btyIb775xithr127FvPnz8ecOXNw5MgRfP755xg8eLDX13jppZdwzz334PDhw7j11luRmZmJiooKz9c/fvw4Nm/ejJycHKxduxZGo7H7AkBERNQDMT8T9QKCiPq1rKwsoVAoREhIiNeyYsUKIYQQAMTcuXO9PpOamirmzZsnhBDinXfeEeHh4aK6utqz/1//+peQy+XCYrEIIYSIjY0Vzz//fId9ACBeeOEFz/vq6moBQGzevFkIIcTtt98uZs+e3TUnTERE1AswPxP1DbyHm4hw0003Ye3atV7bIiIiPOtpaWle+9LS0nDw4EEAQE5ODsaMGYOQkBDP/smTJ8PtdiM3NxcymQxFRUWYNm3aJfswevRoz3pISAh0Oh1KSkoAAPPmzcPMmTOxf/9+3HzzzZgxYwYmTZp0RedKRETUWzA/E/V+LLiJCCEhIW0uIesqGo2mU+2Cg4O93stkMrjdbgDA9OnTkZ+fj6+++gpbt27FtGnTMH/+fPzpT3/q8v4SERH1FMzPRL0f7+EmosvauXNnm/fDhg0DAAwbNgyHDh1CTU2NZ/9PP/0EuVyOIUOGICwsDImJicjOzr6qPkRFRSErKwsffvghVq9ejXfeeeeqjkdERNTbMT8T9Xwc4SYiOJ1OWCwWr21BQUGeB59s3LgRKSkpmDJlCj766CPs3r0b7733HgAgMzMTy5cvR1ZWFl588UWUlpbi8ccfx6xZs2AymQAAL774IubOnYvo6GhMnz4dDocDP/30Ex5//PFO9W/ZsmUYP348RowYAafTiS+//NLzCwUREVFfxfxM1Pux4CYibNmyBTExMV7bhgwZghMnTgCQnlC6YcMGPPbYY4iJicH69esxfPhwAIBWq8XXX3+NhQsXYsKECdBqtZg5cyZee+01z7GysrJQX1+PP//5z3jqqadgNBpx1113dbp/SqUSS5YswdmzZ6HRaDB16lRs2LChC86ciIio52J+Jur9ZEIIEehOEFHPJZPJ8Omnn2LGjBmB7goRERE1Y34m6h14DzcRERERERGRH7DgJiIiIiIiIvIDXlJORERERERE5Acc4SYiIiIiIiLyAxbcRERERERERH7AgpuIiIiIiIjID1hwExEREREREfkBC24iIiIiIiIiP2DBTUREREREROQHLLiJiIiIiIiI/IAFNxEREREREZEf/H8rxRwfOwOqAAAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 1000x500 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.figure(figsize=(10, 5))\n",
+    "\n",
+    "plt.subplot(1, 2, 1)\n",
+    "plt.plot(training_cost, label='Train')\n",
+    "plt.plot(testing_cost, label='Test')\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Cost')\n",
+    "plt.legend()\n",
+    "\n",
+    "plt.subplot(1, 2, 2)\n",
+    "plt.plot(training_accuracy, label='Train')\n",
+    "plt.plot(testing_accuracy, label='Test')\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Accuracy')\n",
+    "plt.legend()\n",
+    "\n",
+    "plt.tight_layout()\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/maximum_vertex_weight_clique.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/maximum_vertex_weight_clique.ipynb.txt
new file mode 100644
index 0000000000..1b25ce1f3f
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/maximum_vertex_weight_clique.ipynb.txt
@@ -0,0 +1,325 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Molecular docking via DC-QAOA\n",
+    "\n",
+    "The data of the clique graph for the molecular docking are taken from this [paper](https://arxiv.org/pdf/2308.04098)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "import numpy as np\n",
+    "\n",
+    "# GPU: Default If an NVIDIA GPU and CUDA runtime libraries are available\n",
+    "#cudaq.set_target('nvidia')\n",
+    "\n",
+    "# CPU\n",
+    "cudaq.set_target('qpp-cpu')\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Edges:  [[0, 1], [0, 2], [0, 4], [0, 5], [1, 2], [1, 3], [1, 5], [2, 3], [2, 4], [3, 4], [3, 5], [4, 5]]\n",
+      "Non-Edges:  [[0, 3], [1, 4], [2, 5]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# The two graphs input from the paper\n",
+    "\n",
+    "# BIG 1\n",
+    "\n",
+    "nodes = [0,1,2,3,4,5]\n",
+    "qubit_num=len(nodes)\n",
+    "edges = [[0,1],[0,2],[0,4],[0,5],[1,2],[1,3],[1,5],[2,3],[2,4],[3,4],[3,5],[4,5]]\n",
+    "non_edges = [[u,v] for u in nodes for v in nodes if u<v and [u,v] not in edges]\n",
+    "print('Edges: ', edges)\n",
+    "print('Non-Edges: ', non_edges)\n",
+    "weights = [0.6686,0.6686,0.6686,0.1453,0.1453,0.1453]\n",
+    "penalty = 6.0\n",
+    "num_layers = 3\n",
+    "\n",
+    "# BIG 2 (More expensive simulation)\n",
+    "\n",
+    "#nodes=[0,1,2,3,4,5,6,7]\n",
+    "#qubit_num=len(nodes)\n",
+    "#edges=[[0,1],[0,2],[0,5],[0,6],[0,7],[1,2],[1,4],[1,6],[1,7],[2,4],[2,5],[2,7],[3,4],[3,5],[3,6],\\\n",
+    "#    [4,5],[4,6],[5,6]]\n",
+    "#non_edges=[[u,v] for u in nodes for v in nodes if u<v and [u,v] not in edges]\n",
+    "#print('Edges: ', edges)\n",
+    "#print('Non-edges: ', non_edges)\n",
+    "#weights=[0.6686,0.6686,0.6886,0.1091,0.0770,0.0770,0.0770,0.0770]\n",
+    "#penalty=8.0\n",
+    "#num_layers=8"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Generate the Hamiltonian\n",
+    "def ham_clique(penalty, nodes, weights, non_edges)-> cudaq.SpinOperator:\n",
+    "    \n",
+    "    spin_ham = 0.0\n",
+    "    for wt,node in zip(weights,nodes):\n",
+    "        #print(wt,node)\n",
+    "        spin_ham += 0.5 * wt * spin.z(node)\n",
+    "        spin_ham -= 0.5 * wt * spin.i(node)\n",
+    "    \n",
+    "    for non_edge in non_edges:\n",
+    "        u,v=(non_edge[0],non_edge[1])\n",
+    "        #print(u,v)\n",
+    "        spin_ham += penalty/4.0 * (spin.z(u)*spin.z(v)-spin.z(u)-spin.z(v)+spin.i(u)*spin.i(v))\n",
+    "    \n",
+    "    return spin_ham   "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Collect coefficients from a spin operator so we can pass them to a kernel\n",
+    "def term_coefficients(ham: cudaq.SpinOperator) -> list[complex]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.get_coefficient()))\n",
+    "    return result\n",
+    "\n",
+    "    # Collect Pauli words from a spin operator so we can pass them to a kernel\n",
+    "def term_words(ham: cudaq.SpinOperator) -> list[str]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.to_string(False)))\n",
+    "    return result\n",
+    "    "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def dc_qaoa(qubit_num:int, num_layers:int,thetas:list[float],\\\n",
+    "    coef:list[complex], words:list[cudaq.pauli_word]):\n",
+    "    \n",
+    "    qubits=cudaq.qvector(qubit_num)\n",
+    "    \n",
+    "    h(qubits)\n",
+    "    \n",
+    "    count=0\n",
+    "    for p in range(num_layers):\n",
+    "        \n",
+    "        for i in range(len(coef)):\n",
+    "            exp_pauli(thetas[count]*coef[i].real,qubits,words[i])\n",
+    "            count+=1\n",
+    "        \n",
+    "        for j in range(qubit_num):\n",
+    "            rx(thetas[count],qubits[j])\n",
+    "            count+=1 \n",
+    "        \n",
+    "        for k in range(qubit_num):\n",
+    "            ry(thetas[count],qubits[k])\n",
+    "            count+=1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[1.5+0j] IIZIIZ\n",
+      "[1.5+0j] ZIIZII\n",
+      "[-1.1657+0j] IZIIII\n",
+      "[1.5+0j] IZIIZI\n",
+      "[-1.42735+0j] IIIZII\n",
+      "[3.2791499999999996+0j] IIIIII\n",
+      "[-1.1657+0j] IIZIII\n",
+      "[-1.42735+0j] IIIIIZ\n",
+      "[-1.1657+0j] ZIIIII\n",
+      "[-1.42735+0j] IIIIZI\n",
+      "\n",
+      "[(1.5+0j), (1.5+0j), (-1.1657+0j), (1.5+0j), (-1.42735+0j), (3.2791499999999996+0j), (-1.1657+0j), (-1.42735+0j), (-1.1657+0j), (-1.42735+0j)]\n",
+      "['IIZIIZ', 'ZIIZII', 'IZIIII', 'IZIIZI', 'IIIZII', 'IIIIII', 'IIZIII', 'IIIIIZ', 'ZIIIII', 'IIIIZI']\n"
+     ]
+    }
+   ],
+   "source": [
+    "ham= ham_clique(penalty,nodes,weights,non_edges)\n",
+    "print(ham)\n",
+    "\n",
+    "coef=term_coefficients(ham)\n",
+    "words=term_words(ham)\n",
+    "\n",
+    "print(term_coefficients(ham))\n",
+    "print(term_words(ham))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Total number of parameters:  66\n",
+      "Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064, 0.37118004688049144, -0.03656087558321203, 0.08564174998504231, 0.21639801853794682, 0.11122286088634259, 0.1743727097033635, -0.36518146001762486, -0.15829741539542244, -0.3467434780387345, 0.28043500852894776, -0.09986021299050934, 0.14125225086023052, -0.19141728018199775, -0.11970943368650361, -0.3853063093646483, -0.1112643868789806, 0.3527177454825464, -0.22156160012057186, -0.1418496891385843, 0.32811766468303116, -0.367642000671186, -0.34158180583996006, 0.10196745745501312, 0.29359239180502594, -0.3858537615546677, 0.19366130907065582, 0.24570488114056754, -0.3332307385378807, 0.12287973244618389, 0.007274514934614895, -0.015799547372526146, 0.3578070967202224, -0.39268963055535144, -0.19872246354138554, 0.16668715544467982, -0.13777293592446055, -0.17514665212709513, 0.15350249947988204, 0.32872977428061945, -0.20068831419712105, -0.032919322131134854, -0.19399909325771983, -0.09477141125241506, 0.08210460401106645, 0.21392577760158515, -0.3393568044538389, 0.14615087942938465, 0.03790339186006314, -0.2843250892879255, -0.3151384847055956, -0.19983741137121905, -0.27348611567665115, 0.33457528180906904, 0.14145414847455462, -0.20604220093940323, 0.05410235084309195, 0.04447870918600966, -0.3355714098595045, 0.266806440171265, -0.07436189654442632, -0.2789176729721685, -0.2427508182662484]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Optimizer\n",
+    "\n",
+    "# Specify the optimizer and its initial parameters.\n",
+    "optimizer = cudaq.optimizers.NelderMead()\n",
+    "#optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "np.random.seed(13)\n",
+    "cudaq.set_random_seed(13)\n",
+    "\n",
+    "# if dc_qaoa used\n",
+    "parameter_count=(2*qubit_num+len(coef))*num_layers\n",
+    "\n",
+    "# if qaoa used\n",
+    "# parameter_count=(qubit_num+len(coef))*num_layers\n",
+    "\n",
+    "print('Total number of parameters: ', parameter_count)\n",
+    "optimizer.initial_parameters = np.random.uniform(-np.pi/8 , np.pi/8 ,parameter_count)\n",
+    "print(\"Initial parameters = \", optimizer.initial_parameters)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "optimal_expectation = -2.0057970170760537\n",
+      "optimal_parameters = [2.0617900450255213, -0.008832997414504553, 0.5446745231437978, 0.9170743966952536, 0.5684145055308018, 0.45653992738579674, 0.48765328828009236, 0.08690545932812363, 0.4396413285058074, 0.18459993158979182, -1.309747594917737, 1.2588385005776594, -0.834255663515425, 0.674712608431175, -0.40174553656823186, 0.1936475123928361, 0.11292461472367524, -0.40520422214477836, 0.5249647407525035, -0.8276837818165452, 0.2945660883282474, -0.8060498989662159, 0.08051672267342141, 0.016438756265571293, 1.5245041151262497, 1.4087477995498743, 0.24688680789607903, 2.1121838066265077, 1.1445970943333728, -0.22281558391261153, 0.29034932090910637, -1.0492037973620043, 0.2734013684834806, 0.5265417924961102, 0.5099056677967553, 0.8636684922225737, -0.6164906874232119, -0.42851259141848624, 0.09675272347583658, 0.05697275350531247, -0.7102412317670379, -0.11174687408874051, 0.32505750242276577, -0.4397450017834574, -0.023604090020531092, 2.072436348972407, -0.38357054930488194, 0.13613334013073858, -0.10505045798768743, 2.0359359294549595, -0.24377425227508304, 0.10609870738840588, -0.2073332743736556, 0.07232539343493427, -0.6190529241716675, -0.03799182564866846, 0.17548654124993912, 0.5257077568577536, -0.23376653076971432, 0.3391308272563698, 0.4193139961661264, 0.02390444901420668, 0.2521154835623746, 1.1843328649807838, -0.6609672889772077, -0.2612231428844001]\n"
+     ]
+    }
+   ],
+   "source": [
+    "cost_values=[]\n",
+    "def objective(parameters):\n",
+    "\n",
+    "    cost=cudaq.observe(dc_qaoa, ham, qubit_num, num_layers, parameters,coef,words).expectation()\n",
+    "    cost_values.append(cost)\n",
+    "    return cost\n",
+    "\n",
+    "# Optimize!\n",
+    "optimal_expectation, optimal_parameters = optimizer.optimize(\n",
+    "    dimensions=parameter_count, function=objective)\n",
+    "\n",
+    "print('optimal_expectation =', optimal_expectation)\n",
+    "print('optimal_parameters =', optimal_parameters)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 111000:200000 }\n",
+      "\n",
+      "The MVWCP is given by the partition:  111000\n",
+      "The MVWCP is given by the partition:  111000\n"
+     ]
+    }
+   ],
+   "source": [
+    "shots=200000\n",
+    "\n",
+    "counts = cudaq.sample(dc_qaoa, qubit_num, num_layers, optimal_parameters,coef,words, shots_count=shots)\n",
+    "print(counts)\n",
+    "\n",
+    "print('The MVWCP is given by the partition: ', max(counts, key=lambda x: counts[x]))\n",
+    "\n",
+    "# Alternative\n",
+    "print('The MVWCP is given by the partition: ', counts.most_probable())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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17/+VZGRkUpISCg3c1GnTh01b97ca1mzZs20f/9+SRf25Up/H2rXrq2srCyv9efOndOxY8f8mi+7jRkzxnP0qFWrVho0aJB+//vfe44ulqe5sArlfl9uTGmcl/PF6Mcff9TSpUs9R42k8jMfX331lbKyspScnOz5t/THH3/U448/rvr160sqXXNBOSqBqKgotW/fXsuWLfMsc7vdWrZsmTp16mRjspIxxmjEiBGaP3++li9frgYNGnitb9++vSpUqOC137t379b+/fs9+92pUydt27bN6w/6+X8Uzv+C7dSpk9c2zo8pTXPXvXt3bdu2TWlpaZ5Hhw4dNHDgQM/P5WUuunTpctEtHb799ltdddVVkqQGDRqodu3aXvuRk5Ojb775xmsuTpw4odTUVM+Y5cuXy+12q2PHjp4xq1evVkFBgWfM0qVL1aRJE1WtWjVo++eP06dPy+n0/uczIiJCbrdbUvmaC6tQ7nc4/J2RLhSj7777Tl9++aWqV6/utb68zMegQYO0detWr39LExMTNWbMGC1ZskRSKZsLn0/dxiXNmTPHuFwuM3v2bLNjxw7z8MMPmypVqnhdmRRuhg0bZuLj483KlSvNoUOHPI/Tp097xgwdOtQkJyeb5cuXm40bN5pOnTqZTp06edafv3y9Z8+eJi0tzSxevNjUrFnzkpevjxkzxuzcudNMnz691F2+finWq9WMKT9zsX79ehMZGWmmTJlivvvuO/Pee++ZmJgY889//tMzZtq0aaZKlSrm008/NVu3bjV33HHHJS/jbtu2rfnmm2/M119/bRo3bux1qe6JEydMQkKCGTRokElPTzdz5swxMTExpepS/pSUFFO3bl3Ppfzz5s0zNWrUME888YRnTFmdi5MnT5rNmzebzZs3G0nmpZdeMps3b/ZcfRWq/V6zZo2JjIw0L774otm5c6eZNGmSLZfyX2k+8vPzza9//WtTr149k5aW5vXvqfVqq7IyH0X92filX16tZkzpmQvKUQC89tprJjk52URFRZnrr7/erFu3zu5IJSLpko933nnHM+bMmTPmd7/7nalataqJiYkxd955pzl06JDXdn744QfTu3dvEx0dbWrUqGEef/xxU1BQ4DVmxYoV5tprrzVRUVGmYcOGXu9RWv2yHJWnufj8889Ny5YtjcvlMk2bNjVvvfWW13q3220mTJhgEhISjMvlMt27dze7d+/2GvPTTz+Z++67z1SuXNnExcWZBx980Jw8edJrzJYtW8yNN95oXC6XqVu3rpk2bVrQ980fOTk5ZuTIkSY5OdlUrFjRNGzY0IwbN87rF15ZnYsVK1Zc8t+HlJQUY0xo9/ujjz4y11xzjYmKijItWrQwCxYsCNp+X86V5mPfvn2X/fd0xYoVnm2Ulfko6s/GL12qHJWWuXAYY7mlKwAAQDnHOUcAAAAWlCMAAAALyhEAAIAF5QgAAMCCcgQAAGBBOQIAALCgHAEAAFhQjgAAACwoRwDKFYfDoU8++cTuGABKMcoRgJAZPHiwHA7HRY/bbrvN7mgA4BFpdwAA5cttt92md955x2uZy+WyKQ0AXIwjRwBCyuVyqXbt2l6PqlWrSvr5I68ZM2aod+/eio6OVsOGDfXxxx97vX7btm3q1q2boqOjVb16dT388MPKzc31GjNr1iy1aNFCLpdLderU0YgRI7zWHz16VHfeeadiYmLUuHFjffbZZ551x48f18CBA1WzZk1FR0ercePGF5U5AGUb5QhAqTJhwgTdfffd2rJliwYOHKh7771XO3fulCSdOnVKvXr1UtWqVbVhwwbNnTtXX375pVf5mTFjhoYPH66HH35Y27Zt02effaZGjRp5vcfkyZN1zz33aOvWrerTp48GDhyoY8eOed5/x44dWrRokXbu3KkZM2aoRo0aoZsAAPYzABAiKSkpJiIiwlSqVMnrMWXKFGOMMZLM0KFDvV7TsWNHM2zYMGOMMW+99ZapWrWqyc3N9axfsGCBcTqdJjMz0xhjTGJiohk3btxlM0gy48eP9zzPzc01ksyiRYuMMcb069fPPPjgg4HZYQBhiXOOAIRU165dNWPGDK9l1apV8/zcqVMnr3WdOnVSWlqaJGnnzp1q06aNKlWq5FnfpUsXud1u7d69Ww6HQwcPHlT37t2vmKF169aenytVqqS4uDhlZWVJkoYNG6a7775bmzZtUs+ePdW/f3917ty5WPsKIDxRjgCEVKVKlS76mCtQoqOjfRpXoUIFr+cOh0Nut1uS1Lt3b/34449auHChli5dqu7du2v48OF68cUXA54XQOnEOUcASpV169Zd9LxZs2aSpGbNmmnLli06deqUZ/2aNWvkdDrVpEkTxcbGqn79+lq2bFmJMtSsWVMpKSn65z//qVdeeUVvvfVWibYHILxw5AhASOXl5SkzM9NrWWRkpOek57lz56pDhw668cYb9d5772n9+vV6++23JUkDBw7UpEmTlJKSoqefflpHjhzRo48+qkGDBikhIUGS9PTTT2vo0KGqVauWevfurZMnT2rNmjV69NFHfco3ceJEtW/fXi1atFBeXp6++OILTzkDUD5QjgCE1OLFi1WnTh2vZU2aNNGuXbsk/Xwl2Zw5c/S73/1OderU0QcffKDmzZtLkmJiYrRkyRKNHDlS1113nWJiYnT33XfrpZde8mwrJSVFZ8+e1csvv6w//OEPqlGjhv7nf/7H53xRUVEaO3asfvjhB0VHR+tXv/qV5syZE4A9BxAuHMYYY3cIAJB+Pvdn/vz56t+/v91RAJRjnHMEAABgQTkCAACw4JwjAKUGn/IDKA04cgQAAGBBOQIAALCgHAEAAFhQjgAAACwoRwAAABaUIwAAAAvKEQAAgAXlCAAAwOL/ASxEkL8STAhjAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "x_values = list(range(len(cost_values)))\n",
+    "y_values = cost_values\n",
+    "\n",
+    "plt.plot(x_values, y_values)\n",
+    "\n",
+    "plt.xlabel(\"Epochs\")\n",
+    "plt.ylabel(\"Cost Value\")\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/noisy_simulations.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/noisy_simulations.ipynb.txt
new file mode 100644
index 0000000000..40b0834663
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/noisy_simulations.ipynb.txt
@@ -0,0 +1,206 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Noisy Simulation \n",
+    "\n",
+    "Quantum noise can be characterized into coherent and incoherent sources of errors that arise during a computation. Coherent noise is commonly due to systematic errors originating from device miscalibrations, for example, gates implementing a rotation $\\theta + \\epsilon$ instead of $\\theta$.\n",
+    "\n",
+    "Incoherent noise has its origins in quantum states being entangled with the environment due to decoherence. This leads to mixed states which are probability distributions over pure states and are described by employing the density matrix formalism. \n",
+    "\n",
+    "We can model incoherent noise via quantum channels which are linear, completely positive, and trace preserving maps. These maps are called Kraus operators, $\\{ K_i \\}$, which satisfy the condition $\\sum_{i} K_i^\\dagger K_i = \\mathbb{I}$. \n",
+    "\n",
+    "The bit-flip channel flips the qubit with probability $p$ and leaves it unchanged with probability $1-p$. This can be represented by employing Kraus operators: \n",
+    "\n",
+    "$$K_0 = \\sqrt{1-p} \\begin{pmatrix}\n",
+    "    1 & 0 \\\\\n",
+    "    0 & 1\n",
+    "\\end{pmatrix}$$\n",
+    "\n",
+    "$$K_1 = \\sqrt{p} \\begin{pmatrix}\n",
+    "  0 & 1 \\\\\n",
+    "  1 & 0\n",
+    "\\end{pmatrix}$$\n",
+    "\n",
+    "Let's implement the bit-flip channel using CUDA-Q:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "# To model quantum noise, we need to utilize the density matrix simulator target.\n",
+    "cudaq.set_target(\"density-matrix-cpu\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮\n",
+      "q0 : ┤ x ├\n",
+      "     ├───┤\n",
+      "q1 : ┤ x ├\n",
+      "     ╰───╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Let's define a simple kernel that we will add noise to.\n",
+    "qubit_count = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(qubit_count: int):\n",
+    "    qvector = cudaq.qvector(qubit_count)\n",
+    "    x(qvector)\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(kernel, qubit_count))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11:1000 }\n"
+     ]
+    }
+   ],
+   "source": [
+    "# In the ideal noiseless case, we get |11> 100% of the time.\n",
+    "\n",
+    "ideal_counts = cudaq.sample(kernel, qubit_count, shots_count=1000)\n",
+    "ideal_counts.dump()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11:850 10:88 01:56 00:6 }\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First, we will define an out of the box noise channel. In this case,\n",
+    "# we choose depolarization noise. This depolarization will result in\n",
+    "# the qubit state decaying into a mix of the basis states, |0> and |1>,\n",
+    "# with our provided probability.\n",
+    "error_probability = 0.1\n",
+    "depolarization_channel = cudaq.DepolarizationChannel(error_probability)\n",
+    "\n",
+    "# We can also define our own, custom noise channels through\n",
+    "# Kraus operators. Here we will define two operators representing\n",
+    "# bit flip errors.\n",
+    "\n",
+    "# Define the Kraus Error Operator as a complex ndarray.\n",
+    "kraus_0 = np.sqrt(1 - error_probability) * np.array([[1.0, 0.0], [0.0, 1.0]],\n",
+    "                                                    dtype=np.complex128)\n",
+    "kraus_1 = np.sqrt(error_probability) * np.array([[0.0, 1.0], [1.0, 0.0]],\n",
+    "                                                dtype=np.complex128)\n",
+    "\n",
+    "# Add the Kraus Operator to create a quantum channel.\n",
+    "bitflip_channel = cudaq.KrausChannel([kraus_0, kraus_1])\n",
+    "\n",
+    "# Add the two channels to our Noise Model.\n",
+    "noise_model = cudaq.NoiseModel()\n",
+    "\n",
+    "# Apply the depolarization channel to any X-gate on the 0th qubit.\n",
+    "noise_model.add_channel(\"x\", [0], depolarization_channel)\n",
+    "# Apply the bitflip channel to any X-gate on the 1st qubit.\n",
+    "noise_model.add_channel(\"x\", [1], bitflip_channel)\n",
+    "\n",
+    "# Due to the impact of noise, our measurements will no longer be uniformly\n",
+    "# in the |11> state.\n",
+    "noisy_counts = cudaq.sample(kernel,\n",
+    "                            qubit_count,\n",
+    "                            noise_model=noise_model,\n",
+    "                            shots_count=1000)\n",
+    "noisy_counts.dump()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "-0.8666666666666666"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# We can also use noise models with the observe function\n",
+    "\n",
+    "hamiltonian = spin.z(0)\n",
+    "\n",
+    "noisy_result = cudaq.observe(kernel,\n",
+    "                             hamiltonian,\n",
+    "                             qubit_count,\n",
+    "                             noise_model=noise_model)\n",
+    "\n",
+    "noisy_result.expectation()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.15 (default, Sep 23 2021, 15:41:43) [GCC]"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/qaoa.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/qaoa.ipynb.txt
new file mode 100644
index 0000000000..b064182dd6
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/qaoa.ipynb.txt
@@ -0,0 +1,376 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Max-Cut with QAOA\n",
+    "\n",
+    "[Farhi et al.](https://arxiv.org/abs/1411.4028) introduced the quantum approximation optimization algorithm (QAOA) to solve optimization problems like the max cut problem. Before diving into the details of QAOA, we'll first define the max cut problem. \n",
+    "\n",
+    "[Max Cut](https://en.wikipedia.org/wiki/Maximum_cut) is the problem of finding a partition of a graph's nodes into two sets which maximizes the edges between the two sets. Although this problem is relatively easy to solve for graphs with few vertices, this problem is [NP-hard](https://en.wikipedia.org/wiki/NP-hardness#:~:text=7%20References-,Definition,complete%20problem%20G%20to%20H.). The max cut problem has a wide range of applications including [machine learning](https://jmlr.org/papers/volume14/wang13a/wang13a.pdf), [circuit design](https://math.mit.edu/research/highschool/primes/materials/2020/Hong-Lee-Wei.pdf) and [statistical physics](https://www.researchgate.net/publication/262162554_An_Application_of_Combinatorial_Optimization_to_Statistical_Physics_and_Circuit_Layout_Design), among others. Furthermore, the QAOA algorithm presented in this tutorial can be adapted to other related optimization problems with an even wider application field including [portfolio optimization](https://journals.aps.org/prresearch/pdf/10.1103/PhysRevResearch.4.043204) and [job shop scheduling](https://www.sciencedirect.com/science/article/pii/S0377221723002072), just to name a few.\n",
+    "\n",
+    "We take the convention that $G=(V,E)$ represents a graph with vertex set $V\\subseteq \\mathbb{N}$ and edge set $E\\subseteq V\\times V$. We use the terms vertex and node interchangeably.  For this tutorial we assume that the graphs are undirected (that is, $(u,v)$ and $(v,u)$ represent the same edge). Our graphs contain no self loops (i.e., for every vertex $v$, there is no edge $(v,v)$). A *cut* of the graph $G$ is a partition, $(V_0,V_1)$, of the vertex set such that every vertex of $V$ is a member of exactly one of $V_0$ or $V_1$ (i.e., $V_0\\bigcup V_1 = V$ and $V_0\\bigcap V_0=\\emptyset$). The *cut value* for a partition is the sum of the edges with one node in $V_0$ and one node in $V_1$.\n",
+    "\n",
+    "In the images below, we illustrate two cuts of a graph with the dotted lines. Each of these cuts partitions the graph into two disjoint sets. The cut on the left is not optimal, and the cut on the right is the max cut. The cut on the left divides the graph into disjoint sets $\\{1,2\\}$ and $\\{0,3,4\\}$, and that cut contains 3 edges. To more easily visualize the cut, we have colored the vertices in one set of the partition green and the vertices in the other set of the partition gray.\n",
+    "The cut depicted in the diagram on the right divides the graph vertices into two disjoint sets $V_0=\\{0,2\\}$, colored gray, and $V_1=\\{1,3,4\\}$, colored green. The number of edges connecting vertices in the distinct sets is computed by $$\\sum_{\\substack{u \\in V_0; v\\in V_1\\\\ (u,v) \\in E}}1.$$ For the graph on the right, the number of edges in the cut (in this case there are $5$ edges) is maximal, and this value is referred to as the *max cut value*. The partitioning $(V_0,V_1)$  &mdash; and sometimes the set of edges connecting vertices in $V_0$ and $V_1$  &mdash; is referred to as a *max cut of a graph*. Note that the max cut of a graph need not be unique; that is, two distinct partitions may produce the same cut value.\n",
+    " \n",
+    "![](images/max-cut-illustration.png)\n",
+    " \n",
+    "We will use bitstrings to identify vertices in each of the two partitions. For example using the ordering of the vertices, the bitstring `01100` captures the partition in the image above on the left with vertices $1$ and $2$ in $V_1$, and the bitstring `01011` codes the partition in the image on the right with vertices $1$, $3$, and $4$ in $V_1$.\n",
+    "\n",
+    "Let's code our graph data as lists of integers so that we can call these variables when we create the `cudaq.kernel` for QAOA. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "from typing import List\n",
+    "\n",
+    "# We'll use the graph below to illustrate how QAOA can be used to\n",
+    "# solve a max cut problem\n",
+    "\n",
+    "#       v1  0--------------0 v2\n",
+    "#           |              | \\\n",
+    "#           |              |  \\\n",
+    "#           |              |   \\\n",
+    "#           |              |    \\\n",
+    "#       v0  0--------------0 v3-- 0 v4\n",
+    "# The max cut solutions are 01011, 10100, 01010, 10101 .\n",
+    "\n",
+    "# First we define the graph nodes (i.e., vertices) and edges as lists of integers so that they can be broadcast into\n",
+    "# a cudaq.kernel.\n",
+    "nodes: List[int] = [0, 1, 2, 3, 4]\n",
+    "edges = [[0, 1], [1, 2], [2, 3], [3, 0], [2, 4], [3, 4]]\n",
+    "edges_src: List[int] = [edges[i][0] for i in range(len(edges))]\n",
+    "edges_tgt: List[int] = [edges[i][1] for i in range(len(edges))]"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "QAOA is a variational algortihm with a particular ansatz. QAOA is made up of a variational quantum circuit (i.e., a kernel that depends on a set of parameter values) and a classical optimizer. The aim of QAOA is to use the classical optimizer to identify parameter values that generate a quantum circuit whose expectation value for a given cost Hamilitonian is minimized. \n",
+    "\n",
+    "What distinguishes QAOA from other variational algorithms is the structure of the quantum circuit. For each vertex in the graph, there is an associated qubit in the circuit. The circuit is initialized in a superposition state. The remainder of the QAOA circuit is made up of blocks (referred to as layers). The more layers there are, the better the approximation the algorithm achieves.\n",
+    "\n",
+    "![diagram of QAOA circuit layers](images/qaoa-circuit-layers.png)\n",
+    "\n",
+    "\n",
+    "\n",
+    "Each layer contains a problem kernel and a mixer kernel. The mixer kernel is composed of parameterized rotation gates applied to each qubit, depicted in green in the image above. The problem kernel encodes the graph edges. The image below shows an example of an graph edge encoded with controlled-X gates and a parameterized rotation gate.\n",
+    "\n",
+    "![diagram of a QAOA problem kernel for a max cut problem](images/qaoa-problem-kernel.png)\n",
+    "\n",
+    "Let's implement the QAOA circuit for our max cut problem in CUDA-Q."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Problem parameters\n",
+    "# The number of qubits we'll need is the same as the number of vertices in our graph\n",
+    "qubit_count: int = len(nodes)\n",
+    "\n",
+    "# We can set the layer count to be any positive integer.  Larger values will create deeper circuits\n",
+    "layer_count: int = 2\n",
+    "\n",
+    "# Each layer of the QAOA kernel contains 2 parameters\n",
+    "parameter_count: int = 2 * layer_count\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def qaoaProblem(qubit_0: cudaq.qubit, qubit_1: cudaq.qubit, alpha: float):\n",
+    "    \"\"\"Build the QAOA gate sequence between two qubits that represent an edge of the graph\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    qubit_0: cudaq.qubit \n",
+    "        Qubit representing the first vertex of an edge\n",
+    "    qubit_1: cudaq.qubit \n",
+    "        Qubit representing the second vertex of an edge\n",
+    "    thetas: List[float]\n",
+    "        Free variable   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.Kernel\n",
+    "        Subcircuit of the problem kernel for Max-Cut of the graph with a given edge\n",
+    "    \"\"\"\n",
+    "    x.ctrl(qubit_0, qubit_1)\n",
+    "    rz(2.0 * alpha, qubit_1)\n",
+    "    x.ctrl(qubit_0, qubit_1)\n",
+    "\n",
+    "\n",
+    "# We now define the kernel_qaoa function which will be the QAOA circuit for our graph\n",
+    "# Since the QAOA circuit for max cut depends on the structure of the graph,\n",
+    "# we'll feed in global concrete variable values into the kernel_qaoa function for the qubit_count, layer_count, edges_src, edges_tgt.\n",
+    "# The types for these variables are restricted to Quake Values (e.g. qubit, int, List[int], ...)\n",
+    "# The thetas plaeholder will be our free parameters\n",
+    "@cudaq.kernel\n",
+    "def kernel_qaoa(qubit_count: int, layer_count: int, edges_src: List[int],\n",
+    "                edges_tgt: List[int], thetas: List[float]):\n",
+    "    \"\"\"Build the QAOA circuit for max cut of the graph with given edges and nodes\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    qubit_count: int \n",
+    "        Number of qubits in the circuit, which is the same as the number of nodes in our graph\n",
+    "    layer_count : int \n",
+    "        Number of layers in the QAOA kernel\n",
+    "    edges_src: List[int]\n",
+    "        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    edges_tgt: List[int]\n",
+    "        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    thetas: List[float]\n",
+    "        Free variables to be optimized   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.Kernel\n",
+    "        QAOA circuit for Max-Cut for max cut of the graph with given edges and nodes\n",
+    "    \"\"\"\n",
+    "    # Let's allocate the qubits\n",
+    "    qreg = cudaq.qvector(qubit_count)\n",
+    "    # And then place the qubits in superposition\n",
+    "    h(qreg)\n",
+    "\n",
+    "    # Each layer has two components: the problem kernel and the mixer\n",
+    "    for i in range(layer_count):\n",
+    "        # Add the problem kernel to each layer\n",
+    "        for edge in range(len(edges_src)):\n",
+    "            qubitu = edges_src[edge]\n",
+    "            qubitv = edges_tgt[edge]\n",
+    "            qaoaProblem(qreg[qubitu], qreg[qubitv], thetas[i])\n",
+    "        # Add the mixer kernel to each layer\n",
+    "        for j in range(qubit_count):\n",
+    "            rx(2.0 * thetas[i + layer_count], qreg[j])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "As mentioned earlier, QAOA is a variational algorithm that aims to minimize a cost function. To apply QAOA to the max cut problem, we assign a binary variable $z_v$ to each vertex $v$. These variables will take on the vales $-1$ or $1$. Notice that an assignment of variable values corresponds to a partition of the graph.  For example, $\\bar z = [-1, 1, -1, 1, 1]$ would partition the graph into two sets: $\\{0,2\\}$ and $\\{1,3,4\\}.$ We can compute the cut value of the graph for an arbirtrary assignment of variable values by the formula: $$C(\\bar{z})= \\frac{1}{2} \\sum_{(u,v)\\in E} (1-z_uz_v),$$ where $E$ is the set of edges of our graph.  Our goal is to find a variable assignment that maximizes $C(\\bar z)$.  Equivalently, we want to find a variable assignment that minimizes $-C(\\bar z)$. Since QAOA identifies minimum values, we have reframed the max cut optimization problem from one of maximization to minimization. Furthermore, we can promote this equation to a matrix equation by replacing $z_uz_v-1$ with Pauli-Z operators acting on qubits associated with nodes $u$ and $v$, respectively, and replacing 1 with the identity matrix. This leads to the reformulation of the problem from one of maximizing $C(\\bar{z})$ to one of minimizing the eigenvalues of $$H= \\frac{1}{2}\\sum_{(u,v)\\in E} (Z_uZ_v-II).$$  \n",
+    "\n",
+    "We can code this Hamiltonian using the `cudaq.spin` operators."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The problem Hamiltonian\n",
+    "# Define a function to generate the Hamiltonian for a max cut problem using the graph\n",
+    "# with the given edges\n",
+    "\n",
+    "\n",
+    "def hamiltonian_max_cut(edges_src, edges_tgt):\n",
+    "    \"\"\"Hamiltonian for finding the max cut for the graph with given edges and nodes\n",
+    "        \n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    edges_src: List[int]\n",
+    "        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    edges_tgt: List[int]\n",
+    "        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.SpinOperator\n",
+    "        Hamiltonian for finding the max cut of the graph with given edges \n",
+    "    \"\"\"\n",
+    "\n",
+    "    hamiltonian = 0\n",
+    "\n",
+    "    for edge in range(len(edges_src)):\n",
+    "\n",
+    "        qubitu = edges_src[edge]\n",
+    "        qubitv = edges_tgt[edge]\n",
+    "        # Add a term to the Hamiltonian for the edge (u,v)\n",
+    "        hamiltonian += 0.5 * (spin.z(qubitu) * spin.z(qubitv) -\n",
+    "                              spin.i(qubitu) * spin.i(qubitv))\n",
+    "\n",
+    "    return hamiltonian"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To inititiate the QAOA algorithm, we need to identify initial parameters and specify the classical optimization routine."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Specify the optimizer and its initial parameters.\n",
+    "cudaq.set_random_seed(13)\n",
+    "optimizer = cudaq.optimizers.NelderMead()\n",
+    "np.random.seed(13)\n",
+    "optimizer.initial_parameters = np.random.uniform(-np.pi / 8, np.pi / 8,\n",
+    "                                                 parameter_count)\n",
+    "print(\"Initial parameters = \", optimizer.initial_parameters)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can either use the `observe` primitive or the `vqe` primitive to code up the optimization loop of QAOA."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[0.5+0j] IIZIZ\n",
+      "[0.5+0j] IZZII\n",
+      "[-3+0j] IIIII\n",
+      "[0.5+0j] ZZIII\n",
+      "[0.5+0j] IIIZZ\n",
+      "[0.5+0j] IIZZI\n",
+      "[0.5+0j] ZIIZI\n",
+      "\n",
+      "optimal_expectation = -4.495973826282007\n",
+      "Therefore, the max cut value is at least  4.495973826282007\n",
+      "optimal_parameters = [0.51349181993727, -0.21299416361632417, 0.3250526425808945, 0.886630847343767]\n"
+     ]
+    }
+   ],
+   "source": [
+    "#cudaq.set_target('nvidia')\n",
+    "cudaq.set_target('qpp-cpu')\n",
+    "\n",
+    "# Generate the Hamiltonian for our graph\n",
+    "hamiltonian = hamiltonian_max_cut(edges_src, edges_tgt)\n",
+    "print(hamiltonian)\n",
+    "\n",
+    "# Define the objective, return `<state(params) | H | state(params)>`\n",
+    "# Note that in the `observe` call we list the kernel, the hamiltonian, and then the concrete global variable values of our kernel\n",
+    "# followed by the parameters to be optimized.\n",
+    "\n",
+    "\n",
+    "def objective(parameters):\n",
+    "    return cudaq.observe(kernel_qaoa, hamiltonian, qubit_count, layer_count,\n",
+    "                         edges_src, edges_tgt, parameters).expectation()\n",
+    "\n",
+    "\n",
+    "# Optimize!\n",
+    "optimal_expectation, optimal_parameters = optimizer.optimize(\n",
+    "    dimensions=parameter_count, function=objective)\n",
+    "\n",
+    "# Alternatively we can use the vqe call (just comment out the above code and uncomment the code below)\n",
+    "# optimal_expectation, optimal_parameters = cudaq.vqe(\n",
+    "#    kernel=kernel_qaoa,\n",
+    "#    spin_operator=hamiltonian,\n",
+    "#    argument_mapper=lambda parameter_vector: (qubit_count, layer_count, edges_src, edges_tgt, parameter_vector),\n",
+    "#    optimizer=optimizer,\n",
+    "#    parameter_count=parameter_count)\n",
+    "\n",
+    "print('optimal_expectation =', optimal_expectation)\n",
+    "print('Therefore, the max cut value is at least ', -1 * optimal_expectation)\n",
+    "print('optimal_parameters =', optimal_parameters)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now that we have identified the optimal parameters, we can read out the partitioning(s) that gives us a max cut of the graph using the `sample` primitive."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11111:4 11110:1 01101:2 01010:148 01110:47 01000:3 00110:54 10101:165 00101:2 01011:154 00100:3 01001:41 00000:1 00011:3 01100:8 10011:7 00010:2 01111:2 11011:3 00111:10 11100:7 10001:65 10010:7 10100:144 10110:40 10000:5 10111:3 11000:7 11101:1 11001:59 11010:2 }\n",
+      "\n",
+      "The max cut is given by the partition:  10101\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Sample the circuit using the optimized parameters\n",
+    "# Since our kernel has more than one argument, we need to list the values for each of these variables in order in the `sample` call.\n",
+    "counts = cudaq.sample(kernel_qaoa, qubit_count, layer_count, edges_src,\n",
+    "                      edges_tgt, optimal_parameters)\n",
+    "print(counts)\n",
+    "\n",
+    "# Identify the most likely outcome from the sample\n",
+    "max_cut = max(counts, key=lambda x: counts[x])\n",
+    "print('The max cut is given by the partition: ',\n",
+    "      max(counts, key=lambda x: counts[x]))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/quantum_fourier_transform.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/quantum_fourier_transform.ipynb.txt
new file mode 100644
index 0000000000..8d836113b3
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/quantum_fourier_transform.ipynb.txt
@@ -0,0 +1,413 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Quantum Fourier Transform "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Classical Fourier transforms aid many areas such as signal processing and data compression. Below, we quantize it to enable Quantum Fourier Transforms (QFT) in CUDA-Q.\n",
+    "\n",
+    "QFT is a key ingredient in Shor's algorithm which is exponentially faster at factoring prime numbers and also plays a vital role in many other interesting quantum algorithms. \n",
+    "\n",
+    "The idea with classical Fourier transforms is to take the problem from the frequency domain, to the time domain where it is easier to solve. This is the same analogy we draw with QFT, where we take the basis state from the computational basis to the Fourier basis. "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The Quantum Fourier Transform is defined to be the linear operation which takes a basis state, $\\ket{x}$, \n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\text{QFT}\\ket{x}  =   \\frac{1}{\\sqrt{N}}\\sum_{y=0}^{N-1} e^{\\frac{2\\pi ixy}{N}} \\ket{y}\n",
+    "\\tag{1}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "where $n$ is the number of qubits and $N= 2^n$. \n",
+    "\n",
+    "It is convenient to represent states like $\\ket{x}  = \\ket{101}$ in their binary representation which in this case would be $2^2 \\times 1 + 2^1 \\times 0 + 2^0 \\times 1 = \\ket{5}$. \n",
+    "\n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "For the $n=1$ qubit case, we have the following basis states: $\\ket{0}, \\ket{1}$. The QFT on these is as follows: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|0\\rangle &= \\frac{1}{\\sqrt{2}}\\sum_{y=0}^{2-1} e^{\\frac{2\\pi i(0)y}{2}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}\\left(e^0|0\\rangle + e^0|1\\rangle\\right) \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}(|0\\rangle + |1\\rangle) \\\\\n",
+    "&= \\ket{+} \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{2}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|1\\rangle &= \\frac{1}{\\sqrt{2}}\\sum_{y=0}^{2-1} e^{\\frac{2\\pi i(1)y}{2}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}\\left(e^0|0\\rangle + e^{\\pi i}|1\\rangle\\right) \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}(|0\\rangle - |1\\rangle) \\\\\n",
+    "&= \\ket{-} \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{3}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "             \n",
+    "\n",
+    "To summarize, $\\text{QFT}|0\\rangle = \\ket{+}$ and $\\text{QFT}|1\\rangle = \\ket{-}$ which can be achieved by applying Hadamard gates. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "Let us now extend this and see how we can apply this to $n=3$ qubits. \n",
+    "\n",
+    "For $n=3, N = 2^3 = 8$ and we would like to perform $\\text{QFT}|101\\rangle$ which in binary is $2^2 \\times 1 + 2^1 \\times 0 + 2^0 \\times 1 = 5$: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|101\\rangle = \\text{QFT}|5\\rangle &= \\frac{1}{\\sqrt{8}}\\sum_{y=0}^{8-1} e^{\\frac{2\\pi i(5)y}{8}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{8}} [ e^{0}\\ket{0} + e^{\\frac{5i\\pi (1)}{4}}\\ket{1}  + e^{\\frac{5i\\pi (2)}{4}}\\ket{2} +...++ e^{\\frac{5i\\pi (7)}{4}}\\ket{7} ]   \\\\\n",
+    "&= \\frac{1}{\\sqrt{8}} [ \\ket{000} + e^{\\frac{5i\\pi (1)}{4}}\\ket{001}  + e^{\\frac{5i\\pi (2)}{4}}\\ket{010} +...++ e^{\\frac{5i\\pi (7)}{4}}\\ket{111} ]   \\\\\n",
+    "&=  (0.35+0i) \\ket{000} + (-0.25-0.25i)\\ket{001}  + (0+0.35i)\\ket{010} +...+ (-0.25+0.25i)\\ket{111}    \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{4}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "where we have used the fact that $e^{i\\theta} = \\cos(\\theta) + i\\sin(\\theta).$\n",
+    "\n",
+    "Here, we see how in addition to the Hadamard gates, we need some phase gates to apply the appropriate phases to the basis states. It turns out that the gate we need is the controlled $R_k$ rotation where the $R_k$ gate is denoted by:\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "R_k = \\begin{bmatrix}\n",
+    "1 & 0 \\\\\n",
+    "0 & e^{2\\pi i/ 2^{k}}\n",
+    "\\end{bmatrix}\n",
+    "\\tag{5}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "\n",
+    "Here is a generalized ciruit for a $n$-qubit quantum Fourier transform:"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "<img src=\"images/qft.png\" alt=\"qft\" width=\"600\">\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below we show the code for a QFT implementation in CUDA-Q based on the circuit diagram above: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "from typing import List\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform(input_state: List[int]):\n",
+    "    '''Args: \n",
+    "    input_state (list[int]): specifies the input state to be Fourier transformed.  '''\n",
+    "\n",
+    "    qubit_count = len(input_state)\n",
+    "\n",
+    "    # Initialize qubits.\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    # Initialize the quantum circuit to the initial state.\n",
+    "    for i in range(qubit_count):\n",
+    "        if input_state[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮╭───────────╮╭────────────╮                       \n",
+      "q0 : ┤ x ├┤ h ├┤ r1(1.571) ├┤ r1(0.7854) ├───────────────────────\n",
+      "     ╰───╯╰───╯╰─────┬─────╯╰─────┬──────╯╭───╮╭───────────╮     \n",
+      "q1 : ────────────────●────────────┼───────┤ h ├┤ r1(1.571) ├─────\n",
+      "     ╭───╮                        │       ╰───╯╰─────┬─────╯╭───╮\n",
+      "q2 : ┤ x ├────────────────────────●──────────────────●──────┤ h ├\n",
+      "     ╰───╯                                                  ╰───╯\n",
+      "\n",
+      "[ 0.35+0.j   -0.25-0.25j  0.  +0.35j  0.25-0.25j -0.35+0.j    0.25+0.25j\n",
+      " -0.  -0.35j -0.25+0.25j]\n"
+     ]
+    }
+   ],
+   "source": [
+    "#Can be changed to 'nvidia' for single gpu, 'nvidia-mgpu' for multi-GPU or quantum hardware.\n",
+    "cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "# The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.\n",
+    "input_state = [1, 0, 1]\n",
+    "\n",
+    "# Number of decimal points to round up the statevector to.\n",
+    "precision = 2\n",
+    "\n",
+    "# Draw the quantum circuit.\n",
+    "print(cudaq.draw(quantum_fourier_transform, input_state))\n",
+    "\n",
+    "# Print the statevector to the specified precision\n",
+    "statevector = np.array(cudaq.get_state(quantum_fourier_transform, input_state))\n",
+    "print(np.round(statevector, precision))"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can verify that this is the correct answer as above we worked out that: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|101\\rangle = \\text{QFT}|5\\rangle &= \\frac{1}{\\sqrt{8}}\\sum_{y=0}^{8-1} e^{\\frac{2\\pi i(5)y}{8}}|y\\rangle \\\\\n",
+    "&=  (0.35+0i) \\ket{000} + (-0.25-0.25i)\\ket{001}  + (0+0.35i)\\ket{010} +...+ (-0.25+0.25i)\\ket{111}.   \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{6}\n",
+    "\\end{equation}\n",
+    "$$\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Barring the gates used in the state preparation step, the circuit starts off by implementing a Hadamard gate and then $n-1$ rotations on the zeroth qubit - a total of $n$ gates. This is followed by a Hadamard and $n-2$ conditional rotations on the first qubit which totals to $n -1$ gates. If we continue the series, we get $n + (n-1) + (n-2)... = n(n+1)/2$ gates. Hence, this circuit provides an algorithm with $O(n^2)$ gates for computing the QFT. \n",
+    "\n",
+    "The best classical algorithms for computing fast Fourier transforms on $2^{n}$ elements require $O(n2^{n})$ gates. This means that it requires exponentially more operations to compute the fast Fourier transform on a classical computer than it does to implement the QFT on a quantum computer.\n",
+    "\n",
+    "Why are we not using QFT for real life applications then? The problem lies in quantum measurement. The quantum-Fourier-transformed amplitudes cannot be accessed by quantum measurement. However there are other quantum algorithms that do make use of QFT such as Shor's algorithm. \n",
+    "\n",
+    "One can also invert the QFT where the circuit is executed in reverse with the inverse of each gate. The figure below shows the general $n$-qubit inverse QFT. Why don't you try implementing this in CUDA-Q?\n",
+    "\n",
+    "<img src=\"images/inverse_qft.png\" alt=\"qft\" width=\"600\">\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum Fourier Transform revisited\n",
+    "We provided one implementation of the Quantum Fourier Transform above.  To demonstrate some of the other features of CUDA-Q, let's define a new kernel for the Quantum Fourier Transform, which we'll call `quantum_fourier_transform2`.  Pay attention to how the kernel definition differs from the example above.\n",
+    "\n",
+    " Since the Quantum Fourier Transform is a unitary operator, its inverse is its adjoint.  Therefore, once we have implemented the Quantum Fourier Transform as a kernel in CUDA-Q, we can use the built-in `adjoint` operation to create the Inverse Quantum Fourier Transform."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define kernels for the Quantum Fourier Transform and the Inverse Quantum Fourier Transform\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform2(qubits: cudaq.qview):\n",
+    "    '''Args: \n",
+    "    qubits (cudaq.qview): specifies the quantum register to which apply the QFT.'''\n",
+    "    qubit_count = len(qubits)\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])\n",
+    "            \n",
+    "@cudaq.kernel\n",
+    "def inverse_qft(qubits: cudaq.qview):\n",
+    "    '''Args: \n",
+    "    qubits (cudaq.qview): specifies the quantum register to which apply the inverse QFT.'''\n",
+    "    cudaq.adjoint(quantum_fourier_transform2, qubits)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's see that this approach gives us the same results as the section above. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮╭─────────╮╭──────────╮                                      »\n",
+      "q0 : ┤ x ├┤ h ├┤ r1(1.5) ├┤ r1(0.75) ├──────────────────────────────────────»\n",
+      "     ╰───╯╰───╯╰────┬────╯╰────┬─────╯╭───╮╭─────────╮          ╭──────────╮»\n",
+      "q1 : ───────────────●──────────┼──────┤ h ├┤ r1(1.5) ├──────────┤ r1(-1.5) ├»\n",
+      "     ╭───╮                     │      ╰───╯╰────┬────╯╭───╮╭───╮╰────┬─────╯»\n",
+      "q2 : ┤ x ├─────────────────────●────────────────●─────┤ h ├┤ h ├─────●──────»\n",
+      "     ╰───╯                                            ╰───╯╰───╯            »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "     ╭───────────╮╭──────────╮╭───╮\n",
+      "─────┤ r1(-0.75) ├┤ r1(-1.5) ├┤ h ├\n",
+      "╭───╮╰─────┬─────╯╰────┬─────╯╰───╯\n",
+      "┤ h ├──────┼───────────●───────────\n",
+      "╰───╯      │                       \n",
+      "───────────●───────────────────────\n",
+      "                                   \n",
+      "\n",
+      "[0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 1.-0.j 0.-0.j 0.+0.j]\n"
+     ]
+    }
+   ],
+   "source": [
+    "@cudaq.kernel\n",
+    "def verification_example(input_state : List[int]):\n",
+    "    '''Args: \n",
+    "    input_state (list[int]): specifies the input state to be transformed with QFT and the inverse QFT.  '''\n",
+    "    qubit_count = len(input_state)\n",
+    "    # Initialize qubits.\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    # Initialize the quantum circuit to the initial state.\n",
+    "    for i in range(qubit_count):\n",
+    "        if input_state[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "    \n",
+    "    # Apply the quantum Fourier Transform\n",
+    "    quantum_fourier_transform2(qubits)\n",
+    "\n",
+    "    # Apply the inverse quantum Fourier Transform\n",
+    "    inverse_qft(qubits)\n",
+    "\n",
+    "# The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.\n",
+    "input_state = [1, 0, 1]\n",
+    "\n",
+    "\n",
+    "# Number of decimal points to round up the statevector to.\n",
+    "precision = 2\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(verification_example, input_state))\n",
+    "\n",
+    "# Print the statevector to the specified precision\n",
+    "statevector = np.array(cudaq.get_state(verification_example, input_state))\n",
+    "print(np.round(statevector, precision)) # The result should be the input state"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/readout_error_mitigation.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/readout_error_mitigation.ipynb.txt
new file mode 100644
index 0000000000..1d1fee4095
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/readout_error_mitigation.ipynb.txt
@@ -0,0 +1,900 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "5b2ac00e-c7fc-45cc-888e-8c26dabf80d2",
+   "metadata": {},
+   "source": [
+    "# Readout Error Mitigation\n",
+    "\n",
+    "Readout errors are caused by imperfect qubit measurement and are a common source of error in quantum computing. Properly modelling these errors in simulation can give the user tools to understand better what these errors are and how to mitigate them when running on actual quantum devices.\n",
+    "\n",
+    "Readout errors can be mitigated with a confusion matrix $A$. It is a square matrix of size $2^n \\times 2^n$ and tells about the probability of observing the state $|y\\rangle$ given the true state $|x\\rangle$. The confusion matrix characterizes the readout error of the device and is circuit-independent. Once $A$ is estimated, we can compute its pseudoinverse $A^+$ which can be applied to the noisy probability distribution $p_{\\text{noisy}}$ to obtain an adjusted quasi-probability distribution \n",
+    "\n",
+    "$$\n",
+    "p_{\\text{mitigated}} = A^+ p_{\\text{noisy}}\n",
+    "$$\n",
+    "\n",
+    "In this tutorial, we show how to build a confusion matrix with the following approaches.\n",
+    "\n",
+    "- Using a  single qubit model\n",
+    "- Using $k$ local confusion matrices\n",
+    "- A full confusion matrix for each $2^n$ combination\n",
+    "\n",
+    "The last method works well for correcting correlated errors (which affect multiple qubits together). However, it becomes impractical for large numbers of qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "04b58854-7dab-4f1b-8c59-d8b9506bce44",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install pandas==2.2.2\n",
+    "!pip install scipy==1.13.1\n",
+    "!pip install seaborn==0.13.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "710a2a46-4e55-4508-a0b7-21969aac6a87",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "import seaborn as sns\n",
+    "import pandas as pd\n",
+    "import itertools\n",
+    "from functools import reduce\n",
+    "from scipy.optimize import minimize\n",
+    "from typing import Union\n",
+    "\n",
+    "sns.set_style(\"dark\")\n",
+    "\n",
+    "cudaq.set_target(\"density-matrix-cpu\")\n",
+    "seed = 42\n",
+    "\n",
+    "cudaq.set_random_seed(seed)\n",
+    "np.random.seed(seed)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8eab761a-0a82-4e20-8cf8-54602cd05d6a",
+   "metadata": {},
+   "source": [
+    "To model the readout error, we apply a bitflip channel on every qubit at the end of the circuit using an Identity gate. The probability of bitflip `probs` can be the same or different for all the qubits.\n",
+    "\n",
+    "<div class=\"alert alert-block alert-success\"><b>Note: </b>\n",
+    "In principle, readout error is applied to the measurement gate but we use the Identity gate because adding a quantum error on the measurement gate is not yet supported. Also, the Identity gate is not present in the <kbd>add_channel</kbd> method, so we model the Identity gate using a rotation gate with an angle of 0.0.\n",
+    "</div>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "d84bb420-4fab-4c26-919a-7efa8d3a219b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_noise(n_qubits: int, probs: Union[float, list[float]]):\n",
+    "    \"\"\"\n",
+    "    Creates a noise model with specified probabilities of bit flip errors on each qubit.\n",
+    "\n",
+    "    Args:\n",
+    "        n_qubits (int): The number of qubits in the quantum circuit.\n",
+    "        probs (Union[float, list[float]]): Probabilities of a bit flip error occurring on each qubit.\n",
+    "        If a single probability value is provided, it will be applied to all qubits. If a list of\n",
+    "        probabilities is provided, each qubit will have its own probability.\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq noise model\n",
+    "    \"\"\"\n",
+    "    noise = cudaq.NoiseModel()\n",
+    "\n",
+    "    if not isinstance(probs, list):\n",
+    "        probs = [probs] * n_qubits\n",
+    "\n",
+    "    for i, p in enumerate(probs):\n",
+    "        bit_flip = cudaq.BitFlipChannel(p)\n",
+    "        noise.add_channel(\"rx\", [i], bit_flip)\n",
+    "\n",
+    "    return noise"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bb4c7a14-1c0c-4fab-a6aa-7174c23baa7f",
+   "metadata": {},
+   "source": [
+    "We define a cudaq kernel which will help create a set of quantum circuits to take measurements of the basis states for $n$ qubits. The kernel takes the number of qubits and the basis state as arguments."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "53e3f450-000f-49b8-ad5c-57aa74461694",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel(n_qubits: int, state_label: list[int]):\n",
+    "    qvector = cudaq.qvector(n_qubits)\n",
+    "    for i, val in enumerate(state_label):\n",
+    "        if val == 1:\n",
+    "            x(qvector[i])\n",
+    "        rx(\n",
+    "            0.0, qvector[i]\n",
+    "        )  # Identity gate at the end on each qubit to model readout error\n",
+    "    mz(qvector)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "95411463-cd1e-499f-baef-d624acc0122c",
+   "metadata": {},
+   "source": [
+    "For the tutorial, we will use the GHZ state on three qubits to test readout error mitigation. The GHZ state on 3 qubits is described as:\n",
+    "\n",
+    "$$\n",
+    "\\frac{|000\\rangle + |111\\rangle}{\\sqrt{2}}\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "c1476028-923d-4f2b-b5fc-39ebcc8cbab9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def ghz_kernel(n_qubits: int):\n",
+    "    qvector = cudaq.qvector(n_qubits)\n",
+    "\n",
+    "    h(qvector[0])\n",
+    "    for i in range(n_qubits - 1):\n",
+    "        cx(qvector[i], qvector[i + 1])\n",
+    "\n",
+    "    # Apply identity gates for readout error mitigation\n",
+    "    for i in range(n_qubits):\n",
+    "        rx(0.0, qvector[i])\n",
+    "\n",
+    "    mz(qvector)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "900d2110-d613-426a-8aa9-6c12b1238536",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Function to draw the confusion matrix\n",
+    "def plot_cmat(mat):\n",
+    "    fig, ax = plt.subplots()\n",
+    "    n = len(mat)\n",
+    "    im2 = ax.matshow(mat, cmap=plt.cm.Reds, vmin=0, vmax=1.0)\n",
+    "    ax.set_yticks(np.arange(n))\n",
+    "    ax.set_xticks(np.arange(n))\n",
+    "    ax.set_yticklabels(n * [\"\"])\n",
+    "    ax.set_xticklabels(n * [\"\"])\n",
+    "    ax.set_title(r\"Confusion Matrix\", fontsize=16)\n",
+    "    ax.set_xlabel(\"Prepared State\")\n",
+    "    ax.xaxis.set_label_position(\"top\")\n",
+    "    ax.set_ylabel(\"Measured State\")\n",
+    "    fig.colorbar(im2, ax=ax)\n",
+    "    plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "032f6898-c953-4d30-a2bf-e8b46ee77c62",
+   "metadata": {},
+   "source": [
+    "It is possible that the adjusted quasi-probability distribution $p_{\\text{mitigated}}$ obtained by application of $A^+$ to $p_{\\text{noisy}}$ may be non-positive. We need to find the closest positive probability distribution in such a case.\n",
+    "\n",
+    " $$ p'' = \\min_{p_{\\rm positive}} \\|p_{\\rm noisy} - p_{\\rm positive}\\|_1$$\n",
+    "\n",
+    "Then, we can draw samples from $p''$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "9b355dcb-bf80-42a1-ae11-dcc9f11ba1e3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_closest_distribution(empirical_dist):\n",
+    "    \"\"\"\n",
+    "    Find the closest distribution to an empirical distribution by minimizing the L1 norm.\n",
+    "\n",
+    "    Args:\n",
+    "        empirical_dist: Empirical distribution that you want to find the closest distribution to.\n",
+    "\n",
+    "    Returns:\n",
+    "        Closest distribution to `empirical_dist`\n",
+    "    \"\"\"\n",
+    "\n",
+    "    def objective(x):\n",
+    "        return np.linalg.norm(empirical_dist - x, ord=1)\n",
+    "\n",
+    "    # Constraint: all elements of p must be positive, and the distribution must sum to 1\n",
+    "    cons = (\n",
+    "        {\"type\": \"ineq\", \"fun\": lambda p: p},\n",
+    "        {\"type\": \"eq\", \"fun\": lambda p: np.sum(p) - 1},\n",
+    "    )\n",
+    "    bnds = [(0, 1) for _ in range(len(empirical_dist))]\n",
+    "    initial_value = np.random.uniform(size=len(empirical_dist))\n",
+    "\n",
+    "    res = minimize(\n",
+    "        objective,\n",
+    "        initial_value,\n",
+    "        method=\"SLSQP\",\n",
+    "        options={\"maxiter\": 1000},\n",
+    "        bounds=bnds,\n",
+    "        constraints=cons,\n",
+    "    )\n",
+    "\n",
+    "    return res.x"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "0ceb5a15-cecf-47ed-b1cc-cea79fa936f7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_counts_from_distribution(n_qubits, size, dist):\n",
+    "    \"\"\"\n",
+    "    Generates samples based on a given distribution and returns the counts of each sample value.\n",
+    "\n",
+    "    Args:\n",
+    "        n_qubits: The number of qubits in the quantum circuit.\n",
+    "        dist: The probability distribution from which samples are drawn.\n",
+    "\n",
+    "    Returns:\n",
+    "        An array of counts for each possible value in the distribution. The array has a length of 2^n_qubits.\n",
+    "    \"\"\"\n",
+    "    samples = np.random.choice(np.arange(2**n_qubits), size=size, p=dist)\n",
+    "    values, counts = np.unique(samples, return_counts=True)\n",
+    "    res = np.zeros(2**n_qubits, dtype=int)\n",
+    "    res[values] = counts\n",
+    "    return res"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1225d4de-fcc8-4a56-846b-44d6a52a272f",
+   "metadata": {},
+   "source": [
+    "Let's run the `ghz_kernel` with the noise model. We will perform two experiments. First, we keep the bitflip probability the same for all the qubits. In the second experiment, we use different bitflip probabilities for qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "53453484-a8d5-416c-8aad-7c982cad7191",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "n_qubits = 3\n",
+    "shots = 1024\n",
+    "\n",
+    "labels = list(map(list, itertools.product([0, 1], repeat=n_qubits)))\n",
+    "states = list(map(lambda label: \"\".join(map(str, label)), labels))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "2d147fe7-ce5e-475c-9014-59d4ff63a644",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "bitflip probability: 0.1\n",
+      "\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'000': 352,\n",
+       " '010': 43,\n",
+       " '111': 367,\n",
+       " '001': 47,\n",
+       " '011': 47,\n",
+       " '100': 54,\n",
+       " '101': 61,\n",
+       " '110': 53}"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "p = 0.1\n",
+    "print(f\"bitflip probability: {p}\\n\")\n",
+    "\n",
+    "noise_1 = get_noise(n_qubits, p)\n",
+    "\n",
+    "ghz_result = cudaq.sample(ghz_kernel, n_qubits, shots_count=shots, noise_model=noise_1)\n",
+    "noisy_dict_1 = dict(list(ghz_result.items()))\n",
+    "\n",
+    "noisy_res_1 = np.array([noisy_dict_1.get(state, 0) for i, state in enumerate(states)])\n",
+    "\n",
+    "noisy_dict_1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "976f13da-277b-4754-9a58-277a5988f739",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "bitflip probability: [0.149816047538945, 0.3802857225639665, 0.292797576724562]\n",
+      "\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'000': 212,\n",
+       " '010': 122,\n",
+       " '111': 189,\n",
+       " '001': 111,\n",
+       " '011': 87,\n",
+       " '100': 78,\n",
+       " '101': 131,\n",
+       " '110': 94}"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "p = list(np.random.uniform(low=0.0, high=0.4, size=n_qubits))\n",
+    "print(f\"bitflip probability: {p}\\n\")\n",
+    "\n",
+    "noise_2 = get_noise(n_qubits, p)\n",
+    "\n",
+    "ghz_result = cudaq.sample(ghz_kernel, n_qubits, shots_count=shots, noise_model=noise_2)\n",
+    "noisy_dict_2 = dict(list(ghz_result.items()))\n",
+    "\n",
+    "noisy_res_2 = np.array([noisy_dict_2.get(state, 0) for i, state in enumerate(states)])\n",
+    "\n",
+    "noisy_dict_2"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1889f50a-f051-4f0e-bace-18477122eafe",
+   "metadata": {},
+   "source": [
+    "## Inverse confusion matrix from single-qubit noise model\n",
+    "\n",
+    "Here we assume that the readout error of each qubit is independent with the same confusion probabilities. Then, the confusion matrix $A_1$ for a single qubit can be defined as\n",
+    "\n",
+    "$$\n",
+    "A_1 = \\begin{bmatrix}\n",
+    "P(0|0) & P(0|1)\\\\\n",
+    "P(1|0) & P(1|1)\n",
+    "\\end{bmatrix}\n",
+    "$$\n",
+    "\n",
+    "where $P(y|x)$ is the probability of observing state $|y\\rangle$ when measuring the true state $|x\\rangle$. Using $A_1$, the full $2^n \\times 2^n$ confusion matrix $A$ can be written as \n",
+    "\n",
+    "$$\n",
+    "A = A_1 \\otimes \\dots \\otimes A_1\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "e6ceb0a9-c2ec-4fcd-bb23-457890a8b57e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0 becomes {'0': 924, '1': 100}\n",
+      "1 becomes {'0': 104, '1': 920}\n"
+     ]
+    }
+   ],
+   "source": [
+    "single_qubit_labels = [[0], [1]]\n",
+    "single_qubit_states = [\"0\", \"1\"]  # Used for dictionary keys\n",
+    "\n",
+    "# we use noise_1 which has same bitflip probability for all qubits\n",
+    "results = [\n",
+    "    cudaq.sample(kernel, 1, label, shots_count=shots, noise_model=noise_1)\n",
+    "    for label in single_qubit_labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(single_qubit_states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "9f030f99-0ad9-4f89-8d99-a570b3c5e745",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[0.90234375 0.1015625 ]\n",
+      " [0.09765625 0.8984375 ]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Construct confusion matrix for single qubit\n",
+    "\n",
+    "A_1 = np.zeros((2, 2))\n",
+    "for i, state in enumerate(single_qubit_states):\n",
+    "    true_state = int(state, 2)\n",
+    "    for key, val in results[i].items():\n",
+    "        observed_state = int(key, 2)\n",
+    "        A_1[observed_state][true_state] = val / shots\n",
+    "\n",
+    "print(A_1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "cbc4a228-935f-413c-9ad3-b6e26f22e802",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[476   3   0   1  12  19   9 501]\n"
+     ]
+    }
+   ],
+   "source": [
+    "A = reduce(np.kron, [A_1] * n_qubits)  # joint confusion matrix\n",
+    "A_pinv = np.linalg.pinv(A)  # Generate pseudoinverse confusion matrix.\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_1), dtype=int)  # Obtain mitigated counts\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "b65c4657-87f7-44df-b205-7fc6195b95a4",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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Tp1q1woCAAAAaclUmI2KilLBggUlSVu3btUzzzyjMmXKqG3btjpy5IhdKwgAAACkJVNh1tfXV8eOHVNCQoJ+/vln/fvf/5Yk3bp1SxaLJcPnW7lypRo3bqwqVarohRde0N69e9Ms+91336lNmzYKCgpS9erV1apVK61bty4zzQAAAIDBuWTmoDZt2qh///4qWLCgTCaTgoODJUl79uyRn59fhs61fv16hYSEaOzYsapWrZqWLVumbt26aePGjfLx8UlR3sPDQ7169ZKfn59cXV31ww8/aMSIEfLx8VH9+vUz0xwAAAAYVKbCbL9+/VSuXDldvHhRzzzzjNzc3CRJFotF3bt3z9C5lixZonbt2qlt27aSpLFjx+rHH39UaGioevTokaJ8nTp1bH7u0qWL1q1bp507dxJmAQAAHjGZCrOS9Mwzz0iSbt++bd323HPPZegccXFxOnDggF5//XXrNrPZrODgYO3evfuBxyclJen333/X33//rcGDB2foswEAAGB8mQqzCQkJmjt3rlavXq2IiAh9++23KlGihKZNm6ZixYrphRdeSNd5oqKilJCQkGI4gY+Pj06cOJHmcTdu3FCDBg0UFxcns9ms0aNHW8ftAgAA4NGRqQlgc+bM0eeff64hQ4bI1dXVur18+fL69NNP7Va5tOTLl0/r1q3Tp59+qgEDBui9995jfVsAAIBHUKbC7BdffKFx48bp2Wefldn8zykqVKhw3zuq/8vLy0sWi0URERE22yMiIuTr65vmcWazWaVKlVLFihX16quvqmnTppo/f37GGwIAAABDy1SYvXTpkkqWLJlie1JSkuLj49N9Hjc3N1WuXFlhYWHWbYmJiQoLC1ONGjXSfZ7ExETFxcWluzwAAAByhkyNmS1btqx27NihYsWK2WzfuHGjKlasmKFzde3aVcOGDVNgYKCqVq2qZcuWKTY2Vm3atJEkDR06VIULF9agQYMkSfPmzVNgYKBKliypuLg4bd26VV9++aXGjBmTmaYAAADAwDIVZnv37q233npLly5dUlJSkr777jv9/fffWrdunebNm5ehczVr1kyRkZGaMWOGwsPDVbFiRS1cuNA6zODChQs2QxliYmI0duxYXbx4Ublz55afn58++OADNWvWLDNNAQAAgIFlKsw2adJEc+fO1ezZs5UnTx7NmDFDlSpV0ty5czO1qkDHjh3VsWPHVPetWLHC5ucBAwZowIABmak2AAAAcphMrzMbFBSkJUuW2LMuAAAAQIZkagIYAAAA4AzSfWe2du3a2rhxo7y9vVWrVi2ZTKY0y27bts0ulQMAAADuJ91hdvjw4cqfP7/17/cLswAAAEB2SHeYfe6556x/v7tsFgAAAOBImRozW7FixRRv7ZKkqKioDK8zCwAAAGRWpsJsUlJSqtvj4uLk6ur6UBUCAAAA0itDS3MtX75ckmQymbR27VrlzZvXui8xMVHbt2+Xn5+ffWsIAAAApCFDYXbp0qWSku/Mrl692ubNXK6uripevLjGjh1r1woCAAAAaclQmN2yZYskqVOnTpo1a5Y8PDyypFIAAABAemTqDWD/+4pZAAAAwBHSHWZDQkL05ptvKm/evAoJCblv2eHDhz90xQAAAIAHSXeYPXjwoOLj461/TwsvUwAAAEB2SXeYvXdoAcMMAAAA4Awytc4sAAAA4AzSfWe2b9++6T7prFmzMlUZAAAAICPSHWbd3d2zsh4AAABAhmVoNQMAAADAmTBmFgAAAIaV7juzzz33nJYuXSoPDw+1bt36vktwff7553apHAAAAHA/6Q6zTz75pNzc3CRJTZo0ybIKAQAAAOmVqdUMMrKyAQAAAJBV0h1mU7Nv3z4dP35cklS2bFkFBgbapVIAAABAemQqzF68eFEDBw7Url27VKBAAUnS9evXVaNGDU2dOlVFihSxayUBAACA1GRqNYORI0cqPj5e69ev17Zt27Rt2zatX79eSUlJGjlypL3rCAAAAKQqU3dmt2/frtWrV8vPz8+6zc/PT2+//bY6dOhgt8oBAAAA95OpO7OPPfaY4uPjU2xPTExUoUKFHrpSAAAAQHpkKswOGTJE48aN0759+6zb9u3bpwkTJmjYsGF2qxwAAABwP+keZlCrVi2bFyXExMSoXbt2slgskqSEhARZLBaNGDGCdWgBAACQLdIdZkeMGJGV9QAAAAAyLEOvswUAAACcyUO9NEGSbt++rTt37thsy58//8OeFgAAAHigTIXZmJgYTZ48WRs2bNDVq1dT7D906NDD1gsAAAB4oEytZvDBBx/o999/15gxY+Tm5qbx48erX79+KlSokN5//3171xEAAABIVabC7A8//KDRo0eradOmslgsCgoKUu/evTVgwAB99dVX9q4jAAAAkKpMhdlr166pRIkSkpLHx167dk2S9K9//Us7duywX+0AAACA+8hUmC1evLjOnj0rKfk1ths2bJCUfMfW3d3dfrUDAAAA7iNTYbZt27Y6fPiwJKlHjx5auXKlqlSpopCQEHXr1s2uFQQAAADSkqnVDF555RXr34ODg7V+/XodPHhQJUuWVEBAgL3qBgAAANzXQ68zKyUPOyhevLg9TgUAAACkW6bDbFhYmJYuXarjx49Lkvz9/dWlSxcFBwfbrXIAAADA/WRqzOzKlSv12muvKV++fOrcubM6d+6s/PnzW8fPAgAAANkhU3dm582bp+HDh6tjx44222vWrKm5c+eqQ4cOdqkcAAAAcD+ZujN748YN1a9fP8X2f//734qOjn7oSgEAAADpkakw27hxY33//fcptm/evFmNGjV62DoBAAAA6ZLuYQbLly+3/t3f319z587Vtm3bVL16dUnSnj17tGvXLnXt2tXulQQAAABSk+4wu3TpUpufCxQooGPHjunYsWPWbe7u7goNDVXv3r3tVkEAAAAgLekOs1u2bMnKegAAAAAZlqkxs/dKSkpSUlKSPeoCAAAAZEimw+y6devUsmVLVa1aVVWrVlXLli21bt06O1YNAAAAuL9MrTO7ZMkSTZ8+XR06dFD//v0lSTt37tSYMWN09epVvfLKK3asIgAAAJC6TIXZFStWaMyYMWrdurV125NPPqly5cpp5syZhFkAAABki0wNMwgPD1eNGjVSbK9Ro4bCw8MfulIAAABAemQqzJYqVUobNmxIsX39+vUqXbr0w9YJAAAASJdMDTPo16+fBgwYoO3bt6tmzZqSpF27dun333/XtGnT7Fk/AAAAIE2ZujPbtGlTrV27Vl5eXtq8ebM2b94sLy8vrV27Vk899ZS96wgAAACkKsN3Zu/cuaNRo0apd+/emjx5clbUCQAAAEiXDN+ZdXV11XfffZcVdQEAAAAyJFPDDJo0aaLNmzfbuy4AAABAhmRqAlipUqU0e/Zs7dq1S5UrV1aePHls9nfu3NkulQMAAADuJ1Nh9tNPP5W7u7v279+v/fv32+wzmUyEWQAAAGSLTIXZLVu2WP+elJQkKTnEAgAAANkpU2NmJWnt2rVq0aKFqlSpoipVqqhFixZau3atPesGAAAA3Fem7sxOnz5dS5cuVceOHVW9enVJ0p9//qmJEyfq/PnzevPNN+1ZRwAAACBVmQqzq1at0rhx49SiRQvrtieffFIVKlTQuHHjMhxmV65cqUWLFik8PFwBAQF65513VLVq1VTLrlmzRuvWrdPRo0clSZUrV9bAgQPTLA8AAICcK1PDDOLj4xUYGJhie+XKlZWQkJChc61fv14hISHq06ePPv/8cwUEBKhbt26KiIhItfwff/yh5s2ba/ny5Vq9erUee+wxvfrqq7p06VJmmgIAAAADy1SYbdWqlVatWpVi+5o1a9SyZcsMnWvJkiVq166d2rZtq7Jly2rs2LHKnTu3QkNDUy0/ZcoUdejQQRUrVpS/v7/Gjx+vxMREhYWFZaYpAAAAMLBMDTOQkpfn+vXXX1WtWjVJ0t69e3X+/Hm1bt1aISEh1nLDhw9P8xxxcXE6cOCAXn/9des2s9ms4OBg7d69O131iI2NVXx8vDw8PDLZEgAAABhVpsLskSNHVKlSJUnS6dOnJUmenp7y9PTUkSNHrOUetFxXVFSUEhIS5OPjY7Pdx8dHJ06cSFddJk+erEKFCik4ODgjTQAAAEAOkKkwu2LFCnvXI1Pmz5+v9evXa/ny5cqVK5ejqwMAAIBslulhBvbg5eUli8WSYrJXRESEfH1973vsokWLNH/+fC1ZskQBAQFZWU0AAAA4qUy/NMEe3NzcVLlyZZvJW3cnc9WoUSPN4xYsWKAPP/xQCxcuVJUqVbKjqgAAAHBCDr0zK0ldu3bVsGHDFBgYqKpVq2rZsmWKjY1VmzZtJElDhw5V4cKFNWjQIEnJQwtmzJihKVOmqFixYgoPD5ck5c2bV/ny5XNYOwAAAJD9HB5mmzVrpsjISM2YMUPh4eGqWLGiFi5caB1mcOHCBZnN/9xAXr16te7cuaM33njD5jx9+/ZVv379srXuAAAAcCyHh1lJ6tixozp27Jjqvv+dbLZly5bsqBIAAAAMwKFjZgEAAICHQZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABgWYRYAAACGRZgFAACAYRFmAQAAYFiEWQAAABiWw8PsypUr1bhxY1WpUkUvvPCC9u7dm2bZo0ePql+/fmrcuLEqVKigpUuXZl9FAQAA4HQcGmbXr1+vkJAQ9enTR59//rkCAgLUrVs3RUREpFo+NjZWxYsX16BBg1SwYMFsri0AAACcjUPD7JIlS9SuXTu1bdtWZcuW1dixY5U7d26FhoamWr5q1aoaNmyYmjdvLjc3t2yuLQAAAJyNw8JsXFycDhw4oODg4H8qYzYrODhYu3fvdlS1AAAAYCAOC7NRUVFKSEiQj4+PzXYfHx9duXLFQbUCAACAkTh8AhgAAACQWQ4Ls15eXrJYLCkme0VERMjX19dBtQIAAICROCzMurm5qXLlygoLC7NuS0xMVFhYmGrUqOGoagEAAMBAXBz54V27dtWwYcMUGBioqlWratmyZYqNjVWbNm0kSUOHDlXhwoU1aNAgScmTxo4fP279+6VLl3To0CHlzZtXpUqVclg7AAAA4BgODbPNmjVTZGSkZsyYofDwcFWsWFELFy60DjO4cOGCzOZ/bh5fvnxZrVu3tv68ePFiLV68WLVr19aKFSuyu/oAAABwMIeGWUnq2LGjOnbsmOq+/w2oxYsX119//ZUd1QIAAIABsJoBAAAADIswCwAAAMMizAIAAMCwCLMAAAAwLMIsAAAADIswCwAAAMMizAIAAMCwCLMAAAAwLMIsAAAADIswCwAAAMNy+OtsAQAwqtDQNVq1aoUiIyPk719OAwYMUaVKgWmW37JlkxYunKOLFy+oePES6tWrn+rWrWdT5uTJvzVnzgz9+ecuJSQkqHRpP40fP0lFihTJ6uYAhsSdWQAAMmHz5u80a9ZUde3aXYsWfaSyZctr4MB+ioqKTLX8vn17NHbsSLVo0UqLF69U/fqNNHz4YJ04ccxa5ty5s+rd+zWVKlVaM2fO07Jlq/XKK92UK5dbdjULMBzCLAAAmbB69Uq1bNlazZs/qzJl/DRkyHDlzp1bX3/9Zarl165drTp16urllzurdOky6t69l8qXD1Bo6BprmfnzZ6tu3WD17v2mypcPULFixVWvXkN5eXlnV7MAwyHMAgCQQXfu3NGRI4cVFFTHus1sNisoqLYOHNib6jH79+9VUFBtm2116tTV/v37JEmJiYn67bdfVaJEKQ0c2FctWjyl7t276KeffsyydgA5AWEWAIAMunbtqhISEuTtbXvH1NvbWxEREakeExkZkeIOq5eXtyIjk8tHRUUqNjZGH320VHXq1NXUqbPUoMETGjlyiHbv3pk1DQFyACaAAcAjyt6TlyZMGKMNG762OaZ27br6z39mWn8eNmyAjh49oqtXo+Tu7q6goNrq1esN+foWtH8DDSYpKUmSVK9eQ7Vv30GSVK5cBe3fv0fr1oWqRo1/ObJ6gNMizALAI+ju5KXBg4erUqVArVmzSgMH9tOqVaGpjs+8O3np9df7KDi4vr7/fqOGDx+sxYs/kp9fWWu5OnWCNWLEKOvPrq62E5dq1gxSp06vytfXV+HhlzV79nS9/fYwzZ27OOsamwU8PDxlsVgUGWk72SsyMlI+Pj6pHuPt7ZNiclhUVKS8vX1szlm6dBmbMqVKldG+fX/ar/IOkN0XThcunNfSpQu1a9cORUREyNfXV02bNlPnzq/K1dU1axoJh2GYAQA8grJi8pIkubm5ysfH1/qnQIECNvvbt++gwMAqKlLkMVWpUk0dO3bRgQP7FB8fn2VtzQqurq4qXz5AO3dus25LTEzUzp3bVbly1VSPCQysqh07ttts2779DwUGVrGes2LFyjpz5pRNmTNnTqtw4cfs3ILskxWrPkjJF05ffLHR+mfMmAnWfadOnVRSUpKGDBmhFSs+0RtvDNS6daGaN292lrYVjkGYBYBHTFZMXrpr9+6datHiKb30UhtNnhyia9euplmP69ev6bvvNiowsKpcXIz3oPDFFzvoq6/WacOGr3Xy5N+aPDlEsbGxat68pSRp3LhRmjt3lrX8Cy+8qD/++E2rVn2kU6dOatGieTp8+KDatm1nLfPSS520efP3+vLLz3X27BmFhn6i3377Wc8990K2t89eHHHh9PjjwRoxYrRq137cuiLESy911NatP2RpW+EYxvvtAQB4KPebvHTq1MlUj3nQ5CUpOdw2bPiEHnusmM6dO6v582dr8OA3NHfuElksFmu5Dz+coc8+W6Nbt26pcuUqmjRpqv0al42efPJpXb0apYUL5yoyMkJly5bXlCkzrcMGLl26KLP5n3tGVapU0+jRE7RgwYeaP3+2ihcvoZCQyTbDNBo2fEKDBw/XRx8t1bRpk1WyZCmNH/++qlWrnt3Ns4u7F06dOnW1bkvPhdOLL3aw2VanTt0UqzrcvXByd3fXv/5VS92795KHh2eadYmOjk7xpAA5A2EWAGAXTZo0tf7d37+s/P3Lqn371tq9e6fNXd2XX+6sFi1a6dKlC1q8eIHGjx+tSZOmyWQyOaLaD6Vt2/Zq27Z9qvtmzZqfYlvjxk3UuHGT+56zRYtWatGilV3q52iOvnC66+5d7j59+j90m+B8GGaALBMaukbPP99SjRsHq3v3Ljp4cP99y2/Zskkvv9xWjRsHq3Pn9goL+yXNsh98MFH16gVpzZqPU+z77bdf1L17FzVu/G8988wTGj580EO3Bc6N71rGZMXkpdQUK1Zcnp6eOnv2jM12T09PlSxZSrVqPa6xYycqLOxXHTiwL42zGIfZbJKLi9luf8xm44X77NKkSVPVq9dQ/v5l1aBBI73//lQdOnQw1SXMwsMva9CgfnriiSZ69tnnHFBbZDXCLLJEVg34l6StW3/QgQP7U13K58cfN2vcuFFq3rylli79WHPmLFKTJs/YvX1wHnzXMi4rJi+l5vLlS7p27Zp8fX3TLJOYmLwcVVxcXEaa4HTMZpM8PPPKyyuf3f54eOY1fKB19IXTlSvh6tevpwIDq2ro0JGZbAWcHcMMkCXuHfAvSUOGDFdY2C/6+usv1anTKynK3zvgX5K6d++l7dv/UGjoGg0ZMsJaLjz8sqZN+0BTpszU0KH9bc4RHx+v6dOnqE+fN9SiRWvr9jJl/OzePjgPvmuZ8+KLHTRhwhgFBFRSxYqVtWbNxykmLxUsWEg9e/aVlDx5qW/fHlq16iMFB9fTpk3f6vDhgxo6NLnPYmJitGTJAjVs2Fg+Pj46d+6sPvxwhooVK6HatetKkg4c2K/Dhw+oatXqcncvoHPnzmrhwjkqVqy4AgNTD9FGYTab5GIx683Vu3XscvRDn69sofya/mINmc0ma+A3onsvnBo0aCTpnwunNm3apXrM3Qundu1etm7LzIVTePhl9evXUxUqBGjEiNE245eRsxBmYXdZNeA/MTFR48aN0ksvdZKfn3+Kcxw5cljh4ZdlMpnVtevL/52QUUF9+rxhM8HC2dl7PcZ7ffDBRH3xxWd6442B1n8ojLweI9+1zLP35CWLxazjx49qw4avFR19Q76+BVWr1uPq3r2n3NyS15rNnTu3tm79QYsWzdetW7Hy8fFVnTp19e673axljO7Y5WgdOH/d0dVwKo64cEoOsq+rcOHH1Ldvf129GmWtj49P2k8KYEyEWdhdVg34X7lymSwWi1544cVUz3H+/DlJ0uLF89Wv3wAVKVJUq1d/pH79XteqVZ+pQAGPh2hV9siqheyltB+Z37seY7FixfX338f1/vsTFBsbq759+2dlcx8a37WHY8/JS7ly5dZ//jMr1X13+fuX1YwZczNeURiaIy6ctm//Q2fPntHZs2f03HPNbOrzyy87sqnlyC6EWRjC4cOHtHbtai1e/FGaM57vPorr3PlVNWr0pCRpxIjRatOmmbZs2aTWrdtmW30zyxGPzB9/PFiPPx5s/blYseI6ffqUPv881OnDbFZ4VL5rQHbK7gunZs1aqlmzlhmvKAyJMAu7y4oB/3v37lZUVKTatm1h3Z+QkKBZs6ZpzZpV+vTTr6xjpUqX/mfcopubmx57rJguXbpol7ZlJUc9Mk+NUdZj5LuWdcxmk90mHyUmJhl63CeyFt81PCzCLOwuKwb8N23aLMXbhwYO7KemTZtZx11VqBAgNzc3nTlz0rrAeHx8vC5evKAiRZz/VZCOemT+v4y0HiPftaxxd2a+i8U+E2biExJ17WoMIQMp8F2DPRBmkSXsPeDfw8MzxZtdXFxc5OPjo5IlS0uS8uXLr1at2mrRovkqVKiIihQpoo8/XiFJeuKJ+y9SnlOl55H5vYy4HiPfNfuz58z8nDIrH1mD7xrsgTCLLJEVr3lMjz593pTFYtG4caN0+/ZtVapUWdOnz+GR+X0emd9l1PUY+a5lHWbmI7vwXcPDIMwiy2TFax7vdW8Qu8vFxUV9+/Y35MQlRz0yl4y/HiPfNQB4dBFm4RD2HPAv5ZxB/454ZJ7T12PkuwYAORthFtnO3gP+pZwz6N8Rj8xz8nqMfNcAIOcjzCLb8drH+8vuR+Y5eT1GvmsAkPMRZuEwDPjPONZjzBy+awCQcxFmAYNgPUYAAFIizAIGwXqMAACkRJgFDIZH5gAA/MNYi0kCAAAA9yDMAgAAwLAYZgAAgAOYT/wil6M/SLduKMmjqOKrPqck71Jplt+yZZMWLpyjixcvqHjxEurVq5/q1q1n3b916xatWxeqv/46rOvXr2nJkpUqV66CzTnOnTurWbOmad++PxUXd0d16tTVgAFDrGtZA0bEnVkAALKZ+exuuez7QvEBTXXniYFK8igq19/mS7dvpFp+3749Gjt2pFq0aKXFi1eqfv1GGj58sE6cOGYtExsbq6pVq6tXr36pniM2NlYDBvSRyWTS9OlzNWfOIsXH39GwYQOUmJiYJe0EsgNhFgCAbGY5tlWJpR9XYqnaSipQRPHVn5csrrKc3JZq+bVrV6tOnbp6+eXOKl26jLp376Xy5QMUGrrGWuaZZ5qra9fuCgqqneo59u3bo4sXL2jkyNHy9y8rf/+yGjlyrA4fPqSdO7dnSTuB7ECYBQAgOyXGy3T1rBILlv9nm8msxILlZYo8meoh+/fvTRFS69Spq/3796X7Y+Pi4mQymeTq6mbd5ubmJrPZrL17/8xICwCnQpgFACA73b4pU1KiknK522xOyu0uUxrDDCIjI+Tl5W2zzcvLW5GREen+2MqVqyh37tyaM2embt26pdjYWM2ePU0JCQmKiLiS8XYAToIJYACAh5bdk5muX7+mRYvmadu233Xp0iV5enqqQYNGeu21XsqfP3+WttWovLy8NG7c+5o8OUSffrpaZrNZTZo8rfLlA2Q2c28LxkWYBQA8FOtkpuovKMmrpCzHf5Lrb/MV99RbkgqkKH93MtPrr/dRcHB9ff/9Rg0fPliLF38kP7+ykv6ZzNS48VN6//3xKc5x5Uq4rlwJV58+/VWmjJ8uXrygDz4I0ZUr4Ro/flJWN/nh5MqnJJNZpts3dO/790y3bqS4W3uXt7ePoqIibbZFRUVmeBWC2rUf15o1X+jq1auyWCxyd3fXs882VdGixTLaCsBpEGYBAA/l3slMkhRf/Xm5XTyYPJmpzHMpyt87mUmSunfvpe3b/1Bo6BoNGTJCUvJkJkm6cOF8qp/p51dWEyZ8YP25WLHi6tGjt8aNe0fx8fFycXHif97MLkryLC5z+FElFq2SvC0pUebwo0rwq5fqIYGBVbVjx3a1a/eyddv27X8oMLBKpqrg6ekpSdq5c7uioiJVr16DTJ3HEez9FCApKUmLFs3TV199rhs3olWlSjUNHvyWSpQoaS3z11+HNWfODB0+fFBms0UNGzZWv34DlDdv3ixtK9KH5woAgMxz0GSm1Ny8Ga18+fI5d5D9r4SyDWU++bvMp7bLdP2SXP78VEqIU8J/LwgubVqkKVOmWMu/8MKL+uOP37Rq1Uc6deqkFi2ap8OHD6pt23bWMtevX9PRo3/p5MkTkqTTp0/p6NG/bMbDfvPNl9q/f5/OnTurb79dr3feeUvt2r2skiVLZ0/DH1JWLGm2cuUyffrpag0ePFzz5y9Vnjy5NXBgP92+fVtS8lOA/v17q3jxEpo/f6mmTJmhkyePa+LEMdnRZKSD8/8fDwBwXveZzGSOvpzqIfaYzPS/rl69qqVLF6ply5R3gp1RYvEair8dLZdDG6Xb15XkUUx3gntIuZP78c6NCIWHh1vLV6lSTaNHT9CCBR9q/vzZKl68hEJCJluHZUjSL7/8pIkTx1p/Hj06+S53167d1a3b65KSA+68ebN1/fo1FSlSVJ07d1X79h2yo8l2Ye+nAElJSVq7dpU6d+6m+vUbSZLefvtdPfvs0/r55x/VpElT/frrz3JxcdHAgcOsY4sHDx6hLl1e1NmzZ1S8eInsaDrugzALADC0mzejNWTImypd2s8a2owg0b++4vzrp7qv+HND9d4b9RUVddO6rXHjJmrcuEma52vWrKWaNWt538/s1atfmi9VcHr/fQqQUP7Jf7al4ynAiy/ahvU6derqp59+lCSdP39OERERqlXrnycF+fPnV6VKgdq/f5+aNGmqO3fi5OrqajNJLleuXJKkvXv/JMw6AYYZAAAy757JTPfKjslMkhQTc1ODBr2hvHnzaeLEDwwxxCAjLBazXFwe/o/ZbHJ0Ux5eFixpdve/Xl4+aZapWbOWIiKu6OOPl+vOnTu6fv265s6dKUksaeYkctb/9cixHDHgf9iwATp69IiuXo2Su7u7goJqq1evN+TrWzBL2woYigMnM928Ga2BA/vJ1dVV77//H+vdspygYP5cUmKCChTIY5fzJSXEK/LqLSUmJj24MGz4+flr5MixmjVrqubNmy2z2aznn39R3t4+MplywEVCDkCYhdO777I/qdz5Sc+yP3cH/I8cOUaPPVZMCxfO0cCB/fTRR2us/yDWrBmkTp1ela+vr8LDL2v27Ol6++1hmjt3cba2H9nLERdOy5YtUljYrzp69C+5urpq48Yfs7KJdpdQtqFcdq6S2bPEf/8f3WozmWno0KHy8PBWjx59JCVPZurbt4dWrfpIwcH1tGnTtzp8+KCGDh1hPef169d06dJFXbmSPG709OlTkpLv6vr4+OrmzWgNGNBXt2/f0qhR43TzZrRu3oyWJHl6eslisWRnF9hdgTwuktkihb4mXTnycCfzLS9T24Uym03GDrNZsKTZ3f9GRUXI19fXpkzZsv9Manz66Wf09NPPKDIyQrlz55HJZNInn6xU0aLF7dQ4PAyGGcDp2fsd5v874L9s2XJ6++13FRERrp9//tF6nvbtOygwsIqKFHlMVapUU8eOXXTgwD7Fx8dnfaOzUWjoGj3/fEs1bhys7t276ODB/fctv2XLJr38cls1bhyszp3bKyzsl2yqadZzxExpSYqPj9cTTzyp1q2fz/I2ZoXE4jUUH9hSLoc2yvWHyTJdO28zmenChQu6cuWfx7F3JzN9+eVneuWVl/Tjj5tTnczUtWsHDRnSX1LyZKauXTto3bpQSclLJR08uF/Hjx9T+/at1arVM9Y/ly9fyr7GZ7UrR6QLex7uz8OGYWdxz1MAq/8+BUjyLp3qIXefAtzr3qcARYsWk4+Pj02ZmzejdfDg/lSfFHh7+yhv3rzavPk7ubm5qVatOg/fLjw07szCuTlowP//un79mr77bqMCA6vmqDF533//rWbNmqrBg4erUqVArVmzSgMH9tOqVaEpxplJ6bvrbWT3mymdUOHJFOXtMVNaknXS0vr1X2V5G7PK/SYzrVixQlFRNxUfn2jd9rCTmWrWDNIvv+zIfIVhSPZ+CmAymfTCCy9p2bJFKlGihPVJnY9PQev/s5IUGvqJAgOrKU+ePNq+/Q99+OF09ezZT+7uqd8RRvbKOf8qI2fKgmV/0jPg/64PP5yhzz5bo1u3bqly5SqaNGnqQzXH2axatVItW7ZW8+bPSpKGDBmusLBf9PXXX6pTp1dSlE/PYveG5SQXTjmVxWKfB4GJiUnGflSOh/KgJc0uXLigO3f+uWhKz5JmHTp00a1btzRp0kRFR99QlSrVNWXKDJsx2AcPHtCiRfMVGxujkiVLa8iQEdYXe8DxCLPAfbz8cme1aNFKly5d0OLFCzR+/GhNmjQtRwz6j4uL019/HVLHjq9Yt5nNZgUF1daBA3tTPeZB4c3QHHzhlFMxkQn2Zu+nACaTSa+91lOvvdYzzTLvvPNu5iuMLEeYhXNz4IB/KfmVj56enipZspRKlSqjNm2a68CBfQoMrGqHxjlWVFSUEhIS5O1tG8a8vb116tTJVI/JisXukbMxkQnZjacAjx7CLJxbFiz7c++A/3LlKkj6Z8B/69Zt06zK3V9qcXFx9mgZnI2DL5xyvLsTmYAswlOARxdhFk7vQQP+L21apCl3tunVV5MfEdljwP+BA/t1+PABVa1aXe7uBXTu3FktXDhHxYoVzxF3ZSXJyyt5+aLISNswFhkZKR+f1Bevt+di907HiS6cAGQcTwEeXYRZOL2seIf5gwb8586dW1u3/qBFi+br1q1Y+fj4qk6dunr33W5yc3PL3g7IIm5ubqpQoaJ27tymBg0aSZISExO1c+d2tWnTLtVj7LXYvbNyxIWTJF28eFE3biSvq5qQkKijR/+SJBUrVkJ58+bN3k4AjI6nAI8cpwizK1eu1KJFixQeHq6AgAC98847qlo17btfGzZs0PTp03Xu3DmVLl1agwcPVsOGDbOxxshu9n6H+YMG/Pv7l9WMGXMfrtIG8NJLHTRu3GgFBFRSxYqVtWbNx4qNjVXz5slLIo0bN0oFCxZSz559JaVvsXsjc8SFkyQtWjRXGzZ8bf25a9fkSXYzZsxVzZpBWd1sADA0h4fZ9evXKyQkRGPHjlW1atW0bNkydevWTRs3bkz1UeeuXbs0aNAgDRw4UE888YS++uor9enTR5999pnKl3/ExqDBBoP+M+6pp5oqMjJSCxfOVWRkhMqWLa8pU2Zahw1cunRRZvM//Zqe8GZ02X3hJEkjR47RyJFjMl1nAHiUOTzMLlmyRO3atVPbtsnjx8aOHasff/xRoaGh6tGjR4ryy5cvV/369fXaa69Jkvr376/ffvtNH330kd59l6UzHkUM+n84bdu2V9u27VPdN2vW/BTbHhTeHgVcOAGA83BomI2Li9OBAwf0+uuvW7eZzWYFBwdr9+7dqR7z559/6pVXXrHZVq9ePW3atClDn23vZUIrFy2gPG4P9y5w/4L5k/9SpKrk+pDj5Hz+uVPmrEui2qPPJKlGSc/kQf+/TJOun3u4kxUoJlO9/jKbTUpKcs6QYY9+8/PNJ8l+oSwpyblDmb2+a/8q6Wn3C6eoa8574cTvtYyz13eNfss4+ixznLXfMnK8KcmB/2JfunRJDRo00OrVq1WjRg3r9kmTJmn79u1au3ZtimMCAwP13nvvqUWLFtZtK1eu1OzZs/Xbb79lS70BAADgHOxzWwYAAABwAIeG2bvrXEZE2L49KCLCdoHxe/n6+urKlSvpLg8AAICcy6Fh1s3NTZUrV1ZYWJh1W2JiosLCwmyGHdyrevXq+v333222/fbbb6pevXpWVhUAAABOyOHDDLp27ao1a9bo888/1/HjxzVmzBjFxsaqTZs2kqShQ4dqypQp1vKdO3fWzz//rMWLF+v48eOaOXOm9u/fr44dOzqqCQAAAHAQhy/N1axZM0VGRmrGjBkKDw9XxYoVtXDhQuuwgQsXLtisc1mzZk1NnjxZ06ZN03/+8x+VLl1as2fPZo1ZAACAR5BDVzMAAAAAHobDhxkAAAAAmUWYBQAAgGERZgEAAGBYhFkAAAAYFmEWAAAAhkWYBQAAgGE5fJ3ZR118fLyOHTum8PBwSVLBggXl7+8vV1dXB9fMeOLj43X58mUVLVrU0VVxSuHh4dqzZ4/1ddC+vr6qVq2aChYs6OCaGU9MTIwOHDigWrVqOboqAPDII8w6SGJioqZPn66PP/5YN27csNnn7u6uDh066I033rB5YQTu79ixY3ruued06NAhR1fFqcTExGjUqFFav369TCaTPDw8JEnXrl1TUlKSmjdvrnfffVd58uRxcE2N4/Tp0+rcuTPftfvg4sl+uHi6v71792r37t0237UaNWqoatWqDq6Z8Vy7dk0//PCDWrdu7eiqZAhh1kEmT56szz//XIMGDVK9evWsbzy7cuWKfv31V02fPl137tzRkCFDHFxTGN2ECRO0b98+zZs3T8HBwbJYLJKkhIQEhYWFady4cZowYYLGjx/v4JoiJ+Diyf64eEpdRESE+vXrp127dqlo0aLy8fGxbg8JCVHNmjU1c+ZM63Y82IULFzR8+HDDhVneAOYg//73v/Xee++pfv36qe7/+eefNWzYMP3222/ZXDPn9dxzz913/61bt3Ty5El+4f+PWrVqad68eapZs2aq+3fu3KmePXtq+/bt2Vwz51W7du377k9ISFBMTAzftVSMHDlSO3bs0Ntvv53mxVOtWrW4eMqAw4cP89QpFW+88YYuX76siRMnys/Pz2bfiRMnNGLECBUqVEgzZsxwUA2dT3R09H33Hz58WJ06dTLcd407sw5y8+ZNFSpUKM39BQsWVGxsbDbWyPkdO3ZMzZs3V/HixVPdf/nyZZ08eTJ7K2UAiYmJ9x2D7erqqsTExGyskfOLi4vTSy+9pPLly6e6/9y5c5o9e3Y218oYvvvuu1QvniwWi+rVq6eJEyeqZ8+ehNl7pOfiCSn9/PPPWrlyZYogK0l+fn56++231alTJwfUzHkFBQXJZDKluT8pKem++50VYdZBateurUmTJumDDz6Qt7e3zb7IyEhNnjz5gb/gHjXlypVT1apV9fLLL6e6/9ChQ1q7dm0218r5NWrUSKNGjdKECRNUqVIlm30HDx7UmDFj9MQTTziods4pICBARYoUSfNpwOHDhwmzaeDiKeO4eMocNze3+95pvHnzptzc3LKxRs4vX7586tmzp6pVq5bq/lOnTmnUqFHZXKuHR5h1kLFjx6pHjx6qX7++ypcvbzPW58iRI/L399e8efMcXEvnUrNmTf39999p7s+XL5+CgoKysUbGMGrUKA0aNEht2rSRh4eH9eIpMjJS169fV7169Qz5yysrNWrUKMXEzHt5eHgYbkxZduHiKeO4eMqcZs2a6a233tLw4cNVt25d5c+fX1Lyo/SwsDCFhISoRYsWDq6lc7n7/2RaN8sKFCggI44+ZcysAyUmJurnn39OMeO3evXqqlevHisZwK6OHz+uP//8M8V3zd/f38E1Q05y7do1DRo0SL/88kuaF09TpkxRgQIFHFxT5zF37lzFx8erb9++qe6/cOGCZsyYoZCQkGyumXOLi4vThAkTFBoaqoSEBOsTgTt37shisej555/XiBEjuDt7jzVr1ujWrVvq3LlzqvuvXLmi1atXp/lddFaEWQCA3XHxhOwSHR2t/fv323zXAgMDrXdqkfMRZh2M9fEyjj6zL6OuK+hI9BkAOA/CrIPcb3288+fPsz5eKuizrMGyPxlHn91fXFycNm3alOLObI0aNfTkk0/y2DcV9Jn9GfWRuSMZtc8Isw7C+ngZR59lTk5dVzAr0WeZd+rUKXXr1k2XL19WtWrVbC469+zZoyJFimjBggUqVaqUg2vqPOizrMFFZ8YZtc8Isw5So0YNrVy5MsVs37v279+vTp06affu3dlcM+dFn2VOQEBAutYVNNovr6xEn2Ve165dlSdPHk2aNCnFmMXo6GgNHTpUt2/f1qJFixxUQ+dDn2XO4cOH77v/xIkTGjRoEP+f3iOn9hlLczkI6+NlHH2WOTl1XcGsRJ9l3q5du7R27dpUJ9/kz59fb775ptq1a+eAmjkv+ixzWrduLZPJlOpSUne3G/EFAFkpp/YZYdZBWB8v4+izzMmp6wpmJfos89zd3XXu3Ln7vgDA3d09m2vl3OizzPHw8NCQIUNUt27dVPcfO3ZMPXv2zOZaObec2meEWQcZPny4EhMTNWDAgDTXxxs2bJiDa+lc6LPMadmy5X1fjezr62u4wf5ZjT7LvBdeeEHDhg1T79699fjjj8vX11dS8sSS33//XXPmzFHHjh0dXEvnQp9lTmBgoC5fvqxixYqluv/GjRtcdP6PnNpnjJl1MNbHyzj6DHBu8+fP1/Lly3XlyhXrI8ukpCT5+vqqS5cu6t69u4Nr6Hzos4z7/vvvFRMTo1atWqW6/9q1a9qyZUuab1Z7FOXUPiPMOlBkZKRCQ0NTXYqlTZs21jfn4B/0WebQbxlHnz28M2fO2PRdiRIlHFwj50efARlHmHWQvXv36rXXXlPu3LkVHBxssxRLWFiYbt26pYULF6pKlSoOrqnzoM8yh37LOPos6/Bq1oyjzzKHfss4o/YZYdZB2rVrp4CAAI0dOzbFzMGkpCSNHj1af/31lz755BMH1dD50GeZQ79lHH2WdYy6jqUj0WeZQ79lnFH7jAlgDnL48GGFhISkugSGyWRSly5dDDdmJavRZ5lDv2UcfZZ5mzdvvu/+M2fOZFNNjIM+yxz6LeNyap8RZh3E19dX+/btk7+/f6r79+3bZ53RimT0WebQbxlHn2Venz590lzH8i4jrmOZleizzKHfMi6n9hlh1kG6deumd955R/v371fdunVtlmIJCwvT2rVrNXToUAfX0rnQZ5lDv2UcfZZ5BQsW1OjRo9WkSZNU9x86dEht2rTJ5lo5N/osc+i3jMupfUaYdZAOHTrIy8tLS5cu1apVq5SQkCBJslgsqly5skJCQtSsWTMH19K50GeZQ79lHH2WeZUrV9aBAwfS/MfyQXeFHkX0WebQbxmXU/uMCWBO4M6dO4qKipIkeXl5WV8GgLTRZ5lDv2UcfZYxO3bsUExMjBo0aJDq/piYGO3fvz/Nt6s9iuizzKHfMi6n9hlhFgAAAIZldnQFAAAAgMwizAIAAMCwCLMAAAAwLMIsAAAADIswCwAAAMMizAKAk3nrrbfUu3fvDB83c+ZMtWrVKgtqBADOizALAAAAw2KdWQBwkI0bN2r27Nk6deqU8uTJo4oVK6pixYpavHixTbnly5erTp06+uCDD7Rp0yZdvHhRvr6+atmypfr06SNXV1d99tlnGj58uM1xISEhatOmja5fv673339fmzdvVlxcnAIDAzVixAgFBARIkg4fPqwJEyZo//79MplMKl26tMaOHasqVapkW18AQGbxOlsAcIDLly9r0KBBGjJkiJo0aaKbN29qx44dat26tS5cuKDo6GiFhIRIkjw8PCRJ+fLlU0hIiAoVKqQjR47onXfeUb58+dS9e3c1a9ZMR48e1c8//6wlS5ZIktzd3SVJb775pnLlyqUFCxbI3d1dn3zyibp06aJvv/1Wnp6eGjx4sCpWrKgxY8bIYrHo0KFDvOkMgGEQZgHAAcLDwxUfH6+nnnpKxYoVkyRVqFBBkpQ7d27FxcWpYMGCNsfcO462ePHi+vvvv/XNN9+oe/fuyp07t/LmzSuLxWJz3I4dO7R3716FhYXJzc1NkjRs2DBt2rRJ3377rdq3b6/z58+rW7du8vf3lySVLl06K5sOAHZFmAUABwgICFDdunXVsmVL1atXT/Xq1VPTpk2td2FTs379ei1fvlxnzpxRTEyM4uPjlT9//vt+zl9//aWYmBjVqVPHZvutW7d0+vRpSVLXrl319ttv64svvlBwcLCeeeYZlSxZ8uEbCQDZgDALAA5gsVi0ZMkS7dq1S7/++qtWrFihqVOnas2aNamW3717twYPHqx+/fqpXr16cnd31zfffGMdUpCWmzdvqmDBglqxYkWKfXeHIfTr108tWrTQ1q1b9dNPP2nGjBmaOnWqnnrqqYdvKABkMcIsADiIyWTSv/71L/3rX/9Snz599MQTT2jTpk1ydXVVYmKiTdndu3eraNGi6tWrl3Xb+fPnbcqkdlzlypV15coVWSwWFS9ePM26lClTRmXKlNErr7yigQMHKjQ0lDALwBAIswDgAHv27FFYWJj+/e9/y8fHR3v27FFkZKT8/Px0+/Zt/fLLLzpx4oQ8PT3l7u6uUqVK6cKFC/rmm29UpUoV/fjjj9q0aZPNOYsVK6azZ8/q0KFDKly4sPLnz6/g4GBVr15dffr00ZAhQ1S6dGldvnxZW7duVZMmTVSuXDlNmjRJTZs2VfHixXXx4kXt27dPTz/9tIN6BgAyhqW5AMABjh8/rokTJ+rgwYOKjo5W0aJF1alTJ3Xs2FGRkZEaPHiwdu/erZiYGOvSXJMmTVJoaKji4uLUqFEjVatWTbNmzdKOHTskSXFxcRo8eLDCwsJ0/fp169Jc0dHRmjZtmr799ltFRUXJ19dXQUFBGjRokHx8fPTWW29p165dunLliry8vPT0009r6NChypUrl4N7CQAejDALAAAAw+INYAAAADAswiwAAAAMizALAAAAwyLMAgAAwLAIswAAADAswiwAAAAMizALAAAAwyLMAgAAwLAIswAAADAswiwAAAAMizALAAAAw/p/7+GnuI5b02kAAAAASUVORK5CYII=",
+      "text/plain": [
+       "<Figure size 800x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(\n",
+    "    {\n",
+    "        \"states\": states,\n",
+    "        \"noisy\": np.around(noisy_res_1 / sum(noisy_res_1), 3),\n",
+    "        \"mitigated_sg\": np.around(mitigated / sum(mitigated), 3),\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "ax = df.plot(x=\"states\", y=[\"noisy\", \"mitigated_sg\"], kind=\"bar\", figsize=(8, 5))\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_sg\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2927e72-98bb-41cf-8e77-35ea9572474a",
+   "metadata": {},
+   "source": [
+    "## Inverse confusion matrix from k local confusion matrices\n",
+    "\n",
+    "This method works under the assumption that the readout errors for different qubits are independent of each other and the confusion matrix $A$ can be factorized into the product of $k$ small local confusion matrices. We consider the special case when $k = n$ for $n$ qubits and different $2 \\times 2$ confusion matrices for each qubit\n",
+    "\n",
+    "$$\n",
+    "A = A_1 \\otimes \\dots \\otimes A_n\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "1e8fd13a-e0cf-4139-84ca-d81f7a71baa6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "000 becomes {'000': 388, '010': 235, '111': 18, '001': 174, '011': 79, '100': 58, '101': 28, '110': 44}\n",
+      "111 becomes {'000': 23, '010': 38, '111': 370, '001': 40, '011': 60, '100': 107, '101': 224, '110': 162}\n"
+     ]
+    }
+   ],
+   "source": [
+    "local_labels = [[0] * n_qubits, [1] * n_qubits]\n",
+    "local_states = [\"0\" * n_qubits, \"1\" * n_qubits]\n",
+    "\n",
+    "results = [\n",
+    "    cudaq.sample(kernel, n_qubits, label, shots_count=shots, noise_model=noise_2)\n",
+    "    for label in local_labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(local_states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0f592fb8-2ded-498e-b4fe-eff6eac74750",
+   "metadata": {},
+   "source": [
+    "The local confusion matrices are generated using the marginal probability distribution for each qubit."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "id": "7fabcc1f-8d9c-42c2-b02a-3ce42c1e34c6",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "counts = [dict(list(results[i].items())) for i, state in enumerate(local_states)]\n",
+    "matrices = []\n",
+    "\n",
+    "for k in range(n_qubits):\n",
+    "    matrix = np.zeros([2, 2], dtype=float)\n",
+    "    marginalized_counts = []\n",
+    "    total_shots = []\n",
+    "    for i in range(2):\n",
+    "        marginal_cts = dict(results[i].get_marginal_counts([k]).items())\n",
+    "        marginalized_counts.append(marginal_cts)\n",
+    "        total_shots.append(sum(marginal_cts.values()))\n",
+    "\n",
+    "    # matrix[i][j] is the probability of counting i for expected j\n",
+    "    for i in range(2):\n",
+    "        for j in range(2):\n",
+    "            matrix[i][j] = marginalized_counts[j].get(str(i), 0) / total_shots[j]\n",
+    "    matrices.append(matrix)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "7f016f9b-3243-42b3-ab59-4d03f7765b82",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[0.85546875 0.15722656]\n",
+      " [0.14453125 0.84277344]]\n",
+      "\n",
+      "[[0.6328125  0.38476562]\n",
+      " [0.3671875  0.61523438]]\n",
+      "\n",
+      "[[0.70800781 0.32226562]\n",
+      " [0.29199219 0.67773438]]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "for m in matrices:\n",
+    "    print(m)\n",
+    "    print()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "id": "51734299-307f-4081-b8cc-1968ebfc7d52",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[559  -1 -58  32 -28  26 -16 510]\n",
+      "\n",
+      "Corrected for negative counts:\n",
+      "[521   0   0  35   0  22   0 446]\n"
+     ]
+    },
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAe0AAAHACAYAAACPhjATAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9VUlEQVR4nO3deVxVdf7H8fe9CKJiolAuaIs64AIkalrmMmJO5ZZgWuOWW4uplT8dxTLLzKFmstxaLM20LCsVncZtKiudRHJBLTVLM0FDQ1CLRUE4vz8cbt1AvZtcjvf1nMdt4tzzPedzsfrcz+d8z/dYDMMwBAAAKjyrtwMAAACOIWkDAGASJG0AAEyCpA0AgEmQtAEAMAmSNgAAJkHSBgDAJEjaAACYBEkbAACTqOTtAFBxffnll/r3v/+tHTt2KDMzUwUFBQoODtaf/vQnderUSb169VKtWrW8GuOBAwf04osvKjU1VadOnVJxcbFGjx6tMWPGlFsMERERkqT9+/eX2zmdFRsbq6NHj0qSBg0apMmTJ19w3/nz5+uf//ynJMnPz0979+4tlxgdceTIEXXp0kVhYWHasGGDt8MByh1JG6VkZ2dr3Lhx2rx5syQpLCxMbdu2VdWqVZWZmanU1FRt3rxZs2bN0ltvvaUbb7zRK3Hm5eXpgQce0NGjRxUZGan27dvLz89PTZs29Uo8ZvHRRx9pwoQJCggIKPP95cuXe/ycJFvAM0jasPPrr7+qf//+OnTokBo2bKhp06apdevWdvsUFBQoKSlJc+bMUWZmppcilb7++msdPXpUMTExWrp0qdfiWLNmjdfO7azIyEh98803+vTTT3XnnXeWen/Hjh364YcfFBUVpa+//toLEV5c7dq1tWbNGvn7+3s7FMAruKYNO9OmTdOhQ4cUFham9957r1TClqSAgADdc889WrlypRo2bOiFKM/LyMiQJF1//fVei0GSGjVqpEaNGnk1Bkf16dNH0oWr6WXLltntV9H4+/urUaNGuvbaa70dCuAVJG3YpKen69///rckadKkSQoODr7o/qGhoWUm7dWrV+u+++5TmzZtFBkZqc6dO2vSpEk6dOhQmceJjY1VRESEjhw5oi1btmjYsGG66aabFB0drbi4OK1cudJu/5SUFEVERGjixImSpKSkJEVERNheJf748x8NGjRIERERSklJsdv+66+/6qWXXlLPnj3VokULW+v93nvv1axZs1RYWGi3/8XOc+rUKb344ovq3r27brzxRsXExCg+Pl5vvPGGzpw5U2r/ks82aNAgFRYW6vXXX1f37t0VHR2ttm3bavTo0Tp48OAFP9OlhIeHKzIyUl9++aWOHz9u915ubq7Wrl2rOnXqqH379hc8xoEDBzR79mzde++96tChgyIjI9W2bVsNGTKkzK5DQkKCunTpIkk6evSo3Z/V739vc+bMUUREhObMmaOffvpJjz/+uDp16qTmzZsrISFB0vk2e0REhGJjY+3OMW3aNEVERKh///46d+5cqRheeuklRUREKC4uTmfPnnX8FwZUMLTHYfPZZ5+pqKhIV111Van/KDrCMAwlJCRo5cqVqlSpklq3bq2QkBDt2bNHK1as0Nq1azV79mx17NixzPHLly/Xq6++qmbNmqlDhw46evSodu7cqYkTJ+rUqVMaMmSIpPNfFuLi4nT48GHt2LFD1157rVq1auXOR7fJz89X//799d1336lWrVq6+eabbdfyDx06pFdeeUVDhw51qD2bnp6u++67T0ePHlWtWrXUqVMnFRYWKiUlRS+88ILWrl2rhQsXqkaNGqXGFhYW6oEHHlBqaqpat26tRo0aaffu3fr444+VkpKipKQk1a9f36XP2KdPH33zzTdasWKFRo4cadu+du1a5eXlafDgwbJYLBccv3DhQi1btkwNGzZUeHi4rrrqKmVkZCglJUXJycnatWuXJk2aZNu/VatWysvL0/r161W1alXdfvvtF43vxx9/VFxcnPz9/dWyZUsZhqGaNWtedMzEiRO1c+dObd++XTNnztT48eNt723cuFHz5s1TUFCQZs6cqcqVK1/qVwRUXAbwP3/729+M8PBwY/DgwS6Nf/fdd43w8HCjbdu2xt69e23bi4uLjdmzZxvh4eFG69atjaysLLtxnTt3NsLDw43mzZsbGzZssHtv+fLlRnh4uNGqVSsjPz+/zPcmTpxYZjzh4eFGeHj4BeMdOHCgER4ebmzZssW2LSkpyQgPDzdGjBhhFBQU2O1fVFRkpKSkGGfPnnXoPH379jXCw8ONhx56yMjNzbVtz8rKMuLi4ozw8HDj//7v/+zGbNmyxXa83r17Gz///LPtvTNnzhjDhg0zwsPDjSeffPKCn6ssJb/jrVu3Gr/88osRHR1tdO3a1W6fe++914iIiDDS0tKM9PR0Izw83GjatGmpY6WkpBhpaWmlth88eNDo2LGjER4ebuzatcvuvZLjde7c+YIxlvwzEh4ebowfP77U7/lSx0lLSzNat25tREREGJ9//rlhGIaRkZFhtG3b1ggPDzfWrFlzwXMDZkF7HDbZ2dmSpJCQEJfGv/nmm5KkUaNG2c3gtlgsGj16tCIiIvTLL7/ogw8+KHP8wIED1blzZ7tt8fHxatiwoX799Vd98803LsXljBMnTkiSbr311lLVtNVqVZs2bS446/r3tm3bpl27dqlKlSqaNm2aqlatanuvVq1aeuaZZySdn8R27NixUuMtFosSExN19dVX27ZVrlxZjzzyiCTZZva7onr16uratasOHz6sr776SpL0ww8/aMeOHbrpppvUoEGDi45v06ZNmfs0bNhQDz/8sCRp3bp1LscXHBysKVOmOPR7/r0GDRooMTFRhmFowoQJSk9P19ixY3Xy5EkNHDiwzIl3gNmQtOERx44dU1pamiQpLi6u1PsWi0Xx8fGSVOoacok/JuwSJZO8/ngN9nKIioqSdP5e5ZUrV+rUqVMuHackGXbo0EGhoaGl3o+MjFSTJk1UXFxs2/f36tWrpyZNmpTa7qnfxR8npJX8v6MT0Equf7/44ot68sknlZCQoISEBP3nP/+RpAvOX3DELbfcourVq7s09rbbbtPQoUN16tQpxcXFaceOHYqMjLTNfwDMjmvasClZKCUrK8vpsSVJJDg4WEFBQWXuUzLj90IJp169emVuLzleeUwgatu2re6//34tWLBAEydOlMVi0XXXXaeWLVuqS5cuio2NldV66e+6JZ/xYtedr732Wn377bdl/j7q1q1b5piS30VBQYEjH+eCbr75ZtWvX1/r16/X448/rlWrVikoKEh33HHHJcdu2LBBkyZNuugXmpycHJdjCwsLc3msJI0fP16bNm3SgQMHVLVqVc2cOdPpqh2oqKi0YdO8eXNJ0t69e1VUVFTu57/Y5KfLobi4uMzt48eP18cff6zJkyfrjjvuUH5+vlasWKFRo0apX79+ysvLu+yxOfLFwB0Wi0VxcXHKz8/XxIkTlZmZqe7duyswMPCi444fP66xY8fq1KlTGjFihFatWqXt27dr37592r9/vxYsWOB2bJeK4VJ27dqlH3/8UdL5BXi+++47t2MCKgqSNmw6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rZLV+tt34BdeeEEJCQlq2rSpKleurH/961+aNWuWpkyZoqZNm2rfvn168sknVbVqVcXFxSk3N1cPPvig2rVrp3/+8586cuTIJR+kUatWLVmtVq1fv1733Xef/Pz8Su3z4Ycfqm/fvnrrrbfUuHFjW8Wfm5ur3r17a/LkyZKkN998Uw888IDWr1+voKAgLVu2TLfccosSExPVoUMH27G3bdumiRMnavLkyWrdurXS0tL05JNPSpJGjx7tyh8dAGcYgMlMnDjRGDlypGEYhlFcXGx8+eWXRmRkpPHcc8/Z3m/Xrp1x9uxZ25iVK1cat99+u1FcXGzbdvbsWSM6OtrYtGmTbVybNm2MvLw82z7vvvuu0aJFC6OoqKjMWLKysozw8HBj//79hmEYRnp6uhEeHm689dZbdvvddtttxkcffWS37eWXXzbuuecewzAMY+nSpUabNm2MM2fO2J07PDzc2Lt37wV/F++8845x4403GjExMcagQYOMuXPnGmlpabb3S+K52DEMwzCKioqMmJgYY8OGDbZt4eHhxscff2y333333We89tprdttWrlxp3HrrrRc9PgDPoNKGKX3++eeKiYlRYWGhDMNQjx49NGbMGNv74eHhdtexv/32W6Wlpally5Z2xzl79qxde7vkueElYmJilJeXp4yMDIWFhenHH3/U7NmztWvXLp08eVLG/x6Sl5GRofDwcNu4yMhI29/n5eUpLS1NTzzxhK0qlaRz586pevXqkqSDBw8qIiJClStXtjv3pQwYMEB33XWXvvrqK+3atUvr1q3TvHnz9Oqrr+rWW2+94LgTJ05o5syZ+uqrr5SVlaXi4mLl5+frp59+uuj5vv32W+3YsUOvvfaabVtRUZHOnj2r/Px8u98dAM8jacOU2rZtq6efflr+/v665pprVKmS/T/Kf0weeXl5at68uV544YVSx6pVq5bD533ooYcUFhamZ599Vtdcc42Ki4vVo0cP27OhS1StWtXu3JI0bdo03XjjjXb7/b6l7qqgoCDFxsYqNjZWjz32mIYPH37JpD1x4kSdOnVKTzzxhOrVq6eAgADdc889pT7HH+Xl5WnMmDH6y1/+Uuq933/hAHB5kLRhSlWqVNF1113n8P7NmzfX2rVrFRISoqCgoAvut3//fp05c0aBgYGSpJ07d6pq1aqqW7euTp48qUOHDunZZ59V69atJZ2/xnspoaGhuuaaa5Senq5evXqVuU+jRo20atUqnT171pb8du7c6fDnK2GxWNSwYUPt2LFDkmzXsIuKiuz227Fjh5566il16tRJ0vlOwcmTJ+328ff3LzWuWbNmOnTokFO/ewCew+xx+ISePXuqZs2aGjlypLZt26b09HSlpKTo2Wef1bFjx2z7FRQU6IknntCBAwf0xRdfaM6cORo4cKCsVqtq1Kih4OBgvf/++zp8+LCSk5P13HPPOXT+Rx55RK+//roWL16sQ4cOaf/+/Vq+fLltolyPHj1ksVg0efJk27nffPPNix5z3759GjlypNatW6cDBw7o8OHD+vDDD7V8+XLbrPGQkBAFBgZq06ZNOnHihO1WsOuvv17/+te/dPDgQe3atUvjx4+3fVEpERYWpuTkZGVmZur06dOSZJt0N3fuXH3//fc6ePCgVq9erZdeesmxPwgAbiFpwydUqVJF77zzjurVq6fRo0erW7dueuKJJ3T27Fm7yvuWW27RddddpwEDBuixxx5TbGys7Vq51WrVSy+9pD179qhHjx5KTEzUhAkTHDp/37599eyzz2rFihXq2bOnBg0apKSkJNWvX1+SVK1aNb322mv67rvv1Lt3b7300ksaP378RY9Zu3ZthYWF6eWXX1bfvn0VFxenxYsXa8yYMRo5cqQkqVKlSpo8ebLef/99dejQQQ8//LAkafr06Tp9+rTi4uI0YcIEDRo0SCEhIXbHnzhxojZv3qw///nPiouLk3T+/vjXXntN//3vf3X33XerX79+euuttxQWFubQ7wGAeyxGyUwawMclJCTol19+0SuvvOLtUACgTFTaAACYBEkbAACToD0OAIBJUGkDAGASJG0AAEyCpA0AgEmQtAEAMAmSNgAAJkHSBgDAJHwyaRcUFGjOnDkqKCjwdihOM2vsxF2+iLv8mTV2s8btq3w2ac+dO9eU/5CaNXbiLl/EXf7MGrtZ4/a2rVu36qGHHlL79u0VERGhTz755JJjUlJSFBcXp8jISHXt2lUrVqxw+rw+mbQBAHBHXl6eIiIi9NRTTzm0f3p6uh588EG1bdtWq1at0n333afJkydr06ZNTp2X52kDAOCkTp062Z5H74ilS5eqfv36SkhIkCQ1atRI27dv11tvvaUOHTo4fByfrbSrVavm7RBcZtbYibt8EXf5M2vsZo3b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",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# To find the joint pseudoinverse confusion matrix, we can first perform pseudoinverse of the\n",
+    "# local confusion matrices and then do the tensor product\n",
+    "\n",
+    "pinv_confusion_matrices = [np.linalg.pinv(m) for m in matrices]\n",
+    "A_pinv = reduce(np.kron, pinv_confusion_matrices)\n",
+    "\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_2), dtype=int)\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")\n",
+    "\n",
+    "A_joint = reduce(np.kron, matrices)\n",
+    "plot_cmat(A_joint)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "4261d8a3-b701-4939-8219-c0d823d42747",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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iIiIyN04ZWendu3a8fLLL1OyZEkMBgP169cHYM+ePfj6+uZogSIiIiIid5OtMDto0CCqVq3KxYsXeeqpp3BxcQHAZDLRu3fvHC1QRERERORushVmAZ566ikAbt26ZW175pln7r8iEREREZFMytac2dTUVObMmUPDhg2pU6cOZ86cAeDdd9+1LtklIiIiIpLbshVm586dyyeffMKIESNwdna2tlerVo2PPvoox4oTEREREbmXbIXZzz77jIkTJ/L0009jNP55iOrVq3Py5MkcK05ERERE5F6yFWYvXbpExYoV07WnpaWRkpJy30WJiIiIiGRGtsKsv78/O3bsSNe+ceNGAgMDs3y8FStW0LRpU0JCQujQoQN79+69a9+vv/6adu3aERoaSu3atWnTpg2ffvppls8pIiIiIo4vW6sZ9O/fn1deeYVLly6RlpbG119/ze+//86nn37K/Pnzs3Ss9evXEx4ezoQJE6hVqxZLly6lV69ebNy4ES8vr3T93d3d6devH76+vjg7O/Ptt98yevRovLy8aNiwYXYuR0REREQcVLbuzDZv3px58+YRFRVF4cKFmTlzJidOnGDevHnWt4Fl1uLFi+nYsSPt27fH39+fCRMm4OrqSmRkZIb969Wrx+OPP46fnx8VK1ake/fuVK9enZ07d2bnUkRERETEgWV7ndnQ0FAWL158XydPSkriwIED9O3b19pmNBqpX78+u3fv/sf909LS+OWXX/j9998ZPnz4fdUiIiIiIo4n22E2J8TFxZGamppuOoGXl9c9V0W4fv06jRo1IikpCaPRyLhx47J8R1hEREREHF+mw+zDDz/Mxo0b8fT05KGHHsJgMNy177Zt23KkuLspWrQon376KQkJCURFRTFlyhQqVKhAvXr1cvW8IiIiIpK/ZDrMhoWF4ebmZv37vcJsZnl4eGAymYiNjbVpj42Nxdvb+677GY1GKlWqBEBgYCAnTpxgwYIFCrMiIiIiD5hMh9lnnnnG+vd27drlyMldXFwICgoiKiqK5s2bA2CxWIiKiqJLly6ZPo7FYiEpKSlHahIRERERx5Gt1QwCAwPT3U2F23Ngs7rObM+ePVmzZg2ffPIJJ06cYPz48SQmJloD88iRI5k2bZq1//z58/npp584c+YMJ06cYNGiRXz++ec8/fTT2bkUEREREXFg2XoALC0tLcP2pKQk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",
+      "text/plain": [
+       "<Figure size 800x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(\n",
+    "    {\n",
+    "        \"states\": states,\n",
+    "        \"noisy\": np.around(noisy_res_2 / sum(noisy_res_2), 3),\n",
+    "        \"mitigated_k_local\": np.around(mitigated / sum(mitigated), 3),\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "ax = df.plot(x=\"states\", y=[\"noisy\", \"mitigated_k_local\"], kind=\"bar\", figsize=(8, 5))\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_k_local\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9329a30d-9224-42b1-9a66-1e87ba7c2674",
+   "metadata": {},
+   "source": [
+    "## Inverse of full confusion matrix\n",
+    "\n",
+    "Here we generate a quantum circuit for each of the basis states of $n$ qubits (i.e., $2^n$ combinations). This gives more accurate readout error mitigation. Since it scales exponentially with the number of qubits, it is only practical for small devices."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "id": "cf6025e8-1755-4c8f-96fa-1b67830d448d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "000 becomes {'000': 367, '010': 248, '111': 17, '001': 159, '011': 83, '100': 68, '101': 35, '110': 47}\n",
+      "001 becomes {'000': 161, '010': 93, '111': 46, '001': 363, '011': 253, '100': 17, '101': 76, '110': 15}\n",
+      "010 becomes {'000': 234, '010': 378, '111': 27, '001': 100, '011': 150, '100': 36, '101': 25, '110': 74}\n",
+      "011 becomes {'000': 106, '010': 145, '111': 65, '001': 251, '011': 386, '100': 11, '101': 30, '110': 30}\n",
+      "100 becomes {'000': 83, '010': 34, '111': 99, '001': 29, '011': 18, '100': 388, '101': 144, '110': 229}\n",
+      "101 becomes {'000': 22, '010': 13, '111': 247, '001': 70, '011': 43, '100': 163, '101': 371, '110': 95}\n",
+      "110 becomes {'000': 32, '010': 77, '111': 157, '001': 14, '011': 30, '100': 233, '101': 85, '110': 396}\n",
+      "111 becomes {'000': 14, '010': 31, '111': 393, '001': 38, '011': 60, '100': 95, '101': 233, '110': 160}\n"
+     ]
+    }
+   ],
+   "source": [
+    "results = [\n",
+    "    cudaq.sample(kernel, n_qubits, label, shots_count=shots, noise_model=noise_2)\n",
+    "    for label in labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "id": "28f2b2cb-13d3-4806-852d-06ea91e58c1d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# generate full confusion matrix\n",
+    "A_full = np.zeros((2**n_qubits, 2**n_qubits))\n",
+    "for i, state in enumerate(states):\n",
+    "    true_state = int(state, 2)\n",
+    "    for key, val in results[i].items():\n",
+    "        observed_state = int(key, 2)\n",
+    "        A_full[observed_state][true_state] = val / shots"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "id": "c3b0b80b-63ac-438a-9f3d-a6a3687da167",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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slqtOnfunNN3rapWrZqkS5c4Xa7KSklJsRt7rRWek75cPD///PNl59aqVUsDBw7UvHnztHnzZn3wwQeqU6eOvvnmGy1ZsuSqxy78jIWfuTgl/fv4o169eslqterzzz+X5FhrfNOmTTp//rw6d+6sv/3tb2rQoIECAwNtXzJ++umnaxrz1WRkZOj//u//dPHiRfXq1UsWi0VTpkyx3cIVMDuSNmxuvvlmde3aVZL03HPPXfV8bnp6un744QdJUvXq1W3t7zVr1hQZaxiG4uPjJV1qQZeEm266SZJsMf7et99+a7s5iyOaNGmifv36SZIOHjx41fGtWrWSJG3ZssW2uO33Dhw4oIMHD8pqteq2225zOA5Pqlmzpjp16qSgoCA1a9bModvRnj171jb3jwzD0EcffVTsvMIvUMVdQ+0phQvQTpw4oZ49eyouLk5Dhw7V2bNnNX78+CLX1wNmRNKGnWnTpumWW27RsWPH1K9fP+3YsaPImNzcXK1atUo9e/a0S4jDhg2TJL300kv69ttvbdsNw9BLL72kgwcP6oYbblDfvn2v/QeR1KZNG0nSokWL7M4BHzt2TLGxsTIMo8icTz75RNu3by/SOs/Ly9OWLVskOXbOtWXLlmratKnOnz+v6dOnKycnx/ZeRkaGpk+fLknq0qXLZc9fl4RFixYpMTFR7733nkPjCxfCbdy4Ub/88otte35+vubPn6+kpKRi51WtWlVly5bVqVOnXF7cdzWLFy/Wli1bVL9+fT311FOSpAkTJigqKkp79uyxPQQFMDMWosFO5cqV9e677+rxxx/X119/rf79+6tWrVoKDw9X+fLlderUKe3du1fZ2dkKDAy0VbOS9OCDDyopKUkffvihevfurdtuu812c5WjR48qICBAs2fPLrEng40aNUobN27Ul19+qbvvvluRkZHKyMjQN998o+bNmysqKqpIkvn666+1fPlyValSRY0aNVLVqlWVlZWlPXv2KD09XdWqVdOIESMcOv6cOXM0ePBgffbZZ+rUqZNatmypixcvKjExUZmZmWrcuLEteZtFx44d1bhxY+3fv1933323WrVqpfLly2vv3r365ZdfNHLkSL322mtF5pUtW1bR0dHauHGjevbsqRYtWtjOXc+aNcvtuLZv364FCxaofPnymj9/vu0SuzJlyuiFF15QTEyM3nzzTbVq1Up33XWX28cDvIWkjSKCg4P11ltvafPmzfr444+VlJSkhIQE5eXlKSgoSFFRUerQoYPuu+8+u1udWiwW/eMf/1D79u313nvvaf/+/crJyVFISIh69eqlkSNHlui9ymvXrq2VK1dq3rx5SkxM1Oeff67Q0FA9/PDDGjFihK0z8Hu9evVSQECAdu7cqcOHDysjI0OVKlVSjRo1NHjwYPXt2/eqd+f6/fHXrFmj119/XZ9++qm++OILWa1W3Xrrrbr33ns1aNAgtxddlbQyZcrorbfe0quvvqqNGzcqISFBgYGBioqK0oIFC5SVlVVs0pakZ555RkFBQdqyZYs2btxoa1e7m7QLz2Pn5+dr+vTpql+/vt37NWvWVFxcnB555BE98cQTatCggct3kwO8zWIU1yMEAAClDue0AQAwCZI2AAAmQdIGAMAkSNoAAJgESRsAAJMgaQMAYBIkbQAATIKkDZRSx44dU3h4uEP3OgfgG0jaMJ3Y2FiFh4crPDxcERER6ty5sxYtWnRNH0ZRWqWkpGjChAlq27atIiMj1b59e40ePVpHjhyR5F7iDw8P16effurpkAG4gduYwpTatWunuLg45ebm6ssvv9QzzzyjsmXLatSoUUXG5ubmyt/f3wtRXpKXl2d7ypWn9zts2DDdeuutWrRokW688UadOHFCmzdv1q+//urx4wHwPiptmJK/v79uvPFGhYaGql+/fmrTpo3tGeCxsbF65JFH9PLLL6tt27a65557JEmpqal67LHH1LJlS7Vq1UqjR4/WsWPHbPssnLdo0SLdfvvtat68uaZPn273hLDNmzfrr3/9q1q2bKnWrVtr1KhRSk5Otr1fWNmuW7dOAwYMUGRkpO1xlR988IHuvfdeRUZG6p577tGKFSvsPtPevXvVs2dPRUZGqlevXletjg8fPqzk5GQ99dRTatasmUJDQ9WiRQuNHz9ezZo1kyR16tRJktSzZ0+Fh4dr4MCBtmMNHTpUrVu3VosWLTRgwADt37/ftu/o6GhJ0pgxYxQeHm77WZI+/fRTxcTEKDIyUp06dfLZLgfgDVTauC6UK1fO7pGPhQ+yWLZsmaRLVenw4cPVrFkzrVixQmXKlNFLL72kESNG6F//+petEk9ISFC5cuX01ltv6fjx45oyZYqqVKmi8ePHS5JycnI0dOhQhYeHKzs7W/Pnz9eYMWP04Ycfymr97Tvw7NmzFRsbq4YNG6pcuXL617/+pfnz52v69Olq2LChDh48qGnTpqlChQqKiYlRVlaWRo0apTZt2uif//ynjh07dtUHaVStWlVWq1UbN27U4MGD5efnV2TMBx98oD59+uiNN95Q/fr1bRV/VlaWevbsqalTp0qSXn/9dT300EPauHGjAgMDtWrVKt1xxx2Ki4tTu3btbPvesWOHJk+erKlTp6ply5ZKTk7WtGnTJEljx4515V8dAGcYgMlMnjzZGD16tGEYhlFQUGB89dVXRkREhPHcc8/Z3m/Tpo1x4cIF25y1a9cad999t1FQUGDbduHCBaNJkybGli1bbPNatWplZGdn28a88847RrNmzYz8/PxiY0lPTzfCwsKMQ4cOGYZhGCkpKUZYWJjxxhtv2I276667jI8++shu24svvmg88MADhmEYxsqVK41WrVoZ58+ftzt2WFiYceDAgcv+Lt5++22jadOmRlRUlDFw4EBj0aJFRnJysu39wniutA/DMIz8/HwjKirK2LRpk21bWFiY8cknn9iNGzx4sPHKK6/YbVu7dq1x5513XnH/ADyDShum9MUXXygqKkp5eXkyDEPdunXTuHHjbO+HhYXZncf+9ttvlZycrObNm9vt58KFC3bt7cLnhheKiopSdna2UlNTFRoaqh9//FELFizQnj17dPr0aRn/e0heamqqwsLCbPMiIiJs/zs7O1vJycl68sknbVWpJF28eFGVKlWSJB05ckTh4eEqV66c3bGvpn///rrvvvv09ddfa8+ePdqwYYMWL16sl19+WXfeeedl5506dUrz5s3T119/rfT0dBUUFCgnJ0c///zzFY/37bffateuXXrllVds2/Lz83XhwgXl5OTY/e4AeB5JG6bUunVrPf300ypbtqxuuukmlSlj/0f5j8kjOztbjRs31uzZs4vsq2rVqg4f9+GHH1ZoaKieffZZ3XTTTSooKFC3bt1sz4YuVKFCBbtjS9LMmTPVtGlTu3G/b6m7KjAwUNHR0YqOjtbjjz+u4cOHXzVpT548WWfOnNGTTz6pmjVryt/fXw888ECRz/FH2dnZGjdunP7yl78Uee/3XzgAXBskbZhS+fLldcsttzg8vnHjxlq/fr2Cg4MVGBh42XGHDh3S+fPnFRAQIEnavXu3KlSooBo1auj06dM6evSonn32WbVs2VLS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",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plot_cmat(A_full)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "id": "507852a8-6715-4802-b6a0-10967d09ed94",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "0.09734490298929"
+      ]
+     },
+     "execution_count": 24,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Distance between full confusion matrix and tensored confusion matrix\n",
+    "np.linalg.norm(A_joint - A_full)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "id": "9e6c3874-2905-4c25-9bf0-22ab27756fed",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[ 714 -100 -211  152  -49   63   32  422]\n",
+      "\n",
+      "Corrected for negative counts:\n",
+      "[683   0   0  39   0   0   0 302]\n"
+     ]
+    }
+   ],
+   "source": [
+    "A_pinv = np.linalg.pinv(A_full)\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_2), dtype=int)\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "id": "cb109820-5478-4179-84b8-66e6af1008fc",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 1200x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df[\"mitigated_full\"] = np.around(mitigated / sum(mitigated), 3)\n",
+    "\n",
+    "ax = df.plot(\n",
+    "    x=\"states\",\n",
+    "    y=[\"noisy\", \"mitigated_k_local\", \"mitigated_full\"],\n",
+    "    kind=\"bar\",\n",
+    "    figsize=(12, 5),\n",
+    ")\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_k_local\"])\n",
+    "ax.bar_label(ax.containers[2], labels=df[\"mitigated_full\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/unitary_compilation.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/unitary_compilation.ipynb.txt
new file mode 100644
index 0000000000..f0b3b1268b
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/unitary_compilation.ipynb.txt
@@ -0,0 +1,1084 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d60f1e23-2541-4b01-84c8-0aff758061b4",
+   "metadata": {},
+   "source": [
+    "# Compiling Unitaries Using Diffusion Models\n",
+    "\n",
+    "This notebook is based on the work presented in [Quantum circuit synthesis with diffusion models, Florian Fürrutter, Gorka Muñoz-Gil & Hans J. Briegel , Nat. Mach. Intell. **6**, 515–524 (2024)](https://doi.org/10.1038/s42256-024-00831-9)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4b6a7722-f302-458b-9f90-8493e46d786d",
+   "metadata": {},
+   "source": [
+    "Quantum computing relies on efficiently translating quantum operations into viable physical realizations on existing quantum hardware. Recently, diffusion models — a powerful class of generative models in machine learning — have demonstrated exceptional performance on this task. \n",
+    "\n",
+    "In this tutorial notebook, we will demonstrate how to use this method to synthesize arbitrary unitaries into a `cudaq.kernel`, effectively decomposing them into sequences of quantum gates, a process commonly known as unitary compilation.\n",
+    "\n",
+    "Our focus will be on generating circuits using a pre-trained model. Specifically, we will illustrate how to compile 3-qubit unitaries."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "fef3bf4a-1008-4df8-b6e8-d5357db1f6d5",
+   "metadata": {},
+   "source": [
+    "### Diffusion model pipeline\n",
+    "\n",
+    "Generative diffusion models (DMs) have recently delivered remarkable results across a wide range of applications, from image generation to protein folding. In this work, we leverage DMs to generate quantum circuits based on a user specified unitary matrix and a text prompt that defines the allowed gate set, effectively using DMs as unitary compilers. The method is thoroughly explained in Ref. [(Fürrutter et al., 2024)](https://doi.org/10.1038/s42256-024-00831-9). The following figure  provides an overview of the proposed circuit generation pipeline:\n",
+    "\n",
+    "<figure>\n",
+    "  <img src=\"images/pipeline_simplified.png\" alt=\"Quantum circuit generation pipeline overview\" width=\"70%\"/>\n",
+    "  <figcaption><b>Quantum circuit generation pipeline</b>. Figure adapted from <a href=\"https://doi.org/10.1038/s42256-024-00831-9\">(Fürrutter et al., 2024)</a></figcaption>\n",
+    "</figure>\n",
+    "\n",
+    "The pipeline consists on 3 main components:\n",
+    "\n",
+    "**1) Circuit encoding:** Like any neural network, diffusion models operate with continuous inputs and outputs. However, since the circuits we consider are composed of discrete gates (i.e., with no continuous parameters), we develop a mapping that transforms each gate into a continuous vector. This allows us to represent a given circuit as a three-dimensional tensor, as illustrated. Crucially, this mapping is invertible: when the DM generates continuous tensors, we can apply the inverse map to convert them back into the circuit form. An overview of these steps is provided in the figure below:\n",
+    "\n",
+    "<figure>\n",
+    "  <img src=\"images/circuit_encoding.png\" alt=\"Quantum circuit encoding\" width=\"60%\"/>\n",
+    "  <figcaption><b>Quantum circuit encoding</b>. Figure adapted from <a href=\"https://doi.org/10.1038/s42256-024-00831-9\">(Fürrutter et al., 2024)</a></figcaption>\n",
+    "</figure>\n",
+    "\n",
+    "**2) Conditioning:** The user's input (the set of available gates and the unitary to compile) is also transformed into a continuous tensor by two neural networks. For the gate set description, where the input is a text prompt (e.g., \"Compile using ['x', 'h']\"), we utilize a pre-trained language model. For the unitary, we employ a neural network that is training jointly with the diffusion model.\n",
+    "\n",
+    "**3) Unitary compilation:** The generation procedure follows the typical DM process: the model is given a fully noisy tensor which is iteratively de-noised until reaching a clean sample based on the given conditioning (the desired unitary and gate set). The tensors generated by the DM are then mapped to circuits via the inverse encoding procedure. To learn more about the practical implementation of diffusion models we recommend [this tutorial](https://course.fast.ai/Lessons/lesson9.html). \n",
+    "\n",
+    "In the following we will use `CUDA-Q` and `genQC` to perform all these steps and go from a desired unitary matrix, $U$, to a quantum circuit that we can execute using CUDA-Q. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e1453ad1-e4d4-4e38-9684-fd967bc1a8de",
+   "metadata": {},
+   "source": [
+    "### Setup and compilation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "id": "f1b7d96a-92d4-46f3-95a6-1d1e46d63240",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.037362Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.036980Z",
+     "iopub.status.idle": "2024-08-27T18:11:38.867336Z",
+     "shell.execute_reply": "2024-08-27T18:11:38.866445Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.037346Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n",
+      "\u001b[0m"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install genQC==0.1.0 -q"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "id": "07d177c6-60fd-497d-ae2b-41e225b56a2d",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.868456Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.868206Z",
+     "iopub.status.idle": "2024-08-27T18:11:38.872654Z",
+     "shell.execute_reply": "2024-08-27T18:11:38.871931Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.868440Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import genQC\n",
+    "from genQC.imports import *\n",
+    "from genQC.pipeline.diffusion_pipeline import DiffusionPipeline\n",
+    "from genQC.inference.export_cudaq import genqc_to_cudaq\n",
+    "import genQC.inference.infer_compilation as infer_comp\n",
+    "import genQC.util as util\n",
+    "\n",
+    "import numpy as np\n",
+    "import torch\n",
+    "\n",
+    "# Fixed seed for reproducibility\n",
+    "torch.manual_seed(0)\n",
+    "np.random.seed(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "id": "ccb97524-0f13-49ff-893d-983c572e66c6",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.873619Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.873403Z",
+     "iopub.status.idle": "2024-08-27T18:11:39.025224Z",
+     "shell.execute_reply": "2024-08-27T18:11:39.024476Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.873603Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[INFO]: Cuda device has a capability of 8.0 (>= 8), allowing tf32 matmul.\n",
+      "cuda\n"
+     ]
+    }
+   ],
+   "source": [
+    "device = util.infer_torch_device()  # Use CUDA if we can\n",
+    "util.MemoryCleaner.purge_mem()  # Clean existing memory allocation\n",
+    "print(device)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "acf7656c-be92-4b36-8c38-d3ff6c1912e3",
+   "metadata": {},
+   "source": [
+    "### Load model"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "0047cbe9-a21c-4c72-a144-7a2929752329",
+   "metadata": {},
+   "source": [
+    "First, we load the pre-trained model weights and setup the DM pipeline.\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "id": "a6b18d03-6976-4eec-9ab0-7b763d73ad17",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:39.026541Z",
+     "iopub.status.busy": "2024-08-27T18:11:39.025956Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.879166Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.878426Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:39.026521Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "543d6667d288478d8d64b8e32c6675f3",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Fetching 2 files:   0%|          | 0/2 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[INFO]: `genQC.models.unet_qc.QC_Compilation_UNet` instantiated from given config on cuda.\n",
+      "[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder` instantiated from given config on cuda.\n",
+      "[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder`. No save_path` provided. No state dict loaded.\n"
+     ]
+    }
+   ],
+   "source": [
+    "pipeline = DiffusionPipeline.from_pretrained(\n",
+    "    \"Floki00/qc_unitary_3qubit\", device)  # Download from Hugging Face\n",
+    "pipeline.scheduler.set_timesteps(40)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bc112d57-71a8-403c-a0a9-d2f7d0eb7492",
+   "metadata": {},
+   "source": [
+    "Set parameters the model was trained on. Note that these are fixed and depend on the pre-trained model."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "id": "3037d98c-16fb-4a7f-bf37-7e9991b6603e",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.880376Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.879966Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.883994Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.883336Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.880352Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "vocab         = {i+1:gate for i, gate in enumerate(pipeline.gate_pool)}  # Gateset used during training, used for decoding\n",
+    "num_of_qubits = 3                                                        # Number of qubits\n",
+    "max_gates     = 12                                                       # Maximum number of gates"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9d7cc1c9-7ddd-4464-98b8-8dbcaa02a53e",
+   "metadata": {},
+   "source": [
+    "### Unitary compilation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b962aea8-9c46-4795-8b74-bca35900f1ed",
+   "metadata": {},
+   "source": [
+    "Let's start by defining the unitary we want to compile. Note that this model has been trained to compile unitaries that arise from circuits composed of the gates contain in `vocab`. While this is a universal gate set (i.e. can perform universal computation), it can only do so with an infinite number of gates. Because the number of gates in the model is restricted to 12, we can only expect the model to generate unitaries under this constraints. We will consider here the compilation of one of such unitary. Nonetheless, stay tuned for bigger and better models!\n",
+    "\n",
+    "We start by defining our unitary as a `numpy.matrix`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "id": "5107c719-4220-4209-a657-4a9c0766b80a",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.884880Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.884694Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.896385Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.895667Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.884863Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "U = np.matrix([[ 0.70710678,  0.        ,  0.        , 0.        ,  0.70710678,  0.        , 0.        ,  0.        ],\n",
+    "               [ 0.        , -0.70710678,  0.        , 0.        ,  0.        , -0.70710678, 0.        ,  0.        ],\n",
+    "               [-0.70710678,  0.        ,  0.        , 0.        ,  0.70710678,  0.        , 0.        ,  0.        ],\n",
+    "               [ 0.        ,  0.70710678,  0.        , 0.        ,  0.        , -0.70710678, 0.        ,  0.        ],\n",
+    "               [ 0.        ,  0.        ,  0.70710678, 0.        ,  0.        ,  0.        , 0.        ,  0.70710678],\n",
+    "               [ 0.        ,  0.        ,  0.        , 0.70710678,  0.        ,  0.        , 0.70710678,  0.        ],\n",
+    "               [ 0.        ,  0.        , -0.70710678, 0.        ,  0.        ,  0.        , 0.        ,  0.70710678],\n",
+    "               [ 0.        ,  0.        ,  0.        ,-0.70710678,  0.        ,  0.        , 0.70710678,  0.        ]], dtype=np.complex128)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "14954138-f16b-48f6-b35d-5b1ac00cff1e",
+   "metadata": {},
+   "source": [
+    "and check that the matrix is indeed unitary, i.e. $U^{\\dagger} U = U U^{\\dagger} = I$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "57164622-8359-4c58-b4d9-1b64ae603b43",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.897692Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.897368Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.904008Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.903243Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.897677Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "assert np.allclose(U.H @ U, np.identity(2**num_of_qubits)) and np.allclose(\n",
+    "    U @ U.H, np.identity(2**num_of_qubits))  #check if unitary"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c0ba07c5-075a-46ca-9a22-cc758ce33cb9",
+   "metadata": {},
+   "source": [
+    "The loaded model was trained on the gate set `['h', 'cx', 'z', 'x', 'ccx', 'swap']`. Specifically, it was trained to generate circuits using any arbitrary subset of this gate set. Therefore, during inference, we can instruct the model to compile the unitary using any of these subsets. However, it is crucial to follow the prompt structure `Compile using [...]`, as the model was trained with this specific format. For example, let's consider a scenario where we compile the unitary without using the `x` gate:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "0f0d3e85-a22e-4a1b-ad17-b02417e56734",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.905214Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.904884Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.912812Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.911995Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.905195Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "# Notice how the x gate missing from the prompt since this is a restriction we set\n",
+    "prompt = \"Compile using: ['h', 'cx', 'z', 'ccx', 'swap']\""
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "cab3a1e8-a404-4ebb-9a58-251d47eebb4a",
+   "metadata": {},
+   "source": [
+    "Now, we call the diffusion model pipeline to generate encoded circuits based on the specified conditions: `prompt` and `U`. One of the key advantages of this method is that, once the model is trained, sampling new circuits is very fast. Therefore, under the same conditions defined above, we will generate 128 circuits and analyze them in the following sections."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "56edb114-3ef7-455b-b4b8-0e262e7b6316",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.913747Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.913584Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.824624Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.823799Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.913732Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "# Number of circuits to sample from the trained DM.\n",
+    "samples = 128\n",
+    "\n",
+    "# As the neural network works only with real numbers, we first separate\n",
+    "# the two components and create a 2 dimensional tensor for the magnitude\n",
+    "# of each component:\n",
+    "U_r, U_i = torch.Tensor(np.real(U)), torch.Tensor(np.imag(U))\n",
+    "U_tensor = torch.stack([U_r, U_i], dim=0)\n",
+    "\n",
+    "# Now we generate a tensor representation of the desired quantum circuit using the DM based on the prompt and U. This is also known as inference.\n",
+    "out_tensors = infer_comp.generate_comp_tensors(\n",
+    "    pipeline=pipeline,\n",
+    "    prompt=prompt,\n",
+    "    U=U_tensor,\n",
+    "    samples=samples,\n",
+    "    system_size=\n",
+    "    num_of_qubits,  # Max qubit number allowed by the model (this model is only trained with 3 qubits)\n",
+    "    num_of_qubits=num_of_qubits,\n",
+    "    max_gates=max_gates,\n",
+    "    g=10  # classifier-free-guidance (CFG) scale\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "81f09d75-a960-4456-bdb9-57ef7668864e",
+   "metadata": {},
+   "source": [
+    "Below is an example of a generated tensor which represents a quantum circuit: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "13c1af73-11bc-46ca-99dd-bccea29f95c1",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.825914Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.825524Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.831202Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.830421Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.825898Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],\n",
+       "        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],\n",
+       "        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])"
+      ]
+     },
+     "execution_count": 33,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "out_tensors[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5605d0a1-626d-4aa5-8721-0416470215dc",
+   "metadata": {},
+   "source": [
+    "### Convert tensors to CUDA-Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b43d006-1e6a-4911-9283-b5a96eb5cf06",
+   "metadata": {},
+   "source": [
+    "Next, we convert the generated tensors into `cudaq.kernels`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "id": "01efc6f7-8f0f-425f-be58-7fcaf880d0fd",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.832305Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.831956Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.840723Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.839940Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.832289Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "cudaq.set_target('qpp-cpu') # Note that cpu is faster for 3 qubit kernels\n",
+    "\n",
+    "# cudaq.set_target('nvidia') # Set to GPU for larger circuits"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "id": "9d5b9ae5-c11e-413b-af00-4412dc86b48d",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.841741Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.841583Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.438113Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.437219Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.841726Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "1948691023bb4f03b79174564c1b8223",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/128 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The model generated 1 invalid tensors that does not correspond to circuits.\n"
+     ]
+    }
+   ],
+   "source": [
+    "kernel_list   = []\n",
+    "valid_tensors = []\n",
+    "\n",
+    "invalid_tensors = 0\n",
+    "for out_tensors_i in tqdm(out_tensors):\n",
+    "\n",
+    "    # Use a try-except to catch invalid tensors (if any)\n",
+    "    try:    kernel = genqc_to_cudaq(out_tensors_i, vocab)  # Convert out_tensors to CUDA-Q kernels\n",
+    "    except: kernel = None\n",
+    "        \n",
+    "    if kernel:\n",
+    "        kernel_list.append(kernel)\n",
+    "        valid_tensors.append(out_tensors_i)\n",
+    "    else:\n",
+    "        invalid_tensors += 1 \n",
+    "\n",
+    "print(f\"The model generated {invalid_tensors} invalid tensors that does not correspond to circuits.\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0a5823e6-9189-46b7-974d-43a2a0cad531",
+   "metadata": {},
+   "source": [
+    "For example, the following tensor encoding"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "id": "dc7d35c7-a7cb-4663-8220-b1030e534deb",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.439383Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.438787Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.443973Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.443101Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.439367Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],\n",
+       "        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],\n",
+       "        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])"
+      ]
+     },
+     "execution_count": 36,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "valid_tensors[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "47116105-b1e1-454e-80fc-6a03061045f5",
+   "metadata": {},
+   "source": [
+    "corresponds to the following `cudaq.kernel`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "4835c288-b018-49d7-b307-3ff05c2c8c56",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.444990Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.444651Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.569067Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.568320Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.444975Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮        ╭───╮╭───╮     \n",
+      "q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──\n",
+      "     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮\n",
+      "q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├\n",
+      "       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯\n",
+      "q2 : ──●──┤ h ├─╳───●──────────────●──\n",
+      "          ╰───╯                       \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Arbitrary input state to the circuit for plotting\n",
+    "\n",
+    "input_state = [0] * (2**num_of_qubits)\n",
+    "\n",
+    "print(cudaq.draw(kernel_list[0], input_state))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "59809685-5d70-4612-8642-c4e924a1ab6c",
+   "metadata": {},
+   "source": [
+    "### Evaluate generated circuits\n",
+    "\n",
+    "As mentioned earlier, one of the key advantages of using diffusion models (DMs) as a unitary compiler is the ability to rapidly sample many circuits. However, as is common in machine learning, the model has a certain accuracy, meaning not all generated circuits are expected to exactly compile the specified unitary. In this section, we will evaluate how many of the generated circuits are indeed correct and then perform post-selection to identify (at least) one circuit that successfully performs the desired unitary operation."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2685d88b-aceb-4a8c-8404-f744196d34c5",
+   "metadata": {},
+   "source": [
+    "### Simulate kernels"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "f5d1e8ca-3abf-47b4-bbca-932bdff86f94",
+   "metadata": {},
+   "source": [
+    "First, we calculate the unitary matrix $U$ implemented by each of the kernels. The elements of this matrix are defined by the transition amplitudes between the basis states, which can be expressed as:\n",
+    "$$\n",
+    "\\begin{equation}\n",
+    "   \\langle i|kernel|j\\rangle = U_{ij},\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "where $|i\\rangle$ and $|j\\rangle$ are computational basis states (typically in the $z$-basis), with $|n\\rangle$ representing the standard basis vector that has a 1 in the $n$-th position and 0 elsewhere."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "id": "11143924-c33f-4fd5-8f04-422eba9ed5a0",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.570028Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.569786Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.873950Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.873023Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.570011Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "fdba942957904d7ea41ce9edeb6b9f48",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/127 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "N = 2**num_of_qubits\n",
+    "\n",
+    "got_unitaries = np.zeros((len(kernel_list), N, N), dtype=np.complex128)\n",
+    "\n",
+    "for i, kernel in tqdm(enumerate(kernel_list), total=got_unitaries.shape[0]):\n",
+    "    for j in range(N):\n",
+    "        basis_state_j = np.zeros((N), dtype=np.complex128)\n",
+    "        basis_state_j[j] = 1\n",
+    "\n",
+    "        got_unitaries[i, :,\n",
+    "                      j] = np.array(cudaq.get_state(kernel, basis_state_j),\n",
+    "                                    copy=False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5eb62ba-40a6-486c-b307-47b11b9b3226",
+   "metadata": {},
+   "source": [
+    "For example, the circuit printed above corresponds to the following unitary:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4a471612-a3e4-4bea-9f61-dc823283af95",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.875219Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.874792Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.879735Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.878882Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.875200Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "np.set_printoptions(linewidth=1000)\n",
+    "print(np.round(got_unitaries[0], 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "203def54-bb97-4344-8544-6b1374b3f9a3",
+   "metadata": {},
+   "source": [
+    "### Compare unitaries"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e5241775-2692-4b10-b9ef-a75a3ddb0eb8",
+   "metadata": {},
+   "source": [
+    "Now that we have the unitaries for each of the kernels, we compare them to the user provided unitary matrix, `U`. To do so, we compute the infidelity between the exact unitary and the generated ones. The infidelity is a value between 0 and 1, where 0 indicates that the unitaries are identical (up to a global phase)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bb4915e8-5a92-4038-ab49-fa67a0a5b668",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.880925Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.880574Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.891293Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.890501Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.880909Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "def infidelity(want_unitary, got_unitary):\n",
+    "    return 1 - np.abs(\n",
+    "        np.trace(np.conj(want_unitary).T @ got_unitary) / 2**num_of_qubits)**2\n",
+    "\n",
+    "\n",
+    "infidelities = np.array(\n",
+    "    [infidelity(U, got_unitary) for got_unitary in got_unitaries])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2ae9d89-3aab-43db-85cb-2aa6fc494d87",
+   "metadata": {},
+   "source": [
+    "Let's now plot an histogram of the infidelities for our generated circuits:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c8313728-3a69-475b-bf3c-f0a8b8e8324a",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.892419Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.892234Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.982604Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.981724Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.892404Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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iEgimJgRERERSQQTMyIiIiKJYGJGREREJBFMzIiIiIgkgokZERERkUQwMSMiIiKSCCZmRERERBLBxIyIiIhIIpiYEREREUkEEzMiIiIiiWBiRkRERCQRTMyIiIiIJIKJGREREZFEMDEjIiIikggmZkREREQSwcSMiIiISCKYmBERERFJhCQTs1u3buGjjz5CxYoVYWNjg9dffx1Hjx5VrxdCYMKECXB1dYWNjQ2CgoJw5cqVUoyYiIiIyHCSS8wePXoEPz8/WFpaYvv27Th//jxmz54Ne3t7dZ1Zs2bhhx9+wKJFi3D48GGUL18ewcHBePbsWSlGTkRERGQYi9IO4GUzZ86Eh4cHIiMj1WVVq1ZV/78QAnPnzsXXX3+Nzp07AwCWLVsGZ2dnbNy4ET179izxmImIiIiMQXIjZps3b0ajRo3QrVs3VKpUCW+++SYWL16sXn/jxg0kJSUhKChIXaZUKtG0aVPExcXl22ZGRgZSU1M1FiIiIiKpkVxidv36dSxcuBDVq1fHjh078Pnnn+OLL77A0qVLAQBJSUkAAGdnZ43tnJ2d1eteFhERAaVSqV48PDyK900QERER6UFyiVlOTg4aNGiA6dOn480338TAgQMxYMAALFq0SO82w8LCoFKp1EtiYqIRIyYiIiIyDsklZq6urqhTp45GWe3atZGQkAAAcHFxAQAkJydr1ElOTlave5lcLodCodBYiIiIiKRGcomZn58fLl26pFF2+fJleHp6AvjvQgAXFxfs3r1bvT41NRWHDx+Gr69vicZKREREZEySuypzxIgRaN68OaZPn47u3bvjn3/+wc8//4yff/4ZACCTyTB8+HBMnToV1atXR9WqVTF+/Hi4ubmhS5cupRs8ERERkQEkl5g1btwYGzZsQFhYGCZPnoyqVati7ty5+PDDD9V1Ro0ahSdPnmDgwIFISUmBv78/YmJiYG1tXYqRExERERlGJoQQum505swZHDlyBO+//756vtbTp08RGhqKzZs3w8bGBl999RU+++wzowdsDKmpqVAqlVCpVJxvRvQK8RqzzeA24md0NEIkRETa0yXv0GuO2dSpUzF+/HjY2tqqy8aOHYuffvoJaWlpSExMxODBg7Fr1y59miciIiIySXolZv/88w9atWoFmUwGAMjKykJkZCSaNGmCu3fv4saNG3BycsL3339v1GCJiIiI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P/OUNW3aFACM9rPyiwrru1yv6rEmkgomZkQmxtraGt27d8e9e/cwderUPOvPnDmDX375Bba2tnj33XeNvn97e3vIZDIkJibmWVepUiXY2Njg+PHjSE9PV5c/evQIQ4cONWi/n376KbKystCtWzcIIV6Ziei9e/dGZmYmJkyYoFG+c+fOfJ8U0LdvX9ja2mLcuHE4d+5cnvXp6enqeWi6KqzvXvSqHmsiKeAcMyITNHv2bBw+fBiTJk3C1q1bERAQAGtra1y+fBmbN2+GEAK///57offX0leFChXQuHFjHDhwAL1790b16tVhZmaG3r17w9PTE4MGDcLs2bPxxhtvoFOnTkhNTcX27dvh6emZ793ytfXWW2/B09MTN2/ehIuLCzp16mTEd1V8Ro0ahfXr12Px4sU4d+4cWrZsicTERKxZswYdO3bEtm3bNOo7OTlh5cqV6NatG9544w289dZbqFWrFjIyMhAfH4/9+/ejefPmiImJ0TmWovou16t6rImkgIkZkQmqVKkSjhw5gjlz5mDjxo346aefkJmZCRcXF7z//vv46quv8Oabbxbb/pcvX44RI0Zg69atUKlUEELA398fnp6eiIiIgIODA6KiorBgwQI4OzujV69emDhxIl577TW995mbQEydOhV9+vRRT86XuvLly2P//v0ICwvDhg0bcPz4cdStWxerV6+GSqXKk5gB/10deeLECXzzzTeIjY3Frl27UL58ebi7u6Nv37746KOP9I6nsL7L9aoeayIpkAkhRGkHQURUEt5++21ER0fj8uXLqFatWmmHU6bxWBPph3PMiMgknD9/HtHR0Wjbti0ThWLGY02kP44vE1GZtmLFCly6dAnLli0DAISHh5dyRGUXjzWR4ZiYEVGZ9vPPP+PPP/+Ep6cnlixZgubNm5d2SGUWjzWR4TjHjIiIiEgiOMeMiIiISCKYmBERERFJBBMzIiIiIolgYkZEREQkEUzMiIiIiCSCiRkRERGRRDAxIyIiIpIIJmZEREREEvF/hgK9PnrrOcMAAAAASUVORK5CYII=",
+      "text/plain": [
+       "<Figure size 700x400 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.figure(figsize=(7, 4))\n",
+    "plt.title(\n",
+    "    f\"Distribution of infidelities for {len(got_unitaries)} generated circuits\",\n",
+    "    fontsize=12)\n",
+    "plt.ylabel(\"Number of circuits\", fontsize=14)\n",
+    "plt.xlabel(\"Unitary infidelity\", fontsize=14)\n",
+    "plt.hist(infidelities, bins=30)\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f1912f6c-e685-4994-bf3a-fe9530dbd513",
+   "metadata": {},
+   "source": [
+    "As we can see, the model generated almost 30 circuits that compile the unitary with an infidelity close or equal to zero! The kernel with the lowest infidelity is:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "656baf92-5a1e-4227-ac1f-67b5f9394310",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.983493Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.983309Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.988444Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.987556Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.983478Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The best kernel has an infidelity of 3.4e-09,\n",
+      "     ╭───╮╭───╮        ╭───╮╭───╮     \n",
+      "q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──\n",
+      "     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮\n",
+      "q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├\n",
+      "       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯\n",
+      "q2 : ──●──┤ h ├─╳───●──────────────●──\n",
+      "          ╰───╯                       \n",
+      "\n",
+      "with the unitary:\n",
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "min_index = np.argmin(infidelities)\n",
+    "\n",
+    "print(f\"The best kernel has an infidelity of {infidelities[min_index]:0.2},\")\n",
+    "\n",
+    "input_state = [0] * (2**num_of_qubits)\n",
+    "input_state[0] = 1\n",
+    "print(cudaq.draw(kernel_list[min_index], input_state))\n",
+    "\n",
+    "print(f\"with the unitary:\")\n",
+    "print(np.round(got_unitaries[min_index], 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e724b39-cc63-40c8-8ad0-9d90d94e23bd",
+   "metadata": {},
+   "source": [
+    "which, as we can see, exactly compiled our wanted unitary:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "46d190d6-7bed-4490-a343-bf856190a101",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.989293Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.989114Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.996387Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.995546Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.989278Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(np.round(U, 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f8bf2fe6-07ca-4bfa-a46b-96a91daeb185",
+   "metadata": {},
+   "source": [
+    "### Choosing the circuit you need"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "983dc8c1-f3ae-4d06-ad7a-e57addfc6e74",
+   "metadata": {},
+   "source": [
+    "As we have seen above, we now have almost 30 kernels that compile the desired unitary! This is particularly valuable when dealing with hardware constraints, where, for instance, we might want to avoid using certain qubits or specific gates. One practical example is finding the circuit with the fewest Toffoli gates (also known as `ccx`). In our `vocab` definition above, we identified that `ccx` corresponds to the label 5 in our tokenized tensors. Let's use this information to search for the circuit that minimizes the number of `ccx` gates:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "acb0f4d8-2e8a-4b32-9e37-006571ca2aa5",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.997443Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.997033Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.005395Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.004630Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.997427Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The model generated 17 distinct correct circuits.\n",
+      "These circuits have this number of ccx gates: tensor([1, 3, 3, 3, 3, 3, 3, 1, 1, 3, 3, 3, 1, 1, 1, 1, 1])\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First, we remove possible duplicates and only pick distinct circuits\n",
+    "_, idx_unique       = np.unique(np.array(valid_tensors), axis=0, return_index=True)\n",
+    "unique_tensors      = torch.stack(valid_tensors)[idx_unique]\n",
+    "unique_infidelities = infidelities[idx_unique]\n",
+    "unique_kernels      = [kernel_list[idx] for idx in idx_unique]\n",
+    "\n",
+    "# Then, find the correct circuits\n",
+    "idx_correct     = torch.argwhere(torch.tensor(unique_infidelities) < 0.01).flatten()\n",
+    "correct_tensors = unique_tensors[idx_correct]\n",
+    "print(f\"The model generated {correct_tensors.shape[0]} distinct correct circuits.\")\n",
+    "\n",
+    "# Now let's flatten the last two dimensions (related to the actual circuit) and find out how many 5's (i.e. ccx) gates each circuit has:\n",
+    "num_ccx = (correct_tensors.flatten(1,2) == 5).sum(1)\n",
+    "print(\"These circuits have this number of ccx gates:\", num_ccx)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7625aac1-78d8-4ce3-9765-88ae48c92dd3",
+   "metadata": {},
+   "source": [
+    "As we can see, it appears that the diffusion model (DM) requires at least one Toffoli gate to compile the unitary. We can now print a few of these circuits to select the one that best suits our needs, or to study whether there are any interesting patterns the model employs for this specific unitary."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "535501a6-cafb-48e6-b53c-636d7ac5a815",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:56.006584Z",
+     "iopub.status.busy": "2024-08-27T18:11:56.006136Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.013882Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.013117Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:56.006569Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "        ╭───╮╭───╮               \n",
+      "q0 : ───┤ x ├┤ z ├───────●───────\n",
+      "        ╰─┬─╯├───┤╭───╮  │       \n",
+      "q1 : ─╳───●──┤ h ├┤ z ├──┼───────\n",
+      "      │   │  ├───┤╰───╯╭─┴─╮╭───╮\n",
+      "q2 : ─╳───●──┤ h ├─────┤ x ├┤ h ├\n",
+      "             ╰───╯     ╰───╯╰───╯\n",
+      "\n",
+      "     ╭───╮╭───╮             \n",
+      "q0 : ┤ x ├┤ z ├──●──────────\n",
+      "     ╰─┬─╯├───┤╭─┴─╮        \n",
+      "q1 : ──●──┤ h ├┤ x ├─╳──────\n",
+      "       │  ├───┤├───┤ │ ╭───╮\n",
+      "q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├\n",
+      "          ╰───╯╰───╯   ╰───╯\n",
+      "\n",
+      "     ╭───╮╭───╮             \n",
+      "q0 : ┤ x ├┤ z ├──●──────────\n",
+      "     ╰─┬─╯├───┤╭─┴─╮        \n",
+      "q1 : ──●──┤ h ├┤ x ├─╳──────\n",
+      "       │  ├───┤├───┤ │ ╭───╮\n",
+      "q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├\n",
+      "          ╰───╯╰───╯   ╰───╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Get the correct kernels\n",
+    "correct_kernels = [unique_kernels[idx] for idx in idx_correct]\n",
+    "\n",
+    "# Get the ones with only one ccx\n",
+    "correct_kernels_ccx1 = [\n",
+    "    correct_kernels[idx] for idx in torch.argwhere(num_ccx == 1).flatten()\n",
+    "]\n",
+    "\n",
+    "# Draw a few of this circuits\n",
+    "for kernel in correct_kernels_ccx1[:3]:\n",
+    "    print(cudaq.draw(kernel, input_state))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "dd32819f-8bb6-4af8-bf69-84b600ba7ad5",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:56.020863Z",
+     "iopub.status.busy": "2024-08-27T18:11:56.020639Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.027045Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.026361Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:56.020849Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a1ee37087fbd5c14a31d5de3441f92432d0dca68)\n",
+      "genQC Version 0.1.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)\n",
+    "print(\"genQC Version\", genQC.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "widgets": {
+   "application/vnd.jupyter.widget-state+json": {
+    "state": {},
+    "version_major": 2,
+    "version_minor": 0
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/visualization.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/visualization.ipynb.txt
new file mode 100644
index 0000000000..518595b0c1
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/visualization.ipynb.txt
@@ -0,0 +1,301 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Visualization\n",
+    "\n",
+    "## Qubit Visualization\n",
+    "\n",
+    "What are the possible states a qubit can be in and how can we build up a visual cue to help us make sense of quantum states and their evolution?\n",
+    "\n",
+    "We know our qubit can have two distinct states: $\\ket{0}$ and $\\ket{1}$. If these were the only two states, we could represent them as two vectors on a one-dimensional line (i.e., the z-axis in the image below). We also know that qubits can be in an equal superposition of states: $\\ket{+}$ and $\\ket{-}$. In order to capture all of the states in equal superposition, we will need a 2D plane (i.e., the $xy$-plane in the image below). If you dive deeper you will learn about the existence of other states that will call for a 3D extension. \n",
+    "\n",
+    "In general, a quantum state can be written in the form $\\ket{\\psi} = \\cos(\\frac{\\theta}{2})\\ket{0}+e^{i\\varphi}\\sin(\\frac{\\theta}{2})\\ket{1}$ where $\\theta$ is a real number between $0$ and $\\pi$ and $\\varphi$ is a real value between $0$ and $2\\pi$.  For example, the minus state, $\\ket{-} = \\frac{1}{\\sqrt{2}}\\ket{0}- \\frac{1}{\\sqrt{2}}\\ket{1}$, can be rewritten as\n",
+    "$$\\ket{-}  = \\cos(\\frac{\\theta}{2})\\ket{0}+e^{i\\varphi}\\sin(\\frac{\\theta}{2})\\ket{1}\\text{ with }\\theta = \\frac{\\pi}{2}\\text{ and }\\varphi = \\pi.$$ \n",
+    "This can be visualized in the image below as a unit vector pointing in the direction of the negative $x$-axis.\n",
+    "\n",
+    "Using spherical coordinates, it is possible to depict all the possible states of a single qubit on a sphere. This is called a Bloch sphere. \n",
+    "\n",
+    "<img src=\"images/Bloch_sphere.png\" alt=\"Bloch Sphere\" width=\"300\" height=\"300\">\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let us try to showcase the functionality to render such a 3D representation with CUDA-Q. \n",
+    "First, let us define a single-qubit kernel that returns a different state each time. This kernel uses random rotations.\n",
+    "\n",
+    "Note: CUDA-Q uses the [QuTiP](https://qutip.org) library to render Bloch spheres. The following code will throw an error if QuTiP is not installed. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "scrolled": true
+   },
+   "outputs": [],
+   "source": [
+    "# install `qutip` in the current Python kernel. Skip this if `qutip` is already installed.\n",
+    "# `matplotlib` is required for all visualization tasks.\n",
+    "# Make sure to restart your kernel if you execute this!\n",
+    "# In a Jupyter notebook, go to the menu bar > Kernel > Restart Kernel.\n",
+    "# In VSCode, click on the Restart button in the Jupyter toolbar.\n",
+    "\n",
+    "# The '\\' before the '>' operator is so that the shell does not misunderstand\n",
+    "# the '>' qualifier for the bash pipe operation.\n",
+    "\n",
+    "import sys\n",
+    "\n",
+    "try:\n",
+    "    import matplotlib.pyplot as plt\n",
+    "    import qutip\n",
+    "\n",
+    "except ImportError:\n",
+    "    print(\"Tools not found, installing. Please restart your kernel after this is done.\")\n",
+    "    !{sys.executable} -m pip install qutip\\>=5 matplotlib\\>=3.5\n",
+    "    print(\"\\nNew libraries have been installed. Please restart your kernel!\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "\n",
+    "## Retry the subsequent cells by setting the target to density matrix simulator.\n",
+    "# cudaq.set_target(\"density-matrix-cpu\")\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(angles: np.ndarray):\n",
+    "    qubit = cudaq.qubit()\n",
+    "    rz(angles[0], qubit)\n",
+    "    rx(angles[1], qubit)\n",
+    "    rz(angles[2], qubit)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Next, we instantiate a random number generator, so we can get random outputs. We then create 4 random single-qubit states by using `cudaq.add_to_bloch_sphere()` on the output state obtained from the random kernel."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "rng = np.random.default_rng(seed=11)\n",
+    "blochSphereList = []\n",
+    "for _ in range(4):\n",
+    "    angleList = rng.random(3) * 2 * np.pi\n",
+    "    sph = cudaq.add_to_bloch_sphere(cudaq.get_state(kernel, angleList))\n",
+    "    blochSphereList.append(sph)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can display the spheres with `cudaq.show()`. Show the first sphere:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[0])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can also show multiple Bloch spheres side by side - simply set the `nrows` and `ncols` in the call to `cudaq.show()` accordingly. Make sure to have more spaces than spheres in your list, else it will throw an error! Let us show two spheres in a row:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[:2], nrows=1, ncols=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can show them in a column too, if we want! Simply set the `nrows = 2` and `ncols = 1`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[:2], nrows=2, ncols=1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Can we show the entire list of 4 Bloch spheres we created? Absolutely!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[:], nrows=2, ncols=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "What if we had to add multiple vectors to a single Bloch sphere? CUDA-Q uses the [QuTiP](https://www.qutip.org) toolbox to construct Bloch spheres. We can then add multiple states to the same Bloch sphere by passing the sphere object as an argument to `cudaq.add_to_bloch_sphere()`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import qutip\n",
+    "\n",
+    "rng = np.random.default_rng(seed=47)\n",
+    "blochSphere = qutip.Bloch()\n",
+    "for _ in range(10):\n",
+    "    angleList = rng.random(3) * 2 * np.pi\n",
+    "    sph = cudaq.add_to_bloch_sphere(cudaq.get_state(kernel, angleList), blochSphere)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This created a single Bloch sphere with 10 random vectors. Let us see how it looks."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "blochSphere.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Unfortunately, there is no such handy visualization for multi-qubit states. In particular, a multi-qubit state cannot be visualized as multiple Bloch spheres due to the nature of entanglement that makes quantum computing so powerful. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Kernel Visualization\n",
+    "\n",
+    "A CUDA-Q kernel can be visualized using the `cudaq.draw` API which returns a string representing the drawing of the execution path, in the specified format. ASCII (default) and LaTeX formats are supported."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel_to_draw():\n",
+    "    q = cudaq.qvector(4)\n",
+    "    h(q)\n",
+    "    x.ctrl(q[0], q[1])\n",
+    "    y.ctrl([q[0], q[1]], q[2])\n",
+    "    z(q[2])\n",
+    "    \n",
+    "    swap(q[0], q[1])\n",
+    "    swap(q[0], q[3])\n",
+    "    swap(q[1], q[2])\n",
+    "\n",
+    "    r1(3.14159, q[0])\n",
+    "    tdg(q[1])\n",
+    "    s(q[2])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(cudaq.draw(kernel_to_draw))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(cudaq.draw('latex', kernel_to_draw))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Copy this output string into any LaTeX editor and export it to PDF.\n",
+    "\n",
+    "<img src=\"images/circuit_pdf.png\" alt=\"Circuit in PDF format\" width=\"500\" height=\"250\">"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/vqe.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/vqe.ipynb.txt
new file mode 100644
index 0000000000..f6c8592354
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/vqe.ipynb.txt
@@ -0,0 +1,229 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Variational Quantum Eigensolver"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "A common application of the Variational Quantum Eigensolver (VQE) algorithm is to compute the ground state energy of a molecular system. The code below demonstrates how to perform classical preprocessing for a $H_2$ molecule (i.e. obtain the integrals from a Hartree-Fock computation to build the molecular Hamiltonian), prepare the initial Hartree-Fock state on the quantum register, add the parameterized UCCSD ansatz to the kernel, and select the COBYLA optimizer.  We are then ready to call `cudaq:vqe` to estimate the minimum energy of the system."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install openfermionpyscf==0.5 matplotlib==3.8.4 scipy==1.13.0"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "from scipy.optimize import minimize\n",
+    "import numpy as np\n",
+    "\n",
+    "# Single precision\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "# Double precision\n",
+    "#cudaq.set_target(\"nvidia-fp64\")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The problem of interest here is a chain of hydrogen atoms seperated along the z-axis at a fixed interval called the bond distance. \n",
+    "\n",
+    "The interatomic electrostatic forces due to the electrons and protons and the shielding by the neutrons creates a chemical system whose energy can be minimised to find a stable configuration. \n",
+    "\n",
+    "Let us first begin by defining the molecule and other metadata about the problem.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Number of hydrogen atoms.\n",
+    "hydrogen_count = 2\n",
+    "\n",
+    "# Distance between the atoms in Angstroms.\n",
+    "bond_distance = 0.7474\n",
+    "\n",
+    "# Define a linear chain of Hydrogen atoms\n",
+    "geometry = [('H', (0, 0, i * bond_distance)) for i in range(hydrogen_count)]\n",
+    "\n",
+    "hamiltonian, data = cudaq.chemistry.create_molecular_hamiltonian(\n",
+    "    geometry, 'sto-3g', 1, 0)\n",
+    "\n",
+    "electron_count = data.n_electrons\n",
+    "qubit_count = 2 * data.n_orbitals"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We now generate a Unitary Coupled-Cluster Singles and Doubles (UCCSD) ansatz from the template provided by CUDA-Q.  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel(thetas: list[float]):\n",
+    "\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    for i in range(electron_count):\n",
+    "        x(qubits[i])\n",
+    "\n",
+    "    cudaq.kernels.uccsd(qubits, thetas, electron_count, qubit_count)\n",
+    "\n",
+    "\n",
+    "parameter_count = cudaq.kernels.uccsd_num_parameters(electron_count,\n",
+    "                                                     qubit_count)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Using CUDA-Q Optimizers\n",
+    "\n",
+    "We use the builtin optimizers within CUDA-Q for the minimization procedure."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "-1.1371744305855906\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "energy, parameters = cudaq.vqe(kernel,\n",
+    "                               hamiltonian,\n",
+    "                               optimizer,\n",
+    "                               parameter_count=parameter_count)\n",
+    "\n",
+    "print(energy)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Integration with Third-Party Optimizers\n",
+    "\n",
+    "We can also integrate popular libraries like scipy with CUDA-Q. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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O3lU7fjPTpdLUtMoU9PflxMGmJqNsJhqPkrj/nvY7PeTL3ALoxdtDaKYp/xw6ijPiXWceHzjpB9OPM7J39vSdzb+3kZxp9Ta8Y1Ns2sjTh0VZOEcdoIQAHiJYRganhjpM7cSAfAcIQAAEMAIQgAAIGARhAAAQMAiCAEAgIBFEAIAAAGLIAQAAAIWQQgAAAQsghAAAAhYBCEAABCwCEIAACBgEYQAAEDAIggBAICARRACAAABiyAEAAAClt3qAvo60zQlSWVlZRZXAgAAOsr957b7z/HWEITaUV5eLklKTU21uBIAANBZ5eXlio6ObvVzw2wvKgU4l8ul/Px8RUZGyjAMr31vWVmZUlNTtX//fkVFRXnte/sSfz9Hfz8/yf/PkfPzff5+jpxf15mmqfLycqWkpMhma70TiBGhdthsNg0aNKjHvj8qKsov/+E+kb+fo7+fn+T/58j5+T5/P0fOr2vaGglyo1kaAAAELIIQAAAIWAQhizgcDj300ENyOBxWl9Jj/P0c/f38JP8/R87P9/n7OXJ+PY9maQAAELAYEQIAAAGLIAQAAAIWQQgAAAQsghAAAAhYBCGLPP3000pPT1doaKiysrK0du1aq0vyit/97ncyDKPZa+TIkVaX1S2ff/65LrnkEqWkpMgwDL377rvNPjdNUw8++KCSk5MVFhamGTNmaPv27dYU2wXtnd+8efNOuaYzZ860ptguWLhwoSZNmqTIyEglJCTo8ssvV15eXrNtampqdNttt2nAgAHq16+fZs+ercLCQosq7ryOnON55513ynW85ZZbLKq4c5555hmNHTvW89C9KVOm6KOPPvJ87uvXr73z8+Vr15KHH35YhmHozjvv9Lxn5TUkCFngH//4h371q1/poYce0tdff61x48bpoosuUlFRkdWlecVpp52mQ4cOeV5ffvml1SV1S2VlpcaNG6enn366xc8feeQRPfXUU3r22We1Zs0aRURE6KKLLlJNTU0vV9o17Z2fJM2cObPZNX3jjTd6scLuWbFihW677TatXr1aS5cuVX19vS688EJVVlZ6trnrrrv0wQcf6K233tKKFSuUn5+vK664wsKqO6cj5yhJN954Y7Pr+Mgjj1hUcecMGjRIDz/8sDZs2KD169fr/PPP12WXXabvvvtOku9fv/bOT/Lda3eydevW6bnnntPYsWObvW/pNTTR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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Define a function to minimize\n",
+    "def cost(theta):\n",
+    "\n",
+    "    exp_val = cudaq.observe(kernel, hamiltonian, theta).expectation()\n",
+    "\n",
+    "    return exp_val\n",
+    "\n",
+    "\n",
+    "exp_vals = []\n",
+    "\n",
+    "\n",
+    "def callback(xk):\n",
+    "    exp_vals.append(cost(xk))\n",
+    "\n",
+    "\n",
+    "# Initial variational parameters.\n",
+    "np.random.seed(42)\n",
+    "x0 = np.random.normal(0, np.pi, parameter_count)\n",
+    "\n",
+    "# Use the scipy optimizer to minimize the function of interest\n",
+    "result = minimize(cost,\n",
+    "                  x0,\n",
+    "                  method='COBYLA',\n",
+    "                  callback=callback,\n",
+    "                  options={'maxiter': 40})\n",
+    "\n",
+    "plt.plot(exp_vals)\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Energy')\n",
+    "plt.title('VQE')\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/examples/python/tutorials/vqe_water_active_space.ipynb.txt b/pr-2241/_sources/examples/python/tutorials/vqe_water_active_space.ipynb.txt
new file mode 100644
index 0000000000..7b5d0306ee
--- /dev/null
+++ b/pr-2241/_sources/examples/python/tutorials/vqe_water_active_space.ipynb.txt
@@ -0,0 +1,235 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Water Molecule with Active Space (CPU vs. GPU)\n",
+    "\n",
+    "#### A- Classical simulation as a reference: CCSD"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermionpyscf==0.5\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install openfermion==1.6.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "converged SCF energy = -75.9839755372789\n",
+      "Total number of electrons =  10\n",
+      "Total number of orbitals =  13\n",
+      "ncore occupied orbitals =  3\n",
+      "E(CCSD) = -75.98508980454675  E_corr = -0.001114267267875617\n",
+      "Total CCSD energy for active space Hamiltonian =  -75.98508980454675 \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from pyscf import gto, scf, mcscf, cc\n",
+    "\n",
+    "geometry ='O 0.1173 0.0 0.0; H -0.4691 0.7570 0.0; H -0.4691 -0.7570 0.0'\n",
+    "mol=gto.M(\n",
+    "    atom = geometry,\n",
+    "    spin = 0,\n",
+    "    charge = 0,\n",
+    "    basis = '631g',\n",
+    ")\n",
+    "\n",
+    "myhf = scf.RHF(mol)\n",
+    "myhf.max_cycle=100\n",
+    "myhf.kernel()\n",
+    "nelec = mol.nelectron\n",
+    "print('Total number of electrons = ', nelec)\n",
+    "norb = myhf.mo_coeff.shape[1]\n",
+    "print('Total number of orbitals = ', norb)\n",
+    "\n",
+    "norb_cas, nele_cas = (4,4)\n",
+    "mycasci = mcscf.CASCI(myhf, norb_cas, nele_cas)\n",
+    "print('ncore occupied orbitals = ', mycasci.ncore)\n",
+    "\n",
+    "frozen = []\n",
+    "frozen += [y for y in range(0,mycasci.ncore)]\n",
+    "frozen += [y for y in range(mycasci.ncore+norb_cas, len(mycasci.mo_coeff))]\n",
+    "mycc = cc.CCSD(myhf,frozen=frozen).run()\n",
+    "print('Total CCSD energy for active space Hamiltonian = ', mycc.e_tot, '\\n')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### B- VQE-UCCSD:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[\u001b[38;2;255;000;000mwarning\u001b[0m] Target \u001b[38;2;000;000;255mnvidia-fp64\u001b[0m: \u001b[38;2;000;000;255mThis target is deprecating. Please use the 'nvidia' target with option 'fp64'.\u001b[0m\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/tmp/ipykernel_23147/4290935201.py:35: ComplexWarning: Casting complex values to real discards the imaginary part\n",
+      "  spin_ham = cudaq.SpinOperator(qubit_hamiltonian)\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "UCCSD-VQE energy =   -75.98415928173183\n",
+      "Pyscf-CCSD energy =  -75.98508980454675\n",
+      "Total number of qubits =  8\n",
+      "Total number of parameters =  26\n",
+      "Total number of terms in the spin hamiltonian =  105\n",
+      "Total elapsed time (s) =  28.929891359000067\n"
+     ]
+    },
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import openfermion\n",
+    "import openfermionpyscf\n",
+    "from openfermion.transforms import jordan_wigner, get_fermion_operator\n",
+    "\n",
+    "import timeit\n",
+    "\n",
+    "\n",
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "from scipy.optimize import minimize\n",
+    "import numpy as np\n",
+    "\n",
+    "# GPU\n",
+    "cudaq.set_target(\"nvidia-fp64\")\n",
+    "# CPU\n",
+    "#cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "# 1- Classical pre-processing:\n",
+    "\n",
+    "geometry = [('O', (0.1173,0.0,0.0)), ('H', (-0.4691,0.7570,0.0)), ('H', (-0.4691,-0.7570,0.0))]\n",
+    "basis = '631g'\n",
+    "multiplicity = 1\n",
+    "charge = 0\n",
+    "ncore = 3\n",
+    "norb_cas, nele_cas = (4,4)\n",
+    "\n",
+    "molecule = openfermionpyscf.run_pyscf(openfermion.MolecularData(geometry, basis, multiplicity,charge))\n",
+    "\n",
+    "molecular_hamiltonian = molecule.get_molecular_hamiltonian(\n",
+    "        occupied_indices=range(ncore), active_indices=range(ncore, ncore + norb_cas))\n",
+    "\n",
+    "fermion_hamiltonian = get_fermion_operator(molecular_hamiltonian)\n",
+    "qubit_hamiltonian = jordan_wigner(fermion_hamiltonian)\n",
+    "\n",
+    "spin_ham = cudaq.SpinOperator(qubit_hamiltonian)\n",
+    "\n",
+    "# 2- Quantum computing using UCCSD ansatz\n",
+    "\n",
+    "electron_count = nele_cas\n",
+    "qubit_count = 2*norb_cas\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(qubit_num:int, electron_num:int, thetas: list[float]):\n",
+    "        qubits = cudaq.qvector(qubit_num)\n",
+    "\n",
+    "        for i in range(electron_num):\n",
+    "                x(qubits[i])\n",
+    "\n",
+    "        cudaq.kernels.uccsd(qubits, thetas, electron_num, qubit_num)\n",
+    "\n",
+    "parameter_count = cudaq.kernels.uccsd_num_parameters(electron_count,qubit_count)\n",
+    "\n",
+    "# Define a function to minimize\n",
+    "def cost(theta):\n",
+    "\n",
+    "        exp_val = cudaq.observe(kernel, spin_ham, qubit_count, electron_count, theta).expectation()\n",
+    "\n",
+    "        return exp_val\n",
+    "\n",
+    "\n",
+    "exp_vals = []\n",
+    "\n",
+    "def callback(xk):\n",
+    "        exp_vals.append(cost(xk))\n",
+    "\n",
+    "# Initial variational parameters.\n",
+    "np.random.seed(42)\n",
+    "x0 = np.random.normal(0, 1, parameter_count)\n",
+    "\n",
+    "# Use the scipy optimizer to minimize the function of interest\n",
+    "start_time = timeit.default_timer()\n",
+    "result = minimize(cost, x0, method='COBYLA', callback=callback, options={'maxiter': 300})\n",
+    "end_time = timeit.default_timer()\n",
+    "\n",
+    "print('UCCSD-VQE energy =  ', result.fun)\n",
+    "print('Pyscf-CCSD energy = ', mycc.e_tot)\n",
+    "print('Total number of qubits = ', qubit_count)\n",
+    "print('Total number of parameters = ', parameter_count)\n",
+    "print('Total number of terms in the spin hamiltonian = ',spin_ham.get_term_count())\n",
+    "print('Total elapsed time (s) = ', end_time-start_time)\n",
+    "\n",
+    "plt.plot(exp_vals)\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Energy')\n",
+    "plt.title('VQE')\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/_sources/index.rst.txt b/pr-2241/_sources/index.rst.txt
new file mode 100644
index 0000000000..1efc969894
--- /dev/null
+++ b/pr-2241/_sources/index.rst.txt
@@ -0,0 +1,33 @@
+************
+CUDA-Q
+************
+
+Welcome to the CUDA-Q documentation page!
+
+CUDA-Q streamlines hybrid application development and promotes productivity and scalability
+in quantum computing. It offers a unified programming model designed for a hybrid
+setting |---| that is, CPUs, GPUs, and QPUs working together. CUDA-Q contains support for 
+programming in Python and in C++.
+
+You are browsing the documentation for |version| version of CUDA-Q. You can find documentation for all released versions :doc:`here <versions>`.
+
+**CUDA-Q** is a programming model and toolchain for using quantum acceleration in heterogeneous computing architectures available in C++ and Python.
+
+.. toctree::
+   :caption: Contents
+   :maxdepth: 2
+
+      Quick Start <using/quick_start.rst>
+      Basics <using/basics/basics.rst>
+      Examples <using/examples/examples.rst>
+      Applications <using/tutorials.rst>
+      Backends <using/backends/backends.rst>
+      Installation <using/install/install.rst>
+      Integration <using/integration/integration.rst>
+      Extending <using/extending/extending.rst>
+      Specifications <specification/index.rst>
+      API Reference <api/api.rst>
+      Other Versions <versions.rst>
+
+.. |---|   unicode:: U+2014 .. EM DASH
+   :trim:
\ No newline at end of file
diff --git a/pr-2241/_sources/releases.rst.txt b/pr-2241/_sources/releases.rst.txt
new file mode 100644
index 0000000000..6a8a353462
--- /dev/null
+++ b/pr-2241/_sources/releases.rst.txt
@@ -0,0 +1,130 @@
+************************
+CUDA-Q Releases
+************************
+
+**latest**
+
+The latest version of CUDA-Q is on the main branch of our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__ and is also available as a Docker image. More information about installing the nightly builds can be found :doc:`here <using/install/install>`
+
+- `Docker image (nightly builds) <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/latest>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/main/docs/sphinx/examples>`__
+
+**0.8.0**
+
+The 0.8.0 release adds a range of changes to improve the ease of use and performance with CUDA-Q. 
+The changes listed below highlight some of what we think will be the most useful features and changes 
+to know about. While the listed changes do not capture all of the great contributions, we would like 
+to extend many thanks for every contribution, in particular those from external contributors.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.8.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.8.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.8.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.8.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.8.0>`__.
+
+**0.7.1**
+
+The 0.7.1 release adds simulator optimizations with significant performance improvements and 
+extends their functionalities. The `nvidia-mgpu` backend now supports user customization of the 
+gate fusion level as controlled by the `CUDAQ_MGPU_FUSE` environment variable documented 
+`here <https://nvidia.github.io/cuda-quantum/latest/using/backends/simulators.html>`__.
+It furthermore adds a range of bug fixes and changes the Python wheel installation instructions.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.7.1>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.7.1>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.7.1>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.7.1/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.7.1>`__.
+
+**0.7.0**
+
+The 0.7.0 release adds support for using :doc:`NVIDIA Quantum Cloud <using/backends/nvqc>`,
+giving you access to our most powerful GPU-accelerated simulators even if you don't have an NVIDIA GPU.
+With 0.7.0, we have furthermore greatly increased expressiveness of the Python and C++ language frontends. 
+Check out our `documentation <https://nvidia.github.io/cuda-quantum/latest/using/quick_start.html>`__ 
+to get started with the new Python syntax support we have added, and `follow our blog <https://developer.nvidia.com/cuda-q>`__
+to learn more about the new setup and its performance benefits.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.7.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.7.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.7.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.7.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.7.0>`__.
+
+**0.6.0**
+
+The 0.6.0 release contains improved support for various HPC scenarios. We have added a
+:ref:`plugin infrastructure <distributed-computing-with-mpi>` for connecting CUDA-Q 
+with an existing MPI installation, and we've added a :ref:`new platform target <remote-mqpu-platform>` that distributes workloads across multiple virtual QPUs, 
+each simulated by one or more GPUs.
+
+Starting with 0.6.0, we are now also distributing 
+:ref:`pre-built binaries <install-prebuilt-binaries>` for using CUDA-Q with C++.
+The binaries are built against the `GNU C library <https://www.gnu.org/software/libc/>`__ 
+version 2.28.
+We've added a detailed :doc:`Building from Source <using/install/data_center_install>` guide to build these binaries for older `glibc` versions.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.6.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.6.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.6.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.6.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.6.0>`__.
+
+**0.5.0**
+
+With 0.5.0 we have added support for quantum kernel execution on OQC and IQM backends. For more information, see :doc:`using/backends/hardware`.
+CUDA-Q now allows to executing adaptive quantum kernels on quantum hardware backends that support it.
+The 0.5.0 release furthermore improves the tensor network simulation tools and adds a matrix product state simulator, see :doc:`using/backends/simulators`.
+
+Additionally, we are now publishing images for experimental features, which currently includes improved Python language support.
+Please take a look at :doc:`using/install/install` for more information about how to obtain them.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.5.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.5.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.5.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.5.0>`__.
+
+**0.4.1**
+
+The 0.4.1 release adds support for ARM processors in the form of multi-platform Docker images and `aarch64` Python wheels. Additionally, all GPU-based backends are now included in the Python wheels as well as in the Docker image.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.4.1>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.4.1>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.4.1/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.4.1>`__.
+
+**0.4.0**
+
+CUDA-Q is now available on PyPI!
+The 0.4.0 release adds support for quantum kernel execution on Quantinuum and IonQ backends. For more information, see :doc:`using/backends/hardware`.
+
+The 0.4.0 PyPI release does not yet include all of the GPU-based backends.
+The fully featured version is available as a Docker image for `linux/amd64` platforms.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.4.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.4.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/0.4.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/tag/0.4.0>`__.
+
+**0.3.0**
+
+The 0.3.0 release of CUDA-Q is available as a Docker image for `linux/amd64` platforms.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.3.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/0.3.0/docs/sphinx/examples>`__
diff --git a/pr-2241/_sources/specification/cudaq.rst.txt b/pr-2241/_sources/specification/cudaq.rst.txt
new file mode 100644
index 0000000000..e0e87a44e4
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq.rst.txt
@@ -0,0 +1,41 @@
+Language Specification 
+***********************************
+
+NVIDIA CUDA-Q is a programming model in C++ for heterogeneous 
+quantum-classical computing. As such, the model provides primitive types, concepts, syntax, and
+semantics that enable the integration of quantum processing units (QPUs) with
+existing NVIDIA multi-node, multi-GPU parallel programming models and architectures. 
+The language is designed for C++. Extensions to other languages is fully supported 
+via appropriate bindings. 
+
+CUDA-Q implementations are intended to be enabled via library-based language 
+extensions that define quantum code as callables in the classical language being extended. 
+These callables are meant to be compiled with standard compilers and runtimes 
+and run via quantum computer simulators or available physical quantum architectures. The 
+language callables intended for quantum coprocessing must be annotated for 
+compilers and runtimes to process. These annotations should directly enable quantum-specific 
+optimization and transformation for optimal execution on simulators and QPUs. 
+
+The rest of this document will detail all aspects of the language specification - its machine model, 
+primitive types and operations, core concepts and abstractions, and algorithmic primitives. All code 
+specification and demonstrative examples are provided in C++ (the native CUDA-Q classical language). 
+Where possible, bindings for higher-level languages (e.g. Python) will be displayed to aid in understanding.
+
+.. toctree::
+  :numbered:
+  :caption: CUDA-Q
+  :maxdepth: 1
+
+  Machine Model <cudaq/machine_model.rst>
+  Namespace and Standard <cudaq/namespace.rst>
+  Quantum Types <cudaq/types.rst>
+  Quantum Operators <cudaq/operators.rst>
+  Quantum Operations <cudaq/operations.rst>
+  Quantum Kernels <cudaq/kernels.rst>
+  Sub-circuit Synthesis <cudaq/synthesis.rst>
+  Control Flow <cudaq/control_flow.rst>
+  Just-in-Time Kernel Creation <cudaq/dynamic_kernels.rst>
+  Quantum Patterns <cudaq/patterns.rst>
+  Platform <cudaq/platform.rst>
+  Algorithmic Primitives <cudaq/algorithmic_primitives.rst>
+  Example Programs <cudaq/examples.rst>
diff --git a/pr-2241/_sources/specification/cudaq/algorithmic_primitives.rst.txt b/pr-2241/_sources/specification/cudaq/algorithmic_primitives.rst.txt
new file mode 100644
index 0000000000..7e8b8240f6
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/algorithmic_primitives.rst.txt
@@ -0,0 +1,637 @@
+Quantum Algorithmic Primitives
+******************************
+**[1]** The general philosophy of the CUDA-Q specification is that quantum 
+device code should be encapsulated as stand-alone callable instances of generic 
+signature, and that operations or primitive algorithms targeting a quantum 
+coprocessor be implemented as adaptors on those callable instances. Adaptors, by 
+definition, are generic functions that take any quantum kernel as input along with 
+the runtime arguments for that kernel. Runtime arguments passed to adaptor functions 
+flow through the adaptor to the provided kernel. This pattern allows general pre- 
+and post-processing around concrete kernel execution. 
+
+.. _cudaq-sample-spec:
+
+:code:`cudaq::sample`
+-------------------------
+**[1]** A common task for near-term quantum execution is to sample the state
+of a given quantum circuit for a specified number of shots (circuit
+executions). The result of this task is typically a mapping of observed
+measurement bit strings to the number of times each was observed. This
+is typically termed the counts dictionary in the community. 
+
+**[2]** The CUDA-Q model enables this functionality via template functions within the
+:code:`cudaq` namespace with the following structure:
+
+.. code-block:: cpp
+
+    template <typename ReturnType>
+    concept HasVoidReturnType = std::is_void_v<ReturnType>;
+
+    // Kernel only
+    template<typename QuantumKernel, typename... Args>
+      requires HasVoidReturnType<QuantumKernel, Args...>
+    sample_result sample(QuantumKernel&& kernel, Args&&... args);
+
+    // Specify shots
+    template<typename QuantumKernel, typename... Args>
+      requires HasVoidReturnType<QuantumKernel, Args...>
+    sample_result sample(std::size_t shots, QuantumKernel&& kernel, Args&&... args);
+
+    // Specify sample options (including shots and noise model)
+    template<typename QuantumKernel, typename... Args>
+      requires HasVoidReturnType<QuantumKernel, Args...>
+    sample_result sample(const sample_options &options,
+                         QuantumKernel&& kernel, Args&&... args);
+
+**[3]** This function takes as input a quantum kernel instance followed by the
+concrete arguments at which the kernel should be invoked. CUDA-Q kernels 
+passed to this function must be entry-point kernels and return :code:`void`. 
+
+**[4]** Overloaded functions exist for specifying the number of shots to sample and the
+noise model to apply.
+
+**[5]** The function returns an instance of the :code:`cudaq::sample_result` type which encapsulates
+the counts dictionary produced by the sampling task. Programmers can
+extract the result information in the following manner: 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      auto bell = []() __qpu__ { ... };
+      
+      // Sample the state generated by bel
+      auto counts = cudaq::sample(bell)
+  
+      // Print to standard out
+      counts.dump();
+  
+      // Fine-grained access to the bits and counts
+      for (auto& [bits, count] : counts) {
+        printf("Observed: %s, %lu\n", bits, count);
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def bell(): 
+       ... 
+    
+    # Sample the state generated by bell
+    counts = cudaq.sample(bell) 
+
+    # Print to standard out
+    counts.dump()
+
+    # Fine-grained access to the bits and counts 
+    for bits, count in counts:
+        print('Observed: {}, {}'.format(bits, count))
+
+
+**[6]** CUDA-Q specifies the following structure for :code:`cudaq::sample_result`:
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      using CountsDictionary = std::unordered_map<std::string, std::size_t>;
+      inline static const std::string GlobalRegisterName = "__global__";
+      class sample_result {
+        public:
+          sample_result() = default;
+          sample_result(const sample_result &);
+          ~sample_result();
+          
+          std::vector<std::string> register_names();
+          
+          std::size_t count(std::string_view bitString,
+                      const std::string_view registerName = GlobalRegisterName);
+          
+          std::vector<std::string>
+          sequential_data(const std::string_view registerName = GlobalRegisterName);
+          
+          CountsDictionary
+          to_map(const std::string_view registerName = GlobalRegisterName);
+          
+          sample_result
+          get_marginal(const std::vector<std::size_t> &&marginalIndices,
+                 const std::string_view registerName = GlobalRegisterName);
+
+          double expectation(const std::string_view registerName == GlobalRegisterName);
+          double probability(std::string_view bitString, const std::string_view registerName == GlobalRegisterName);
+          std::size_t size(const std::string_view registerName == GlobalRegisterName);
+          
+          void dump();
+          void clear();
+
+          CountsDictionary::iterator begin();
+          CountsDictionary::iterator end();
+      };
+    }
+
+**[7]** The :code:`sample_result` type enables one to encode measurement results from a 
+quantum circuit sampling task. It keeps track of a list of sample results, each 
+one corresponding to a measurement action during the sampling process and represented 
+by a unique register name. It also tracks a unique global register, the implicit sampling 
+of the state at the end of circuit execution. The API gives fine-grain access 
+to the measurement results for each register. To illustrate this, observe 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+    auto kernel = []() __qpu__ {
+      cudaq::qubit q;
+      h(q);
+      auto reg1 = mz(q);
+      reset (q);
+      x(q);
+    };
+    cudaq::sample(kernel).dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def kernel():
+       q = cudaq.qubit()
+       h(q)
+       reg1 = mz(q)
+       reset(q)
+       x(q)
+    
+    cudaq.sample(kernel).dump()
+
+should produce 
+
+.. code-block:: bash 
+
+    { 
+      __global__ : { 1:1000 }
+      reg1 : { 0:501 1:499 }
+    }
+
+Here we see that we have measured a qubit in a uniform superposition to a 
+register named :code:`reg1`, and followed it with a reset and the application 
+of an NOT operation. The :code:`sample_result` returned for this sampling 
+tasks contains the default :code:`__global__` register as well as the user 
+specified :code:`reg1` register. 
+
+The contents of the :code:`__global__` register will depend on how your kernel
+is written:
+
+1. If no measurements appear in the kernel, then the :code:`__global__`
+   register is formed with implicit measurements being added for *all* the
+   qubits defined in the kernel, and the measurements all occur at the end of
+   the kernel. The order of the bits in the bitstring corresponds to the qubit
+   allocation order specified in the kernel.  That is - the :code:`[0]` element
+   in the :code:`__global__` bitstring corresponds with the first declared qubit
+   in the kernel. For example,
+
+.. tab:: C++ 
+
+   .. code-block:: cpp
+
+       auto kernel = []() __qpu__ {
+         cudaq::qubit a, b;
+         x(a);
+       };
+       cudaq::sample(kernel).dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel 
+    def kernel():
+        a, b = cudaq.qubit(), cudaq.qubit() 
+        x(a) 
+    
+    cudaq.sample(kernel).dump() 
+
+should produce 
+
+   .. code-block:: bash 
+
+       { 
+         __global__ : { 10:1000 }
+       }
+
+2. Conversely, if any measurements appear in the kernel, then only the measured
+   qubits will appear in the :code:`__global__` register. Similar to #1, the 
+   bitstring corresponds to the qubit allocation order specified in the kernel.
+   Also (again, similar to #1), the values of the sampled qubits always
+   correspond to the values *at the end of the kernel execution*. That is - if a
+   qubit is measured in the middle of a kernel and subsequent operations change
+   the state of the qubit, the qubit will be implicitly re-measured at the end
+   of the kernel, and that re-measured value is the value that will appear in
+   the :code:`__global__` register. For example,
+
+.. tab:: C++ 
+
+   .. code-block:: cpp
+
+       auto kernel = []() __qpu__ {
+         cudaq::qubit a, b;
+         x(a);
+         mz(b);
+         mz(a);
+       };
+       cudaq::sample(kernel).dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel
+    def kernel():
+        a, b = cudaq.qubit(), cudaq.qubit()
+        x(a)
+        mz(b)
+        mz(a)
+
+    cudaq.sample(kernel).dump() 
+  
+should produce 
+
+   .. code-block:: bash 
+
+       { 
+         __global__ : { 10:1000 }
+       }
+
+.. note::
+
+  If you don't specify any measurements in your kernel and allow the :code:`nvq++`
+  compiler to perform passes that introduce ancilla qubits into your kernel, it
+  may be difficult to discern which qubits are the ancilla qubits vs which ones
+  are your qubits. In this case, it is recommended that you provide explicit
+  measurements in your kernel in order to only receive measurements from your
+  qubits and silently discard the measurements from the ancillary qubits.
+
+**[8]** The API exposed by the :code:`sample_result` data type allows one to extract
+the information contained at a variety of levels and for each available 
+register name. One can get the number of times a bit string was observed via 
+:code:`sample_result::count`, extract a `std::unordered_map` representation via 
+:code:`sample_result::to_map`, get a new :code:`sample_result` instance over a subset of 
+measured qubits via :code:`sample_result::get_marginal`, and extract the 
+measurement data as it was produced sequentially (a vector of bit string observations 
+for each shot in the sampling process). One can also compute probabilities and expectation 
+values. 
+
+**[9]** There are specific requirements on input quantum kernels for the use of the
+sample function which must be enforced by compiler implementations. The kernel 
+must be an entry-point kernel that returns :code:`void`.
+
+**[10]** CUDA-Q also provides an asynchronous version of this function 
+(:code:`cudaq::sample_async`) which returns a :code:`sample_async_result`. 
+
+.. code-block:: cpp 
+
+    template<typename QuantumKernel, typename... Args>
+    async_sample_result sample_async(const std::size_t qpu_id, QuantumKernel&& kernel, Args&&... args);
+
+Programmers can asynchronously launch sampling tasks on any :code:`qpu_id`. 
+
+**[11]** The :code:`async_sample_result` wraps a :code:`std::future<sample_result>` and exposes the same 
+:code:`get()` functionality to extract the results after asynchronous execution. 
+
+**[12]** For remote QPU systems with long queue times, the :code:`async_sample_result` type encodes job ID 
+information and can be persisted to file and loaded from file at a later time. After loading from file, 
+and when remote queue jobs are completed, one can invoke :code:`get()` and the results will 
+be retrieved and returned. 
+
+:code:`cudaq::observe`
+-------------------------
+**[1]** A common task in variational algorithms is the computation of the expected
+value of a given observable with respect to a parameterized quantum circuit
+(:math:`\langle H \rangle(𝚹) = \langle \psi(𝚹)|H|\psi(𝚹) \rangle`). 
+
+**[2]** The :code:`cudaq::observe` function is provided to enable one to quickly compute
+this expectation value via execution of the parameterized quantum circuit
+with repeated measurements in the bases of the provided :code:`spin_op` terms. The
+function has the following signature:
+
+.. code-block:: cpp
+  
+    // Kernel only
+    template<typename QuantumKernel, typename... Args>
+    observe_result observe(QuantumKernel&&, cudaq::spin_op&, Args&&... args);
+    
+    // Specify shots
+    template<typename QuantumKernel, typename... Args>
+    observe_result observe(std::size_t shots, QuantumKernel&&, cudaq::spin_op&, Args&&... args);
+
+    // Specify sample options (including shots and noise model)
+    template<typename QuantumKernel, typename... Args>
+    observe_result observe(const cudaq::observe_options &options,
+                          QuantumKernel&&, cudaq::spin_op&, Args&&... args);
+
+**[3]** :code:`cudaq::observe` takes as input an instantiated quantum kernel, the
+:code:`cudaq::spin_op` whose expectation is requested, and the concrete
+arguments used as input to the parameterized quantum kernel. 
+
+**[4]** :code:`cudaq::observe` returns an instance of the :code:`observe_result` type which can be implicitly 
+converted to a :code:`double` expectation value, but also retains all data directly
+generated and used as part of that expectation value computation. The 
+:code:`observe_result` takes on the following form:
+
+.. code-block:: cpp
+
+    class observe_result {
+      public:
+        observe_result(double &e, spin_op &H);
+        observe_result(double &e, spin_op &H, MeasureCounts counts);
+
+        sample_results raw_data() { return data; };
+        operator double();
+        double expectation();
+        
+        template <typename SpinOpType>
+        double expectation(SpinOpType term);
+
+        template <typename SpinOpType>
+        sample_result counts(SpinOpType term);
+        double id_coefficient() 
+        void dump();
+    };
+
+**[5]** The public API for :code:`observe_result` enables one to extract the 
+:code:`sample_result` data for each term in the provided :code:`spin_op`. 
+This return type can be used in the following way.
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+      // I only care about the expected value, discard 
+      // the fine-grain data produced
+      double expVal = cudaq::observe(kernel, spinOp, args...);
+
+      // I require the result with all generated data 
+      auto result = cudaq::observe(kernel, spinOp, args...);
+      auto expVal = result.expectation();
+      auto X0X1Exp = result.expectation(x(0)*x(1));
+      auto X0X1Data = result.counts(x(0)*x(1));
+      result.dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    # I require the result with all generated data 
+    result = cudaq::observe(kernel, spinOp, *args)
+    expVal = result.expectation()
+    X0X1Exp = result.expectation(x(0)*x(1))
+    X0X1Data = result.counts(x(0)*x(1))
+    result.dump()
+
+
+Here is an example of the utility of the :code:`cudaq::observe` function:
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      struct ansatz {
+        auto operator()(double theta) __qpu__ {
+          cudaq::qarray<2> q;
+          x(q[0]);
+          ry(theta, q[1]);
+          x<cudaq::ctrl>(q[1], q[0]);
+        }
+      };
+    
+      int main() {
+        using namespace cudaq::spin; // make it easier to use pauli X,Y,Z below
+    
+        spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                    .21829 * z(0) - 6.125 * z(1);
+    
+        double energy = cudaq::observe(ansatz{}, h, .59);
+        printf("Energy is %lf\n", energy); 
+        return 0;
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def ansatz(theta : float): 
+       q = cudaq.qvector(2)
+       x(q[0])
+       ry(theta, q[1])
+       x.ctrl(q[1], q[0])
+    
+    h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                    .21829 * z(0) - 6.125 * z(1)
+    energy = cudaq.observe(ansatz, h, .59).expectation() 
+    print('Energy is {}'.format(energy))
+
+
+**[5]** There are specific requirements on input quantum kernels for the use of the
+observe function which must be enforced by compiler implementations. The
+kernel must be an entry-point kernel that does not contain any conditional
+or measurement statements.
+
+**[6]** By default on simulation backends, :code:`cudaq::observe` computes the true
+analytic expectation value (i.e. without stochastic noise due to shots-based sampling). 
+If a specific shot count is provided then the returned expectation value will contain some 
+level of statistical noise. Overloaded :code:`observe` functions are provided to 
+specify the number of shots and/or specify the noise model to apply.
+
+**[7]** CUDA-Q also provides an asynchronous version of this function 
+(:code:`cudaq::observe_async`) which returns a :code:`async_observe_result`. 
+
+.. code-block:: cpp 
+
+    template<typename QuantumKernel, typename... Args>
+    async_observe_result observe_async(const std::size_t qpu_id, QuantumKernel&& kernel, cudaq::spin_op&, Args&&... args);
+
+Programmers can asynchronously launch sampling tasks on any :code:`qpu_id`. 
+
+**[8]** For remote QPU systems with long queue times, the :code:`async_observe_result` type encodes job ID 
+information for each execution and can be persisted to file and loaded from file at a later time. After loading from file, 
+and when remote queue jobs are completed, one can invoke :code:`get()` and the results will 
+be retrieved and returned. 
+
+:code:`cudaq::optimizer` (deprecated, functionality moved to CUDA-Q libraries)
+------------------------------------------------------------------------------------
+The primary use case for :code:`cudaq::observe` is to leverage it as
+the core of a broader objective function optimization workflow. 
+:code:`cudaq::observe` produces the expected value of a specified 
+:code:`spin_op` with respect to a given parameterized ansatz at a concrete
+set of parameters, and often programmers will require an extremal value of that expected value 
+at a specific set of concrete parameters. This will directly require
+abstractions for gradient-based and gradient-free optimization strategies. 
+
+The CUDA-Q model provides a :code:`cudaq::optimizer` data type that exposes
+an :code:`optimize()` method that takes as input an 
+:code:`optimizable_function` to optimize and the number of independent
+function dimensions. Implementations are free to implement this abstraction
+in any way that is pertinent, but it is expected that most approaches will
+enable optimization strategy extensibility. For example, programmers should
+be able to instantiate a specific :code:`cudaq::optimizer` sub-type, thereby 
+dictating the underlying optimization algorithm in a type-safe manner. 
+Moreover, the optimizer should expose a public API of pertinent optimizer-specific 
+options that the programmer can customize.
+
+CUDA-Q models the :code:`cudaq::optimizer` as follows:
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      // Encode the optimal value and optimal parameters
+      using optimization_result = std::tuple<double, std::vector<double>>;
+      // Initialized with user specified callable of a specific signature
+      // Clients can query if the function computes gradients or not
+      class optimizable_function {
+        public:
+          template<typename Callable>
+          optimizable_function(Callable&&);
+          bool providesGradients() { return _providesGradients; }
+          double operator()(const std::vector<double> &x, std::vector<double> &dx);
+      };
+      class optimizer {
+        public:
+          virtual bool requiresGradients() = 0;
+          virtual optimization_result optimize(const int dimensions,
+                                              optimizable_function&& opt_function) = 0;
+      }; 
+    }
+
+Here, :code:`optimization_result` should encode the optimal value and optimal
+parameters achieved during the optimization workflow
+(i.e. a :code:`tuple<double, std::vector<double>>`). The optimize method takes
+as input the number of parameters (or dimensions of the objective function),
+and a function-like object (i.e. :code:`std::function` or a lambda, something 
+:code:`optimizable_function` can be constructed from) that takes a 
+:code:`const std::vector<double>&` and :code:`std::vector<double>&` for the
+function input parameters and gradient vector, respectively. The objective
+function must return a double representing the scalar cost for the
+objective function (e.g. the expected value from :code:`cudaq::observe()`).  
+
+Here is an example of how the :code:`cudaq::optimizer` is intended to be used: 
+
+.. code-block:: cpp 
+
+    auto ansatz = [](double theta, double phi) __qpu__ {...};
+    cudaq::spin_op H = ... ;
+  
+    cudaq::optimizers::cobyla optimizer;
+    optimizer.max_eval = 200;
+  
+    auto [opt_energy, opt_params] = optimizer.optimize(
+          2, [&](const std::vector<double> &x, std::vector<double> &grad_vec) {
+            return cudaq::observe(ansatz, H, x[0], x[1]);
+          });
+
+:code:`cudaq::gradient` (deprecated, functionality moved to CUDA-Q libraries)
+-----------------------------------------------------------------------------------
+Typical optimization use cases will require the computation of gradients for the specified
+objective function. The gradient is a vector over all ansatz circuit
+parameters :math:`∂H(𝚹) / ∂𝚹_i`. There are a number of potential strategies for
+computing this gradient vector, but most require additional evaluations
+of the ansatz circuit on the quantum processor. 
+
+To enable true extensibility in gradient strategies, CUDA-Q programmers can
+instantiate custom sub-types of the :code:`cudaq::gradient` type. The :code:`cudaq::gradient`
+type defines a :code:`compute(...)` method that takes a mutable reference to the 
+current gradient vector and is free to update that vector in a strategy-specific way. 
+The method also takes the current evaluation parameter vector, the :code:`cudaq::spin_op` used 
+in the current variational task, and the computed expected value at the given parameters. 
+The gradient strategy type takes the following form:
+
+.. code-block:: cpp
+
+    namespace cudaq {
+      class gradient {
+        public:
+          gradient(std::function<void(std::vector<double>)> &&kernel);
+  
+          template <typename QuantumKernel, typename ArgsMapper>
+          gradient(QuantumKernel &&kernel, ArgsMapper &&argsMapper);
+  
+          virtual void compute(std::vector<double>& x, std::vector<double> &dx,
+                            spin_op& h, double exp_h) = 0;
+          
+          virtual std::vector<double>
+          compute(const std::vector<double> &x,
+                  std::function<double(std::vector<double>)> &func) = 0;
+
+      };
+  
+      // gradient is intended for subclassing
+      class central_difference : public gradient {
+        public:
+          void compute(std::vector<double>& x, std::vector<double> &dx, spin_op& h,
+                  double exp_h) override { ... }
+      };
+    }
+
+The :code:`compute` function can make use of the quantum kernel parameterized ansatz, the 
+:code:`spin_op` for which the expected value is being computed, the
+pre-computed expected value at the current iteration's parameter, and the
+concrete arguments for the given quantum kernel at this iteration.
+
+A non-trivial aspect of the computation of gradients (in an extensible manner)
+is that we model the gradient as a derivative over concrete parameters for the
+circuit ansatz represented as a :code:`std::vector<double>` when the actual
+quantum kernel may be defined with general variadic :code:`Args...` types.
+To address this issue, programmers can provide a default translation
+mechanism for mapping common quantum kernel ansatz functional expressions to a :code:`vector<double>` representation - the 
+:code:`ArgsMapper` callable template type. This type must implement the 
+:code:`std::tuple<Args...>(std::vector<double>&)` callable concept. 
+
+The overall CUDA-Q workflow for leveraging the :code:`cudaq::optimizer`
+will work as follows (here we demonstrate with an ansatz without the
+default :code:`std::vector<double>` signature):
+
+.. code-block:: cpp
+
+    auto deuteron_n3_ansatz = [](double x0, double x1) __qpu__ {
+      cudaq::qarray<3> q;
+      x(q[0]);
+      ry(x0, q[1]);
+      ry(x1, q[2]);
+      x<cudaq::ctrl>(q[2], q[0]);
+      x<vctrl>(q[0], q[1]);
+      ry(-x0, q[1]);
+      x<cudaq::ctrl>(q[0], q[1]);
+      x<cudaq::ctrl>(q[1], q[0]);
+    };
+
+    cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+              .21829 * z(0) - 6.125 * z(1);
+    cudaq::spin_op h3 = h + 9.625 - 9.625 * z(2) - 3.913119 * x(1) * x(2) -
+                3.913119 * y(1) * y(2);
+
+    // The above ansatz takes 2 doubles, not a single std::vector<double>, which 
+    // the gradient type is expecting. So we must provide an ArgsMapper callable type
+    auto argsMapper = [](std::vector<double> x) {return std::make_tuple(x[0],x[1]);};
+
+    // Create the gradient strategy
+    cudaq::gradients::central_difference gradient(deuteron_n3_ansatz, argsMapper);
+
+    // Create the L-BFGS optimizer, requires gradients
+    cudaq::optimizers::lbfgs optimizer;
+
+    // Run the optimization routine. 
+    auto [min_val, opt_params] = optimizer.optimize(
+        2, [&](const std::vector<double>& x, std::vector<double>& grad_vec) {
+          // Compute the cost, here its an energy
+          auto cost = cudaq::observe(deuteron_n3_ansatz, h3, x);
+          
+          // Compute the gradient, results written to the grad_vec reference
+          gradient.compute(x, grad_vec, h3, cost);
+
+          // Return the cost to the optimizer
+          return cost;
+        });
+
+    // Print the results
+    printf("Optimizer found %lf at [%lf,%lf]\n", min_val, opt_params[0], opt_params[1]);
+
diff --git a/pr-2241/_sources/specification/cudaq/control_flow.rst.txt b/pr-2241/_sources/specification/cudaq/control_flow.rst.txt
new file mode 100644
index 0000000000..da3120dd74
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/control_flow.rst.txt
@@ -0,0 +1,10 @@
+Control Flow
+************
+**[1]** All classical control flow expressions are inherited from the host language
+(e.g. C++, Python). 
+
+**[2]** Programmers can define quantum kernels using standard loop
+constructs and conditional statements. 
+
+**[3]** Conditional statements on quantum memory and measured :code:`cudaq::qudit` 
+results are permitted. 
diff --git a/pr-2241/_sources/specification/cudaq/dynamic_kernels.rst.txt b/pr-2241/_sources/specification/cudaq/dynamic_kernels.rst.txt
new file mode 100644
index 0000000000..8681ad6a62
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/dynamic_kernels.rst.txt
@@ -0,0 +1,163 @@
+Just-in-Time Kernel Creation
+****************************
+
+**[1]** CUDA-Q provides a set of programming abstractions for dynamically constructing
+quantum kernel code at runtime. 
+
+**[2]** The callable :code:`cudaq::kernel_builder` abstraction
+facilitates the dynamic definition of quantum kernels that can optionally
+be parameterized by user-defined input arguments. 
+
+The :code:`kernel_builder` takes the following structure
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      // Type wrapping a value in the kernel IR
+      struct Value;
+      template <typename... Args>
+      class kernel_builder {
+        private:
+          std::vector<Value> arguments;
+
+        public:
+          std::vector<Value>& getArguments();
+          std::string name() const;
+          std::size_t getNumParams() const;
+
+          Value qalloc(std::size_t nQubits = 1);
+          Value qalloc(Value size);
+
+          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>
+          void call(OtherKernelBuilder&& kernelToCall, Values&... args);
+          
+          // General multi-control on a predefined kernel
+          // models cudaq::control(...)
+          template<typename OtherKernelBuilder, typename... Values>
+          void control(OtherKernelBuilder&& kernelToControl, Value& ctrl, Values&... values);
+          
+          // General adjoint on a predefined kernel
+          // models cudaq::adjoint(...)
+          template<typename OtherKernelBuilder, typename... Values>
+          void adjoint(OtherKernelBuilder&& kernelToAdjoint, Values&... values);
+       
+          // The constructed kernel is callable
+          void operator()(Args... args);
+          void operator()(void** argsArray);
+
+          // Enable structured bindings
+          template <std::size_t N>
+          decltype(auto) get() {
+            if constexpr (N == 0)
+              return *this;
+            else
+              return arguments[N - 1];
+          }
+      };
+    }
+
+    /// Enable structured bindings on the kernel_builder type.
+    /// auto [kernel, theta, phi] = std::make_kernel<double,double>();
+    namespace std {
+      template <typename... Args> 
+      struct tuple_size<cudaq::kernel_builder<Args...>>
+        : std::integral_constant<std::size_t, sizeof...(Args) + 1> {};
+
+      template <std::size_t N, typename... Args>
+      struct tuple_element<N, cudaq::kernel_builder<Args...>> {
+        using type = std::conditional_t<N == 0, cudaq::kernel_builder<Args...>,
+                                  cudaq::QuakeValue>;
+      };
+    } // namespace std
+
+    namespace cudaq {
+      kernel_builder<> make_kernel();
+      template<typename... Args>
+      kernel_builder<Args...> make_kernel();
+    }
+
+**[3]** The structure above allows one to leverage the provided factory functions (:code:`make_kernel`)
+to construct an empty CUDA-Q kernel with defined argument signature. 
+
+**[4]** For each type in the signature, the programmer is returned a new :code:`Value` instance which 
+can be leveraged in the construction of the kernel. The intended mechanism for 
+kernel creation and argument value extraction is via standard C++ 
+`structured bindings <https://en.cppreference.com/w/cpp/language/structured_binding>`_.
+
+**[5]** Once the kernel is created, the programmer is free to build up the kernel expression 
+using the exposed API. There are methods for qubit allocation, quantum operation 
+invocation, control and adjoint synthesis, and conditional branching based on 
+`boolean` values. 
+
+Here is a simple example how one might build a CUDA-Q kernel dynamically. 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    auto kernel = cudaq::make_kernel();
+    auto qubits = kernel.qalloc(2);
+    kernel.h(qubits[0]);
+    kernel.x<cudaq::ctrl>(qubits[0], qubits[1]);
+    kernel.mz(qubits);
+    
+    // See algorithmic primitives section for more on sample
+    auto counts = cudaq::sample(kernel);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    kernel = cudaq.make_kernel()
+    qubits = kernel.qalloc(2)
+    kernel.h(qubits[0])
+    kernel.cx(qubits[0], qubits[1])
+    kernel.mz(qubits)
+
+Here is an example demonstrating how one may build a dynamic set of 
+CUDA-Q kernels for executing the standard Hadamard test. 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      auto [xPrep, qubitIn] = cudaq::make_kernel<cudaq::qubit>();
+      xPrep.x(qubitIn);
+
+      // Compute <1|X|1> = 0
+      auto hadamardTest = cudaq::make_kernel();
+      auto q = hadamardTest.qalloc();
+      auto ancilla = hadamardTest.qalloc();
+      hadamardTest.call(xPrep, q);
+      hadamardTest.h(ancilla);
+      hadamardTest.control(xPrep, ancilla, q);
+      hadamardTest.h(ancilla);
+      hadamardTest.mz(ancilla);
+
+      // See algorithmic primitives section for more on sample
+      auto counts = cudaq::sample(hadamardTest);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    xPrep, qubitIn = cudaq.make_kernel(cudaq.qubit)
+
+    # Compute <1|X|1> = 0
+    hadamardTest = cudaq.make_kernel()
+    q = hadamardTest.qalloc()
+    hadamardTest.call(xPrep, q)
+    hadamardTest.h(ancilla)
+    hadamardTest.control(xPrep, ancilla, q)
+    hadamardTest.h(ancilla)
+    hadamardTest.mz(ancilla)
+
+    # See algorithmic primitives section for more on sample
+    counts = cudaq.sample(hadamardTest)
diff --git a/pr-2241/_sources/specification/cudaq/examples.rst.txt b/pr-2241/_sources/specification/cudaq/examples.rst.txt
new file mode 100644
index 0000000000..9cc490e035
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/examples.rst.txt
@@ -0,0 +1,270 @@
+
+Example Programs
+****************
+Hello World - Simple Bell State
+-------------------------------
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      #include <cudaq.h>
+
+      struct bell {
+        int operator()(int num_iters) __qpu__ {
+          cudaq::qarray<2> q;
+          int nCorrect = 0;
+          for (int i = 0; i < num_iters; i++) {
+            h(q[0]);
+            x<cudaq::ctrl>(q[0], q[1]);
+            auto results = mz(q);
+            if (results[0] == results[1]) 
+              nCorrect++;
+            
+            reset(q[0]);
+            reset(q[1]);
+          }
+          return nCorrect;
+        }
+      };
+
+      int main() { printf("N Correct = %d\n", bell{}(100)); }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq 
+
+    @cudaq.kernel()
+    def bell(num_iters : int) -> int:
+        q = cudaq.qvector(2)
+        nCorrect = 0
+        for i in range(num_iters):
+            h(q[0])
+            x.ctrl(q[0], q[1])
+            results = mz(q)
+            if results[0] == results[1]:
+               nCorrect = nCorrect + 1
+            
+            reset(q)
+        return nCorrect 
+
+    counts = bell(100)
+    print(f'N Correct = {counts}')
+    assert counts == 100
+
+GHZ State Preparation and Sampling
+----------------------------------
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+  
+      #include <cudaq.h>
+
+      __qpu__ ghz(const int n_qubits) {
+        cudaq::qvector q(n_qubits);
+        h(q[0]);
+        for (int i = 0; i < n_qubits - 1; ++i) 
+          // note use of ctrl modifier
+          x<cudaq::ctrl>(q[i], q[i+1]); 
+        
+        mz(q);
+      }
+
+      int main() {
+        // Sample the state produced by the ghz kernel
+        auto counts = cudaq::sample(ghz, 10);
+        for (auto [bits, count] : counts) {
+          printf("Observed %s %lu times.\n", bits.c_str(), count);
+        }
+        return 0;
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq 
+    
+    @cudaq.kernel
+    def ghz(numQubits:int):
+        qubits = cudaq.qvector(numQubits)
+        h(qubits.front())
+        for i, qubit in enumerate(qubits.front(numQubits - 1)):
+            x.ctrl(qubit, qubits[i + 1])
+    
+    counts = cudaq.sample(ghz, 10)
+    for bits, count : counts:
+        print('Observed {} {} times.'.format(bits, count))
+
+Quantum Phase Estimation
+------------------------
+
+.. tab:: C++ 
+
+  .. literalinclude:: ../../examples/cpp/algorithms/phase_estimation.cpp
+      :language: cpp
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq, numpy as np
+
+    # Compute phase for U |psi> = exp(-2 pi phase) |psi> 
+    # This example will consider U = T, and |psi> = |1>
+    # Define a Inverse Quantum Fourier Transform kernel
+    @cudaq.kernel
+    def iqft(qubits: cudaq.qview):
+        N = qubits.size()
+        for i in range(N // 2):
+            swap(qubits[i], qubits[N - i - 1])
+
+        for i in range(N - 1):
+            h(qubits[i])
+            j = i + 1
+            for y in range(i, -1, -1):
+                r1.ctrl(-np.pi / 2**(j - y), qubits[j], qubits[y])
+
+        h(qubits[N - 1])
+
+
+    # Define the U kernel
+    @cudaq.kernel
+    def tGate(qubit: cudaq.qubit):
+        t(qubit)
+
+
+    # Define the state preparation |psi> kernel
+    @cudaq.kernel
+    def xGate(qubit: cudaq.qubit):
+        x(qubit)
+
+    # General Phase Estimation kernel for single qubit 
+    # eigen states. 
+    @cudaq.kernel
+    def qpe(nC: int, nQ: int, statePrep: Callable[[cudaq.qubit], None],
+            oracle: Callable[[cudaq.qubit], None]):
+        q = cudaq.qvector(nC + nQ)
+        countingQubits = q.front(nC)
+        stateRegister = q.back()
+        statePrep(stateRegister)
+        h(countingQubits)
+        for i in range(nC):
+            for j in range(2**i):
+                cudaq.control(oracle, [countingQubits[i]], stateRegister)
+        iqft(countingQubits)
+        mz(countingQubits)
+
+    # Sample the state to get the phase. 
+    counts = cudaq.sample(qpe, 3, 1, xGate, tGate)
+    assert len(counts) == 1
+    assert '100' in counts
+
+
+Deuteron Binding Energy Parameter Sweep
+---------------------------------------
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+      #include <cudaq.h>
+
+      struct deuteron_n2_ansatz {
+        void operator()(double theta) __qpu__ {
+          cudaq::qarray<2> q;
+          x(q[0]);
+          ry(theta, q[1]);
+          x<cudaq::ctrl>(q[1], q[0]);
+        }
+      };
+
+      int main() {
+        using namespace cudaq::spin;
+        cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                    .21829 * z(0) - 6.125 * z(1);
+    
+        // Perform parameter sweep for deuteron N=2 Hamiltonian
+        const auto param_space = cudaq::linspace(-M_PI, M_PI, 25);
+        for (const auto& param : param_space) {
+          // KERNEL::observe(...) <==> 
+          // E(params...) = <psi(params...) | H | psi(params...)>
+          double energy_at_param = cudaq::observe(deuteron_n2_ansatz{}, h, param);
+          printf("<H>(%lf) = %lf\n", param, energy_at_param);
+        }
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq 
+    from cudaq import spin 
+
+    @cudaq.kernel
+    def ansatz(angle:float):
+        q = cudaq.qvector(2)
+        x(q[0])
+        ry(angle, q[1])
+        x.ctrl(q[1], q[0])
+
+    hamiltonian = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+        0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+    # Perform parameter sweep for deuteron N=2 Hamiltonian
+    for angle in np.linspace(-np.pi, np.pi, 25):
+         # KERNEL::observe(...) <==> 
+         # E(params...) = <psi(params...) | H | psi(params...)>
+         energyAtParam = cudaq.observe(ansatz, hamiltonian, .59)
+         print('<H>({}) = {}'.format(angle, energyAtParam))
+
+
+Grover's Algorithm
+------------------
+
+.. tab:: C++ 
+
+  .. literalinclude:: ../../examples/cpp/algorithms/grover.cpp
+      :language: cpp
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel 
+    def reflect(qubits: cudaq.qview):
+        ctrls = qubits.front(qubits.size() - 1)
+        last = qubits.back()
+        cudaq.compute_action(lambda: (h(qubits), x(qubits)),
+                              lambda: z.ctrl(ctrls, last))
+
+    @cudaq.kernel
+    def oracle(q: cudaq.qview):
+        z.ctrl(q[0], q[2])
+        z.ctrl(q[1], q[2])
+
+    @cudaq.kernel
+    def grover(N: int, M: int, oracle: Callable[[cudaq.qview], None]):
+        q = cudaq.qvector(N)
+        h(q)
+        for i in range(M):
+            oracle(q)
+            reflect(q)
+        mz(q)
+
+    counts = cudaq.sample(grover, 3, 1, oracle)
+    assert len(counts) == 2
+    assert '101' in counts
+    assert '011' in counts
+
+
+Iterative Phase Estimation
+--------------------------
+
+.. literalinclude:: ../../examples/cpp/other/iterative_qpe.cpp
+    :language: cpp
+    :start-after: [Begin Documentation]
+    :end-before: [End Documentation]
diff --git a/pr-2241/_sources/specification/cudaq/kernels.rst.txt b/pr-2241/_sources/specification/cudaq/kernels.rst.txt
new file mode 100644
index 0000000000..b9da04496a
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/kernels.rst.txt
@@ -0,0 +1,362 @@
+Quantum Kernels
+***************
+**[1]** To differentiate between host and quantum device code, the CUDA-Q programming
+model defines the concept of a **quantum kernel**. A quantum kernel is any callable 
+in C++ annotated to indicate compilation and execution on an available quantum coprocessor. 
+
+**[2]** All quantum kernels must be annotated to indicate they are to be compiled for, and executed
+on, a specified quantum coprocessor. CUDA-Q requires the :code:`__qpu__` function
+attribute for quantum kernel declarations. Other language bindings may opt to use other language 
+features to enable function annotation or decoration (e.g. a :code:`@cudaq.kernel()` function 
+decorator in Python). 
+
+**[3]** CUDA-Q specifically differentiates between kernels invoked from host code and those invoked
+from within another quantum kernel. The former are denoted **entry-point**
+quantum kernels, the latter are **pure device** quantum kernels. Entry point kernels can 
+only take classical types as input and return classical output. Pure-device kernels 
+can take quantum types as input.
+
+.. tab:: C++ 
+  
+  .. code-block:: cpp
+  
+      // Entry point lambda kernel
+      auto my_first_entry_point_kernel = [](double x) __qpu__ { ... quantum code ... };
+      
+      // Entry point typed callable kernel
+      struct my_second_entry_point_kernel { 
+        void operator()(double x, std::vector<double> params) __qpu__ { 
+          ... quantum code ...
+        }
+      };
+
+      // Pure device free function kernel
+      __qpu__ void my_first_pure_device_kernel(cudaq::qview<> qubits) {
+         ... quantum code ... 
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def my_first_entry_point_kernel(x : float):
+       ... quantum code ... 
+    
+    @cudaq.kernel()
+    def my_second_entry_point_kernel(x : float, params : list[float]):
+       ... quantum code ... 
+
+    @cudaq.kernel()
+    def my_first_pure_device_kernel(qubits : cudaq.qview):
+       ... quantum code ... 
+    
+**[4]** Quantum kernel function bodies are programmed in a subset of the parent classical language. 
+Kernels can be composed of the following: 
+
+  * Quantum intrinsic operations and measurements
+  * In-scope kernel calls with or without any kernel modifiers (e.g. :code:`cudaq::control`)
+  * Classical control flow constructs from the classical language (:code:`if`, :code:`for`, :code:`while`, etc.)
+  * Stack variable declarations for supported types. 
+  * Arithmetic operations on integer and floating point stack variables
+  * Coherent conditional execution - :code:`if ( boolExprFromQubitMeasurement ) { x (another_qubit); }` 
+  * Syntax for common quantum programming patterns (e.g. compute-action-uncompute).
+
+
+**[5]** CUDA-Q defines a set of allowed types that can be leveraged in quantum kernel 
+function signatures (input and return types), in-function variable declaration or construction, 
+and in variable capture from parent scope. 
+
+The allowed types are as follows: 
+
+  * :code:`T` such that :code:`std::is_arithmetic_v<T> == true`
+  * :code:`std::vector<T>` such that :code:`std::is_arithmetic_v<T> == true`
+  * :code:`std::span<T>` such that :code:`std::is_arithmetic_v<T> == true`
+  * :code:`std::vector<V>` such that type :code:`V` is a valid :code:`std::vector<T>` (possibly recursively)
+  * :code:`struct` types composed of any valid CUDA-Q type.
+  * :code:`std::tuple<Ts...>` such that T is any allowed type.
+  * :code:`std::pair<T,U>` such that T is any allowed type.
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+    struct MyCustomSimpleStruct {
+       int i = 0;
+       int j = 0;
+       std::vector<double> angles;
+    }; 
+
+    // Valid CUDA-Q Types used in Kernels
+    auto kernel = [](int N, bool flag, float angle, std::vector<std::size_t> layers,
+             std::vector<double> parameters, std::vector<std::vector<float>> recursiveVec, 
+             MyCustomSimpleStruct var) __qpu__ { ... }
+    
+    __qpu__ double kernelThatReturns() { 
+       ... 
+       return M_PI_2;
+    }
+    
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    class MySimpleStruct(object):
+        def __init__(self):
+            self.i = 0 
+            self.j = 0
+
+    @cudaq.kernel
+    def kernel(N : int, flag : bool, angle : float, layers : list[int], 
+                parameters : list[float], recursiveList : list[list[float]], 
+                var : MySimpleStruct): ... 
+    
+    @cudaq.kernel 
+    def kernelThatReturns() -> float:
+        ... 
+        return np.pi / 2.0
+
+**[6]** Any variable with an allowed CUDA-Q type can be allocated on the stack within 
+CUDA-Q kernels. Variables of type :code:`std::vector<T>` for any allowed type 
+:code:`T` can only be constructed with known size. Vector-like variables cannot be 
+default constructed and later filled with type :code:`T` data (i.e. no dynamic memory allocation). 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+    // Valid CUDA-Q Types used in Kernels
+    auto kernel = []() __qpu__ {
+      
+      // Not Allowed. 
+      // std::vector<int> i; 
+      // i.push_back(1);
+
+      // Valid variable declarations
+
+      std::vector<int> i(5);
+      i[2] = 3; 
+
+      std::vector<float> f {1.0, 2.0, 3.0};
+
+      int k = 0;
+
+      double pi = 3.1415926
+    };
+    
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel
+    def kernel(): 
+       # Not Allowed 
+       # i = [] 
+       # i.append(1)
+
+       i = [0 for k in range(5)]
+       i[2] = 3 
+
+       f = [1., 2., 3.]
+
+       k = 0 
+
+       pi = 3.1415926
+
+**[7]** All entry-point kernel arguments adhere to pass-by-value semantics. 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    auto kernel = [](int i, std::vector<double> v) __qpu__ {
+       // i == 2, allocate 2 qubits 
+       cudaq::qvector q(i); 
+       // v[1] == 2.0, angle here is 2.0
+       ry(v[1], q[0]);
+
+       // Change the variables, caller does not see this
+       i = 5; 
+       v[0] = 3.0;
+    };
+
+    int k = 2;
+    std::vector<double> d {1.0, 2.0};
+    
+    kernel(k, d);
+
+    // k is still 2, pass by value 
+    // d is still {1.0, 2.0}, pass by value 
+  
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel 
+    def kernel(i : int, v : list[float]): 
+        # i = 2, allocate 2 qubits 
+        q = cudaq.qvector(i)
+        # v[1] == 2.0, angle here is 2.0 
+        ry(v[1], q[0])
+
+        # Change the variables, caller does not see this 
+        i = 5 
+        v[0] = 3.0 
+
+    k, d = 2, [1., 2.]
+    kernel(i, d)
+
+    # k is still 2, pass by value 
+    # d is still {1.0, 2.0}, pass by value 
+
+
+.. FIXME Pass by value vs reference, should we mandate pass by reference for inter-kernel calls
+
+**[8]** CUDA-Q kernel lambdas in C++ can capture variables of allowed type 
+by value. CUDA-Q kernels defined as custom callable types can define non-reference type 
+class members of any allowed type. These member variables can be set with 
+pass-by-value semantics at kernel construction. 
+
+.. tab:: C++ 
+
+  .. code-block:: C++ 
+
+    struct kernel {
+      int i; 
+      float f; 
+
+      void operator()() __qpu__ {
+         cudaq::qvector q(i); 
+         ry(f, q[0]);
+      }
+    };
+
+    kernel{2, 2.2}();
+
+    int i = 2; 
+    double f = 2.2;
+
+    auto kernelLambda = [=]() __qpu__ {
+      // Use captured variables 
+      cudaq::qvector q(i); 
+      ry(f, q[0]);
+      i = 5; 
+      return i; 
+    };
+
+    auto k = kernelLambda(); 
+
+    // Pass by value semantics 
+    assert(k != i);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    i = 2 
+    f = np.pi / 2. 
+
+    @cudaq.kernel
+    def kernel() -> int:
+       # Use captured variables 
+       q = cudaq.qvector(i) 
+       ry(f, q[0])
+
+       i = 5 
+       return i 
+    
+    k = kernel() 
+
+    # Pass by value semantics 
+    assert k != i 
+
+**[9]** All quantum kernel invocations are synchronous calls by default. 
+
+**[10]** CUDA-Q kernels can serve as input to other quantum kernels and invoked by kernel 
+function body code. To support CUDA-Q kernel parameterization on callable quantum kernel 
+code, programmers can leverage standard C++ template definitions or dynamic typing in language bindings such as Python:
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+      __qpu__ void MyStatePrep(cudaq::qview<> qubits) {
+          ... apply state prep operations on qubits ...
+      }
+
+      struct MyGenericAlgorithm {
+        template<typename StatePrep>
+        void operator()(const StatePrep& statePrep) __qpu__ {
+          cudaq::qarray<10> q;
+          statePrep(q);
+          ...
+        }
+      };
+
+      // -or- with placeholder type specifiers
+      struct MyGenericAlgorithm2 {
+        void operator()(const auto& statePrep) __qpu__ {
+          cudaq::qarray<10> q;
+          statePrep(q);
+          ...
+        }
+      };
+
+      void callKernels() {
+
+        MyGenericAlgorithm algorithm;
+        algorithm(MyStatePrep);
+
+        MyGenericAlgorithm2 anotherVersion;
+        anotherVersion(MyStatePrep);
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def MyStatePrep(qubits : cudaq.qview):
+        ... apply state prep operations on qubits ... 
+    
+    @cudaq.kernel()
+    def MyGenericAlgorithm(statePrep : typing.Callable[[cudaq.qview], None]):
+        q = cudaq.qvector(10)
+        statePrep(q)
+        ...
+    
+    MyGenericAlgorithm(MyStatePrep)
+
+CUDA-Q kernel inputs can also be `constrained <https://en.cppreference.com/w/cpp/language/constraints>`_. 
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+
+      // Generic constraint on Kernel Function Signatures
+      template <typename Kernel, typename Signature>
+      concept signature = std::is_convertible_v<Kernel, std::function<Signature>>; 
+
+      // Specialized for taking a single qubit
+      template<typename Kernel>
+      concept takes_qubit = signature<Kernel, void(qubit&)>;
+    }
+
+    struct MyGenericAlgorithmOnQarray {
+      void operator()(cudaq::signature<void(cudaq::qarray&)> auto&& statePrep) __qpu__ {
+        cudaq::qarray<10> q;
+        statePrep(q);
+        ...
+      }
+    };
+
+    struct MyGenericAlgorithmOnQubit {
+      void operator()(cudaq::takes_qubit auto&& statePrep) __qpu__ {
+        cudaq::qarray<10> q;
+        statePrep(q[0]);
+        ...
+      }
+    };
+
+This approach enables the development of generic libraries of quantum 
+algorithms that are parameterized on sub-units of the global circuit representation. 
diff --git a/pr-2241/_sources/specification/cudaq/machine_model.rst.txt b/pr-2241/_sources/specification/cudaq/machine_model.rst.txt
new file mode 100644
index 0000000000..e2389c6dfc
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/machine_model.rst.txt
@@ -0,0 +1,59 @@
+Machine Model
+*************
+
+.. role:: raw-html(raw)
+    :format: html 
+
+:raw-html:`<a name="mm1"></a>`
+
+**[1]** CUDA-Q presumes the existence of one or more classical host processors, 
+zero or more NVIDIA graphics processing units (GPUs), and zero or more quantum processing units (QPUs). 
+
+**[2]** Each QPU is composed of a classical quantum control system (distributed FPGAs, GPUs, etc.) 
+and a register of quantum bits (qubits) whose state evolves via signals from the classical control system.
+
+**[3]** The machine model allows for three modes of quantum process parallelism: concurrent execution
+of quantum circuits on independent QPUs, dependent quantum parallelism via
+quantum message passing and inter-QPU entanglement, and QPU thread-level
+parallelism or the ability for concurrent execution of independent quantum
+circuits on a single QPU qubit connectivity fabric. 
+
+**[4]** The model assumes a
+classical memory space for the host processor which inherits the native language memory
+model semantics (e.g. C++ or Python). 
+
+**[5]** The model assumes a classical memory space for each control
+system driving the evolution of the multi-qubit state. This control system
+memory space should enable primitive arithmetic variable declarations,
+stores, and loads, as well as qubit measurement persistence and loading
+for fast-feedback and conditional circuit execution. 
+
+**[6]** The quantum memory
+space on an individual QPU is modeled as an infinite register of 
+qubits and physical connectivity constraints are hidden from the
+programmer. Note that compiler implementations of the CUDA-Q model
+are free to enable developer access to the details of the QPU
+qubit connectivity for the purpose of developing novel placement strategies. 
+
+**[7]** CUDA-Q considers general :math:`D`-level quantum information systems, e.g. qudits. Qudits
+are non-copyable, and can be allocated in chunks, via instantiation of 
+user-level quantum container types. Quantum containers come in two flavors - 
+quantum memory owning and non-owning (views). Moreover, the size of a quantum container 
+can be specified at either compile-time or dynamically at runtime. 
+As all qudits are non-copyable, qudits and containers 
+thereof can only be passed by reference. 
+
+**[8]** Each allocated qudit is unique and if  
+deallocated, is available for subsequent allocation. Deallocation occurs implicitly
+when the qudit goes out of scope. Uncomputation of qudit state should occur 
+automatically via compiler implementations of the CUDA-Q model.
+
+**[9]** The CUDA-Q model considers both remotely hosted QPU execution models as well as
+tightly-coupled quantum-classical architectures. Remotely hosted models
+support batch circuit execution where each circuit may contain simple
+quantum-classical operation integration. Tightly-coupled execution models provide
+streaming instruction execution, measure-reset, and fast-feedback of
+qubit measurement results. This multi-modal execution model directly
+influences the syntax and semantics of quantum kernel expressions
+and their associated host-code context. 
+
diff --git a/pr-2241/_sources/specification/cudaq/namespace.rst.txt b/pr-2241/_sources/specification/cudaq/namespace.rst.txt
new file mode 100644
index 0000000000..f20c0c8b94
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/namespace.rst.txt
@@ -0,0 +1,11 @@
+Namespace and Standard
+**********************
+
+**[1]** The CUDA-Q language is a library-based extension for C++. As such, all
+pertinent data structures and library functions exist within the CUDA-Q
+namespace. This namespace is denoted :code:`::cudaq`. 
+
+**[2]** CUDA-Q is a C++ library-based language extension adherent to the `C++20 <https://en.cppreference.com/w/cpp/20>`_
+language specification. Any implementations that require backwards compatibility to previous 
+standards must retain the semantics of the user-facing API (e.g. `SFINAE <https://en.cppreference.com/w/cpp/language/sfinae>`_ 
+instead of `concepts and constraints <https://en.cppreference.com/w/cpp/language/constraints>`_).
\ No newline at end of file
diff --git a/pr-2241/_sources/specification/cudaq/operations.rst.txt b/pr-2241/_sources/specification/cudaq/operations.rst.txt
new file mode 100644
index 0000000000..09497945f3
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/operations.rst.txt
@@ -0,0 +1,127 @@
+Quantum Intrinsic Operations
+****************************
+**[1]** To support low-level quantum programming and build foundational
+quantum kernels for large-scale applications, CUDA-Q specifies the *quantum
+intrinsic operation* abstraction for device-specific single-qudit unitary operations. 
+
+**[2]** A quantum intrinsic operation is modeled via a standard free function in the native classical language. It 
+has a unique instruction name and general specified function operands. 
+
+**[3]** These operands can model classical rotation parameters or units of quantum information (e.g. the :code:`cudaq::qudit`).
+The syntax for these operations is 
+
+.. code-block:: cpp 
+
+    void INST_NAME( PARAM...?, cudaq::qudit<N>&...);
+
+where :code:`INST_NAME` is the name of the instruction, :code:`qudit<N>&...` indicates one many
+:code:`cudaq::qudit` instances, and :code:`PARAM...?` indicates optional parameters of 
+floating point type (e.g. :code:`double`, :code:`float`). Quantum intrinsic operations return :code:`void`.
+
+**[4]** All intrinsic operations should start with a base declaration targeting a single :code:`cudaq::qudit`, and overloads
+should be provided that take more than one :code:`cudaq::qudit` instances to model the application
+of that instruction on all provided :code:`cudaq::qudits`, e.g. :code:`void x(cudaq::qubit&)` and
+:code:`x(cudaq::qubit&, cudaq::qubit&, cudaq::qubit&)`, modeling the NOT operation on a single 
+:code:`cudaq::qubit` or on multiple :code:`cudaq::qubit`. 
+
+**[5]** The specific set of quantum intrinsic operations available to the programmer can 
+be platform specific and provided via platform specific header files. 
+
+**[6]** Implementations should provide overloads to support broadcasting of single-qubit
+intrinsic operations across containers of :code:`cudaq::qudit`. For example,
+:code:`x(cudaq::qvector<>&)` should apply a NOT operation on all
+:code:`cudaq::qubit` in the provided :code:`cudaq::qvector`. 
+
+**[7]** Programmers can further modify quantum intrinsic operations via 
+an extra specified template parameter, and CUDA-Q leverages this syntax 
+for synthesizing control and adjoint variants of the operation. Specifically CUDA-Q 
+provides the `cudaq::ctrl`, and `cudaq::adj` type modifiers for synthesizing control and 
+adjoint forms of the operation. For language bindings that do not support template 
+parameterization, implementations may rely on static method calls (e.g. :code:`x.ctrl(q, r)`)
+
+Here is an example of how one might modify an intrinsic operation for multi-control and adjoint operations.
+
+.. tab:: C++ 
+  
+  .. code-block:: cpp 
+
+    cudaq::qubit q, r, s;
+    // Apply T operation
+    t(q);
+    // Apply Tdg operation
+    t<cudaq::adj>(q);
+    // Apply control Hadamard operation
+    h<cudaq::ctrl>(q,r,s);
+    // Error, ctrl requires > 1 qubit operands
+    // h<cudaq::ctrl>(r);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    q, r, s = cudaq.qubit(), cudaq.qubit(), cudaq.qubit()
+    # Apply T operation
+    t(q)
+    # Apply Tdg operation
+    t.adj(q)
+    # Apply control Hadamard operation
+    h.ctrl(q,r,s)
+    # Error, ctrl requires > 1 qubit operands
+    # h.ctrl(r);
+
+Operations on :code:`cudaq::qubit`
+----------------------------------
+The default set of quantum intrinsic operations for the cudaq::qubit type is as follows: 
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      struct base;
+      struct ctrl;
+      struct adj;
+  
+      // Single qubit operations, ctrl / adj variants, and broadcasting
+      template<typename mod = base, typename... QubitArgs>
+      void NAME(QubitArgs&... args) noexcept { ... }
+  
+      template<typename mod = base>
+      void NAME(const qvector& qr) noexcept { ... }
+  
+      template<typename mod = ctrl>
+      void NAME(qvector& ctrls, qubit& target) noexcept { ... }
+ 
+      // Single qubit rotation operations and ctrl / adj variants
+      template <typename mod = base, typename ScalarAngle, typename... QubitArgs> 
+      void ROTATION_NAME(ScalarAngle angle, QubitArgs &...args) noexcept { ... }
+ 
+      bool MEASURE_OP(qubit &q) noexcept;
+      std::vector<bool> MEASURE_OP(qvector &q) noexcept;
+      double measure(cudaq::spin_op & term) noexcept { ... }
+  }
+
+**[1]** For the default implementation of the :code:`cudaq::qubit` intrinsic operations, we let 
+NAME be any operation name in the set :code:`{h, x, y, z, t, s}` and :code:`ROTATION_NAME` be any 
+operation in :code:`{rx, ry, rz, r1 (phase)}`. Implementations may provide appropriate 
+function implementations using the above foundational functions to enable other 
+common operations (e.g. :code:`cnot -> x<cudaq::ctrl>`).
+
+**[2]** Control qubits can be specified with positive or negative polarity. 
+By this we mean that a control qubit can specify that a target operation is 
+applied if the control qubit state is a :code:`|0>` (positive polarity) or :code:`|1>` (negative polarity). 
+By default all control qubits are assumed to convey positive polarity. The 
+syntax for negating the polarity is the not operator preceding the control 
+qubit 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    x<cudaq::ctrl>(!q, r);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    x.ctrl(~q, r)
+  
+The set of gates that the official CUDA-Q implementation supports can be found in the :doc:`API documentation </api/api>`.
diff --git a/pr-2241/_sources/specification/cudaq/operators.rst.txt b/pr-2241/_sources/specification/cudaq/operators.rst.txt
new file mode 100644
index 0000000000..2645b861fe
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/operators.rst.txt
@@ -0,0 +1,81 @@
+Quantum Operators
+*****************
+
+:code:`cudaq::spin_op`
+----------------------
+**[1]** CUDA-Q provides a native :code:`spin_op` data type in the :code:`cudaq` namespace for the
+expression of quantum mechanical spin operators. 
+
+**[2]** The :code:`spin_op` provides an abstraction for a general tensor product of Pauli
+spin operators, and sums thereof:
+
+.. math:: 
+
+    H = \sum_{i=0}^M P_i, P_i = \prod_{j=0}^N \sigma_j^a
+
+for :math:`a = {x,y,z}`, :math:`j` the qubit index, and :math:`N` the number of qubits.
+
+**[3]** The :code:`spin_op` exposes common C++ operator overloads for algebraic expressions. 
+
+**[4]** CUDA-Q defines convenience functions in :code:`cudaq::spin` namespace that produce
+the primitive X, Y, and Z Pauli operators on specified qubit indices
+which can subsequently be used in algebraic expressions to build up
+more complicated Pauli tensor products and their sums.
+
+.. tab:: C++ 
+
+    .. code-block:: cpp
+
+        using namespace cudaq::spin;
+        auto h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) + \
+                 .21829 * z(0) - 6.125 * z(1);
+
+.. tab:: Python
+
+    .. code-block:: python 
+
+        from cudaq import spin 
+        h = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(0) * spin.y(1) + \
+                 .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+
+**[5]** The :code:`spin_op` also provides a mechanism for the expression of circuit
+synthesis tasks within quantum kernel code. Specifically, operations
+that encode :math:`N`\ :sup:`th`\ order trotterization of exponentiated :code:`spin_op`
+rotations, e.g. :math:`U = \exp(-i H t)`, where :math:`H` is the provided :code:`spin_op`.
+
+**[6]** The :code:`spin_op` can be created within classical host code and quantum kernel
+code, and can also be passed by value to quantum kernel code from host code. 
+
+The :code:`spin_op` should take on the following structure: 
+
+.. code-block:: cpp
+
+    namespace cudaq {
+    class spin_op {
+      public:
+        spin_op();
+        spin_op(const spin_op&);
+        bool empty() const;
+        std::size_t num_qubits() const;
+        std::size_t num_terms() const;
+        std::complex<double> get_coefficient();
+        bool is_identity() const;
+        void for_each_term(std::function<void(spin_op &)> &&) const;
+        void for_each_pauli(std::function<void(pauli, std::size_t)> &&) const;
+        spin_op& operator=(const spin_op&);
+        spin_op& operator+=(const spin_op&);
+        spin_op& operator-=(const spin_op&);
+        spin_op& operator*=(const spin_op&);
+        bool operator==(const spin_op&);
+        spin_op& operator*=(const double);
+        spin_op& operator*=(const std::complex<double>)
+    };
+
+    namespace spin {
+      spin_op x(const std::size_t);
+      spin_op y(const std::size_t);
+      spin_op z(const std::size_t);
+    }
+  }
+
diff --git a/pr-2241/_sources/specification/cudaq/patterns.rst.txt b/pr-2241/_sources/specification/cudaq/patterns.rst.txt
new file mode 100644
index 0000000000..0f96c164b6
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/patterns.rst.txt
@@ -0,0 +1,50 @@
+
+Common Quantum Programming Patterns
+***********************************
+
+Compute-Action-Uncompute
+------------------------
+**[1]** CUDA-Q specifies syntax and semantics to support the compute-action-uncompute
+pattern, :math:`W = U V U \dagger` (here :math:`U` is the compute block, and :math:`V` is the action block).
+
+**[2]** Via special syntax for this pattern CUDA-Q enables compiler implementations to 
+key on circuit optimizations via programmer intent. Specifically, controlled versions of :math:`W` do not produce controlled
+operations of all instructions in :math:`U`, :math:`V`, and :math:`U \dagger`, but instead we are free to only
+control :math:`V`. 
+
+**[3]** The CUDA-Q specification requires the following syntax for this pattern:
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      // Will invoke U V U^dag
+      cudaq::compute_action (
+          [&](){ 
+            /*U_code*/ 
+          }, 
+          [&]() { 
+            /*V_code*/ 
+          } 
+      ); 
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    def computeF():
+       ... 
+    
+    def actionF():
+       ...
+
+    # Can take user-defined functions
+    cudaq.compute_action(computeF, actionF)
+
+    # Can take Pythonic CUDA-Q lambda kernels
+    computeL = lambda : (h(q), x(q), ry(-np.pi, q[0]))
+    cudaq.compute_action(computeL, actionF)
+
+
+**[4]** Compiler implementations must add the uncompute segment
+and optimize on any controlled versions of this block of code. 
\ No newline at end of file
diff --git a/pr-2241/_sources/specification/cudaq/platform.rst.txt b/pr-2241/_sources/specification/cudaq/platform.rst.txt
new file mode 100644
index 0000000000..fc44e7f12f
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/platform.rst.txt
@@ -0,0 +1,54 @@
+
+Quantum Platform
+****************
+
+**[1]** CUDA-Q provides an abstraction describing the underlying quantum computing resource(s). 
+The underlying quantum platform can contain one or many quantum processing units (QPUs) each with 
+its own qubit connectivity and noise configuration.
+
+**[2]** CUDA-Q defines a :code:`cudaq::quantum_platform` in an effort to expose relevant system 
+information and enable asynchronous quantum kernel invocations.
+
+**[3]** The :code:`cudaq::quantum_platform` provides an API for querying the number of available 
+quantum processing units (QPUs), with each QPU assigned a logical integer index (:code:`{0,1,2,...}`). 
+
+**[4]** Programmers can specify the ID of the desired QPU and all subsequent CUDA-Q 
+kernel executions will target that QPU.
+
+The :code:`cudaq::quantum_platform`  should take the following structure
+
+.. code-block:: cpp
+
+  namespace cudaq {
+    class quantum_platform {
+    public:
+      quantum_platform();
+      ~quantum_platform();
+ 
+      using QubitEdge = std::pair<std::size_t, std::size_t>;
+      using QubitConnectivity = std::vector<QubitEdge>;
+      std::optional<QubitConnectivity> connectivity();
+
+      std::size_t num_qpus() const;
+      std::size_t get_num_qubits(std::size_t qpu_id = 0) const;
+ 
+      bool is_simulator(std::size_t qpu_id = 0) const;
+      bool is_remote(std::size_t qpuId = 0);
+      bool is_emulated(std::size_t qpuId = 0) const;
+      std::string name() const;
+ 
+      std::size_t get_current_qpu() const ;
+      void set_current_qpu(const std::size_t device_id);
+
+    };
+  }
+
+CUDA-Q provides the following public functions to interact with the current
+:code:`cudaq::quantum_platform`
+
+.. code-block:: cpp
+
+  namespace cudaq {
+    quantum_platform &get_platform() ;
+  }
+
diff --git a/pr-2241/_sources/specification/cudaq/synthesis.rst.txt b/pr-2241/_sources/specification/cudaq/synthesis.rst.txt
new file mode 100644
index 0000000000..038151ab8d
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/synthesis.rst.txt
@@ -0,0 +1,106 @@
+Sub-circuit Synthesis
+*********************
+**[1]** Execution of pure device quantum kernels can be modified via explicit intrinsic
+library calls that provide multi-qubit controlled application and adjoint,
+or circuit reversal, semantics. 
+
+**[2]** CUDA-Q defines the following library functions
+for enabling multi-controlled and adjoint operations on a general pure
+device kernel:
+
+.. code-block:: cpp
+
+    template <typename QuantumKernel, typename... Args>
+    void control(QuantumKernel &&kernel,
+                 cudaq::qubit& ctrl_qubit, Args &... args);
+ 
+    template <typename QuantumKernel, typename QuantumRegister, typename... Args>
+      requires(std::ranges::range<QuantumRegister>)
+    void control(QuantumKernel &&kernel,
+                 QuantumRegister& ctrl_qubits, Args &... args);
+ 
+    template <typename QuantumKernel, typename... Args>
+    void adjoint(QuantumKernel &&kernel, Args &... args);
+
+These functions can be leveraged in quantum kernel code in the following way
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      __qpu__ void x_gate(cudaq::qubit& q) { x(q); }
+      
+      struct kernel {
+        void operator() () __qpu__ {
+          cudaq::qarray<3> q;
+          ...
+          // Create Toffoli gate
+          auto ctrl_bits = q.front(2);
+          cudaq::control(x_gate, ctrl_bits, q[2]);
+          ...
+        }
+      };
+      
+      void rx_and_h_gate(double x, cudaq::qubit& q) __qpu__ { rx(x,q); h(q); }
+      
+      __qpu__ kernel(int N) {
+        cudaq::qvector q(N);
+        ...
+        // apply h(q[2]); rx(-pi, q[2]);
+        cudaq::adjoint(rx_and_h_gate{}, M_PI, q[2]);
+        ...
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def x_gate(q : cudaq.qubit):
+        x(q)
+    
+    @cudaq.kernel()
+    def kernelTestControl():
+        q = cudaq.qvector(3)
+        ...
+        ctrl_bits = q.front(2)
+        cudaq.control(x_gate, ctrl_bits, q[2])
+        ...
+    
+    @cudaq.kernel()
+    def rx_and_h_gate(x : float, q : cudaq.qubit):
+        rx(x, q)
+        h(q)
+    
+    @cudaq.kernel()
+    def kernelTestAdjoint(N : int):
+        q = cudaq.qvector(N)
+        ...
+        # apply h(q[2]); rx(-pi, q[2])
+        cudaq.adjoint(rx_and_h_gate, np.pi, q[2])
+        ...
+
+
+**[3]** The :code:`cudaq::control(...)` function takes as input an instantiated pure
+device quantum kernel, a std::range of control qubits (:code:`cudaq::qvector`
+or :code:`cudaq::qview`), and the remaining arguments for the kernel itself.
+
+**[4]** Compiler implementations are free to synthesize multi-controlled operations
+using any pertinent synthesis strategy available. Qubits may be aggregated into
+a range of control qubits with or without the use of the :code:`operator!`
+:doc:`negated polarity operator <operations>`.
+
+.. tab:: C++ 
+  
+  .. code-block:: cpp
+
+      cudaq::control(kernel{}, {qubit0, !qubit1}, kernel_arg);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    cudaq.control(kernel, [qubit0, ~qubit1], kernel_arg)
+  
+**[5]** The :code:`cudaq::adjoint(...)` function takes as input an
+pure device quantum kernel and the remaining arguments for the kernel.
diff --git a/pr-2241/_sources/specification/cudaq/types.rst.txt b/pr-2241/_sources/specification/cudaq/types.rst.txt
new file mode 100644
index 0000000000..2a61b8576c
--- /dev/null
+++ b/pr-2241/_sources/specification/cudaq/types.rst.txt
@@ -0,0 +1,451 @@
+Quantum Types
+*************
+The CUDA-Q language extension provides certain fundamental types that are pertinent
+to quantum-classical computing. These types are provided via defined classical library
+types in C++ in the :code:`cudaq` namespace. 
+
+:code:`cudaq::qudit<Levels>`
+----------------------------
+**[1]** The :code:`cudaq::qudit` models a :math:`D`-level unit of quantum information. The state of
+this system (for :math:`N` qudits) can be described by a :math:`D`\ :sup:`N`\-dimensional vector in
+Hilbert space with the absolute square of all elements summing to 1. 
+
+**[2]** The :code:`cudaq::qudit` encapsulates a unique :code:`std::size_t` modeling the index of the
+qudit in the underlying quantum memory space (assuming an infinite register
+of available qudits). 
+
+**[4]** To adhere to the no-cloning theorem of quantum mechanics,
+the :code:`cudaq::qudit` is non-copyable and non-movable. Therefore, all :code:`cudaq::qudit` 
+instances must be passed by reference, and the no-cloning theorem is satisfied
+at compile-time. 
+
+**[5]** :code:`cudaq::qudit` instances can only be allocated within CUDA-Q quantum
+kernel code and can never be allocated from classical host code.
+
+**[6]** All instantiated :code:`cudaq::qudit` instances start in the :code:`|0>` computational basis 
+state and serve as the primary input argument for quantum intrinsic operations 
+modeling typical logical quantum gate operations.
+
+**[7]** :code:`cudaq::qudit` instances can be negated when leveraged as controls in 
+quantum operation invocations. The mechanism for negation should be via overloading of :code:`qudit<N>::operator!()`.
+
+The :code:`cudaq::qudit` takes on the following structure
+
+.. code-block:: cpp
+
+    template <std::size_t Levels>
+    class qudit {
+      protected: 
+        const std::size_t idx = 0;
+      public:
+        qudit();
+        qudit(const qudit&) = delete;
+        qudit(qudit &&) = delete;
+        std::size_t id() const;
+        static constexpr std::size_t n_levels();
+        qudit<Levels> &operator!(); 
+    };
+
+:code:`cudaq::qubit`
+--------------------
+**[1]** The specification provides a primitive :code:`cudaq::qubit` type which models a
+single quantum bit (:math:`2`-level) in the discrete quantum memory space.
+:code:`cudaq::qubit` is an alias for :code:`cudaq::qudit<2>` 
+
+.. code-block:: cpp
+    
+    namespace cudaq {
+      using qubit = qudit<2>;
+    }
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      {
+        // Allocate a qubit in the |0> state
+        cudaq::qubit q;
+        // Put the qubit in a superposition of |0> and |1>
+        h(q); // cudaq::h == hadamard, ADL leveraged
+        printf("ID = %lu\n", q.id()); // prints 0
+        cudaq::qubit r;
+        printf("ID = %lu\n", r.id()); // prints 1
+        // qubit out of scope, implicit deallocation
+      }
+      cudaq::qubit q;
+      printf("ID = %lu\n", q.id()); // prints 0 (previous deallocated)
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    # Allocate a qubit in the |0> state
+    q = cudaq.qubit()
+    # Put the qubit in a superposition of |0> and |1>
+    h(q)
+    print("ID = {}".format(q.id())) # prints 0
+    
+    r = cudaq.qubit()
+    print("ID = {}", r.id()) # prints 1
+    # qubits go out of scope, implicit deallocation
+    
+Quantum Containers
+------------------
+**[1]** CUDA-Q specifies abstractions for dealing with groups of :code:`cudaq::qudit` instances in the
+form of familiar C++ containers. 
+
+**[2]** The underlying connectivity of the :code:`cudaq::qudit` instances stored in these containers is opaque to
+the programmer and any logical-to-physical program connectivity mapping should be done by compiler implementations. 
+
+:code:`cudaq::qview<Levels = 2>`
+++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qview<N>` is a non-owning reference to a subset of the discrete quantum memory space, 
+and as such, it is a :code:`std::span`-like C++ range of :code:`cudaq::qudit`.
+
+**[2]** The :code:`cudaq::qview` does not own its elements and can therefore be passed by value or reference. 
+
+**[3]** The :code:`cudaq::qview` is templated on the dimensionality of the contained quantum information unit, 
+and defaults to :math:`2` for qubit systems.
+
+**[4]** The :code:`cudaq::qview` provides an API for individual qubit extraction and sub-register slicing. 
+Programmers can extract the front :math:`N` :code:`qudits`, the back :math:`N` :code:`qudits`, and the 
+inner slice starting at a given index and including user-specified :code:`count` :code:`qudits`.
+
+The :code:`cudaq::qview` should take on the following structure:
+
+.. code-block:: cpp
+    
+    namespace cudaq { 
+      template <std::size_t Levels = 2>
+      class qview {
+        private:
+          std::span<qudit<Levels>> qudits;
+        public:
+          // Construct a span that refers to the qudits in `other`.
+          template <typename R>
+          requires(std::ranges::range<R>)
+          qview(R&& other);
+          qview(const qview& other);
+
+          // Iterator interface.
+          auto begin();
+          auto end();
+
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+
+          // Returns the `[0, count)` qudits.
+          qview<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qview<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+
+
+          // Returns the `[start, start+count)` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+      };
+    }
+
+:code:`cudaq::qvector<Levels = 2>`
+++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qvector<Levels>` is a container of elements from the discrete quantum memory space - a C++ container of :code:`cuda::qudit`.  
+
+**[2]** The :code:`cudaq::qvector` is a dynamically constructed owning container for :code:`cuda::qudit` (:code:`std::vector`-like), 
+and since it owns the quantum memory, it cannot be copied or moved. 
+
+**[3]** The :code:`cudaq::qvector` is templated on the dimensionality of the contained 
+quantum information unit, and defaults to :math:`2` for qubit systems.
+
+**[4]** The :code:`cudaq::qvector` can only be instantiated within CUDA-Q kernels
+
+**[5]** All qudits in the :code:`cudaq::qvector` start in the :code:`|0>` computational basis state. 
+
+**[6]** The :code:`cudaq::qvector` provides an API for individual qubit extraction and sub-register slicing. 
+Programmers can extract the front :math:`N` :code:`qudits`, the back :math:`N` :code:`qudits`, and the 
+inner slice starting at a given index and including user-specified :code:`count` :code:`qudits`.
+
+The :code:`cudaq::qview` should take on the following structure:
+
+.. code-block:: cpp
+    
+    namespace cudaq { 
+      template <std::size_t Levels = 2>
+      class qvector {
+        private:
+          std::vector<qudit<Levels>> qudits;
+
+        public:
+          // Construct a qreg with `size` qudits in the |0> state.
+          qvector(std::size_t size);
+          qvector(const qvector&) = delete;
+
+          // Iterator interface.
+          auto begin();
+          auto end();
+
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+
+          // Returns the `[0, count)` qudits.
+          qview<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qview<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+ 
+          // Returns the `[start, start+count)` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the `{start, start + stride, ...}` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t stride, std::size_t end);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+
+          // Destroys all contained qudits. Postcondition: `size() == 0`.
+          void clear();
+      };
+    }
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    // Allocate 20 qubits, std::vector-like semantics
+    cudaq::qvector q(20);
+    // Get first qubit
+    auto first = q.front();
+    // Get first 5 qubits
+    auto first_5 = q.front(5);
+    // Get last qubit 
+    auto last = q.back();
+    // Can loop over qubits with size() method
+    for (int i = 0; i < q.size(); i++) {
+      ... do something with q[i] ...
+    }
+    // Range based for loop supported 
+    for (auto & qb : q) {
+      ... do something with qb ...
+    }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    # Allocate 20 qubits, vector-like semantics
+    q = cudaq.qvector(20)
+    # Get the first qubit 
+    first = q.front()
+    # Get the first 5 qubits 
+    first_5 = q.front(5)
+    # Get the last qubit 
+    last = q.back()
+    # Can loop over qubits with size or len function 
+    for i in range(len(q)):
+      .. do something with q[i] ..
+    # Range based for loop 
+    for qb in q:
+      .. do something with qb .. 
+
+
+:code:`cudaq::qarray<N, Levels = 2>`
+++++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qarray<N, Levels>` (where :code:`N` is an integral constant) is a statically 
+allocated container (:code:`std::array`-like). The utility of this type is in the compile-time 
+knowledge of allocated containers of qudits that may directly enable ahead-of-time quantum 
+optimization and synthesis. 
+
+**[2]** The second template parameter defaults to :math:`2`-level :code:`cudaq::qudit`.
+
+**[3]** The :code:`cudaq::qarray` owns the quantum memory it contains, and therefore cannot be copied or moved.
+
+**[4]** The :code:`cudaq::qarray` can only be instantiated within CUDA-Q kernels
+
+**[5]** All qudits in the :code:`cudaq::qarray` start in the :code:`|0>` computational basis state. 
+
+**[6]** The :code:`cudaq::qarray` provides an API for individual qubit extraction and sub-register slicing. 
+Programmers can extract the front :math:`N` :code:`qudits`, the back :math:`N` :code:`qudits`, and the 
+inner slice starting at a given index and including user-specified :code:`count` :code:`qudits`.
+
+The :code:`cudaq::qarray` should take on the following structure:
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      template <std::size_t N, std::size_t Levels = 2>
+      class qarray {
+        private:
+          std::array<qudit<Levels>, N> qudits;
+
+        public:
+          // Construct a qreg with `size` qudits in the |0> state.
+          qarray();
+          qarray(const qvector&) = delete;
+          qarray(qarray &&) = delete;
+
+          qarray& operator=(const qarray &) = delete;
+
+          // Iterator interface.
+          auto begin();
+          auto end();
+
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+
+          // Returns the `[0, count)` qudits.
+          qview<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qview<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+
+          // Returns the `[start, start+count)` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the `{start, start + stride, ...}` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t stride, std::size_t end);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+
+          // Destroys all contained qudits. Postcondition: `size() == 0`.
+          void clear();
+      };
+    }
+
+:code:`cudaq::qspan<N, Levels>` (Deprecated. Use :code:`cudaq::qview<Levels>` instead.)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qspan` is a non-owning reference to a part of the discrete quantum
+memory space, a :code:`std::span`-like C++ range of :code:`cudaq::qudit` 
+(see C++ `span <https://en.cppreference.com/w/cpp/container/span>`_). It does not
+own its elements. It takes a single template parameter indicating the levels for 
+the underlying qudits that it stores. This parameter defaults to 2 for qubits. 
+It takes on the following structure:
+
+.. code-block:: cpp
+    
+    namespace cudaq {
+      template <std::size_t Levels = 2>
+      class qspan {
+        private:
+          std::span<qudit<Levels>> qubits;
+        public:
+          // Construct a span that refers to the qudits in `other`.
+          qspan(std::ranges::range<qudit<Levels>> auto& other);
+          qspan(qspan const& other);
+ 
+          // Iterator interface.
+          auto begin();
+          auto end();
+ 
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+ 
+          // Returns the `[0, count)` qudits.
+          qspan<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qspan<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+ 
+          // Returns the `[start, start+count)` qudits.
+          qspan<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+      };
+    }
+
+:code:`cudaq::qreg<N, Levels>` (Deprecated. Use :code:`cudaq::qvector<Levels>` instead.)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qreg<N, Levels>` models a register of the discrete quantum memory space - a
+C++ container of :code:`cudaq::qudit`.  As a container, it owns its elements and
+their storage. :code:`qreg<dyn, Levels>` is a dynamically allocated container
+(:code:`std::vector`-like, see C++ `vector <https://en.cppreference.com/w/cpp/container/vector>`_).
+:code:`cudaq::qreg<N, Levels>` (where N is an integral
+constant) is a statically allocated container (:code:`std::array`-like, 
+see `array <https://en.cppreference.com/w/cpp/container/array>`_). 
+Its template parameters default to dynamic allocation and :code:`cudaq::qudit<2>`.
+
+.. code-block:: cpp
+
+    namespace cudaq {
+      template <std::size_t N = dyn, std::size_t Levels = 2>
+      class qreg {
+        private:
+          std::conditional_t<
+            N == dyn,
+            std::vector<qudit<Levels>>,
+            std::array<qudit<Levels>, N>
+          > qudits;
+        public:
+          // Construct a qreg with `size` qudits in the |0> state.
+          qreg(std::size_t size) requires (N == dyn);
+          qreg(qreg const&) = delete;
+ 
+          // Iterator interface.
+          auto begin();
+          auto end();
+ 
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+ 
+          // Returns the `[0, count)` qudits.
+          qspan<dyn, Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qspan<dyn, Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+ 
+          // Returns the `[start, start+count)` qudits.
+          qspan<dyn, Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+ 
+          // Destroys all contained qudits. Postcondition: `size() == 0`.
+          void clear();
+      };
+    } 
+
+:code:`qreg` instances can only be instantiated from within quantum kernels,
+they cannot be instantiated in host code. All qubits in the :code:`qreg` 
+start in the :code:`|0>` computational basis state. 
+
+.. code-block:: cpp
+
+    // Allocate 20 qubits, std::vector-like semantics
+    cudaq::qreg q(20);
+    auto first = q.front();
+    auto first_5 = q.front(5);
+    auto last = q.back();
+    for (int i = 0; i < q.size(); i++) {
+      ... do something with q[i] ...
+    }
+    for (auto & qb : q) {
+      ... do something with qb ...
+    }
+ 
+    // std::array-like semantics
+    cudaq::qreg<5> fiveCompileTimeQubits;
\ No newline at end of file
diff --git a/pr-2241/_sources/specification/index.rst.txt b/pr-2241/_sources/specification/index.rst.txt
new file mode 100644
index 0000000000..6895a6de94
--- /dev/null
+++ b/pr-2241/_sources/specification/index.rst.txt
@@ -0,0 +1,11 @@
+*****************
+Specifications
+*****************
+
+The following specifications for the CUDA-Q programming model and toolchain are available:
+
+.. toctree::
+   :maxdepth: 2
+
+      Language Specification <cudaq.rst>
+      Quake Specification <quake-dialect>
diff --git a/pr-2241/_sources/specification/quake-dialect.md.txt b/pr-2241/_sources/specification/quake-dialect.md.txt
new file mode 100644
index 0000000000..0650f71206
--- /dev/null
+++ b/pr-2241/_sources/specification/quake-dialect.md.txt
@@ -0,0 +1,150 @@
+# Quake Dialect
+
+## General Introduction
+
+The quantum circuit model is the most widely used model of quantum
+computation.  It provides a convenient tool for formulating quantum
+algorithms and an architecture for the physical construction of quantum
+computers.
+
+A _quantum circuit_ represents a computation as a sequence of quantum
+operators applied to quantum data.  In our case, the quantum data is a set
+of quantum bits, or qubits for short.  Physically, a qubit is an object with
+only two distinguishable states, i.e., it is a two-state quantum mechanical
+system such as a spin-1/2 particle.
+
+Conceptually, a _quantum operator_ is an effect that might modify the state
+of a subset of qubits. Most often, this effect is unitary evolution---in
+this case, we say that the operator is a _unitary_.  The number of target
+qubits an operator acts upon is an intrinsic property.
+
+A _quantum instruction_ is the embodiment of a quantum operator when applied
+to a specific subset of qubits.  The number of qubits must be equal to (or
+greater than) the number of target qubits intrinsic to the operator.  If
+greater, the extra qubits are considered controls.
+
+## Motivation
+
+The main motivation behind Quake's value model is to directly expose
+quantum and classical data dependencies for optimization purposes,
+i.e., to represent the dataflow in quantum computations.  In contrast
+to Quake's memory model, which uses memory semantics (quantum
+operators act as side-effects on qubit references), the value model
+uses value semantics, that is quantum operators consume and produce
+values. These values are not truly SSA values, however, as operations
+still have side-effects on the value itself and the value cannot be
+copied.
+
+Let's see an example to clarify the distinction between the models.  Take the
+following Quake implementation of some toy quantum computation:
+
+```cpp
+func.func foo(%veq : !quake.veq<2>) {
+    // Boilerplate to extract each qubit from the vector
+    %c0 = arith.constant 0 : index
+    %c1 = arith.constant 1 : index
+    %q0 = quake.extract_ref %veq[%c0] : (!quake.veq<2>, index) -> !quake.ref
+    %q1 = quake.extract_ref %veq[%c1] : (!quake.veq<2>, index) -> !quake.ref
+
+    // We apply some operators to those extracted qubits
+    // ... bunch of operators using %q0 and %q1 ...
+    quake.h %q0 : (!quake.ref) -> ()
+
+    // We decide to measure the vector
+    %result = quake.mz %veq : (!quake.veq<2>) -> cc.stdvec<i1>
+
+    // And then apply another Hadamard to %q0
+    quake.h %q0 : (!quake.ref) -> ()
+    // ...
+}
+```
+
+Now imagine we want to optimize this code by removing pair of adjacent
+adjoint operators, e.g., if we have a pair Hadamard operations next to each
+other on the same qubit---visually:
+
+```text
+    ┌───┐ ┌───┐         ┌───┐
+   ─┤ H ├─┤ H ├─  =  ───┤ I ├───  =  ─────────────
+    └───┘ └───┘         └───┘
+```
+
+Where `I` is the identity operator. Now note that a naive implementation of
+this optimization for Quake would optimize away both `quake.h` operators
+being applied to `%q0`.  Such an implementation would have missed the fact
+that a measurement is being applied to the vector, `%veq`, which contains
+`%q0`.
+
+Of course it is possible to correctly implement this optimization for Quake.
+However such an implementation would be quite error-prone and require
+complex analyses.  For this reason, Quake has overloaded gates.
+
+In the value model operators consume values and return new values:
+
+```text
+  %q0_1 = quake.op %q0_0 : (!quake.wire) -> !quake.wire
+```
+
+We can visualize the difference between memory and value representation as:
+
+```text
+            Memory                                   Value
+
+        ┌──┐ ┌──┐     ┌──┐                  ┌──┐ %q0_1 ┌──┐     ┌──┐
+   %q0 ─┤  ├─┤  ├─···─┤  ├─ %q0  vs  %q0_0 ─┤  ├───────┤  ├─···─┤  ├─ %q0_Z
+        └──┘ └──┘     └──┘                  └──┘       └──┘     └──┘
+```
+
+If we look at the implementation again, we notice that the problem
+with the naive optimization happens because the Hadamard operators are
+implicitly connected by the same value `%q0`. In value form, all the gates
+are explicitly connected by distinct values, which eliminates the need
+to do further analysis via implicit side-effects.
+The following is the implementation in value form.
+
+```text
+func.func @foo(%array : !quake.qvec<2>) {
+    // Boilerplate to extract each qubit
+    %c0 = arith.constant 0 : index
+    %c1 = arith.constant 1 : index
+    %r0 = quake.extract_ref %array[%c0] : (!quake.qvec<2>, index) -> !quake.qref
+    %r1 = quake.extract_ref %array[%c1] : (!quake.qvec<2>, index) -> !quake.qref
+
+    // Unwrap the quantum references to expose the wires.
+    %q0 = quake.unwrap %r0 : (!quake.qref) -> !quake.wire
+    %q1 = quake.unwrap %r1 : (!quake.qref) -> !quake.wire
+
+    // Misc. operators applied
+    %q0_M = quake.h %q0_L : (!quake.wire) -> !quake.wire
+
+    // Re-wrap the wire to its original source
+    quake.wrap %q0_M to %r0 : !quake.wire, !quake.qref
+    quake.wrap %q1_X to %r1 : !quake.wire, !quake.qref
+
+    // Measure the entire vector of quantum references
+    %result = quake.mz %array : (!quake.qvec<2>) -> !cc.stdvec<i1>
+
+    // Unwrap the wire for qubit 0 again
+    %q0_P = quake.unwrap %r0 : (!quake.qref) -> !quake.wire
+    ...
+    %q0_Z = quake.h %q0_Y : (!quake.wire) -> !quake.wire
+    // Re-wrap the wire back to the original reference
+    quake.wrap %q0_Z to %r0 : !quake.wire, !quake.qref
+    return
+}
+```
+
+In this code we can more straightforwardly see that the Hadamard
+operators cannot cancel each other.  One way of reasoning about this
+is as follows: In value form we need to follow a chain of values to
+know the qubit operators are being applied to, in this example:
+
+```text
+Mmeory                          Value
+    %q0         [%q0_0, %q0_1 ... %q0_L, %q0_M; %q0_P ... %q0_Y, %q0_Z]
+
+```
+
+We know that one Hadamard is applied to `%q0_L` and generates `%q0_M`, and
+the other is applied `%q0_Y` and generates `%q0_Z`.  Hence, there is no
+connection between them---which means they cannot cancel each other out.
diff --git a/pr-2241/_sources/using/backends/backends.rst.txt b/pr-2241/_sources/using/backends/backends.rst.txt
new file mode 100644
index 0000000000..56b628e8fd
--- /dev/null
+++ b/pr-2241/_sources/using/backends/backends.rst.txt
@@ -0,0 +1,36 @@
+CUDA-Q Backends
+**********************
+
+.. toctree::
+   :caption: Backend Targets
+   :maxdepth: 1
+
+      Simulation <simulators.rst>
+      Quantum Hardware <hardware.rst>
+      NVIDIA Quantum Cloud <nvqc.rst>
+      Multi-Processor Platforms <platform.rst>
+
+**The following is a comprehensive list of the available targets in CUDA-Q:**
+
+* :ref:`density-matrix-cpu <default-simulator>`
+* :ref:`ionq <ionq-backend>`
+* :ref:`iqm <iqm-backend>`
+* :ref:`nvidia <nvidia-backend>`
+* :ref:`nvidia-fp64 <nvidia-fp64-backend>`
+* :ref:`nvidia-mgpu <nvidia-mgpu-backend>`
+* :ref:`nvidia-mqpu <mqpu-platform>`
+* :ref:`nvidia-mqpu-fp64 <mqpu-platform>`
+* :doc:`nvqc <nvqc>`
+* :ref:`oqc <oqc-backend>`
+* :ref:`orca <orca-backend>`
+* :ref:`qpp-cpu <qpp-cpu-backend>`
+* :ref:`quantinuum <quantinuum-backend>`
+* :ref:`remote-mqpu <mqpu-platform>`
+* :ref:`stim <stim-backend>`
+* :ref:`tensornet <tensor-backends>`
+* :ref:`tensornet-mps <tensor-backends>`
+
+.. deprecated:: 0.8
+   The `nvidia-fp64`, `nvidia-mgpu`, `nvidia-mqpu`, and `nvidia-mqpu-fp64` targets can be 
+   enabled as extensions of the unified `nvidia` target (see `nvidia` :ref:`target documentation <nvidia-backend>`).
+   These target names might be removed in a future release.
\ No newline at end of file
diff --git a/pr-2241/_sources/using/backends/hardware.rst.txt b/pr-2241/_sources/using/backends/hardware.rst.txt
new file mode 100644
index 0000000000..203e0268b1
--- /dev/null
+++ b/pr-2241/_sources/using/backends/hardware.rst.txt
@@ -0,0 +1,482 @@
+CUDA-Q Hardware Backends
+*********************************
+
+CUDA-Q supports submission to a set of hardware providers. 
+To submit to a hardware backend, you need an account with the respective provider.
+
+
+IonQ
+==================================
+
+.. _ionq-backend:
+
+Setting Credentials
+`````````````````````````
+
+Programmers of CUDA-Q may access the `IonQ Quantum Cloud
+<https://cloud.ionq.com/>`__ from either C++ or Python. Generate
+an API key from your `IonQ account <https://cloud.ionq.com/>`__ and export
+it as an environment variable:
+
+.. code:: bash
+
+  export IONQ_API_KEY="ionq_generated_api_key"
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution in the IonQ Cloud,
+pass the flag ``--target ionq`` to the ``nvq++`` compiler.
+
+.. code:: bash
+
+    nvq++ --target ionq src.cpp
+
+This will take the API key and handle all authentication with, and submission to,
+the IonQ QPU(s). By default, quantum kernel code will be submitted to the IonQ
+simulator.
+
+.. note:: 
+
+    A "target" in :code:`cudaq` refers to a quantum compute provider, such as :code:`ionq`.
+    However, IonQ's documentation uses the term "target" to refer to specific QPU's themselves.
+
+To execute your kernels on a QPU, pass the ``--ionq-machine`` flag to the ``nvq++`` compiler
+to specify which machine to submit quantum kernels to:
+
+.. code:: bash
+
+    nvq++ --target ionq --ionq-machine qpu.aria-1 src.cpp ...
+
+where ``qpu.aria-1`` is an example of a physical QPU.
+
+A list of available QPUs can be found `in the API documentation
+<https://docs.ionq.com/#tag/jobs>`__. To see which backends are available 
+with your subscription login to your `IonQ account <https://cloud.ionq.com/jobs>`__.
+
+To emulate the IonQ machine locally, without submitting through the cloud,
+you can also pass the ``--emulate`` flag to ``nvq++``. This will emit any target 
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target ionq src.cpp
+
+To see a complete example for using IonQ's backends, take a look at our :doc:`C++ examples <../examples/examples>`.
+
+Submission from Python
+`````````````````````````
+
+The target to which quantum kernels are submitted 
+can be controlled with the ``cudaq::set_target()`` function.
+
+.. code:: python
+
+    cudaq.set_target('ionq')
+
+By default, quantum kernel code will be submitted to the IonQ
+simulator.
+
+.. note:: 
+
+    A "target" in :code:`cudaq` refers to a quantum compute provider, such as :code:`ionq`.
+    However, IonQ's documentation uses the term "target" to refer to specific QPU's themselves.
+
+To specify which IonQ QPU to use, set the :code:`qpu` parameter.
+
+.. code:: python
+
+    cudaq.set_target("ionq", qpu="qpu.aria-1")
+
+where ``qpu.aria-1`` is an example of a physical QPU.
+
+A list of available QPUs can be found `in the API documentation
+<https://docs.ionq.com/#tag/jobs>`__. To see which backends are available 
+with your subscription login to your `IonQ account <https://cloud.ionq.com/jobs>`__.
+
+To emulate the IonQ machine locally, without submitting through the cloud,
+you can also set the ``emulate`` flag to ``True``. This will emit any target 
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: python
+
+    cudaq.set_target('ionq', emulate=True)
+
+The number of shots for a kernel execution can be set through
+the ``shots_count`` argument to ``cudaq.sample`` or ``cudaq.observe``. By default,
+the ``shots_count`` is set to 1000.
+
+.. code:: python
+
+    cudaq.sample(kernel, shots_count=10000)
+
+To see a complete example for using IonQ's backends, take a look at our :doc:`Python examples <../examples/examples>`.
+
+
+IQM
+==================================
+
+.. _iqm-backend:
+
+Support for submissions to IQM is currently under development. 
+In particular, two-qubit gates can only be performed on adjacent qubits. For more information, we refer to the respective hardware documentation.
+Support for automatically injecting the necessary operations during compilation to execute arbitrary multi-qubit gates will be added in future versions.
+
+Setting Credentials
+`````````````````````````
+
+Programmers of CUDA-Q may access the IQM Server from either C++ or Python. Following the `quick start guide <https://iqm-finland.github.io/cortex-cli/readme.html#using-cortex-cli>`__, install `iqm-cortex-cli` and login to initialize the tokens file.
+The path to the tokens file can either be passed explicitly via an environment variable or it will be loaded automatically if located in
+the default location :code:`~/.cache/iqm-cortex-cli/tokens.json`.
+
+.. code:: bash
+
+    export IQM_TOKENS_FILE="path/to/tokens.json"
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution on an IQM Server,
+pass the ``--target iqm`` flag to the ``nvq++`` compiler, along with a specified ``--iqm-machine``.
+
+.. note::
+    The ``--iqm-machine`` is  a mandatory argument. This provided architecture must match
+    the device architecture that the program has been compiled against. The hardware architecture for a
+    specific IQM Server may be checked  via `https://<IQM server>/cocos/quantum-architecture`.
+
+.. code:: bash
+
+    nvq++ --target iqm --iqm-machine Adonis src.cpp
+
+Once the binary for a specific IQM QPU architecture is compiled, it can be executed against any IQM Server with the same QPU architecture:
+
+.. code:: bash
+
+    nvq++ --target iqm --iqm-machine Adonis src.cpp -o program
+    IQM_SERVER_URL="https://demo.qc.iqm.fi/cocos" ./program
+
+    # Executing the same program against an IQM Server with a different underlying QPU
+    # architecture will result in an error.
+    IQM_SERVER_URL="https://<Apollo IQM Server>/cocos" ./program
+
+To emulate the IQM machine locally, without submitting to the IQM Server,
+you can also pass the ``--emulate`` flag to ``nvq++``. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target iqm --iqm-machine Adonis src.cpp
+
+To see a complete example for using IQM server backends, take a look at our :doc:`C++ examples <../examples/examples>`.
+
+Submission from Python
+`````````````````````````
+
+The target to which quantum kernels are submitted
+can be controlled with the ``cudaq::set_target()`` function.
+
+.. code:: python
+
+    cudaq.set_target("iqm", url="https://<IQM Server>/cocos", **{"qpu-architecture": "Adonis"})
+
+To emulate the IQM Server locally, without submitting to the IQM Server,
+you can also set the ``emulate`` flag to ``True``. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: python
+
+    cudaq.set_target('iqm', emulate=True)
+
+The number of shots for a kernel execution can be set through
+the ``shots_count`` argument to ``cudaq.sample`` or ``cudaq.observe``. By default,
+the ``shots_count`` is set to 1000.
+
+.. code:: python
+
+    cudaq.sample(kernel, shots_count=10000)
+
+To see a complete example for using IQM server backends, take a look at our :doc:`Python examples<../examples/examples>`.
+
+OQC
+==================================
+
+.. _oqc-backend:
+
+`Oxford Quantum Circuits <https://oxfordquantumcircuits.com/>`__ (OQC) is currently providing CUDA-Q integration for multiple Quantum Processing Unit types.
+The 8 qubit ring topology Lucy device and the 32 qubit Kagome lattice topology Toshiko device are both supported via machine options described below.
+
+Setting Credentials
+`````````````````````````
+
+In order to use the OQC devices you will need to register.
+Registration is achieved by contacting oqc_qcaas_support@oxfordquantumcircuits.com
+
+Once registered you will be able to authenticate with your ``email`` and ``password``
+
+There are three environment variables that the OQC target will look for during configuration:
+
+1. ``OQC_URL``
+2. ``OQC_EMAIL``
+3. ``OQC_PASSWORD`` - is mandatory
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution on the OQC platform, provide the flag ``--target oqc`` to the ``nvq++`` compiler.
+
+Users may provide their :code:`email` and :code:`url` as extra arguments
+
+.. code:: bash
+
+    nvq++ --target oqc --oqc-email <email> --oqc-url <url> src.cpp -o executable
+
+Where both environment variables and extra arguments are supplied, precedent is given to the extra arguments.
+To run the output, provide the runtime loaded variables and invoke the pre-built executable
+
+.. code:: bash
+
+   OQC_PASSWORD=<password> ./executable
+
+To emulate the OQC device locally, without submitting through the OQC QCaaS services, you can pass the ``--emulate`` flag to ``nvq++``.
+This will emit any target specific compiler warnings and diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target oqc src.cpp -o executable
+
+
+.. note::
+
+    The oqc target supports a ``--oqc-machine`` option.
+    The default is the 8 qubit Lucy device.
+    You can set this to be either ``toshiko`` or ``lucy`` via this flag.
+
+.. note::
+
+    The OQC quantum assembly toolchain (qat) which is used to compile and execute instructions can be found on github as `oqc-community/qat <https://github.com/oqc-community/qat>`__
+
+Submission from Python
+`````````````````````````
+
+To set which OQC URL, set the :code:`url` parameter.
+To set which OQC email, set the :code:`email` parameter.
+To set which OQC machine, set the :code:`machine` parameter.
+
+.. code:: python
+
+    import os
+    import cudaq
+    # ...
+    os.environ['OQC_PASSWORD'] = password
+    cudaq.set_target("oqc", url=url, machine="lucy")
+
+You can then execute a kernel against the platform using the OQC Lucy device
+
+.. code:: python
+
+    kernel = cudaq.make_kernel()
+    qvec = kernel.qalloc(2)
+    kernel.h(qvec[0])
+    kernel.x(qvec[1])
+    kernel.cx(qvec[0], qvec[1])
+    kernel.mz(qvec)
+    str(cudaq.sample(kernel=kernel, shots_count=1000))
+
+
+ORCA Computing
+==================================
+
+.. _orca-backend:
+
+ORCA Computing's PT Series implement the boson sampling model of quantum computation, in which 
+multiple single photons are interfered with each other within a network of beam splitters, and 
+photon detectors measure where the photons leave this network. This process is implemented within 
+a time-bin interferometer (TBI) architecture where photons are created in different time-bins 
+and interfered within a network of delay lines. This can be represented by a circuit diagram, 
+like the one below, where this illustration example corresponds to 4 photons in 8 modes sent into 
+alternating time-bins in a circuit composed of two delay lines in series.
+
+.. image:: ../examples/images/orca_tbi.png
+   :width: 400px
+   :align: center
+
+
+Setting Credentials
+```````````````````
+
+Programmers of CUDA-Q may access the ORCA API from either C++ or Python. There is an environment 
+variable ``ORCA_ACCESS_URL`` that can be set so that the ORCA target can look for it during 
+configuration.
+
+.. code:: bash
+
+  export ORCA_ACCESS_URL="https://<ORCA API Server>"
+
+Submission from C++
+`````````````````````````
+
+To execute a boson sampling experiment on the ORCA platform, provide the flag 
+``--target orca`` to the ``nvq++`` compiler. You should then pass the ``--orca-url`` flag set with 
+the previously set environment variable ``$ORCA_ACCESS_URL`` or an :code:`url`.
+
+.. code:: bash
+
+    nvq++ --target orca --orca-url $ORCA_ACCESS_URL src.cpp -o executable
+
+or
+
+.. code:: bash
+
+    nvq++ --target orca --orca-url <url> src.cpp -o executable
+
+To run the output, invoke the executable
+
+.. code:: bash
+
+   ./executable
+
+
+To see a complete example for using ORCA server backends, take a look at our :doc:`C++ examples <../examples/hardware_providers>`.
+
+Submission from Python
+`````````````````````````
+
+To set which ORCA URL to be used, set the :code:`url` parameter.
+
+.. code:: python
+
+    import os
+    import cudaq
+    # ...
+    orca_url = os.getenv("ORCA_ACCESS_URL", "http://localhost/sample")
+
+    cudaq.set_target("orca", url=orca_url)
+
+
+You can then execute a time-bin boson sampling experiment against the platform using an ORCA device.
+
+.. code:: python
+
+    bs_angles = [np.pi / 3, np.pi / 6]
+    input_state = [1, 1, 1]
+    loop_lengths = [1]
+    counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles)
+
+To see a complete example for using ORCA's backends, take a look at our :doc:`Python examples <../examples/hardware_providers>`.
+
+Quantinuum
+==================================
+
+.. _quantinuum-backend:
+
+Setting Credentials
+```````````````````
+
+Programmers of CUDA-Q may access the Quantinuum API from either
+C++ or Python. Quantinuum requires a credential configuration file. 
+The configuration file can be generated as follows, replacing
+the ``email`` and ``credentials`` in the first line with your Quantinuum
+account details.
+
+.. code:: bash
+
+    # You may need to run: `apt-get update && apt-get install curl jq`
+    curl -X POST -H "Content Type: application/json" \
+        -d '{ "email":"<your_alias>@email.com","password":"<your_password>" }' \
+        https://qapi.quantinuum.com/v1/login > $HOME/credentials.json
+    id_token=`cat $HOME/credentials.json | jq -r '."id-token"'`
+    refresh_token=`cat $HOME/credentials.json | jq -r '."refresh-token"'`
+    echo "key: $id_token" >> $HOME/.quantinuum_config
+    echo "refresh: $refresh_token" >> $HOME/.quantinuum_config
+
+The path to the configuration can be specified as an environment variable:
+
+.. code:: bash
+
+    export CUDAQ_QUANTINUUM_CREDENTIALS=$HOME/.quantinuum_config
+
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution in the Quantinuum backends,
+pass the flag ``--target quantinuum`` to the ``nvq++`` compiler. CUDA-Q will 
+authenticate via the Quantinuum REST API using the credential in your configuration file.
+By default, quantum kernel code will be submitted to the Quantinuum syntax checker.
+Submission to the syntax checker merely validates the program; the kernels are not executed.
+
+.. code:: bash
+
+    nvq++ --target quantinuum src.cpp ...
+
+To execute your kernels, pass the ``--quantinuum-machine`` flag to the ``nvq++`` compiler
+to specify which machine to submit quantum kernels to:
+
+.. code:: bash
+
+    nvq++ --target quantinuum --quantinuum-machine H1-2 src.cpp ...
+
+where ``H1-2`` is an example of a physical QPU. Hardware specific
+emulators may be accessed by appending an ``E`` to the end (e.g, ``H1-2E``). For 
+access to the syntax checker for the provided machine, you may append an ``SC`` 
+to the end (e.g, ``H1-1SC``).
+
+For a comprehensive list of available machines, login to your `Quantinuum user account <https://um.qapi.quantinuum.com/user>`__ 
+and navigate to the "Account" tab, where you should find a table titled "Machines".
+
+To emulate the Quantinuum machine locally, without submitting through the cloud,
+you can also pass the ``--emulate`` flag to ``nvq++``. This will emit any target 
+specific compiler warnings and diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target quantinuum src.cpp
+
+To see a complete example for using Quantinuum's backends, take a look at our :doc:`C++ examples <../examples/examples>`.
+
+
+Submission from Python
+`````````````````````````
+
+The target to which quantum kernels are submitted 
+can be controlled with the ``cudaq::set_target()`` function.
+
+.. code:: python
+
+    cudaq.set_target('quantinuum')
+
+By default, quantum kernel code will be submitted to the Quantinuum syntax checker.
+Submission to the syntax checker merely validates the program; the kernels are not executed.
+
+To execute your kernels, specify which machine to submit quantum kernels to
+by setting the :code:`machine` parameter of the target.
+
+.. code:: python
+
+    cudaq.set_target('quantinuum', machine='H1-2')
+
+where ``H1-2`` is an example of a physical QPU. Hardware specific
+emulators may be accessed by appending an ``E`` to the end (e.g, ``H1-2E``). For 
+access to the syntax checker for the provided machine, you may append an ``SC`` 
+to the end (e.g, ``H1-1SC``).
+
+For a comprehensive list of available machines, login to your `Quantinuum user account <https://um.qapi.quantinuum.com/user>`__ 
+and navigate to the "Account" tab, where you should find a table titled "Machines".
+
+To emulate the Quantinuum machine locally, without submitting through the cloud,
+you can also set the ``emulate`` flag to ``True``. This will emit any target 
+specific compiler warnings and diagnostics, before running a noise free emulation.
+
+.. code:: python
+
+    cudaq.set_target('quantinuum', emulate=True)
+
+The number of shots for a kernel execution can be set through
+the ``shots_count`` argument to ``cudaq.sample`` or ``cudaq.observe``. By default,
+the ``shots_count`` is set to 1000.
+
+.. code:: python 
+
+    cudaq.sample(kernel, shots_count=10000)
+
+To see a complete example for using Quantinuum's backends, take a look at our :doc:`Python examples <../examples/examples>`.
\ No newline at end of file
diff --git a/pr-2241/_sources/using/backends/nvqc.rst.txt b/pr-2241/_sources/using/backends/nvqc.rst.txt
new file mode 100644
index 0000000000..05ff706697
--- /dev/null
+++ b/pr-2241/_sources/using/backends/nvqc.rst.txt
@@ -0,0 +1,256 @@
+NVIDIA Quantum Cloud
+---------------------
+NVIDIA Quantum Cloud (NVQC) offers universal access to the world’s most powerful computing platform, 
+for every quantum researcher to do their life’s work.
+To learn more about NVQC visit this `link <https://www.nvidia.com/en-us/solutions/quantum-computing/cloud>`__. 
+
+Apply for early access `here <https://developer.nvidia.com/quantum-cloud-early-access-join>`__. 
+Access to the Quantum Cloud early access program requires an NVIDIA Developer account.
+
+Quick Start
++++++++++++
+Once you have been approved for an early access to NVQC, you will be able to follow these instructions to use it.
+
+1. Follow the instructions in your NVQC Early Access welcome email to obtain an API Key for NVQC. 
+You can also find the instructions `here <https://developer.nvidia.com/quantum-cloud-early-access-members>`__ (link available only for approved users)
+
+2. Set the environment variable `NVQC_API_KEY` to the API Key obtained above.
+
+ .. code-block:: console
+
+    export NVQC_API_KEY=<your NVQC API key>
+
+You may wish to persist that environment variable between bash sessions, e.g., by adding it to your `$HOME/.bashrc` file.
+
+3. Run your first NVQC example
+
+The following is a typical CUDA-Q kernel example. 
+By selecting the `nvqc` target, the quantum circuit simulation will run on NVQC in the cloud, rather than running locally.
+
+
+.. tab:: Python
+    
+    .. literalinclude:: ../../snippets/python/using/cudaq/nvqc/nvqc_intro.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+    .. code-block:: console
+        
+        [2024-03-14 19:26:31.438] Submitting jobs to NVQC service with 1 GPU(s). Max execution time: 3600 seconds (excluding queue wait time).
+
+        ================ NVQC Device Info ================
+        GPU Device Name: "NVIDIA H100 80GB HBM3"
+        CUDA Driver Version / Runtime Version: 12.2 / 11.8
+        Total global memory (GB): 79.1
+        Memory Clock Rate (MHz): 2619.000
+        GPU Clock Rate (MHz): 1980.000
+        ==================================================
+        { 1111111111111111111111111:486 0000000000000000000000000:514 }
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/nvqc/nvqc_intro.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+
+    The code above is saved in `nvqc_intro.cpp` and compiled with the following command, targeting the :code:`nvqc` platform
+
+    .. code-block:: console
+
+        nvq++ nvqc_intro.cpp -o nvqc_intro.x --target nvqc 
+        ./nvqc_intro.x
+
+        [2024-03-14 19:25:05.545] Submitting jobs to NVQC service with 1 GPU(s). Max execution time: 3600 seconds (excluding queue wait time).
+
+        ================ NVQC Device Info ================
+        GPU Device Name: "NVIDIA H100 80GB HBM3"
+        CUDA Driver Version / Runtime Version: 12.2 / 11.8
+        Total global memory (GB): 79.1
+        Memory Clock Rate (MHz): 2619.000
+        GPU Clock Rate (MHz): 1980.000
+        ==================================================
+        { 
+        __global__ : { 1111111111111111111111111:487 0000000000000000000000000:513 }
+        result : { 1111111111111111111111111:487 0000000000000000000000000:513 }
+        }
+
+
+Simulator Backend Selection
+++++++++++++++++++++++++++++
+
+NVQC hosts all CUDA-Q simulator backends (see :doc:`simulators`). 
+You may use the NVQC `backend` (Python) or `--nvqc-backend` (C++) option to select the simulator to be used by the service.
+
+For example, to request the `tensornet` simulator backend, the user can do the following for C++ or Python.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        cudaq.set_target("nvqc", backend="tensornet")
+
+.. tab:: C++
+    
+    .. code-block:: console
+
+        nvq++ nvqc_sample.cpp -o nvqc_sample.x --target nvqc --nvqc-backend tensornet
+
+
+.. note::
+
+  By default, the single-GPU single-precision `custatevec-fp32` simulator backend will be selected if backend information is not specified.
+
+Multiple GPUs
++++++++++++++
+
+Some CUDA-Q simulator backends are capable of multi-GPU distribution as detailed in :doc:`simulators`.
+For example, the `nvidia-mgpu` backend can partition and distribute state vector simulation to multiple GPUs to simulate 
+a larger number of qubits, whose state vector size grows beyond the memory size of a single GPU.
+
+To select a specific number of GPUs on the NVQC managed service, the following `ngpus` (Python) or `--nvqc-ngpus` (C++) option can be used.
+
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        cudaq.set_target("nvqc", backend="nvidia-mgpu", ngpus=4)
+
+.. tab:: C++
+
+    .. code-block:: console
+
+        nvq++ nvqc_sample.cpp -o nvqc_sample.x --target nvqc --nvqc-backend nvidia-mgpu --nvqc-ngpus 4
+
+
+.. note::
+
+    If your NVQC subscription does not contain service instances that have the specified number of GPUs, 
+    you may encounter the following error.
+
+    .. code-block:: console
+        
+        Unable to find NVQC deployment with 16 GPUs.
+        Available deployments have {1, 2, 4, 8} GPUs.
+        Please check your `ngpus` value (Python) or `--nvqc-ngpus` value (C++).
+
+.. note::
+
+    Not all simulator backends are capable of utilizing multiple GPUs. 
+    When requesting a multiple-GPU service with a single-GPU simulator backend, 
+    you might encounter the following log message:
+
+    .. code-block:: console
+        
+        The requested backend simulator (custatevec-fp32) is not capable of using all 4 GPUs requested.
+        Only one GPU will be used for simulation.
+        Please refer to CUDA-Q documentation for a list of multi-GPU capable simulator backends.
+
+    Consider removing the `ngpus` value (Python) or `--nvqc-ngpus` value (C++) to use the default of 1 GPU 
+    if you don't need to use a multi-GPU backend to better utilize NVQC resources.
+
+    Please refer to the table below for a list of backend simulator names along with its multi-GPU capability.
+
+    .. list-table:: Simulator Backends
+        :widths: 20 50 10 10
+        :header-rows: 1
+
+        *   - Name
+            - Description
+            - GPU Accelerated 
+            - Multi-GPU 
+        *   - `qpp`
+            - CPU-only state vector simulator
+            - no
+            - no
+        *   - `dm`
+            - CPU-only density matrix simulator
+            - no
+            - no
+        *   - `custatevec-fp32`
+            - Single-precision `cuStateVec` simulator
+            - yes
+            - no
+        *   - `custatevec-fp64`
+            - Double-precision `cuStateVec` simulator
+            - yes
+            - no
+        *   - `tensornet`
+            - Double-precision `cuTensorNet` full tensor network contraction simulator
+            - yes
+            - yes
+        *   - `tensornet-mps`
+            - Double-precision `cuTensorNet` matrix-product state simulator
+            - yes
+            - no
+        *   - `nvidia-mgpu`
+            - Double-precision `cuStateVec` multi-GPU simulator
+            - yes
+            - yes
+    
+
+Multiple QPUs Asynchronous Execution
++++++++++++++++++++++++++++++++++++++
+
+NVQC provides scalable QPU virtualization services, whereby clients
+can submit asynchronous jobs simultaneously to NVQC. These jobs are
+handled by a pool of service worker instances.
+
+For example, in the following code snippet, using the `nqpus` (Python) or `--nvqc-nqpus` (C++) configuration option,
+the user instantiates 3 virtual QPU instances to submit simulation jobs to NVQC
+calculating the expectation value along with parameter-shift gradients simultaneously.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/nvqc/nvqc_mqpu.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/nvqc/nvqc_mqpu.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+
+    The code above is saved in `nvqc_vqe.cpp` and compiled with the following command, targeting the :code:`nvqc` platform with 3 virtual QPUs.
+
+    .. code-block:: console
+
+        nvq++ nvqc_vqe.cpp -o nvqc_vqe.x --target nvqc --nvqc-nqpus 3 
+        ./nvqc_vqe.x
+
+
+.. note::
+
+    The NVQC managed-service has a pool of worker instances processing incoming requests on a 
+    first-come-first-serve basis. Thus, the attainable speedup using multiple virtual QPUs vs. 
+    sequential execution on a single QPU depends on the NVQC service load. For example, 
+    if the number of free workers is greater than the number of requested virtual QPUs, a linear
+    (ideal) speedup could be achieved. On the other hand, if all the service workers are busy, 
+    multi-QPU distribution may not deliver any substantial speedup.  
+
+FAQ
+++++
+
+1. How do I get more information about my NVQC API submission?
+
+The environment variable `NVQC_LOG_LEVEL` can be used to turn on and off
+certain logs. There are three levels:
+
+- Info (`info`): basic information about NVQC is logged to the console. This is the default.
+
+- Off (`off` or `0`): disable all NVQC logging.
+
+- Trace: (`trace`): log additional information for each NVQC job execution (including timing)
+
+2. I want to persist my API key to a configuration file.
+
+You may persist your NVQC API Key to a credential configuration file in lieu of 
+using the `NVQC_API_KEY` environment variable. 
+The configuration file can be generated as follows, replacing
+the `api_key` value with your NVQC API Key.
+
+.. code:: bash
+
+    echo "key: <api_key>" >> $HOME/.nvqc_config
+
diff --git a/pr-2241/_sources/using/backends/platform.rst.txt b/pr-2241/_sources/using/backends/platform.rst.txt
new file mode 100644
index 0000000000..18753617c9
--- /dev/null
+++ b/pr-2241/_sources/using/backends/platform.rst.txt
@@ -0,0 +1,341 @@
+Multi-Processor Platforms
+---------------------------------------------------
+The CUDA-Q machine model elucidates the various devices considered in the 
+broader quantum-classical compute node context. Programmers will have one or many 
+host CPUs, zero or many NVIDIA GPUs, a classical QPU control space, and the
+quantum register itself. Moreover, the :doc:`specification </specification/cudaq/platform>`
+notes that the underlying platform may expose multiple QPUs. In the near-term,
+this will be unlikely with physical QPU instantiations, but the availability of
+GPU-based circuit simulators on NVIDIA multi-GPU architectures does give one an
+opportunity to think about programming such a multi-QPU architecture in the near-term.
+CUDA-Q starts by enabling one to query information about the underlying quantum
+platform via the :code:`quantum_platform` abstraction. This type exposes a
+:code:`num_qpus()` method that can be used to query the number of available
+QPUs for asynchronous CUDA-Q kernel and :code:`cudaq::` function invocations.
+Each available QPU is assigned a logical index, and programmers can launch
+specific asynchronous function invocations targeting a desired QPU.
+
+.. _mqpu-platform:
+
+NVIDIA `MQPU` Platform
+++++++++++++++++++++++
+
+In the multi-QPU mode (:code:`mqpu` option), the NVIDIA target provides a simulated QPU for every available NVIDIA GPU on the underlying system. 
+Each QPU is simulated via a `cuStateVec` simulator backend as defined by the NVIDIA target. For more information about using multiple GPUs 
+to simulate each virtual QPU, or using a different backend for virtual QPUs, please see :ref:`remote MQPU platform <remote-mqpu-platform>`.
+This target enables asynchronous parallel execution of quantum kernel tasks.
+
+Here is a simple example demonstrating its usage.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/sample_async.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/sample_async.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+
+    One can specify the target multi-QPU architecture with the :code:`--target` flag:
+    
+    .. code-block:: console
+
+        nvq++ sample_async.cpp --target nvidia --target-option mqpu
+        ./a.out
+
+CUDA-Q exposes asynchronous versions of the default :code:`cudaq` algorithmic
+primitive functions like :code:`sample`, :code:`observe`, and :code:`get_state` 
+(e.g., :code:`sample_async` function in the above code snippets).
+
+Depending on the number of GPUs available on the system, the :code:`nvidia` multi-QPU platform will create the same number of virtual QPU instances.
+For example, on a system with 4 GPUs, the above code will distribute the four sampling tasks among those :code:`GPUEmulatedQPU` instances.
+
+The results might look like the following 4 different random samplings:
+
+.. code-block:: console
+  
+    Number of QPUs: 4
+    { 10011:28 01100:28 ... }
+    { 10011:37 01100:25 ... }
+    { 10011:29 01100:25 ... }
+    { 10011:33 01100:30 ... }
+
+.. note::
+
+  By default, the :code:`nvidia` multi-QPU platform will utilize all available GPUs (number of QPUs instances is equal to the number of GPUs).
+  To specify the number QPUs to be instantiated, one can set the :code:`CUDAQ_MQPU_NGPUS` environment variable.
+  For example, use :code:`export CUDAQ_MQPU_NGPUS=2` to specify that only 2 QPUs (GPUs) are needed.
+
+Since the underlying :code:`GPUEmulatedQPU` is a simulator backend, we can also retrieve the state vector from each
+QPU via the :code:`cudaq::get_state_async` (C++) or :code:`cudaq.get_state_async` (Python) as shown in the bellow code snippets.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/get_state_async.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/get_state_async.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+
+    One can specify the target multi-QPU architecture with the :code:`--target` flag:
+    
+    .. code-block:: console
+
+        nvq++ get_state_async.cpp --target nvidia --target-option mqpu
+        ./a.out
+
+.. deprecated:: 0.8
+    The :code:`nvidia-mqpu` and :code:`nvidia-mqpu-fp64` targets, which are equivalent to the multi-QPU options `mgpu,fp32` and `mgpu,fp64`, respectively, of the :code:`nvidia` target, are deprecated and will be removed in a future release.
+
+Parallel distribution mode
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The CUDA-Q :code:`nvidia` multi-QPU platform supports two modes of parallel distribution of expectation value computation:
+
+* MPI: distribute the expectation value computations across available MPI ranks and GPUs for each Hamiltonian term.
+* Thread: distribute the expectation value computations among available GPUs via standard C++ threads (each thread handles one GPU).
+
+For instance, if all GPUs are available on a single node, thread-based parallel distribution 
+(:code:`cudaq::parallel::thread` in C++ or :code:`cudaq.parallel.thread` in Python, as shown in the above example) is sufficient.
+On the other hand, if one wants to distribute the tasks across GPUs on multiple nodes, e.g., on a compute cluster, MPI distribution mode
+should be used.
+
+An example of MPI distribution mode usage in both C++ and Python is given below:
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/observe_mqpu_mpi.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+    .. code-block:: console
+
+        mpiexec -np <N> python3 file.py
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/observe_mqpu_mpi.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+    .. code-block:: console
+
+        nvq++ file.cpp --target nvidia --target-option mqpu
+        mpiexec -np <N> a.out
+
+In the above example, the parallel distribution mode was set to :code:`mpi` using :code:`cudaq::parallel::mpi` in C++ or :code:`cudaq.parallel.mpi` in Python.
+CUDA-Q provides MPI utility functions to initialize, finalize, or query (rank, size, etc.) the MPI runtime. 
+Last but not least, the compiled executable (C++) or Python script needs to be launched with an appropriate MPI command, 
+e.g., :code:`mpiexec`, :code:`mpirun`, :code:`srun`, etc.
+
+Remote `MQPU` Platform
++++++++++++++++++++++++++++
+
+.. _remote-mqpu-platform:
+
+As shown in the above examples, the multi-QPU NVIDIA platform enables
+multi-QPU distribution whereby each QPU is simulated by a :ref:`single NVIDIA GPU <cuQuantum single-GPU>`.
+To run multi-QPU workloads on different simulator backends, one can use the :code:`remote-mqpu` platform,
+which encapsulates simulated QPUs as independent HTTP REST server instances. 
+The following code illustrates how to launch asynchronous sampling tasks on multiple virtual QPUs, 
+each simulated by a `tensornet` simulator backend.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/sample_async_remote.py
+        :language: python
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/sample_async_remote.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+    The code above is saved in `sample_async.cpp` and compiled with the following command, targeting the :code:`remote-mqpu` platform:
+
+    .. code-block:: console
+
+        nvq++ sample_async.cpp -o sample_async.x --target remote-mqpu --remote-mqpu-backend tensornet --remote-mqpu-auto-launch 2
+        ./sample_async.x
+
+In the above code snippets, the :code:`remote-mqpu` platform was used in the auto-launch mode,
+whereby a specific number of server instances, i.e., virtual QPUs, are launched on the local machine
+in the background. The remote QPU daemon service, :code:`cudaq-qpud`, will also be shut down automatically
+at the end of the session.
+
+.. note:: 
+    By default, auto launching daemon services do not support MPI parallelism.
+    Hence, using the `nvidia-mgpu` backend to simulate each virtual QPU requires 
+    manually launching each server instance. How to do that is explained in the rest of this section.
+
+.. _custom_remote_qpud_launch:
+
+To customize how many and which GPUs are used for simulating each virtual QPU, one can launch each server manually.
+For instance, on a machine with 8 NVIDIA GPUs, one may wish to partition those GPUs into
+4 virtual QPU instances, each manages 2 GPUs. To do so, first launch a :code:`cudaq-qpud` server for each virtual QPU:
+
+.. tab:: Python
+
+     .. See scripts/validate_wheel.sh for examples of how similar commands are run automatically during release validation.
+
+     .. code-block:: bash
+         
+         # Use cudaq-qpud.py wrapper script to automatically find dependencies for the Python wheel configuration.
+         cudaq_location=`python3 -m pip show cuda-quantum | grep -e 'Location: .*$'`
+         qpud_py="${cudaq_location#Location: }/bin/cudaq-qpud.py"
+         CUDA_VISIBLE_DEVICES=0,1 mpiexec -np 2 python3 "$qpud_py" --port <QPU 1 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=2,3 mpiexec -np 2 python3 "$qpud_py" --port <QPU 2 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=4,5 mpiexec -np 2 python3 "$qpud_py" --port <QPU 3 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=6,7 mpiexec -np 2 python3 "$qpud_py" --port <QPU 4 TCP/IP port number>
+
+.. tab:: C++
+     
+     .. code-block:: bash
+         
+         # It is assumed that your $LD_LIBRARY_PATH is able to find all the necessary dependencies.
+         CUDA_VISIBLE_DEVICES=0,1 mpiexec -np 2 cudaq-qpud --port <QPU 1 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=2,3 mpiexec -np 2 cudaq-qpud --port <QPU 2 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=4,5 mpiexec -np 2 cudaq-qpud --port <QPU 3 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=6,7 mpiexec -np 2 cudaq-qpud --port <QPU 4 TCP/IP port number>
+
+
+In the above code snippet, four :code:`nvidia-mgpu` daemons are started in MPI context via the :code:`mpiexec` launcher.
+This activates MPI runtime environment required by the :code:`nvidia-mgpu` backend. Each QPU daemon is assigned a unique 
+TCP/IP port number via the :code:`--port` command-line option. The :code:`CUDA_VISIBLE_DEVICES` environment variable restricts the GPU devices 
+that each QPU daemon sees so that it targets specific GPUs. 
+
+With these invocations, each virtual QPU is locally addressable at the URL `localhost:<port>`. 
+
+.. warning:: 
+
+    There is no authentication required to communicate with this server app. 
+    Hence, please make sure to either (1) use a non-public TCP/IP port for internal use or 
+    (2) use firewalls or other security mechanisms to manage user access. 
+
+User code can then target these QPUs for multi-QPU workloads, such as asynchronous sample or observe shown above for the multi-QPU NVIDIA platform platform.
+
+.. tab:: Python
+
+     .. code:: python 
+
+        cudaq.set_target("remote-mqpu", url="localhost:<port1>,localhost:<port2>,localhost:<port3>,localhost:<port4>", backend="nvidia-mgpu")
+        
+.. tab:: C++
+
+    .. code-block:: console
+
+        nvq++ distributed.cpp --target remote-mqpu --remote-mqpu-url localhost:<port1>,localhost:<port2>,localhost:<port3>,localhost:<port4> --remote-mqpu-backend nvidia-mgpu
+    
+
+Each URL is treated as an independent QPU, hence the number of QPUs (:code:`num_qpus()`) is equal to the number of URLs provided. 
+The multi-node multi-GPU simulator backend (:code:`nvidia-mgpu`) is requested via the :code:`--remote-mqpu-backend` command-line option.
+
+.. note:: 
+
+    The requested backend (:code:`nvidia-mgpu`) will be executed inside the context of the QPU daemon service, thus 
+    inherits its GPU resource allocation (two GPUs per backend simulator instance). 
+
+Supported Kernel Arguments
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The platform serializes kernel invocation to QPU daemons via REST APIs. 
+Please refer to the `Open API Docs <../../openapi.html>`_  for the latest API information.
+Runtime arguments are serialized into a flat memory buffer (`args` field of the request JSON). 
+For more information about argument type serialization, please see :ref:`the table below <type_serialization_table>`.
+
+When using a remote backend to simulate each virtual QPU, 
+by default, we currently do not support passing complex data structures, 
+such as nested vectors or class objects, or other kernels as arguments to the entry point kernels.
+These type limitations only apply to the **entry-point** kernel and not when passing arguments
+to other quantum kernels.
+
+Support for the full range of argument types within CUDA-Q can be enabled by compiling the 
+code with the :code:`--enable-mlir` option. This flag forces quantum kernels to be compiled with 
+the CUDA-Q MLIR-based compiler. As a result, runtime arguments can be resolved by the CUDA 
+Quantum compiler infrastructure to support wider range of argument types. However, certain
+language constructs within quantum kernels may not yet be fully supported.
+
+.. _type_serialization_table:
+
+.. list-table:: Kernel argument serialization
+   :widths: 50 50 50
+   :header-rows: 1
+
+   * - Data type
+     - Example
+     - Serialization
+   * -  Trivial type (occupies a contiguous memory area)
+     -  `int`, `std::size_t`, `double`, etc.
+     - Byte data (via `memcpy`)
+   * - `std::vector` of trivial type
+     - `std::vector<int>`, `std::vector<double>`, etc. 
+     - Total vector size in bytes as a 64-bit integer followed by serialized data of all vector elements.
+   * - `cudaq::pauli_word`
+     - `cudaq::pauli_word("IXIZ")`
+     - Same as `std::vector<char>`: total vector size in bytes as a 64-bit integer followed by serialized data of all characters.
+   * - Single-level nested `std::vector` of supported `std::vector` types
+     - `std::vector<std::vector<int>>`, `std::vector<cudaq::pauli_word>`, etc. 
+     - Number of top-level elements (as a 64-bit integer) followed sizes in bytes of element vectors (as a contiguous array of 64-bit integers) then serialized data of the inner vectors.
+     
+For CUDA-Q kernels that return a value, the remote platform supports returning simple data types of 
+`bool`, integral (e.g., `int` or `std::size_t`), and floating-point types (`float` or `double`) 
+when MLIR-based compilation is enabled (:code:`--enable-mlir`).
+
+Accessing Simulated Quantum State
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The remote `MQPU` platform supports accessing simulator backend's state vector via the 
+`cudaq::get_state` (C++) or `cudaq.get_state` (Python) APIs, similar to local simulator backends.
+
+State data can be retrieved as a full state vector or as individual basis states' amplitudes.
+The later is designed for large quantum states, which incurred data transfer overheads.
+
+.. tab:: Python
+
+    .. code:: python 
+        
+        state = cudaq.get_state(kernel)
+        amplitudes = state.amplitudes(['0000', '1111'])
+        
+.. tab:: C++
+
+    .. code-block:: cpp
+        
+        auto state = cudaq::get_state(kernel)
+        auto amplitudes = state.amplitudes({{0, 0, 0, 0}, {1, 1, 1, 1}});
+
+In the above example, the amplitudes of the two requested states are returned.
+
+For C++ quantum kernels [*]_ compiled with the CUDA-Q MLIR-based compiler and Python kernels,
+state accessor is evaluated in a just-in-time/on-demand manner, and hence can be customize to
+users' need.
+
+For instance, in the above amplitude access example, if the state vector is very large, e.g.,
+multi-GPU distributed state vectors or tensor-network encoded quantum states, the full state vector
+will not be retrieved when `get_state` is called. Instead, when the `amplitudes` accessor is called,
+a specific amplitude calculation request will be sent to the server. 
+Thus, only the amplitudes of those basis states will be computed and returned. 
+
+Similarly, for state overlap calculation, if deferred state evaluation is available (Python/MLIR-based compiler)
+for both of the operand quantum states, a custom overlap calculation request will be constructed and sent to the server.
+Only the final overlap result will be returned, thereby eliminating back-and-forth state data transfers. 
+
+.. [*] Only C++ quantum kernels whose names are available via run-time type information (RTTI) are supported.
+    For example, quantum kernels expressed as named `struct` are supported but not standalone functions.
+    Kernels that do not have deferred state evaluation support will perform synchronous `get_state`, whereby the full state
+    vector is returned from the server immediately.   
diff --git a/pr-2241/_sources/using/backends/simulators.rst.txt b/pr-2241/_sources/using/backends/simulators.rst.txt
new file mode 100644
index 0000000000..dab80d3243
--- /dev/null
+++ b/pr-2241/_sources/using/backends/simulators.rst.txt
@@ -0,0 +1,517 @@
+CUDA-Q Simulation Backends
+*********************************
+
+.. _nvidia-backend:
+
+The simulation backends that are currently available in CUDA-Q are as follows.
+
+State Vector Simulators
+==================================
+
+The :code:`nvidia` target provides a state vector simulator accelerated with 
+the :code:`cuStateVec` library. 
+
+The :code:`nvidia` target supports multiple configurable options.
+
+Features 
++++++++++
+
+* Floating-point precision configuration 
+
+The floating point precision of the state vector data can be configured to either 
+double (`fp64`) or single (`fp32`) precision. This option can be chosen for the optimal performance and accuracy.
+
+
+* Distributed simulation
+
+The :code:`nvidia` target supports distributing state vector simulations to multiple GPUs and multiple nodes (`mgpu` :ref:`distribution <nvidia-mgpu-backend>`)
+and multi-QPU (`mqpu` :ref:`platform <mqpu-platform>`) distribution whereby each QPU is simulated via a single-GPU simulator instance.
+
+
+* Host CPU memory utilization 
+
+Host CPU memory can be leveraged in addition to GPU memory to accommodate the state vector 
+(i.e., maximizing the number of qubits to be simulated).
+
+.. _cuQuantum single-GPU:
+
+
+Single-GPU 
+++++++++++++++++++++++++++++++++++
+
+To execute a program on the :code:`nvidia` target, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target nvidia
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('nvidia')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target nvidia program.cpp [...] -o program.x
+        ./program.x
+
+.. _nvidia-fp64-backend:
+
+By default, this will leverage :code:`FP32` floating point types for the simulation. To 
+switch to :code:`FP64`, specify the :code:`--target-option fp64` `nvq++` command line option for `C++` and `Python` or 
+use `cudaq.set_target('nvidia', option='fp64')` for Python in-source target modification instead. 
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target nvidia --target-option fp64
+
+    The precision of the :code:`nvidia` target can also be modified in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('nvidia', option='fp64')
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target nvidia --target-option fp64 program.cpp [...] -o program.x
+        ./program.x
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU and CUDA runtime libraries. If you do not have these dependencies installed, you may encounter an error stating `Invalid simulator requested`. See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+
+In the single-GPU mode, the :code:`nvidia` target provides the following
+environment variable options. Any environment variables must be set prior to
+setting the target.
+
+.. list-table:: **Environment variable options supported in single-GPU mode**
+  :widths: 20 30 50
+
+  * - Option
+    - Value
+    - Description
+  * - ``CUDAQ_FUSION_MAX_QUBITS``
+    - positive integer
+    - The max number of qubits used for gate fusion. The default value is `4`.
+  * - ``CUDAQ_FUSION_DIAGONAL_GATE_MAX_QUBITS``
+    - integer greater than or equal to -1
+    - The max number of qubits used for diagonal gate fusion. The default value is set to `-1` and the fusion size will be automatically adjusted for the better performance. If 0, the gate fusion for diagonal gates is disabled.
+  * - ``CUDAQ_FUSION_NUM_HOST_THREADS``
+    - positive integer
+    - Number of CPU threads used for circuit processing. The default value is `8`.
+  * - ``CUDAQ_MAX_CPU_MEMORY_GB``
+    - non-negative integer, or `NONE`
+    - CPU memory size (in GB) allowed for state-vector migration. `NONE` means unlimited (up to physical memory constraints). Default is 0 (disabled). 
+  * - ``CUDAQ_MAX_GPU_MEMORY_GB``
+    - positive integer, or `NONE`
+    - GPU memory (in GB) allowed for on-device state-vector allocation. As the state-vector size exceeds this limit, host memory will be utilized for migration. `NONE` means unlimited (up to physical memory constraints). This is the default. 
+
+.. deprecated:: 0.8
+    The :code:`nvidia-fp64` targets, which is equivalent setting the `fp64` option on the :code:`nvidia` target, 
+    is deprecated and will be removed in a future release.
+
+.. _nvidia-mgpu-backend:
+
+Multi-node multi-GPU
+++++++++++++++++++++++++++++++++++
+
+The NVIDIA target also provides a state vector simulator accelerated with 
+the :code:`cuStateVec` library with support for Multi-Node, Multi-GPU distribution of the 
+state vector, in addition to a single GPU.
+
+The multi-node multi-GPU simulator expects to run within an MPI context.
+To execute a program on the multi-node multi-GPU NVIDIA target, use the following commands 
+(adjust the value of the :code:`-np` flag as needed to reflect available GPU resources on your system):
+
+.. tab:: Python
+
+    Double precision simulation:
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 program.py [...] --target nvidia --target-option fp64,mgpu
+
+    Single precision simulation:
+    
+    .. code:: bash 
+
+        mpiexec -np 2 python3 program.py [...] --target nvidia --target-option fp32,mgpu
+
+    .. note::
+
+      If you installed CUDA-Q via :code:`pip`, you will need to install the necessary MPI dependencies separately;
+      please follow the instructions for installing dependencies in the `Project Description <https://pypi.org/project/cuda-quantum/#description>`__.
+
+    In addition to using MPI in the simulator, you can use it in your application code by installing `mpi4py <https://mpi4py.readthedocs.io/>`__, and 
+    invoking the program with the command
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 -m mpi4py program.py [...] --target nvidia --target-option fp64,mgpu
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('nvidia', option='mgpu,fp64')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+    .. note::
+        
+        * The order of the option settings are interchangeable.
+          For example, `cudaq.set_target('nvidia', option='mgpu,fp64')` is equivalent to `cudaq.set_target('nvidia', option='fp64,mgpu')`.
+
+        * The `nvidia` target has single-precision as the default setting. Thus, using `option='mgpu'` implies that `option='mgpu,fp32'`.  
+
+.. tab:: C++
+
+    Double precision simulation:
+
+    .. code:: bash 
+
+        nvq++ --target nvidia  --target-option mgpu,fp64 program.cpp [...] -o program.x
+        mpiexec -np 2 ./program.x
+
+    Single precision simulation:
+
+    .. code:: bash 
+
+        nvq++ --target nvidia  --target-option mgpu,fp32 program.cpp [...] -o program.x
+        mpiexec -np 2 ./program.x
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU, CUDA runtime libraries, as well as an MPI installation. If you do not have these dependencies installed, you may encounter either an error stating `invalid simulator requested` (missing CUDA libraries), or an error along the lines of `failed to launch kernel` (missing MPI installation). See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+  
+  The number of processes and nodes should be always power-of-2. 
+
+  Host-device state vector migration is also supported in the multi-node multi-GPU configuration. 
+
+
+In addition to those environment variable options supported in the single-GPU mode,
+the :code:`nvidia` target provides the following environment variable options particularly for 
+the multi-node multi-GPU configuration. Any environment variables must be set
+prior to setting the target.
+
+.. list-table:: **Additional environment variable options for multi-node multi-GPU mode**
+  :widths: 20 30 50
+
+  * - Option
+    - Value
+    - Description
+  * - ``CUDAQ_MGPU_LIB_MPI``
+    - string
+    - The shared library name for inter-process communication. The default value is `libmpi.so`.
+  * - ``CUDAQ_MGPU_COMM_PLUGIN_TYPE``
+    - `AUTO`, `EXTERNAL`, `OpenMPI`, or `MPICH` 
+    - Selecting :code:`cuStateVec` `CommPlugin` for inter-process communication. The default is `AUTO`. If `EXTERNAL` is selected, `CUDAQ_MGPU_LIB_MPI` should point to an implementation of :code:`cuStateVec` `CommPlugin` interface.
+  * - ``CUDAQ_MGPU_NQUBITS_THRESH``
+    - positive integer
+    - The qubit count threshold where state vector distribution is activated. Below this threshold, simulation is performed as independent (non-distributed) tasks across all MPI processes for optimal performance. Default is 25. 
+  * - ``CUDAQ_MGPU_FUSE``
+    - positive integer
+    - The max number of qubits used for gate fusion. The default value is `6` if there are more than one MPI processes or `4` otherwise.
+  * - ``CUDAQ_MGPU_P2P_DEVICE_BITS``
+    - positive integer
+    - Specify the number of GPUs that can communicate by using GPUDirect P2P. Default value is 0 (P2P communication is disabled).
+  * - ``CUDAQ_GPU_FABRIC``
+    - `MNNVL`, `NVL`, or `NONE`
+    - Automatically set the number of P2P device bits based on the total number of processes when multi-node NVLink (`MNNVL`) is selected; or the number of processes per node when NVLink (`NVL`) is selected; or disable P2P (with `NONE`). 
+  * - ``CUDAQ_GLOBAL_INDEX_BITS``
+    - comma-separated list of positive integers
+    - Specify the inter-node network structure (faster to slower). For example, assuming a 8 nodes, 4 GPUs/node simulation whereby network communication is faster, this `CUDAQ_GLOBAL_INDEX_BITS` environment variable can be set to `3,2`. The first `3` represents **8** nodes with fast communication and the second `2` represents **4** 8-node groups in those total 32 nodes. Default is an empty list (no customization based on network structure of the cluster).
+  * - ``CUDAQ_HOST_DEVICE_MIGRATION_LEVEL``
+    - positive integer
+    - Specify host-device memory migration w.r.t. the network structure. 
+
+.. deprecated:: 0.8
+    The :code:`nvidia-mgpu` target, which is equivalent to the multi-node multi-GPU double-precision option (`mgpu,fp64`) of the :code:`nvidia`
+    is deprecated and will be removed in a future release.
+
+The above configuration options of the :code:`nvidia` backend 
+can be tuned to reduce your simulation runtimes. One of the
+performance improvements is to fuse multiple gates together during runtime. For
+example, :code:`x(qubit0)` and :code:`x(qubit1)` can be fused together into a
+single 4x4 matrix operation on the state vector rather than 2 separate 2x2
+matrix operations on the state vector. This fusion reduces memory bandwidth on
+the GPU because the state vector is transferred into and out of memory fewer
+times. By default, up to 4 gates are fused together for single-GPU simulations,
+and up to 6 gates are fused together for multi-GPU simulations. The number of
+gates fused can **significantly** affect performance of some circuits, so users
+can override the default fusion level by setting the setting `CUDAQ_MGPU_FUSE`
+environment variable to another integer value as shown below.
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        CUDAQ_MGPU_FUSE=5 mpiexec -np 2 python3 program.py [...] --target nvidia --target-option mgpu,fp64
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target nvidia --target-option mgpu,fp64 program.cpp [...] -o program.x
+        CUDAQ_MGPU_FUSE=5 mpiexec -np 2 ./program.x
+
+.. _OpenMP CPU-only:
+
+OpenMP CPU-only
+++++++++++++++++++++++++++++++++++
+
+.. _qpp-cpu-backend:
+
+This target provides a state vector simulator based on the CPU-only, OpenMP threaded `Q++ <https://github.com/softwareqinc/qpp>`_ library.
+This is the default target when running on CPU-only systems.
+
+To execute a program on the :code:`qpp-cpu` target even if a GPU-accelerated backend is available, 
+use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target qpp-cpu
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('qpp-cpu')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target qpp-cpu program.cpp [...] -o program.x
+        ./program.x
+
+
+Clifford-Only Simulation (CPU)
+++++++++++++++++++++++++++++++++++
+
+.. _stim-backend:
+
+This target provides a fast simulator for circuits containing *only* Clifford
+gates. Any non-Clifford gates (such as T gates and Toffoli gates) are not
+supported. This simulator is based on the `Stim <https://github.com/quantumlib/Stim>`_
+library.
+
+To execute a program on the :code:`stim` target, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target stim
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('stim')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target stim program.cpp [...] -o program.x
+        ./program.x
+
+
+Tensor Network Simulators
+==================================
+
+.. _tensor-backends:
+
+CUDA-Q provides a couple of tensor-network simulator targets accelerated with 
+the :code:`cuTensorNet` library. 
+These backends are available for use from both C++ and Python.
+
+Tensor network simulators are suitable for large-scale simulation of certain classes of quantum circuits involving many qubits beyond the memory limit of state vector based simulators. For example, computing the expectation value of a Hamiltonian via :code:`cudaq::observe` can be performed efficiently, thanks to :code:`cuTensorNet` contraction optimization capability. On the other hand, conditional circuits, i.e., those with mid-circuit measurements or reset, despite being supported by both backends, may result in poor performance. 
+
+Multi-node multi-GPU
++++++++++++++++++++++++++++++++++++
+
+The :code:`tensornet` backend represents quantum states and circuits as tensor networks in an exact form (no approximation). 
+Measurement samples and expectation values are computed via tensor network contractions. 
+This backend supports multi-node, multi-GPU distribution of tensor operations required to evaluate and simulate the circuit.
+
+To execute a program on the :code:`tensornet` target using a *single GPU*, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target tensornet
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('tensornet')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target tensornet program.cpp [...] -o program.x
+        ./program.x
+
+If you have *multiple GPUs* available on your system, you can use MPI to automatically distribute parallelization across the visible GPUs. 
+
+.. note::
+
+  If you installed the CUDA-Q Python wheels, distribution across multiple GPUs is currently not supported for this backend.
+  We will add support for it in future releases. For more information, see this `GitHub issue <https://github.com/NVIDIA/cuda-quantum/issues/920>`__.
+
+Use the following commands to enable distribution across multiple GPUs (adjust the value of the :code:`-np` flag as needed to reflect available GPU resources on your system):
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 program.py [...] --target tensornet
+
+    In addition to using MPI in the simulator, you can use it in your application code by installing `mpi4py <https://mpi4py.readthedocs.io/>`__, and 
+    invoking the program with the command
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 -m mpi4py program.py [...] --target tensornet
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target tensornet program.cpp [...] -o program.x
+        mpiexec -np 2 ./program.x
+
+.. note::
+
+  If the `CUTENSORNET_COMM_LIB` environment variable is not set, MPI parallelization on the :code:`tensornet` backend may fail.
+  If you are using a CUDA-Q container, this variable is pre-configured and no additional setup is needed. If you are customizing your installation or have built CUDA-Q from source, please follow the instructions for `activating the distributed interface <https://docs.nvidia.com/cuda/cuquantum/latest/getting-started/index.html#from-nvidia-devzone>`__ for the `cuTensorNet` library. This requires 
+  :ref:`installing CUDA development dependencies <additional-cuda-tools>`, and setting the `CUTENSORNET_COMM_LIB`
+  environment variable to the newly built `libcutensornet_distributed_interface_mpi.so` library.
+
+Specific aspects of the simulation can be configured by setting the following of environment variables:
+
+* **`CUDA_VISIBLE_DEVICES=X`**: Makes the process only see GPU X on multi-GPU nodes. Each MPI process must only see its own dedicated GPU. For example, if you run 8 MPI processes on a DGX system with 8 GPUs, each MPI process should be assigned its own dedicated GPU via `CUDA_VISIBLE_DEVICES` when invoking `mpiexec` (or `mpirun`) commands. 
+* **`OMP_PLACES=cores`**: Set this environment variable to improve CPU parallelization.
+* **`OMP_NUM_THREADS=X`**: To enable CPU parallelization, set X to `NUMBER_OF_CORES_PER_NODE/NUMBER_OF_GPUS_PER_NODE`.
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU and CUDA runtime libraries. 
+  If you do not have these dependencies installed, you may encounter an error stating `Invalid simulator requested`. 
+  See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+
+.. note::
+
+  Setting random seed, via :code:`cudaq::set_random_seed`, is not supported for this backend due to a limitation of the :code:`cuTensorNet` library. This will be fixed in future release once this feature becomes available.
+
+
+Matrix product state 
++++++++++++++++++++++++++++++++++++
+
+The :code:`tensornet-mps` backend is based on the matrix product state (MPS) representation of the state vector/wave function, exploiting the sparsity in the tensor network via tensor decomposition techniques such as QR and SVD. As such, this backend is an approximate simulator, whereby the number of singular values may be truncated to keep the MPS size tractable. 
+The :code:`tensornet-mps` backend only supports single-GPU simulation. Its approximate nature allows the :code:`tensornet-mps` backend to handle a large number of qubits for certain classes of quantum circuits on a relatively small memory footprint.
+
+To execute a program on the :code:`tensornet-mps` target, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target tensornet-mps
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('tensornet-mps')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target tensornet-mps program.cpp [...] -o program.x
+        ./program.x
+
+Specific aspects of the simulation can be configured by defining the following environment variables:
+
+* **`CUDAQ_MPS_MAX_BOND=X`**: The maximum number of singular values to keep (fixed extent truncation). Default: 64.
+* **`CUDAQ_MPS_ABS_CUTOFF=X`**: The cutoff for the largest singular value during truncation. Eigenvalues that are smaller will be trimmed out. Default: 1e-5.
+* **`CUDAQ_MPS_RELATIVE_CUTOFF=X`**: The cutoff for the maximal singular value relative to the largest eigenvalue. Eigenvalues that are smaller than this fraction of the largest singular value will be trimmed out. Default: 1e-5
+* **`CUDAQ_MPS_SVD_ALGO=X`**: The SVD algorithm to use. Valid values are: `GESVD` (QR algorithm), `GESVDJ` (Jacobi method), `GESVDP` (`polar decomposition <https://epubs.siam.org/doi/10.1137/090774999>`__), `GESVDR` (`randomized methods <https://epubs.siam.org/doi/10.1137/090771806>`__). Default: `GESVDJ`.
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU and CUDA runtime libraries. 
+  If you do not have these dependencies installed, you may encounter an error stating `Invalid simulator requested`. 
+  See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+
+.. note::
+
+  Setting random seed, via :code:`cudaq::set_random_seed`, is not supported for this backend due to a limitation of the :code:`cuTensorNet` library. This will be fixed in future release once this feature becomes available.
+
+.. note::
+    The parallelism of Jacobi method (the default `CUDAQ_MPS_SVD_ALGO` setting) gives GPU better performance on small and medium size matrices.
+    If you expect a large number of singular values (e.g., increasing the `CUDAQ_MPS_MAX_BOND` setting), please adjust the `CUDAQ_MPS_SVD_ALGO` setting accordingly.  
+
+Default Simulator
+==================================
+
+.. _default-simulator:
+
+If no explicit target is set, i.e., if the code is compiled without any :code:`--target` flags, then CUDA-Q makes a default choice for the simulator.
+
+If an NVIDIA GPU and CUDA runtime libraries are available, the default target is set to `nvidia`. This will utilize the :ref:`cuQuantum single-GPU state vector simulator <cuQuantum single-GPU>`.  
+On CPU-only systems, the default target is set to `qpp-cpu` which uses the :ref:`OpenMP CPU-only simulator <OpenMP CPU-only>`.
+
+The default simulator can be overridden by the environment variable `CUDAQ_DEFAULT_SIMULATOR`. If no target is explicitly specified and the environment variable has a valid value, then it will take effect.
+This environment variable can be set to any non-hardware backend. Any invalid value is ignored.
+
+For CUDA-Q Python API, the environment variable at the time when `cudaq` module is imported is relevant, not the value of the environment variable at the time when the simulator is invoked.
+
+For example,
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        CUDAQ_DEFAULT_SIMULATOR=density-matrix-cpu python3 program.py [...]
+        
+.. tab:: C++
+
+    .. code:: bash 
+
+        CUDAQ_DEFAULT_SIMULATOR=density-matrix-cpu nvq++ program.cpp [...] -o program.x
+        ./program.x
+
+This will use the density matrix simulator target.
+
+
+.. note:: 
+
+    To use targets that require an NVIDIA GPU and CUDA runtime libraries, the dependencies must be installed, else you may encounter an error stating `Invalid simulator requested`. See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
diff --git a/pr-2241/_sources/using/basics/basics.rst.txt b/pr-2241/_sources/using/basics/basics.rst.txt
new file mode 100644
index 0000000000..308ba7492c
--- /dev/null
+++ b/pr-2241/_sources/using/basics/basics.rst.txt
@@ -0,0 +1,11 @@
+CUDA-Q Basics
+*******************
+
+.. toctree::
+   :caption: Contents
+   :maxdepth: 2
+
+      What is a CUDA-Q Kernel? <kernel_intro.rst>
+      Building your first CUDA-Q Program <build_kernel.rst>
+      Running your first CUDA-Q Program <run_kernel.rst>
+      Troubleshooting <troubleshooting.rst>
diff --git a/pr-2241/_sources/using/basics/build_kernel.rst.txt b/pr-2241/_sources/using/basics/build_kernel.rst.txt
new file mode 100644
index 0000000000..08a8d9f9cc
--- /dev/null
+++ b/pr-2241/_sources/using/basics/build_kernel.rst.txt
@@ -0,0 +1,30 @@
+Building your first CUDA-Q Program
+-----------------------------------------
+
+.. tab:: Python
+
+  We can define our quantum kernel as a typical Python function, with the additional use of the
+  `@cudaq.kernel` decorator. Let's begin with a simple GHZ-state example, producing a state of
+  maximal entanglement amongst an allocated set of qubits. 
+  
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+      :language: python
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+.. tab:: C++
+
+  We can define our quantum kernel as we do any other typed callable in C++, through the use of the
+  `__qpu__` annotation. For the following example, we will define a kernel for a simple GHZ-state as
+  a standard free function.
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+      :language: cpp
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+This kernel function can accept any number of arguments, allowing for flexibility in the construction
+of the quantum program. In this case, the `qubit_count` argument allows us to dynamically control the
+number of qubits allocated to the kernel. As we will see in further :doc:`examples <../examples/examples>`,
+we could also use these arguments to control various parameters of the gates themselves, such as rotation
+angles.
diff --git a/pr-2241/_sources/using/basics/kernel_intro.rst.txt b/pr-2241/_sources/using/basics/kernel_intro.rst.txt
new file mode 100644
index 0000000000..aaafcea8a5
--- /dev/null
+++ b/pr-2241/_sources/using/basics/kernel_intro.rst.txt
@@ -0,0 +1,28 @@
+What is a CUDA-Q kernel?
+-------------------------------
+
+Quantum kernels are defined as functions that are executed on a quantum processing unit (QPU) or
+a simulated QPU. They generalize quantum circuits and provide a new abstraction for quantum programming.
+Quantum kernels can be combined with classical functions to create quantum-classical applications
+that can be executed on a heterogeneous system of QPUs, GPUs, and CPUs to solve real-world problems.
+
+**What’s the difference between a quantum kernel and a quantum circuit?**
+
+Every quantum circuit is a kernel, but not every quantum kernel is a circuit. For instance, a quantum
+kernel can be built up from other kernels, allowing us to interpret a large quantum program as a sequence
+of subroutines or subcircuits.  
+
+Moreover, since quantum kernels are functions, there is more expressibility available compared to a
+standard quantum circuit. We can not only parameterize the kernel, but can also contain classical control
+flow statements (`if`, `for`, `while`, etc.), and classical computations such as additions, multiplication, etc.
+Conditional statements on quantum memory and qubit measurements can be included in quantum kernels to enable 
+dynamic circuits and fast feedback, particularly useful for quantum error correction. To learn more about what
+language constructs are supported within quantum kernels, take a look at the CUDA-Q 
+:doc:`specification <../../specification/cudaq/kernels>`.
+
+**How do I build and run a quantum kernel?**
+
+Once a quantum kernel has been defined in a program, it may be called as a typical function, or can be executed
+using the `sample` or `observe` primitives.
+
+Let’s take a closer look at how to build and execute a quantum kernel with CUDA-Q.
\ No newline at end of file
diff --git a/pr-2241/_sources/using/basics/run_kernel.rst.txt b/pr-2241/_sources/using/basics/run_kernel.rst.txt
new file mode 100644
index 0000000000..37a82cf3b4
--- /dev/null
+++ b/pr-2241/_sources/using/basics/run_kernel.rst.txt
@@ -0,0 +1,258 @@
+Running your first CUDA-Q Program
+----------------------------------------
+
+Now that you have defined your first quantum kernel, let's look at different options for how to execute it.
+In CUDA-Q, quantum circuits are stored as quantum kernels. For estimating the probability distribution of 
+a measured quantum state in a circuit, we use the ``sample`` function call, and for computing the
+expectation value of a quantum state with a given observable, we use the ``observe`` function call.
+
+Sample
+++++++++
+
+Quantum states collapse upon measurement and hence need to be sampled many times to gather statistics. The CUDA-Q `sample` call enables this.
+
+.. tab:: Python
+
+  The :func:`cudaq.sample` method takes a kernel and its arguments as inputs, and returns a :class:`cudaq.SampleResult`.
+
+.. tab:: C++
+
+  The `cudaq::sample` method takes a kernel and its arguments as inputs, and returns a `cudaq::SampleResult`.
+
+This result dictionary contains the distribution of measured states for the system.
+
+Continuing with the GHZ kernel defined in :doc:`Building Your First CUDA-Q Program <build_kernel>`,
+we will set the concrete value of our `qubit_count` to be two.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin Sample1]
+        :end-before: [End Sample1]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+        :language: cpp
+        :start-after: [Begin Sample1]
+        :end-before: [End Sample1]
+
+The code above can be run like any other program:
+
+.. tab:: Python
+
+  Assuming the program is saved in the file `sample.py`, we can execute is with the command
+
+  .. code-block:: console
+
+      python3 sample.py
+
+.. tab:: C++
+
+  Assuming the program is saved in the file `sample.cpp`, we can now compile this file with the `nvq++` toolchain, and then run the compiled executable.
+
+  .. code-block:: console
+
+      nvq++ sample.cpp
+      ./a.out
+
+By default, `sample` produces an ensemble of 1000 shots. This can be changed by specifying an integer argument
+for the `shots_count`.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin Sample2]
+        :end-before: [End Sample2]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+        :language: cpp
+        :start-after: [Begin Sample2]
+        :end-before: [End Sample2]
+
+Note that there is a subtle difference between how sample is executed with the target device set to a simulator or with the target device set to a QPU. When run on a simulator, the quantum state is built once and then sampled repeatedly, where the number of samples is defined by `shots_count`. When executed on quantum hardware, the quantum state collapses upon measurement and hence needs to be rebuilt every time to collect a sample.
+
+A variety of methods can be used to extract useful information from a `SampleResult`. For example,
+to return the most probable measurement and its respective probability:
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin Sample3]
+        :end-before: [End Sample3]
+
+  See the :doc:`API specification <../../../api/languages/python_api>` for further information.
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+        :language: cpp
+        :start-after: [Begin Sample3]
+        :end-before: [End Sample3]
+
+  See the :doc:`API specification <../../../api/languages/cpp_api>` for further information.
+
+Sampling a distribution can be a time intensive task. An asynchronous version of sample exists and can be useful to parallelize your application. Asynchronous programming is a technique that enables your program to start a potentially long-running task and still be able to be responsive to other events while that task runs, rather than having to wait until that task has finished. Once that task has finished, your program is presented with the result.
+
+Asynchronous execution allows to easily parallelize execution of multiple kernels on a multi-processor platform. Such a platform
+is available, for example, by choosing the target `nvidia-mqpu`:
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin SampleAsync]
+        :end-before: [End SampleAsync]
+
+.. note::
+
+  This kind of parallelization is most effective
+  if you actually have multiple QPU or CPU available. Otherwise, the 
+  sampling will still have to execute sequentially due to resource constraints. 
+
+More information about parallelizing execution can be found at :doc:`../backends/platform` page.
+
+Observe
++++++++++
+
+The observe function allows us to calculate expectation values for a defined quantum operator, that is the value of :math:`\bra{\psi}H\ket{\psi}`, where :math:`H` is the desired operator and :math:`\ket{\psi}` is the quantum state after executing a given kernel. 
+
+.. tab:: Python
+
+  The :func:`cudaq.observe` method takes a kernel and its arguments as inputs, along with a :class:`cudaq.SpinOperator`.
+
+  Using the `cudaq.spin` module, operators may be defined as a linear combination of Pauli strings. Functions, such
+  as :func:`cudaq.spin.i`, :func:`cudaq.spin.x`, :func:`cudaq.spin.y`, :func:`cudaq.spin.z` may be used to construct more
+  complex spin Hamiltonians on multiple qubits.
+
+.. tab:: C++
+
+  The `cudaq::observe` method takes a kernel and its arguments as inputs, along with a `cudaq::spin_op`.
+
+  Within the `cudaq::spin` namespace, operators may be defined as a linear combination of Pauli strings. Functions, such
+  as `cudaq::spin::i`, `cudaq::spin::x`, `cudaq::spin::y`, `cudaq::spin::z` may be used to construct more
+  complex spin Hamiltonians on multiple qubits.
+
+Below is an example of a spin operator object consisting of a `Z(0)` operator, or a Pauli Z-operator on the qubit zero. 
+This is followed by the construction of a kernel with a single qubit in an equal superposition. 
+The Hamiltonian is printed to confirm it has been constructed properly.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_observe.py
+        :language: python
+        :start-after: [Begin Observe1]
+        :end-before: [End Observe1]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_observe.cpp
+        :language: cpp
+        :start-after: [Begin Observe1]
+        :end-before: [End Observe1]
+
+The `observe` function takes a kernel, any kernel arguments, and a spin operator as inputs and produces an `ObserveResult` object.
+The expectation value can be printed using the `expectation` method. 
+
+.. note:: 
+  
+  It is important to exclude a measurement in the kernel, otherwise the expectation value will be determined from a collapsed 
+  classical state. For this example, the expected result of 0.0 is produced.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_observe.py
+        :language: python
+        :start-after: [Begin Observe2]
+        :end-before: [End Observe2]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_observe.cpp
+        :language: cpp
+        :start-after: [Begin Observe2]
+        :end-before: [End Observe2]
+
+Unlike `sample`, the default `shots_count` for `observe` is 1. This result is deterministic and equivalent to the
+expectation value in the limit of infinite shots.  To produce an approximate expectation value from sampling, `shots_count` can
+be specified to any integer.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_observe.py
+        :language: python
+        :start-after: [Begin Observe3]
+        :end-before: [End Observe3]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_observe.cpp
+        :language: cpp
+        :start-after: [Begin Observe3]
+        :end-before: [End Observe3]
+
+Similar to `sample_async` above, observe also supports asynchronous execution. 
+More information about parallelizing execution can be found at 
+:doc:`../backends/platform` page.
+
+Running on a GPU
+++++++++++++++++++
+
+.. tab:: Python
+
+  Using :func:`cudaq.set_target`, different targets can be specified for kernel execution.
+
+.. tab:: C++
+
+  Using the `--target` argument to `nvq++`, different targets can be specified for kernel execution.
+
+If a local GPU is detected, the target will default to `nvidia`. Otherwise, the CPU-based simulation
+target, `qpp-cpu`,  will be selected.
+  
+We will demonstrate the benefits of using a GPU by sampling our GHZ kernel with 25 qubits and a
+`shots_count` of 1 million. Using a GPU accelerates this task by more than 35x. To learn about
+all of the available targets and ways to accelerate kernel execution, visit the
+:doc:`Backends <../backends/backends>` page.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/time.py
+        :language: python
+        :start-after: [Begin Time]
+        :end-before: [End Time]
+
+.. tab:: C++
+
+  To compare the performance, we can create a simple timing script that isolates just the call
+  to `cudaq::sample`. We are still using the same GHZ kernel as earlier, but the following
+  modification made to the main function:
+
+  .. literalinclude:: ../../snippets/cpp/using/time.cpp
+    :language: cpp
+    :start-after: [Begin Time]
+    :end-before: [End Time]
+
+  First we execute on the CPU backend:
+
+  .. code:: console
+
+    nvq++ --target=qpp-cpu sample.cpp
+    ./a.out
+  
+  seeing an output of the order:
+  ``It took 22.8337 seconds.``
+
+  Now we can execute on the GPU enabled backend:
+
+  .. code:: console
+
+    nvq++ --target=nvidia sample.cpp
+    ./a.out
+
+  seeing an output of the order:
+  ``It took 3.18988 seconds.``
\ No newline at end of file
diff --git a/pr-2241/_sources/using/basics/troubleshooting.rst.txt b/pr-2241/_sources/using/basics/troubleshooting.rst.txt
new file mode 100644
index 0000000000..608e7086f6
--- /dev/null
+++ b/pr-2241/_sources/using/basics/troubleshooting.rst.txt
@@ -0,0 +1,41 @@
+Troubleshooting
+-----------------
+
+Debugging and Verbose Simulation Output
++++++++++++++++++++++++++++++++++++++++++
+
+One helpful mechanism of debugging CUDA-Q simulation execution is
+the :code:`CUDAQ_LOG_LEVEL` environment variable. For any CUDA-Q
+executable, just prepend this and turn it on:
+
+.. tab:: Python
+
+  .. code-block:: bash
+
+      CUDAQ_LOG_LEVEL=info python3 file.py
+
+.. tab:: C++
+
+    .. code-block:: bash
+
+      CUDAQ_LOG_LEVEL=info ./a.out
+
+Similarly, one may write the IR to their console or to a file before remote
+submission. This may be done through the :code:`CUDAQ_DUMP_JIT_IR` environment
+variable. For any CUDA-Q executable, just prepend as follows:
+
+.. tab:: Python
+
+  .. code-block:: bash
+
+      CUDAQ_DUMP_JIT_IR=1 python3 file.py
+      # or
+      CUDAQ_DUMP_JIT_IR=<output_filename> python3 file.py
+
+.. tab:: C++
+
+  .. code-block:: bash
+
+      CUDAQ_DUMP_JIT_IR=1 ./a.out
+      # or
+      CUDAQ_DUMP_JIT_IR=<output_filename> ./a.out
\ No newline at end of file
diff --git a/pr-2241/_sources/using/examples/bernstein_vazirani.rst.txt b/pr-2241/_sources/using/examples/bernstein_vazirani.rst.txt
new file mode 100644
index 0000000000..fe6139529d
--- /dev/null
+++ b/pr-2241/_sources/using/examples/bernstein_vazirani.rst.txt
@@ -0,0 +1,23 @@
+Bernstein-Vazirani
+--------------------------------
+
+The Bernstein-Vazirani algorithm aims to identify the bitstring encoded in a given function. 
+
+For the original source of this algorithm, see 
+`this publication <https://epubs.siam.org/doi/10.1137/S0097539796300921>`__.
+
+In this example, we generate a random bitstring and encode it into an inner-product oracle, 
+and define a kernel for the Bernstein-Vazirani algorithm.  Then, we simulate the kernel and return the most probable bitstring from its execution.
+
+
+If all goes well, the state measured with the highest probability should be our hidden bitstring!
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/bernstein_vazirani.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/bernstein_vazirani.cpp
+      :language: cpp
diff --git a/pr-2241/_sources/using/examples/cuquantum.rst.txt b/pr-2241/_sources/using/examples/cuquantum.rst.txt
new file mode 100644
index 0000000000..1eefb5f103
--- /dev/null
+++ b/pr-2241/_sources/using/examples/cuquantum.rst.txt
@@ -0,0 +1,30 @@
+Simulations with cuQuantum
+-----------------------------------
+
+CUDA-Q provides support for cuQuantum-accelerated state vector and tensor network 
+simulations. Let's take a look at an example that is too large for a standard CPU-only simulator, but 
+can be trivially simulated via a NVIDIA GPU-accelerated backend:
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/cuquantum_backends.py
+      :language: python
+
+   Here we generate a GHZ state on 28 qubits. The built-in cuQuantum state vector
+   backend is selected by default if a local GPU is present. Alternatively, the
+   target may be manually set through the `cudaq.set_target("nvidia")` command.
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/cuquantum_backends.cpp
+      :language: cpp
+
+   Here we generate a GHZ state on 28 qubits. To run with the built-in cuQuantum state 
+   vector support, we pass the :code:`--target nvidia` flag at compile time:
+
+   .. code:: bash 
+
+      nvq++ --target nvidia cuquantum_backends.cpp -o ghz.x
+      ./ghz.x
+
+   Alternatively, we can set the environment variable `CUDAQ_DEFAULT_SIMULATOR` to `nvidia`.
\ No newline at end of file
diff --git a/pr-2241/_sources/using/examples/examples.rst.txt b/pr-2241/_sources/using/examples/examples.rst.txt
new file mode 100644
index 0000000000..2c35b360a3
--- /dev/null
+++ b/pr-2241/_sources/using/examples/examples.rst.txt
@@ -0,0 +1,21 @@
+*************************
+CUDA-Q by Example
+*************************
+
+Examples that illustrate how to use CUDA-Q for application development are available in C++ and Python.
+
+.. toctree::
+   :maxdepth: 1
+
+      Introduction <introduction.rst>
+      Quantum Operations <quantum_operations.rst>
+      Visualization <../../examples/python/tutorials/visualization.ipynb>
+      Computing Expectation Values <expectation_values.rst>
+      Multi-Control Synthesis <multi_control.rst>
+      Multi-GPU Workflows <multi_gpu_workflows.rst>
+      Bernstein-Vazirani <bernstein_vazirani.rst>
+      Variational Quantum Eigensolver <vqe.rst>
+      Quantum Approximate Optimization Algorithm <qaoa.rst>
+      Simulations with cuQuantum <cuquantum.rst>
+      Noisy Simulation <noisy_simulation.rst>
+      Using Quantum Hardware Providers <hardware_providers.rst>
diff --git a/pr-2241/_sources/using/examples/expectation_values.rst.txt b/pr-2241/_sources/using/examples/expectation_values.rst.txt
new file mode 100644
index 0000000000..f9b6e996b9
--- /dev/null
+++ b/pr-2241/_sources/using/examples/expectation_values.rst.txt
@@ -0,0 +1,82 @@
+Computing Expectation Values
+-----------------------------
+
+CUDA-Q provides generic library functions enabling one to compute expectation values 
+of quantum spin operators with respect to a parameterized CUDA-Q kernel. Let's take a look 
+at an example of this:
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/expectation_values.py
+      :language: python
+
+   Here we define a parameterized CUDA-Q kernel that takes an angle, `theta`, as a single
+   input. This angle becomes the argument of a single `ry` rotation.
+
+   We define a Hamiltonian operator via the CUDA-Q `cudaq.SpinOperator` type.
+
+   CUDA-Q provides a generic function `cudaq.observe`. This function takes as input three
+   arguments. The first two argument are a parameterized kernel and the `cudaq.SpinOperator` whose
+   expectation value we wish to compute. The final arguments are the runtime parameters at which we
+   evaluate the parameterized kernel.
+
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/expectation_values.cpp
+      :language: cpp
+
+   Here we define a parameterized CUDA-Q kernel, a callable type named :code:`ansatz` that takes as 
+   input a single angle :code:`theta`. This angle becomes the argument of a single :code:`ry` rotation. 
+
+   In host code, we define a Hamiltonian operator via the CUDA-Q :code:`spin_op` type. 
+   CUDA-Q provides a generic function :code:`cudaq::observe`. This function takes as input three terms. 
+   The first two terms are a parameterized kernel and the :code:`spin_op` whose expectation value we wish to compute.
+   The last term contains the runtime parameters at which we evaluate the parameterized kernel. 
+
+   The return type of this function is an :code:`cudaq::observe_result` which contains all the data 
+   from the execution, but is trivially convertible to a double, resulting in the expectation value we are interested in. 
+
+   To compile and execute this code, we run the following:
+
+   .. code:: bash 
+
+      nvq++ expectation_values.cpp -o exp_vals.x 
+      ./exp_vals.x 
+
+
+Parallelizing across Multiple Processors
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:doc:`multi-processor platforms <../backends/platform>` page.
+
+
+One typical use case of :doc:`multi-processor platforms <../backends/platform>` is to distribute the
+expectation value computations of a multi-term Hamiltonian across multiple virtual QPUs.
+
+The following shows an example using the :code:`nvidia-mqpu` platform:
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/observe_mqpu.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/observe_mqpu.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+
+    One can then target the :code:`nvidia-mqpu` platform by executing the following commands:
+
+    .. code-block:: console
+
+        nvq++ observe_mqpu.cpp -target nvidia-mqpu
+        ./a.out
+
+In the above code snippets, since the Hamiltonian contains four non-identity terms, there are four quantum circuits that need to be executed
+in order to compute the expectation value of that Hamiltonian and given the quantum state prepared by the ansatz kernel. When the :code:`nvidia-mqpu` platform
+is selected, these circuits will be distributed across all available QPUs. The final expectation value result is computed from all QPU execution results.
diff --git a/pr-2241/_sources/using/examples/hardware_providers.rst.txt b/pr-2241/_sources/using/examples/hardware_providers.rst.txt
new file mode 100644
index 0000000000..53e21e83e1
--- /dev/null
+++ b/pr-2241/_sources/using/examples/hardware_providers.rst.txt
@@ -0,0 +1,101 @@
+Using Quantum Hardware Providers
+-----------------------------------
+
+CUDA-Q contains support for using a set of hardware providers (IonQ, IQM, OQC, ORCA Computing and Quantinuum). 
+For more information about executing quantum kernels on different hardware backends, please take a look
+at :doc:`hardware <../backends/hardware>`.
+
+IonQ
+==================================
+
+The following code illustrates how to run kernels on IonQ's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/ionq.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/ionq.cpp
+      :language: cpp
+
+IQM
+==================================
+
+The following code illustrates how to run kernels on IQM's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/iqm.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/iqm.cpp
+      :language: cpp
+
+OQC
+==================================
+
+The following code illustrates how to run kernels on OQC's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/oqc.py
+      :language: python
+
+ORCA Computing
+==================================
+
+The following code illustrates how to run kernels on ORCA Computing's backends.
+
+ORCA Computing's PT Series implement the boson sampling model of quantum computation, in which 
+multiple photons are interfered with each other within a network of beam splitters, and photon 
+detectors measure where the photons leave this network.
+
+The following image shows the schematic of a Time Bin Interferometer (TBI) boson sampling experiment 
+that runs on ORCA Computing's backends. A TBI uses optical delay lines with reconfigurable coupling 
+parameters. A TBI can be represented by a circuit diagram, like the one below, where this 
+illustration example corresponds to 4 photons in 8 modes sent into alternating time-bins in a circuit 
+composed of two delay lines in series. 
+
+.. image:: ./images/orca_tbi.png
+   :width: 400px
+   :align: center
+
+The parameters needed to define the time bin interferometer are the the input state, the loop 
+lengths, beam splitter angles, and optionally the phase shifter angles, and the number of samples.
+The *input state* is the initial state of the photons in the time bin interferometer, 
+the left-most entry corresponds to the first mode entering the loop.
+The *loop lengths* are the lengths of the different loops in the time bin interferometer.
+The *beam splitter angles* and the phase shifter angles are controllable
+parameters of the time bin interferometer.
+
+This experiment is performed on ORCA's backends by the code below.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/orca.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/orca.cpp
+      :language: cpp
+      
+Quantinuum
+==================================
+
+The following code illustrates how to run kernels on Quantinuum's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/quantinuum.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/quantinuum.cpp
+      :language: cpp
+
diff --git a/pr-2241/_sources/using/examples/introduction.rst.txt b/pr-2241/_sources/using/examples/introduction.rst.txt
new file mode 100644
index 0000000000..a12fb6cdad
--- /dev/null
+++ b/pr-2241/_sources/using/examples/introduction.rst.txt
@@ -0,0 +1,42 @@
+Introduction
+--------------------------------
+
+Welcome to CUDA-Q! On this page we will illustrate CUDA-Q with several examples. 
+
+.. tab:: Python
+
+   We're going to take a look at how to construct quantum programs through CUDA-Q's `Kernel` API.
+
+   When you create a `Kernel` and invoke its methods, a quantum program is constructed that can then be executed by calling, for example, `cudaq::sample`. Let's take a closer look!
+
+   .. literalinclude:: ../../examples/python/intro.py
+      :language: python
+
+.. tab:: C++
+
+   We're going to take a look at how to construct quantum programs using CUDA-Q kernels.
+
+   CUDA-Q kernels are any typed callable in the language that is annotated with the :code:`__qpu__` attribute. Let's take a look at a very 
+   simple "Hello World" example, specifically a CUDA-Q kernel that prepares a GHZ state on a programmer-specified number of qubits. 
+
+   .. literalinclude:: ../../examples/cpp/basics/static_kernel.cpp
+      :language: cpp
+
+   Here we see that we can define a custom :code:`struct` that is templated on a :code:`size_t` parameter. 
+   Our kernel expression is free to use this template parameter in the allocation of a 
+   compile-time-known register of qubits. Within the kernel, we are free to apply various quantum operations, 
+   like a Hadamard on qubit 0 :code:`h(q[0])`. Controlled operations are **modifications** of single-qubit 
+   operations, like the :code:`x<cudaq::ctrl>(q[0],q[1])` operation which implements a controlled-X gate. We 
+   can measure single qubits or entire registers. 
+
+   In this example we are interested in sampling the final state produced by this CUDA-Q kernel. 
+   To do so, we leverage the generic :code:`cudaq::sample` function, which returns a data type 
+   encoding the qubit measurement strings and the corresponding number of times that string 
+   was observed (here the default number of shots is used, :code:`1000`).
+
+   The following example illustrates how to compile and execute this code.
+
+   .. code:: bash 
+
+      nvq++ static_kernel.cpp -o ghz.x
+      ./ghz.x
\ No newline at end of file
diff --git a/pr-2241/_sources/using/examples/multi_control.rst.txt b/pr-2241/_sources/using/examples/multi_control.rst.txt
new file mode 100644
index 0000000000..ae8123cf44
--- /dev/null
+++ b/pr-2241/_sources/using/examples/multi_control.rst.txt
@@ -0,0 +1,32 @@
+Multi-control Synthesis 
+-------------------------
+
+Now let's take a look at how CUDA-Q allows one to control a general unitary 
+on an arbitrary number of control qubits. 
+
+.. tab:: Python
+
+   Our first option is to describe our general unitary by another pre-defined
+   CUDA-Q kernel. 
+
+   .. literalinclude:: ../../examples/python/multi_controlled_operations.py
+      :language: python
+      :start-after: [Begin OptionA]
+      :end-before: [End OptionA]
+
+   Alternatively, one may pass multiple arguments for control qubits or vectors
+   to any controlled operation.
+
+   .. literalinclude:: ../../examples/python/multi_controlled_operations.py
+      :language: python
+      :start-after: [Begin OptionB]
+      :end-before: [End OptionB]
+
+
+.. tab:: C++ 
+
+   For this scenario, our general unitary can be described by another pre-defined 
+   CUDA-Q kernel expression. 
+
+   .. literalinclude:: ../../examples/cpp/basics/multi_controlled_operations.cpp
+      :language: cpp
\ No newline at end of file
diff --git a/pr-2241/_sources/using/examples/multi_gpu_workflows.rst.txt b/pr-2241/_sources/using/examples/multi_gpu_workflows.rst.txt
new file mode 100644
index 0000000000..d6ce73bac3
--- /dev/null
+++ b/pr-2241/_sources/using/examples/multi_gpu_workflows.rst.txt
@@ -0,0 +1,155 @@
+Multi-GPU Workflows
+===================
+
+There are many backends available with CUDA-Q which enable seamless
+switching between GPUs, QPUs and CPUs and also allow for workflows
+involving multiple architectures working in tandem.
+
+Available Targets
+-------------------
+
+-  **`qpp-cpu`**: The QPP based CPU backend which is multithreaded to
+   maximize the usage of available cores on your system.
+
+-  **`nvidia`**: GPU-accelerated state-vector based backend which accelerates quantum circuit
+   simulation on NVIDIA GPUs powered by cuQuantum.
+
+-  **`nvidia-mgpu`**: Allows for scaling circuit simulation on multiple GPUs.
+
+-  **`nvidia-mqpu`**: Enables users to program workflows utilizing
+   multiple virtual quantum processors in parallel, where each QPU is simulated by the `nvidia` backend.
+
+-  **`remote-mqpu`**: Enables users to program workflows utilizing
+   multiple virtual quantum processors in parallel, where the backend used to simulate each QPU is configurable.
+
+Please see :doc:`../backends/backends` for a full list of all available backends. 
+Below we explore how to effectively utilize multiple CUDA-Q targets with the same GHZ state preparation code
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
+    :language: python
+    :start-after: [Begin state]
+    :end-before: [End state]
+
+You can execute the code by running a statevector simulator on your CPU:
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
+    :language: python
+    :start-after: [Begin CPU]
+    :end-before: [End CPU]
+
+.. parsed-literal::
+
+    { 00:475 11:525 }
+
+You will notice a speedup of up to **2500x** in executing the circuit below on
+NVIDIA GPUs vs CPUs:
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
+    :language: python
+    :start-after: [Begin GPU]
+    :end-before: [End GPU]
+
+.. parsed-literal::
+
+    { 0000000000000000000000000:510 1111111111111111111111111:490 }
+
+If one incrementally increases the qubit count, we
+reach a limit where the memory required is beyond the capabilities of a
+single GPU: A :math:`n` qubit quantum state has :math:`2^n` complex amplitudes, each
+of which require 8 bytes of memory to store. Hence the total memory
+required to store a :math:`n` qubit quantum state is :math:`8` bytes
+:math:`\times 2^n`. For :math:`n = 30` qubits, this is roughly :math:`8`
+GB but for :math:`n = 40`, this exponentially increases to 8700 GB.
+
+
+Parallelization across Multiple Processors
+---------------------------------------------
+
+The ``nvidia-mgpu`` target allows for memory from additional
+GPUs to be pooled enabling qubit counts to be scaled.
+Execution on the ``nvidia-mgpu`` backend is enabled via ``mpirun``. Users
+need to create a ``.py`` file with their code and run the command below
+in terminal:
+
+``mpirun -np 4 python3 test.py``
+
+where 4 is the number of GPUs one has access to and ``test`` is the file
+name chosen.
+
+The ``nvidia-mqpu`` target uses a statevector simulator to simulate execution 
+on each virtual QPU.
+The ``remote-mqpu`` platform allows to freely configure what backend is used 
+for each platform QPU. 
+For more information about the different platform targets, please take a look at
+:doc:`../backends/platform`.
+
+Batching Hamiltonian Terms
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Expectation value computations of multi-term Hamiltonians can be
+asynchronously processed via the ``mqpu`` platform.
+
+.. image:: ../../examples/python/tutorials/images/hsplit.png
+
+For workflows involving multiple GPUs, save the code below in a
+``filename.py`` file and execute via:
+``mpirun -np n python3 filename.py`` where ``n`` is an integer
+specifying the number of GPUs you have access to.
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/hamiltonian_batching.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    mpi is initialized?  True
+    rank 0 num_ranks 1
+
+
+Circuit Batching
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Execution of parameterized circuits with different parameters can be
+executed asynchronously via the ``mqpu`` platform.
+
+.. image:: ../../examples/python/tutorials/images/circsplit.png
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin prepare]
+    :end-before: [End prepare]
+
+Let's time the execution on single GPU.
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin single]
+    :end-before: [End single]
+
+.. parsed-literal::
+
+    31.7 s ± 990 ms per loop (mean ± std. dev. of 7 runs, 1 loop each)
+
+Now let's try to time multi GPU run.
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin split]
+    :end-before: [End split]
+
+.. parsed-literal::
+
+    We have 10000 parameters which we would like to execute
+    We split this into 4 batches of 2500 , 2500 , 2500 , 2500
+
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin multiple]
+    :end-before: [End multiple]
+
+.. parsed-literal::
+
+    85.3 ms ± 2.36 ms per loop (mean ± std. dev. of 7 runs, 10 loops each)
+
diff --git a/pr-2241/_sources/using/examples/noisy_simulation.rst.txt b/pr-2241/_sources/using/examples/noisy_simulation.rst.txt
new file mode 100644
index 0000000000..bf008500a5
--- /dev/null
+++ b/pr-2241/_sources/using/examples/noisy_simulation.rst.txt
@@ -0,0 +1,65 @@
+Noisy Simulation
+-----------------
+
+CUDA-Q makes it simple to model noise within the simulation of your quantum program.
+Let's take a look at the various built-in noise models we support, before concluding with a brief example of a custom noise model constructed from user-defined Kraus Operators.
+
+The following code illustrates how to run a simulation with depolarization noise.
+
+.. tab:: Python
+   
+   .. literalinclude:: ../../examples/python/noise_depolarization.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_depolarization.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with amplitude damping noise.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_amplitude_damping.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_amplitude_damping.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with bit-flip noise.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_bit_flip.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_bit_flip.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with phase-flip noise.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_phase_flip.py
+      :language: python
+
+.. tab:: C++
+
+    .. literalinclude:: ../../examples/cpp/basics/noise_phase_flip.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with a custom noise model.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_kraus_operator.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_modeling.cpp
+      :language: cpp
\ No newline at end of file
diff --git a/pr-2241/_sources/using/examples/qaoa.rst.txt b/pr-2241/_sources/using/examples/qaoa.rst.txt
new file mode 100644
index 0000000000..de1db8d4df
--- /dev/null
+++ b/pr-2241/_sources/using/examples/qaoa.rst.txt
@@ -0,0 +1,22 @@
+Quantum Approximate Optimization Algorithm
+-------------------------------------------
+
+.. tab:: Python
+
+   Let's now see how we can implement the Quantum Approximate Optimization Algorithm (QAOA) to compute the Max-Cut of a rectangular graph by leveraging 
+   `cudaq:vqe`. For more on the QAOA algorithm and the Max-Cut problem, refer to 
+   `this paper <https://arxiv.org/abs/1411.4028>`__.
+
+   .. literalinclude:: ../../examples/python/qaoa_maxcut.py
+      :language: python
+
+.. tab:: C++
+
+   Let's now see how we can implement the Quantum Approximate Optimization Algorithm (QAOA) to compute the Max-Cut of a rectangular graph
+   For more on the QAOA algorithm and the Max-Cut problem, refer to 
+   `this paper <https://arxiv.org/abs/1411.4028>`__.
+
+   .. literalinclude:: ../../examples/cpp/algorithms/qaoa_maxcut.cpp
+      :language: cpp
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
\ No newline at end of file
diff --git a/pr-2241/_sources/using/examples/quantum_operations.rst.txt b/pr-2241/_sources/using/examples/quantum_operations.rst.txt
new file mode 100644
index 0000000000..3ce35eb098
--- /dev/null
+++ b/pr-2241/_sources/using/examples/quantum_operations.rst.txt
@@ -0,0 +1,175 @@
+Quantum Computing 101
+======================
+
+The fundamental unit of classical information storage, processing and
+transmission is the bit. Analogously, we define its quantum counterpart,
+a quantum bit or simply the qubit.
+
+Classical bits are transistor elements whose states can be altered to
+perform computations. Similarly qubits too have physical realizations
+within superconducting materials, ion-traps and photonic systems. We
+shall not concern ourselves with specific qubit architectures but rather
+think of them as systems which obey the laws of quantum mechanics and
+the mathematical language physicists have developed to describe the
+theory: linear algebra.
+
+Quantum States
+-----------------------------
+
+Information storage scales linearly if bits have a single state. Access
+to multiple states, namely a 0 and a 1 allows for information encoding
+to scale logarithmically. Similarly we define a qubit to have the states
+:math:`\ket{0}` and :math:`\ket{1}` in Dirac notation where:
+
+.. math:: \ket{0} = \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix}
+
+.. math:: \ket{1} = \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}
+
+Rather than just the two states each classical bit can be in,
+quantum theory allows one to explore linear combinations of states,
+also called superpositions:
+
+.. math::   \ket{\psi} = \alpha\ket{0} + \beta\ket{1} 
+
+where :math:`\alpha` and :math:`\beta` :math:`\in \mathbb{C}`. It is
+important to note that this is still the state of one qubit; 
+although we have two kets, they both represent a
+superposition state of one qubit.
+
+If we have two classical bits, the possible states we could encode
+information in would be 00, 01, 10 and 11. Correspondingly, multiple
+qubits can be combined and the possible combinations of their states
+used to process information.
+
+A two qubit system has four computational basis states:
+:math:`\ket{00}, \ket{01}, \ket{10}, \ket{11}`.
+
+More generally, the quantum state of a :math:`n` qubit system is written
+as a sum of :math:`2^n` possible basis states where the coefficients
+track the probability of the system collapsing into that state if a
+measurement is applied.
+
+For :math:`n = 500`, :math:`2^n \approx 10^{150}` which is greater than
+the number of atoms in the universe. Storing the complex numbers
+associated with :math:`2^{500}` amplitudes would not be feasible using
+bits and classical computations but nature seems to only require 500
+qubits to do so. The art of quantum computation is thus to build quantum
+systems that we can manipulate with fine precision such that evolving a
+large statevector can be offloaded onto a quantum computer.
+
+
+Quantum Gates
+-----------------------------
+
+We can manipulate the state of a qubit via quantum gates. 
+For example, the Pauli X gate allows us to flip the state of the qubit:
+
+.. math::  X \ket{0} = \ket{1} 
+
+.. math::  \begin{bmatrix} 0 & 1 \\ 1 & 0 \end{bmatrix} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} = \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix} 
+
+.. literalinclude:: ../../snippets/python/using/examples/pauli_x_gate.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    { 1:1000 }
+
+The Hadamard gate allows us to put the qubit in an equal superposition
+state:
+
+.. math::  H \ket{0} =  \tfrac{1}{\sqrt{2}} \ket{0} + \tfrac{1}{\sqrt{2}} \ket{1}  \equiv \ket{+}
+
+.. math:: \tfrac{1}{\sqrt{2}}\begin{bmatrix} 1 & 1 \\ 1 & -1 \end{bmatrix} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} = \tfrac{1}{\sqrt{2}} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} + \tfrac{1}{\sqrt{2}} \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}. 
+
+The probability of finding the qubit in the :math:`\ket{0}` or :math:`\ket{1}` state is hence
+:math:`\lvert \tfrac{1}{\sqrt{2}} \rvert ^2 = \tfrac{1}{2}`. Lets verify
+this with some code:
+
+.. literalinclude:: ../../snippets/python/using/examples/hadamard_gate.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    { 0:502 1:498 }
+
+For a qubit in a superposition state, quantum gates
+act linearly:
+
+.. math::    X (\alpha\ket{0} + \beta\ket{1}) = \alpha\ket{1} + \beta\ket{0} 
+
+As we evolve quantum states via quantum gates, the normalization
+condition requires that the sum of modulus squared of amplitudes must
+equal 1 at all times:
+
+.. math::   \ket{\psi} = \alpha\ket{0} + \beta\ket{1},          |\alpha|^2 + |\beta|^2 = 1. 
+
+This is to adhere to the conservation of probabilities which translates
+to a constraint on types of quantum gates we can define.
+For a general quantum state :math:`\ket{\psi}`, upholding the
+normalization condition requires quantum gates to be unitary, that is
+:math:`U^{\dagger}U = U^{*^{T}}U = \mathbb{I}`.
+
+Just like the single-qubit gates above, we can define 
+multi-qubit gates to act on multiple-qubits.
+The controlled-NOT or CNOT gate, for example, acts on 2 qubits: the control qubit and
+the target qubit. Its effect is to flip the target if the control is in
+the excited :math:`\ket{1}` state.
+
+.. literalinclude:: ../../snippets/python/using/examples/cnot_gate.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    { 11:1000 }
+    
+
+The CNOT gate in matrix notation is represented as
+
+.. math::  CNOT \equiv \begin{bmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & 0 & 1 \\ 0 & 0 & 1 & 0 \end{bmatrix} 
+
+and one can check that :math:`CNOT^\dagger CNOT = \mathbb{I}`.
+Its effect on the computational basis states is:
+
+.. math::  CNOT\ket{00} = \ket{00} 
+
+.. math::  CNOT\ket{01} = \ket{01} 
+
+.. math::  CNOT\ket{10} = \ket{11} 
+
+.. math::  CNOT\ket{11} = \ket{10} 
+
+For a full list of gates supported in CUDA-Q see :doc:`../../api/default_ops`. 
+
+Measurements
+-----------------------------
+
+Quantum theory is probabilistic and hence requires statistical inference
+to derive observations. Prior to measurement, the state of a qubit is
+all possible combinations of :math:`\alpha` and :math:`\beta` and upon
+measurement, wavefunction collapse yields either a classical 0 or 1.
+
+The mathematical theory devised to explain quantum phenomena tells us
+that the probability of observing the qubit in the state
+:math:`\ket{0}` or :math:`\ket{1}`, yielding a classical 0 or 1, is
+:math:`\lvert \alpha \rvert ^2` or :math:`\lvert \beta \rvert ^2`, respectively. 
+
+As we see in the example of the Hadamard gate above,
+the result 0 or 1 each is yielded roughly 50% of the times as predicted 
+by the postulate stated above thus proving the theory.
+
+Classically, we cannot encode information within states such as 00 + 11
+but quantum mechanics allows us to write linear superpositions
+
+.. math::   \ket{\psi} = \alpha_{00}\ket{00} + \alpha_{01}\ket{01} + \alpha_{10}\ket{10} + \alpha_{11}\ket{11}
+
+where the probability of measuring :math:`x = 00, 01, 10, 11` occurs
+with probability :math:`\lvert \alpha_{x} \rvert ^2` with the
+normalization condition that
+:math:`\sum_{x \in \{ 0,1 \}^2} \lvert \alpha_{x} \rvert ^2 = 1`.
diff --git a/pr-2241/_sources/using/examples/vqe.rst.txt b/pr-2241/_sources/using/examples/vqe.rst.txt
new file mode 100644
index 0000000000..08b0e5755c
--- /dev/null
+++ b/pr-2241/_sources/using/examples/vqe.rst.txt
@@ -0,0 +1,29 @@
+Variational Quantum Eigensolver
+--------------------------------
+
+The Variational Quantum Eigensolver (VQE) algorithm, originally proposed in
+`this publication <https://arxiv.org/abs/1304.3061>`__, 
+is a hybrid algorithm that can make use of both quantum and classical resources.
+
+Let's take a look at how we can use CUDA-Q's built-in `vqe` module to run our own custom VQE routines! 
+Given a parameterized quantum kernel, a system spin Hamiltonian, and one of CUDA-Q's optimizers, 
+`cudaq.vqe` will find and return the optimal set of parameters that minimize the energy, <Z>, of the system.
+
+The code block below represents the contents of a file titled `simple_vqe.py`. 
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/simple_vqe.py
+      :language: python
+
+.. tab:: C++
+   
+   .. literalinclude:: ../../examples/cpp/algorithms/vqe_h2.cpp
+      :language: cpp
+
+Let's look at a more advanced variation of the previous example.
+
+As an alternative to `cudaq.vqe`, we can also use the `cudaq.optimizers` suite on its own to write custom variational algorithm routines. Much of this can be slightly modified for use with third-party optimizers, such as `scipy`.
+
+.. literalinclude:: ../../examples/python/advanced_vqe.py
+   :language: python
\ No newline at end of file
diff --git a/pr-2241/_sources/using/extending/cudaq_ir.rst.txt b/pr-2241/_sources/using/extending/cudaq_ir.rst.txt
new file mode 100644
index 0000000000..070f6369f2
--- /dev/null
+++ b/pr-2241/_sources/using/extending/cudaq_ir.rst.txt
@@ -0,0 +1,260 @@
+Working with the CUDA-Q IR
+********************************
+Let's see the output of :code:`nvq++` in verbose mode. Consider a simple code like the one below, saved to file :code:`simple.cpp`.
+
+.. code-block:: console 
+
+    #include <cudaq.h>
+
+    struct ghz {
+      void operator()(int N) __qpu__ {
+        cudaq::qvector q(N);
+        h(q[0]);
+        for (int i = 0; i < N - 1; i++) {
+          x<cudaq::ctrl>(q[i], q[i + 1]);
+        }
+        mz(q);
+      }
+    };
+
+    int main() { ... }
+
+ We see the following output from :code:`nvq++` verbose mode (up to some absolute paths).
+
+.. code-block:: console 
+
+    $ nvq++ simple.cpp -v --save-temps
+    
+    cudaq-quake --emit-llvm-file simple.cpp -o simple.qke
+    cudaq-opt --pass-pipeline=builtin.module(canonicalize,lambda-lifting,canonicalize,apply-op-specialization,kernel-execution,inline{default-pipeline=func.func(indirect-to-direct-calls)},func.func(quake-add-metadata),device-code-loader{use-quake=1},expand-measurements,func.func(lower-to-cfg),canonicalize,cse) simple.qke -o simple.qke.LpsXpu
+    cudaq-translate --convert-to=qir simple.qke.LpsXpu -o simple.ll.p3De4L
+    fixup-linkage.pl simple.qke simple.ll
+    llc --relocation-model=pic --filetype=obj -O2 simple.ll.p3De4L -o simple.qke.o
+    llc --relocation-model=pic --filetype=obj -O2 simple.ll -o simple.classic.o
+    clang++ -L/usr/lib/gcc/x86_64-linux-gnu/12 -L/usr/lib64 -L/lib/x86_64-linux-gnu -L/lib64 -L/usr/lib/x86_64-linux-gnu -L/lib -L/usr/lib -L/usr/local/cuda/lib64/stubs -r simple.qke.o simple.classic.o -o simple.o
+    clang++ -Wl,-rpath,lib -Llib -L/usr/lib/gcc/x86_64-linux-gnu/12 -L/usr/lib64 -L/lib/x86_64-linux-gnu -L/lib64 -L/usr/lib/x86_64-linux-gnu -L/lib -L/usr/lib -L/usr/local/cuda/lib64/stubs simple.o -lcudaq -lcudaq-common -lcudaq-mlir-runtime -lcudaq-builder -lcudaq-ensmallen -lcudaq-nlopt -lcudaq-spin -lcudaq-em-default -lcudaq-platform-default -lnvqir -lnvqir-qpp
+
+This workflow orchestration is represented in the figure below: 
+
+.. image:: ../../_static/nvqpp_workflow.png
+
+We start by mapping CUDA-Q C++ kernel representations (structs, lambdas, and free functions) 
+to the Quake dialect. Since we added :code:`--save-temps`, 
+we can look at the IR code that was produced. The base Quake file, :code:`simple.qke`, contains the following: 
+
+.. code-block:: console 
+
+    module attributes {qtx.mangled_name_map = {__nvqpp__mlirgen__ghz = "_ZN3ghzclEi"}} {
+        func.func @__nvqpp__mlirgen__ghz(%arg0: i32) attributes {"cudaq-entrypoint", "cudaq-kernel"} {
+           %alloca = memref.alloca() : memref<i32>
+           memref.store %arg0, %alloca[] : memref<i32>
+           %0 = memref.load %alloca[] : memref<i32>
+           %1 = arith.extsi %0 : i32 to i64
+           %2 = quake.alloca(%1 : i64) !quake.veq<?>
+           %c0_i32 = arith.constant 0 : i32
+           %3 = arith.extsi %c0_i32 : i32 to i64
+           %4 = quake.extract_ref %2[%3] : (!quake.veq<?>, i64) -> !quake.ref
+           quake.h %4 : (!quake.ref) -> ()
+           cc.scope {
+            %c0_i32_0 = arith.constant 0 : i32
+            %alloca_1 = memref.alloca() : memref<i32>
+            memref.store %c0_i32_0, %alloca_1[] : memref<i32>
+            cc.loop while {
+                %6 = memref.load %alloca_1[] : memref<i32>
+                %7 = memref.load %alloca[] : memref<i32>
+                %c1_i32 = arith.constant 1 : i32
+                %8 = arith.subi %7, %c1_i32 : i32
+                %9 = arith.cmpi slt, %6, %8 : i32
+                cc.condition %9
+            } do {
+              cc.scope {
+                %6 = memref.load %alloca_1[] : memref<i32>
+                %7 = arith.extsi %6 : i32 to i64
+                %8 = quake.extract_ref %2[%7] : (!quake.veq<?>, i64) -> !quake.ref
+                %9 = memref.load %alloca_1[] : memref<i32>
+                %c1_i32 = arith.constant 1 : i32
+                %10 = arith.addi %9, %c1_i32 : i32
+                %11 = arith.extsi %10 : i32 to i64
+                %12 = quake.extract_ref %2[%11] : (!quake.veq<?>, i64) -> !quake.ref
+                quake.x [%8] %12 : (!quake.ref, !quake.ref) -> ()
+              }
+              cc.continue
+            } step {
+                %6 = memref.load %alloca_1[] : memref<i32>
+                %c1_i32 = arith.constant 1 : i32
+                %7 = arith.addi %6, %c1_i32 : i32
+                memref.store %7, %alloca_1[] : memref<i32>
+            }
+            }
+            %5 = quake.mz %2 : (!quake.veq<?>) -> !cc.stdvec<i1>
+            return
+        }
+    }
+
+This base Quake file is unoptimized and unchanged. It is produced by the 
+:code:`cudaq-quake` tool, which also allows us to output the full LLVM IR representation 
+for the code. This LLVM IR is classical-only, and is directly produced by :code:`clang++` 
+code-generation. The LLVM IR file :code:`simple.ll` contains the CUDA-Q kernel 
+:code:`operator()(Args...)` LLVM function, with a mangled name. Ultimately, we 
+want to replace this function with our own MLIR-generated function. 
+
+Next, the :code:`cudaq-opt` tool is invoked on the :code:`simple.qke` file. This runs an
+MLIR pass pipeline that canonicalizes and optimizes the code. It will also process quantum 
+lambdas, lift those lambdas to functions, and synthesis adjoint and controlled versions of 
+CUDA-Q kernel functions if necessary. The most important pass that this step applies is the 
+:code:`kernel-execution` pass, which synthesizes a new entry point LLVM function with the 
+same name and signature as the original :code:`operator()(Args...)` call function in the 
+classical :code:`simple.ll` file. We also extract all Quake code representations as strings
+and register them with the CUDA-Q runtime for runtime IR introspection. 
+
+After :code:`cudaq-opt`, the :code:`cudaq-translate` tool is used to lower the transformed 
+Quake representation to an LLVM IR representation, specifically the QIR. We finish by lowering 
+this representation to object code via standard LLVM tools (e.g. :code:`llc`), and merge all 
+object files into a single object file, ensuring that our new mangled :code:`operator()(Args...)` 
+call is injected first, thereby overwriting the original. Finally, based on user compile flags, 
+we configure the link line with specific libraries that implement the :code:`quantum_platform` 
+(here the :code:`libcudaq-platform-default.so`) and NVQIR circuit simulator backend (the 
+:code:`libnvqir-qpp.so` Q++ CPU-only simulation backend). These latter libraries are controlled 
+via the :code:`--platform` and :code:`--target` compiler flags. 
+
+.. image:: ../../_static/dialects.png
+
+The above figure demonstrate the MLIR dialects involved and the overall workflow mapping 
+high-level language constructs to lower-level MLIR dialect code, and ultimately LLVM IR. 
+
+CUDA-Q also provides value-semantics form of Quake for static circuit
+representation. This dialect directly enables robust circuit 
+optimizations via data-flow analysis of the representative circuit. This dialect 
+is typically produced just-in-time when the structure of the circuit is fully known. 
+
+You will notice that there are a number of CUDA-Q executable tools installed as part 
+of this open beta release. These tools are directly related to the generation, 
+processing, optimization, and lowering of the core :code:`nvq++` compiler representations.
+The tools available are 
+
+1. :code:`cudaq-quake` - Lower C++ to Quake, can also output classical LLVM IR file
+2. :code:`cudaq-opt` - Process Quake with various MLIR Passes
+3. :code:`cudaq-translate` - Lower Quake to external representations like QIR
+
+CUDA-Q and :code:`nvq++` rely on Quake for the core quantum intermediate representation.
+Quake represents an IR closer to the CUDA-Q source language and models qubits and
+quantum instructions via memory semantics. Quake can be fully dynamic and in
+that sense represents a quantum circuit template or generator. With runtime 
+arguments fully specified, Quake code can be used to generate or synthesize
+a fully known quantum circuit. The value semantics form of Quake can thus be
+used as a representation for fully known
+or synthesized quantum circuits. Its utility, therefore, lies in its ability to 
+optimize quantum code. It departs from the memory semantics model of Quake and 
+expresses the flow of quantum information explicitly as MLIR values.
+This approach makes it easier for finding circuit patterns and leveraging it for common 
+optimization tasks. 
+
+To demonstrate how these tools work together, let's take the simple GHZ CUDA-Q 
+program and lower the kernel from C++ to Quake, synthesize that Quake code, 
+and produce QIR. Recall the code snippet for the kernel
+
+.. code-block:: cpp 
+
+    // Define a quantum kernel
+    struct ghz {
+      auto operator()() __qpu__ {
+        cudaq::qarray<5> q;
+        h(q[0]);
+        for (int i = 0; i < 4; i++) 
+          x<cudaq::ctrl>(q[i], q[i + 1]);
+        mz(q);
+      }
+    };
+
+Using the toolchain, we can lower this directly to QIR,
+
+.. code-block:: console
+
+    cudaq-quake simple.cpp | cudaq-opt --canonicalize | cudaq-translate --convert-to=qir 
+
+which prints: 
+
+.. code-block:: console 
+
+    ; ModuleID = 'LLVMDialectModule'
+    source_filename = "LLVMDialectModule"
+    target datalayout = "e-m:e-p270:32:32-p271:32:32-p272:64:64-i64:64-f80:128-n8:16:32:64-S128"
+    target triple = "x86_64-unknown-linux-gnu"
+
+    %Array = type opaque
+    %Qubit = type opaque
+    %Result = type opaque
+
+    declare void @invokeWithControlQubits(i64, void (%Array*, %Qubit*)*, ...) local_unnamed_addr
+
+    declare void @__quantum__qis__x__ctl(%Array*, %Qubit*)
+
+    declare %Result* @__quantum__qis__mz(%Qubit*) local_unnamed_addr
+
+    declare void @__quantum__rt__qubit_release_array(%Array*) local_unnamed_addr
+
+    declare i64 @__quantum__rt__array_get_size_1d(%Array*) local_unnamed_addr
+
+    declare void @__quantum__qis__h(%Qubit*) local_unnamed_addr
+
+    declare i8* @__quantum__rt__array_get_element_ptr_1d(%Array*, i64) local_unnamed_addr
+
+    declare %Array* @__quantum__rt__qubit_allocate_array(i64) local_unnamed_addr
+
+    define void @__nvqpp__mlirgen__ghz(i32 %0) local_unnamed_addr {
+      %2 = sext i32 %0 to i64
+      %3 = tail call %Array* @__quantum__rt__qubit_allocate_array(i64 %2)
+      %4 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 0)
+      %5 = bitcast i8* %4 to %Qubit**
+      %6 = load %Qubit*, %Qubit** %5, align 8
+      tail call void @__quantum__qis__h(%Qubit* %6)
+      %7 = add i32 %0, -1
+      %8 = icmp sgt i32 %7, 0
+      br i1 %8, label %.lr.ph.preheader, label %._crit_edge
+
+    .lr.ph.preheader:                                 ; preds = %1
+      %wide.trip.count = zext i32 %7 to i64
+      br label %.lr.ph
+
+    .lr.ph:                                           ; preds = %.lr.ph.preheader, %.lr.ph
+      %indvars.iv = phi i64 [ 0, %.lr.ph.preheader ], [ %indvars.iv.next, %.lr.ph ]
+      %9 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 %indvars.iv)
+      %10 = bitcast i8* %9 to %Qubit**
+      %11 = load %Qubit*, %Qubit** %10, align 8
+      %indvars.iv.next = add nuw nsw i64 %indvars.iv, 1
+      %12 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 %indvars.iv.next)
+      %13 = bitcast i8* %12 to %Qubit**
+      %14 = load %Qubit*, %Qubit** %13, align 8
+      tail call void (i64, void (%Array*, %Qubit*)*, ...) @invokeWithControlQubits(i64 1, void (%Array*, %Qubit*)* nonnull @__quantum__qis__x__ctl, %Qubit* %11, %Qubit* %14)
+      %exitcond.not = icmp eq i64 %indvars.iv.next, %wide.trip.count
+      br i1 %exitcond.not, label %._crit_edge, label %.lr.ph
+
+    ._crit_edge:                                      ; preds = %.lr.ph, %1
+      %15 = tail call i64 @__quantum__rt__array_get_size_1d(%Array* %3)
+      %16 = icmp sgt i64 %15, 0
+      br i1 %16, label %.lr.ph3, label %._crit_edge4
+
+    .lr.ph3:                                          ; preds = %._crit_edge, %.lr.ph3
+      %17 = phi i64 [ %22, %.lr.ph3 ], [ 0, %._crit_edge ]
+      %18 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 %17)
+      %19 = bitcast i8* %18 to %Qubit**
+      %20 = load %Qubit*, %Qubit** %19, align 8
+      %21 = tail call %Result* @__quantum__qis__mz(%Qubit* %20)
+      %22 = add nuw nsw i64 %17, 1
+      %exitcond5.not = icmp eq i64 %22, %15
+      br i1 %exitcond5.not, label %._crit_edge4, label %.lr.ph3
+
+    ._crit_edge4:                                     ; preds = %.lr.ph3, %._crit_edge
+      tail call void @__quantum__rt__qubit_release_array(%Array* %3)
+      ret void
+    }
+
+    !llvm.module.flags = !{!0}
+
+    !0 = !{i32 2, !"Debug Info Version", i32 3}
+
+
+Note that the results of each tool can be piped to further tools, creating a
+composable pipeline of compiler lowering tools. 
+
+
diff --git a/pr-2241/_sources/using/extending/extending.rst.txt b/pr-2241/_sources/using/extending/extending.rst.txt
new file mode 100644
index 0000000000..fd755f7969
--- /dev/null
+++ b/pr-2241/_sources/using/extending/extending.rst.txt
@@ -0,0 +1,9 @@
+Extending CUDA-Q
+****************************
+
+.. toctree::
+  :maxdepth: 1
+
+  Create a new NVQIR Simulator <nvqir_simulator.rst>
+  Working with CUDA-Q IR <cudaq_ir.rst>
+  Create an MLIR Pass for CUDA-Q <mlir_pass.rst>
diff --git a/pr-2241/_sources/using/extending/mlir_pass.rst.txt b/pr-2241/_sources/using/extending/mlir_pass.rst.txt
new file mode 100644
index 0000000000..8d61325ea1
--- /dev/null
+++ b/pr-2241/_sources/using/extending/mlir_pass.rst.txt
@@ -0,0 +1,97 @@
+Create your own CUDA-Q Compiler Pass 
+******************************************
+
+The CUDA-Q IR can be transformed, analyzed, or optimized 
+using standard MLIR patterns and tools. CUDA-Q provides a registration 
+mechanism for the :code:`cudaq-opt` tool that allows one to create, load, and 
+use custom MLIR passes on Quake code. 
+
+CUDA-Q MLIR Passes can only be created within an existing CUDA-Q 
+development environment. Therefore, you must clone the repository and add your 
+Pass code as part of the existing CUDA-Q CMake system. 
+
+As an example, clone the repository and add the following directory structure 
+under :code:`lib`, :code:`lib/Plugins/MyCustomPlugin/`. Within this directory create a 
+:code:`CMakeLists.txt` file and a :code:`MyCustomPlugin.cpp` file. In the CMake file, 
+add the following: 
+
+.. code:: cmake 
+
+    add_llvm_pass_plugin(MyCustomPlugin MyCustomPlugin.cpp)
+
+Creating a CUDA-Q IR pass starts with the implementation of an 
+:code:`mlir::OperationPass`. A full discussion of the MLIR Pass infrastructure 
+is beyond the scope of this document; please see 
+`MLIR Passes <https://mlir.llvm.org/docs/PassManagement>`_. To create such 
+a pass, start with the following template in the :code:`MyCustomPlugin.cpp` file:
+
+.. code:: cpp 
+    
+    #include "cudaq/Optimizer/Dialect/Quake/QuakeDialect.h"
+    #include "cudaq/Optimizer/Dialect/Quake/QuakeOps.h"
+    #include "cudaq/Support/Plugin.h"
+    #include "mlir/Rewrite/FrozenRewritePatternSet.h"
+    #include "mlir/Transforms/DialectConversion.h"
+
+    // Here is an example MLIR Pass that one can write externally and 
+    // use via the cudaq-opt tool, with the --load-cudaq-plugin flag. 
+    // The pass here is simple, replace Hadamard operations with S operations. 
+
+    using namespace mlir;
+
+    namespace {
+
+    struct ReplaceH : public OpRewritePattern<quake::HOp> {
+      using OpRewritePattern::OpRewritePattern;
+      LogicalResult matchAndRewrite(quake::HOp hOp,
+                                    PatternRewriter &rewriter) const override {
+        rewriter.replaceOpWithNewOp<quake::SOp>(
+            hOp, hOp.isAdj(), hOp.getParameters(), hOp.getControls(),
+            hOp.getTargets());
+        return success();
+      }
+    };
+
+    class CustomPassPlugin
+        : public PassWrapper<CustomPassPlugin, OperationPass<func::FuncOp>> {
+    public:
+      MLIR_DEFINE_EXPLICIT_INTERNAL_INLINE_TYPE_ID(CustomPassPlugin)
+  
+      llvm::StringRef getArgument() const override { return "cudaq-custom-pass"; }
+
+      void runOnOperation() override {
+        auto circuit = getOperation();
+        auto ctx = circuit.getContext();
+
+        RewritePatternSet patterns(ctx);
+        patterns.insert<ReplaceH>(ctx);
+        ConversionTarget target(*ctx);
+        target.addLegalDialect<quake::QuakeDialect>();
+        target.addIllegalOp<quake::HOp>();
+        if (failed(applyPartialConversion(circuit, target, std::move(patterns)))) {
+          circuit.emitOpError("simple pass failed");
+          signalPassFailure();
+        }
+      }
+    };
+
+    } // namespace
+
+    CUDAQ_REGISTER_MLIR_PASS(CustomPassPlugin)
+
+This example serves as a very simple template for creating custom MLIR 
+Passes that analyze the CUDA-Q Quake representation and perform 
+some general transformation. In this example, we create a rewrite pattern 
+that replaces :code:`Hadamard` operations with :code:`S` operations. 
+
+Ensure that :code:`add_subdirectory(Plugins)` is in the :code:`lib/CMakeLists.txt` file, 
+and also that there is a :code:`lib/Plugins/CMakeLists.txt` file that adds your 
+plugin directory with :code:`add_subdirectory`.
+
+Then build CUDA-Q and you will have a :code:`MyCustomPlugin.so` plugin library 
+in the install. You can load the plugin and use it with :code:`cudaq-opt` as follows: 
+
+.. code:: bash 
+
+    cudaq-opt --load-cudaq-plugin MyCustomPlugin.so file.qke -cudaq-custom-pass
+
diff --git a/pr-2241/_sources/using/extending/nvqir_simulator.rst.txt b/pr-2241/_sources/using/extending/nvqir_simulator.rst.txt
new file mode 100644
index 0000000000..899d2989c6
--- /dev/null
+++ b/pr-2241/_sources/using/extending/nvqir_simulator.rst.txt
@@ -0,0 +1,172 @@
+Extending CUDA-Q with a new Simulator
+*******************************************
+
+Backend circuit simulation in CUDA-Q is enabled via the 
+NVQIR library (:code:`libnvqir`). CUDA-Q code is ultimately lowered 
+to the LLVM IR in a manner that is adherent to the `QIR specification <https://qir-alliance.org>`_.
+NVQIR provides function implementations for the various declared functions 
+in the specification, which in turn delegate to an extensible simulation 
+architecture. 
+
+The primary extension point for NVQIR is the :code:`CircuitSimulator` class. This class
+exposes an API that enables qubit allocation and deallocation, quantum operation 
+invocation, and measurement and sampling. Subtypes of this class are free to 
+override these methods to affect simulation of the quantum code in any 
+simulation-strategy-specific manner (e.g., state vector, tensor network, etc.). Moreover, 
+subtypes are free to implement simulators that leverage classical accelerated computing. 
+
+In this document, we'll detail this simulator interface and walk through how to extend it for new types of simulation. 
+
+:code:`CircuitSimulator`
+------------------------
+
+The :code:`CircuitSimulator` type is defined in :code:`runtime/nvqir/CircuitSimulator.h`. It
+exposes a public API to `libnvqir` that is immediately subclassed in the :code:`CircuitSimulatorBase` 
+type. This type is templated on the floating point type used in the simulator's computations (e.g. :code:`double,float`).
+This templated type handles a lot of the base functionality required for allocating and deallocated qubits, 
+as well as measurement, sampling, and observation under a number of execution contexts. 
+This is the type that downstream simulation developers should extend. 
+
+The actual definition of the quantum state data structure, and its overall evolution are 
+left as tasks for :code:`CircuitSimulatorBase` subclasses. Examples of simulation subtypes can be found 
+in :code:`runtime/nvqir/qpp/QppCircuitSimulator.cpp` or :code:`runtime/nvqir/custatevec/CuStateVecCircuitSimulator.cpp`.
+The :code:`QppCircuitSimulator` models the state vector using the `Q++ <https://github.com/softwareqinc/qpp>`_ library, which 
+leverages the :code:`Eigen::Matrix` type and OpenMP threading for matrix-vector operations. 
+The :code:`CuStateVecCircuitSimulator` type models the state vector on an NVIDIA GPU device 
+by leveraging the cuQuantum library. 
+
+The key methods that need to be overridden by subtypes of :code:`CircuitSimulatorBase` are as follows:
+
+.. list-table:: Required Circuit Simulator Subtype Method Overrides
+
+    * - Method Name 
+      - Method Arguments
+      - Method Description
+    * - :code:`addQubitToState`
+      - :code:`void` 
+      - Add a qubit to the underlying state representation.
+    * - :code:`addQubitsToState`
+      - :code:`nQubits : std::size_t` 
+      - Add the specified number of qubits to the underlying state representation.
+    * - :code:`resetQubit`
+      - :code:`qubitIdx : std::size_t`
+      - Reset the state of the qubit at the given index to :code:`|0>`
+    * - :code:`resetQubitStateImpl`
+      - :code:`void` 
+      - Clear the entire state representation (reset to 0 qubits).
+    * - :code:`applyGate`
+      - :code:`task : GateApplicationTask`
+      - Apply the specified gate described by the :code:`GateApplicationTask`. This type encodes the control and target qubit indices, optional rotational parameters, and the gate matrix data. 
+    * - :code:`measureQubit`
+      - :code:`qubitIdx : std::size_t -> bool` (returns bit result as bool)
+      - Measure the qubit, produce a bit result, collapse the state.
+    * - :code:`sample`
+      - :code`qubitIdxs : std::vector<std::size_t>, shots : int`
+      - Sample the current multi-qubit state on the provided qubit indices over a certain number of shots
+    * - :code:`name`
+      - :code:`void`
+      - Return the name of this CircuitSimulator, must be the same as the name used in :code:`nvq++ -qpu NAME ...`
+
+To extend a subtype class, you will need to create a new :code:`cpp` implementation file with the same name as your 
+subtype class name. In this file, you will subclass the :code:`CircuitSimulatorBase<FloatType>` and implement the methods in 
+the above table. Finally, the subclass must be registered with the NVQIR library so that it 
+can be picked up and used when a user specifies :code:`nvq++ --target mySimulator ...` from the command line (or :code:`cudaq.set_target('mySimulator')` in Python.)
+Type registration can be performed with a provided NVQIR macro, 
+
+.. code:: cpp 
+
+    NVQIR_REGISTER_SIMULATOR(MySimulatorClassName, mySimulator)
+
+where :code:`MySimulatorClassName` is the name of your subtype, and :code:`mySimulator` is the 
+same name as what :code:`MySimulatorClassName::name()` returns, and what you desire the 
+:code:`-qpu NAME` name to be. 
+
+A further requirement is that the code be compiled into its own standalone shared library 
+with name :code:`libnvqir-NAME.{so,dylib}`, where NAME is the 
+same name as what :code:`MySimulatorClassName::name()` returns, and what you desire the 
+:code:`-qpu NAME` name to be. You will also need to create a :code:`NAME.config` file that 
+contains the following contents 
+
+.. code:: bash 
+
+    NVQIR_SIMULATION_BACKEND="NAME"
+
+The library must be installed in :code:`$CUDA_QUANTUM_PATH/lib` and the configuration file 
+must be installed to :code:`$CUDA_QUANTUM_PATH/platforms`.
+
+Let's see this in action 
+------------------------
+
+CUDA-Q provides some CMake utilities to make the creation of your new simulation library 
+easier. Specifically, by using :code:`find_package(NVQIR)`, you'll get access to a :code:`nvqir_add_backend` function
+that will automate much of the boilerplate for creating your library and configuration file.
+
+Let's assume you want a simulation subtype named :code:`MySimulator`. You can create a folder or 
+repository for this code called :code:`my-simulator` and add :code:`MySimulator.cpp` and 
+:code:`CMakeLists.txt` files. Fill the CMake file with the following: 
+
+.. code:: cmake 
+
+    cmake_minimum_required(VERSION 3.24 FATAL_ERROR)
+    project(DemoCreateNVQIRBackend VERSION 1.0.0 LANGUAGES CXX)
+    find_package(NVQIR REQUIRED)
+    nvqir_add_backend(MySimulator MySimulator.cpp "")
+
+and then fill out your :code:`MySimulator.cpp` file with your subtype implementation. For example, 
+
+.. code:: cpp
+
+    #include "CircuitSimulator.h"
+
+    namespace {
+
+      class MySimulator : public nvqir::CircuitSimulatorBase<double> {
+
+      protected:
+        /// @brief Grow the state vector by one qubit.
+        void addQubitToState() override { ... }
+
+        /// @brief Grow the state vector by `count` qubit.
+        void addQubitsToState(std::size_t count) override { ... }
+
+        /// @brief Reset the qubit state.
+        void resetQubitStateImpl() override { ... }
+
+        /// @brief Apply the given gate
+        void applyGate(const GateApplicationTask &task) override { ... }
+
+      public:
+        MySimulator() = default;
+        virtual ~MySimulator() = default;
+        
+        bool measureQubit(std::size_t qubitIdx) override { ... }
+
+        void resetQubit(std::size_t &qubitIdx) override { ... }
+
+        cudaq::SampleResult sample(std::vector<std::size_t> &measuredBits,
+                              int shots) override { ... }
+
+        const std::string_view name() const override { return "MySimulator"; }
+      
+      };
+
+    } // namespace
+
+    /// Register this Simulator with NVQIR.
+    NVQIR_REGISTER_SIMULATOR(MySimulator)
+
+To build, install, and use this simulation backend, run the following from the top-level of :code:`my-simulator`:
+
+.. code:: bash 
+
+    export CUDA_QUANTUM_PATH=/path/to/cuda_quantum/install
+    mkdir build && cd build 
+    cmake .. -G Ninja -DNVQIR_DIR="$CUDA_QUANTUM_PATH/lib/cmake/nvqir"
+    ninja install 
+
+Then given any CUDA-Q source file, you can compile and target your backend simulator with the following: 
+
+.. code:: bash 
+
+    nvq++ file.cpp --target MySimulator 
+    ./a.out 
diff --git a/pr-2241/_sources/using/install/data_center_install.rst.txt b/pr-2241/_sources/using/install/data_center_install.rst.txt
new file mode 100644
index 0000000000..b73cc94640
--- /dev/null
+++ b/pr-2241/_sources/using/install/data_center_install.rst.txt
@@ -0,0 +1,472 @@
+Installation from Source
+=========================
+
+In most cases, you should not need to build CUDA-Q from source. For the
+best experience, we recommend using a container runtime to avoid conflicts with
+other software tools installed on the system. Note that `Singularity
+<https://docs.sylabs.io/guides/2.6/user-guide/faq.html#what-is-so-special-about-singularity>`__
+or `Docker rootless mode <https://docs.docker.com/engine/security/rootless/>`__
+address common issue or concerns that are often the motivation for
+avoiding the use of containers. Singularity, for example, can be installed 
+in a user folder and its installation does not require admin permissions; see
+:ref:`this section <install-singularity-image>` for more detailed instructions 
+on how to do that. Our installation guide also contains instructions for how to 
+:ref:`connect an IDE <local-development-with-vscode>` to a running container.
+
+If you do not want use a container runtime, we also provide pre-built binaries
+for using CUDA-Q with C++, and Python wheels for using CUDA-Q with Python. 
+These binaries and wheels are built following the instructions 
+in this guide and should work for you as long as your system meets the compatibility 
+requirements listed under :ref:`Prerequisites <compatibility-prebuilt-binaries>`. 
+To install the pre-built binaries, please follow the instructions 
+:ref:`here <install-prebuilt-binaries>`. To install the Python wheels, please 
+follow the instructions :ref:`here <install-python-wheels>`.
+
+If your system is not listed as supported by our official packages, e.g. because you would 
+like to use CUDA-Q on an operating system that uses an older C standard library, 
+please follow this guide carefully without skipping any steps to build and install
+CUDA-Q from source. The rest of this guide details system requirements 
+during the build and after installation, and walks through the installation steps.
+
+.. note::
+
+  CUDA-Q contains some components that are only included as
+  pre-built binaries and not part of our open source repository. We are working on
+  either open-sourcing these components or making them available as separate downloads
+  in the future. Even without these components, almost all features of CUDA-Q
+  will be enabled in a source build, though some pieces may be less performant. 
+  At this time, the :ref:`multi-GPU state vector simulator <nvidia-mgpu-backend>` 
+  backend will not be included if you build CUDA-Q from source.
+
+
+.. _compatibility-prebuilt-binaries:
+
+Prerequisites
+++++++++++++++++++++++++++++++++++++
+
+The following pre-requisites need to be satisfied both on the build system and
+on the host system, that is the system where the built CUDA-Q binaries
+will be installed and used.
+
+- Linux operating system. The instructions in this guide have been validated
+  with the `AlmaLinux 8 image <https://hub.docker.com/u/almalinux>`__ that
+  serves as the base image for the `manylinux_2_28 image
+  <https://github.com/pypa/manylinux>`__, and should work for the operating
+  systems CentOS 8, Debian 11 and 12, Fedora 38, OpenSUSE/SLED/SLES 15.5, RHEL 8
+  and 9, Rocky 8 and 9, and Ubuntu 22.04. Other operating systems may work, but
+  have not been tested.
+- `Bash <https://www.gnu.org/software/bash/>`__ shell. The CUDA-Q 
+  build, install and run scripts expect to use `/bin/bash`.
+- `GNU C library <https://www.gnu.org/software/libc/>`__. 
+  Make sure that the version on the host system is the same one
+  or newer than the version on the build system. Our own builds
+  use version 2.28.
+- CPU with either x86-64 (x86-64-v3 architecture and newer) or ARM64
+  (ARM v8-A architecture and newer). Other architectures may work but are not tested and may require
+  adjustments to the build instructions.
+- Needed **only on the host** system: NVIDIA GPU with Volta, Turing, Ampere, Ada, or
+  Hopper architecture and `Compute Capability
+  <https://developer.nvidia.com/cuda-gpus>`__ 7+. Make sure you have the latest
+  `drivers <https://www.nvidia.com/download/index.aspx>`__ installed for your
+  GPU, and double check that the driver version listed by the `nvidia-smi`
+  command is 470.57.02 or newer. You do *not* need to have a GPU available on the
+  build system; the CUDA compiler needed for the build can be installed and used
+  without a GPU.
+
+We strongly recommend using a virtual environment for the build that includes
+*only* the tools and dependencies listed in this guide. If you have additional
+software installed, you will need to make sure that the build is linking against
+the correct libraries and versions.
+
+
+Build Dependencies
+++++++++++++++++++++++++++++++++++++
+
+In addition to the prerequisites listed above, you will need to install the
+following prerequisites in your build environment prior to proceeding with 
+the build as described in the subsequent sections:
+
+- Python version 3.8 or newer: If you intend to build CUDA-Q with Python
+  support, make sure the Python version on the build system matches the version
+  on the host system. If you intend to only build the C++ support for
+  CUDA-Q, the Python interpreter is required only for some of the 
+  LLVM build scripts and the Python version used for the build does not have 
+  to match the version on the host system.
+- Common tools: `wget`, `git`, `unzip`. The commands in the rest of this guide assume
+  that these tools are present on the build system, but they can be replaced by
+  other alternatives (such as, for example, manually going to a web page and
+  downloading a file/folder).
+
+The above prerequisites are no longer needed once CUDA-Q is built and 
+do not need to be present on the host system.
+
+.. note::
+
+  The CUDA-Q build scripts and the commands listed in the rest of this 
+  document assume you are using `bash` as the shell for your build.
+
+In addition to installing the needed build dependencies listed above, make sure
+to set the following environment variables prior to proceeding:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>InstallLocations]
+    :end-before: [<InstallLocations]
+
+These environment variables *must* be set during the build. We strongly
+recommend that their value is set to a path that does *not* already exist; 
+this will ensure that these components are built/installed as needed when
+building CUDA-Q.
+The configured paths can be chosen freely, but the paths specified during the
+build are also where the corresponding libraries will be installed on the 
+host system. We are working on making this more flexible in the future.
+
+.. note::
+
+  Please do **not** set `LLVM_INSTALL_PREFIX` to an existing directory;
+  To avoid compatibility issues, it is important to use the same compiler
+  to build the LLVM/MLIR dependencies from source as is later used to 
+  build CUDA-Q itself.
+
+.. note::
+
+  If you are setting the `CURL_INSTALL_PREFIX` variable to an existing 
+  CURL installation (not recommended), please make sure the command 
+  `curl --version` lists HTTP and HTTPS as supported protocols. If these 
+  protocols are not listed, please instead set the `CURL_INSTALL_PREFIX` 
+  variable to a path that does *not* exist. In that case, a suitable 
+  library will be automatically built from source as part of
+  building CUDA-Q.
+
+If you deviate from the instructions below for installing one of the
+dependencies and instead install it, for example, via package manager, you will
+need to make sure that the installation path matches the path you set for the
+corresponding environment variable(s).
+
+CUDA
+~~~~~~~~~~
+
+Building CUDA-Q requires a full installation of the CUDA toolkit.
+**You can install the CUDA toolkit and use the CUDA compiler without having a GPU.**
+The instructions are tested using version 11.8, but any CUDA 11 or 12 version
+should work, as long as the CUDA runtime version on the host system matches the 
+CUDA version used for the build, and the installed driver on the host 
+system supports that CUDA version. We recommend using the latest CUDA version
+that is supported by the driver on the host system.
+
+Download a suitable `CUDA version <https://developer.nvidia.com/cuda-toolkit-archive>`__
+following the installation guide for your platform in the online documentation
+linked on that page.
+
+Within the tested AlmaLinux 8 environment, for example, the following commands
+install CUDA 11.8:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAInstall]
+    :end-before: [<CUDAInstall]
+
+Toolchain
+~~~~~~~~~~
+
+The compiler toolchain used for the build must be a supported 
+`CUDA host compiler <https://docs.nvidia.com/cuda/cuda-compiler-driver-nvcc/index.html#supported-host-compilers>`__
+for the installed CUDA version.
+The following instructions have been tested with `GCC-11 <https://gcc.gnu.org/index.html>`__.
+Other toolchains may be supported but have not been tested.
+
+Within the tested AlmaLinux 8 environment, for example, the following commands
+install GCC 11:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>gccInstall]
+    :end-before: [<gccInstall]
+
+Independent on which compiler toolchain you installed, set the following
+environment variables to point to the respective compilers on your build system:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>ToolchainConfiguration]
+    :end-before: [<ToolchainConfiguration]
+
+- The variables `CC` and `CXX` *must* be set for the CUDA-Q build.
+- To use GPU-acceleration in CUDA-Q, make sure to set `CUDACXX` to 
+  your CUDA compiler, and `CUDAHOSTCXX` to the CUDA compatible host 
+  compiler you are using. If the CUDA compiler is not found when building
+  CUDA-Q, some components and backends will be omitted automatically 
+  during the build.
+
+
+Building CUDA-Q
+++++++++++++++++++++++++++++++++++++
+
+This installation guide has been written for a specific version/commit of CUDA-Q. 
+Make sure to obtain the source code for that version. 
+Clone the CUDA-Q `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__ and
+checkout the appropriate branch, tag, or commit. 
+Note that the build scripts assume that they are run from within a git repository, 
+and merely downloading the source code as ZIP archive hence will not work.
+
+Please follow the instructions in the respective subsection(s) to build the necessary 
+components for using CUDA-Q from C++ and/or Python.
+After the build, check that the GPU-accelerated components have been built by confirming
+that the file `nvidia.config` exists in the `$CUDAQ_INSTALL_PREFIX/targets` folder.
+We also recommend checking the build log printed to the console to confirm that all desired 
+components have been built. 
+
+.. note::
+
+  The CUDA-Q build will compile or omit optional components automatically depending
+  on whether the necessary pre-requisites are found in the build environment.
+  If you see a message that a component has been skipped, and/or the CUDA compiler
+  is not properly detected, make sure you followed the 
+  instructions for installing the necessary prerequisites and build dependencies, 
+  and have set the necessary environment variables as described in this document.
+
+.. _cudaq-python-from-source:
+
+Python Support
++++++++++++++++++++++++++++++++
+
+The most convenient way to enable Python support within CUDA-Q is to build 
+a `wheel <https://pythonwheels.com/>`__ that can then easily be installed
+using `pip`. To ensure the wheel can be installed on the host system, make sure to
+use the same Python version for the build as the one that is installed on the host system.
+To build a CUDA-Q Python wheel, you will need to install the following additional 
+Python-specific tools:
+
+- Python development headers: The development headers for your Python version are installed
+  in the way as you installed Python itself. If you installed Python via the package manager
+  for your system, you may need to install an additional package to get the development headers.
+  The package name is usually your python version followed by either a `-dev` or `-devel` suffix.
+  If you are using a `Conda environment <https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-python.html>`__,
+  the necessary headers should already be installed.
+- Pip package manager: Make sure the `pip` module is enable for your Python version.
+  We refer to the Python `documentation <https://pip.pypa.io/en/stable/installation/>`__ for
+  more information about installing/enabling `pip`.
+- Python modules: Install the additional modules `numpy`, `build`, `auditwheel`, and `patchelf` for your
+  Python version, e.g. `python3 -m pip install numpy build auditwheel patchelf`.
+
+From within the folder where you cloned the CUDA-Q repository, run the following
+command to build the CUDA-Q Python wheel:
+
+.. literalinclude:: ../../../../docker/build/assets.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumPythonBuild]
+    :end-before: [<CUDAQuantumPythonBuild]
+
+.. note::
+
+  A version identifier will be automatically assigned to the wheel based on the commit
+  history. You can manually override this detection to give a more descriptive identifier
+  by setting the environment variable `SETUPTOOLS_SCM_PRETEND_VERSION` to the desired
+  value before building the wheel.
+
+After the initial build, `auditwheel <https://github.com/pypa/auditwheel>`__ is used to 
+include dependencies in the wheel, if necessary, and correctly label the wheel.
+We recommend not including the CUDA runtime libraries and instead install them separately
+on the host system following the instructions in the next section. The following 
+command builds the final wheel, not including CUDA dependencies: 
+
+.. literalinclude:: ../../../../docker/build/assets.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumWheel]
+    :end-before: [<CUDAQuantumWheel]
+
+The command above will create a new wheel in the `wheelhouse` folder. This wheel can be
+installed on any `compatible platform <https://packaging.python.org/en/latest/specifications/platform-compatibility-tags/>`__.
+
+.. note::
+  You can confirm that the wheel is indeed compatible with your host platform by 
+  checking that the wheel tag (i.e. the file name ending of the `.whl` file) is listed under
+  "Compatible Tags" when running the command `python3 -m pip debug --verbose` on the host.
+
+.. _cudaq-cpp-from-source:
+
+C++ Support
++++++++++++++++++++++++++++++++
+
+From within the folder where you cloned the CUDA-Q repository, run the following
+command to build CUDA-Q:
+
+.. literalinclude:: ../../../../docker/build/assets.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumCppBuild]
+    :end-before: [<CUDAQuantumCppBuild]
+
+Note that `lld` is primarily needed when the build or host system does not already
+have an existing default linker on its path; CUDA-Q supports the same linkers as
+`clang` does.
+
+To easily migrate the built binaries to the host system, we recommend creating a
+`self-extracting archive <https://makeself.io/>`__. To do so, download the 
+`makeself script(s) <https://github.com/megastep/makeself>`__ and move the necessary 
+files to install into a separate folder using the command
+
+.. literalinclude:: ../../../../docker/release/installer.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumAssets]
+    :end-before: [<CUDAQuantumAssets]
+
+You can then create a self-extracting archive with the command
+
+.. code-block:: bash
+
+    ./makeself.sh --gzip --sha256 --license cuda_quantum_assets/cudaq/LICENSE \
+        cuda_quantum_assets install_cuda_quantum.$(uname -m) \
+        "CUDA-Q toolkit for heterogeneous quantum-classical workflows" \
+        bash cudaq/migrate_assets.sh -t /opt/nvidia/cudaq
+
+Installation on the Host
+++++++++++++++++++++++++++++++++++++
+
+Make sure your host system satisfies the `Prerequisites`_ listed above.
+
+- To use CUDA-Q with Python, you should have a working
+  Python installation on the host system, including the `pip` package manager.
+- To use CUDA-Q with C++, you should make sure that you have the necessary development
+  headers of the C standard library installed. You can check this by searching for
+  `features.h`, commonly found in `/usr/include/`. You can install the necessary headers
+  via package manager (usually the package name is called something like `glibc-devel`
+  or `libc6-devel`). These headers are also included with any installation of GCC.
+
+To use CUDA-Q with Python, you should have a working
+Python installation on the host system, including the `pip` package manager.
+
+If you followed the instructions for building the 
+:ref:`CUDA-Q Python wheel <cudaq-python-from-source>`,
+copy the built `.whl` file to the host system, and install it using `pip`; e.g.
+
+.. code-block:: bash
+
+    pip install cuda_quantum*.whl
+
+To install the necessary CUDA and MPI dependencies for some of the components, 
+you can either follow the instructions on `PyPI.org <https://pypi.org/project/cuda-quantum/>`__, 
+replacing `pip install cuda-quantum` with the command above, or you can follow the
+instructions in the remaining sections of this document to customize and better
+optimize them for your host system.
+
+If you followed the instructions for building the 
+:ref:`CUDA-Q C++ tools <cudaq-cpp-from-source>`,
+copy the `install_cuda_quantum` file that you created to the host system, 
+and install it by running the commands
+
+.. code-block:: bash
+
+    sudo bash install_cuda_quantum.$(uname -m) --accept
+    . /opt/nvidia/cudaq/set_env.sh
+
+This will extract the built assets and move them to the correct locations.
+The `set_env.sh` script in `/opt/nvidia/cudaq` defines the necessary environment
+variables to use CUDA-Q. To avoid having to set them manually every time a 
+new shell is opened, we highly recommend adding the following lines to
+the `/etc/profile` file:
+
+.. code-block:: bash
+
+    if [ -f /opt/nvidia/cudaq/set_env.sh ];
+      . /opt/nvidia/cudaq/set_env.sh
+    fi
+
+.. note::
+  CUDA-Q as built following the instructions above includes and uses the LLVM
+  C++ standard library. This will not interfere with any other C++ standard library
+  you may have on your system. Pre-built external libraries, you may want to use with 
+  CUDA-Q, such as specific optimizers for example, have a C API to ensure compatibility
+  across different versions of the C++ standard library and will work with CUDA-Q without 
+  issues. The same is true for all distributed CUDA libraries. To build you own CUDA 
+  libraries that can be used with CUDA-Q, please take a look at :doc:`../integration/cuda_gpu`.
+
+The remaining sections in this document list additional runtime dependencies 
+that are not included in the migrated assets and are needed to use some of the 
+CUDA-Q features and components.
+
+CUDA Runtime Libraries
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To use GPU-acceleration in CUDA-Q you will need to install the necessary 
+CUDA runtime libraries. Their version (at least the version major) needs to match the version
+used for the build. While not necessary, we recommend installing 
+the complete CUDA toolkit like you did for the CUDA-Q build.
+If you prefer to only install the minimal set of runtime libraries, the following 
+commands, for example, install the necessary packages for the AlmaLinux 8 environment:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>CUDARTInstall]
+    :end-before: [<CUDARTInstall]
+
+MPI
+~~~~~~
+
+To work with all CUDA-Q backends, a CUDA-aware MPI installation is required. 
+If you do not have an existing CUDA-aware MPI installation, you can build one from 
+source. To do so, in addition to the CUDA runtime libraries listed above 
+you will need to install the CUDA runtime development package 
+(`cuda-cudart-devel-${version_suffix}` or `cuda-cudart-dev-${version_suffix}`, 
+depending on your distribution).
+
+The following commands build a sufficient CUDA-aware OpenMPI installation.
+To make best use of MPI, we recommend a more fully featured installation including
+additional configurations that fit your host system.
+The commands below assume you have the necessary prerequisites for the OpenMPI build
+installed on the build system. Within the tested AlmaLinux 8 environment, for example,
+the packages `autoconf`, `libtool`, `flex`, and `make` need to be installed.
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>OpenMPIBuild]
+    :end-before: [<OpenMPIBuild]
+
+Confirm that you have a suitable MPI implementation installed. For OpenMPI and MPICH,
+for example, this can be done by compiling and running the following program:
+
+.. literalinclude:: ../../../../docker/test/installer/mpi_cuda_check.cpp
+    :language: cpp
+
+.. note::
+
+  If you are encountering an error similar to "The value of the MCA parameter `plm_rsh_agent` 
+  was set to a path that could not be found", please make sure you have an SSH Client installed
+  or update the MCA parameter to another suitable agent.
+  MPI uses `SSH <https://en.wikipedia.org/wiki/Secure_Shell>`__ or
+  `RSH <https://en.wikipedia.org/wiki/Remote_Shell>`__ to communicate with each node
+  unless another resource manager, such as
+  `SLURM <https://slurm.schedmd.com/overview.html>`__, is used. 
+
+Different MPI implementations are supported via a plugin infrastructure in CUDA-Q.
+Once you have a CUDA-aware MPI installation on your host system, you can 
+configure CUDA-Q to use it by activating the necessary plugin.
+Plugins for OpenMPI and MPICH are included in CUDA-Q and can be activated by
+setting the environment variable `MPI_PATH` to the MPI installation folder 
+and then running the command
+
+.. code-block:: bash
+
+    bash "${CUDA_QUANTUM_PATH}/distributed_interfaces/activate_custom_mpi.sh"
+
+.. note::
+
+  To activate the MPI plugin for the Python support, replace `${CUDA_QUANTUM_PATH}`
+  with the path that is listed under "Location" when you run the command
+  `pip show cuda-quantum`.
+
+If you use a different MPI implementation than OpenMPI or MPICH, you will need to 
+implement the necessary plugin interface yourself prior to activating the plugin 
+with the command above.
+
+.. TODO:
+  For more information about building and activating a custom MPI plugin, see ...
diff --git a/pr-2241/_sources/using/install/install.rst.txt b/pr-2241/_sources/using/install/install.rst.txt
new file mode 100644
index 0000000000..ad3e59decb
--- /dev/null
+++ b/pr-2241/_sources/using/install/install.rst.txt
@@ -0,0 +1,11 @@
+Installation Guide
+*******************************************
+
+.. _install-cuda-quantum:
+
+.. toctree::
+  :caption: Contents
+  :maxdepth: 1
+
+  Local Installation <local_installation.rst>
+  Data Center Installation <data_center_install.rst>
diff --git a/pr-2241/_sources/using/install/local_installation.rst.txt b/pr-2241/_sources/using/install/local_installation.rst.txt
new file mode 100644
index 0000000000..695dc6de72
--- /dev/null
+++ b/pr-2241/_sources/using/install/local_installation.rst.txt
@@ -0,0 +1,921 @@
+Local Installation
+===================
+
+Introduction
+-------------------
+
+This guide walks through how to :ref:`install CUDA-Q <install-cuda-quantum>` on your system, and how to set up :ref:`VS Code for local development <local-development-with-vscode>`.
+The section on :ref:`connecting to a remote host <connect-to-remote>` contains some
+guidance for application development on a remote host where CUDA-Q is installed.
+
+The following sections contain instructions for how to install CUDA-Q on your machine using
+
+- :ref:`Docker <install-docker-image>`: A fully featured CUDA-Q installation including all C++ and Python tools is available as a `Docker <https://docs.docker.com/get-started/overview/>`__ image.
+- :ref:`Singularity <install-singularity-image>`: A `Singularity <https://docs.sylabs.io/guides/latest/user-guide/introduction.html>`__ container can easily be created based on our Docker images. 
+- :ref:`PyPI <install-python-wheels>`: Additionally, we distribute pre-built Python wheels via `PyPI <https://pypi.org>`__.
+- :ref:`Pre-built binaries <install-prebuilt-binaries>`: We also provide pre-built C++ binaries, bundled as `self-extracting archive <https://makeself.io/>`__, that work across a range of Linux operating systems.
+
+If you would like to build CUDA-Q from source to deploy on an HPC system without relying on a container runtime, please follow the instructions for :doc:`data_center_install`. 
+If, on the other hand, you want to contribute to the development of CUDA-Q itself and hence want to 
+build a custom version of CUDA-Q from source, follow the instructions on the 
+`CUDA-Q GitHub repository <https://github.com/NVIDIA/cuda-quantum/blob/main/Building.md>`__ instead.
+
+If you are unsure which option suits you best, we recommend using our :ref:`Docker image <install-docker-image>` to develop your applications in a controlled environment that does not depend on, or interfere with, other software
+that is installed on your system.
+
+.. _install-docker-image:
+
+Docker
+++++++++++++++++++++++++++++++++++++
+
+To download and use our Docker images, you will need to install and launch the Docker engine. 
+If you do not already have Docker installed on your system, you can get it by downloading and installing `Docker Desktop <https://docs.docker.com/get-docker/>`_. 
+If you do not have the necessary administrator permissions to install software on your machine,
+take a look at the section below on how to use `Singularity`_ instead.
+
+Docker images for all CUDA-Q releases are available on the `NGC Container Registry`_.
+In addition to publishing `stable releases <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__, 
+we also publish Docker images whenever we update certain branches on our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`_.
+These images are published in our `nightly channel on NGC <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum/tags>`__.
+To download the latest version on the main branch of our GitHub repository, for example, use the command
+
+.. code-block:: console
+
+    docker pull nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+.. _NGC Container Registry: https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum
+
+Early prototypes for features we are considering can be tried out by using the image tags starting 
+with `experimental`. The `README` in the `/home/cudaq` folder in the container gives more details 
+about the feature. We welcome and appreciate your feedback about these early prototypes; 
+how popular they are will help inform whether we should include them in future releases.
+
+Once you have downloaded an image, the container can be run using the command
+
+.. code-block:: console
+
+    docker run -it --name cuda-quantum nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+Replace the image name and/or tag in the command above, if necessary, with the one you want to use.
+This will give you terminal access to the created container. To enable support 
+for GPU-accelerated backends, you will need to pass the :code:`--gpus` flag when launching
+the container, for example:
+
+.. code-block:: console
+
+    docker run -it --gpus all --name cuda-quantum nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+.. note:: 
+
+  This command will fail if you do not have a suitable NVIDIA GPU available, or if your driver 
+  version is insufficient. To improve compatibility with older drivers, you may need to install the 
+  `NVIDIA container toolkit`_.
+
+.. _NVIDIA container toolkit: https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html
+
+You can stop and exit the container by typing the command :code:`exit`. If you did not specify
+:code:`--rm` flag when launching the container, the container still exists after exiting, as well as any 
+changes you made in it. You can get back to it using
+the command :code:`docker start -i cuda-quantum`. 
+You can delete an existing container and any changes you made using :code:`docker rm -v cuda-quantum`.
+
+When working with Docker images, the files inside the container are not visible outside the container environment. 
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+please take a look at the section on :ref:`Development with VS Code <docker-in-vscode>`.
+
+Alternatively, it is possible, but not recommended, to launch an SSH server inside the container environment and connect an IDE using SSH. To do so, make sure you have generated a suitable RSA key pair; if your `~/.ssh/` folder does not already contain the files `id_rsa.pub` and `id.rsa`,
+follow the instructions for generating a new SSH key on `this page <https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent>`__.
+You can then launch the container and connect to it via SSH by executing the following commands:
+
+.. code-block:: console
+
+    docker run -itd --gpus all --name cuda-quantum -p 2222:22 nvcr.io/nvidia/nightly/cuda-quantum:latest
+    docker exec cuda-quantum bash -c "sudo apt-get install -y --no-install-recommends openssh-server"
+    docker exec cuda-quantum bash -c "sudo sed -i -E "s/#?\s*UsePAM\s+.+/UsePAM yes/g" /etc/ssh/sshd_config"
+    docker cp ~/.ssh/id_rsa.pub cuda-quantum:/home/cudaq/.ssh/authorized_keys
+    docker exec -d cuda-quantum bash -c "sudo -E /usr/sbin/sshd -D"
+    ssh cudaq@localhost -p 2222 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o GlobalKnownHostsFile=/dev/null
+
+
+.. _install-singularity-image:
+
+Singularity
+++++++++++++++++++++++++++++++++++++
+
+You can use `Singularity <https://github.com/sylabs/singularity>`__ to run a CUDA-Q container in a folder without needing administrator permissions.
+If you do not already have Singularity installed, you can build a relocatable installation from source. 
+To do so on Linux or WSL, make sure you have the `necessary prerequisites <https://docs.sylabs.io/guides/4.0/user-guide/quick_start.html#prerequisites>`__ installed, download a suitable version of the `go toolchain <https://docs.sylabs.io/guides/4.0/user-guide/quick_start.html#install-go>`__, and make sure the `go` binaries are on your :code:`PATH`. You can then build Singularity with the commands
+
+.. code-block:: console
+
+    wget https://github.com/sylabs/singularity/releases/download/v4.0.1/singularity-ce-4.0.1.tar.gz
+    tar -xzf singularity-ce-4.0.1.tar.gz singularity-ce-4.0.1/ && rm singularity-ce-4.0.1.tar.gz && cd singularity-ce-4.0.1/
+    ./mconfig --without-suid --prefix="$HOME/.local/singularity"
+    make -C ./builddir && make -C ./builddir install && cd .. && rm -rf singularity-ce-4.0.1/
+    echo 'PATH="$PATH:$HOME/.local/singularity/bin/"' >> ~/.profile && source ~/.profile
+
+For more information about using Singularity on other systems, take a look at the `admin guide <https://docs.sylabs.io/guides/4.0/admin-guide/installation.html#installation-on-windows-or-mac>`__.
+
+Once you have singularity installed, create a file `cuda-quantum.def` with the following content:
+
+.. code-block:: console
+
+    Bootstrap: docker
+    From: nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+    %runscript
+        mount devpts /dev/pts -t devpts
+        cp -r /home/cudaq/* .
+        bash
+
+Replace the image name and/or tag in the `From` line, if necessary, with the one you want to use;
+In addition to publishing `stable releases <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__, 
+we also publish Docker images whenever we update certain branches on our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`_.
+These images are published in our `nightly channel on NGC <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum/tags>`__.
+Early prototypes for features we are considering can be tried out by using the image tags starting 
+with `experimental`. We welcome and appreciate your feedback about these early prototypes; 
+how popular they are will help inform whether we should include them in future releases.
+
+You can then create a CUDA-Q container by running the following commands:
+
+.. code-block:: console
+
+    singularity build --fakeroot cuda-quantum.sif cuda-quantum.def
+    singularity run --writable --fakeroot cuda-quantum.sif
+
+In addition to the files in your current folder, you should now
+see a `README` file, as well as examples and tutorials.
+To enable support for GPU-accelerated backends, you will need to pass the
+the :code:`--nv` flag when running the container:
+
+.. code-block:: console
+
+    singularity run --writable --fakeroot --nv cuda-quantum.sif
+    nvidia-smi
+
+The output of the command above lists the GPUs that are visible and accessible in the container environment.
+
+.. note:: 
+
+  If you do not see any GPUs listed in the output of `nvidia-smi`, 
+  it means the container environment is unable to access a suitable NVIDIA GPU. 
+  This can happen if your driver version is insufficient, or if you are 
+  working on WSL. To improve compatibility with older drivers, or to enable GPU support
+  on WSL, please install the `NVIDIA container toolkit`_, and update the singularity configuration 
+  to set `use nvidia-container-cli` to `yes` and configure the correct `nvidia-container-cli path`. 
+  The two commands below use `sed` to do that:
+
+  .. code-block:: console
+
+    sed -i 's/use nvidia-container-cli = no/use nvidia-container-cli = yes/' "$HOME/.local/singularity/etc/singularity/singularity.conf"
+    sed -i 's/# nvidia-container-cli path =/nvidia-container-cli path = \/usr\/bin\/nvidia-container-cli/' "$HOME/.local/singularity/etc/singularity/singularity.conf"
+
+You can exit the container environment by typing the command :code:`exit`.
+Any changes you made will still be visible after you exit the container, and you can re-enable the 
+container environment at any time using the `run` command above.
+
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+please take a look at the section on :ref:`Development with VS Code <singularity-in-vscode>`.
+
+
+.. _install-python-wheels:
+
+Python wheels
+++++++++++++++++++++++++++++++++++++
+
+CUDA-Q Python wheels are available on `PyPI.org <https://pypi.org/project/cuda-quantum>`__. 
+Installation instructions can be found in the `project description <https://pypi.org/project/cuda-quantum/#description>`__.
+For more information about available versions and documentation,
+see :doc:`../../releases`.
+
+There are currently no source distributions available on PyPI, but you can download the 
+source code for the latest version of the CUDA-Q Python wheels from our 
+`GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__. 
+The source code for previous versions can be downloaded from the respective 
+`GitHub Release <https://github.com/NVIDIA/cuda-quantum/releases>`__.
+
+At this time, wheels are distributed for Linux operating systems only. 
+If your platform is not :ref:`officially supported <dependencies-and-compatibility>` and
+`pip` does not find a compatible wheel to install, you can build your own 
+wheel from source following the instructions here: :doc:`data_center_install`.
+
+To build the CUDA-Q Python API for the purpose of contributing to
+our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__,
+follow the instructions for 
+`Setting up your Environment <https://github.com/NVIDIA/cuda-quantum/blob/main/Dev_Setup.md>`__, 
+and then run the following commands in the repository root:
+
+.. code-block:: console
+
+    bash scripts/install_prerequisites.sh
+    pip install . --user
+
+.. _install-prebuilt-binaries:
+
+Pre-built binaries
+++++++++++++++++++++++++++++++++++++
+
+Starting with the 0.6.0 release, we provide pre-built binaries for using 
+CUDA-Q with C++. Support for using CUDA-Q with Python can be installed 
+side-by-side with the pre-built binaries for C++ by following the instructions on 
+`PyPI.org <https://pypi.org/project/cuda-quantum>`__.
+The pre-built binaries work across a range of Linux operating systems listed 
+under :ref:`dependencies-and-compatibility`. 
+
+Before installing our pre-built binaries, please make sure that your 
+operating system is using the `GNU C library <https://www.gnu.org/software/libc/>`__ 
+version 2.28 or newer. You can confirm this by checking the output of the command 
+`ldd --version`. If this command does not exist, or shows an older version than 2.28, 
+please double check that your operating system is listed as 
+:ref:`supported <dependencies-and-compatibility>`. If you use an operating system
+with an older GNU C library version, you will need to build the installer from 
+source following the instructions in :doc:`data_center_install`.
+
+You can download the `install_cuda_quantum` file for your processor architecture from
+the assets of the respective `GitHub release <https://github.com/NVIDIA/cuda-quantum/releases>`__. 
+The installer is a `self-extracting archive <https://makeself.io/>`__ that contains the 
+pre-built binaries as well as a script to move them to the correct locations. You will need
+`bash`, `tar`, and `gzip` (usually already installed on most Linux distributions) to run 
+the installer.
+The installation location of CUDA-Q is not currently configurable and using the installer
+hence requires admin privileges on the system. We may revise that in the future; please see and
+upvote the corresponding `GitHub issue <https://github.com/NVIDIA/cuda-quantum/issues/1075>`__.
+
+To install CUDA-Q, execute the command
+
+.. literalinclude:: ../../../../docker/test/installer/linux.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumInstall]
+    :end-before: [<CUDAQuantumInstall]
+
+.. note:: 
+
+  To use GPU-accelerated backends, you will need to install the necessary CUDA runtime libraries. 
+  For more information see the corresponding section on 
+  :ref:`Additional CUDA Tools <cuda-dependencies-prebuilt-binaries>`.
+
+The installation ensures that the necessary environment variables for
+using the CUDA-Q toolchain are set upon login for all POSIX shells.
+Confirm that the `nvq++` command is found. If it is not, please make sure 
+to set the environment variables defined by the `set_env.sh` script in the 
+CUDA-Q installation folder (usually `/usr/local/cudaq` or `/opt/nvidia/cudaq`).
+
+If an MPI installation is available in the directory defined by `MPI_PATH`, 
+the installer automatically enables MPI support in CUDA-Q.
+If you do not have MPI installed on your system, you can simply
+leave that path empty, and CUDA-Q will be installed without MPI support.
+If you install MPI at a later point in time, you can activate the MPI support in CUDA 
+Quantum by setting the `MPI_PATH` variable to its installation location and 
+executing the commands
+
+.. code-block:: console
+
+    MPI_PATH=/usr/local/openmpi # update this path as needed
+    bash "${CUDA_QUANTUM_PATH}/distributed_interfaces/activate_custom_mpi.sh"
+
+.. note::
+
+  Please make sure that you have the necessary development headers of the C standard 
+  library installed. You can check this by searching for `features.h`, commonly found
+  in `/usr/include/`. You can install the necessary headers via package manager 
+  (usually the package name is called something like `glibc-devel` or `libc6-dev`). 
+  These headers are also included with any installation of GCC.
+
+.. _local-development-with-vscode:
+
+Development with VS Code
+------------------------------------
+
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+we recommend using `VS Code <https://code.visualstudio.com/>`_. VS Code provides a seamless
+development experience on all platforms, and is also available without installation via web browser. 
+This sections describes how to connect VS Code to a running container on your machine.
+The section on :ref:`connecting to a remote host <connect-to-remote>` contains information on
+how to set up your development environment when accessing CUDA-Q on a remote host instead.
+
+.. _docker-in-vscode:
+
+Using a Docker container
+++++++++++++++++++++++++++++++++++++++++
+
+Before connecting VS Code, open a terminal/shell, 
+and start the CUDA-Q Docker container following the 
+instructions in the :ref:`section above <install-docker-image>`. 
+
+If you have a local installation of `VS Code <https://code.visualstudio.com/>`_ 
+you can connect to the running container using the  
+`Dev Containers <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`__ extension. If you want to use VS Code in the web browser, please follow the instructions
+in the section `Developing with Remote Tunnels`_ instead.
+
+.. |:spellcheck-disable:| replace:: \
+.. |:spellcheck-enable:| replace:: \
+
+After installing the
+`Dev Containers <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`__ extension, launch VS Code, open the Command Palette with `Ctrl+Shift+P`, and enter 
+|:spellcheck-disable:|"Dev Containers: Attach to Running Container"|:spellcheck-enable:|.
+You should see and select the running `cuda-quantum` container in the list. 
+After the window reloaded, enter "File: Open Folder" in the Command Palette to open the `/home/cudaq/` folder.
+
+To run the examples, open the Command Palette and enter "View: Show Terminal"
+to launch an integrated terminal. You are now all set to 
+:ref:`get started <post-installation>` with CUDA-Q development.
+
+.. _singularity-in-vscode:
+
+Using a Singularity container
+++++++++++++++++++++++++++++++++++++++++
+
+If you have a GitHub or Microsoft account, we recommend that you connect 
+to a CUDA-Q container using tunnels. To do so, launch a CUDA-Q Singularity 
+container following the instructions in the :ref:`section above <install-singularity-image>`,
+and then follow the instructions in the section `Developing with Remote Tunnels`_.
+
+If you cannot use tunnels, you need a local installation of 
+`VS Code <https://code.visualstudio.com/>`_ and you need to install 
+the `Remote - SSH <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`__ extension. 
+Make sure you also have a suitable SSH key pair; if your `~/.ssh/` folder does not already contain
+the files `id_rsa.pub` and `id.rsa`, follow the instructions for generating a new SSH key on 
+`this page <https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent>`__.
+
+To connect VS Code to a running CUDA-Q container, 
+the most convenient setup is to install and run an SSH server 
+in the Singularity container. Open a terminal/shell in a separate window,
+and enter the following commands to create a suitable sandbox:
+
+.. code-block:: console
+
+    singularity build --sandbox cuda-quantum-sandbox cuda-quantum.sif
+    singularity exec --writable --fakeroot cuda-quantum-sandbox \
+      apt-get install -y --no-install-recommends openssh-server
+    cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
+
+You can launch this sandbox by entering the commands below. Please see the `Singularity`_ section above
+for more information about how to get the `cuda-quantum.sif` image, and how to enable GPU-acceleration
+with the `--nv` flag.
+
+.. code-block:: console
+
+    singularity run --writable --fakeroot --nv --network-args="portmap=22:2222/tcp" cuda-quantum-sandbox
+    /usr/sbin/sshd -D -p 2222 -E sshd_output.txt
+
+.. note::
+
+  Make sure to use a free port. You can check if the SSH server is ready and listening
+  by looking at the log in `sshd_output.txt`. If the port is already in use, you can 
+  replace the number `2222` by any free TCP port in the range `1025-65535` in all
+  commands.
+
+Entering `Ctrl+C` followed by `exit` will stop the running container. You can re-start
+it at any time by entering the two commands above. While the container is running,
+open the Command Palette in VS Code with `Ctrl+Shift+P`, enter "Remote-SSH: Add new
+SSH Host", and enter the following SSH command:
+
+.. code-block:: console
+
+    ssh root@localhost -p 2222 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o GlobalKnownHostsFile=/dev/null
+
+.. note::
+
+  If you are working on Windows and are building and running the Singularity container in WSL,
+  make sure to copy the used SSH keys to the Windows partition, such that VS Code can connect with 
+  the expected key. Alternatively, add the used public key to the `/root/.ssh/authorized_keys` file in 
+  the Singularity container.
+
+You can then connect to the host by opening the Command Palette, entering
+"Remote SSH: Connect Current Window to Host", and choosing the newly created host.
+After the window reloaded, enter "File: Open Folder" in the 
+Command Palette to open the desired folder.
+
+To run the examples, open the Command Palette and enter "View: Show Terminal"
+to launch an integrated terminal. You are now all set to 
+:ref:`get started <post-installation>` with CUDA-Q development.
+
+
+.. _connect-to-remote:
+
+Connecting to a Remote Host
+------------------------------------
+
+Depending on the setup on the remote host, there are a couple of different options 
+for developing CUDA-Q applications.
+
+- If a CUDA-Q container is running on the remote host,
+  and you have a GitHub or Microsoft account, take a look at
+  `Developing with Remote Tunnels`_. This works for both Docker
+  and Singularity containers on the remote host, and should also
+  work for other containers.
+- If you cannot use tunnels, or if you want to work with an
+  existing CUDA-Q installation without using a container, 
+  take a look at `Remote Access via SSH`_ instead.
+
+.. _connect-vscode-via-tunnel:
+
+Developing with Remote Tunnels
+++++++++++++++++++++++++++++++++++++
+
+`Remote access via tunnel <https://code.visualstudio.com/blogs/2022/12/07/remote-even-better>`__
+can easily be enabled with the `VS Code CLI <https://code.visualstudio.com/docs/editor/command-line>`__.
+This allows to connect either a local installation of `VS Code <https://code.visualstudio.com/>`_, 
+or the `VS Code Web UI <https://vscode.dev/>`__, to a running CUDA-Q container on the same or a different machine. 
+
+Creating a secure connection requires authenticating with the same GitHub or Microsoft account on each end.
+Once authenticated, an SSH connection over the tunnel provides end-to-end encryption. To download the VS Code CLI, if necessary, and create a tunnel, execute the 
+following command in the running CUDA-Q container,
+and follow the instructions to authenticate:
+
+.. code-block:: console
+
+    vscode-setup tunnel --name cuda-quantum-remote --accept-server-license-terms
+
+You can then either `open VS Code in a web browser <https://vscode.dev/tunnel/cuda-quantum-remote/home/cudaq/>`__, or connect a local installation of VS Code.
+To connect a local installation of VS Code, make sure you have the 
+`Remote - Tunnels <https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server>`__ extension installed,
+then open the Command Palette with `Ctrl+Shift+P`, enter "Remote Tunnels: Connect to Tunnel", 
+and enter `cuda-quantum-remote`. After the window reloaded, enter "File: Open Folder" in the Command Palette 
+to open the `/home/cudaq/` folder.
+
+You should see a pop up asking if you want to install the recommended extensions. Selecting to install them will
+configure VS Code with extensions for working with C++, Python, and Jupyter.
+You can always see the list of recommended extensions that aren't installed yet by clicking on the "Extensions" icon in the sidebar and navigating to the "Recommended" tab.
+
+Remote Access via SSH
+++++++++++++++++++++++++++++++++++++
+
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+you can connect a local installation of `VS Code <https://code.visualstudio.com/>`_ to a remote host via SSH. 
+
+.. note:: 
+
+  For the best user experience, we recommend to launch a CUDA-Q container on the remote host, 
+  and then connect :ref:`VS Code using tunnels <connect-vscode-via-tunnel>`.
+  If a connection via tunnel is not possible, this section describes using SSH instead.
+
+To do so, make sure you have `Remote - SSH <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`__ extension installed.
+Open the Command Palette with `Ctrl+Shift+P`, enter "Remote-SSH: Add new
+SSH Host", and enter the SSH command to connect to your account on the remote host.
+You can then connect to the host by opening the Command Palette, entering
+"Remote SSH: Connect Current Window to Host", and choosing the newly created host.
+
+When prompted, choose Linux as the operating system, and enter your
+password. After the window reloaded, enter "File: Open Folder" in the 
+Command Palette to open the desired folder. Our GitHub repository contains
+a folder with VS Code configurations including a list of recommended extensions for
+working with CUDA-Q; you can copy `these configurations <https://github.com/NVIDIA/cuda-quantum/tree/main/docker/release/config/.vscode>`__ into the a folder named `.vscode` in your workspace to use them.
+
+If you want to work with an existing CUDA-Q installation on the remote host, you are all set.
+Alternatively, you can use Singularity to build and run a container following the instructions in 
+:ref:`this section <install-singularity-image>`. Once the `cuda-quantum.sif` image is built and 
+available in your home directory on the remote host, you can update your VS Code configuration 
+to enable/improve completion, hover information, and other development tools within the container.
+
+To do so, open the Command Palette and enter "Remote-SSH: Open SSH Configuration File". 
+Add a new entry to that file with the command to launch the container, and edit the configuration 
+of the remote host, titled `remote-host` in the snippets below, to add a new identifier:
+
+.. code-block:: console
+
+    Host cuda-quantum~*
+      RemoteCommand singularity run --writable --fakeroot --nv ~/cuda-quantum.sif
+      RequestTTY yes
+
+    Host remote-host cuda-quantum~remote-host
+      HostName ...
+      ...
+
+You will need to edit a couple of VS Code setting to make use of the newly defined remote command;
+open the Command Palette, enter "Preferences: Open User Settings (JSON)", and add or update the 
+following configurations:
+
+.. code-block:: console
+
+    "remote.SSH.enableRemoteCommand": true,
+    "remote.SSH.useLocalServer": true,
+    "remote.SSH.remoteServerListenOnSocket": false,
+    "remote.SSH.connectTimeout": 120,
+    "remote.SSH.serverInstallPath": {
+        "cuda-quantum~remote-host": "~/.vscode-container/cuda-quantum",
+    },
+
+After saving the changes, you should now be able to select `cuda-quantum~remote-host` as the host
+when connecting via SSH, which will launch the CUDA-Q container and connect VS Code to it.
+
+.. note::
+
+  If the connection to `cuda-quantum~remote-host` fails, you may need to specify the full
+  path to the `singularity` executable on the remote host, since environment variables, 
+  and specifically the configured `PATH` may be different during launch than in your user account.
+
+DGX Cloud
+--------------------------------
+
+If you are using `DGX Cloud <https://www.nvidia.com/en-us/data-center/dgx-cloud/>`__, 
+you can easily use it to run CUDA-Q applications.
+While submitting jobs to DGX Cloud directly from within CUDA-Q is not (yet) supported,
+you can use the NGC CLI to launch and interact with workloads in DGX Cloud.
+The following sections detail how to do that, and how to connect JupyterLab and/or VS Code
+to a running CUDA-Q job in DGX Cloud.
+
+.. _dgx-cloud-setup:
+
+Get Started
++++++++++++++++++++++++++++++++
+
+To get started with DGX Cloud, you can 
+`request access here <https://www.nvidia.com/en-us/data-center/dgx-cloud/trial/>`__.
+Once you have access, `sign in <https://ngc.nvidia.com/signin>`__ to your account,
+and `generate an API key <https://ngc.nvidia.com/setup/api-key>`__. 
+`Install the NGC CLI <https://ngc.nvidia.com/setup/installers/cli>`__
+and configure it with 
+
+.. code-block:: console
+
+    ngc config set
+
+entering the API key you just generated when prompted, and configure other settings as appropriate.
+
+.. note::
+
+  The rest of this section assumes you have CLI version 3.33.0. If you 
+  have an older version installed, you can upgrade to the latest version using the command
+
+  .. code-block:: console
+
+      ngc version upgrade 3.33.0
+  
+  See also the `NGC CLI documentation <https://docs.ngc.nvidia.com/cli/index.html>`__
+  for more information about available commands.
+
+You can see all information about available compute resources and ace instances
+with the command 
+
+.. code-block:: console
+
+    ngc base-command ace list
+
+Confirm that you can submit a job with the command
+
+.. code-block:: console
+
+    ngc base-command job run \
+      --name Job-001 --total-runtime 60s \
+      --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \
+      --ace <ace_name> --instance <instance_name> \
+      --commandline 'echo "Hello from DGX Cloud!"'
+
+replacing `<ace_name>` and `<instance_name>` with the name of the ace and instance you want 
+to execute the job on.
+You should now see that job listed when you run the command
+
+.. code-block:: console
+
+    ngc base-command job list
+
+Once it has completed you can download the job results using the command
+
+.. code-block:: console
+
+    ngc base-command result download <job_id>
+
+replacing `<job_id>` with the id of the job you just submitted.
+You should see a new folder named `<job_id>` with the job log that contains 
+the output "Hello from DGX Cloud!".
+
+For more information about how to use the NGC CLI to interact with DGX Cloud, 
+we refer to the `NGC CLI documentation <https://docs.ngc.nvidia.com/cli/index.html>`__.
+
+Use JupyterLab
++++++++++++++++++++++++++++++++
+
+Once you can :ref:`run jobs on DGX Cloud <dgx-cloud-setup>`, you can launch an interactive job 
+to use CUDA-Q with `JupyterLab <https://jupyterlab.readthedocs.io/en/latest/>`__ 
+running on DGX Cloud:
+
+.. code-block:: console
+
+    ngc base-command job run \
+      --name Job-interactive-001 --total-runtime 600s \
+      --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \
+      --ace <ace_name> --instance <instance_name> \
+      --port 8888 --commandline 'jupyter-lab-setup <my-custom-token> --port=8888'
+
+Replace `<my-custom-token>` in the command above with a custom token that you can freely choose.
+You will use this token to authenticate with JupyterLab;
+Go to the `job portal <https://bc.ngc.nvidia.com/jobs>`__, click on the job you just launched, and click on the link
+under |:spellcheck-disable:|"URL/Hostname"|:spellcheck-enable:| in Service Mapped Ports. 
+
+.. note::
+
+  It may take a couple of minutes for DGX Cloud to launch and for the URL to become active, even after it appears in the Service Mapped Ports section;
+  if you encounter a "404: Not Found" error, be patient and try again in a couple of minutes.
+
+Once this URL opens, you should see the JupyterLab authentication page; enter the 
+token you selected above to get access to the running CUDA-Q container.
+On the left you should see a folder with tutorials. Happy coding!
+
+Use VS Code
++++++++++++++++++++++++++++++++
+
+Once you can :ref:`run jobs on DGX Cloud <dgx-cloud-setup>`, you can launch an interactive job 
+to use CUDA-Q with a local installation of `VS Code <https://code.visualstudio.com/>`_, 
+or the `VS Code Web UI <https://vscode.dev/>`__, running on DGX Cloud:
+
+.. code-block:: console
+
+    ngc base-command job run \
+      --name Job-interactive-001 --total-runtime 600s \
+      --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \
+      --ace <ace_name> --instance <instance_name> \
+      --commandline 'vscode-setup tunnel --name cuda-quantum-dgx --accept-server-license-terms'
+
+Go to the `job portal <https://bc.ngc.nvidia.com/jobs>`__, click on the job you just launched, and select the "Log"
+tab. Once the job is running, you should see instructions there for how to connect to the device the job is running on.
+These instructions include a link to open and the code to enter on that page; follow the instructions to authenticate. 
+Once you have authenticated, you can either 
+`open VS Code in a web browser <https://vscode.dev/tunnel/cuda-quantum-dgx/home/cudaq/>`__, 
+or connect a local installation of VS Code.
+To connect a local installation of VS Code, make sure you have the 
+`Remote - Tunnels <https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server>`__ extension installed,
+then open the Command Palette with `Ctrl+Shift+P`, enter "Remote Tunnels: Connect to Tunnel", 
+and enter `cuda-quantum-remote`. After the window reloaded, enter "File: Open Folder" in the Command Palette 
+to open the `/home/cudaq/` folder.
+
+You should see a pop up asking if you want to install the recommended extensions. Selecting to install them will
+configure VS Code with extensions for working with C++, Python, and Jupyter.
+You can always see the list of recommended extensions that aren't installed yet by clicking on the "Extensions" icon in the sidebar and navigating to the "Recommended" tab.
+
+If you enter "View: Show Explorer" in the Command Palette, you should see a folder with tutorials and examples
+to help you get started. Take a look at `Next Steps`_ to dive into CUDA-Q development.
+
+.. _additional-cuda-tools:
+
+Additional CUDA Tools
+------------------------------------
+
+CUDA-Q makes use of GPU-acceleration in certain backends and components. 
+Depending on how you installed CUDA-Q, you may need to install 
+certain CUDA libraries separately to take advantage of these.
+
+Installation via PyPI
+++++++++++++++++++++++++++++++++++++
+
+If you installed CUDA-Q via `PyPI <https://pypi.org/project/cuda-quantum>`__, please follow the installation instructions there to install the necessary CUDA dependencies.
+
+Installation In Container Images
+++++++++++++++++++++++++++++++++++++
+
+If you are using the CUDA-Q container image, the image already contains all necessary runtime libraries to use all CUDA-Q components. To take advantage of GPU-acceleration, make sure
+to enable GPU support when you launch the container, that is pass the `--gpus all` flag when launching 
+the container with Docker and the `--nv` flag when launching the container with Singularity.
+
+Note that the image does not contain all development dependencies for CUDA, such as, for example the `nvcc` compiler. You can install all CUDA development dependencies by running the command 
+
+.. code-block:: console
+
+    sudo apt-get install cuda-toolkit-11.8
+
+inside the container. Most Python packages that use GPU-acceleration, such as for example `CuPy <https://cupy.dev>`__, require an existing CUDA installation. After installing the `cuda-toolkit-11.8` you can install CuPy with the command
+
+.. code-block:: console
+
+    python3 -m pip install cupy-cuda11x
+
+.. _cuda-dependencies-prebuilt-binaries:
+
+Installing Pre-built Binaries
+++++++++++++++++++++++++++++++++++++
+
+If you installed pre-built binaries for CUDA-Q, you will need to install 
+the necessary CUDA 11 runtime libraries to use GPU-acceleration in CUDA-Q. 
+If you prefer to only install the minimal set of runtime libraries, the following 
+commands, for example, install the necessary packages for RHEL 8:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>CUDARTInstall]
+    :end-before: [<CUDARTInstall]
+
+More detailed instructions for your platform can be found in the online documentation
+linked for that `CUDA version <https://developer.nvidia.com/cuda-toolkit-archive>`__. 
+Please make sure to install CUDA version 11.8, and confirm that your 
+`GPU driver <https://www.nvidia.com/download/index.aspx>`__ supports that version.
+While the above packages are sufficient to use GPU-acceleration within CUDA-Q, 
+we recommend installing the complete CUDA toolkit (`cuda-toolkit-11-8`) that also 
+includes the `nvcc` compiler.
+
+.. _distributed-computing-with-mpi:
+
+Distributed Computing with MPI
+------------------------------------
+
+CUDA-Q supports the Message Passing Interface (MPI) parallelism via a plugin interface.
+It is possible to activate or replace such an MPI plugin without re-installing or re-compiling CUDA-Q.
+MPI calls via CUDA-Q API for C++ and Python will be delegated to the currently activated plugin at runtime.
+
+.. tab:: Built-in MPI Support
+
+  The :ref:`CUDA-Q Docker image <install-docker-image>` is shipped with a pre-built MPI plugin based on an 
+  optimized OpenMPI installation included in the image. No action is required to use this plugin. 
+  We recommend using this plugin unless the container host has an existing MPI implementation other than OpenMPI.
+
+  If you are not using the Docker image, or are using the image on a system that has a
+  vendor-optimized MPI library pre-installed, please follow the instructions in the "Custom MPI Support" tab 
+  to enable MPI support.
+
+.. tab:: Custom MPI Support
+
+  If you are not using the Docker image, or are using the image on a system that has a
+  vendor-optimized MPI library pre-installed, CUDA-Q can be configured to use the local MPI installation by
+  manually activating a suitable plugin post-installation.
+  To do so, 
+
+  - Make sure the environment variable `CUDA_QUANTUM_PATH` points to the CUDA-Q installation directory. 
+    If you installed CUDA-Q using the `installer <install-prebuilt-binaries>`, or if you are using the CUDA-Q 
+    container image, this variable should already be defined. If you installed the CUDA-Q 
+    `Python wheels <install-python-wheels>`, set this variable to the directory listed under "Location" when you run the 
+    command `pip show cuda-quantum`.
+
+  - Set the environment variable `MPI_PATH` to the location of your MPI installation. In particular, `${MPI_PATH}/include` 
+    is expected to contain the `mpi.h` header and `${MPI_PATH}/lib64` or `${MPI_PATH}/lib` is expected to contain `libmpi.so`.
+
+  - Execute the following command to complete the activation:
+
+    .. code-block:: console
+
+        bash $CUDA_QUANTUM_PATH/distributed_interfaces/activate_custom_mpi.sh
+
+  .. note::
+
+    HPC data centers often have a vendor-optimized MPI library pre-installed on their system. 
+    If you are using our container images, installing that MPI implementation in the container 
+    and manually activating the plugin following the steps above ensure the best performance,
+    and guarantee compatibility when MPI injection into a container occurs. 
+
+  Manually activating an MPI plugin replaces any existing plugin; After the initial activation, the newly built 
+  `libcudaq_distributed_interface_mpi.so` in the installation directory will subsequently always be used to 
+  handle CUDA-Q MPI calls.
+
+  .. note::
+
+    Executing the activation script from the CUDA-Q installation directory requires *write* permissions to that directory.
+    If you do not have the necessary permissions, copy the `distributed_interfaces` sub-directory to a local location and execute the 
+    activation script from there.
+
+    In this scenario, since the activated plugin (`libcudaq_distributed_interface_mpi.so`) is outside the CUDA-Q installation,
+    you must set the environment variable `$CUDAQ_MPI_COMM_LIB` to the path of that shared library.
+    This is done automatically when executing that activation script, but you may wish to persist that environment variable 
+    between bash sessions, e.g., by adding it to the `.bashrc` file.
+
+.. _updating-cuda-quantum:
+
+Updating CUDA-Q
+--------------------------------
+
+If you installed the CUDA-Q Python wheels, you can update to the latest release
+by running the command 
+
+.. code-block:: console
+
+    python3 -m pip install --upgrade cuda-quantum
+
+If you previously installed the CUDA-Q pre-built binaries, you should first uninstall your 
+current CUDA-Q installation before installing the new version using the installer. 
+To uninstall your current CUDA-Q version, run the command
+
+.. code-block:: console
+
+    sudo bash "${CUDA_QUANTUM_PATH}/uninstall.sh" -y
+
+The `uninstall.sh` script is generated during installation, and will remove all files 
+and folders that were created as part of the installation, whether they were modified 
+in the meantime or not. It does not remove any additional files that existed prior 
+to the installation or that you have added to the installation location since then. 
+You can then download and install the new version of CUDA-Q following the
+instructions :ref:`above <install-prebuilt-binaries>`.
+
+.. _dependencies-and-compatibility:
+
+Dependencies and Compatibility
+--------------------------------
+
+CUDA-Q can be used to compile and run quantum programs on a CPU-only system, but a GPU is highly recommended and necessary to use the GPU-based simulators, see also :doc:`../backends/simulators`.
+
+The supported CPUs include x86_64 (x86-64-v3 architecture and newer) and ARM64 (ARM v8-A architecture and newer).
+
+.. note:: 
+
+  Some of the components included in the CUDA-Q Python wheels depend on an existing CUDA installation on your system. For more information about installing the CUDA-Q Python wheels, take a look at :ref:`this section <install-python-wheels>`.
+
+The following table summarizes the required components.
+
+.. list-table:: Supported Systems
+    :widths: 30 50
+    :header-rows: 0
+
+    * - CPU architectures
+      - x86_64, ARM64
+    * - Operating System
+      - Linux
+    * - Tested Distributions
+      - CentOS 8; Debian 11, 12; Fedora 38; OpenSUSE/SLED/SLES 15.5; RHEL 8, 9; Rocky 8, 9; Ubuntu 22.04
+    * - Python versions
+      - 3.8+
+
+.. list-table:: Requirements for GPU Simulation
+    :widths: 30 50
+    :header-rows: 0
+
+    * - GPU Architectures
+      - Volta, Turing, Ampere, Ada, Hopper
+    * - NVIDIA GPU with Compute Capability
+      - 7.0+
+    * - CUDA
+      - 11.x (Driver 470.57.02+), 12.x (Driver 525.60.13+)
+
+Detailed information about supported drivers for different CUDA versions and be found `here <https://docs.nvidia.com/deploy/cuda-compatibility/>`__.
+
+
+.. _post-installation:
+
+Next Steps
+----------
+
+You can now compile and/or run the C++ and Python examples using the terminal.
+To open a terminal in VS Code, open the Command Palette with `Ctrl+Shift+P` and 
+enter "View: Show Terminal".
+
+.. image:: ../../_static/getToWork.png 
+
+The CUDA-Q image contains a folder with examples and tutorials in the :code:`/home/cudaq` directory. 
+These examples are provided to get you started with CUDA-Q and understanding 
+the programming and execution model. 
+If you are not using a container image, you can find these examples on our 
+`GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__.
+
+Let's start by running a simple program to validate your installation.
+The samples contain an implementation of a 
+`Bernstein-Vazirani algorithm <https://en.wikipedia.org/wiki/Bernstein%E2%80%93Vazirani_algorithm>`__. 
+To run the example, execute the command:
+
+.. tab:: Python
+
+  .. code-block:: console
+
+      python examples/python/bernstein_vazirani.py --size 5
+
+.. tab:: C++
+
+  .. code-block:: console
+
+      nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp && ./a.out
+
+This will execute the program on the :ref:`default simulator <default-simulator>`, which will use GPU-acceleration if 
+a suitable GPU has been detected. To confirm that the GPU acceleration works, you can 
+increase the size of the secret string, and pass the target as a command line argument:
+
+.. tab:: Python
+
+  .. code-block:: console
+
+      python examples/python/bernstein_vazirani.py --size 25 --target nvidia
+
+.. tab:: C++
+
+  .. code-block:: console
+
+      nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp -DSIZE=25 --target nvidia && ./a.out
+
+This program should complete fairly quickly. Depending on the available memory on your GPU,
+you can set the size of the secret string to up to 28-32 when running on the `nvidia` target. 
+
+.. note::
+
+  If you get an error that the CUDA driver version is insufficient or no GPU has been detected,
+  check that you have enabled GPU support when launching the container by passing the `--gpus all` flag
+  (for :ref:`Docker <install-docker-image>`) or the `--nv` flag (for :ref:`Singularity <install-singularity-image>`).
+  If you are not running a container, you can execute the command `nvidia-smi` to confirm your setup;
+  if the command is unknown or fails, you do not have a GPU or do not have a driver installed. If the command
+  succeeds, please confirm that your CUDA and driver version matches the 
+  :ref:`supported versions <dependencies-and-compatibility>`.
+
+Let's compare that to using only your CPU:
+
+.. tab:: Python
+
+  .. code-block:: console
+
+      python examples/python/bernstein_vazirani.py --size 25 --target qpp-cpu
+
+.. tab:: C++
+
+  .. code-block:: console
+
+      nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp -DSIZE=25 --target qpp-cpu && ./a.out
+
+When you execute this command, the program simply seems to hang; that is because it takes
+a long time for the CPU-only backend to simulate 28+ qubits! Cancel the execution with `Ctrl+C`.
+
+You are now all set to start developing quantum applications using CUDA-Q!
+Please proceed to :doc:`Basics <../basics/basics>` for an introduction
+to the fundamental features of CUDA-Q.
\ No newline at end of file
diff --git a/pr-2241/_sources/using/integration/cmake_app.rst.txt b/pr-2241/_sources/using/integration/cmake_app.rst.txt
new file mode 100644
index 0000000000..d54a761284
--- /dev/null
+++ b/pr-2241/_sources/using/integration/cmake_app.rst.txt
@@ -0,0 +1,39 @@
+CUDA-Q and CMake
+**********************
+
+CUDA-Q provides a full compiler toolchain for building 
+out quantum-classical applications. Since most C++ projects 
+provide some sort of integration with CMake, it becomes imperative 
+for our toolchain to integrate well with the CMake build system. 
+
+CUDA-Q provides CMake configuration files that allow downstream 
+application developers to create hybrid quantum-classical source code 
+and build it with the typical CMake workflow, which will natively 
+leverage :code:`nvq++` for compilation of CUDA-Q source files. 
+
+To see how this works, let's create a trivial example. Suppose we have 
+a folder named :code:`myCudaQApp` and within that folder we have 
+a simple CUDA-Q source file, like `ghz.cpp`. With a local 
+CUDA-Q installation present on the system, we can create the 
+following top-level :code:`CMakeLists.txt` file to build this file with 
+:code:`nvq++`:
+
+.. code:: bash 
+
+    cmake_minimum_required(VERSION 3.24 FATAL_ERROR)
+    project(myCudaQApp LANGUAGES CXX)
+    find_package(CUDAQ REQUIRED)
+    add_executable(ghz_exe ghz.cpp)
+
+To configure and build this file, all we need to do is execute the following from the top level of the :code:`myCudaQApp` folder:
+
+.. code:: bash 
+
+    mkdir build && cd build 
+    cmake .. -G Ninja -DCUDAQ_DIR="$CUDA_QUANTUM_PATH/lib/cmake/cudaq"
+    ninja
+    ./ghz_exe 
+
+Notice that by running the :code:`ninja` command with :code:`--verbose`, you'll see that 
+:code:`nvq++` was used to compile and link the executable. 
+
diff --git a/pr-2241/_sources/using/integration/cuda_gpu.rst.txt b/pr-2241/_sources/using/integration/cuda_gpu.rst.txt
new file mode 100644
index 0000000000..4ad7c09f89
--- /dev/null
+++ b/pr-2241/_sources/using/integration/cuda_gpu.rst.txt
@@ -0,0 +1,114 @@
+Using CUDA and CUDA-Q in a Project
+****************************************
+
+It may be the case that a project that uses CUDA-Q kernels may also
+want to use CUDA code to do computation on a GPU.  This is possible by using
+both the CUDA Toolkit and CUDA-Q tools. More about programming GPUs
+in CUDA can be found in the `Quick Start Guide
+<https://docs.nvidia.com/cuda/cuda-quick-start-guide/index.html>`__.
+
+Once the `nvcc` compiler is installed, it is possible to write
+CUDA kernels and have them execute on the system GPU. See NVIDIA's `An
+Easy Introduction to CUDA C and C++
+<https://developer.nvidia.com/blog/easy-introduction-cuda-c-and-c/>`__
+for more information on getting started with CUDA.
+
+CUDA code uses a unique syntax and is, typically, saved in a file with
+the extension `.cu`. For our example, assume we have written our
+CUDA code in the file `my_proj.cu`.
+
+CUDA-Q code is a library-based extension of C++ and uses
+standard conforming C++ syntax. Typically, a quantum kernel would be
+saved in a file with the `.cpp` extension. Again for our
+example, let's assume that we've written quantum kernels and saved
+them in the file `my_proj_quantum.cpp`.
+
+By default, CUDA-Q uses C++ 20 and builds source code against the 
+LLVM C++ standard library (`libc++`). To create a CUDA library that 
+can link against CUDA-Q code, make sure to define an API that does 
+not rely on C++ data structures that rely on a specific C++ toolchain
+for all functions intended to be called from CUDA-Q (see also 
+:ref:`clike-shim`). For example, if you define a CUDA kernel in `my_proj.cu`
+
+.. code-block:: cpp
+
+    template <typename CudaDataType>
+    __global__ void cudaSetFirstNElements(CudaDataType *sv, const CudaDataType *__restrict__ sv2, int64_t N) {
+    int64_t i = static_cast<int64_t>(blockIdx.x) * blockDim.x + threadIdx.x;
+        if (i < N) {
+            sv[i].x = sv2[i].x;
+            sv[i].y = sv2[i].y;
+        } else {
+            sv[i].x = 0.0;
+            sv[i].y = 0.0;
+        }
+    }
+
+define the following template and all desired template specializations
+
+.. code-block:: cpp
+
+    template <typename CudaDataType>
+    void setFirstNElements(uint32_t n_blocks, 
+                           int32_t threads_per_block, 
+                           void *newDeviceStateVector, 
+                           void *deviceStateVector,
+                           std::size_t previousStateDimension) {
+        cudaSetFirstNElements<<<n_blocks, threads_per_block>>>(
+            reinterpret_cast<CudaDataType *>(newDeviceStateVector),
+            reinterpret_cast<CudaDataType *>(deviceStateVector),
+            previousStateDimension);
+    }
+
+    template void
+    setFirstNElements<cuFloatComplex>(uint32_t n_blocks, 
+                                      int32_t threads_per_block, 
+                                      void *newDeviceStateVector, 
+                                      void *deviceStateVector,
+                                      std::size_t previousStateDimension);
+
+    template void
+    setFirstNElements<cuDoubleComplex>(uint32_t n_blocks, 
+                                       int32_t threads_per_block, 
+                                       void *newDeviceStateVector, 
+                                       void *deviceStateVector,
+                                       std::size_t previousStateDimension);
+
+Create the corresponding header file `my_proj.h` declaring the `setFirstNElements`
+template. You can then call `setFirstNElements` from within `my_proj_quantum.cpp`
+by including `my_proj.h`, for example
+
+.. code-block:: cpp
+
+    #include "cuComplex.h"
+    #include "cuda_runtime.h"
+    #include "device_launch_parameters.h"
+    #include "my_proj.h"
+
+    using namespace my_kernels; // the namespace where you defined setFirstNElements
+
+    int main () {
+        const uint32_t n_blocks = 10;
+        const uint32_t threads_per_block = 5;
+
+        void *deviceStateVector;
+        cudaMalloc((void **)&deviceStateVector, 2 * sizeof(cuDoubleComplex));
+        // ...
+        void *newDeviceStateVector;
+        cudaMalloc((void **)&newDeviceStateVector, 2 * sizeof(cuDoubleComplex));
+        setFirstNElements<cuDoubleComplex>(n_blocks, threads_per_block,
+                                           newDeviceStateVector, deviceStateVector,
+                                           2);
+        return 0;
+    }
+
+To get an executable, compile the code with
+
+.. code-block:: bash
+
+    nvcc -c -std=c++17 -Xcompiler -fPIC my_proj.cu -o my_proj.o
+    nvq++ my_proj_quantum.cpp my_proj.o -I"${CUDA_HOME}/include/" -L"${CUDA_HOME}/lib64" -lcudart -o my_executable
+
+Above, :code:`nvq++` is used for the link step and will make sure the CUDA-Q
+runtime libraries are linked correctly to the executable program.
+The CUDA runtime is explicitly added to this command.
diff --git a/pr-2241/_sources/using/integration/integration.rst.txt b/pr-2241/_sources/using/integration/integration.rst.txt
new file mode 100644
index 0000000000..ce6d6ab094
--- /dev/null
+++ b/pr-2241/_sources/using/integration/integration.rst.txt
@@ -0,0 +1,11 @@
+Integration with other Software Tools
+**************************************
+
+.. toctree::
+  :maxdepth: 1
+
+  Downstream CMake Integration <cmake_app.rst>
+  Combining CUDA with CUDA-Q <cuda_gpu.rst>
+  Integrating with Third-Party Libraries <libraries.rst>
+
+Information about customizing or extending the CUDA-Q toolchain can be found in :doc:`../extending/extending`.
\ No newline at end of file
diff --git a/pr-2241/_sources/using/integration/libraries.rst.txt b/pr-2241/_sources/using/integration/libraries.rst.txt
new file mode 100644
index 0000000000..0e7c7c6fcd
--- /dev/null
+++ b/pr-2241/_sources/using/integration/libraries.rst.txt
@@ -0,0 +1,226 @@
+Integrating with Third-Party Libraries
+****************************************
+
+CUDA-Q enables easily integrating quantum kernels with existing state-of-the-art tools
+for classical computing and high performance computing. While quantum kernels are expressed 
+in Python or C++, quantum hardware backends only support a very limited set of classical 
+instructions. Correspondingly, only a select set of libraries and functions that are 
+directly supported by the CUDA-Q compiler can be called from within quantum kernels.
+Code that is not marked as kernel code, on the other hand, can be used to invoke the 
+defined quantum kernels as well as any classical tools and libraries. CUDA-Q provides 
+a complete toolset to build complex applications running on multi-processor systems involving
+CPUs, GPUs and QPUs. 
+
+In Python, integration with any third-party Python package is handled
+automatically without any need for additional configuration. For C++, the rest of this
+document outlines how to integration with libraries that are compile with a different 
+compiler than `nvq++`.
+
+
+Calling a CUDA-Q library from C++
+--------------------------------------
+
+The CUDA-Q compiler is a fully-featured C++ compiler able to process arbitrary C++ code outside
+of quantum kernels. In fact, the CUDA-Q installation includes and invokes a custom-built Clang 
+compiler under the hood. In general, it hence is not necessary to use a different compiler to 
+compile C++ host code that calls into quantum kernels; the host code is compiled along with 
+the quantum kernels into a single library or executable by the CUDA-Q toolchain.
+
+If you would still like to create a library that can be included in libraries and executables 
+built with a different toolchain, you can configure `nvq++` to include and encapsulate all its
+C++ dependencies, such that the CUDA-Q library only depends on C libraries. For example, 
+if you have a file `quantum_kernel.cpp` containing 
+
+.. code:: C++
+
+    #include "cudaq.h"
+    #include <iostream>
+    #include <sstream>
+
+    namespace quantum {
+
+    __qpu__ void bell() {
+      cudaq::qvector qs(2);
+      h(qs[0]);
+      cnot(qs[0], qs[1]);
+      mz(qs);
+    }
+
+    // Usually, one would probably return something like
+    // the most probably value in the distribution rather
+    // than the string dump. However, the bell kernel here
+    // has a 50/50 chance of returning 00 or 11.
+    const char* bell_distribution() {
+      auto dist = cudaq::sample(bell);
+
+      std::stringbuf buffer;
+      std::ostream os(&buffer);
+      dist.dump(os);
+      auto sample_results = buffer.str();
+
+      char* ptr = new char[sample_results.size() + 1];
+      strcpy(ptr, sample_results.c_str());
+      return ptr;
+    }
+
+    } // namespace quantum
+
+you can create such a library with the command
+
+.. code:: bash
+
+    nvq++ quantum_kernel.cpp -shared -static-libstdc++ -fPIC -o libquantum_kernel.so
+
+To use this library in a project built with an external toolchain, define a suitable 
+header file `quantum_kernel.h` containing
+
+.. code:: C++
+
+    namespace quantum {
+      const char* bell_distribution();
+    }
+
+and include it in your project. For example, if `external.cpp` contains
+
+.. code:: C++ 
+
+    #include <iostream>
+    #include "quantum_kernel.h"
+
+    int main () {
+      // some code
+      auto bell_dist = quantum::bell_distribution();
+      std::cout << bell_dist << std::endl;
+      delete[] bell_dist;
+      // more code
+      return 0;
+    }
+
+you can compile it with `g++` and link it with the built `libquantum_kernel.so` library
+using the command
+
+.. code:: bash
+
+    g++ external.cpp -lquantum_kernel -L"$(pwd)" -Wl,-rpath="$(pwd)" -I"$(pwd)"
+
+Note that the API defined in `quantum_kernel.h` does not depend on any data types that 
+rely on the specific implementation of the C++ standard library. For example, we return a 
+`const char*` instead of a `std::string` value. This is important to ensure that the data 
+is handled correctly regardless of which C++ standard library is used. If you include
+data types that depend on a specific C++ ABI, the linker should detect this incompatibility
+and should generate an error. See the section :ref:`clike-shim` below to learn more about 
+what to watch out for when defining an API to interface between libraries that are built 
+with different compilers. 
+
+
+Calling an C++ library from CUDA-Q
+--------------------------------------
+
+CUDA-Q comes with a complete C++ toolchain, and is configured to use its own C++ standard
+library by default. When calling a third-party library from within a CUDA-Q application,
+the quantum kernels and the surrounding application code are compiled with the `nvq++` compiler, 
+whereas the third-party library may be compiled with a different toolchain. 
+For most widely distributed libraries, this will work out of the box. The exception are 
+third-party libraries that are pre-compiled (opposed to being header-only libraries) 
+and dynamically depend on a different C++ standard library than CUDA-Q uses. 
+This is the case for a library `third_party_library.so` if `libstdc++.so` is listed 
+in the output of the command
+
+.. code:: bash
+
+    ldd third_party_library.so
+
+To use such a library with CUDA-Q, you have to install the static version of the 
+library. The `nvq++` compiler can be configured to link a static library 
+`libexternal_library.a` instead of the shared one with the same flags as GCC/Clang:
+
+.. code:: bash
+
+    nvq++ my_code.cpp -Wl,-Bstatic -lexternal_library -Wl,-Bdynamic ...
+
+If the compilation fails due to undefined symbols during linking, then `libexternal_library.a`
+does not include the C++ standard library components it depends on. In this case, you can create a 
+suitable static library that contains the external library as well as its `libstdc++` dependencies
+by combining `libexternal_library.a` and `libstdc++.a` into a single flattened archive.
+For example, if the external library is built with GCC and located in `/usr/lib`,
+the following commands create a suitable archive using the GNU archiver:
+
+.. code:: bash
+
+    ar cruT libexternal_library_complete.a /usr/lib/libexternal_library.a "$(g++ -print-file-name=libstdc++.a)"
+    echo -e 'create libexternal_library_complete.a\naddlib libexternal_library_complete.a\nsave\nend' | ar -M
+
+The above commands create a new static library `libexternal_library_complete.a` in the current directory. 
+To use it, adjust the `nvq++` command accordingly:
+
+.. code:: bash
+
+    nvq++ my_code.cpp -L. -Wl,-Bstatic -lexternal_library_complete -Wl,-Bdynamic ...
+
+.. note::
+
+  If the third-party library functions you are calling from your CUDA-Q code 
+  consume or produce data types that explicitly depend on the C++ standard library implementation,
+  a small shim is needed to properly encapsulate these dependencies, as described in
+  :ref:`clike-shim`.
+
+
+.. _clike-shim:
+
+Interfacing between binaries compiled with a different toolchains
+---------------------------------------------------------------------
+
+To avoid incompatibilities between different C++ implementations, 
+two binaries built using a different C++ compiler should be careful when passing data types between them
+that rely on a specific C++ implementation. While primitive data types can be passed without
+issues, attempting to pass a string, for example, will result in a linking failure; a `char*` must 
+be passed instead of a string.
+
+Most other data types, including templated types, can be passed as long as their alignment matches.
+While different compilers generally align data differently, it is possible to force a particular 
+alignment when defining the data type or value. For example, if we define a struct
+
+.. code:: C++
+
+    #pragma pack(push, 4)
+    template <typename ScalarType>
+    struct Entry {
+      bool is_integral;
+      ScalarType value;
+    };
+    #pragma pack(pop)
+
+the `pragma` directives ensure that each item will be 4-byte aligned, regardless of the 
+default setting that can differ between compilers.
+
+Even function pointers can usually be passed, as long as their argument and return types can be passed.
+When using templated functions and data types, the header file should only include their declaration as well 
+as explicit instantiation for all valid template arguments. For example,
+
+.. code:: C++
+
+    template <typename CudaDataType>
+    void initializeDeviceStateVector(uint32_t n_blocks, 
+                                    int32_t threads_per_block, 
+                                    void *deviceStateVector,
+                                    std::size_t stateDimension) {
+      cudaInitializeDeviceStateVector<<<n_blocks, threads_per_block>>>(
+        reinterpret_cast<CudaDataType *>(deviceStateVector), stateDimension);
+    }
+
+    template void
+    initializeDeviceStateVector<cuFloatComplex>(uint32_t n_blocks, 
+                                    int32_t threads_per_block, 
+                                    void *deviceStateVector,
+                                    std::size_t stateDimension);
+
+    template void
+    initializeDeviceStateVector<cuDoubleComplex>(uint32_t n_blocks, 
+                                    int32_t threads_per_block, 
+                                    void *deviceStateVector,
+                                    std::size_t stateDimension);
+
+The most cumbersome aspect when libraries built with different toolchains are combined into a single executable
+is exception handling. Since the handling relies on a specific ABI, an thrown exception is not necessarily 
+recognized as such in a library that uses a different ABI implementation. While matching the exception type 
+may not work as expected, a catch-all will reliably catch any thrown exception. 
diff --git a/pr-2241/_sources/using/quick_start.rst.txt b/pr-2241/_sources/using/quick_start.rst.txt
new file mode 100644
index 0000000000..0e88f40ea4
--- /dev/null
+++ b/pr-2241/_sources/using/quick_start.rst.txt
@@ -0,0 +1,130 @@
+Quick Start
+===================
+
+**NVIDIA CUDA-Q**
+
+CUDA-Q streamlines hybrid application development and promotes productivity and scalability
+in quantum computing. It offers a unified programming model designed for a hybrid
+setting |---| that is, CPUs, GPUs, and QPUs working together. CUDA-Q contains support for 
+programming in Python and in C++. Learn more about the `key benefits of CUDA-Q <https://developer.nvidia.com/cuda-q>`_.
+
+This Quick Start page guides you through installing CUDA-Q and running your first program.
+If you have already installed and configured CUDA-Q, or if you are using our 
+`Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum>`_, you can move directly to our
+:doc:`Basics Section <basics/basics>`. More information about working with containers and Docker alternatives can be 
+found in our complete :doc:`Installation Guide <install/install>`.
+
+Install CUDA-Q
+----------------------------
+
+.. tab:: Python
+
+   To develop CUDA-Q applications using Python, 
+   please follow the instructions for `installing CUDA-Q <https://pypi.org/project/cuda-quantum/>`_ from PyPI. 
+   If you have an NVIDIA GPU, make sure to also follow the instructions for enabling GPU-acceleration.
+
+   .. include:: ../../../python/README.md
+      :parser: myst_parser.sphinx_
+      :start-after: (Begin complete install)
+      :end-before: (End complete install)
+
+   Once you completed the installation, please follow the instructions
+   :ref:`below <validate-installation>` to run your first CUDA-Q program!
+
+.. tab:: C++
+
+   To develop CUDA-Q applications using C++, please make sure you have a C++ toolchain installed
+   that supports C++20, for example `g++` version 11 or newer.
+   Download the `install_cuda_quantum` file for your processor architecture from
+   the assets of the respective `GitHub release <https://github.com/NVIDIA/cuda-quantum/releases>`__; that is the file with the `aarch64` extension for ARM processors, and the one with `x86_64` for, e.g., Intel and AMD processors.
+
+   To install CUDA-Q, execute the commands
+
+   .. code-block:: bash
+
+      sudo -E bash install_cuda_quantum.$(uname -m) --accept 
+      . /etc/profile
+
+   If you have an NVIDIA GPU, please also install the `CUDA Toolkit <https://developer.nvidia.com/cuda-downloads>`__ to enable GPU-acceleration within CUDA-Q.
+
+   Please see the complete :ref:`installation guide <install-prebuilt-binaries>` for more details, including
+
+   - a list of :ref:`supported operating systems <dependencies-and-compatibility>`, 
+   - instructions on how to :ref:`enable MPI parallelization <distributed-computing-with-mpi>` within CUDA-Q, and
+   - information about :ref:`updating CUDA-Q <updating-cuda-quantum>`.
+
+   Once you completed the installation, please follow the instructions
+   :ref:`below <validate-installation>` to run your first CUDA-Q program!   
+
+.. |---|   unicode:: U+2014 .. EM DASH
+   :trim:
+
+.. _validate-installation:
+
+Validate your Installation
+----------------------------
+
+Let's run a simple program to validate your installation.
+The quantum kernel in the following program creates and measures the state 
+:math:`(|00\rangle + |11\rangle) / \sqrt{2}`. That means each kernel execution should 
+either yield `00` or `11`. The program samples, meaning it executes, the kernel 1000 times
+and prints how many times each output was measured. On average, the values `00` and `11`
+should be observed around 500 times each.
+
+.. tab:: Python
+
+   Create a file titled `program.py`, containing the following code:
+
+   .. literalinclude:: /snippets/python/quick_start.py
+      :language: python
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+   Run this program as you do any other Python program, for example:
+
+   .. code-block:: console
+
+      python3 program.py
+
+.. tab:: C++
+
+   Create a file titled `program.cpp`, containing the following code:
+
+   .. literalinclude:: /snippets/cpp/quick_start.cpp
+      :language: cpp
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+   Compile the program using the `nvq++` compiler and run the built application with the following command:
+
+   .. code-block:: console
+
+      nvq++ program.cpp -o program.x && ./program.x
+
+If you have an NVIDIA GPU the program uses GPU acceleration by default.
+To confirm that this works as expected and to see the effects of GPU acceleration, you can 
+increase the numbers of qubits the program uses to 28 and
+compare the time to execute the program on the 
+`nvidia` target (:ref:`GPU-accelerated statevector simulator <cuQuantum single-GPU>`) to the time when setting the target to `qpp-cpu` (:ref:`OpenMP parallelized CPU-only statevector simulator <OpenMP CPU-only>`):
+
+.. tab:: Python
+
+   .. code-block:: console
+
+      python3 program.py 28 --target nvidia
+
+.. tab:: C++
+
+   .. code-block:: console
+
+      nvq++ program.cpp -o program.x --target nvidia && ./program.x 28
+
+When you change the target to `qpp-cpu`, the program simply seems to hang; that is because it takes a long time for the CPU-only backend to simulate 28+ qubits! Cancel the execution with `Ctrl+C`.
+
+For more information about enabling GPU-acceleration, please see
+our complete :ref:`Installation Guide <additional-cuda-tools>`.
+For further information on available targets, see :doc:`Backends <backends/backends>`.
+
+You are now all set to start developing quantum applications using CUDA-Q!
+Please proceed to :doc:`Basics <basics/basics>` for an introduction
+to the fundamental features of CUDA-Q.
diff --git a/pr-2241/_sources/using/tutorials.rst.txt b/pr-2241/_sources/using/tutorials.rst.txt
new file mode 100644
index 0000000000..ad45c8b48f
--- /dev/null
+++ b/pr-2241/_sources/using/tutorials.rst.txt
@@ -0,0 +1,24 @@
+*************************
+CUDA-Q Tutorials
+*************************
+
+Tutorials that give an in depth view of CUDA-Q and its applications in Python.
+
+.. nbgallery::
+
+    /examples/python/tutorials/afqmc.ipynb
+    /examples/python/tutorials/deutschs_algorithm.ipynb
+    /examples/python/tutorials/quantum_fourier_transform.ipynb
+    /examples/python/tutorials/cost_minimization.ipynb
+    /examples/python/tutorials/vqe.ipynb
+    /examples/python/tutorials/qaoa.ipynb
+    /examples/python/tutorials/hadamard_test.ipynb
+    /examples/python/tutorials/hybrid_qnns.ipynb
+    /examples/python/tutorials/maximum_vertex_weight_clique.ipynb
+    /examples/python/tutorials/noisy_simulations.ipynb
+    /examples/python/tutorials/readout_error_mitigation.ipynb
+    /examples/python/tutorials/vqe_water_active_space.ipynb
+    /examples/python/tutorials/Divisive_clustering.ipynb
+    /examples/python/tutorials/H2-MRQKS.ipynb
+    /examples/python/tutorials/Shors.ipynb
+    /examples/python/tutorials/unitary_compilation.ipynb
diff --git a/pr-2241/_sources/versions.rst.txt b/pr-2241/_sources/versions.rst.txt
new file mode 100644
index 0000000000..9394f5a52e
--- /dev/null
+++ b/pr-2241/_sources/versions.rst.txt
@@ -0,0 +1,6 @@
+************************
+CUDA-Q Versions
+************************
+
+.. include:: releases.rst
+    :start-line: 4
diff --git a/pr-2241/_static/_sphinx_javascript_frameworks_compat.js b/pr-2241/_static/_sphinx_javascript_frameworks_compat.js
new file mode 100644
index 0000000000..8549469dc2
--- /dev/null
+++ b/pr-2241/_static/_sphinx_javascript_frameworks_compat.js
@@ -0,0 +1,134 @@
+/*
+ * _sphinx_javascript_frameworks_compat.js
+ * ~~~~~~~~~~
+ *
+ * Compatability shim for jQuery and underscores.js.
+ *
+ * WILL BE REMOVED IN Sphinx 6.0
+ * xref RemovedInSphinx60Warning
+ *
+ */
+
+/**
+ * select a different prefix for underscore
+ */
+$u = _.noConflict();
+
+
+/**
+ * small helper function to urldecode strings
+ *
+ * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL
+ */
+jQuery.urldecode = function(x) {
+    if (!x) {
+        return x
+    }
+    return decodeURIComponent(x.replace(/\+/g, ' '));
+};
+
+/**
+ * small helper function to urlencode strings
+ */
+jQuery.urlencode = encodeURIComponent;
+
+/**
+ * This function returns the parsed url parameters of the
+ * current request. Multiple values per key are supported,
+ * it will always return arrays of strings for the value parts.
+ */
+jQuery.getQueryParameters = function(s) {
+    if (typeof s === 'undefined')
+        s = document.location.search;
+    var parts = s.substr(s.indexOf('?') + 1).split('&');
+    var result = {};
+    for (var i = 0; i < parts.length; i++) {
+        var tmp = parts[i].split('=', 2);
+        var key = jQuery.urldecode(tmp[0]);
+        var value = jQuery.urldecode(tmp[1]);
+        if (key in result)
+            result[key].push(value);
+        else
+            result[key] = [value];
+    }
+    return result;
+};
+
+/**
+ * highlight a given string on a jquery object by wrapping it in
+ * span elements with the given class name.
+ */
+jQuery.fn.highlightText = function(text, className) {
+    function highlight(node, addItems) {
+        if (node.nodeType === 3) {
+            var val = node.nodeValue;
+            var pos = val.toLowerCase().indexOf(text);
+            if (pos >= 0 &&
+                !jQuery(node.parentNode).hasClass(className) &&
+                !jQuery(node.parentNode).hasClass("nohighlight")) {
+                var span;
+                var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg");
+                if (isInSVG) {
+                    span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
+                } else {
+                    span = document.createElement("span");
+                    span.className = className;
+                }
+                span.appendChild(document.createTextNode(val.substr(pos, text.length)));
+                node.parentNode.insertBefore(span, node.parentNode.insertBefore(
+                    document.createTextNode(val.substr(pos + text.length)),
+                    node.nextSibling));
+                node.nodeValue = val.substr(0, pos);
+                if (isInSVG) {
+                    var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect");
+                    var bbox = node.parentElement.getBBox();
+                    rect.x.baseVal.value = bbox.x;
+                    rect.y.baseVal.value = bbox.y;
+                    rect.width.baseVal.value = bbox.width;
+                    rect.height.baseVal.value = bbox.height;
+                    rect.setAttribute('class', className);
+                    addItems.push({
+                        "parent": node.parentNode,
+                        "target": rect});
+                }
+            }
+        }
+        else if (!jQuery(node).is("button, select, textarea")) {
+            jQuery.each(node.childNodes, function() {
+                highlight(this, addItems);
+            });
+        }
+    }
+    var addItems = [];
+    var result = this.each(function() {
+        highlight(this, addItems);
+    });
+    for (var i = 0; i < addItems.length; ++i) {
+        jQuery(addItems[i].parent).before(addItems[i].target);
+    }
+    return result;
+};
+
+/*
+ * backward compatibility for jQuery.browser
+ * This will be supported until firefox bug is fixed.
+ */
+if (!jQuery.browser) {
+    jQuery.uaMatch = function(ua) {
+        ua = ua.toLowerCase();
+
+        var match = /(chrome)[ \/]([\w.]+)/.exec(ua) ||
+            /(webkit)[ \/]([\w.]+)/.exec(ua) ||
+            /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) ||
+            /(msie) ([\w.]+)/.exec(ua) ||
+            ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) ||
+            [];
+
+        return {
+            browser: match[ 1 ] || "",
+            version: match[ 2 ] || "0"
+        };
+    };
+    jQuery.browser = {};
+    jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true;
+}
diff --git a/pr-2241/_static/attachToDevContainer.png b/pr-2241/_static/attachToDevContainer.png
new file mode 100644
index 0000000000..a841832ef8
Binary files /dev/null and b/pr-2241/_static/attachToDevContainer.png differ
diff --git a/pr-2241/_static/basic.css b/pr-2241/_static/basic.css
new file mode 100644
index 0000000000..4e9a9f1fac
--- /dev/null
+++ b/pr-2241/_static/basic.css
@@ -0,0 +1,900 @@
+/*
+ * basic.css
+ * ~~~~~~~~~
+ *
+ * Sphinx stylesheet -- basic theme.
+ *
+ * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/* -- main layout ----------------------------------------------------------- */
+
+div.clearer {
+    clear: both;
+}
+
+div.section::after {
+    display: block;
+    content: '';
+    clear: left;
+}
+
+/* -- relbar ---------------------------------------------------------------- */
+
+div.related {
+    width: 100%;
+    font-size: 90%;
+}
+
+div.related h3 {
+    display: none;
+}
+
+div.related ul {
+    margin: 0;
+    padding: 0 0 0 10px;
+    list-style: none;
+}
+
+div.related li {
+    display: inline;
+}
+
+div.related li.right {
+    float: right;
+    margin-right: 5px;
+}
+
+/* -- sidebar --------------------------------------------------------------- */
+
+div.sphinxsidebarwrapper {
+    padding: 10px 5px 0 10px;
+}
+
+div.sphinxsidebar {
+    float: left;
+    width: 230px;
+    margin-left: -100%;
+    font-size: 90%;
+    word-wrap: break-word;
+    overflow-wrap : break-word;
+}
+
+div.sphinxsidebar ul {
+    list-style: none;
+}
+
+div.sphinxsidebar ul ul,
+div.sphinxsidebar ul.want-points {
+    margin-left: 20px;
+    list-style: square;
+}
+
+div.sphinxsidebar ul ul {
+    margin-top: 0;
+    margin-bottom: 0;
+}
+
+div.sphinxsidebar form {
+    margin-top: 10px;
+}
+
+div.sphinxsidebar input {
+    border: 1px solid #98dbcc;
+    font-family: sans-serif;
+    font-size: 1em;
+}
+
+div.sphinxsidebar #searchbox form.search {
+    overflow: hidden;
+}
+
+div.sphinxsidebar #searchbox input[type="text"] {
+    float: left;
+    width: 80%;
+    padding: 0.25em;
+    box-sizing: border-box;
+}
+
+div.sphinxsidebar #searchbox input[type="submit"] {
+    float: left;
+    width: 20%;
+    border-left: none;
+    padding: 0.25em;
+    box-sizing: border-box;
+}
+
+
+img {
+    border: 0;
+    max-width: 100%;
+}
+
+/* -- search page ----------------------------------------------------------- */
+
+ul.search {
+    margin: 10px 0 0 20px;
+    padding: 0;
+}
+
+ul.search li {
+    padding: 5px 0 5px 20px;
+    background-image: url(file.png);
+    background-repeat: no-repeat;
+    background-position: 0 7px;
+}
+
+ul.search li a {
+    font-weight: bold;
+}
+
+ul.search li p.context {
+    color: #888;
+    margin: 2px 0 0 30px;
+    text-align: left;
+}
+
+ul.keywordmatches li.goodmatch a {
+    font-weight: bold;
+}
+
+/* -- index page ------------------------------------------------------------ */
+
+table.contentstable {
+    width: 90%;
+    margin-left: auto;
+    margin-right: auto;
+}
+
+table.contentstable p.biglink {
+    line-height: 150%;
+}
+
+a.biglink {
+    font-size: 1.3em;
+}
+
+span.linkdescr {
+    font-style: italic;
+    padding-top: 5px;
+    font-size: 90%;
+}
+
+/* -- general index --------------------------------------------------------- */
+
+table.indextable {
+    width: 100%;
+}
+
+table.indextable td {
+    text-align: left;
+    vertical-align: top;
+}
+
+table.indextable ul {
+    margin-top: 0;
+    margin-bottom: 0;
+    list-style-type: none;
+}
+
+table.indextable > tbody > tr > td > ul {
+    padding-left: 0em;
+}
+
+table.indextable tr.pcap {
+    height: 10px;
+}
+
+table.indextable tr.cap {
+    margin-top: 10px;
+    background-color: #f2f2f2;
+}
+
+img.toggler {
+    margin-right: 3px;
+    margin-top: 3px;
+    cursor: pointer;
+}
+
+div.modindex-jumpbox {
+    border-top: 1px solid #ddd;
+    border-bottom: 1px solid #ddd;
+    margin: 1em 0 1em 0;
+    padding: 0.4em;
+}
+
+div.genindex-jumpbox {
+    border-top: 1px solid #ddd;
+    border-bottom: 1px solid #ddd;
+    margin: 1em 0 1em 0;
+    padding: 0.4em;
+}
+
+/* -- domain module index --------------------------------------------------- */
+
+table.modindextable td {
+    padding: 2px;
+    border-collapse: collapse;
+}
+
+/* -- general body styles --------------------------------------------------- */
+
+div.body {
+    min-width: 360px;
+    max-width: 800px;
+}
+
+div.body p, div.body dd, div.body li, div.body blockquote {
+    -moz-hyphens: auto;
+    -ms-hyphens: auto;
+    -webkit-hyphens: auto;
+    hyphens: auto;
+}
+
+a.headerlink {
+    visibility: hidden;
+}
+
+h1:hover > a.headerlink,
+h2:hover > a.headerlink,
+h3:hover > a.headerlink,
+h4:hover > a.headerlink,
+h5:hover > a.headerlink,
+h6:hover > a.headerlink,
+dt:hover > a.headerlink,
+caption:hover > a.headerlink,
+p.caption:hover > a.headerlink,
+div.code-block-caption:hover > a.headerlink {
+    visibility: visible;
+}
+
+div.body p.caption {
+    text-align: inherit;
+}
+
+div.body td {
+    text-align: left;
+}
+
+.first {
+    margin-top: 0 !important;
+}
+
+p.rubric {
+    margin-top: 30px;
+    font-weight: bold;
+}
+
+img.align-left, figure.align-left, .figure.align-left, object.align-left {
+    clear: left;
+    float: left;
+    margin-right: 1em;
+}
+
+img.align-right, figure.align-right, .figure.align-right, object.align-right {
+    clear: right;
+    float: right;
+    margin-left: 1em;
+}
+
+img.align-center, figure.align-center, .figure.align-center, object.align-center {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+img.align-default, figure.align-default, .figure.align-default {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.align-left {
+    text-align: left;
+}
+
+.align-center {
+    text-align: center;
+}
+
+.align-default {
+    text-align: center;
+}
+
+.align-right {
+    text-align: right;
+}
+
+/* -- sidebars -------------------------------------------------------------- */
+
+div.sidebar,
+aside.sidebar {
+    margin: 0 0 0.5em 1em;
+    border: 1px solid #ddb;
+    padding: 7px;
+    background-color: #ffe;
+    width: 40%;
+    float: right;
+    clear: right;
+    overflow-x: auto;
+}
+
+p.sidebar-title {
+    font-weight: bold;
+}
+nav.contents,
+aside.topic,
+div.admonition, div.topic, blockquote {
+    clear: left;
+}
+
+/* -- topics ---------------------------------------------------------------- */
+nav.contents,
+aside.topic,
+div.topic {
+    border: 1px solid #ccc;
+    padding: 7px;
+    margin: 10px 0 10px 0;
+}
+
+p.topic-title {
+    font-size: 1.1em;
+    font-weight: bold;
+    margin-top: 10px;
+}
+
+/* -- admonitions ----------------------------------------------------------- */
+
+div.admonition {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    padding: 7px;
+}
+
+div.admonition dt {
+    font-weight: bold;
+}
+
+p.admonition-title {
+    margin: 0px 10px 5px 0px;
+    font-weight: bold;
+}
+
+div.body p.centered {
+    text-align: center;
+    margin-top: 25px;
+}
+
+/* -- content of sidebars/topics/admonitions -------------------------------- */
+
+div.sidebar > :last-child,
+aside.sidebar > :last-child,
+nav.contents > :last-child,
+aside.topic > :last-child,
+div.topic > :last-child,
+div.admonition > :last-child {
+    margin-bottom: 0;
+}
+
+div.sidebar::after,
+aside.sidebar::after,
+nav.contents::after,
+aside.topic::after,
+div.topic::after,
+div.admonition::after,
+blockquote::after {
+    display: block;
+    content: '';
+    clear: both;
+}
+
+/* -- tables ---------------------------------------------------------------- */
+
+table.docutils {
+    margin-top: 10px;
+    margin-bottom: 10px;
+    border: 0;
+    border-collapse: collapse;
+}
+
+table.align-center {
+    margin-left: auto;
+    margin-right: auto;
+}
+
+table.align-default {
+    margin-left: auto;
+    margin-right: auto;
+}
+
+table caption span.caption-number {
+    font-style: italic;
+}
+
+table caption span.caption-text {
+}
+
+table.docutils td, table.docutils th {
+    padding: 1px 8px 1px 5px;
+    border-top: 0;
+    border-left: 0;
+    border-right: 0;
+    border-bottom: 1px solid #aaa;
+}
+
+th {
+    text-align: left;
+    padding-right: 5px;
+}
+
+table.citation {
+    border-left: solid 1px gray;
+    margin-left: 1px;
+}
+
+table.citation td {
+    border-bottom: none;
+}
+
+th > :first-child,
+td > :first-child {
+    margin-top: 0px;
+}
+
+th > :last-child,
+td > :last-child {
+    margin-bottom: 0px;
+}
+
+/* -- figures --------------------------------------------------------------- */
+
+div.figure, figure {
+    margin: 0.5em;
+    padding: 0.5em;
+}
+
+div.figure p.caption, figcaption {
+    padding: 0.3em;
+}
+
+div.figure p.caption span.caption-number,
+figcaption span.caption-number {
+    font-style: italic;
+}
+
+div.figure p.caption span.caption-text,
+figcaption span.caption-text {
+}
+
+/* -- field list styles ----------------------------------------------------- */
+
+table.field-list td, table.field-list th {
+    border: 0 !important;
+}
+
+.field-list ul {
+    margin: 0;
+    padding-left: 1em;
+}
+
+.field-list p {
+    margin: 0;
+}
+
+.field-name {
+    -moz-hyphens: manual;
+    -ms-hyphens: manual;
+    -webkit-hyphens: manual;
+    hyphens: manual;
+}
+
+/* -- hlist styles ---------------------------------------------------------- */
+
+table.hlist {
+    margin: 1em 0;
+}
+
+table.hlist td {
+    vertical-align: top;
+}
+
+/* -- object description styles --------------------------------------------- */
+
+.sig {
+	font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
+}
+
+.sig-name, code.descname {
+    background-color: transparent;
+    font-weight: bold;
+}
+
+.sig-name {
+	font-size: 1.1em;
+}
+
+code.descname {
+    font-size: 1.2em;
+}
+
+.sig-prename, code.descclassname {
+    background-color: transparent;
+}
+
+.optional {
+    font-size: 1.3em;
+}
+
+.sig-paren {
+    font-size: larger;
+}
+
+.sig-param.n {
+	font-style: italic;
+}
+
+/* C++ specific styling */
+
+.sig-inline.c-texpr,
+.sig-inline.cpp-texpr {
+	font-family: unset;
+}
+
+.sig.c   .k, .sig.c   .kt,
+.sig.cpp .k, .sig.cpp .kt {
+	color: #0033B3;
+}
+
+.sig.c   .m,
+.sig.cpp .m {
+	color: #1750EB;
+}
+
+.sig.c   .s, .sig.c   .sc,
+.sig.cpp .s, .sig.cpp .sc {
+	color: #067D17;
+}
+
+
+/* -- other body styles ----------------------------------------------------- */
+
+ol.arabic {
+    list-style: decimal;
+}
+
+ol.loweralpha {
+    list-style: lower-alpha;
+}
+
+ol.upperalpha {
+    list-style: upper-alpha;
+}
+
+ol.lowerroman {
+    list-style: lower-roman;
+}
+
+ol.upperroman {
+    list-style: upper-roman;
+}
+
+:not(li) > ol > li:first-child > :first-child,
+:not(li) > ul > li:first-child > :first-child {
+    margin-top: 0px;
+}
+
+:not(li) > ol > li:last-child > :last-child,
+:not(li) > ul > li:last-child > :last-child {
+    margin-bottom: 0px;
+}
+
+ol.simple ol p,
+ol.simple ul p,
+ul.simple ol p,
+ul.simple ul p {
+    margin-top: 0;
+}
+
+ol.simple > li:not(:first-child) > p,
+ul.simple > li:not(:first-child) > p {
+    margin-top: 0;
+}
+
+ol.simple p,
+ul.simple p {
+    margin-bottom: 0;
+}
+aside.footnote > span,
+div.citation > span {
+    float: left;
+}
+aside.footnote > span:last-of-type,
+div.citation > span:last-of-type {
+  padding-right: 0.5em;
+}
+aside.footnote > p {
+  margin-left: 2em;
+}
+div.citation > p {
+  margin-left: 4em;
+}
+aside.footnote > p:last-of-type,
+div.citation > p:last-of-type {
+    margin-bottom: 0em;
+}
+aside.footnote > p:last-of-type:after,
+div.citation > p:last-of-type:after {
+    content: "";
+    clear: both;
+}
+
+dl.field-list {
+    display: grid;
+    grid-template-columns: fit-content(30%) auto;
+}
+
+dl.field-list > dt {
+    font-weight: bold;
+    word-break: break-word;
+    padding-left: 0.5em;
+    padding-right: 5px;
+}
+
+dl.field-list > dd {
+    padding-left: 0.5em;
+    margin-top: 0em;
+    margin-left: 0em;
+    margin-bottom: 0em;
+}
+
+dl {
+    margin-bottom: 15px;
+}
+
+dd > :first-child {
+    margin-top: 0px;
+}
+
+dd ul, dd table {
+    margin-bottom: 10px;
+}
+
+dd {
+    margin-top: 3px;
+    margin-bottom: 10px;
+    margin-left: 30px;
+}
+
+dl > dd:last-child,
+dl > dd:last-child > :last-child {
+    margin-bottom: 0;
+}
+
+dt:target, span.highlighted {
+    background-color: #fbe54e;
+}
+
+rect.highlighted {
+    fill: #fbe54e;
+}
+
+dl.glossary dt {
+    font-weight: bold;
+    font-size: 1.1em;
+}
+
+.versionmodified {
+    font-style: italic;
+}
+
+.system-message {
+    background-color: #fda;
+    padding: 5px;
+    border: 3px solid red;
+}
+
+.footnote:target  {
+    background-color: #ffa;
+}
+
+.line-block {
+    display: block;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.line-block .line-block {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 1.5em;
+}
+
+.guilabel, .menuselection {
+    font-family: sans-serif;
+}
+
+.accelerator {
+    text-decoration: underline;
+}
+
+.classifier {
+    font-style: oblique;
+}
+
+.classifier:before {
+    font-style: normal;
+    margin: 0 0.5em;
+    content: ":";
+    display: inline-block;
+}
+
+abbr, acronym {
+    border-bottom: dotted 1px;
+    cursor: help;
+}
+
+/* -- code displays --------------------------------------------------------- */
+
+pre {
+    overflow: auto;
+    overflow-y: hidden;  /* fixes display issues on Chrome browsers */
+}
+
+pre, div[class*="highlight-"] {
+    clear: both;
+}
+
+span.pre {
+    -moz-hyphens: none;
+    -ms-hyphens: none;
+    -webkit-hyphens: none;
+    hyphens: none;
+    white-space: nowrap;
+}
+
+div[class*="highlight-"] {
+    margin: 1em 0;
+}
+
+td.linenos pre {
+    border: 0;
+    background-color: transparent;
+    color: #aaa;
+}
+
+table.highlighttable {
+    display: block;
+}
+
+table.highlighttable tbody {
+    display: block;
+}
+
+table.highlighttable tr {
+    display: flex;
+}
+
+table.highlighttable td {
+    margin: 0;
+    padding: 0;
+}
+
+table.highlighttable td.linenos {
+    padding-right: 0.5em;
+}
+
+table.highlighttable td.code {
+    flex: 1;
+    overflow: hidden;
+}
+
+.highlight .hll {
+    display: block;
+}
+
+div.highlight pre,
+table.highlighttable pre {
+    margin: 0;
+}
+
+div.code-block-caption + div {
+    margin-top: 0;
+}
+
+div.code-block-caption {
+    margin-top: 1em;
+    padding: 2px 5px;
+    font-size: small;
+}
+
+div.code-block-caption code {
+    background-color: transparent;
+}
+
+table.highlighttable td.linenos,
+span.linenos,
+div.highlight span.gp {  /* gp: Generic.Prompt */
+  user-select: none;
+  -webkit-user-select: text; /* Safari fallback only */
+  -webkit-user-select: none; /* Chrome/Safari */
+  -moz-user-select: none; /* Firefox */
+  -ms-user-select: none; /* IE10+ */
+}
+
+div.code-block-caption span.caption-number {
+    padding: 0.1em 0.3em;
+    font-style: italic;
+}
+
+div.code-block-caption span.caption-text {
+}
+
+div.literal-block-wrapper {
+    margin: 1em 0;
+}
+
+code.xref, a code {
+    background-color: transparent;
+    font-weight: bold;
+}
+
+h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
+    background-color: transparent;
+}
+
+.viewcode-link {
+    float: right;
+}
+
+.viewcode-back {
+    float: right;
+    font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+    margin: -1px -10px;
+    padding: 0 10px;
+}
+
+/* -- math display ---------------------------------------------------------- */
+
+img.math {
+    vertical-align: middle;
+}
+
+div.body div.math p {
+    text-align: center;
+}
+
+span.eqno {
+    float: right;
+}
+
+span.eqno a.headerlink {
+    position: absolute;
+    z-index: 1;
+}
+
+div.math:hover a.headerlink {
+    visibility: visible;
+}
+
+/* -- printout stylesheet --------------------------------------------------- */
+
+@media print {
+    div.document,
+    div.documentwrapper,
+    div.bodywrapper {
+        margin: 0 !important;
+        width: 100%;
+    }
+
+    div.sphinxsidebar,
+    div.related,
+    div.footer,
+    #top-link {
+        display: none;
+    }
+}
\ No newline at end of file
diff --git a/pr-2241/_static/binder_badge_logo.svg b/pr-2241/_static/binder_badge_logo.svg
new file mode 100644
index 0000000000..327f6b639a
--- /dev/null
+++ b/pr-2241/_static/binder_badge_logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="109" height="20"><linearGradient id="b" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="a"><rect width="109" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#a)"><path fill="#555" d="M0 0h64v20H0z"/><path fill="#579aca" d="M64 0h45v20H64z"/><path fill="url(#b)" d="M0 0h109v20H0z"/></g><g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="110"><image x="5" y="3" width="14" height="14" xlink:href="data:image/png;base64,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"/> <text x="415" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="370">launch</text><text x="415" y="140" transform="scale(.1)" textLength="370">launch</text><text x="855" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="350">binder</text><text x="855" y="140" transform="scale(.1)" textLength="350">binder</text></g> </svg>
\ No newline at end of file
diff --git a/pr-2241/_static/broken_example.png b/pr-2241/_static/broken_example.png
new file mode 100644
index 0000000000..4fea24e7df
Binary files /dev/null and b/pr-2241/_static/broken_example.png differ
diff --git a/pr-2241/_static/check-solid.svg b/pr-2241/_static/check-solid.svg
new file mode 100644
index 0000000000..92fad4b5c0
--- /dev/null
+++ b/pr-2241/_static/check-solid.svg
@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-check" width="44" height="44" viewBox="0 0 24 24" stroke-width="2" stroke="#22863a" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <path d="M5 12l5 5l10 -10" />
+</svg>
diff --git a/pr-2241/_static/clipboard.min.js b/pr-2241/_static/clipboard.min.js
new file mode 100644
index 0000000000..54b3c46381
--- /dev/null
+++ b/pr-2241/_static/clipboard.min.js
@@ -0,0 +1,7 @@
+/*!
+ * clipboard.js v2.0.8
+ * https://clipboardjs.com/
+ *
+ * Licensed MIT © Zeno Rocha
+ */
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.ClipboardJS=e():t.ClipboardJS=e()}(this,function(){return n={686:function(t,e,n){"use strict";n.d(e,{default:function(){return o}});var e=n(279),i=n.n(e),e=n(370),u=n.n(e),e=n(817),c=n.n(e);function a(t){try{return document.execCommand(t)}catch(t){return}}var f=function(t){t=c()(t);return a("cut"),t};var l=function(t){var e,n,o,r=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{container:document.body},i="";return"string"==typeof t?(e=t,n="rtl"===document.documentElement.getAttribute("dir"),(o=document.createElement("textarea")).style.fontSize="12pt",o.style.border="0",o.style.padding="0",o.style.margin="0",o.style.position="absolute",o.style[n?"right":"left"]="-9999px",n=window.pageYOffset||document.documentElement.scrollTop,o.style.top="".concat(n,"px"),o.setAttribute("readonly",""),o.value=e,o=o,r.container.appendChild(o),i=c()(o),a("copy"),o.remove()):(i=c()(t),a("copy")),i};function r(t){return(r="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}var s=function(){var t=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{},e=t.action,n=void 0===e?"copy":e,o=t.container,e=t.target,t=t.text;if("copy"!==n&&"cut"!==n)throw new Error('Invalid "action" value, use either "copy" or "cut"');if(void 0!==e){if(!e||"object"!==r(e)||1!==e.nodeType)throw new Error('Invalid "target" value, use a valid Element');if("copy"===n&&e.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if("cut"===n&&(e.hasAttribute("readonly")||e.hasAttribute("disabled")))throw new Error('Invalid "target" attribute. You can\'t cut text from elements with "readonly" or "disabled" attributes')}return t?l(t,{container:o}):e?"cut"===n?f(e):l(e,{container:o}):void 0};function d(t){return(d="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}function p(t,e){for(var n=0;n<e.length;n++){var o=e[n];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(t,o.key,o)}}function y(t,e){return(y=Object.setPrototypeOf||function(t,e){return t.__proto__=e,t})(t,e)}function h(n){var o=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(t){return!1}}();return function(){var t,e=m(n);return t=o?(t=m(this).constructor,Reflect.construct(e,arguments,t)):e.apply(this,arguments),e=this,!(t=t)||"object"!==d(t)&&"function"!=typeof t?function(t){if(void 0!==t)return t;throw new ReferenceError("this hasn't been initialised - super() hasn't been called")}(e):t}}function m(t){return(m=Object.setPrototypeOf?Object.getPrototypeOf:function(t){return t.__proto__||Object.getPrototypeOf(t)})(t)}function v(t,e){t="data-clipboard-".concat(t);if(e.hasAttribute(t))return e.getAttribute(t)}var o=function(){!function(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Super expression must either be null or a function");t.prototype=Object.create(e&&e.prototype,{constructor:{value:t,writable:!0,configurable:!0}}),e&&y(t,e)}(r,i());var t,e,n,o=h(r);function r(t,e){var n;return function(t){if(!(t instanceof r))throw new TypeError("Cannot call a class as a function")}(this),(n=o.call(this)).resolveOptions(e),n.listenClick(t),n}return t=r,n=[{key:"copy",value:function(t){var e=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{container:document.body};return l(t,e)}},{key:"cut",value:function(t){return f(t)}},{key:"isSupported",value:function(){var t=0<arguments.length&&void 0!==arguments[0]?arguments[0]:["copy","cut"],t="string"==typeof t?[t]:t,e=!!document.queryCommandSupported;return t.forEach(function(t){e=e&&!!document.queryCommandSupported(t)}),e}}],(e=[{key:"resolveOptions",value:function(){var t=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{};this.action="function"==typeof t.action?t.action:this.defaultAction,this.target="function"==typeof t.target?t.target:this.defaultTarget,this.text="function"==typeof t.text?t.text:this.defaultText,this.container="object"===d(t.container)?t.container:document.body}},{key:"listenClick",value:function(t){var e=this;this.listener=u()(t,"click",function(t){return e.onClick(t)})}},{key:"onClick",value:function(t){var e=t.delegateTarget||t.currentTarget,t=s({action:this.action(e),container:this.container,target:this.target(e),text:this.text(e)});this.emit(t?"success":"error",{action:this.action,text:t,trigger:e,clearSelection:function(){e&&e.focus(),document.activeElement.blur(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(t){return v("action",t)}},{key:"defaultTarget",value:function(t){t=v("target",t);if(t)return document.querySelector(t)}},{key:"defaultText",value:function(t){return v("text",t)}},{key:"destroy",value:function(){this.listener.destroy()}}])&&p(t.prototype,e),n&&p(t,n),r}()},828:function(t){var e;"undefined"==typeof Element||Element.prototype.matches||((e=Element.prototype).matches=e.matchesSelector||e.mozMatchesSelector||e.msMatchesSelector||e.oMatchesSelector||e.webkitMatchesSelector),t.exports=function(t,e){for(;t&&9!==t.nodeType;){if("function"==typeof t.matches&&t.matches(e))return t;t=t.parentNode}}},438:function(t,e,n){var u=n(828);function i(t,e,n,o,r){var i=function(e,n,t,o){return function(t){t.delegateTarget=u(t.target,n),t.delegateTarget&&o.call(e,t)}}.apply(this,arguments);return t.addEventListener(n,i,r),{destroy:function(){t.removeEventListener(n,i,r)}}}t.exports=function(t,e,n,o,r){return"function"==typeof t.addEventListener?i.apply(null,arguments):"function"==typeof n?i.bind(null,document).apply(null,arguments):("string"==typeof t&&(t=document.querySelectorAll(t)),Array.prototype.map.call(t,function(t){return i(t,e,n,o,r)}))}},879:function(t,n){n.node=function(t){return void 0!==t&&t instanceof HTMLElement&&1===t.nodeType},n.nodeList=function(t){var e=Object.prototype.toString.call(t);return void 0!==t&&("[object NodeList]"===e||"[object HTMLCollection]"===e)&&"length"in t&&(0===t.length||n.node(t[0]))},n.string=function(t){return"string"==typeof t||t instanceof String},n.fn=function(t){return"[object Function]"===Object.prototype.toString.call(t)}},370:function(t,e,n){var f=n(879),l=n(438);t.exports=function(t,e,n){if(!t&&!e&&!n)throw new Error("Missing required arguments");if(!f.string(e))throw new TypeError("Second argument must be a String");if(!f.fn(n))throw new TypeError("Third argument must be a Function");if(f.node(t))return c=e,a=n,(u=t).addEventListener(c,a),{destroy:function(){u.removeEventListener(c,a)}};if(f.nodeList(t))return o=t,r=e,i=n,Array.prototype.forEach.call(o,function(t){t.addEventListener(r,i)}),{destroy:function(){Array.prototype.forEach.call(o,function(t){t.removeEventListener(r,i)})}};if(f.string(t))return t=t,e=e,n=n,l(document.body,t,e,n);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList");var o,r,i,u,c,a}},817:function(t){t.exports=function(t){var e,n="SELECT"===t.nodeName?(t.focus(),t.value):"INPUT"===t.nodeName||"TEXTAREA"===t.nodeName?((e=t.hasAttribute("readonly"))||t.setAttribute("readonly",""),t.select(),t.setSelectionRange(0,t.value.length),e||t.removeAttribute("readonly"),t.value):(t.hasAttribute("contenteditable")&&t.focus(),n=window.getSelection(),(e=document.createRange()).selectNodeContents(t),n.removeAllRanges(),n.addRange(e),n.toString());return n}},279:function(t){function e(){}e.prototype={on:function(t,e,n){var o=this.e||(this.e={});return(o[t]||(o[t]=[])).push({fn:e,ctx:n}),this},once:function(t,e,n){var o=this;function r(){o.off(t,r),e.apply(n,arguments)}return r._=e,this.on(t,r,n)},emit:function(t){for(var e=[].slice.call(arguments,1),n=((this.e||(this.e={}))[t]||[]).slice(),o=0,r=n.length;o<r;o++)n[o].fn.apply(n[o].ctx,e);return this},off:function(t,e){var n=this.e||(this.e={}),o=n[t],r=[];if(o&&e)for(var i=0,u=o.length;i<u;i++)o[i].fn!==e&&o[i].fn._!==e&&r.push(o[i]);return r.length?n[t]=r:delete n[t],this}},t.exports=e,t.exports.TinyEmitter=e}},r={},o.n=function(t){var e=t&&t.__esModule?function(){return t.default}:function(){return t};return o.d(e,{a:e}),e},o.d=function(t,e){for(var n in e)o.o(e,n)&&!o.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:e[n]})},o.o=function(t,e){return Object.prototype.hasOwnProperty.call(t,e)},o(686).default;function o(t){if(r[t])return r[t].exports;var e=r[t]={exports:{}};return n[t](e,e.exports,o),e.exports}var n,r});
\ No newline at end of file
diff --git a/pr-2241/_static/copy-button.svg b/pr-2241/_static/copy-button.svg
new file mode 100644
index 0000000000..9c074dae52
--- /dev/null
+++ b/pr-2241/_static/copy-button.svg
@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-copy" width="44" height="44" viewBox="0 0 24 24" stroke-width="1.5" stroke="#000000" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <rect x="8" y="8" width="12" height="12" rx="2" />
+  <path d="M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2" />
+</svg>
diff --git a/pr-2241/_static/copybutton.css b/pr-2241/_static/copybutton.css
new file mode 100644
index 0000000000..f1916ec7d1
--- /dev/null
+++ b/pr-2241/_static/copybutton.css
@@ -0,0 +1,94 @@
+/* Copy buttons */
+button.copybtn {
+    position: absolute;
+    display: flex;
+    top: .3em;
+    right: .3em;
+    width: 1.7em;
+    height: 1.7em;
+	opacity: 0;
+    transition: opacity 0.3s, border .3s, background-color .3s;
+    user-select: none;
+    padding: 0;
+    border: none;
+    outline: none;
+    border-radius: 0.4em;
+    /* The colors that GitHub uses */
+    border: #1b1f2426 1px solid;
+    background-color: #f6f8fa;
+    color: #57606a;
+}
+
+button.copybtn.success {
+    border-color: #22863a;
+    color: #22863a;
+}
+
+button.copybtn svg {
+    stroke: currentColor;
+    width: 1.5em;
+    height: 1.5em;
+    padding: 0.1em;
+}
+
+div.highlight  {
+    position: relative;
+}
+
+/* Show the copybutton */
+.highlight:hover button.copybtn, button.copybtn.success {
+	opacity: 1;
+}
+
+.highlight button.copybtn:hover {
+    background-color: rgb(235, 235, 235);
+}
+
+.highlight button.copybtn:active {
+    background-color: rgb(187, 187, 187);
+}
+
+/**
+ * A minimal CSS-only tooltip copied from:
+ *   https://codepen.io/mildrenben/pen/rVBrpK
+ *
+ * To use, write HTML like the following:
+ *
+ * <p class="o-tooltip--left" data-tooltip="Hey">Short</p>
+ */
+ .o-tooltip--left {
+  position: relative;
+ }
+
+ .o-tooltip--left:after {
+    opacity: 0;
+    visibility: hidden;
+    position: absolute;
+    content: attr(data-tooltip);
+    padding: .2em;
+    font-size: .8em;
+    left: -.2em;
+    background: grey;
+    color: white;
+    white-space: nowrap;
+    z-index: 2;
+    border-radius: 2px;
+    transform: translateX(-102%) translateY(0);
+    transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1);
+}
+
+.o-tooltip--left:hover:after {
+    display: block;
+    opacity: 1;
+    visibility: visible;
+    transform: translateX(-100%) translateY(0);
+    transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1);
+    transition-delay: .5s;
+}
+
+/* By default the copy button shouldn't show up when printing a page */
+@media print {
+    button.copybtn {
+        display: none;
+    }
+}
diff --git a/pr-2241/_static/copybutton.js b/pr-2241/_static/copybutton.js
new file mode 100644
index 0000000000..1631e1138b
--- /dev/null
+++ b/pr-2241/_static/copybutton.js
@@ -0,0 +1,248 @@
+// Localization support
+const messages = {
+  'en': {
+    'copy': 'Copy',
+    'copy_to_clipboard': 'Copy to clipboard',
+    'copy_success': 'Copied!',
+    'copy_failure': 'Failed to copy',
+  },
+  'es' : {
+    'copy': 'Copiar',
+    'copy_to_clipboard': 'Copiar al portapapeles',
+    'copy_success': '¡Copiado!',
+    'copy_failure': 'Error al copiar',
+  },
+  'de' : {
+    'copy': 'Kopieren',
+    'copy_to_clipboard': 'In die Zwischenablage kopieren',
+    'copy_success': 'Kopiert!',
+    'copy_failure': 'Fehler beim Kopieren',
+  },
+  'fr' : {
+    'copy': 'Copier',
+    'copy_to_clipboard': 'Copier dans le presse-papier',
+    'copy_success': 'Copié !',
+    'copy_failure': 'Échec de la copie',
+  },
+  'ru': {
+    'copy': 'Скопировать',
+    'copy_to_clipboard': 'Скопировать в буфер',
+    'copy_success': 'Скопировано!',
+    'copy_failure': 'Не удалось скопировать',
+  },
+  'zh-CN': {
+    'copy': '复制',
+    'copy_to_clipboard': '复制到剪贴板',
+    'copy_success': '复制成功!',
+    'copy_failure': '复制失败',
+  },
+  'it' : {
+    'copy': 'Copiare',
+    'copy_to_clipboard': 'Copiato negli appunti',
+    'copy_success': 'Copiato!',
+    'copy_failure': 'Errore durante la copia',
+  }
+}
+
+let locale = 'en'
+if( document.documentElement.lang !== undefined
+    && messages[document.documentElement.lang] !== undefined ) {
+  locale = document.documentElement.lang
+}
+
+let doc_url_root = DOCUMENTATION_OPTIONS.URL_ROOT;
+if (doc_url_root == '#') {
+    doc_url_root = '';
+}
+
+/**
+ * SVG files for our copy buttons
+ */
+let iconCheck = `<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-check" width="44" height="44" viewBox="0 0 24 24" stroke-width="2" stroke="#22863a" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <title>${messages[locale]['copy_success']}</title>
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <path d="M5 12l5 5l10 -10" />
+</svg>`
+
+// If the user specified their own SVG use that, otherwise use the default
+let iconCopy = ``;
+if (!iconCopy) {
+  iconCopy = `<svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-copy" width="44" height="44" viewBox="0 0 24 24" stroke-width="1.5" stroke="#000000" fill="none" stroke-linecap="round" stroke-linejoin="round">
+  <title>${messages[locale]['copy_to_clipboard']}</title>
+  <path stroke="none" d="M0 0h24v24H0z" fill="none"/>
+  <rect x="8" y="8" width="12" height="12" rx="2" />
+  <path d="M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2" />
+</svg>`
+}
+
+/**
+ * Set up copy/paste for code blocks
+ */
+
+const runWhenDOMLoaded = cb => {
+  if (document.readyState != 'loading') {
+    cb()
+  } else if (document.addEventListener) {
+    document.addEventListener('DOMContentLoaded', cb)
+  } else {
+    document.attachEvent('onreadystatechange', function() {
+      if (document.readyState == 'complete') cb()
+    })
+  }
+}
+
+const codeCellId = index => `codecell${index}`
+
+// Clears selected text since ClipboardJS will select the text when copying
+const clearSelection = () => {
+  if (window.getSelection) {
+    window.getSelection().removeAllRanges()
+  } else if (document.selection) {
+    document.selection.empty()
+  }
+}
+
+// Changes tooltip text for a moment, then changes it back
+// We want the timeout of our `success` class to be a bit shorter than the
+// tooltip and icon change, so that we can hide the icon before changing back.
+var timeoutIcon = 2000;
+var timeoutSuccessClass = 1500;
+
+const temporarilyChangeTooltip = (el, oldText, newText) => {
+  el.setAttribute('data-tooltip', newText)
+  el.classList.add('success')
+  // Remove success a little bit sooner than we change the tooltip
+  // So that we can use CSS to hide the copybutton first
+  setTimeout(() => el.classList.remove('success'), timeoutSuccessClass)
+  setTimeout(() => el.setAttribute('data-tooltip', oldText), timeoutIcon)
+}
+
+// Changes the copy button icon for two seconds, then changes it back
+const temporarilyChangeIcon = (el) => {
+  el.innerHTML = iconCheck;
+  setTimeout(() => {el.innerHTML = iconCopy}, timeoutIcon)
+}
+
+const addCopyButtonToCodeCells = () => {
+  // If ClipboardJS hasn't loaded, wait a bit and try again. This
+  // happens because we load ClipboardJS asynchronously.
+  if (window.ClipboardJS === undefined) {
+    setTimeout(addCopyButtonToCodeCells, 250)
+    return
+  }
+
+  // Add copybuttons to all of our code cells
+  const COPYBUTTON_SELECTOR = 'div.highlight pre';
+  const codeCells = document.querySelectorAll(COPYBUTTON_SELECTOR)
+  codeCells.forEach((codeCell, index) => {
+    const id = codeCellId(index)
+    codeCell.setAttribute('id', id)
+
+    const clipboardButton = id =>
+    `<button class="copybtn o-tooltip--left" data-tooltip="${messages[locale]['copy']}" data-clipboard-target="#${id}">
+      ${iconCopy}
+    </button>`
+    codeCell.insertAdjacentHTML('afterend', clipboardButton(id))
+  })
+
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
+}
+
+/**
+ * Removes excluded text from a Node.
+ *
+ * @param {Node} target Node to filter.
+ * @param {string} exclude CSS selector of nodes to exclude.
+ * @returns {DOMString} Text from `target` with text removed.
+ */
+function filterText(target, exclude) {
+    const clone = target.cloneNode(true);  // clone as to not modify the live DOM
+    if (exclude) {
+        // remove excluded nodes
+        clone.querySelectorAll(exclude).forEach(node => node.remove());
+    }
+    return clone.innerText;
+}
+
+// Callback when a copy button is clicked. Will be passed the node that was clicked
+// should then grab the text and replace pieces of text that shouldn't be used in output
+function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") {
+    var regexp;
+    var match;
+
+    // Do we check for line continuation characters and "HERE-documents"?
+    var useLineCont = !!lineContinuationChar
+    var useHereDoc = !!hereDocDelim
+
+    // create regexp to capture prompt and remaining line
+    if (isRegexp) {
+        regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)')
+    } else {
+        regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)')
+    }
+
+    const outputLines = [];
+    var promptFound = false;
+    var gotLineCont = false;
+    var gotHereDoc = false;
+    const lineGotPrompt = [];
+    for (const line of textContent.split('\n')) {
+        match = line.match(regexp)
+        if (match || gotLineCont || gotHereDoc) {
+            promptFound = regexp.test(line)
+            lineGotPrompt.push(promptFound)
+            if (removePrompts && promptFound) {
+                outputLines.push(match[2])
+            } else {
+                outputLines.push(line)
+            }
+            gotLineCont = line.endsWith(lineContinuationChar) & useLineCont
+            if (line.includes(hereDocDelim) & useHereDoc)
+                gotHereDoc = !gotHereDoc
+        } else if (!onlyCopyPromptLines) {
+            outputLines.push(line)
+        } else if (copyEmptyLines && line.trim() === '') {
+            outputLines.push(line)
+        }
+    }
+
+    // If no lines with the prompt were found then just use original lines
+    if (lineGotPrompt.some(v => v === true)) {
+        textContent = outputLines.join('\n');
+    }
+
+    // Remove a trailing newline to avoid auto-running when pasting
+    if (textContent.endsWith("\n")) {
+        textContent = textContent.slice(0, -1)
+    }
+    return textContent
+}
+
+
+var copyTargetText = (trigger) => {
+  var target = document.querySelector(trigger.attributes['data-clipboard-target'].value);
+
+  // get filtered text
+  let exclude = '.linenos';
+
+  let text = filterText(target, exclude);
+  return formatCopyText(text, '', false, true, true, false, '', '')
+}
+
+  // Initialize with a callback so we can modify the text before copy
+  const clipboard = new ClipboardJS('.copybtn', {text: copyTargetText})
+
+  // Update UI with error/success messages
+  clipboard.on('success', event => {
+    clearSelection()
+    temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_success'])
+    temporarilyChangeIcon(event.trigger)
+  })
+
+  clipboard.on('error', event => {
+    temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_failure'])
+  })
+}
+
+runWhenDOMLoaded(addCopyButtonToCodeCells)
\ No newline at end of file
diff --git a/pr-2241/_static/copybutton_funcs.js b/pr-2241/_static/copybutton_funcs.js
new file mode 100644
index 0000000000..dbe1aaad79
--- /dev/null
+++ b/pr-2241/_static/copybutton_funcs.js
@@ -0,0 +1,73 @@
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
+}
+
+/**
+ * Removes excluded text from a Node.
+ *
+ * @param {Node} target Node to filter.
+ * @param {string} exclude CSS selector of nodes to exclude.
+ * @returns {DOMString} Text from `target` with text removed.
+ */
+export function filterText(target, exclude) {
+    const clone = target.cloneNode(true);  // clone as to not modify the live DOM
+    if (exclude) {
+        // remove excluded nodes
+        clone.querySelectorAll(exclude).forEach(node => node.remove());
+    }
+    return clone.innerText;
+}
+
+// Callback when a copy button is clicked. Will be passed the node that was clicked
+// should then grab the text and replace pieces of text that shouldn't be used in output
+export function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") {
+    var regexp;
+    var match;
+
+    // Do we check for line continuation characters and "HERE-documents"?
+    var useLineCont = !!lineContinuationChar
+    var useHereDoc = !!hereDocDelim
+
+    // create regexp to capture prompt and remaining line
+    if (isRegexp) {
+        regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)')
+    } else {
+        regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)')
+    }
+
+    const outputLines = [];
+    var promptFound = false;
+    var gotLineCont = false;
+    var gotHereDoc = false;
+    const lineGotPrompt = [];
+    for (const line of textContent.split('\n')) {
+        match = line.match(regexp)
+        if (match || gotLineCont || gotHereDoc) {
+            promptFound = regexp.test(line)
+            lineGotPrompt.push(promptFound)
+            if (removePrompts && promptFound) {
+                outputLines.push(match[2])
+            } else {
+                outputLines.push(line)
+            }
+            gotLineCont = line.endsWith(lineContinuationChar) & useLineCont
+            if (line.includes(hereDocDelim) & useHereDoc)
+                gotHereDoc = !gotHereDoc
+        } else if (!onlyCopyPromptLines) {
+            outputLines.push(line)
+        } else if (copyEmptyLines && line.trim() === '') {
+            outputLines.push(line)
+        }
+    }
+
+    // If no lines with the prompt were found then just use original lines
+    if (lineGotPrompt.some(v => v === true)) {
+        textContent = outputLines.join('\n');
+    }
+
+    // Remove a trailing newline to avoid auto-running when pasting
+    if (textContent.endsWith("\n")) {
+        textContent = textContent.slice(0, -1)
+    }
+    return textContent
+}
diff --git a/pr-2241/_static/css/badge_only.css b/pr-2241/_static/css/badge_only.css
new file mode 100644
index 0000000000..c718cee441
--- /dev/null
+++ b/pr-2241/_static/css/badge_only.css
@@ -0,0 +1 @@
+.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}
\ No newline at end of file
diff --git a/pr-2241/_static/css/fonts/Roboto-Slab-Bold.woff b/pr-2241/_static/css/fonts/Roboto-Slab-Bold.woff
new file mode 100644
index 0000000000..6cb6000018
Binary files /dev/null and b/pr-2241/_static/css/fonts/Roboto-Slab-Bold.woff differ
diff --git a/pr-2241/_static/css/fonts/Roboto-Slab-Bold.woff2 b/pr-2241/_static/css/fonts/Roboto-Slab-Bold.woff2
new file mode 100644
index 0000000000..7059e23142
Binary files /dev/null and b/pr-2241/_static/css/fonts/Roboto-Slab-Bold.woff2 differ
diff --git a/pr-2241/_static/css/fonts/Roboto-Slab-Regular.woff b/pr-2241/_static/css/fonts/Roboto-Slab-Regular.woff
new file mode 100644
index 0000000000..f815f63f99
Binary files /dev/null and b/pr-2241/_static/css/fonts/Roboto-Slab-Regular.woff differ
diff --git a/pr-2241/_static/css/fonts/Roboto-Slab-Regular.woff2 b/pr-2241/_static/css/fonts/Roboto-Slab-Regular.woff2
new file mode 100644
index 0000000000..f2c76e5bda
Binary files /dev/null and b/pr-2241/_static/css/fonts/Roboto-Slab-Regular.woff2 differ
diff --git a/pr-2241/_static/css/fonts/fontawesome-webfont.eot b/pr-2241/_static/css/fonts/fontawesome-webfont.eot
new file mode 100644
index 0000000000..e9f60ca953
Binary files /dev/null and b/pr-2241/_static/css/fonts/fontawesome-webfont.eot differ
diff --git a/pr-2241/_static/css/fonts/fontawesome-webfont.svg b/pr-2241/_static/css/fonts/fontawesome-webfont.svg
new file mode 100644
index 0000000000..855c845e53
--- /dev/null
+++ b/pr-2241/_static/css/fonts/fontawesome-webfont.svg
@@ -0,0 +1,2671 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg>
+<metadata>
+Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016
+ By ,,,
+Copyright Dave Gandy 2016. All rights reserved.
+</metadata>
+<defs>
+<font id="FontAwesome" horiz-adv-x="1536" >
+  <font-face 
+    font-family="FontAwesome"
+    font-weight="400"
+    font-stretch="normal"
+    units-per-em="1792"
+    panose-1="0 0 0 0 0 0 0 0 0 0"
+    ascent="1536"
+    descent="-256"
+    bbox="-1.02083 -256.962 2304.6 1537.02"
+    underline-thickness="0"
+    underline-position="0"
+    unicode-range="U+0020-F500"
+  />
+<missing-glyph horiz-adv-x="896" 
+d="M224 112h448v1312h-448v-1312zM112 0v1536h672v-1536h-672z" />
+    <glyph glyph-name=".notdef" horiz-adv-x="896" 
+d="M224 112h448v1312h-448v-1312zM112 0v1536h672v-1536h-672z" />
+    <glyph glyph-name=".null" horiz-adv-x="0" 
+ />
+    <glyph glyph-name="nonmarkingreturn" horiz-adv-x="597" 
+ />
+    <glyph glyph-name="space" unicode=" " horiz-adv-x="448" 
+ />
+    <glyph glyph-name="dieresis" unicode="&#xa8;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="copyright" unicode="&#xa9;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="registered" unicode="&#xae;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="acute" unicode="&#xb4;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="AE" unicode="&#xc6;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="Oslash" unicode="&#xd8;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="trademark" unicode="&#x2122;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="infinity" unicode="&#x221e;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="notequal" unicode="&#x2260;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="glass" unicode="&#xf000;" horiz-adv-x="1792" 
+d="M1699 1350q0 -35 -43 -78l-632 -632v-768h320q26 0 45 -19t19 -45t-19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45t45 19h320v768l-632 632q-43 43 -43 78q0 23 18 36.5t38 17.5t43 4h1408q23 0 43 -4t38 -17.5t18 -36.5z" />
+    <glyph glyph-name="music" unicode="&#xf001;" 
+d="M1536 1312v-1120q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v537l-768 -237v-709q0 -50 -34 -89t-86 -60.5t-103.5 -32t-96.5 -10.5t-96.5 10.5t-103.5 32t-86 60.5t-34 89
+t34 89t86 60.5t103.5 32t96.5 10.5q105 0 192 -39v967q0 31 19 56.5t49 35.5l832 256q12 4 28 4q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="search" unicode="&#xf002;" horiz-adv-x="1664" 
+d="M1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -52 -38 -90t-90 -38q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5
+t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
+    <glyph glyph-name="envelope" unicode="&#xf003;" horiz-adv-x="1792" 
+d="M1664 32v768q-32 -36 -69 -66q-268 -206 -426 -338q-51 -43 -83 -67t-86.5 -48.5t-102.5 -24.5h-1h-1q-48 0 -102.5 24.5t-86.5 48.5t-83 67q-158 132 -426 338q-37 30 -69 66v-768q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1664 1083v11v13.5t-0.5 13
+t-3 12.5t-5.5 9t-9 7.5t-14 2.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5q0 -168 147 -284q193 -152 401 -317q6 -5 35 -29.5t46 -37.5t44.5 -31.5t50.5 -27.5t43 -9h1h1q20 0 43 9t50.5 27.5t44.5 31.5t46 37.5t35 29.5q208 165 401 317q54 43 100.5 115.5t46.5 131.5z
+M1792 1120v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="heart" unicode="&#xf004;" horiz-adv-x="1792" 
+d="M896 -128q-26 0 -44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124t127 -344q0 -221 -229 -450l-623 -600
+q-18 -18 -44 -18z" />
+    <glyph glyph-name="star" unicode="&#xf005;" horiz-adv-x="1664" 
+d="M1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -21 -10.5 -35.5t-30.5 -14.5q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455
+l502 -73q56 -9 56 -46z" />
+    <glyph glyph-name="star_empty" unicode="&#xf006;" horiz-adv-x="1664" 
+d="M1137 532l306 297l-422 62l-189 382l-189 -382l-422 -62l306 -297l-73 -421l378 199l377 -199zM1664 889q0 -22 -26 -48l-363 -354l86 -500q1 -7 1 -20q0 -50 -41 -50q-19 0 -40 12l-449 236l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500
+l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41t49 -41l225 -455l502 -73q56 -9 56 -46z" />
+    <glyph glyph-name="user" unicode="&#xf007;" horiz-adv-x="1280" 
+d="M1280 137q0 -109 -62.5 -187t-150.5 -78h-854q-88 0 -150.5 78t-62.5 187q0 85 8.5 160.5t31.5 152t58.5 131t94 89t134.5 34.5q131 -128 313 -128t313 128q76 0 134.5 -34.5t94 -89t58.5 -131t31.5 -152t8.5 -160.5zM1024 1024q0 -159 -112.5 -271.5t-271.5 -112.5
+t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
+    <glyph glyph-name="film" unicode="&#xf008;" horiz-adv-x="1920" 
+d="M384 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 320v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM384 704v128q0 26 -19 45t-45 19h-128
+q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 -64v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM384 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45
+t45 -19h128q26 0 45 19t19 45zM1792 -64v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1408 704v512q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-512q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1792 320v128
+q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 704v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1792 1088v128q0 26 -19 45t-45 19h-128q-26 0 -45 -19
+t-19 -45v-128q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1920 1248v-1344q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1344q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="th_large" unicode="&#xf009;" horiz-adv-x="1664" 
+d="M768 512v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM768 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 512v-384q0 -52 -38 -90t-90 -38
+h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90zM1664 1280v-384q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="th" unicode="&#xf00a;" horiz-adv-x="1792" 
+d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 288v-192q0 -40 -28 -68t-68 -28h-320
+q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28
+h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1152 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192
+q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="th_list" unicode="&#xf00b;" horiz-adv-x="1792" 
+d="M512 288v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM512 800v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 288v-192q0 -40 -28 -68t-68 -28h-960
+q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68zM512 1312v-192q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h320q40 0 68 -28t28 -68zM1792 800v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28
+h960q40 0 68 -28t28 -68zM1792 1312v-192q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h960q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="ok" unicode="&#xf00c;" horiz-adv-x="1792" 
+d="M1671 970q0 -40 -28 -68l-724 -724l-136 -136q-28 -28 -68 -28t-68 28l-136 136l-362 362q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -295l656 657q28 28 68 28t68 -28l136 -136q28 -28 28 -68z" />
+    <glyph glyph-name="remove" unicode="&#xf00d;" horiz-adv-x="1408" 
+d="M1298 214q0 -40 -28 -68l-136 -136q-28 -28 -68 -28t-68 28l-294 294l-294 -294q-28 -28 -68 -28t-68 28l-136 136q-28 28 -28 68t28 68l294 294l-294 294q-28 28 -28 68t28 68l136 136q28 28 68 28t68 -28l294 -294l294 294q28 28 68 28t68 -28l136 -136q28 -28 28 -68
+t-28 -68l-294 -294l294 -294q28 -28 28 -68z" />
+    <glyph glyph-name="zoom_in" unicode="&#xf00e;" horiz-adv-x="1664" 
+d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-224q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v224h-224q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h224v224q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5v-224h224
+q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5
+t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z" />
+    <glyph glyph-name="zoom_out" unicode="&#xf010;" horiz-adv-x="1664" 
+d="M1024 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-576q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h576q13 0 22.5 -9.5t9.5 -22.5zM1152 704q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5z
+M1664 -128q0 -53 -37.5 -90.5t-90.5 -37.5q-54 0 -90 38l-343 342q-179 -124 -399 -124q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -220 -124 -399l343 -343q37 -37 37 -90z
+" />
+    <glyph glyph-name="off" unicode="&#xf011;" 
+d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61t-298 61t-245 164t-164 245t-61 298q0 182 80.5 343t226.5 270q43 32 95.5 25t83.5 -50q32 -42 24.5 -94.5t-49.5 -84.5q-98 -74 -151.5 -181t-53.5 -228q0 -104 40.5 -198.5t109.5 -163.5t163.5 -109.5
+t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5q0 121 -53.5 228t-151.5 181q-42 32 -49.5 84.5t24.5 94.5q31 43 84 50t95 -25q146 -109 226.5 -270t80.5 -343zM896 1408v-640q0 -52 -38 -90t-90 -38t-90 38t-38 90v640q0 52 38 90t90 38t90 -38t38 -90z" />
+    <glyph glyph-name="signal" unicode="&#xf012;" horiz-adv-x="1792" 
+d="M256 96v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 224v-320q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 480v-576q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23
+v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1408 864v-960q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1376v-1472q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1472q0 14 9 23t23 9h192q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="cog" unicode="&#xf013;" 
+d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1536 749v-222q0 -12 -8 -23t-20 -13l-185 -28q-19 -54 -39 -91q35 -50 107 -138q10 -12 10 -25t-9 -23q-27 -37 -99 -108t-94 -71q-12 0 -26 9l-138 108q-44 -23 -91 -38
+q-16 -136 -29 -186q-7 -28 -36 -28h-222q-14 0 -24.5 8.5t-11.5 21.5l-28 184q-49 16 -90 37l-141 -107q-10 -9 -25 -9q-14 0 -25 11q-126 114 -165 168q-7 10 -7 23q0 12 8 23q15 21 51 66.5t54 70.5q-27 50 -41 99l-183 27q-13 2 -21 12.5t-8 23.5v222q0 12 8 23t19 13
+l186 28q14 46 39 92q-40 57 -107 138q-10 12 -10 24q0 10 9 23q26 36 98.5 107.5t94.5 71.5q13 0 26 -10l138 -107q44 23 91 38q16 136 29 186q7 28 36 28h222q14 0 24.5 -8.5t11.5 -21.5l28 -184q49 -16 90 -37l142 107q9 9 24 9q13 0 25 -10q129 -119 165 -170q7 -8 7 -22
+q0 -12 -8 -23q-15 -21 -51 -66.5t-54 -70.5q26 -50 41 -98l183 -28q13 -2 21 -12.5t8 -23.5z" />
+    <glyph glyph-name="trash" unicode="&#xf014;" horiz-adv-x="1408" 
+d="M512 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM768 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1024 800v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576
+q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1152 76v948h-896v-948q0 -22 7 -40.5t14.5 -27t10.5 -8.5h832q3 0 10.5 8.5t14.5 27t7 40.5zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832
+q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="home" unicode="&#xf015;" horiz-adv-x="1664" 
+d="M1408 544v-480q0 -26 -19 -45t-45 -19h-384v384h-256v-384h-384q-26 0 -45 19t-19 45v480q0 1 0.5 3t0.5 3l575 474l575 -474q1 -2 1 -6zM1631 613l-62 -74q-8 -9 -21 -11h-3q-13 0 -21 7l-692 577l-692 -577q-12 -8 -24 -7q-13 2 -21 11l-62 74q-8 10 -7 23.5t11 21.5
+l719 599q32 26 76 26t76 -26l244 -204v195q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-408l219 -182q10 -8 11 -21.5t-7 -23.5z" />
+    <glyph glyph-name="file_alt" unicode="&#xf016;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+" />
+    <glyph glyph-name="time" unicode="&#xf017;" 
+d="M896 992v-448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="road" unicode="&#xf018;" horiz-adv-x="1920" 
+d="M1111 540v4l-24 320q-1 13 -11 22.5t-23 9.5h-186q-13 0 -23 -9.5t-11 -22.5l-24 -320v-4q-1 -12 8 -20t21 -8h244q12 0 21 8t8 20zM1870 73q0 -73 -46 -73h-704q13 0 22 9.5t8 22.5l-20 256q-1 13 -11 22.5t-23 9.5h-272q-13 0 -23 -9.5t-11 -22.5l-20 -256
+q-1 -13 8 -22.5t22 -9.5h-704q-46 0 -46 73q0 54 26 116l417 1044q8 19 26 33t38 14h339q-13 0 -23 -9.5t-11 -22.5l-15 -192q-1 -14 8 -23t22 -9h166q13 0 22 9t8 23l-15 192q-1 13 -11 22.5t-23 9.5h339q20 0 38 -14t26 -33l417 -1044q26 -62 26 -116z" />
+    <glyph glyph-name="download_alt" unicode="&#xf019;" horiz-adv-x="1664" 
+d="M1280 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 416v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h465l135 -136
+q58 -56 136 -56t136 56l136 136h464q40 0 68 -28t28 -68zM1339 985q17 -41 -14 -70l-448 -448q-18 -19 -45 -19t-45 19l-448 448q-31 29 -14 70q17 39 59 39h256v448q0 26 19 45t45 19h256q26 0 45 -19t19 -45v-448h256q42 0 59 -39z" />
+    <glyph glyph-name="download" unicode="&#xf01a;" 
+d="M1120 608q0 -12 -10 -24l-319 -319q-11 -9 -23 -9t-23 9l-320 320q-15 16 -7 35q8 20 30 20h192v352q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-352h192q14 0 23 -9t9 -23zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273
+t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="upload" unicode="&#xf01b;" 
+d="M1118 660q-8 -20 -30 -20h-192v-352q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v352h-192q-14 0 -23 9t-9 23q0 12 10 24l319 319q11 9 23 9t23 -9l320 -320q15 -16 7 -35zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198
+t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="inbox" unicode="&#xf01c;" 
+d="M1023 576h316q-1 3 -2.5 8.5t-2.5 7.5l-212 496h-708l-212 -496q-1 -3 -2.5 -8.5t-2.5 -7.5h316l95 -192h320zM1536 546v-482q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v482q0 62 25 123l238 552q10 25 36.5 42t52.5 17h832q26 0 52.5 -17t36.5 -42l238 -552
+q25 -61 25 -123z" />
+    <glyph glyph-name="play_circle" unicode="&#xf01d;" 
+d="M1184 640q0 -37 -32 -55l-544 -320q-15 -9 -32 -9q-16 0 -32 8q-32 19 -32 56v640q0 37 32 56q33 18 64 -1l544 -320q32 -18 32 -55zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="repeat" unicode="&#xf01e;" 
+d="M1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l138 138q-148 137 -349 137q-104 0 -198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5q119 0 225 52t179 147q7 10 23 12q15 0 25 -9
+l137 -138q9 -8 9.5 -20.5t-7.5 -22.5q-109 -132 -264 -204.5t-327 -72.5q-156 0 -298 61t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q147 0 284.5 -55.5t244.5 -156.5l130 129q29 31 70 14q39 -17 39 -59z" />
+    <glyph glyph-name="refresh" unicode="&#xf021;" 
+d="M1511 480q0 -5 -1 -7q-64 -268 -268 -434.5t-478 -166.5q-146 0 -282.5 55t-243.5 157l-129 -129q-19 -19 -45 -19t-45 19t-19 45v448q0 26 19 45t45 19h448q26 0 45 -19t19 -45t-19 -45l-137 -137q71 -66 161 -102t187 -36q134 0 250 65t186 179q11 17 53 117
+q8 23 30 23h192q13 0 22.5 -9.5t9.5 -22.5zM1536 1280v-448q0 -26 -19 -45t-45 -19h-448q-26 0 -45 19t-19 45t19 45l138 138q-148 137 -349 137q-134 0 -250 -65t-186 -179q-11 -17 -53 -117q-8 -23 -30 -23h-199q-13 0 -22.5 9.5t-9.5 22.5v7q65 268 270 434.5t480 166.5
+q146 0 284 -55.5t245 -156.5l130 129q19 19 45 19t45 -19t19 -45z" />
+    <glyph glyph-name="list_alt" unicode="&#xf022;" horiz-adv-x="1792" 
+d="M384 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M384 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1536 352v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5z
+M1536 608v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5t9.5 -22.5zM1536 864v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h960q13 0 22.5 -9.5
+t9.5 -22.5zM1664 160v832q0 13 -9.5 22.5t-22.5 9.5h-1472q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 1248v-1088q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1472q66 0 113 -47
+t47 -113z" />
+    <glyph glyph-name="lock" unicode="&#xf023;" horiz-adv-x="1152" 
+d="M320 768h512v192q0 106 -75 181t-181 75t-181 -75t-75 -181v-192zM1152 672v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v192q0 184 132 316t316 132t316 -132t132 -316v-192h32q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="flag" unicode="&#xf024;" horiz-adv-x="1792" 
+d="M320 1280q0 -72 -64 -110v-1266q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v1266q-64 38 -64 110q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -25 -12.5 -38.5t-39.5 -27.5q-215 -116 -369 -116q-61 0 -123.5 22t-108.5 48
+t-115.5 48t-142.5 22q-192 0 -464 -146q-17 -9 -33 -9q-26 0 -45 19t-19 45v742q0 32 31 55q21 14 79 43q236 120 421 120q107 0 200 -29t219 -88q38 -19 88 -19q54 0 117.5 21t110 47t88 47t54.5 21q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="headphones" unicode="&#xf025;" horiz-adv-x="1664" 
+d="M1664 650q0 -166 -60 -314l-20 -49l-185 -33q-22 -83 -90.5 -136.5t-156.5 -53.5v-32q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-32q71 0 130 -35.5t93 -95.5l68 12q29 95 29 193q0 148 -88 279t-236.5 209t-315.5 78
+t-315.5 -78t-236.5 -209t-88 -279q0 -98 29 -193l68 -12q34 60 93 95.5t130 35.5v32q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v32q-88 0 -156.5 53.5t-90.5 136.5l-185 33l-20 49q-60 148 -60 314q0 151 67 291t179 242.5
+t266 163.5t320 61t320 -61t266 -163.5t179 -242.5t67 -291z" />
+    <glyph glyph-name="volume_off" unicode="&#xf026;" horiz-adv-x="768" 
+d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45z" />
+    <glyph glyph-name="volume_down" unicode="&#xf027;" horiz-adv-x="1152" 
+d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 36
+t12 56.5t-12 56.5t-29 36t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142z" />
+    <glyph glyph-name="volume_up" unicode="&#xf028;" horiz-adv-x="1664" 
+d="M768 1184v-1088q0 -26 -19 -45t-45 -19t-45 19l-333 333h-262q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h262l333 333q19 19 45 19t45 -19t19 -45zM1152 640q0 -76 -42.5 -141.5t-112.5 -93.5q-10 -5 -25 -5q-26 0 -45 18.5t-19 45.5q0 21 12 35.5t29 25t34 23t29 36
+t12 56.5t-12 56.5t-29 36t-34 23t-29 25t-12 35.5q0 27 19 45.5t45 18.5q15 0 25 -5q70 -27 112.5 -93t42.5 -142zM1408 640q0 -153 -85 -282.5t-225 -188.5q-13 -5 -25 -5q-27 0 -46 19t-19 45q0 39 39 59q56 29 76 44q74 54 115.5 135.5t41.5 173.5t-41.5 173.5
+t-115.5 135.5q-20 15 -76 44q-39 20 -39 59q0 26 19 45t45 19q13 0 26 -5q140 -59 225 -188.5t85 -282.5zM1664 640q0 -230 -127 -422.5t-338 -283.5q-13 -5 -26 -5q-26 0 -45 19t-19 45q0 36 39 59q7 4 22.5 10.5t22.5 10.5q46 25 82 51q123 91 192 227t69 289t-69 289
+t-192 227q-36 26 -82 51q-7 4 -22.5 10.5t-22.5 10.5q-39 23 -39 59q0 26 19 45t45 19q13 0 26 -5q211 -91 338 -283.5t127 -422.5z" />
+    <glyph glyph-name="qrcode" unicode="&#xf029;" horiz-adv-x="1408" 
+d="M384 384v-128h-128v128h128zM384 1152v-128h-128v128h128zM1152 1152v-128h-128v128h128zM128 129h384v383h-384v-383zM128 896h384v384h-384v-384zM896 896h384v384h-384v-384zM640 640v-640h-640v640h640zM1152 128v-128h-128v128h128zM1408 128v-128h-128v128h128z
+M1408 640v-384h-384v128h-128v-384h-128v640h384v-128h128v128h128zM640 1408v-640h-640v640h640zM1408 1408v-640h-640v640h640z" />
+    <glyph glyph-name="barcode" unicode="&#xf02a;" horiz-adv-x="1792" 
+d="M63 0h-63v1408h63v-1408zM126 1h-32v1407h32v-1407zM220 1h-31v1407h31v-1407zM377 1h-31v1407h31v-1407zM534 1h-62v1407h62v-1407zM660 1h-31v1407h31v-1407zM723 1h-31v1407h31v-1407zM786 1h-31v1407h31v-1407zM943 1h-63v1407h63v-1407zM1100 1h-63v1407h63v-1407z
+M1226 1h-63v1407h63v-1407zM1352 1h-63v1407h63v-1407zM1446 1h-63v1407h63v-1407zM1635 1h-94v1407h94v-1407zM1698 1h-32v1407h32v-1407zM1792 0h-63v1408h63v-1408z" />
+    <glyph glyph-name="tag" unicode="&#xf02b;" 
+d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5
+l715 -714q37 -39 37 -91z" />
+    <glyph glyph-name="tags" unicode="&#xf02c;" horiz-adv-x="1920" 
+d="M448 1088q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1515 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-53 0 -90 37l-715 716q-38 37 -64.5 101t-26.5 117v416q0 52 38 90t90 38h416q53 0 117 -26.5t102 -64.5
+l715 -714q37 -39 37 -91zM1899 512q0 -53 -37 -90l-491 -492q-39 -37 -91 -37q-36 0 -59 14t-53 45l470 470q37 37 37 90q0 52 -37 91l-715 714q-38 38 -102 64.5t-117 26.5h224q53 0 117 -26.5t102 -64.5l715 -714q37 -39 37 -91z" />
+    <glyph glyph-name="book" unicode="&#xf02d;" horiz-adv-x="1664" 
+d="M1639 1058q40 -57 18 -129l-275 -906q-19 -64 -76.5 -107.5t-122.5 -43.5h-923q-77 0 -148.5 53.5t-99.5 131.5q-24 67 -2 127q0 4 3 27t4 37q1 8 -3 21.5t-3 19.5q2 11 8 21t16.5 23.5t16.5 23.5q23 38 45 91.5t30 91.5q3 10 0.5 30t-0.5 28q3 11 17 28t17 23
+q21 36 42 92t25 90q1 9 -2.5 32t0.5 28q4 13 22 30.5t22 22.5q19 26 42.5 84.5t27.5 96.5q1 8 -3 25.5t-2 26.5q2 8 9 18t18 23t17 21q8 12 16.5 30.5t15 35t16 36t19.5 32t26.5 23.5t36 11.5t47.5 -5.5l-1 -3q38 9 51 9h761q74 0 114 -56t18 -130l-274 -906
+q-36 -119 -71.5 -153.5t-128.5 -34.5h-869q-27 0 -38 -15q-11 -16 -1 -43q24 -70 144 -70h923q29 0 56 15.5t35 41.5l300 987q7 22 5 57q38 -15 59 -43zM575 1056q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5
+t-16.5 -22.5zM492 800q-4 -13 2 -22.5t20 -9.5h608q13 0 25.5 9.5t16.5 22.5l21 64q4 13 -2 22.5t-20 9.5h-608q-13 0 -25.5 -9.5t-16.5 -22.5z" />
+    <glyph glyph-name="bookmark" unicode="&#xf02e;" horiz-adv-x="1280" 
+d="M1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
+    <glyph glyph-name="print" unicode="&#xf02f;" horiz-adv-x="1664" 
+d="M384 0h896v256h-896v-256zM384 640h896v384h-160q-40 0 -68 28t-28 68v160h-640v-640zM1536 576q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 576v-416q0 -13 -9.5 -22.5t-22.5 -9.5h-224v-160q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68
+v160h-224q-13 0 -22.5 9.5t-9.5 22.5v416q0 79 56.5 135.5t135.5 56.5h64v544q0 40 28 68t68 28h672q40 0 88 -20t76 -48l152 -152q28 -28 48 -76t20 -88v-256h64q79 0 135.5 -56.5t56.5 -135.5z" />
+    <glyph glyph-name="camera" unicode="&#xf030;" horiz-adv-x="1920" 
+d="M960 864q119 0 203.5 -84.5t84.5 -203.5t-84.5 -203.5t-203.5 -84.5t-203.5 84.5t-84.5 203.5t84.5 203.5t203.5 84.5zM1664 1280q106 0 181 -75t75 -181v-896q0 -106 -75 -181t-181 -75h-1408q-106 0 -181 75t-75 181v896q0 106 75 181t181 75h224l51 136
+q19 49 69.5 84.5t103.5 35.5h512q53 0 103.5 -35.5t69.5 -84.5l51 -136h224zM960 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="font" unicode="&#xf031;" horiz-adv-x="1664" 
+d="M725 977l-170 -450q33 0 136.5 -2t160.5 -2q19 0 57 2q-87 253 -184 452zM0 -128l2 79q23 7 56 12.5t57 10.5t49.5 14.5t44.5 29t31 50.5l237 616l280 724h75h53q8 -14 11 -21l205 -480q33 -78 106 -257.5t114 -274.5q15 -34 58 -144.5t72 -168.5q20 -45 35 -57
+q19 -15 88 -29.5t84 -20.5q6 -38 6 -57q0 -5 -0.5 -13.5t-0.5 -12.5q-63 0 -190 8t-191 8q-76 0 -215 -7t-178 -8q0 43 4 78l131 28q1 0 12.5 2.5t15.5 3.5t14.5 4.5t15 6.5t11 8t9 11t2.5 14q0 16 -31 96.5t-72 177.5t-42 100l-450 2q-26 -58 -76.5 -195.5t-50.5 -162.5
+q0 -22 14 -37.5t43.5 -24.5t48.5 -13.5t57 -8.5t41 -4q1 -19 1 -58q0 -9 -2 -27q-58 0 -174.5 10t-174.5 10q-8 0 -26.5 -4t-21.5 -4q-80 -14 -188 -14z" />
+    <glyph glyph-name="bold" unicode="&#xf032;" horiz-adv-x="1408" 
+d="M555 15q74 -32 140 -32q376 0 376 335q0 114 -41 180q-27 44 -61.5 74t-67.5 46.5t-80.5 25t-84 10.5t-94.5 2q-73 0 -101 -10q0 -53 -0.5 -159t-0.5 -158q0 -8 -1 -67.5t-0.5 -96.5t4.5 -83.5t12 -66.5zM541 761q42 -7 109 -7q82 0 143 13t110 44.5t74.5 89.5t25.5 142
+q0 70 -29 122.5t-79 82t-108 43.5t-124 14q-50 0 -130 -13q0 -50 4 -151t4 -152q0 -27 -0.5 -80t-0.5 -79q0 -46 1 -69zM0 -128l2 94q15 4 85 16t106 27q7 12 12.5 27t8.5 33.5t5.5 32.5t3 37.5t0.5 34v35.5v30q0 982 -22 1025q-4 8 -22 14.5t-44.5 11t-49.5 7t-48.5 4.5
+t-30.5 3l-4 83q98 2 340 11.5t373 9.5q23 0 68 -0.5t68 -0.5q70 0 136.5 -13t128.5 -42t108 -71t74 -104.5t28 -137.5q0 -52 -16.5 -95.5t-39 -72t-64.5 -57.5t-73 -45t-84 -40q154 -35 256.5 -134t102.5 -248q0 -100 -35 -179.5t-93.5 -130.5t-138 -85.5t-163.5 -48.5
+t-176 -14q-44 0 -132 3t-132 3q-106 0 -307 -11t-231 -12z" />
+    <glyph glyph-name="italic" unicode="&#xf033;" horiz-adv-x="1024" 
+d="M0 -126l17 85q22 7 61.5 16.5t72 19t59.5 23.5q28 35 41 101q1 7 62 289t114 543.5t52 296.5v25q-24 13 -54.5 18.5t-69.5 8t-58 5.5l19 103q33 -2 120 -6.5t149.5 -7t120.5 -2.5q48 0 98.5 2.5t121 7t98.5 6.5q-5 -39 -19 -89q-30 -10 -101.5 -28.5t-108.5 -33.5
+q-8 -19 -14 -42.5t-9 -40t-7.5 -45.5t-6.5 -42q-27 -148 -87.5 -419.5t-77.5 -355.5q-2 -9 -13 -58t-20 -90t-16 -83.5t-6 -57.5l1 -18q17 -4 185 -31q-3 -44 -16 -99q-11 0 -32.5 -1.5t-32.5 -1.5q-29 0 -87 10t-86 10q-138 2 -206 2q-51 0 -143 -9t-121 -11z" />
+    <glyph glyph-name="text_height" unicode="&#xf034;" horiz-adv-x="1792" 
+d="M1744 128q33 0 42 -18.5t-11 -44.5l-126 -162q-20 -26 -49 -26t-49 26l-126 162q-20 26 -11 44.5t42 18.5h80v1024h-80q-33 0 -42 18.5t11 44.5l126 162q20 26 49 26t49 -26l126 -162q20 -26 11 -44.5t-42 -18.5h-80v-1024h80zM81 1407l54 -27q12 -5 211 -5q44 0 132 2
+t132 2q36 0 107.5 -0.5t107.5 -0.5h293q6 0 21 -0.5t20.5 0t16 3t17.5 9t15 17.5l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 48t-14.5 73.5t-7.5 35.5q-6 8 -12 12.5t-15.5 6t-13 2.5t-18 0.5t-16.5 -0.5
+q-17 0 -66.5 0.5t-74.5 0.5t-64 -2t-71 -6q-9 -81 -8 -136q0 -94 2 -388t2 -455q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27
+q19 42 19 383q0 101 -3 303t-3 303v117q0 2 0.5 15.5t0.5 25t-1 25.5t-3 24t-5 14q-11 12 -162 12q-33 0 -93 -12t-80 -26q-19 -13 -34 -72.5t-31.5 -111t-42.5 -53.5q-42 26 -56 44v383z" />
+    <glyph glyph-name="text_width" unicode="&#xf035;" 
+d="M81 1407l54 -27q12 -5 211 -5q44 0 132 2t132 2q70 0 246.5 1t304.5 0.5t247 -4.5q33 -1 56 31l42 1q4 0 14 -0.5t14 -0.5q2 -112 2 -336q0 -80 -5 -109q-39 -14 -68 -18q-25 44 -54 128q-3 9 -11 47.5t-15 73.5t-7 36q-10 13 -27 19q-5 2 -66 2q-30 0 -93 1t-103 1
+t-94 -2t-96 -7q-9 -81 -8 -136l1 -152v52q0 -55 1 -154t1.5 -180t0.5 -153q0 -16 -2.5 -71.5t0 -91.5t12.5 -69q40 -21 124 -42.5t120 -37.5q5 -40 5 -50q0 -14 -3 -29l-34 -1q-76 -2 -218 8t-207 10q-50 0 -151 -9t-152 -9q-3 51 -3 52v9q17 27 61.5 43t98.5 29t78 27
+q7 16 11.5 74t6 145.5t1.5 155t-0.5 153.5t-0.5 89q0 7 -2.5 21.5t-2.5 22.5q0 7 0.5 44t1 73t0 76.5t-3 67.5t-6.5 32q-11 12 -162 12q-41 0 -163 -13.5t-138 -24.5q-19 -12 -34 -71.5t-31.5 -111.5t-42.5 -54q-42 26 -56 44v383zM1310 125q12 0 42 -19.5t57.5 -41.5
+t59.5 -49t36 -30q26 -21 26 -49t-26 -49q-4 -3 -36 -30t-59.5 -49t-57.5 -41.5t-42 -19.5q-13 0 -20.5 10.5t-10 28.5t-2.5 33.5t1.5 33t1.5 19.5h-1024q0 -2 1.5 -19.5t1.5 -33t-2.5 -33.5t-10 -28.5t-20.5 -10.5q-12 0 -42 19.5t-57.5 41.5t-59.5 49t-36 30q-26 21 -26 49
+t26 49q4 3 36 30t59.5 49t57.5 41.5t42 19.5q13 0 20.5 -10.5t10 -28.5t2.5 -33.5t-1.5 -33t-1.5 -19.5h1024q0 2 -1.5 19.5t-1.5 33t2.5 33.5t10 28.5t20.5 10.5z" />
+    <glyph glyph-name="align_left" unicode="&#xf036;" horiz-adv-x="1792" 
+d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45
+t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="align_center" unicode="&#xf037;" horiz-adv-x="1792" 
+d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1408 576v-128q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h896q26 0 45 -19t19 -45zM1664 960v-128q0 -26 -19 -45t-45 -19
+h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1280 1344v-128q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h640q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="align_right" unicode="&#xf038;" horiz-adv-x="1792" 
+d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1280q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45
+t-45 -19h-1536q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1536q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1152q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="align_justify" unicode="&#xf039;" horiz-adv-x="1792" 
+d="M1792 192v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 576v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 960v-128q0 -26 -19 -45
+t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-128q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="list" unicode="&#xf03a;" horiz-adv-x="1792" 
+d="M256 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM256 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5
+t9.5 -22.5zM256 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344
+q13 0 22.5 -9.5t9.5 -22.5zM256 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5
+t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v192
+q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5z" />
+    <glyph glyph-name="indent_left" unicode="&#xf03b;" horiz-adv-x="1792" 
+d="M384 992v-576q0 -13 -9.5 -22.5t-22.5 -9.5q-14 0 -23 9l-288 288q-9 9 -9 23t9 23l288 288q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5
+t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088
+q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
+    <glyph glyph-name="indent_right" unicode="&#xf03c;" horiz-adv-x="1792" 
+d="M352 704q0 -14 -9 -23l-288 -288q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v576q0 13 9.5 22.5t22.5 9.5q14 0 23 -9l288 -288q9 -9 9 -23zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5
+t9.5 -22.5zM1792 608v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088q13 0 22.5 -9.5t9.5 -22.5zM1792 992v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1088q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1088
+q13 0 22.5 -9.5t9.5 -22.5zM1792 1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1728q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1728q13 0 22.5 -9.5t9.5 -22.5z" />
+    <glyph glyph-name="facetime_video" unicode="&#xf03d;" horiz-adv-x="1792" 
+d="M1792 1184v-1088q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-403 403v-166q0 -119 -84.5 -203.5t-203.5 -84.5h-704q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h704q119 0 203.5 -84.5t84.5 -203.5v-165l403 402q18 19 45 19q12 0 25 -5
+q39 -17 39 -59z" />
+    <glyph glyph-name="picture" unicode="&#xf03e;" horiz-adv-x="1920" 
+d="M640 960q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 576v-448h-1408v192l320 320l160 -160l512 512zM1760 1280h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5v1216
+q0 13 -9.5 22.5t-22.5 9.5zM1920 1248v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="pencil" unicode="&#xf040;" 
+d="M363 0l91 91l-235 235l-91 -91v-107h128v-128h107zM886 928q0 22 -22 22q-10 0 -17 -7l-542 -542q-7 -7 -7 -17q0 -22 22 -22q10 0 17 7l542 542q7 7 7 17zM832 1120l416 -416l-832 -832h-416v416zM1515 1024q0 -53 -37 -90l-166 -166l-416 416l166 165q36 38 90 38
+q53 0 91 -38l235 -234q37 -39 37 -91z" />
+    <glyph glyph-name="map_marker" unicode="&#xf041;" horiz-adv-x="1024" 
+d="M768 896q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1024 896q0 -109 -33 -179l-364 -774q-16 -33 -47.5 -52t-67.5 -19t-67.5 19t-46.5 52l-365 774q-33 70 -33 179q0 212 150 362t362 150t362 -150t150 -362z" />
+    <glyph glyph-name="adjust" unicode="&#xf042;" 
+d="M768 96v1088q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="tint" unicode="&#xf043;" horiz-adv-x="1024" 
+d="M512 384q0 36 -20 69q-1 1 -15.5 22.5t-25.5 38t-25 44t-21 50.5q-4 16 -21 16t-21 -16q-7 -23 -21 -50.5t-25 -44t-25.5 -38t-15.5 -22.5q-20 -33 -20 -69q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 512q0 -212 -150 -362t-362 -150t-362 150t-150 362
+q0 145 81 275q6 9 62.5 90.5t101 151t99.5 178t83 201.5q9 30 34 47t51 17t51.5 -17t33.5 -47q28 -93 83 -201.5t99.5 -178t101 -151t62.5 -90.5q81 -127 81 -275z" />
+    <glyph glyph-name="edit" unicode="&#xf044;" horiz-adv-x="1792" 
+d="M888 352l116 116l-152 152l-116 -116v-56h96v-96h56zM1328 1072q-16 16 -33 -1l-350 -350q-17 -17 -1 -33t33 1l350 350q17 17 1 33zM1408 478v-190q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832
+q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-14 -14 -32 -8q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v126q0 13 9 22l64 64q15 15 35 7t20 -29zM1312 1216l288 -288l-672 -672h-288v288zM1756 1084l-92 -92
+l-288 288l92 92q28 28 68 28t68 -28l152 -152q28 -28 28 -68t-28 -68z" />
+    <glyph glyph-name="share" unicode="&#xf045;" horiz-adv-x="1664" 
+d="M1408 547v-259q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h255v0q13 0 22.5 -9.5t9.5 -22.5q0 -27 -26 -32q-77 -26 -133 -60q-10 -4 -16 -4h-112q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832
+q66 0 113 47t47 113v214q0 19 18 29q28 13 54 37q16 16 35 8q21 -9 21 -29zM1645 1043l-384 -384q-18 -19 -45 -19q-12 0 -25 5q-39 17 -39 59v192h-160q-323 0 -438 -131q-119 -137 -74 -473q3 -23 -20 -34q-8 -2 -12 -2q-16 0 -26 13q-10 14 -21 31t-39.5 68.5t-49.5 99.5
+t-38.5 114t-17.5 122q0 49 3.5 91t14 90t28 88t47 81.5t68.5 74t94.5 61.5t124.5 48.5t159.5 30.5t196.5 11h160v192q0 42 39 59q13 5 25 5q26 0 45 -19l384 -384q19 -19 19 -45t-19 -45z" />
+    <glyph glyph-name="check" unicode="&#xf046;" horiz-adv-x="1664" 
+d="M1408 606v-318q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q63 0 117 -25q15 -7 18 -23q3 -17 -9 -29l-49 -49q-10 -10 -23 -10q-3 0 -9 2q-23 6 -45 6h-832q-66 0 -113 -47t-47 -113v-832
+q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v254q0 13 9 22l64 64q10 10 23 10q6 0 12 -3q20 -8 20 -29zM1639 1095l-814 -814q-24 -24 -57 -24t-57 24l-430 430q-24 24 -24 57t24 57l110 110q24 24 57 24t57 -24l263 -263l647 647q24 24 57 24t57 -24l110 -110
+q24 -24 24 -57t-24 -57z" />
+    <glyph glyph-name="move" unicode="&#xf047;" horiz-adv-x="1792" 
+d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-384v-384h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v384h-384v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45
+t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h384v384h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45t-19 -45t-45 -19h-128v-384h384v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
+    <glyph glyph-name="step_backward" unicode="&#xf048;" horiz-adv-x="1024" 
+d="M979 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 10 13 19z" />
+    <glyph glyph-name="fast_backward" unicode="&#xf049;" horiz-adv-x="1792" 
+d="M1747 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-678q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-678q4 10 13 19l710 710
+q19 19 32 13t13 -32v-710q4 10 13 19z" />
+    <glyph glyph-name="backward" unicode="&#xf04a;" horiz-adv-x="1664" 
+d="M1619 1395q19 19 32 13t13 -32v-1472q0 -26 -13 -32t-32 13l-710 710q-9 9 -13 19v-710q0 -26 -13 -32t-32 13l-710 710q-19 19 -19 45t19 45l710 710q19 19 32 13t13 -32v-710q4 10 13 19z" />
+    <glyph glyph-name="play" unicode="&#xf04b;" horiz-adv-x="1408" 
+d="M1384 609l-1328 -738q-23 -13 -39.5 -3t-16.5 36v1472q0 26 16.5 36t39.5 -3l1328 -738q23 -13 23 -31t-23 -31z" />
+    <glyph glyph-name="pause" unicode="&#xf04c;" 
+d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45zM640 1344v-1408q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h512q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="stop" unicode="&#xf04d;" 
+d="M1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="forward" unicode="&#xf04e;" horiz-adv-x="1664" 
+d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v710q0 26 13 32t32 -13l710 -710q19 -19 19 -45t-19 -45l-710 -710q-19 -19 -32 -13t-13 32v710q-4 -10 -13 -19z" />
+    <glyph glyph-name="fast_forward" unicode="&#xf050;" horiz-adv-x="1792" 
+d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v710q0 26 13 32t32 -13l710 -710q9 -9 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-4 -10 -13 -19l-710 -710
+q-19 -19 -32 -13t-13 32v710q-4 -10 -13 -19z" />
+    <glyph glyph-name="step_forward" unicode="&#xf051;" horiz-adv-x="1024" 
+d="M45 -115q-19 -19 -32 -13t-13 32v1472q0 26 13 32t32 -13l710 -710q9 -9 13 -19v678q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-1408q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v678q-4 -10 -13 -19z" />
+    <glyph glyph-name="eject" unicode="&#xf052;" horiz-adv-x="1538" 
+d="M14 557l710 710q19 19 45 19t45 -19l710 -710q19 -19 13 -32t-32 -13h-1472q-26 0 -32 13t13 32zM1473 0h-1408q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1408q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19z" />
+    <glyph glyph-name="chevron_left" unicode="&#xf053;" horiz-adv-x="1280" 
+d="M1171 1235l-531 -531l531 -531q19 -19 19 -45t-19 -45l-166 -166q-19 -19 -45 -19t-45 19l-742 742q-19 19 -19 45t19 45l742 742q19 19 45 19t45 -19l166 -166q19 -19 19 -45t-19 -45z" />
+    <glyph glyph-name="chevron_right" unicode="&#xf054;" horiz-adv-x="1280" 
+d="M1107 659l-742 -742q-19 -19 -45 -19t-45 19l-166 166q-19 19 -19 45t19 45l531 531l-531 531q-19 19 -19 45t19 45l166 166q19 19 45 19t45 -19l742 -742q19 -19 19 -45t-19 -45z" />
+    <glyph glyph-name="plus_sign" unicode="&#xf055;" 
+d="M1216 576v128q0 26 -19 45t-45 19h-256v256q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-256h-256q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h256v-256q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v256h256q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5
+t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="minus_sign" unicode="&#xf056;" 
+d="M1216 576v128q0 26 -19 45t-45 19h-768q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h768q26 0 45 19t19 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
+t103 -385.5z" />
+    <glyph glyph-name="remove_sign" unicode="&#xf057;" 
+d="M1149 414q0 26 -19 45l-181 181l181 181q19 19 19 45q0 27 -19 46l-90 90q-19 19 -46 19q-26 0 -45 -19l-181 -181l-181 181q-19 19 -45 19q-27 0 -46 -19l-90 -90q-19 -19 -19 -46q0 -26 19 -45l181 -181l-181 -181q-19 -19 -19 -45q0 -27 19 -46l90 -90q19 -19 46 -19
+q26 0 45 19l181 181l181 -181q19 -19 45 -19q27 0 46 19l90 90q19 19 19 46zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="ok_sign" unicode="&#xf058;" 
+d="M1284 802q0 28 -18 46l-91 90q-19 19 -45 19t-45 -19l-408 -407l-226 226q-19 19 -45 19t-45 -19l-91 -90q-18 -18 -18 -46q0 -27 18 -45l362 -362q19 -19 45 -19q27 0 46 19l543 543q18 18 18 45zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
+t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="question_sign" unicode="&#xf059;" 
+d="M896 160v192q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1152 832q0 88 -55.5 163t-138.5 116t-170 41q-243 0 -371 -213q-15 -24 8 -42l132 -100q7 -6 19 -6q16 0 25 12q53 68 86 92q34 24 86 24q48 0 85.5 -26t37.5 -59
+q0 -38 -20 -61t-68 -45q-63 -28 -115.5 -86.5t-52.5 -125.5v-36q0 -14 9 -23t23 -9h192q14 0 23 9t9 23q0 19 21.5 49.5t54.5 49.5q32 18 49 28.5t46 35t44.5 48t28 60.5t12.5 81zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
+t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="info_sign" unicode="&#xf05a;" 
+d="M1024 160v160q0 14 -9 23t-23 9h-96v512q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h96v-320h-96q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23t23 -9h448q14 0 23 9t9 23zM896 1056v160q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-160q0 -14 9 -23
+t23 -9h192q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="screenshot" unicode="&#xf05b;" 
+d="M1197 512h-109q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h109q-32 108 -112.5 188.5t-188.5 112.5v-109q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v109q-108 -32 -188.5 -112.5t-112.5 -188.5h109q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-109
+q32 -108 112.5 -188.5t188.5 -112.5v109q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-109q108 32 188.5 112.5t112.5 188.5zM1536 704v-128q0 -26 -19 -45t-45 -19h-143q-37 -161 -154.5 -278.5t-278.5 -154.5v-143q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v143
+q-161 37 -278.5 154.5t-154.5 278.5h-143q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h143q37 161 154.5 278.5t278.5 154.5v143q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-143q161 -37 278.5 -154.5t154.5 -278.5h143q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="remove_circle" unicode="&#xf05c;" 
+d="M1097 457l-146 -146q-10 -10 -23 -10t-23 10l-137 137l-137 -137q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l137 137l-137 137q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l137 -137l137 137q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23
+l-137 -137l137 -137q10 -10 10 -23t-10 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5
+t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="ok_circle" unicode="&#xf05d;" 
+d="M1171 723l-422 -422q-19 -19 -45 -19t-45 19l-294 294q-19 19 -19 45t19 45l102 102q19 19 45 19t45 -19l147 -147l275 275q19 19 45 19t45 -19l102 -102q19 -19 19 -45t-19 -45zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198
+t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="ban_circle" unicode="&#xf05e;" 
+d="M1312 643q0 161 -87 295l-754 -753q137 -89 297 -89q111 0 211.5 43.5t173.5 116.5t116 174.5t43 212.5zM313 344l755 754q-135 91 -300 91q-148 0 -273 -73t-198 -199t-73 -274q0 -162 89 -299zM1536 643q0 -157 -61 -300t-163.5 -246t-245 -164t-298.5 -61t-298.5 61
+t-245 164t-163.5 246t-61 300t61 299.5t163.5 245.5t245 164t298.5 61t298.5 -61t245 -164t163.5 -245.5t61 -299.5z" />
+    <glyph glyph-name="arrow_left" unicode="&#xf060;" 
+d="M1536 640v-128q0 -53 -32.5 -90.5t-84.5 -37.5h-704l293 -294q38 -36 38 -90t-38 -90l-75 -76q-37 -37 -90 -37q-52 0 -91 37l-651 652q-37 37 -37 90q0 52 37 91l651 650q38 38 91 38q52 0 90 -38l75 -74q38 -38 38 -91t-38 -91l-293 -293h704q52 0 84.5 -37.5
+t32.5 -90.5z" />
+    <glyph glyph-name="arrow_right" unicode="&#xf061;" 
+d="M1472 576q0 -54 -37 -91l-651 -651q-39 -37 -91 -37q-51 0 -90 37l-75 75q-38 38 -38 91t38 91l293 293h-704q-52 0 -84.5 37.5t-32.5 90.5v128q0 53 32.5 90.5t84.5 37.5h704l-293 294q-38 36 -38 90t38 90l75 75q38 38 90 38q53 0 91 -38l651 -651q37 -35 37 -90z" />
+    <glyph glyph-name="arrow_up" unicode="&#xf062;" horiz-adv-x="1664" 
+d="M1611 565q0 -51 -37 -90l-75 -75q-38 -38 -91 -38q-54 0 -90 38l-294 293v-704q0 -52 -37.5 -84.5t-90.5 -32.5h-128q-53 0 -90.5 32.5t-37.5 84.5v704l-294 -293q-36 -38 -90 -38t-90 38l-75 75q-38 38 -38 90q0 53 38 91l651 651q35 37 90 37q54 0 91 -37l651 -651
+q37 -39 37 -91z" />
+    <glyph glyph-name="arrow_down" unicode="&#xf063;" horiz-adv-x="1664" 
+d="M1611 704q0 -53 -37 -90l-651 -652q-39 -37 -91 -37q-53 0 -90 37l-651 652q-38 36 -38 90q0 53 38 91l74 75q39 37 91 37q53 0 90 -37l294 -294v704q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-704l294 294q37 37 90 37q52 0 91 -37l75 -75q37 -39 37 -91z" />
+    <glyph glyph-name="share_alt" unicode="&#xf064;" horiz-adv-x="1792" 
+d="M1792 896q0 -26 -19 -45l-512 -512q-19 -19 -45 -19t-45 19t-19 45v256h-224q-98 0 -175.5 -6t-154 -21.5t-133 -42.5t-105.5 -69.5t-80 -101t-48.5 -138.5t-17.5 -181q0 -55 5 -123q0 -6 2.5 -23.5t2.5 -26.5q0 -15 -8.5 -25t-23.5 -10q-16 0 -28 17q-7 9 -13 22
+t-13.5 30t-10.5 24q-127 285 -127 451q0 199 53 333q162 403 875 403h224v256q0 26 19 45t45 19t45 -19l512 -512q19 -19 19 -45z" />
+    <glyph glyph-name="resize_full" unicode="&#xf065;" 
+d="M755 480q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23zM1536 1344v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332
+q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="resize_small" unicode="&#xf066;" 
+d="M768 576v-448q0 -26 -19 -45t-45 -19t-45 19l-144 144l-332 -332q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l332 332l-144 144q-19 19 -19 45t19 45t45 19h448q26 0 45 -19t19 -45zM1523 1248q0 -13 -10 -23l-332 -332l144 -144q19 -19 19 -45t-19 -45
+t-45 -19h-448q-26 0 -45 19t-19 45v448q0 26 19 45t45 19t45 -19l144 -144l332 332q10 10 23 10t23 -10l114 -114q10 -10 10 -23z" />
+    <glyph glyph-name="plus" unicode="&#xf067;" horiz-adv-x="1408" 
+d="M1408 800v-192q0 -40 -28 -68t-68 -28h-416v-416q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v416h-416q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h416v416q0 40 28 68t68 28h192q40 0 68 -28t28 -68v-416h416q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="minus" unicode="&#xf068;" horiz-adv-x="1408" 
+d="M1408 800v-192q0 -40 -28 -68t-68 -28h-1216q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h1216q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="asterisk" unicode="&#xf069;" horiz-adv-x="1664" 
+d="M1482 486q46 -26 59.5 -77.5t-12.5 -97.5l-64 -110q-26 -46 -77.5 -59.5t-97.5 12.5l-266 153v-307q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v307l-266 -153q-46 -26 -97.5 -12.5t-77.5 59.5l-64 110q-26 46 -12.5 97.5t59.5 77.5l266 154l-266 154
+q-46 26 -59.5 77.5t12.5 97.5l64 110q26 46 77.5 59.5t97.5 -12.5l266 -153v307q0 52 38 90t90 38h128q52 0 90 -38t38 -90v-307l266 153q46 26 97.5 12.5t77.5 -59.5l64 -110q26 -46 12.5 -97.5t-59.5 -77.5l-266 -154z" />
+    <glyph glyph-name="exclamation_sign" unicode="&#xf06a;" 
+d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM896 161v190q0 14 -9 23.5t-22 9.5h-192q-13 0 -23 -10t-10 -23v-190q0 -13 10 -23t23 -10h192
+q13 0 22 9.5t9 23.5zM894 505l18 621q0 12 -10 18q-10 8 -24 8h-220q-14 0 -24 -8q-10 -6 -10 -18l17 -621q0 -10 10 -17.5t24 -7.5h185q14 0 23.5 7.5t10.5 17.5z" />
+    <glyph glyph-name="gift" unicode="&#xf06b;" 
+d="M928 180v56v468v192h-320v-192v-468v-56q0 -25 18 -38.5t46 -13.5h192q28 0 46 13.5t18 38.5zM472 1024h195l-126 161q-26 31 -69 31q-40 0 -68 -28t-28 -68t28 -68t68 -28zM1160 1120q0 40 -28 68t-68 28q-43 0 -69 -31l-125 -161h194q40 0 68 28t28 68zM1536 864v-320
+q0 -14 -9 -23t-23 -9h-96v-416q0 -40 -28 -68t-68 -28h-1088q-40 0 -68 28t-28 68v416h-96q-14 0 -23 9t-9 23v320q0 14 9 23t23 9h440q-93 0 -158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5q107 0 168 -77l128 -165l128 165q61 77 168 77q93 0 158.5 -65.5t65.5 -158.5
+t-65.5 -158.5t-158.5 -65.5h440q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="leaf" unicode="&#xf06c;" horiz-adv-x="1792" 
+d="M1280 832q0 26 -19 45t-45 19q-172 0 -318 -49.5t-259.5 -134t-235.5 -219.5q-19 -21 -19 -45q0 -26 19 -45t45 -19q24 0 45 19q27 24 74 71t67 66q137 124 268.5 176t313.5 52q26 0 45 19t19 45zM1792 1030q0 -95 -20 -193q-46 -224 -184.5 -383t-357.5 -268
+q-214 -108 -438 -108q-148 0 -286 47q-15 5 -88 42t-96 37q-16 0 -39.5 -32t-45 -70t-52.5 -70t-60 -32q-43 0 -63.5 17.5t-45.5 59.5q-2 4 -6 11t-5.5 10t-3 9.5t-1.5 13.5q0 35 31 73.5t68 65.5t68 56t31 48q0 4 -14 38t-16 44q-9 51 -9 104q0 115 43.5 220t119 184.5
+t170.5 139t204 95.5q55 18 145 25.5t179.5 9t178.5 6t163.5 24t113.5 56.5l29.5 29.5t29.5 28t27 20t36.5 16t43.5 4.5q39 0 70.5 -46t47.5 -112t24 -124t8 -96z" />
+    <glyph glyph-name="fire" unicode="&#xf06d;" horiz-adv-x="1408" 
+d="M1408 -160v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-1344q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h1344q13 0 22.5 -9.5t9.5 -22.5zM1152 896q0 -78 -24.5 -144t-64 -112.5t-87.5 -88t-96 -77.5t-87.5 -72t-64 -81.5t-24.5 -96.5q0 -96 67 -224l-4 1l1 -1
+q-90 41 -160 83t-138.5 100t-113.5 122.5t-72.5 150.5t-27.5 184q0 78 24.5 144t64 112.5t87.5 88t96 77.5t87.5 72t64 81.5t24.5 96.5q0 94 -66 224l3 -1l-1 1q90 -41 160 -83t138.5 -100t113.5 -122.5t72.5 -150.5t27.5 -184z" />
+    <glyph glyph-name="eye_open" unicode="&#xf06e;" horiz-adv-x="1792" 
+d="M1664 576q-152 236 -381 353q61 -104 61 -225q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 121 61 225q-229 -117 -381 -353q133 -205 333.5 -326.5t434.5 -121.5t434.5 121.5t333.5 326.5zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5
+t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1792 576q0 -34 -20 -69q-140 -230 -376.5 -368.5t-499.5 -138.5t-499.5 139t-376.5 368q-20 35 -20 69t20 69q140 229 376.5 368t499.5 139t499.5 -139t376.5 -368q20 -35 20 -69z" />
+    <glyph glyph-name="eye_close" unicode="&#xf070;" horiz-adv-x="1792" 
+d="M555 201l78 141q-87 63 -136 159t-49 203q0 121 61 225q-229 -117 -381 -353q167 -258 427 -375zM944 960q0 20 -14 34t-34 14q-125 0 -214.5 -89.5t-89.5 -214.5q0 -20 14 -34t34 -14t34 14t14 34q0 86 61 147t147 61q20 0 34 14t14 34zM1307 1151q0 -7 -1 -9
+q-106 -189 -316 -567t-315 -566l-49 -89q-10 -16 -28 -16q-12 0 -134 70q-16 10 -16 28q0 12 44 87q-143 65 -263.5 173t-208.5 245q-20 31 -20 69t20 69q153 235 380 371t496 136q89 0 180 -17l54 97q10 16 28 16q5 0 18 -6t31 -15.5t33 -18.5t31.5 -18.5t19.5 -11.5
+q16 -10 16 -27zM1344 704q0 -139 -79 -253.5t-209 -164.5l280 502q8 -45 8 -84zM1792 576q0 -35 -20 -69q-39 -64 -109 -145q-150 -172 -347.5 -267t-419.5 -95l74 132q212 18 392.5 137t301.5 307q-115 179 -282 294l63 112q95 -64 182.5 -153t144.5 -184q20 -34 20 -69z
+" />
+    <glyph glyph-name="warning_sign" unicode="&#xf071;" horiz-adv-x="1792" 
+d="M1024 161v190q0 14 -9.5 23.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -23.5v-190q0 -14 9.5 -23.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 23.5zM1022 535l18 459q0 12 -10 19q-13 11 -24 11h-220q-11 0 -24 -11q-10 -7 -10 -21l17 -457q0 -10 10 -16.5t24 -6.5h185
+q14 0 23.5 6.5t10.5 16.5zM1008 1469l768 -1408q35 -63 -2 -126q-17 -29 -46.5 -46t-63.5 -17h-1536q-34 0 -63.5 17t-46.5 46q-37 63 -2 126l768 1408q17 31 47 49t65 18t65 -18t47 -49z" />
+    <glyph glyph-name="plane" unicode="&#xf072;" horiz-adv-x="1408" 
+d="M1376 1376q44 -52 12 -148t-108 -172l-161 -161l160 -696q5 -19 -12 -33l-128 -96q-7 -6 -19 -6q-4 0 -7 1q-15 3 -21 16l-279 508l-259 -259l53 -194q5 -17 -8 -31l-96 -96q-9 -9 -23 -9h-2q-15 2 -24 13l-189 252l-252 189q-11 7 -13 23q-1 13 9 25l96 97q9 9 23 9
+q6 0 8 -1l194 -53l259 259l-508 279q-14 8 -17 24q-2 16 9 27l128 128q14 13 30 8l665 -159l160 160q76 76 172 108t148 -12z" />
+    <glyph glyph-name="calendar" unicode="&#xf073;" horiz-adv-x="1664" 
+d="M128 -128h288v288h-288v-288zM480 -128h320v288h-320v-288zM128 224h288v320h-288v-320zM480 224h320v320h-320v-320zM128 608h288v288h-288v-288zM864 -128h320v288h-320v-288zM480 608h320v288h-320v-288zM1248 -128h288v288h-288v-288zM864 224h320v320h-320v-320z
+M512 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1248 224h288v320h-288v-320zM864 608h320v288h-320v-288zM1248 608h288v288h-288v-288zM1280 1088v288q0 13 -9.5 22.5t-22.5 9.5h-64
+q-13 0 -22.5 -9.5t-9.5 -22.5v-288q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47
+h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="random" unicode="&#xf074;" horiz-adv-x="1792" 
+d="M666 1055q-60 -92 -137 -273q-22 45 -37 72.5t-40.5 63.5t-51 56.5t-63 35t-81.5 14.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q250 0 410 -225zM1792 256q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192q-32 0 -85 -0.5t-81 -1t-73 1
+t-71 5t-64 10.5t-63 18.5t-58 28.5t-59 40t-55 53.5t-56 69.5q59 93 136 273q22 -45 37 -72.5t40.5 -63.5t51 -56.5t63 -35t81.5 -14.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1792 1152q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5
+v192h-256q-48 0 -87 -15t-69 -45t-51 -61.5t-45 -77.5q-32 -62 -78 -171q-29 -66 -49.5 -111t-54 -105t-64 -100t-74 -83t-90 -68.5t-106.5 -42t-128 -16.5h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224q48 0 87 15t69 45t51 61.5t45 77.5q32 62 78 171q29 66 49.5 111
+t54 105t64 100t74 83t90 68.5t106.5 42t128 16.5h256v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
+    <glyph glyph-name="comment" unicode="&#xf075;" horiz-adv-x="1792" 
+d="M1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22q-17 -2 -30.5 9t-17.5 29v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281
+q0 130 71 248.5t191 204.5t286 136.5t348 50.5q244 0 450 -85.5t326 -233t120 -321.5z" />
+    <glyph glyph-name="magnet" unicode="&#xf076;" 
+d="M1536 704v-128q0 -201 -98.5 -362t-274 -251.5t-395.5 -90.5t-395.5 90.5t-274 251.5t-98.5 362v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-128q0 -52 23.5 -90t53.5 -57t71 -30t64 -13t44 -2t44 2t64 13t71 30t53.5 57t23.5 90v128q0 26 19 45t45 19h384
+q26 0 45 -19t19 -45zM512 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45zM1536 1344v-384q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h384q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="chevron_up" unicode="&#xf077;" horiz-adv-x="1792" 
+d="M1683 205l-166 -165q-19 -19 -45 -19t-45 19l-531 531l-531 -531q-19 -19 -45 -19t-45 19l-166 165q-19 19 -19 45.5t19 45.5l742 741q19 19 45 19t45 -19l742 -741q19 -19 19 -45.5t-19 -45.5z" />
+    <glyph glyph-name="chevron_down" unicode="&#xf078;" horiz-adv-x="1792" 
+d="M1683 728l-742 -741q-19 -19 -45 -19t-45 19l-742 741q-19 19 -19 45.5t19 45.5l166 165q19 19 45 19t45 -19l531 -531l531 531q19 19 45 19t45 -19l166 -165q19 -19 19 -45.5t-19 -45.5z" />
+    <glyph glyph-name="retweet" unicode="&#xf079;" horiz-adv-x="1920" 
+d="M1280 32q0 -13 -9.5 -22.5t-22.5 -9.5h-960q-8 0 -13.5 2t-9 7t-5.5 8t-3 11.5t-1 11.5v13v11v160v416h-192q-26 0 -45 19t-19 45q0 24 15 41l320 384q19 22 49 22t49 -22l320 -384q15 -17 15 -41q0 -26 -19 -45t-45 -19h-192v-384h576q16 0 25 -11l160 -192q7 -10 7 -21
+zM1920 448q0 -24 -15 -41l-320 -384q-20 -23 -49 -23t-49 23l-320 384q-15 17 -15 41q0 26 19 45t45 19h192v384h-576q-16 0 -25 12l-160 192q-7 9 -7 20q0 13 9.5 22.5t22.5 9.5h960q8 0 13.5 -2t9 -7t5.5 -8t3 -11.5t1 -11.5v-13v-11v-160v-416h192q26 0 45 -19t19 -45z
+" />
+    <glyph glyph-name="shopping_cart" unicode="&#xf07a;" horiz-adv-x="1664" 
+d="M640 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1536 0q0 -52 -38 -90t-90 -38t-90 38t-38 90t38 90t90 38t90 -38t38 -90zM1664 1088v-512q0 -24 -16.5 -42.5t-40.5 -21.5l-1044 -122q13 -60 13 -70q0 -16 -24 -64h920q26 0 45 -19t19 -45
+t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 11 8 31.5t16 36t21.5 40t15.5 29.5l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t19.5 -15.5t13 -24.5t8 -26t5.5 -29.5t4.5 -26h1201q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="folder_close" unicode="&#xf07b;" horiz-adv-x="1664" 
+d="M1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
+    <glyph glyph-name="folder_open" unicode="&#xf07c;" horiz-adv-x="1920" 
+d="M1879 584q0 -31 -31 -66l-336 -396q-43 -51 -120.5 -86.5t-143.5 -35.5h-1088q-34 0 -60.5 13t-26.5 43q0 31 31 66l336 396q43 51 120.5 86.5t143.5 35.5h1088q34 0 60.5 -13t26.5 -43zM1536 928v-160h-832q-94 0 -197 -47.5t-164 -119.5l-337 -396l-5 -6q0 4 -0.5 12.5
+t-0.5 12.5v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158z" />
+    <glyph glyph-name="resize_vertical" unicode="&#xf07d;" horiz-adv-x="768" 
+d="M704 1216q0 -26 -19 -45t-45 -19h-128v-1024h128q26 0 45 -19t19 -45t-19 -45l-256 -256q-19 -19 -45 -19t-45 19l-256 256q-19 19 -19 45t19 45t45 19h128v1024h-128q-26 0 -45 19t-19 45t19 45l256 256q19 19 45 19t45 -19l256 -256q19 -19 19 -45z" />
+    <glyph glyph-name="resize_horizontal" unicode="&#xf07e;" horiz-adv-x="1792" 
+d="M1792 640q0 -26 -19 -45l-256 -256q-19 -19 -45 -19t-45 19t-19 45v128h-1024v-128q0 -26 -19 -45t-45 -19t-45 19l-256 256q-19 19 -19 45t19 45l256 256q19 19 45 19t45 -19t19 -45v-128h1024v128q0 26 19 45t45 19t45 -19l256 -256q19 -19 19 -45z" />
+    <glyph glyph-name="bar_chart" unicode="&#xf080;" horiz-adv-x="2048" 
+d="M640 640v-512h-256v512h256zM1024 1152v-1024h-256v1024h256zM2048 0v-128h-2048v1536h128v-1408h1920zM1408 896v-768h-256v768h256zM1792 1280v-1152h-256v1152h256z" />
+    <glyph glyph-name="twitter_sign" unicode="&#xf081;" 
+d="M1280 926q-56 -25 -121 -34q68 40 93 117q-65 -38 -134 -51q-61 66 -153 66q-87 0 -148.5 -61.5t-61.5 -148.5q0 -29 5 -48q-129 7 -242 65t-192 155q-29 -50 -29 -106q0 -114 91 -175q-47 1 -100 26v-2q0 -75 50 -133.5t123 -72.5q-29 -8 -51 -8q-13 0 -39 4
+q21 -63 74.5 -104t121.5 -42q-116 -90 -261 -90q-26 0 -50 3q148 -94 322 -94q112 0 210 35.5t168 95t120.5 137t75 162t24.5 168.5q0 18 -1 27q63 45 105 109zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5
+t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="facebook_sign" unicode="&#xf082;" 
+d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-188v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-532q-119 0 -203.5 84.5t-84.5 203.5v960
+q0 119 84.5 203.5t203.5 84.5h960z" />
+    <glyph glyph-name="camera_retro" unicode="&#xf083;" horiz-adv-x="1792" 
+d="M928 704q0 14 -9 23t-23 9q-66 0 -113 -47t-47 -113q0 -14 9 -23t23 -9t23 9t9 23q0 40 28 68t68 28q14 0 23 9t9 23zM1152 574q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM128 0h1536v128h-1536v-128zM1280 574q0 159 -112.5 271.5
+t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM256 1216h384v128h-384v-128zM128 1024h1536v118v138h-828l-64 -128h-644v-128zM1792 1280v-1280q0 -53 -37.5 -90.5t-90.5 -37.5h-1536q-53 0 -90.5 37.5t-37.5 90.5v1280
+q0 53 37.5 90.5t90.5 37.5h1536q53 0 90.5 -37.5t37.5 -90.5z" />
+    <glyph glyph-name="key" unicode="&#xf084;" horiz-adv-x="1792" 
+d="M832 1024q0 80 -56 136t-136 56t-136 -56t-56 -136q0 -42 19 -83q-41 19 -83 19q-80 0 -136 -56t-56 -136t56 -136t136 -56t136 56t56 136q0 42 -19 83q41 -19 83 -19q80 0 136 56t56 136zM1683 320q0 -17 -49 -66t-66 -49q-9 0 -28.5 16t-36.5 33t-38.5 40t-24.5 26
+l-96 -96l220 -220q28 -28 28 -68q0 -42 -39 -81t-81 -39q-40 0 -68 28l-671 671q-176 -131 -365 -131q-163 0 -265.5 102.5t-102.5 265.5q0 160 95 313t248 248t313 95q163 0 265.5 -102.5t102.5 -265.5q0 -189 -131 -365l355 -355l96 96q-3 3 -26 24.5t-40 38.5t-33 36.5
+t-16 28.5q0 17 49 66t66 49q13 0 23 -10q6 -6 46 -44.5t82 -79.5t86.5 -86t73 -78t28.5 -41z" />
+    <glyph glyph-name="cogs" unicode="&#xf085;" horiz-adv-x="1920" 
+d="M896 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1664 128q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1152q0 52 -38 90t-90 38t-90 -38t-38 -90q0 -53 37.5 -90.5t90.5 -37.5
+t90.5 37.5t37.5 90.5zM1280 731v-185q0 -10 -7 -19.5t-16 -10.5l-155 -24q-11 -35 -32 -76q34 -48 90 -115q7 -11 7 -20q0 -12 -7 -19q-23 -30 -82.5 -89.5t-78.5 -59.5q-11 0 -21 7l-115 90q-37 -19 -77 -31q-11 -108 -23 -155q-7 -24 -30 -24h-186q-11 0 -20 7.5t-10 17.5
+l-23 153q-34 10 -75 31l-118 -89q-7 -7 -20 -7q-11 0 -21 8q-144 133 -144 160q0 9 7 19q10 14 41 53t47 61q-23 44 -35 82l-152 24q-10 1 -17 9.5t-7 19.5v185q0 10 7 19.5t16 10.5l155 24q11 35 32 76q-34 48 -90 115q-7 11 -7 20q0 12 7 20q22 30 82 89t79 59q11 0 21 -7
+l115 -90q34 18 77 32q11 108 23 154q7 24 30 24h186q11 0 20 -7.5t10 -17.5l23 -153q34 -10 75 -31l118 89q8 7 20 7q11 0 21 -8q144 -133 144 -160q0 -8 -7 -19q-12 -16 -42 -54t-45 -60q23 -48 34 -82l152 -23q10 -2 17 -10.5t7 -19.5zM1920 198v-140q0 -16 -149 -31
+q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20
+t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31zM1920 1222v-140q0 -16 -149 -31q-12 -27 -30 -52q51 -113 51 -138q0 -4 -4 -7q-122 -71 -124 -71q-8 0 -46 47t-52 68
+q-20 -2 -30 -2t-30 2q-14 -21 -52 -68t-46 -47q-2 0 -124 71q-4 3 -4 7q0 25 51 138q-18 25 -30 52q-149 15 -149 31v140q0 16 149 31q13 29 30 52q-51 113 -51 138q0 4 4 7q4 2 35 20t59 34t30 16q8 0 46 -46.5t52 -67.5q20 2 30 2t30 -2q51 71 92 112l6 2q4 0 124 -70
+q4 -3 4 -7q0 -25 -51 -138q17 -23 30 -52q149 -15 149 -31z" />
+    <glyph glyph-name="comments" unicode="&#xf086;" horiz-adv-x="1792" 
+d="M1408 768q0 -139 -94 -257t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224
+q0 139 94 257t256.5 186.5t353.5 68.5t353.5 -68.5t256.5 -186.5t94 -257zM1792 512q0 -120 -71 -224.5t-195 -176.5q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7
+q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230z" />
+    <glyph glyph-name="thumbs_up_alt" unicode="&#xf087;" 
+d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 768q0 51 -39 89.5t-89 38.5h-352q0 58 48 159.5t48 160.5q0 98 -32 145t-128 47q-26 -26 -38 -85t-30.5 -125.5t-59.5 -109.5q-22 -23 -77 -91q-4 -5 -23 -30t-31.5 -41t-34.5 -42.5
+t-40 -44t-38.5 -35.5t-40 -27t-35.5 -9h-32v-640h32q13 0 31.5 -3t33 -6.5t38 -11t35 -11.5t35.5 -12.5t29 -10.5q211 -73 342 -73h121q192 0 192 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5q32 1 53.5 47t21.5 81zM1536 769
+q0 -89 -49 -163q9 -33 9 -69q0 -77 -38 -144q3 -21 3 -43q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5h-36h-93q-96 0 -189.5 22.5t-216.5 65.5q-116 40 -138 40h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h274q36 24 137 155q58 75 107 128
+q24 25 35.5 85.5t30.5 126.5t62 108q39 37 90 37q84 0 151 -32.5t102 -101.5t35 -186q0 -93 -48 -192h176q104 0 180 -76t76 -179z" />
+    <glyph glyph-name="thumbs_down_alt" unicode="&#xf088;" 
+d="M256 1088q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 512q0 35 -21.5 81t-53.5 47q15 17 25 47.5t10 55.5q0 69 -53 119q18 31 18 69q0 37 -17.5 73.5t-47.5 52.5q5 30 5 56q0 85 -49 126t-136 41h-128q-131 0 -342 -73q-5 -2 -29 -10.5
+t-35.5 -12.5t-35 -11.5t-38 -11t-33 -6.5t-31.5 -3h-32v-640h32q16 0 35.5 -9t40 -27t38.5 -35.5t40 -44t34.5 -42.5t31.5 -41t23 -30q55 -68 77 -91q41 -43 59.5 -109.5t30.5 -125.5t38 -85q96 0 128 47t32 145q0 59 -48 160.5t-48 159.5h352q50 0 89 38.5t39 89.5z
+M1536 511q0 -103 -76 -179t-180 -76h-176q48 -99 48 -192q0 -118 -35 -186q-35 -69 -102 -101.5t-151 -32.5q-51 0 -90 37q-34 33 -54 82t-25.5 90.5t-17.5 84.5t-31 64q-48 50 -107 127q-101 131 -137 155h-274q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5
+h288q22 0 138 40q128 44 223 66t200 22h112q140 0 226.5 -79t85.5 -216v-5q60 -77 60 -178q0 -22 -3 -43q38 -67 38 -144q0 -36 -9 -69q49 -73 49 -163z" />
+    <glyph glyph-name="star_half" unicode="&#xf089;" horiz-adv-x="896" 
+d="M832 1504v-1339l-449 -236q-22 -12 -40 -12q-21 0 -31.5 14.5t-10.5 35.5q0 6 2 20l86 500l-364 354q-25 27 -25 48q0 37 56 46l502 73l225 455q19 41 49 41z" />
+    <glyph glyph-name="heart_empty" unicode="&#xf08a;" horiz-adv-x="1792" 
+d="M1664 940q0 81 -21.5 143t-55 98.5t-81.5 59.5t-94 31t-98 8t-112 -25.5t-110.5 -64t-86.5 -72t-60 -61.5q-18 -22 -49 -22t-49 22q-24 28 -60 61.5t-86.5 72t-110.5 64t-112 25.5t-98 -8t-94 -31t-81.5 -59.5t-55 -98.5t-21.5 -143q0 -168 187 -355l581 -560l580 559
+q188 188 188 356zM1792 940q0 -221 -229 -450l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-10 8 -27.5 26t-55.5 65.5t-68 97.5t-53.5 121t-23.5 138q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5
+q224 0 351 -124t127 -344z" />
+    <glyph glyph-name="signout" unicode="&#xf08b;" horiz-adv-x="1664" 
+d="M640 96q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-119 0 -203.5 84.5t-84.5 203.5v704q0 119 84.5 203.5t203.5 84.5h320q13 0 22.5 -9.5t9.5 -22.5q0 -4 1 -20t0.5 -26.5t-3 -23.5t-10 -19.5t-20.5 -6.5h-320q-66 0 -113 -47t-47 -113v-704
+q0 -66 47 -113t113 -47h288h11h13t11.5 -1t11.5 -3t8 -5.5t7 -9t2 -13.5zM1568 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45z" />
+    <glyph glyph-name="linkedin_sign" unicode="&#xf08c;" 
+d="M237 122h231v694h-231v-694zM483 1030q-1 52 -36 86t-93 34t-94.5 -34t-36.5 -86q0 -51 35.5 -85.5t92.5 -34.5h1q59 0 95 34.5t36 85.5zM1068 122h231v398q0 154 -73 233t-193 79q-136 0 -209 -117h2v101h-231q3 -66 0 -694h231v388q0 38 7 56q15 35 45 59.5t74 24.5
+q116 0 116 -157v-371zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="pushpin" unicode="&#xf08d;" horiz-adv-x="1152" 
+d="M480 672v448q0 14 -9 23t-23 9t-23 -9t-9 -23v-448q0 -14 9 -23t23 -9t23 9t9 23zM1152 320q0 -26 -19 -45t-45 -19h-429l-51 -483q-2 -12 -10.5 -20.5t-20.5 -8.5h-1q-27 0 -32 27l-76 485h-404q-26 0 -45 19t-19 45q0 123 78.5 221.5t177.5 98.5v512q-52 0 -90 38
+t-38 90t38 90t90 38h640q52 0 90 -38t38 -90t-38 -90t-90 -38v-512q99 0 177.5 -98.5t78.5 -221.5z" />
+    <glyph glyph-name="external_link" unicode="&#xf08e;" horiz-adv-x="1792" 
+d="M1408 608v-320q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v320
+q0 14 9 23t23 9h64q14 0 23 -9t9 -23zM1792 1472v-512q0 -26 -19 -45t-45 -19t-45 19l-176 176l-652 -652q-10 -10 -23 -10t-23 10l-114 114q-10 10 -10 23t10 23l652 652l-176 176q-19 19 -19 45t19 45t45 19h512q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="signin" unicode="&#xf090;" 
+d="M1184 640q0 -26 -19 -45l-544 -544q-19 -19 -45 -19t-45 19t-19 45v288h-448q-26 0 -45 19t-19 45v384q0 26 19 45t45 19h448v288q0 26 19 45t45 19t45 -19l544 -544q19 -19 19 -45zM1536 992v-704q0 -119 -84.5 -203.5t-203.5 -84.5h-320q-13 0 -22.5 9.5t-9.5 22.5
+q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q66 0 113 47t47 113v704q0 66 -47 113t-113 47h-288h-11h-13t-11.5 1t-11.5 3t-8 5.5t-7 9t-2 13.5q0 4 -1 20t-0.5 26.5t3 23.5t10 19.5t20.5 6.5h320q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="trophy" unicode="&#xf091;" horiz-adv-x="1664" 
+d="M458 653q-74 162 -74 371h-256v-96q0 -78 94.5 -162t235.5 -113zM1536 928v96h-256q0 -209 -74 -371q141 29 235.5 113t94.5 162zM1664 1056v-128q0 -71 -41.5 -143t-112 -130t-173 -97.5t-215.5 -44.5q-42 -54 -95 -95q-38 -34 -52.5 -72.5t-14.5 -89.5q0 -54 30.5 -91
+t97.5 -37q75 0 133.5 -45.5t58.5 -114.5v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 69 58.5 114.5t133.5 45.5q67 0 97.5 37t30.5 91q0 51 -14.5 89.5t-52.5 72.5q-53 41 -95 95q-113 5 -215.5 44.5t-173 97.5t-112 130t-41.5 143v128q0 40 28 68t68 28h288v96
+q0 66 47 113t113 47h576q66 0 113 -47t47 -113v-96h288q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="github_sign" unicode="&#xf092;" 
+d="M519 336q4 6 -3 13q-9 7 -14 2q-4 -6 3 -13q9 -7 14 -2zM491 377q-5 7 -12 4q-6 -4 0 -12q7 -8 12 -5q6 4 0 13zM450 417q2 4 -5 8q-7 2 -8 -2q-3 -5 4 -8q8 -2 9 2zM471 394q2 1 1.5 4.5t-3.5 5.5q-6 7 -10 3t1 -11q6 -6 11 -2zM557 319q2 7 -9 11q-9 3 -13 -4
+q-2 -7 9 -11q9 -3 13 4zM599 316q0 8 -12 8q-10 0 -10 -8t11 -8t11 8zM638 323q-2 7 -13 5t-9 -9q2 -8 12 -6t10 10zM1280 640q0 212 -150 362t-362 150t-362 -150t-150 -362q0 -167 98 -300.5t252 -185.5q18 -3 26.5 5t8.5 20q0 52 -1 95q-6 -1 -15.5 -2.5t-35.5 -2t-48 4
+t-43.5 20t-29.5 41.5q-23 59 -57 74q-2 1 -4.5 3.5l-8 8t-7 9.5t4 7.5t19.5 3.5q6 0 15 -2t30 -15.5t33 -35.5q16 -28 37.5 -42t43.5 -14t38 3.5t30 9.5q7 47 33 69q-49 6 -86 18.5t-73 39t-55.5 76t-19.5 119.5q0 79 53 137q-24 62 5 136q19 6 54.5 -7.5t60.5 -29.5l26 -16
+q58 17 128 17t128 -17q11 7 28.5 18t55.5 26t57 9q29 -74 5 -136q53 -58 53 -137q0 -57 -14 -100.5t-35.5 -70t-53.5 -44.5t-62.5 -26t-68.5 -12q35 -31 35 -95q0 -40 -0.5 -89t-0.5 -51q0 -12 8.5 -20t26.5 -5q154 52 252 185.5t98 300.5zM1536 1120v-960
+q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="upload_alt" unicode="&#xf093;" horiz-adv-x="1664" 
+d="M1280 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 288v-320q0 -40 -28 -68t-68 -28h-1472q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h427q21 -56 70.5 -92
+t110.5 -36h256q61 0 110.5 36t70.5 92h427q40 0 68 -28t28 -68zM1339 936q-17 -40 -59 -40h-256v-448q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v448h-256q-42 0 -59 40q-17 39 14 69l448 448q18 19 45 19t45 -19l448 -448q31 -30 14 -69z" />
+    <glyph glyph-name="lemon" unicode="&#xf094;" 
+d="M1407 710q0 44 -7 113.5t-18 96.5q-12 30 -17 44t-9 36.5t-4 48.5q0 23 5 68.5t5 67.5q0 37 -10 55q-4 1 -13 1q-19 0 -58 -4.5t-59 -4.5q-60 0 -176 24t-175 24q-43 0 -94.5 -11.5t-85 -23.5t-89.5 -34q-137 -54 -202 -103q-96 -73 -159.5 -189.5t-88 -236t-24.5 -248.5
+q0 -40 12.5 -120t12.5 -121q0 -23 -11 -66.5t-11 -65.5t12 -36.5t34 -14.5q24 0 72.5 11t73.5 11q57 0 169.5 -15.5t169.5 -15.5q181 0 284 36q129 45 235.5 152.5t166 245.5t59.5 275zM1535 712q0 -165 -70 -327.5t-196 -288t-281 -180.5q-124 -44 -326 -44
+q-57 0 -170 14.5t-169 14.5q-24 0 -72.5 -14.5t-73.5 -14.5q-73 0 -123.5 55.5t-50.5 128.5q0 24 11 68t11 67q0 40 -12.5 120.5t-12.5 121.5q0 111 18 217.5t54.5 209.5t100.5 194t150 156q78 59 232 120q194 78 316 78q60 0 175.5 -24t173.5 -24q19 0 57 5t58 5
+q81 0 118 -50.5t37 -134.5q0 -23 -5 -68t-5 -68q0 -13 2 -25t3.5 -16.5t7.5 -20.5t8 -20q16 -40 25 -118.5t9 -136.5z" />
+    <glyph glyph-name="phone" unicode="&#xf095;" horiz-adv-x="1408" 
+d="M1408 296q0 -27 -10 -70.5t-21 -68.5q-21 -50 -122 -106q-94 -51 -186 -51q-27 0 -53 3.5t-57.5 12.5t-47 14.5t-55.5 20.5t-49 18q-98 35 -175 83q-127 79 -264 216t-216 264q-48 77 -83 175q-3 9 -18 49t-20.5 55.5t-14.5 47t-12.5 57.5t-3.5 53q0 92 51 186
+q56 101 106 122q25 11 68.5 21t70.5 10q14 0 21 -3q18 -6 53 -76q11 -19 30 -54t35 -63.5t31 -53.5q3 -4 17.5 -25t21.5 -35.5t7 -28.5q0 -20 -28.5 -50t-62 -55t-62 -53t-28.5 -46q0 -9 5 -22.5t8.5 -20.5t14 -24t11.5 -19q76 -137 174 -235t235 -174q2 -1 19 -11.5t24 -14
+t20.5 -8.5t22.5 -5q18 0 46 28.5t53 62t55 62t50 28.5q14 0 28.5 -7t35.5 -21.5t25 -17.5q25 -15 53.5 -31t63.5 -35t54 -30q70 -35 76 -53q3 -7 3 -21z" />
+    <glyph glyph-name="check_empty" unicode="&#xf096;" horiz-adv-x="1408" 
+d="M1120 1280h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113v832q0 66 -47 113t-113 47zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832
+q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="bookmark_empty" unicode="&#xf097;" horiz-adv-x="1280" 
+d="M1152 1280h-1024v-1242l423 406l89 85l89 -85l423 -406v1242zM1164 1408q23 0 44 -9q33 -13 52.5 -41t19.5 -62v-1289q0 -34 -19.5 -62t-52.5 -41q-19 -8 -44 -8q-48 0 -83 32l-441 424l-441 -424q-36 -33 -83 -33q-23 0 -44 9q-33 13 -52.5 41t-19.5 62v1289
+q0 34 19.5 62t52.5 41q21 9 44 9h1048z" />
+    <glyph glyph-name="phone_sign" unicode="&#xf098;" 
+d="M1280 343q0 11 -2 16t-18 16.5t-40.5 25t-47.5 26.5t-45.5 25t-28.5 15q-5 3 -19 13t-25 15t-21 5q-15 0 -36.5 -20.5t-39.5 -45t-38.5 -45t-33.5 -20.5q-7 0 -16.5 3.5t-15.5 6.5t-17 9.5t-14 8.5q-99 55 -170 126.5t-127 170.5q-2 3 -8.5 14t-9.5 17t-6.5 15.5
+t-3.5 16.5q0 13 20.5 33.5t45 38.5t45 39.5t20.5 36.5q0 10 -5 21t-15 25t-13 19q-3 6 -15 28.5t-25 45.5t-26.5 47.5t-25 40.5t-16.5 18t-16 2q-48 0 -101 -22q-46 -21 -80 -94.5t-34 -130.5q0 -16 2.5 -34t5 -30.5t9 -33t10 -29.5t12.5 -33t11 -30q60 -164 216.5 -320.5
+t320.5 -216.5q6 -2 30 -11t33 -12.5t29.5 -10t33 -9t30.5 -5t34 -2.5q57 0 130.5 34t94.5 80q22 53 22 101zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z
+" />
+    <glyph glyph-name="twitter" unicode="&#xf099;" horiz-adv-x="1664" 
+d="M1620 1128q-67 -98 -162 -167q1 -14 1 -42q0 -130 -38 -259.5t-115.5 -248.5t-184.5 -210.5t-258 -146t-323 -54.5q-271 0 -496 145q35 -4 78 -4q225 0 401 138q-105 2 -188 64.5t-114 159.5q33 -5 61 -5q43 0 85 11q-112 23 -185.5 111.5t-73.5 205.5v4q68 -38 146 -41
+q-66 44 -105 115t-39 154q0 88 44 163q121 -149 294.5 -238.5t371.5 -99.5q-8 38 -8 74q0 134 94.5 228.5t228.5 94.5q140 0 236 -102q109 21 205 78q-37 -115 -142 -178q93 10 186 50z" />
+    <glyph glyph-name="facebook" unicode="&#xf09a;" horiz-adv-x="1024" 
+d="M959 1524v-264h-157q-86 0 -116 -36t-30 -108v-189h293l-39 -296h-254v-759h-306v759h-255v296h255v218q0 186 104 288.5t277 102.5q147 0 228 -12z" />
+    <glyph glyph-name="github" unicode="&#xf09b;" 
+d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5q0 -251 -146.5 -451.5t-378.5 -277.5q-27 -5 -40 7t-13 30q0 3 0.5 76.5t0.5 134.5q0 97 -52 142q57 6 102.5 18t94 39t81 66.5t53 105t20.5 150.5q0 119 -79 206q37 91 -8 204q-28 9 -81 -11t-92 -44l-38 -24
+q-93 26 -192 26t-192 -26q-16 11 -42.5 27t-83.5 38.5t-85 13.5q-45 -113 -8 -204q-79 -87 -79 -206q0 -85 20.5 -150t52.5 -105t80.5 -67t94 -39t102.5 -18q-39 -36 -49 -103q-21 -10 -45 -15t-57 -5t-65.5 21.5t-55.5 62.5q-19 32 -48.5 52t-49.5 24l-20 3q-21 0 -29 -4.5
+t-5 -11.5t9 -14t13 -12l7 -5q22 -10 43.5 -38t31.5 -51l10 -23q13 -38 44 -61.5t67 -30t69.5 -7t55.5 3.5l23 4q0 -38 0.5 -88.5t0.5 -54.5q0 -18 -13 -30t-40 -7q-232 77 -378.5 277.5t-146.5 451.5q0 209 103 385.5t279.5 279.5t385.5 103zM291 305q3 7 -7 12
+q-10 3 -13 -2q-3 -7 7 -12q9 -6 13 2zM322 271q7 5 -2 16q-10 9 -16 3q-7 -5 2 -16q10 -10 16 -3zM352 226q9 7 0 19q-8 13 -17 6q-9 -5 0 -18t17 -7zM394 184q8 8 -4 19q-12 12 -20 3q-9 -8 4 -19q12 -12 20 -3zM451 159q3 11 -13 16q-15 4 -19 -7t13 -15q15 -6 19 6z
+M514 154q0 13 -17 11q-16 0 -16 -11q0 -13 17 -11q16 0 16 11zM572 164q-2 11 -18 9q-16 -3 -14 -15t18 -8t14 14z" />
+    <glyph glyph-name="unlock" unicode="&#xf09c;" horiz-adv-x="1664" 
+d="M1664 960v-256q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-192h96q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h672v192q0 185 131.5 316.5t316.5 131.5
+t316.5 -131.5t131.5 -316.5z" />
+    <glyph glyph-name="credit_card" unicode="&#xf09d;" horiz-adv-x="1920" 
+d="M1760 1408q66 0 113 -47t47 -113v-1216q0 -66 -47 -113t-113 -47h-1600q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1600zM160 1280q-13 0 -22.5 -9.5t-9.5 -22.5v-224h1664v224q0 13 -9.5 22.5t-22.5 9.5h-1600zM1760 0q13 0 22.5 9.5t9.5 22.5v608h-1664v-608
+q0 -13 9.5 -22.5t22.5 -9.5h1600zM256 128v128h256v-128h-256zM640 128v128h384v-128h-384z" />
+    <glyph glyph-name="rss" unicode="&#xf09e;" horiz-adv-x="1408" 
+d="M384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 69q2 -28 -17 -48q-18 -21 -47 -21h-135q-25 0 -43 16.5t-20 41.5q-22 229 -184.5 391.5t-391.5 184.5q-25 2 -41.5 20t-16.5 43v135q0 29 21 47q17 17 43 17h5q160 -13 306 -80.5
+t259 -181.5q114 -113 181.5 -259t80.5 -306zM1408 67q2 -27 -18 -47q-18 -20 -46 -20h-143q-26 0 -44.5 17.5t-19.5 42.5q-12 215 -101 408.5t-231.5 336t-336 231.5t-408.5 102q-25 1 -42.5 19.5t-17.5 43.5v143q0 28 20 46q18 18 44 18h3q262 -13 501.5 -120t425.5 -294
+q187 -186 294 -425.5t120 -501.5z" />
+    <glyph glyph-name="hdd" unicode="&#xf0a0;" 
+d="M1040 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1296 320q0 -33 -23.5 -56.5t-56.5 -23.5t-56.5 23.5t-23.5 56.5t23.5 56.5t56.5 23.5t56.5 -23.5t23.5 -56.5zM1408 160v320q0 13 -9.5 22.5t-22.5 9.5
+h-1216q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5zM178 640h1180l-157 482q-4 13 -16 21.5t-26 8.5h-782q-14 0 -26 -8.5t-16 -21.5zM1536 480v-320q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v320q0 25 16 75
+l197 606q17 53 63 86t101 33h782q55 0 101 -33t63 -86l197 -606q16 -50 16 -75z" />
+    <glyph glyph-name="bullhorn" unicode="&#xf0a1;" horiz-adv-x="1792" 
+d="M1664 896q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5v-384q0 -52 -38 -90t-90 -38q-417 347 -812 380q-58 -19 -91 -66t-31 -100.5t40 -92.5q-20 -33 -23 -65.5t6 -58t33.5 -55t48 -50t61.5 -50.5q-29 -58 -111.5 -83t-168.5 -11.5t-132 55.5q-7 23 -29.5 87.5
+t-32 94.5t-23 89t-15 101t3.5 98.5t22 110.5h-122q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h480q435 0 896 384q52 0 90 -38t38 -90v-384zM1536 292v954q-394 -302 -768 -343v-270q377 -42 768 -341z" />
+    <glyph glyph-name="bell" unicode="&#xf0a2;" horiz-adv-x="1792" 
+d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM246 128h1300q-266 300 -266 832q0 51 -24 105t-69 103t-121.5 80.5t-169.5 31.5t-169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -532 -266 -832z
+M1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5
+t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
+    <glyph glyph-name="certificate" unicode="&#xf0a3;" 
+d="M1376 640l138 -135q30 -28 20 -70q-12 -41 -52 -51l-188 -48l53 -186q12 -41 -19 -70q-29 -31 -70 -19l-186 53l-48 -188q-10 -40 -51 -52q-12 -2 -19 -2q-31 0 -51 22l-135 138l-135 -138q-28 -30 -70 -20q-41 11 -51 52l-48 188l-186 -53q-41 -12 -70 19q-31 29 -19 70
+l53 186l-188 48q-40 10 -52 51q-10 42 20 70l138 135l-138 135q-30 28 -20 70q12 41 52 51l188 48l-53 186q-12 41 19 70q29 31 70 19l186 -53l48 188q10 41 51 51q41 12 70 -19l135 -139l135 139q29 30 70 19q41 -10 51 -51l48 -188l186 53q41 12 70 -19q31 -29 19 -70
+l-53 -186l188 -48q40 -10 52 -51q10 -42 -20 -70z" />
+    <glyph glyph-name="hand_right" unicode="&#xf0a4;" horiz-adv-x="1792" 
+d="M256 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1664 768q0 51 -39 89.5t-89 38.5h-576q0 20 15 48.5t33 55t33 68t15 84.5q0 67 -44.5 97.5t-115.5 30.5q-24 0 -90 -139q-24 -44 -37 -65q-40 -64 -112 -145q-71 -81 -101 -106
+q-69 -57 -140 -57h-32v-640h32q72 0 167 -32t193.5 -64t179.5 -32q189 0 189 167q0 26 -5 56q30 16 47.5 52.5t17.5 73.5t-18 69q53 50 53 119q0 25 -10 55.5t-25 47.5h331q52 0 90 38t38 90zM1792 769q0 -105 -75.5 -181t-180.5 -76h-169q-4 -62 -37 -119q3 -21 3 -43
+q0 -101 -60 -178q1 -139 -85 -219.5t-227 -80.5q-133 0 -322 69q-164 59 -223 59h-288q-53 0 -90.5 37.5t-37.5 90.5v640q0 53 37.5 90.5t90.5 37.5h288q10 0 21.5 4.5t23.5 14t22.5 18t24 22.5t20.5 21.5t19 21.5t14 17q65 74 100 129q13 21 33 62t37 72t40.5 63t55 49.5
+t69.5 17.5q125 0 206.5 -67t81.5 -189q0 -68 -22 -128h374q104 0 180 -76t76 -179z" />
+    <glyph glyph-name="hand_left" unicode="&#xf0a5;" horiz-adv-x="1792" 
+d="M1376 128h32v640h-32q-35 0 -67.5 12t-62.5 37t-50 46t-49 54q-8 9 -12 14q-72 81 -112 145q-14 22 -38 68q-1 3 -10.5 22.5t-18.5 36t-20 35.5t-21.5 30.5t-18.5 11.5q-71 0 -115.5 -30.5t-44.5 -97.5q0 -43 15 -84.5t33 -68t33 -55t15 -48.5h-576q-50 0 -89 -38.5
+t-39 -89.5q0 -52 38 -90t90 -38h331q-15 -17 -25 -47.5t-10 -55.5q0 -69 53 -119q-18 -32 -18 -69t17.5 -73.5t47.5 -52.5q-4 -24 -4 -56q0 -85 48.5 -126t135.5 -41q84 0 183 32t194 64t167 32zM1664 192q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45z
+M1792 768v-640q0 -53 -37.5 -90.5t-90.5 -37.5h-288q-59 0 -223 -59q-190 -69 -317 -69q-142 0 -230 77.5t-87 217.5l1 5q-61 76 -61 178q0 22 3 43q-33 57 -37 119h-169q-105 0 -180.5 76t-75.5 181q0 103 76 179t180 76h374q-22 60 -22 128q0 122 81.5 189t206.5 67
+q38 0 69.5 -17.5t55 -49.5t40.5 -63t37 -72t33 -62q35 -55 100 -129q2 -3 14 -17t19 -21.5t20.5 -21.5t24 -22.5t22.5 -18t23.5 -14t21.5 -4.5h288q53 0 90.5 -37.5t37.5 -90.5z" />
+    <glyph glyph-name="hand_up" unicode="&#xf0a6;" 
+d="M1280 -64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 700q0 189 -167 189q-26 0 -56 -5q-16 30 -52.5 47.5t-73.5 17.5t-69 -18q-50 53 -119 53q-25 0 -55.5 -10t-47.5 -25v331q0 52 -38 90t-90 38q-51 0 -89.5 -39t-38.5 -89v-576
+q-20 0 -48.5 15t-55 33t-68 33t-84.5 15q-67 0 -97.5 -44.5t-30.5 -115.5q0 -24 139 -90q44 -24 65 -37q64 -40 145 -112q81 -71 106 -101q57 -69 57 -140v-32h640v32q0 72 32 167t64 193.5t32 179.5zM1536 705q0 -133 -69 -322q-59 -164 -59 -223v-288q0 -53 -37.5 -90.5
+t-90.5 -37.5h-640q-53 0 -90.5 37.5t-37.5 90.5v288q0 10 -4.5 21.5t-14 23.5t-18 22.5t-22.5 24t-21.5 20.5t-21.5 19t-17 14q-74 65 -129 100q-21 13 -62 33t-72 37t-63 40.5t-49.5 55t-17.5 69.5q0 125 67 206.5t189 81.5q68 0 128 -22v374q0 104 76 180t179 76
+q105 0 181 -75.5t76 -180.5v-169q62 -4 119 -37q21 3 43 3q101 0 178 -60q139 1 219.5 -85t80.5 -227z" />
+    <glyph glyph-name="hand_down" unicode="&#xf0a7;" 
+d="M1408 576q0 84 -32 183t-64 194t-32 167v32h-640v-32q0 -35 -12 -67.5t-37 -62.5t-46 -50t-54 -49q-9 -8 -14 -12q-81 -72 -145 -112q-22 -14 -68 -38q-3 -1 -22.5 -10.5t-36 -18.5t-35.5 -20t-30.5 -21.5t-11.5 -18.5q0 -71 30.5 -115.5t97.5 -44.5q43 0 84.5 15t68 33
+t55 33t48.5 15v-576q0 -50 38.5 -89t89.5 -39q52 0 90 38t38 90v331q46 -35 103 -35q69 0 119 53q32 -18 69 -18t73.5 17.5t52.5 47.5q24 -4 56 -4q85 0 126 48.5t41 135.5zM1280 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1536 580
+q0 -142 -77.5 -230t-217.5 -87l-5 1q-76 -61 -178 -61q-22 0 -43 3q-54 -30 -119 -37v-169q0 -105 -76 -180.5t-181 -75.5q-103 0 -179 76t-76 180v374q-54 -22 -128 -22q-121 0 -188.5 81.5t-67.5 206.5q0 38 17.5 69.5t49.5 55t63 40.5t72 37t62 33q55 35 129 100
+q3 2 17 14t21.5 19t21.5 20.5t22.5 24t18 22.5t14 23.5t4.5 21.5v288q0 53 37.5 90.5t90.5 37.5h640q53 0 90.5 -37.5t37.5 -90.5v-288q0 -59 59 -223q69 -190 69 -317z" />
+    <glyph glyph-name="circle_arrow_left" unicode="&#xf0a8;" 
+d="M1280 576v128q0 26 -19 45t-45 19h-502l189 189q19 19 19 45t-19 45l-91 91q-18 18 -45 18t-45 -18l-362 -362l-91 -91q-18 -18 -18 -45t18 -45l91 -91l362 -362q18 -18 45 -18t45 18l91 91q18 18 18 45t-18 45l-189 189h502q26 0 45 19t19 45zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="circle_arrow_right" unicode="&#xf0a9;" 
+d="M1285 640q0 27 -18 45l-91 91l-362 362q-18 18 -45 18t-45 -18l-91 -91q-18 -18 -18 -45t18 -45l189 -189h-502q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h502l-189 -189q-19 -19 -19 -45t19 -45l91 -91q18 -18 45 -18t45 18l362 362l91 91q18 18 18 45zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="circle_arrow_up" unicode="&#xf0aa;" 
+d="M1284 641q0 27 -18 45l-362 362l-91 91q-18 18 -45 18t-45 -18l-91 -91l-362 -362q-18 -18 -18 -45t18 -45l91 -91q18 -18 45 -18t45 18l189 189v-502q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v502l189 -189q19 -19 45 -19t45 19l91 91q18 18 18 45zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="circle_arrow_down" unicode="&#xf0ab;" 
+d="M1284 639q0 27 -18 45l-91 91q-18 18 -45 18t-45 -18l-189 -189v502q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-502l-189 189q-19 19 -45 19t-45 -19l-91 -91q-18 -18 -18 -45t18 -45l362 -362l91 -91q18 -18 45 -18t45 18l91 91l362 362q18 18 18 45zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="globe" unicode="&#xf0ac;" 
+d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1042 887q-2 -1 -9.5 -9.5t-13.5 -9.5q2 0 4.5 5t5 11t3.5 7q6 7 22 15q14 6 52 12q34 8 51 -11
+q-2 2 9.5 13t14.5 12q3 2 15 4.5t15 7.5l2 22q-12 -1 -17.5 7t-6.5 21q0 -2 -6 -8q0 7 -4.5 8t-11.5 -1t-9 -1q-10 3 -15 7.5t-8 16.5t-4 15q-2 5 -9.5 11t-9.5 10q-1 2 -2.5 5.5t-3 6.5t-4 5.5t-5.5 2.5t-7 -5t-7.5 -10t-4.5 -5q-3 2 -6 1.5t-4.5 -1t-4.5 -3t-5 -3.5
+q-3 -2 -8.5 -3t-8.5 -2q15 5 -1 11q-10 4 -16 3q9 4 7.5 12t-8.5 14h5q-1 4 -8.5 8.5t-17.5 8.5t-13 6q-8 5 -34 9.5t-33 0.5q-5 -6 -4.5 -10.5t4 -14t3.5 -12.5q1 -6 -5.5 -13t-6.5 -12q0 -7 14 -15.5t10 -21.5q-3 -8 -16 -16t-16 -12q-5 -8 -1.5 -18.5t10.5 -16.5
+q2 -2 1.5 -4t-3.5 -4.5t-5.5 -4t-6.5 -3.5l-3 -2q-11 -5 -20.5 6t-13.5 26q-7 25 -16 30q-23 8 -29 -1q-5 13 -41 26q-25 9 -58 4q6 1 0 15q-7 15 -19 12q3 6 4 17.5t1 13.5q3 13 12 23q1 1 7 8.5t9.5 13.5t0.5 6q35 -4 50 11q5 5 11.5 17t10.5 17q9 6 14 5.5t14.5 -5.5
+t14.5 -5q14 -1 15.5 11t-7.5 20q12 -1 3 17q-4 7 -8 9q-12 4 -27 -5q-8 -4 2 -8q-1 1 -9.5 -10.5t-16.5 -17.5t-16 5q-1 1 -5.5 13.5t-9.5 13.5q-8 0 -16 -15q3 8 -11 15t-24 8q19 12 -8 27q-7 4 -20.5 5t-19.5 -4q-5 -7 -5.5 -11.5t5 -8t10.5 -5.5t11.5 -4t8.5 -3
+q14 -10 8 -14q-2 -1 -8.5 -3.5t-11.5 -4.5t-6 -4q-3 -4 0 -14t-2 -14q-5 5 -9 17.5t-7 16.5q7 -9 -25 -6l-10 1q-4 0 -16 -2t-20.5 -1t-13.5 8q-4 8 0 20q1 4 4 2q-4 3 -11 9.5t-10 8.5q-46 -15 -94 -41q6 -1 12 1q5 2 13 6.5t10 5.5q34 14 42 7l5 5q14 -16 20 -25
+q-7 4 -30 1q-20 -6 -22 -12q7 -12 5 -18q-4 3 -11.5 10t-14.5 11t-15 5q-16 0 -22 -1q-146 -80 -235 -222q7 -7 12 -8q4 -1 5 -9t2.5 -11t11.5 3q9 -8 3 -19q1 1 44 -27q19 -17 21 -21q3 -11 -10 -18q-1 2 -9 9t-9 4q-3 -5 0.5 -18.5t10.5 -12.5q-7 0 -9.5 -16t-2.5 -35.5
+t-1 -23.5l2 -1q-3 -12 5.5 -34.5t21.5 -19.5q-13 -3 20 -43q6 -8 8 -9q3 -2 12 -7.5t15 -10t10 -10.5q4 -5 10 -22.5t14 -23.5q-2 -6 9.5 -20t10.5 -23q-1 0 -2.5 -1t-2.5 -1q3 -7 15.5 -14t15.5 -13q1 -3 2 -10t3 -11t8 -2q2 20 -24 62q-15 25 -17 29q-3 5 -5.5 15.5
+t-4.5 14.5q2 0 6 -1.5t8.5 -3.5t7.5 -4t2 -3q-3 -7 2 -17.5t12 -18.5t17 -19t12 -13q6 -6 14 -19.5t0 -13.5q9 0 20 -10.5t17 -19.5q5 -8 8 -26t5 -24q2 -7 8.5 -13.5t12.5 -9.5l16 -8t13 -7q5 -2 18.5 -10.5t21.5 -11.5q10 -4 16 -4t14.5 2.5t13.5 3.5q15 2 29 -15t21 -21
+q36 -19 55 -11q-2 -1 0.5 -7.5t8 -15.5t9 -14.5t5.5 -8.5q5 -6 18 -15t18 -15q6 4 7 9q-3 -8 7 -20t18 -10q14 3 14 32q-31 -15 -49 18q0 1 -2.5 5.5t-4 8.5t-2.5 8.5t0 7.5t5 3q9 0 10 3.5t-2 12.5t-4 13q-1 8 -11 20t-12 15q-5 -9 -16 -8t-16 9q0 -1 -1.5 -5.5t-1.5 -6.5
+q-13 0 -15 1q1 3 2.5 17.5t3.5 22.5q1 4 5.5 12t7.5 14.5t4 12.5t-4.5 9.5t-17.5 2.5q-19 -1 -26 -20q-1 -3 -3 -10.5t-5 -11.5t-9 -7q-7 -3 -24 -2t-24 5q-13 8 -22.5 29t-9.5 37q0 10 2.5 26.5t3 25t-5.5 24.5q3 2 9 9.5t10 10.5q2 1 4.5 1.5t4.5 0t4 1.5t3 6q-1 1 -4 3
+q-3 3 -4 3q7 -3 28.5 1.5t27.5 -1.5q15 -11 22 2q0 1 -2.5 9.5t-0.5 13.5q5 -27 29 -9q3 -3 15.5 -5t17.5 -5q3 -2 7 -5.5t5.5 -4.5t5 0.5t8.5 6.5q10 -14 12 -24q11 -40 19 -44q7 -3 11 -2t4.5 9.5t0 14t-1.5 12.5l-1 8v18l-1 8q-15 3 -18.5 12t1.5 18.5t15 18.5q1 1 8 3.5
+t15.5 6.5t12.5 8q21 19 15 35q7 0 11 9q-1 0 -5 3t-7.5 5t-4.5 2q9 5 2 16q5 3 7.5 11t7.5 10q9 -12 21 -2q8 8 1 16q5 7 20.5 10.5t18.5 9.5q7 -2 8 2t1 12t3 12q4 5 15 9t13 5l17 11q3 4 0 4q18 -2 31 11q10 11 -6 20q3 6 -3 9.5t-15 5.5q3 1 11.5 0.5t10.5 1.5
+q15 10 -7 16q-17 5 -43 -12zM879 10q206 36 351 189q-3 3 -12.5 4.5t-12.5 3.5q-18 7 -24 8q1 7 -2.5 13t-8 9t-12.5 8t-11 7q-2 2 -7 6t-7 5.5t-7.5 4.5t-8.5 2t-10 -1l-3 -1q-3 -1 -5.5 -2.5t-5.5 -3t-4 -3t0 -2.5q-21 17 -36 22q-5 1 -11 5.5t-10.5 7t-10 1.5t-11.5 -7
+q-5 -5 -6 -15t-2 -13q-7 5 0 17.5t2 18.5q-3 6 -10.5 4.5t-12 -4.5t-11.5 -8.5t-9 -6.5t-8.5 -5.5t-8.5 -7.5q-3 -4 -6 -12t-5 -11q-2 4 -11.5 6.5t-9.5 5.5q2 -10 4 -35t5 -38q7 -31 -12 -48q-27 -25 -29 -40q-4 -22 12 -26q0 -7 -8 -20.5t-7 -21.5q0 -6 2 -16z" />
+    <glyph glyph-name="wrench" unicode="&#xf0ad;" horiz-adv-x="1664" 
+d="M384 64q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1028 484l-682 -682q-37 -37 -90 -37q-52 0 -91 37l-106 108q-38 36 -38 90q0 53 38 91l681 681q39 -98 114.5 -173.5t173.5 -114.5zM1662 919q0 -39 -23 -106q-47 -134 -164.5 -217.5
+t-258.5 -83.5q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q58 0 121.5 -16.5t107.5 -46.5q16 -11 16 -28t-16 -28l-293 -169v-224l193 -107q5 3 79 48.5t135.5 81t70.5 35.5q15 0 23.5 -10t8.5 -25z" />
+    <glyph glyph-name="tasks" unicode="&#xf0ae;" horiz-adv-x="1792" 
+d="M1024 128h640v128h-640v-128zM640 640h1024v128h-1024v-128zM1280 1152h384v128h-384v-128zM1792 320v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 832v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19
+t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45zM1792 1344v-256q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1664q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="filter" unicode="&#xf0b0;" horiz-adv-x="1408" 
+d="M1403 1241q17 -41 -14 -70l-493 -493v-742q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-256 256q-19 19 -19 45v486l-493 493q-31 29 -14 70q17 39 59 39h1280q42 0 59 -39z" />
+    <glyph glyph-name="briefcase" unicode="&#xf0b1;" horiz-adv-x="1792" 
+d="M640 1280h512v128h-512v-128zM1792 640v-480q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v480h672v-160q0 -26 19 -45t45 -19h320q26 0 45 19t19 45v160h672zM1024 640v-128h-256v128h256zM1792 1120v-384h-1792v384q0 66 47 113t113 47h352v160q0 40 28 68
+t68 28h576q40 0 68 -28t28 -68v-160h352q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="fullscreen" unicode="&#xf0b2;" 
+d="M1283 995l-355 -355l355 -355l144 144q29 31 70 14q39 -17 39 -59v-448q0 -26 -19 -45t-45 -19h-448q-42 0 -59 40q-17 39 14 69l144 144l-355 355l-355 -355l144 -144q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l144 -144
+l355 355l-355 355l-144 -144q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v448q0 26 19 45t45 19h448q42 0 59 -40q17 -39 -14 -69l-144 -144l355 -355l355 355l-144 144q-31 30 -14 69q17 40 59 40h448q26 0 45 -19t19 -45v-448q0 -42 -39 -59q-13 -5 -25 -5q-26 0 -45 19z
+" />
+    <glyph glyph-name="group" unicode="&#xf0c0;" horiz-adv-x="1920" 
+d="M593 640q-162 -5 -265 -128h-134q-82 0 -138 40.5t-56 118.5q0 353 124 353q6 0 43.5 -21t97.5 -42.5t119 -21.5q67 0 133 23q-5 -37 -5 -66q0 -139 81 -256zM1664 3q0 -120 -73 -189.5t-194 -69.5h-874q-121 0 -194 69.5t-73 189.5q0 53 3.5 103.5t14 109t26.5 108.5
+t43 97.5t62 81t85.5 53.5t111.5 20q10 0 43 -21.5t73 -48t107 -48t135 -21.5t135 21.5t107 48t73 48t43 21.5q61 0 111.5 -20t85.5 -53.5t62 -81t43 -97.5t26.5 -108.5t14 -109t3.5 -103.5zM640 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75
+t75 -181zM1344 896q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5zM1920 671q0 -78 -56 -118.5t-138 -40.5h-134q-103 123 -265 128q81 117 81 256q0 29 -5 66q66 -23 133 -23q59 0 119 21.5t97.5 42.5
+t43.5 21q124 0 124 -353zM1792 1280q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181z" />
+    <glyph glyph-name="link" unicode="&#xf0c1;" horiz-adv-x="1664" 
+d="M1456 320q0 40 -28 68l-208 208q-28 28 -68 28q-42 0 -72 -32q3 -3 19 -18.5t21.5 -21.5t15 -19t13 -25.5t3.5 -27.5q0 -40 -28 -68t-68 -28q-15 0 -27.5 3.5t-25.5 13t-19 15t-21.5 21.5t-18.5 19q-33 -31 -33 -73q0 -40 28 -68l206 -207q27 -27 68 -27q40 0 68 26
+l147 146q28 28 28 67zM753 1025q0 40 -28 68l-206 207q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l208 -208q27 -27 68 -27q42 0 72 31q-3 3 -19 18.5t-21.5 21.5t-15 19t-13 25.5t-3.5 27.5q0 40 28 68t68 28q15 0 27.5 -3.5t25.5 -13t19 -15
+t21.5 -21.5t18.5 -19q33 31 33 73zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-206 207q-83 83 -83 203q0 123 88 209l-88 88q-86 -88 -208 -88q-120 0 -204 84l-208 208q-84 84 -84 204t85 203l147 146q83 83 203 83q121 0 204 -85l206 -207
+q83 -83 83 -203q0 -123 -88 -209l88 -88q86 88 208 88q120 0 204 -84l208 -208q84 -84 84 -204z" />
+    <glyph glyph-name="cloud" unicode="&#xf0c2;" horiz-adv-x="1920" 
+d="M1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088q-185 0 -316.5 131.5t-131.5 316.5q0 132 71 241.5t187 163.5q-2 28 -2 43q0 212 150 362t362 150q158 0 286.5 -88t187.5 -230q70 62 166 62q106 0 181 -75t75 -181q0 -75 -41 -138q129 -30 213 -134.5t84 -239.5z
+" />
+    <glyph glyph-name="beaker" unicode="&#xf0c3;" horiz-adv-x="1664" 
+d="M1527 88q56 -89 21.5 -152.5t-140.5 -63.5h-1152q-106 0 -140.5 63.5t21.5 152.5l503 793v399h-64q-26 0 -45 19t-19 45t19 45t45 19h512q26 0 45 -19t19 -45t-19 -45t-45 -19h-64v-399zM748 813l-272 -429h712l-272 429l-20 31v37v399h-128v-399v-37z" />
+    <glyph glyph-name="cut" unicode="&#xf0c4;" horiz-adv-x="1792" 
+d="M960 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1260 576l507 -398q28 -20 25 -56q-5 -35 -35 -51l-128 -64q-13 -7 -29 -7q-17 0 -31 8l-690 387l-110 -66q-8 -4 -12 -5q14 -49 10 -97q-7 -77 -56 -147.5t-132 -123.5q-132 -84 -277 -84
+q-136 0 -222 78q-90 84 -79 207q7 76 56 147t131 124q132 84 278 84q83 0 151 -31q9 13 22 22l122 73l-122 73q-13 9 -22 22q-68 -31 -151 -31q-146 0 -278 84q-82 53 -131 124t-56 147q-5 59 15.5 113t63.5 93q85 79 222 79q145 0 277 -84q83 -52 132 -123t56 -148
+q4 -48 -10 -97q4 -1 12 -5l110 -66l690 387q14 8 31 8q16 0 29 -7l128 -64q30 -16 35 -51q3 -36 -25 -56zM579 836q46 42 21 108t-106 117q-92 59 -192 59q-74 0 -113 -36q-46 -42 -21 -108t106 -117q92 -59 192 -59q74 0 113 36zM494 91q81 51 106 117t-21 108
+q-39 36 -113 36q-100 0 -192 -59q-81 -51 -106 -117t21 -108q39 -36 113 -36q100 0 192 59zM672 704l96 -58v11q0 36 33 56l14 8l-79 47l-26 -26q-3 -3 -10 -11t-12 -12q-2 -2 -4 -3.5t-3 -2.5zM896 480l96 -32l736 576l-128 64l-768 -431v-113l-160 -96l9 -8q2 -2 7 -6
+q4 -4 11 -12t11 -12l26 -26zM1600 64l128 64l-520 408l-177 -138q-2 -3 -13 -7z" />
+    <glyph glyph-name="copy" unicode="&#xf0c5;" horiz-adv-x="1792" 
+d="M1696 1152q40 0 68 -28t28 -68v-1216q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v288h-544q-40 0 -68 28t-28 68v672q0 40 20 88t48 76l408 408q28 28 76 48t88 20h416q40 0 68 -28t28 -68v-328q68 40 128 40h416zM1152 939l-299 -299h299v299zM512 1323l-299 -299
+h299v299zM708 676l316 316v416h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h512v256q0 40 20 88t48 76zM1664 -128v1152h-384v-416q0 -40 -28 -68t-68 -28h-416v-640h896z" />
+    <glyph glyph-name="paper_clip" unicode="&#xf0c6;" horiz-adv-x="1408" 
+d="M1404 151q0 -117 -79 -196t-196 -79q-135 0 -235 100l-777 776q-113 115 -113 271q0 159 110 270t269 111q158 0 273 -113l605 -606q10 -10 10 -22q0 -16 -30.5 -46.5t-46.5 -30.5q-13 0 -23 10l-606 607q-79 77 -181 77q-106 0 -179 -75t-73 -181q0 -105 76 -181
+l776 -777q63 -63 145 -63q64 0 106 42t42 106q0 82 -63 145l-581 581q-26 24 -60 24q-29 0 -48 -19t-19 -48q0 -32 25 -59l410 -410q10 -10 10 -22q0 -16 -31 -47t-47 -31q-12 0 -22 10l-410 410q-63 61 -63 149q0 82 57 139t139 57q88 0 149 -63l581 -581q100 -98 100 -235
+z" />
+    <glyph glyph-name="save" unicode="&#xf0c7;" 
+d="M384 0h768v384h-768v-384zM1280 0h128v896q0 14 -10 38.5t-20 34.5l-281 281q-10 10 -34 20t-39 10v-416q0 -40 -28 -68t-68 -28h-576q-40 0 -68 28t-28 68v416h-128v-1280h128v416q0 40 28 68t68 28h832q40 0 68 -28t28 -68v-416zM896 928v320q0 13 -9.5 22.5t-22.5 9.5
+h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5zM1536 896v-928q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h928q40 0 88 -20t76 -48l280 -280q28 -28 48 -76t20 -88z" />
+    <glyph glyph-name="sign_blank" unicode="&#xf0c8;" 
+d="M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="reorder" unicode="&#xf0c9;" 
+d="M1536 192v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 704v-128q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1536 1216v-128q0 -26 -19 -45
+t-45 -19h-1408q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="ul" unicode="&#xf0ca;" horiz-adv-x="1792" 
+d="M384 128q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 640q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 224v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5
+t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1152q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z
+M1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
+    <glyph glyph-name="ol" unicode="&#xf0cb;" horiz-adv-x="1792" 
+d="M381 -84q0 -80 -54.5 -126t-135.5 -46q-106 0 -172 66l57 88q49 -45 106 -45q29 0 50.5 14.5t21.5 42.5q0 64 -105 56l-26 56q8 10 32.5 43.5t42.5 54t37 38.5v1q-16 0 -48.5 -1t-48.5 -1v-53h-106v152h333v-88l-95 -115q51 -12 81 -49t30 -88zM383 543v-159h-362
+q-6 36 -6 54q0 51 23.5 93t56.5 68t66 47.5t56.5 43.5t23.5 45q0 25 -14.5 38.5t-39.5 13.5q-46 0 -81 -58l-85 59q24 51 71.5 79.5t105.5 28.5q73 0 123 -41.5t50 -112.5q0 -50 -34 -91.5t-75 -64.5t-75.5 -50.5t-35.5 -52.5h127v60h105zM1792 224v-192q0 -13 -9.5 -22.5
+t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM384 1123v-99h-335v99h107q0 41 0.5 121.5t0.5 121.5v12h-2q-8 -17 -50 -54l-71 76l136 127h106v-404h108zM1792 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216
+q-13 0 -22.5 9.5t-9.5 22.5v192q0 14 9 23t23 9h1216q13 0 22.5 -9.5t9.5 -22.5zM1792 1248v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1216q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1216q13 0 22.5 -9.5t9.5 -22.5z" />
+    <glyph glyph-name="strikethrough" unicode="&#xf0cc;" horiz-adv-x="1792" 
+d="M1760 640q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h1728zM483 704q-28 35 -51 80q-48 98 -48 188q0 181 134 309q133 127 393 127q50 0 167 -19q66 -12 177 -48q10 -38 21 -118q14 -123 14 -183q0 -18 -5 -45l-12 -3l-84 6
+l-14 2q-50 149 -103 205q-88 91 -210 91q-114 0 -182 -59q-67 -58 -67 -146q0 -73 66 -140t279 -129q69 -20 173 -66q58 -28 95 -52h-743zM990 448h411q7 -39 7 -92q0 -111 -41 -212q-23 -56 -71 -104q-37 -35 -109 -81q-80 -48 -153 -66q-80 -21 -203 -21q-114 0 -195 23
+l-140 40q-57 16 -72 28q-8 8 -8 22v13q0 108 -2 156q-1 30 0 68l2 37v44l102 2q15 -34 30 -71t22.5 -56t12.5 -27q35 -57 80 -94q43 -36 105 -57q59 -22 132 -22q64 0 139 27q77 26 122 86q47 61 47 129q0 84 -81 157q-34 29 -137 71z" />
+    <glyph glyph-name="underline" unicode="&#xf0cd;" 
+d="M48 1313q-37 2 -45 4l-3 88q13 1 40 1q60 0 112 -4q132 -7 166 -7q86 0 168 3q116 4 146 5q56 0 86 2l-1 -14l2 -64v-9q-60 -9 -124 -9q-60 0 -79 -25q-13 -14 -13 -132q0 -13 0.5 -32.5t0.5 -25.5l1 -229l14 -280q6 -124 51 -202q35 -59 96 -92q88 -47 177 -47
+q104 0 191 28q56 18 99 51q48 36 65 64q36 56 53 114q21 73 21 229q0 79 -3.5 128t-11 122.5t-13.5 159.5l-4 59q-5 67 -24 88q-34 35 -77 34l-100 -2l-14 3l2 86h84l205 -10q76 -3 196 10l18 -2q6 -38 6 -51q0 -7 -4 -31q-45 -12 -84 -13q-73 -11 -79 -17q-15 -15 -15 -41
+q0 -7 1.5 -27t1.5 -31q8 -19 22 -396q6 -195 -15 -304q-15 -76 -41 -122q-38 -65 -112 -123q-75 -57 -182 -89q-109 -33 -255 -33q-167 0 -284 46q-119 47 -179 122q-61 76 -83 195q-16 80 -16 237v333q0 188 -17 213q-25 36 -147 39zM1536 -96v64q0 14 -9 23t-23 9h-1472
+q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h1472q14 0 23 9t9 23z" />
+    <glyph glyph-name="table" unicode="&#xf0ce;" horiz-adv-x="1664" 
+d="M512 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 160v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23
+v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM512 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 160v192
+q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1024 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 544v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192
+q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1536 928v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1664 1248v-1088q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1344q66 0 113 -47t47 -113
+z" />
+    <glyph glyph-name="magic" unicode="&#xf0d0;" horiz-adv-x="1664" 
+d="M1190 955l293 293l-107 107l-293 -293zM1637 1248q0 -27 -18 -45l-1286 -1286q-18 -18 -45 -18t-45 18l-198 198q-18 18 -18 45t18 45l1286 1286q18 18 45 18t45 -18l198 -198q18 -18 18 -45zM286 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM636 1276
+l196 -60l-196 -60l-60 -196l-60 196l-196 60l196 60l60 196zM1566 798l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98zM926 1438l98 -30l-98 -30l-30 -98l-30 98l-98 30l98 30l30 98z" />
+    <glyph glyph-name="truck" unicode="&#xf0d1;" horiz-adv-x="1792" 
+d="M640 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM256 640h384v256h-158q-13 0 -22 -9l-195 -195q-9 -9 -9 -22v-30zM1536 128q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1792 1216v-1024q0 -15 -4 -26.5t-13.5 -18.5
+t-16.5 -11.5t-23.5 -6t-22.5 -2t-25.5 0t-22.5 0.5q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-64q-3 0 -22.5 -0.5t-25.5 0t-22.5 2t-23.5 6t-16.5 11.5t-13.5 18.5t-4 26.5q0 26 19 45t45 19v320q0 8 -0.5 35t0 38
+t2.5 34.5t6.5 37t14 30.5t22.5 30l198 198q19 19 50.5 32t58.5 13h160v192q0 26 19 45t45 19h1024q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="pinterest" unicode="&#xf0d2;" 
+d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103q-111 0 -218 32q59 93 78 164q9 34 54 211q20 -39 73 -67.5t114 -28.5q121 0 216 68.5t147 188.5t52 270q0 114 -59.5 214t-172.5 163t-255 63q-105 0 -196 -29t-154.5 -77t-109 -110.5t-67 -129.5t-21.5 -134
+q0 -104 40 -183t117 -111q30 -12 38 20q2 7 8 31t8 30q6 23 -11 43q-51 61 -51 151q0 151 104.5 259.5t273.5 108.5q151 0 235.5 -82t84.5 -213q0 -170 -68.5 -289t-175.5 -119q-61 0 -98 43.5t-23 104.5q8 35 26.5 93.5t30 103t11.5 75.5q0 50 -27 83t-77 33
+q-62 0 -105 -57t-43 -142q0 -73 25 -122l-99 -418q-17 -70 -13 -177q-206 91 -333 281t-127 423q0 209 103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="pinterest_sign" unicode="&#xf0d3;" 
+d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-725q85 122 108 210q9 34 53 209q21 -39 73.5 -67t112.5 -28q181 0 295.5 147.5t114.5 373.5q0 84 -35 162.5t-96.5 139t-152.5 97t-197 36.5q-104 0 -194.5 -28.5t-153 -76.5
+t-107.5 -109.5t-66.5 -128t-21.5 -132.5q0 -102 39.5 -180t116.5 -110q13 -5 23.5 0t14.5 19q10 44 15 61q6 23 -11 42q-50 62 -50 150q0 150 103.5 256.5t270.5 106.5q149 0 232.5 -81t83.5 -210q0 -168 -67.5 -286t-173.5 -118q-60 0 -97 43.5t-23 103.5q8 34 26.5 92.5
+t29.5 102t11 74.5q0 49 -26.5 81.5t-75.5 32.5q-61 0 -103.5 -56.5t-42.5 -139.5q0 -72 24 -121l-98 -414q-24 -100 -7 -254h-183q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960z" />
+    <glyph glyph-name="google_plus_sign" unicode="&#xf0d4;" 
+d="M917 631q0 26 -6 64h-362v-132h217q-3 -24 -16.5 -50t-37.5 -53t-66.5 -44.5t-96.5 -17.5q-99 0 -169 71t-70 171t70 171t169 71q92 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585
+h109v110h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="google_plus" unicode="&#xf0d5;" horiz-adv-x="2304" 
+d="M1437 623q0 -208 -87 -370.5t-248 -254t-369 -91.5q-149 0 -285 58t-234 156t-156 234t-58 285t58 285t156 234t234 156t285 58q286 0 491 -192l-199 -191q-117 113 -292 113q-123 0 -227.5 -62t-165.5 -168.5t-61 -232.5t61 -232.5t165.5 -168.5t227.5 -62
+q83 0 152.5 23t114.5 57.5t78.5 78.5t49 83t21.5 74h-416v252h692q12 -63 12 -122zM2304 745v-210h-209v-209h-210v209h-209v210h209v209h210v-209h209z" />
+    <glyph glyph-name="money" unicode="&#xf0d6;" horiz-adv-x="1920" 
+d="M768 384h384v96h-128v448h-114l-148 -137l77 -80q42 37 55 57h2v-288h-128v-96zM1280 640q0 -70 -21 -142t-59.5 -134t-101.5 -101t-138 -39t-138 39t-101.5 101t-59.5 134t-21 142t21 142t59.5 134t101.5 101t138 39t138 -39t101.5 -101t59.5 -134t21 -142zM1792 384
+v512q-106 0 -181 75t-75 181h-1152q0 -106 -75 -181t-181 -75v-512q106 0 181 -75t75 -181h1152q0 106 75 181t181 75zM1920 1216v-1152q0 -26 -19 -45t-45 -19h-1792q-26 0 -45 19t-19 45v1152q0 26 19 45t45 19h1792q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="caret_down" unicode="&#xf0d7;" horiz-adv-x="1024" 
+d="M1024 832q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="caret_up" unicode="&#xf0d8;" horiz-adv-x="1024" 
+d="M1024 320q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
+    <glyph glyph-name="caret_left" unicode="&#xf0d9;" horiz-adv-x="640" 
+d="M640 1088v-896q0 -26 -19 -45t-45 -19t-45 19l-448 448q-19 19 -19 45t19 45l448 448q19 19 45 19t45 -19t19 -45z" />
+    <glyph glyph-name="caret_right" unicode="&#xf0da;" horiz-adv-x="640" 
+d="M576 640q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19t-19 45v896q0 26 19 45t45 19t45 -19l448 -448q19 -19 19 -45z" />
+    <glyph glyph-name="columns" unicode="&#xf0db;" horiz-adv-x="1664" 
+d="M160 0h608v1152h-640v-1120q0 -13 9.5 -22.5t22.5 -9.5zM1536 32v1120h-640v-1152h608q13 0 22.5 9.5t9.5 22.5zM1664 1248v-1216q0 -66 -47 -113t-113 -47h-1344q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1344q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="sort" unicode="&#xf0dc;" horiz-adv-x="1024" 
+d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45zM1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
+    <glyph glyph-name="sort_down" unicode="&#xf0dd;" horiz-adv-x="1024" 
+d="M1024 448q0 -26 -19 -45l-448 -448q-19 -19 -45 -19t-45 19l-448 448q-19 19 -19 45t19 45t45 19h896q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="sort_up" unicode="&#xf0de;" horiz-adv-x="1024" 
+d="M1024 832q0 -26 -19 -45t-45 -19h-896q-26 0 -45 19t-19 45t19 45l448 448q19 19 45 19t45 -19l448 -448q19 -19 19 -45z" />
+    <glyph glyph-name="envelope_alt" unicode="&#xf0e0;" horiz-adv-x="1792" 
+d="M1792 826v-794q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v794q44 -49 101 -87q362 -246 497 -345q57 -42 92.5 -65.5t94.5 -48t110 -24.5h1h1q51 0 110 24.5t94.5 48t92.5 65.5q170 123 498 345q57 39 100 87zM1792 1120q0 -79 -49 -151t-122 -123
+q-376 -261 -468 -325q-10 -7 -42.5 -30.5t-54 -38t-52 -32.5t-57.5 -27t-50 -9h-1h-1q-23 0 -50 9t-57.5 27t-52 32.5t-54 38t-42.5 30.5q-91 64 -262 182.5t-205 142.5q-62 42 -117 115.5t-55 136.5q0 78 41.5 130t118.5 52h1472q65 0 112.5 -47t47.5 -113z" />
+    <glyph glyph-name="linkedin" unicode="&#xf0e1;" 
+d="M349 911v-991h-330v991h330zM370 1217q1 -73 -50.5 -122t-135.5 -49h-2q-82 0 -132 49t-50 122q0 74 51.5 122.5t134.5 48.5t133 -48.5t51 -122.5zM1536 488v-568h-329v530q0 105 -40.5 164.5t-126.5 59.5q-63 0 -105.5 -34.5t-63.5 -85.5q-11 -30 -11 -81v-553h-329
+q2 399 2 647t-1 296l-1 48h329v-144h-2q20 32 41 56t56.5 52t87 43.5t114.5 15.5q171 0 275 -113.5t104 -332.5z" />
+    <glyph glyph-name="undo" unicode="&#xf0e2;" 
+d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5
+t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298z" />
+    <glyph glyph-name="legal" unicode="&#xf0e3;" horiz-adv-x="1792" 
+d="M1771 0q0 -53 -37 -90l-107 -108q-39 -37 -91 -37q-53 0 -90 37l-363 364q-38 36 -38 90q0 53 43 96l-256 256l-126 -126q-14 -14 -34 -14t-34 14q2 -2 12.5 -12t12.5 -13t10 -11.5t10 -13.5t6 -13.5t5.5 -16.5t1.5 -18q0 -38 -28 -68q-3 -3 -16.5 -18t-19 -20.5
+t-18.5 -16.5t-22 -15.5t-22 -9t-26 -4.5q-40 0 -68 28l-408 408q-28 28 -28 68q0 13 4.5 26t9 22t15.5 22t16.5 18.5t20.5 19t18 16.5q30 28 68 28q10 0 18 -1.5t16.5 -5.5t13.5 -6t13.5 -10t11.5 -10t13 -12.5t12 -12.5q-14 14 -14 34t14 34l348 348q14 14 34 14t34 -14
+q-2 2 -12.5 12t-12.5 13t-10 11.5t-10 13.5t-6 13.5t-5.5 16.5t-1.5 18q0 38 28 68q3 3 16.5 18t19 20.5t18.5 16.5t22 15.5t22 9t26 4.5q40 0 68 -28l408 -408q28 -28 28 -68q0 -13 -4.5 -26t-9 -22t-15.5 -22t-16.5 -18.5t-20.5 -19t-18 -16.5q-30 -28 -68 -28
+q-10 0 -18 1.5t-16.5 5.5t-13.5 6t-13.5 10t-11.5 10t-13 12.5t-12 12.5q14 -14 14 -34t-14 -34l-126 -126l256 -256q43 43 96 43q52 0 91 -37l363 -363q37 -39 37 -91z" />
+    <glyph glyph-name="dashboard" unicode="&#xf0e4;" horiz-adv-x="1792" 
+d="M384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM576 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1004 351l101 382q6 26 -7.5 48.5t-38.5 29.5
+t-48 -6.5t-30 -39.5l-101 -382q-60 -5 -107 -43.5t-63 -98.5q-20 -77 20 -146t117 -89t146 20t89 117q16 60 -6 117t-72 91zM1664 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 1024q0 53 -37.5 90.5
+t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1472 832q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 384q0 -261 -141 -483q-19 -29 -54 -29h-1402q-35 0 -54 29
+q-141 221 -141 483q0 182 71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="comment_alt" unicode="&#xf0e5;" horiz-adv-x="1792" 
+d="M896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640
+q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 174 120 321.5
+t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
+    <glyph glyph-name="comments_alt" unicode="&#xf0e6;" horiz-adv-x="1792" 
+d="M704 1152q-153 0 -286 -52t-211.5 -141t-78.5 -191q0 -82 53 -158t149 -132l97 -56l-35 -84q34 20 62 39l44 31l53 -10q78 -14 153 -14q153 0 286 52t211.5 141t78.5 191t-78.5 191t-211.5 141t-286 52zM704 1280q191 0 353.5 -68.5t256.5 -186.5t94 -257t-94 -257
+t-256.5 -186.5t-353.5 -68.5q-86 0 -176 16q-124 -88 -278 -128q-36 -9 -86 -16h-3q-11 0 -20.5 8t-11.5 21q-1 3 -1 6.5t0.5 6.5t2 6l2.5 5t3.5 5.5t4 5t4.5 5t4 4.5q5 6 23 25t26 29.5t22.5 29t25 38.5t20.5 44q-124 72 -195 177t-71 224q0 139 94 257t256.5 186.5
+t353.5 68.5zM1526 111q10 -24 20.5 -44t25 -38.5t22.5 -29t26 -29.5t23 -25q1 -1 4 -4.5t4.5 -5t4 -5t3.5 -5.5l2.5 -5t2 -6t0.5 -6.5t-1 -6.5q-3 -14 -13 -22t-22 -7q-50 7 -86 16q-154 40 -278 128q-90 -16 -176 -16q-271 0 -472 132q58 -4 88 -4q161 0 309 45t264 129
+q125 92 192 212t67 254q0 77 -23 152q129 -71 204 -178t75 -230q0 -120 -71 -224.5t-195 -176.5z" />
+    <glyph glyph-name="bolt" unicode="&#xf0e7;" horiz-adv-x="896" 
+d="M885 970q18 -20 7 -44l-540 -1157q-13 -25 -42 -25q-4 0 -14 2q-17 5 -25.5 19t-4.5 30l197 808l-406 -101q-4 -1 -12 -1q-18 0 -31 11q-18 15 -13 39l201 825q4 14 16 23t28 9h328q19 0 32 -12.5t13 -29.5q0 -8 -5 -18l-171 -463l396 98q8 2 12 2q19 0 34 -15z" />
+    <glyph glyph-name="sitemap" unicode="&#xf0e8;" horiz-adv-x="1792" 
+d="M1792 288v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192h-512v-192h96q40 0 68 -28t28 -68v-320
+q0 -40 -28 -68t-68 -28h-320q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h96v192q0 52 38 90t90 38h512v192h-96q-40 0 -68 28t-28 68v320q0 40 28 68t68 28h320q40 0 68 -28t28 -68v-320q0 -40 -28 -68t-68 -28h-96v-192h512q52 0 90 -38t38 -90v-192h96q40 0 68 -28t28 -68
+z" />
+    <glyph glyph-name="umbrella" unicode="&#xf0e9;" horiz-adv-x="1664" 
+d="M896 708v-580q0 -104 -76 -180t-180 -76t-180 76t-76 180q0 26 19 45t45 19t45 -19t19 -45q0 -50 39 -89t89 -39t89 39t39 89v580q33 11 64 11t64 -11zM1664 681q0 -13 -9.5 -22.5t-22.5 -9.5q-11 0 -23 10q-49 46 -93 69t-102 23q-68 0 -128 -37t-103 -97
+q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -28 -17q-18 0 -29 17q-4 6 -14.5 24t-17.5 28q-43 60 -102.5 97t-127.5 37t-127.5 -37t-102.5 -97q-7 -10 -17.5 -28t-14.5 -24q-11 -17 -29 -17q-17 0 -28 17q-4 6 -14.5 24t-17.5 28q-43 60 -103 97t-128 37q-58 0 -102 -23t-93 -69
+q-12 -10 -23 -10q-13 0 -22.5 9.5t-9.5 22.5q0 5 1 7q45 183 172.5 319.5t298 204.5t360.5 68q140 0 274.5 -40t246.5 -113.5t194.5 -187t115.5 -251.5q1 -2 1 -7zM896 1408v-98q-42 2 -64 2t-64 -2v98q0 26 19 45t45 19t45 -19t19 -45z" />
+    <glyph glyph-name="paste" unicode="&#xf0ea;" horiz-adv-x="1792" 
+d="M768 -128h896v640h-416q-40 0 -68 28t-28 68v416h-384v-1152zM1024 1312v64q0 13 -9.5 22.5t-22.5 9.5h-704q-13 0 -22.5 -9.5t-9.5 -22.5v-64q0 -13 9.5 -22.5t22.5 -9.5h704q13 0 22.5 9.5t9.5 22.5zM1280 640h299l-299 299v-299zM1792 512v-672q0 -40 -28 -68t-68 -28
+h-960q-40 0 -68 28t-28 68v160h-544q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1088q40 0 68 -28t28 -68v-328q21 -13 36 -28l408 -408q28 -28 48 -76t20 -88z" />
+    <glyph glyph-name="light_bulb" unicode="&#xf0eb;" horiz-adv-x="1024" 
+d="M736 960q0 -13 -9.5 -22.5t-22.5 -9.5t-22.5 9.5t-9.5 22.5q0 46 -54 71t-106 25q-13 0 -22.5 9.5t-9.5 22.5t9.5 22.5t22.5 9.5q50 0 99.5 -16t87 -54t37.5 -90zM896 960q0 72 -34.5 134t-90 101.5t-123 62t-136.5 22.5t-136.5 -22.5t-123 -62t-90 -101.5t-34.5 -134
+q0 -101 68 -180q10 -11 30.5 -33t30.5 -33q128 -153 141 -298h228q13 145 141 298q10 11 30.5 33t30.5 33q68 79 68 180zM1024 960q0 -155 -103 -268q-45 -49 -74.5 -87t-59.5 -95.5t-34 -107.5q47 -28 47 -82q0 -37 -25 -64q25 -27 25 -64q0 -52 -45 -81q13 -23 13 -47
+q0 -46 -31.5 -71t-77.5 -25q-20 -44 -60 -70t-87 -26t-87 26t-60 70q-46 0 -77.5 25t-31.5 71q0 24 13 47q-45 29 -45 81q0 37 25 64q-25 27 -25 64q0 54 47 82q-4 50 -34 107.5t-59.5 95.5t-74.5 87q-103 113 -103 268q0 99 44.5 184.5t117 142t164 89t186.5 32.5
+t186.5 -32.5t164 -89t117 -142t44.5 -184.5z" />
+    <glyph glyph-name="exchange" unicode="&#xf0ec;" horiz-adv-x="1792" 
+d="M1792 352v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-1376v-192q0 -13 -9.5 -22.5t-22.5 -9.5q-12 0 -24 10l-319 320q-9 9 -9 22q0 14 9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h1376q13 0 22.5 -9.5t9.5 -22.5zM1792 896q0 -14 -9 -23l-320 -320q-9 -9 -23 -9
+q-13 0 -22.5 9.5t-9.5 22.5v192h-1376q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h1376v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23z" />
+    <glyph glyph-name="cloud_download" unicode="&#xf0ed;" horiz-adv-x="1920" 
+d="M1280 608q0 14 -9 23t-23 9h-224v352q0 13 -9.5 22.5t-22.5 9.5h-192q-13 0 -22.5 -9.5t-9.5 -22.5v-352h-224q-13 0 -22.5 -9.5t-9.5 -22.5q0 -14 9 -23l352 -352q9 -9 23 -9t23 9l351 351q10 12 10 24zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088
+q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
+    <glyph glyph-name="cloud_upload" unicode="&#xf0ee;" horiz-adv-x="1920" 
+d="M1280 672q0 14 -9 23l-352 352q-9 9 -23 9t-23 -9l-351 -351q-10 -12 -10 -24q0 -14 9 -23t23 -9h224v-352q0 -13 9.5 -22.5t22.5 -9.5h192q13 0 22.5 9.5t9.5 22.5v352h224q13 0 22.5 9.5t9.5 22.5zM1920 384q0 -159 -112.5 -271.5t-271.5 -112.5h-1088
+q-185 0 -316.5 131.5t-131.5 316.5q0 130 70 240t188 165q-2 30 -2 43q0 212 150 362t362 150q156 0 285.5 -87t188.5 -231q71 62 166 62q106 0 181 -75t75 -181q0 -76 -41 -138q130 -31 213.5 -135.5t83.5 -238.5z" />
+    <glyph glyph-name="user_md" unicode="&#xf0f0;" horiz-adv-x="1408" 
+d="M384 192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 68 5.5 131t24 138t47.5 132.5t81 103t120 60.5q-22 -52 -22 -120v-203q-58 -20 -93 -70t-35 -111q0 -80 56 -136t136 -56
+t136 56t56 136q0 61 -35.5 111t-92.5 70v203q0 62 25 93q132 -104 295 -104t295 104q25 -31 25 -93v-64q-106 0 -181 -75t-75 -181v-89q-32 -29 -32 -71q0 -40 28 -68t68 -28t68 28t28 68q0 42 -32 71v89q0 52 38 90t90 38t90 -38t38 -90v-89q-32 -29 -32 -71q0 -40 28 -68
+t68 -28t68 28t28 68q0 42 -32 71v89q0 68 -34.5 127.5t-93.5 93.5q0 10 0.5 42.5t0 48t-2.5 41.5t-7 47t-13 40q68 -15 120 -60.5t81 -103t47.5 -132.5t24 -138t5.5 -131zM1088 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5
+t271.5 -112.5t112.5 -271.5z" />
+    <glyph glyph-name="stethoscope" unicode="&#xf0f1;" horiz-adv-x="1408" 
+d="M1280 832q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 832q0 -62 -35.5 -111t-92.5 -70v-395q0 -159 -131.5 -271.5t-316.5 -112.5t-316.5 112.5t-131.5 271.5v132q-164 20 -274 128t-110 252v512q0 26 19 45t45 19q6 0 16 -2q17 30 47 48
+t65 18q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5q-33 0 -64 18v-402q0 -106 94 -181t226 -75t226 75t94 181v402q-31 -18 -64 -18q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5q35 0 65 -18t47 -48q10 2 16 2q26 0 45 -19t19 -45v-512q0 -144 -110 -252
+t-274 -128v-132q0 -106 94 -181t226 -75t226 75t94 181v395q-57 21 -92.5 70t-35.5 111q0 80 56 136t136 56t136 -56t56 -136z" />
+    <glyph glyph-name="suitcase" unicode="&#xf0f2;" horiz-adv-x="1792" 
+d="M640 1152h512v128h-512v-128zM288 1152v-1280h-64q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h64zM1408 1152v-1280h-1024v1280h128v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h128zM1792 928v-832q0 -92 -66 -158t-158 -66h-64v1280h64q92 0 158 -66
+t66 -158z" />
+    <glyph glyph-name="bell_alt" unicode="&#xf0f3;" horiz-adv-x="1792" 
+d="M912 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM1728 128q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-181 75t-75 181h-448q-52 0 -90 38t-38 90q50 42 91 88t85 119.5t74.5 158.5
+t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q190 -28 307 -158.5t117 -282.5q0 -139 19.5 -260t50 -206t74.5 -158.5t85 -119.5t91 -88z" />
+    <glyph glyph-name="coffee" unicode="&#xf0f4;" horiz-adv-x="1920" 
+d="M1664 896q0 80 -56 136t-136 56h-64v-384h64q80 0 136 56t56 136zM0 128h1792q0 -106 -75 -181t-181 -75h-1280q-106 0 -181 75t-75 181zM1856 896q0 -159 -112.5 -271.5t-271.5 -112.5h-64v-32q0 -92 -66 -158t-158 -66h-704q-92 0 -158 66t-66 158v736q0 26 19 45
+t45 19h1152q159 0 271.5 -112.5t112.5 -271.5z" />
+    <glyph glyph-name="food" unicode="&#xf0f5;" horiz-adv-x="1408" 
+d="M640 1472v-640q0 -61 -35.5 -111t-92.5 -70v-779q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v779q-57 20 -92.5 70t-35.5 111v640q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45v-416q0 -26 19 -45
+t45 -19t45 19t19 45v416q0 26 19 45t45 19t45 -19t19 -45zM1408 1472v-1600q0 -52 -38 -90t-90 -38h-128q-52 0 -90 38t-38 90v512h-224q-13 0 -22.5 9.5t-9.5 22.5v800q0 132 94 226t226 94h256q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="file_text_alt" unicode="&#xf0f6;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M384 736q0 14 9 23t23 9h704q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64zM1120 512q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704zM1120 256q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-704
+q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704z" />
+    <glyph glyph-name="building" unicode="&#xf0f7;" horiz-adv-x="1408" 
+d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M640 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M640 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 992v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M896 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 1248v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M896 -128h384v1536h-1152v-1536h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM1408 1472v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="hospital" unicode="&#xf0f8;" horiz-adv-x="1408" 
+d="M384 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M640 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM384 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M1152 224v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM896 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M640 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 480v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M896 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5zM1152 736v-64q0 -13 -9.5 -22.5t-22.5 -9.5h-64q-13 0 -22.5 9.5t-9.5 22.5v64q0 13 9.5 22.5t22.5 9.5h64q13 0 22.5 -9.5t9.5 -22.5z
+M896 -128h384v1152h-256v-32q0 -40 -28 -68t-68 -28h-448q-40 0 -68 28t-28 68v32h-256v-1152h384v224q0 13 9.5 22.5t22.5 9.5h320q13 0 22.5 -9.5t9.5 -22.5v-224zM896 1056v320q0 13 -9.5 22.5t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-96h-128v96q0 13 -9.5 22.5
+t-22.5 9.5h-64q-13 0 -22.5 -9.5t-9.5 -22.5v-320q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5v96h128v-96q0 -13 9.5 -22.5t22.5 -9.5h64q13 0 22.5 9.5t9.5 22.5zM1408 1088v-1280q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1280q0 26 19 45t45 19h320
+v288q0 40 28 68t68 28h448q40 0 68 -28t28 -68v-288h320q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="ambulance" unicode="&#xf0f9;" horiz-adv-x="1920" 
+d="M640 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM256 640h384v256h-158q-14 -2 -22 -9l-195 -195q-7 -12 -9 -22v-30zM1536 128q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5
+t90.5 37.5t37.5 90.5zM1664 800v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM1920 1344v-1152
+q0 -26 -19 -45t-45 -19h-192q0 -106 -75 -181t-181 -75t-181 75t-75 181h-384q0 -106 -75 -181t-181 -75t-181 75t-75 181h-128q-26 0 -45 19t-19 45t19 45t45 19v416q0 26 13 58t32 51l198 198q19 19 51 32t58 13h160v320q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="medkit" unicode="&#xf0fa;" horiz-adv-x="1792" 
+d="M1280 416v192q0 14 -9 23t-23 9h-224v224q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23v-224h-224q-14 0 -23 -9t-9 -23v-192q0 -14 9 -23t23 -9h224v-224q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v224h224q14 0 23 9t9 23zM640 1152h512v128h-512v-128zM256 1152v-1280h-32
+q-92 0 -158 66t-66 158v832q0 92 66 158t158 66h32zM1440 1152v-1280h-1088v1280h160v160q0 40 28 68t68 28h576q40 0 68 -28t28 -68v-160h160zM1792 928v-832q0 -92 -66 -158t-158 -66h-32v1280h32q92 0 158 -66t66 -158z" />
+    <glyph glyph-name="fighter_jet" unicode="&#xf0fb;" horiz-adv-x="1920" 
+d="M1920 576q-1 -32 -288 -96l-352 -32l-224 -64h-64l-293 -352h69q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-96h-160h-64v32h64v416h-160l-192 -224h-96l-32 32v192h32v32h128v8l-192 24v128l192 24v8h-128v32h-32v192l32 32h96l192 -224h160v416h-64v32h64h160h96
+q26 0 45 -4.5t19 -11.5t-19 -11.5t-45 -4.5h-69l293 -352h64l224 -64l352 -32q128 -28 200 -52t80 -34z" />
+    <glyph glyph-name="beer" unicode="&#xf0fc;" horiz-adv-x="1664" 
+d="M640 640v384h-256v-256q0 -53 37.5 -90.5t90.5 -37.5h128zM1664 192v-192h-1152v192l128 192h-128q-159 0 -271.5 112.5t-112.5 271.5v320l-64 64l32 128h480l32 128h960l32 -192l-64 -32v-800z" />
+    <glyph glyph-name="h_sign" unicode="&#xf0fd;" 
+d="M1280 192v896q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-512v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-896q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h512v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45zM1536 1120v-960
+q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="f0fe" unicode="&#xf0fe;" 
+d="M1280 576v128q0 26 -19 45t-45 19h-320v320q0 26 -19 45t-45 19h-128q-26 0 -45 -19t-19 -45v-320h-320q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h320v-320q0 -26 19 -45t45 -19h128q26 0 45 19t19 45v320h320q26 0 45 19t19 45zM1536 1120v-960
+q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="double_angle_left" unicode="&#xf100;" horiz-adv-x="1024" 
+d="M627 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23zM1011 160q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23
+t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23z" />
+    <glyph glyph-name="double_angle_right" unicode="&#xf101;" horiz-adv-x="1024" 
+d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM979 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23
+l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+    <glyph glyph-name="double_angle_up" unicode="&#xf102;" horiz-adv-x="1152" 
+d="M1075 224q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23zM1075 608q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393
+q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+    <glyph glyph-name="double_angle_down" unicode="&#xf103;" horiz-adv-x="1152" 
+d="M1075 672q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23zM1075 1056q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23
+t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
+    <glyph glyph-name="angle_left" unicode="&#xf104;" horiz-adv-x="640" 
+d="M627 992q0 -13 -10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
+    <glyph glyph-name="angle_right" unicode="&#xf105;" horiz-adv-x="640" 
+d="M595 576q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+    <glyph glyph-name="angle_up" unicode="&#xf106;" horiz-adv-x="1152" 
+d="M1075 352q0 -13 -10 -23l-50 -50q-10 -10 -23 -10t-23 10l-393 393l-393 -393q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l466 -466q10 -10 10 -23z" />
+    <glyph glyph-name="angle_down" unicode="&#xf107;" horiz-adv-x="1152" 
+d="M1075 800q0 -13 -10 -23l-466 -466q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l393 -393l393 393q10 10 23 10t23 -10l50 -50q10 -10 10 -23z" />
+    <glyph glyph-name="desktop" unicode="&#xf108;" horiz-adv-x="1920" 
+d="M1792 544v832q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-832q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1376v-1088q0 -66 -47 -113t-113 -47h-544q0 -37 16 -77.5t32 -71t16 -43.5q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19
+t-19 45q0 14 16 44t32 70t16 78h-544q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="laptop" unicode="&#xf109;" horiz-adv-x="1920" 
+d="M416 256q-66 0 -113 47t-47 113v704q0 66 47 113t113 47h1088q66 0 113 -47t47 -113v-704q0 -66 -47 -113t-113 -47h-1088zM384 1120v-704q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5v704q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5z
+M1760 192h160v-96q0 -40 -47 -68t-113 -28h-1600q-66 0 -113 28t-47 68v96h160h1600zM1040 96q16 0 16 16t-16 16h-160q-16 0 -16 -16t16 -16h160z" />
+    <glyph glyph-name="tablet" unicode="&#xf10a;" horiz-adv-x="1152" 
+d="M640 128q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1024 288v960q0 13 -9.5 22.5t-22.5 9.5h-832q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h832q13 0 22.5 9.5t9.5 22.5zM1152 1248v-1088q0 -66 -47 -113t-113 -47h-832
+q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h832q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="mobile_phone" unicode="&#xf10b;" horiz-adv-x="768" 
+d="M464 128q0 33 -23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5t56.5 23.5t23.5 56.5zM672 288v704q0 13 -9.5 22.5t-22.5 9.5h-512q-13 0 -22.5 -9.5t-9.5 -22.5v-704q0 -13 9.5 -22.5t22.5 -9.5h512q13 0 22.5 9.5t9.5 22.5zM480 1136
+q0 16 -16 16h-160q-16 0 -16 -16t16 -16h160q16 0 16 16zM768 1152v-1024q0 -52 -38 -90t-90 -38h-512q-52 0 -90 38t-38 90v1024q0 52 38 90t90 38h512q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="circle_blank" unicode="&#xf10c;" 
+d="M768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103
+t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="quote_left" unicode="&#xf10d;" horiz-adv-x="1664" 
+d="M768 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z
+M1664 576v-384q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v704q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5h64q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-64q-106 0 -181 -75t-75 -181v-32q0 -40 28 -68t68 -28h224q80 0 136 -56t56 -136z" />
+    <glyph glyph-name="quote_right" unicode="&#xf10e;" horiz-adv-x="1664" 
+d="M768 1216v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136zM1664 1216
+v-704q0 -104 -40.5 -198.5t-109.5 -163.5t-163.5 -109.5t-198.5 -40.5h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64q106 0 181 75t75 181v32q0 40 -28 68t-68 28h-224q-80 0 -136 56t-56 136v384q0 80 56 136t136 56h384q80 0 136 -56t56 -136z" />
+    <glyph glyph-name="spinner" unicode="&#xf110;" horiz-adv-x="1792" 
+d="M526 142q0 -53 -37.5 -90.5t-90.5 -37.5q-52 0 -90 38t-38 90q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 -64q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM320 640q0 -53 -37.5 -90.5t-90.5 -37.5
+t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1522 142q0 -52 -38 -90t-90 -38q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM558 1138q0 -66 -47 -113t-113 -47t-113 47t-47 113t47 113t113 47t113 -47t47 -113z
+M1728 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1088 1344q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1618 1138q0 -93 -66 -158.5t-158 -65.5q-93 0 -158.5 65.5t-65.5 158.5
+q0 92 65.5 158t158.5 66q92 0 158 -66t66 -158z" />
+    <glyph glyph-name="circle" unicode="&#xf111;" 
+d="M1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="reply" unicode="&#xf112;" horiz-adv-x="1792" 
+d="M1792 416q0 -166 -127 -451q-3 -7 -10.5 -24t-13.5 -30t-13 -22q-12 -17 -28 -17q-15 0 -23.5 10t-8.5 25q0 9 2.5 26.5t2.5 23.5q5 68 5 123q0 101 -17.5 181t-48.5 138.5t-80 101t-105.5 69.5t-133 42.5t-154 21.5t-175.5 6h-224v-256q0 -26 -19 -45t-45 -19t-45 19
+l-512 512q-19 19 -19 45t19 45l512 512q19 19 45 19t45 -19t19 -45v-256h224q713 0 875 -403q53 -134 53 -333z" />
+    <glyph glyph-name="github_alt" unicode="&#xf113;" horiz-adv-x="1664" 
+d="M640 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1280 320q0 -40 -12.5 -82t-43 -76t-72.5 -34t-72.5 34t-43 76t-12.5 82t12.5 82t43 76t72.5 34t72.5 -34t43 -76t12.5 -82zM1440 320
+q0 120 -69 204t-187 84q-41 0 -195 -21q-71 -11 -157 -11t-157 11q-152 21 -195 21q-118 0 -187 -84t-69 -204q0 -88 32 -153.5t81 -103t122 -60t140 -29.5t149 -7h168q82 0 149 7t140 29.5t122 60t81 103t32 153.5zM1664 496q0 -207 -61 -331q-38 -77 -105.5 -133t-141 -86
+t-170 -47.5t-171.5 -22t-167 -4.5q-78 0 -142 3t-147.5 12.5t-152.5 30t-137 51.5t-121 81t-86 115q-62 123 -62 331q0 237 136 396q-27 82 -27 170q0 116 51 218q108 0 190 -39.5t189 -123.5q147 35 309 35q148 0 280 -32q105 82 187 121t189 39q51 -102 51 -218
+q0 -87 -27 -168q136 -160 136 -398z" />
+    <glyph glyph-name="folder_close_alt" unicode="&#xf114;" horiz-adv-x="1664" 
+d="M1536 224v704q0 40 -28 68t-68 28h-704q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68v-960q0 -40 28 -68t68 -28h1216q40 0 68 28t28 68zM1664 928v-704q0 -92 -66 -158t-158 -66h-1216q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320
+q92 0 158 -66t66 -158v-32h672q92 0 158 -66t66 -158z" />
+    <glyph glyph-name="folder_open_alt" unicode="&#xf115;" horiz-adv-x="1920" 
+d="M1781 605q0 35 -53 35h-1088q-40 0 -85.5 -21.5t-71.5 -52.5l-294 -363q-18 -24 -18 -40q0 -35 53 -35h1088q40 0 86 22t71 53l294 363q18 22 18 39zM640 768h768v160q0 40 -28 68t-68 28h-576q-40 0 -68 28t-28 68v64q0 40 -28 68t-68 28h-320q-40 0 -68 -28t-28 -68
+v-853l256 315q44 53 116 87.5t140 34.5zM1909 605q0 -62 -46 -120l-295 -363q-43 -53 -116 -87.5t-140 -34.5h-1088q-92 0 -158 66t-66 158v960q0 92 66 158t158 66h320q92 0 158 -66t66 -158v-32h544q92 0 158 -66t66 -158v-160h192q54 0 99 -24.5t67 -70.5q15 -32 15 -68z
+" />
+    <glyph glyph-name="expand_alt" unicode="&#xf116;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="collapse_alt" unicode="&#xf117;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="smile" unicode="&#xf118;" 
+d="M1134 461q-37 -121 -138 -195t-228 -74t-228 74t-138 195q-8 25 4 48.5t38 31.5q25 8 48.5 -4t31.5 -38q25 -80 92.5 -129.5t151.5 -49.5t151.5 49.5t92.5 129.5q8 26 32 38t49 4t37 -31.5t4 -48.5zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
+t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5
+t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="frown" unicode="&#xf119;" 
+d="M1134 307q8 -25 -4 -48.5t-37 -31.5t-49 4t-32 38q-25 80 -92.5 129.5t-151.5 49.5t-151.5 -49.5t-92.5 -129.5q-8 -26 -31.5 -38t-48.5 -4q-26 8 -38 31.5t-4 48.5q37 121 138 195t228 74t228 -74t138 -195zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
+t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204
+t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="meh" unicode="&#xf11a;" 
+d="M1152 448q0 -26 -19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h640q26 0 45 -19t19 -45zM640 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1152 896q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
+t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="gamepad" unicode="&#xf11b;" horiz-adv-x="1920" 
+d="M832 448v128q0 14 -9 23t-23 9h-192v192q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-192h-192q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h192v-192q0 -14 9 -23t23 -9h128q14 0 23 9t9 23v192h192q14 0 23 9t9 23zM1408 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5
+t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1920 512q0 -212 -150 -362t-362 -150q-192 0 -338 128h-220q-146 -128 -338 -128q-212 0 -362 150
+t-150 362t150 362t362 150h896q212 0 362 -150t150 -362z" />
+    <glyph glyph-name="keyboard" unicode="&#xf11c;" horiz-adv-x="1920" 
+d="M384 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM512 624v-96q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h224q16 0 16 -16zM384 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 368v-96q0 -16 -16 -16
+h-864q-16 0 -16 16v96q0 16 16 16h864q16 0 16 -16zM768 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM640 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1024 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16
+h96q16 0 16 -16zM896 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1280 624v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 368v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1152 880v-96
+q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1408 880v-96q0 -16 -16 -16h-96q-16 0 -16 16v96q0 16 16 16h96q16 0 16 -16zM1664 880v-352q0 -16 -16 -16h-224q-16 0 -16 16v96q0 16 16 16h112v240q0 16 16 16h96q16 0 16 -16zM1792 128v896h-1664v-896
+h1664zM1920 1024v-896q0 -53 -37.5 -90.5t-90.5 -37.5h-1664q-53 0 -90.5 37.5t-37.5 90.5v896q0 53 37.5 90.5t90.5 37.5h1664q53 0 90.5 -37.5t37.5 -90.5z" />
+    <glyph glyph-name="flag_alt" unicode="&#xf11d;" horiz-adv-x="1792" 
+d="M1664 491v616q-169 -91 -306 -91q-82 0 -145 32q-100 49 -184 76.5t-178 27.5q-173 0 -403 -127v-599q245 113 433 113q55 0 103.5 -7.5t98 -26t77 -31t82.5 -39.5l28 -14q44 -22 101 -22q120 0 293 92zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9
+h-64q-14 0 -23 9t-9 23v1266q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102
+q-15 -9 -33 -9q-16 0 -32 8q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
+    <glyph glyph-name="flag_checkered" unicode="&#xf11e;" horiz-adv-x="1792" 
+d="M832 536v192q-181 -16 -384 -117v-185q205 96 384 110zM832 954v197q-172 -8 -384 -126v-189q215 111 384 118zM1664 491v184q-235 -116 -384 -71v224q-20 6 -39 15q-5 3 -33 17t-34.5 17t-31.5 15t-34.5 15.5t-32.5 13t-36 12.5t-35 8.5t-39.5 7.5t-39.5 4t-44 2
+q-23 0 -49 -3v-222h19q102 0 192.5 -29t197.5 -82q19 -9 39 -15v-188q42 -17 91 -17q120 0 293 92zM1664 918v189q-169 -91 -306 -91q-45 0 -78 8v-196q148 -42 384 90zM320 1280q0 -35 -17.5 -64t-46.5 -46v-1266q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v1266
+q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1792 1216v-763q0 -39 -35 -57q-10 -5 -17 -9q-218 -116 -369 -116q-88 0 -158 35l-28 14q-64 33 -99 48t-91 29t-114 14q-102 0 -235.5 -44t-228.5 -102q-15 -9 -33 -9q-16 0 -32 8
+q-32 19 -32 56v742q0 35 31 55q35 21 78.5 42.5t114 52t152.5 49.5t155 19q112 0 209 -31t209 -86q38 -19 89 -19q122 0 310 112q22 12 31 17q31 16 62 -2q31 -20 31 -55z" />
+    <glyph glyph-name="terminal" unicode="&#xf120;" horiz-adv-x="1664" 
+d="M585 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23zM1664 96v-64q0 -14 -9 -23t-23 -9h-960q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h960q14 0 23 -9
+t9 -23z" />
+    <glyph glyph-name="code" unicode="&#xf121;" horiz-adv-x="1920" 
+d="M617 137l-50 -50q-10 -10 -23 -10t-23 10l-466 466q-10 10 -10 23t10 23l466 466q10 10 23 10t23 -10l50 -50q10 -10 10 -23t-10 -23l-393 -393l393 -393q10 -10 10 -23t-10 -23zM1208 1204l-373 -1291q-4 -13 -15.5 -19.5t-23.5 -2.5l-62 17q-13 4 -19.5 15.5t-2.5 24.5
+l373 1291q4 13 15.5 19.5t23.5 2.5l62 -17q13 -4 19.5 -15.5t2.5 -24.5zM1865 553l-466 -466q-10 -10 -23 -10t-23 10l-50 50q-10 10 -10 23t10 23l393 393l-393 393q-10 10 -10 23t10 23l50 50q10 10 23 10t23 -10l466 -466q10 -10 10 -23t-10 -23z" />
+    <glyph glyph-name="reply_all" unicode="&#xf122;" horiz-adv-x="1792" 
+d="M640 454v-70q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-69l-397 -398q-19 -19 -19 -45t19 -45zM1792 416q0 -58 -17 -133.5t-38.5 -138t-48 -125t-40.5 -90.5l-20 -40q-8 -17 -28 -17q-6 0 -9 1
+q-25 8 -23 34q43 400 -106 565q-64 71 -170.5 110.5t-267.5 52.5v-251q0 -42 -39 -59q-13 -5 -25 -5q-27 0 -45 19l-512 512q-19 19 -19 45t19 45l512 512q29 31 70 14q39 -17 39 -59v-262q411 -28 599 -221q169 -173 169 -509z" />
+    <glyph glyph-name="star_half_empty" unicode="&#xf123;" horiz-adv-x="1664" 
+d="M1186 579l257 250l-356 52l-66 10l-30 60l-159 322v-963l59 -31l318 -168l-60 355l-12 66zM1638 841l-363 -354l86 -500q5 -33 -6 -51.5t-34 -18.5q-17 0 -40 12l-449 236l-449 -236q-23 -12 -40 -12q-23 0 -34 18.5t-6 51.5l86 500l-364 354q-32 32 -23 59.5t54 34.5
+l502 73l225 455q20 41 49 41q28 0 49 -41l225 -455l502 -73q45 -7 54 -34.5t-24 -59.5z" />
+    <glyph glyph-name="location_arrow" unicode="&#xf124;" horiz-adv-x="1408" 
+d="M1401 1187l-640 -1280q-17 -35 -57 -35q-5 0 -15 2q-22 5 -35.5 22.5t-13.5 39.5v576h-576q-22 0 -39.5 13.5t-22.5 35.5t4 42t29 30l1280 640q13 7 29 7q27 0 45 -19q15 -14 18.5 -34.5t-6.5 -39.5z" />
+    <glyph glyph-name="crop" unicode="&#xf125;" horiz-adv-x="1664" 
+d="M557 256h595v595zM512 301l595 595h-595v-595zM1664 224v-192q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v224h-864q-14 0 -23 9t-9 23v864h-224q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h224v224q0 14 9 23t23 9h192q14 0 23 -9t9 -23
+v-224h851l246 247q10 9 23 9t23 -9q9 -10 9 -23t-9 -23l-247 -246v-851h224q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="code_fork" unicode="&#xf126;" horiz-adv-x="1024" 
+d="M288 64q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM288 1216q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM928 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1024 1088q0 -52 -26 -96.5t-70 -69.5
+q-2 -287 -226 -414q-67 -38 -203 -81q-128 -40 -169.5 -71t-41.5 -100v-26q44 -25 70 -69.5t26 -96.5q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 52 26 96.5t70 69.5v820q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136q0 -52 -26 -96.5t-70 -69.5v-497
+q54 26 154 57q55 17 87.5 29.5t70.5 31t59 39.5t40.5 51t28 69.5t8.5 91.5q-44 25 -70 69.5t-26 96.5q0 80 56 136t136 56t136 -56t56 -136z" />
+    <glyph glyph-name="unlink" unicode="&#xf127;" horiz-adv-x="1664" 
+d="M439 265l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23zM608 224v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM384 448q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23t9 23t23 9h320
+q14 0 23 -9t9 -23zM1648 320q0 -120 -85 -203l-147 -146q-83 -83 -203 -83q-121 0 -204 85l-334 335q-21 21 -42 56l239 18l273 -274q27 -27 68 -27.5t68 26.5l147 146q28 28 28 67q0 40 -28 68l-274 275l18 239q35 -21 56 -42l336 -336q84 -86 84 -204zM1031 1044l-239 -18
+l-273 274q-28 28 -68 28q-39 0 -68 -27l-147 -146q-28 -28 -28 -67q0 -40 28 -68l274 -274l-18 -240q-35 21 -56 42l-336 336q-84 86 -84 204q0 120 85 203l147 146q83 83 203 83q121 0 204 -85l334 -335q21 -21 42 -56zM1664 960q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9
+t-9 23t9 23t23 9h320q14 0 23 -9t9 -23zM1120 1504v-320q0 -14 -9 -23t-23 -9t-23 9t-9 23v320q0 14 9 23t23 9t23 -9t9 -23zM1527 1353l-256 -256q-11 -9 -23 -9t-23 9q-9 10 -9 23t9 23l256 256q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
+    <glyph glyph-name="question" unicode="&#xf128;" horiz-adv-x="1024" 
+d="M704 280v-240q0 -16 -12 -28t-28 -12h-240q-16 0 -28 12t-12 28v240q0 16 12 28t28 12h240q16 0 28 -12t12 -28zM1020 880q0 -54 -15.5 -101t-35 -76.5t-55 -59.5t-57.5 -43.5t-61 -35.5q-41 -23 -68.5 -65t-27.5 -67q0 -17 -12 -32.5t-28 -15.5h-240q-15 0 -25.5 18.5
+t-10.5 37.5v45q0 83 65 156.5t143 108.5q59 27 84 56t25 76q0 42 -46.5 74t-107.5 32q-65 0 -108 -29q-35 -25 -107 -115q-13 -16 -31 -16q-12 0 -25 8l-164 125q-13 10 -15.5 25t5.5 28q160 266 464 266q80 0 161 -31t146 -83t106 -127.5t41 -158.5z" />
+    <glyph glyph-name="_279" unicode="&#xf129;" horiz-adv-x="640" 
+d="M640 192v-128q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h64v384h-64q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h384q26 0 45 -19t19 -45v-576h64q26 0 45 -19t19 -45zM512 1344v-192q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v192
+q0 26 19 45t45 19h256q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="exclamation" unicode="&#xf12a;" horiz-adv-x="640" 
+d="M512 288v-224q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v224q0 26 19 45t45 19h256q26 0 45 -19t19 -45zM542 1344l-28 -768q-1 -26 -20.5 -45t-45.5 -19h-256q-26 0 -45.5 19t-20.5 45l-28 768q-1 26 17.5 45t44.5 19h320q26 0 44.5 -19t17.5 -45z" />
+    <glyph glyph-name="superscript" unicode="&#xf12b;" 
+d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3q-1 -3 -2.5 -6.5t-3.5 -8t-3 -6.5q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109z
+M1534 846v-206h-514l-3 27q-4 28 -4 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q83 65 188 65q110 0 178 -59.5t68 -158.5q0 -56 -24.5 -103t-62 -76.5t-81.5 -58.5t-82 -50.5
+t-65.5 -51.5t-30.5 -63h232v80h126z" />
+    <glyph glyph-name="subscript" unicode="&#xf12c;" 
+d="M897 167v-167h-248l-159 252l-24 42q-8 9 -11 21h-3q-1 -3 -2.5 -6.5t-3.5 -8t-3 -6.5q-10 -20 -25 -44l-155 -250h-258v167h128l197 291l-185 272h-137v168h276l139 -228q2 -4 23 -42q8 -9 11 -21h3q3 9 11 21l25 42l140 228h257v-168h-125l-184 -267l204 -296h109z
+M1536 -50v-206h-514l-4 27q-3 45 -3 46q0 64 26 117t65 86.5t84 65t84 54.5t65 54t26 64q0 38 -29.5 62.5t-70.5 24.5q-51 0 -97 -39q-14 -11 -36 -38l-105 92q26 37 63 66q80 65 188 65q110 0 178 -59.5t68 -158.5q0 -66 -34.5 -118.5t-84 -86t-99.5 -62.5t-87 -63t-41 -73
+h232v80h126z" />
+    <glyph glyph-name="_283" unicode="&#xf12d;" horiz-adv-x="1920" 
+d="M896 128l336 384h-768l-336 -384h768zM1909 1205q15 -34 9.5 -71.5t-30.5 -65.5l-896 -1024q-38 -44 -96 -44h-768q-38 0 -69.5 20.5t-47.5 54.5q-15 34 -9.5 71.5t30.5 65.5l896 1024q38 44 96 44h768q38 0 69.5 -20.5t47.5 -54.5z" />
+    <glyph glyph-name="puzzle_piece" unicode="&#xf12e;" horiz-adv-x="1664" 
+d="M1664 438q0 -81 -44.5 -135t-123.5 -54q-41 0 -77.5 17.5t-59 38t-56.5 38t-71 17.5q-110 0 -110 -124q0 -39 16 -115t15 -115v-5q-22 0 -33 -1q-34 -3 -97.5 -11.5t-115.5 -13.5t-98 -5q-61 0 -103 26.5t-42 83.5q0 37 17.5 71t38 56.5t38 59t17.5 77.5q0 79 -54 123.5
+t-135 44.5q-84 0 -143 -45.5t-59 -127.5q0 -43 15 -83t33.5 -64.5t33.5 -53t15 -50.5q0 -45 -46 -89q-37 -35 -117 -35q-95 0 -245 24q-9 2 -27.5 4t-27.5 4l-13 2q-1 0 -3 1q-2 0 -2 1v1024q2 -1 17.5 -3.5t34 -5t21.5 -3.5q150 -24 245 -24q80 0 117 35q46 44 46 89
+q0 22 -15 50.5t-33.5 53t-33.5 64.5t-15 83q0 82 59 127.5t144 45.5q80 0 134 -44.5t54 -123.5q0 -41 -17.5 -77.5t-38 -59t-38 -56.5t-17.5 -71q0 -57 42 -83.5t103 -26.5q64 0 180 15t163 17v-2q-1 -2 -3.5 -17.5t-5 -34t-3.5 -21.5q-24 -150 -24 -245q0 -80 35 -117
+q44 -46 89 -46q22 0 50.5 15t53 33.5t64.5 33.5t83 15q82 0 127.5 -59t45.5 -143z" />
+    <glyph glyph-name="microphone" unicode="&#xf130;" horiz-adv-x="1152" 
+d="M1152 832v-128q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-217 24 -364.5 187.5t-147.5 384.5v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -185 131.5 -316.5t316.5 -131.5
+t316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45zM896 1216v-512q0 -132 -94 -226t-226 -94t-226 94t-94 226v512q0 132 94 226t226 94t226 -94t94 -226z" />
+    <glyph glyph-name="microphone_off" unicode="&#xf131;" horiz-adv-x="1408" 
+d="M271 591l-101 -101q-42 103 -42 214v128q0 26 19 45t45 19t45 -19t19 -45v-128q0 -53 15 -113zM1385 1193l-361 -361v-128q0 -132 -94 -226t-226 -94q-55 0 -109 19l-96 -96q97 -51 205 -51q185 0 316.5 131.5t131.5 316.5v128q0 26 19 45t45 19t45 -19t19 -45v-128
+q0 -221 -147.5 -384.5t-364.5 -187.5v-132h256q26 0 45 -19t19 -45t-19 -45t-45 -19h-640q-26 0 -45 19t-19 45t19 45t45 19h256v132q-125 13 -235 81l-254 -254q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l1234 1234q10 10 23 10t23 -10l82 -82q10 -10 10 -23
+t-10 -23zM1005 1325l-621 -621v512q0 132 94 226t226 94q102 0 184.5 -59t116.5 -152z" />
+    <glyph glyph-name="shield" unicode="&#xf132;" horiz-adv-x="1280" 
+d="M1088 576v640h-448v-1137q119 63 213 137q235 184 235 360zM1280 1344v-768q0 -86 -33.5 -170.5t-83 -150t-118 -127.5t-126.5 -103t-121 -77.5t-89.5 -49.5t-42.5 -20q-12 -6 -26 -6t-26 6q-16 7 -42.5 20t-89.5 49.5t-121 77.5t-126.5 103t-118 127.5t-83 150
+t-33.5 170.5v768q0 26 19 45t45 19h1152q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="calendar_empty" unicode="&#xf133;" horiz-adv-x="1664" 
+d="M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280
+q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="fire_extinguisher" unicode="&#xf134;" horiz-adv-x="1408" 
+d="M512 1344q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1408 1376v-320q0 -16 -12 -25q-8 -7 -20 -7q-4 0 -7 1l-448 96q-11 2 -18 11t-7 20h-256v-102q111 -23 183.5 -111t72.5 -203v-800q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v800
+q0 106 62.5 190.5t161.5 114.5v111h-32q-59 0 -115 -23.5t-91.5 -53t-66 -66.5t-40.5 -53.5t-14 -24.5q-17 -35 -57 -35q-16 0 -29 7q-23 12 -31.5 37t3.5 49q5 10 14.5 26t37.5 53.5t60.5 70t85 67t108.5 52.5q-25 42 -25 86q0 66 47 113t113 47t113 -47t47 -113
+q0 -33 -14 -64h302q0 11 7 20t18 11l448 96q3 1 7 1q12 0 20 -7q12 -9 12 -25z" />
+    <glyph glyph-name="rocket" unicode="&#xf135;" horiz-adv-x="1664" 
+d="M1440 1088q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1664 1376q0 -249 -75.5 -430.5t-253.5 -360.5q-81 -80 -195 -176l-20 -379q-2 -16 -16 -26l-384 -224q-7 -4 -16 -4q-12 0 -23 9l-64 64q-13 14 -8 32l85 276l-281 281l-276 -85q-3 -1 -9 -1
+q-14 0 -23 9l-64 64q-17 19 -5 39l224 384q10 14 26 16l379 20q96 114 176 195q188 187 358 258t431 71q14 0 24 -9.5t10 -22.5z" />
+    <glyph glyph-name="maxcdn" unicode="&#xf136;" horiz-adv-x="1792" 
+d="M1745 763l-164 -763h-334l178 832q13 56 -15 88q-27 33 -83 33h-169l-204 -953h-334l204 953h-286l-204 -953h-334l204 953l-153 327h1276q101 0 189.5 -40.5t147.5 -113.5q60 -73 81 -168.5t0 -194.5z" />
+    <glyph glyph-name="chevron_sign_left" unicode="&#xf137;" 
+d="M909 141l102 102q19 19 19 45t-19 45l-307 307l307 307q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
+t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="chevron_sign_right" unicode="&#xf138;" 
+d="M717 141l454 454q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l307 -307l-307 -307q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
+t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="chevron_sign_up" unicode="&#xf139;" 
+d="M1165 397l102 102q19 19 19 45t-19 45l-454 454q-19 19 -45 19t-45 -19l-454 -454q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l307 307l307 -307q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
+t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="chevron_sign_down" unicode="&#xf13a;" 
+d="M813 237l454 454q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-307 -307l-307 307q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l454 -454q19 -19 45 -19t45 19zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5
+t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="html5" unicode="&#xf13b;" horiz-adv-x="1408" 
+d="M1130 939l16 175h-884l47 -534h612l-22 -228l-197 -53l-196 53l-13 140h-175l22 -278l362 -100h4v1l359 99l50 544h-644l-15 181h674zM0 1408h1408l-128 -1438l-578 -162l-574 162z" />
+    <glyph glyph-name="css3" unicode="&#xf13c;" horiz-adv-x="1792" 
+d="M275 1408h1505l-266 -1333l-804 -267l-698 267l71 356h297l-29 -147l422 -161l486 161l68 339h-1208l58 297h1209l38 191h-1208z" />
+    <glyph glyph-name="anchor" unicode="&#xf13d;" horiz-adv-x="1792" 
+d="M960 1280q0 26 -19 45t-45 19t-45 -19t-19 -45t19 -45t45 -19t45 19t19 45zM1792 352v-352q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-93 93q-119 -143 -318.5 -226.5t-429.5 -83.5t-429.5 83.5t-318.5 226.5l-93 -93q-9 -9 -23 -9q-4 0 -12 2q-20 8 -20 30v352
+q0 14 9 23t23 9h352q22 0 30 -20q8 -19 -7 -35l-100 -100q67 -91 189.5 -153.5t271.5 -82.5v647h-192q-26 0 -45 19t-19 45v128q0 26 19 45t45 19h192v163q-58 34 -93 92.5t-35 128.5q0 106 75 181t181 75t181 -75t75 -181q0 -70 -35 -128.5t-93 -92.5v-163h192q26 0 45 -19
+t19 -45v-128q0 -26 -19 -45t-45 -19h-192v-647q149 20 271.5 82.5t189.5 153.5l-100 100q-15 16 -7 35q8 20 30 20h352q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="unlock_alt" unicode="&#xf13e;" horiz-adv-x="1152" 
+d="M1056 768q40 0 68 -28t28 -68v-576q0 -40 -28 -68t-68 -28h-960q-40 0 -68 28t-28 68v576q0 40 28 68t68 28h32v320q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -26 -19 -45t-45 -19h-64q-26 0 -45 19t-19 45q0 106 -75 181t-181 75t-181 -75t-75 -181
+v-320h736z" />
+    <glyph glyph-name="bullseye" unicode="&#xf140;" 
+d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM1152 640q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1280 640q0 -212 -150 -362t-362 -150t-362 150
+t-150 362t150 362t362 150t362 -150t150 -362zM1408 640q0 130 -51 248.5t-136.5 204t-204 136.5t-248.5 51t-248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5zM1536 640
+q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="ellipsis_horizontal" unicode="&#xf141;" horiz-adv-x="1408" 
+d="M384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM896 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM1408 800v-192q0 -40 -28 -68t-68 -28h-192
+q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="ellipsis_vertical" unicode="&#xf142;" horiz-adv-x="384" 
+d="M384 288v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 800v-192q0 -40 -28 -68t-68 -28h-192q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68zM384 1312v-192q0 -40 -28 -68t-68 -28h-192
+q-40 0 -68 28t-28 68v192q0 40 28 68t68 28h192q40 0 68 -28t28 -68z" />
+    <glyph glyph-name="_303" unicode="&#xf143;" 
+d="M512 256q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM863 162q-13 233 -176.5 396.5t-396.5 176.5q-14 1 -24 -9t-10 -23v-128q0 -13 8.5 -22t21.5 -10q154 -11 264 -121t121 -264q1 -13 10 -21.5t22 -8.5h128
+q13 0 23 10t9 24zM1247 161q-5 154 -56 297.5t-139.5 260t-205 205t-260 139.5t-297.5 56q-14 1 -23 -9q-10 -10 -10 -23v-128q0 -13 9 -22t22 -10q204 -7 378 -111.5t278.5 -278.5t111.5 -378q1 -13 10 -22t22 -9h128q13 0 23 10q11 9 9 23zM1536 1120v-960
+q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="play_sign" unicode="&#xf144;" 
+d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM1152 585q32 18 32 55t-32 55l-544 320q-31 19 -64 1q-32 -19 -32 -56v-640q0 -37 32 -56
+q16 -8 32 -8q17 0 32 9z" />
+    <glyph glyph-name="ticket" unicode="&#xf145;" horiz-adv-x="1792" 
+d="M1024 1084l316 -316l-572 -572l-316 316zM813 105l618 618q19 19 19 45t-19 45l-362 362q-18 18 -45 18t-45 -18l-618 -618q-19 -19 -19 -45t19 -45l362 -362q18 -18 45 -18t45 18zM1702 742l-907 -908q-37 -37 -90.5 -37t-90.5 37l-126 126q56 56 56 136t-56 136
+t-136 56t-136 -56l-125 126q-37 37 -37 90.5t37 90.5l907 906q37 37 90.5 37t90.5 -37l125 -125q-56 -56 -56 -136t56 -136t136 -56t136 56l126 -125q37 -37 37 -90.5t-37 -90.5z" />
+    <glyph glyph-name="minus_sign_alt" unicode="&#xf146;" 
+d="M1280 576v128q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-128q0 -26 19 -45t45 -19h896q26 0 45 19t19 45zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
+t84.5 -203.5z" />
+    <glyph glyph-name="check_minus" unicode="&#xf147;" horiz-adv-x="1408" 
+d="M1152 736v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h832q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5
+t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="level_up" unicode="&#xf148;" horiz-adv-x="1024" 
+d="M1018 933q-18 -37 -58 -37h-192v-864q0 -14 -9 -23t-23 -9h-704q-21 0 -29 18q-8 20 4 35l160 192q9 11 25 11h320v640h-192q-40 0 -58 37q-17 37 9 68l320 384q18 22 49 22t49 -22l320 -384q27 -32 9 -68z" />
+    <glyph glyph-name="level_down" unicode="&#xf149;" horiz-adv-x="1024" 
+d="M32 1280h704q13 0 22.5 -9.5t9.5 -23.5v-863h192q40 0 58 -37t-9 -69l-320 -384q-18 -22 -49 -22t-49 22l-320 384q-26 31 -9 69q18 37 58 37h192v640h-320q-14 0 -25 11l-160 192q-13 14 -4 34q9 19 29 19z" />
+    <glyph glyph-name="check_sign" unicode="&#xf14a;" 
+d="M685 237l614 614q19 19 19 45t-19 45l-102 102q-19 19 -45 19t-45 -19l-467 -467l-211 211q-19 19 -45 19t-45 -19l-102 -102q-19 -19 -19 -45t19 -45l358 -358q19 -19 45 -19t45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5
+t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="edit_sign" unicode="&#xf14b;" 
+d="M404 428l152 -152l-52 -52h-56v96h-96v56zM818 818q14 -13 -3 -30l-291 -291q-17 -17 -30 -3q-14 13 3 30l291 291q17 17 30 3zM544 128l544 544l-288 288l-544 -544v-288h288zM1152 736l92 92q28 28 28 68t-28 68l-152 152q-28 28 -68 28t-68 -28l-92 -92zM1536 1120
+v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_312" unicode="&#xf14c;" 
+d="M1280 608v480q0 26 -19 45t-45 19h-480q-42 0 -59 -39q-17 -41 14 -70l144 -144l-534 -534q-19 -19 -19 -45t19 -45l102 -102q19 -19 45 -19t45 19l534 534l144 -144q18 -19 45 -19q12 0 25 5q39 17 39 59zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960
+q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="share_sign" unicode="&#xf14d;" 
+d="M1005 435l352 352q19 19 19 45t-19 45l-352 352q-30 31 -69 14q-40 -17 -40 -59v-160q-119 0 -216 -19.5t-162.5 -51t-114 -79t-76.5 -95.5t-44.5 -109t-21.5 -111.5t-5 -110.5q0 -181 167 -404q11 -12 25 -12q7 0 13 3q22 9 19 33q-44 354 62 473q46 52 130 75.5
+t224 23.5v-160q0 -42 40 -59q12 -5 24 -5q26 0 45 19zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="compass" unicode="&#xf14e;" 
+d="M640 448l256 128l-256 128v-256zM1024 1039v-542l-512 -256v542zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
+t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="collapse" unicode="&#xf150;" 
+d="M1145 861q18 -35 -5 -66l-320 -448q-19 -27 -52 -27t-52 27l-320 448q-23 31 -5 66q17 35 57 35h640q40 0 57 -35zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120
+v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="collapse_top" unicode="&#xf151;" 
+d="M1145 419q-17 -35 -57 -35h-640q-40 0 -57 35q-18 35 5 66l320 448q19 27 52 27t52 -27l320 -448q23 -31 5 -66zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1536 1120v-960
+q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_317" unicode="&#xf152;" 
+d="M1088 640q0 -33 -27 -52l-448 -320q-31 -23 -66 -5q-35 17 -35 57v640q0 40 35 57q35 18 66 -5l448 -320q27 -19 27 -52zM1280 160v960q0 14 -9 23t-23 9h-960q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h960q14 0 23 9t9 23zM1536 1120v-960q0 -119 -84.5 -203.5
+t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="eur" unicode="&#xf153;" horiz-adv-x="1024" 
+d="M976 229l35 -159q3 -12 -3 -22.5t-17 -14.5l-5 -1q-4 -2 -10.5 -3.5t-16 -4.5t-21.5 -5.5t-25.5 -5t-30 -5t-33.5 -4.5t-36.5 -3t-38.5 -1q-234 0 -409 130.5t-238 351.5h-95q-13 0 -22.5 9.5t-9.5 22.5v113q0 13 9.5 22.5t22.5 9.5h66q-2 57 1 105h-67q-14 0 -23 9
+t-9 23v114q0 14 9 23t23 9h98q67 210 243.5 338t400.5 128q102 0 194 -23q11 -3 20 -15q6 -11 3 -24l-43 -159q-3 -13 -14 -19.5t-24 -2.5l-4 1q-4 1 -11.5 2.5l-17.5 3.5t-22.5 3.5t-26 3t-29 2.5t-29.5 1q-126 0 -226 -64t-150 -176h468q16 0 25 -12q10 -12 7 -26
+l-24 -114q-5 -26 -32 -26h-488q-3 -37 0 -105h459q15 0 25 -12q9 -12 6 -27l-24 -112q-2 -11 -11 -18.5t-20 -7.5h-387q48 -117 149.5 -185.5t228.5 -68.5q18 0 36 1.5t33.5 3.5t29.5 4.5t24.5 5t18.5 4.5l12 3l5 2q13 5 26 -2q12 -7 15 -21z" />
+    <glyph glyph-name="gbp" unicode="&#xf154;" horiz-adv-x="1024" 
+d="M1020 399v-367q0 -14 -9 -23t-23 -9h-956q-14 0 -23 9t-9 23v150q0 13 9.5 22.5t22.5 9.5h97v383h-95q-14 0 -23 9.5t-9 22.5v131q0 14 9 23t23 9h95v223q0 171 123.5 282t314.5 111q185 0 335 -125q9 -8 10 -20.5t-7 -22.5l-103 -127q-9 -11 -22 -12q-13 -2 -23 7
+q-5 5 -26 19t-69 32t-93 18q-85 0 -137 -47t-52 -123v-215h305q13 0 22.5 -9t9.5 -23v-131q0 -13 -9.5 -22.5t-22.5 -9.5h-305v-379h414v181q0 13 9 22.5t23 9.5h162q14 0 23 -9.5t9 -22.5z" />
+    <glyph glyph-name="usd" unicode="&#xf155;" horiz-adv-x="1024" 
+d="M978 351q0 -153 -99.5 -263.5t-258.5 -136.5v-175q0 -14 -9 -23t-23 -9h-135q-13 0 -22.5 9.5t-9.5 22.5v175q-66 9 -127.5 31t-101.5 44.5t-74 48t-46.5 37.5t-17.5 18q-17 21 -2 41l103 135q7 10 23 12q15 2 24 -9l2 -2q113 -99 243 -125q37 -8 74 -8q81 0 142.5 43
+t61.5 122q0 28 -15 53t-33.5 42t-58.5 37.5t-66 32t-80 32.5q-39 16 -61.5 25t-61.5 26.5t-62.5 31t-56.5 35.5t-53.5 42.5t-43.5 49t-35.5 58t-21 66.5t-8.5 78q0 138 98 242t255 134v180q0 13 9.5 22.5t22.5 9.5h135q14 0 23 -9t9 -23v-176q57 -6 110.5 -23t87 -33.5
+t63.5 -37.5t39 -29t15 -14q17 -18 5 -38l-81 -146q-8 -15 -23 -16q-14 -3 -27 7q-3 3 -14.5 12t-39 26.5t-58.5 32t-74.5 26t-85.5 11.5q-95 0 -155 -43t-60 -111q0 -26 8.5 -48t29.5 -41.5t39.5 -33t56 -31t60.5 -27t70 -27.5q53 -20 81 -31.5t76 -35t75.5 -42.5t62 -50
+t53 -63.5t31.5 -76.5t13 -94z" />
+    <glyph glyph-name="inr" unicode="&#xf156;" horiz-adv-x="898" 
+d="M898 1066v-102q0 -14 -9 -23t-23 -9h-168q-23 -144 -129 -234t-276 -110q167 -178 459 -536q14 -16 4 -34q-8 -18 -29 -18h-195q-16 0 -25 12q-306 367 -498 571q-9 9 -9 22v127q0 13 9.5 22.5t22.5 9.5h112q132 0 212.5 43t102.5 125h-427q-14 0 -23 9t-9 23v102
+q0 14 9 23t23 9h413q-57 113 -268 113h-145q-13 0 -22.5 9.5t-9.5 22.5v133q0 14 9 23t23 9h832q14 0 23 -9t9 -23v-102q0 -14 -9 -23t-23 -9h-233q47 -61 64 -144h171q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="jpy" unicode="&#xf157;" horiz-adv-x="1027" 
+d="M603 0h-172q-13 0 -22.5 9t-9.5 23v330h-288q-13 0 -22.5 9t-9.5 23v103q0 13 9.5 22.5t22.5 9.5h288v85h-288q-13 0 -22.5 9t-9.5 23v104q0 13 9.5 22.5t22.5 9.5h214l-321 578q-8 16 0 32q10 16 28 16h194q19 0 29 -18l215 -425q19 -38 56 -125q10 24 30.5 68t27.5 61
+l191 420q8 19 29 19h191q17 0 27 -16q9 -14 1 -31l-313 -579h215q13 0 22.5 -9.5t9.5 -22.5v-104q0 -14 -9.5 -23t-22.5 -9h-290v-85h290q13 0 22.5 -9.5t9.5 -22.5v-103q0 -14 -9.5 -23t-22.5 -9h-290v-330q0 -13 -9.5 -22.5t-22.5 -9.5z" />
+    <glyph glyph-name="rub" unicode="&#xf158;" horiz-adv-x="1280" 
+d="M1043 971q0 100 -65 162t-171 62h-320v-448h320q106 0 171 62t65 162zM1280 971q0 -193 -126.5 -315t-326.5 -122h-340v-118h505q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-505v-192q0 -14 -9.5 -23t-22.5 -9h-167q-14 0 -23 9t-9 23v192h-224q-14 0 -23 9t-9 23v128
+q0 14 9 23t23 9h224v118h-224q-14 0 -23 9t-9 23v149q0 13 9 22.5t23 9.5h224v629q0 14 9 23t23 9h539q200 0 326.5 -122t126.5 -315z" />
+    <glyph glyph-name="krw" unicode="&#xf159;" horiz-adv-x="1792" 
+d="M514 341l81 299h-159l75 -300q1 -1 1 -3t1 -3q0 1 0.5 3.5t0.5 3.5zM630 768l35 128h-292l32 -128h225zM822 768h139l-35 128h-70zM1271 340l78 300h-162l81 -299q0 -1 0.5 -3.5t1.5 -3.5q0 1 0.5 3t0.5 3zM1382 768l33 128h-297l34 -128h230zM1792 736v-64q0 -14 -9 -23
+t-23 -9h-213l-164 -616q-7 -24 -31 -24h-159q-24 0 -31 24l-166 616h-209l-167 -616q-7 -24 -31 -24h-159q-11 0 -19.5 7t-10.5 17l-160 616h-208q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h175l-33 128h-142q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h109l-89 344q-5 15 5 28
+q10 12 26 12h137q26 0 31 -24l90 -360h359l97 360q7 24 31 24h126q24 0 31 -24l98 -360h365l93 360q5 24 31 24h137q16 0 26 -12q10 -13 5 -28l-91 -344h111q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-145l-34 -128h179q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="btc" unicode="&#xf15a;" horiz-adv-x="1280" 
+d="M1167 896q18 -182 -131 -258q117 -28 175 -103t45 -214q-7 -71 -32.5 -125t-64.5 -89t-97 -58.5t-121.5 -34.5t-145.5 -15v-255h-154v251q-80 0 -122 1v-252h-154v255q-18 0 -54 0.5t-55 0.5h-200l31 183h111q50 0 58 51v402h16q-6 1 -16 1v287q-13 68 -89 68h-111v164
+l212 -1q64 0 97 1v252h154v-247q82 2 122 2v245h154v-252q79 -7 140 -22.5t113 -45t82.5 -78t36.5 -114.5zM952 351q0 36 -15 64t-37 46t-57.5 30.5t-65.5 18.5t-74 9t-69 3t-64.5 -1t-47.5 -1v-338q8 0 37 -0.5t48 -0.5t53 1.5t58.5 4t57 8.5t55.5 14t47.5 21t39.5 30
+t24.5 40t9.5 51zM881 827q0 33 -12.5 58.5t-30.5 42t-48 28t-55 16.5t-61.5 8t-58 2.5t-54 -1t-39.5 -0.5v-307q5 0 34.5 -0.5t46.5 0t50 2t55 5.5t51.5 11t48.5 18.5t37 27t27 38.5t9 51z" />
+    <glyph glyph-name="file" unicode="&#xf15b;" 
+d="M1024 1024v472q22 -14 36 -28l408 -408q14 -14 28 -36h-472zM896 992q0 -40 28 -68t68 -28h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544z" />
+    <glyph glyph-name="file_text" unicode="&#xf15c;" 
+d="M1468 1060q14 -14 28 -36h-472v472q22 -14 36 -28zM992 896h544v-1056q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h800v-544q0 -40 28 -68t68 -28zM1152 160v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704
+q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23z" />
+    <glyph glyph-name="sort_by_alphabet" unicode="&#xf15d;" horiz-adv-x="1664" 
+d="M1191 1128h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1572 -23
+v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -11v-2l14 2q9 2 30 2h248v119h121zM1661 874v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162
+l230 -662h70z" />
+    <glyph glyph-name="_329" unicode="&#xf15e;" horiz-adv-x="1664" 
+d="M1191 104h177l-72 218l-12 47q-2 16 -2 20h-4l-3 -20q0 -1 -3.5 -18t-7.5 -29zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1661 -150
+v-106h-288v106h75l-47 144h-243l-47 -144h75v-106h-287v106h70l230 662h162l230 -662h70zM1572 1001v-233h-584v90l369 529q12 18 21 27l11 9v3q-2 0 -6.5 -0.5t-7.5 -0.5q-12 -3 -30 -3h-232v-115h-120v229h567v-89l-369 -530q-6 -8 -21 -26l-11 -10v-3l14 3q9 1 30 1h248
+v119h121z" />
+    <glyph glyph-name="sort_by_attributes" unicode="&#xf160;" horiz-adv-x="1792" 
+d="M736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23zM1792 -32v-192q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832
+q14 0 23 -9t9 -23zM1600 480v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1408 992v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1216 1504v-192q0 -14 -9 -23t-23 -9h-256
+q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="sort_by_attributes_alt" unicode="&#xf161;" horiz-adv-x="1792" 
+d="M1216 -32v-192q0 -14 -9 -23t-23 -9h-256q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h256q14 0 23 -9t9 -23zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192
+q14 0 23 -9t9 -23zM1408 480v-192q0 -14 -9 -23t-23 -9h-448q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h448q14 0 23 -9t9 -23zM1600 992v-192q0 -14 -9 -23t-23 -9h-640q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h640q14 0 23 -9t9 -23zM1792 1504v-192q0 -14 -9 -23t-23 -9h-832
+q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h832q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="sort_by_order" unicode="&#xf162;" 
+d="M1346 223q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9t9 -23
+zM1486 165q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5
+t82 -252.5zM1456 882v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165z" />
+    <glyph glyph-name="sort_by_order_alt" unicode="&#xf163;" 
+d="M1346 1247q0 63 -44 116t-103 53q-52 0 -83 -37t-31 -94t36.5 -95t104.5 -38q50 0 85 27t35 68zM736 96q0 -12 -10 -24l-319 -319q-10 -9 -23 -9q-12 0 -23 9l-320 320q-15 16 -7 35q8 20 30 20h192v1376q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1376h192q14 0 23 -9
+t9 -23zM1456 -142v-114h-469v114h167v432q0 7 0.5 19t0.5 17v16h-2l-7 -12q-8 -13 -26 -31l-62 -58l-82 86l192 185h123v-654h165zM1486 1189q0 -62 -13 -121.5t-41 -114t-68 -95.5t-98.5 -65.5t-127.5 -24.5q-62 0 -108 16q-24 8 -42 15l39 113q15 -7 31 -11q37 -13 75 -13
+q84 0 134.5 58.5t66.5 145.5h-2q-21 -23 -61.5 -37t-84.5 -14q-106 0 -173 71.5t-67 172.5q0 105 72 178t181 73q123 0 205 -94.5t82 -252.5z" />
+    <glyph glyph-name="_334" unicode="&#xf164;" horiz-adv-x="1664" 
+d="M256 192q0 26 -19 45t-45 19q-27 0 -45.5 -19t-18.5 -45q0 -27 18.5 -45.5t45.5 -18.5q26 0 45 18.5t19 45.5zM416 704v-640q0 -26 -19 -45t-45 -19h-288q-26 0 -45 19t-19 45v640q0 26 19 45t45 19h288q26 0 45 -19t19 -45zM1600 704q0 -86 -55 -149q15 -44 15 -76
+q3 -76 -43 -137q17 -56 0 -117q-15 -57 -54 -94q9 -112 -49 -181q-64 -76 -197 -78h-36h-76h-17q-66 0 -144 15.5t-121.5 29t-120.5 39.5q-123 43 -158 44q-26 1 -45 19.5t-19 44.5v641q0 25 18 43.5t43 20.5q24 2 76 59t101 121q68 87 101 120q18 18 31 48t17.5 48.5
+t13.5 60.5q7 39 12.5 61t19.5 52t34 50q19 19 45 19q46 0 82.5 -10.5t60 -26t40 -40.5t24 -45t12 -50t5 -45t0.5 -39q0 -38 -9.5 -76t-19 -60t-27.5 -56q-3 -6 -10 -18t-11 -22t-8 -24h277q78 0 135 -57t57 -135z" />
+    <glyph glyph-name="_335" unicode="&#xf165;" horiz-adv-x="1664" 
+d="M256 960q0 -26 -19 -45t-45 -19q-27 0 -45.5 19t-18.5 45q0 27 18.5 45.5t45.5 18.5q26 0 45 -18.5t19 -45.5zM416 448v640q0 26 -19 45t-45 19h-288q-26 0 -45 -19t-19 -45v-640q0 -26 19 -45t45 -19h288q26 0 45 19t19 45zM1545 597q55 -61 55 -149q-1 -78 -57.5 -135
+t-134.5 -57h-277q4 -14 8 -24t11 -22t10 -18q18 -37 27 -57t19 -58.5t10 -76.5q0 -24 -0.5 -39t-5 -45t-12 -50t-24 -45t-40 -40.5t-60 -26t-82.5 -10.5q-26 0 -45 19q-20 20 -34 50t-19.5 52t-12.5 61q-9 42 -13.5 60.5t-17.5 48.5t-31 48q-33 33 -101 120q-49 64 -101 121
+t-76 59q-25 2 -43 20.5t-18 43.5v641q0 26 19 44.5t45 19.5q35 1 158 44q77 26 120.5 39.5t121.5 29t144 15.5h17h76h36q133 -2 197 -78q58 -69 49 -181q39 -37 54 -94q17 -61 0 -117q46 -61 43 -137q0 -32 -15 -76z" />
+    <glyph glyph-name="youtube_sign" unicode="&#xf166;" 
+d="M919 233v157q0 50 -29 50q-17 0 -33 -16v-224q16 -16 33 -16q29 0 29 49zM1103 355h66v34q0 51 -33 51t-33 -51v-34zM532 621v-70h-80v-423h-74v423h-78v70h232zM733 495v-367h-67v40q-39 -45 -76 -45q-33 0 -42 28q-6 17 -6 54v290h66v-270q0 -24 1 -26q1 -15 15 -15
+q20 0 42 31v280h67zM985 384v-146q0 -52 -7 -73q-12 -42 -53 -42q-35 0 -68 41v-36h-67v493h67v-161q32 40 68 40q41 0 53 -42q7 -21 7 -74zM1236 255v-9q0 -29 -2 -43q-3 -22 -15 -40q-27 -40 -80 -40q-52 0 -81 38q-21 27 -21 86v129q0 59 20 86q29 38 80 38t78 -38
+q21 -29 21 -86v-76h-133v-65q0 -51 34 -51q24 0 30 26q0 1 0.5 7t0.5 16.5v21.5h68zM785 1079v-156q0 -51 -32 -51t-32 51v156q0 52 32 52t32 -52zM1318 366q0 177 -19 260q-10 44 -43 73.5t-76 34.5q-136 15 -412 15q-275 0 -411 -15q-44 -5 -76.5 -34.5t-42.5 -73.5
+q-20 -87 -20 -260q0 -176 20 -260q10 -43 42.5 -73t75.5 -35q137 -15 412 -15t412 15q43 5 75.5 35t42.5 73q20 84 20 260zM563 1017l90 296h-75l-51 -195l-53 195h-78q7 -23 23 -69l24 -69q35 -103 46 -158v-201h74v201zM852 936v130q0 58 -21 87q-29 38 -78 38
+q-51 0 -78 -38q-21 -29 -21 -87v-130q0 -58 21 -87q27 -38 78 -38q49 0 78 38q21 27 21 87zM1033 816h67v370h-67v-283q-22 -31 -42 -31q-15 0 -16 16q-1 2 -1 26v272h-67v-293q0 -37 6 -55q11 -27 43 -27q36 0 77 45v-40zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5
+h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="youtube" unicode="&#xf167;" 
+d="M971 292v-211q0 -67 -39 -67q-23 0 -45 22v301q22 22 45 22q39 0 39 -67zM1309 291v-46h-90v46q0 68 45 68t45 -68zM343 509h107v94h-312v-94h105v-569h100v569zM631 -60h89v494h-89v-378q-30 -42 -57 -42q-18 0 -21 21q-1 3 -1 35v364h-89v-391q0 -49 8 -73
+q12 -37 58 -37q48 0 102 61v-54zM1060 88v197q0 73 -9 99q-17 56 -71 56q-50 0 -93 -54v217h-89v-663h89v48q45 -55 93 -55q54 0 71 55q9 27 9 100zM1398 98v13h-91q0 -51 -2 -61q-7 -36 -40 -36q-46 0 -46 69v87h179v103q0 79 -27 116q-39 51 -106 51q-68 0 -107 -51
+q-28 -37 -28 -116v-173q0 -79 29 -116q39 -51 108 -51q72 0 108 53q18 27 21 54q2 9 2 58zM790 1011v210q0 69 -43 69t-43 -69v-210q0 -70 43 -70t43 70zM1509 260q0 -234 -26 -350q-14 -59 -58 -99t-102 -46q-184 -21 -555 -21t-555 21q-58 6 -102.5 46t-57.5 99
+q-26 112 -26 350q0 234 26 350q14 59 58 99t103 47q183 20 554 20t555 -20q58 -7 102.5 -47t57.5 -99q26 -112 26 -350zM511 1536h102l-121 -399v-271h-100v271q-14 74 -61 212q-37 103 -65 187h106l71 -263zM881 1203v-175q0 -81 -28 -118q-38 -51 -106 -51q-67 0 -105 51
+q-28 38 -28 118v175q0 80 28 117q38 51 105 51q68 0 106 -51q28 -37 28 -117zM1216 1365v-499h-91v55q-53 -62 -103 -62q-46 0 -59 37q-8 24 -8 75v394h91v-367q0 -33 1 -35q3 -22 21 -22q27 0 57 43v381h91z" />
+    <glyph glyph-name="xing" unicode="&#xf168;" horiz-adv-x="1408" 
+d="M597 869q-10 -18 -257 -456q-27 -46 -65 -46h-239q-21 0 -31 17t0 36l253 448q1 0 0 1l-161 279q-12 22 -1 37q9 15 32 15h239q40 0 66 -45zM1403 1511q11 -16 0 -37l-528 -934v-1l336 -615q11 -20 1 -37q-10 -15 -32 -15h-239q-42 0 -66 45l-339 622q18 32 531 942
+q25 45 64 45h241q22 0 31 -15z" />
+    <glyph glyph-name="xing_sign" unicode="&#xf169;" 
+d="M685 771q0 1 -126 222q-21 34 -52 34h-184q-18 0 -26 -11q-7 -12 1 -29l125 -216v-1l-196 -346q-9 -14 0 -28q8 -13 24 -13h185q31 0 50 36zM1309 1268q-7 12 -24 12h-187q-30 0 -49 -35l-411 -729q1 -2 262 -481q20 -35 52 -35h184q18 0 25 12q8 13 -1 28l-260 476v1
+l409 723q8 16 0 28zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="youtube_play" unicode="&#xf16a;" horiz-adv-x="1792" 
+d="M711 408l484 250l-484 253v-503zM896 1270q168 0 324.5 -4.5t229.5 -9.5l73 -4q1 0 17 -1.5t23 -3t23.5 -4.5t28.5 -8t28 -13t31 -19.5t29 -26.5q6 -6 15.5 -18.5t29 -58.5t26.5 -101q8 -64 12.5 -136.5t5.5 -113.5v-40v-136q1 -145 -18 -290q-7 -55 -25 -99.5t-32 -61.5
+l-14 -17q-14 -15 -29 -26.5t-31 -19t-28 -12.5t-28.5 -8t-24 -4.5t-23 -3t-16.5 -1.5q-251 -19 -627 -19q-207 2 -359.5 6.5t-200.5 7.5l-49 4l-36 4q-36 5 -54.5 10t-51 21t-56.5 41q-6 6 -15.5 18.5t-29 58.5t-26.5 101q-8 64 -12.5 136.5t-5.5 113.5v40v136
+q-1 145 18 290q7 55 25 99.5t32 61.5l14 17q14 15 29 26.5t31 19.5t28 13t28.5 8t23.5 4.5t23 3t17 1.5q251 18 627 18z" />
+    <glyph glyph-name="dropbox" unicode="&#xf16b;" horiz-adv-x="1792" 
+d="M402 829l494 -305l-342 -285l-490 319zM1388 274v-108l-490 -293v-1l-1 1l-1 -1v1l-489 293v108l147 -96l342 284v2l1 -1l1 1v-2l343 -284zM554 1418l342 -285l-494 -304l-338 270zM1390 829l338 -271l-489 -319l-343 285zM1239 1418l489 -319l-338 -270l-494 304z" />
+    <glyph glyph-name="stackexchange" unicode="&#xf16c;" 
+d="M1289 -96h-1118v480h-160v-640h1438v640h-160v-480zM347 428l33 157l783 -165l-33 -156zM450 802l67 146l725 -339l-67 -145zM651 1158l102 123l614 -513l-102 -123zM1048 1536l477 -641l-128 -96l-477 641zM330 65v159h800v-159h-800z" />
+    <glyph glyph-name="instagram" unicode="&#xf16d;" 
+d="M1024 640q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM1162 640q0 -164 -115 -279t-279 -115t-279 115t-115 279t115 279t279 115t279 -115t115 -279zM1270 1050q0 -38 -27 -65t-65 -27t-65 27t-27 65t27 65t65 27t65 -27t27 -65zM768 1270
+q-7 0 -76.5 0.5t-105.5 0t-96.5 -3t-103 -10t-71.5 -18.5q-50 -20 -88 -58t-58 -88q-11 -29 -18.5 -71.5t-10 -103t-3 -96.5t0 -105.5t0.5 -76.5t-0.5 -76.5t0 -105.5t3 -96.5t10 -103t18.5 -71.5q20 -50 58 -88t88 -58q29 -11 71.5 -18.5t103 -10t96.5 -3t105.5 0t76.5 0.5
+t76.5 -0.5t105.5 0t96.5 3t103 10t71.5 18.5q50 20 88 58t58 88q11 29 18.5 71.5t10 103t3 96.5t0 105.5t-0.5 76.5t0.5 76.5t0 105.5t-3 96.5t-10 103t-18.5 71.5q-20 50 -58 88t-88 58q-29 11 -71.5 18.5t-103 10t-96.5 3t-105.5 0t-76.5 -0.5zM1536 640q0 -229 -5 -317
+q-10 -208 -124 -322t-322 -124q-88 -5 -317 -5t-317 5q-208 10 -322 124t-124 322q-5 88 -5 317t5 317q10 208 124 322t322 124q88 5 317 5t317 -5q208 -10 322 -124t124 -322q5 -88 5 -317z" />
+    <glyph glyph-name="flickr" unicode="&#xf16e;" 
+d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM698 640q0 88 -62 150t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150zM1262 640q0 88 -62 150
+t-150 62t-150 -62t-62 -150t62 -150t150 -62t150 62t62 150z" />
+    <glyph glyph-name="adn" unicode="&#xf170;" 
+d="M768 914l201 -306h-402zM1133 384h94l-459 691l-459 -691h94l104 160h522zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="f171" unicode="&#xf171;" horiz-adv-x="1408" 
+d="M815 677q8 -63 -50.5 -101t-111.5 -6q-39 17 -53.5 58t-0.5 82t52 58q36 18 72.5 12t64 -35.5t27.5 -67.5zM926 698q-14 107 -113 164t-197 13q-63 -28 -100.5 -88.5t-34.5 -129.5q4 -91 77.5 -155t165.5 -56q91 8 152 84t50 168zM1165 1240q-20 27 -56 44.5t-58 22
+t-71 12.5q-291 47 -566 -2q-43 -7 -66 -12t-55 -22t-50 -43q30 -28 76 -45.5t73.5 -22t87.5 -11.5q228 -29 448 -1q63 8 89.5 12t72.5 21.5t75 46.5zM1222 205q-8 -26 -15.5 -76.5t-14 -84t-28.5 -70t-58 -56.5q-86 -48 -189.5 -71.5t-202 -22t-201.5 18.5q-46 8 -81.5 18
+t-76.5 27t-73 43.5t-52 61.5q-25 96 -57 292l6 16l18 9q223 -148 506.5 -148t507.5 148q21 -6 24 -23t-5 -45t-8 -37zM1403 1166q-26 -167 -111 -655q-5 -30 -27 -56t-43.5 -40t-54.5 -31q-252 -126 -610 -88q-248 27 -394 139q-15 12 -25.5 26.5t-17 35t-9 34t-6 39.5
+t-5.5 35q-9 50 -26.5 150t-28 161.5t-23.5 147.5t-22 158q3 26 17.5 48.5t31.5 37.5t45 30t46 22.5t48 18.5q125 46 313 64q379 37 676 -50q155 -46 215 -122q16 -20 16.5 -51t-5.5 -54z" />
+    <glyph glyph-name="bitbucket_sign" unicode="&#xf172;" 
+d="M848 666q0 43 -41 66t-77 1q-43 -20 -42.5 -72.5t43.5 -70.5q39 -23 81 4t36 72zM928 682q8 -66 -36 -121t-110 -61t-119 40t-56 113q-2 49 25.5 93t72.5 64q70 31 141.5 -10t81.5 -118zM1100 1073q-20 -21 -53.5 -34t-53 -16t-63.5 -8q-155 -20 -324 0q-44 6 -63 9.5
+t-52.5 16t-54.5 32.5q13 19 36 31t40 15.5t47 8.5q198 35 408 1q33 -5 51 -8.5t43 -16t39 -31.5zM1142 327q0 7 5.5 26.5t3 32t-17.5 16.5q-161 -106 -365 -106t-366 106l-12 -6l-5 -12q26 -154 41 -210q47 -81 204 -108q249 -46 428 53q34 19 49 51.5t22.5 85.5t12.5 71z
+M1272 1020q9 53 -8 75q-43 55 -155 88q-216 63 -487 36q-132 -12 -226 -46q-38 -15 -59.5 -25t-47 -34t-29.5 -54q8 -68 19 -138t29 -171t24 -137q1 -5 5 -31t7 -36t12 -27t22 -28q105 -80 284 -100q259 -28 440 63q24 13 39.5 23t31 29t19.5 40q48 267 80 473zM1536 1120
+v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="tumblr" unicode="&#xf173;" horiz-adv-x="1024" 
+d="M944 207l80 -237q-23 -35 -111 -66t-177 -32q-104 -2 -190.5 26t-142.5 74t-95 106t-55.5 120t-16.5 118v544h-168v215q72 26 129 69.5t91 90t58 102t34 99t15 88.5q1 5 4.5 8.5t7.5 3.5h244v-424h333v-252h-334v-518q0 -30 6.5 -56t22.5 -52.5t49.5 -41.5t81.5 -14
+q78 2 134 29z" />
+    <glyph glyph-name="tumblr_sign" unicode="&#xf174;" 
+d="M1136 75l-62 183q-44 -22 -103 -22q-36 -1 -62 10.5t-38.5 31.5t-17.5 40.5t-5 43.5v398h257v194h-256v326h-188q-8 0 -9 -10q-5 -44 -17.5 -87t-39 -95t-77 -95t-118.5 -68v-165h130v-418q0 -57 21.5 -115t65 -111t121 -85.5t176.5 -30.5q69 1 136.5 25t85.5 50z
+M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="long_arrow_down" unicode="&#xf175;" horiz-adv-x="768" 
+d="M765 237q8 -19 -5 -35l-350 -384q-10 -10 -23 -10q-14 0 -24 10l-355 384q-13 16 -5 35q9 19 29 19h224v1248q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-1248h224q21 0 29 -19z" />
+    <glyph glyph-name="long_arrow_up" unicode="&#xf176;" horiz-adv-x="768" 
+d="M765 1043q-9 -19 -29 -19h-224v-1248q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v1248h-224q-21 0 -29 19t5 35l350 384q10 10 23 10q14 0 24 -10l355 -384q13 -16 5 -35z" />
+    <glyph glyph-name="long_arrow_left" unicode="&#xf177;" horiz-adv-x="1792" 
+d="M1792 736v-192q0 -14 -9 -23t-23 -9h-1248v-224q0 -21 -19 -29t-35 5l-384 350q-10 10 -10 23q0 14 10 24l384 354q16 14 35 6q19 -9 19 -29v-224h1248q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="long_arrow_right" unicode="&#xf178;" horiz-adv-x="1792" 
+d="M1728 643q0 -14 -10 -24l-384 -354q-16 -14 -35 -6q-19 9 -19 29v224h-1248q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h1248v224q0 21 19 29t35 -5l384 -350q10 -10 10 -23z" />
+    <glyph glyph-name="apple" unicode="&#xf179;" horiz-adv-x="1408" 
+d="M1393 321q-39 -125 -123 -250q-129 -196 -257 -196q-49 0 -140 32q-86 32 -151 32q-61 0 -142 -33q-81 -34 -132 -34q-152 0 -301 259q-147 261 -147 503q0 228 113 374q113 144 284 144q72 0 177 -30q104 -30 138 -30q45 0 143 34q102 34 173 34q119 0 213 -65
+q52 -36 104 -100q-79 -67 -114 -118q-65 -94 -65 -207q0 -124 69 -223t158 -126zM1017 1494q0 -61 -29 -136q-30 -75 -93 -138q-54 -54 -108 -72q-37 -11 -104 -17q3 149 78 257q74 107 250 148q1 -3 2.5 -11t2.5 -11q0 -4 0.5 -10t0.5 -10z" />
+    <glyph glyph-name="windows" unicode="&#xf17a;" horiz-adv-x="1664" 
+d="M682 530v-651l-682 94v557h682zM682 1273v-659h-682v565zM1664 530v-786l-907 125v661h907zM1664 1408v-794h-907v669z" />
+    <glyph glyph-name="android" unicode="&#xf17b;" horiz-adv-x="1408" 
+d="M493 1053q16 0 27.5 11.5t11.5 27.5t-11.5 27.5t-27.5 11.5t-27 -11.5t-11 -27.5t11 -27.5t27 -11.5zM915 1053q16 0 27 11.5t11 27.5t-11 27.5t-27 11.5t-27.5 -11.5t-11.5 -27.5t11.5 -27.5t27.5 -11.5zM103 869q42 0 72 -30t30 -72v-430q0 -43 -29.5 -73t-72.5 -30
+t-73 30t-30 73v430q0 42 30 72t73 30zM1163 850v-666q0 -46 -32 -78t-77 -32h-75v-227q0 -43 -30 -73t-73 -30t-73 30t-30 73v227h-138v-227q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73l-1 227h-74q-46 0 -78 32t-32 78v666h918zM931 1255q107 -55 171 -153.5t64 -215.5
+h-925q0 117 64 215.5t172 153.5l-71 131q-7 13 5 20q13 6 20 -6l72 -132q95 42 201 42t201 -42l72 132q7 12 20 6q12 -7 5 -20zM1408 767v-430q0 -43 -30 -73t-73 -30q-42 0 -72 30t-30 73v430q0 43 30 72.5t72 29.5q43 0 73 -29.5t30 -72.5z" />
+    <glyph glyph-name="linux" unicode="&#xf17c;" 
+d="M663 1125q-11 -1 -15.5 -10.5t-8.5 -9.5q-5 -1 -5 5q0 12 19 15h10zM750 1111q-4 -1 -11.5 6.5t-17.5 4.5q24 11 32 -2q3 -6 -3 -9zM399 684q-4 1 -6 -3t-4.5 -12.5t-5.5 -13.5t-10 -13q-10 -11 -1 -12q4 -1 12.5 7t12.5 18q1 3 2 7t2 6t1.5 4.5t0.5 4v3t-1 2.5t-3 2z
+M1254 325q0 18 -55 42q4 15 7.5 27.5t5 26t3 21.5t0.5 22.5t-1 19.5t-3.5 22t-4 20.5t-5 25t-5.5 26.5q-10 48 -47 103t-72 75q24 -20 57 -83q87 -162 54 -278q-11 -40 -50 -42q-31 -4 -38.5 18.5t-8 83.5t-11.5 107q-9 39 -19.5 69t-19.5 45.5t-15.5 24.5t-13 15t-7.5 7
+q-14 62 -31 103t-29.5 56t-23.5 33t-15 40q-4 21 6 53.5t4.5 49.5t-44.5 25q-15 3 -44.5 18t-35.5 16q-8 1 -11 26t8 51t36 27q37 3 51 -30t4 -58q-11 -19 -2 -26.5t30 -0.5q13 4 13 36v37q-5 30 -13.5 50t-21 30.5t-23.5 15t-27 7.5q-107 -8 -89 -134q0 -15 -1 -15
+q-9 9 -29.5 10.5t-33 -0.5t-15.5 5q1 57 -16 90t-45 34q-27 1 -41.5 -27.5t-16.5 -59.5q-1 -15 3.5 -37t13 -37.5t15.5 -13.5q10 3 16 14q4 9 -7 8q-7 0 -15.5 14.5t-9.5 33.5q-1 22 9 37t34 14q17 0 27 -21t9.5 -39t-1.5 -22q-22 -15 -31 -29q-8 -12 -27.5 -23.5
+t-20.5 -12.5q-13 -14 -15.5 -27t7.5 -18q14 -8 25 -19.5t16 -19t18.5 -13t35.5 -6.5q47 -2 102 15q2 1 23 7t34.5 10.5t29.5 13t21 17.5q9 14 20 8q5 -3 6.5 -8.5t-3 -12t-16.5 -9.5q-20 -6 -56.5 -21.5t-45.5 -19.5q-44 -19 -70 -23q-25 -5 -79 2q-10 2 -9 -2t17 -19
+q25 -23 67 -22q17 1 36 7t36 14t33.5 17.5t30 17t24.5 12t17.5 2.5t8.5 -11q0 -2 -1 -4.5t-4 -5t-6 -4.5t-8.5 -5t-9 -4.5t-10 -5t-9.5 -4.5q-28 -14 -67.5 -44t-66.5 -43t-49 -1q-21 11 -63 73q-22 31 -25 22q-1 -3 -1 -10q0 -25 -15 -56.5t-29.5 -55.5t-21 -58t11.5 -63
+q-23 -6 -62.5 -90t-47.5 -141q-2 -18 -1.5 -69t-5.5 -59q-8 -24 -29 -3q-32 31 -36 94q-2 28 4 56q4 19 -1 18q-2 -1 -4 -5q-36 -65 10 -166q5 -12 25 -28t24 -20q20 -23 104 -90.5t93 -76.5q16 -15 17.5 -38t-14 -43t-45.5 -23q8 -15 29 -44.5t28 -54t7 -70.5q46 24 7 92
+q-4 8 -10.5 16t-9.5 12t-2 6q3 5 13 9.5t20 -2.5q46 -52 166 -36q133 15 177 87q23 38 34 30q12 -6 10 -52q-1 -25 -23 -92q-9 -23 -6 -37.5t24 -15.5q3 19 14.5 77t13.5 90q2 21 -6.5 73.5t-7.5 97t23 70.5q15 18 51 18q1 37 34.5 53t72.5 10.5t60 -22.5zM626 1152
+q3 17 -2.5 30t-11.5 15q-9 2 -9 -7q2 -5 5 -6q10 0 7 -15q-3 -20 8 -20q3 0 3 3zM1045 955q-2 8 -6.5 11.5t-13 5t-14.5 5.5q-5 3 -9.5 8t-7 8t-5.5 6.5t-4 4t-4 -1.5q-14 -16 7 -43.5t39 -31.5q9 -1 14.5 8t3.5 20zM867 1168q0 11 -5 19.5t-11 12.5t-9 3q-6 0 -8 -2t0 -4
+t5 -3q14 -4 18 -31q0 -3 8 2q2 2 2 3zM921 1401q0 2 -2.5 5t-9 7t-9.5 6q-15 15 -24 15q-9 -1 -11.5 -7.5t-1 -13t-0.5 -12.5q-1 -4 -6 -10.5t-6 -9t3 -8.5q4 -3 8 0t11 9t15 9q1 1 9 1t15 2t9 7zM1486 60q20 -12 31 -24.5t12 -24t-2.5 -22.5t-15.5 -22t-23.5 -19.5
+t-30 -18.5t-31.5 -16.5t-32 -15.5t-27 -13q-38 -19 -85.5 -56t-75.5 -64q-17 -16 -68 -19.5t-89 14.5q-18 9 -29.5 23.5t-16.5 25.5t-22 19.5t-47 9.5q-44 1 -130 1q-19 0 -57 -1.5t-58 -2.5q-44 -1 -79.5 -15t-53.5 -30t-43.5 -28.5t-53.5 -11.5q-29 1 -111 31t-146 43
+q-19 4 -51 9.5t-50 9t-39.5 9.5t-33.5 14.5t-17 19.5q-10 23 7 66.5t18 54.5q1 16 -4 40t-10 42.5t-4.5 36.5t10.5 27q14 12 57 14t60 12q30 18 42 35t12 51q21 -73 -32 -106q-32 -20 -83 -15q-34 3 -43 -10q-13 -15 5 -57q2 -6 8 -18t8.5 -18t4.5 -17t1 -22q0 -15 -17 -49
+t-14 -48q3 -17 37 -26q20 -6 84.5 -18.5t99.5 -20.5q24 -6 74 -22t82.5 -23t55.5 -4q43 6 64.5 28t23 48t-7.5 58.5t-19 52t-20 36.5q-121 190 -169 242q-68 74 -113 40q-11 -9 -15 15q-3 16 -2 38q1 29 10 52t24 47t22 42q8 21 26.5 72t29.5 78t30 61t39 54
+q110 143 124 195q-12 112 -16 310q-2 90 24 151.5t106 104.5q39 21 104 21q53 1 106 -13.5t89 -41.5q57 -42 91.5 -121.5t29.5 -147.5q-5 -95 30 -214q34 -113 133 -218q55 -59 99.5 -163t59.5 -191q8 -49 5 -84.5t-12 -55.5t-20 -22q-10 -2 -23.5 -19t-27 -35.5
+t-40.5 -33.5t-61 -14q-18 1 -31.5 5t-22.5 13.5t-13.5 15.5t-11.5 20.5t-9 19.5q-22 37 -41 30t-28 -49t7 -97q20 -70 1 -195q-10 -65 18 -100.5t73 -33t85 35.5q59 49 89.5 66.5t103.5 42.5q53 18 77 36.5t18.5 34.5t-25 28.5t-51.5 23.5q-33 11 -49.5 48t-15 72.5
+t15.5 47.5q1 -31 8 -56.5t14.5 -40.5t20.5 -28.5t21 -19t21.5 -13t16.5 -9.5z" />
+    <glyph glyph-name="dribble" unicode="&#xf17d;" 
+d="M1024 36q-42 241 -140 498h-2l-2 -1q-16 -6 -43 -16.5t-101 -49t-137 -82t-131 -114.5t-103 -148l-15 11q184 -150 418 -150q132 0 256 52zM839 643q-21 49 -53 111q-311 -93 -673 -93q-1 -7 -1 -21q0 -124 44 -236.5t124 -201.5q50 89 123.5 166.5t142.5 124.5t130.5 81
+t99.5 48l37 13q4 1 13 3.5t13 4.5zM732 855q-120 213 -244 378q-138 -65 -234 -186t-128 -272q302 0 606 80zM1416 536q-210 60 -409 29q87 -239 128 -469q111 75 185 189.5t96 250.5zM611 1277q-1 0 -2 -1q1 1 2 1zM1201 1132q-185 164 -433 164q-76 0 -155 -19
+q131 -170 246 -382q69 26 130 60.5t96.5 61.5t65.5 57t37.5 40.5zM1424 647q-3 232 -149 410l-1 -1q-9 -12 -19 -24.5t-43.5 -44.5t-71 -60.5t-100 -65t-131.5 -64.5q25 -53 44 -95q2 -5 6.5 -17t7.5 -17q36 5 74.5 7t73.5 2t69 -1.5t64 -4t56.5 -5.5t48 -6.5t36.5 -6
+t25 -4.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="skype" unicode="&#xf17e;" 
+d="M1173 473q0 50 -19.5 91.5t-48.5 68.5t-73 49t-82.5 34t-87.5 23l-104 24q-30 7 -44 10.5t-35 11.5t-30 16t-16.5 21t-7.5 30q0 77 144 77q43 0 77 -12t54 -28.5t38 -33.5t40 -29t48 -12q47 0 75.5 32t28.5 77q0 55 -56 99.5t-142 67.5t-182 23q-68 0 -132 -15.5
+t-119.5 -47t-89 -87t-33.5 -128.5q0 -61 19 -106.5t56 -75.5t80 -48.5t103 -32.5l146 -36q90 -22 112 -36q32 -20 32 -60q0 -39 -40 -64.5t-105 -25.5q-51 0 -91.5 16t-65 38.5t-45.5 45t-46 38.5t-54 16q-50 0 -75.5 -30t-25.5 -75q0 -92 122 -157.5t291 -65.5
+q73 0 140 18.5t122.5 53.5t88.5 93.5t33 131.5zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5q-130 0 -234 80q-77 -16 -150 -16q-143 0 -273.5 55.5t-225 150t-150 225t-55.5 273.5q0 73 16 150q-80 104 -80 234q0 159 112.5 271.5t271.5 112.5q130 0 234 -80
+q77 16 150 16q143 0 273.5 -55.5t225 -150t150 -225t55.5 -273.5q0 -73 -16 -150q80 -104 80 -234z" />
+    <glyph glyph-name="foursquare" unicode="&#xf180;" horiz-adv-x="1280" 
+d="M1000 1102l37 194q5 23 -9 40t-35 17h-712q-23 0 -38.5 -17t-15.5 -37v-1101q0 -7 6 -1l291 352q23 26 38 33.5t48 7.5h239q22 0 37 14.5t18 29.5q24 130 37 191q4 21 -11.5 40t-36.5 19h-294q-29 0 -48 19t-19 48v42q0 29 19 47.5t48 18.5h346q18 0 35 13.5t20 29.5z
+M1227 1324q-15 -73 -53.5 -266.5t-69.5 -350t-35 -173.5q-6 -22 -9 -32.5t-14 -32.5t-24.5 -33t-38.5 -21t-58 -10h-271q-13 0 -22 -10q-8 -9 -426 -494q-22 -25 -58.5 -28.5t-48.5 5.5q-55 22 -55 98v1410q0 55 38 102.5t120 47.5h888q95 0 127 -53t10 -159zM1227 1324
+l-158 -790q4 17 35 173.5t69.5 350t53.5 266.5z" />
+    <glyph glyph-name="trello" unicode="&#xf181;" 
+d="M704 192v1024q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-1024q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1376 576v640q0 14 -9 23t-23 9h-480q-14 0 -23 -9t-9 -23v-640q0 -14 9 -23t23 -9h480q14 0 23 9t9 23zM1536 1344v-1408q0 -26 -19 -45t-45 -19h-1408
+q-26 0 -45 19t-19 45v1408q0 26 19 45t45 19h1408q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="female" unicode="&#xf182;" horiz-adv-x="1280" 
+d="M1280 480q0 -40 -28 -68t-68 -28q-51 0 -80 43l-227 341h-45v-132l247 -411q9 -15 9 -33q0 -26 -19 -45t-45 -19h-192v-272q0 -46 -33 -79t-79 -33h-160q-46 0 -79 33t-33 79v272h-192q-26 0 -45 19t-19 45q0 18 9 33l247 411v132h-45l-227 -341q-29 -43 -80 -43
+q-40 0 -68 28t-28 68q0 29 16 53l256 384q73 107 176 107h384q103 0 176 -107l256 -384q16 -24 16 -53zM864 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
+    <glyph glyph-name="male" unicode="&#xf183;" horiz-adv-x="1024" 
+d="M1024 832v-416q0 -40 -28 -68t-68 -28t-68 28t-28 68v352h-64v-912q0 -46 -33 -79t-79 -33t-79 33t-33 79v464h-64v-464q0 -46 -33 -79t-79 -33t-79 33t-33 79v912h-64v-352q0 -40 -28 -68t-68 -28t-68 28t-28 68v416q0 80 56 136t136 56h640q80 0 136 -56t56 -136z
+M736 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
+    <glyph glyph-name="gittip" unicode="&#xf184;" 
+d="M773 234l350 473q16 22 24.5 59t-6 85t-61.5 79q-40 26 -83 25.5t-73.5 -17.5t-54.5 -45q-36 -40 -96 -40q-59 0 -95 40q-24 28 -54.5 45t-73.5 17.5t-84 -25.5q-46 -31 -60.5 -79t-6 -85t24.5 -59zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
+t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="sun" unicode="&#xf185;" horiz-adv-x="1792" 
+d="M1472 640q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5t-223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5t45.5 -223.5t123 -184t184 -123t223.5 -45.5t223.5 45.5t184 123t123 184t45.5 223.5zM1748 363q-4 -15 -20 -20l-292 -96v-306q0 -16 -13 -26q-15 -10 -29 -4
+l-292 94l-180 -248q-10 -13 -26 -13t-26 13l-180 248l-292 -94q-14 -6 -29 4q-13 10 -13 26v306l-292 96q-16 5 -20 20q-5 17 4 29l180 248l-180 248q-9 13 -4 29q4 15 20 20l292 96v306q0 16 13 26q15 10 29 4l292 -94l180 248q9 12 26 12t26 -12l180 -248l292 94
+q14 6 29 -4q13 -10 13 -26v-306l292 -96q16 -5 20 -20q5 -16 -4 -29l-180 -248l180 -248q9 -12 4 -29z" />
+    <glyph glyph-name="_366" unicode="&#xf186;" 
+d="M1262 233q-54 -9 -110 -9q-182 0 -337 90t-245 245t-90 337q0 192 104 357q-201 -60 -328.5 -229t-127.5 -384q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51q144 0 273.5 61.5t220.5 171.5zM1465 318q-94 -203 -283.5 -324.5t-413.5 -121.5q-156 0 -298 61
+t-245 164t-164 245t-61 298q0 153 57.5 292.5t156 241.5t235.5 164.5t290 68.5q44 2 61 -39q18 -41 -15 -72q-86 -78 -131.5 -181.5t-45.5 -218.5q0 -148 73 -273t198 -198t273 -73q118 0 228 51q41 18 72 -13q14 -14 17.5 -34t-4.5 -38z" />
+    <glyph glyph-name="archive" unicode="&#xf187;" horiz-adv-x="1792" 
+d="M1088 704q0 26 -19 45t-45 19h-256q-26 0 -45 -19t-19 -45t19 -45t45 -19h256q26 0 45 19t19 45zM1664 896v-960q0 -26 -19 -45t-45 -19h-1408q-26 0 -45 19t-19 45v960q0 26 19 45t45 19h1408q26 0 45 -19t19 -45zM1728 1344v-256q0 -26 -19 -45t-45 -19h-1536
+q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h1536q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="bug" unicode="&#xf188;" horiz-adv-x="1664" 
+d="M1632 576q0 -26 -19 -45t-45 -19h-224q0 -171 -67 -290l208 -209q19 -19 19 -45t-19 -45q-18 -19 -45 -19t-45 19l-198 197q-5 -5 -15 -13t-42 -28.5t-65 -36.5t-82 -29t-97 -13v896h-128v-896q-51 0 -101.5 13.5t-87 33t-66 39t-43.5 32.5l-15 14l-183 -207
+q-20 -21 -48 -21q-24 0 -43 16q-19 18 -20.5 44.5t15.5 46.5l202 227q-58 114 -58 274h-224q-26 0 -45 19t-19 45t19 45t45 19h224v294l-173 173q-19 19 -19 45t19 45t45 19t45 -19l173 -173h844l173 173q19 19 45 19t45 -19t19 -45t-19 -45l-173 -173v-294h224q26 0 45 -19
+t19 -45zM1152 1152h-640q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5z" />
+    <glyph glyph-name="vk" unicode="&#xf189;" horiz-adv-x="1920" 
+d="M1917 1016q23 -64 -150 -294q-24 -32 -65 -85q-40 -51 -55 -72t-30.5 -49.5t-12 -42t13 -34.5t32.5 -43t57 -53q4 -2 5 -4q141 -131 191 -221q3 -5 6.5 -12.5t7 -26.5t-0.5 -34t-25 -27.5t-59 -12.5l-256 -4q-24 -5 -56 5t-52 22l-20 12q-30 21 -70 64t-68.5 77.5t-61 58
+t-56.5 15.5q-3 -1 -8 -3.5t-17 -14.5t-21.5 -29.5t-17 -52t-6.5 -77.5q0 -15 -3.5 -27.5t-7.5 -18.5l-4 -5q-18 -19 -53 -22h-115q-71 -4 -146 16.5t-131.5 53t-103 66t-70.5 57.5l-25 24q-10 10 -27.5 30t-71.5 91t-106 151t-122.5 211t-130.5 272q-6 16 -6 27t3 16l4 6
+q15 19 57 19l274 2q12 -2 23 -6.5t16 -8.5l5 -3q16 -11 24 -32q20 -50 46 -103.5t41 -81.5l16 -29q29 -60 56 -104t48.5 -68.5t41.5 -38.5t34 -14t27 5q2 1 5 5t12 22t13.5 47t9.5 81t0 125q-2 40 -9 73t-14 46l-6 12q-25 34 -85 43q-13 2 5 24q16 19 38 30q53 26 239 24
+q82 -1 135 -13q20 -5 33.5 -13.5t20.5 -24t10.5 -32t3.5 -45.5t-1 -55t-2.5 -70.5t-1.5 -82.5q0 -11 -1 -42t-0.5 -48t3.5 -40.5t11.5 -39t22.5 -24.5q8 -2 17 -4t26 11t38 34.5t52 67t68 107.5q60 104 107 225q4 10 10 17.5t11 10.5l4 3l5 2.5t13 3t20 0.5l288 2
+q39 5 64 -2.5t31 -16.5z" />
+    <glyph glyph-name="weibo" unicode="&#xf18a;" horiz-adv-x="1792" 
+d="M675 252q21 34 11 69t-45 50q-34 14 -73 1t-60 -46q-22 -34 -13 -68.5t43 -50.5t74.5 -2.5t62.5 47.5zM769 373q8 13 3.5 26.5t-17.5 18.5q-14 5 -28.5 -0.5t-21.5 -18.5q-17 -31 13 -45q14 -5 29 0.5t22 18.5zM943 266q-45 -102 -158 -150t-224 -12
+q-107 34 -147.5 126.5t6.5 187.5q47 93 151.5 139t210.5 19q111 -29 158.5 -119.5t2.5 -190.5zM1255 426q-9 96 -89 170t-208.5 109t-274.5 21q-223 -23 -369.5 -141.5t-132.5 -264.5q9 -96 89 -170t208.5 -109t274.5 -21q223 23 369.5 141.5t132.5 264.5zM1563 422
+q0 -68 -37 -139.5t-109 -137t-168.5 -117.5t-226 -83t-270.5 -31t-275 33.5t-240.5 93t-171.5 151t-65 199.5q0 115 69.5 245t197.5 258q169 169 341.5 236t246.5 -7q65 -64 20 -209q-4 -14 -1 -20t10 -7t14.5 0.5t13.5 3.5l6 2q139 59 246 59t153 -61q45 -63 0 -178
+q-2 -13 -4.5 -20t4.5 -12.5t12 -7.5t17 -6q57 -18 103 -47t80 -81.5t34 -116.5zM1489 1046q42 -47 54.5 -108.5t-6.5 -117.5q-8 -23 -29.5 -34t-44.5 -4q-23 8 -34 29.5t-4 44.5q20 63 -24 111t-107 35q-24 -5 -45 8t-25 37q-5 24 8 44.5t37 25.5q60 13 119 -5.5t101 -65.5z
+M1670 1209q87 -96 112.5 -222.5t-13.5 -241.5q-9 -27 -34 -40t-52 -4t-40 34t-5 52q28 82 10 172t-80 158q-62 69 -148 95.5t-173 8.5q-28 -6 -52 9.5t-30 43.5t9.5 51.5t43.5 29.5q123 26 244 -11.5t208 -134.5z" />
+    <glyph glyph-name="renren" unicode="&#xf18b;" 
+d="M1133 -34q-171 -94 -368 -94q-196 0 -367 94q138 87 235.5 211t131.5 268q35 -144 132.5 -268t235.5 -211zM638 1394v-485q0 -252 -126.5 -459.5t-330.5 -306.5q-181 215 -181 495q0 187 83.5 349.5t229.5 269.5t325 137zM1536 638q0 -280 -181 -495
+q-204 99 -330.5 306.5t-126.5 459.5v485q179 -30 325 -137t229.5 -269.5t83.5 -349.5z" />
+    <glyph glyph-name="_372" unicode="&#xf18c;" horiz-adv-x="1408" 
+d="M1402 433q-32 -80 -76 -138t-91 -88.5t-99 -46.5t-101.5 -14.5t-96.5 8.5t-86.5 22t-69.5 27.5t-46 22.5l-17 10q-113 -228 -289.5 -359.5t-384.5 -132.5q-19 0 -32 13t-13 32t13 31.5t32 12.5q173 1 322.5 107.5t251.5 294.5q-36 -14 -72 -23t-83 -13t-91 2.5t-93 28.5
+t-92 59t-84.5 100t-74.5 146q114 47 214 57t167.5 -7.5t124.5 -56.5t88.5 -77t56.5 -82q53 131 79 291q-7 -1 -18 -2.5t-46.5 -2.5t-69.5 0.5t-81.5 10t-88.5 23t-84 42.5t-75 65t-54.5 94.5t-28.5 127.5q70 28 133.5 36.5t112.5 -1t92 -30t73.5 -50t56 -61t42 -63t27.5 -56
+t16 -39.5l4 -16q12 122 12 195q-8 6 -21.5 16t-49 44.5t-63.5 71.5t-54 93t-33 112.5t12 127t70 138.5q73 -25 127.5 -61.5t84.5 -76.5t48 -85t20.5 -89t-0.5 -85.5t-13 -76.5t-19 -62t-17 -42l-7 -15q1 -4 1 -50t-1 -72q3 7 10 18.5t30.5 43t50.5 58t71 55.5t91.5 44.5
+t112 14.5t132.5 -24q-2 -78 -21.5 -141.5t-50 -104.5t-69.5 -71.5t-81.5 -45.5t-84.5 -24t-80 -9.5t-67.5 1t-46.5 4.5l-17 3q-23 -147 -73 -283q6 7 18 18.5t49.5 41t77.5 52.5t99.5 42t117.5 20t129 -23.5t137 -77.5z" />
+    <glyph glyph-name="stack_exchange" unicode="&#xf18d;" horiz-adv-x="1280" 
+d="M1259 283v-66q0 -85 -57.5 -144.5t-138.5 -59.5h-57l-260 -269v269h-529q-81 0 -138.5 59.5t-57.5 144.5v66h1238zM1259 609v-255h-1238v255h1238zM1259 937v-255h-1238v255h1238zM1259 1077v-67h-1238v67q0 84 57.5 143.5t138.5 59.5h846q81 0 138.5 -59.5t57.5 -143.5z
+" />
+    <glyph glyph-name="_374" unicode="&#xf18e;" 
+d="M1152 640q0 -14 -9 -23l-320 -320q-9 -9 -23 -9q-13 0 -22.5 9.5t-9.5 22.5v192h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v192q0 14 9 23t23 9q12 0 24 -10l319 -319q9 -9 9 -23zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198
+t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="arrow_circle_alt_left" unicode="&#xf190;" 
+d="M1152 736v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-192q0 -14 -9 -23t-23 -9q-12 0 -24 10l-319 319q-9 9 -9 23t9 23l320 320q9 9 23 9q13 0 22.5 -9.5t9.5 -22.5v-192h352q13 0 22.5 -9.5t9.5 -22.5zM1312 640q0 148 -73 273t-198 198t-273 73t-273 -73t-198 -198
+t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_376" unicode="&#xf191;" 
+d="M1024 960v-640q0 -26 -19 -45t-45 -19q-20 0 -37 12l-448 320q-27 19 -27 52t27 52l448 320q17 12 37 12q26 0 45 -19t19 -45zM1280 160v960q0 13 -9.5 22.5t-22.5 9.5h-960q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5z
+M1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="dot_circle_alt" unicode="&#xf192;" 
+d="M1024 640q0 -106 -75 -181t-181 -75t-181 75t-75 181t75 181t181 75t181 -75t75 -181zM768 1184q-148 0 -273 -73t-198 -198t-73 -273t73 -273t198 -198t273 -73t273 73t198 198t73 273t-73 273t-198 198t-273 73zM1536 640q0 -209 -103 -385.5t-279.5 -279.5
+t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_378" unicode="&#xf193;" horiz-adv-x="1664" 
+d="M1023 349l102 -204q-58 -179 -210 -290t-339 -111q-156 0 -288.5 77.5t-210 210t-77.5 288.5q0 181 104.5 330t274.5 211l17 -131q-122 -54 -195 -165.5t-73 -244.5q0 -185 131.5 -316.5t316.5 -131.5q126 0 232.5 65t165 175.5t49.5 236.5zM1571 249l58 -114l-256 -128
+q-13 -7 -29 -7q-40 0 -57 35l-239 477h-472q-24 0 -42.5 16.5t-21.5 40.5l-96 779q-2 17 6 42q14 51 57 82.5t97 31.5q66 0 113 -47t47 -113q0 -69 -52 -117.5t-120 -41.5l37 -289h423v-128h-407l16 -128h455q40 0 57 -35l228 -455z" />
+    <glyph glyph-name="vimeo_square" unicode="&#xf194;" 
+d="M1292 898q10 216 -161 222q-231 8 -312 -261q44 19 82 19q85 0 74 -96q-4 -57 -74 -167t-105 -110q-43 0 -82 169q-13 54 -45 255q-30 189 -160 177q-59 -7 -164 -100l-81 -72l-81 -72l52 -67q76 52 87 52q57 0 107 -179q15 -55 45 -164.5t45 -164.5q68 -179 164 -179
+q157 0 383 294q220 283 226 444zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_380" unicode="&#xf195;" horiz-adv-x="1152" 
+d="M1152 704q0 -191 -94.5 -353t-256.5 -256.5t-353 -94.5h-160q-14 0 -23 9t-9 23v611l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v93l-215 -66q-3 -1 -9 -1q-10 0 -19 6q-13 10 -13 26v128q0 23 23 31l233 71v250q0 14 9 23t23 9h160
+q14 0 23 -9t9 -23v-181l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-93l375 116q15 5 28 -5t13 -26v-128q0 -23 -23 -31l-393 -121v-487q188 13 318 151t130 328q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="plus_square_o" unicode="&#xf196;" horiz-adv-x="1408" 
+d="M1152 736v-64q0 -14 -9 -23t-23 -9h-352v-352q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v352h-352q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h352v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-352h352q14 0 23 -9t9 -23zM1280 288v832q0 66 -47 113t-113 47h-832
+q-66 0 -113 -47t-47 -113v-832q0 -66 47 -113t113 -47h832q66 0 113 47t47 113zM1408 1120v-832q0 -119 -84.5 -203.5t-203.5 -84.5h-832q-119 0 -203.5 84.5t-84.5 203.5v832q0 119 84.5 203.5t203.5 84.5h832q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_382" unicode="&#xf197;" horiz-adv-x="2176" 
+d="M620 416q-110 -64 -268 -64h-128v64h-64q-13 0 -22.5 23.5t-9.5 56.5q0 24 7 49q-58 2 -96.5 10.5t-38.5 20.5t38.5 20.5t96.5 10.5q-7 25 -7 49q0 33 9.5 56.5t22.5 23.5h64v64h128q158 0 268 -64h1113q42 -7 106.5 -18t80.5 -14q89 -15 150 -40.5t83.5 -47.5t22.5 -40
+t-22.5 -40t-83.5 -47.5t-150 -40.5q-16 -3 -80.5 -14t-106.5 -18h-1113zM1739 668q53 -36 53 -92t-53 -92l81 -30q68 48 68 122t-68 122zM625 400h1015q-217 -38 -456 -80q-57 0 -113 -24t-83 -48l-28 -24l-288 -288q-26 -26 -70.5 -45t-89.5 -19h-96l-93 464h29
+q157 0 273 64zM352 816h-29l93 464h96q46 0 90 -19t70 -45l288 -288q4 -4 11 -10.5t30.5 -23t48.5 -29t61.5 -23t72.5 -10.5l456 -80h-1015q-116 64 -273 64z" />
+    <glyph glyph-name="_383" unicode="&#xf198;" horiz-adv-x="1664" 
+d="M1519 760q62 0 103.5 -40.5t41.5 -101.5q0 -97 -93 -130l-172 -59l56 -167q7 -21 7 -47q0 -59 -42 -102t-101 -43q-47 0 -85.5 27t-53.5 72l-55 165l-310 -106l55 -164q8 -24 8 -47q0 -59 -42 -102t-102 -43q-47 0 -85 27t-53 72l-55 163l-153 -53q-29 -9 -50 -9
+q-61 0 -101.5 40t-40.5 101q0 47 27.5 85t71.5 53l156 53l-105 313l-156 -54q-26 -8 -48 -8q-60 0 -101 40.5t-41 100.5q0 47 27.5 85t71.5 53l157 53l-53 159q-8 24 -8 47q0 60 42 102.5t102 42.5q47 0 85 -27t53 -72l54 -160l310 105l-54 160q-8 24 -8 47q0 59 42.5 102
+t101.5 43q47 0 85.5 -27.5t53.5 -71.5l53 -161l162 55q21 6 43 6q60 0 102.5 -39.5t42.5 -98.5q0 -45 -30 -81.5t-74 -51.5l-157 -54l105 -316l164 56q24 8 46 8zM725 498l310 105l-105 315l-310 -107z" />
+    <glyph glyph-name="_384" unicode="&#xf199;" 
+d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM1280 352v436q-31 -35 -64 -55q-34 -22 -132.5 -85t-151.5 -99q-98 -69 -164 -69v0v0q-66 0 -164 69
+q-47 32 -142 92.5t-142 92.5q-12 8 -33 27t-31 27v-436q0 -40 28 -68t68 -28h832q40 0 68 28t28 68zM1280 925q0 41 -27.5 70t-68.5 29h-832q-40 0 -68 -28t-28 -68q0 -37 30.5 -76.5t67.5 -64.5q47 -32 137.5 -89t129.5 -83q3 -2 17 -11.5t21 -14t21 -13t23.5 -13
+t21.5 -9.5t22.5 -7.5t20.5 -2.5t20.5 2.5t22.5 7.5t21.5 9.5t23.5 13t21 13t21 14t17 11.5l267 174q35 23 66.5 62.5t31.5 73.5z" />
+    <glyph glyph-name="_385" unicode="&#xf19a;" horiz-adv-x="1792" 
+d="M127 640q0 163 67 313l367 -1005q-196 95 -315 281t-119 411zM1415 679q0 -19 -2.5 -38.5t-10 -49.5t-11.5 -44t-17.5 -59t-17.5 -58l-76 -256l-278 826q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-75 1 -202 10q-12 1 -20.5 -5t-11.5 -15t-1.5 -18.5t9 -16.5
+t19.5 -8l80 -8l120 -328l-168 -504l-280 832q46 3 88 8q19 2 26 18.5t-2.5 31t-28.5 13.5l-205 -10q-7 0 -23 0.5t-26 0.5q105 160 274.5 253.5t367.5 93.5q147 0 280.5 -53t238.5 -149h-10q-55 0 -92 -40.5t-37 -95.5q0 -12 2 -24t4 -21.5t8 -23t9 -21t12 -22.5t12.5 -21
+t14.5 -24t14 -23q63 -107 63 -212zM909 573l237 -647q1 -6 5 -11q-126 -44 -255 -44q-112 0 -217 32zM1570 1009q95 -174 95 -369q0 -209 -104 -385.5t-279 -278.5l235 678q59 169 59 276q0 42 -6 79zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286
+t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 -215q173 0 331.5 68t273 182.5t182.5 273t68 331.5t-68 331.5t-182.5 273t-273 182.5t-331.5 68t-331.5 -68t-273 -182.5t-182.5 -273t-68 -331.5t68 -331.5t182.5 -273
+t273 -182.5t331.5 -68z" />
+    <glyph glyph-name="_386" unicode="&#xf19b;" horiz-adv-x="1792" 
+d="M1086 1536v-1536l-272 -128q-228 20 -414 102t-293 208.5t-107 272.5q0 140 100.5 263.5t275 205.5t391.5 108v-172q-217 -38 -356.5 -150t-139.5 -255q0 -152 154.5 -267t388.5 -145v1360zM1755 954l37 -390l-525 114l147 83q-119 70 -280 99v172q277 -33 481 -157z" />
+    <glyph glyph-name="_387" unicode="&#xf19c;" horiz-adv-x="2048" 
+d="M960 1536l960 -384v-128h-128q0 -26 -20.5 -45t-48.5 -19h-1526q-28 0 -48.5 19t-20.5 45h-128v128zM256 896h256v-768h128v768h256v-768h128v768h256v-768h128v768h256v-768h59q28 0 48.5 -19t20.5 -45v-64h-1664v64q0 26 20.5 45t48.5 19h59v768zM1851 -64
+q28 0 48.5 -19t20.5 -45v-128h-1920v128q0 26 20.5 45t48.5 19h1782z" />
+    <glyph glyph-name="_388" unicode="&#xf19d;" horiz-adv-x="2304" 
+d="M1774 700l18 -316q4 -69 -82 -128t-235 -93.5t-323 -34.5t-323 34.5t-235 93.5t-82 128l18 316l574 -181q22 -7 48 -7t48 7zM2304 1024q0 -23 -22 -31l-1120 -352q-4 -1 -10 -1t-10 1l-652 206q-43 -34 -71 -111.5t-34 -178.5q63 -36 63 -109q0 -69 -58 -107l58 -433
+q2 -14 -8 -25q-9 -11 -24 -11h-192q-15 0 -24 11q-10 11 -8 25l58 433q-58 38 -58 107q0 73 65 111q11 207 98 330l-333 104q-22 8 -22 31t22 31l1120 352q4 1 10 1t10 -1l1120 -352q22 -8 22 -31z" />
+    <glyph glyph-name="_389" unicode="&#xf19e;" 
+d="M859 579l13 -707q-62 11 -105 11q-41 0 -105 -11l13 707q-40 69 -168.5 295.5t-216.5 374.5t-181 287q58 -15 108 -15q44 0 111 15q63 -111 133.5 -229.5t167 -276.5t138.5 -227q37 61 109.5 177.5t117.5 190t105 176t107 189.5q54 -14 107 -14q56 0 114 14v0
+q-28 -39 -60 -88.5t-49.5 -78.5t-56.5 -96t-49 -84q-146 -248 -353 -610z" />
+    <glyph glyph-name="uniF1A0" unicode="&#xf1a0;" 
+d="M768 750h725q12 -67 12 -128q0 -217 -91 -387.5t-259.5 -266.5t-386.5 -96q-157 0 -299 60.5t-245 163.5t-163.5 245t-60.5 299t60.5 299t163.5 245t245 163.5t299 60.5q300 0 515 -201l-209 -201q-123 119 -306 119q-129 0 -238.5 -65t-173.5 -176.5t-64 -243.5
+t64 -243.5t173.5 -176.5t238.5 -65q87 0 160 24t120 60t82 82t51.5 87t22.5 78h-436v264z" />
+    <glyph glyph-name="f1a1" unicode="&#xf1a1;" horiz-adv-x="1792" 
+d="M1095 369q16 -16 0 -31q-62 -62 -199 -62t-199 62q-16 15 0 31q6 6 15 6t15 -6q48 -49 169 -49q120 0 169 49q6 6 15 6t15 -6zM788 550q0 -37 -26 -63t-63 -26t-63.5 26t-26.5 63q0 38 26.5 64t63.5 26t63 -26.5t26 -63.5zM1183 550q0 -37 -26.5 -63t-63.5 -26t-63 26
+t-26 63t26 63.5t63 26.5t63.5 -26t26.5 -64zM1434 670q0 49 -35 84t-85 35t-86 -36q-130 90 -311 96l63 283l200 -45q0 -37 26 -63t63 -26t63.5 26.5t26.5 63.5t-26.5 63.5t-63.5 26.5q-54 0 -80 -50l-221 49q-19 5 -25 -16l-69 -312q-180 -7 -309 -97q-35 37 -87 37
+q-50 0 -85 -35t-35 -84q0 -35 18.5 -64t49.5 -44q-6 -27 -6 -56q0 -142 140 -243t337 -101q198 0 338 101t140 243q0 32 -7 57q30 15 48 43.5t18 63.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191
+t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="_392" unicode="&#xf1a2;" 
+d="M939 407q13 -13 0 -26q-53 -53 -171 -53t-171 53q-13 13 0 26q5 6 13 6t13 -6q42 -42 145 -42t145 42q5 6 13 6t13 -6zM676 563q0 -31 -23 -54t-54 -23t-54 23t-23 54q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1014 563q0 -31 -23 -54t-54 -23t-54 23t-23 54
+q0 32 22.5 54.5t54.5 22.5t54.5 -22.5t22.5 -54.5zM1229 666q0 42 -30 72t-73 30q-42 0 -73 -31q-113 78 -267 82l54 243l171 -39q1 -32 23.5 -54t53.5 -22q32 0 54.5 22.5t22.5 54.5t-22.5 54.5t-54.5 22.5q-48 0 -69 -43l-189 42q-17 5 -21 -13l-60 -268q-154 -6 -265 -83
+q-30 32 -74 32q-43 0 -73 -30t-30 -72q0 -30 16 -55t42 -38q-5 -25 -5 -48q0 -122 120 -208.5t289 -86.5q170 0 290 86.5t120 208.5q0 25 -6 49q25 13 40.5 37.5t15.5 54.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960
+q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_393" unicode="&#xf1a3;" 
+d="M866 697l90 27v62q0 79 -58 135t-138 56t-138 -55.5t-58 -134.5v-283q0 -20 -14 -33.5t-33 -13.5t-32.5 13.5t-13.5 33.5v120h-151v-122q0 -82 57.5 -139t139.5 -57q81 0 138.5 56.5t57.5 136.5v280q0 19 13.5 33t33.5 14q19 0 32.5 -14t13.5 -33v-54zM1199 502v122h-150
+v-126q0 -20 -13.5 -33.5t-33.5 -13.5q-19 0 -32.5 14t-13.5 33v123l-90 -26l-60 28v-123q0 -80 58 -137t139 -57t138.5 57t57.5 139zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103
+t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="f1a4" unicode="&#xf1a4;" horiz-adv-x="1920" 
+d="M1062 824v118q0 42 -30 72t-72 30t-72 -30t-30 -72v-612q0 -175 -126 -299t-303 -124q-178 0 -303.5 125.5t-125.5 303.5v266h328v-262q0 -43 30 -72.5t72 -29.5t72 29.5t30 72.5v620q0 171 126.5 292t301.5 121q176 0 302 -122t126 -294v-136l-195 -58zM1592 602h328
+v-266q0 -178 -125.5 -303.5t-303.5 -125.5q-177 0 -303 124.5t-126 300.5v268l131 -61l195 58v-270q0 -42 30 -71.5t72 -29.5t72 29.5t30 71.5v275z" />
+    <glyph glyph-name="_395" unicode="&#xf1a5;" 
+d="M1472 160v480h-704v704h-480q-93 0 -158.5 -65.5t-65.5 -158.5v-480h704v-704h480q93 0 158.5 65.5t65.5 158.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
+t84.5 -203.5z" />
+    <glyph glyph-name="_396" unicode="&#xf1a6;" horiz-adv-x="2048" 
+d="M328 1254h204v-983h-532v697h328v286zM328 435v369h-123v-369h123zM614 968v-697h205v697h-205zM614 1254v-204h205v204h-205zM901 968h533v-942h-533v163h328v82h-328v697zM1229 435v369h-123v-369h123zM1516 968h532v-942h-532v163h327v82h-327v697zM1843 435v369h-123
+v-369h123z" />
+    <glyph glyph-name="_397" unicode="&#xf1a7;" 
+d="M1046 516q0 -64 -38 -109t-91 -45q-43 0 -70 15v277q28 17 70 17q53 0 91 -45.5t38 -109.5zM703 944q0 -64 -38 -109.5t-91 -45.5q-43 0 -70 15v277q28 17 70 17q53 0 91 -45t38 -109zM1265 513q0 134 -88 229t-213 95q-20 0 -39 -3q-23 -78 -78 -136q-87 -95 -211 -101
+v-636l211 41v206q51 -19 117 -19q125 0 213 95t88 229zM922 940q0 134 -88.5 229t-213.5 95q-74 0 -141 -36h-186v-840l211 41v206q55 -19 116 -19q125 0 213.5 95t88.5 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960
+q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_398" unicode="&#xf1a8;" horiz-adv-x="2038" 
+d="M1222 607q75 3 143.5 -20.5t118 -58.5t101 -94.5t84 -108t75.5 -120.5q33 -56 78.5 -109t75.5 -80.5t99 -88.5q-48 -30 -108.5 -57.5t-138.5 -59t-114 -47.5q-44 37 -74 115t-43.5 164.5t-33 180.5t-42.5 168.5t-72.5 123t-122.5 48.5l-10 -2l-6 -4q4 -5 13 -14
+q6 -5 28 -23.5t25.5 -22t19 -18t18 -20.5t11.5 -21t10.5 -27.5t4.5 -31t4 -40.5l1 -33q1 -26 -2.5 -57.5t-7.5 -52t-12.5 -58.5t-11.5 -53q-35 1 -101 -9.5t-98 -10.5q-39 0 -72 10q-2 16 -2 47q0 74 3 96q2 13 31.5 41.5t57 59t26.5 51.5q-24 2 -43 -24
+q-36 -53 -111.5 -99.5t-136.5 -46.5q-25 0 -75.5 63t-106.5 139.5t-84 96.5q-6 4 -27 30q-482 -112 -513 -112q-16 0 -28 11t-12 27q0 15 8.5 26.5t22.5 14.5l486 106q-8 14 -8 25t5.5 17.5t16 11.5t20 7t23 4.5t18.5 4.5q4 1 15.5 7.5t17.5 6.5q15 0 28 -16t20 -33
+q163 37 172 37q17 0 29.5 -11t12.5 -28q0 -15 -8.5 -26t-23.5 -14l-182 -40l-1 -16q-1 -26 81.5 -117.5t104.5 -91.5q47 0 119 80t72 129q0 36 -23.5 53t-51 18.5t-51 11.5t-23.5 34q0 16 10 34l-68 19q43 44 43 117q0 26 -5 58q82 16 144 16q44 0 71.5 -1.5t48.5 -8.5
+t31 -13.5t20.5 -24.5t15.5 -33.5t17 -47.5t24 -60l50 25q-3 -40 -23 -60t-42.5 -21t-40 -6.5t-16.5 -20.5zM1282 842q-5 5 -13.5 15.5t-12 14.5t-10.5 11.5t-10 10.5l-8 8t-8.5 7.5t-8 5t-8.5 4.5q-7 3 -14.5 5t-20.5 2.5t-22 0.5h-32.5h-37.5q-126 0 -217 -43
+q16 30 36 46.5t54 29.5t65.5 36t46 36.5t50 55t43.5 50.5q12 -9 28 -31.5t32 -36.5t38 -13l12 1v-76l22 -1q247 95 371 190q28 21 50 39t42.5 37.5t33 31t29.5 34t24 31t24.5 37t23 38t27 47.5t29.5 53l7 9q-2 -53 -43 -139q-79 -165 -205 -264t-306 -142q-14 -3 -42 -7.5
+t-50 -9.5t-39 -14q3 -19 24.5 -46t21.5 -34q0 -11 -26 -30zM1061 -79q39 26 131.5 47.5t146.5 21.5q9 0 22.5 -15.5t28 -42.5t26 -50t24 -51t14.5 -33q-121 -45 -244 -45q-61 0 -125 11zM822 568l48 12l109 -177l-73 -48zM1323 51q3 -15 3 -16q0 -7 -17.5 -14.5t-46 -13
+t-54 -9.5t-53.5 -7.5t-32 -4.5l-7 43q21 2 60.5 8.5t72 10t60.5 3.5h14zM866 679l-96 -20l-6 17q10 1 32.5 7t34.5 6q19 0 35 -10zM1061 45h31l10 -83l-41 -12v95zM1950 1535v1v-1zM1950 1535l-1 -5l-2 -2l1 3zM1950 1535l1 1z" />
+    <glyph glyph-name="_399" unicode="&#xf1a9;" 
+d="M1167 -50q-5 19 -24 5q-30 -22 -87 -39t-131 -17q-129 0 -193 49q-5 4 -13 4q-11 0 -26 -12q-7 -6 -7.5 -16t7.5 -20q34 -32 87.5 -46t102.5 -12.5t99 4.5q41 4 84.5 20.5t65 30t28.5 20.5q12 12 7 29zM1128 65q-19 47 -39 61q-23 15 -76 15q-47 0 -71 -10
+q-29 -12 -78 -56q-26 -24 -12 -44q9 -8 17.5 -4.5t31.5 23.5q3 2 10.5 8.5t10.5 8.5t10 7t11.5 7t12.5 5t15 4.5t16.5 2.5t20.5 1q27 0 44.5 -7.5t23 -14.5t13.5 -22q10 -17 12.5 -20t12.5 1q23 12 14 34zM1483 346q0 22 -5 44.5t-16.5 45t-34 36.5t-52.5 14
+q-33 0 -97 -41.5t-129 -83.5t-101 -42q-27 -1 -63.5 19t-76 49t-83.5 58t-100 49t-111 19q-115 -1 -197 -78.5t-84 -178.5q-2 -112 74 -164q29 -20 62.5 -28.5t103.5 -8.5q57 0 132 32.5t134 71t120 70.5t93 31q26 -1 65 -31.5t71.5 -67t68 -67.5t55.5 -32q35 -3 58.5 14
+t55.5 63q28 41 42.5 101t14.5 106zM1536 506q0 -164 -62 -304.5t-166 -236t-242.5 -149.5t-290.5 -54t-293 57.5t-247.5 157t-170.5 241.5t-64 302q0 89 19.5 172.5t49 145.5t70.5 118.5t78.5 94t78.5 69.5t64.5 46.5t42.5 24.5q14 8 51 26.5t54.5 28.5t48 30t60.5 44
+q36 28 58 72.5t30 125.5q129 -155 186 -193q44 -29 130 -68t129 -66q21 -13 39 -25t60.5 -46.5t76 -70.5t75 -95t69 -122t47 -148.5t19.5 -177.5z" />
+    <glyph glyph-name="_400" unicode="&#xf1aa;" 
+d="M1070 463l-160 -160l-151 -152l-30 -30q-65 -64 -151.5 -87t-171.5 -2q-16 -70 -72 -115t-129 -45q-85 0 -145 60.5t-60 145.5q0 72 44.5 128t113.5 72q-22 86 1 173t88 152l12 12l151 -152l-11 -11q-37 -37 -37 -89t37 -90q37 -37 89 -37t89 37l30 30l151 152l161 160z
+M729 1145l12 -12l-152 -152l-12 12q-37 37 -89 37t-89 -37t-37 -89.5t37 -89.5l29 -29l152 -152l160 -160l-151 -152l-161 160l-151 152l-30 30q-68 67 -90 159.5t5 179.5q-70 15 -115 71t-45 129q0 85 60 145.5t145 60.5q76 0 133.5 -49t69.5 -123q84 20 169.5 -3.5
+t149.5 -87.5zM1536 78q0 -85 -60 -145.5t-145 -60.5q-74 0 -131 47t-71 118q-86 -28 -179.5 -6t-161.5 90l-11 12l151 152l12 -12q37 -37 89 -37t89 37t37 89t-37 89l-30 30l-152 152l-160 160l152 152l160 -160l152 -152l29 -30q64 -64 87.5 -150.5t2.5 -171.5
+q76 -11 126.5 -68.5t50.5 -134.5zM1534 1202q0 -77 -51 -135t-127 -69q26 -85 3 -176.5t-90 -158.5l-12 -12l-151 152l12 12q37 37 37 89t-37 89t-89 37t-89 -37l-30 -30l-152 -152l-160 -160l-152 152l161 160l152 152l29 30q67 67 159 89.5t178 -3.5q11 75 68.5 126
+t135.5 51q85 0 145 -60.5t60 -145.5z" />
+    <glyph glyph-name="f1ab" unicode="&#xf1ab;" 
+d="M654 458q-1 -3 -12.5 0.5t-31.5 11.5l-20 9q-44 20 -87 49q-7 5 -41 31.5t-38 28.5q-67 -103 -134 -181q-81 -95 -105 -110q-4 -2 -19.5 -4t-18.5 0q6 4 82 92q21 24 85.5 115t78.5 118q17 30 51 98.5t36 77.5q-8 1 -110 -33q-8 -2 -27.5 -7.5t-34.5 -9.5t-17 -5
+q-2 -2 -2 -10.5t-1 -9.5q-5 -10 -31 -15q-23 -7 -47 0q-18 4 -28 21q-4 6 -5 23q6 2 24.5 5t29.5 6q58 16 105 32q100 35 102 35q10 2 43 19.5t44 21.5q9 3 21.5 8t14.5 5.5t6 -0.5q2 -12 -1 -33q0 -2 -12.5 -27t-26.5 -53.5t-17 -33.5q-25 -50 -77 -131l64 -28
+q12 -6 74.5 -32t67.5 -28q4 -1 10.5 -25.5t4.5 -30.5zM449 944q3 -15 -4 -28q-12 -23 -50 -38q-30 -12 -60 -12q-26 3 -49 26q-14 15 -18 41l1 3q3 -3 19.5 -5t26.5 0t58 16q36 12 55 14q17 0 21 -17zM1147 815l63 -227l-139 42zM39 15l694 232v1032l-694 -233v-1031z
+M1280 332l102 -31l-181 657l-100 31l-216 -536l102 -31l45 110l211 -65zM777 1294l573 -184v380zM1088 -29l158 -13l-54 -160l-40 66q-130 -83 -276 -108q-58 -12 -91 -12h-84q-79 0 -199.5 39t-183.5 85q-8 7 -8 16q0 8 5 13.5t13 5.5q4 0 18 -7.5t30.5 -16.5t20.5 -11
+q73 -37 159.5 -61.5t157.5 -24.5q95 0 167 14.5t157 50.5q15 7 30.5 15.5t34 19t28.5 16.5zM1536 1050v-1079l-774 246q-14 -6 -375 -127.5t-368 -121.5q-13 0 -18 13q0 1 -1 3v1078q3 9 4 10q5 6 20 11q107 36 149 50v384l558 -198q2 0 160.5 55t316 108.5t161.5 53.5
+q20 0 20 -21v-418z" />
+    <glyph glyph-name="_402" unicode="&#xf1ac;" horiz-adv-x="1792" 
+d="M288 1152q66 0 113 -47t47 -113v-1088q0 -66 -47 -113t-113 -47h-128q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h128zM1664 989q58 -34 93 -93t35 -128v-768q0 -106 -75 -181t-181 -75h-864q-66 0 -113 47t-47 113v1536q0 40 28 68t68 28h672q40 0 88 -20t76 -48
+l152 -152q28 -28 48 -76t20 -88v-163zM928 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM928 512v128q0 14 -9 23
+t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1184 256v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128
+q14 0 23 9t9 23zM1184 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 0v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 256v128q0 14 -9 23t-23 9h-128
+q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1440 512v128q0 14 -9 23t-23 9h-128q-14 0 -23 -9t-9 -23v-128q0 -14 9 -23t23 -9h128q14 0 23 9t9 23zM1536 896v256h-160q-40 0 -68 28t-28 68v160h-640v-512h896z" />
+    <glyph glyph-name="_403" unicode="&#xf1ad;" 
+d="M1344 1536q26 0 45 -19t19 -45v-1664q0 -26 -19 -45t-45 -19h-1280q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h1280zM512 1248v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 992v-64q0 -14 9 -23t23 -9h64q14 0 23 9
+t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 736v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM512 480v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 160v64
+q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64
+q14 0 23 9t9 23zM384 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM384 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 -96v192q0 14 -9 23t-23 9h-320q-14 0 -23 -9
+t-9 -23v-192q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM896 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 928v64
+q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM896 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 160v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64
+q14 0 23 9t9 23zM1152 416v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 672v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 928v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9
+t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1152 1184v64q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h64q14 0 23 9t9 23z" />
+    <glyph glyph-name="_404" unicode="&#xf1ae;" horiz-adv-x="1280" 
+d="M1188 988l-292 -292v-824q0 -46 -33 -79t-79 -33t-79 33t-33 79v384h-64v-384q0 -46 -33 -79t-79 -33t-79 33t-33 79v824l-292 292q-28 28 -28 68t28 68q29 28 68.5 28t67.5 -28l228 -228h368l228 228q28 28 68 28t68 -28q28 -29 28 -68.5t-28 -67.5zM864 1152
+q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5z" />
+    <glyph glyph-name="uniF1B1" unicode="&#xf1b0;" horiz-adv-x="1664" 
+d="M780 1064q0 -60 -19 -113.5t-63 -92.5t-105 -39q-76 0 -138 57.5t-92 135.5t-30 151q0 60 19 113.5t63 92.5t105 39q77 0 138.5 -57.5t91.5 -135t30 -151.5zM438 581q0 -80 -42 -139t-119 -59q-76 0 -141.5 55.5t-100.5 133.5t-35 152q0 80 42 139.5t119 59.5
+q76 0 141.5 -55.5t100.5 -134t35 -152.5zM832 608q118 0 255 -97.5t229 -237t92 -254.5q0 -46 -17 -76.5t-48.5 -45t-64.5 -20t-76 -5.5q-68 0 -187.5 45t-182.5 45q-66 0 -192.5 -44.5t-200.5 -44.5q-183 0 -183 146q0 86 56 191.5t139.5 192.5t187.5 146t193 59zM1071 819
+q-61 0 -105 39t-63 92.5t-19 113.5q0 74 30 151.5t91.5 135t138.5 57.5q61 0 105 -39t63 -92.5t19 -113.5q0 -73 -30 -151t-92 -135.5t-138 -57.5zM1503 923q77 0 119 -59.5t42 -139.5q0 -74 -35 -152t-100.5 -133.5t-141.5 -55.5q-77 0 -119 59t-42 139q0 74 35 152.5
+t100.5 134t141.5 55.5z" />
+    <glyph glyph-name="_406" unicode="&#xf1b1;" horiz-adv-x="768" 
+d="M704 1008q0 -145 -57 -243.5t-152 -135.5l45 -821q2 -26 -16 -45t-44 -19h-192q-26 0 -44 19t-16 45l45 821q-95 37 -152 135.5t-57 243.5q0 128 42.5 249.5t117.5 200t160 78.5t160 -78.5t117.5 -200t42.5 -249.5z" />
+    <glyph glyph-name="_407" unicode="&#xf1b2;" horiz-adv-x="1792" 
+d="M896 -93l640 349v636l-640 -233v-752zM832 772l698 254l-698 254l-698 -254zM1664 1024v-768q0 -35 -18 -65t-49 -47l-704 -384q-28 -16 -61 -16t-61 16l-704 384q-31 17 -49 47t-18 65v768q0 40 23 73t61 47l704 256q22 8 44 8t44 -8l704 -256q38 -14 61 -47t23 -73z
+" />
+    <glyph glyph-name="_408" unicode="&#xf1b3;" horiz-adv-x="2304" 
+d="M640 -96l384 192v314l-384 -164v-342zM576 358l404 173l-404 173l-404 -173zM1664 -96l384 192v314l-384 -164v-342zM1600 358l404 173l-404 173l-404 -173zM1152 651l384 165v266l-384 -164v-267zM1088 1030l441 189l-441 189l-441 -189zM2176 512v-416q0 -36 -19 -67
+t-52 -47l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-4 2 -7 4q-2 -2 -7 -4l-448 -224q-25 -14 -57 -14t-57 14l-448 224q-33 16 -52 47t-19 67v416q0 38 21.5 70t56.5 48l434 186v400q0 38 21.5 70t56.5 48l448 192q23 10 50 10t50 -10l448 -192q35 -16 56.5 -48t21.5 -70
+v-400l434 -186q36 -16 57 -48t21 -70z" />
+    <glyph glyph-name="_409" unicode="&#xf1b4;" horiz-adv-x="2048" 
+d="M1848 1197h-511v-124h511v124zM1596 771q-90 0 -146 -52.5t-62 -142.5h408q-18 195 -200 195zM1612 186q63 0 122 32t76 87h221q-100 -307 -427 -307q-214 0 -340.5 132t-126.5 347q0 208 130.5 345.5t336.5 137.5q138 0 240.5 -68t153 -179t50.5 -248q0 -17 -2 -47h-658
+q0 -111 57.5 -171.5t166.5 -60.5zM277 236h296q205 0 205 167q0 180 -199 180h-302v-347zM277 773h281q78 0 123.5 36.5t45.5 113.5q0 144 -190 144h-260v-294zM0 1282h594q87 0 155 -14t126.5 -47.5t90 -96.5t31.5 -154q0 -181 -172 -263q114 -32 172 -115t58 -204
+q0 -75 -24.5 -136.5t-66 -103.5t-98.5 -71t-121 -42t-134 -13h-611v1260z" />
+    <glyph glyph-name="_410" unicode="&#xf1b5;" 
+d="M1248 1408q119 0 203.5 -84.5t84.5 -203.5v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960zM499 1041h-371v-787h382q117 0 197 57.5t80 170.5q0 158 -143 200q107 52 107 164q0 57 -19.5 96.5
+t-56.5 60.5t-79 29.5t-97 8.5zM477 723h-176v184h163q119 0 119 -90q0 -94 -106 -94zM486 388h-185v217h189q124 0 124 -113q0 -104 -128 -104zM1136 356q-68 0 -104 38t-36 107h411q1 10 1 30q0 132 -74.5 220.5t-203.5 88.5q-128 0 -210 -86t-82 -216q0 -135 79 -217
+t213 -82q205 0 267 191h-138q-11 -34 -47.5 -54t-75.5 -20zM1126 722q113 0 124 -122h-254q4 56 39 89t91 33zM964 988h319v-77h-319v77z" />
+    <glyph glyph-name="_411" unicode="&#xf1b6;" horiz-adv-x="1792" 
+d="M1582 954q0 -101 -71.5 -172.5t-172.5 -71.5t-172.5 71.5t-71.5 172.5t71.5 172.5t172.5 71.5t172.5 -71.5t71.5 -172.5zM812 212q0 104 -73 177t-177 73q-27 0 -54 -6l104 -42q77 -31 109.5 -106.5t1.5 -151.5q-31 -77 -107 -109t-152 -1q-21 8 -62 24.5t-61 24.5
+q32 -60 91 -96.5t130 -36.5q104 0 177 73t73 177zM1642 953q0 126 -89.5 215.5t-215.5 89.5q-127 0 -216.5 -89.5t-89.5 -215.5q0 -127 89.5 -216t216.5 -89q126 0 215.5 89t89.5 216zM1792 953q0 -189 -133.5 -322t-321.5 -133l-437 -319q-12 -129 -109 -218t-229 -89
+q-121 0 -214 76t-118 192l-230 92v429l389 -157q79 48 173 48q13 0 35 -2l284 407q2 187 135.5 319t320.5 132q188 0 321.5 -133.5t133.5 -321.5z" />
+    <glyph glyph-name="_412" unicode="&#xf1b7;" 
+d="M1242 889q0 80 -57 136.5t-137 56.5t-136.5 -57t-56.5 -136q0 -80 56.5 -136.5t136.5 -56.5t137 56.5t57 136.5zM632 301q0 -83 -58 -140.5t-140 -57.5q-56 0 -103 29t-72 77q52 -20 98 -40q60 -24 120 1.5t85 86.5q24 60 -1.5 120t-86.5 84l-82 33q22 5 42 5
+q82 0 140 -57.5t58 -140.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v153l172 -69q20 -92 93.5 -152t168.5 -60q104 0 181 70t87 173l345 252q150 0 255.5 105.5t105.5 254.5q0 150 -105.5 255.5t-255.5 105.5
+q-148 0 -253 -104.5t-107 -252.5l-225 -322q-9 1 -28 1q-75 0 -137 -37l-297 119v468q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5zM1289 887q0 -100 -71 -170.5t-171 -70.5t-170.5 70.5t-70.5 170.5t70.5 171t170.5 71q101 0 171.5 -70.5t70.5 -171.5z
+" />
+    <glyph glyph-name="_413" unicode="&#xf1b8;" horiz-adv-x="1792" 
+d="M836 367l-15 -368l-2 -22l-420 29q-36 3 -67 31.5t-47 65.5q-11 27 -14.5 55t4 65t12 55t21.5 64t19 53q78 -12 509 -28zM449 953l180 -379l-147 92q-63 -72 -111.5 -144.5t-72.5 -125t-39.5 -94.5t-18.5 -63l-4 -21l-190 357q-17 26 -18 56t6 47l8 18q35 63 114 188
+l-140 86zM1680 436l-188 -359q-12 -29 -36.5 -46.5t-43.5 -20.5l-18 -4q-71 -7 -219 -12l8 -164l-230 367l211 362l7 -173q170 -16 283 -5t170 33zM895 1360q-47 -63 -265 -435l-317 187l-19 12l225 356q20 31 60 45t80 10q24 -2 48.5 -12t42 -21t41.5 -33t36 -34.5
+t36 -39.5t32 -35zM1550 1053l212 -363q18 -37 12.5 -76t-27.5 -74q-13 -20 -33 -37t-38 -28t-48.5 -22t-47 -16t-51.5 -14t-46 -12q-34 72 -265 436l313 195zM1407 1279l142 83l-220 -373l-419 20l151 86q-34 89 -75 166t-75.5 123.5t-64.5 80t-47 46.5l-17 13l405 -1
+q31 3 58 -10.5t39 -28.5l11 -15q39 -61 112 -190z" />
+    <glyph glyph-name="_414" unicode="&#xf1b9;" horiz-adv-x="2048" 
+d="M480 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM516 768h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5zM1888 448q0 66 -47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47t113 47t47 113zM2048 544v-384
+q0 -14 -9 -23t-23 -9h-96v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-1024v-128q0 -80 -56 -136t-136 -56t-136 56t-56 136v128h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5t179 63.5h768q98 0 179 -63.5t104 -157.5
+l105 -419h28q93 0 158.5 -65.5t65.5 -158.5z" />
+    <glyph glyph-name="_415" unicode="&#xf1ba;" horiz-adv-x="2048" 
+d="M1824 640q93 0 158.5 -65.5t65.5 -158.5v-384q0 -14 -9 -23t-23 -9h-96v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-1024v-64q0 -80 -56 -136t-136 -56t-136 56t-56 136v64h-96q-14 0 -23 9t-9 23v384q0 93 65.5 158.5t158.5 65.5h28l105 419q23 94 104 157.5
+t179 63.5h128v224q0 14 9 23t23 9h448q14 0 23 -9t9 -23v-224h128q98 0 179 -63.5t104 -157.5l105 -419h28zM320 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM516 640h1016l-89 357q-2 8 -14 17.5t-21 9.5h-768q-9 0 -21 -9.5t-14 -17.5z
+M1728 160q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47z" />
+    <glyph glyph-name="_416" unicode="&#xf1bb;" 
+d="M1504 64q0 -26 -19 -45t-45 -19h-462q1 -17 6 -87.5t5 -108.5q0 -25 -18 -42.5t-43 -17.5h-320q-25 0 -43 17.5t-18 42.5q0 38 5 108.5t6 87.5h-462q-26 0 -45 19t-19 45t19 45l402 403h-229q-26 0 -45 19t-19 45t19 45l402 403h-197q-26 0 -45 19t-19 45t19 45l384 384
+q19 19 45 19t45 -19l384 -384q19 -19 19 -45t-19 -45t-45 -19h-197l402 -403q19 -19 19 -45t-19 -45t-45 -19h-229l402 -403q19 -19 19 -45z" />
+    <glyph glyph-name="_417" unicode="&#xf1bc;" 
+d="M1127 326q0 32 -30 51q-193 115 -447 115q-133 0 -287 -34q-42 -9 -42 -52q0 -20 13.5 -34.5t35.5 -14.5q5 0 37 8q132 27 243 27q226 0 397 -103q19 -11 33 -11q19 0 33 13.5t14 34.5zM1223 541q0 40 -35 61q-237 141 -548 141q-153 0 -303 -42q-48 -13 -48 -64
+q0 -25 17.5 -42.5t42.5 -17.5q7 0 37 8q122 33 251 33q279 0 488 -124q24 -13 38 -13q25 0 42.5 17.5t17.5 42.5zM1331 789q0 47 -40 70q-126 73 -293 110.5t-343 37.5q-204 0 -364 -47q-23 -7 -38.5 -25.5t-15.5 -48.5q0 -31 20.5 -52t51.5 -21q11 0 40 8q133 37 307 37
+q159 0 309.5 -34t253.5 -95q21 -12 40 -12q29 0 50.5 20.5t21.5 51.5zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_418" unicode="&#xf1bd;" horiz-adv-x="1024" 
+d="M1024 1233l-303 -582l24 -31h279v-415h-507l-44 -30l-142 -273l-30 -30h-301v303l303 583l-24 30h-279v415h507l44 30l142 273l30 30h301v-303z" />
+    <glyph glyph-name="_419" unicode="&#xf1be;" horiz-adv-x="2304" 
+d="M784 164l16 241l-16 523q-1 10 -7.5 17t-16.5 7q-9 0 -16 -7t-7 -17l-14 -523l14 -241q1 -10 7.5 -16.5t15.5 -6.5q22 0 24 23zM1080 193l11 211l-12 586q0 16 -13 24q-8 5 -16 5t-16 -5q-13 -8 -13 -24l-1 -6l-10 -579q0 -1 11 -236v-1q0 -10 6 -17q9 -11 23 -11
+q11 0 20 9q9 7 9 20zM35 533l20 -128l-20 -126q-2 -9 -9 -9t-9 9l-17 126l17 128q2 9 9 9t9 -9zM121 612l26 -207l-26 -203q-2 -9 -10 -9q-9 0 -9 10l-23 202l23 207q0 9 9 9q8 0 10 -9zM401 159zM213 650l25 -245l-25 -237q0 -11 -11 -11q-10 0 -12 11l-21 237l21 245
+q2 12 12 12q11 0 11 -12zM307 657l23 -252l-23 -244q-2 -13 -14 -13q-13 0 -13 13l-21 244l21 252q0 13 13 13q12 0 14 -13zM401 639l21 -234l-21 -246q-2 -16 -16 -16q-6 0 -10.5 4.5t-4.5 11.5l-20 246l20 234q0 6 4.5 10.5t10.5 4.5q14 0 16 -15zM784 164zM495 785
+l21 -380l-21 -246q0 -7 -5 -12.5t-12 -5.5q-16 0 -18 18l-18 246l18 380q2 18 18 18q7 0 12 -5.5t5 -12.5zM589 871l19 -468l-19 -244q0 -8 -5.5 -13.5t-13.5 -5.5q-18 0 -20 19l-16 244l16 468q2 19 20 19q8 0 13.5 -5.5t5.5 -13.5zM687 911l18 -506l-18 -242
+q-2 -21 -22 -21q-19 0 -21 21l-16 242l16 506q0 9 6.5 15.5t14.5 6.5q9 0 15 -6.5t7 -15.5zM1079 169v0v0v0zM881 915l15 -510l-15 -239q0 -10 -7.5 -17.5t-17.5 -7.5t-17 7t-8 18l-14 239l14 510q0 11 7.5 18t17.5 7t17.5 -7t7.5 -18zM980 896l14 -492l-14 -236
+q0 -11 -8 -19t-19 -8t-19 8t-9 19l-12 236l12 492q1 12 9 20t19 8t18.5 -8t8.5 -20zM1192 404l-14 -231v0q0 -13 -9 -22t-22 -9t-22 9t-10 22l-6 114l-6 117l12 636v3q2 15 12 24q9 7 20 7q8 0 15 -5q14 -8 16 -26zM2304 423q0 -117 -83 -199.5t-200 -82.5h-786
+q-13 2 -22 11t-9 22v899q0 23 28 33q85 34 181 34q195 0 338 -131.5t160 -323.5q53 22 110 22q117 0 200 -83t83 -201z" />
+    <glyph glyph-name="uniF1C0" unicode="&#xf1c0;" 
+d="M768 768q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 0q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127
+t443 -43zM768 384q237 0 443 43t325 127v-170q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5t-103 128v170q119 -84 325 -127t443 -43zM768 1536q208 0 385 -34.5t280 -93.5t103 -128v-128q0 -69 -103 -128t-280 -93.5t-385 -34.5t-385 34.5t-280 93.5
+t-103 128v128q0 69 103 128t280 93.5t385 34.5z" />
+    <glyph glyph-name="uniF1C1" unicode="&#xf1c1;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M894 465q33 -26 84 -56q59 7 117 7q147 0 177 -49q16 -22 2 -52q0 -1 -1 -2l-2 -2v-1q-6 -38 -71 -38q-48 0 -115 20t-130 53q-221 -24 -392 -83q-153 -262 -242 -262q-15 0 -28 7l-24 12q-1 1 -6 5q-10 10 -6 36q9 40 56 91.5t132 96.5q14 9 23 -6q2 -2 2 -4q52 85 107 197
+q68 136 104 262q-24 82 -30.5 159.5t6.5 127.5q11 40 42 40h21h1q23 0 35 -15q18 -21 9 -68q-2 -6 -4 -8q1 -3 1 -8v-30q-2 -123 -14 -192q55 -164 146 -238zM318 54q52 24 137 158q-51 -40 -87.5 -84t-49.5 -74zM716 974q-15 -42 -2 -132q1 7 7 44q0 3 7 43q1 4 4 8
+q-1 1 -1 2q-1 2 -1 3q-1 22 -13 36q0 -1 -1 -2v-2zM592 313q135 54 284 81q-2 1 -13 9.5t-16 13.5q-76 67 -127 176q-27 -86 -83 -197q-30 -56 -45 -83zM1238 329q-24 24 -140 24q76 -28 124 -28q14 0 18 1q0 1 -2 3z" />
+    <glyph glyph-name="_422" unicode="&#xf1c2;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M233 768v-107h70l164 -661h159l128 485q7 20 10 46q2 16 2 24h4l3 -24q1 -3 3.5 -20t5.5 -26l128 -485h159l164 661h70v107h-300v-107h90l-99 -438q-5 -20 -7 -46l-2 -21h-4q0 3 -0.5 6.5t-1.5 8t-1 6.5q-1 5 -4 21t-5 25l-144 545h-114l-144 -545q-2 -9 -4.5 -24.5
+t-3.5 -21.5l-4 -21h-4l-2 21q-2 26 -7 46l-99 438h90v107h-300z" />
+    <glyph glyph-name="_423" unicode="&#xf1c3;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M429 106v-106h281v106h-75l103 161q5 7 10 16.5t7.5 13.5t3.5 4h2q1 -4 5 -10q2 -4 4.5 -7.5t6 -8t6.5 -8.5l107 -161h-76v-106h291v106h-68l-192 273l195 282h67v107h-279v-107h74l-103 -159q-4 -7 -10 -16.5t-9 -13.5l-2 -3h-2q-1 4 -5 10q-6 11 -17 23l-106 159h76v107
+h-290v-107h68l189 -272l-194 -283h-68z" />
+    <glyph glyph-name="_424" unicode="&#xf1c4;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M416 106v-106h327v106h-93v167h137q76 0 118 15q67 23 106.5 87t39.5 146q0 81 -37 141t-100 87q-48 19 -130 19h-368v-107h92v-555h-92zM769 386h-119v268h120q52 0 83 -18q56 -33 56 -115q0 -89 -62 -120q-31 -15 -78 -15z" />
+    <glyph glyph-name="_425" unicode="&#xf1c5;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M1280 320v-320h-1024v192l192 192l128 -128l384 384zM448 512q-80 0 -136 56t-56 136t56 136t136 56t136 -56t56 -136t-56 -136t-136 -56z" />
+    <glyph glyph-name="_426" unicode="&#xf1c6;" 
+d="M640 1152v128h-128v-128h128zM768 1024v128h-128v-128h128zM640 896v128h-128v-128h128zM768 768v128h-128v-128h128zM1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400
+v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-128v-128h-128v128h-512v-1536h1280zM781 593l107 -349q8 -27 8 -52q0 -83 -72.5 -137.5t-183.5 -54.5t-183.5 54.5t-72.5 137.5q0 25 8 52q21 63 120 396v128h128v-128h79
+q22 0 39 -13t23 -34zM640 128q53 0 90.5 19t37.5 45t-37.5 45t-90.5 19t-90.5 -19t-37.5 -45t37.5 -45t90.5 -19z" />
+    <glyph glyph-name="_427" unicode="&#xf1c7;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M620 686q20 -8 20 -30v-544q0 -22 -20 -30q-8 -2 -12 -2q-12 0 -23 9l-166 167h-131q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h131l166 167q16 15 35 7zM1037 -3q31 0 50 24q129 159 129 363t-129 363q-16 21 -43 24t-47 -14q-21 -17 -23.5 -43.5t14.5 -47.5
+q100 -123 100 -282t-100 -282q-17 -21 -14.5 -47.5t23.5 -42.5q18 -15 40 -15zM826 145q27 0 47 20q87 93 87 219t-87 219q-18 19 -45 20t-46 -17t-20 -44.5t18 -46.5q52 -57 52 -131t-52 -131q-19 -20 -18 -46.5t20 -44.5q20 -17 44 -17z" />
+    <glyph glyph-name="_428" unicode="&#xf1c8;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M768 768q52 0 90 -38t38 -90v-384q0 -52 -38 -90t-90 -38h-384q-52 0 -90 38t-38 90v384q0 52 38 90t90 38h384zM1260 766q20 -8 20 -30v-576q0 -22 -20 -30q-8 -2 -12 -2q-14 0 -23 9l-265 266v90l265 266q9 9 23 9q4 0 12 -2z" />
+    <glyph glyph-name="_429" unicode="&#xf1c9;" 
+d="M1468 1156q28 -28 48 -76t20 -88v-1152q0 -40 -28 -68t-68 -28h-1344q-40 0 -68 28t-28 68v1600q0 40 28 68t68 28h896q40 0 88 -20t76 -48zM1024 1400v-376h376q-10 29 -22 41l-313 313q-12 12 -41 22zM1408 -128v1024h-416q-40 0 -68 28t-28 68v416h-768v-1536h1280z
+M480 768q8 11 21 12.5t24 -6.5l51 -38q11 -8 12.5 -21t-6.5 -24l-182 -243l182 -243q8 -11 6.5 -24t-12.5 -21l-51 -38q-11 -8 -24 -6.5t-21 12.5l-226 301q-14 19 0 38zM1282 467q14 -19 0 -38l-226 -301q-8 -11 -21 -12.5t-24 6.5l-51 38q-11 8 -12.5 21t6.5 24l182 243
+l-182 243q-8 11 -6.5 24t12.5 21l51 38q11 8 24 6.5t21 -12.5zM662 6q-13 2 -20.5 13t-5.5 24l138 831q2 13 13 20.5t24 5.5l63 -10q13 -2 20.5 -13t5.5 -24l-138 -831q-2 -13 -13 -20.5t-24 -5.5z" />
+    <glyph glyph-name="_430" unicode="&#xf1ca;" 
+d="M1497 709v-198q-101 -23 -198 -23q-65 -136 -165.5 -271t-181.5 -215.5t-128 -106.5q-80 -45 -162 3q-28 17 -60.5 43.5t-85 83.5t-102.5 128.5t-107.5 184t-105.5 244t-91.5 314.5t-70.5 390h283q26 -218 70 -398.5t104.5 -317t121.5 -235.5t140 -195q169 169 287 406
+q-142 72 -223 220t-81 333q0 192 104 314.5t284 122.5q178 0 273 -105.5t95 -297.5q0 -159 -58 -286q-7 -1 -19.5 -3t-46 -2t-63 6t-62 25.5t-50.5 51.5q31 103 31 184q0 87 -29 132t-79 45q-53 0 -85 -49.5t-32 -140.5q0 -186 105 -293.5t267 -107.5q62 0 121 14z" />
+    <glyph glyph-name="_431" unicode="&#xf1cb;" horiz-adv-x="1792" 
+d="M216 367l603 -402v359l-334 223zM154 511l193 129l-193 129v-258zM973 -35l603 402l-269 180l-334 -223v-359zM896 458l272 182l-272 182l-272 -182zM485 733l334 223v359l-603 -402zM1445 640l193 -129v258zM1307 733l269 180l-603 402v-359zM1792 913v-546
+q0 -41 -34 -64l-819 -546q-21 -13 -43 -13t-43 13l-819 546q-34 23 -34 64v546q0 41 34 64l819 546q21 13 43 13t43 -13l819 -546q34 -23 34 -64z" />
+    <glyph glyph-name="_432" unicode="&#xf1cc;" horiz-adv-x="2048" 
+d="M1800 764q111 -46 179.5 -145.5t68.5 -221.5q0 -164 -118 -280.5t-285 -116.5q-4 0 -11.5 0.5t-10.5 0.5h-1209h-1h-2h-5q-170 10 -288 125.5t-118 280.5q0 110 55 203t147 147q-12 39 -12 82q0 115 82 196t199 81q95 0 172 -58q75 154 222.5 248t326.5 94
+q166 0 306 -80.5t221.5 -218.5t81.5 -301q0 -6 -0.5 -18t-0.5 -18zM468 498q0 -122 84 -193t208 -71q137 0 240 99q-16 20 -47.5 56.5t-43.5 50.5q-67 -65 -144 -65q-55 0 -93.5 33.5t-38.5 87.5q0 53 38.5 87t91.5 34q44 0 84.5 -21t73 -55t65 -75t69 -82t77 -75t97 -55
+t121.5 -21q121 0 204.5 71.5t83.5 190.5q0 121 -84 192t-207 71q-143 0 -241 -97l93 -108q66 64 142 64q52 0 92 -33t40 -84q0 -57 -37 -91.5t-94 -34.5q-43 0 -82.5 21t-72 55t-65.5 75t-69.5 82t-77.5 75t-96.5 55t-118.5 21q-122 0 -207 -70.5t-85 -189.5z" />
+    <glyph glyph-name="_433" unicode="&#xf1cd;" horiz-adv-x="1792" 
+d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM896 1408q-190 0 -361 -90l194 -194q82 28 167 28t167 -28l194 194q-171 90 -361 90zM218 279l194 194
+q-28 82 -28 167t28 167l-194 194q-90 -171 -90 -361t90 -361zM896 -128q190 0 361 90l-194 194q-82 -28 -167 -28t-167 28l-194 -194q171 -90 361 -90zM896 256q159 0 271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5
+t271.5 -112.5zM1380 473l194 -194q90 171 90 361t-90 361l-194 -194q28 -82 28 -167t-28 -167z" />
+    <glyph glyph-name="_434" unicode="&#xf1ce;" horiz-adv-x="1792" 
+d="M1760 640q0 -176 -68.5 -336t-184 -275.5t-275.5 -184t-336 -68.5t-336 68.5t-275.5 184t-184 275.5t-68.5 336q0 213 97 398.5t265 305.5t374 151v-228q-221 -45 -366.5 -221t-145.5 -406q0 -130 51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5
+t136.5 204t51 248.5q0 230 -145.5 406t-366.5 221v228q206 -31 374 -151t265 -305.5t97 -398.5z" />
+    <glyph glyph-name="uniF1D0" unicode="&#xf1d0;" horiz-adv-x="1792" 
+d="M19 662q8 217 116 406t305 318h5q0 -1 -1 -3q-8 -8 -28 -33.5t-52 -76.5t-60 -110.5t-44.5 -135.5t-14 -150.5t39 -157.5t108.5 -154q50 -50 102 -69.5t90.5 -11.5t69.5 23.5t47 32.5l16 16q39 51 53 116.5t6.5 122.5t-21 107t-26.5 80l-14 29q-10 25 -30.5 49.5t-43 41
+t-43.5 29.5t-35 19l-13 6l104 115q39 -17 78 -52t59 -61l19 -27q1 48 -18.5 103.5t-40.5 87.5l-20 31l161 183l160 -181q-33 -46 -52.5 -102.5t-22.5 -90.5l-4 -33q22 37 61.5 72.5t67.5 52.5l28 17l103 -115q-44 -14 -85 -50t-60 -65l-19 -29q-31 -56 -48 -133.5t-7 -170
+t57 -156.5q33 -45 77.5 -60.5t85 -5.5t76 26.5t57.5 33.5l21 16q60 53 96.5 115t48.5 121.5t10 121.5t-18 118t-37 107.5t-45.5 93t-45 72t-34.5 47.5l-13 17q-14 13 -7 13l10 -3q40 -29 62.5 -46t62 -50t64 -58t58.5 -65t55.5 -77t45.5 -88t38 -103t23.5 -117t10.5 -136
+q3 -259 -108 -465t-312 -321t-456 -115q-185 0 -351 74t-283.5 198t-184 293t-60.5 353z" />
+    <glyph glyph-name="uniF1D1" unicode="&#xf1d1;" horiz-adv-x="1792" 
+d="M874 -102v-66q-208 6 -385 109.5t-283 275.5l58 34q29 -49 73 -99l65 57q148 -168 368 -212l-17 -86q65 -12 121 -13zM276 428l-83 -28q22 -60 49 -112l-57 -33q-98 180 -98 385t98 385l57 -33q-30 -56 -49 -112l82 -28q-35 -100 -35 -212q0 -109 36 -212zM1528 251
+l58 -34q-106 -172 -283 -275.5t-385 -109.5v66q56 1 121 13l-17 86q220 44 368 212l65 -57q44 50 73 99zM1377 805l-233 -80q14 -42 14 -85t-14 -85l232 -80q-31 -92 -98 -169l-185 162q-57 -67 -147 -85l48 -241q-52 -10 -98 -10t-98 10l48 241q-90 18 -147 85l-185 -162
+q-67 77 -98 169l232 80q-14 42 -14 85t14 85l-233 80q33 93 99 169l185 -162q59 68 147 86l-48 240q44 10 98 10t98 -10l-48 -240q88 -18 147 -86l185 162q66 -76 99 -169zM874 1448v-66q-65 -2 -121 -13l17 -86q-220 -42 -368 -211l-65 56q-38 -42 -73 -98l-57 33
+q106 172 282 275.5t385 109.5zM1705 640q0 -205 -98 -385l-57 33q27 52 49 112l-83 28q36 103 36 212q0 112 -35 212l82 28q-19 56 -49 112l57 33q98 -180 98 -385zM1585 1063l-57 -33q-35 56 -73 98l-65 -56q-148 169 -368 211l17 86q-56 11 -121 13v66q209 -6 385 -109.5
+t282 -275.5zM1748 640q0 173 -67.5 331t-181.5 272t-272 181.5t-331 67.5t-331 -67.5t-272 -181.5t-181.5 -272t-67.5 -331t67.5 -331t181.5 -272t272 -181.5t331 -67.5t331 67.5t272 181.5t181.5 272t67.5 331zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71
+t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="uniF1D2" unicode="&#xf1d2;" 
+d="M582 228q0 -66 -93 -66q-107 0 -107 63q0 64 98 64q102 0 102 -61zM546 694q0 -85 -74 -85q-77 0 -77 84q0 90 77 90q36 0 55 -25.5t19 -63.5zM712 769v125q-78 -29 -135 -29q-50 29 -110 29q-86 0 -145 -57t-59 -143q0 -50 29.5 -102t73.5 -67v-3q-38 -17 -38 -85
+q0 -53 41 -77v-3q-113 -37 -113 -139q0 -45 20 -78.5t54 -51t72 -25.5t81 -8q224 0 224 188q0 67 -48 99t-126 46q-27 5 -51.5 20.5t-24.5 39.5q0 44 49 52q77 15 122 70t45 134q0 24 -10 52q37 9 49 13zM771 350h137q-2 27 -2 82v387q0 46 2 69h-137q3 -23 3 -71v-392
+q0 -50 -3 -75zM1280 366v121q-30 -21 -68 -21q-53 0 -53 82v225h52q9 0 26.5 -1t26.5 -1v117h-105q0 82 3 102h-140q4 -24 4 -55v-47h-60v-117q36 3 37 3q3 0 11 -0.5t12 -0.5v-2h-2v-217q0 -37 2.5 -64t11.5 -56.5t24.5 -48.5t43.5 -31t66 -12q64 0 108 24zM924 1072
+q0 36 -24 63.5t-60 27.5t-60.5 -27t-24.5 -64q0 -36 25 -62.5t60 -26.5t59.5 27t24.5 62zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_438" unicode="&#xf1d3;" horiz-adv-x="1792" 
+d="M595 22q0 100 -165 100q-158 0 -158 -104q0 -101 172 -101q151 0 151 105zM536 777q0 61 -30 102t-89 41q-124 0 -124 -145q0 -135 124 -135q119 0 119 137zM805 1101v-202q-36 -12 -79 -22q16 -43 16 -84q0 -127 -73 -216.5t-197 -112.5q-40 -8 -59.5 -27t-19.5 -58
+q0 -31 22.5 -51.5t58 -32t78.5 -22t86 -25.5t78.5 -37.5t58 -64t22.5 -98.5q0 -304 -363 -304q-69 0 -130 12.5t-116 41t-87.5 82t-32.5 127.5q0 165 182 225v4q-67 41 -67 126q0 109 63 137v4q-72 24 -119.5 108.5t-47.5 165.5q0 139 95 231.5t235 92.5q96 0 178 -47
+q98 0 218 47zM1123 220h-222q4 45 4 134v609q0 94 -4 128h222q-4 -33 -4 -124v-613q0 -89 4 -134zM1724 442v-196q-71 -39 -174 -39q-62 0 -107 20t-70 50t-39.5 78t-18.5 92t-4 103v351h2v4q-7 0 -19 1t-18 1q-21 0 -59 -6v190h96v76q0 54 -6 89h227q-6 -41 -6 -165h171
+v-190q-15 0 -43.5 2t-42.5 2h-85v-365q0 -131 87 -131q61 0 109 33zM1148 1389q0 -58 -39 -101.5t-96 -43.5q-58 0 -98 43.5t-40 101.5q0 59 39.5 103t98.5 44q58 0 96.5 -44.5t38.5 -102.5z" />
+    <glyph glyph-name="_439" unicode="&#xf1d4;" 
+d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="uniF1D5" unicode="&#xf1d5;" horiz-adv-x="1280" 
+d="M842 964q0 -80 -57 -136.5t-136 -56.5q-60 0 -111 35q-62 -67 -115 -146q-247 -371 -202 -859q1 -22 -12.5 -38.5t-34.5 -18.5h-5q-20 0 -35 13.5t-17 33.5q-14 126 -3.5 247.5t29.5 217t54 186t69 155.5t74 125q61 90 132 165q-16 35 -16 77q0 80 56.5 136.5t136.5 56.5
+t136.5 -56.5t56.5 -136.5zM1223 953q0 -158 -78 -292t-212.5 -212t-292.5 -78q-64 0 -131 14q-21 5 -32.5 23.5t-6.5 39.5q5 20 23 31.5t39 7.5q51 -13 108 -13q97 0 186 38t153 102t102 153t38 186t-38 186t-102 153t-153 102t-186 38t-186 -38t-153 -102t-102 -153
+t-38 -186q0 -114 52 -218q10 -20 3.5 -40t-25.5 -30t-39.5 -3t-30.5 26q-64 123 -64 265q0 119 46.5 227t124.5 186t186 124t226 46q158 0 292.5 -78t212.5 -212.5t78 -292.5z" />
+    <glyph glyph-name="uniF1D6" unicode="&#xf1d6;" horiz-adv-x="1792" 
+d="M270 730q-8 19 -8 52q0 20 11 49t24 45q-1 22 7.5 53t22.5 43q0 139 92.5 288.5t217.5 209.5q139 66 324 66q133 0 266 -55q49 -21 90 -48t71 -56t55 -68t42 -74t32.5 -84.5t25.5 -89.5t22 -98l1 -5q55 -83 55 -150q0 -14 -9 -40t-9 -38q0 -1 1.5 -3.5t3.5 -5t2 -3.5
+q77 -114 120.5 -214.5t43.5 -208.5q0 -43 -19.5 -100t-55.5 -57q-9 0 -19.5 7.5t-19 17.5t-19 26t-16 26.5t-13.5 26t-9 17.5q-1 1 -3 1l-5 -4q-59 -154 -132 -223q20 -20 61.5 -38.5t69 -41.5t35.5 -65q-2 -4 -4 -16t-7 -18q-64 -97 -302 -97q-53 0 -110.5 9t-98 20
+t-104.5 30q-15 5 -23 7q-14 4 -46 4.5t-40 1.5q-41 -45 -127.5 -65t-168.5 -20q-35 0 -69 1.5t-93 9t-101 20.5t-74.5 40t-32.5 64q0 40 10 59.5t41 48.5q11 2 40.5 13t49.5 12q4 0 14 2q2 2 2 4l-2 3q-48 11 -108 105.5t-73 156.5l-5 3q-4 0 -12 -20q-18 -41 -54.5 -74.5
+t-77.5 -37.5h-1q-4 0 -6 4.5t-5 5.5q-23 54 -23 100q0 275 252 466z" />
+    <glyph glyph-name="uniF1D7" unicode="&#xf1d7;" horiz-adv-x="2048" 
+d="M580 1075q0 41 -25 66t-66 25q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 66 24.5t25 65.5zM1323 568q0 28 -25.5 50t-65.5 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q40 0 65.5 22t25.5 51zM1087 1075q0 41 -24.5 66t-65.5 25
+q-43 0 -76 -25.5t-33 -65.5q0 -39 33 -64.5t76 -25.5q41 0 65.5 24.5t24.5 65.5zM1722 568q0 28 -26 50t-65 22q-27 0 -49.5 -22.5t-22.5 -49.5q0 -28 22.5 -50.5t49.5 -22.5q39 0 65 22t26 51zM1456 965q-31 4 -70 4q-169 0 -311 -77t-223.5 -208.5t-81.5 -287.5
+q0 -78 23 -152q-35 -3 -68 -3q-26 0 -50 1.5t-55 6.5t-44.5 7t-54.5 10.5t-50 10.5l-253 -127l72 218q-290 203 -290 490q0 169 97.5 311t264 223.5t363.5 81.5q176 0 332.5 -66t262 -182.5t136.5 -260.5zM2048 404q0 -117 -68.5 -223.5t-185.5 -193.5l55 -181l-199 109
+q-150 -37 -218 -37q-169 0 -311 70.5t-223.5 191.5t-81.5 264t81.5 264t223.5 191.5t311 70.5q161 0 303 -70.5t227.5 -192t85.5 -263.5z" />
+    <glyph glyph-name="_443" unicode="&#xf1d8;" horiz-adv-x="1792" 
+d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-453 185l-242 -295q-18 -23 -49 -23q-13 0 -22 4q-19 7 -30.5 23.5t-11.5 36.5v349l864 1059l-1069 -925l-395 162q-37 14 -40 55q-2 40 32 59l1664 960q15 9 32 9q20 0 36 -11z" />
+    <glyph glyph-name="_444" unicode="&#xf1d9;" horiz-adv-x="1792" 
+d="M1764 1525q33 -24 27 -64l-256 -1536q-5 -29 -32 -45q-14 -8 -31 -8q-11 0 -24 5l-527 215l-298 -327q-18 -21 -47 -21q-14 0 -23 4q-19 7 -30 23.5t-11 36.5v452l-472 193q-37 14 -40 55q-3 39 32 59l1664 960q35 21 68 -2zM1422 26l221 1323l-1434 -827l336 -137
+l863 639l-478 -797z" />
+    <glyph glyph-name="_445" unicode="&#xf1da;" 
+d="M1536 640q0 -156 -61 -298t-164 -245t-245 -164t-298 -61q-172 0 -327 72.5t-264 204.5q-7 10 -6.5 22.5t8.5 20.5l137 138q10 9 25 9q16 -2 23 -12q73 -95 179 -147t225 -52q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5
+t-163.5 109.5t-198.5 40.5q-98 0 -188 -35.5t-160 -101.5l137 -138q31 -30 14 -69q-17 -40 -59 -40h-448q-26 0 -45 19t-19 45v448q0 42 40 59q39 17 69 -14l130 -129q107 101 244.5 156.5t284.5 55.5q156 0 298 -61t245 -164t164 -245t61 -298zM896 928v-448q0 -14 -9 -23
+t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v352q0 14 9 23t23 9h64q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="_446" unicode="&#xf1db;" 
+d="M768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103
+t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_447" unicode="&#xf1dc;" horiz-adv-x="1792" 
+d="M1682 -128q-44 0 -132.5 3.5t-133.5 3.5q-44 0 -132 -3.5t-132 -3.5q-24 0 -37 20.5t-13 45.5q0 31 17 46t39 17t51 7t45 15q33 21 33 140l-1 391q0 21 -1 31q-13 4 -50 4h-675q-38 0 -51 -4q-1 -10 -1 -31l-1 -371q0 -142 37 -164q16 -10 48 -13t57 -3.5t45 -15
+t20 -45.5q0 -26 -12.5 -48t-36.5 -22q-47 0 -139.5 3.5t-138.5 3.5q-43 0 -128 -3.5t-127 -3.5q-23 0 -35.5 21t-12.5 45q0 30 15.5 45t36 17.5t47.5 7.5t42 15q33 23 33 143l-1 57v813q0 3 0.5 26t0 36.5t-1.5 38.5t-3.5 42t-6.5 36.5t-11 31.5t-16 18q-15 10 -45 12t-53 2
+t-41 14t-18 45q0 26 12 48t36 22q46 0 138.5 -3.5t138.5 -3.5q42 0 126.5 3.5t126.5 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17 -43.5t-38.5 -14.5t-49.5 -4t-43 -13q-35 -21 -35 -160l1 -320q0 -21 1 -32q13 -3 39 -3h699q25 0 38 3q1 11 1 32l1 320q0 139 -35 160
+q-18 11 -58.5 12.5t-66 13t-25.5 49.5q0 26 12.5 48t37.5 22q44 0 132 -3.5t132 -3.5q43 0 129 3.5t129 3.5q25 0 37.5 -22t12.5 -48q0 -30 -17.5 -44t-40 -14.5t-51.5 -3t-44 -12.5q-35 -23 -35 -161l1 -943q0 -119 34 -140q16 -10 46 -13.5t53.5 -4.5t41.5 -15.5t18 -44.5
+q0 -26 -12 -48t-36 -22z" />
+    <glyph glyph-name="_448" unicode="&#xf1dd;" horiz-adv-x="1280" 
+d="M1278 1347v-73q0 -29 -18.5 -61t-42.5 -32q-50 0 -54 -1q-26 -6 -32 -31q-3 -11 -3 -64v-1152q0 -25 -18 -43t-43 -18h-108q-25 0 -43 18t-18 43v1218h-143v-1218q0 -25 -17.5 -43t-43.5 -18h-108q-26 0 -43.5 18t-17.5 43v496q-147 12 -245 59q-126 58 -192 179
+q-64 117 -64 259q0 166 88 286q88 118 209 159q111 37 417 37h479q25 0 43 -18t18 -43z" />
+    <glyph glyph-name="_449" unicode="&#xf1de;" 
+d="M352 128v-128h-352v128h352zM704 256q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM864 640v-128h-864v128h864zM224 1152v-128h-224v128h224zM1536 128v-128h-736v128h736zM576 1280q26 0 45 -19t19 -45v-256
+q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1216 768q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h256zM1536 640v-128h-224v128h224zM1536 1152v-128h-864v128h864z" />
+    <glyph glyph-name="uniF1E0" unicode="&#xf1e0;" 
+d="M1216 512q133 0 226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5t-226.5 93.5t-93.5 226.5q0 12 2 34l-360 180q-92 -86 -218 -86q-133 0 -226.5 93.5t-93.5 226.5t93.5 226.5t226.5 93.5q126 0 218 -86l360 180q-2 22 -2 34q0 133 93.5 226.5t226.5 93.5
+t226.5 -93.5t93.5 -226.5t-93.5 -226.5t-226.5 -93.5q-126 0 -218 86l-360 -180q2 -22 2 -34t-2 -34l360 -180q92 86 218 86z" />
+    <glyph glyph-name="_451" unicode="&#xf1e1;" 
+d="M1280 341q0 88 -62.5 151t-150.5 63q-84 0 -145 -58l-241 120q2 16 2 23t-2 23l241 120q61 -58 145 -58q88 0 150.5 63t62.5 151t-62.5 150.5t-150.5 62.5t-151 -62.5t-63 -150.5q0 -7 2 -23l-241 -120q-62 57 -145 57q-88 0 -150.5 -62.5t-62.5 -150.5t62.5 -150.5
+t150.5 -62.5q83 0 145 57l241 -120q-2 -16 -2 -23q0 -88 63 -150.5t151 -62.5t150.5 62.5t62.5 150.5zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_452" unicode="&#xf1e2;" horiz-adv-x="1792" 
+d="M571 947q-10 25 -34 35t-49 0q-108 -44 -191 -127t-127 -191q-10 -25 0 -49t35 -34q13 -5 24 -5q42 0 60 40q34 84 98.5 148.5t148.5 98.5q25 11 35 35t0 49zM1513 1303l46 -46l-244 -243l68 -68q19 -19 19 -45.5t-19 -45.5l-64 -64q89 -161 89 -343q0 -143 -55.5 -273.5
+t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5q182 0 343 -89l64 64q19 19 45.5 19t45.5 -19l68 -68zM1521 1359q-10 -10 -22 -10q-13 0 -23 10l-91 90q-9 10 -9 23t9 23q10 9 23 9t23 -9l90 -91
+q10 -9 10 -22.5t-10 -22.5zM1751 1129q-11 -9 -23 -9t-23 9l-90 91q-10 9 -10 22.5t10 22.5q9 10 22.5 10t22.5 -10l91 -90q9 -10 9 -23t-9 -23zM1792 1312q0 -14 -9 -23t-23 -9h-96q-14 0 -23 9t-9 23t9 23t23 9h96q14 0 23 -9t9 -23zM1600 1504v-96q0 -14 -9 -23t-23 -9
+t-23 9t-9 23v96q0 14 9 23t23 9t23 -9t9 -23zM1751 1449l-91 -90q-10 -10 -22 -10q-13 0 -23 10q-10 9 -10 22.5t10 22.5l90 91q10 9 23 9t23 -9q9 -10 9 -23t-9 -23z" />
+    <glyph glyph-name="_453" unicode="&#xf1e3;" horiz-adv-x="1792" 
+d="M609 720l287 208l287 -208l-109 -336h-355zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM1515 186q149 203 149 454v3l-102 -89l-240 224l63 323
+l134 -12q-150 206 -389 282l53 -124l-287 -159l-287 159l53 124q-239 -76 -389 -282l135 12l62 -323l-240 -224l-102 89v-3q0 -251 149 -454l30 132l326 -40l139 -298l-116 -69q117 -39 240 -39t240 39l-116 69l139 298l326 40z" />
+    <glyph glyph-name="_454" unicode="&#xf1e4;" horiz-adv-x="1792" 
+d="M448 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM256 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM832 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23
+v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM640 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM66 768q-28 0 -47 19t-19 46v129h514v-129q0 -27 -19 -46t-46 -19h-383zM1216 224v-192q0 -14 -9 -23t-23 -9h-192
+q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1024 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1600 224v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23
+zM1408 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 1016v-13h-514v10q0 104 -382 102q-382 -1 -382 -102v-10h-514v13q0 17 8.5 43t34 64t65.5 75.5t110.5 76t160 67.5t224 47.5t293.5 18.5t293 -18.5t224 -47.5
+t160.5 -67.5t110.5 -76t65.5 -75.5t34 -64t8.5 -43zM1792 608v-192q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v192q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 962v-129q0 -27 -19 -46t-46 -19h-384q-27 0 -46 19t-19 46v129h514z" />
+    <glyph glyph-name="_455" unicode="&#xf1e5;" horiz-adv-x="1792" 
+d="M704 1216v-768q0 -26 -19 -45t-45 -19v-576q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v512l249 873q7 23 31 23h424zM1024 1216v-704h-256v704h256zM1792 320v-512q0 -26 -19 -45t-45 -19h-512q-26 0 -45 19t-19 45v576q-26 0 -45 19t-19 45v768h424q24 0 31 -23z
+M736 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23zM1408 1504v-224h-352v224q0 14 9 23t23 9h288q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="_456" unicode="&#xf1e6;" horiz-adv-x="1792" 
+d="M1755 1083q37 -38 37 -90.5t-37 -90.5l-401 -400l150 -150l-160 -160q-163 -163 -389.5 -186.5t-411.5 100.5l-362 -362h-181v181l362 362q-124 185 -100.5 411.5t186.5 389.5l160 160l150 -150l400 401q38 37 91 37t90 -37t37 -90.5t-37 -90.5l-400 -401l234 -234
+l401 400q38 37 91 37t90 -37z" />
+    <glyph glyph-name="_457" unicode="&#xf1e7;" horiz-adv-x="1792" 
+d="M873 796q0 -83 -63.5 -142.5t-152.5 -59.5t-152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59t152.5 -59t63.5 -143zM1375 796q0 -83 -63 -142.5t-153 -59.5q-89 0 -152.5 59.5t-63.5 142.5q0 84 63.5 143t152.5 59q90 0 153 -59t63 -143zM1600 616v667q0 87 -32 123.5
+t-111 36.5h-1112q-83 0 -112.5 -34t-29.5 -126v-673q43 -23 88.5 -40t81 -28t81 -18.5t71 -11t70 -4t58.5 -0.5t56.5 2t44.5 2q68 1 95 -27q6 -6 10 -9q26 -25 61 -51q7 91 118 87q5 0 36.5 -1.5t43 -2t45.5 -1t53 1t54.5 4.5t61 8.5t62 13.5t67 19.5t67.5 27t72 34.5z
+M1763 621q-121 -149 -372 -252q84 -285 -23 -465q-66 -113 -183 -148q-104 -32 -182 15q-86 51 -82 164l-1 326v1q-8 2 -24.5 6t-23.5 5l-1 -338q4 -114 -83 -164q-79 -47 -183 -15q-117 36 -182 150q-105 180 -22 463q-251 103 -372 252q-25 37 -4 63t60 -1q4 -2 11.5 -7
+t10.5 -8v694q0 72 47 123t114 51h1257q67 0 114 -51t47 -123v-694l21 15q39 27 60 1t-4 -63z" />
+    <glyph glyph-name="_458" unicode="&#xf1e8;" horiz-adv-x="1792" 
+d="M896 1102v-434h-145v434h145zM1294 1102v-434h-145v434h145zM1294 342l253 254v795h-1194v-1049h326v-217l217 217h398zM1692 1536v-1013l-434 -434h-326l-217 -217h-217v217h-398v1158l109 289h1483z" />
+    <glyph glyph-name="_459" unicode="&#xf1e9;" 
+d="M773 217v-127q-1 -292 -6 -305q-12 -32 -51 -40q-54 -9 -181.5 38t-162.5 89q-13 15 -17 36q-1 12 4 26q4 10 34 47t181 216q1 0 60 70q15 19 39.5 24.5t49.5 -3.5q24 -10 37.5 -29t12.5 -42zM624 468q-3 -55 -52 -70l-120 -39q-275 -88 -292 -88q-35 2 -54 36
+q-12 25 -17 75q-8 76 1 166.5t30 124.5t56 32q13 0 202 -77q71 -29 115 -47l84 -34q23 -9 35.5 -30.5t11.5 -48.5zM1450 171q-7 -54 -91.5 -161t-135.5 -127q-37 -14 -63 7q-14 10 -184 287l-47 77q-14 21 -11.5 46t19.5 46q35 43 83 26q1 -1 119 -40q203 -66 242 -79.5
+t47 -20.5q28 -22 22 -61zM778 803q5 -102 -54 -122q-58 -17 -114 71l-378 598q-8 35 19 62q41 43 207.5 89.5t224.5 31.5q40 -10 49 -45q3 -18 22 -305.5t24 -379.5zM1440 695q3 -39 -26 -59q-15 -10 -329 -86q-67 -15 -91 -23l1 2q-23 -6 -46 4t-37 32q-30 47 0 87
+q1 1 75 102q125 171 150 204t34 39q28 19 65 2q48 -23 123 -133.5t81 -167.5v-3z" />
+    <glyph glyph-name="_460" unicode="&#xf1ea;" horiz-adv-x="2048" 
+d="M1024 1024h-384v-384h384v384zM1152 384v-128h-640v128h640zM1152 1152v-640h-640v640h640zM1792 384v-128h-512v128h512zM1792 640v-128h-512v128h512zM1792 896v-128h-512v128h512zM1792 1152v-128h-512v128h512zM256 192v960h-128v-960q0 -26 19 -45t45 -19t45 19
+t19 45zM1920 192v1088h-1536v-1088q0 -33 -11 -64h1483q26 0 45 19t19 45zM2048 1408v-1216q0 -80 -56 -136t-136 -56h-1664q-80 0 -136 56t-56 136v1088h256v128h1792z" />
+    <glyph glyph-name="_461" unicode="&#xf1eb;" horiz-adv-x="2048" 
+d="M1024 13q-20 0 -93 73.5t-73 93.5q0 32 62.5 54t103.5 22t103.5 -22t62.5 -54q0 -20 -73 -93.5t-93 -73.5zM1294 284q-2 0 -40 25t-101.5 50t-128.5 25t-128.5 -25t-101 -50t-40.5 -25q-18 0 -93.5 75t-75.5 93q0 13 10 23q78 77 196 121t233 44t233 -44t196 -121
+q10 -10 10 -23q0 -18 -75.5 -93t-93.5 -75zM1567 556q-11 0 -23 8q-136 105 -252 154.5t-268 49.5q-85 0 -170.5 -22t-149 -53t-113.5 -62t-79 -53t-31 -22q-17 0 -92 75t-75 93q0 12 10 22q132 132 320 205t380 73t380 -73t320 -205q10 -10 10 -22q0 -18 -75 -93t-92 -75z
+M1838 827q-11 0 -22 9q-179 157 -371.5 236.5t-420.5 79.5t-420.5 -79.5t-371.5 -236.5q-11 -9 -22 -9q-17 0 -92.5 75t-75.5 93q0 13 10 23q187 186 445 288t527 102t527 -102t445 -288q10 -10 10 -23q0 -18 -75.5 -93t-92.5 -75z" />
+    <glyph glyph-name="_462" unicode="&#xf1ec;" horiz-adv-x="1792" 
+d="M384 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM384 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5
+t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 0q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5
+t37.5 90.5zM384 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1152 384q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM768 768q0 53 -37.5 90.5t-90.5 37.5
+t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1536 0v384q0 52 -38 90t-90 38t-90 -38t-38 -90v-384q0 -52 38 -90t90 -38t90 38t38 90zM1152 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z
+M1536 1088v256q0 26 -19 45t-45 19h-1280q-26 0 -45 -19t-19 -45v-256q0 -26 19 -45t45 -19h1280q26 0 45 19t19 45zM1536 768q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1664 1408v-1536q0 -52 -38 -90t-90 -38
+h-1408q-52 0 -90 38t-38 90v1536q0 52 38 90t90 38h1408q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_463" unicode="&#xf1ed;" 
+d="M1519 890q18 -84 -4 -204q-87 -444 -565 -444h-44q-25 0 -44 -16.5t-24 -42.5l-4 -19l-55 -346l-2 -15q-5 -26 -24.5 -42.5t-44.5 -16.5h-251q-21 0 -33 15t-9 36q9 56 26.5 168t26.5 168t27 167.5t27 167.5q5 37 43 37h131q133 -2 236 21q175 39 287 144q102 95 155 246
+q24 70 35 133q1 6 2.5 7.5t3.5 1t6 -3.5q79 -59 98 -162zM1347 1172q0 -107 -46 -236q-80 -233 -302 -315q-113 -40 -252 -42q0 -1 -90 -1l-90 1q-100 0 -118 -96q-2 -8 -85 -530q-1 -10 -12 -10h-295q-22 0 -36.5 16.5t-11.5 38.5l232 1471q5 29 27.5 48t51.5 19h598
+q34 0 97.5 -13t111.5 -32q107 -41 163.5 -123t56.5 -196z" />
+    <glyph glyph-name="_464" unicode="&#xf1ee;" horiz-adv-x="1792" 
+d="M441 864q33 0 52 -26q266 -364 362 -774h-446q-127 441 -367 749q-12 16 -3 33.5t29 17.5h373zM1000 507q-49 -199 -125 -393q-79 310 -256 594q40 221 44 449q211 -340 337 -650zM1099 1216q235 -324 384.5 -698.5t184.5 -773.5h-451q-41 665 -553 1472h435zM1792 640
+q0 -424 -101 -812q-67 560 -359 1083q-25 301 -106 584q-4 16 5.5 28.5t25.5 12.5h359q21 0 38.5 -13t22.5 -33q115 -409 115 -850z" />
+    <glyph glyph-name="uniF1F0" unicode="&#xf1f0;" horiz-adv-x="2304" 
+d="M1975 546h-138q14 37 66 179l3 9q4 10 10 26t9 26l12 -55zM531 611l-58 295q-11 54 -75 54h-268l-2 -13q311 -79 403 -336zM710 960l-162 -438l-17 89q-26 70 -85 129.5t-131 88.5l135 -510h175l261 641h-176zM849 318h166l104 642h-166zM1617 944q-69 27 -149 27
+q-123 0 -201 -59t-79 -153q-1 -102 145 -174q48 -23 67 -41t19 -39q0 -30 -30 -46t-69 -16q-86 0 -156 33l-22 11l-23 -144q74 -34 185 -34q130 -1 208.5 59t80.5 160q0 106 -140 174q-49 25 -71 42t-22 38q0 22 24.5 38.5t70.5 16.5q70 1 124 -24l15 -8zM2042 960h-128
+q-65 0 -87 -54l-246 -588h174l35 96h212q5 -22 20 -96h154zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_466" unicode="&#xf1f1;" horiz-adv-x="2304" 
+d="M1119 1195q-128 85 -281 85q-103 0 -197.5 -40.5t-162.5 -108.5t-108.5 -162t-40.5 -197q0 -104 40.5 -198t108.5 -162t162 -108.5t198 -40.5q153 0 281 85q-131 107 -178 265.5t0.5 316.5t177.5 265zM1152 1171q-126 -99 -172 -249.5t-0.5 -300.5t172.5 -249
+q127 99 172.5 249t-0.5 300.5t-172 249.5zM1185 1195q130 -107 177.5 -265.5t0.5 -317t-178 -264.5q128 -85 281 -85q104 0 198 40.5t162 108.5t108.5 162t40.5 198q0 103 -40.5 197t-108.5 162t-162.5 108.5t-197.5 40.5q-153 0 -281 -85zM1926 473h7v3h-17v-3h7v-17h3v17z
+M1955 456h4v20h-5l-6 -13l-6 13h-5v-20h3v15l6 -13h4l5 13v-15zM1947 16v-2h-2h-3v3h3h2v-1zM1947 7h3l-4 5h2l1 1q1 1 1 3t-1 3l-1 1h-3h-6v-13h3v5h1zM685 75q0 19 11 31t30 12q18 0 29 -12.5t11 -30.5q0 -19 -11 -31t-29 -12q-19 0 -30 12t-11 31zM1158 119q30 0 35 -32
+h-70q5 32 35 32zM1514 75q0 19 11 31t29 12t29.5 -12.5t11.5 -30.5q0 -19 -11 -31t-30 -12q-18 0 -29 12t-11 31zM1786 75q0 18 11.5 30.5t29.5 12.5t29.5 -12.5t11.5 -30.5q0 -19 -11.5 -31t-29.5 -12t-29.5 12.5t-11.5 30.5zM1944 3q-2 0 -4 1q-1 0 -3 2t-2 3q-1 2 -1 4
+q0 3 1 4q0 2 2 4l1 1q2 0 2 1q2 1 4 1q3 0 4 -1l4 -2l2 -4v-1q1 -2 1 -3l-1 -1v-3t-1 -1l-1 -2q-2 -2 -4 -2q-1 -1 -4 -1zM599 7h30v85q0 24 -14.5 38.5t-39.5 15.5q-32 0 -47 -24q-14 24 -45 24q-24 0 -39 -20v16h-30v-135h30v75q0 36 33 36q30 0 30 -36v-75h29v75
+q0 36 33 36q30 0 30 -36v-75zM765 7h29v68v67h-29v-16q-17 20 -43 20q-29 0 -48 -20t-19 -51t19 -51t48 -20q28 0 43 20v-17zM943 48q0 34 -47 40l-14 2q-23 4 -23 14q0 15 25 15q23 0 43 -11l12 24q-22 14 -55 14q-26 0 -41 -12t-15 -32q0 -33 47 -39l13 -2q24 -4 24 -14
+q0 -17 -31 -17q-25 0 -45 14l-13 -23q25 -17 58 -17q29 0 45.5 12t16.5 32zM1073 14l-8 25q-13 -7 -26 -7q-19 0 -19 22v61h48v27h-48v41h-30v-41h-28v-27h28v-61q0 -50 47 -50q21 0 36 10zM1159 146q-29 0 -48 -20t-19 -51q0 -32 19.5 -51.5t49.5 -19.5q33 0 55 19l-14 22
+q-18 -15 -39 -15q-34 0 -41 33h101v12q0 32 -18 51.5t-46 19.5zM1318 146q-23 0 -35 -20v16h-30v-135h30v76q0 35 29 35q10 0 18 -4l9 28q-9 4 -21 4zM1348 75q0 -31 19.5 -51t52.5 -20q29 0 48 16l-14 24q-18 -13 -35 -12q-18 0 -29.5 12t-11.5 31t11.5 31t29.5 12
+q19 0 35 -12l14 24q-20 16 -48 16q-33 0 -52.5 -20t-19.5 -51zM1593 7h30v68v67h-30v-16q-15 20 -42 20q-29 0 -48.5 -20t-19.5 -51t19.5 -51t48.5 -20q28 0 42 20v-17zM1726 146q-23 0 -35 -20v16h-29v-135h29v76q0 35 29 35q10 0 18 -4l9 28q-8 4 -21 4zM1866 7h29v68v122
+h-29v-71q-15 20 -43 20t-47.5 -20.5t-19.5 -50.5t19.5 -50.5t47.5 -20.5q29 0 43 20v-17zM1944 27l-2 -1h-3q-2 -1 -4 -3q-3 -1 -3 -4q-1 -2 -1 -6q0 -3 1 -5q0 -2 3 -4q2 -2 4 -3t5 -1q4 0 6 1q0 1 2 2l2 1q1 1 3 4q1 2 1 5q0 4 -1 6q-1 1 -3 4q0 1 -2 2l-2 1q-1 0 -3 0.5
+t-3 0.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_467" unicode="&#xf1f2;" horiz-adv-x="2304" 
+d="M313 759q0 -51 -36 -84q-29 -26 -89 -26h-17v220h17q61 0 89 -27q36 -31 36 -83zM2089 824q0 -52 -64 -52h-19v101h20q63 0 63 -49zM380 759q0 74 -50 120.5t-129 46.5h-95v-333h95q74 0 119 38q60 51 60 128zM410 593h65v333h-65v-333zM730 694q0 40 -20.5 62t-75.5 42
+q-29 10 -39.5 19t-10.5 23q0 16 13.5 26.5t34.5 10.5q29 0 53 -27l34 44q-41 37 -98 37q-44 0 -74 -27.5t-30 -67.5q0 -35 18 -55.5t64 -36.5q37 -13 45 -19q19 -12 19 -34q0 -20 -14 -33.5t-36 -13.5q-48 0 -71 44l-42 -40q44 -64 115 -64q51 0 83 30.5t32 79.5zM1008 604
+v77q-37 -37 -78 -37q-49 0 -80.5 32.5t-31.5 82.5q0 48 31.5 81.5t77.5 33.5q43 0 81 -38v77q-40 20 -80 20q-74 0 -125.5 -50.5t-51.5 -123.5t51 -123.5t125 -50.5q42 0 81 19zM2240 0v527q-65 -40 -144.5 -84t-237.5 -117t-329.5 -137.5t-417.5 -134.5t-504 -118h1569
+q26 0 45 19t19 45zM1389 757q0 75 -53 128t-128 53t-128 -53t-53 -128t53 -128t128 -53t128 53t53 128zM1541 584l144 342h-71l-90 -224l-89 224h-71l142 -342h35zM1714 593h184v56h-119v90h115v56h-115v74h119v57h-184v-333zM2105 593h80l-105 140q76 16 76 94q0 47 -31 73
+t-87 26h-97v-333h65v133h9zM2304 1274v-1268q0 -56 -38.5 -95t-93.5 -39h-2040q-55 0 -93.5 39t-38.5 95v1268q0 56 38.5 95t93.5 39h2040q55 0 93.5 -39t38.5 -95z" />
+    <glyph glyph-name="f1f3" unicode="&#xf1f3;" horiz-adv-x="2304" 
+d="M119 854h89l-45 108zM740 328l74 79l-70 79h-163v-49h142v-55h-142v-54h159zM898 406l99 -110v217zM1186 453q0 33 -40 33h-84v-69h83q41 0 41 36zM1475 457q0 29 -42 29h-82v-61h81q43 0 43 32zM1197 923q0 29 -42 29h-82v-60h81q43 0 43 31zM1656 854h89l-44 108z
+M699 1009v-271h-66v212l-94 -212h-57l-94 212v-212h-132l-25 60h-135l-25 -60h-70l116 271h96l110 -257v257h106l85 -184l77 184h108zM1255 453q0 -20 -5.5 -35t-14 -25t-22.5 -16.5t-26 -10t-31.5 -4.5t-31.5 -1t-32.5 0.5t-29.5 0.5v-91h-126l-80 90l-83 -90h-256v271h260
+l80 -89l82 89h207q109 0 109 -89zM964 794v-56h-217v271h217v-57h-152v-49h148v-55h-148v-54h152zM2304 235v-229q0 -55 -38.5 -94.5t-93.5 -39.5h-2040q-55 0 -93.5 39.5t-38.5 94.5v678h111l25 61h55l25 -61h218v46l19 -46h113l20 47v-47h541v99l10 1q10 0 10 -14v-86h279
+v23q23 -12 55 -18t52.5 -6.5t63 0.5t51.5 1l25 61h56l25 -61h227v58l34 -58h182v378h-180v-44l-25 44h-185v-44l-23 44h-249q-69 0 -109 -22v22h-172v-22q-24 22 -73 22h-628l-43 -97l-43 97h-198v-44l-22 44h-169l-78 -179v391q0 55 38.5 94.5t93.5 39.5h2040
+q55 0 93.5 -39.5t38.5 -94.5v-678h-120q-51 0 -81 -22v22h-177q-55 0 -78 -22v22h-316v-22q-31 22 -87 22h-209v-22q-23 22 -91 22h-234l-54 -58l-50 58h-349v-378h343l55 59l52 -59h211v89h21q59 0 90 13v-102h174v99h8q8 0 10 -2t2 -10v-87h529q57 0 88 24v-24h168
+q60 0 95 17zM1546 469q0 -23 -12 -43t-34 -29q25 -9 34 -26t9 -46v-54h-65v45q0 33 -12 43.5t-46 10.5h-69v-99h-65v271h154q48 0 77 -15t29 -58zM1269 936q0 -24 -12.5 -44t-33.5 -29q26 -9 34.5 -25.5t8.5 -46.5v-53h-65q0 9 0.5 26.5t0 25t-3 18.5t-8.5 16t-17.5 8.5
+t-29.5 3.5h-70v-98h-64v271l153 -1q49 0 78 -14.5t29 -57.5zM1798 327v-56h-216v271h216v-56h-151v-49h148v-55h-148v-54zM1372 1009v-271h-66v271h66zM2065 357q0 -86 -102 -86h-126v58h126q34 0 34 25q0 16 -17 21t-41.5 5t-49.5 3.5t-42 22.5t-17 55q0 39 26 60t66 21
+h130v-57h-119q-36 0 -36 -25q0 -16 17.5 -20.5t42 -4t49 -2.5t42 -21.5t17.5 -54.5zM2304 407v-101q-24 -35 -88 -35h-125v58h125q33 0 33 25q0 13 -12.5 19t-31 5.5t-40 2t-40 8t-31 24t-12.5 48.5q0 39 26.5 60t66.5 21h129v-57h-118q-36 0 -36 -25q0 -20 29 -22t68.5 -5
+t56.5 -26zM2139 1008v-270h-92l-122 203v-203h-132l-26 60h-134l-25 -60h-75q-129 0 -129 133q0 138 133 138h63v-59q-7 0 -28 1t-28.5 0.5t-23 -2t-21.5 -6.5t-14.5 -13.5t-11.5 -23t-3 -33.5q0 -38 13.5 -58t49.5 -20h29l92 213h97l109 -256v256h99l114 -188v188h66z" />
+    <glyph glyph-name="_469" unicode="&#xf1f4;" horiz-adv-x="2304" 
+d="M745 630q0 -37 -25.5 -61.5t-62.5 -24.5q-29 0 -46.5 16t-17.5 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM1530 779q0 -42 -22 -57t-66 -15l-32 -1l17 107q2 11 13 11h18q22 0 35 -2t25 -12.5t12 -30.5zM1881 630q0 -36 -25.5 -61t-61.5 -25q-29 0 -47 16
+t-18 44q0 37 25 62.5t62 25.5q28 0 46.5 -16.5t18.5 -45.5zM513 801q0 59 -38.5 85.5t-100.5 26.5h-160q-19 0 -21 -19l-65 -408q-1 -6 3 -11t10 -5h76q20 0 22 19l18 110q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM822 489l41 261q1 6 -3 11t-10 5h-76
+q-14 0 -17 -33q-27 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q28 0 58 12t48 32q-4 -12 -4 -21q0 -16 13 -16h69q19 0 22 19zM1269 752q0 5 -4 9.5t-9 4.5h-77q-11 0 -18 -10l-106 -156l-44 150q-5 16 -22 16h-75q-5 0 -9 -4.5t-4 -9.5q0 -2 19.5 -59
+t42 -123t23.5 -70q-82 -112 -82 -120q0 -13 13 -13h77q11 0 18 10l255 368q2 2 2 7zM1649 801q0 59 -38.5 85.5t-100.5 26.5h-159q-20 0 -22 -19l-65 -408q-1 -6 3 -11t10 -5h82q12 0 16 13l18 116q1 8 7 13t15 6.5t17 1.5t19 -1t14 -1q86 0 135 48.5t49 134.5zM1958 489
+l41 261q1 6 -3 11t-10 5h-76q-14 0 -17 -33q-26 40 -95 40q-72 0 -122.5 -54t-50.5 -127q0 -59 34.5 -94t92.5 -35q29 0 59 12t47 32q0 -1 -2 -9t-2 -12q0 -16 13 -16h69q19 0 22 19zM2176 898v1q0 14 -13 14h-74q-11 0 -13 -11l-65 -416l-1 -2q0 -5 4 -9.5t10 -4.5h66
+q19 0 21 19zM392 764q-5 -35 -26 -46t-60 -11l-33 -1l17 107q2 11 13 11h19q40 0 58 -11.5t12 -48.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_470" unicode="&#xf1f5;" horiz-adv-x="2304" 
+d="M1597 633q0 -69 -21 -106q-19 -35 -52 -35q-23 0 -41 9v224q29 30 57 30q57 0 57 -122zM2035 669h-110q6 98 56 98q51 0 54 -98zM476 534q0 59 -33 91.5t-101 57.5q-36 13 -52 24t-16 25q0 26 38 26q58 0 124 -33l18 112q-67 32 -149 32q-77 0 -123 -38q-48 -39 -48 -109
+q0 -58 32.5 -90.5t99.5 -56.5q39 -14 54.5 -25.5t15.5 -27.5q0 -31 -48 -31q-29 0 -70 12.5t-72 30.5l-18 -113q72 -41 168 -41q81 0 129 37q51 41 51 117zM771 749l19 111h-96v135l-129 -21l-18 -114l-46 -8l-17 -103h62v-219q0 -84 44 -120q38 -30 111 -30q32 0 79 11v118
+q-32 -7 -44 -7q-42 0 -42 50v197h77zM1087 724v139q-15 3 -28 3q-32 0 -55.5 -16t-33.5 -46l-10 56h-131v-471h150v306q26 31 82 31q16 0 26 -2zM1124 389h150v471h-150v-471zM1746 638q0 122 -45 179q-40 52 -111 52q-64 0 -117 -56l-8 47h-132v-645l150 25v151
+q36 -11 68 -11q83 0 134 56q61 65 61 202zM1278 986q0 33 -23 56t-56 23t-56 -23t-23 -56t23 -56.5t56 -23.5t56 23.5t23 56.5zM2176 629q0 113 -48 176q-50 64 -144 64q-96 0 -151.5 -66t-55.5 -180q0 -128 63 -188q55 -55 161 -55q101 0 160 40l-16 103q-57 -31 -128 -31
+q-43 0 -63 19q-23 19 -28 66h248q2 14 2 52zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_471" unicode="&#xf1f6;" horiz-adv-x="2048" 
+d="M1558 684q61 -356 298 -556q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5zM1024 -176q16 0 16 16t-16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5zM2026 1424q8 -10 7.5 -23.5t-10.5 -22.5
+l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5
+l418 363q10 8 23.5 7t21.5 -11z" />
+    <glyph glyph-name="_472" unicode="&#xf1f7;" horiz-adv-x="2048" 
+d="M1040 -160q0 16 -16 16q-59 0 -101.5 42.5t-42.5 101.5q0 16 -16 16t-16 -16q0 -73 51.5 -124.5t124.5 -51.5q16 0 16 16zM503 315l877 760q-42 88 -132.5 146.5t-223.5 58.5q-93 0 -169.5 -31.5t-121.5 -80.5t-69 -103t-24 -105q0 -384 -137 -645zM1856 128
+q0 -52 -38 -90t-90 -38h-448q0 -106 -75 -181t-181 -75t-180.5 74.5t-75.5 180.5l149 129h757q-166 187 -227 459l111 97q61 -356 298 -556zM1942 1520l84 -96q8 -10 7.5 -23.5t-10.5 -22.5l-1872 -1622q-10 -8 -23.5 -7t-21.5 11l-84 96q-8 10 -7.5 23.5t10.5 21.5l186 161
+q-19 32 -19 66q50 42 91 88t85 119.5t74.5 158.5t50 206t19.5 260q0 152 117 282.5t307 158.5q-8 19 -8 39q0 40 28 68t68 28t68 -28t28 -68q0 -20 -8 -39q124 -18 219 -82.5t148 -157.5l418 363q10 8 23.5 7t21.5 -11z" />
+    <glyph glyph-name="_473" unicode="&#xf1f8;" horiz-adv-x="1408" 
+d="M512 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM768 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1024 160v704q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-704
+q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM480 1152h448l-48 117q-7 9 -17 11h-317q-10 -2 -17 -11zM1408 1120v-64q0 -14 -9 -23t-23 -9h-96v-948q0 -83 -47 -143.5t-113 -60.5h-832q-66 0 -113 58.5t-47 141.5v952h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h309l70 167
+q15 37 54 63t79 26h320q40 0 79 -26t54 -63l70 -167h309q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="_474" unicode="&#xf1f9;" 
+d="M1150 462v-109q0 -50 -36.5 -89t-94 -60.5t-118 -32.5t-117.5 -11q-205 0 -342.5 139t-137.5 346q0 203 136 339t339 136q34 0 75.5 -4.5t93 -18t92.5 -34t69 -56.5t28 -81v-109q0 -16 -16 -16h-118q-16 0 -16 16v70q0 43 -65.5 67.5t-137.5 24.5q-140 0 -228.5 -91.5
+t-88.5 -237.5q0 -151 91.5 -249.5t233.5 -98.5q68 0 138 24t70 66v70q0 7 4.5 11.5t10.5 4.5h119q6 0 11 -4.5t5 -11.5zM768 1280q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5
+t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_475" unicode="&#xf1fa;" 
+d="M972 761q0 108 -53.5 169t-147.5 61q-63 0 -124 -30.5t-110 -84.5t-79.5 -137t-30.5 -180q0 -112 53.5 -173t150.5 -61q96 0 176 66.5t122.5 166t42.5 203.5zM1536 640q0 -111 -37 -197t-98.5 -135t-131.5 -74.5t-145 -27.5q-6 0 -15.5 -0.5t-16.5 -0.5q-95 0 -142 53
+q-28 33 -33 83q-52 -66 -131.5 -110t-173.5 -44q-161 0 -249.5 95.5t-88.5 269.5q0 157 66 290t179 210.5t246 77.5q87 0 155 -35.5t106 -99.5l2 19l11 56q1 6 5.5 12t9.5 6h118q5 0 13 -11q5 -5 3 -16l-120 -614q-5 -24 -5 -48q0 -39 12.5 -52t44.5 -13q28 1 57 5.5t73 24
+t77 50t57 89.5t24 137q0 292 -174 466t-466 174q-130 0 -248.5 -51t-204 -136.5t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51q228 0 405 144q11 9 24 8t21 -12l41 -49q8 -12 7 -24q-2 -13 -12 -22q-102 -83 -227.5 -128t-258.5 -45q-156 0 -298 61
+t-245 164t-164 245t-61 298t61 298t164 245t245 164t298 61q344 0 556 -212t212 -556z" />
+    <glyph glyph-name="_476" unicode="&#xf1fb;" horiz-adv-x="1792" 
+d="M1698 1442q94 -94 94 -226.5t-94 -225.5l-225 -223l104 -104q10 -10 10 -23t-10 -23l-210 -210q-10 -10 -23 -10t-23 10l-105 105l-603 -603q-37 -37 -90 -37h-203l-256 -128l-64 64l128 256v203q0 53 37 90l603 603l-105 105q-10 10 -10 23t10 23l210 210q10 10 23 10
+t23 -10l104 -104l223 225q93 94 225.5 94t226.5 -94zM512 64l576 576l-192 192l-576 -576v-192h192z" />
+    <glyph glyph-name="f1fc" unicode="&#xf1fc;" horiz-adv-x="1792" 
+d="M1615 1536q70 0 122.5 -46.5t52.5 -116.5q0 -63 -45 -151q-332 -629 -465 -752q-97 -91 -218 -91q-126 0 -216.5 92.5t-90.5 219.5q0 128 92 212l638 579q59 54 130 54zM706 502q39 -76 106.5 -130t150.5 -76l1 -71q4 -213 -129.5 -347t-348.5 -134q-123 0 -218 46.5
+t-152.5 127.5t-86.5 183t-29 220q7 -5 41 -30t62 -44.5t59 -36.5t46 -17q41 0 55 37q25 66 57.5 112.5t69.5 76t88 47.5t103 25.5t125 10.5z" />
+    <glyph glyph-name="_478" unicode="&#xf1fd;" horiz-adv-x="1792" 
+d="M1792 128v-384h-1792v384q45 0 85 14t59 27.5t47 37.5q30 27 51.5 38t56.5 11q24 0 44 -7t31 -15t33 -27q29 -25 47 -38t58 -27t86 -14q45 0 85 14.5t58 27t48 37.5q21 19 32.5 27t31 15t43.5 7q35 0 56.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14t85 14t59 27.5
+t47 37.5q30 27 51.5 38t56.5 11q34 0 55.5 -11t51.5 -38q28 -24 47 -37.5t59 -27.5t85 -14zM1792 448v-192q-24 0 -44 7t-31 15t-33 27q-29 25 -47 38t-58 27t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-22 -19 -33 -27t-31 -15t-44 -7q-35 0 -56.5 11t-51.5 38q-29 25 -47 38
+t-58 27t-86 14q-45 0 -85 -14.5t-58 -27t-48 -37.5q-21 -19 -32.5 -27t-31 -15t-43.5 -7q-35 0 -56.5 11t-51.5 38q-28 24 -47 37.5t-59 27.5t-85 14q-46 0 -86 -14t-58 -27t-47 -38q-30 -27 -51.5 -38t-56.5 -11v192q0 80 56 136t136 56h64v448h256v-448h256v448h256v-448
+h256v448h256v-448h64q80 0 136 -56t56 -136zM512 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1024 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5
+q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150zM1536 1312q0 -77 -36 -118.5t-92 -41.5q-53 0 -90.5 37.5t-37.5 90.5q0 29 9.5 51t23.5 34t31 28t31 31.5t23.5 44.5t9.5 67q38 0 83 -74t45 -150z" />
+    <glyph glyph-name="_479" unicode="&#xf1fe;" horiz-adv-x="2048" 
+d="M2048 0v-128h-2048v1536h128v-1408h1920zM1664 1024l256 -896h-1664v576l448 576l576 -576z" />
+    <glyph glyph-name="_480" unicode="&#xf200;" horiz-adv-x="1792" 
+d="M768 646l546 -546q-106 -108 -247.5 -168t-298.5 -60q-209 0 -385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103v-762zM955 640h773q0 -157 -60 -298.5t-168 -247.5zM1664 768h-768v768q209 0 385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_481" unicode="&#xf201;" horiz-adv-x="2048" 
+d="M2048 0v-128h-2048v1536h128v-1408h1920zM1920 1248v-435q0 -21 -19.5 -29.5t-35.5 7.5l-121 121l-633 -633q-10 -10 -23 -10t-23 10l-233 233l-416 -416l-192 192l585 585q10 10 23 10t23 -10l233 -233l464 464l-121 121q-16 16 -7.5 35.5t29.5 19.5h435q14 0 23 -9
+t9 -23z" />
+    <glyph glyph-name="_482" unicode="&#xf202;" horiz-adv-x="1792" 
+d="M1292 832q0 -6 10 -41q10 -29 25 -49.5t41 -34t44 -20t55 -16.5q325 -91 325 -332q0 -146 -105.5 -242.5t-254.5 -96.5q-59 0 -111.5 18.5t-91.5 45.5t-77 74.5t-63 87.5t-53.5 103.5t-43.5 103t-39.5 106.5t-35.5 95q-32 81 -61.5 133.5t-73.5 96.5t-104 64t-142 20
+q-96 0 -183 -55.5t-138 -144.5t-51 -185q0 -160 106.5 -279.5t263.5 -119.5q177 0 258 95q56 63 83 116l84 -152q-15 -34 -44 -70l1 -1q-131 -152 -388 -152q-147 0 -269.5 79t-190.5 207.5t-68 274.5q0 105 43.5 206t116 176.5t172 121.5t204.5 46q87 0 159 -19t123.5 -50
+t95 -80t72.5 -99t58.5 -117t50.5 -124.5t50 -130.5t55 -127q96 -200 233 -200q81 0 138.5 48.5t57.5 128.5q0 42 -19 72t-50.5 46t-72.5 31.5t-84.5 27t-87.5 34t-81 52t-65 82t-39 122.5q-3 16 -3 33q0 110 87.5 192t198.5 78q78 -3 120.5 -14.5t90.5 -53.5h-1
+q12 -11 23 -24.5t26 -36t19 -27.5l-129 -99q-26 49 -54 70v1q-23 21 -97 21q-49 0 -84 -33t-35 -83z" />
+    <glyph glyph-name="_483" unicode="&#xf203;" 
+d="M1432 484q0 173 -234 239q-35 10 -53 16.5t-38 25t-29 46.5q0 2 -2 8.5t-3 12t-1 7.5q0 36 24.5 59.5t60.5 23.5q54 0 71 -15h-1q20 -15 39 -51l93 71q-39 54 -49 64q-33 29 -67.5 39t-85.5 10q-80 0 -142 -57.5t-62 -137.5q0 -7 2 -23q16 -96 64.5 -140t148.5 -73
+q29 -8 49 -15.5t45 -21.5t38.5 -34.5t13.5 -46.5v-5q1 -58 -40.5 -93t-100.5 -35q-97 0 -167 144q-23 47 -51.5 121.5t-48 125.5t-54 110.5t-74 95.5t-103.5 60.5t-147 24.5q-101 0 -192 -56t-144 -148t-50 -192v-1q4 -108 50.5 -199t133.5 -147.5t196 -56.5q186 0 279 110
+q20 27 31 51l-60 109q-42 -80 -99 -116t-146 -36q-115 0 -191 87t-76 204q0 105 82 189t186 84q112 0 170 -53.5t104 -172.5q8 -21 25.5 -68.5t28.5 -76.5t31.5 -74.5t38.5 -74t45.5 -62.5t55.5 -53.5t66 -33t80 -13.5q107 0 183 69.5t76 174.5zM1536 1120v-960
+q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_484" unicode="&#xf204;" horiz-adv-x="2048" 
+d="M1152 640q0 104 -40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5t198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM1920 640q0 104 -40.5 198.5
+t-109.5 163.5t-163.5 109.5t-198.5 40.5h-386q119 -90 188.5 -224t69.5 -288t-69.5 -288t-188.5 -224h386q104 0 198.5 40.5t163.5 109.5t109.5 163.5t40.5 198.5zM2048 640q0 -130 -51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5
+t-136.5 204t-51 248.5t51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5z" />
+    <glyph glyph-name="_485" unicode="&#xf205;" horiz-adv-x="2048" 
+d="M0 640q0 130 51 248.5t136.5 204t204 136.5t248.5 51h768q130 0 248.5 -51t204 -136.5t136.5 -204t51 -248.5t-51 -248.5t-136.5 -204t-204 -136.5t-248.5 -51h-768q-130 0 -248.5 51t-204 136.5t-136.5 204t-51 248.5zM1408 128q104 0 198.5 40.5t163.5 109.5
+t109.5 163.5t40.5 198.5t-40.5 198.5t-109.5 163.5t-163.5 109.5t-198.5 40.5t-198.5 -40.5t-163.5 -109.5t-109.5 -163.5t-40.5 -198.5t40.5 -198.5t109.5 -163.5t163.5 -109.5t198.5 -40.5z" />
+    <glyph glyph-name="_486" unicode="&#xf206;" horiz-adv-x="2304" 
+d="M762 384h-314q-40 0 -57.5 35t6.5 67l188 251q-65 31 -137 31q-132 0 -226 -94t-94 -226t94 -226t226 -94q115 0 203 72.5t111 183.5zM576 512h186q-18 85 -75 148zM1056 512l288 384h-480l-99 -132q105 -103 126 -252h165zM2176 448q0 132 -94 226t-226 94
+q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94t226 94t94 226zM2304 448q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 97 39.5 183.5t109.5 149.5l-65 98l-353 -469
+q-18 -26 -51 -26h-197q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5t-131.5 316.5t131.5 316.5t316.5 131.5q114 0 215 -55l137 183h-224q-26 0 -45 19t-19 45t19 45t45 19h384v-128h435l-85 128h-222q-26 0 -45 19t-19 45t19 45t45 19h256q33 0 53 -28l267 -400
+q91 44 192 44q185 0 316.5 -131.5t131.5 -316.5z" />
+    <glyph glyph-name="_487" unicode="&#xf207;" 
+d="M384 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 320q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1362 716l-72 384q-5 23 -22.5 37.5t-40.5 14.5
+h-918q-23 0 -40.5 -14.5t-22.5 -37.5l-72 -384q-5 -30 14 -53t49 -23h1062q30 0 49 23t14 53zM1136 1328q0 20 -14 34t-34 14h-640q-20 0 -34 -14t-14 -34t14 -34t34 -14h640q20 0 34 14t14 34zM1536 603v-603h-128v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5
+t-37.5 90.5v128h-768v-128q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5v128h-128v603q0 112 25 223l103 454q9 78 97.5 137t230 89t312.5 30t312.5 -30t230 -89t97.5 -137l105 -454q23 -102 23 -223z" />
+    <glyph glyph-name="_488" unicode="&#xf208;" horiz-adv-x="2048" 
+d="M1463 704q0 -35 -25 -60.5t-61 -25.5h-702q-36 0 -61 25.5t-25 60.5t25 60.5t61 25.5h702q36 0 61 -25.5t25 -60.5zM1677 704q0 86 -23 170h-982q-36 0 -61 25t-25 60q0 36 25 61t61 25h908q-88 143 -235 227t-320 84q-177 0 -327.5 -87.5t-238 -237.5t-87.5 -327
+q0 -86 23 -170h982q36 0 61 -25t25 -60q0 -36 -25 -61t-61 -25h-908q88 -143 235.5 -227t320.5 -84q132 0 253 51.5t208 139t139 208t52 253.5zM2048 959q0 -35 -25 -60t-61 -25h-131q17 -85 17 -170q0 -167 -65.5 -319.5t-175.5 -263t-262.5 -176t-319.5 -65.5
+q-246 0 -448.5 133t-301.5 350h-189q-36 0 -61 25t-25 61q0 35 25 60t61 25h132q-17 85 -17 170q0 167 65.5 319.5t175.5 263t262.5 176t320.5 65.5q245 0 447.5 -133t301.5 -350h188q36 0 61 -25t25 -61z" />
+    <glyph glyph-name="_489" unicode="&#xf209;" horiz-adv-x="1280" 
+d="M953 1158l-114 -328l117 -21q165 451 165 518q0 56 -38 56q-57 0 -130 -225zM654 471l33 -88q37 42 71 67l-33 5.5t-38.5 7t-32.5 8.5zM362 1367q0 -98 159 -521q17 10 49 10q15 0 75 -5l-121 351q-75 220 -123 220q-19 0 -29 -17.5t-10 -37.5zM283 608q0 -36 51.5 -119
+t117.5 -153t100 -70q14 0 25.5 13t11.5 27q0 24 -32 102q-13 32 -32 72t-47.5 89t-61.5 81t-62 32q-20 0 -45.5 -27t-25.5 -47zM125 273q0 -41 25 -104q59 -145 183.5 -227t281.5 -82q227 0 382 170q152 169 152 427q0 43 -1 67t-11.5 62t-30.5 56q-56 49 -211.5 75.5
+t-270.5 26.5q-37 0 -49 -11q-12 -5 -12 -35q0 -34 21.5 -60t55.5 -40t77.5 -23.5t87.5 -11.5t85 -4t70 0h23q24 0 40 -19q15 -19 19 -55q-28 -28 -96 -54q-61 -22 -93 -46q-64 -46 -108.5 -114t-44.5 -137q0 -31 18.5 -88.5t18.5 -87.5l-3 -12q-4 -12 -4 -14
+q-137 10 -146 216q-8 -2 -41 -2q2 -7 2 -21q0 -53 -40.5 -89.5t-94.5 -36.5q-82 0 -166.5 78t-84.5 159q0 34 33 67q52 -64 60 -76q77 -104 133 -104q12 0 26.5 8.5t14.5 20.5q0 34 -87.5 145t-116.5 111q-43 0 -70 -44.5t-27 -90.5zM11 264q0 101 42.5 163t136.5 88
+q-28 74 -28 104q0 62 61 123t122 61q29 0 70 -15q-163 462 -163 567q0 80 41 130.5t119 50.5q131 0 325 -581q6 -17 8 -23q6 16 29 79.5t43.5 118.5t54 127.5t64.5 123t70.5 86.5t76.5 36q71 0 112 -49t41 -122q0 -108 -159 -550q61 -15 100.5 -46t58.5 -78t26 -93.5
+t7 -110.5q0 -150 -47 -280t-132 -225t-211 -150t-278 -55q-111 0 -223 42q-149 57 -258 191.5t-109 286.5z" />
+    <glyph glyph-name="_490" unicode="&#xf20a;" horiz-adv-x="2048" 
+d="M785 528h207q-14 -158 -98.5 -248.5t-214.5 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-203q-5 64 -35.5 99t-81.5 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t40 -51.5t66 -18q95 0 109 139zM1497 528h206
+q-14 -158 -98 -248.5t-214 -90.5q-162 0 -254.5 116t-92.5 316q0 194 93 311.5t233 117.5q148 0 232 -87t97 -247h-204q-4 64 -35 99t-81 35q-57 0 -88.5 -60.5t-31.5 -177.5q0 -48 5 -84t18 -69.5t39.5 -51.5t65.5 -18q49 0 76.5 38t33.5 101zM1856 647q0 207 -15.5 307
+t-60.5 161q-6 8 -13.5 14t-21.5 15t-16 11q-86 63 -697 63q-625 0 -710 -63q-5 -4 -17.5 -11.5t-21 -14t-14.5 -14.5q-45 -60 -60 -159.5t-15 -308.5q0 -208 15 -307.5t60 -160.5q6 -8 15 -15t20.5 -14t17.5 -12q44 -33 239.5 -49t470.5 -16q610 0 697 65q5 4 17 11t20.5 14
+t13.5 16q46 60 61 159t15 309zM2048 1408v-1536h-2048v1536h2048z" />
+    <glyph glyph-name="_491" unicode="&#xf20b;" 
+d="M992 912v-496q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v496q0 112 -80 192t-192 80h-272v-1152q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v1344q0 14 9 23t23 9h464q135 0 249 -66.5t180.5 -180.5t66.5 -249zM1376 1376v-880q0 -135 -66.5 -249t-180.5 -180.5
+t-249 -66.5h-464q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h160q14 0 23 -9t9 -23v-768h272q112 0 192 80t80 192v880q0 14 9 23t23 9h160q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="_492" unicode="&#xf20c;" 
+d="M1311 694v-114q0 -24 -13.5 -38t-37.5 -14h-202q-24 0 -38 14t-14 38v114q0 24 14 38t38 14h202q24 0 37.5 -14t13.5 -38zM821 464v250q0 53 -32.5 85.5t-85.5 32.5h-133q-68 0 -96 -52q-28 52 -96 52h-130q-53 0 -85.5 -32.5t-32.5 -85.5v-250q0 -22 21 -22h55
+q22 0 22 22v230q0 24 13.5 38t38.5 14h94q24 0 38 -14t14 -38v-230q0 -22 21 -22h54q22 0 22 22v230q0 24 14 38t38 14h97q24 0 37.5 -14t13.5 -38v-230q0 -22 22 -22h55q21 0 21 22zM1410 560v154q0 53 -33 85.5t-86 32.5h-264q-53 0 -86 -32.5t-33 -85.5v-410
+q0 -21 22 -21h55q21 0 21 21v180q31 -42 94 -42h191q53 0 86 32.5t33 85.5zM1536 1176v-1072q0 -96 -68 -164t-164 -68h-1072q-96 0 -164 68t-68 164v1072q0 96 68 164t164 68h1072q96 0 164 -68t68 -164z" />
+    <glyph glyph-name="_493" unicode="&#xf20d;" 
+d="M915 450h-294l147 551zM1001 128h311l-324 1024h-440l-324 -1024h311l383 314zM1536 1120v-960q0 -118 -85 -203t-203 -85h-960q-118 0 -203 85t-85 203v960q0 118 85 203t203 85h960q118 0 203 -85t85 -203z" />
+    <glyph glyph-name="_494" unicode="&#xf20e;" horiz-adv-x="2048" 
+d="M2048 641q0 -21 -13 -36.5t-33 -19.5l-205 -356q3 -9 3 -18q0 -20 -12.5 -35.5t-32.5 -19.5l-193 -337q3 -8 3 -16q0 -23 -16.5 -40t-40.5 -17q-25 0 -41 18h-400q-17 -20 -43 -20t-43 20h-399q-17 -20 -43 -20q-23 0 -40 16.5t-17 40.5q0 8 4 20l-193 335
+q-20 4 -32.5 19.5t-12.5 35.5q0 9 3 18l-206 356q-20 5 -32.5 20.5t-12.5 35.5q0 21 13.5 36.5t33.5 19.5l199 344q0 1 -0.5 3t-0.5 3q0 36 34 51l209 363q-4 10 -4 18q0 24 17 40.5t40 16.5q26 0 44 -21h396q16 21 43 21t43 -21h398q18 21 44 21q23 0 40 -16.5t17 -40.5
+q0 -6 -4 -18l207 -358q23 -1 39 -17.5t16 -38.5q0 -13 -7 -27l187 -324q19 -4 31.5 -19.5t12.5 -35.5zM1063 -158h389l-342 354h-143l-342 -354h360q18 16 39 16t39 -16zM112 654q1 -4 1 -13q0 -10 -2 -15l208 -360l15 -6l188 199v347l-187 194q-13 -8 -29 -10zM986 1438
+h-388l190 -200l554 200h-280q-16 -16 -38 -16t-38 16zM1689 226q1 6 5 11l-64 68l-17 -79h76zM1583 226l22 105l-252 266l-296 -307l63 -64h463zM1495 -142l16 28l65 310h-427l333 -343q8 4 13 5zM578 -158h5l342 354h-373v-335l4 -6q14 -5 22 -13zM552 226h402l64 66
+l-309 321l-157 -166v-221zM359 226h163v189l-168 -177q4 -8 5 -12zM358 1051q0 -1 0.5 -2t0.5 -2q0 -16 -8 -29l171 -177v269zM552 1121v-311l153 -157l297 314l-223 236zM556 1425l-4 -8v-264l205 74l-191 201q-6 -2 -10 -3zM1447 1438h-16l-621 -224l213 -225zM1023 946
+l-297 -315l311 -319l296 307zM688 634l-136 141v-284zM1038 270l-42 -44h85zM1374 618l238 -251l132 624l-3 5l-1 1zM1718 1018q-8 13 -8 29v2l-216 376q-5 1 -13 5l-437 -463l310 -327zM522 1142v223l-163 -282zM522 196h-163l163 -283v283zM1607 196l-48 -227l130 227h-82
+zM1729 266l207 361q-2 10 -2 14q0 1 3 16l-171 296l-129 -612l77 -82q5 3 15 7z" />
+    <glyph glyph-name="f210" unicode="&#xf210;" 
+d="M0 856q0 131 91.5 226.5t222.5 95.5h742l352 358v-1470q0 -132 -91.5 -227t-222.5 -95h-780q-131 0 -222.5 95t-91.5 227v790zM1232 102l-176 180v425q0 46 -32 79t-78 33h-484q-46 0 -78 -33t-32 -79v-492q0 -46 32.5 -79.5t77.5 -33.5h770z" />
+    <glyph glyph-name="_496" unicode="&#xf211;" 
+d="M934 1386q-317 -121 -556 -362.5t-358 -560.5q-20 89 -20 176q0 208 102.5 384.5t278.5 279t384 102.5q82 0 169 -19zM1203 1267q93 -65 164 -155q-389 -113 -674.5 -400.5t-396.5 -676.5q-93 72 -155 162q112 386 395 671t667 399zM470 -67q115 356 379.5 622t619.5 384
+q40 -92 54 -195q-292 -120 -516 -345t-343 -518q-103 14 -194 52zM1536 -125q-193 50 -367 115q-135 -84 -290 -107q109 205 274 370.5t369 275.5q-21 -152 -101 -284q65 -175 115 -370z" />
+    <glyph glyph-name="f212" unicode="&#xf212;" horiz-adv-x="2048" 
+d="M1893 1144l155 -1272q-131 0 -257 57q-200 91 -393 91q-226 0 -374 -148q-148 148 -374 148q-193 0 -393 -91q-128 -57 -252 -57h-5l155 1272q224 127 482 127q233 0 387 -106q154 106 387 106q258 0 482 -127zM1398 157q129 0 232 -28.5t260 -93.5l-124 1021
+q-171 78 -368 78q-224 0 -374 -141q-150 141 -374 141q-197 0 -368 -78l-124 -1021q105 43 165.5 65t148.5 39.5t178 17.5q202 0 374 -108q172 108 374 108zM1438 191l-55 907q-211 -4 -359 -155q-152 155 -374 155q-176 0 -336 -66l-114 -941q124 51 228.5 76t221.5 25
+q209 0 374 -102q172 107 374 102z" />
+    <glyph glyph-name="_498" unicode="&#xf213;" horiz-adv-x="2048" 
+d="M1500 165v733q0 21 -15 36t-35 15h-93q-20 0 -35 -15t-15 -36v-733q0 -20 15 -35t35 -15h93q20 0 35 15t15 35zM1216 165v531q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-531q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM924 165v429q0 20 -15 35t-35 15h-101
+q-20 0 -35 -15t-15 -35v-429q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM632 165v362q0 20 -15 35t-35 15h-101q-20 0 -35 -15t-15 -35v-362q0 -20 15 -35t35 -15h101q20 0 35 15t15 35zM2048 311q0 -166 -118 -284t-284 -118h-1244q-166 0 -284 118t-118 284
+q0 116 63 214.5t168 148.5q-10 34 -10 73q0 113 80.5 193.5t193.5 80.5q102 0 180 -67q45 183 194 300t338 117q149 0 275 -73.5t199.5 -199.5t73.5 -275q0 -66 -14 -122q135 -33 221 -142.5t86 -247.5z" />
+    <glyph glyph-name="_499" unicode="&#xf214;" 
+d="M0 1536h1536v-1392l-776 -338l-760 338v1392zM1436 209v926h-1336v-926l661 -294zM1436 1235v201h-1336v-201h1336zM181 937v-115h-37v115h37zM181 789v-115h-37v115h37zM181 641v-115h-37v115h37zM181 493v-115h-37v115h37zM181 345v-115h-37v115h37zM207 202l15 34
+l105 -47l-15 -33zM343 142l15 34l105 -46l-15 -34zM478 82l15 34l105 -46l-15 -34zM614 23l15 33l104 -46l-15 -34zM797 10l105 46l15 -33l-105 -47zM932 70l105 46l15 -34l-105 -46zM1068 130l105 46l15 -34l-105 -46zM1203 189l105 47l15 -34l-105 -46zM259 1389v-36h-114
+v36h114zM421 1389v-36h-115v36h115zM583 1389v-36h-115v36h115zM744 1389v-36h-114v36h114zM906 1389v-36h-114v36h114zM1068 1389v-36h-115v36h115zM1230 1389v-36h-115v36h115zM1391 1389v-36h-114v36h114zM181 1049v-79h-37v115h115v-36h-78zM421 1085v-36h-115v36h115z
+M583 1085v-36h-115v36h115zM744 1085v-36h-114v36h114zM906 1085v-36h-114v36h114zM1068 1085v-36h-115v36h115zM1230 1085v-36h-115v36h115zM1355 970v79h-78v36h115v-115h-37zM1355 822v115h37v-115h-37zM1355 674v115h37v-115h-37zM1355 526v115h37v-115h-37zM1355 378
+v115h37v-115h-37zM1355 230v115h37v-115h-37zM760 265q-129 0 -221 91.5t-92 221.5q0 129 92 221t221 92q130 0 221.5 -92t91.5 -221q0 -130 -91.5 -221.5t-221.5 -91.5zM595 646q0 -36 19.5 -56.5t49.5 -25t64 -7t64 -2t49.5 -9t19.5 -30.5q0 -49 -112 -49q-97 0 -123 51
+h-3l-31 -63q67 -42 162 -42q29 0 56.5 5t55.5 16t45.5 33t17.5 53q0 46 -27.5 69.5t-67.5 27t-79.5 3t-67 5t-27.5 25.5q0 21 20.5 33t40.5 15t41 3q34 0 70.5 -11t51.5 -34h3l30 58q-3 1 -21 8.5t-22.5 9t-19.5 7t-22 7t-20 4.5t-24 4t-23 1q-29 0 -56.5 -5t-54 -16.5
+t-43 -34t-16.5 -53.5z" />
+    <glyph glyph-name="_500" unicode="&#xf215;" horiz-adv-x="2048" 
+d="M863 504q0 112 -79.5 191.5t-191.5 79.5t-191 -79.5t-79 -191.5t79 -191t191 -79t191.5 79t79.5 191zM1726 505q0 112 -79 191t-191 79t-191.5 -79t-79.5 -191q0 -113 79.5 -192t191.5 -79t191 79.5t79 191.5zM2048 1314v-1348q0 -44 -31.5 -75.5t-76.5 -31.5h-1832
+q-45 0 -76.5 31.5t-31.5 75.5v1348q0 44 31.5 75.5t76.5 31.5h431q44 0 76 -31.5t32 -75.5v-161h754v161q0 44 32 75.5t76 31.5h431q45 0 76.5 -31.5t31.5 -75.5z" />
+    <glyph glyph-name="_501" unicode="&#xf216;" horiz-adv-x="2048" 
+d="M1430 953zM1690 749q148 0 253 -98.5t105 -244.5q0 -157 -109 -261.5t-267 -104.5q-85 0 -162 27.5t-138 73.5t-118 106t-109 126t-103.5 132.5t-108.5 126.5t-117 106t-136 73.5t-159 27.5q-154 0 -251.5 -91.5t-97.5 -244.5q0 -157 104 -250t263 -93q100 0 208 37.5
+t193 98.5q5 4 21 18.5t30 24t22 9.5q14 0 24.5 -10.5t10.5 -24.5q0 -24 -60 -77q-101 -88 -234.5 -142t-260.5 -54q-133 0 -245.5 58t-180 165t-67.5 241q0 205 141.5 341t347.5 136q120 0 226.5 -43.5t185.5 -113t151.5 -153t139 -167.5t133.5 -153.5t149.5 -113
+t172.5 -43.5q102 0 168.5 61.5t66.5 162.5q0 95 -64.5 159t-159.5 64q-30 0 -81.5 -18.5t-68.5 -18.5q-20 0 -35.5 15t-15.5 35q0 18 8.5 57t8.5 59q0 159 -107.5 263t-266.5 104q-58 0 -111.5 -18.5t-84 -40.5t-55.5 -40.5t-33 -18.5q-15 0 -25.5 10.5t-10.5 25.5
+q0 19 25 46q59 67 147 103.5t182 36.5q191 0 318 -125.5t127 -315.5q0 -37 -4 -66q57 15 115 15z" />
+    <glyph glyph-name="_502" unicode="&#xf217;" horiz-adv-x="1664" 
+d="M1216 832q0 26 -19 45t-45 19h-128v128q0 26 -19 45t-45 19t-45 -19t-19 -45v-128h-128q-26 0 -45 -19t-19 -45t19 -45t45 -19h128v-128q0 -26 19 -45t45 -19t45 19t19 45v128h128q26 0 45 19t19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
+t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920
+q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="_503" unicode="&#xf218;" horiz-adv-x="1664" 
+d="M1280 832q0 26 -19 45t-45 19t-45 -19l-147 -146v293q0 26 -19 45t-45 19t-45 -19t-19 -45v-293l-147 146q-19 19 -45 19t-45 -19t-19 -45t19 -45l256 -256q19 -19 45 -19t45 19l256 256q19 19 19 45zM640 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5
+t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1536 0q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1664 1088v-512q0 -24 -16 -42.5t-41 -21.5l-1044 -122q1 -7 4.5 -21.5t6 -26.5t2.5 -22q0 -16 -24 -64h920
+q26 0 45 -19t19 -45t-19 -45t-45 -19h-1024q-26 0 -45 19t-19 45q0 14 11 39.5t29.5 59.5t20.5 38l-177 823h-204q-26 0 -45 19t-19 45t19 45t45 19h256q16 0 28.5 -6.5t20 -15.5t13 -24.5t7.5 -26.5t5.5 -29.5t4.5 -25.5h1201q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="_504" unicode="&#xf219;" horiz-adv-x="2048" 
+d="M212 768l623 -665l-300 665h-323zM1024 -4l349 772h-698zM538 896l204 384h-262l-288 -384h346zM1213 103l623 665h-323zM683 896h682l-204 384h-274zM1510 896h346l-288 384h-262zM1651 1382l384 -512q14 -18 13 -41.5t-17 -40.5l-960 -1024q-18 -20 -47 -20t-47 20
+l-960 1024q-16 17 -17 40.5t13 41.5l384 512q18 26 51 26h1152q33 0 51 -26z" />
+    <glyph glyph-name="_505" unicode="&#xf21a;" horiz-adv-x="2048" 
+d="M1811 -19q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83
+q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83q19 19 45 19t45 -19l83 -83l83 83
+q19 19 45 19t45 -19l83 -83zM237 19q-19 -19 -45 -19t-45 19l-128 128l90 90l83 -82l83 82q19 19 45 19t45 -19l83 -82l64 64v293l-210 314q-17 26 -7 56.5t40 40.5l177 58v299h128v128h256v128h256v-128h256v-128h128v-299l177 -58q30 -10 40 -40.5t-7 -56.5l-210 -314
+v-293l19 18q19 19 45 19t45 -19l83 -82l83 82q19 19 45 19t45 -19l128 -128l-90 -90l-83 83l-83 -83q-18 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83l-83 -83
+q-19 -19 -45 -19t-45 19l-83 83l-83 -83q-19 -19 -45 -19t-45 19l-83 83zM640 1152v-128l384 128l384 -128v128h-128v128h-512v-128h-128z" />
+    <glyph glyph-name="_506" unicode="&#xf21b;" 
+d="M576 0l96 448l-96 128l-128 64zM832 0l128 640l-128 -64l-96 -128zM992 1010q-2 4 -4 6q-10 8 -96 8q-70 0 -167 -19q-7 -2 -21 -2t-21 2q-97 19 -167 19q-86 0 -96 -8q-2 -2 -4 -6q2 -18 4 -27q2 -3 7.5 -6.5t7.5 -10.5q2 -4 7.5 -20.5t7 -20.5t7.5 -17t8.5 -17t9 -14
+t12 -13.5t14 -9.5t17.5 -8t20.5 -4t24.5 -2q36 0 59 12.5t32.5 30t14.5 34.5t11.5 29.5t17.5 12.5h12q11 0 17.5 -12.5t11.5 -29.5t14.5 -34.5t32.5 -30t59 -12.5q13 0 24.5 2t20.5 4t17.5 8t14 9.5t12 13.5t9 14t8.5 17t7.5 17t7 20.5t7.5 20.5q2 7 7.5 10.5t7.5 6.5
+q2 9 4 27zM1408 131q0 -121 -73 -190t-194 -69h-874q-121 0 -194 69t-73 190q0 61 4.5 118t19 125.5t37.5 123.5t63.5 103.5t93.5 74.5l-90 220h214q-22 64 -22 128q0 12 2 32q-194 40 -194 96q0 57 210 99q17 62 51.5 134t70.5 114q32 37 76 37q30 0 84 -31t84 -31t84 31
+t84 31q44 0 76 -37q36 -42 70.5 -114t51.5 -134q210 -42 210 -99q0 -56 -194 -96q7 -81 -20 -160h214l-82 -225q63 -33 107.5 -96.5t65.5 -143.5t29 -151.5t8 -148.5z" />
+    <glyph glyph-name="_507" unicode="&#xf21c;" horiz-adv-x="2304" 
+d="M2301 500q12 -103 -22 -198.5t-99 -163.5t-158.5 -106t-196.5 -31q-161 11 -279.5 125t-134.5 274q-12 111 27.5 210.5t118.5 170.5l-71 107q-96 -80 -151 -194t-55 -244q0 -27 -18.5 -46.5t-45.5 -19.5h-256h-69q-23 -164 -149 -274t-294 -110q-185 0 -316.5 131.5
+t-131.5 316.5t131.5 316.5t316.5 131.5q76 0 152 -27l24 45q-123 110 -304 110h-64q-26 0 -45 19t-19 45t19 45t45 19h128q78 0 145 -13.5t116.5 -38.5t71.5 -39.5t51 -36.5h512h115l-85 128h-222q-30 0 -49 22.5t-14 52.5q4 23 23 38t43 15h253q33 0 53 -28l70 -105
+l114 114q19 19 46 19h101q26 0 45 -19t19 -45v-128q0 -26 -19 -45t-45 -19h-179l115 -172q131 63 275 36q143 -26 244 -134.5t118 -253.5zM448 128q115 0 203 72.5t111 183.5h-314q-35 0 -55 31q-18 32 -1 63l147 277q-47 13 -91 13q-132 0 -226 -94t-94 -226t94 -226
+t226 -94zM1856 128q132 0 226 94t94 226t-94 226t-226 94q-60 0 -121 -24l174 -260q15 -23 10 -49t-27 -40q-15 -11 -36 -11q-35 0 -53 29l-174 260q-93 -95 -93 -225q0 -132 94 -226t226 -94z" />
+    <glyph glyph-name="_508" unicode="&#xf21d;" 
+d="M1408 0q0 -63 -61.5 -113.5t-164 -81t-225 -46t-253.5 -15.5t-253.5 15.5t-225 46t-164 81t-61.5 113.5q0 49 33 88.5t91 66.5t118 44.5t131 29.5q26 5 48 -10.5t26 -41.5q5 -26 -10.5 -48t-41.5 -26q-58 -10 -106 -23.5t-76.5 -25.5t-48.5 -23.5t-27.5 -19.5t-8.5 -12
+q3 -11 27 -26.5t73 -33t114 -32.5t160.5 -25t201.5 -10t201.5 10t160.5 25t114 33t73 33.5t27 27.5q-1 4 -8.5 11t-27.5 19t-48.5 23.5t-76.5 25t-106 23.5q-26 4 -41.5 26t-10.5 48q4 26 26 41.5t48 10.5q71 -12 131 -29.5t118 -44.5t91 -66.5t33 -88.5zM1024 896v-384
+q0 -26 -19 -45t-45 -19h-64v-384q0 -26 -19 -45t-45 -19h-256q-26 0 -45 19t-19 45v384h-64q-26 0 -45 19t-19 45v384q0 53 37.5 90.5t90.5 37.5h384q53 0 90.5 -37.5t37.5 -90.5zM928 1280q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5
+t158.5 -65.5t65.5 -158.5z" />
+    <glyph glyph-name="_509" unicode="&#xf21e;" horiz-adv-x="1792" 
+d="M1280 512h305q-5 -6 -10 -10.5t-9 -7.5l-3 -4l-623 -600q-18 -18 -44 -18t-44 18l-624 602q-5 2 -21 20h369q22 0 39.5 13.5t22.5 34.5l70 281l190 -667q6 -20 23 -33t39 -13q21 0 38 13t23 33l146 485l56 -112q18 -35 57 -35zM1792 940q0 -145 -103 -300h-369l-111 221
+q-8 17 -25.5 27t-36.5 8q-45 -5 -56 -46l-129 -430l-196 686q-6 20 -23.5 33t-39.5 13t-39 -13.5t-22 -34.5l-116 -464h-423q-103 155 -103 300q0 220 127 344t351 124q62 0 126.5 -21.5t120 -58t95.5 -68.5t76 -68q36 36 76 68t95.5 68.5t120 58t126.5 21.5q224 0 351 -124
+t127 -344z" />
+    <glyph glyph-name="venus" unicode="&#xf221;" horiz-adv-x="1280" 
+d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292
+q11 134 80.5 249t182 188t245.5 88q170 19 319 -54t236 -212t87 -306zM128 960q0 -185 131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5z" />
+    <glyph glyph-name="_511" unicode="&#xf222;" 
+d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-382 -383q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5
+q203 0 359 -126l382 382h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_512" unicode="&#xf223;" horiz-adv-x="1280" 
+d="M830 1220q145 -72 233.5 -210.5t88.5 -305.5q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5
+t-147.5 384.5q0 167 88.5 305.5t233.5 210.5q-165 96 -228 273q-6 16 3.5 29.5t26.5 13.5h69q21 0 29 -20q44 -106 140 -171t214 -65t214 65t140 171q8 20 37 20h61q17 0 26.5 -13.5t3.5 -29.5q-63 -177 -228 -273zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
+t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_513" unicode="&#xf224;" 
+d="M1024 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64
+q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-149 16 -270.5 103t-186.5 223.5t-53 291.5q16 204 160 353.5t347 172.5q118 14 228 -19t198 -103l255 254h-134q-14 0 -23 9t-9 23v64zM576 256q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
+t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_514" unicode="&#xf225;" horiz-adv-x="1792" 
+d="M1280 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q126 -158 126 -359q0 -221 -147.5 -384.5t-364.5 -187.5v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64
+q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-217 24 -364.5 187.5t-147.5 384.5q0 201 126 359l-52 53l-101 -111q-9 -10 -22 -10.5t-23 7.5l-48 44q-10 8 -10.5 21.5t8.5 23.5l105 115l-111 112v-134q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9
+t-9 23v288q0 26 19 45t45 19h288q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-133l106 -107l86 94q9 10 22 10.5t23 -7.5l48 -44q10 -8 10.5 -21.5t-8.5 -23.5l-90 -99l57 -56q158 126 359 126t359 -126l255 254h-134q-14 0 -23 9t-9 23v64zM832 256q185 0 316.5 131.5
+t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_515" unicode="&#xf226;" horiz-adv-x="1792" 
+d="M1790 1007q12 -155 -52.5 -292t-186 -224t-271.5 -103v-260h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-512v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23
+t23 9h224v260q-150 16 -271.5 103t-186 224t-52.5 292q17 206 164.5 356.5t352.5 169.5q206 21 377 -94q171 115 377 94q205 -19 352.5 -169.5t164.5 -356.5zM896 647q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM576 512q115 0 218 57q-154 165 -154 391
+q0 224 154 391q-103 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5zM1152 128v260q-137 15 -256 94q-119 -79 -256 -94v-260h512zM1216 512q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5q-115 0 -218 -57q154 -167 154 -391
+q0 -226 -154 -391q103 -57 218 -57z" />
+    <glyph glyph-name="_516" unicode="&#xf227;" horiz-adv-x="1920" 
+d="M1536 1120q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-31 -182 -166 -312t-318 -156q-210 -29 -384.5 80t-241.5 300q-117 6 -221 57.5t-177.5 133t-113.5 192.5t-32 230
+q9 135 78 252t182 191.5t248 89.5q118 14 227.5 -19t198.5 -103l255 254h-134q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q59 -74 93 -169q182 -9 328 -124l255 254h-134q-14 0 -23 9
+t-9 23v64zM1024 704q0 20 -4 58q-162 -25 -271 -150t-109 -292q0 -20 4 -58q162 25 271 150t109 292zM128 704q0 -168 111 -294t276 -149q-3 29 -3 59q0 210 135 369.5t338 196.5q-53 120 -163.5 193t-245.5 73q-185 0 -316.5 -131.5t-131.5 -316.5zM1088 -128
+q185 0 316.5 131.5t131.5 316.5q0 168 -111 294t-276 149q3 -28 3 -59q0 -210 -135 -369.5t-338 -196.5q53 -120 163.5 -193t245.5 -73z" />
+    <glyph glyph-name="_517" unicode="&#xf228;" horiz-adv-x="2048" 
+d="M1664 1504q0 14 9 23t23 9h288q26 0 45 -19t19 -45v-288q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v134l-254 -255q76 -95 107.5 -214t9.5 -247q-32 -180 -164.5 -310t-313.5 -157q-223 -34 -409 90q-117 -78 -256 -93v-132h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23
+t-23 -9h-96v-96q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v96h-96q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v132q-155 17 -279.5 109.5t-187 237.5t-39.5 307q25 187 159.5 322.5t320.5 164.5q224 34 410 -90q146 97 320 97q201 0 359 -126l255 254h-134q-14 0 -23 9
+t-9 23v64zM896 391q128 131 128 313t-128 313q-128 -131 -128 -313t128 -313zM128 704q0 -185 131.5 -316.5t316.5 -131.5q117 0 218 57q-154 167 -154 391t154 391q-101 57 -218 57q-185 0 -316.5 -131.5t-131.5 -316.5zM1216 256q185 0 316.5 131.5t131.5 316.5
+t-131.5 316.5t-316.5 131.5q-117 0 -218 -57q154 -167 154 -391t-154 -391q101 -57 218 -57z" />
+    <glyph glyph-name="_518" unicode="&#xf229;" 
+d="M1472 1408q26 0 45 -19t19 -45v-416q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v262l-213 -214l140 -140q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-140 141l-78 -79q126 -156 126 -359q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5
+t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123t223.5 45.5q203 0 359 -126l78 78l-172 172q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l172 -172l213 213h-261q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h416zM576 0q185 0 316.5 131.5t131.5 316.5t-131.5 316.5
+t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_519" unicode="&#xf22a;" horiz-adv-x="1280" 
+d="M640 892q217 -24 364.5 -187.5t147.5 -384.5q0 -167 -87 -306t-236 -212t-319 -54q-133 15 -245.5 88t-182 188t-80.5 249q-12 155 52.5 292t186 224t271.5 103v132h-160q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h160v165l-92 -92q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22
+t9 23l202 201q19 19 45 19t45 -19l202 -201q9 -10 9 -23t-9 -22l-46 -46q-9 -9 -22 -9t-23 9l-92 92v-165h160q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-160v-132zM576 -128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5
+t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_520" unicode="&#xf22b;" horiz-adv-x="2048" 
+d="M1901 621q19 -19 19 -45t-19 -45l-294 -294q-9 -10 -22.5 -10t-22.5 10l-45 45q-10 9 -10 22.5t10 22.5l185 185h-294v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-132q-24 -217 -187.5 -364.5t-384.5 -147.5q-167 0 -306 87t-212 236t-54 319q15 133 88 245.5
+t188 182t249 80.5q155 12 292 -52.5t224 -186t103 -271.5h132v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224h294l-185 185q-10 9 -10 22.5t10 22.5l45 45q9 10 22.5 10t22.5 -10zM576 128q185 0 316.5 131.5t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5
+t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_521" unicode="&#xf22c;" horiz-adv-x="1280" 
+d="M1152 960q0 -221 -147.5 -384.5t-364.5 -187.5v-612q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v612q-217 24 -364.5 187.5t-147.5 384.5q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM576 512q185 0 316.5 131.5
+t131.5 316.5t-131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5z" />
+    <glyph glyph-name="_522" unicode="&#xf22d;" horiz-adv-x="1280" 
+d="M1024 576q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5t131.5 -316.5t316.5 -131.5t316.5 131.5t131.5 316.5zM1152 576q0 -117 -45.5 -223.5t-123 -184t-184 -123t-223.5 -45.5t-223.5 45.5t-184 123t-123 184t-45.5 223.5t45.5 223.5t123 184t184 123
+t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5z" />
+    <glyph glyph-name="_523" unicode="&#xf22e;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="_524" unicode="&#xf22f;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="_525" unicode="&#xf230;" 
+d="M1451 1408q35 0 60 -25t25 -60v-1366q0 -35 -25 -60t-60 -25h-391v595h199l30 232h-229v148q0 56 23.5 84t91.5 28l122 1v207q-63 9 -178 9q-136 0 -217.5 -80t-81.5 -226v-171h-200v-232h200v-595h-735q-35 0 -60 25t-25 60v1366q0 35 25 60t60 25h1366z" />
+    <glyph glyph-name="_526" unicode="&#xf231;" horiz-adv-x="1280" 
+d="M0 939q0 108 37.5 203.5t103.5 166.5t152 123t185 78t202 26q158 0 294 -66.5t221 -193.5t85 -287q0 -96 -19 -188t-60 -177t-100 -149.5t-145 -103t-189 -38.5q-68 0 -135 32t-96 88q-10 -39 -28 -112.5t-23.5 -95t-20.5 -71t-26 -71t-32 -62.5t-46 -77.5t-62 -86.5
+l-14 -5l-9 10q-15 157 -15 188q0 92 21.5 206.5t66.5 287.5t52 203q-32 65 -32 169q0 83 52 156t132 73q61 0 95 -40.5t34 -102.5q0 -66 -44 -191t-44 -187q0 -63 45 -104.5t109 -41.5q55 0 102 25t78.5 68t56 95t38 110.5t20 111t6.5 99.5q0 173 -109.5 269.5t-285.5 96.5
+q-200 0 -334 -129.5t-134 -328.5q0 -44 12.5 -85t27 -65t27 -45.5t12.5 -30.5q0 -28 -15 -73t-37 -45q-2 0 -17 3q-51 15 -90.5 56t-61 94.5t-32.5 108t-11 106.5z" />
+    <glyph glyph-name="_527" unicode="&#xf232;" 
+d="M985 562q13 0 97.5 -44t89.5 -53q2 -5 2 -15q0 -33 -17 -76q-16 -39 -71 -65.5t-102 -26.5q-57 0 -190 62q-98 45 -170 118t-148 185q-72 107 -71 194v8q3 91 74 158q24 22 52 22q6 0 18 -1.5t19 -1.5q19 0 26.5 -6.5t15.5 -27.5q8 -20 33 -88t25 -75q0 -21 -34.5 -57.5
+t-34.5 -46.5q0 -7 5 -15q34 -73 102 -137q56 -53 151 -101q12 -7 22 -7q15 0 54 48.5t52 48.5zM782 32q127 0 243.5 50t200.5 134t134 200.5t50 243.5t-50 243.5t-134 200.5t-200.5 134t-243.5 50t-243.5 -50t-200.5 -134t-134 -200.5t-50 -243.5q0 -203 120 -368l-79 -233
+l242 77q158 -104 345 -104zM782 1414q153 0 292.5 -60t240.5 -161t161 -240.5t60 -292.5t-60 -292.5t-161 -240.5t-240.5 -161t-292.5 -60q-195 0 -365 94l-417 -134l136 405q-108 178 -108 389q0 153 60 292.5t161 240.5t240.5 161t292.5 60z" />
+    <glyph glyph-name="_528" unicode="&#xf233;" horiz-adv-x="1792" 
+d="M128 128h1024v128h-1024v-128zM128 640h1024v128h-1024v-128zM1696 192q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM128 1152h1024v128h-1024v-128zM1696 704q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1696 1216
+q0 40 -28 68t-68 28t-68 -28t-28 -68t28 -68t68 -28t68 28t28 68zM1792 384v-384h-1792v384h1792zM1792 896v-384h-1792v384h1792zM1792 1408v-384h-1792v384h1792z" />
+    <glyph glyph-name="_529" unicode="&#xf234;" horiz-adv-x="2048" 
+d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1664 512h352q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-352v-352q0 -13 -9.5 -22.5t-22.5 -9.5h-192q-13 0 -22.5 9.5
+t-9.5 22.5v352h-352q-13 0 -22.5 9.5t-9.5 22.5v192q0 13 9.5 22.5t22.5 9.5h352v352q0 13 9.5 22.5t22.5 9.5h192q13 0 22.5 -9.5t9.5 -22.5v-352zM928 288q0 -52 38 -90t90 -38h256v-238q-68 -50 -171 -50h-874q-121 0 -194 69t-73 190q0 53 3.5 103.5t14 109t26.5 108.5
+t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q79 -61 154.5 -91.5t164.5 -30.5t164.5 30.5t154.5 91.5q20 17 39 17q132 0 217 -96h-223q-52 0 -90 -38t-38 -90v-192z" />
+    <glyph glyph-name="_530" unicode="&#xf235;" horiz-adv-x="2048" 
+d="M704 640q-159 0 -271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5t-112.5 -271.5t-271.5 -112.5zM1781 320l249 -249q9 -9 9 -23q0 -13 -9 -22l-136 -136q-9 -9 -22 -9q-14 0 -23 9l-249 249l-249 -249q-9 -9 -23 -9q-13 0 -22 9l-136 136
+q-9 9 -9 22q0 14 9 23l249 249l-249 249q-9 9 -9 23q0 13 9 22l136 136q9 9 22 9q14 0 23 -9l249 -249l249 249q9 9 23 9q13 0 22 -9l136 -136q9 -9 9 -22q0 -14 -9 -23zM1283 320l-181 -181q-37 -37 -37 -91q0 -53 37 -90l83 -83q-21 -3 -44 -3h-874q-121 0 -194 69
+t-73 190q0 53 3.5 103.5t14 109t26.5 108.5t43 97.5t62 81t85.5 53.5t111.5 20q19 0 39 -17q154 -122 319 -122t319 122q20 17 39 17q28 0 57 -6q-28 -27 -41 -50t-13 -56q0 -54 37 -91z" />
+    <glyph glyph-name="_531" unicode="&#xf236;" horiz-adv-x="2048" 
+d="M256 512h1728q26 0 45 -19t19 -45v-448h-256v256h-1536v-256h-256v1216q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-704zM832 832q0 106 -75 181t-181 75t-181 -75t-75 -181t75 -181t181 -75t181 75t75 181zM2048 576v64q0 159 -112.5 271.5t-271.5 112.5h-704
+q-26 0 -45 -19t-19 -45v-384h1152z" />
+    <glyph glyph-name="_532" unicode="&#xf237;" 
+d="M1536 1536l-192 -448h192v-192h-274l-55 -128h329v-192h-411l-357 -832l-357 832h-411v192h329l-55 128h-274v192h192l-192 448h256l323 -768h378l323 768h256zM768 320l108 256h-216z" />
+    <glyph glyph-name="_533" unicode="&#xf238;" 
+d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM768 192q80 0 136 56t56 136t-56 136t-136 56
+t-136 -56t-56 -136t56 -136t136 -56zM1344 768v512h-1152v-512h1152z" />
+    <glyph glyph-name="_534" unicode="&#xf239;" 
+d="M1088 1536q185 0 316.5 -93.5t131.5 -226.5v-896q0 -130 -125.5 -222t-305.5 -97l213 -202q16 -15 8 -35t-30 -20h-1056q-22 0 -30 20t8 35l213 202q-180 5 -305.5 97t-125.5 222v896q0 133 131.5 226.5t316.5 93.5h640zM288 224q66 0 113 47t47 113t-47 113t-113 47
+t-113 -47t-47 -113t47 -113t113 -47zM704 768v512h-544v-512h544zM1248 224q66 0 113 47t47 113t-47 113t-113 47t-113 -47t-47 -113t47 -113t113 -47zM1408 768v512h-576v-512h576z" />
+    <glyph glyph-name="_535" unicode="&#xf23a;" horiz-adv-x="1792" 
+d="M597 1115v-1173q0 -25 -12.5 -42.5t-36.5 -17.5q-17 0 -33 8l-465 233q-21 10 -35.5 33.5t-14.5 46.5v1140q0 20 10 34t29 14q14 0 44 -15l511 -256q3 -3 3 -5zM661 1014l534 -866l-534 266v600zM1792 996v-1054q0 -25 -14 -40.5t-38 -15.5t-47 13l-441 220zM1789 1116
+q0 -3 -256.5 -419.5t-300.5 -487.5l-390 634l324 527q17 28 52 28q14 0 26 -6l541 -270q4 -2 4 -6z" />
+    <glyph glyph-name="_536" unicode="&#xf23b;" 
+d="M809 532l266 499h-112l-157 -312q-24 -48 -44 -92l-42 92l-155 312h-120l263 -493v-324h101v318zM1536 1408v-1536h-1536v1536h1536z" />
+    <glyph glyph-name="_537" unicode="&#xf23c;" horiz-adv-x="2296" 
+d="M478 -139q-8 -16 -27 -34.5t-37 -25.5q-25 -9 -51.5 3.5t-28.5 31.5q-1 22 40 55t68 38q23 4 34 -21.5t2 -46.5zM1819 -139q7 -16 26 -34.5t38 -25.5q25 -9 51.5 3.5t27.5 31.5q2 22 -39.5 55t-68.5 38q-22 4 -33 -21.5t-2 -46.5zM1867 -30q13 -27 56.5 -59.5t77.5 -41.5
+q45 -13 82 4.5t37 50.5q0 46 -67.5 100.5t-115.5 59.5q-40 5 -63.5 -37.5t-6.5 -76.5zM428 -30q-13 -27 -56 -59.5t-77 -41.5q-45 -13 -82 4.5t-37 50.5q0 46 67.5 100.5t115.5 59.5q40 5 63 -37.5t6 -76.5zM1158 1094h1q-41 0 -76 -15q27 -8 44 -30.5t17 -49.5
+q0 -35 -27 -60t-65 -25q-52 0 -80 43q-5 -23 -5 -42q0 -74 56 -126.5t135 -52.5q80 0 136 52.5t56 126.5t-56 126.5t-136 52.5zM1462 1312q-99 109 -220.5 131.5t-245.5 -44.5q27 60 82.5 96.5t118 39.5t121.5 -17t99.5 -74.5t44.5 -131.5zM2212 73q8 -11 -11 -42
+q7 -23 7 -40q1 -56 -44.5 -112.5t-109.5 -91.5t-118 -37q-48 -2 -92 21.5t-66 65.5q-687 -25 -1259 0q-23 -41 -66.5 -65t-92.5 -22q-86 3 -179.5 80.5t-92.5 160.5q2 22 7 40q-19 31 -11 42q6 10 31 1q14 22 41 51q-7 29 2 38q11 10 39 -4q29 20 59 34q0 29 13 37
+q23 12 51 -16q35 5 61 -2q18 -4 38 -19v73q-11 0 -18 2q-53 10 -97 44.5t-55 87.5q-9 38 0 81q15 62 93 95q2 17 19 35.5t36 23.5t33 -7.5t19 -30.5h13q46 -5 60 -23q3 -3 5 -7q10 1 30.5 3.5t30.5 3.5q-15 11 -30 17q-23 40 -91 43q0 6 1 10q-62 2 -118.5 18.5t-84.5 47.5
+q-32 36 -42.5 92t-2.5 112q16 126 90 179q23 16 52 4.5t32 -40.5q0 -1 1.5 -14t2.5 -21t3 -20t5.5 -19t8.5 -10q27 -14 76 -12q48 46 98 74q-40 4 -162 -14l47 46q61 58 163 111q145 73 282 86q-20 8 -41 15.5t-47 14t-42.5 10.5t-47.5 11t-43 10q595 126 904 -139
+q98 -84 158 -222q85 -10 121 9h1q5 3 8.5 10t5.5 19t3 19.5t3 21.5l1 14q3 28 32 40t52 -5q73 -52 91 -178q7 -57 -3.5 -113t-42.5 -91q-28 -32 -83.5 -48.5t-115.5 -18.5v-10q-71 -2 -95 -43q-14 -5 -31 -17q11 -1 32 -3.5t30 -3.5q1 5 5 8q16 18 60 23h13q5 18 19 30t33 8
+t36 -23t19 -36q79 -32 93 -95q9 -40 1 -81q-12 -53 -56 -88t-97 -44q-10 -2 -17 -2q0 -49 -1 -73q20 15 38 19q26 7 61 2q28 28 51 16q14 -9 14 -37q33 -16 59 -34q27 13 38 4q10 -10 2 -38q28 -30 41 -51q23 8 31 -1zM1937 1025q0 -29 -9 -54q82 -32 112 -132
+q4 37 -9.5 98.5t-41.5 90.5q-20 19 -36 17t-16 -20zM1859 925q35 -42 47.5 -108.5t-0.5 -124.5q67 13 97 45q13 14 18 28q-3 64 -31 114.5t-79 66.5q-15 -15 -52 -21zM1822 921q-30 0 -44 1q42 -115 53 -239q21 0 43 3q16 68 1 135t-53 100zM258 839q30 100 112 132
+q-9 25 -9 54q0 18 -16.5 20t-35.5 -17q-28 -29 -41.5 -90.5t-9.5 -98.5zM294 737q29 -31 97 -45q-13 58 -0.5 124.5t47.5 108.5v0q-37 6 -52 21q-51 -16 -78.5 -66t-31.5 -115q9 -17 18 -28zM471 683q14 124 73 235q-19 -4 -55 -18l-45 -19v1q-46 -89 -20 -196q25 -3 47 -3z
+M1434 644q8 -38 16.5 -108.5t11.5 -89.5q3 -18 9.5 -21.5t23.5 4.5q40 20 62 85.5t23 125.5q-24 2 -146 4zM1152 1285q-116 0 -199 -82.5t-83 -198.5q0 -117 83 -199.5t199 -82.5t199 82.5t83 199.5q0 116 -83 198.5t-199 82.5zM1380 646q-105 2 -211 0v1q-1 -27 2.5 -86
+t13.5 -66q29 -14 93.5 -14.5t95.5 10.5q9 3 11 39t-0.5 69.5t-4.5 46.5zM1112 447q8 4 9.5 48t-0.5 88t-4 63v1q-212 -3 -214 -3q-4 -20 -7 -62t0 -83t14 -46q34 -15 101 -16t101 10zM718 636q-16 -59 4.5 -118.5t77.5 -84.5q15 -8 24 -5t12 21q3 16 8 90t10 103
+q-69 -2 -136 -6zM591 510q3 -23 -34 -36q132 -141 271.5 -240t305.5 -154q172 49 310.5 146t293.5 250q-33 13 -30 34q0 2 0.5 3.5t1.5 3t1 2.5v1v-1q-17 2 -50 5.5t-48 4.5q-26 -90 -82 -132q-51 -38 -82 1q-5 6 -9 14q-7 13 -17 62q-2 -5 -5 -9t-7.5 -7t-8 -5.5t-9.5 -4
+l-10 -2.5t-12 -2l-12 -1.5t-13.5 -1t-13.5 -0.5q-106 -9 -163 11q-4 -17 -10 -26.5t-21 -15t-23 -7t-36 -3.5q-6 -1 -9 -1q-179 -17 -203 40q-2 -63 -56 -54q-47 8 -91 54q-12 13 -20 26q-17 29 -26 65q-58 -6 -87 -10q1 -2 4 -10zM507 -118q3 14 3 30q-17 71 -51 130
+t-73 70q-41 12 -101.5 -14.5t-104.5 -80t-39 -107.5q35 -53 100 -93t119 -42q51 -2 94 28t53 79zM510 53q23 -63 27 -119q195 113 392 174q-98 52 -180.5 120t-179.5 165q-6 -4 -29 -13q0 -1 -1 -4t-1 -5q31 -18 22 -37q-12 -23 -56 -34q-10 -13 -29 -24h-1q-2 -83 1 -150
+q19 -34 35 -73zM579 -113q532 -21 1145 0q-254 147 -428 196q-76 -35 -156 -57q-8 -3 -16 0q-65 21 -129 49q-208 -60 -416 -188h-1v-1q1 0 1 1zM1763 -67q4 54 28 120q14 38 33 71l-1 -1q3 77 3 153q-15 8 -30 25q-42 9 -56 33q-9 20 22 38q-2 4 -2 9q-16 4 -28 12
+q-204 -190 -383 -284q198 -59 414 -176zM2155 -90q5 54 -39 107.5t-104 80t-102 14.5q-38 -11 -72.5 -70.5t-51.5 -129.5q0 -16 3 -30q10 -49 53 -79t94 -28q54 2 119 42t100 93z" />
+    <glyph glyph-name="_538" unicode="&#xf23d;" horiz-adv-x="2304" 
+d="M1524 -25q0 -68 -48 -116t-116 -48t-116.5 48t-48.5 116t48.5 116.5t116.5 48.5t116 -48.5t48 -116.5zM775 -25q0 -68 -48.5 -116t-116.5 -48t-116 48t-48 116t48 116.5t116 48.5t116.5 -48.5t48.5 -116.5zM0 1469q57 -60 110.5 -104.5t121 -82t136 -63t166 -45.5
+t200 -31.5t250 -18.5t304 -9.5t372.5 -2.5q139 0 244.5 -5t181 -16.5t124 -27.5t71 -39.5t24 -51.5t-19.5 -64t-56.5 -76.5t-89.5 -91t-116 -104.5t-139 -119q-185 -157 -286 -247q29 51 76.5 109t94 105.5t94.5 98.5t83 91.5t54 80.5t13 70t-45.5 55.5t-116.5 41t-204 23.5
+t-304 5q-168 -2 -314 6t-256 23t-204.5 41t-159.5 51.5t-122.5 62.5t-91.5 66.5t-68 71.5t-50.5 69.5t-40 68t-36.5 59.5z" />
+    <glyph glyph-name="_539" unicode="&#xf23e;" horiz-adv-x="1792" 
+d="M896 1472q-169 0 -323 -66t-265.5 -177.5t-177.5 -265.5t-66 -323t66 -323t177.5 -265.5t265.5 -177.5t323 -66t323 66t265.5 177.5t177.5 265.5t66 323t-66 323t-177.5 265.5t-265.5 177.5t-323 66zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348
+t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71zM496 704q16 0 16 -16v-480q0 -16 -16 -16h-32q-16 0 -16 16v480q0 16 16 16h32zM896 640q53 0 90.5 -37.5t37.5 -90.5q0 -35 -17.5 -64t-46.5 -46v-114q0 -14 -9 -23
+t-23 -9h-64q-14 0 -23 9t-9 23v114q-29 17 -46.5 46t-17.5 64q0 53 37.5 90.5t90.5 37.5zM896 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM544 928v-96
+q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 93 65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5v-96q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v96q0 146 -103 249t-249 103t-249 -103t-103 -249zM1408 192v512q0 26 -19 45t-45 19h-896q-26 0 -45 -19t-19 -45v-512
+q0 -26 19 -45t45 -19h896q26 0 45 19t19 45z" />
+    <glyph glyph-name="_540" unicode="&#xf240;" horiz-adv-x="2304" 
+d="M1920 1024v-768h-1664v768h1664zM2048 448h128v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288zM2304 832v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113
+v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160q53 0 90.5 -37.5t37.5 -90.5z" />
+    <glyph glyph-name="_541" unicode="&#xf241;" horiz-adv-x="2304" 
+d="M256 256v768h1280v-768h-1280zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
+h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+    <glyph glyph-name="_542" unicode="&#xf242;" horiz-adv-x="2304" 
+d="M256 256v768h896v-768h-896zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
+h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+    <glyph glyph-name="_543" unicode="&#xf243;" horiz-adv-x="2304" 
+d="M256 256v768h512v-768h-512zM2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9
+h-1856q-14 0 -23 -9t-9 -23v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+    <glyph glyph-name="_544" unicode="&#xf244;" horiz-adv-x="2304" 
+d="M2176 960q53 0 90.5 -37.5t37.5 -90.5v-384q0 -53 -37.5 -90.5t-90.5 -37.5v-160q0 -66 -47 -113t-113 -47h-1856q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1856q66 0 113 -47t47 -113v-160zM2176 448v384h-128v288q0 14 -9 23t-23 9h-1856q-14 0 -23 -9t-9 -23
+v-960q0 -14 9 -23t23 -9h1856q14 0 23 9t9 23v288h128z" />
+    <glyph glyph-name="_545" unicode="&#xf245;" horiz-adv-x="1280" 
+d="M1133 493q31 -30 14 -69q-17 -40 -59 -40h-382l201 -476q10 -25 0 -49t-34 -35l-177 -75q-25 -10 -49 0t-35 34l-191 452l-312 -312q-19 -19 -45 -19q-12 0 -24 5q-40 17 -40 59v1504q0 42 40 59q12 5 24 5q27 0 45 -19z" />
+    <glyph glyph-name="_546" unicode="&#xf246;" horiz-adv-x="1024" 
+d="M832 1408q-320 0 -320 -224v-416h128v-128h-128v-544q0 -224 320 -224h64v-128h-64q-272 0 -384 146q-112 -146 -384 -146h-64v128h64q320 0 320 224v544h-128v128h128v416q0 224 -320 224h-64v128h64q272 0 384 -146q112 146 384 146h64v-128h-64z" />
+    <glyph glyph-name="_547" unicode="&#xf247;" horiz-adv-x="2048" 
+d="M2048 1152h-128v-1024h128v-384h-384v128h-1280v-128h-384v384h128v1024h-128v384h384v-128h1280v128h384v-384zM1792 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 -128v128h-128v-128h128zM1664 0v128h128v1024h-128v128h-1280v-128h-128v-1024h128v-128
+h1280zM1920 -128v128h-128v-128h128zM1280 896h384v-768h-896v256h-384v768h896v-256zM512 512h640v512h-640v-512zM1536 256v512h-256v-384h-384v-128h640z" />
+    <glyph glyph-name="_548" unicode="&#xf248;" horiz-adv-x="2304" 
+d="M2304 768h-128v-640h128v-384h-384v128h-896v-128h-384v384h128v128h-384v-128h-384v384h128v640h-128v384h384v-128h896v128h384v-384h-128v-128h384v128h384v-384zM2048 1024v-128h128v128h-128zM1408 1408v-128h128v128h-128zM128 1408v-128h128v128h-128zM256 256
+v128h-128v-128h128zM1536 384h-128v-128h128v128zM384 384h896v128h128v640h-128v128h-896v-128h-128v-640h128v-128zM896 -128v128h-128v-128h128zM2176 -128v128h-128v-128h128zM2048 128v640h-128v128h-384v-384h128v-384h-384v128h-384v-128h128v-128h896v128h128z" />
+    <glyph glyph-name="_549" unicode="&#xf249;" 
+d="M1024 288v-416h-928q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68v-928h-416q-40 0 -68 -28t-28 -68zM1152 256h381q-15 -82 -65 -132l-184 -184q-50 -50 -132 -65v381z" />
+    <glyph glyph-name="_550" unicode="&#xf24a;" 
+d="M1400 256h-248v-248q29 10 41 22l185 185q12 12 22 41zM1120 384h288v896h-1280v-1280h896v288q0 40 28 68t68 28zM1536 1312v-1024q0 -40 -20 -88t-48 -76l-184 -184q-28 -28 -76 -48t-88 -20h-1024q-40 0 -68 28t-28 68v1344q0 40 28 68t68 28h1344q40 0 68 -28t28 -68
+z" />
+    <glyph glyph-name="_551" unicode="&#xf24b;" horiz-adv-x="2304" 
+d="M1951 538q0 -26 -15.5 -44.5t-38.5 -23.5q-8 -2 -18 -2h-153v140h153q10 0 18 -2q23 -5 38.5 -23.5t15.5 -44.5zM1933 751q0 -25 -15 -42t-38 -21q-3 -1 -15 -1h-139v129h139q3 0 8.5 -0.5t6.5 -0.5q23 -4 38 -21.5t15 -42.5zM728 587v308h-228v-308q0 -58 -38 -94.5
+t-105 -36.5q-108 0 -229 59v-112q53 -15 121 -23t109 -9l42 -1q328 0 328 217zM1442 403v113q-99 -52 -200 -59q-108 -8 -169 41t-61 142t61 142t169 41q101 -7 200 -58v112q-48 12 -100 19.5t-80 9.5l-28 2q-127 6 -218.5 -14t-140.5 -60t-71 -88t-22 -106t22 -106t71 -88
+t140.5 -60t218.5 -14q101 4 208 31zM2176 518q0 54 -43 88.5t-109 39.5v3q57 8 89 41.5t32 79.5q0 55 -41 88t-107 36q-3 0 -12 0.5t-14 0.5h-455v-510h491q74 0 121.5 36.5t47.5 96.5zM2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90
+t90 38h2048q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_552" unicode="&#xf24c;" horiz-adv-x="2304" 
+d="M858 295v693q-106 -41 -172 -135.5t-66 -211.5t66 -211.5t172 -134.5zM1362 641q0 117 -66 211.5t-172 135.5v-694q106 41 172 135.5t66 211.5zM1577 641q0 -159 -78.5 -294t-213.5 -213.5t-294 -78.5q-119 0 -227.5 46.5t-187 125t-125 187t-46.5 227.5q0 159 78.5 294
+t213.5 213.5t294 78.5t294 -78.5t213.5 -213.5t78.5 -294zM1960 634q0 139 -55.5 261.5t-147.5 205.5t-213.5 131t-252.5 48h-301q-176 0 -323.5 -81t-235 -230t-87.5 -335q0 -171 87 -317.5t236 -231.5t323 -85h301q129 0 251.5 50.5t214.5 135t147.5 202.5t55.5 246z
+M2304 1280v-1280q0 -52 -38 -90t-90 -38h-2048q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h2048q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_553" unicode="&#xf24d;" horiz-adv-x="1792" 
+d="M1664 -96v1088q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h1088q13 0 22.5 9.5t9.5 22.5zM1792 992v-1088q0 -66 -47 -113t-113 -47h-1088q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113
+zM1408 1376v-160h-128v160q0 13 -9.5 22.5t-22.5 9.5h-1088q-13 0 -22.5 -9.5t-9.5 -22.5v-1088q0 -13 9.5 -22.5t22.5 -9.5h160v-128h-160q-66 0 -113 47t-47 113v1088q0 66 47 113t113 47h1088q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="_554" unicode="&#xf24e;" horiz-adv-x="2304" 
+d="M1728 1088l-384 -704h768zM448 1088l-384 -704h768zM1269 1280q-14 -40 -45.5 -71.5t-71.5 -45.5v-1291h608q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1344q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h608v1291q-40 14 -71.5 45.5t-45.5 71.5h-491q-14 0 -23 9t-9 23v64
+q0 14 9 23t23 9h491q21 57 70 92.5t111 35.5t111 -35.5t70 -92.5h491q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-491zM1088 1264q33 0 56.5 23.5t23.5 56.5t-23.5 56.5t-56.5 23.5t-56.5 -23.5t-23.5 -56.5t23.5 -56.5t56.5 -23.5zM2176 384q0 -73 -46.5 -131t-117.5 -91
+t-144.5 -49.5t-139.5 -16.5t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81zM896 384q0 -73 -46.5 -131t-117.5 -91t-144.5 -49.5t-139.5 -16.5
+t-139.5 16.5t-144.5 49.5t-117.5 91t-46.5 131q0 11 35 81t92 174.5t107 195.5t102 184t56 100q18 33 56 33t56 -33q4 -7 56 -100t102 -184t107 -195.5t92 -174.5t35 -81z" />
+    <glyph glyph-name="_555" unicode="&#xf250;" 
+d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
+t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-77 -29 -149 -92.5
+t-129.5 -152.5t-92.5 -210t-35 -253h1024q0 132 -35 253t-92.5 210t-129.5 152.5t-149 92.5q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
+    <glyph glyph-name="_556" unicode="&#xf251;" 
+d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
+t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -66 9 -128h1006q9 61 9 128zM1280 -128q0 130 -34 249.5t-90.5 208t-126.5 152t-146 94.5h-230q-76 -31 -146 -94.5t-126.5 -152t-90.5 -208t-34 -249.5h1024z" />
+    <glyph glyph-name="_557" unicode="&#xf252;" 
+d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
+t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM1280 1408h-1024q0 -206 85 -384h854q85 178 85 384zM1223 192q-54 141 -145.5 241.5t-194.5 142.5h-230q-103 -42 -194.5 -142.5t-145.5 -241.5h910z" />
+    <glyph glyph-name="_558" unicode="&#xf253;" 
+d="M1408 1408q0 -261 -106.5 -461.5t-266.5 -306.5q160 -106 266.5 -306.5t106.5 -461.5h96q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96q0 261 106.5 461.5t266.5 306.5q-160 106 -266.5 306.5t-106.5 461.5h-96q-14 0 -23 9
+t-9 23v64q0 14 9 23t23 9h1472q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-96zM874 700q77 29 149 92.5t129.5 152.5t92.5 210t35 253h-1024q0 -132 35 -253t92.5 -210t129.5 -152.5t149 -92.5q19 -7 30.5 -23.5t11.5 -36.5t-11.5 -36.5t-30.5 -23.5q-137 -51 -244 -196
+h700q-107 145 -244 196q-19 7 -30.5 23.5t-11.5 36.5t11.5 36.5t30.5 23.5z" />
+    <glyph glyph-name="_559" unicode="&#xf254;" 
+d="M1504 -64q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472zM130 0q3 55 16 107t30 95t46 87t53.5 76t64.5 69.5t66 60t70.5 55t66.5 47.5t65 43q-43 28 -65 43t-66.5 47.5t-70.5 55t-66 60t-64.5 69.5t-53.5 76t-46 87
+t-30 95t-16 107h1276q-3 -55 -16 -107t-30 -95t-46 -87t-53.5 -76t-64.5 -69.5t-66 -60t-70.5 -55t-66.5 -47.5t-65 -43q43 -28 65 -43t66.5 -47.5t70.5 -55t66 -60t64.5 -69.5t53.5 -76t46 -87t30 -95t16 -107h-1276zM1504 1536q14 0 23 -9t9 -23v-128q0 -14 -9 -23t-23 -9
+h-1472q-14 0 -23 9t-9 23v128q0 14 9 23t23 9h1472z" />
+    <glyph glyph-name="_560" unicode="&#xf255;" 
+d="M768 1152q-53 0 -90.5 -37.5t-37.5 -90.5v-128h-32v93q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-429l-32 30v172q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-224q0 -47 35 -82l310 -296q39 -39 39 -102q0 -26 19 -45t45 -19h640q26 0 45 19t19 45v25
+q0 41 10 77l108 436q10 36 10 77v246q0 48 -32 81.5t-80 33.5q-46 0 -79 -33t-33 -79v-32h-32v125q0 40 -25 72.5t-64 40.5q-14 2 -23 2q-46 0 -79 -33t-33 -79v-128h-32v122q0 51 -32.5 89.5t-82.5 43.5q-5 1 -13 1zM768 1280q84 0 149 -50q57 34 123 34q59 0 111 -27
+t86 -76q27 7 59 7q100 0 170 -71.5t70 -171.5v-246q0 -51 -13 -108l-109 -436q-6 -24 -6 -71q0 -80 -56 -136t-136 -56h-640q-84 0 -138 58.5t-54 142.5l-308 296q-76 73 -76 175v224q0 99 70.5 169.5t169.5 70.5q11 0 16 -1q6 95 75.5 160t164.5 65q52 0 98 -21
+q72 69 174 69z" />
+    <glyph glyph-name="_561" unicode="&#xf256;" horiz-adv-x="1792" 
+d="M880 1408q-46 0 -79 -33t-33 -79v-656h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528v-256l-154 205q-38 51 -102 51q-53 0 -90.5 -37.5t-37.5 -90.5q0 -43 26 -77l384 -512q38 -51 102 -51h688q34 0 61 22t34 56l76 405q5 32 5 59v498q0 46 -33 79t-79 33t-79 -33
+t-33 -79v-272h-32v528q0 46 -33 79t-79 33t-79 -33t-33 -79v-528h-32v656q0 46 -33 79t-79 33zM880 1536q68 0 125.5 -35.5t88.5 -96.5q19 4 42 4q99 0 169.5 -70.5t70.5 -169.5v-17q105 6 180.5 -64t75.5 -175v-498q0 -40 -8 -83l-76 -404q-14 -79 -76.5 -131t-143.5 -52
+h-688q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 106 75 181t181 75q78 0 128 -34v434q0 99 70.5 169.5t169.5 70.5q23 0 42 -4q31 61 88.5 96.5t125.5 35.5z" />
+    <glyph glyph-name="_562" unicode="&#xf257;" horiz-adv-x="1792" 
+d="M1073 -128h-177q-163 0 -226 141q-23 49 -23 102v5q-62 30 -98.5 88.5t-36.5 127.5q0 38 5 48h-261q-106 0 -181 75t-75 181t75 181t181 75h113l-44 17q-74 28 -119.5 93.5t-45.5 145.5q0 106 75 181t181 75q46 0 91 -17l628 -239h401q106 0 181 -75t75 -181v-668
+q0 -88 -54 -157.5t-140 -90.5l-339 -85q-92 -23 -186 -23zM1024 583l-155 -71l-163 -74q-30 -14 -48 -41.5t-18 -60.5q0 -46 33 -79t79 -33q26 0 46 10l338 154q-49 10 -80.5 50t-31.5 90v55zM1344 272q0 46 -33 79t-79 33q-26 0 -46 -10l-290 -132q-28 -13 -37 -17
+t-30.5 -17t-29.5 -23.5t-16 -29t-8 -40.5q0 -50 31.5 -82t81.5 -32q20 0 38 9l352 160q30 14 48 41.5t18 60.5zM1112 1024l-650 248q-24 8 -46 8q-53 0 -90.5 -37.5t-37.5 -90.5q0 -40 22.5 -73t59.5 -47l526 -200v-64h-640q-53 0 -90.5 -37.5t-37.5 -90.5t37.5 -90.5
+t90.5 -37.5h535l233 106v198q0 63 46 106l111 102h-69zM1073 0q82 0 155 19l339 85q43 11 70 45.5t27 78.5v668q0 53 -37.5 90.5t-90.5 37.5h-308l-136 -126q-36 -33 -36 -82v-296q0 -46 33 -77t79 -31t79 35t33 81v208h32v-208q0 -70 -57 -114q52 -8 86.5 -48.5t34.5 -93.5
+q0 -42 -23 -78t-61 -53l-310 -141h91z" />
+    <glyph glyph-name="_563" unicode="&#xf258;" horiz-adv-x="2048" 
+d="M1151 1536q61 0 116 -28t91 -77l572 -781q118 -159 118 -359v-355q0 -80 -56 -136t-136 -56h-384q-80 0 -136 56t-56 136v177l-286 143h-546q-80 0 -136 56t-56 136v32q0 119 84.5 203.5t203.5 84.5h420l42 128h-686q-100 0 -173.5 67.5t-81.5 166.5q-65 79 -65 182v32
+q0 80 56 136t136 56h959zM1920 -64v355q0 157 -93 284l-573 781q-39 52 -103 52h-959q-26 0 -45 -19t-19 -45q0 -32 1.5 -49.5t9.5 -40.5t25 -43q10 31 35.5 50t56.5 19h832v-32h-832q-26 0 -45 -19t-19 -45q0 -44 3 -58q8 -44 44 -73t81 -29h640h91q40 0 68 -28t28 -68
+q0 -15 -5 -30l-64 -192q-10 -29 -35 -47.5t-56 -18.5h-443q-66 0 -113 -47t-47 -113v-32q0 -26 19 -45t45 -19h561q16 0 29 -7l317 -158q24 -13 38.5 -36t14.5 -50v-197q0 -26 19 -45t45 -19h384q26 0 45 19t19 45z" />
+    <glyph glyph-name="_564" unicode="&#xf259;" horiz-adv-x="2048" 
+d="M459 -256q-77 0 -137.5 47.5t-79.5 122.5l-101 401q-13 57 -13 108q0 45 -5 67l-116 477q-7 27 -7 57q0 93 62 161t155 78q17 85 82.5 139t152.5 54q83 0 148 -51.5t85 -132.5l83 -348l103 428q20 81 85 132.5t148 51.5q89 0 155.5 -57.5t80.5 -144.5q92 -10 152 -79
+t60 -162q0 -24 -7 -59l-123 -512q10 7 37.5 28.5t38.5 29.5t35 23t41 20.5t41.5 11t49.5 5.5q105 0 180 -74t75 -179q0 -62 -28.5 -118t-78.5 -94l-507 -380q-68 -51 -153 -51h-694zM1104 1408q-38 0 -68.5 -24t-39.5 -62l-164 -682h-127l-145 602q-9 38 -39.5 62t-68.5 24
+q-48 0 -80 -33t-32 -80q0 -15 3 -28l132 -547h-26l-99 408q-9 37 -40 62.5t-69 25.5q-47 0 -80 -33t-33 -79q0 -14 3 -26l116 -478q7 -28 9 -86t10 -88l100 -401q8 -32 34 -52.5t59 -20.5h694q42 0 76 26l507 379q56 43 56 110q0 52 -37.5 88.5t-89.5 36.5q-43 0 -77 -26
+l-307 -230v227q0 4 32 138t68 282t39 161q4 18 4 29q0 47 -32 81t-79 34q-39 0 -69.5 -24t-39.5 -62l-116 -482h-26l150 624q3 14 3 28q0 48 -31.5 82t-79.5 34z" />
+    <glyph glyph-name="_565" unicode="&#xf25a;" horiz-adv-x="1792" 
+d="M640 1408q-53 0 -90.5 -37.5t-37.5 -90.5v-512v-384l-151 202q-41 54 -107 54q-52 0 -89 -38t-37 -90q0 -43 26 -77l384 -512q38 -51 102 -51h718q22 0 39.5 13.5t22.5 34.5l92 368q24 96 24 194v217q0 41 -28 71t-68 30t-68 -28t-28 -68h-32v61q0 48 -32 81.5t-80 33.5
+q-46 0 -79 -33t-33 -79v-64h-32v90q0 55 -37 94.5t-91 39.5q-53 0 -90.5 -37.5t-37.5 -90.5v-96h-32v570q0 55 -37 94.5t-91 39.5zM640 1536q107 0 181.5 -77.5t74.5 -184.5v-220q22 2 32 2q99 0 173 -69q47 21 99 21q113 0 184 -87q27 7 56 7q94 0 159 -67.5t65 -161.5
+v-217q0 -116 -28 -225l-92 -368q-16 -64 -68 -104.5t-118 -40.5h-718q-60 0 -114.5 27.5t-90.5 74.5l-384 512q-51 68 -51 154q0 105 74.5 180.5t179.5 75.5q71 0 130 -35v547q0 106 75 181t181 75zM768 128v384h-32v-384h32zM1024 128v384h-32v-384h32zM1280 128v384h-32
+v-384h32z" />
+    <glyph glyph-name="_566" unicode="&#xf25b;" 
+d="M1288 889q60 0 107 -23q141 -63 141 -226v-177q0 -94 -23 -186l-85 -339q-21 -86 -90.5 -140t-157.5 -54h-668q-106 0 -181 75t-75 181v401l-239 628q-17 45 -17 91q0 106 75 181t181 75q80 0 145.5 -45.5t93.5 -119.5l17 -44v113q0 106 75 181t181 75t181 -75t75 -181
+v-261q27 5 48 5q69 0 127.5 -36.5t88.5 -98.5zM1072 896q-33 0 -60.5 -18t-41.5 -48l-74 -163l-71 -155h55q50 0 90 -31.5t50 -80.5l154 338q10 20 10 46q0 46 -33 79t-79 33zM1293 761q-22 0 -40.5 -8t-29 -16t-23.5 -29.5t-17 -30.5t-17 -37l-132 -290q-10 -20 -10 -46
+q0 -46 33 -79t79 -33q33 0 60.5 18t41.5 48l160 352q9 18 9 38q0 50 -32 81.5t-82 31.5zM128 1120q0 -22 8 -46l248 -650v-69l102 111q43 46 106 46h198l106 233v535q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5v-640h-64l-200 526q-14 37 -47 59.5t-73 22.5
+q-53 0 -90.5 -37.5t-37.5 -90.5zM1180 -128q44 0 78.5 27t45.5 70l85 339q19 73 19 155v91l-141 -310q-17 -38 -53 -61t-78 -23q-53 0 -93.5 34.5t-48.5 86.5q-44 -57 -114 -57h-208v32h208q46 0 81 33t35 79t-31 79t-77 33h-296q-49 0 -82 -36l-126 -136v-308
+q0 -53 37.5 -90.5t90.5 -37.5h668z" />
+    <glyph glyph-name="_567" unicode="&#xf25c;" horiz-adv-x="1973" 
+d="M857 992v-117q0 -13 -9.5 -22t-22.5 -9h-298v-812q0 -13 -9 -22.5t-22 -9.5h-135q-13 0 -22.5 9t-9.5 23v812h-297q-13 0 -22.5 9t-9.5 22v117q0 14 9 23t23 9h793q13 0 22.5 -9.5t9.5 -22.5zM1895 995l77 -961q1 -13 -8 -24q-10 -10 -23 -10h-134q-12 0 -21 8.5
+t-10 20.5l-46 588l-189 -425q-8 -19 -29 -19h-120q-20 0 -29 19l-188 427l-45 -590q-1 -12 -10 -20.5t-21 -8.5h-135q-13 0 -23 10q-9 10 -9 24l78 961q1 12 10 20.5t21 8.5h142q20 0 29 -19l220 -520q10 -24 20 -51q3 7 9.5 24.5t10.5 26.5l221 520q9 19 29 19h141
+q13 0 22 -8.5t10 -20.5z" />
+    <glyph glyph-name="_568" unicode="&#xf25d;" horiz-adv-x="1792" 
+d="M1042 833q0 88 -60 121q-33 18 -117 18h-123v-281h162q66 0 102 37t36 105zM1094 548l205 -373q8 -17 -1 -31q-8 -16 -27 -16h-152q-20 0 -28 17l-194 365h-155v-350q0 -14 -9 -23t-23 -9h-134q-14 0 -23 9t-9 23v960q0 14 9 23t23 9h294q128 0 190 -24q85 -31 134 -109
+t49 -180q0 -92 -42.5 -165.5t-115.5 -109.5q6 -10 9 -16zM896 1376q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM1792 640
+q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="_569" unicode="&#xf25e;" horiz-adv-x="1792" 
+d="M605 303q153 0 257 104q14 18 3 36l-45 82q-6 13 -24 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13.5t-23.5 -14.5t-28.5 -13t-33.5 -9.5t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78
+q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-148 0 -246 -96.5t-98 -240.5q0 -146 97 -241.5t247 -95.5zM1235 303q153 0 257 104q14 18 4 36l-45 82q-8 14 -25 17q-16 2 -27 -11l-4 -3q-4 -4 -11.5 -10t-17.5 -13.5t-23.5 -14.5t-28.5 -13t-33.5 -9.5
+t-37.5 -3.5q-76 0 -125 50t-49 127q0 76 48 125.5t122 49.5q37 0 71.5 -14t50.5 -28l16 -14q11 -11 26 -10q16 2 24 14l53 78q13 20 -2 39q-3 4 -11 12t-30 23.5t-48.5 28t-67.5 22.5t-86 10q-147 0 -245.5 -96.5t-98.5 -240.5q0 -146 97 -241.5t247 -95.5zM896 1376
+q-150 0 -286 -58.5t-234.5 -157t-157 -234.5t-58.5 -286t58.5 -286t157 -234.5t234.5 -157t286 -58.5t286 58.5t234.5 157t157 234.5t58.5 286t-58.5 286t-157 234.5t-234.5 157t-286 58.5zM896 1536q182 0 348 -71t286 -191t191 -286t71 -348t-71 -348t-191 -286t-286 -191
+t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71z" />
+    <glyph glyph-name="f260" unicode="&#xf260;" horiz-adv-x="2048" 
+d="M736 736l384 -384l-384 -384l-672 672l672 672l168 -168l-96 -96l-72 72l-480 -480l480 -480l193 193l-289 287zM1312 1312l672 -672l-672 -672l-168 168l96 96l72 -72l480 480l-480 480l-193 -193l289 -287l-96 -96l-384 384z" />
+    <glyph glyph-name="f261" unicode="&#xf261;" horiz-adv-x="1792" 
+d="M717 182l271 271l-279 279l-88 -88l192 -191l-96 -96l-279 279l279 279l40 -40l87 87l-127 128l-454 -454zM1075 190l454 454l-454 454l-271 -271l279 -279l88 88l-192 191l96 96l279 -279l-279 -279l-40 40l-87 -88zM1792 640q0 -182 -71 -348t-191 -286t-286 -191
+t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="_572" unicode="&#xf262;" horiz-adv-x="2304" 
+d="M651 539q0 -39 -27.5 -66.5t-65.5 -27.5q-39 0 -66.5 27.5t-27.5 66.5q0 38 27.5 65.5t66.5 27.5q38 0 65.5 -27.5t27.5 -65.5zM1805 540q0 -39 -27.5 -66.5t-66.5 -27.5t-66.5 27.5t-27.5 66.5t27.5 66t66.5 27t66.5 -27t27.5 -66zM765 539q0 79 -56.5 136t-136.5 57
+t-136.5 -56.5t-56.5 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM1918 540q0 80 -56.5 136.5t-136.5 56.5q-79 0 -136 -56.5t-57 -136.5t56.5 -136.5t136.5 -56.5t136.5 56.5t56.5 136.5zM850 539q0 -116 -81.5 -197.5t-196.5 -81.5q-116 0 -197.5 82t-81.5 197
+t82 196.5t197 81.5t196.5 -81.5t81.5 -196.5zM2004 540q0 -115 -81.5 -196.5t-197.5 -81.5q-115 0 -196.5 81.5t-81.5 196.5t81.5 196.5t196.5 81.5q116 0 197.5 -81.5t81.5 -196.5zM1040 537q0 191 -135.5 326.5t-326.5 135.5q-125 0 -231 -62t-168 -168.5t-62 -231.5
+t62 -231.5t168 -168.5t231 -62q191 0 326.5 135.5t135.5 326.5zM1708 1110q-254 111 -556 111q-319 0 -573 -110q117 0 223 -45.5t182.5 -122.5t122 -183t45.5 -223q0 115 43.5 219.5t118 180.5t177.5 123t217 50zM2187 537q0 191 -135 326.5t-326 135.5t-326.5 -135.5
+t-135.5 -326.5t135.5 -326.5t326.5 -135.5t326 135.5t135 326.5zM1921 1103h383q-44 -51 -75 -114.5t-40 -114.5q110 -151 110 -337q0 -156 -77 -288t-209 -208.5t-287 -76.5q-133 0 -249 56t-196 155q-47 -56 -129 -179q-11 22 -53.5 82.5t-74.5 97.5
+q-80 -99 -196.5 -155.5t-249.5 -56.5q-155 0 -287 76.5t-209 208.5t-77 288q0 186 110 337q-9 51 -40 114.5t-75 114.5h365q149 100 355 156.5t432 56.5q224 0 421 -56t348 -157z" />
+    <glyph glyph-name="f263" unicode="&#xf263;" horiz-adv-x="1280" 
+d="M640 629q-188 0 -321 133t-133 320q0 188 133 321t321 133t321 -133t133 -321q0 -187 -133 -320t-321 -133zM640 1306q-92 0 -157.5 -65.5t-65.5 -158.5q0 -92 65.5 -157.5t157.5 -65.5t157.5 65.5t65.5 157.5q0 93 -65.5 158.5t-157.5 65.5zM1163 574q13 -27 15 -49.5
+t-4.5 -40.5t-26.5 -38.5t-42.5 -37t-61.5 -41.5q-115 -73 -315 -94l73 -72l267 -267q30 -31 30 -74t-30 -73l-12 -13q-31 -30 -74 -30t-74 30q-67 68 -267 268l-267 -268q-31 -30 -74 -30t-73 30l-12 13q-31 30 -31 73t31 74l267 267l72 72q-203 21 -317 94
+q-39 25 -61.5 41.5t-42.5 37t-26.5 38.5t-4.5 40.5t15 49.5q10 20 28 35t42 22t56 -2t65 -35q5 -4 15 -11t43 -24.5t69 -30.5t92 -24t113 -11q91 0 174 25.5t120 50.5l38 25q33 26 65 35t56 2t42 -22t28 -35z" />
+    <glyph glyph-name="_574" unicode="&#xf264;" 
+d="M927 956q0 -66 -46.5 -112.5t-112.5 -46.5t-112.5 46.5t-46.5 112.5t46.5 112.5t112.5 46.5t112.5 -46.5t46.5 -112.5zM1141 593q-10 20 -28 32t-47.5 9.5t-60.5 -27.5q-10 -8 -29 -20t-81 -32t-127 -20t-124 18t-86 36l-27 18q-31 25 -60.5 27.5t-47.5 -9.5t-28 -32
+q-22 -45 -2 -74.5t87 -73.5q83 -53 226 -67l-51 -52q-142 -142 -191 -190q-22 -22 -22 -52.5t22 -52.5l9 -9q22 -22 52.5 -22t52.5 22l191 191q114 -115 191 -191q22 -22 52.5 -22t52.5 22l9 9q22 22 22 52.5t-22 52.5l-191 190l-52 52q141 14 225 67q67 44 87 73.5t-2 74.5
+zM1092 956q0 134 -95 229t-229 95t-229 -95t-95 -229t95 -229t229 -95t229 95t95 229zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="_575" unicode="&#xf265;" horiz-adv-x="1720" 
+d="M1565 1408q65 0 110 -45.5t45 -110.5v-519q0 -176 -68 -336t-182.5 -275t-274 -182.5t-334.5 -67.5q-176 0 -335.5 67.5t-274.5 182.5t-183 275t-68 336v519q0 64 46 110t110 46h1409zM861 344q47 0 82 33l404 388q37 35 37 85q0 49 -34.5 83.5t-83.5 34.5q-47 0 -82 -33
+l-323 -310l-323 310q-35 33 -81 33q-49 0 -83.5 -34.5t-34.5 -83.5q0 -51 36 -85l405 -388q33 -33 81 -33z" />
+    <glyph glyph-name="_576" unicode="&#xf266;" horiz-adv-x="2304" 
+d="M1494 -103l-295 695q-25 -49 -158.5 -305.5t-198.5 -389.5q-1 -1 -27.5 -0.5t-26.5 1.5q-82 193 -255.5 587t-259.5 596q-21 50 -66.5 107.5t-103.5 100.5t-102 43q0 5 -0.5 24t-0.5 27h583v-50q-39 -2 -79.5 -16t-66.5 -43t-10 -64q26 -59 216.5 -499t235.5 -540
+q31 61 140 266.5t131 247.5q-19 39 -126 281t-136 295q-38 69 -201 71v50l513 -1v-47q-60 -2 -93.5 -25t-12.5 -69q33 -70 87 -189.5t86 -187.5q110 214 173 363q24 55 -10 79.5t-129 26.5q1 7 1 25v24q64 0 170.5 0.5t180 1t92.5 0.5v-49q-62 -2 -119 -33t-90 -81
+l-213 -442q13 -33 127.5 -290t121.5 -274l441 1017q-14 38 -49.5 62.5t-65 31.5t-55.5 8v50l460 -4l1 -2l-1 -44q-139 -4 -201 -145q-526 -1216 -559 -1291h-49z" />
+    <glyph glyph-name="_577" unicode="&#xf267;" horiz-adv-x="1792" 
+d="M949 643q0 -26 -16.5 -45t-41.5 -19q-26 0 -45 16.5t-19 41.5q0 26 17 45t42 19t44 -16.5t19 -41.5zM964 585l350 581q-9 -8 -67.5 -62.5t-125.5 -116.5t-136.5 -127t-117 -110.5t-50.5 -51.5l-349 -580q7 7 67 62t126 116.5t136 127t117 111t50 50.5zM1611 640
+q0 -201 -104 -371q-3 2 -17 11t-26.5 16.5t-16.5 7.5q-13 0 -13 -13q0 -10 59 -44q-74 -112 -184.5 -190.5t-241.5 -110.5l-16 67q-1 10 -15 10q-5 0 -8 -5.5t-2 -9.5l16 -68q-72 -15 -146 -15q-199 0 -372 105q1 2 13 20.5t21.5 33.5t9.5 19q0 13 -13 13q-6 0 -17 -14.5
+t-22.5 -34.5t-13.5 -23q-113 75 -192 187.5t-110 244.5l69 15q10 3 10 15q0 5 -5.5 8t-10.5 2l-68 -15q-14 72 -14 139q0 206 109 379q2 -1 18.5 -12t30 -19t17.5 -8q13 0 13 12q0 6 -12.5 15.5t-32.5 21.5l-20 12q77 112 189 189t244 107l15 -67q2 -10 15 -10q5 0 8 5.5
+t2 10.5l-15 66q71 13 134 13q204 0 379 -109q-39 -56 -39 -65q0 -13 12 -13q11 0 48 64q111 -75 187.5 -186t107.5 -241l-56 -12q-10 -2 -10 -16q0 -5 5.5 -8t9.5 -2l57 13q14 -72 14 -140zM1696 640q0 163 -63.5 311t-170.5 255t-255 170.5t-311 63.5t-311 -63.5
+t-255 -170.5t-170.5 -255t-63.5 -311t63.5 -311t170.5 -255t255 -170.5t311 -63.5t311 63.5t255 170.5t170.5 255t63.5 311zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191
+t191 -286t71 -348z" />
+    <glyph glyph-name="_578" unicode="&#xf268;" horiz-adv-x="1792" 
+d="M893 1536q240 2 451 -120q232 -134 352 -372l-742 39q-160 9 -294 -74.5t-185 -229.5l-276 424q128 159 311 245.5t383 87.5zM146 1131l337 -663q72 -143 211 -217t293 -45l-230 -451q-212 33 -385 157.5t-272.5 316t-99.5 411.5q0 267 146 491zM1732 962
+q58 -150 59.5 -310.5t-48.5 -306t-153 -272t-246 -209.5q-230 -133 -498 -119l405 623q88 131 82.5 290.5t-106.5 277.5zM896 942q125 0 213.5 -88.5t88.5 -213.5t-88.5 -213.5t-213.5 -88.5t-213.5 88.5t-88.5 213.5t88.5 213.5t213.5 88.5z" />
+    <glyph glyph-name="_579" unicode="&#xf269;" horiz-adv-x="1792" 
+d="M903 -256q-283 0 -504.5 150.5t-329.5 398.5q-58 131 -67 301t26 332.5t111 312t179 242.5l-11 -281q11 14 68 15.5t70 -15.5q42 81 160.5 138t234.5 59q-54 -45 -119.5 -148.5t-58.5 -163.5q25 -8 62.5 -13.5t63 -7.5t68 -4t50.5 -3q15 -5 9.5 -45.5t-30.5 -75.5
+q-5 -7 -16.5 -18.5t-56.5 -35.5t-101 -34l15 -189l-139 67q-18 -43 -7.5 -81.5t36 -66.5t65.5 -41.5t81 -6.5q51 9 98 34.5t83.5 45t73.5 17.5q61 -4 89.5 -33t19.5 -65q-1 -2 -2.5 -5.5t-8.5 -12.5t-18 -15.5t-31.5 -10.5t-46.5 -1q-60 -95 -144.5 -135.5t-209.5 -29.5
+q74 -61 162.5 -82.5t168.5 -6t154.5 52t128 87.5t80.5 104q43 91 39 192.5t-37.5 188.5t-78.5 125q87 -38 137 -79.5t77 -112.5q15 170 -57.5 343t-209.5 284q265 -77 412 -279.5t151 -517.5q2 -127 -40.5 -255t-123.5 -238t-189 -196t-247.5 -135.5t-288.5 -49.5z" />
+    <glyph glyph-name="_580" unicode="&#xf26a;" horiz-adv-x="1792" 
+d="M1493 1308q-165 110 -359 110q-155 0 -293 -73t-240 -200q-75 -93 -119.5 -218t-48.5 -266v-42q4 -141 48.5 -266t119.5 -218q102 -127 240 -200t293 -73q194 0 359 110q-121 -108 -274.5 -168t-322.5 -60q-29 0 -43 1q-175 8 -333 82t-272 193t-181 281t-67 339
+q0 182 71 348t191 286t286 191t348 71h3q168 -1 320.5 -60.5t273.5 -167.5zM1792 640q0 -192 -77 -362.5t-213 -296.5q-104 -63 -222 -63q-137 0 -255 84q154 56 253.5 233t99.5 405q0 227 -99 404t-253 234q119 83 254 83q119 0 226 -65q135 -125 210.5 -295t75.5 -361z
+" />
+    <glyph glyph-name="_581" unicode="&#xf26b;" horiz-adv-x="1792" 
+d="M1792 599q0 -56 -7 -104h-1151q0 -146 109.5 -244.5t257.5 -98.5q99 0 185.5 46.5t136.5 130.5h423q-56 -159 -170.5 -281t-267.5 -188.5t-321 -66.5q-187 0 -356 83q-228 -116 -394 -116q-237 0 -237 263q0 115 45 275q17 60 109 229q199 360 475 606
+q-184 -79 -427 -354q63 274 283.5 449.5t501.5 175.5q30 0 45 -1q255 117 433 117q64 0 116 -13t94.5 -40.5t66.5 -76.5t24 -115q0 -116 -75 -286q101 -182 101 -390zM1722 1239q0 83 -53 132t-137 49q-108 0 -254 -70q121 -47 222.5 -131.5t170.5 -195.5q51 135 51 216z
+M128 2q0 -86 48.5 -132.5t134.5 -46.5q115 0 266 83q-122 72 -213.5 183t-137.5 245q-98 -205 -98 -332zM632 715h728q-5 142 -113 237t-251 95q-144 0 -251.5 -95t-112.5 -237z" />
+    <glyph glyph-name="_582" unicode="&#xf26c;" horiz-adv-x="2048" 
+d="M1792 288v960q0 13 -9.5 22.5t-22.5 9.5h-1600q-13 0 -22.5 -9.5t-9.5 -22.5v-960q0 -13 9.5 -22.5t22.5 -9.5h1600q13 0 22.5 9.5t9.5 22.5zM1920 1248v-960q0 -66 -47 -113t-113 -47h-736v-128h352q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-832q-14 0 -23 9t-9 23
+v64q0 14 9 23t23 9h352v128h-736q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h1600q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="_583" unicode="&#xf26d;" horiz-adv-x="1792" 
+d="M138 1408h197q-70 -64 -126 -149q-36 -56 -59 -115t-30 -125.5t-8.5 -120t10.5 -132t21 -126t28 -136.5q4 -19 6 -28q51 -238 81 -329q57 -171 152 -275h-272q-48 0 -82 34t-34 82v1304q0 48 34 82t82 34zM1346 1408h308q48 0 82 -34t34 -82v-1304q0 -48 -34 -82t-82 -34
+h-178q212 210 196 565l-469 -101q-2 -45 -12 -82t-31 -72t-59.5 -59.5t-93.5 -36.5q-123 -26 -199 40q-32 27 -53 61t-51.5 129t-64.5 258q-35 163 -45.5 263t-5.5 139t23 77q20 41 62.5 73t102.5 45q45 12 83.5 6.5t67 -17t54 -35t43 -48t34.5 -56.5l468 100
+q-68 175 -180 287z" />
+    <glyph glyph-name="_584" unicode="&#xf26e;" 
+d="M1401 -11l-6 -6q-113 -113 -259 -175q-154 -64 -317 -64q-165 0 -317 64q-148 63 -259 175q-113 112 -175 258q-42 103 -54 189q-4 28 48 36q51 8 56 -20q1 -1 1 -4q18 -90 46 -159q50 -124 152 -226q98 -98 226 -152q132 -56 276 -56q143 0 276 56q128 55 225 152l6 6
+q10 10 25 6q12 -3 33 -22q36 -37 17 -58zM929 604l-66 -66l63 -63q21 -21 -7 -49q-17 -17 -32 -17q-10 0 -19 10l-62 61l-66 -66q-5 -5 -15 -5q-15 0 -31 16l-2 2q-18 15 -18 29q0 7 8 17l66 65l-66 66q-16 16 14 45q18 18 31 18q6 0 13 -5l65 -66l65 65q18 17 48 -13
+q27 -27 11 -44zM1400 547q0 -118 -46 -228q-45 -105 -126 -186q-80 -80 -187 -126t-228 -46t-228 46t-187 126q-82 82 -125 186q-15 33 -15 40h-1q-9 27 43 44q50 16 60 -12q37 -99 97 -167h1v339v2q3 136 102 232q105 103 253 103q147 0 251 -103t104 -249
+q0 -147 -104.5 -251t-250.5 -104q-58 0 -112 16q-28 11 -13 61q16 51 44 43l14 -3q14 -3 33 -6t30 -3q104 0 176 71.5t72 174.5q0 101 -72 171q-71 71 -175 71q-107 0 -178 -80q-64 -72 -64 -160v-413q110 -67 242 -67q96 0 185 36.5t156 103.5t103.5 155t36.5 183
+q0 198 -141 339q-140 140 -339 140q-200 0 -340 -140q-53 -53 -77 -87l-2 -2q-8 -11 -13 -15.5t-21.5 -9.5t-38.5 3q-21 5 -36.5 16.5t-15.5 26.5v680q0 15 10.5 26.5t27.5 11.5h877q30 0 30 -55t-30 -55h-811v-483h1q40 42 102 84t108 61q109 46 231 46q121 0 228 -46
+t187 -126q81 -81 126 -186q46 -112 46 -229zM1369 1128q9 -8 9 -18t-5.5 -18t-16.5 -21q-26 -26 -39 -26q-9 0 -16 7q-106 91 -207 133q-128 56 -276 56q-133 0 -262 -49q-27 -10 -45 37q-9 25 -8 38q3 16 16 20q130 57 299 57q164 0 316 -64q137 -58 235 -152z" />
+    <glyph glyph-name="_585" unicode="&#xf270;" horiz-adv-x="1792" 
+d="M1551 60q15 6 26 3t11 -17.5t-15 -33.5q-13 -16 -44 -43.5t-95.5 -68t-141 -74t-188 -58t-229.5 -24.5q-119 0 -238 31t-209 76.5t-172.5 104t-132.5 105t-84 87.5q-8 9 -10 16.5t1 12t8 7t11.5 2t11.5 -4.5q192 -117 300 -166q389 -176 799 -90q190 40 391 135z
+M1758 175q11 -16 2.5 -69.5t-28.5 -102.5q-34 -83 -85 -124q-17 -14 -26 -9t0 24q21 45 44.5 121.5t6.5 98.5q-5 7 -15.5 11.5t-27 6t-29.5 2.5t-35 0t-31.5 -2t-31 -3t-22.5 -2q-6 -1 -13 -1.5t-11 -1t-8.5 -1t-7 -0.5h-5.5h-4.5t-3 0.5t-2 1.5l-1.5 3q-6 16 47 40t103 30
+q46 7 108 1t76 -24zM1364 618q0 -31 13.5 -64t32 -58t37.5 -46t33 -32l13 -11l-227 -224q-40 37 -79 75.5t-58 58.5l-19 20q-11 11 -25 33q-38 -59 -97.5 -102.5t-127.5 -63.5t-140 -23t-137.5 21t-117.5 65.5t-83 113t-31 162.5q0 84 28 154t72 116.5t106.5 83t122.5 57
+t130 34.5t119.5 18.5t99.5 6.5v127q0 65 -21 97q-34 53 -121 53q-6 0 -16.5 -1t-40.5 -12t-56 -29.5t-56 -59.5t-48 -96l-294 27q0 60 22 119t67 113t108 95t151.5 65.5t190.5 24.5q100 0 181 -25t129.5 -61.5t81 -83t45 -86t12.5 -73.5v-589zM692 597q0 -86 70 -133
+q66 -44 139 -22q84 25 114 123q14 45 14 101v162q-59 -2 -111 -12t-106.5 -33.5t-87 -71t-32.5 -114.5z" />
+    <glyph glyph-name="_586" unicode="&#xf271;" horiz-adv-x="1792" 
+d="M1536 1280q52 0 90 -38t38 -90v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128zM1152 1376v-288q0 -14 9 -23t23 -9
+h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM384 1376v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23zM1536 -128v1024h-1408v-1024h1408zM896 448h224q14 0 23 -9t9 -23v-64q0 -14 -9 -23t-23 -9h-224
+v-224q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v224h-224q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h224v224q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-224z" />
+    <glyph glyph-name="_587" unicode="&#xf272;" horiz-adv-x="1792" 
+d="M1152 416v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23
+t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47
+t47 -113v-96h128q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_588" unicode="&#xf273;" horiz-adv-x="1792" 
+d="M1111 151l-46 -46q-9 -9 -22 -9t-23 9l-188 189l-188 -189q-10 -9 -23 -9t-22 9l-46 46q-9 9 -9 22t9 23l189 188l-189 188q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l188 -188l188 188q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23l-188 -188l188 -188q9 -10 9 -23t-9 -22z
+M128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280
+q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_589" unicode="&#xf274;" horiz-adv-x="1792" 
+d="M1303 572l-512 -512q-10 -9 -23 -9t-23 9l-288 288q-9 10 -9 23t9 22l46 46q9 9 22 9t23 -9l220 -220l444 444q10 9 23 9t22 -9l46 -46q9 -9 9 -22t-9 -23zM128 -128h1408v1024h-1408v-1024zM512 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23
+t23 -9h64q14 0 23 9t9 23zM1280 1088v288q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-288q0 -14 9 -23t23 -9h64q14 0 23 9t9 23zM1664 1152v-1280q0 -52 -38 -90t-90 -38h-1408q-52 0 -90 38t-38 90v1280q0 52 38 90t90 38h128v96q0 66 47 113t113 47h64q66 0 113 -47
+t47 -113v-96h384v96q0 66 47 113t113 47h64q66 0 113 -47t47 -113v-96h128q52 0 90 -38t38 -90z" />
+    <glyph glyph-name="_590" unicode="&#xf275;" horiz-adv-x="1792" 
+d="M448 1536q26 0 45 -19t19 -45v-891l536 429q17 14 40 14q26 0 45 -19t19 -45v-379l536 429q17 14 40 14q26 0 45 -19t19 -45v-1152q0 -26 -19 -45t-45 -19h-1664q-26 0 -45 19t-19 45v1664q0 26 19 45t45 19h384z" />
+    <glyph glyph-name="_591" unicode="&#xf276;" horiz-adv-x="1024" 
+d="M512 448q66 0 128 15v-655q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v655q62 -15 128 -15zM512 1536q212 0 362 -150t150 -362t-150 -362t-362 -150t-362 150t-150 362t150 362t362 150zM512 1312q14 0 23 9t9 23t-9 23t-23 9q-146 0 -249 -103t-103 -249
+q0 -14 9 -23t23 -9t23 9t9 23q0 119 84.5 203.5t203.5 84.5z" />
+    <glyph glyph-name="_592" unicode="&#xf277;" horiz-adv-x="1792" 
+d="M1745 1239q10 -10 10 -23t-10 -23l-141 -141q-28 -28 -68 -28h-1344q-26 0 -45 19t-19 45v256q0 26 19 45t45 19h576v64q0 26 19 45t45 19h128q26 0 45 -19t19 -45v-64h512q40 0 68 -28zM768 320h256v-512q0 -26 -19 -45t-45 -19h-128q-26 0 -45 19t-19 45v512zM1600 768
+q26 0 45 -19t19 -45v-256q0 -26 -19 -45t-45 -19h-1344q-40 0 -68 28l-141 141q-10 10 -10 23t10 23l141 141q28 28 68 28h512v192h256v-192h576z" />
+    <glyph glyph-name="_593" unicode="&#xf278;" horiz-adv-x="2048" 
+d="M2020 1525q28 -20 28 -53v-1408q0 -20 -11 -36t-29 -23l-640 -256q-24 -11 -48 0l-616 246l-616 -246q-10 -5 -24 -5q-19 0 -36 11q-28 20 -28 53v1408q0 20 11 36t29 23l640 256q24 11 48 0l616 -246l616 246q32 13 60 -6zM736 1390v-1270l576 -230v1270zM128 1173
+v-1270l544 217v1270zM1920 107v1270l-544 -217v-1270z" />
+    <glyph glyph-name="_594" unicode="&#xf279;" horiz-adv-x="1792" 
+d="M512 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472q0 20 17 28l480 256q7 4 15 4zM1760 1536q13 0 22.5 -9.5t9.5 -22.5v-1472q0 -20 -17 -28l-480 -256q-7 -4 -15 -4q-13 0 -22.5 9.5t-9.5 22.5v1472
+q0 20 17 28l480 256q7 4 15 4zM640 1536q8 0 14 -3l512 -256q18 -10 18 -29v-1472q0 -13 -9.5 -22.5t-22.5 -9.5q-8 0 -14 3l-512 256q-18 10 -18 29v1472q0 13 9.5 22.5t22.5 9.5z" />
+    <glyph glyph-name="_595" unicode="&#xf27a;" horiz-adv-x="1792" 
+d="M640 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1024 640q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1408 640q0 53 -37.5 90.5t-90.5 37.5
+t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-110 0 -211 18q-173 -173 -435 -229q-52 -10 -86 -13q-12 -1 -22 6t-13 18q-4 15 20 37q5 5 23.5 21.5t25.5 23.5t23.5 25.5t24 31.5t20.5 37
+t20 48t14.5 57.5t12.5 72.5q-146 90 -229.5 216.5t-83.5 269.5q0 174 120 321.5t326 233t450 85.5t450 -85.5t326 -233t120 -321.5z" />
+    <glyph glyph-name="_596" unicode="&#xf27b;" horiz-adv-x="1792" 
+d="M640 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1024 640q0 -53 -37.5 -90.5t-90.5 -37.5t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM1408 640q0 -53 -37.5 -90.5t-90.5 -37.5
+t-90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5t90.5 -37.5t37.5 -90.5zM896 1152q-204 0 -381.5 -69.5t-282 -187.5t-104.5 -255q0 -112 71.5 -213.5t201.5 -175.5l87 -50l-27 -96q-24 -91 -70 -172q152 63 275 171l43 38l57 -6q69 -8 130 -8q204 0 381.5 69.5t282 187.5
+t104.5 255t-104.5 255t-282 187.5t-381.5 69.5zM1792 640q0 -174 -120 -321.5t-326 -233t-450 -85.5q-70 0 -145 8q-198 -175 -460 -242q-49 -14 -114 -22h-5q-15 0 -27 10.5t-16 27.5v1q-3 4 -0.5 12t2 10t4.5 9.5l6 9t7 8.5t8 9q7 8 31 34.5t34.5 38t31 39.5t32.5 51
+t27 59t26 76q-157 89 -247.5 220t-90.5 281q0 130 71 248.5t191 204.5t286 136.5t348 50.5t348 -50.5t286 -136.5t191 -204.5t71 -248.5z" />
+    <glyph glyph-name="_597" unicode="&#xf27c;" horiz-adv-x="1024" 
+d="M512 345l512 295v-591l-512 -296v592zM0 640v-591l512 296zM512 1527v-591l-512 -296v591zM512 936l512 295v-591z" />
+    <glyph glyph-name="_598" unicode="&#xf27d;" horiz-adv-x="1792" 
+d="M1709 1018q-10 -236 -332 -651q-333 -431 -562 -431q-142 0 -240 263q-44 160 -132 482q-72 262 -157 262q-18 0 -127 -76l-77 98q24 21 108 96.5t130 115.5q156 138 241 146q95 9 153 -55.5t81 -203.5q44 -287 66 -373q55 -249 120 -249q51 0 154 161q101 161 109 246
+q13 139 -109 139q-57 0 -121 -26q120 393 459 382q251 -8 236 -326z" />
+    <glyph glyph-name="f27e" unicode="&#xf27e;" 
+d="M0 1408h1536v-1536h-1536v1536zM1085 293l-221 631l221 297h-634l221 -297l-221 -631l317 -304z" />
+    <glyph glyph-name="uniF280" unicode="&#xf280;" 
+d="M0 1408h1536v-1536h-1536v1536zM908 1088l-12 -33l75 -83l-31 -114l25 -25l107 57l107 -57l25 25l-31 114l75 83l-12 33h-95l-53 96h-32l-53 -96h-95zM641 925q32 0 44.5 -16t11.5 -63l174 21q0 55 -17.5 92.5t-50.5 56t-69 25.5t-85 7q-133 0 -199 -57.5t-66 -182.5v-72
+h-96v-128h76q20 0 20 -8v-382q0 -14 -5 -20t-18 -7l-73 -7v-88h448v86l-149 14q-6 1 -8.5 1.5t-3.5 2.5t-0.5 4t1 7t0.5 10v387h191l38 128h-231q-6 0 -2 6t4 9v80q0 27 1.5 40.5t7.5 28t19.5 20t36.5 5.5zM1248 96v86l-54 9q-7 1 -9.5 2.5t-2.5 3t1 7.5t1 12v520h-275
+l-23 -101l83 -22q23 -7 23 -27v-370q0 -14 -6 -18.5t-20 -6.5l-70 -9v-86h352z" />
+    <glyph glyph-name="uniF281" unicode="&#xf281;" horiz-adv-x="1792" 
+d="M1792 690q0 -58 -29.5 -105.5t-79.5 -72.5q12 -46 12 -96q0 -155 -106.5 -287t-290.5 -208.5t-400 -76.5t-399.5 76.5t-290 208.5t-106.5 287q0 47 11 94q-51 25 -82 73.5t-31 106.5q0 82 58 140.5t141 58.5q85 0 145 -63q218 152 515 162l116 521q3 13 15 21t26 5
+l369 -81q18 37 54 59.5t79 22.5q62 0 106 -43.5t44 -105.5t-44 -106t-106 -44t-105.5 43.5t-43.5 105.5l-334 74l-104 -472q300 -9 519 -160q58 61 143 61q83 0 141 -58.5t58 -140.5zM418 491q0 -62 43.5 -106t105.5 -44t106 44t44 106t-44 105.5t-106 43.5q-61 0 -105 -44
+t-44 -105zM1228 136q11 11 11 26t-11 26q-10 10 -25 10t-26 -10q-41 -42 -121 -62t-160 -20t-160 20t-121 62q-11 10 -26 10t-25 -10q-11 -10 -11 -25.5t11 -26.5q43 -43 118.5 -68t122.5 -29.5t91 -4.5t91 4.5t122.5 29.5t118.5 68zM1225 341q62 0 105.5 44t43.5 106
+q0 61 -44 105t-105 44q-62 0 -106 -43.5t-44 -105.5t44 -106t106 -44z" />
+    <glyph glyph-name="_602" unicode="&#xf282;" horiz-adv-x="1792" 
+d="M69 741h1q16 126 58.5 241.5t115 217t167.5 176t223.5 117.5t276.5 43q231 0 414 -105.5t294 -303.5q104 -187 104 -442v-188h-1125q1 -111 53.5 -192.5t136.5 -122.5t189.5 -57t213 -3t208 46.5t173.5 84.5v-377q-92 -55 -229.5 -92t-312.5 -38t-316 53
+q-189 73 -311.5 249t-124.5 372q-3 242 111 412t325 268q-48 -60 -78 -125.5t-46 -159.5h635q8 77 -8 140t-47 101.5t-70.5 66.5t-80.5 41t-75 20.5t-56 8.5l-22 1q-135 -5 -259.5 -44.5t-223.5 -104.5t-176 -140.5t-138 -163.5z" />
+    <glyph glyph-name="_603" unicode="&#xf283;" horiz-adv-x="2304" 
+d="M0 32v608h2304v-608q0 -66 -47 -113t-113 -47h-1984q-66 0 -113 47t-47 113zM640 256v-128h384v128h-384zM256 256v-128h256v128h-256zM2144 1408q66 0 113 -47t47 -113v-224h-2304v224q0 66 47 113t113 47h1984z" />
+    <glyph glyph-name="_604" unicode="&#xf284;" horiz-adv-x="1792" 
+d="M1584 246l-218 111q-74 -120 -196.5 -189t-263.5 -69q-147 0 -271 72t-196 196t-72 270q0 110 42.5 209.5t115 172t172 115t209.5 42.5q131 0 247.5 -60.5t192.5 -168.5l215 125q-110 169 -286.5 265t-378.5 96q-161 0 -308 -63t-253 -169t-169 -253t-63 -308t63 -308
+t169 -253t253 -169t308 -63q213 0 397.5 107t290.5 292zM1030 643l693 -352q-116 -253 -334.5 -400t-492.5 -147q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71q260 0 470.5 -133.5t335.5 -366.5zM1543 640h-39v-160h-96v352h136q32 0 54.5 -20
+t28.5 -48t1 -56t-27.5 -48t-57.5 -20z" />
+    <glyph glyph-name="uniF285" unicode="&#xf285;" horiz-adv-x="1792" 
+d="M1427 827l-614 386l92 151h855zM405 562l-184 116v858l1183 -743zM1424 697l147 -95v-858l-532 335zM1387 718l-500 -802h-855l356 571z" />
+    <glyph glyph-name="uniF286" unicode="&#xf286;" horiz-adv-x="1792" 
+d="M640 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1152 528v224q0 16 -16 16h-96q-16 0 -16 -16v-224q0 -16 16 -16h96q16 0 16 16zM1664 496v-752h-640v320q0 80 -56 136t-136 56t-136 -56t-56 -136v-320h-640v752q0 16 16 16h96
+q16 0 16 -16v-112h128v624q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 6 2.5 9.5t8.5 5t9.5 2t11.5 0t9 -0.5v391q-32 15 -32 50q0 23 16.5 39t38.5 16t38.5 -16t16.5 -39q0 -35 -32 -50v-17q45 10 83 10q21 0 59.5 -7.5t54.5 -7.5
+q17 0 47 7.5t37 7.5q16 0 16 -16v-210q0 -15 -35 -21.5t-62 -6.5q-18 0 -54.5 7.5t-55.5 7.5q-40 0 -90 -12v-133q1 0 9 0.5t11.5 0t9.5 -2t8.5 -5t2.5 -9.5v-112h128v112q0 16 16 16h96q16 0 16 -16v-112h128v112q0 16 16 16h96q16 0 16 -16v-624h128v112q0 16 16 16h96
+q16 0 16 -16z" />
+    <glyph glyph-name="_607" unicode="&#xf287;" horiz-adv-x="2304" 
+d="M2288 731q16 -8 16 -27t-16 -27l-320 -192q-8 -5 -16 -5q-9 0 -16 4q-16 10 -16 28v128h-858q37 -58 83 -165q16 -37 24.5 -55t24 -49t27 -47t27 -34t31.5 -26t33 -8h96v96q0 14 9 23t23 9h320q14 0 23 -9t9 -23v-320q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v96h-96
+q-32 0 -61 10t-51 23.5t-45 40.5t-37 46t-33.5 57t-28.5 57.5t-28 60.5q-23 53 -37 81.5t-36 65t-44.5 53.5t-46.5 17h-360q-22 -84 -91 -138t-157 -54q-106 0 -181 75t-75 181t75 181t181 75q88 0 157 -54t91 -138h104q24 0 46.5 17t44.5 53.5t36 65t37 81.5q19 41 28 60.5
+t28.5 57.5t33.5 57t37 46t45 40.5t51 23.5t61 10h107q21 57 70 92.5t111 35.5q80 0 136 -56t56 -136t-56 -136t-136 -56q-62 0 -111 35.5t-70 92.5h-107q-17 0 -33 -8t-31.5 -26t-27 -34t-27 -47t-24 -49t-24.5 -55q-46 -107 -83 -165h1114v128q0 18 16 28t32 -1z" />
+    <glyph glyph-name="_608" unicode="&#xf288;" horiz-adv-x="1792" 
+d="M1150 774q0 -56 -39.5 -95t-95.5 -39h-253v269h253q56 0 95.5 -39.5t39.5 -95.5zM1329 774q0 130 -91.5 222t-222.5 92h-433v-896h180v269h253q130 0 222 91.5t92 221.5zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348
+t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="_609" unicode="&#xf289;" horiz-adv-x="2304" 
+d="M1645 438q0 59 -34 106.5t-87 68.5q-7 -45 -23 -92q-7 -24 -27.5 -38t-44.5 -14q-12 0 -24 3q-31 10 -45 38.5t-4 58.5q23 71 23 143q0 123 -61 227.5t-166 165.5t-228 61q-134 0 -247 -73t-167 -194q108 -28 188 -106q22 -23 22 -55t-22 -54t-54 -22t-55 22
+q-75 75 -180 75q-106 0 -181 -74.5t-75 -180.5t75 -180.5t181 -74.5h1046q79 0 134.5 55.5t55.5 133.5zM1798 438q0 -142 -100.5 -242t-242.5 -100h-1046q-169 0 -289 119.5t-120 288.5q0 153 100 267t249 136q62 184 221 298t354 114q235 0 408.5 -158.5t196.5 -389.5
+q116 -25 192.5 -118.5t76.5 -214.5zM2048 438q0 -175 -97 -319q-23 -33 -64 -33q-24 0 -43 13q-26 17 -32 48.5t12 57.5q71 104 71 233t-71 233q-18 26 -12 57t32 49t57.5 11.5t49.5 -32.5q97 -142 97 -318zM2304 438q0 -244 -134 -443q-23 -34 -64 -34q-23 0 -42 13
+q-26 18 -32.5 49t11.5 57q108 164 108 358q0 195 -108 357q-18 26 -11.5 57.5t32.5 48.5q26 18 57 12t49 -33q134 -198 134 -442z" />
+    <glyph glyph-name="_610" unicode="&#xf28a;" 
+d="M1500 -13q0 -89 -63 -152.5t-153 -63.5t-153.5 63.5t-63.5 152.5q0 90 63.5 153.5t153.5 63.5t153 -63.5t63 -153.5zM1267 268q-115 -15 -192.5 -102.5t-77.5 -205.5q0 -74 33 -138q-146 -78 -379 -78q-109 0 -201 21t-153.5 54.5t-110.5 76.5t-76 85t-44.5 83
+t-23.5 66.5t-6 39.5q0 19 4.5 42.5t18.5 56t36.5 58t64 43.5t94.5 18t94 -17.5t63 -41t35.5 -53t17.5 -49t4 -33.5q0 -34 -23 -81q28 -27 82 -42t93 -17l40 -1q115 0 190 51t75 133q0 26 -9 48.5t-31.5 44.5t-49.5 41t-74 44t-93.5 47.5t-119.5 56.5q-28 13 -43 20
+q-116 55 -187 100t-122.5 102t-72 125.5t-20.5 162.5q0 78 20.5 150t66 137.5t112.5 114t166.5 77t221.5 28.5q120 0 220 -26t164.5 -67t109.5 -94t64 -105.5t19 -103.5q0 -46 -15 -82.5t-36.5 -58t-48.5 -36t-49 -19.5t-39 -5h-8h-32t-39 5t-44 14t-41 28t-37 46t-24 70.5
+t-10 97.5q-15 16 -59 25.5t-81 10.5l-37 1q-68 0 -117.5 -31t-70.5 -70t-21 -76q0 -24 5 -43t24 -46t53 -51t97 -53.5t150 -58.5q76 -25 138.5 -53.5t109 -55.5t83 -59t60.5 -59.5t41 -62.5t26.5 -62t14.5 -63.5t6 -62t1 -62.5z" />
+    <glyph glyph-name="_611" unicode="&#xf28b;" 
+d="M704 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1152 352v576q0 14 -9 23t-23 9h-256q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h256q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103
+t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_612" unicode="&#xf28c;" 
+d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273
+t73 -273t198 -198t273 -73zM864 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h192q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-192z" />
+    <glyph glyph-name="_613" unicode="&#xf28d;" 
+d="M1088 352v576q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-576q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
+t103 -385.5z" />
+    <glyph glyph-name="_614" unicode="&#xf28e;" 
+d="M768 1408q209 0 385.5 -103t279.5 -279.5t103 -385.5t-103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103zM768 96q148 0 273 73t198 198t73 273t-73 273t-198 198t-273 73t-273 -73t-198 -198t-73 -273
+t73 -273t198 -198t273 -73zM480 320q-14 0 -23 9t-9 23v576q0 14 9 23t23 9h576q14 0 23 -9t9 -23v-576q0 -14 -9 -23t-23 -9h-576z" />
+    <glyph glyph-name="_615" unicode="&#xf290;" horiz-adv-x="1792" 
+d="M1757 128l35 -313q3 -28 -16 -50q-19 -21 -48 -21h-1664q-29 0 -48 21q-19 22 -16 50l35 313h1722zM1664 967l86 -775h-1708l86 775q3 24 21 40.5t43 16.5h256v-128q0 -53 37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5v128h384v-128q0 -53 37.5 -90.5t90.5 -37.5
+t90.5 37.5t37.5 90.5v128h256q25 0 43 -16.5t21 -40.5zM1280 1152v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 106 -75 181t-181 75t-181 -75t-75 -181v-256q0 -26 -19 -45t-45 -19t-45 19t-19 45v256q0 159 112.5 271.5t271.5 112.5t271.5 -112.5t112.5 -271.5z" />
+    <glyph glyph-name="_616" unicode="&#xf291;" horiz-adv-x="2048" 
+d="M1920 768q53 0 90.5 -37.5t37.5 -90.5t-37.5 -90.5t-90.5 -37.5h-15l-115 -662q-8 -46 -44 -76t-82 -30h-1280q-46 0 -82 30t-44 76l-115 662h-15q-53 0 -90.5 37.5t-37.5 90.5t37.5 90.5t90.5 37.5h1792zM485 -32q26 2 43.5 22.5t15.5 46.5l-32 416q-2 26 -22.5 43.5
+t-46.5 15.5t-43.5 -22.5t-15.5 -46.5l32 -416q2 -25 20.5 -42t43.5 -17h5zM896 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1280 32v416q0 26 -19 45t-45 19t-45 -19t-19 -45v-416q0 -26 19 -45t45 -19t45 19t19 45zM1632 27l32 416
+q2 26 -15.5 46.5t-43.5 22.5t-46.5 -15.5t-22.5 -43.5l-32 -416q-2 -26 15.5 -46.5t43.5 -22.5h5q25 0 43.5 17t20.5 42zM476 1244l-93 -412h-132l101 441q19 88 89 143.5t160 55.5h167q0 26 19 45t45 19h384q26 0 45 -19t19 -45h167q90 0 160 -55.5t89 -143.5l101 -441
+h-132l-93 412q-11 44 -45.5 72t-79.5 28h-167q0 -26 -19 -45t-45 -19h-384q-26 0 -45 19t-19 45h-167q-45 0 -79.5 -28t-45.5 -72z" />
+    <glyph glyph-name="_617" unicode="&#xf292;" horiz-adv-x="1792" 
+d="M991 512l64 256h-254l-64 -256h254zM1759 1016l-56 -224q-7 -24 -31 -24h-327l-64 -256h311q15 0 25 -12q10 -14 6 -28l-56 -224q-5 -24 -31 -24h-327l-81 -328q-7 -24 -31 -24h-224q-16 0 -26 12q-9 12 -6 28l78 312h-254l-81 -328q-7 -24 -31 -24h-225q-15 0 -25 12
+q-9 12 -6 28l78 312h-311q-15 0 -25 12q-9 12 -6 28l56 224q7 24 31 24h327l64 256h-311q-15 0 -25 12q-10 14 -6 28l56 224q5 24 31 24h327l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h254l81 328q7 24 32 24h224q15 0 25 -12q9 -12 6 -28l-78 -312h311
+q15 0 25 -12q9 -12 6 -28z" />
+    <glyph glyph-name="_618" unicode="&#xf293;" 
+d="M841 483l148 -148l-149 -149zM840 1094l149 -149l-148 -148zM710 -130l464 464l-306 306l306 306l-464 464v-611l-255 255l-93 -93l320 -321l-320 -321l93 -93l255 255v-611zM1429 640q0 -209 -32 -365.5t-87.5 -257t-140.5 -162.5t-181.5 -86.5t-219.5 -24.5
+t-219.5 24.5t-181.5 86.5t-140.5 162.5t-87.5 257t-32 365.5t32 365.5t87.5 257t140.5 162.5t181.5 86.5t219.5 24.5t219.5 -24.5t181.5 -86.5t140.5 -162.5t87.5 -257t32 -365.5z" />
+    <glyph glyph-name="_619" unicode="&#xf294;" horiz-adv-x="1024" 
+d="M596 113l173 172l-173 172v-344zM596 823l173 172l-173 172v-344zM628 640l356 -356l-539 -540v711l-297 -296l-108 108l372 373l-372 373l108 108l297 -296v711l539 -540z" />
+    <glyph glyph-name="_620" unicode="&#xf295;" 
+d="M1280 256q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM512 1024q0 52 -38 90t-90 38t-90 -38t-38 -90t38 -90t90 -38t90 38t38 90zM1536 256q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5t271.5 -112.5
+t112.5 -271.5zM1440 1344q0 -20 -13 -38l-1056 -1408q-19 -26 -51 -26h-160q-26 0 -45 19t-19 45q0 20 13 38l1056 1408q19 26 51 26h160q26 0 45 -19t19 -45zM768 1024q0 -159 -112.5 -271.5t-271.5 -112.5t-271.5 112.5t-112.5 271.5t112.5 271.5t271.5 112.5
+t271.5 -112.5t112.5 -271.5z" />
+    <glyph glyph-name="_621" unicode="&#xf296;" horiz-adv-x="1792" 
+d="M104 830l792 -1015l-868 630q-18 13 -25 34.5t0 42.5l101 308v0zM566 830h660l-330 -1015v0zM368 1442l198 -612h-462l198 612q8 23 33 23t33 -23zM1688 830l101 -308q7 -21 0 -42.5t-25 -34.5l-868 -630l792 1015v0zM1688 830h-462l198 612q8 23 33 23t33 -23z" />
+    <glyph glyph-name="_622" unicode="&#xf297;" horiz-adv-x="1792" 
+d="M384 704h160v224h-160v-224zM1221 372v92q-104 -36 -243 -38q-135 -1 -259.5 46.5t-220.5 122.5l1 -96q88 -80 212 -128.5t272 -47.5q129 0 238 49zM640 704h640v224h-640v-224zM1792 736q0 -187 -99 -352q89 -102 89 -229q0 -157 -129.5 -268t-313.5 -111
+q-122 0 -225 52.5t-161 140.5q-19 -1 -57 -1t-57 1q-58 -88 -161 -140.5t-225 -52.5q-184 0 -313.5 111t-129.5 268q0 127 89 229q-99 165 -99 352q0 209 120 385.5t326.5 279.5t449.5 103t449.5 -103t326.5 -279.5t120 -385.5z" />
+    <glyph glyph-name="_623" unicode="&#xf298;" 
+d="M515 625v-128h-252v128h252zM515 880v-127h-252v127h252zM1273 369v-128h-341v128h341zM1273 625v-128h-672v128h672zM1273 880v-127h-672v127h672zM1408 20v1240q0 8 -6 14t-14 6h-32l-378 -256l-210 171l-210 -171l-378 256h-32q-8 0 -14 -6t-6 -14v-1240q0 -8 6 -14
+t14 -6h1240q8 0 14 6t6 14zM553 1130l185 150h-406zM983 1130l221 150h-406zM1536 1260v-1240q0 -62 -43 -105t-105 -43h-1240q-62 0 -105 43t-43 105v1240q0 62 43 105t105 43h1240q62 0 105 -43t43 -105z" />
+    <glyph glyph-name="_624" unicode="&#xf299;" horiz-adv-x="1792" 
+d="M896 720q-104 196 -160 278q-139 202 -347 318q-34 19 -70 36q-89 40 -94 32t34 -38l39 -31q62 -43 112.5 -93.5t94.5 -116.5t70.5 -113t70.5 -131q9 -17 13 -25q44 -84 84 -153t98 -154t115.5 -150t131 -123.5t148.5 -90.5q153 -66 154 -60q1 3 -49 37q-53 36 -81 57
+q-77 58 -179 211t-185 310zM549 177q-76 60 -132.5 125t-98 143.5t-71 154.5t-58.5 186t-52 209t-60.5 252t-76.5 289q273 0 497.5 -36t379 -92t271 -144.5t185.5 -172.5t110 -198.5t56 -199.5t12.5 -198.5t-9.5 -173t-20 -143.5t-13 -107l323 -327h-104l-281 285
+q-22 -2 -91.5 -14t-121.5 -19t-138 -6t-160.5 17t-167.5 59t-179 111z" />
+    <glyph glyph-name="_625" unicode="&#xf29a;" horiz-adv-x="1792" 
+d="M1374 879q-6 26 -28.5 39.5t-48.5 7.5q-261 -62 -401 -62t-401 62q-26 6 -48.5 -7.5t-28.5 -39.5t7.5 -48.5t39.5 -28.5q194 -46 303 -58q-2 -158 -15.5 -269t-26.5 -155.5t-41 -115.5l-9 -21q-10 -25 1 -49t36 -34q9 -4 23 -4q44 0 60 41l8 20q54 139 71 259h42
+q17 -120 71 -259l8 -20q16 -41 60 -41q14 0 23 4q25 10 36 34t1 49l-9 21q-28 71 -41 115.5t-26.5 155.5t-15.5 269q109 12 303 58q26 6 39.5 28.5t7.5 48.5zM1024 1024q0 53 -37.5 90.5t-90.5 37.5t-90.5 -37.5t-37.5 -90.5t37.5 -90.5t90.5 -37.5t90.5 37.5t37.5 90.5z
+M1600 640q0 -143 -55.5 -273.5t-150 -225t-225 -150t-273.5 -55.5t-273.5 55.5t-225 150t-150 225t-55.5 273.5t55.5 273.5t150 225t225 150t273.5 55.5t273.5 -55.5t225 -150t150 -225t55.5 -273.5zM896 1408q-156 0 -298 -61t-245 -164t-164 -245t-61 -298t61 -298
+t164 -245t245 -164t298 -61t298 61t245 164t164 245t61 298t-61 298t-164 245t-245 164t-298 61zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="_626" unicode="&#xf29b;" 
+d="M1438 723q34 -35 29 -82l-44 -551q-4 -42 -34.5 -70t-71.5 -28q-6 0 -9 1q-44 3 -72.5 36.5t-25.5 77.5l35 429l-143 -8q55 -113 55 -240q0 -216 -148 -372l-137 137q91 101 91 235q0 145 -102.5 248t-247.5 103q-134 0 -236 -92l-137 138q120 114 284 141l264 300
+l-149 87l-181 -161q-33 -30 -77 -27.5t-73 35.5t-26.5 77t34.5 73l239 213q26 23 60 26.5t64 -14.5l488 -283q36 -21 48 -68q17 -67 -26 -117l-205 -232l371 20q49 3 83 -32zM1240 1180q-74 0 -126 52t-52 126t52 126t126 52t126.5 -52t52.5 -126t-52.5 -126t-126.5 -52z
+M613 -62q106 0 196 61l139 -139q-146 -116 -335 -116q-148 0 -273.5 73t-198.5 198t-73 273q0 188 116 336l139 -139q-60 -88 -60 -197q0 -145 102.5 -247.5t247.5 -102.5z" />
+    <glyph glyph-name="_627" unicode="&#xf29c;" 
+d="M880 336v-160q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v160q0 14 9 23t23 9h160q14 0 23 -9t9 -23zM1136 832q0 -50 -15 -90t-45.5 -69t-52 -44t-59.5 -36q-32 -18 -46.5 -28t-26 -24t-11.5 -29v-32q0 -14 -9 -23t-23 -9h-160q-14 0 -23 9t-9 23v68q0 35 10.5 64.5
+t24 47.5t39 35.5t41 25.5t44.5 21q53 25 75 43t22 49q0 42 -43.5 71.5t-95.5 29.5q-56 0 -95 -27q-29 -20 -80 -83q-9 -12 -25 -12q-11 0 -19 6l-108 82q-10 7 -12 20t5 23q122 192 349 192q129 0 238.5 -89.5t109.5 -214.5zM768 1280q-130 0 -248.5 -51t-204 -136.5
+t-136.5 -204t-51 -248.5t51 -248.5t136.5 -204t204 -136.5t248.5 -51t248.5 51t204 136.5t136.5 204t51 248.5t-51 248.5t-136.5 204t-204 136.5t-248.5 51zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5
+t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="_628" unicode="&#xf29d;" horiz-adv-x="1408" 
+d="M366 1225q-64 0 -110 45.5t-46 110.5q0 64 46 109.5t110 45.5t109.5 -45.5t45.5 -109.5q0 -65 -45.5 -110.5t-109.5 -45.5zM917 583q0 -50 -30 -67.5t-63.5 -6.5t-47.5 34l-367 438q-7 12 -14 15.5t-11 1.5l-3 -3q-7 -8 4 -21l122 -139l1 -354l-161 -457
+q-67 -192 -92 -234q-15 -26 -28 -32q-50 -26 -103 -1q-29 13 -41.5 43t-9.5 57q2 17 197 618l5 416l-85 -164l35 -222q4 -24 -1 -42t-14 -27.5t-19 -16t-17 -7.5l-7 -2q-19 -3 -34.5 3t-24 16t-14 22t-7.5 19.5t-2 9.5l-46 299l211 381q23 34 113 34q75 0 107 -40l424 -521
+q7 -5 14 -17l3 -3l-1 -1q7 -13 7 -29zM514 433q43 -113 88.5 -225t69.5 -168l24 -55q36 -93 42 -125q11 -70 -36 -97q-35 -22 -66 -16t-51 22t-29 35h-1q-6 16 -8 25l-124 351zM1338 -159q31 -49 31 -57q0 -5 -3 -7q-9 -5 -14.5 0.5t-15.5 26t-16 30.5q-114 172 -423 661
+q3 -1 7 1t7 4l3 2q11 9 11 17z" />
+    <glyph glyph-name="_629" unicode="&#xf29e;" horiz-adv-x="2304" 
+d="M504 542h171l-1 265zM1530 641q0 87 -50.5 140t-146.5 53h-54v-388h52q91 0 145 57t54 138zM956 1018l1 -756q0 -14 -9.5 -24t-23.5 -10h-216q-14 0 -23.5 10t-9.5 24v62h-291l-55 -81q-10 -15 -28 -15h-267q-21 0 -30.5 18t3.5 35l556 757q9 14 27 14h332q14 0 24 -10
+t10 -24zM1783 641q0 -193 -125.5 -303t-324.5 -110h-270q-14 0 -24 10t-10 24v756q0 14 10 24t24 10h268q200 0 326 -109t126 -302zM1939 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5
+t-7.5 60t-20 91.5t-41 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2123 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-45 -108t-74 -102.5h-51q38 45 66.5 104.5t41.5 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5
+h43q41 -47 72 -107t45.5 -111.5t23 -96t10.5 -70.5zM2304 640q0 -11 -0.5 -29t-8 -71.5t-21.5 -102t-44.5 -108t-73.5 -102.5h-51q38 45 66 104.5t41 112t21 98t9 72.5l1 27q0 8 -0.5 22.5t-7.5 60t-19.5 91.5t-40.5 111.5t-66 124.5h43q41 -47 72 -107t45.5 -111.5t23 -96
+t9.5 -70.5z" />
+    <glyph glyph-name="uniF2A0" unicode="&#xf2a0;" horiz-adv-x="1408" 
+d="M617 -153q0 11 -13 58t-31 107t-20 69q-1 4 -5 26.5t-8.5 36t-13.5 21.5q-15 14 -51 14q-23 0 -70 -5.5t-71 -5.5q-34 0 -47 11q-6 5 -11 15.5t-7.5 20t-6.5 24t-5 18.5q-37 128 -37 255t37 255q1 4 5 18.5t6.5 24t7.5 20t11 15.5q13 11 47 11q24 0 71 -5.5t70 -5.5
+q36 0 51 14q9 8 13.5 21.5t8.5 36t5 26.5q2 9 20 69t31 107t13 58q0 22 -43.5 52.5t-75.5 42.5q-20 8 -45 8q-34 0 -98 -18q-57 -17 -96.5 -40.5t-71 -66t-46 -70t-45.5 -94.5q-6 -12 -9 -19q-49 -107 -68 -216t-19 -244t19 -244t68 -216q56 -122 83 -161q63 -91 179 -127
+l6 -2q64 -18 98 -18q25 0 45 8q32 12 75.5 42.5t43.5 52.5zM776 760q-26 0 -45 19t-19 45.5t19 45.5q37 37 37 90q0 52 -37 91q-19 19 -19 45t19 45t45 19t45 -19q75 -75 75 -181t-75 -181q-21 -19 -45 -19zM957 579q-27 0 -45 19q-19 19 -19 45t19 45q112 114 112 272
+t-112 272q-19 19 -19 45t19 45t45 19t45 -19q150 -150 150 -362t-150 -362q-18 -19 -45 -19zM1138 398q-27 0 -45 19q-19 19 -19 45t19 45q90 91 138.5 208t48.5 245t-48.5 245t-138.5 208q-19 19 -19 45t19 45t45 19t45 -19q109 -109 167 -249t58 -294t-58 -294t-167 -249
+q-18 -19 -45 -19z" />
+    <glyph glyph-name="uniF2A1" unicode="&#xf2a1;" horiz-adv-x="2176" 
+d="M192 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM704 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 352
+q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 352q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1472 864q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 864
+q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM1984 1376q-66 0 -113 -47t-47 -113t47 -113t113 -47t113 47t47 113t-47 113t-113 47zM384 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 192q0 -80 -56 -136
+t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM384 1216q0 -80 -56 -136t-136 -56
+t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 192q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM896 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 192q0 -80 -56 -136t-136 -56t-136 56
+t-56 136t56 136t136 56t136 -56t56 -136zM1664 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM2176 704q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136zM1664 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136
+t56 136t136 56t136 -56t56 -136zM2176 1216q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z" />
+    <glyph glyph-name="uniF2A2" unicode="&#xf2a2;" horiz-adv-x="1792" 
+d="M128 -192q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM320 0q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45zM365 365l256 -256l-90 -90l-256 256zM704 384q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45t45 19t45 -19t19 -45z
+M1411 704q0 -59 -11.5 -108.5t-37.5 -93.5t-44 -67.5t-53 -64.5q-31 -35 -45.5 -54t-33.5 -50t-26.5 -64t-7.5 -74q0 -159 -112.5 -271.5t-271.5 -112.5q-26 0 -45 19t-19 45t19 45t45 19q106 0 181 75t75 181q0 57 11.5 105.5t37 91t43.5 66.5t52 63q40 46 59.5 72
+t37.5 74.5t18 103.5q0 185 -131.5 316.5t-316.5 131.5t-316.5 -131.5t-131.5 -316.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 117 45.5 223.5t123 184t184 123t223.5 45.5t223.5 -45.5t184 -123t123 -184t45.5 -223.5zM896 576q0 -26 -19 -45t-45 -19t-45 19t-19 45t19 45
+t45 19t45 -19t19 -45zM1184 704q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 93 -65.5 158.5t-158.5 65.5q-92 0 -158 -65.5t-66 -158.5q0 -26 -19 -45t-45 -19t-45 19t-19 45q0 146 103 249t249 103t249 -103t103 -249zM1578 993q10 -25 -1 -49t-36 -34q-9 -4 -23 -4
+q-19 0 -35.5 11t-23.5 30q-68 178 -224 295q-21 16 -25 42t12 47q17 21 43 25t47 -12q183 -137 266 -351zM1788 1074q9 -25 -1.5 -49t-35.5 -34q-11 -4 -23 -4q-44 0 -60 41q-92 238 -297 393q-22 16 -25.5 42t12.5 47q16 22 42 25.5t47 -12.5q235 -175 341 -449z" />
+    <glyph glyph-name="uniF2A3" unicode="&#xf2a3;" horiz-adv-x="2304" 
+d="M1032 576q-59 2 -84 55q-17 34 -48 53.5t-68 19.5q-53 0 -90.5 -37.5t-37.5 -90.5q0 -56 36 -89l10 -8q34 -31 82 -31q37 0 68 19.5t48 53.5q25 53 84 55zM1600 704q0 56 -36 89l-10 8q-34 31 -82 31q-37 0 -68 -19.5t-48 -53.5q-25 -53 -84 -55q59 -2 84 -55
+q17 -34 48 -53.5t68 -19.5q53 0 90.5 37.5t37.5 90.5zM1174 925q-17 -35 -55 -48t-73 4q-62 31 -134 31q-51 0 -99 -17q3 0 9.5 0.5t9.5 0.5q92 0 170.5 -50t118.5 -133q17 -36 3.5 -73.5t-49.5 -54.5q-18 -9 -39 -9q21 0 39 -9q36 -17 49.5 -54.5t-3.5 -73.5
+q-40 -83 -118.5 -133t-170.5 -50h-6q-16 2 -44 4l-290 27l-239 -120q-14 -7 -29 -7q-40 0 -57 35l-160 320q-11 23 -4 47.5t29 37.5l209 119l148 267q17 155 91.5 291.5t195.5 236.5q31 25 70.5 21.5t64.5 -34.5t21.5 -70t-34.5 -65q-70 -59 -117 -128q123 84 267 101
+q40 5 71.5 -19t35.5 -64q5 -40 -19 -71.5t-64 -35.5q-84 -10 -159 -55q46 10 99 10q115 0 218 -50q36 -18 49 -55.5t-5 -73.5zM2137 1085l160 -320q11 -23 4 -47.5t-29 -37.5l-209 -119l-148 -267q-17 -155 -91.5 -291.5t-195.5 -236.5q-26 -22 -61 -22q-45 0 -74 35
+q-25 31 -21.5 70t34.5 65q70 59 117 128q-123 -84 -267 -101q-4 -1 -12 -1q-36 0 -63.5 24t-31.5 60q-5 40 19 71.5t64 35.5q84 10 159 55q-46 -10 -99 -10q-115 0 -218 50q-36 18 -49 55.5t5 73.5q17 35 55 48t73 -4q62 -31 134 -31q51 0 99 17q-3 0 -9.5 -0.5t-9.5 -0.5
+q-92 0 -170.5 50t-118.5 133q-17 36 -3.5 73.5t49.5 54.5q18 9 39 9q-21 0 -39 9q-36 17 -49.5 54.5t3.5 73.5q40 83 118.5 133t170.5 50h6h1q14 -2 42 -4l291 -27l239 120q14 7 29 7q40 0 57 -35z" />
+    <glyph glyph-name="uniF2A4" unicode="&#xf2a4;" horiz-adv-x="1792" 
+d="M1056 704q0 -26 19 -45t45 -19t45 19t19 45q0 146 -103 249t-249 103t-249 -103t-103 -249q0 -26 19 -45t45 -19t45 19t19 45q0 93 66 158.5t158 65.5t158 -65.5t66 -158.5zM835 1280q-117 0 -223.5 -45.5t-184 -123t-123 -184t-45.5 -223.5q0 -26 19 -45t45 -19t45 19
+t19 45q0 185 131.5 316.5t316.5 131.5t316.5 -131.5t131.5 -316.5q0 -55 -18 -103.5t-37.5 -74.5t-59.5 -72q-34 -39 -52 -63t-43.5 -66.5t-37 -91t-11.5 -105.5q0 -106 -75 -181t-181 -75q-26 0 -45 -19t-19 -45t19 -45t45 -19q159 0 271.5 112.5t112.5 271.5q0 41 7.5 74
+t26.5 64t33.5 50t45.5 54q35 41 53 64.5t44 67.5t37.5 93.5t11.5 108.5q0 117 -45.5 223.5t-123 184t-184 123t-223.5 45.5zM591 561l226 -226l-579 -579q-12 -12 -29 -12t-29 12l-168 168q-12 12 -12 29t12 29zM1612 1524l168 -168q12 -12 12 -29t-12 -30l-233 -233
+l-26 -25l-71 -71q-66 153 -195 258l91 91l207 207q13 12 30 12t29 -12z" />
+    <glyph glyph-name="uniF2A5" unicode="&#xf2a5;" 
+d="M866 1021q0 -27 -13 -94q-11 -50 -31.5 -150t-30.5 -150q-2 -11 -4.5 -12.5t-13.5 -2.5q-20 -2 -31 -2q-58 0 -84 49.5t-26 113.5q0 88 35 174t103 124q28 14 51 14q28 0 36.5 -16.5t8.5 -47.5zM1352 597q0 14 -39 75.5t-52 66.5q-21 8 -34 8q-91 0 -226 -77l-2 2
+q3 22 27.5 135t24.5 178q0 233 -242 233q-24 0 -68 -6q-94 -17 -168.5 -89.5t-111.5 -166.5t-37 -189q0 -146 80.5 -225t227.5 -79q25 0 25 -3t-1 -5q-4 -34 -26 -117q-14 -52 -51.5 -101t-82.5 -49q-42 0 -42 47q0 24 10.5 47.5t25 39.5t29.5 28.5t26 20t11 8.5q0 3 -7 10
+q-24 22 -58.5 36.5t-65.5 14.5q-35 0 -63.5 -34t-41 -75t-12.5 -75q0 -88 51.5 -142t138.5 -54q82 0 155 53t117.5 126t65.5 153q6 22 15.5 66.5t14.5 66.5q3 12 14 18q118 60 227 60q48 0 127 -18q1 -1 4 -1q5 0 9.5 4.5t4.5 8.5zM1536 1120v-960q0 -119 -84.5 -203.5
+t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="uniF2A6" unicode="&#xf2a6;" horiz-adv-x="1535" 
+d="M744 1231q0 24 -2 38.5t-8.5 30t-21 23t-37.5 7.5q-39 0 -78 -23q-105 -58 -159 -190.5t-54 -269.5q0 -44 8.5 -85.5t26.5 -80.5t52.5 -62.5t81.5 -23.5q4 0 18 -0.5t20 0t16 3t15 8.5t7 16q16 77 48 231.5t48 231.5q19 91 19 146zM1498 575q0 -7 -7.5 -13.5t-15.5 -6.5
+l-6 1q-22 3 -62 11t-72 12.5t-63 4.5q-167 0 -351 -93q-15 -8 -21 -27q-10 -36 -24.5 -105.5t-22.5 -100.5q-23 -91 -70 -179.5t-112.5 -164.5t-154.5 -123t-185 -47q-135 0 -214.5 83.5t-79.5 219.5q0 53 19.5 117t63 116.5t97.5 52.5q38 0 120 -33.5t83 -61.5
+q0 -1 -16.5 -12.5t-39.5 -31t-46 -44.5t-39 -61t-16 -74q0 -33 16.5 -53t48.5 -20q45 0 85 31.5t66.5 78t48 105.5t32.5 107t16 90v9q0 2 -3.5 3.5t-8.5 1.5h-10t-10 -0.5t-6 -0.5q-227 0 -352 122.5t-125 348.5q0 108 34.5 221t96 210t156 167.5t204.5 89.5q52 9 106 9
+q374 0 374 -360q0 -98 -38 -273t-43 -211l3 -3q101 57 182.5 88t167.5 31q22 0 53 -13q19 -7 80 -102.5t61 -116.5z" />
+    <glyph glyph-name="uniF2A7" unicode="&#xf2a7;" horiz-adv-x="1664" 
+d="M831 863q32 0 59 -18l222 -148q61 -40 110 -97l146 -170q40 -46 29 -106l-72 -413q-6 -32 -29.5 -53.5t-55.5 -25.5l-527 -56l-352 -32h-9q-39 0 -67.5 28t-28.5 68q0 37 27 64t65 32l260 32h-448q-41 0 -69.5 30t-26.5 71q2 39 32 65t69 26l442 1l-521 64q-41 5 -66 37
+t-19 73q6 35 34.5 57.5t65.5 22.5h10l481 -60l-351 94q-38 10 -62 41.5t-18 68.5q6 36 33 58.5t62 22.5q6 0 20 -2l448 -96l217 -37q1 0 3 -0.5t3 -0.5q23 0 30.5 23t-12.5 36l-186 125q-35 23 -42 63.5t18 73.5q27 38 76 38zM761 661l186 -125l-218 37l-5 2l-36 38
+l-238 262q-1 1 -2.5 3.5t-2.5 3.5q-24 31 -18.5 70t37.5 64q31 23 68 17.5t64 -33.5l142 -147q-2 -1 -5 -3.5t-4 -4.5q-32 -45 -23 -99t55 -85zM1648 1115l15 -266q4 -73 -11 -147l-48 -219q-12 -59 -67 -87l-106 -54q2 62 -39 109l-146 170q-53 61 -117 103l-222 148
+q-34 23 -76 23q-51 0 -88 -37l-235 312q-25 33 -18 73.5t41 63.5q33 22 71.5 14t62.5 -40l266 -352l-262 455q-21 35 -10.5 75t47.5 59q35 18 72.5 6t57.5 -46l241 -420l-136 337q-15 35 -4.5 74t44.5 56q37 19 76 6t56 -51l193 -415l101 -196q8 -15 23 -17.5t27 7.5t11 26
+l-12 224q-2 41 26 71t69 31q39 0 67 -28.5t30 -67.5z" />
+    <glyph glyph-name="uniF2A8" unicode="&#xf2a8;" horiz-adv-x="1792" 
+d="M335 180q-2 0 -6 2q-86 57 -168.5 145t-139.5 180q-21 30 -21 69q0 9 2 19t4 18t7 18t8.5 16t10.5 17t10 15t12 15.5t11 14.5q184 251 452 365q-110 198 -110 211q0 19 17 29q116 64 128 64q18 0 28 -16l124 -229q92 19 192 19q266 0 497.5 -137.5t378.5 -369.5
+q20 -31 20 -69t-20 -69q-91 -142 -218.5 -253.5t-278.5 -175.5q110 -198 110 -211q0 -20 -17 -29q-116 -64 -127 -64q-19 0 -29 16l-124 229l-64 119l-444 820l7 7q-58 -24 -99 -47q3 -5 127 -234t243 -449t119 -223q0 -7 -9 -9q-13 -3 -72 -3q-57 0 -60 7l-456 841
+q-39 -28 -82 -68q24 -43 214 -393.5t190 -354.5q0 -10 -11 -10q-14 0 -82.5 22t-72.5 28l-106 197l-224 413q-44 -53 -78 -106q2 -3 18 -25t23 -34l176 -327q0 -10 -10 -10zM1165 282l49 -91q273 111 450 385q-180 277 -459 389q67 -64 103 -148.5t36 -176.5
+q0 -106 -47 -200.5t-132 -157.5zM848 896q0 -20 14 -34t34 -14q86 0 147 -61t61 -147q0 -20 14 -34t34 -14t34 14t14 34q0 126 -89 215t-215 89q-20 0 -34 -14t-14 -34zM1214 961l-9 4l7 -7z" />
+    <glyph glyph-name="uniF2A9" unicode="&#xf2a9;" horiz-adv-x="1280" 
+d="M1050 430q0 -215 -147 -374q-148 -161 -378 -161q-232 0 -378 161q-147 159 -147 374q0 147 68 270.5t189 196.5t268 73q96 0 182 -31q-32 -62 -39 -126q-66 28 -143 28q-167 0 -280.5 -123t-113.5 -291q0 -170 112.5 -288.5t281.5 -118.5t281 118.5t112 288.5
+q0 89 -32 166q66 13 123 49q41 -98 41 -212zM846 619q0 -192 -79.5 -345t-238.5 -253l-14 -1q-29 0 -62 5q83 32 146.5 102.5t99.5 154.5t58.5 189t30 192.5t7.5 178.5q0 69 -3 103q55 -160 55 -326zM791 947v-2q-73 214 -206 440q88 -59 142.5 -186.5t63.5 -251.5z
+M1035 744q-83 0 -160 75q218 120 290 247q19 37 21 56q-42 -94 -139.5 -166.5t-204.5 -97.5q-35 54 -35 113q0 37 17 79t43 68q46 44 157 74q59 16 106 58.5t74 100.5q74 -105 74 -253q0 -109 -24 -170q-32 -77 -88.5 -130.5t-130.5 -53.5z" />
+    <glyph glyph-name="uniF2AA" unicode="&#xf2aa;" 
+d="M1050 495q0 78 -28 147q-41 -25 -85 -34q22 -50 22 -114q0 -117 -77 -198.5t-193 -81.5t-193.5 81.5t-77.5 198.5q0 115 78 199.5t193 84.5q53 0 98 -19q4 43 27 87q-60 21 -125 21q-154 0 -257.5 -108.5t-103.5 -263.5t103.5 -261t257.5 -106t257.5 106.5t103.5 260.5z
+M872 850q2 -24 2 -71q0 -63 -5 -123t-20.5 -132.5t-40.5 -130t-68.5 -106t-100.5 -70.5q21 -3 42 -3h10q219 139 219 411q0 116 -38 225zM872 850q-4 80 -44 171.5t-98 130.5q92 -156 142 -302zM1207 955q0 102 -51 174q-41 -86 -124 -109q-69 -19 -109 -53.5t-40 -99.5
+q0 -40 24 -77q74 17 140.5 67t95.5 115q-4 -52 -74.5 -111.5t-138.5 -97.5q52 -52 110 -52q51 0 90 37t60 90q17 42 17 117zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960q119 0 203.5 -84.5
+t84.5 -203.5z" />
+    <glyph glyph-name="uniF2AB" unicode="&#xf2ab;" 
+d="M1279 388q0 22 -22 27q-67 15 -118 59t-80 108q-7 19 -7 25q0 15 19.5 26t43 17t43 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-12 0 -32 -8t-31 -8q-4 0 -12 2q5 95 5 114q0 79 -17 114q-36 78 -103 121.5t-152 43.5q-199 0 -275 -165q-17 -35 -17 -114q0 -19 5 -114
+q-4 -2 -14 -2q-12 0 -32 7.5t-30 7.5q-21 0 -38.5 -12t-17.5 -32q0 -21 19.5 -35.5t43 -20.5t43 -17t19.5 -26q0 -6 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -46 137 -68q2 -5 6 -26t11.5 -30.5t23.5 -9.5q12 0 37.5 4.5t39.5 4.5q35 0 67 -15t54 -32.5t57.5 -32.5
+t76.5 -15q43 0 79 15t57.5 32.5t53.5 32.5t67 15q14 0 39.5 -4t38.5 -4q16 0 23 10t11 30t6 25q137 22 137 68zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5
+t103 -385.5z" />
+    <glyph glyph-name="uniF2AC" unicode="&#xf2ac;" horiz-adv-x="1664" 
+d="M848 1408q134 1 240.5 -68.5t163.5 -192.5q27 -58 27 -179q0 -47 -9 -191q14 -7 28 -7q18 0 51 13.5t51 13.5q29 0 56 -18t27 -46q0 -32 -31.5 -54t-69 -31.5t-69 -29t-31.5 -47.5q0 -15 12 -43q37 -82 102.5 -150t144.5 -101q28 -12 80 -23q28 -6 28 -35
+q0 -70 -219 -103q-7 -11 -11 -39t-14 -46.5t-33 -18.5q-20 0 -62 6.5t-64 6.5q-37 0 -62 -5q-32 -5 -63 -22.5t-58 -38t-58 -40.5t-76 -33.5t-99 -13.5q-52 0 -96.5 13.5t-75 33.5t-57.5 40.5t-58 38t-62 22.5q-26 5 -63 5q-24 0 -65.5 -7.5t-58.5 -7.5q-25 0 -35 18.5
+t-14 47.5t-11 40q-219 33 -219 103q0 29 28 35q52 11 80 23q78 32 144.5 101t102.5 150q12 28 12 43q0 28 -31.5 47.5t-69.5 29.5t-69.5 31.5t-31.5 52.5q0 27 26 45.5t55 18.5q15 0 48 -13t53 -13q18 0 32 7q-9 142 -9 190q0 122 27 180q64 137 172 198t264 63z" />
+    <glyph glyph-name="uniF2AD" unicode="&#xf2ad;" 
+d="M1280 388q0 22 -22 27q-67 14 -118 58t-80 109q-7 14 -7 25q0 15 19.5 26t42.5 17t42.5 20.5t19.5 36.5q0 19 -18.5 31.5t-38.5 12.5q-11 0 -31 -8t-32 -8q-4 0 -12 2q5 63 5 115q0 78 -17 114q-36 78 -102.5 121.5t-152.5 43.5q-198 0 -275 -165q-18 -38 -18 -115
+q0 -38 6 -114q-10 -2 -15 -2q-11 0 -31.5 8t-30.5 8q-20 0 -37.5 -12.5t-17.5 -32.5q0 -21 19.5 -35.5t42.5 -20.5t42.5 -17t19.5 -26q0 -11 -7 -25q-64 -138 -198 -167q-22 -5 -22 -27q0 -47 138 -69q2 -5 6 -26t11 -30.5t23 -9.5q13 0 38.5 5t38.5 5q35 0 67.5 -15
+t54.5 -32.5t57.5 -32.5t76.5 -15q43 0 79 15t57.5 32.5t54 32.5t67.5 15q13 0 39 -4.5t39 -4.5q15 0 22.5 9.5t11.5 31t5 24.5q138 22 138 69zM1536 1120v-960q0 -119 -84.5 -203.5t-203.5 -84.5h-960q-119 0 -203.5 84.5t-84.5 203.5v960q0 119 84.5 203.5t203.5 84.5h960
+q119 0 203.5 -84.5t84.5 -203.5z" />
+    <glyph glyph-name="uniF2AE" unicode="&#xf2ae;" horiz-adv-x="2304" 
+d="M2304 1536q-69 -46 -125 -92t-89 -81t-59.5 -71.5t-37.5 -57.5t-22 -44.5t-14 -29.5q-10 -18 -35.5 -136.5t-48.5 -164.5q-15 -29 -50 -60.5t-67.5 -50.5t-72.5 -41t-48 -28q-47 -31 -151 -231q-341 14 -630 -158q-92 -53 -303 -179q47 16 86 31t55 22l15 7
+q71 27 163 64.5t133.5 53.5t108 34.5t142.5 31.5q186 31 465 -7q1 0 10 -3q11 -6 14 -17t-3 -22l-194 -345q-15 -29 -47 -22q-128 24 -354 24q-146 0 -402 -44.5t-392 -46.5q-82 -1 -149 13t-107 37t-61 40t-33 34l-1 1v2q0 6 6 6q138 0 371 55q192 366 374.5 524t383.5 158
+q5 0 14.5 -0.5t38 -5t55 -12t61.5 -24.5t63 -39.5t54 -59t40 -82.5l102 177q2 4 21 42.5t44.5 86.5t61 109.5t84 133.5t100.5 137q66 82 128 141.5t121.5 96.5t92.5 53.5t88 39.5z" />
+    <glyph glyph-name="uniF2B0" unicode="&#xf2b0;" 
+d="M1322 640q0 -45 -5 -76l-236 14l224 -78q-19 -73 -58 -141l-214 103l177 -158q-44 -61 -107 -108l-157 178l103 -215q-61 -37 -140 -59l-79 228l14 -240q-38 -6 -76 -6t-76 6l14 238l-78 -226q-74 19 -140 59l103 215l-157 -178q-59 43 -108 108l178 158l-214 -104
+q-39 69 -58 141l224 79l-237 -14q-5 42 -5 76q0 35 5 77l238 -14l-225 79q19 73 58 140l214 -104l-177 159q46 61 107 108l158 -178l-103 215q67 39 140 58l77 -224l-13 236q36 6 75 6q38 0 76 -6l-14 -237l78 225q74 -19 140 -59l-103 -214l158 178q61 -47 107 -108
+l-177 -159l213 104q37 -62 58 -141l-224 -78l237 14q5 -31 5 -77zM1352 640q0 160 -78.5 295.5t-213 214t-292.5 78.5q-119 0 -227 -46.5t-186.5 -125t-124.5 -187.5t-46 -229q0 -119 46 -228t124.5 -187.5t186.5 -125t227 -46.5q158 0 292.5 78.5t213 214t78.5 294.5z
+M1425 1023v-766l-657 -383l-657 383v766l657 383zM768 -183l708 412v823l-708 411l-708 -411v-823zM1536 1088v-896l-768 -448l-768 448v896l768 448z" />
+    <glyph glyph-name="uniF2B1" unicode="&#xf2b1;" horiz-adv-x="1664" 
+d="M339 1318h691l-26 -72h-665q-110 0 -188.5 -79t-78.5 -189v-771q0 -95 60.5 -169.5t153.5 -93.5q23 -5 98 -5v-72h-45q-140 0 -239.5 100t-99.5 240v771q0 140 99.5 240t239.5 100zM1190 1536h247l-482 -1294q-23 -61 -40.5 -103.5t-45 -98t-54 -93.5t-64.5 -78.5
+t-79.5 -65t-95.5 -41t-116 -18.5v195q163 26 220 182q20 52 20 105q0 54 -20 106l-285 733h228l187 -585zM1664 978v-1111h-795q37 55 45 73h678v1038q0 85 -49.5 155t-129.5 99l25 67q101 -34 163.5 -123.5t62.5 -197.5z" />
+    <glyph glyph-name="uniF2B2" unicode="&#xf2b2;" horiz-adv-x="1792" 
+d="M852 1227q0 -29 -17 -52.5t-45 -23.5t-45 23.5t-17 52.5t17 52.5t45 23.5t45 -23.5t17 -52.5zM688 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50 -21.5t-20 -51.5v-114q0 -30 20.5 -52t49.5 -22q30 0 50.5 22t20.5 52zM860 -149v114q0 30 -20 51.5t-50 21.5t-50.5 -21.5
+t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22q29 0 49.5 22t20.5 52zM1034 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1208 -149v114q0 30 -20.5 51.5t-50.5 21.5t-50.5 -21.5t-20.5 -51.5v-114
+q0 -30 20.5 -52t50.5 -22t50.5 22t20.5 52zM1476 535q-84 -160 -232 -259.5t-323 -99.5q-123 0 -229.5 51.5t-178.5 137t-113 197.5t-41 232q0 88 21 174q-104 -175 -104 -390q0 -162 65 -312t185 -251q30 57 91 57q56 0 86 -50q32 50 87 50q56 0 86 -50q32 50 87 50t87 -50
+q30 50 86 50q28 0 52.5 -15.5t37.5 -40.5q112 94 177 231.5t73 287.5zM1326 564q0 75 -72 75q-17 0 -47 -6q-95 -19 -149 -19q-226 0 -226 243q0 86 30 204q-83 -127 -83 -275q0 -150 89 -260.5t235 -110.5q111 0 210 70q13 48 13 79zM884 1223q0 50 -32 89.5t-81 39.5
+t-81 -39.5t-32 -89.5q0 -51 31.5 -90.5t81.5 -39.5t81.5 39.5t31.5 90.5zM1513 884q0 96 -37.5 179t-113 137t-173.5 54q-77 0 -149 -35t-127 -94q-48 -159 -48 -268q0 -104 45.5 -157t147.5 -53q53 0 142 19q36 6 53 6q51 0 77.5 -28t26.5 -80q0 -26 -4 -46
+q75 68 117.5 165.5t42.5 200.5zM1792 667q0 -111 -33.5 -249.5t-93.5 -204.5q-58 -64 -195 -142.5t-228 -104.5l-4 -1v-114q0 -43 -29.5 -75t-72.5 -32q-56 0 -86 50q-32 -50 -87 -50t-87 50q-30 -50 -86 -50q-55 0 -87 50q-30 -50 -86 -50q-47 0 -75 33.5t-28 81.5
+q-90 -68 -198 -68q-118 0 -211 80q54 1 106 20q-113 31 -182 127q32 -7 71 -7q89 0 164 46q-192 192 -240 306q-24 56 -24 160q0 57 9 125.5t31.5 146.5t55 141t86.5 105t120 42q59 0 81 -52q19 29 42 54q2 3 12 13t13 16q10 15 23 38t25 42t28 39q87 111 211.5 177
+t260.5 66q35 0 62 -4q59 64 146 64q83 0 140 -57q5 -5 5 -12q0 -5 -6 -13.5t-12.5 -16t-16 -17l-10.5 -10.5q17 -6 36 -18t19 -24q0 -6 -16 -25q157 -138 197 -378q25 30 60 30q45 0 100 -49q90 -80 90 -279z" />
+    <glyph glyph-name="uniF2B3" unicode="&#xf2b3;" 
+d="M917 631q0 33 -6 64h-362v-132h217q-12 -76 -74.5 -120.5t-142.5 -44.5q-99 0 -169 71.5t-70 170.5t70 170.5t169 71.5q93 0 153 -59l104 101q-108 100 -257 100q-160 0 -272 -112.5t-112 -271.5t112 -271.5t272 -112.5q165 0 266.5 105t101.5 270zM1262 585h109v110
+h-109v110h-110v-110h-110v-110h110v-110h110v110zM1536 640q0 -209 -103 -385.5t-279.5 -279.5t-385.5 -103t-385.5 103t-279.5 279.5t-103 385.5t103 385.5t279.5 279.5t385.5 103t385.5 -103t279.5 -279.5t103 -385.5z" />
+    <glyph glyph-name="uniF2B4" unicode="&#xf2b4;" 
+d="M1536 1024v-839q0 -48 -49 -62q-174 -52 -338 -52q-73 0 -215.5 29.5t-227.5 29.5q-164 0 -370 -48v-338h-160v1368q-63 25 -101 81t-38 124q0 91 64 155t155 64t155 -64t64 -155q0 -68 -38 -124t-101 -81v-68q190 44 343 44q99 0 198 -15q14 -2 111.5 -22.5t149.5 -20.5
+q77 0 165 18q11 2 80 21t89 19q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="uniF2B5" unicode="&#xf2b5;" horiz-adv-x="2304" 
+d="M192 384q40 0 56 32t0 64t-56 32t-56 -32t0 -64t56 -32zM1665 442q-10 13 -38.5 50t-41.5 54t-38 49t-42.5 53t-40.5 47t-45 49l-125 -140q-83 -94 -208.5 -92t-205.5 98q-57 69 -56.5 158t58.5 157l177 206q-22 11 -51 16.5t-47.5 6t-56.5 -0.5t-49 -1q-92 0 -158 -66
+l-158 -158h-155v-544q5 0 21 0.5t22 0t19.5 -2t20.5 -4.5t17.5 -8.5t18.5 -13.5l297 -292q115 -111 227 -111q78 0 125 47q57 -20 112.5 8t72.5 85q74 -6 127 44q20 18 36 45.5t14 50.5q10 -10 43 -10q43 0 77 21t49.5 53t12 71.5t-30.5 73.5zM1824 384h96v512h-93l-157 180
+q-66 76 -169 76h-167q-89 0 -146 -67l-209 -243q-28 -33 -28 -75t27 -75q43 -51 110 -52t111 49l193 218q25 23 53.5 21.5t47 -27t8.5 -56.5q16 -19 56 -63t60 -68q29 -36 82.5 -105.5t64.5 -84.5q52 -66 60 -140zM2112 384q40 0 56 32t0 64t-56 32t-56 -32t0 -64t56 -32z
+M2304 960v-640q0 -26 -19 -45t-45 -19h-434q-27 -65 -82 -106.5t-125 -51.5q-33 -48 -80.5 -81.5t-102.5 -45.5q-42 -53 -104.5 -81.5t-128.5 -24.5q-60 -34 -126 -39.5t-127.5 14t-117 53.5t-103.5 81l-287 282h-358q-26 0 -45 19t-19 45v672q0 26 19 45t45 19h421
+q14 14 47 48t47.5 48t44 40t50.5 37.5t51 25.5t62 19.5t68 5.5h117q99 0 181 -56q82 56 181 56h167q35 0 67 -6t56.5 -14.5t51.5 -26.5t44.5 -31t43 -39.5t39 -42t41 -48t41.5 -48.5h355q26 0 45 -19t19 -45z" />
+    <glyph glyph-name="uniF2B6" unicode="&#xf2b6;" horiz-adv-x="1792" 
+d="M1792 882v-978q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v978q0 15 11 24q8 7 39 34.5t41.5 36t45.5 37.5t70 55.5t96 73t143.5 107t192.5 140.5q5 4 52.5 40t71.5 52.5t64 35t69 18.5t69 -18.5t65 -35.5t71 -52t52 -40q110 -80 192.5 -140.5t143.5 -107
+t96 -73t70 -55.5t45.5 -37.5t41.5 -36t39 -34.5q11 -9 11 -24zM1228 297q263 191 345 252q11 8 12.5 20.5t-6.5 23.5l-38 52q-8 11 -21 12.5t-24 -6.5q-231 -169 -343 -250q-5 -3 -52 -39t-71.5 -52.5t-64.5 -35t-69 -18.5t-69 18.5t-64.5 35t-71.5 52.5t-52 39
+q-186 134 -343 250q-11 8 -24 6.5t-21 -12.5l-38 -52q-8 -11 -6.5 -23.5t12.5 -20.5q82 -61 345 -252q10 -8 50 -38t65 -47t64 -39.5t77.5 -33.5t75.5 -11t75.5 11t79 34.5t64.5 39.5t65 47.5t48 36.5z" />
+    <glyph glyph-name="uniF2B7" unicode="&#xf2b7;" horiz-adv-x="1792" 
+d="M1474 623l39 -51q8 -11 6.5 -23.5t-11.5 -20.5q-43 -34 -126.5 -98.5t-146.5 -113t-67 -51.5q-39 -32 -60 -48t-60.5 -41t-76.5 -36.5t-74 -11.5h-1h-1q-37 0 -74 11.5t-76 36.5t-61 41.5t-60 47.5q-5 4 -65 50.5t-143.5 111t-122.5 94.5q-11 8 -12.5 20.5t6.5 23.5
+l37 52q8 11 21.5 13t24.5 -7q94 -73 306 -236q5 -4 43.5 -35t60.5 -46.5t56.5 -32.5t58.5 -17h1h1q24 0 58.5 17t56.5 32.5t60.5 46.5t43.5 35q258 198 313 242q11 8 24 6.5t21 -12.5zM1664 -96v928q-90 83 -159 139q-91 74 -389 304q-3 2 -43 35t-61 48t-56 32.5t-59 17.5
+h-1h-1q-24 0 -59 -17.5t-56 -32.5t-61 -48t-43 -35q-215 -166 -315.5 -245.5t-129.5 -104t-82 -74.5q-14 -12 -21 -19v-928q0 -13 9.5 -22.5t22.5 -9.5h1472q13 0 22.5 9.5t9.5 22.5zM1792 832v-928q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v928q0 56 41 94
+q123 114 350 290.5t233 181.5q36 30 59 47.5t61.5 42t76 36.5t74.5 12h1h1q37 0 74.5 -12t76 -36.5t61.5 -42t59 -47.5q43 -36 156 -122t226 -177t201 -173q41 -38 41 -94z" />
+    <glyph glyph-name="uniF2B8" unicode="&#xf2b8;" 
+d="M330 1l202 -214l-34 236l-216 213zM556 -225l274 218l-11 245l-300 -215zM245 413l227 -213l-48 327l-245 204zM495 189l317 214l-14 324l-352 -200zM843 178l95 -80l-2 239l-103 79q0 -1 1 -8.5t0 -12t-5 -7.5l-78 -52l85 -70q7 -6 7 -88zM138 930l256 -200l-68 465
+l-279 173zM1173 267l15 234l-230 -164l2 -240zM417 722l373 194l-19 441l-423 -163zM1270 357l20 233l-226 142l-2 -105l144 -95q6 -4 4 -9l-7 -119zM1461 496l30 222l-179 -128l-20 -228zM1273 329l-71 49l-8 -117q0 -5 -4 -8l-234 -187q-7 -5 -14 0l-98 83l7 -161
+q0 -5 -4 -8l-293 -234q-4 -2 -6 -2q-8 2 -8 3l-228 242q-4 4 -59 277q-2 7 5 11l61 37q-94 86 -95 92l-72 351q-2 7 6 12l94 45q-133 100 -135 108l-96 466q-2 10 7 13l433 135q5 0 8 -1l317 -153q6 -4 6 -9l20 -463q0 -7 -6 -10l-118 -61l126 -85q5 -2 5 -8l5 -123l121 74
+q5 4 11 0l84 -56l3 110q0 6 5 9l206 126q6 3 11 0l245 -135q4 -4 5 -7t-6.5 -60t-17.5 -124.5t-10 -70.5q0 -5 -4 -7l-191 -153q-6 -5 -13 0z" />
+    <glyph glyph-name="uniF2B9" unicode="&#xf2b9;" horiz-adv-x="1664" 
+d="M1201 298q0 57 -5.5 107t-21 100.5t-39.5 86t-64 58t-91 22.5q-6 -4 -33.5 -20.5t-42.5 -24.5t-40.5 -20t-49 -17t-46.5 -5t-46.5 5t-49 17t-40.5 20t-42.5 24.5t-33.5 20.5q-51 0 -91 -22.5t-64 -58t-39.5 -86t-21 -100.5t-5.5 -107q0 -73 42 -121.5t103 -48.5h576
+q61 0 103 48.5t42 121.5zM1028 892q0 108 -76.5 184t-183.5 76t-183.5 -76t-76.5 -184q0 -107 76.5 -183t183.5 -76t183.5 76t76.5 183zM1664 352v-192q0 -14 -9 -23t-23 -9h-96v-224q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h1216
+q66 0 113 -47t47 -113v-224h96q14 0 23 -9t9 -23v-192q0 -14 -9 -23t-23 -9h-96v-128h96q14 0 23 -9t9 -23v-192q0 -14 -9 -23t-23 -9h-96v-128h96q14 0 23 -9t9 -23z" />
+    <glyph glyph-name="uniF2BA" unicode="&#xf2ba;" horiz-adv-x="1664" 
+d="M1028 892q0 -107 -76.5 -183t-183.5 -76t-183.5 76t-76.5 183q0 108 76.5 184t183.5 76t183.5 -76t76.5 -184zM980 672q46 0 82.5 -17t60 -47.5t39.5 -67t24 -81t11.5 -82.5t3.5 -79q0 -67 -39.5 -118.5t-105.5 -51.5h-576q-66 0 -105.5 51.5t-39.5 118.5q0 48 4.5 93.5
+t18.5 98.5t36.5 91.5t63 64.5t93.5 26h5q7 -4 32 -19.5t35.5 -21t33 -17t37 -16t35 -9t39.5 -4.5t39.5 4.5t35 9t37 16t33 17t35.5 21t32 19.5zM1664 928q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-128h96q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-128h96
+q13 0 22.5 -9.5t9.5 -22.5v-192q0 -13 -9.5 -22.5t-22.5 -9.5h-96v-224q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h1216q66 0 113 -47t47 -113v-224h96q13 0 22.5 -9.5t9.5 -22.5v-192zM1408 -96v1472q0 13 -9.5 22.5t-22.5 9.5h-1216
+q-13 0 -22.5 -9.5t-9.5 -22.5v-1472q0 -13 9.5 -22.5t22.5 -9.5h1216q13 0 22.5 9.5t9.5 22.5z" />
+    <glyph glyph-name="uniF2BB" unicode="&#xf2bb;" horiz-adv-x="2048" 
+d="M1024 405q0 64 -9 117.5t-29.5 103t-60.5 78t-97 28.5q-6 -4 -30 -18t-37.5 -21.5t-35.5 -17.5t-43 -14.5t-42 -4.5t-42 4.5t-43 14.5t-35.5 17.5t-37.5 21.5t-30 18q-57 0 -97 -28.5t-60.5 -78t-29.5 -103t-9 -117.5t37 -106.5t91 -42.5h512q54 0 91 42.5t37 106.5z
+M867 925q0 94 -66.5 160.5t-160.5 66.5t-160.5 -66.5t-66.5 -160.5t66.5 -160.5t160.5 -66.5t160.5 66.5t66.5 160.5zM1792 416v64q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM1792 676v56q0 15 -10.5 25.5t-25.5 10.5h-568
+q-15 0 -25.5 -10.5t-10.5 -25.5v-56q0 -15 10.5 -25.5t25.5 -10.5h568q15 0 25.5 10.5t10.5 25.5zM1792 928v64q0 14 -9 23t-23 9h-576q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h576q14 0 23 9t9 23zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-352v96q0 14 -9 23t-23 9
+h-64q-14 0 -23 -9t-9 -23v-96h-768v96q0 14 -9 23t-23 9h-64q-14 0 -23 -9t-9 -23v-96h-352q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2BC" unicode="&#xf2bc;" horiz-adv-x="2048" 
+d="M1024 405q0 -64 -37 -106.5t-91 -42.5h-512q-54 0 -91 42.5t-37 106.5t9 117.5t29.5 103t60.5 78t97 28.5q6 -4 30 -18t37.5 -21.5t35.5 -17.5t43 -14.5t42 -4.5t42 4.5t43 14.5t35.5 17.5t37.5 21.5t30 18q57 0 97 -28.5t60.5 -78t29.5 -103t9 -117.5zM867 925
+q0 -94 -66.5 -160.5t-160.5 -66.5t-160.5 66.5t-66.5 160.5t66.5 160.5t160.5 66.5t160.5 -66.5t66.5 -160.5zM1792 480v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM1792 732v-56q0 -15 -10.5 -25.5t-25.5 -10.5h-568
+q-15 0 -25.5 10.5t-10.5 25.5v56q0 15 10.5 25.5t25.5 10.5h568q15 0 25.5 -10.5t10.5 -25.5zM1792 992v-64q0 -14 -9 -23t-23 -9h-576q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h576q14 0 23 -9t9 -23zM1920 32v1216q0 13 -9.5 22.5t-22.5 9.5h-1728q-13 0 -22.5 -9.5
+t-9.5 -22.5v-1216q0 -13 9.5 -22.5t22.5 -9.5h352v96q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-96h768v96q0 14 9 23t23 9h64q14 0 23 -9t9 -23v-96h352q13 0 22.5 9.5t9.5 22.5zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-1728q-66 0 -113 47t-47 113v1216q0 66 47 113
+t113 47h1728q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2BD" unicode="&#xf2bd;" horiz-adv-x="1792" 
+d="M1523 197q-22 155 -87.5 257.5t-184.5 118.5q-67 -74 -159.5 -115.5t-195.5 -41.5t-195.5 41.5t-159.5 115.5q-119 -16 -184.5 -118.5t-87.5 -257.5q106 -150 271 -237.5t356 -87.5t356 87.5t271 237.5zM1280 896q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5
+t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5zM1792 640q0 -182 -71 -347.5t-190.5 -286t-285.5 -191.5t-349 -71q-182 0 -348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="uniF2BE" unicode="&#xf2be;" horiz-adv-x="1792" 
+d="M896 1536q182 0 348 -71t286 -191t191 -286t71 -348q0 -181 -70.5 -347t-190.5 -286t-286 -191.5t-349 -71.5t-349 71t-285.5 191.5t-190.5 286t-71 347.5t71 348t191 286t286 191t348 71zM1515 185q149 205 149 455q0 156 -61 298t-164 245t-245 164t-298 61t-298 -61
+t-245 -164t-164 -245t-61 -298q0 -250 149 -455q66 327 306 327q131 -128 313 -128t313 128q240 0 306 -327zM1280 832q0 159 -112.5 271.5t-271.5 112.5t-271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5z" />
+    <glyph glyph-name="uniF2C0" unicode="&#xf2c0;" 
+d="M1201 752q47 -14 89.5 -38t89 -73t79.5 -115.5t55 -172t22 -236.5q0 -154 -100 -263.5t-241 -109.5h-854q-141 0 -241 109.5t-100 263.5q0 131 22 236.5t55 172t79.5 115.5t89 73t89.5 38q-79 125 -79 272q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5
+t198.5 -40.5t163.5 -109.5t109.5 -163.5t40.5 -198.5q0 -147 -79 -272zM768 1408q-159 0 -271.5 -112.5t-112.5 -271.5t112.5 -271.5t271.5 -112.5t271.5 112.5t112.5 271.5t-112.5 271.5t-271.5 112.5zM1195 -128q88 0 150.5 71.5t62.5 173.5q0 239 -78.5 377t-225.5 145
+q-145 -127 -336 -127t-336 127q-147 -7 -225.5 -145t-78.5 -377q0 -102 62.5 -173.5t150.5 -71.5h854z" />
+    <glyph glyph-name="uniF2C1" unicode="&#xf2c1;" horiz-adv-x="1280" 
+d="M1024 278q0 -64 -37 -107t-91 -43h-512q-54 0 -91 43t-37 107t9 118t29.5 104t61 78.5t96.5 28.5q80 -75 188 -75t188 75q56 0 96.5 -28.5t61 -78.5t29.5 -104t9 -118zM870 797q0 -94 -67.5 -160.5t-162.5 -66.5t-162.5 66.5t-67.5 160.5t67.5 160.5t162.5 66.5
+t162.5 -66.5t67.5 -160.5zM1152 -96v1376h-1024v-1376q0 -13 9.5 -22.5t22.5 -9.5h960q13 0 22.5 9.5t9.5 22.5zM1280 1376v-1472q0 -66 -47 -113t-113 -47h-960q-66 0 -113 47t-47 113v1472q0 66 47 113t113 47h352v-96q0 -14 9 -23t23 -9h192q14 0 23 9t9 23v96h352
+q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2C2" unicode="&#xf2c2;" horiz-adv-x="2048" 
+d="M896 324q0 54 -7.5 100.5t-24.5 90t-51 68.5t-81 25q-64 -64 -156 -64t-156 64q-47 0 -81 -25t-51 -68.5t-24.5 -90t-7.5 -100.5q0 -55 31.5 -93.5t75.5 -38.5h426q44 0 75.5 38.5t31.5 93.5zM768 768q0 80 -56 136t-136 56t-136 -56t-56 -136t56 -136t136 -56t136 56
+t56 136zM1792 288v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM1408 544v64q0 14 -9 23t-23 9h-320q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h320q14 0 23 9t9 23zM1792 544v64q0 14 -9 23t-23 9h-192q-14 0 -23 -9t-9 -23
+v-64q0 -14 9 -23t23 -9h192q14 0 23 9t9 23zM1792 800v64q0 14 -9 23t-23 9h-704q-14 0 -23 -9t-9 -23v-64q0 -14 9 -23t23 -9h704q14 0 23 9t9 23zM128 1152h1792v96q0 14 -9 23t-23 9h-1728q-14 0 -23 -9t-9 -23v-96zM2048 1248v-1216q0 -66 -47 -113t-113 -47h-1728
+q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2C3" unicode="&#xf2c3;" horiz-adv-x="2048" 
+d="M896 324q0 -55 -31.5 -93.5t-75.5 -38.5h-426q-44 0 -75.5 38.5t-31.5 93.5q0 54 7.5 100.5t24.5 90t51 68.5t81 25q64 -64 156 -64t156 64q47 0 81 -25t51 -68.5t24.5 -90t7.5 -100.5zM768 768q0 -80 -56 -136t-136 -56t-136 56t-56 136t56 136t136 56t136 -56t56 -136z
+M1792 352v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704q14 0 23 -9t9 -23zM1408 608v-64q0 -14 -9 -23t-23 -9h-320q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h320q14 0 23 -9t9 -23zM1792 608v-64q0 -14 -9 -23t-23 -9h-192q-14 0 -23 9t-9 23v64
+q0 14 9 23t23 9h192q14 0 23 -9t9 -23zM1792 864v-64q0 -14 -9 -23t-23 -9h-704q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h704q14 0 23 -9t9 -23zM1920 32v1120h-1792v-1120q0 -13 9.5 -22.5t22.5 -9.5h1728q13 0 22.5 9.5t9.5 22.5zM2048 1248v-1216q0 -66 -47 -113t-113 -47
+h-1728q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1728q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2C4" unicode="&#xf2c4;" horiz-adv-x="1792" 
+d="M1255 749q0 318 -105 474.5t-330 156.5q-222 0 -326 -157t-104 -474q0 -316 104 -471.5t326 -155.5q74 0 131 17q-22 43 -39 73t-44 65t-53.5 56.5t-63 36t-77.5 14.5q-46 0 -79 -16l-49 97q105 91 276 91q132 0 215.5 -54t150.5 -155q67 149 67 402zM1645 117h117
+q3 -27 -2 -67t-26.5 -95t-58 -100.5t-107 -78t-162.5 -32.5q-71 0 -130.5 19t-105.5 56t-79 78t-66 96q-97 -27 -205 -27q-150 0 -292.5 58t-253 158.5t-178 249t-67.5 317.5q0 170 67.5 319.5t178.5 250.5t253.5 159t291.5 58q121 0 238.5 -36t217 -106t176 -164.5
+t119.5 -219t43 -261.5q0 -190 -80.5 -347.5t-218.5 -264.5q47 -70 93.5 -106.5t104.5 -36.5q61 0 94 37.5t38 85.5z" />
+    <glyph glyph-name="uniF2C5" unicode="&#xf2c5;" horiz-adv-x="2304" 
+d="M453 -101q0 -21 -16 -37.5t-37 -16.5q-1 0 -13 3q-63 15 -162 140q-225 284 -225 676q0 341 213 614q39 51 95 103.5t94 52.5q19 0 35 -13.5t16 -32.5q0 -27 -63 -90q-98 -102 -147 -184q-119 -199 -119 -449q0 -281 123 -491q50 -85 136 -173q2 -3 14.5 -16t19.5 -21
+t17 -20.5t14.5 -23.5t4.5 -21zM1796 33q0 -29 -17.5 -48.5t-46.5 -19.5h-1081q-26 0 -45 19t-19 45q0 29 17.5 48.5t46.5 19.5h1081q26 0 45 -19t19 -45zM1581 644q0 -134 -67 -233q-25 -38 -69.5 -78.5t-83.5 -60.5q-16 -10 -27 -10q-7 0 -15 6t-8 12q0 9 19 30t42 46
+t42 67.5t19 88.5q0 76 -35 130q-29 42 -46 42q-3 0 -3 -5q0 -12 7.5 -35.5t7.5 -36.5q0 -22 -21.5 -35t-44.5 -13q-66 0 -66 76q0 15 1.5 44t1.5 44q0 25 -10 46q-13 25 -42 53.5t-51 28.5q-5 0 -7 -0.5t-3.5 -2.5t-1.5 -6q0 -2 16 -26t16 -54q0 -37 -19 -68t-46 -54
+t-53.5 -46t-45.5 -54t-19 -68q0 -98 42 -160q29 -43 79 -63q16 -5 17 -10q1 -2 1 -5q0 -16 -18 -16q-6 0 -33 11q-119 43 -195 139.5t-76 218.5q0 55 24.5 115.5t60 115t70.5 108.5t59.5 113.5t24.5 111.5q0 53 -25 94q-29 48 -56 64q-19 9 -19 21q0 20 41 20q50 0 110 -29
+q41 -19 71 -44.5t49.5 -51t33.5 -62.5t22 -69t16 -80q0 -1 3 -17.5t4.5 -25t5.5 -25t9 -27t11 -21.5t14.5 -16.5t18.5 -5.5q23 0 37 14t14 37q0 25 -20 67t-20 52t10 10q27 0 93 -70q72 -76 102.5 -156t30.5 -186zM2304 615q0 -274 -138 -503q-19 -32 -48 -72t-68 -86.5
+t-81 -77t-74 -30.5q-16 0 -31 15.5t-15 31.5q0 15 29 50.5t68.5 77t48.5 52.5q183 230 183 531q0 131 -20.5 235t-72.5 211q-58 119 -163 228q-2 3 -13 13.5t-16.5 16.5t-15 17.5t-15 20t-9.5 18.5t-4 19q0 19 16 35.5t35 16.5q70 0 196 -169q98 -131 146 -273t60 -314
+q2 -42 2 -64z" />
+    <glyph glyph-name="uniF2C6" unicode="&#xf2c6;" horiz-adv-x="1792" 
+d="M1189 229l147 693q9 44 -10.5 63t-51.5 7l-864 -333q-29 -11 -39.5 -25t-2.5 -26.5t32 -19.5l221 -69l513 323q21 14 32 6q7 -5 -4 -15l-415 -375v0v0l-16 -228q23 0 45 22l108 104l224 -165q64 -36 81 38zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71
+t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="uniF2C7" unicode="&#xf2c7;" horiz-adv-x="1024" 
+d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v907h128v-907q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
+t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
+v128h192z" />
+    <glyph glyph-name="uniF2C8" unicode="&#xf2c8;" horiz-adv-x="1024" 
+d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v651h128v-651q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
+t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
+v128h192z" />
+    <glyph glyph-name="uniF2C9" unicode="&#xf2c9;" horiz-adv-x="1024" 
+d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v395h128v-395q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
+t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
+v128h192z" />
+    <glyph glyph-name="uniF2CA" unicode="&#xf2ca;" horiz-adv-x="1024" 
+d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 60 35 110t93 71v139h128v-139q58 -21 93 -71t35 -110zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5
+t93.5 226.5zM896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192
+v128h192z" />
+    <glyph glyph-name="uniF2CB" unicode="&#xf2cb;" horiz-adv-x="1024" 
+d="M640 192q0 -80 -56 -136t-136 -56t-136 56t-56 136q0 79 56 135.5t136 56.5t136 -56.5t56 -135.5zM768 192q0 77 -34 144t-94 112v768q0 80 -56 136t-136 56t-136 -56t-56 -136v-768q-60 -45 -94 -112t-34 -144q0 -133 93.5 -226.5t226.5 -93.5t226.5 93.5t93.5 226.5z
+M896 192q0 -185 -131.5 -316.5t-316.5 -131.5t-316.5 131.5t-131.5 316.5q0 182 128 313v711q0 133 93.5 226.5t226.5 93.5t226.5 -93.5t93.5 -226.5v-711q128 -131 128 -313zM1024 768v-128h-192v128h192zM1024 1024v-128h-192v128h192zM1024 1280v-128h-192v128h192z" />
+    <glyph glyph-name="uniF2CC" unicode="&#xf2cc;" horiz-adv-x="1920" 
+d="M1433 1287q10 -10 10 -23t-10 -23l-626 -626q-10 -10 -23 -10t-23 10l-82 82q-10 10 -10 23t10 23l44 44q-72 91 -81.5 207t46.5 215q-74 71 -176 71q-106 0 -181 -75t-75 -181v-1280h-256v1280q0 104 40.5 198.5t109.5 163.5t163.5 109.5t198.5 40.5q106 0 201 -41
+t166 -115q94 39 197 24.5t185 -79.5l44 44q10 10 23 10t23 -10zM1344 1024q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1600 896q-26 0 -45 19t-19 45t19 45t45 19t45 -19t19 -45t-19 -45t-45 -19zM1856 1024q26 0 45 -19t19 -45t-19 -45t-45 -19
+t-45 19t-19 45t19 45t45 19zM1216 896q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1408 832q0 26 19 45t45 19t45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45zM1728 896q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 768
+q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1344 640q-26 0 -45 19t-19 45t19 45t45 19t45 -19t19 -45t-19 -45t-45 -19zM1600 768q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1216 512q-26 0 -45 19t-19 45t19 45t45 19t45 -19
+t19 -45t-19 -45t-45 -19zM1472 640q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 512q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1344 512q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1216 384
+q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19zM1088 256q26 0 45 -19t19 -45t-19 -45t-45 -19t-45 19t-19 45t19 45t45 19z" />
+    <glyph glyph-name="uniF2CD" unicode="&#xf2cd;" horiz-adv-x="1792" 
+d="M1664 448v-192q0 -169 -128 -286v-194q0 -14 -9 -23t-23 -9h-64q-14 0 -23 9t-9 23v118q-63 -22 -128 -22h-768q-65 0 -128 22v-110q0 -17 -9.5 -28.5t-22.5 -11.5h-64q-13 0 -22.5 11.5t-9.5 28.5v186q-128 117 -128 286v192h1536zM704 864q0 -14 -9 -23t-23 -9t-23 9
+t-9 23t9 23t23 9t23 -9t9 -23zM768 928q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM704 992q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 992q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM768 1056q0 -14 -9 -23t-23 -9t-23 9
+t-9 23t9 23t23 9t23 -9t9 -23zM704 1120q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1792 608v-64q0 -14 -9 -23t-23 -9h-1728q-14 0 -23 9t-9 23v64q0 14 9 23t23 9h96v640q0 106 75 181t181 75q108 0 184 -78q46 19 98 12t93 -39l22 22q11 11 22 0l42 -42
+q11 -11 0 -22l-314 -314q-11 -11 -22 0l-42 42q-11 11 0 22l22 22q-36 46 -40.5 104t23.5 108q-37 35 -88 35q-53 0 -90.5 -37.5t-37.5 -90.5v-640h1504q14 0 23 -9t9 -23zM896 1056q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 1120q0 -14 -9 -23t-23 -9
+t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM768 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM960 1120q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM896 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM832 1248q0 -14 -9 -23
+t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1024 1184q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM960 1248q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23zM1088 1248q0 -14 -9 -23t-23 -9t-23 9t-9 23t9 23t23 9t23 -9t9 -23z" />
+    <glyph glyph-name="uniF2CE" unicode="&#xf2ce;" 
+d="M994 344q0 -86 -17 -197q-31 -215 -55 -313q-22 -90 -152 -90t-152 90q-24 98 -55 313q-17 110 -17 197q0 168 224 168t224 -168zM1536 768q0 -240 -134 -434t-350 -280q-8 -3 -15 3t-6 15q7 48 10 66q4 32 6 47q1 9 9 12q159 81 255.5 234t96.5 337q0 180 -91 330.5
+t-247 234.5t-337 74q-124 -7 -237 -61t-193.5 -140.5t-128 -202t-46.5 -240.5q1 -184 99 -336.5t257 -231.5q7 -3 9 -12q3 -21 6 -45q1 -9 5 -32.5t6 -35.5q1 -9 -6.5 -15t-15.5 -2q-148 58 -261 169.5t-173.5 264t-52.5 319.5q7 143 66 273.5t154.5 227t225 157.5t272.5 70
+q164 10 315.5 -46.5t261 -160.5t175 -250.5t65.5 -308.5zM994 800q0 -93 -65.5 -158.5t-158.5 -65.5t-158.5 65.5t-65.5 158.5t65.5 158.5t158.5 65.5t158.5 -65.5t65.5 -158.5zM1282 768q0 -122 -53.5 -228.5t-146.5 -177.5q-8 -6 -16 -2t-10 14q-6 52 -29 92q-7 10 3 20
+q58 54 91 127t33 155q0 111 -58.5 204t-157.5 141.5t-212 36.5q-133 -15 -229 -113t-109 -231q-10 -92 23.5 -176t98.5 -144q10 -10 3 -20q-24 -41 -29 -93q-2 -9 -10 -13t-16 2q-95 74 -148.5 183t-51.5 234q3 131 69 244t177 181.5t241 74.5q144 7 268 -60t196.5 -187.5
+t72.5 -263.5z" />
+    <glyph glyph-name="uniF2D0" unicode="&#xf2d0;" horiz-adv-x="1792" 
+d="M256 128h1280v768h-1280v-768zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2D1" unicode="&#xf2d1;" horiz-adv-x="1792" 
+d="M1792 224v-192q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v192q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2D2" unicode="&#xf2d2;" horiz-adv-x="2048" 
+d="M256 0h768v512h-768v-512zM1280 512h512v768h-768v-256h96q66 0 113 -47t47 -113v-352zM2048 1376v-960q0 -66 -47 -113t-113 -47h-608v-352q0 -66 -47 -113t-113 -47h-960q-66 0 -113 47t-47 113v960q0 66 47 113t113 47h608v352q0 66 47 113t113 47h960q66 0 113 -47
+t47 -113z" />
+    <glyph glyph-name="uniF2D3" unicode="&#xf2d3;" horiz-adv-x="1792" 
+d="M1175 215l146 146q10 10 10 23t-10 23l-233 233l233 233q10 10 10 23t-10 23l-146 146q-10 10 -23 10t-23 -10l-233 -233l-233 233q-10 10 -23 10t-23 -10l-146 -146q-10 -10 -10 -23t10 -23l233 -233l-233 -233q-10 -10 -10 -23t10 -23l146 -146q10 -10 23 -10t23 10
+l233 233l233 -233q10 -10 23 -10t23 10zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2D4" unicode="&#xf2d4;" horiz-adv-x="1792" 
+d="M1257 425l-146 -146q-10 -10 -23 -10t-23 10l-169 169l-169 -169q-10 -10 -23 -10t-23 10l-146 146q-10 10 -10 23t10 23l169 169l-169 169q-10 10 -10 23t10 23l146 146q10 10 23 10t23 -10l169 -169l169 169q10 10 23 10t23 -10l146 -146q10 -10 10 -23t-10 -23
+l-169 -169l169 -169q10 -10 10 -23t-10 -23zM256 128h1280v1024h-1280v-1024zM1792 1248v-1216q0 -66 -47 -113t-113 -47h-1472q-66 0 -113 47t-47 113v1216q0 66 47 113t113 47h1472q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2D5" unicode="&#xf2d5;" horiz-adv-x="1792" 
+d="M1070 358l306 564h-654l-306 -564h654zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="uniF2D6" unicode="&#xf2d6;" horiz-adv-x="1794" 
+d="M1291 1060q-15 17 -35 8.5t-26 -28.5t5 -38q14 -17 40 -14.5t34 20.5t-18 52zM895 814q-8 -8 -19.5 -8t-18.5 8q-8 8 -8 19t8 18q7 8 18.5 8t19.5 -8q7 -7 7 -18t-7 -19zM1060 740l-35 -35q-12 -13 -29.5 -13t-30.5 13l-38 38q-12 13 -12 30t12 30l35 35q12 12 29.5 12
+t30.5 -12l38 -39q12 -12 12 -29.5t-12 -29.5zM951 870q-7 -8 -18.5 -8t-19.5 8q-7 8 -7 19t7 19q8 8 19 8t19 -8t8 -19t-8 -19zM1354 968q-34 -64 -107.5 -85.5t-127.5 16.5q-38 28 -61 66.5t-21 87.5t39 92t75.5 53t70.5 -5t70 -51q2 -2 13 -12.5t14.5 -13.5t13 -13.5
+t12.5 -15.5t10 -15.5t8.5 -18t4 -18.5t1 -21t-5 -22t-9.5 -24zM1555 486q3 20 -8.5 34.5t-27.5 21.5t-33 17t-23 20q-40 71 -84 98.5t-113 11.5q19 13 40 18.5t33 4.5l12 -1q2 45 -34 90q6 20 6.5 40.5t-2.5 30.5l-3 10q43 24 71 65t34 91q10 84 -43 150.5t-137 76.5
+q-60 7 -114 -18.5t-82 -74.5q-30 -51 -33.5 -101t14.5 -87t43.5 -64t56.5 -42q-45 4 -88 36t-57 88q-28 108 32 222q-16 21 -29 32q-50 0 -89 -19q19 24 42 37t36 14l13 1q0 50 -13 78q-10 21 -32.5 28.5t-47 -3.5t-37.5 -40q2 4 4 7q-7 -28 -6.5 -75.5t19 -117t48.5 -122.5
+q-25 -14 -47 -36q-35 -16 -85.5 -70.5t-84.5 -101.5l-33 -46q-90 -34 -181 -125.5t-75 -162.5q1 -16 11 -27q-15 -12 -30 -30q-21 -25 -21 -54t21.5 -40t63.5 6q41 19 77 49.5t55 60.5q-2 2 -6.5 5t-20.5 7.5t-33 3.5q23 5 51 12.5t40 10t27.5 6t26 4t23.5 0.5q14 -7 22 34
+q7 37 7 90q0 102 -40 150q106 -103 101 -219q-1 -29 -15 -50t-27 -27l-13 -6q-4 -7 -19 -32t-26 -45.5t-26.5 -52t-25 -61t-17 -63t-6.5 -66.5t10 -63q-35 54 -37 80q-22 -24 -34.5 -39t-33.5 -42t-30.5 -46t-16.5 -41t-0.5 -38t25.5 -27q45 -25 144 64t190.5 221.5
+t122.5 228.5q86 52 145 115.5t86 119.5q47 -93 154 -178q104 -83 167 -80q39 2 46 43zM1794 640q0 -182 -71 -348t-191 -286t-286.5 -191t-348.5 -71t-348.5 71t-286.5 191t-191 286t-71 348t71 348t191 286t286.5 191t348.5 71t348.5 -71t286.5 -191t191 -286t71 -348z" />
+    <glyph glyph-name="uniF2D7" unicode="&#xf2d7;" 
+d="M518 1353v-655q103 -1 191.5 1.5t125.5 5.5l37 3q68 2 90.5 24.5t39.5 94.5l33 142h103l-14 -322l7 -319h-103l-29 127q-15 68 -45 93t-84 26q-87 8 -352 8v-556q0 -78 43.5 -115.5t133.5 -37.5h357q35 0 59.5 2t55 7.5t54 18t48.5 32t46 50.5t39 73l93 216h89
+q-6 -37 -31.5 -252t-30.5 -276q-146 5 -263.5 8t-162.5 4h-44h-628l-376 -12v102l127 25q67 13 91.5 37t25.5 79l8 643q3 402 -8 645q-2 61 -25.5 84t-91.5 36l-127 24v102l376 -12h702q139 0 374 27q-6 -68 -14 -194.5t-12 -219.5l-5 -92h-93l-32 124q-31 121 -74 179.5
+t-113 58.5h-548q-28 0 -35.5 -8.5t-7.5 -30.5z" />
+    <glyph glyph-name="uniF2D8" unicode="&#xf2d8;" 
+d="M922 739v-182q0 -4 0.5 -15t0 -15l-1.5 -12t-3.5 -11.5t-6.5 -7.5t-11 -5.5t-16 -1.5v309q9 0 16 -1t11 -5t6.5 -5.5t3.5 -9.5t1 -10.5v-13.5v-14zM1238 643v-121q0 -1 0.5 -12.5t0 -15.5t-2.5 -11.5t-7.5 -10.5t-13.5 -3q-9 0 -14 9q-4 10 -4 165v7v8.5v9t1.5 8.5l3.5 7
+t5 5.5t8 1.5q6 0 10 -1.5t6.5 -4.5t4 -6t2 -8.5t0.5 -8v-9.5v-9zM180 407h122v472h-122v-472zM614 407h106v472h-159l-28 -221q-20 148 -32 221h-158v-472h107v312l45 -312h76l43 319v-319zM1039 712q0 67 -5 90q-3 16 -11 28.5t-17 20.5t-25 14t-26.5 8.5t-31 4t-29 1.5
+h-29.5h-12h-91v-472h56q169 -1 197 24.5t25 180.5q-1 62 -1 100zM1356 515v133q0 29 -2 45t-9.5 33.5t-24.5 25t-46 7.5q-46 0 -77 -34v154h-117v-472h110l7 30q30 -36 77 -36q50 0 66 30.5t16 83.5zM1536 1248v-1216q0 -66 -47 -113t-113 -47h-1216q-66 0 -113 47t-47 113
+v1216q0 66 47 113t113 47h1216q66 0 113 -47t47 -113z" />
+    <glyph glyph-name="uniF2D9" unicode="&#xf2d9;" horiz-adv-x="2176" 
+d="M1143 -197q-6 1 -11 4q-13 8 -36 23t-86 65t-116.5 104.5t-112 140t-89.5 172.5q-17 3 -175 37q66 -213 235 -362t391 -184zM502 409l168 -28q-25 76 -41 167.5t-19 145.5l-4 53q-84 -82 -121 -224q5 -65 17 -114zM612 1018q-43 -64 -77 -148q44 46 74 68zM2049 584
+q0 161 -62 307t-167.5 252t-250.5 168.5t-304 62.5q-147 0 -281 -52.5t-240 -148.5q-30 -58 -45 -160q60 51 143 83.5t158.5 43t143 13.5t108.5 -1l40 -3q33 -1 53 -15.5t24.5 -33t6.5 -37t-1 -28.5q-126 11 -227.5 0.5t-183 -43.5t-142.5 -71.5t-131 -98.5
+q4 -36 11.5 -92.5t35.5 -178t62 -179.5q123 -6 247.5 14.5t214.5 53.5t162.5 67t109.5 59l37 24q22 16 39.5 20.5t30.5 -5t17 -34.5q14 -97 -39 -121q-208 -97 -467 -134q-135 -20 -317 -16q41 -96 110 -176.5t137 -127t130.5 -79t101.5 -43.5l39 -12q143 -23 263 15
+q195 99 314 289t119 418zM2123 621q-14 -135 -40 -212q-70 -208 -181.5 -346.5t-318.5 -253.5q-48 -33 -82 -44q-72 -26 -163 -16q-36 -3 -73 -3q-283 0 -504.5 173t-295.5 442q-1 0 -4 0.5t-5 0.5q-6 -50 2.5 -112.5t26 -115t36 -98t31.5 -71.5l14 -26q8 -12 54 -82
+q-71 38 -124.5 106.5t-78.5 140t-39.5 137t-17.5 107.5l-2 42q-5 2 -33.5 12.5t-48.5 18t-53 20.5t-57.5 25t-50 25.5t-42.5 27t-25 25.5q19 -10 50.5 -25.5t113 -45.5t145.5 -38l2 32q11 149 94 290q41 202 176 365q28 115 81 214q15 28 32 45t49 32q158 74 303.5 104
+t302 11t306.5 -97q220 -115 333 -336t87 -474z" />
+    <glyph glyph-name="uniF2DA" unicode="&#xf2da;" horiz-adv-x="1792" 
+d="M1341 752q29 44 -6.5 129.5t-121.5 142.5q-58 39 -125.5 53.5t-118 4.5t-68.5 -37q-12 -23 -4.5 -28t42.5 -10q23 -3 38.5 -5t44.5 -9.5t56 -17.5q36 -13 67.5 -31.5t53 -37t40 -38.5t30.5 -38t22 -34.5t16.5 -28.5t12 -18.5t10.5 -6t11 9.5zM1704 178
+q-52 -127 -148.5 -220t-214.5 -141.5t-253 -60.5t-266 13.5t-251 91t-210 161.5t-141.5 235.5t-46.5 303.5q1 41 8.5 84.5t12.5 64t24 80.5t23 73q-51 -208 1 -397t173 -318t291 -206t346 -83t349 74.5t289 244.5q20 27 18 14q0 -4 -4 -14zM1465 627q0 -104 -40.5 -199
+t-108.5 -164t-162 -109.5t-198 -40.5t-198 40.5t-162 109.5t-108.5 164t-40.5 199t40.5 199t108.5 164t162 109.5t198 40.5t198 -40.5t162 -109.5t108.5 -164t40.5 -199zM1752 915q-65 147 -180.5 251t-253 153.5t-292 53.5t-301 -36.5t-275.5 -129t-220 -211.5t-131 -297
+t-10 -373q-49 161 -51.5 311.5t35.5 272.5t109 227t165.5 180.5t207 126t232 71t242.5 9t236 -54t216 -124.5t178 -197q33 -50 62 -121t31 -112zM1690 573q12 244 -136.5 416t-396.5 240q-8 0 -10 5t24 8q125 -4 230 -50t173 -120t116 -168.5t58.5 -199t-1 -208
+t-61.5 -197.5t-122.5 -167t-185 -117.5t-248.5 -46.5q108 30 201.5 80t174 123t129.5 176.5t55 225.5z" />
+    <glyph glyph-name="uniF2DB" unicode="&#xf2db;" 
+d="M192 256v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 512v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 768v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16
+q0 16 16 16h112zM192 1024v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM192 1280v-128h-112q-16 0 -16 16v16h-48q-16 0 -16 16v32q0 16 16 16h48v16q0 16 16 16h112zM1280 1440v-1472q0 -40 -28 -68t-68 -28h-832q-40 0 -68 28
+t-28 68v1472q0 40 28 68t68 28h832q40 0 68 -28t28 -68zM1536 208v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 464v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 720v-32
+q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 976v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16h48q16 0 16 -16zM1536 1232v-32q0 -16 -16 -16h-48v-16q0 -16 -16 -16h-112v128h112q16 0 16 -16v-16
+h48q16 0 16 -16z" />
+    <glyph glyph-name="uniF2DC" unicode="&#xf2dc;" horiz-adv-x="1664" 
+d="M1566 419l-167 -33l186 -107q23 -13 29.5 -38.5t-6.5 -48.5q-14 -23 -39 -29.5t-48 6.5l-186 106l55 -160q13 -38 -12 -63.5t-60.5 -20.5t-48.5 42l-102 300l-271 156v-313l208 -238q16 -18 17 -39t-11 -36.5t-28.5 -25t-37 -5.5t-36.5 22l-112 128v-214q0 -26 -19 -45
+t-45 -19t-45 19t-19 45v214l-112 -128q-16 -18 -36.5 -22t-37 5.5t-28.5 25t-11 36.5t17 39l208 238v313l-271 -156l-102 -300q-13 -37 -48.5 -42t-60.5 20.5t-12 63.5l55 160l-186 -106q-23 -13 -48 -6.5t-39 29.5q-13 23 -6.5 48.5t29.5 38.5l186 107l-167 33
+q-29 6 -42 29t-8.5 46.5t25.5 40t50 10.5l310 -62l271 157l-271 157l-310 -62q-4 -1 -13 -1q-27 0 -44 18t-19 40t11 43t40 26l167 33l-186 107q-23 13 -29.5 38.5t6.5 48.5t39 30t48 -7l186 -106l-55 160q-13 38 12 63.5t60.5 20.5t48.5 -42l102 -300l271 -156v313
+l-208 238q-16 18 -17 39t11 36.5t28.5 25t37 5.5t36.5 -22l112 -128v214q0 26 19 45t45 19t45 -19t19 -45v-214l112 128q16 18 36.5 22t37 -5.5t28.5 -25t11 -36.5t-17 -39l-208 -238v-313l271 156l102 300q13 37 48.5 42t60.5 -20.5t12 -63.5l-55 -160l186 106
+q23 13 48 6.5t39 -29.5q13 -23 6.5 -48.5t-29.5 -38.5l-186 -107l167 -33q27 -5 40 -26t11 -43t-19 -40t-44 -18q-9 0 -13 1l-310 62l-271 -157l271 -157l310 62q29 6 50 -10.5t25.5 -40t-8.5 -46.5t-42 -29z" />
+    <glyph glyph-name="uniF2DD" unicode="&#xf2dd;" horiz-adv-x="1792" 
+d="M1473 607q7 118 -33 226.5t-113 189t-177 131t-221 57.5q-116 7 -225.5 -32t-192 -110.5t-135 -175t-59.5 -220.5q-7 -118 33 -226.5t113 -189t177.5 -131t221.5 -57.5q155 -9 293 59t224 195.5t94 283.5zM1792 1536l-349 -348q120 -117 180.5 -272t50.5 -321
+q-11 -183 -102 -339t-241 -255.5t-332 -124.5l-999 -132l347 347q-120 116 -180.5 271.5t-50.5 321.5q11 184 102 340t241.5 255.5t332.5 124.5q167 22 500 66t500 66z" />
+    <glyph glyph-name="uniF2DE" unicode="&#xf2de;" horiz-adv-x="1792" 
+d="M948 508l163 -329h-51l-175 350l-171 -350h-49l179 374l-78 33l21 49l240 -102l-21 -50zM563 1100l304 -130l-130 -304l-304 130zM907 915l240 -103l-103 -239l-239 102zM1188 765l191 -81l-82 -190l-190 81zM1680 640q0 159 -62 304t-167.5 250.5t-250.5 167.5t-304 62
+t-304 -62t-250.5 -167.5t-167.5 -250.5t-62 -304t62 -304t167.5 -250.5t250.5 -167.5t304 -62t304 62t250.5 167.5t167.5 250.5t62 304zM1792 640q0 -182 -71 -348t-191 -286t-286 -191t-348 -71t-348 71t-286 191t-191 286t-71 348t71 348t191 286t286 191t348 71t348 -71
+t286 -191t191 -286t71 -348z" />
+    <glyph glyph-name="uniF2E0" unicode="&#xf2e0;" horiz-adv-x="1920" 
+d="M1334 302q-4 24 -27.5 34t-49.5 10.5t-48.5 12.5t-25.5 38q-5 47 33 139.5t75 181t32 127.5q-14 101 -117 103q-45 1 -75 -16l-3 -2l-5 -2.5t-4.5 -2t-5 -2t-5 -0.5t-6 1.5t-6 3.5t-6.5 5q-3 2 -9 8.5t-9 9t-8.5 7.5t-9.5 7.5t-9.5 5.5t-11 4.5t-11.5 2.5q-30 5 -48 -3
+t-45 -31q-1 -1 -9 -8.5t-12.5 -11t-15 -10t-16.5 -5.5t-17 3q-54 27 -84 40q-41 18 -94 -5t-76 -65q-16 -28 -41 -98.5t-43.5 -132.5t-40 -134t-21.5 -73q-22 -69 18.5 -119t110.5 -46q30 2 50.5 15t38.5 46q7 13 79 199.5t77 194.5q6 11 21.5 18t29.5 0q27 -15 21 -53
+q-2 -18 -51 -139.5t-50 -132.5q-6 -38 19.5 -56.5t60.5 -7t55 49.5q4 8 45.5 92t81.5 163.5t46 88.5q20 29 41 28q29 0 25 -38q-2 -16 -65.5 -147.5t-70.5 -159.5q-12 -53 13 -103t74 -74q17 -9 51 -15.5t71.5 -8t62.5 14t20 48.5zM383 86q3 -15 -5 -27.5t-23 -15.5
+q-14 -3 -26.5 5t-15.5 23q-3 14 5 27t22 16t27 -5t16 -23zM953 -177q12 -17 8.5 -37.5t-20.5 -32.5t-37.5 -8t-32.5 21q-11 17 -7.5 37.5t20.5 32.5t37.5 8t31.5 -21zM177 635q-18 -27 -49.5 -33t-57.5 13q-26 18 -32 50t12 58q18 27 49.5 33t57.5 -12q26 -19 32 -50.5
+t-12 -58.5zM1467 -42q19 -28 13 -61.5t-34 -52.5t-60.5 -13t-51.5 34t-13 61t33 53q28 19 60.5 13t52.5 -34zM1579 562q69 -113 42.5 -244.5t-134.5 -207.5q-90 -63 -199 -60q-20 -80 -84.5 -127t-143.5 -44.5t-140 57.5q-12 -9 -13 -10q-103 -71 -225 -48.5t-193 126.5
+q-50 73 -53 164q-83 14 -142.5 70.5t-80.5 128t-2 152t81 138.5q-36 60 -38 128t24.5 125t79.5 98.5t121 50.5q32 85 99 148t146.5 91.5t168 17t159.5 -66.5q72 21 140 17.5t128.5 -36t104.5 -80t67.5 -115t17.5 -140.5q52 -16 87 -57t45.5 -89t-5.5 -99.5t-58 -87.5z
+M455 1222q14 -20 9.5 -44.5t-24.5 -38.5q-19 -14 -43.5 -9.5t-37.5 24.5q-14 20 -9.5 44.5t24.5 38.5q19 14 43.5 9.5t37.5 -24.5zM614 1503q4 -16 -5 -30.5t-26 -18.5t-31 5.5t-18 26.5q-3 17 6.5 31t25.5 18q17 4 31 -5.5t17 -26.5zM1800 555q4 -20 -6.5 -37t-30.5 -21
+q-19 -4 -36 6.5t-21 30.5t6.5 37t30.5 22q20 4 36.5 -7.5t20.5 -30.5zM1136 1448q16 -27 8.5 -58.5t-35.5 -47.5q-27 -16 -57.5 -8.5t-46.5 34.5q-16 28 -8.5 59t34.5 48t58 9t47 -36zM1882 792q4 -15 -4 -27.5t-23 -16.5q-15 -3 -27.5 5.5t-15.5 22.5q-3 15 5 28t23 16
+q14 3 26.5 -5t15.5 -23zM1691 1033q15 -22 10.5 -49t-26.5 -43q-22 -15 -49 -10t-42 27t-10 49t27 43t48.5 11t41.5 -28z" />
+    <glyph glyph-name="uniF2E1" unicode="&#xf2e1;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E2" unicode="&#xf2e2;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E3" unicode="&#xf2e3;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E4" unicode="&#xf2e4;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E5" unicode="&#xf2e5;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E6" unicode="&#xf2e6;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E7" unicode="&#xf2e7;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="_698" unicode="&#xf2e8;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2E9" unicode="&#xf2e9;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2EA" unicode="&#xf2ea;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2EB" unicode="&#xf2eb;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2EC" unicode="&#xf2ec;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2ED" unicode="&#xf2ed;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="uniF2EE" unicode="&#xf2ee;" horiz-adv-x="1792" 
+ />
+    <glyph glyph-name="lessequal" unicode="&#xf500;" horiz-adv-x="1792" 
+ />
+  </font>
+</defs></svg>
diff --git a/pr-2241/_static/css/fonts/fontawesome-webfont.ttf b/pr-2241/_static/css/fonts/fontawesome-webfont.ttf
new file mode 100644
index 0000000000..35acda2fa1
Binary files /dev/null and b/pr-2241/_static/css/fonts/fontawesome-webfont.ttf differ
diff --git a/pr-2241/_static/css/fonts/fontawesome-webfont.woff b/pr-2241/_static/css/fonts/fontawesome-webfont.woff
new file mode 100644
index 0000000000..400014a4b0
Binary files /dev/null and b/pr-2241/_static/css/fonts/fontawesome-webfont.woff differ
diff --git a/pr-2241/_static/css/fonts/fontawesome-webfont.woff2 b/pr-2241/_static/css/fonts/fontawesome-webfont.woff2
new file mode 100644
index 0000000000..4d13fc6040
Binary files /dev/null and b/pr-2241/_static/css/fonts/fontawesome-webfont.woff2 differ
diff --git a/pr-2241/_static/css/fonts/lato-bold-italic.woff b/pr-2241/_static/css/fonts/lato-bold-italic.woff
new file mode 100644
index 0000000000..88ad05b9ff
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-bold-italic.woff differ
diff --git a/pr-2241/_static/css/fonts/lato-bold-italic.woff2 b/pr-2241/_static/css/fonts/lato-bold-italic.woff2
new file mode 100644
index 0000000000..c4e3d804b5
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-bold-italic.woff2 differ
diff --git a/pr-2241/_static/css/fonts/lato-bold.woff b/pr-2241/_static/css/fonts/lato-bold.woff
new file mode 100644
index 0000000000..c6dff51f06
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-bold.woff differ
diff --git a/pr-2241/_static/css/fonts/lato-bold.woff2 b/pr-2241/_static/css/fonts/lato-bold.woff2
new file mode 100644
index 0000000000..bb195043cf
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-bold.woff2 differ
diff --git a/pr-2241/_static/css/fonts/lato-normal-italic.woff b/pr-2241/_static/css/fonts/lato-normal-italic.woff
new file mode 100644
index 0000000000..76114bc033
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-normal-italic.woff differ
diff --git a/pr-2241/_static/css/fonts/lato-normal-italic.woff2 b/pr-2241/_static/css/fonts/lato-normal-italic.woff2
new file mode 100644
index 0000000000..3404f37e2e
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-normal-italic.woff2 differ
diff --git a/pr-2241/_static/css/fonts/lato-normal.woff b/pr-2241/_static/css/fonts/lato-normal.woff
new file mode 100644
index 0000000000..ae1307ff5f
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-normal.woff differ
diff --git a/pr-2241/_static/css/fonts/lato-normal.woff2 b/pr-2241/_static/css/fonts/lato-normal.woff2
new file mode 100644
index 0000000000..3bf9843328
Binary files /dev/null and b/pr-2241/_static/css/fonts/lato-normal.woff2 differ
diff --git a/pr-2241/_static/css/theme.css b/pr-2241/_static/css/theme.css
new file mode 100644
index 0000000000..c03c88f06c
--- /dev/null
+++ b/pr-2241/_static/css/theme.css
@@ -0,0 +1,4 @@
+html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .eqno .headerlink:before,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*!
+ *  Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
+ *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
+ */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .eqno .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a button.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-left.toctree-expand,.wy-menu-vertical li button.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .eqno .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a button.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-right.toctree-expand,.wy-menu-vertical li button.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .eqno .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a button.pull-left.toctree-expand,.wy-menu-vertical li.on a button.pull-left.toctree-expand,.wy-menu-vertical li button.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .eqno .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a button.pull-right.toctree-expand,.wy-menu-vertical li.on a button.pull-right.toctree-expand,.wy-menu-vertical li button.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li button.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content .eqno .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content .eqno a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content p a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li a button.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content .eqno .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content p .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li button.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content .eqno .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a button.toctree-expand,.btn .wy-menu-vertical li.on a button.toctree-expand,.btn .wy-menu-vertical li button.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content .eqno .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a button.toctree-expand,.nav .wy-menu-vertical li.on a button.toctree-expand,.nav .wy-menu-vertical li button.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .eqno .btn .headerlink,.rst-content .eqno .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p .btn .headerlink,.rst-content p .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn button.toctree-expand,.wy-menu-vertical li.current>a .btn button.toctree-expand,.wy-menu-vertical li.current>a .nav button.toctree-expand,.wy-menu-vertical li .nav button.toctree-expand,.wy-menu-vertical li.on a .btn button.toctree-expand,.wy-menu-vertical li.on a .nav button.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .eqno .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li button.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .eqno .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li button.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .eqno .btn .fa-large.headerlink,.rst-content .eqno .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p .btn .fa-large.headerlink,.rst-content p .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn button.fa-large.toctree-expand,.wy-menu-vertical li .nav button.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .eqno .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li button.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .eqno .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li button.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .eqno .btn .fa-spin.headerlink,.rst-content .eqno .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p .btn .fa-spin.headerlink,.rst-content p .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn button.fa-spin.toctree-expand,.wy-menu-vertical li .nav button.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content .eqno .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li button.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content .eqno .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li button.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content .eqno .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li button.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content .eqno .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini button.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.rst-content section ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.rst-content section ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.rst-content section ul li p:last-child,.rst-content section ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.rst-content section ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.rst-content section ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.rst-content section ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content .section ol.arabic,.rst-content .toctree-wrapper ol,.rst-content .toctree-wrapper ol.arabic,.rst-content section ol,.rst-content section ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol.arabic li,.rst-content .section ol li,.rst-content .toctree-wrapper ol.arabic li,.rst-content .toctree-wrapper ol li,.rst-content section ol.arabic li,.rst-content section ol li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol.arabic li ul,.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content .toctree-wrapper ol.arabic li ul,.rst-content .toctree-wrapper ol li p:last-child,.rst-content .toctree-wrapper ol li ul,.rst-content section ol.arabic li ul,.rst-content section ol li p:last-child,.rst-content section ol li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol.arabic li ul li,.rst-content .section ol li ul li,.rst-content .toctree-wrapper ol.arabic li ul li,.rst-content .toctree-wrapper ol li ul li,.rst-content section ol.arabic li ul li,.rst-content section ol li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs>li{display:inline-block;padding-top:5px}.wy-breadcrumbs>li.wy-breadcrumbs-aside{float:right}.rst-content .wy-breadcrumbs>li code,.rst-content .wy-breadcrumbs>li tt,.wy-breadcrumbs>li .rst-content tt,.wy-breadcrumbs>li code{all:inherit;color:inherit}.breadcrumb-item:before{content:"/";color:#bbb;font-size:13px;padding:0 6px 0 3px}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li button.toctree-expand{display:block;float:left;margin-left:-1.2em;line-height:18px;color:#4d4d4d;border:none;background:none;padding:0}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover button.toctree-expand,.wy-menu-vertical li.on a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand{display:block;line-height:18px;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{padding:.4045em 1.618em .4045em 4.045em}.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{padding:.4045em 1.618em .4045em 5.663em}.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a{padding:.4045em 1.618em .4045em 7.281em}.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a{padding:.4045em 1.618em .4045em 8.899em}.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a{padding:.4045em 1.618em .4045em 10.517em}.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a{padding:.4045em 1.618em .4045em 12.135em}.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a{padding:.4045em 1.618em .4045em 13.753em}.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a{padding:.4045em 1.618em .4045em 15.371em}.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 1.618em .4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 button.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 button.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover button.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active button.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em;max-width:100%}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .eqno .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content .eqno .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li button.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version button.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content .toctree-wrapper>p.caption,.rst-content h1,.rst-content h2,.rst-content h3,.rst-content h4,.rst-content h5,.rst-content h6{margin-bottom:24px}.rst-content img{max-width:100%;height:auto}.rst-content div.figure,.rst-content figure{margin-bottom:24px}.rst-content div.figure .caption-text,.rst-content figure .caption-text{font-style:italic}.rst-content div.figure p:last-child.caption,.rst-content figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center,.rst-content figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img,.rst-content section>a>img,.rst-content section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp,.rst-content div.highlight span.linenos{user-select:none;pointer-events:none}.rst-content div.highlight span.linenos{display:inline-block;padding-left:0;padding-right:12px;margin-right:12px;border-right:1px solid #e6e9ea}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li,.rst-content .toctree-wrapper ol.loweralpha,.rst-content .toctree-wrapper ol.loweralpha>li,.rst-content section ol.loweralpha,.rst-content section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li,.rst-content .toctree-wrapper ol.upperalpha,.rst-content .toctree-wrapper ol.upperalpha>li,.rst-content section ol.upperalpha,.rst-content section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*,.rst-content .toctree-wrapper ol li>*,.rst-content .toctree-wrapper ul li>*,.rst-content section ol li>*,.rst-content section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child,.rst-content .toctree-wrapper ol li>:first-child,.rst-content .toctree-wrapper ul li>:first-child,.rst-content section ol li>:first-child,.rst-content section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child,.rst-content .toctree-wrapper ol li>p,.rst-content .toctree-wrapper ol li>p:last-child,.rst-content .toctree-wrapper ul li>p,.rst-content .toctree-wrapper ul li>p:last-child,.rst-content section ol li>p,.rst-content section ol li>p:last-child,.rst-content section ul li>p,.rst-content section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child,.rst-content .toctree-wrapper ol li>p:only-child,.rst-content .toctree-wrapper ol li>p:only-child:last-child,.rst-content .toctree-wrapper ul li>p:only-child,.rst-content .toctree-wrapper ul li>p:only-child:last-child,.rst-content section ol li>p:only-child,.rst-content section ol li>p:only-child:last-child,.rst-content section ul li>p:only-child,.rst-content section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul,.rst-content .toctree-wrapper ol li>ol,.rst-content .toctree-wrapper ol li>ul,.rst-content .toctree-wrapper ul li>ol,.rst-content .toctree-wrapper ul li>ul,.rst-content section ol li>ol,.rst-content section ol li>ul,.rst-content section ul li>ol,.rst-content section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul,.rst-content .toctree-wrapper ol.simple li>*,.rst-content .toctree-wrapper ol.simple li ol,.rst-content .toctree-wrapper ol.simple li ul,.rst-content .toctree-wrapper ul.simple li>*,.rst-content .toctree-wrapper ul.simple li ol,.rst-content .toctree-wrapper ul.simple li ul,.rst-content section ol.simple li>*,.rst-content section ol.simple li ol,.rst-content section ol.simple li ul,.rst-content section ul.simple li>*,.rst-content section ul.simple li ol,.rst-content section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink{opacity:0;font-size:14px;font-family:FontAwesome;margin-left:.5em}.rst-content .code-block-caption .headerlink:focus,.rst-content .code-block-caption:hover .headerlink,.rst-content .eqno .headerlink:focus,.rst-content .eqno:hover .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink:focus,.rst-content .toctree-wrapper>p.caption:hover .headerlink,.rst-content dl dt .headerlink:focus,.rst-content dl dt:hover .headerlink,.rst-content h1 .headerlink:focus,.rst-content h1:hover .headerlink,.rst-content h2 .headerlink:focus,.rst-content h2:hover .headerlink,.rst-content h3 .headerlink:focus,.rst-content h3:hover .headerlink,.rst-content h4 .headerlink:focus,.rst-content h4:hover .headerlink,.rst-content h5 .headerlink:focus,.rst-content h5:hover .headerlink,.rst-content h6 .headerlink:focus,.rst-content h6:hover .headerlink,.rst-content p.caption .headerlink:focus,.rst-content p.caption:hover .headerlink,.rst-content p .headerlink:focus,.rst-content p:hover .headerlink,.rst-content table>caption .headerlink:focus,.rst-content table>caption:hover .headerlink{opacity:1}.rst-content p a{overflow-wrap:anywhere}.rst-content .wy-table td p,.rst-content .wy-table td ul,.rst-content .wy-table th p,.rst-content .wy-table th ul,.rst-content table.docutils td p,.rst-content table.docutils td ul,.rst-content table.docutils th p,.rst-content table.docutils th ul,.rst-content table.field-list td p,.rst-content table.field-list td ul,.rst-content table.field-list th p,.rst-content table.field-list th ul{font-size:inherit}.rst-content .btn:focus{outline:2px solid}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .citation-reference>span.fn-bracket,.rst-content .footnote-reference>span.fn-bracket{display:none}.rst-content .hlist{width:100%}.rst-content dl dt span.classifier:before{content:" : "}.rst-content dl dt span.classifier-delimiter{display:none!important}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:auto minmax(80%,95%)}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{display:inline-grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{display:grid;grid-template-columns:auto auto minmax(.65rem,auto) minmax(40%,95%)}html.writer-html5 .rst-content aside.citation>span.label,html.writer-html5 .rst-content aside.footnote>span.label,html.writer-html5 .rst-content div.citation>span.label{grid-column-start:1;grid-column-end:2}html.writer-html5 .rst-content aside.citation>span.backrefs,html.writer-html5 .rst-content aside.footnote>span.backrefs,html.writer-html5 .rst-content div.citation>span.backrefs{grid-column-start:2;grid-column-end:3;grid-row-start:1;grid-row-end:3}html.writer-html5 .rst-content aside.citation>p,html.writer-html5 .rst-content aside.footnote>p,html.writer-html5 .rst-content div.citation>p{grid-column-start:4;grid-column-end:5}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{margin-bottom:24px}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.citation>dt>span.brackets:before,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.citation>dt>span.brackets:after,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a{word-break:keep-all}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a:not(:first-child):before,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.citation>dd p,html.writer-html5 .rst-content dl.footnote>dd p{font-size:.9rem}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{padding-left:1rem;padding-right:1rem;font-size:.9rem;line-height:1.2rem}html.writer-html5 .rst-content aside.citation p,html.writer-html5 .rst-content aside.footnote p,html.writer-html5 .rst-content div.citation p{font-size:.9rem;line-height:1.2rem;margin-bottom:12px}html.writer-html5 .rst-content aside.citation span.backrefs,html.writer-html5 .rst-content aside.footnote span.backrefs,html.writer-html5 .rst-content div.citation span.backrefs{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content aside.citation span.backrefs>a,html.writer-html5 .rst-content aside.footnote span.backrefs>a,html.writer-html5 .rst-content div.citation span.backrefs>a{word-break:keep-all}html.writer-html5 .rst-content aside.citation span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content aside.footnote span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content div.citation span.backrefs>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content aside.citation span.label,html.writer-html5 .rst-content aside.footnote span.label,html.writer-html5 .rst-content div.citation span.label{line-height:1.2rem}html.writer-html5 .rst-content aside.citation-list,html.writer-html5 .rst-content aside.footnote-list,html.writer-html5 .rst-content div.citation-list{margin-bottom:24px}html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content aside.footnote-list aside.footnote,html.writer-html5 .rst-content div.citation-list>div.citation,html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content aside.footnote-list aside.footnote code,html.writer-html5 .rst-content aside.footnote-list aside.footnote tt,html.writer-html5 .rst-content aside.footnote code,html.writer-html5 .rst-content aside.footnote tt,html.writer-html5 .rst-content div.citation-list>div.citation code,html.writer-html5 .rst-content div.citation-list>div.citation tt,html.writer-html5 .rst-content dl.citation code,html.writer-html5 .rst-content dl.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c;white-space:normal}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040;overflow-wrap:normal}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl dd>ol:last-child,.rst-content dl dd>p:last-child,.rst-content dl dd>table:last-child,.rst-content dl dd>ul:last-child{margin-bottom:0}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px;max-width:100%}html.writer-html4 .rst-content dl:not(.docutils) .k,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .k{font-style:italic}html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .sig-name{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#000}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>.kbd,.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>kbd{color:inherit;font-size:80%;background-color:#fff;border:1px solid #a6a6a6;border-radius:4px;box-shadow:0 2px grey;padding:2.4px 6px;margin:auto 0}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block}
\ No newline at end of file
diff --git a/pr-2241/_static/cuda_quantum_icon.svg b/pr-2241/_static/cuda_quantum_icon.svg
new file mode 100644
index 0000000000..e7f2901fec
--- /dev/null
+++ b/pr-2241/_static/cuda_quantum_icon.svg
@@ -0,0 +1,553 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 300 300">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: none;
+      }
+
+      .cls-2 {
+        opacity: 0.1;
+      }
+
+      .cls-3 {
+        fill: url(#New_Gradient_Swatch_4);
+      }
+
+      .cls-4 {
+        fill: url(#linear-gradient);
+      }
+
+      .cls-5 {
+        fill: url(#linear-gradient-2);
+      }
+
+      .cls-6 {
+        fill: url(#linear-gradient-3);
+      }
+
+      .cls-7 {
+        opacity: 0.15;
+      }
+
+      .cls-8 {
+        isolation: isolate;
+      }
+
+      .cls-9 {
+        fill: #649d00;
+      }
+
+      .cls-10 {
+        clip-path: url(#clip-path);
+      }
+
+      .cls-11 {
+        fill: #649c00;
+      }
+
+      .cls-12 {
+        fill: #639b00;
+      }
+
+      .cls-13 {
+        clip-path: url(#clip-path-2);
+      }
+
+      .cls-14 {
+        clip-path: url(#clip-path-3);
+      }
+
+      .cls-15 {
+        fill: #75b700;
+      }
+
+      .cls-16 {
+        clip-path: url(#clip-path-4);
+      }
+
+      .cls-17 {
+        clip-path: url(#clip-path-5);
+      }
+
+      .cls-18 {
+        clip-path: url(#clip-path-6);
+      }
+
+      .cls-19 {
+        clip-path: url(#clip-path-7);
+      }
+
+      .cls-20 {
+        clip-path: url(#clip-path-8);
+      }
+
+      .cls-21 {
+        clip-path: url(#clip-path-9);
+      }
+
+      .cls-22 {
+        clip-path: url(#clip-path-10);
+      }
+
+      .cls-23 {
+        clip-path: url(#clip-path-11);
+      }
+
+      .cls-24 {
+        clip-path: url(#clip-path-12);
+      }
+
+      .cls-25 {
+        clip-path: url(#clip-path-13);
+      }
+
+      .cls-26 {
+        clip-path: url(#clip-path-14);
+      }
+
+      .cls-27 {
+        clip-path: url(#clip-path-15);
+      }
+
+      .cls-28 {
+        clip-path: url(#clip-path-16);
+      }
+
+      .cls-29 {
+        clip-path: url(#clip-path-17);
+      }
+
+      .cls-30 {
+        clip-path: url(#clip-path-18);
+      }
+
+      .cls-31 {
+        clip-path: url(#clip-path-19);
+      }
+
+      .cls-32 {
+        clip-path: url(#clip-path-20);
+      }
+
+      .cls-33 {
+        clip-path: url(#clip-path-21);
+      }
+
+      .cls-34 {
+        clip-path: url(#clip-path-22);
+      }
+
+      .cls-35 {
+        clip-path: url(#clip-path-23);
+      }
+
+      .cls-36 {
+        clip-path: url(#clip-path-24);
+      }
+
+      .cls-37 {
+        clip-path: url(#clip-path-25);
+      }
+
+      .cls-38 {
+        clip-path: url(#clip-path-26);
+      }
+
+      .cls-39 {
+        clip-path: url(#clip-path-27);
+      }
+
+      .cls-40 {
+        clip-path: url(#clip-path-28);
+      }
+
+      .cls-41 {
+        fill: #629a00;
+      }
+
+      .cls-42 {
+        fill: url(#linear-gradient-4);
+      }
+
+      .cls-43 {
+        fill: url(#linear-gradient-5);
+      }
+
+      .cls-44 {
+        fill: url(#linear-gradient-6);
+      }
+    </style>
+    <linearGradient id="New_Gradient_Swatch_4" data-name="New Gradient Swatch 4" x1="19.41202" y1="176.86035" x2="273.0417" y2="176.86035" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fafafa"/>
+      <stop offset="1" stop-color="#f5f5f5"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient" x1="19.41517" y1="222.20019" x2="146.22726" y2="222.20019" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#e8e8e8"/>
+      <stop offset="1" stop-color="#fafafa"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient-2" x1="146.22521" y1="222.18105" x2="273.0417" y2="222.18105" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#e8e8e8"/>
+      <stop offset="1" stop-color="#bfbfbf"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient-3" x1="82.8193" y1="251.37619" x2="82.8193" y2="175.56131" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fff" stop-opacity="0"/>
+      <stop offset="0.07729" stop-color="#fff" stop-opacity="0.20984"/>
+      <stop offset="0.18847" stop-color="#fff" stop-opacity="0.48739"/>
+      <stop offset="0.28866" stop-color="#fff" stop-opacity="0.70783"/>
+      <stop offset="0.37409" stop-color="#fff" stop-opacity="0.86665"/>
+      <stop offset="0.44148" stop-color="#fff" stop-opacity="0.96412"/>
+      <stop offset="0.4824" stop-color="#fff"/>
+      <stop offset="1" stop-color="#fff" stop-opacity="0"/>
+    </linearGradient>
+    <clipPath id="clip-path">
+      <path class="cls-1" d="M96.69992,77.63435l3.59062-2.08664c1.60132,25.22727,15.69236,53.68711,34.90423,72.61731l-3.59062,2.08664C112.39228,131.32146,98.30124,102.86162,96.69992,77.63435Z"/>
+    </clipPath>
+    <clipPath id="clip-path-2">
+      <path class="cls-1" d="M96.55979,71.76781l3.59061-2.08664A11.16815,11.16815,0,0,0,102.14,72.56481l-3.59062,2.08664A11.16776,11.16776,0,0,1,96.55979,71.76781Z"/>
+    </clipPath>
+    <clipPath id="clip-path-3">
+      <path class="cls-1" d="M96.83933,66.65908l3.59061-2.08664c-.16039,1.64238-.25083,3.35-.27954,5.10873l-3.59061,2.08664C96.58849,70.00911,96.67894,68.30146,96.83933,66.65908Z"/>
+    </clipPath>
+    <clipPath id="clip-path-4">
+      <path class="cls-1" d="M102.81149,79.02226l3.59061-2.08664q2.06991,1.9307,4.65942,4.05782l-3.59062,2.08664Q104.88684,80.95361,102.81149,79.02226Z"/>
+    </clipPath>
+    <clipPath id="clip-path-5">
+      <path class="cls-1" d="M96.99076,65.26633l3.59061-2.08664a23.07238,23.07238,0,0,1,4.4.61222l-3.59062,2.08664A23.0724,23.0724,0,0,0,96.99076,65.26633Z"/>
+    </clipPath>
+    <clipPath id="clip-path-6">
+      <path class="cls-1" d="M112.2852,86.90162l3.59062-2.08664q2.30167,1.77063,4.867,3.61985l-3.59062,2.08664Q114.58688,88.66975,112.2852,86.90162Z"/>
+    </clipPath>
+    <clipPath id="clip-path-7">
+      <path class="cls-1" d="M122.06632,93.99382l3.59062-2.08664q2.3802,1.64565,4.93945,3.34223l-3.59062,2.08664Q124.45141,95.64414,122.06632,93.99382Z"/>
+    </clipPath>
+    <clipPath id="clip-path-8">
+      <path class="cls-1" d="M106.43072,67.29752l3.59062-2.08664q2.33222.75875,5.04263,1.812l-3.59062,2.08664Q108.76566,68.0572,106.43072,67.29752Z"/>
+    </clipPath>
+    <clipPath id="clip-path-9">
+      <path class="cls-1" d="M131.964,100.56432l3.59061-2.08663c1.60869,1.03734,3.26084,2.07357,4.95527,3.12423l-3.59062,2.08664C135.22485,102.6379,133.5727,101.60167,131.964,100.56432Z"/>
+    </clipPath>
+    <clipPath id="clip-path-10">
+      <path class="cls-1" d="M116.51742,71.18059,120.108,69.094q2.41285,1.04488,5.04352,2.25672l-3.59062,2.08664Q118.93355,72.22176,116.51742,71.18059Z"/>
+    </clipPath>
+    <clipPath id="clip-path-11">
+      <path class="cls-1" d="M126.60839,75.84606l3.59062-2.08664q2.44175,1.20009,5.03625,2.53082l-3.59061,2.08664Q129.055,77.05208,126.60839,75.84606Z"/>
+    </clipPath>
+    <clipPath id="clip-path-12">
+      <path class="cls-1" d="M111.96537,38.87726l3.59062-2.08664c-7.99738,4.64757-13.43786,13.69991-14.97462,26.38907l-3.59061,2.08664C98.52751,52.57717,103.968,43.52483,111.96537,38.87726Z"/>
+    </clipPath>
+    <clipPath id="clip-path-13">
+      <path class="cls-1" d="M190.30956,165.42376l-3.59062,2.08664c-9.6048,5.5817-22.89778,4.80935-37.54727-3.64854a83.82263,83.82263,0,0,1-13.1804-9.52838l3.59062-2.08663a83.8232,83.8232,0,0,0,13.1804,9.52837C167.41178,170.23311,180.70476,171.00546,190.30956,165.42376Z"/>
+    </clipPath>
+    <clipPath id="clip-path-14">
+      <path class="cls-1" d="M154.1471,113.86216l3.59061-2.08663c1.62321.90595,3.21277,1.78874,4.76989,2.63533L158.917,116.4975C157.35986,115.65091,155.7703,114.76812,154.1471,113.86216Z"/>
+    </clipPath>
+    <clipPath id="clip-path-15">
+      <path class="cls-1" d="M136.69573,81.02981l3.59062-2.08664q2.46587,1.3151,5.04541,2.74326l-3.59062,2.08664Q139.16484,82.34741,136.69573,81.02981Z"/>
+    </clipPath>
+    <clipPath id="clip-path-16">
+      <path class="cls-1" d="M163.67515,119.04372l3.59062-2.08664q2.435,1.28981,4.753,2.45962l-3.59062,2.08665Q166.115,120.3307,163.67515,119.04372Z"/>
+    </clipPath>
+    <clipPath id="clip-path-17">
+      <path class="cls-1" d="M173.16845,123.84832l3.59062-2.08664q2.445,1.17952,4.72542,2.22282l-3.59062,2.08664Q175.6162,125.02755,173.16845,123.84832Z"/>
+    </clipPath>
+    <clipPath id="clip-path-18">
+      <path class="cls-1" d="M158.85887,93.70217l3.59062-2.08664q2.47023,1.50292,4.8297,2.98435l-3.59062,2.08664Q161.3291,95.20821,158.85887,93.70217Z"/>
+    </clipPath>
+    <clipPath id="clip-path-19">
+      <path class="cls-1" d="M182.59148,128.14812l3.59062-2.08664q2.46012,1.03287,4.66779,1.87008l-3.59062,2.08665Q185.056,129.17852,182.59148,128.14812Z"/>
+    </clipPath>
+    <clipPath id="clip-path-20">
+      <path class="cls-1" d="M168.51911,99.7587l3.59062-2.08664q2.49436,1.61046,4.84106,3.19308l-3.59062,2.08664Q171.014,101.3651,168.51911,99.7587Z"/>
+    </clipPath>
+    <clipPath id="clip-path-21">
+      <path class="cls-1" d="M191.85718,131.62956l3.59062-2.08664a45.07824,45.07824,0,0,0,4.44484,1.21475l-3.59062,2.08664A45.079,45.079,0,0,1,191.85718,131.62956Z"/>
+    </clipPath>
+    <clipPath id="clip-path-22">
+      <path class="cls-1" d="M178.17813,106.24382l3.59062-2.08664c1.67894,1.16525,3.29057,2.31786,4.83167,3.43972l-3.59062,2.08664C181.4687,108.56168,179.85707,107.40907,178.17813,106.24382Z"/>
+    </clipPath>
+    <clipPath id="clip-path-23">
+      <path class="cls-1" d="M187.83228,113.3039l3.59062-2.08664q2.58446,2.00315,4.81852,3.86016l-3.59062,2.08664Q190.41619,115.30112,187.83228,113.3039Z"/>
+    </clipPath>
+    <clipPath id="clip-path-24">
+      <path class="cls-1" d="M205.43783,130.869l-3.59062,2.08664a3.38107,3.38107,0,0,1-1.50944.34489l3.59061-2.08663A3.38123,3.38123,0,0,0,205.43783,130.869Z"/>
+    </clipPath>
+    <clipPath id="clip-path-25">
+      <path class="cls-1" d="M197.47138,121.39217l3.59062-2.08663c1.64683,1.53505,3.07936,2.99377,4.26983,4.34711l-3.59062,2.08664C200.55074,124.386,199.11822,122.92722,197.47138,121.39217Z"/>
+    </clipPath>
+    <clipPath id="clip-path-26">
+      <path class="cls-1" d="M108.75261,33.28549l3.59062-2.08664c10.43768-6.06572,24.87246-5.21767,40.778,3.96539a88.32433,88.32433,0,0,1,11.55207,8.01468l-3.59062,2.08664a88.32433,88.32433,0,0,0-11.55207-8.01468C133.62507,28.06781,119.19029,27.21977,108.75261,33.28549Z"/>
+    </clipPath>
+    <clipPath id="clip-path-27">
+      <path class="cls-1" d="M193.56562,171.01716l-3.59062,2.08665c10.3077-5.99018,16.70763-18.71246,16.75884-36.77653.00075-.26266-.00572-.52949-.01081-1.279l3.59062-2.08664c.00509.74955.01156,1.01638.01081,1.279C210.27325,152.30471,203.87332,165.027,193.56562,171.01716Z"/>
+    </clipPath>
+    <clipPath id="clip-path-28">
+      <path class="cls-1" d="M165.53648,49.11093l3.59061-2.08663c23.51675,21.46183,40.78294,56.23333,41.18656,85.9373l-3.59062,2.08664C206.31941,105.34427,189.05322,70.57277,165.53648,49.11093Z"/>
+    </clipPath>
+    <linearGradient id="linear-gradient-4" x1="146.73062" y1="31.35912" x2="188.91213" y2="31.35912" xlink:href="#linear-gradient-3"/>
+    <linearGradient id="linear-gradient-5" x1="109.56421" y1="36.98419" x2="160.96562" y2="36.98419" xlink:href="#linear-gradient-3"/>
+    <linearGradient id="linear-gradient-6" x1="2068.6157" y1="-2541.90253" x2="2152.48665" y2="-2541.90253" gradientTransform="translate(-3117.78829 126.29245) rotate(49.6)" xlink:href="#linear-gradient-3"/>
+  </defs>
+  <g id="OBJ">
+    <g>
+      <g class="cls-2">
+        <image width="327" height="219" transform="translate(-16.9622 103.99442)" xlink:href="data:image/png;base64,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"/>
+      </g>
+      <g>
+        <polygon class="cls-3" points="146.227 250.077 19.412 176.86 146.226 103.644 273.042 176.861 146.227 250.077"/>
+        <polygon class="cls-4" points="146.226 267.538 19.415 194.323 19.417 176.863 146.227 250.077 146.226 267.538"/>
+        <polygon class="cls-5" points="273.04 194.285 146.225 267.502 146.227 250.077 273.042 176.861 273.04 194.285"/>
+      </g>
+      <path class="cls-6" d="M19.41183,176.86039c5.59668,2.50928,11.10205,5.17676,16.60937,7.84009l15.84473,9.165,31.70361,18.3042,31.70362,18.30419,15.85205,9.1521c5.05566,3.44556,10.11865,6.87964,15.10156,10.45118-5.58447-2.52979-11.08984-5.19727-16.60156-7.853l-15.85205-9.1521-31.70362-18.3042-31.70361-18.3042L34.50655,187.3245C29.446,183.88627,24.38351,180.45243,19.41183,176.86039Z"/>
+      <g class="cls-7">
+        <image width="188" height="136" transform="translate(36.0378 115.99442)" xlink:href="data:image/png;base64,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BtytgvkpC2U4nxK4u6piAFZrDaUUjcdjarfbV44b+asR4T2nIP4nDW6n05lEUTSerfphGNa01o+YuW6tXdda1zDdrhBlnzkiog4R9YjoYjKZJGEY2g8fPiy3vEOaVmEOeYO7t7dHvV5PvXv3LtjZ2QmMMSVrbTlN08tNZURUgRtJVogoAqCMMalS6lwp1SO3s7IHYLC3txf/9NNPS91nIxVeuMJNVX9ra2swHo9DACVmLmmtI2NMlKZpCECFYWittbG19iIMw2GpVBqNRqP07du3S21YAanwwoLMVv04jlW329WVSkWPRiMNIAjDUCdJQgAQx7GJoiipVqvJcDhM3rx5Y16/fr3U6g5IhRcWZE7Vpzdv3qQvXrygVqtFv//+u2o2m9Tv9wkA6vU6A7DD4dACsK9fv156dQekwgtfSPYLgIODgysTmFevXjHdkz00OSK84BUKguARIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BX/DyPCZGaV2fWkAAAAAElFTkSuQmCC"/>
+      </g>
+      <g class="cls-8">
+        <polygon class="cls-9" points="134.76 158.718 138.35 156.632 131.312 181.7 127.721 183.787 134.76 158.718"/>
+        <g class="cls-8">
+          <g class="cls-10">
+            <g class="cls-8">
+              <path class="cls-11" d="M96.69992,77.63435l3.59062-2.08664q.21131,3.32889.70756,6.72414l-3.59062,2.08664q-.49376-3.39091-.70756-6.72414"/>
+              <path class="cls-12" d="M97.40748,84.35849l3.59062-2.08664c3.41259,23.43664,16.67488,48.62828,34.19667,65.89317l-3.59062,2.08664c-17.52179-17.2649-30.78408-42.45653-34.19667-65.89317"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-11" points="98.549 74.651 102.14 72.565 100.291 75.548 96.7 77.634 98.549 74.651"/>
+        <g class="cls-8">
+          <g class="cls-13">
+            <g class="cls-8">
+              <path class="cls-12" d="M96.55979,71.76781l3.59061-2.08664A11.16815,11.16815,0,0,0,102.14,72.56481l-3.59062,2.08664a11.16776,11.16776,0,0,1-1.98954-2.88364"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-14">
+            <g class="cls-8">
+              <path class="cls-11" d="M96.83933,66.65908l3.59061-2.08664c-.16039,1.64238-.25083,3.35-.27954,5.10873l-3.59061,2.08664c.0287-1.7587.11915-3.46635.27954-5.10873"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M102.81149,79.02226q2.06989,1.93069,4.65941,4.05782l-.97852,4.60512q-2.79207-2.30833-5.03532-4.3884Z"/>
+        <g class="cls-8">
+          <g class="cls-16">
+            <g class="cls-8">
+              <path class="cls-12" d="M102.81149,79.02226l3.59062-2.08664q2.0699,1.9307,4.65941,4.05782l-3.59062,2.08664q-2.58407-2.12647-4.65941-4.05782"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="107.471 83.08 111.062 80.993 110.083 85.599 106.492 87.685 107.471 83.08"/>
+        <g class="cls-8">
+          <g class="cls-17">
+            <g class="cls-8">
+              <path class="cls-12" d="M96.99076,65.26633l3.59061-2.08664a23.07238,23.07238,0,0,1,4.4.61222l-3.59062,2.08663a23.07309,23.07309,0,0,0-4.4-.61221"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="101.391 65.879 104.981 63.792 106.321 69.612 102.731 71.698 101.391 65.879"/>
+        <g class="cls-8">
+          <g class="cls-18">
+            <g class="cls-8">
+              <path class="cls-12" d="M112.2852,86.90162l3.59062-2.08664q2.30167,1.77063,4.867,3.61985l-3.59062,2.08663q-2.56532-1.8517-4.867-3.61984"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="117.152 90.521 120.743 88.435 120.154 93.339 116.564 95.425 117.152 90.521"/>
+        <polygon class="cls-9" points="127.006 97.336 130.596 95.249 130.237 100.315 126.646 102.402 127.006 97.336"/>
+        <g class="cls-8">
+          <g class="cls-19">
+            <g class="cls-8">
+              <path class="cls-12" d="M122.06632,93.99382l3.59062-2.08664q2.3802,1.64565,4.93945,3.34223l-3.59062,2.08664q-2.55437-1.69191-4.93945-3.34223"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="111.473 69.109 115.064 67.023 115.798 72.659 112.208 74.746 111.473 69.109"/>
+        <g class="cls-8">
+          <g class="cls-20">
+            <g class="cls-8">
+              <path class="cls-12" d="M106.43072,67.29752l3.59062-2.08664q2.33222.75875,5.04263,1.812l-3.59062,2.08664q-2.70769-1.05228-5.04263-1.812"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M111.47335,69.10948l.73445,5.63653q-2.58076-.99583-4.80936-1.72969l-.96772-5.7188Q108.76294,68.05627,111.47335,69.10948Z"/>
+        <g class="cls-8">
+          <g class="cls-21">
+            <g class="cls-8">
+              <path class="cls-12" d="M131.964,100.56432l3.59061-2.08663c1.60869,1.03734,3.26084,2.07357,4.95527,3.12423l-3.59061,2.08664c-1.69444-1.05066-3.34659-2.08689-4.95527-3.12424"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="136.919 103.689 140.51 101.602 140.325 106.78 136.734 108.867 136.919 103.689"/>
+        <polygon class="cls-9" points="121.561 73.437 125.152 71.351 125.586 76.865 121.995 78.952 121.561 73.437"/>
+        <path class="cls-15" d="M121.56094,73.43731l.434,5.51423q-2.56068-1.192-4.91337-2.20156l-.56413-5.56939Q118.93028,72.22547,121.56094,73.43731Z"/>
+        <g class="cls-8">
+          <g class="cls-22">
+            <g class="cls-8">
+              <path class="cls-12" d="M116.51742,71.18059,120.108,69.094q2.41285,1.04488,5.04352,2.25672l-3.59062,2.08664q-2.62739-1.21555-5.04352-2.25672"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-23">
+            <g class="cls-8">
+              <path class="cls-12" d="M126.60839,75.84606l3.59062-2.08664q2.44175,1.20009,5.03625,2.53082l-3.59061,2.08664q-2.58966-1.3248-5.03626-2.53082"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="131.645 78.377 135.235 76.29 135.485 81.708 131.894 83.795 131.645 78.377"/>
+        <path class="cls-15" d="M131.64465,78.37688l.24963,5.41777q-2.549-1.30131-4.95929-2.48638l-.3266-5.46221Q129.05014,77.04615,131.64465,78.37688Z"/>
+        <g class="cls-8">
+          <g class="cls-24">
+            <g class="cls-8">
+              <path class="cls-11" d="M111.96537,38.87726l3.59062-2.08664c-7.99738,4.64757-13.43786,13.69991-14.97462,26.38907l-3.59061,2.08664c1.53675-12.68916,6.97723-21.7415,14.97461-26.38907"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-25">
+            <g class="cls-8">
+              <path class="cls-12" d="M135.99127,154.33348l3.59062-2.08664a83.82263,83.82263,0,0,0,13.1804,9.52838c14.64949,8.45789,27.94247,9.23024,37.54727,3.64854l-3.59062,2.08664c-9.6048,5.5817-22.89778,4.80935-37.54727-3.64854a83.82263,83.82263,0,0,1-13.1804-9.52838"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M158.917,116.4975l.11516,5.35137q-2.36334-1.28772-4.82409-2.66664l-.06095-5.32007C155.7703,114.76812,157.35986,115.65091,158.917,116.4975Z"/>
+        <polygon class="cls-9" points="158.917 116.498 162.508 114.411 162.623 119.762 159.032 121.849 158.917 116.498"/>
+        <g class="cls-8">
+          <g class="cls-26">
+            <g class="cls-8">
+              <path class="cls-12" d="M154.1471,113.86216l3.59062-2.08664c1.6232.906,3.21276,1.78875,4.76988,2.63534L158.917,116.4975c-1.55712-.84659-3.14668-1.72938-4.76988-2.63534"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M141.74114,83.77306l.08372,5.332q-2.53566-1.40218-4.96844-2.69881l-.16069-5.37641Q139.1616,82.34491,141.74114,83.77306Z"/>
+        <g class="cls-8">
+          <g class="cls-27">
+            <g class="cls-8">
+              <path class="cls-12" d="M136.69573,81.02981l3.59062-2.08664q2.46587,1.3151,5.04541,2.74326l-3.59062,2.08663q-2.5763-1.42564-5.04541-2.74325"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="141.741 83.773 145.332 81.686 145.415 87.018 141.825 89.105 141.741 83.773"/>
+        <g class="cls-8">
+          <g class="cls-28">
+            <g class="cls-8">
+              <path class="cls-12" d="M163.67515,119.04372l3.59062-2.08664q2.435,1.28981,4.753,2.45962l-3.59062,2.08664q-2.31315-1.17264-4.753-2.45962"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="168.428 121.503 172.019 119.417 172.282 124.844 168.692 126.93 168.428 121.503"/>
+        <polygon class="cls-9" points="177.894 126.071 181.484 123.984 181.949 129.506 178.358 131.593 177.894 126.071"/>
+        <g class="cls-8">
+          <g class="cls-29">
+            <g class="cls-8">
+              <path class="cls-12" d="M173.16845,123.84832l3.59062-2.08664q2.445,1.17952,4.72542,2.22282l-3.59062,2.08664q-2.27767-1.04359-4.72542-2.22282"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M158.85887,93.70217q2.47023,1.50293,4.8297,2.98434l-.21119,5.1617q-2.327-1.45951-4.75923-2.94366Z"/>
+        <g class="cls-8">
+          <g class="cls-30">
+            <g class="cls-8">
+              <path class="cls-12" d="M158.85887,93.70217l3.59062-2.08664q2.47023,1.50292,4.8297,2.98435l-3.59062,2.08663q-2.35947-1.4783-4.8297-2.98434"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="163.689 96.687 167.279 94.6 167.068 99.762 163.477 101.848 163.689 96.687"/>
+        <g class="cls-8">
+          <g class="cls-31">
+            <g class="cls-8">
+              <path class="cls-12" d="M182.59148,128.14812l3.59062-2.08664q2.46012,1.03287,4.66779,1.87008l-3.59062,2.08664q-2.2033-.83967-4.66779-1.87008"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="187.259 130.018 190.85 127.932 191.61 133.582 188.02 135.669 187.259 130.018"/>
+        <path class="cls-15" d="M187.25927,130.0182l.76048,5.65032c-1.51769-.57674-3.12642-1.22726-4.81964-1.93654l-.60863-5.58386Q185.0516,129.181,187.25927,130.0182Z"/>
+        <path class="cls-15" d="M168.51911,99.7587q2.49436,1.61046,4.84106,3.19307l-.40089,5.03221q-2.29253-1.54073-4.72831-3.11674Z"/>
+        <g class="cls-8">
+          <g class="cls-32">
+            <g class="cls-8">
+              <path class="cls-12" d="M168.51911,99.7587l3.59062-2.08664q2.49436,1.61046,4.84106,3.19308l-3.59062,2.08663q-2.34617-1.58667-4.84106-3.19307"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="173.36 102.952 176.951 100.865 176.55 105.897 172.959 107.984 173.36 102.952"/>
+        <g class="cls-8">
+          <g class="cls-33">
+            <g class="cls-8">
+              <path class="cls-12" d="M191.85718,131.62956l3.59062-2.08664a45.07824,45.07824,0,0,0,4.44484,1.21475l-3.59062,2.08664a45.079,45.079,0,0,1-4.44484-1.21475"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="196.302 132.844 199.893 130.758 201.264 136.586 197.673 138.673 196.302 132.844"/>
+        <polygon class="cls-9" points="183.01 109.684 186.6 107.597 185.981 112.483 182.39 114.569 183.01 109.684"/>
+        <g class="cls-8">
+          <g class="cls-34">
+            <g class="cls-8">
+              <path class="cls-12" d="M178.17813,106.24382l3.59062-2.08664c1.67894,1.16525,3.29057,2.31786,4.83167,3.43972l-3.59062,2.08664c-1.5411-1.12186-3.15273-2.27447-4.83167-3.43972"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="192.651 117.164 196.241 115.077 195.231 119.656 191.641 121.742 192.651 117.164"/>
+        <g class="cls-8">
+          <g class="cls-35">
+            <g class="cls-8">
+              <path class="cls-12" d="M187.83228,113.3039l3.59062-2.08664q2.58446,2.00315,4.81852,3.86016l-3.59062,2.08664q-2.23461-1.86294-4.81852-3.86016"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-36">
+            <g class="cls-8">
+              <path class="cls-12" d="M200.33777,133.30052l3.59062-2.08664a3.38111,3.38111,0,0,0,1.50944-.34489l-3.59062,2.08664a3.38107,3.38107,0,0,1-1.50944.34489"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-11" points="201.866 127.097 205.457 125.011 203.749 127.741 200.159 129.828 201.866 127.097"/>
+        <g class="cls-8">
+          <g class="cls-37">
+            <g class="cls-8">
+              <path class="cls-12" d="M197.47138,121.39217l3.59062-2.08664c1.64683,1.53506,3.07936,2.99378,4.26983,4.34712l-3.59062,2.08664c-1.19047-1.35334-2.623-2.81207-4.26983-4.34712"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="164.306 53.496 167.897 51.41 139.582 152.247 135.991 154.333 164.306 53.496"/>
+        <g class="cls-8">
+          <g class="cls-38">
+            <g class="cls-8">
+              <path class="cls-12" d="M108.75261,33.28549l3.59062-2.08664c10.43768-6.06572,24.87246-5.21767,40.778,3.96539a88.32433,88.32433,0,0,1,11.55207,8.01468l-3.59062,2.08664a88.32433,88.32433,0,0,0-11.55207-8.01468c-15.90554-9.18307-30.34032-10.03111-40.778-3.96539"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="173.07 22.277 176.661 20.19 169.127 47.024 165.536 49.111 173.07 22.277"/>
+        <path class="cls-15" d="M206.723,135.04824c.00509.74955.01156,1.01638.01081,1.279-.10309,36.36319-25.93258,51.08027-57.57713,32.81028a91.12,91.12,0,0,1-14.39692-10.41916L127.721,183.78653l-4.42255-3.953,7.07218-25.18636c-22.415-21.91959-38.49669-55.78677-38.415-84.58722.00064-.2248.00642-.44544.00809-.66965.22341-16.21607,5.58029-28.03748,14.28042-34.45712,10.56644-7.79674,26.06432-7.6256,43.28656,2.31766a88.32433,88.32433,0,0,1,11.55207,8.01468l7.55143-26.89114L145.09,20.3972l1.69877-6.23289,26.37793-2.26507,15.112,39.02308-1.70084,6.23644L173.07021,22.27713l-7.53373,26.8338C189.05322,70.57277,206.31941,105.34427,206.723,135.04824Zm-4.721,2.73761-1.66425-4.48533c1.39046-.073,1.72785-.48616,1.79623-.59719-.01951-1.84816-.10909-3.72018-.26773-5.606l-1.70739,2.7307a50.84393,50.84393,0,0,0-4.06093-4.18266l1.37343-4.25319c1.64684,1.53505,3.07936,2.99378,4.26983,4.34712-2.60151-25.66963-17.59608-54.1048-37.43519-72.24285l-28.31475,100.837a83.82263,83.82263,0,0,0,13.1804,9.52838c27.89041,16.10254,50.86395,4.34778,52.83035-26.076m-70.39787,12.46581,28.24495-100.587a81.006,81.006,0,0,0-10.33344-7.13926c-26.84634-15.49974-49.14232-5.1895-52.5249,22.74093a23.07309,23.07309,0,0,1,4.4.61221l1.33972,5.81963a18.04675,18.04675,0,0,0-4.25794-.53255l-1.63325-4.50654c-.16039,1.64238-.25084,3.35-.27954,5.10873a11.16776,11.16776,0,0,0,1.98954,2.88364l-1.84941,2.9829c1.60132,25.22727,15.69236,53.68711,34.90423,72.61731"/>
+        <path class="cls-15" d="M112.2852,86.90162q2.30169,1.77063,4.867,3.61984l-.5884,4.904q-2.65959-1.923-5.04687-3.7549Z"/>
+        <path class="cls-15" d="M122.06632,93.99382q2.38022,1.64565,4.93945,3.34223l-.35972,5.066q-2.60964-1.7388-5.04242-3.41166Z"/>
+        <path class="cls-15" d="M131.964,100.56432c1.60868,1.03735,3.26083,2.07358,4.95527,3.12424l-.18517,5.178q-2.58886-1.60324-5.04959-3.18867Z"/>
+        <path class="cls-15" d="M168.42815,121.50334l.26372,5.42716q-2.3554-1.19892-4.83-2.49535l-.18672-5.39143Q166.11015,120.33353,168.42815,121.50334Z"/>
+        <path class="cls-15" d="M177.89387,126.07114l.46436,5.52178q-2.33136-1.05963-4.83279-2.27483l-.357-5.46977Q175.61348,125.02785,177.89387,126.07114Z"/>
+        <path class="cls-15" d="M196.302,132.84431l1.37142,5.82833c-1.42941-.30364-3.04742-.74363-4.83552-1.31551l-.98074-5.72757A45.079,45.079,0,0,0,196.302,132.84431Z"/>
+        <path class="cls-15" d="M178.17813,106.24382c1.67894,1.16525,3.29057,2.31786,4.83167,3.43972l-.61984,4.88583q-2.245-1.64618-4.69726-3.35214Z"/>
+        <path class="cls-15" d="M187.83228,113.3039q2.58446,2.00315,4.81852,3.86016l-1.00993,4.57825c-1.41823-1.18071-2.95252-2.4122-4.59531-3.68013Z"/>
+        <g class="cls-8">
+          <g class="cls-39">
+            <g class="cls-8">
+              <path class="cls-11" d="M206.723,135.04824l3.59062-2.08664c.00509.74955.01156,1.01638.01081,1.279-.05121,18.06407-6.45114,30.78635-16.75884,36.77652L189.975,173.1038c10.3077-5.99017,16.70763-18.71245,16.75884-36.77652.00075-.26266-.00572-.52949-.01081-1.279"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-40">
+            <g class="cls-8">
+              <path class="cls-12" d="M165.53648,49.11093l3.59061-2.08664c20.56879,18.77148,36.35589,47.72488,40.26074,74.56393l-3.59062,2.08664c-3.90485-26.839-19.69194-55.79245-40.26073-74.56393"/>
+              <path class="cls-11" d="M205.79721,123.67486l3.59062-2.08664a87.34653,87.34653,0,0,1,.92582,11.37338l-3.59062,2.08664a87.34653,87.34653,0,0,0-.92582-11.37338"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="188.279 50.922 191.869 48.836 190.168 55.072 186.578 57.159 188.279 50.922"/>
+        <polygon class="cls-11" points="173.167 11.899 176.757 9.813 191.869 48.836 188.279 50.922 173.167 11.899"/>
+        <polygon class="cls-41" points="146.789 14.164 150.379 12.078 176.757 9.813 173.167 11.899 146.789 14.164"/>
+      </g>
+      <path class="cls-42" d="M188.21537,50.94685c-1.542-3.14246-2.98231-6.32431-4.38758-9.51971l-1.05166-2.39744c-.35142-.79882-.68413-1.60487-1.02712-2.40694-.67666-1.60777-1.37439-3.20738-2.02555-4.825L177.74119,26.956l-1.9209-4.86553-.96-2.433-.92973-2.44466-1.85822-4.8898,1.1947.74542-6.60513.44188q-3.30536.18876-6.61234.35819c-2.20673.08941-4.41176.19788-6.62143.25259l-1.65651.04981-1.65814.0306c-1.10485.02722-2.21236.02342-3.319.03045l-.01161-.13536,26.37343-2.31735.08984-.00789.03275.08439c1.26166,3.251,2.541,6.49519,3.78746,9.75211l3.75856,9.7633,7.51707,19.5266Z"/>
+      <path class="cls-43" d="M160.10027,45.53611a75.99753,75.99753,0,0,0-20.526-12.51332,44.77388,44.77388,0,0,0-15.69825-3.22987,32.15388,32.15388,0,0,0-10.05162,1.41858,18.10493,18.10493,0,0,0-3.55093,1.49014l-.70929-1.15871c.21194-.12985,5.29853-3.17978,14.22246-3.10947a46.02237,46.02237,0,0,1,16.20754,3.295,77.25956,77.25956,0,0,1,20.97141,12.76018Z"/>
+      <path class="cls-44" d="M205.12005,123.72819a88.449,88.449,0,0,0-7.71363-28.97294,130.39944,130.39944,0,0,0-13.83506-23.57532,147.06,147.06,0,0,0-19.1583-21.63625l.89586-1.02123a148.42919,148.42919,0,0,1,19.34039,21.83012,131.78833,131.78833,0,0,1,13.98995,23.8317,89.80922,89.80922,0,0,1,7.835,29.43729Z"/>
+    </g>
+  </g>
+</svg>
diff --git a/pr-2241/_static/cudaq_override.css b/pr-2241/_static/cudaq_override.css
new file mode 100644
index 0000000000..4ab0ac179a
--- /dev/null
+++ b/pr-2241/_static/cudaq_override.css
@@ -0,0 +1,27 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ *                                                                             *
+ * File: cudaq_override.css                                                    *
+ * Created Date: 16 Feb 2023                                                   *
+ * Last Modified: 16 Feb 2023                                                  *
+ ******************************************************************************/
+
+.wy-nav-content {
+max-width: 1240px !important;
+}
+
+.wy-menu-vertical a {
+	font-size: 92%;
+}
+
+.wy-menu-vertical li code, .wy-menu-vertical li .rst-content tt, .rst-content .wy-menu-vertical li tt {
+    font-size: 100%;
+}
+
+code.code span.pre, code.cpp span.pre, code.docutils span.pre{
+    color: darkgreen;
+}
diff --git a/pr-2241/_static/devContainersExtension.png b/pr-2241/_static/devContainersExtension.png
new file mode 100644
index 0000000000..f863a09331
Binary files /dev/null and b/pr-2241/_static/devContainersExtension.png differ
diff --git a/pr-2241/_static/dialects.png b/pr-2241/_static/dialects.png
new file mode 100644
index 0000000000..9890d3d6dd
Binary files /dev/null and b/pr-2241/_static/dialects.png differ
diff --git a/pr-2241/_static/doctools.js b/pr-2241/_static/doctools.js
new file mode 100644
index 0000000000..527b876ca6
--- /dev/null
+++ b/pr-2241/_static/doctools.js
@@ -0,0 +1,156 @@
+/*
+ * doctools.js
+ * ~~~~~~~~~~~
+ *
+ * Base JavaScript utilities for all Sphinx HTML documentation.
+ *
+ * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+"use strict";
+
+const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([
+  "TEXTAREA",
+  "INPUT",
+  "SELECT",
+  "BUTTON",
+]);
+
+const _ready = (callback) => {
+  if (document.readyState !== "loading") {
+    callback();
+  } else {
+    document.addEventListener("DOMContentLoaded", callback);
+  }
+};
+
+/**
+ * Small JavaScript module for the documentation.
+ */
+const Documentation = {
+  init: () => {
+    Documentation.initDomainIndexTable();
+    Documentation.initOnKeyListeners();
+  },
+
+  /**
+   * i18n support
+   */
+  TRANSLATIONS: {},
+  PLURAL_EXPR: (n) => (n === 1 ? 0 : 1),
+  LOCALE: "unknown",
+
+  // gettext and ngettext don't access this so that the functions
+  // can safely bound to a different name (_ = Documentation.gettext)
+  gettext: (string) => {
+    const translated = Documentation.TRANSLATIONS[string];
+    switch (typeof translated) {
+      case "undefined":
+        return string; // no translation
+      case "string":
+        return translated; // translation exists
+      default:
+        return translated[0]; // (singular, plural) translation tuple exists
+    }
+  },
+
+  ngettext: (singular, plural, n) => {
+    const translated = Documentation.TRANSLATIONS[singular];
+    if (typeof translated !== "undefined")
+      return translated[Documentation.PLURAL_EXPR(n)];
+    return n === 1 ? singular : plural;
+  },
+
+  addTranslations: (catalog) => {
+    Object.assign(Documentation.TRANSLATIONS, catalog.messages);
+    Documentation.PLURAL_EXPR = new Function(
+      "n",
+      `return (${catalog.plural_expr})`
+    );
+    Documentation.LOCALE = catalog.locale;
+  },
+
+  /**
+   * helper function to focus on search bar
+   */
+  focusSearchBar: () => {
+    document.querySelectorAll("input[name=q]")[0]?.focus();
+  },
+
+  /**
+   * Initialise the domain index toggle buttons
+   */
+  initDomainIndexTable: () => {
+    const toggler = (el) => {
+      const idNumber = el.id.substr(7);
+      const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`);
+      if (el.src.substr(-9) === "minus.png") {
+        el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`;
+        toggledRows.forEach((el) => (el.style.display = "none"));
+      } else {
+        el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`;
+        toggledRows.forEach((el) => (el.style.display = ""));
+      }
+    };
+
+    const togglerElements = document.querySelectorAll("img.toggler");
+    togglerElements.forEach((el) =>
+      el.addEventListener("click", (event) => toggler(event.currentTarget))
+    );
+    togglerElements.forEach((el) => (el.style.display = ""));
+    if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler);
+  },
+
+  initOnKeyListeners: () => {
+    // only install a listener if it is really needed
+    if (
+      !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS &&
+      !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS
+    )
+      return;
+
+    document.addEventListener("keydown", (event) => {
+      // bail for input elements
+      if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return;
+      // bail with special keys
+      if (event.altKey || event.ctrlKey || event.metaKey) return;
+
+      if (!event.shiftKey) {
+        switch (event.key) {
+          case "ArrowLeft":
+            if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
+
+            const prevLink = document.querySelector('link[rel="prev"]');
+            if (prevLink && prevLink.href) {
+              window.location.href = prevLink.href;
+              event.preventDefault();
+            }
+            break;
+          case "ArrowRight":
+            if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break;
+
+            const nextLink = document.querySelector('link[rel="next"]');
+            if (nextLink && nextLink.href) {
+              window.location.href = nextLink.href;
+              event.preventDefault();
+            }
+            break;
+        }
+      }
+
+      // some keyboard layouts may need Shift to get /
+      switch (event.key) {
+        case "/":
+          if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break;
+          Documentation.focusSearchBar();
+          event.preventDefault();
+      }
+    });
+  },
+};
+
+// quick alias for translations
+const _ = Documentation.gettext;
+
+_ready(Documentation.init);
diff --git a/pr-2241/_static/documentation_options.js b/pr-2241/_static/documentation_options.js
new file mode 100644
index 0000000000..b57ae3b839
--- /dev/null
+++ b/pr-2241/_static/documentation_options.js
@@ -0,0 +1,14 @@
+var DOCUMENTATION_OPTIONS = {
+    URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
+    VERSION: '',
+    LANGUAGE: 'en',
+    COLLAPSE_INDEX: false,
+    BUILDER: 'html',
+    FILE_SUFFIX: '.html',
+    LINK_SUFFIX: '.html',
+    HAS_SOURCE: true,
+    SOURCELINK_SUFFIX: '.txt',
+    NAVIGATION_WITH_KEYS: false,
+    SHOW_SEARCH_SUMMARY: true,
+    ENABLE_SEARCH_SHORTCUTS: true,
+};
\ No newline at end of file
diff --git a/pr-2241/_static/file.png b/pr-2241/_static/file.png
new file mode 100644
index 0000000000..a858a410e4
Binary files /dev/null and b/pr-2241/_static/file.png differ
diff --git a/pr-2241/_static/getToWork.png b/pr-2241/_static/getToWork.png
new file mode 100644
index 0000000000..06eee986fb
Binary files /dev/null and b/pr-2241/_static/getToWork.png differ
diff --git a/pr-2241/_static/jquery-3.6.0.js b/pr-2241/_static/jquery-3.6.0.js
new file mode 100644
index 0000000000..fc6c299b73
--- /dev/null
+++ b/pr-2241/_static/jquery-3.6.0.js
@@ -0,0 +1,10881 @@
+/*!
+ * jQuery JavaScript Library v3.6.0
+ * https://jquery.com/
+ *
+ * Includes Sizzle.js
+ * https://sizzlejs.com/
+ *
+ * Copyright OpenJS Foundation and other contributors
+ * Released under the MIT license
+ * https://jquery.org/license
+ *
+ * Date: 2021-03-02T17:08Z
+ */
+( function( global, factory ) {
+
+	"use strict";
+
+	if ( typeof module === "object" && typeof module.exports === "object" ) {
+
+		// For CommonJS and CommonJS-like environments where a proper `window`
+		// is present, execute the factory and get jQuery.
+		// For environments that do not have a `window` with a `document`
+		// (such as Node.js), expose a factory as module.exports.
+		// This accentuates the need for the creation of a real `window`.
+		// e.g. var jQuery = require("jquery")(window);
+		// See ticket #14549 for more info.
+		module.exports = global.document ?
+			factory( global, true ) :
+			function( w ) {
+				if ( !w.document ) {
+					throw new Error( "jQuery requires a window with a document" );
+				}
+				return factory( w );
+			};
+	} else {
+		factory( global );
+	}
+
+// Pass this if window is not defined yet
+} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) {
+
+// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1
+// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode
+// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common
+// enough that all such attempts are guarded in a try block.
+"use strict";
+
+var arr = [];
+
+var getProto = Object.getPrototypeOf;
+
+var slice = arr.slice;
+
+var flat = arr.flat ? function( array ) {
+	return arr.flat.call( array );
+} : function( array ) {
+	return arr.concat.apply( [], array );
+};
+
+
+var push = arr.push;
+
+var indexOf = arr.indexOf;
+
+var class2type = {};
+
+var toString = class2type.toString;
+
+var hasOwn = class2type.hasOwnProperty;
+
+var fnToString = hasOwn.toString;
+
+var ObjectFunctionString = fnToString.call( Object );
+
+var support = {};
+
+var isFunction = function isFunction( obj ) {
+
+		// Support: Chrome <=57, Firefox <=52
+		// In some browsers, typeof returns "function" for HTML <object> elements
+		// (i.e., `typeof document.createElement( "object" ) === "function"`).
+		// We don't want to classify *any* DOM node as a function.
+		// Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5
+		// Plus for old WebKit, typeof returns "function" for HTML collections
+		// (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756)
+		return typeof obj === "function" && typeof obj.nodeType !== "number" &&
+			typeof obj.item !== "function";
+	};
+
+
+var isWindow = function isWindow( obj ) {
+		return obj != null && obj === obj.window;
+	};
+
+
+var document = window.document;
+
+
+
+	var preservedScriptAttributes = {
+		type: true,
+		src: true,
+		nonce: true,
+		noModule: true
+	};
+
+	function DOMEval( code, node, doc ) {
+		doc = doc || document;
+
+		var i, val,
+			script = doc.createElement( "script" );
+
+		script.text = code;
+		if ( node ) {
+			for ( i in preservedScriptAttributes ) {
+
+				// Support: Firefox 64+, Edge 18+
+				// Some browsers don't support the "nonce" property on scripts.
+				// On the other hand, just using `getAttribute` is not enough as
+				// the `nonce` attribute is reset to an empty string whenever it
+				// becomes browsing-context connected.
+				// See https://github.com/whatwg/html/issues/2369
+				// See https://html.spec.whatwg.org/#nonce-attributes
+				// The `node.getAttribute` check was added for the sake of
+				// `jQuery.globalEval` so that it can fake a nonce-containing node
+				// via an object.
+				val = node[ i ] || node.getAttribute && node.getAttribute( i );
+				if ( val ) {
+					script.setAttribute( i, val );
+				}
+			}
+		}
+		doc.head.appendChild( script ).parentNode.removeChild( script );
+	}
+
+
+function toType( obj ) {
+	if ( obj == null ) {
+		return obj + "";
+	}
+
+	// Support: Android <=2.3 only (functionish RegExp)
+	return typeof obj === "object" || typeof obj === "function" ?
+		class2type[ toString.call( obj ) ] || "object" :
+		typeof obj;
+}
+/* global Symbol */
+// Defining this global in .eslintrc.json would create a danger of using the global
+// unguarded in another place, it seems safer to define global only for this module
+
+
+
+var
+	version = "3.6.0",
+
+	// Define a local copy of jQuery
+	jQuery = function( selector, context ) {
+
+		// The jQuery object is actually just the init constructor 'enhanced'
+		// Need init if jQuery is called (just allow error to be thrown if not included)
+		return new jQuery.fn.init( selector, context );
+	};
+
+jQuery.fn = jQuery.prototype = {
+
+	// The current version of jQuery being used
+	jquery: version,
+
+	constructor: jQuery,
+
+	// The default length of a jQuery object is 0
+	length: 0,
+
+	toArray: function() {
+		return slice.call( this );
+	},
+
+	// Get the Nth element in the matched element set OR
+	// Get the whole matched element set as a clean array
+	get: function( num ) {
+
+		// Return all the elements in a clean array
+		if ( num == null ) {
+			return slice.call( this );
+		}
+
+		// Return just the one element from the set
+		return num < 0 ? this[ num + this.length ] : this[ num ];
+	},
+
+	// Take an array of elements and push it onto the stack
+	// (returning the new matched element set)
+	pushStack: function( elems ) {
+
+		// Build a new jQuery matched element set
+		var ret = jQuery.merge( this.constructor(), elems );
+
+		// Add the old object onto the stack (as a reference)
+		ret.prevObject = this;
+
+		// Return the newly-formed element set
+		return ret;
+	},
+
+	// Execute a callback for every element in the matched set.
+	each: function( callback ) {
+		return jQuery.each( this, callback );
+	},
+
+	map: function( callback ) {
+		return this.pushStack( jQuery.map( this, function( elem, i ) {
+			return callback.call( elem, i, elem );
+		} ) );
+	},
+
+	slice: function() {
+		return this.pushStack( slice.apply( this, arguments ) );
+	},
+
+	first: function() {
+		return this.eq( 0 );
+	},
+
+	last: function() {
+		return this.eq( -1 );
+	},
+
+	even: function() {
+		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
+			return ( i + 1 ) % 2;
+		} ) );
+	},
+
+	odd: function() {
+		return this.pushStack( jQuery.grep( this, function( _elem, i ) {
+			return i % 2;
+		} ) );
+	},
+
+	eq: function( i ) {
+		var len = this.length,
+			j = +i + ( i < 0 ? len : 0 );
+		return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] );
+	},
+
+	end: function() {
+		return this.prevObject || this.constructor();
+	},
+
+	// For internal use only.
+	// Behaves like an Array's method, not like a jQuery method.
+	push: push,
+	sort: arr.sort,
+	splice: arr.splice
+};
+
+jQuery.extend = jQuery.fn.extend = function() {
+	var options, name, src, copy, copyIsArray, clone,
+		target = arguments[ 0 ] || {},
+		i = 1,
+		length = arguments.length,
+		deep = false;
+
+	// Handle a deep copy situation
+	if ( typeof target === "boolean" ) {
+		deep = target;
+
+		// Skip the boolean and the target
+		target = arguments[ i ] || {};
+		i++;
+	}
+
+	// Handle case when target is a string or something (possible in deep copy)
+	if ( typeof target !== "object" && !isFunction( target ) ) {
+		target = {};
+	}
+
+	// Extend jQuery itself if only one argument is passed
+	if ( i === length ) {
+		target = this;
+		i--;
+	}
+
+	for ( ; i < length; i++ ) {
+
+		// Only deal with non-null/undefined values
+		if ( ( options = arguments[ i ] ) != null ) {
+
+			// Extend the base object
+			for ( name in options ) {
+				copy = options[ name ];
+
+				// Prevent Object.prototype pollution
+				// Prevent never-ending loop
+				if ( name === "__proto__" || target === copy ) {
+					continue;
+				}
+
+				// Recurse if we're merging plain objects or arrays
+				if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
+					( copyIsArray = Array.isArray( copy ) ) ) ) {
+					src = target[ name ];
+
+					// Ensure proper type for the source value
+					if ( copyIsArray && !Array.isArray( src ) ) {
+						clone = [];
+					} else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) {
+						clone = {};
+					} else {
+						clone = src;
+					}
+					copyIsArray = false;
+
+					// Never move original objects, clone them
+					target[ name ] = jQuery.extend( deep, clone, copy );
+
+				// Don't bring in undefined values
+				} else if ( copy !== undefined ) {
+					target[ name ] = copy;
+				}
+			}
+		}
+	}
+
+	// Return the modified object
+	return target;
+};
+
+jQuery.extend( {
+
+	// Unique for each copy of jQuery on the page
+	expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ),
+
+	// Assume jQuery is ready without the ready module
+	isReady: true,
+
+	error: function( msg ) {
+		throw new Error( msg );
+	},
+
+	noop: function() {},
+
+	isPlainObject: function( obj ) {
+		var proto, Ctor;
+
+		// Detect obvious negatives
+		// Use toString instead of jQuery.type to catch host objects
+		if ( !obj || toString.call( obj ) !== "[object Object]" ) {
+			return false;
+		}
+
+		proto = getProto( obj );
+
+		// Objects with no prototype (e.g., `Object.create( null )`) are plain
+		if ( !proto ) {
+			return true;
+		}
+
+		// Objects with prototype are plain iff they were constructed by a global Object function
+		Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor;
+		return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString;
+	},
+
+	isEmptyObject: function( obj ) {
+		var name;
+
+		for ( name in obj ) {
+			return false;
+		}
+		return true;
+	},
+
+	// Evaluates a script in a provided context; falls back to the global one
+	// if not specified.
+	globalEval: function( code, options, doc ) {
+		DOMEval( code, { nonce: options && options.nonce }, doc );
+	},
+
+	each: function( obj, callback ) {
+		var length, i = 0;
+
+		if ( isArrayLike( obj ) ) {
+			length = obj.length;
+			for ( ; i < length; i++ ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		} else {
+			for ( i in obj ) {
+				if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) {
+					break;
+				}
+			}
+		}
+
+		return obj;
+	},
+
+	// results is for internal usage only
+	makeArray: function( arr, results ) {
+		var ret = results || [];
+
+		if ( arr != null ) {
+			if ( isArrayLike( Object( arr ) ) ) {
+				jQuery.merge( ret,
+					typeof arr === "string" ?
+						[ arr ] : arr
+				);
+			} else {
+				push.call( ret, arr );
+			}
+		}
+
+		return ret;
+	},
+
+	inArray: function( elem, arr, i ) {
+		return arr == null ? -1 : indexOf.call( arr, elem, i );
+	},
+
+	// Support: Android <=4.0 only, PhantomJS 1 only
+	// push.apply(_, arraylike) throws on ancient WebKit
+	merge: function( first, second ) {
+		var len = +second.length,
+			j = 0,
+			i = first.length;
+
+		for ( ; j < len; j++ ) {
+			first[ i++ ] = second[ j ];
+		}
+
+		first.length = i;
+
+		return first;
+	},
+
+	grep: function( elems, callback, invert ) {
+		var callbackInverse,
+			matches = [],
+			i = 0,
+			length = elems.length,
+			callbackExpect = !invert;
+
+		// Go through the array, only saving the items
+		// that pass the validator function
+		for ( ; i < length; i++ ) {
+			callbackInverse = !callback( elems[ i ], i );
+			if ( callbackInverse !== callbackExpect ) {
+				matches.push( elems[ i ] );
+			}
+		}
+
+		return matches;
+	},
+
+	// arg is for internal usage only
+	map: function( elems, callback, arg ) {
+		var length, value,
+			i = 0,
+			ret = [];
+
+		// Go through the array, translating each of the items to their new values
+		if ( isArrayLike( elems ) ) {
+			length = elems.length;
+			for ( ; i < length; i++ ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+
+		// Go through every key on the object,
+		} else {
+			for ( i in elems ) {
+				value = callback( elems[ i ], i, arg );
+
+				if ( value != null ) {
+					ret.push( value );
+				}
+			}
+		}
+
+		// Flatten any nested arrays
+		return flat( ret );
+	},
+
+	// A global GUID counter for objects
+	guid: 1,
+
+	// jQuery.support is not used in Core but other projects attach their
+	// properties to it so it needs to exist.
+	support: support
+} );
+
+if ( typeof Symbol === "function" ) {
+	jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ];
+}
+
+// Populate the class2type map
+jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ),
+	function( _i, name ) {
+		class2type[ "[object " + name + "]" ] = name.toLowerCase();
+	} );
+
+function isArrayLike( obj ) {
+
+	// Support: real iOS 8.2 only (not reproducible in simulator)
+	// `in` check used to prevent JIT error (gh-2145)
+	// hasOwn isn't used here due to false negatives
+	// regarding Nodelist length in IE
+	var length = !!obj && "length" in obj && obj.length,
+		type = toType( obj );
+
+	if ( isFunction( obj ) || isWindow( obj ) ) {
+		return false;
+	}
+
+	return type === "array" || length === 0 ||
+		typeof length === "number" && length > 0 && ( length - 1 ) in obj;
+}
+var Sizzle =
+/*!
+ * Sizzle CSS Selector Engine v2.3.6
+ * https://sizzlejs.com/
+ *
+ * Copyright JS Foundation and other contributors
+ * Released under the MIT license
+ * https://js.foundation/
+ *
+ * Date: 2021-02-16
+ */
+( function( window ) {
+var i,
+	support,
+	Expr,
+	getText,
+	isXML,
+	tokenize,
+	compile,
+	select,
+	outermostContext,
+	sortInput,
+	hasDuplicate,
+
+	// Local document vars
+	setDocument,
+	document,
+	docElem,
+	documentIsHTML,
+	rbuggyQSA,
+	rbuggyMatches,
+	matches,
+	contains,
+
+	// Instance-specific data
+	expando = "sizzle" + 1 * new Date(),
+	preferredDoc = window.document,
+	dirruns = 0,
+	done = 0,
+	classCache = createCache(),
+	tokenCache = createCache(),
+	compilerCache = createCache(),
+	nonnativeSelectorCache = createCache(),
+	sortOrder = function( a, b ) {
+		if ( a === b ) {
+			hasDuplicate = true;
+		}
+		return 0;
+	},
+
+	// Instance methods
+	hasOwn = ( {} ).hasOwnProperty,
+	arr = [],
+	pop = arr.pop,
+	pushNative = arr.push,
+	push = arr.push,
+	slice = arr.slice,
+
+	// Use a stripped-down indexOf as it's faster than native
+	// https://jsperf.com/thor-indexof-vs-for/5
+	indexOf = function( list, elem ) {
+		var i = 0,
+			len = list.length;
+		for ( ; i < len; i++ ) {
+			if ( list[ i ] === elem ) {
+				return i;
+			}
+		}
+		return -1;
+	},
+
+	booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" +
+		"ismap|loop|multiple|open|readonly|required|scoped",
+
+	// Regular expressions
+
+	// http://www.w3.org/TR/css3-selectors/#whitespace
+	whitespace = "[\\x20\\t\\r\\n\\f]",
+
+	// https://www.w3.org/TR/css-syntax-3/#ident-token-diagram
+	identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace +
+		"?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+",
+
+	// Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors
+	attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace +
+
+		// Operator (capture 2)
+		"*([*^$|!~]?=)" + whitespace +
+
+		// "Attribute values must be CSS identifiers [capture 5]
+		// or strings [capture 3 or capture 4]"
+		"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" +
+		whitespace + "*\\]",
+
+	pseudos = ":(" + identifier + ")(?:\\((" +
+
+		// To reduce the number of selectors needing tokenize in the preFilter, prefer arguments:
+		// 1. quoted (capture 3; capture 4 or capture 5)
+		"('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" +
+
+		// 2. simple (capture 6)
+		"((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" +
+
+		// 3. anything else (capture 2)
+		".*" +
+		")\\)|)",
+
+	// Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter
+	rwhitespace = new RegExp( whitespace + "+", "g" ),
+	rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" +
+		whitespace + "+$", "g" ),
+
+	rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ),
+	rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace +
+		"*" ),
+	rdescend = new RegExp( whitespace + "|>" ),
+
+	rpseudo = new RegExp( pseudos ),
+	ridentifier = new RegExp( "^" + identifier + "$" ),
+
+	matchExpr = {
+		"ID": new RegExp( "^#(" + identifier + ")" ),
+		"CLASS": new RegExp( "^\\.(" + identifier + ")" ),
+		"TAG": new RegExp( "^(" + identifier + "|[*])" ),
+		"ATTR": new RegExp( "^" + attributes ),
+		"PSEUDO": new RegExp( "^" + pseudos ),
+		"CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" +
+			whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" +
+			whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ),
+		"bool": new RegExp( "^(?:" + booleans + ")$", "i" ),
+
+		// For use in libraries implementing .is()
+		// We use this for POS matching in `select`
+		"needsContext": new RegExp( "^" + whitespace +
+			"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace +
+			"*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" )
+	},
+
+	rhtml = /HTML$/i,
+	rinputs = /^(?:input|select|textarea|button)$/i,
+	rheader = /^h\d$/i,
+
+	rnative = /^[^{]+\{\s*\[native \w/,
+
+	// Easily-parseable/retrievable ID or TAG or CLASS selectors
+	rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,
+
+	rsibling = /[+~]/,
+
+	// CSS escapes
+	// http://www.w3.org/TR/CSS21/syndata.html#escaped-characters
+	runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ),
+	funescape = function( escape, nonHex ) {
+		var high = "0x" + escape.slice( 1 ) - 0x10000;
+
+		return nonHex ?
+
+			// Strip the backslash prefix from a non-hex escape sequence
+			nonHex :
+
+			// Replace a hexadecimal escape sequence with the encoded Unicode code point
+			// Support: IE <=11+
+			// For values outside the Basic Multilingual Plane (BMP), manually construct a
+			// surrogate pair
+			high < 0 ?
+				String.fromCharCode( high + 0x10000 ) :
+				String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 );
+	},
+
+	// CSS string/identifier serialization
+	// https://drafts.csswg.org/cssom/#common-serializing-idioms
+	rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,
+	fcssescape = function( ch, asCodePoint ) {
+		if ( asCodePoint ) {
+
+			// U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER
+			if ( ch === "\0" ) {
+				return "\uFFFD";
+			}
+
+			// Control characters and (dependent upon position) numbers get escaped as code points
+			return ch.slice( 0, -1 ) + "\\" +
+				ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " ";
+		}
+
+		// Other potentially-special ASCII characters get backslash-escaped
+		return "\\" + ch;
+	},
+
+	// Used for iframes
+	// See setDocument()
+	// Removing the function wrapper causes a "Permission Denied"
+	// error in IE
+	unloadHandler = function() {
+		setDocument();
+	},
+
+	inDisabledFieldset = addCombinator(
+		function( elem ) {
+			return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset";
+		},
+		{ dir: "parentNode", next: "legend" }
+	);
+
+// Optimize for push.apply( _, NodeList )
+try {
+	push.apply(
+		( arr = slice.call( preferredDoc.childNodes ) ),
+		preferredDoc.childNodes
+	);
+
+	// Support: Android<4.0
+	// Detect silently failing push.apply
+	// eslint-disable-next-line no-unused-expressions
+	arr[ preferredDoc.childNodes.length ].nodeType;
+} catch ( e ) {
+	push = { apply: arr.length ?
+
+		// Leverage slice if possible
+		function( target, els ) {
+			pushNative.apply( target, slice.call( els ) );
+		} :
+
+		// Support: IE<9
+		// Otherwise append directly
+		function( target, els ) {
+			var j = target.length,
+				i = 0;
+
+			// Can't trust NodeList.length
+			while ( ( target[ j++ ] = els[ i++ ] ) ) {}
+			target.length = j - 1;
+		}
+	};
+}
+
+function Sizzle( selector, context, results, seed ) {
+	var m, i, elem, nid, match, groups, newSelector,
+		newContext = context && context.ownerDocument,
+
+		// nodeType defaults to 9, since context defaults to document
+		nodeType = context ? context.nodeType : 9;
+
+	results = results || [];
+
+	// Return early from calls with invalid selector or context
+	if ( typeof selector !== "string" || !selector ||
+		nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) {
+
+		return results;
+	}
+
+	// Try to shortcut find operations (as opposed to filters) in HTML documents
+	if ( !seed ) {
+		setDocument( context );
+		context = context || document;
+
+		if ( documentIsHTML ) {
+
+			// If the selector is sufficiently simple, try using a "get*By*" DOM method
+			// (excepting DocumentFragment context, where the methods don't exist)
+			if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) {
+
+				// ID selector
+				if ( ( m = match[ 1 ] ) ) {
+
+					// Document context
+					if ( nodeType === 9 ) {
+						if ( ( elem = context.getElementById( m ) ) ) {
+
+							// Support: IE, Opera, Webkit
+							// TODO: identify versions
+							// getElementById can match elements by name instead of ID
+							if ( elem.id === m ) {
+								results.push( elem );
+								return results;
+							}
+						} else {
+							return results;
+						}
+
+					// Element context
+					} else {
+
+						// Support: IE, Opera, Webkit
+						// TODO: identify versions
+						// getElementById can match elements by name instead of ID
+						if ( newContext && ( elem = newContext.getElementById( m ) ) &&
+							contains( context, elem ) &&
+							elem.id === m ) {
+
+							results.push( elem );
+							return results;
+						}
+					}
+
+				// Type selector
+				} else if ( match[ 2 ] ) {
+					push.apply( results, context.getElementsByTagName( selector ) );
+					return results;
+
+				// Class selector
+				} else if ( ( m = match[ 3 ] ) && support.getElementsByClassName &&
+					context.getElementsByClassName ) {
+
+					push.apply( results, context.getElementsByClassName( m ) );
+					return results;
+				}
+			}
+
+			// Take advantage of querySelectorAll
+			if ( support.qsa &&
+				!nonnativeSelectorCache[ selector + " " ] &&
+				( !rbuggyQSA || !rbuggyQSA.test( selector ) ) &&
+
+				// Support: IE 8 only
+				// Exclude object elements
+				( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) {
+
+				newSelector = selector;
+				newContext = context;
+
+				// qSA considers elements outside a scoping root when evaluating child or
+				// descendant combinators, which is not what we want.
+				// In such cases, we work around the behavior by prefixing every selector in the
+				// list with an ID selector referencing the scope context.
+				// The technique has to be used as well when a leading combinator is used
+				// as such selectors are not recognized by querySelectorAll.
+				// Thanks to Andrew Dupont for this technique.
+				if ( nodeType === 1 &&
+					( rdescend.test( selector ) || rcombinators.test( selector ) ) ) {
+
+					// Expand context for sibling selectors
+					newContext = rsibling.test( selector ) && testContext( context.parentNode ) ||
+						context;
+
+					// We can use :scope instead of the ID hack if the browser
+					// supports it & if we're not changing the context.
+					if ( newContext !== context || !support.scope ) {
+
+						// Capture the context ID, setting it first if necessary
+						if ( ( nid = context.getAttribute( "id" ) ) ) {
+							nid = nid.replace( rcssescape, fcssescape );
+						} else {
+							context.setAttribute( "id", ( nid = expando ) );
+						}
+					}
+
+					// Prefix every selector in the list
+					groups = tokenize( selector );
+					i = groups.length;
+					while ( i-- ) {
+						groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " +
+							toSelector( groups[ i ] );
+					}
+					newSelector = groups.join( "," );
+				}
+
+				try {
+					push.apply( results,
+						newContext.querySelectorAll( newSelector )
+					);
+					return results;
+				} catch ( qsaError ) {
+					nonnativeSelectorCache( selector, true );
+				} finally {
+					if ( nid === expando ) {
+						context.removeAttribute( "id" );
+					}
+				}
+			}
+		}
+	}
+
+	// All others
+	return select( selector.replace( rtrim, "$1" ), context, results, seed );
+}
+
+/**
+ * Create key-value caches of limited size
+ * @returns {function(string, object)} Returns the Object data after storing it on itself with
+ *	property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength)
+ *	deleting the oldest entry
+ */
+function createCache() {
+	var keys = [];
+
+	function cache( key, value ) {
+
+		// Use (key + " ") to avoid collision with native prototype properties (see Issue #157)
+		if ( keys.push( key + " " ) > Expr.cacheLength ) {
+
+			// Only keep the most recent entries
+			delete cache[ keys.shift() ];
+		}
+		return ( cache[ key + " " ] = value );
+	}
+	return cache;
+}
+
+/**
+ * Mark a function for special use by Sizzle
+ * @param {Function} fn The function to mark
+ */
+function markFunction( fn ) {
+	fn[ expando ] = true;
+	return fn;
+}
+
+/**
+ * Support testing using an element
+ * @param {Function} fn Passed the created element and returns a boolean result
+ */
+function assert( fn ) {
+	var el = document.createElement( "fieldset" );
+
+	try {
+		return !!fn( el );
+	} catch ( e ) {
+		return false;
+	} finally {
+
+		// Remove from its parent by default
+		if ( el.parentNode ) {
+			el.parentNode.removeChild( el );
+		}
+
+		// release memory in IE
+		el = null;
+	}
+}
+
+/**
+ * Adds the same handler for all of the specified attrs
+ * @param {String} attrs Pipe-separated list of attributes
+ * @param {Function} handler The method that will be applied
+ */
+function addHandle( attrs, handler ) {
+	var arr = attrs.split( "|" ),
+		i = arr.length;
+
+	while ( i-- ) {
+		Expr.attrHandle[ arr[ i ] ] = handler;
+	}
+}
+
+/**
+ * Checks document order of two siblings
+ * @param {Element} a
+ * @param {Element} b
+ * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b
+ */
+function siblingCheck( a, b ) {
+	var cur = b && a,
+		diff = cur && a.nodeType === 1 && b.nodeType === 1 &&
+			a.sourceIndex - b.sourceIndex;
+
+	// Use IE sourceIndex if available on both nodes
+	if ( diff ) {
+		return diff;
+	}
+
+	// Check if b follows a
+	if ( cur ) {
+		while ( ( cur = cur.nextSibling ) ) {
+			if ( cur === b ) {
+				return -1;
+			}
+		}
+	}
+
+	return a ? 1 : -1;
+}
+
+/**
+ * Returns a function to use in pseudos for input types
+ * @param {String} type
+ */
+function createInputPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return name === "input" && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for buttons
+ * @param {String} type
+ */
+function createButtonPseudo( type ) {
+	return function( elem ) {
+		var name = elem.nodeName.toLowerCase();
+		return ( name === "input" || name === "button" ) && elem.type === type;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for :enabled/:disabled
+ * @param {Boolean} disabled true for :disabled; false for :enabled
+ */
+function createDisabledPseudo( disabled ) {
+
+	// Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable
+	return function( elem ) {
+
+		// Only certain elements can match :enabled or :disabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled
+		// https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled
+		if ( "form" in elem ) {
+
+			// Check for inherited disabledness on relevant non-disabled elements:
+			// * listed form-associated elements in a disabled fieldset
+			//   https://html.spec.whatwg.org/multipage/forms.html#category-listed
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled
+			// * option elements in a disabled optgroup
+			//   https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled
+			// All such elements have a "form" property.
+			if ( elem.parentNode && elem.disabled === false ) {
+
+				// Option elements defer to a parent optgroup if present
+				if ( "label" in elem ) {
+					if ( "label" in elem.parentNode ) {
+						return elem.parentNode.disabled === disabled;
+					} else {
+						return elem.disabled === disabled;
+					}
+				}
+
+				// Support: IE 6 - 11
+				// Use the isDisabled shortcut property to check for disabled fieldset ancestors
+				return elem.isDisabled === disabled ||
+
+					// Where there is no isDisabled, check manually
+					/* jshint -W018 */
+					elem.isDisabled !== !disabled &&
+					inDisabledFieldset( elem ) === disabled;
+			}
+
+			return elem.disabled === disabled;
+
+		// Try to winnow out elements that can't be disabled before trusting the disabled property.
+		// Some victims get caught in our net (label, legend, menu, track), but it shouldn't
+		// even exist on them, let alone have a boolean value.
+		} else if ( "label" in elem ) {
+			return elem.disabled === disabled;
+		}
+
+		// Remaining elements are neither :enabled nor :disabled
+		return false;
+	};
+}
+
+/**
+ * Returns a function to use in pseudos for positionals
+ * @param {Function} fn
+ */
+function createPositionalPseudo( fn ) {
+	return markFunction( function( argument ) {
+		argument = +argument;
+		return markFunction( function( seed, matches ) {
+			var j,
+				matchIndexes = fn( [], seed.length, argument ),
+				i = matchIndexes.length;
+
+			// Match elements found at the specified indexes
+			while ( i-- ) {
+				if ( seed[ ( j = matchIndexes[ i ] ) ] ) {
+					seed[ j ] = !( matches[ j ] = seed[ j ] );
+				}
+			}
+		} );
+	} );
+}
+
+/**
+ * Checks a node for validity as a Sizzle context
+ * @param {Element|Object=} context
+ * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value
+ */
+function testContext( context ) {
+	return context && typeof context.getElementsByTagName !== "undefined" && context;
+}
+
+// Expose support vars for convenience
+support = Sizzle.support = {};
+
+/**
+ * Detects XML nodes
+ * @param {Element|Object} elem An element or a document
+ * @returns {Boolean} True iff elem is a non-HTML XML node
+ */
+isXML = Sizzle.isXML = function( elem ) {
+	var namespace = elem && elem.namespaceURI,
+		docElem = elem && ( elem.ownerDocument || elem ).documentElement;
+
+	// Support: IE <=8
+	// Assume HTML when documentElement doesn't yet exist, such as inside loading iframes
+	// https://bugs.jquery.com/ticket/4833
+	return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" );
+};
+
+/**
+ * Sets document-related variables once based on the current document
+ * @param {Element|Object} [doc] An element or document object to use to set the document
+ * @returns {Object} Returns the current document
+ */
+setDocument = Sizzle.setDocument = function( node ) {
+	var hasCompare, subWindow,
+		doc = node ? node.ownerDocument || node : preferredDoc;
+
+	// Return early if doc is invalid or already selected
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) {
+		return document;
+	}
+
+	// Update global variables
+	document = doc;
+	docElem = document.documentElement;
+	documentIsHTML = !isXML( document );
+
+	// Support: IE 9 - 11+, Edge 12 - 18+
+	// Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936)
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( preferredDoc != document &&
+		( subWindow = document.defaultView ) && subWindow.top !== subWindow ) {
+
+		// Support: IE 11, Edge
+		if ( subWindow.addEventListener ) {
+			subWindow.addEventListener( "unload", unloadHandler, false );
+
+		// Support: IE 9 - 10 only
+		} else if ( subWindow.attachEvent ) {
+			subWindow.attachEvent( "onunload", unloadHandler );
+		}
+	}
+
+	// Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only,
+	// Safari 4 - 5 only, Opera <=11.6 - 12.x only
+	// IE/Edge & older browsers don't support the :scope pseudo-class.
+	// Support: Safari 6.0 only
+	// Safari 6.0 supports :scope but it's an alias of :root there.
+	support.scope = assert( function( el ) {
+		docElem.appendChild( el ).appendChild( document.createElement( "div" ) );
+		return typeof el.querySelectorAll !== "undefined" &&
+			!el.querySelectorAll( ":scope fieldset div" ).length;
+	} );
+
+	/* Attributes
+	---------------------------------------------------------------------- */
+
+	// Support: IE<8
+	// Verify that getAttribute really returns attributes and not properties
+	// (excepting IE8 booleans)
+	support.attributes = assert( function( el ) {
+		el.className = "i";
+		return !el.getAttribute( "className" );
+	} );
+
+	/* getElement(s)By*
+	---------------------------------------------------------------------- */
+
+	// Check if getElementsByTagName("*") returns only elements
+	support.getElementsByTagName = assert( function( el ) {
+		el.appendChild( document.createComment( "" ) );
+		return !el.getElementsByTagName( "*" ).length;
+	} );
+
+	// Support: IE<9
+	support.getElementsByClassName = rnative.test( document.getElementsByClassName );
+
+	// Support: IE<10
+	// Check if getElementById returns elements by name
+	// The broken getElementById methods don't pick up programmatically-set names,
+	// so use a roundabout getElementsByName test
+	support.getById = assert( function( el ) {
+		docElem.appendChild( el ).id = expando;
+		return !document.getElementsByName || !document.getElementsByName( expando ).length;
+	} );
+
+	// ID filter and find
+	if ( support.getById ) {
+		Expr.filter[ "ID" ] = function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				return elem.getAttribute( "id" ) === attrId;
+			};
+		};
+		Expr.find[ "ID" ] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var elem = context.getElementById( id );
+				return elem ? [ elem ] : [];
+			}
+		};
+	} else {
+		Expr.filter[ "ID" ] =  function( id ) {
+			var attrId = id.replace( runescape, funescape );
+			return function( elem ) {
+				var node = typeof elem.getAttributeNode !== "undefined" &&
+					elem.getAttributeNode( "id" );
+				return node && node.value === attrId;
+			};
+		};
+
+		// Support: IE 6 - 7 only
+		// getElementById is not reliable as a find shortcut
+		Expr.find[ "ID" ] = function( id, context ) {
+			if ( typeof context.getElementById !== "undefined" && documentIsHTML ) {
+				var node, i, elems,
+					elem = context.getElementById( id );
+
+				if ( elem ) {
+
+					// Verify the id attribute
+					node = elem.getAttributeNode( "id" );
+					if ( node && node.value === id ) {
+						return [ elem ];
+					}
+
+					// Fall back on getElementsByName
+					elems = context.getElementsByName( id );
+					i = 0;
+					while ( ( elem = elems[ i++ ] ) ) {
+						node = elem.getAttributeNode( "id" );
+						if ( node && node.value === id ) {
+							return [ elem ];
+						}
+					}
+				}
+
+				return [];
+			}
+		};
+	}
+
+	// Tag
+	Expr.find[ "TAG" ] = support.getElementsByTagName ?
+		function( tag, context ) {
+			if ( typeof context.getElementsByTagName !== "undefined" ) {
+				return context.getElementsByTagName( tag );
+
+			// DocumentFragment nodes don't have gEBTN
+			} else if ( support.qsa ) {
+				return context.querySelectorAll( tag );
+			}
+		} :
+
+		function( tag, context ) {
+			var elem,
+				tmp = [],
+				i = 0,
+
+				// By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too
+				results = context.getElementsByTagName( tag );
+
+			// Filter out possible comments
+			if ( tag === "*" ) {
+				while ( ( elem = results[ i++ ] ) ) {
+					if ( elem.nodeType === 1 ) {
+						tmp.push( elem );
+					}
+				}
+
+				return tmp;
+			}
+			return results;
+		};
+
+	// Class
+	Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) {
+		if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) {
+			return context.getElementsByClassName( className );
+		}
+	};
+
+	/* QSA/matchesSelector
+	---------------------------------------------------------------------- */
+
+	// QSA and matchesSelector support
+
+	// matchesSelector(:active) reports false when true (IE9/Opera 11.5)
+	rbuggyMatches = [];
+
+	// qSa(:focus) reports false when true (Chrome 21)
+	// We allow this because of a bug in IE8/9 that throws an error
+	// whenever `document.activeElement` is accessed on an iframe
+	// So, we allow :focus to pass through QSA all the time to avoid the IE error
+	// See https://bugs.jquery.com/ticket/13378
+	rbuggyQSA = [];
+
+	if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) {
+
+		// Build QSA regex
+		// Regex strategy adopted from Diego Perini
+		assert( function( el ) {
+
+			var input;
+
+			// Select is set to empty string on purpose
+			// This is to test IE's treatment of not explicitly
+			// setting a boolean content attribute,
+			// since its presence should be enough
+			// https://bugs.jquery.com/ticket/12359
+			docElem.appendChild( el ).innerHTML = "<a id='" + expando + "'></a>" +
+				"<select id='" + expando + "-\r\\' msallowcapture=''>" +
+				"<option selected=''></option></select>";
+
+			// Support: IE8, Opera 11-12.16
+			// Nothing should be selected when empty strings follow ^= or $= or *=
+			// The test attribute must be unknown in Opera but "safe" for WinRT
+			// https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section
+			if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) {
+				rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" );
+			}
+
+			// Support: IE8
+			// Boolean attributes and "value" are not treated correctly
+			if ( !el.querySelectorAll( "[selected]" ).length ) {
+				rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" );
+			}
+
+			// Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+
+			if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) {
+				rbuggyQSA.push( "~=" );
+			}
+
+			// Support: IE 11+, Edge 15 - 18+
+			// IE 11/Edge don't find elements on a `[name='']` query in some cases.
+			// Adding a temporary attribute to the document before the selection works
+			// around the issue.
+			// Interestingly, IE 10 & older don't seem to have the issue.
+			input = document.createElement( "input" );
+			input.setAttribute( "name", "" );
+			el.appendChild( input );
+			if ( !el.querySelectorAll( "[name='']" ).length ) {
+				rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" +
+					whitespace + "*(?:''|\"\")" );
+			}
+
+			// Webkit/Opera - :checked should return selected option elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			// IE8 throws error here and will not see later tests
+			if ( !el.querySelectorAll( ":checked" ).length ) {
+				rbuggyQSA.push( ":checked" );
+			}
+
+			// Support: Safari 8+, iOS 8+
+			// https://bugs.webkit.org/show_bug.cgi?id=136851
+			// In-page `selector#id sibling-combinator selector` fails
+			if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) {
+				rbuggyQSA.push( ".#.+[+~]" );
+			}
+
+			// Support: Firefox <=3.6 - 5 only
+			// Old Firefox doesn't throw on a badly-escaped identifier.
+			el.querySelectorAll( "\\\f" );
+			rbuggyQSA.push( "[\\r\\n\\f]" );
+		} );
+
+		assert( function( el ) {
+			el.innerHTML = "<a href='' disabled='disabled'></a>" +
+				"<select disabled='disabled'><option/></select>";
+
+			// Support: Windows 8 Native Apps
+			// The type and name attributes are restricted during .innerHTML assignment
+			var input = document.createElement( "input" );
+			input.setAttribute( "type", "hidden" );
+			el.appendChild( input ).setAttribute( "name", "D" );
+
+			// Support: IE8
+			// Enforce case-sensitivity of name attribute
+			if ( el.querySelectorAll( "[name=d]" ).length ) {
+				rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" );
+			}
+
+			// FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled)
+			// IE8 throws error here and will not see later tests
+			if ( el.querySelectorAll( ":enabled" ).length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Support: IE9-11+
+			// IE's :disabled selector does not pick up the children of disabled fieldsets
+			docElem.appendChild( el ).disabled = true;
+			if ( el.querySelectorAll( ":disabled" ).length !== 2 ) {
+				rbuggyQSA.push( ":enabled", ":disabled" );
+			}
+
+			// Support: Opera 10 - 11 only
+			// Opera 10-11 does not throw on post-comma invalid pseudos
+			el.querySelectorAll( "*,:x" );
+			rbuggyQSA.push( ",.*:" );
+		} );
+	}
+
+	if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches ||
+		docElem.webkitMatchesSelector ||
+		docElem.mozMatchesSelector ||
+		docElem.oMatchesSelector ||
+		docElem.msMatchesSelector ) ) ) ) {
+
+		assert( function( el ) {
+
+			// Check to see if it's possible to do matchesSelector
+			// on a disconnected node (IE 9)
+			support.disconnectedMatch = matches.call( el, "*" );
+
+			// This should fail with an exception
+			// Gecko does not error, returns false instead
+			matches.call( el, "[s!='']:x" );
+			rbuggyMatches.push( "!=", pseudos );
+		} );
+	}
+
+	rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) );
+	rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) );
+
+	/* Contains
+	---------------------------------------------------------------------- */
+	hasCompare = rnative.test( docElem.compareDocumentPosition );
+
+	// Element contains another
+	// Purposefully self-exclusive
+	// As in, an element does not contain itself
+	contains = hasCompare || rnative.test( docElem.contains ) ?
+		function( a, b ) {
+			var adown = a.nodeType === 9 ? a.documentElement : a,
+				bup = b && b.parentNode;
+			return a === bup || !!( bup && bup.nodeType === 1 && (
+				adown.contains ?
+					adown.contains( bup ) :
+					a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16
+			) );
+		} :
+		function( a, b ) {
+			if ( b ) {
+				while ( ( b = b.parentNode ) ) {
+					if ( b === a ) {
+						return true;
+					}
+				}
+			}
+			return false;
+		};
+
+	/* Sorting
+	---------------------------------------------------------------------- */
+
+	// Document order sorting
+	sortOrder = hasCompare ?
+	function( a, b ) {
+
+		// Flag for duplicate removal
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		// Sort on method existence if only one input has compareDocumentPosition
+		var compare = !a.compareDocumentPosition - !b.compareDocumentPosition;
+		if ( compare ) {
+			return compare;
+		}
+
+		// Calculate position if both inputs belong to the same document
+		// Support: IE 11+, Edge 17 - 18+
+		// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+		// two documents; shallow comparisons work.
+		// eslint-disable-next-line eqeqeq
+		compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ?
+			a.compareDocumentPosition( b ) :
+
+			// Otherwise we know they are disconnected
+			1;
+
+		// Disconnected nodes
+		if ( compare & 1 ||
+			( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) {
+
+			// Choose the first element that is related to our preferred document
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			// eslint-disable-next-line eqeqeq
+			if ( a == document || a.ownerDocument == preferredDoc &&
+				contains( preferredDoc, a ) ) {
+				return -1;
+			}
+
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			// eslint-disable-next-line eqeqeq
+			if ( b == document || b.ownerDocument == preferredDoc &&
+				contains( preferredDoc, b ) ) {
+				return 1;
+			}
+
+			// Maintain original order
+			return sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+		}
+
+		return compare & 4 ? -1 : 1;
+	} :
+	function( a, b ) {
+
+		// Exit early if the nodes are identical
+		if ( a === b ) {
+			hasDuplicate = true;
+			return 0;
+		}
+
+		var cur,
+			i = 0,
+			aup = a.parentNode,
+			bup = b.parentNode,
+			ap = [ a ],
+			bp = [ b ];
+
+		// Parentless nodes are either documents or disconnected
+		if ( !aup || !bup ) {
+
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			/* eslint-disable eqeqeq */
+			return a == document ? -1 :
+				b == document ? 1 :
+				/* eslint-enable eqeqeq */
+				aup ? -1 :
+				bup ? 1 :
+				sortInput ?
+				( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) :
+				0;
+
+		// If the nodes are siblings, we can do a quick check
+		} else if ( aup === bup ) {
+			return siblingCheck( a, b );
+		}
+
+		// Otherwise we need full lists of their ancestors for comparison
+		cur = a;
+		while ( ( cur = cur.parentNode ) ) {
+			ap.unshift( cur );
+		}
+		cur = b;
+		while ( ( cur = cur.parentNode ) ) {
+			bp.unshift( cur );
+		}
+
+		// Walk down the tree looking for a discrepancy
+		while ( ap[ i ] === bp[ i ] ) {
+			i++;
+		}
+
+		return i ?
+
+			// Do a sibling check if the nodes have a common ancestor
+			siblingCheck( ap[ i ], bp[ i ] ) :
+
+			// Otherwise nodes in our document sort first
+			// Support: IE 11+, Edge 17 - 18+
+			// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+			// two documents; shallow comparisons work.
+			/* eslint-disable eqeqeq */
+			ap[ i ] == preferredDoc ? -1 :
+			bp[ i ] == preferredDoc ? 1 :
+			/* eslint-enable eqeqeq */
+			0;
+	};
+
+	return document;
+};
+
+Sizzle.matches = function( expr, elements ) {
+	return Sizzle( expr, null, null, elements );
+};
+
+Sizzle.matchesSelector = function( elem, expr ) {
+	setDocument( elem );
+
+	if ( support.matchesSelector && documentIsHTML &&
+		!nonnativeSelectorCache[ expr + " " ] &&
+		( !rbuggyMatches || !rbuggyMatches.test( expr ) ) &&
+		( !rbuggyQSA     || !rbuggyQSA.test( expr ) ) ) {
+
+		try {
+			var ret = matches.call( elem, expr );
+
+			// IE 9's matchesSelector returns false on disconnected nodes
+			if ( ret || support.disconnectedMatch ||
+
+				// As well, disconnected nodes are said to be in a document
+				// fragment in IE 9
+				elem.document && elem.document.nodeType !== 11 ) {
+				return ret;
+			}
+		} catch ( e ) {
+			nonnativeSelectorCache( expr, true );
+		}
+	}
+
+	return Sizzle( expr, document, null, [ elem ] ).length > 0;
+};
+
+Sizzle.contains = function( context, elem ) {
+
+	// Set document vars if needed
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( ( context.ownerDocument || context ) != document ) {
+		setDocument( context );
+	}
+	return contains( context, elem );
+};
+
+Sizzle.attr = function( elem, name ) {
+
+	// Set document vars if needed
+	// Support: IE 11+, Edge 17 - 18+
+	// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+	// two documents; shallow comparisons work.
+	// eslint-disable-next-line eqeqeq
+	if ( ( elem.ownerDocument || elem ) != document ) {
+		setDocument( elem );
+	}
+
+	var fn = Expr.attrHandle[ name.toLowerCase() ],
+
+		// Don't get fooled by Object.prototype properties (jQuery #13807)
+		val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ?
+			fn( elem, name, !documentIsHTML ) :
+			undefined;
+
+	return val !== undefined ?
+		val :
+		support.attributes || !documentIsHTML ?
+			elem.getAttribute( name ) :
+			( val = elem.getAttributeNode( name ) ) && val.specified ?
+				val.value :
+				null;
+};
+
+Sizzle.escape = function( sel ) {
+	return ( sel + "" ).replace( rcssescape, fcssescape );
+};
+
+Sizzle.error = function( msg ) {
+	throw new Error( "Syntax error, unrecognized expression: " + msg );
+};
+
+/**
+ * Document sorting and removing duplicates
+ * @param {ArrayLike} results
+ */
+Sizzle.uniqueSort = function( results ) {
+	var elem,
+		duplicates = [],
+		j = 0,
+		i = 0;
+
+	// Unless we *know* we can detect duplicates, assume their presence
+	hasDuplicate = !support.detectDuplicates;
+	sortInput = !support.sortStable && results.slice( 0 );
+	results.sort( sortOrder );
+
+	if ( hasDuplicate ) {
+		while ( ( elem = results[ i++ ] ) ) {
+			if ( elem === results[ i ] ) {
+				j = duplicates.push( i );
+			}
+		}
+		while ( j-- ) {
+			results.splice( duplicates[ j ], 1 );
+		}
+	}
+
+	// Clear input after sorting to release objects
+	// See https://github.com/jquery/sizzle/pull/225
+	sortInput = null;
+
+	return results;
+};
+
+/**
+ * Utility function for retrieving the text value of an array of DOM nodes
+ * @param {Array|Element} elem
+ */
+getText = Sizzle.getText = function( elem ) {
+	var node,
+		ret = "",
+		i = 0,
+		nodeType = elem.nodeType;
+
+	if ( !nodeType ) {
+
+		// If no nodeType, this is expected to be an array
+		while ( ( node = elem[ i++ ] ) ) {
+
+			// Do not traverse comment nodes
+			ret += getText( node );
+		}
+	} else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) {
+
+		// Use textContent for elements
+		// innerText usage removed for consistency of new lines (jQuery #11153)
+		if ( typeof elem.textContent === "string" ) {
+			return elem.textContent;
+		} else {
+
+			// Traverse its children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				ret += getText( elem );
+			}
+		}
+	} else if ( nodeType === 3 || nodeType === 4 ) {
+		return elem.nodeValue;
+	}
+
+	// Do not include comment or processing instruction nodes
+
+	return ret;
+};
+
+Expr = Sizzle.selectors = {
+
+	// Can be adjusted by the user
+	cacheLength: 50,
+
+	createPseudo: markFunction,
+
+	match: matchExpr,
+
+	attrHandle: {},
+
+	find: {},
+
+	relative: {
+		">": { dir: "parentNode", first: true },
+		" ": { dir: "parentNode" },
+		"+": { dir: "previousSibling", first: true },
+		"~": { dir: "previousSibling" }
+	},
+
+	preFilter: {
+		"ATTR": function( match ) {
+			match[ 1 ] = match[ 1 ].replace( runescape, funescape );
+
+			// Move the given value to match[3] whether quoted or unquoted
+			match[ 3 ] = ( match[ 3 ] || match[ 4 ] ||
+				match[ 5 ] || "" ).replace( runescape, funescape );
+
+			if ( match[ 2 ] === "~=" ) {
+				match[ 3 ] = " " + match[ 3 ] + " ";
+			}
+
+			return match.slice( 0, 4 );
+		},
+
+		"CHILD": function( match ) {
+
+			/* matches from matchExpr["CHILD"]
+				1 type (only|nth|...)
+				2 what (child|of-type)
+				3 argument (even|odd|\d*|\d*n([+-]\d+)?|...)
+				4 xn-component of xn+y argument ([+-]?\d*n|)
+				5 sign of xn-component
+				6 x of xn-component
+				7 sign of y-component
+				8 y of y-component
+			*/
+			match[ 1 ] = match[ 1 ].toLowerCase();
+
+			if ( match[ 1 ].slice( 0, 3 ) === "nth" ) {
+
+				// nth-* requires argument
+				if ( !match[ 3 ] ) {
+					Sizzle.error( match[ 0 ] );
+				}
+
+				// numeric x and y parameters for Expr.filter.CHILD
+				// remember that false/true cast respectively to 0/1
+				match[ 4 ] = +( match[ 4 ] ?
+					match[ 5 ] + ( match[ 6 ] || 1 ) :
+					2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) );
+				match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" );
+
+				// other types prohibit arguments
+			} else if ( match[ 3 ] ) {
+				Sizzle.error( match[ 0 ] );
+			}
+
+			return match;
+		},
+
+		"PSEUDO": function( match ) {
+			var excess,
+				unquoted = !match[ 6 ] && match[ 2 ];
+
+			if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) {
+				return null;
+			}
+
+			// Accept quoted arguments as-is
+			if ( match[ 3 ] ) {
+				match[ 2 ] = match[ 4 ] || match[ 5 ] || "";
+
+			// Strip excess characters from unquoted arguments
+			} else if ( unquoted && rpseudo.test( unquoted ) &&
+
+				// Get excess from tokenize (recursively)
+				( excess = tokenize( unquoted, true ) ) &&
+
+				// advance to the next closing parenthesis
+				( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) {
+
+				// excess is a negative index
+				match[ 0 ] = match[ 0 ].slice( 0, excess );
+				match[ 2 ] = unquoted.slice( 0, excess );
+			}
+
+			// Return only captures needed by the pseudo filter method (type and argument)
+			return match.slice( 0, 3 );
+		}
+	},
+
+	filter: {
+
+		"TAG": function( nodeNameSelector ) {
+			var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase();
+			return nodeNameSelector === "*" ?
+				function() {
+					return true;
+				} :
+				function( elem ) {
+					return elem.nodeName && elem.nodeName.toLowerCase() === nodeName;
+				};
+		},
+
+		"CLASS": function( className ) {
+			var pattern = classCache[ className + " " ];
+
+			return pattern ||
+				( pattern = new RegExp( "(^|" + whitespace +
+					")" + className + "(" + whitespace + "|$)" ) ) && classCache(
+						className, function( elem ) {
+							return pattern.test(
+								typeof elem.className === "string" && elem.className ||
+								typeof elem.getAttribute !== "undefined" &&
+									elem.getAttribute( "class" ) ||
+								""
+							);
+				} );
+		},
+
+		"ATTR": function( name, operator, check ) {
+			return function( elem ) {
+				var result = Sizzle.attr( elem, name );
+
+				if ( result == null ) {
+					return operator === "!=";
+				}
+				if ( !operator ) {
+					return true;
+				}
+
+				result += "";
+
+				/* eslint-disable max-len */
+
+				return operator === "=" ? result === check :
+					operator === "!=" ? result !== check :
+					operator === "^=" ? check && result.indexOf( check ) === 0 :
+					operator === "*=" ? check && result.indexOf( check ) > -1 :
+					operator === "$=" ? check && result.slice( -check.length ) === check :
+					operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 :
+					operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" :
+					false;
+				/* eslint-enable max-len */
+
+			};
+		},
+
+		"CHILD": function( type, what, _argument, first, last ) {
+			var simple = type.slice( 0, 3 ) !== "nth",
+				forward = type.slice( -4 ) !== "last",
+				ofType = what === "of-type";
+
+			return first === 1 && last === 0 ?
+
+				// Shortcut for :nth-*(n)
+				function( elem ) {
+					return !!elem.parentNode;
+				} :
+
+				function( elem, _context, xml ) {
+					var cache, uniqueCache, outerCache, node, nodeIndex, start,
+						dir = simple !== forward ? "nextSibling" : "previousSibling",
+						parent = elem.parentNode,
+						name = ofType && elem.nodeName.toLowerCase(),
+						useCache = !xml && !ofType,
+						diff = false;
+
+					if ( parent ) {
+
+						// :(first|last|only)-(child|of-type)
+						if ( simple ) {
+							while ( dir ) {
+								node = elem;
+								while ( ( node = node[ dir ] ) ) {
+									if ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) {
+
+										return false;
+									}
+								}
+
+								// Reverse direction for :only-* (if we haven't yet done so)
+								start = dir = type === "only" && !start && "nextSibling";
+							}
+							return true;
+						}
+
+						start = [ forward ? parent.firstChild : parent.lastChild ];
+
+						// non-xml :nth-child(...) stores cache data on `parent`
+						if ( forward && useCache ) {
+
+							// Seek `elem` from a previously-cached index
+
+							// ...in a gzip-friendly way
+							node = parent;
+							outerCache = node[ expando ] || ( node[ expando ] = {} );
+
+							// Support: IE <9 only
+							// Defend against cloned attroperties (jQuery gh-1709)
+							uniqueCache = outerCache[ node.uniqueID ] ||
+								( outerCache[ node.uniqueID ] = {} );
+
+							cache = uniqueCache[ type ] || [];
+							nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+							diff = nodeIndex && cache[ 2 ];
+							node = nodeIndex && parent.childNodes[ nodeIndex ];
+
+							while ( ( node = ++nodeIndex && node && node[ dir ] ||
+
+								// Fallback to seeking `elem` from the start
+								( diff = nodeIndex = 0 ) || start.pop() ) ) {
+
+								// When found, cache indexes on `parent` and break
+								if ( node.nodeType === 1 && ++diff && node === elem ) {
+									uniqueCache[ type ] = [ dirruns, nodeIndex, diff ];
+									break;
+								}
+							}
+
+						} else {
+
+							// Use previously-cached element index if available
+							if ( useCache ) {
+
+								// ...in a gzip-friendly way
+								node = elem;
+								outerCache = node[ expando ] || ( node[ expando ] = {} );
+
+								// Support: IE <9 only
+								// Defend against cloned attroperties (jQuery gh-1709)
+								uniqueCache = outerCache[ node.uniqueID ] ||
+									( outerCache[ node.uniqueID ] = {} );
+
+								cache = uniqueCache[ type ] || [];
+								nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ];
+								diff = nodeIndex;
+							}
+
+							// xml :nth-child(...)
+							// or :nth-last-child(...) or :nth(-last)?-of-type(...)
+							if ( diff === false ) {
+
+								// Use the same loop as above to seek `elem` from the start
+								while ( ( node = ++nodeIndex && node && node[ dir ] ||
+									( diff = nodeIndex = 0 ) || start.pop() ) ) {
+
+									if ( ( ofType ?
+										node.nodeName.toLowerCase() === name :
+										node.nodeType === 1 ) &&
+										++diff ) {
+
+										// Cache the index of each encountered element
+										if ( useCache ) {
+											outerCache = node[ expando ] ||
+												( node[ expando ] = {} );
+
+											// Support: IE <9 only
+											// Defend against cloned attroperties (jQuery gh-1709)
+											uniqueCache = outerCache[ node.uniqueID ] ||
+												( outerCache[ node.uniqueID ] = {} );
+
+											uniqueCache[ type ] = [ dirruns, diff ];
+										}
+
+										if ( node === elem ) {
+											break;
+										}
+									}
+								}
+							}
+						}
+
+						// Incorporate the offset, then check against cycle size
+						diff -= last;
+						return diff === first || ( diff % first === 0 && diff / first >= 0 );
+					}
+				};
+		},
+
+		"PSEUDO": function( pseudo, argument ) {
+
+			// pseudo-class names are case-insensitive
+			// http://www.w3.org/TR/selectors/#pseudo-classes
+			// Prioritize by case sensitivity in case custom pseudos are added with uppercase letters
+			// Remember that setFilters inherits from pseudos
+			var args,
+				fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] ||
+					Sizzle.error( "unsupported pseudo: " + pseudo );
+
+			// The user may use createPseudo to indicate that
+			// arguments are needed to create the filter function
+			// just as Sizzle does
+			if ( fn[ expando ] ) {
+				return fn( argument );
+			}
+
+			// But maintain support for old signatures
+			if ( fn.length > 1 ) {
+				args = [ pseudo, pseudo, "", argument ];
+				return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ?
+					markFunction( function( seed, matches ) {
+						var idx,
+							matched = fn( seed, argument ),
+							i = matched.length;
+						while ( i-- ) {
+							idx = indexOf( seed, matched[ i ] );
+							seed[ idx ] = !( matches[ idx ] = matched[ i ] );
+						}
+					} ) :
+					function( elem ) {
+						return fn( elem, 0, args );
+					};
+			}
+
+			return fn;
+		}
+	},
+
+	pseudos: {
+
+		// Potentially complex pseudos
+		"not": markFunction( function( selector ) {
+
+			// Trim the selector passed to compile
+			// to avoid treating leading and trailing
+			// spaces as combinators
+			var input = [],
+				results = [],
+				matcher = compile( selector.replace( rtrim, "$1" ) );
+
+			return matcher[ expando ] ?
+				markFunction( function( seed, matches, _context, xml ) {
+					var elem,
+						unmatched = matcher( seed, null, xml, [] ),
+						i = seed.length;
+
+					// Match elements unmatched by `matcher`
+					while ( i-- ) {
+						if ( ( elem = unmatched[ i ] ) ) {
+							seed[ i ] = !( matches[ i ] = elem );
+						}
+					}
+				} ) :
+				function( elem, _context, xml ) {
+					input[ 0 ] = elem;
+					matcher( input, null, xml, results );
+
+					// Don't keep the element (issue #299)
+					input[ 0 ] = null;
+					return !results.pop();
+				};
+		} ),
+
+		"has": markFunction( function( selector ) {
+			return function( elem ) {
+				return Sizzle( selector, elem ).length > 0;
+			};
+		} ),
+
+		"contains": markFunction( function( text ) {
+			text = text.replace( runescape, funescape );
+			return function( elem ) {
+				return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1;
+			};
+		} ),
+
+		// "Whether an element is represented by a :lang() selector
+		// is based solely on the element's language value
+		// being equal to the identifier C,
+		// or beginning with the identifier C immediately followed by "-".
+		// The matching of C against the element's language value is performed case-insensitively.
+		// The identifier C does not have to be a valid language name."
+		// http://www.w3.org/TR/selectors/#lang-pseudo
+		"lang": markFunction( function( lang ) {
+
+			// lang value must be a valid identifier
+			if ( !ridentifier.test( lang || "" ) ) {
+				Sizzle.error( "unsupported lang: " + lang );
+			}
+			lang = lang.replace( runescape, funescape ).toLowerCase();
+			return function( elem ) {
+				var elemLang;
+				do {
+					if ( ( elemLang = documentIsHTML ?
+						elem.lang :
+						elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) {
+
+						elemLang = elemLang.toLowerCase();
+						return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0;
+					}
+				} while ( ( elem = elem.parentNode ) && elem.nodeType === 1 );
+				return false;
+			};
+		} ),
+
+		// Miscellaneous
+		"target": function( elem ) {
+			var hash = window.location && window.location.hash;
+			return hash && hash.slice( 1 ) === elem.id;
+		},
+
+		"root": function( elem ) {
+			return elem === docElem;
+		},
+
+		"focus": function( elem ) {
+			return elem === document.activeElement &&
+				( !document.hasFocus || document.hasFocus() ) &&
+				!!( elem.type || elem.href || ~elem.tabIndex );
+		},
+
+		// Boolean properties
+		"enabled": createDisabledPseudo( false ),
+		"disabled": createDisabledPseudo( true ),
+
+		"checked": function( elem ) {
+
+			// In CSS3, :checked should return both checked and selected elements
+			// http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked
+			var nodeName = elem.nodeName.toLowerCase();
+			return ( nodeName === "input" && !!elem.checked ) ||
+				( nodeName === "option" && !!elem.selected );
+		},
+
+		"selected": function( elem ) {
+
+			// Accessing this property makes selected-by-default
+			// options in Safari work properly
+			if ( elem.parentNode ) {
+				// eslint-disable-next-line no-unused-expressions
+				elem.parentNode.selectedIndex;
+			}
+
+			return elem.selected === true;
+		},
+
+		// Contents
+		"empty": function( elem ) {
+
+			// http://www.w3.org/TR/selectors/#empty-pseudo
+			// :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5),
+			//   but not by others (comment: 8; processing instruction: 7; etc.)
+			// nodeType < 6 works because attributes (2) do not appear as children
+			for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) {
+				if ( elem.nodeType < 6 ) {
+					return false;
+				}
+			}
+			return true;
+		},
+
+		"parent": function( elem ) {
+			return !Expr.pseudos[ "empty" ]( elem );
+		},
+
+		// Element/input types
+		"header": function( elem ) {
+			return rheader.test( elem.nodeName );
+		},
+
+		"input": function( elem ) {
+			return rinputs.test( elem.nodeName );
+		},
+
+		"button": function( elem ) {
+			var name = elem.nodeName.toLowerCase();
+			return name === "input" && elem.type === "button" || name === "button";
+		},
+
+		"text": function( elem ) {
+			var attr;
+			return elem.nodeName.toLowerCase() === "input" &&
+				elem.type === "text" &&
+
+				// Support: IE<8
+				// New HTML5 attribute values (e.g., "search") appear with elem.type === "text"
+				( ( attr = elem.getAttribute( "type" ) ) == null ||
+					attr.toLowerCase() === "text" );
+		},
+
+		// Position-in-collection
+		"first": createPositionalPseudo( function() {
+			return [ 0 ];
+		} ),
+
+		"last": createPositionalPseudo( function( _matchIndexes, length ) {
+			return [ length - 1 ];
+		} ),
+
+		"eq": createPositionalPseudo( function( _matchIndexes, length, argument ) {
+			return [ argument < 0 ? argument + length : argument ];
+		} ),
+
+		"even": createPositionalPseudo( function( matchIndexes, length ) {
+			var i = 0;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} ),
+
+		"odd": createPositionalPseudo( function( matchIndexes, length ) {
+			var i = 1;
+			for ( ; i < length; i += 2 ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} ),
+
+		"lt": createPositionalPseudo( function( matchIndexes, length, argument ) {
+			var i = argument < 0 ?
+				argument + length :
+				argument > length ?
+					length :
+					argument;
+			for ( ; --i >= 0; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} ),
+
+		"gt": createPositionalPseudo( function( matchIndexes, length, argument ) {
+			var i = argument < 0 ? argument + length : argument;
+			for ( ; ++i < length; ) {
+				matchIndexes.push( i );
+			}
+			return matchIndexes;
+		} )
+	}
+};
+
+Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ];
+
+// Add button/input type pseudos
+for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) {
+	Expr.pseudos[ i ] = createInputPseudo( i );
+}
+for ( i in { submit: true, reset: true } ) {
+	Expr.pseudos[ i ] = createButtonPseudo( i );
+}
+
+// Easy API for creating new setFilters
+function setFilters() {}
+setFilters.prototype = Expr.filters = Expr.pseudos;
+Expr.setFilters = new setFilters();
+
+tokenize = Sizzle.tokenize = function( selector, parseOnly ) {
+	var matched, match, tokens, type,
+		soFar, groups, preFilters,
+		cached = tokenCache[ selector + " " ];
+
+	if ( cached ) {
+		return parseOnly ? 0 : cached.slice( 0 );
+	}
+
+	soFar = selector;
+	groups = [];
+	preFilters = Expr.preFilter;
+
+	while ( soFar ) {
+
+		// Comma and first run
+		if ( !matched || ( match = rcomma.exec( soFar ) ) ) {
+			if ( match ) {
+
+				// Don't consume trailing commas as valid
+				soFar = soFar.slice( match[ 0 ].length ) || soFar;
+			}
+			groups.push( ( tokens = [] ) );
+		}
+
+		matched = false;
+
+		// Combinators
+		if ( ( match = rcombinators.exec( soFar ) ) ) {
+			matched = match.shift();
+			tokens.push( {
+				value: matched,
+
+				// Cast descendant combinators to space
+				type: match[ 0 ].replace( rtrim, " " )
+			} );
+			soFar = soFar.slice( matched.length );
+		}
+
+		// Filters
+		for ( type in Expr.filter ) {
+			if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] ||
+				( match = preFilters[ type ]( match ) ) ) ) {
+				matched = match.shift();
+				tokens.push( {
+					value: matched,
+					type: type,
+					matches: match
+				} );
+				soFar = soFar.slice( matched.length );
+			}
+		}
+
+		if ( !matched ) {
+			break;
+		}
+	}
+
+	// Return the length of the invalid excess
+	// if we're just parsing
+	// Otherwise, throw an error or return tokens
+	return parseOnly ?
+		soFar.length :
+		soFar ?
+			Sizzle.error( selector ) :
+
+			// Cache the tokens
+			tokenCache( selector, groups ).slice( 0 );
+};
+
+function toSelector( tokens ) {
+	var i = 0,
+		len = tokens.length,
+		selector = "";
+	for ( ; i < len; i++ ) {
+		selector += tokens[ i ].value;
+	}
+	return selector;
+}
+
+function addCombinator( matcher, combinator, base ) {
+	var dir = combinator.dir,
+		skip = combinator.next,
+		key = skip || dir,
+		checkNonElements = base && key === "parentNode",
+		doneName = done++;
+
+	return combinator.first ?
+
+		// Check against closest ancestor/preceding element
+		function( elem, context, xml ) {
+			while ( ( elem = elem[ dir ] ) ) {
+				if ( elem.nodeType === 1 || checkNonElements ) {
+					return matcher( elem, context, xml );
+				}
+			}
+			return false;
+		} :
+
+		// Check against all ancestor/preceding elements
+		function( elem, context, xml ) {
+			var oldCache, uniqueCache, outerCache,
+				newCache = [ dirruns, doneName ];
+
+			// We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching
+			if ( xml ) {
+				while ( ( elem = elem[ dir ] ) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						if ( matcher( elem, context, xml ) ) {
+							return true;
+						}
+					}
+				}
+			} else {
+				while ( ( elem = elem[ dir ] ) ) {
+					if ( elem.nodeType === 1 || checkNonElements ) {
+						outerCache = elem[ expando ] || ( elem[ expando ] = {} );
+
+						// Support: IE <9 only
+						// Defend against cloned attroperties (jQuery gh-1709)
+						uniqueCache = outerCache[ elem.uniqueID ] ||
+							( outerCache[ elem.uniqueID ] = {} );
+
+						if ( skip && skip === elem.nodeName.toLowerCase() ) {
+							elem = elem[ dir ] || elem;
+						} else if ( ( oldCache = uniqueCache[ key ] ) &&
+							oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) {
+
+							// Assign to newCache so results back-propagate to previous elements
+							return ( newCache[ 2 ] = oldCache[ 2 ] );
+						} else {
+
+							// Reuse newcache so results back-propagate to previous elements
+							uniqueCache[ key ] = newCache;
+
+							// A match means we're done; a fail means we have to keep checking
+							if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) {
+								return true;
+							}
+						}
+					}
+				}
+			}
+			return false;
+		};
+}
+
+function elementMatcher( matchers ) {
+	return matchers.length > 1 ?
+		function( elem, context, xml ) {
+			var i = matchers.length;
+			while ( i-- ) {
+				if ( !matchers[ i ]( elem, context, xml ) ) {
+					return false;
+				}
+			}
+			return true;
+		} :
+		matchers[ 0 ];
+}
+
+function multipleContexts( selector, contexts, results ) {
+	var i = 0,
+		len = contexts.length;
+	for ( ; i < len; i++ ) {
+		Sizzle( selector, contexts[ i ], results );
+	}
+	return results;
+}
+
+function condense( unmatched, map, filter, context, xml ) {
+	var elem,
+		newUnmatched = [],
+		i = 0,
+		len = unmatched.length,
+		mapped = map != null;
+
+	for ( ; i < len; i++ ) {
+		if ( ( elem = unmatched[ i ] ) ) {
+			if ( !filter || filter( elem, context, xml ) ) {
+				newUnmatched.push( elem );
+				if ( mapped ) {
+					map.push( i );
+				}
+			}
+		}
+	}
+
+	return newUnmatched;
+}
+
+function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) {
+	if ( postFilter && !postFilter[ expando ] ) {
+		postFilter = setMatcher( postFilter );
+	}
+	if ( postFinder && !postFinder[ expando ] ) {
+		postFinder = setMatcher( postFinder, postSelector );
+	}
+	return markFunction( function( seed, results, context, xml ) {
+		var temp, i, elem,
+			preMap = [],
+			postMap = [],
+			preexisting = results.length,
+
+			// Get initial elements from seed or context
+			elems = seed || multipleContexts(
+				selector || "*",
+				context.nodeType ? [ context ] : context,
+				[]
+			),
+
+			// Prefilter to get matcher input, preserving a map for seed-results synchronization
+			matcherIn = preFilter && ( seed || !selector ) ?
+				condense( elems, preMap, preFilter, context, xml ) :
+				elems,
+
+			matcherOut = matcher ?
+
+				// If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results,
+				postFinder || ( seed ? preFilter : preexisting || postFilter ) ?
+
+					// ...intermediate processing is necessary
+					[] :
+
+					// ...otherwise use results directly
+					results :
+				matcherIn;
+
+		// Find primary matches
+		if ( matcher ) {
+			matcher( matcherIn, matcherOut, context, xml );
+		}
+
+		// Apply postFilter
+		if ( postFilter ) {
+			temp = condense( matcherOut, postMap );
+			postFilter( temp, [], context, xml );
+
+			// Un-match failing elements by moving them back to matcherIn
+			i = temp.length;
+			while ( i-- ) {
+				if ( ( elem = temp[ i ] ) ) {
+					matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem );
+				}
+			}
+		}
+
+		if ( seed ) {
+			if ( postFinder || preFilter ) {
+				if ( postFinder ) {
+
+					// Get the final matcherOut by condensing this intermediate into postFinder contexts
+					temp = [];
+					i = matcherOut.length;
+					while ( i-- ) {
+						if ( ( elem = matcherOut[ i ] ) ) {
+
+							// Restore matcherIn since elem is not yet a final match
+							temp.push( ( matcherIn[ i ] = elem ) );
+						}
+					}
+					postFinder( null, ( matcherOut = [] ), temp, xml );
+				}
+
+				// Move matched elements from seed to results to keep them synchronized
+				i = matcherOut.length;
+				while ( i-- ) {
+					if ( ( elem = matcherOut[ i ] ) &&
+						( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) {
+
+						seed[ temp ] = !( results[ temp ] = elem );
+					}
+				}
+			}
+
+		// Add elements to results, through postFinder if defined
+		} else {
+			matcherOut = condense(
+				matcherOut === results ?
+					matcherOut.splice( preexisting, matcherOut.length ) :
+					matcherOut
+			);
+			if ( postFinder ) {
+				postFinder( null, results, matcherOut, xml );
+			} else {
+				push.apply( results, matcherOut );
+			}
+		}
+	} );
+}
+
+function matcherFromTokens( tokens ) {
+	var checkContext, matcher, j,
+		len = tokens.length,
+		leadingRelative = Expr.relative[ tokens[ 0 ].type ],
+		implicitRelative = leadingRelative || Expr.relative[ " " ],
+		i = leadingRelative ? 1 : 0,
+
+		// The foundational matcher ensures that elements are reachable from top-level context(s)
+		matchContext = addCombinator( function( elem ) {
+			return elem === checkContext;
+		}, implicitRelative, true ),
+		matchAnyContext = addCombinator( function( elem ) {
+			return indexOf( checkContext, elem ) > -1;
+		}, implicitRelative, true ),
+		matchers = [ function( elem, context, xml ) {
+			var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || (
+				( checkContext = context ).nodeType ?
+					matchContext( elem, context, xml ) :
+					matchAnyContext( elem, context, xml ) );
+
+			// Avoid hanging onto element (issue #299)
+			checkContext = null;
+			return ret;
+		} ];
+
+	for ( ; i < len; i++ ) {
+		if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) {
+			matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ];
+		} else {
+			matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches );
+
+			// Return special upon seeing a positional matcher
+			if ( matcher[ expando ] ) {
+
+				// Find the next relative operator (if any) for proper handling
+				j = ++i;
+				for ( ; j < len; j++ ) {
+					if ( Expr.relative[ tokens[ j ].type ] ) {
+						break;
+					}
+				}
+				return setMatcher(
+					i > 1 && elementMatcher( matchers ),
+					i > 1 && toSelector(
+
+					// If the preceding token was a descendant combinator, insert an implicit any-element `*`
+					tokens
+						.slice( 0, i - 1 )
+						.concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } )
+					).replace( rtrim, "$1" ),
+					matcher,
+					i < j && matcherFromTokens( tokens.slice( i, j ) ),
+					j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ),
+					j < len && toSelector( tokens )
+				);
+			}
+			matchers.push( matcher );
+		}
+	}
+
+	return elementMatcher( matchers );
+}
+
+function matcherFromGroupMatchers( elementMatchers, setMatchers ) {
+	var bySet = setMatchers.length > 0,
+		byElement = elementMatchers.length > 0,
+		superMatcher = function( seed, context, xml, results, outermost ) {
+			var elem, j, matcher,
+				matchedCount = 0,
+				i = "0",
+				unmatched = seed && [],
+				setMatched = [],
+				contextBackup = outermostContext,
+
+				// We must always have either seed elements or outermost context
+				elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ),
+
+				// Use integer dirruns iff this is the outermost matcher
+				dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ),
+				len = elems.length;
+
+			if ( outermost ) {
+
+				// Support: IE 11+, Edge 17 - 18+
+				// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+				// two documents; shallow comparisons work.
+				// eslint-disable-next-line eqeqeq
+				outermostContext = context == document || context || outermost;
+			}
+
+			// Add elements passing elementMatchers directly to results
+			// Support: IE<9, Safari
+			// Tolerate NodeList properties (IE: "length"; Safari: <number>) matching elements by id
+			for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) {
+				if ( byElement && elem ) {
+					j = 0;
+
+					// Support: IE 11+, Edge 17 - 18+
+					// IE/Edge sometimes throw a "Permission denied" error when strict-comparing
+					// two documents; shallow comparisons work.
+					// eslint-disable-next-line eqeqeq
+					if ( !context && elem.ownerDocument != document ) {
+						setDocument( elem );
+						xml = !documentIsHTML;
+					}
+					while ( ( matcher = elementMatchers[ j++ ] ) ) {
+						if ( matcher( elem, context || document, xml ) ) {
+							results.push( elem );
+							break;
+						}
+					}
+					if ( outermost ) {
+						dirruns = dirrunsUnique;
+					}
+				}
+
+				// Track unmatched elements for set filters
+				if ( bySet ) {
+
+					// They will have gone through all possible matchers
+					if ( ( elem = !matcher && elem ) ) {
+						matchedCount--;
+					}
+
+					// Lengthen the array for every element, matched or not
+					if ( seed ) {
+						unmatched.push( elem );
+					}
+				}
+			}
+
+			// `i` is now the count of elements visited above, and adding it to `matchedCount`
+			// makes the latter nonnegative.
+			matchedCount += i;
+
+			// Apply set filters to unmatched elements
+			// NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount`
+			// equals `i`), unless we didn't visit _any_ elements in the above loop because we have
+			// no element matchers and no seed.
+			// Incrementing an initially-string "0" `i` allows `i` to remain a string only in that
+			// case, which will result in a "00" `matchedCount` that differs from `i` but is also
+			// numerically zero.
+			if ( bySet && i !== matchedCount ) {
+				j = 0;
+				while ( ( matcher = setMatchers[ j++ ] ) ) {
+					matcher( unmatched, setMatched, context, xml );
+				}
+
+				if ( seed ) {
+
+					// Reintegrate element matches to eliminate the need for sorting
+					if ( matchedCount > 0 ) {
+						while ( i-- ) {
+							if ( !( unmatched[ i ] || setMatched[ i ] ) ) {
+								setMatched[ i ] = pop.call( results );
+							}
+						}
+					}
+
+					// Discard index placeholder values to get only actual matches
+					setMatched = condense( setMatched );
+				}
+
+				// Add matches to results
+				push.apply( results, setMatched );
+
+				// Seedless set matches succeeding multiple successful matchers stipulate sorting
+				if ( outermost && !seed && setMatched.length > 0 &&
+					( matchedCount + setMatchers.length ) > 1 ) {
+
+					Sizzle.uniqueSort( results );
+				}
+			}
+
+			// Override manipulation of globals by nested matchers
+			if ( outermost ) {
+				dirruns = dirrunsUnique;
+				outermostContext = contextBackup;
+			}
+
+			return unmatched;
+		};
+
+	return bySet ?
+		markFunction( superMatcher ) :
+		superMatcher;
+}
+
+compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) {
+	var i,
+		setMatchers = [],
+		elementMatchers = [],
+		cached = compilerCache[ selector + " " ];
+
+	if ( !cached ) {
+
+		// Generate a function of recursive functions that can be used to check each element
+		if ( !match ) {
+			match = tokenize( selector );
+		}
+		i = match.length;
+		while ( i-- ) {
+			cached = matcherFromTokens( match[ i ] );
+			if ( cached[ expando ] ) {
+				setMatchers.push( cached );
+			} else {
+				elementMatchers.push( cached );
+			}
+		}
+
+		// Cache the compiled function
+		cached = compilerCache(
+			selector,
+			matcherFromGroupMatchers( elementMatchers, setMatchers )
+		);
+
+		// Save selector and tokenization
+		cached.selector = selector;
+	}
+	return cached;
+};
+
+/**
+ * A low-level selection function that works with Sizzle's compiled
+ *  selector functions
+ * @param {String|Function} selector A selector or a pre-compiled
+ *  selector function built with Sizzle.compile
+ * @param {Element} context
+ * @param {Array} [results]
+ * @param {Array} [seed] A set of elements to match against
+ */
+select = Sizzle.select = function( selector, context, results, seed ) {
+	var i, tokens, token, type, find,
+		compiled = typeof selector === "function" && selector,
+		match = !seed && tokenize( ( selector = compiled.selector || selector ) );
+
+	results = results || [];
+
+	// Try to minimize operations if there is only one selector in the list and no seed
+	// (the latter of which guarantees us context)
+	if ( match.length === 1 ) {
+
+		// Reduce context if the leading compound selector is an ID
+		tokens = match[ 0 ] = match[ 0 ].slice( 0 );
+		if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" &&
+			context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) {
+
+			context = ( Expr.find[ "ID" ]( token.matches[ 0 ]
+				.replace( runescape, funescape ), context ) || [] )[ 0 ];
+			if ( !context ) {
+				return results;
+
+			// Precompiled matchers will still verify ancestry, so step up a level
+			} else if ( compiled ) {
+				context = context.parentNode;
+			}
+
+			selector = selector.slice( tokens.shift().value.length );
+		}
+
+		// Fetch a seed set for right-to-left matching
+		i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length;
+		while ( i-- ) {
+			token = tokens[ i ];
+
+			// Abort if we hit a combinator
+			if ( Expr.relative[ ( type = token.type ) ] ) {
+				break;
+			}
+			if ( ( find = Expr.find[ type ] ) ) {
+
+				// Search, expanding context for leading sibling combinators
+				if ( ( seed = find(
+					token.matches[ 0 ].replace( runescape, funescape ),
+					rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) ||
+						context
+				) ) ) {
+
+					// If seed is empty or no tokens remain, we can return early
+					tokens.splice( i, 1 );
+					selector = seed.length && toSelector( tokens );
+					if ( !selector ) {
+						push.apply( results, seed );
+						return results;
+					}
+
+					break;
+				}
+			}
+		}
+	}
+
+	// Compile and execute a filtering function if one is not provided
+	// Provide `match` to avoid retokenization if we modified the selector above
+	( compiled || compile( selector, match ) )(
+		seed,
+		context,
+		!documentIsHTML,
+		results,
+		!context || rsibling.test( selector ) && testContext( context.parentNode ) || context
+	);
+	return results;
+};
+
+// One-time assignments
+
+// Sort stability
+support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando;
+
+// Support: Chrome 14-35+
+// Always assume duplicates if they aren't passed to the comparison function
+support.detectDuplicates = !!hasDuplicate;
+
+// Initialize against the default document
+setDocument();
+
+// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27)
+// Detached nodes confoundingly follow *each other*
+support.sortDetached = assert( function( el ) {
+
+	// Should return 1, but returns 4 (following)
+	return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1;
+} );
+
+// Support: IE<8
+// Prevent attribute/property "interpolation"
+// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx
+if ( !assert( function( el ) {
+	el.innerHTML = "<a href='#'></a>";
+	return el.firstChild.getAttribute( "href" ) === "#";
+} ) ) {
+	addHandle( "type|href|height|width", function( elem, name, isXML ) {
+		if ( !isXML ) {
+			return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 );
+		}
+	} );
+}
+
+// Support: IE<9
+// Use defaultValue in place of getAttribute("value")
+if ( !support.attributes || !assert( function( el ) {
+	el.innerHTML = "<input/>";
+	el.firstChild.setAttribute( "value", "" );
+	return el.firstChild.getAttribute( "value" ) === "";
+} ) ) {
+	addHandle( "value", function( elem, _name, isXML ) {
+		if ( !isXML && elem.nodeName.toLowerCase() === "input" ) {
+			return elem.defaultValue;
+		}
+	} );
+}
+
+// Support: IE<9
+// Use getAttributeNode to fetch booleans when getAttribute lies
+if ( !assert( function( el ) {
+	return el.getAttribute( "disabled" ) == null;
+} ) ) {
+	addHandle( booleans, function( elem, name, isXML ) {
+		var val;
+		if ( !isXML ) {
+			return elem[ name ] === true ? name.toLowerCase() :
+				( val = elem.getAttributeNode( name ) ) && val.specified ?
+					val.value :
+					null;
+		}
+	} );
+}
+
+return Sizzle;
+
+} )( window );
+
+
+
+jQuery.find = Sizzle;
+jQuery.expr = Sizzle.selectors;
+
+// Deprecated
+jQuery.expr[ ":" ] = jQuery.expr.pseudos;
+jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort;
+jQuery.text = Sizzle.getText;
+jQuery.isXMLDoc = Sizzle.isXML;
+jQuery.contains = Sizzle.contains;
+jQuery.escapeSelector = Sizzle.escape;
+
+
+
+
+var dir = function( elem, dir, until ) {
+	var matched = [],
+		truncate = until !== undefined;
+
+	while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) {
+		if ( elem.nodeType === 1 ) {
+			if ( truncate && jQuery( elem ).is( until ) ) {
+				break;
+			}
+			matched.push( elem );
+		}
+	}
+	return matched;
+};
+
+
+var siblings = function( n, elem ) {
+	var matched = [];
+
+	for ( ; n; n = n.nextSibling ) {
+		if ( n.nodeType === 1 && n !== elem ) {
+			matched.push( n );
+		}
+	}
+
+	return matched;
+};
+
+
+var rneedsContext = jQuery.expr.match.needsContext;
+
+
+
+function nodeName( elem, name ) {
+
+	return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase();
+
+}
+var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i );
+
+
+
+// Implement the identical functionality for filter and not
+function winnow( elements, qualifier, not ) {
+	if ( isFunction( qualifier ) ) {
+		return jQuery.grep( elements, function( elem, i ) {
+			return !!qualifier.call( elem, i, elem ) !== not;
+		} );
+	}
+
+	// Single element
+	if ( qualifier.nodeType ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( elem === qualifier ) !== not;
+		} );
+	}
+
+	// Arraylike of elements (jQuery, arguments, Array)
+	if ( typeof qualifier !== "string" ) {
+		return jQuery.grep( elements, function( elem ) {
+			return ( indexOf.call( qualifier, elem ) > -1 ) !== not;
+		} );
+	}
+
+	// Filtered directly for both simple and complex selectors
+	return jQuery.filter( qualifier, elements, not );
+}
+
+jQuery.filter = function( expr, elems, not ) {
+	var elem = elems[ 0 ];
+
+	if ( not ) {
+		expr = ":not(" + expr + ")";
+	}
+
+	if ( elems.length === 1 && elem.nodeType === 1 ) {
+		return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [];
+	}
+
+	return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) {
+		return elem.nodeType === 1;
+	} ) );
+};
+
+jQuery.fn.extend( {
+	find: function( selector ) {
+		var i, ret,
+			len = this.length,
+			self = this;
+
+		if ( typeof selector !== "string" ) {
+			return this.pushStack( jQuery( selector ).filter( function() {
+				for ( i = 0; i < len; i++ ) {
+					if ( jQuery.contains( self[ i ], this ) ) {
+						return true;
+					}
+				}
+			} ) );
+		}
+
+		ret = this.pushStack( [] );
+
+		for ( i = 0; i < len; i++ ) {
+			jQuery.find( selector, self[ i ], ret );
+		}
+
+		return len > 1 ? jQuery.uniqueSort( ret ) : ret;
+	},
+	filter: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], false ) );
+	},
+	not: function( selector ) {
+		return this.pushStack( winnow( this, selector || [], true ) );
+	},
+	is: function( selector ) {
+		return !!winnow(
+			this,
+
+			// If this is a positional/relative selector, check membership in the returned set
+			// so $("p:first").is("p:last") won't return true for a doc with two "p".
+			typeof selector === "string" && rneedsContext.test( selector ) ?
+				jQuery( selector ) :
+				selector || [],
+			false
+		).length;
+	}
+} );
+
+
+// Initialize a jQuery object
+
+
+// A central reference to the root jQuery(document)
+var rootjQuery,
+
+	// A simple way to check for HTML strings
+	// Prioritize #id over <tag> to avoid XSS via location.hash (#9521)
+	// Strict HTML recognition (#11290: must start with <)
+	// Shortcut simple #id case for speed
+	rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/,
+
+	init = jQuery.fn.init = function( selector, context, root ) {
+		var match, elem;
+
+		// HANDLE: $(""), $(null), $(undefined), $(false)
+		if ( !selector ) {
+			return this;
+		}
+
+		// Method init() accepts an alternate rootjQuery
+		// so migrate can support jQuery.sub (gh-2101)
+		root = root || rootjQuery;
+
+		// Handle HTML strings
+		if ( typeof selector === "string" ) {
+			if ( selector[ 0 ] === "<" &&
+				selector[ selector.length - 1 ] === ">" &&
+				selector.length >= 3 ) {
+
+				// Assume that strings that start and end with <> are HTML and skip the regex check
+				match = [ null, selector, null ];
+
+			} else {
+				match = rquickExpr.exec( selector );
+			}
+
+			// Match html or make sure no context is specified for #id
+			if ( match && ( match[ 1 ] || !context ) ) {
+
+				// HANDLE: $(html) -> $(array)
+				if ( match[ 1 ] ) {
+					context = context instanceof jQuery ? context[ 0 ] : context;
+
+					// Option to run scripts is true for back-compat
+					// Intentionally let the error be thrown if parseHTML is not present
+					jQuery.merge( this, jQuery.parseHTML(
+						match[ 1 ],
+						context && context.nodeType ? context.ownerDocument || context : document,
+						true
+					) );
+
+					// HANDLE: $(html, props)
+					if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) {
+						for ( match in context ) {
+
+							// Properties of context are called as methods if possible
+							if ( isFunction( this[ match ] ) ) {
+								this[ match ]( context[ match ] );
+
+							// ...and otherwise set as attributes
+							} else {
+								this.attr( match, context[ match ] );
+							}
+						}
+					}
+
+					return this;
+
+				// HANDLE: $(#id)
+				} else {
+					elem = document.getElementById( match[ 2 ] );
+
+					if ( elem ) {
+
+						// Inject the element directly into the jQuery object
+						this[ 0 ] = elem;
+						this.length = 1;
+					}
+					return this;
+				}
+
+			// HANDLE: $(expr, $(...))
+			} else if ( !context || context.jquery ) {
+				return ( context || root ).find( selector );
+
+			// HANDLE: $(expr, context)
+			// (which is just equivalent to: $(context).find(expr)
+			} else {
+				return this.constructor( context ).find( selector );
+			}
+
+		// HANDLE: $(DOMElement)
+		} else if ( selector.nodeType ) {
+			this[ 0 ] = selector;
+			this.length = 1;
+			return this;
+
+		// HANDLE: $(function)
+		// Shortcut for document ready
+		} else if ( isFunction( selector ) ) {
+			return root.ready !== undefined ?
+				root.ready( selector ) :
+
+				// Execute immediately if ready is not present
+				selector( jQuery );
+		}
+
+		return jQuery.makeArray( selector, this );
+	};
+
+// Give the init function the jQuery prototype for later instantiation
+init.prototype = jQuery.fn;
+
+// Initialize central reference
+rootjQuery = jQuery( document );
+
+
+var rparentsprev = /^(?:parents|prev(?:Until|All))/,
+
+	// Methods guaranteed to produce a unique set when starting from a unique set
+	guaranteedUnique = {
+		children: true,
+		contents: true,
+		next: true,
+		prev: true
+	};
+
+jQuery.fn.extend( {
+	has: function( target ) {
+		var targets = jQuery( target, this ),
+			l = targets.length;
+
+		return this.filter( function() {
+			var i = 0;
+			for ( ; i < l; i++ ) {
+				if ( jQuery.contains( this, targets[ i ] ) ) {
+					return true;
+				}
+			}
+		} );
+	},
+
+	closest: function( selectors, context ) {
+		var cur,
+			i = 0,
+			l = this.length,
+			matched = [],
+			targets = typeof selectors !== "string" && jQuery( selectors );
+
+		// Positional selectors never match, since there's no _selection_ context
+		if ( !rneedsContext.test( selectors ) ) {
+			for ( ; i < l; i++ ) {
+				for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) {
+
+					// Always skip document fragments
+					if ( cur.nodeType < 11 && ( targets ?
+						targets.index( cur ) > -1 :
+
+						// Don't pass non-elements to Sizzle
+						cur.nodeType === 1 &&
+							jQuery.find.matchesSelector( cur, selectors ) ) ) {
+
+						matched.push( cur );
+						break;
+					}
+				}
+			}
+		}
+
+		return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched );
+	},
+
+	// Determine the position of an element within the set
+	index: function( elem ) {
+
+		// No argument, return index in parent
+		if ( !elem ) {
+			return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1;
+		}
+
+		// Index in selector
+		if ( typeof elem === "string" ) {
+			return indexOf.call( jQuery( elem ), this[ 0 ] );
+		}
+
+		// Locate the position of the desired element
+		return indexOf.call( this,
+
+			// If it receives a jQuery object, the first element is used
+			elem.jquery ? elem[ 0 ] : elem
+		);
+	},
+
+	add: function( selector, context ) {
+		return this.pushStack(
+			jQuery.uniqueSort(
+				jQuery.merge( this.get(), jQuery( selector, context ) )
+			)
+		);
+	},
+
+	addBack: function( selector ) {
+		return this.add( selector == null ?
+			this.prevObject : this.prevObject.filter( selector )
+		);
+	}
+} );
+
+function sibling( cur, dir ) {
+	while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {}
+	return cur;
+}
+
+jQuery.each( {
+	parent: function( elem ) {
+		var parent = elem.parentNode;
+		return parent && parent.nodeType !== 11 ? parent : null;
+	},
+	parents: function( elem ) {
+		return dir( elem, "parentNode" );
+	},
+	parentsUntil: function( elem, _i, until ) {
+		return dir( elem, "parentNode", until );
+	},
+	next: function( elem ) {
+		return sibling( elem, "nextSibling" );
+	},
+	prev: function( elem ) {
+		return sibling( elem, "previousSibling" );
+	},
+	nextAll: function( elem ) {
+		return dir( elem, "nextSibling" );
+	},
+	prevAll: function( elem ) {
+		return dir( elem, "previousSibling" );
+	},
+	nextUntil: function( elem, _i, until ) {
+		return dir( elem, "nextSibling", until );
+	},
+	prevUntil: function( elem, _i, until ) {
+		return dir( elem, "previousSibling", until );
+	},
+	siblings: function( elem ) {
+		return siblings( ( elem.parentNode || {} ).firstChild, elem );
+	},
+	children: function( elem ) {
+		return siblings( elem.firstChild );
+	},
+	contents: function( elem ) {
+		if ( elem.contentDocument != null &&
+
+			// Support: IE 11+
+			// <object> elements with no `data` attribute has an object
+			// `contentDocument` with a `null` prototype.
+			getProto( elem.contentDocument ) ) {
+
+			return elem.contentDocument;
+		}
+
+		// Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only
+		// Treat the template element as a regular one in browsers that
+		// don't support it.
+		if ( nodeName( elem, "template" ) ) {
+			elem = elem.content || elem;
+		}
+
+		return jQuery.merge( [], elem.childNodes );
+	}
+}, function( name, fn ) {
+	jQuery.fn[ name ] = function( until, selector ) {
+		var matched = jQuery.map( this, fn, until );
+
+		if ( name.slice( -5 ) !== "Until" ) {
+			selector = until;
+		}
+
+		if ( selector && typeof selector === "string" ) {
+			matched = jQuery.filter( selector, matched );
+		}
+
+		if ( this.length > 1 ) {
+
+			// Remove duplicates
+			if ( !guaranteedUnique[ name ] ) {
+				jQuery.uniqueSort( matched );
+			}
+
+			// Reverse order for parents* and prev-derivatives
+			if ( rparentsprev.test( name ) ) {
+				matched.reverse();
+			}
+		}
+
+		return this.pushStack( matched );
+	};
+} );
+var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g );
+
+
+
+// Convert String-formatted options into Object-formatted ones
+function createOptions( options ) {
+	var object = {};
+	jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) {
+		object[ flag ] = true;
+	} );
+	return object;
+}
+
+/*
+ * Create a callback list using the following parameters:
+ *
+ *	options: an optional list of space-separated options that will change how
+ *			the callback list behaves or a more traditional option object
+ *
+ * By default a callback list will act like an event callback list and can be
+ * "fired" multiple times.
+ *
+ * Possible options:
+ *
+ *	once:			will ensure the callback list can only be fired once (like a Deferred)
+ *
+ *	memory:			will keep track of previous values and will call any callback added
+ *					after the list has been fired right away with the latest "memorized"
+ *					values (like a Deferred)
+ *
+ *	unique:			will ensure a callback can only be added once (no duplicate in the list)
+ *
+ *	stopOnFalse:	interrupt callings when a callback returns false
+ *
+ */
+jQuery.Callbacks = function( options ) {
+
+	// Convert options from String-formatted to Object-formatted if needed
+	// (we check in cache first)
+	options = typeof options === "string" ?
+		createOptions( options ) :
+		jQuery.extend( {}, options );
+
+	var // Flag to know if list is currently firing
+		firing,
+
+		// Last fire value for non-forgettable lists
+		memory,
+
+		// Flag to know if list was already fired
+		fired,
+
+		// Flag to prevent firing
+		locked,
+
+		// Actual callback list
+		list = [],
+
+		// Queue of execution data for repeatable lists
+		queue = [],
+
+		// Index of currently firing callback (modified by add/remove as needed)
+		firingIndex = -1,
+
+		// Fire callbacks
+		fire = function() {
+
+			// Enforce single-firing
+			locked = locked || options.once;
+
+			// Execute callbacks for all pending executions,
+			// respecting firingIndex overrides and runtime changes
+			fired = firing = true;
+			for ( ; queue.length; firingIndex = -1 ) {
+				memory = queue.shift();
+				while ( ++firingIndex < list.length ) {
+
+					// Run callback and check for early termination
+					if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false &&
+						options.stopOnFalse ) {
+
+						// Jump to end and forget the data so .add doesn't re-fire
+						firingIndex = list.length;
+						memory = false;
+					}
+				}
+			}
+
+			// Forget the data if we're done with it
+			if ( !options.memory ) {
+				memory = false;
+			}
+
+			firing = false;
+
+			// Clean up if we're done firing for good
+			if ( locked ) {
+
+				// Keep an empty list if we have data for future add calls
+				if ( memory ) {
+					list = [];
+
+				// Otherwise, this object is spent
+				} else {
+					list = "";
+				}
+			}
+		},
+
+		// Actual Callbacks object
+		self = {
+
+			// Add a callback or a collection of callbacks to the list
+			add: function() {
+				if ( list ) {
+
+					// If we have memory from a past run, we should fire after adding
+					if ( memory && !firing ) {
+						firingIndex = list.length - 1;
+						queue.push( memory );
+					}
+
+					( function add( args ) {
+						jQuery.each( args, function( _, arg ) {
+							if ( isFunction( arg ) ) {
+								if ( !options.unique || !self.has( arg ) ) {
+									list.push( arg );
+								}
+							} else if ( arg && arg.length && toType( arg ) !== "string" ) {
+
+								// Inspect recursively
+								add( arg );
+							}
+						} );
+					} )( arguments );
+
+					if ( memory && !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Remove a callback from the list
+			remove: function() {
+				jQuery.each( arguments, function( _, arg ) {
+					var index;
+					while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) {
+						list.splice( index, 1 );
+
+						// Handle firing indexes
+						if ( index <= firingIndex ) {
+							firingIndex--;
+						}
+					}
+				} );
+				return this;
+			},
+
+			// Check if a given callback is in the list.
+			// If no argument is given, return whether or not list has callbacks attached.
+			has: function( fn ) {
+				return fn ?
+					jQuery.inArray( fn, list ) > -1 :
+					list.length > 0;
+			},
+
+			// Remove all callbacks from the list
+			empty: function() {
+				if ( list ) {
+					list = [];
+				}
+				return this;
+			},
+
+			// Disable .fire and .add
+			// Abort any current/pending executions
+			// Clear all callbacks and values
+			disable: function() {
+				locked = queue = [];
+				list = memory = "";
+				return this;
+			},
+			disabled: function() {
+				return !list;
+			},
+
+			// Disable .fire
+			// Also disable .add unless we have memory (since it would have no effect)
+			// Abort any pending executions
+			lock: function() {
+				locked = queue = [];
+				if ( !memory && !firing ) {
+					list = memory = "";
+				}
+				return this;
+			},
+			locked: function() {
+				return !!locked;
+			},
+
+			// Call all callbacks with the given context and arguments
+			fireWith: function( context, args ) {
+				if ( !locked ) {
+					args = args || [];
+					args = [ context, args.slice ? args.slice() : args ];
+					queue.push( args );
+					if ( !firing ) {
+						fire();
+					}
+				}
+				return this;
+			},
+
+			// Call all the callbacks with the given arguments
+			fire: function() {
+				self.fireWith( this, arguments );
+				return this;
+			},
+
+			// To know if the callbacks have already been called at least once
+			fired: function() {
+				return !!fired;
+			}
+		};
+
+	return self;
+};
+
+
+function Identity( v ) {
+	return v;
+}
+function Thrower( ex ) {
+	throw ex;
+}
+
+function adoptValue( value, resolve, reject, noValue ) {
+	var method;
+
+	try {
+
+		// Check for promise aspect first to privilege synchronous behavior
+		if ( value && isFunction( ( method = value.promise ) ) ) {
+			method.call( value ).done( resolve ).fail( reject );
+
+		// Other thenables
+		} else if ( value && isFunction( ( method = value.then ) ) ) {
+			method.call( value, resolve, reject );
+
+		// Other non-thenables
+		} else {
+
+			// Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer:
+			// * false: [ value ].slice( 0 ) => resolve( value )
+			// * true: [ value ].slice( 1 ) => resolve()
+			resolve.apply( undefined, [ value ].slice( noValue ) );
+		}
+
+	// For Promises/A+, convert exceptions into rejections
+	// Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in
+	// Deferred#then to conditionally suppress rejection.
+	} catch ( value ) {
+
+		// Support: Android 4.0 only
+		// Strict mode functions invoked without .call/.apply get global-object context
+		reject.apply( undefined, [ value ] );
+	}
+}
+
+jQuery.extend( {
+
+	Deferred: function( func ) {
+		var tuples = [
+
+				// action, add listener, callbacks,
+				// ... .then handlers, argument index, [final state]
+				[ "notify", "progress", jQuery.Callbacks( "memory" ),
+					jQuery.Callbacks( "memory" ), 2 ],
+				[ "resolve", "done", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 0, "resolved" ],
+				[ "reject", "fail", jQuery.Callbacks( "once memory" ),
+					jQuery.Callbacks( "once memory" ), 1, "rejected" ]
+			],
+			state = "pending",
+			promise = {
+				state: function() {
+					return state;
+				},
+				always: function() {
+					deferred.done( arguments ).fail( arguments );
+					return this;
+				},
+				"catch": function( fn ) {
+					return promise.then( null, fn );
+				},
+
+				// Keep pipe for back-compat
+				pipe: function( /* fnDone, fnFail, fnProgress */ ) {
+					var fns = arguments;
+
+					return jQuery.Deferred( function( newDefer ) {
+						jQuery.each( tuples, function( _i, tuple ) {
+
+							// Map tuples (progress, done, fail) to arguments (done, fail, progress)
+							var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ];
+
+							// deferred.progress(function() { bind to newDefer or newDefer.notify })
+							// deferred.done(function() { bind to newDefer or newDefer.resolve })
+							// deferred.fail(function() { bind to newDefer or newDefer.reject })
+							deferred[ tuple[ 1 ] ]( function() {
+								var returned = fn && fn.apply( this, arguments );
+								if ( returned && isFunction( returned.promise ) ) {
+									returned.promise()
+										.progress( newDefer.notify )
+										.done( newDefer.resolve )
+										.fail( newDefer.reject );
+								} else {
+									newDefer[ tuple[ 0 ] + "With" ](
+										this,
+										fn ? [ returned ] : arguments
+									);
+								}
+							} );
+						} );
+						fns = null;
+					} ).promise();
+				},
+				then: function( onFulfilled, onRejected, onProgress ) {
+					var maxDepth = 0;
+					function resolve( depth, deferred, handler, special ) {
+						return function() {
+							var that = this,
+								args = arguments,
+								mightThrow = function() {
+									var returned, then;
+
+									// Support: Promises/A+ section 2.3.3.3.3
+									// https://promisesaplus.com/#point-59
+									// Ignore double-resolution attempts
+									if ( depth < maxDepth ) {
+										return;
+									}
+
+									returned = handler.apply( that, args );
+
+									// Support: Promises/A+ section 2.3.1
+									// https://promisesaplus.com/#point-48
+									if ( returned === deferred.promise() ) {
+										throw new TypeError( "Thenable self-resolution" );
+									}
+
+									// Support: Promises/A+ sections 2.3.3.1, 3.5
+									// https://promisesaplus.com/#point-54
+									// https://promisesaplus.com/#point-75
+									// Retrieve `then` only once
+									then = returned &&
+
+										// Support: Promises/A+ section 2.3.4
+										// https://promisesaplus.com/#point-64
+										// Only check objects and functions for thenability
+										( typeof returned === "object" ||
+											typeof returned === "function" ) &&
+										returned.then;
+
+									// Handle a returned thenable
+									if ( isFunction( then ) ) {
+
+										// Special processors (notify) just wait for resolution
+										if ( special ) {
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special )
+											);
+
+										// Normal processors (resolve) also hook into progress
+										} else {
+
+											// ...and disregard older resolution values
+											maxDepth++;
+
+											then.call(
+												returned,
+												resolve( maxDepth, deferred, Identity, special ),
+												resolve( maxDepth, deferred, Thrower, special ),
+												resolve( maxDepth, deferred, Identity,
+													deferred.notifyWith )
+											);
+										}
+
+									// Handle all other returned values
+									} else {
+
+										// Only substitute handlers pass on context
+										// and multiple values (non-spec behavior)
+										if ( handler !== Identity ) {
+											that = undefined;
+											args = [ returned ];
+										}
+
+										// Process the value(s)
+										// Default process is resolve
+										( special || deferred.resolveWith )( that, args );
+									}
+								},
+
+								// Only normal processors (resolve) catch and reject exceptions
+								process = special ?
+									mightThrow :
+									function() {
+										try {
+											mightThrow();
+										} catch ( e ) {
+
+											if ( jQuery.Deferred.exceptionHook ) {
+												jQuery.Deferred.exceptionHook( e,
+													process.stackTrace );
+											}
+
+											// Support: Promises/A+ section 2.3.3.3.4.1
+											// https://promisesaplus.com/#point-61
+											// Ignore post-resolution exceptions
+											if ( depth + 1 >= maxDepth ) {
+
+												// Only substitute handlers pass on context
+												// and multiple values (non-spec behavior)
+												if ( handler !== Thrower ) {
+													that = undefined;
+													args = [ e ];
+												}
+
+												deferred.rejectWith( that, args );
+											}
+										}
+									};
+
+							// Support: Promises/A+ section 2.3.3.3.1
+							// https://promisesaplus.com/#point-57
+							// Re-resolve promises immediately to dodge false rejection from
+							// subsequent errors
+							if ( depth ) {
+								process();
+							} else {
+
+								// Call an optional hook to record the stack, in case of exception
+								// since it's otherwise lost when execution goes async
+								if ( jQuery.Deferred.getStackHook ) {
+									process.stackTrace = jQuery.Deferred.getStackHook();
+								}
+								window.setTimeout( process );
+							}
+						};
+					}
+
+					return jQuery.Deferred( function( newDefer ) {
+
+						// progress_handlers.add( ... )
+						tuples[ 0 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onProgress ) ?
+									onProgress :
+									Identity,
+								newDefer.notifyWith
+							)
+						);
+
+						// fulfilled_handlers.add( ... )
+						tuples[ 1 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onFulfilled ) ?
+									onFulfilled :
+									Identity
+							)
+						);
+
+						// rejected_handlers.add( ... )
+						tuples[ 2 ][ 3 ].add(
+							resolve(
+								0,
+								newDefer,
+								isFunction( onRejected ) ?
+									onRejected :
+									Thrower
+							)
+						);
+					} ).promise();
+				},
+
+				// Get a promise for this deferred
+				// If obj is provided, the promise aspect is added to the object
+				promise: function( obj ) {
+					return obj != null ? jQuery.extend( obj, promise ) : promise;
+				}
+			},
+			deferred = {};
+
+		// Add list-specific methods
+		jQuery.each( tuples, function( i, tuple ) {
+			var list = tuple[ 2 ],
+				stateString = tuple[ 5 ];
+
+			// promise.progress = list.add
+			// promise.done = list.add
+			// promise.fail = list.add
+			promise[ tuple[ 1 ] ] = list.add;
+
+			// Handle state
+			if ( stateString ) {
+				list.add(
+					function() {
+
+						// state = "resolved" (i.e., fulfilled)
+						// state = "rejected"
+						state = stateString;
+					},
+
+					// rejected_callbacks.disable
+					// fulfilled_callbacks.disable
+					tuples[ 3 - i ][ 2 ].disable,
+
+					// rejected_handlers.disable
+					// fulfilled_handlers.disable
+					tuples[ 3 - i ][ 3 ].disable,
+
+					// progress_callbacks.lock
+					tuples[ 0 ][ 2 ].lock,
+
+					// progress_handlers.lock
+					tuples[ 0 ][ 3 ].lock
+				);
+			}
+
+			// progress_handlers.fire
+			// fulfilled_handlers.fire
+			// rejected_handlers.fire
+			list.add( tuple[ 3 ].fire );
+
+			// deferred.notify = function() { deferred.notifyWith(...) }
+			// deferred.resolve = function() { deferred.resolveWith(...) }
+			// deferred.reject = function() { deferred.rejectWith(...) }
+			deferred[ tuple[ 0 ] ] = function() {
+				deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments );
+				return this;
+			};
+
+			// deferred.notifyWith = list.fireWith
+			// deferred.resolveWith = list.fireWith
+			// deferred.rejectWith = list.fireWith
+			deferred[ tuple[ 0 ] + "With" ] = list.fireWith;
+		} );
+
+		// Make the deferred a promise
+		promise.promise( deferred );
+
+		// Call given func if any
+		if ( func ) {
+			func.call( deferred, deferred );
+		}
+
+		// All done!
+		return deferred;
+	},
+
+	// Deferred helper
+	when: function( singleValue ) {
+		var
+
+			// count of uncompleted subordinates
+			remaining = arguments.length,
+
+			// count of unprocessed arguments
+			i = remaining,
+
+			// subordinate fulfillment data
+			resolveContexts = Array( i ),
+			resolveValues = slice.call( arguments ),
+
+			// the primary Deferred
+			primary = jQuery.Deferred(),
+
+			// subordinate callback factory
+			updateFunc = function( i ) {
+				return function( value ) {
+					resolveContexts[ i ] = this;
+					resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value;
+					if ( !( --remaining ) ) {
+						primary.resolveWith( resolveContexts, resolveValues );
+					}
+				};
+			};
+
+		// Single- and empty arguments are adopted like Promise.resolve
+		if ( remaining <= 1 ) {
+			adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject,
+				!remaining );
+
+			// Use .then() to unwrap secondary thenables (cf. gh-3000)
+			if ( primary.state() === "pending" ||
+				isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) {
+
+				return primary.then();
+			}
+		}
+
+		// Multiple arguments are aggregated like Promise.all array elements
+		while ( i-- ) {
+			adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject );
+		}
+
+		return primary.promise();
+	}
+} );
+
+
+// These usually indicate a programmer mistake during development,
+// warn about them ASAP rather than swallowing them by default.
+var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;
+
+jQuery.Deferred.exceptionHook = function( error, stack ) {
+
+	// Support: IE 8 - 9 only
+	// Console exists when dev tools are open, which can happen at any time
+	if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) {
+		window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack );
+	}
+};
+
+
+
+
+jQuery.readyException = function( error ) {
+	window.setTimeout( function() {
+		throw error;
+	} );
+};
+
+
+
+
+// The deferred used on DOM ready
+var readyList = jQuery.Deferred();
+
+jQuery.fn.ready = function( fn ) {
+
+	readyList
+		.then( fn )
+
+		// Wrap jQuery.readyException in a function so that the lookup
+		// happens at the time of error handling instead of callback
+		// registration.
+		.catch( function( error ) {
+			jQuery.readyException( error );
+		} );
+
+	return this;
+};
+
+jQuery.extend( {
+
+	// Is the DOM ready to be used? Set to true once it occurs.
+	isReady: false,
+
+	// A counter to track how many items to wait for before
+	// the ready event fires. See #6781
+	readyWait: 1,
+
+	// Handle when the DOM is ready
+	ready: function( wait ) {
+
+		// Abort if there are pending holds or we're already ready
+		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
+			return;
+		}
+
+		// Remember that the DOM is ready
+		jQuery.isReady = true;
+
+		// If a normal DOM Ready event fired, decrement, and wait if need be
+		if ( wait !== true && --jQuery.readyWait > 0 ) {
+			return;
+		}
+
+		// If there are functions bound, to execute
+		readyList.resolveWith( document, [ jQuery ] );
+	}
+} );
+
+jQuery.ready.then = readyList.then;
+
+// The ready event handler and self cleanup method
+function completed() {
+	document.removeEventListener( "DOMContentLoaded", completed );
+	window.removeEventListener( "load", completed );
+	jQuery.ready();
+}
+
+// Catch cases where $(document).ready() is called
+// after the browser event has already occurred.
+// Support: IE <=9 - 10 only
+// Older IE sometimes signals "interactive" too soon
+if ( document.readyState === "complete" ||
+	( document.readyState !== "loading" && !document.documentElement.doScroll ) ) {
+
+	// Handle it asynchronously to allow scripts the opportunity to delay ready
+	window.setTimeout( jQuery.ready );
+
+} else {
+
+	// Use the handy event callback
+	document.addEventListener( "DOMContentLoaded", completed );
+
+	// A fallback to window.onload, that will always work
+	window.addEventListener( "load", completed );
+}
+
+
+
+
+// Multifunctional method to get and set values of a collection
+// The value/s can optionally be executed if it's a function
+var access = function( elems, fn, key, value, chainable, emptyGet, raw ) {
+	var i = 0,
+		len = elems.length,
+		bulk = key == null;
+
+	// Sets many values
+	if ( toType( key ) === "object" ) {
+		chainable = true;
+		for ( i in key ) {
+			access( elems, fn, i, key[ i ], true, emptyGet, raw );
+		}
+
+	// Sets one value
+	} else if ( value !== undefined ) {
+		chainable = true;
+
+		if ( !isFunction( value ) ) {
+			raw = true;
+		}
+
+		if ( bulk ) {
+
+			// Bulk operations run against the entire set
+			if ( raw ) {
+				fn.call( elems, value );
+				fn = null;
+
+			// ...except when executing function values
+			} else {
+				bulk = fn;
+				fn = function( elem, _key, value ) {
+					return bulk.call( jQuery( elem ), value );
+				};
+			}
+		}
+
+		if ( fn ) {
+			for ( ; i < len; i++ ) {
+				fn(
+					elems[ i ], key, raw ?
+						value :
+						value.call( elems[ i ], i, fn( elems[ i ], key ) )
+				);
+			}
+		}
+	}
+
+	if ( chainable ) {
+		return elems;
+	}
+
+	// Gets
+	if ( bulk ) {
+		return fn.call( elems );
+	}
+
+	return len ? fn( elems[ 0 ], key ) : emptyGet;
+};
+
+
+// Matches dashed string for camelizing
+var rmsPrefix = /^-ms-/,
+	rdashAlpha = /-([a-z])/g;
+
+// Used by camelCase as callback to replace()
+function fcamelCase( _all, letter ) {
+	return letter.toUpperCase();
+}
+
+// Convert dashed to camelCase; used by the css and data modules
+// Support: IE <=9 - 11, Edge 12 - 15
+// Microsoft forgot to hump their vendor prefix (#9572)
+function camelCase( string ) {
+	return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase );
+}
+var acceptData = function( owner ) {
+
+	// Accepts only:
+	//  - Node
+	//    - Node.ELEMENT_NODE
+	//    - Node.DOCUMENT_NODE
+	//  - Object
+	//    - Any
+	return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType );
+};
+
+
+
+
+function Data() {
+	this.expando = jQuery.expando + Data.uid++;
+}
+
+Data.uid = 1;
+
+Data.prototype = {
+
+	cache: function( owner ) {
+
+		// Check if the owner object already has a cache
+		var value = owner[ this.expando ];
+
+		// If not, create one
+		if ( !value ) {
+			value = {};
+
+			// We can accept data for non-element nodes in modern browsers,
+			// but we should not, see #8335.
+			// Always return an empty object.
+			if ( acceptData( owner ) ) {
+
+				// If it is a node unlikely to be stringify-ed or looped over
+				// use plain assignment
+				if ( owner.nodeType ) {
+					owner[ this.expando ] = value;
+
+				// Otherwise secure it in a non-enumerable property
+				// configurable must be true to allow the property to be
+				// deleted when data is removed
+				} else {
+					Object.defineProperty( owner, this.expando, {
+						value: value,
+						configurable: true
+					} );
+				}
+			}
+		}
+
+		return value;
+	},
+	set: function( owner, data, value ) {
+		var prop,
+			cache = this.cache( owner );
+
+		// Handle: [ owner, key, value ] args
+		// Always use camelCase key (gh-2257)
+		if ( typeof data === "string" ) {
+			cache[ camelCase( data ) ] = value;
+
+		// Handle: [ owner, { properties } ] args
+		} else {
+
+			// Copy the properties one-by-one to the cache object
+			for ( prop in data ) {
+				cache[ camelCase( prop ) ] = data[ prop ];
+			}
+		}
+		return cache;
+	},
+	get: function( owner, key ) {
+		return key === undefined ?
+			this.cache( owner ) :
+
+			// Always use camelCase key (gh-2257)
+			owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ];
+	},
+	access: function( owner, key, value ) {
+
+		// In cases where either:
+		//
+		//   1. No key was specified
+		//   2. A string key was specified, but no value provided
+		//
+		// Take the "read" path and allow the get method to determine
+		// which value to return, respectively either:
+		//
+		//   1. The entire cache object
+		//   2. The data stored at the key
+		//
+		if ( key === undefined ||
+				( ( key && typeof key === "string" ) && value === undefined ) ) {
+
+			return this.get( owner, key );
+		}
+
+		// When the key is not a string, or both a key and value
+		// are specified, set or extend (existing objects) with either:
+		//
+		//   1. An object of properties
+		//   2. A key and value
+		//
+		this.set( owner, key, value );
+
+		// Since the "set" path can have two possible entry points
+		// return the expected data based on which path was taken[*]
+		return value !== undefined ? value : key;
+	},
+	remove: function( owner, key ) {
+		var i,
+			cache = owner[ this.expando ];
+
+		if ( cache === undefined ) {
+			return;
+		}
+
+		if ( key !== undefined ) {
+
+			// Support array or space separated string of keys
+			if ( Array.isArray( key ) ) {
+
+				// If key is an array of keys...
+				// We always set camelCase keys, so remove that.
+				key = key.map( camelCase );
+			} else {
+				key = camelCase( key );
+
+				// If a key with the spaces exists, use it.
+				// Otherwise, create an array by matching non-whitespace
+				key = key in cache ?
+					[ key ] :
+					( key.match( rnothtmlwhite ) || [] );
+			}
+
+			i = key.length;
+
+			while ( i-- ) {
+				delete cache[ key[ i ] ];
+			}
+		}
+
+		// Remove the expando if there's no more data
+		if ( key === undefined || jQuery.isEmptyObject( cache ) ) {
+
+			// Support: Chrome <=35 - 45
+			// Webkit & Blink performance suffers when deleting properties
+			// from DOM nodes, so set to undefined instead
+			// https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted)
+			if ( owner.nodeType ) {
+				owner[ this.expando ] = undefined;
+			} else {
+				delete owner[ this.expando ];
+			}
+		}
+	},
+	hasData: function( owner ) {
+		var cache = owner[ this.expando ];
+		return cache !== undefined && !jQuery.isEmptyObject( cache );
+	}
+};
+var dataPriv = new Data();
+
+var dataUser = new Data();
+
+
+
+//	Implementation Summary
+//
+//	1. Enforce API surface and semantic compatibility with 1.9.x branch
+//	2. Improve the module's maintainability by reducing the storage
+//		paths to a single mechanism.
+//	3. Use the same single mechanism to support "private" and "user" data.
+//	4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData)
+//	5. Avoid exposing implementation details on user objects (eg. expando properties)
+//	6. Provide a clear path for implementation upgrade to WeakMap in 2014
+
+var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,
+	rmultiDash = /[A-Z]/g;
+
+function getData( data ) {
+	if ( data === "true" ) {
+		return true;
+	}
+
+	if ( data === "false" ) {
+		return false;
+	}
+
+	if ( data === "null" ) {
+		return null;
+	}
+
+	// Only convert to a number if it doesn't change the string
+	if ( data === +data + "" ) {
+		return +data;
+	}
+
+	if ( rbrace.test( data ) ) {
+		return JSON.parse( data );
+	}
+
+	return data;
+}
+
+function dataAttr( elem, key, data ) {
+	var name;
+
+	// If nothing was found internally, try to fetch any
+	// data from the HTML5 data-* attribute
+	if ( data === undefined && elem.nodeType === 1 ) {
+		name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase();
+		data = elem.getAttribute( name );
+
+		if ( typeof data === "string" ) {
+			try {
+				data = getData( data );
+			} catch ( e ) {}
+
+			// Make sure we set the data so it isn't changed later
+			dataUser.set( elem, key, data );
+		} else {
+			data = undefined;
+		}
+	}
+	return data;
+}
+
+jQuery.extend( {
+	hasData: function( elem ) {
+		return dataUser.hasData( elem ) || dataPriv.hasData( elem );
+	},
+
+	data: function( elem, name, data ) {
+		return dataUser.access( elem, name, data );
+	},
+
+	removeData: function( elem, name ) {
+		dataUser.remove( elem, name );
+	},
+
+	// TODO: Now that all calls to _data and _removeData have been replaced
+	// with direct calls to dataPriv methods, these can be deprecated.
+	_data: function( elem, name, data ) {
+		return dataPriv.access( elem, name, data );
+	},
+
+	_removeData: function( elem, name ) {
+		dataPriv.remove( elem, name );
+	}
+} );
+
+jQuery.fn.extend( {
+	data: function( key, value ) {
+		var i, name, data,
+			elem = this[ 0 ],
+			attrs = elem && elem.attributes;
+
+		// Gets all values
+		if ( key === undefined ) {
+			if ( this.length ) {
+				data = dataUser.get( elem );
+
+				if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) {
+					i = attrs.length;
+					while ( i-- ) {
+
+						// Support: IE 11 only
+						// The attrs elements can be null (#14894)
+						if ( attrs[ i ] ) {
+							name = attrs[ i ].name;
+							if ( name.indexOf( "data-" ) === 0 ) {
+								name = camelCase( name.slice( 5 ) );
+								dataAttr( elem, name, data[ name ] );
+							}
+						}
+					}
+					dataPriv.set( elem, "hasDataAttrs", true );
+				}
+			}
+
+			return data;
+		}
+
+		// Sets multiple values
+		if ( typeof key === "object" ) {
+			return this.each( function() {
+				dataUser.set( this, key );
+			} );
+		}
+
+		return access( this, function( value ) {
+			var data;
+
+			// The calling jQuery object (element matches) is not empty
+			// (and therefore has an element appears at this[ 0 ]) and the
+			// `value` parameter was not undefined. An empty jQuery object
+			// will result in `undefined` for elem = this[ 0 ] which will
+			// throw an exception if an attempt to read a data cache is made.
+			if ( elem && value === undefined ) {
+
+				// Attempt to get data from the cache
+				// The key will always be camelCased in Data
+				data = dataUser.get( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// Attempt to "discover" the data in
+				// HTML5 custom data-* attrs
+				data = dataAttr( elem, key );
+				if ( data !== undefined ) {
+					return data;
+				}
+
+				// We tried really hard, but the data doesn't exist.
+				return;
+			}
+
+			// Set the data...
+			this.each( function() {
+
+				// We always store the camelCased key
+				dataUser.set( this, key, value );
+			} );
+		}, null, value, arguments.length > 1, null, true );
+	},
+
+	removeData: function( key ) {
+		return this.each( function() {
+			dataUser.remove( this, key );
+		} );
+	}
+} );
+
+
+jQuery.extend( {
+	queue: function( elem, type, data ) {
+		var queue;
+
+		if ( elem ) {
+			type = ( type || "fx" ) + "queue";
+			queue = dataPriv.get( elem, type );
+
+			// Speed up dequeue by getting out quickly if this is just a lookup
+			if ( data ) {
+				if ( !queue || Array.isArray( data ) ) {
+					queue = dataPriv.access( elem, type, jQuery.makeArray( data ) );
+				} else {
+					queue.push( data );
+				}
+			}
+			return queue || [];
+		}
+	},
+
+	dequeue: function( elem, type ) {
+		type = type || "fx";
+
+		var queue = jQuery.queue( elem, type ),
+			startLength = queue.length,
+			fn = queue.shift(),
+			hooks = jQuery._queueHooks( elem, type ),
+			next = function() {
+				jQuery.dequeue( elem, type );
+			};
+
+		// If the fx queue is dequeued, always remove the progress sentinel
+		if ( fn === "inprogress" ) {
+			fn = queue.shift();
+			startLength--;
+		}
+
+		if ( fn ) {
+
+			// Add a progress sentinel to prevent the fx queue from being
+			// automatically dequeued
+			if ( type === "fx" ) {
+				queue.unshift( "inprogress" );
+			}
+
+			// Clear up the last queue stop function
+			delete hooks.stop;
+			fn.call( elem, next, hooks );
+		}
+
+		if ( !startLength && hooks ) {
+			hooks.empty.fire();
+		}
+	},
+
+	// Not public - generate a queueHooks object, or return the current one
+	_queueHooks: function( elem, type ) {
+		var key = type + "queueHooks";
+		return dataPriv.get( elem, key ) || dataPriv.access( elem, key, {
+			empty: jQuery.Callbacks( "once memory" ).add( function() {
+				dataPriv.remove( elem, [ type + "queue", key ] );
+			} )
+		} );
+	}
+} );
+
+jQuery.fn.extend( {
+	queue: function( type, data ) {
+		var setter = 2;
+
+		if ( typeof type !== "string" ) {
+			data = type;
+			type = "fx";
+			setter--;
+		}
+
+		if ( arguments.length < setter ) {
+			return jQuery.queue( this[ 0 ], type );
+		}
+
+		return data === undefined ?
+			this :
+			this.each( function() {
+				var queue = jQuery.queue( this, type, data );
+
+				// Ensure a hooks for this queue
+				jQuery._queueHooks( this, type );
+
+				if ( type === "fx" && queue[ 0 ] !== "inprogress" ) {
+					jQuery.dequeue( this, type );
+				}
+			} );
+	},
+	dequeue: function( type ) {
+		return this.each( function() {
+			jQuery.dequeue( this, type );
+		} );
+	},
+	clearQueue: function( type ) {
+		return this.queue( type || "fx", [] );
+	},
+
+	// Get a promise resolved when queues of a certain type
+	// are emptied (fx is the type by default)
+	promise: function( type, obj ) {
+		var tmp,
+			count = 1,
+			defer = jQuery.Deferred(),
+			elements = this,
+			i = this.length,
+			resolve = function() {
+				if ( !( --count ) ) {
+					defer.resolveWith( elements, [ elements ] );
+				}
+			};
+
+		if ( typeof type !== "string" ) {
+			obj = type;
+			type = undefined;
+		}
+		type = type || "fx";
+
+		while ( i-- ) {
+			tmp = dataPriv.get( elements[ i ], type + "queueHooks" );
+			if ( tmp && tmp.empty ) {
+				count++;
+				tmp.empty.add( resolve );
+			}
+		}
+		resolve();
+		return defer.promise( obj );
+	}
+} );
+var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source;
+
+var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" );
+
+
+var cssExpand = [ "Top", "Right", "Bottom", "Left" ];
+
+var documentElement = document.documentElement;
+
+
+
+	var isAttached = function( elem ) {
+			return jQuery.contains( elem.ownerDocument, elem );
+		},
+		composed = { composed: true };
+
+	// Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only
+	// Check attachment across shadow DOM boundaries when possible (gh-3504)
+	// Support: iOS 10.0-10.2 only
+	// Early iOS 10 versions support `attachShadow` but not `getRootNode`,
+	// leading to errors. We need to check for `getRootNode`.
+	if ( documentElement.getRootNode ) {
+		isAttached = function( elem ) {
+			return jQuery.contains( elem.ownerDocument, elem ) ||
+				elem.getRootNode( composed ) === elem.ownerDocument;
+		};
+	}
+var isHiddenWithinTree = function( elem, el ) {
+
+		// isHiddenWithinTree might be called from jQuery#filter function;
+		// in that case, element will be second argument
+		elem = el || elem;
+
+		// Inline style trumps all
+		return elem.style.display === "none" ||
+			elem.style.display === "" &&
+
+			// Otherwise, check computed style
+			// Support: Firefox <=43 - 45
+			// Disconnected elements can have computed display: none, so first confirm that elem is
+			// in the document.
+			isAttached( elem ) &&
+
+			jQuery.css( elem, "display" ) === "none";
+	};
+
+
+
+function adjustCSS( elem, prop, valueParts, tween ) {
+	var adjusted, scale,
+		maxIterations = 20,
+		currentValue = tween ?
+			function() {
+				return tween.cur();
+			} :
+			function() {
+				return jQuery.css( elem, prop, "" );
+			},
+		initial = currentValue(),
+		unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ),
+
+		// Starting value computation is required for potential unit mismatches
+		initialInUnit = elem.nodeType &&
+			( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) &&
+			rcssNum.exec( jQuery.css( elem, prop ) );
+
+	if ( initialInUnit && initialInUnit[ 3 ] !== unit ) {
+
+		// Support: Firefox <=54
+		// Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144)
+		initial = initial / 2;
+
+		// Trust units reported by jQuery.css
+		unit = unit || initialInUnit[ 3 ];
+
+		// Iteratively approximate from a nonzero starting point
+		initialInUnit = +initial || 1;
+
+		while ( maxIterations-- ) {
+
+			// Evaluate and update our best guess (doubling guesses that zero out).
+			// Finish if the scale equals or crosses 1 (making the old*new product non-positive).
+			jQuery.style( elem, prop, initialInUnit + unit );
+			if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) {
+				maxIterations = 0;
+			}
+			initialInUnit = initialInUnit / scale;
+
+		}
+
+		initialInUnit = initialInUnit * 2;
+		jQuery.style( elem, prop, initialInUnit + unit );
+
+		// Make sure we update the tween properties later on
+		valueParts = valueParts || [];
+	}
+
+	if ( valueParts ) {
+		initialInUnit = +initialInUnit || +initial || 0;
+
+		// Apply relative offset (+=/-=) if specified
+		adjusted = valueParts[ 1 ] ?
+			initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] :
+			+valueParts[ 2 ];
+		if ( tween ) {
+			tween.unit = unit;
+			tween.start = initialInUnit;
+			tween.end = adjusted;
+		}
+	}
+	return adjusted;
+}
+
+
+var defaultDisplayMap = {};
+
+function getDefaultDisplay( elem ) {
+	var temp,
+		doc = elem.ownerDocument,
+		nodeName = elem.nodeName,
+		display = defaultDisplayMap[ nodeName ];
+
+	if ( display ) {
+		return display;
+	}
+
+	temp = doc.body.appendChild( doc.createElement( nodeName ) );
+	display = jQuery.css( temp, "display" );
+
+	temp.parentNode.removeChild( temp );
+
+	if ( display === "none" ) {
+		display = "block";
+	}
+	defaultDisplayMap[ nodeName ] = display;
+
+	return display;
+}
+
+function showHide( elements, show ) {
+	var display, elem,
+		values = [],
+		index = 0,
+		length = elements.length;
+
+	// Determine new display value for elements that need to change
+	for ( ; index < length; index++ ) {
+		elem = elements[ index ];
+		if ( !elem.style ) {
+			continue;
+		}
+
+		display = elem.style.display;
+		if ( show ) {
+
+			// Since we force visibility upon cascade-hidden elements, an immediate (and slow)
+			// check is required in this first loop unless we have a nonempty display value (either
+			// inline or about-to-be-restored)
+			if ( display === "none" ) {
+				values[ index ] = dataPriv.get( elem, "display" ) || null;
+				if ( !values[ index ] ) {
+					elem.style.display = "";
+				}
+			}
+			if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) {
+				values[ index ] = getDefaultDisplay( elem );
+			}
+		} else {
+			if ( display !== "none" ) {
+				values[ index ] = "none";
+
+				// Remember what we're overwriting
+				dataPriv.set( elem, "display", display );
+			}
+		}
+	}
+
+	// Set the display of the elements in a second loop to avoid constant reflow
+	for ( index = 0; index < length; index++ ) {
+		if ( values[ index ] != null ) {
+			elements[ index ].style.display = values[ index ];
+		}
+	}
+
+	return elements;
+}
+
+jQuery.fn.extend( {
+	show: function() {
+		return showHide( this, true );
+	},
+	hide: function() {
+		return showHide( this );
+	},
+	toggle: function( state ) {
+		if ( typeof state === "boolean" ) {
+			return state ? this.show() : this.hide();
+		}
+
+		return this.each( function() {
+			if ( isHiddenWithinTree( this ) ) {
+				jQuery( this ).show();
+			} else {
+				jQuery( this ).hide();
+			}
+		} );
+	}
+} );
+var rcheckableType = ( /^(?:checkbox|radio)$/i );
+
+var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i );
+
+var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i );
+
+
+
+( function() {
+	var fragment = document.createDocumentFragment(),
+		div = fragment.appendChild( document.createElement( "div" ) ),
+		input = document.createElement( "input" );
+
+	// Support: Android 4.0 - 4.3 only
+	// Check state lost if the name is set (#11217)
+	// Support: Windows Web Apps (WWA)
+	// `name` and `type` must use .setAttribute for WWA (#14901)
+	input.setAttribute( "type", "radio" );
+	input.setAttribute( "checked", "checked" );
+	input.setAttribute( "name", "t" );
+
+	div.appendChild( input );
+
+	// Support: Android <=4.1 only
+	// Older WebKit doesn't clone checked state correctly in fragments
+	support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked;
+
+	// Support: IE <=11 only
+	// Make sure textarea (and checkbox) defaultValue is properly cloned
+	div.innerHTML = "<textarea>x</textarea>";
+	support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue;
+
+	// Support: IE <=9 only
+	// IE <=9 replaces <option> tags with their contents when inserted outside of
+	// the select element.
+	div.innerHTML = "<option></option>";
+	support.option = !!div.lastChild;
+} )();
+
+
+// We have to close these tags to support XHTML (#13200)
+var wrapMap = {
+
+	// XHTML parsers do not magically insert elements in the
+	// same way that tag soup parsers do. So we cannot shorten
+	// this by omitting <tbody> or other required elements.
+	thead: [ 1, "<table>", "</table>" ],
+	col: [ 2, "<table><colgroup>", "</colgroup></table>" ],
+	tr: [ 2, "<table><tbody>", "</tbody></table>" ],
+	td: [ 3, "<table><tbody><tr>", "</tr></tbody></table>" ],
+
+	_default: [ 0, "", "" ]
+};
+
+wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead;
+wrapMap.th = wrapMap.td;
+
+// Support: IE <=9 only
+if ( !support.option ) {
+	wrapMap.optgroup = wrapMap.option = [ 1, "<select multiple='multiple'>", "</select>" ];
+}
+
+
+function getAll( context, tag ) {
+
+	// Support: IE <=9 - 11 only
+	// Use typeof to avoid zero-argument method invocation on host objects (#15151)
+	var ret;
+
+	if ( typeof context.getElementsByTagName !== "undefined" ) {
+		ret = context.getElementsByTagName( tag || "*" );
+
+	} else if ( typeof context.querySelectorAll !== "undefined" ) {
+		ret = context.querySelectorAll( tag || "*" );
+
+	} else {
+		ret = [];
+	}
+
+	if ( tag === undefined || tag && nodeName( context, tag ) ) {
+		return jQuery.merge( [ context ], ret );
+	}
+
+	return ret;
+}
+
+
+// Mark scripts as having already been evaluated
+function setGlobalEval( elems, refElements ) {
+	var i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		dataPriv.set(
+			elems[ i ],
+			"globalEval",
+			!refElements || dataPriv.get( refElements[ i ], "globalEval" )
+		);
+	}
+}
+
+
+var rhtml = /<|&#?\w+;/;
+
+function buildFragment( elems, context, scripts, selection, ignored ) {
+	var elem, tmp, tag, wrap, attached, j,
+		fragment = context.createDocumentFragment(),
+		nodes = [],
+		i = 0,
+		l = elems.length;
+
+	for ( ; i < l; i++ ) {
+		elem = elems[ i ];
+
+		if ( elem || elem === 0 ) {
+
+			// Add nodes directly
+			if ( toType( elem ) === "object" ) {
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem );
+
+			// Convert non-html into a text node
+			} else if ( !rhtml.test( elem ) ) {
+				nodes.push( context.createTextNode( elem ) );
+
+			// Convert html into DOM nodes
+			} else {
+				tmp = tmp || fragment.appendChild( context.createElement( "div" ) );
+
+				// Deserialize a standard representation
+				tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase();
+				wrap = wrapMap[ tag ] || wrapMap._default;
+				tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ];
+
+				// Descend through wrappers to the right content
+				j = wrap[ 0 ];
+				while ( j-- ) {
+					tmp = tmp.lastChild;
+				}
+
+				// Support: Android <=4.0 only, PhantomJS 1 only
+				// push.apply(_, arraylike) throws on ancient WebKit
+				jQuery.merge( nodes, tmp.childNodes );
+
+				// Remember the top-level container
+				tmp = fragment.firstChild;
+
+				// Ensure the created nodes are orphaned (#12392)
+				tmp.textContent = "";
+			}
+		}
+	}
+
+	// Remove wrapper from fragment
+	fragment.textContent = "";
+
+	i = 0;
+	while ( ( elem = nodes[ i++ ] ) ) {
+
+		// Skip elements already in the context collection (trac-4087)
+		if ( selection && jQuery.inArray( elem, selection ) > -1 ) {
+			if ( ignored ) {
+				ignored.push( elem );
+			}
+			continue;
+		}
+
+		attached = isAttached( elem );
+
+		// Append to fragment
+		tmp = getAll( fragment.appendChild( elem ), "script" );
+
+		// Preserve script evaluation history
+		if ( attached ) {
+			setGlobalEval( tmp );
+		}
+
+		// Capture executables
+		if ( scripts ) {
+			j = 0;
+			while ( ( elem = tmp[ j++ ] ) ) {
+				if ( rscriptType.test( elem.type || "" ) ) {
+					scripts.push( elem );
+				}
+			}
+		}
+	}
+
+	return fragment;
+}
+
+
+var rtypenamespace = /^([^.]*)(?:\.(.+)|)/;
+
+function returnTrue() {
+	return true;
+}
+
+function returnFalse() {
+	return false;
+}
+
+// Support: IE <=9 - 11+
+// focus() and blur() are asynchronous, except when they are no-op.
+// So expect focus to be synchronous when the element is already active,
+// and blur to be synchronous when the element is not already active.
+// (focus and blur are always synchronous in other supported browsers,
+// this just defines when we can count on it).
+function expectSync( elem, type ) {
+	return ( elem === safeActiveElement() ) === ( type === "focus" );
+}
+
+// Support: IE <=9 only
+// Accessing document.activeElement can throw unexpectedly
+// https://bugs.jquery.com/ticket/13393
+function safeActiveElement() {
+	try {
+		return document.activeElement;
+	} catch ( err ) { }
+}
+
+function on( elem, types, selector, data, fn, one ) {
+	var origFn, type;
+
+	// Types can be a map of types/handlers
+	if ( typeof types === "object" ) {
+
+		// ( types-Object, selector, data )
+		if ( typeof selector !== "string" ) {
+
+			// ( types-Object, data )
+			data = data || selector;
+			selector = undefined;
+		}
+		for ( type in types ) {
+			on( elem, type, selector, data, types[ type ], one );
+		}
+		return elem;
+	}
+
+	if ( data == null && fn == null ) {
+
+		// ( types, fn )
+		fn = selector;
+		data = selector = undefined;
+	} else if ( fn == null ) {
+		if ( typeof selector === "string" ) {
+
+			// ( types, selector, fn )
+			fn = data;
+			data = undefined;
+		} else {
+
+			// ( types, data, fn )
+			fn = data;
+			data = selector;
+			selector = undefined;
+		}
+	}
+	if ( fn === false ) {
+		fn = returnFalse;
+	} else if ( !fn ) {
+		return elem;
+	}
+
+	if ( one === 1 ) {
+		origFn = fn;
+		fn = function( event ) {
+
+			// Can use an empty set, since event contains the info
+			jQuery().off( event );
+			return origFn.apply( this, arguments );
+		};
+
+		// Use same guid so caller can remove using origFn
+		fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ );
+	}
+	return elem.each( function() {
+		jQuery.event.add( this, types, fn, data, selector );
+	} );
+}
+
+/*
+ * Helper functions for managing events -- not part of the public interface.
+ * Props to Dean Edwards' addEvent library for many of the ideas.
+ */
+jQuery.event = {
+
+	global: {},
+
+	add: function( elem, types, handler, data, selector ) {
+
+		var handleObjIn, eventHandle, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.get( elem );
+
+		// Only attach events to objects that accept data
+		if ( !acceptData( elem ) ) {
+			return;
+		}
+
+		// Caller can pass in an object of custom data in lieu of the handler
+		if ( handler.handler ) {
+			handleObjIn = handler;
+			handler = handleObjIn.handler;
+			selector = handleObjIn.selector;
+		}
+
+		// Ensure that invalid selectors throw exceptions at attach time
+		// Evaluate against documentElement in case elem is a non-element node (e.g., document)
+		if ( selector ) {
+			jQuery.find.matchesSelector( documentElement, selector );
+		}
+
+		// Make sure that the handler has a unique ID, used to find/remove it later
+		if ( !handler.guid ) {
+			handler.guid = jQuery.guid++;
+		}
+
+		// Init the element's event structure and main handler, if this is the first
+		if ( !( events = elemData.events ) ) {
+			events = elemData.events = Object.create( null );
+		}
+		if ( !( eventHandle = elemData.handle ) ) {
+			eventHandle = elemData.handle = function( e ) {
+
+				// Discard the second event of a jQuery.event.trigger() and
+				// when an event is called after a page has unloaded
+				return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ?
+					jQuery.event.dispatch.apply( elem, arguments ) : undefined;
+			};
+		}
+
+		// Handle multiple events separated by a space
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// There *must* be a type, no attaching namespace-only handlers
+			if ( !type ) {
+				continue;
+			}
+
+			// If event changes its type, use the special event handlers for the changed type
+			special = jQuery.event.special[ type ] || {};
+
+			// If selector defined, determine special event api type, otherwise given type
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+
+			// Update special based on newly reset type
+			special = jQuery.event.special[ type ] || {};
+
+			// handleObj is passed to all event handlers
+			handleObj = jQuery.extend( {
+				type: type,
+				origType: origType,
+				data: data,
+				handler: handler,
+				guid: handler.guid,
+				selector: selector,
+				needsContext: selector && jQuery.expr.match.needsContext.test( selector ),
+				namespace: namespaces.join( "." )
+			}, handleObjIn );
+
+			// Init the event handler queue if we're the first
+			if ( !( handlers = events[ type ] ) ) {
+				handlers = events[ type ] = [];
+				handlers.delegateCount = 0;
+
+				// Only use addEventListener if the special events handler returns false
+				if ( !special.setup ||
+					special.setup.call( elem, data, namespaces, eventHandle ) === false ) {
+
+					if ( elem.addEventListener ) {
+						elem.addEventListener( type, eventHandle );
+					}
+				}
+			}
+
+			if ( special.add ) {
+				special.add.call( elem, handleObj );
+
+				if ( !handleObj.handler.guid ) {
+					handleObj.handler.guid = handler.guid;
+				}
+			}
+
+			// Add to the element's handler list, delegates in front
+			if ( selector ) {
+				handlers.splice( handlers.delegateCount++, 0, handleObj );
+			} else {
+				handlers.push( handleObj );
+			}
+
+			// Keep track of which events have ever been used, for event optimization
+			jQuery.event.global[ type ] = true;
+		}
+
+	},
+
+	// Detach an event or set of events from an element
+	remove: function( elem, types, handler, selector, mappedTypes ) {
+
+		var j, origCount, tmp,
+			events, t, handleObj,
+			special, handlers, type, namespaces, origType,
+			elemData = dataPriv.hasData( elem ) && dataPriv.get( elem );
+
+		if ( !elemData || !( events = elemData.events ) ) {
+			return;
+		}
+
+		// Once for each type.namespace in types; type may be omitted
+		types = ( types || "" ).match( rnothtmlwhite ) || [ "" ];
+		t = types.length;
+		while ( t-- ) {
+			tmp = rtypenamespace.exec( types[ t ] ) || [];
+			type = origType = tmp[ 1 ];
+			namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort();
+
+			// Unbind all events (on this namespace, if provided) for the element
+			if ( !type ) {
+				for ( type in events ) {
+					jQuery.event.remove( elem, type + types[ t ], handler, selector, true );
+				}
+				continue;
+			}
+
+			special = jQuery.event.special[ type ] || {};
+			type = ( selector ? special.delegateType : special.bindType ) || type;
+			handlers = events[ type ] || [];
+			tmp = tmp[ 2 ] &&
+				new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" );
+
+			// Remove matching events
+			origCount = j = handlers.length;
+			while ( j-- ) {
+				handleObj = handlers[ j ];
+
+				if ( ( mappedTypes || origType === handleObj.origType ) &&
+					( !handler || handler.guid === handleObj.guid ) &&
+					( !tmp || tmp.test( handleObj.namespace ) ) &&
+					( !selector || selector === handleObj.selector ||
+						selector === "**" && handleObj.selector ) ) {
+					handlers.splice( j, 1 );
+
+					if ( handleObj.selector ) {
+						handlers.delegateCount--;
+					}
+					if ( special.remove ) {
+						special.remove.call( elem, handleObj );
+					}
+				}
+			}
+
+			// Remove generic event handler if we removed something and no more handlers exist
+			// (avoids potential for endless recursion during removal of special event handlers)
+			if ( origCount && !handlers.length ) {
+				if ( !special.teardown ||
+					special.teardown.call( elem, namespaces, elemData.handle ) === false ) {
+
+					jQuery.removeEvent( elem, type, elemData.handle );
+				}
+
+				delete events[ type ];
+			}
+		}
+
+		// Remove data and the expando if it's no longer used
+		if ( jQuery.isEmptyObject( events ) ) {
+			dataPriv.remove( elem, "handle events" );
+		}
+	},
+
+	dispatch: function( nativeEvent ) {
+
+		var i, j, ret, matched, handleObj, handlerQueue,
+			args = new Array( arguments.length ),
+
+			// Make a writable jQuery.Event from the native event object
+			event = jQuery.event.fix( nativeEvent ),
+
+			handlers = (
+				dataPriv.get( this, "events" ) || Object.create( null )
+			)[ event.type ] || [],
+			special = jQuery.event.special[ event.type ] || {};
+
+		// Use the fix-ed jQuery.Event rather than the (read-only) native event
+		args[ 0 ] = event;
+
+		for ( i = 1; i < arguments.length; i++ ) {
+			args[ i ] = arguments[ i ];
+		}
+
+		event.delegateTarget = this;
+
+		// Call the preDispatch hook for the mapped type, and let it bail if desired
+		if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) {
+			return;
+		}
+
+		// Determine handlers
+		handlerQueue = jQuery.event.handlers.call( this, event, handlers );
+
+		// Run delegates first; they may want to stop propagation beneath us
+		i = 0;
+		while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) {
+			event.currentTarget = matched.elem;
+
+			j = 0;
+			while ( ( handleObj = matched.handlers[ j++ ] ) &&
+				!event.isImmediatePropagationStopped() ) {
+
+				// If the event is namespaced, then each handler is only invoked if it is
+				// specially universal or its namespaces are a superset of the event's.
+				if ( !event.rnamespace || handleObj.namespace === false ||
+					event.rnamespace.test( handleObj.namespace ) ) {
+
+					event.handleObj = handleObj;
+					event.data = handleObj.data;
+
+					ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle ||
+						handleObj.handler ).apply( matched.elem, args );
+
+					if ( ret !== undefined ) {
+						if ( ( event.result = ret ) === false ) {
+							event.preventDefault();
+							event.stopPropagation();
+						}
+					}
+				}
+			}
+		}
+
+		// Call the postDispatch hook for the mapped type
+		if ( special.postDispatch ) {
+			special.postDispatch.call( this, event );
+		}
+
+		return event.result;
+	},
+
+	handlers: function( event, handlers ) {
+		var i, handleObj, sel, matchedHandlers, matchedSelectors,
+			handlerQueue = [],
+			delegateCount = handlers.delegateCount,
+			cur = event.target;
+
+		// Find delegate handlers
+		if ( delegateCount &&
+
+			// Support: IE <=9
+			// Black-hole SVG <use> instance trees (trac-13180)
+			cur.nodeType &&
+
+			// Support: Firefox <=42
+			// Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861)
+			// https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click
+			// Support: IE 11 only
+			// ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343)
+			!( event.type === "click" && event.button >= 1 ) ) {
+
+			for ( ; cur !== this; cur = cur.parentNode || this ) {
+
+				// Don't check non-elements (#13208)
+				// Don't process clicks on disabled elements (#6911, #8165, #11382, #11764)
+				if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) {
+					matchedHandlers = [];
+					matchedSelectors = {};
+					for ( i = 0; i < delegateCount; i++ ) {
+						handleObj = handlers[ i ];
+
+						// Don't conflict with Object.prototype properties (#13203)
+						sel = handleObj.selector + " ";
+
+						if ( matchedSelectors[ sel ] === undefined ) {
+							matchedSelectors[ sel ] = handleObj.needsContext ?
+								jQuery( sel, this ).index( cur ) > -1 :
+								jQuery.find( sel, this, null, [ cur ] ).length;
+						}
+						if ( matchedSelectors[ sel ] ) {
+							matchedHandlers.push( handleObj );
+						}
+					}
+					if ( matchedHandlers.length ) {
+						handlerQueue.push( { elem: cur, handlers: matchedHandlers } );
+					}
+				}
+			}
+		}
+
+		// Add the remaining (directly-bound) handlers
+		cur = this;
+		if ( delegateCount < handlers.length ) {
+			handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } );
+		}
+
+		return handlerQueue;
+	},
+
+	addProp: function( name, hook ) {
+		Object.defineProperty( jQuery.Event.prototype, name, {
+			enumerable: true,
+			configurable: true,
+
+			get: isFunction( hook ) ?
+				function() {
+					if ( this.originalEvent ) {
+						return hook( this.originalEvent );
+					}
+				} :
+				function() {
+					if ( this.originalEvent ) {
+						return this.originalEvent[ name ];
+					}
+				},
+
+			set: function( value ) {
+				Object.defineProperty( this, name, {
+					enumerable: true,
+					configurable: true,
+					writable: true,
+					value: value
+				} );
+			}
+		} );
+	},
+
+	fix: function( originalEvent ) {
+		return originalEvent[ jQuery.expando ] ?
+			originalEvent :
+			new jQuery.Event( originalEvent );
+	},
+
+	special: {
+		load: {
+
+			// Prevent triggered image.load events from bubbling to window.load
+			noBubble: true
+		},
+		click: {
+
+			// Utilize native event to ensure correct state for checkable inputs
+			setup: function( data ) {
+
+				// For mutual compressibility with _default, replace `this` access with a local var.
+				// `|| data` is dead code meant only to preserve the variable through minification.
+				var el = this || data;
+
+				// Claim the first handler
+				if ( rcheckableType.test( el.type ) &&
+					el.click && nodeName( el, "input" ) ) {
+
+					// dataPriv.set( el, "click", ... )
+					leverageNative( el, "click", returnTrue );
+				}
+
+				// Return false to allow normal processing in the caller
+				return false;
+			},
+			trigger: function( data ) {
+
+				// For mutual compressibility with _default, replace `this` access with a local var.
+				// `|| data` is dead code meant only to preserve the variable through minification.
+				var el = this || data;
+
+				// Force setup before triggering a click
+				if ( rcheckableType.test( el.type ) &&
+					el.click && nodeName( el, "input" ) ) {
+
+					leverageNative( el, "click" );
+				}
+
+				// Return non-false to allow normal event-path propagation
+				return true;
+			},
+
+			// For cross-browser consistency, suppress native .click() on links
+			// Also prevent it if we're currently inside a leveraged native-event stack
+			_default: function( event ) {
+				var target = event.target;
+				return rcheckableType.test( target.type ) &&
+					target.click && nodeName( target, "input" ) &&
+					dataPriv.get( target, "click" ) ||
+					nodeName( target, "a" );
+			}
+		},
+
+		beforeunload: {
+			postDispatch: function( event ) {
+
+				// Support: Firefox 20+
+				// Firefox doesn't alert if the returnValue field is not set.
+				if ( event.result !== undefined && event.originalEvent ) {
+					event.originalEvent.returnValue = event.result;
+				}
+			}
+		}
+	}
+};
+
+// Ensure the presence of an event listener that handles manually-triggered
+// synthetic events by interrupting progress until reinvoked in response to
+// *native* events that it fires directly, ensuring that state changes have
+// already occurred before other listeners are invoked.
+function leverageNative( el, type, expectSync ) {
+
+	// Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add
+	if ( !expectSync ) {
+		if ( dataPriv.get( el, type ) === undefined ) {
+			jQuery.event.add( el, type, returnTrue );
+		}
+		return;
+	}
+
+	// Register the controller as a special universal handler for all event namespaces
+	dataPriv.set( el, type, false );
+	jQuery.event.add( el, type, {
+		namespace: false,
+		handler: function( event ) {
+			var notAsync, result,
+				saved = dataPriv.get( this, type );
+
+			if ( ( event.isTrigger & 1 ) && this[ type ] ) {
+
+				// Interrupt processing of the outer synthetic .trigger()ed event
+				// Saved data should be false in such cases, but might be a leftover capture object
+				// from an async native handler (gh-4350)
+				if ( !saved.length ) {
+
+					// Store arguments for use when handling the inner native event
+					// There will always be at least one argument (an event object), so this array
+					// will not be confused with a leftover capture object.
+					saved = slice.call( arguments );
+					dataPriv.set( this, type, saved );
+
+					// Trigger the native event and capture its result
+					// Support: IE <=9 - 11+
+					// focus() and blur() are asynchronous
+					notAsync = expectSync( this, type );
+					this[ type ]();
+					result = dataPriv.get( this, type );
+					if ( saved !== result || notAsync ) {
+						dataPriv.set( this, type, false );
+					} else {
+						result = {};
+					}
+					if ( saved !== result ) {
+
+						// Cancel the outer synthetic event
+						event.stopImmediatePropagation();
+						event.preventDefault();
+
+						// Support: Chrome 86+
+						// In Chrome, if an element having a focusout handler is blurred by
+						// clicking outside of it, it invokes the handler synchronously. If
+						// that handler calls `.remove()` on the element, the data is cleared,
+						// leaving `result` undefined. We need to guard against this.
+						return result && result.value;
+					}
+
+				// If this is an inner synthetic event for an event with a bubbling surrogate
+				// (focus or blur), assume that the surrogate already propagated from triggering the
+				// native event and prevent that from happening again here.
+				// This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the
+				// bubbling surrogate propagates *after* the non-bubbling base), but that seems
+				// less bad than duplication.
+				} else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) {
+					event.stopPropagation();
+				}
+
+			// If this is a native event triggered above, everything is now in order
+			// Fire an inner synthetic event with the original arguments
+			} else if ( saved.length ) {
+
+				// ...and capture the result
+				dataPriv.set( this, type, {
+					value: jQuery.event.trigger(
+
+						// Support: IE <=9 - 11+
+						// Extend with the prototype to reset the above stopImmediatePropagation()
+						jQuery.extend( saved[ 0 ], jQuery.Event.prototype ),
+						saved.slice( 1 ),
+						this
+					)
+				} );
+
+				// Abort handling of the native event
+				event.stopImmediatePropagation();
+			}
+		}
+	} );
+}
+
+jQuery.removeEvent = function( elem, type, handle ) {
+
+	// This "if" is needed for plain objects
+	if ( elem.removeEventListener ) {
+		elem.removeEventListener( type, handle );
+	}
+};
+
+jQuery.Event = function( src, props ) {
+
+	// Allow instantiation without the 'new' keyword
+	if ( !( this instanceof jQuery.Event ) ) {
+		return new jQuery.Event( src, props );
+	}
+
+	// Event object
+	if ( src && src.type ) {
+		this.originalEvent = src;
+		this.type = src.type;
+
+		// Events bubbling up the document may have been marked as prevented
+		// by a handler lower down the tree; reflect the correct value.
+		this.isDefaultPrevented = src.defaultPrevented ||
+				src.defaultPrevented === undefined &&
+
+				// Support: Android <=2.3 only
+				src.returnValue === false ?
+			returnTrue :
+			returnFalse;
+
+		// Create target properties
+		// Support: Safari <=6 - 7 only
+		// Target should not be a text node (#504, #13143)
+		this.target = ( src.target && src.target.nodeType === 3 ) ?
+			src.target.parentNode :
+			src.target;
+
+		this.currentTarget = src.currentTarget;
+		this.relatedTarget = src.relatedTarget;
+
+	// Event type
+	} else {
+		this.type = src;
+	}
+
+	// Put explicitly provided properties onto the event object
+	if ( props ) {
+		jQuery.extend( this, props );
+	}
+
+	// Create a timestamp if incoming event doesn't have one
+	this.timeStamp = src && src.timeStamp || Date.now();
+
+	// Mark it as fixed
+	this[ jQuery.expando ] = true;
+};
+
+// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding
+// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html
+jQuery.Event.prototype = {
+	constructor: jQuery.Event,
+	isDefaultPrevented: returnFalse,
+	isPropagationStopped: returnFalse,
+	isImmediatePropagationStopped: returnFalse,
+	isSimulated: false,
+
+	preventDefault: function() {
+		var e = this.originalEvent;
+
+		this.isDefaultPrevented = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.preventDefault();
+		}
+	},
+	stopPropagation: function() {
+		var e = this.originalEvent;
+
+		this.isPropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopPropagation();
+		}
+	},
+	stopImmediatePropagation: function() {
+		var e = this.originalEvent;
+
+		this.isImmediatePropagationStopped = returnTrue;
+
+		if ( e && !this.isSimulated ) {
+			e.stopImmediatePropagation();
+		}
+
+		this.stopPropagation();
+	}
+};
+
+// Includes all common event props including KeyEvent and MouseEvent specific props
+jQuery.each( {
+	altKey: true,
+	bubbles: true,
+	cancelable: true,
+	changedTouches: true,
+	ctrlKey: true,
+	detail: true,
+	eventPhase: true,
+	metaKey: true,
+	pageX: true,
+	pageY: true,
+	shiftKey: true,
+	view: true,
+	"char": true,
+	code: true,
+	charCode: true,
+	key: true,
+	keyCode: true,
+	button: true,
+	buttons: true,
+	clientX: true,
+	clientY: true,
+	offsetX: true,
+	offsetY: true,
+	pointerId: true,
+	pointerType: true,
+	screenX: true,
+	screenY: true,
+	targetTouches: true,
+	toElement: true,
+	touches: true,
+	which: true
+}, jQuery.event.addProp );
+
+jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) {
+	jQuery.event.special[ type ] = {
+
+		// Utilize native event if possible so blur/focus sequence is correct
+		setup: function() {
+
+			// Claim the first handler
+			// dataPriv.set( this, "focus", ... )
+			// dataPriv.set( this, "blur", ... )
+			leverageNative( this, type, expectSync );
+
+			// Return false to allow normal processing in the caller
+			return false;
+		},
+		trigger: function() {
+
+			// Force setup before trigger
+			leverageNative( this, type );
+
+			// Return non-false to allow normal event-path propagation
+			return true;
+		},
+
+		// Suppress native focus or blur as it's already being fired
+		// in leverageNative.
+		_default: function() {
+			return true;
+		},
+
+		delegateType: delegateType
+	};
+} );
+
+// Create mouseenter/leave events using mouseover/out and event-time checks
+// so that event delegation works in jQuery.
+// Do the same for pointerenter/pointerleave and pointerover/pointerout
+//
+// Support: Safari 7 only
+// Safari sends mouseenter too often; see:
+// https://bugs.chromium.org/p/chromium/issues/detail?id=470258
+// for the description of the bug (it existed in older Chrome versions as well).
+jQuery.each( {
+	mouseenter: "mouseover",
+	mouseleave: "mouseout",
+	pointerenter: "pointerover",
+	pointerleave: "pointerout"
+}, function( orig, fix ) {
+	jQuery.event.special[ orig ] = {
+		delegateType: fix,
+		bindType: fix,
+
+		handle: function( event ) {
+			var ret,
+				target = this,
+				related = event.relatedTarget,
+				handleObj = event.handleObj;
+
+			// For mouseenter/leave call the handler if related is outside the target.
+			// NB: No relatedTarget if the mouse left/entered the browser window
+			if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) {
+				event.type = handleObj.origType;
+				ret = handleObj.handler.apply( this, arguments );
+				event.type = fix;
+			}
+			return ret;
+		}
+	};
+} );
+
+jQuery.fn.extend( {
+
+	on: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn );
+	},
+	one: function( types, selector, data, fn ) {
+		return on( this, types, selector, data, fn, 1 );
+	},
+	off: function( types, selector, fn ) {
+		var handleObj, type;
+		if ( types && types.preventDefault && types.handleObj ) {
+
+			// ( event )  dispatched jQuery.Event
+			handleObj = types.handleObj;
+			jQuery( types.delegateTarget ).off(
+				handleObj.namespace ?
+					handleObj.origType + "." + handleObj.namespace :
+					handleObj.origType,
+				handleObj.selector,
+				handleObj.handler
+			);
+			return this;
+		}
+		if ( typeof types === "object" ) {
+
+			// ( types-object [, selector] )
+			for ( type in types ) {
+				this.off( type, selector, types[ type ] );
+			}
+			return this;
+		}
+		if ( selector === false || typeof selector === "function" ) {
+
+			// ( types [, fn] )
+			fn = selector;
+			selector = undefined;
+		}
+		if ( fn === false ) {
+			fn = returnFalse;
+		}
+		return this.each( function() {
+			jQuery.event.remove( this, types, fn, selector );
+		} );
+	}
+} );
+
+
+var
+
+	// Support: IE <=10 - 11, Edge 12 - 13 only
+	// In IE/Edge using regex groups here causes severe slowdowns.
+	// See https://connect.microsoft.com/IE/feedback/details/1736512/
+	rnoInnerhtml = /<script|<style|<link/i,
+
+	// checked="checked" or checked
+	rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i,
+	rcleanScript = /^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;
+
+// Prefer a tbody over its parent table for containing new rows
+function manipulationTarget( elem, content ) {
+	if ( nodeName( elem, "table" ) &&
+		nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) {
+
+		return jQuery( elem ).children( "tbody" )[ 0 ] || elem;
+	}
+
+	return elem;
+}
+
+// Replace/restore the type attribute of script elements for safe DOM manipulation
+function disableScript( elem ) {
+	elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type;
+	return elem;
+}
+function restoreScript( elem ) {
+	if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) {
+		elem.type = elem.type.slice( 5 );
+	} else {
+		elem.removeAttribute( "type" );
+	}
+
+	return elem;
+}
+
+function cloneCopyEvent( src, dest ) {
+	var i, l, type, pdataOld, udataOld, udataCur, events;
+
+	if ( dest.nodeType !== 1 ) {
+		return;
+	}
+
+	// 1. Copy private data: events, handlers, etc.
+	if ( dataPriv.hasData( src ) ) {
+		pdataOld = dataPriv.get( src );
+		events = pdataOld.events;
+
+		if ( events ) {
+			dataPriv.remove( dest, "handle events" );
+
+			for ( type in events ) {
+				for ( i = 0, l = events[ type ].length; i < l; i++ ) {
+					jQuery.event.add( dest, type, events[ type ][ i ] );
+				}
+			}
+		}
+	}
+
+	// 2. Copy user data
+	if ( dataUser.hasData( src ) ) {
+		udataOld = dataUser.access( src );
+		udataCur = jQuery.extend( {}, udataOld );
+
+		dataUser.set( dest, udataCur );
+	}
+}
+
+// Fix IE bugs, see support tests
+function fixInput( src, dest ) {
+	var nodeName = dest.nodeName.toLowerCase();
+
+	// Fails to persist the checked state of a cloned checkbox or radio button.
+	if ( nodeName === "input" && rcheckableType.test( src.type ) ) {
+		dest.checked = src.checked;
+
+	// Fails to return the selected option to the default selected state when cloning options
+	} else if ( nodeName === "input" || nodeName === "textarea" ) {
+		dest.defaultValue = src.defaultValue;
+	}
+}
+
+function domManip( collection, args, callback, ignored ) {
+
+	// Flatten any nested arrays
+	args = flat( args );
+
+	var fragment, first, scripts, hasScripts, node, doc,
+		i = 0,
+		l = collection.length,
+		iNoClone = l - 1,
+		value = args[ 0 ],
+		valueIsFunction = isFunction( value );
+
+	// We can't cloneNode fragments that contain checked, in WebKit
+	if ( valueIsFunction ||
+			( l > 1 && typeof value === "string" &&
+				!support.checkClone && rchecked.test( value ) ) ) {
+		return collection.each( function( index ) {
+			var self = collection.eq( index );
+			if ( valueIsFunction ) {
+				args[ 0 ] = value.call( this, index, self.html() );
+			}
+			domManip( self, args, callback, ignored );
+		} );
+	}
+
+	if ( l ) {
+		fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored );
+		first = fragment.firstChild;
+
+		if ( fragment.childNodes.length === 1 ) {
+			fragment = first;
+		}
+
+		// Require either new content or an interest in ignored elements to invoke the callback
+		if ( first || ignored ) {
+			scripts = jQuery.map( getAll( fragment, "script" ), disableScript );
+			hasScripts = scripts.length;
+
+			// Use the original fragment for the last item
+			// instead of the first because it can end up
+			// being emptied incorrectly in certain situations (#8070).
+			for ( ; i < l; i++ ) {
+				node = fragment;
+
+				if ( i !== iNoClone ) {
+					node = jQuery.clone( node, true, true );
+
+					// Keep references to cloned scripts for later restoration
+					if ( hasScripts ) {
+
+						// Support: Android <=4.0 only, PhantomJS 1 only
+						// push.apply(_, arraylike) throws on ancient WebKit
+						jQuery.merge( scripts, getAll( node, "script" ) );
+					}
+				}
+
+				callback.call( collection[ i ], node, i );
+			}
+
+			if ( hasScripts ) {
+				doc = scripts[ scripts.length - 1 ].ownerDocument;
+
+				// Reenable scripts
+				jQuery.map( scripts, restoreScript );
+
+				// Evaluate executable scripts on first document insertion
+				for ( i = 0; i < hasScripts; i++ ) {
+					node = scripts[ i ];
+					if ( rscriptType.test( node.type || "" ) &&
+						!dataPriv.access( node, "globalEval" ) &&
+						jQuery.contains( doc, node ) ) {
+
+						if ( node.src && ( node.type || "" ).toLowerCase()  !== "module" ) {
+
+							// Optional AJAX dependency, but won't run scripts if not present
+							if ( jQuery._evalUrl && !node.noModule ) {
+								jQuery._evalUrl( node.src, {
+									nonce: node.nonce || node.getAttribute( "nonce" )
+								}, doc );
+							}
+						} else {
+							DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc );
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return collection;
+}
+
+function remove( elem, selector, keepData ) {
+	var node,
+		nodes = selector ? jQuery.filter( selector, elem ) : elem,
+		i = 0;
+
+	for ( ; ( node = nodes[ i ] ) != null; i++ ) {
+		if ( !keepData && node.nodeType === 1 ) {
+			jQuery.cleanData( getAll( node ) );
+		}
+
+		if ( node.parentNode ) {
+			if ( keepData && isAttached( node ) ) {
+				setGlobalEval( getAll( node, "script" ) );
+			}
+			node.parentNode.removeChild( node );
+		}
+	}
+
+	return elem;
+}
+
+jQuery.extend( {
+	htmlPrefilter: function( html ) {
+		return html;
+	},
+
+	clone: function( elem, dataAndEvents, deepDataAndEvents ) {
+		var i, l, srcElements, destElements,
+			clone = elem.cloneNode( true ),
+			inPage = isAttached( elem );
+
+		// Fix IE cloning issues
+		if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) &&
+				!jQuery.isXMLDoc( elem ) ) {
+
+			// We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2
+			destElements = getAll( clone );
+			srcElements = getAll( elem );
+
+			for ( i = 0, l = srcElements.length; i < l; i++ ) {
+				fixInput( srcElements[ i ], destElements[ i ] );
+			}
+		}
+
+		// Copy the events from the original to the clone
+		if ( dataAndEvents ) {
+			if ( deepDataAndEvents ) {
+				srcElements = srcElements || getAll( elem );
+				destElements = destElements || getAll( clone );
+
+				for ( i = 0, l = srcElements.length; i < l; i++ ) {
+					cloneCopyEvent( srcElements[ i ], destElements[ i ] );
+				}
+			} else {
+				cloneCopyEvent( elem, clone );
+			}
+		}
+
+		// Preserve script evaluation history
+		destElements = getAll( clone, "script" );
+		if ( destElements.length > 0 ) {
+			setGlobalEval( destElements, !inPage && getAll( elem, "script" ) );
+		}
+
+		// Return the cloned set
+		return clone;
+	},
+
+	cleanData: function( elems ) {
+		var data, elem, type,
+			special = jQuery.event.special,
+			i = 0;
+
+		for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) {
+			if ( acceptData( elem ) ) {
+				if ( ( data = elem[ dataPriv.expando ] ) ) {
+					if ( data.events ) {
+						for ( type in data.events ) {
+							if ( special[ type ] ) {
+								jQuery.event.remove( elem, type );
+
+							// This is a shortcut to avoid jQuery.event.remove's overhead
+							} else {
+								jQuery.removeEvent( elem, type, data.handle );
+							}
+						}
+					}
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataPriv.expando ] = undefined;
+				}
+				if ( elem[ dataUser.expando ] ) {
+
+					// Support: Chrome <=35 - 45+
+					// Assign undefined instead of using delete, see Data#remove
+					elem[ dataUser.expando ] = undefined;
+				}
+			}
+		}
+	}
+} );
+
+jQuery.fn.extend( {
+	detach: function( selector ) {
+		return remove( this, selector, true );
+	},
+
+	remove: function( selector ) {
+		return remove( this, selector );
+	},
+
+	text: function( value ) {
+		return access( this, function( value ) {
+			return value === undefined ?
+				jQuery.text( this ) :
+				this.empty().each( function() {
+					if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+						this.textContent = value;
+					}
+				} );
+		}, null, value, arguments.length );
+	},
+
+	append: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.appendChild( elem );
+			}
+		} );
+	},
+
+	prepend: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) {
+				var target = manipulationTarget( this, elem );
+				target.insertBefore( elem, target.firstChild );
+			}
+		} );
+	},
+
+	before: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this );
+			}
+		} );
+	},
+
+	after: function() {
+		return domManip( this, arguments, function( elem ) {
+			if ( this.parentNode ) {
+				this.parentNode.insertBefore( elem, this.nextSibling );
+			}
+		} );
+	},
+
+	empty: function() {
+		var elem,
+			i = 0;
+
+		for ( ; ( elem = this[ i ] ) != null; i++ ) {
+			if ( elem.nodeType === 1 ) {
+
+				// Prevent memory leaks
+				jQuery.cleanData( getAll( elem, false ) );
+
+				// Remove any remaining nodes
+				elem.textContent = "";
+			}
+		}
+
+		return this;
+	},
+
+	clone: function( dataAndEvents, deepDataAndEvents ) {
+		dataAndEvents = dataAndEvents == null ? false : dataAndEvents;
+		deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents;
+
+		return this.map( function() {
+			return jQuery.clone( this, dataAndEvents, deepDataAndEvents );
+		} );
+	},
+
+	html: function( value ) {
+		return access( this, function( value ) {
+			var elem = this[ 0 ] || {},
+				i = 0,
+				l = this.length;
+
+			if ( value === undefined && elem.nodeType === 1 ) {
+				return elem.innerHTML;
+			}
+
+			// See if we can take a shortcut and just use innerHTML
+			if ( typeof value === "string" && !rnoInnerhtml.test( value ) &&
+				!wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) {
+
+				value = jQuery.htmlPrefilter( value );
+
+				try {
+					for ( ; i < l; i++ ) {
+						elem = this[ i ] || {};
+
+						// Remove element nodes and prevent memory leaks
+						if ( elem.nodeType === 1 ) {
+							jQuery.cleanData( getAll( elem, false ) );
+							elem.innerHTML = value;
+						}
+					}
+
+					elem = 0;
+
+				// If using innerHTML throws an exception, use the fallback method
+				} catch ( e ) {}
+			}
+
+			if ( elem ) {
+				this.empty().append( value );
+			}
+		}, null, value, arguments.length );
+	},
+
+	replaceWith: function() {
+		var ignored = [];
+
+		// Make the changes, replacing each non-ignored context element with the new content
+		return domManip( this, arguments, function( elem ) {
+			var parent = this.parentNode;
+
+			if ( jQuery.inArray( this, ignored ) < 0 ) {
+				jQuery.cleanData( getAll( this ) );
+				if ( parent ) {
+					parent.replaceChild( elem, this );
+				}
+			}
+
+		// Force callback invocation
+		}, ignored );
+	}
+} );
+
+jQuery.each( {
+	appendTo: "append",
+	prependTo: "prepend",
+	insertBefore: "before",
+	insertAfter: "after",
+	replaceAll: "replaceWith"
+}, function( name, original ) {
+	jQuery.fn[ name ] = function( selector ) {
+		var elems,
+			ret = [],
+			insert = jQuery( selector ),
+			last = insert.length - 1,
+			i = 0;
+
+		for ( ; i <= last; i++ ) {
+			elems = i === last ? this : this.clone( true );
+			jQuery( insert[ i ] )[ original ]( elems );
+
+			// Support: Android <=4.0 only, PhantomJS 1 only
+			// .get() because push.apply(_, arraylike) throws on ancient WebKit
+			push.apply( ret, elems.get() );
+		}
+
+		return this.pushStack( ret );
+	};
+} );
+var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" );
+
+var getStyles = function( elem ) {
+
+		// Support: IE <=11 only, Firefox <=30 (#15098, #14150)
+		// IE throws on elements created in popups
+		// FF meanwhile throws on frame elements through "defaultView.getComputedStyle"
+		var view = elem.ownerDocument.defaultView;
+
+		if ( !view || !view.opener ) {
+			view = window;
+		}
+
+		return view.getComputedStyle( elem );
+	};
+
+var swap = function( elem, options, callback ) {
+	var ret, name,
+		old = {};
+
+	// Remember the old values, and insert the new ones
+	for ( name in options ) {
+		old[ name ] = elem.style[ name ];
+		elem.style[ name ] = options[ name ];
+	}
+
+	ret = callback.call( elem );
+
+	// Revert the old values
+	for ( name in options ) {
+		elem.style[ name ] = old[ name ];
+	}
+
+	return ret;
+};
+
+
+var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" );
+
+
+
+( function() {
+
+	// Executing both pixelPosition & boxSizingReliable tests require only one layout
+	// so they're executed at the same time to save the second computation.
+	function computeStyleTests() {
+
+		// This is a singleton, we need to execute it only once
+		if ( !div ) {
+			return;
+		}
+
+		container.style.cssText = "position:absolute;left:-11111px;width:60px;" +
+			"margin-top:1px;padding:0;border:0";
+		div.style.cssText =
+			"position:relative;display:block;box-sizing:border-box;overflow:scroll;" +
+			"margin:auto;border:1px;padding:1px;" +
+			"width:60%;top:1%";
+		documentElement.appendChild( container ).appendChild( div );
+
+		var divStyle = window.getComputedStyle( div );
+		pixelPositionVal = divStyle.top !== "1%";
+
+		// Support: Android 4.0 - 4.3 only, Firefox <=3 - 44
+		reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12;
+
+		// Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3
+		// Some styles come back with percentage values, even though they shouldn't
+		div.style.right = "60%";
+		pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36;
+
+		// Support: IE 9 - 11 only
+		// Detect misreporting of content dimensions for box-sizing:border-box elements
+		boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36;
+
+		// Support: IE 9 only
+		// Detect overflow:scroll screwiness (gh-3699)
+		// Support: Chrome <=64
+		// Don't get tricked when zoom affects offsetWidth (gh-4029)
+		div.style.position = "absolute";
+		scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12;
+
+		documentElement.removeChild( container );
+
+		// Nullify the div so it wouldn't be stored in the memory and
+		// it will also be a sign that checks already performed
+		div = null;
+	}
+
+	function roundPixelMeasures( measure ) {
+		return Math.round( parseFloat( measure ) );
+	}
+
+	var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal,
+		reliableTrDimensionsVal, reliableMarginLeftVal,
+		container = document.createElement( "div" ),
+		div = document.createElement( "div" );
+
+	// Finish early in limited (non-browser) environments
+	if ( !div.style ) {
+		return;
+	}
+
+	// Support: IE <=9 - 11 only
+	// Style of cloned element affects source element cloned (#8908)
+	div.style.backgroundClip = "content-box";
+	div.cloneNode( true ).style.backgroundClip = "";
+	support.clearCloneStyle = div.style.backgroundClip === "content-box";
+
+	jQuery.extend( support, {
+		boxSizingReliable: function() {
+			computeStyleTests();
+			return boxSizingReliableVal;
+		},
+		pixelBoxStyles: function() {
+			computeStyleTests();
+			return pixelBoxStylesVal;
+		},
+		pixelPosition: function() {
+			computeStyleTests();
+			return pixelPositionVal;
+		},
+		reliableMarginLeft: function() {
+			computeStyleTests();
+			return reliableMarginLeftVal;
+		},
+		scrollboxSize: function() {
+			computeStyleTests();
+			return scrollboxSizeVal;
+		},
+
+		// Support: IE 9 - 11+, Edge 15 - 18+
+		// IE/Edge misreport `getComputedStyle` of table rows with width/height
+		// set in CSS while `offset*` properties report correct values.
+		// Behavior in IE 9 is more subtle than in newer versions & it passes
+		// some versions of this test; make sure not to make it pass there!
+		//
+		// Support: Firefox 70+
+		// Only Firefox includes border widths
+		// in computed dimensions. (gh-4529)
+		reliableTrDimensions: function() {
+			var table, tr, trChild, trStyle;
+			if ( reliableTrDimensionsVal == null ) {
+				table = document.createElement( "table" );
+				tr = document.createElement( "tr" );
+				trChild = document.createElement( "div" );
+
+				table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate";
+				tr.style.cssText = "border:1px solid";
+
+				// Support: Chrome 86+
+				// Height set through cssText does not get applied.
+				// Computed height then comes back as 0.
+				tr.style.height = "1px";
+				trChild.style.height = "9px";
+
+				// Support: Android 8 Chrome 86+
+				// In our bodyBackground.html iframe,
+				// display for all div elements is set to "inline",
+				// which causes a problem only in Android 8 Chrome 86.
+				// Ensuring the div is display: block
+				// gets around this issue.
+				trChild.style.display = "block";
+
+				documentElement
+					.appendChild( table )
+					.appendChild( tr )
+					.appendChild( trChild );
+
+				trStyle = window.getComputedStyle( tr );
+				reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) +
+					parseInt( trStyle.borderTopWidth, 10 ) +
+					parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight;
+
+				documentElement.removeChild( table );
+			}
+			return reliableTrDimensionsVal;
+		}
+	} );
+} )();
+
+
+function curCSS( elem, name, computed ) {
+	var width, minWidth, maxWidth, ret,
+
+		// Support: Firefox 51+
+		// Retrieving style before computed somehow
+		// fixes an issue with getting wrong values
+		// on detached elements
+		style = elem.style;
+
+	computed = computed || getStyles( elem );
+
+	// getPropertyValue is needed for:
+	//   .css('filter') (IE 9 only, #12537)
+	//   .css('--customProperty) (#3144)
+	if ( computed ) {
+		ret = computed.getPropertyValue( name ) || computed[ name ];
+
+		if ( ret === "" && !isAttached( elem ) ) {
+			ret = jQuery.style( elem, name );
+		}
+
+		// A tribute to the "awesome hack by Dean Edwards"
+		// Android Browser returns percentage for some values,
+		// but width seems to be reliably pixels.
+		// This is against the CSSOM draft spec:
+		// https://drafts.csswg.org/cssom/#resolved-values
+		if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) {
+
+			// Remember the original values
+			width = style.width;
+			minWidth = style.minWidth;
+			maxWidth = style.maxWidth;
+
+			// Put in the new values to get a computed value out
+			style.minWidth = style.maxWidth = style.width = ret;
+			ret = computed.width;
+
+			// Revert the changed values
+			style.width = width;
+			style.minWidth = minWidth;
+			style.maxWidth = maxWidth;
+		}
+	}
+
+	return ret !== undefined ?
+
+		// Support: IE <=9 - 11 only
+		// IE returns zIndex value as an integer.
+		ret + "" :
+		ret;
+}
+
+
+function addGetHookIf( conditionFn, hookFn ) {
+
+	// Define the hook, we'll check on the first run if it's really needed.
+	return {
+		get: function() {
+			if ( conditionFn() ) {
+
+				// Hook not needed (or it's not possible to use it due
+				// to missing dependency), remove it.
+				delete this.get;
+				return;
+			}
+
+			// Hook needed; redefine it so that the support test is not executed again.
+			return ( this.get = hookFn ).apply( this, arguments );
+		}
+	};
+}
+
+
+var cssPrefixes = [ "Webkit", "Moz", "ms" ],
+	emptyStyle = document.createElement( "div" ).style,
+	vendorProps = {};
+
+// Return a vendor-prefixed property or undefined
+function vendorPropName( name ) {
+
+	// Check for vendor prefixed names
+	var capName = name[ 0 ].toUpperCase() + name.slice( 1 ),
+		i = cssPrefixes.length;
+
+	while ( i-- ) {
+		name = cssPrefixes[ i ] + capName;
+		if ( name in emptyStyle ) {
+			return name;
+		}
+	}
+}
+
+// Return a potentially-mapped jQuery.cssProps or vendor prefixed property
+function finalPropName( name ) {
+	var final = jQuery.cssProps[ name ] || vendorProps[ name ];
+
+	if ( final ) {
+		return final;
+	}
+	if ( name in emptyStyle ) {
+		return name;
+	}
+	return vendorProps[ name ] = vendorPropName( name ) || name;
+}
+
+
+var
+
+	// Swappable if display is none or starts with table
+	// except "table", "table-cell", or "table-caption"
+	// See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display
+	rdisplayswap = /^(none|table(?!-c[ea]).+)/,
+	rcustomProp = /^--/,
+	cssShow = { position: "absolute", visibility: "hidden", display: "block" },
+	cssNormalTransform = {
+		letterSpacing: "0",
+		fontWeight: "400"
+	};
+
+function setPositiveNumber( _elem, value, subtract ) {
+
+	// Any relative (+/-) values have already been
+	// normalized at this point
+	var matches = rcssNum.exec( value );
+	return matches ?
+
+		// Guard against undefined "subtract", e.g., when used as in cssHooks
+		Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) :
+		value;
+}
+
+function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) {
+	var i = dimension === "width" ? 1 : 0,
+		extra = 0,
+		delta = 0;
+
+	// Adjustment may not be necessary
+	if ( box === ( isBorderBox ? "border" : "content" ) ) {
+		return 0;
+	}
+
+	for ( ; i < 4; i += 2 ) {
+
+		// Both box models exclude margin
+		if ( box === "margin" ) {
+			delta += jQuery.css( elem, box + cssExpand[ i ], true, styles );
+		}
+
+		// If we get here with a content-box, we're seeking "padding" or "border" or "margin"
+		if ( !isBorderBox ) {
+
+			// Add padding
+			delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+
+			// For "border" or "margin", add border
+			if ( box !== "padding" ) {
+				delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+
+			// But still keep track of it otherwise
+			} else {
+				extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+
+		// If we get here with a border-box (content + padding + border), we're seeking "content" or
+		// "padding" or "margin"
+		} else {
+
+			// For "content", subtract padding
+			if ( box === "content" ) {
+				delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles );
+			}
+
+			// For "content" or "padding", subtract border
+			if ( box !== "margin" ) {
+				delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles );
+			}
+		}
+	}
+
+	// Account for positive content-box scroll gutter when requested by providing computedVal
+	if ( !isBorderBox && computedVal >= 0 ) {
+
+		// offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border
+		// Assuming integer scroll gutter, subtract the rest and round down
+		delta += Math.max( 0, Math.ceil(
+			elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+			computedVal -
+			delta -
+			extra -
+			0.5
+
+		// If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter
+		// Use an explicit zero to avoid NaN (gh-3964)
+		) ) || 0;
+	}
+
+	return delta;
+}
+
+function getWidthOrHeight( elem, dimension, extra ) {
+
+	// Start with computed style
+	var styles = getStyles( elem ),
+
+		// To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322).
+		// Fake content-box until we know it's needed to know the true value.
+		boxSizingNeeded = !support.boxSizingReliable() || extra,
+		isBorderBox = boxSizingNeeded &&
+			jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+		valueIsBorderBox = isBorderBox,
+
+		val = curCSS( elem, dimension, styles ),
+		offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 );
+
+	// Support: Firefox <=54
+	// Return a confounding non-pixel value or feign ignorance, as appropriate.
+	if ( rnumnonpx.test( val ) ) {
+		if ( !extra ) {
+			return val;
+		}
+		val = "auto";
+	}
+
+
+	// Support: IE 9 - 11 only
+	// Use offsetWidth/offsetHeight for when box sizing is unreliable.
+	// In those cases, the computed value can be trusted to be border-box.
+	if ( ( !support.boxSizingReliable() && isBorderBox ||
+
+		// Support: IE 10 - 11+, Edge 15 - 18+
+		// IE/Edge misreport `getComputedStyle` of table rows with width/height
+		// set in CSS while `offset*` properties report correct values.
+		// Interestingly, in some cases IE 9 doesn't suffer from this issue.
+		!support.reliableTrDimensions() && nodeName( elem, "tr" ) ||
+
+		// Fall back to offsetWidth/offsetHeight when value is "auto"
+		// This happens for inline elements with no explicit setting (gh-3571)
+		val === "auto" ||
+
+		// Support: Android <=4.1 - 4.3 only
+		// Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602)
+		!parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) &&
+
+		// Make sure the element is visible & connected
+		elem.getClientRects().length ) {
+
+		isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box";
+
+		// Where available, offsetWidth/offsetHeight approximate border box dimensions.
+		// Where not available (e.g., SVG), assume unreliable box-sizing and interpret the
+		// retrieved value as a content box dimension.
+		valueIsBorderBox = offsetProp in elem;
+		if ( valueIsBorderBox ) {
+			val = elem[ offsetProp ];
+		}
+	}
+
+	// Normalize "" and auto
+	val = parseFloat( val ) || 0;
+
+	// Adjust for the element's box model
+	return ( val +
+		boxModelAdjustment(
+			elem,
+			dimension,
+			extra || ( isBorderBox ? "border" : "content" ),
+			valueIsBorderBox,
+			styles,
+
+			// Provide the current computed size to request scroll gutter calculation (gh-3589)
+			val
+		)
+	) + "px";
+}
+
+jQuery.extend( {
+
+	// Add in style property hooks for overriding the default
+	// behavior of getting and setting a style property
+	cssHooks: {
+		opacity: {
+			get: function( elem, computed ) {
+				if ( computed ) {
+
+					// We should always get a number back from opacity
+					var ret = curCSS( elem, "opacity" );
+					return ret === "" ? "1" : ret;
+				}
+			}
+		}
+	},
+
+	// Don't automatically add "px" to these possibly-unitless properties
+	cssNumber: {
+		"animationIterationCount": true,
+		"columnCount": true,
+		"fillOpacity": true,
+		"flexGrow": true,
+		"flexShrink": true,
+		"fontWeight": true,
+		"gridArea": true,
+		"gridColumn": true,
+		"gridColumnEnd": true,
+		"gridColumnStart": true,
+		"gridRow": true,
+		"gridRowEnd": true,
+		"gridRowStart": true,
+		"lineHeight": true,
+		"opacity": true,
+		"order": true,
+		"orphans": true,
+		"widows": true,
+		"zIndex": true,
+		"zoom": true
+	},
+
+	// Add in properties whose names you wish to fix before
+	// setting or getting the value
+	cssProps: {},
+
+	// Get and set the style property on a DOM Node
+	style: function( elem, name, value, extra ) {
+
+		// Don't set styles on text and comment nodes
+		if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) {
+			return;
+		}
+
+		// Make sure that we're working with the right name
+		var ret, type, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name ),
+			style = elem.style;
+
+		// Make sure that we're working with the right name. We don't
+		// want to query the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Gets hook for the prefixed version, then unprefixed version
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// Check if we're setting a value
+		if ( value !== undefined ) {
+			type = typeof value;
+
+			// Convert "+=" or "-=" to relative numbers (#7345)
+			if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) {
+				value = adjustCSS( elem, name, ret );
+
+				// Fixes bug #9237
+				type = "number";
+			}
+
+			// Make sure that null and NaN values aren't set (#7116)
+			if ( value == null || value !== value ) {
+				return;
+			}
+
+			// If a number was passed in, add the unit (except for certain CSS properties)
+			// The isCustomProp check can be removed in jQuery 4.0 when we only auto-append
+			// "px" to a few hardcoded values.
+			if ( type === "number" && !isCustomProp ) {
+				value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" );
+			}
+
+			// background-* props affect original clone's values
+			if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) {
+				style[ name ] = "inherit";
+			}
+
+			// If a hook was provided, use that value, otherwise just set the specified value
+			if ( !hooks || !( "set" in hooks ) ||
+				( value = hooks.set( elem, value, extra ) ) !== undefined ) {
+
+				if ( isCustomProp ) {
+					style.setProperty( name, value );
+				} else {
+					style[ name ] = value;
+				}
+			}
+
+		} else {
+
+			// If a hook was provided get the non-computed value from there
+			if ( hooks && "get" in hooks &&
+				( ret = hooks.get( elem, false, extra ) ) !== undefined ) {
+
+				return ret;
+			}
+
+			// Otherwise just get the value from the style object
+			return style[ name ];
+		}
+	},
+
+	css: function( elem, name, extra, styles ) {
+		var val, num, hooks,
+			origName = camelCase( name ),
+			isCustomProp = rcustomProp.test( name );
+
+		// Make sure that we're working with the right name. We don't
+		// want to modify the value if it is a CSS custom property
+		// since they are user-defined.
+		if ( !isCustomProp ) {
+			name = finalPropName( origName );
+		}
+
+		// Try prefixed name followed by the unprefixed name
+		hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ];
+
+		// If a hook was provided get the computed value from there
+		if ( hooks && "get" in hooks ) {
+			val = hooks.get( elem, true, extra );
+		}
+
+		// Otherwise, if a way to get the computed value exists, use that
+		if ( val === undefined ) {
+			val = curCSS( elem, name, styles );
+		}
+
+		// Convert "normal" to computed value
+		if ( val === "normal" && name in cssNormalTransform ) {
+			val = cssNormalTransform[ name ];
+		}
+
+		// Make numeric if forced or a qualifier was provided and val looks numeric
+		if ( extra === "" || extra ) {
+			num = parseFloat( val );
+			return extra === true || isFinite( num ) ? num || 0 : val;
+		}
+
+		return val;
+	}
+} );
+
+jQuery.each( [ "height", "width" ], function( _i, dimension ) {
+	jQuery.cssHooks[ dimension ] = {
+		get: function( elem, computed, extra ) {
+			if ( computed ) {
+
+				// Certain elements can have dimension info if we invisibly show them
+				// but it must have a current display style that would benefit
+				return rdisplayswap.test( jQuery.css( elem, "display" ) ) &&
+
+					// Support: Safari 8+
+					// Table columns in Safari have non-zero offsetWidth & zero
+					// getBoundingClientRect().width unless display is changed.
+					// Support: IE <=11 only
+					// Running getBoundingClientRect on a disconnected node
+					// in IE throws an error.
+					( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ?
+					swap( elem, cssShow, function() {
+						return getWidthOrHeight( elem, dimension, extra );
+					} ) :
+					getWidthOrHeight( elem, dimension, extra );
+			}
+		},
+
+		set: function( elem, value, extra ) {
+			var matches,
+				styles = getStyles( elem ),
+
+				// Only read styles.position if the test has a chance to fail
+				// to avoid forcing a reflow.
+				scrollboxSizeBuggy = !support.scrollboxSize() &&
+					styles.position === "absolute",
+
+				// To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991)
+				boxSizingNeeded = scrollboxSizeBuggy || extra,
+				isBorderBox = boxSizingNeeded &&
+					jQuery.css( elem, "boxSizing", false, styles ) === "border-box",
+				subtract = extra ?
+					boxModelAdjustment(
+						elem,
+						dimension,
+						extra,
+						isBorderBox,
+						styles
+					) :
+					0;
+
+			// Account for unreliable border-box dimensions by comparing offset* to computed and
+			// faking a content-box to get border and padding (gh-3699)
+			if ( isBorderBox && scrollboxSizeBuggy ) {
+				subtract -= Math.ceil(
+					elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] -
+					parseFloat( styles[ dimension ] ) -
+					boxModelAdjustment( elem, dimension, "border", false, styles ) -
+					0.5
+				);
+			}
+
+			// Convert to pixels if value adjustment is needed
+			if ( subtract && ( matches = rcssNum.exec( value ) ) &&
+				( matches[ 3 ] || "px" ) !== "px" ) {
+
+				elem.style[ dimension ] = value;
+				value = jQuery.css( elem, dimension );
+			}
+
+			return setPositiveNumber( elem, value, subtract );
+		}
+	};
+} );
+
+jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft,
+	function( elem, computed ) {
+		if ( computed ) {
+			return ( parseFloat( curCSS( elem, "marginLeft" ) ) ||
+				elem.getBoundingClientRect().left -
+					swap( elem, { marginLeft: 0 }, function() {
+						return elem.getBoundingClientRect().left;
+					} )
+			) + "px";
+		}
+	}
+);
+
+// These hooks are used by animate to expand properties
+jQuery.each( {
+	margin: "",
+	padding: "",
+	border: "Width"
+}, function( prefix, suffix ) {
+	jQuery.cssHooks[ prefix + suffix ] = {
+		expand: function( value ) {
+			var i = 0,
+				expanded = {},
+
+				// Assumes a single number if not a string
+				parts = typeof value === "string" ? value.split( " " ) : [ value ];
+
+			for ( ; i < 4; i++ ) {
+				expanded[ prefix + cssExpand[ i ] + suffix ] =
+					parts[ i ] || parts[ i - 2 ] || parts[ 0 ];
+			}
+
+			return expanded;
+		}
+	};
+
+	if ( prefix !== "margin" ) {
+		jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber;
+	}
+} );
+
+jQuery.fn.extend( {
+	css: function( name, value ) {
+		return access( this, function( elem, name, value ) {
+			var styles, len,
+				map = {},
+				i = 0;
+
+			if ( Array.isArray( name ) ) {
+				styles = getStyles( elem );
+				len = name.length;
+
+				for ( ; i < len; i++ ) {
+					map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles );
+				}
+
+				return map;
+			}
+
+			return value !== undefined ?
+				jQuery.style( elem, name, value ) :
+				jQuery.css( elem, name );
+		}, name, value, arguments.length > 1 );
+	}
+} );
+
+
+function Tween( elem, options, prop, end, easing ) {
+	return new Tween.prototype.init( elem, options, prop, end, easing );
+}
+jQuery.Tween = Tween;
+
+Tween.prototype = {
+	constructor: Tween,
+	init: function( elem, options, prop, end, easing, unit ) {
+		this.elem = elem;
+		this.prop = prop;
+		this.easing = easing || jQuery.easing._default;
+		this.options = options;
+		this.start = this.now = this.cur();
+		this.end = end;
+		this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" );
+	},
+	cur: function() {
+		var hooks = Tween.propHooks[ this.prop ];
+
+		return hooks && hooks.get ?
+			hooks.get( this ) :
+			Tween.propHooks._default.get( this );
+	},
+	run: function( percent ) {
+		var eased,
+			hooks = Tween.propHooks[ this.prop ];
+
+		if ( this.options.duration ) {
+			this.pos = eased = jQuery.easing[ this.easing ](
+				percent, this.options.duration * percent, 0, 1, this.options.duration
+			);
+		} else {
+			this.pos = eased = percent;
+		}
+		this.now = ( this.end - this.start ) * eased + this.start;
+
+		if ( this.options.step ) {
+			this.options.step.call( this.elem, this.now, this );
+		}
+
+		if ( hooks && hooks.set ) {
+			hooks.set( this );
+		} else {
+			Tween.propHooks._default.set( this );
+		}
+		return this;
+	}
+};
+
+Tween.prototype.init.prototype = Tween.prototype;
+
+Tween.propHooks = {
+	_default: {
+		get: function( tween ) {
+			var result;
+
+			// Use a property on the element directly when it is not a DOM element,
+			// or when there is no matching style property that exists.
+			if ( tween.elem.nodeType !== 1 ||
+				tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) {
+				return tween.elem[ tween.prop ];
+			}
+
+			// Passing an empty string as a 3rd parameter to .css will automatically
+			// attempt a parseFloat and fallback to a string if the parse fails.
+			// Simple values such as "10px" are parsed to Float;
+			// complex values such as "rotate(1rad)" are returned as-is.
+			result = jQuery.css( tween.elem, tween.prop, "" );
+
+			// Empty strings, null, undefined and "auto" are converted to 0.
+			return !result || result === "auto" ? 0 : result;
+		},
+		set: function( tween ) {
+
+			// Use step hook for back compat.
+			// Use cssHook if its there.
+			// Use .style if available and use plain properties where available.
+			if ( jQuery.fx.step[ tween.prop ] ) {
+				jQuery.fx.step[ tween.prop ]( tween );
+			} else if ( tween.elem.nodeType === 1 && (
+				jQuery.cssHooks[ tween.prop ] ||
+					tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) {
+				jQuery.style( tween.elem, tween.prop, tween.now + tween.unit );
+			} else {
+				tween.elem[ tween.prop ] = tween.now;
+			}
+		}
+	}
+};
+
+// Support: IE <=9 only
+// Panic based approach to setting things on disconnected nodes
+Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = {
+	set: function( tween ) {
+		if ( tween.elem.nodeType && tween.elem.parentNode ) {
+			tween.elem[ tween.prop ] = tween.now;
+		}
+	}
+};
+
+jQuery.easing = {
+	linear: function( p ) {
+		return p;
+	},
+	swing: function( p ) {
+		return 0.5 - Math.cos( p * Math.PI ) / 2;
+	},
+	_default: "swing"
+};
+
+jQuery.fx = Tween.prototype.init;
+
+// Back compat <1.8 extension point
+jQuery.fx.step = {};
+
+
+
+
+var
+	fxNow, inProgress,
+	rfxtypes = /^(?:toggle|show|hide)$/,
+	rrun = /queueHooks$/;
+
+function schedule() {
+	if ( inProgress ) {
+		if ( document.hidden === false && window.requestAnimationFrame ) {
+			window.requestAnimationFrame( schedule );
+		} else {
+			window.setTimeout( schedule, jQuery.fx.interval );
+		}
+
+		jQuery.fx.tick();
+	}
+}
+
+// Animations created synchronously will run synchronously
+function createFxNow() {
+	window.setTimeout( function() {
+		fxNow = undefined;
+	} );
+	return ( fxNow = Date.now() );
+}
+
+// Generate parameters to create a standard animation
+function genFx( type, includeWidth ) {
+	var which,
+		i = 0,
+		attrs = { height: type };
+
+	// If we include width, step value is 1 to do all cssExpand values,
+	// otherwise step value is 2 to skip over Left and Right
+	includeWidth = includeWidth ? 1 : 0;
+	for ( ; i < 4; i += 2 - includeWidth ) {
+		which = cssExpand[ i ];
+		attrs[ "margin" + which ] = attrs[ "padding" + which ] = type;
+	}
+
+	if ( includeWidth ) {
+		attrs.opacity = attrs.width = type;
+	}
+
+	return attrs;
+}
+
+function createTween( value, prop, animation ) {
+	var tween,
+		collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ),
+		index = 0,
+		length = collection.length;
+	for ( ; index < length; index++ ) {
+		if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) {
+
+			// We're done with this property
+			return tween;
+		}
+	}
+}
+
+function defaultPrefilter( elem, props, opts ) {
+	var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display,
+		isBox = "width" in props || "height" in props,
+		anim = this,
+		orig = {},
+		style = elem.style,
+		hidden = elem.nodeType && isHiddenWithinTree( elem ),
+		dataShow = dataPriv.get( elem, "fxshow" );
+
+	// Queue-skipping animations hijack the fx hooks
+	if ( !opts.queue ) {
+		hooks = jQuery._queueHooks( elem, "fx" );
+		if ( hooks.unqueued == null ) {
+			hooks.unqueued = 0;
+			oldfire = hooks.empty.fire;
+			hooks.empty.fire = function() {
+				if ( !hooks.unqueued ) {
+					oldfire();
+				}
+			};
+		}
+		hooks.unqueued++;
+
+		anim.always( function() {
+
+			// Ensure the complete handler is called before this completes
+			anim.always( function() {
+				hooks.unqueued--;
+				if ( !jQuery.queue( elem, "fx" ).length ) {
+					hooks.empty.fire();
+				}
+			} );
+		} );
+	}
+
+	// Detect show/hide animations
+	for ( prop in props ) {
+		value = props[ prop ];
+		if ( rfxtypes.test( value ) ) {
+			delete props[ prop ];
+			toggle = toggle || value === "toggle";
+			if ( value === ( hidden ? "hide" : "show" ) ) {
+
+				// Pretend to be hidden if this is a "show" and
+				// there is still data from a stopped show/hide
+				if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) {
+					hidden = true;
+
+				// Ignore all other no-op show/hide data
+				} else {
+					continue;
+				}
+			}
+			orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop );
+		}
+	}
+
+	// Bail out if this is a no-op like .hide().hide()
+	propTween = !jQuery.isEmptyObject( props );
+	if ( !propTween && jQuery.isEmptyObject( orig ) ) {
+		return;
+	}
+
+	// Restrict "overflow" and "display" styles during box animations
+	if ( isBox && elem.nodeType === 1 ) {
+
+		// Support: IE <=9 - 11, Edge 12 - 15
+		// Record all 3 overflow attributes because IE does not infer the shorthand
+		// from identically-valued overflowX and overflowY and Edge just mirrors
+		// the overflowX value there.
+		opts.overflow = [ style.overflow, style.overflowX, style.overflowY ];
+
+		// Identify a display type, preferring old show/hide data over the CSS cascade
+		restoreDisplay = dataShow && dataShow.display;
+		if ( restoreDisplay == null ) {
+			restoreDisplay = dataPriv.get( elem, "display" );
+		}
+		display = jQuery.css( elem, "display" );
+		if ( display === "none" ) {
+			if ( restoreDisplay ) {
+				display = restoreDisplay;
+			} else {
+
+				// Get nonempty value(s) by temporarily forcing visibility
+				showHide( [ elem ], true );
+				restoreDisplay = elem.style.display || restoreDisplay;
+				display = jQuery.css( elem, "display" );
+				showHide( [ elem ] );
+			}
+		}
+
+		// Animate inline elements as inline-block
+		if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) {
+			if ( jQuery.css( elem, "float" ) === "none" ) {
+
+				// Restore the original display value at the end of pure show/hide animations
+				if ( !propTween ) {
+					anim.done( function() {
+						style.display = restoreDisplay;
+					} );
+					if ( restoreDisplay == null ) {
+						display = style.display;
+						restoreDisplay = display === "none" ? "" : display;
+					}
+				}
+				style.display = "inline-block";
+			}
+		}
+	}
+
+	if ( opts.overflow ) {
+		style.overflow = "hidden";
+		anim.always( function() {
+			style.overflow = opts.overflow[ 0 ];
+			style.overflowX = opts.overflow[ 1 ];
+			style.overflowY = opts.overflow[ 2 ];
+		} );
+	}
+
+	// Implement show/hide animations
+	propTween = false;
+	for ( prop in orig ) {
+
+		// General show/hide setup for this element animation
+		if ( !propTween ) {
+			if ( dataShow ) {
+				if ( "hidden" in dataShow ) {
+					hidden = dataShow.hidden;
+				}
+			} else {
+				dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } );
+			}
+
+			// Store hidden/visible for toggle so `.stop().toggle()` "reverses"
+			if ( toggle ) {
+				dataShow.hidden = !hidden;
+			}
+
+			// Show elements before animating them
+			if ( hidden ) {
+				showHide( [ elem ], true );
+			}
+
+			/* eslint-disable no-loop-func */
+
+			anim.done( function() {
+
+				/* eslint-enable no-loop-func */
+
+				// The final step of a "hide" animation is actually hiding the element
+				if ( !hidden ) {
+					showHide( [ elem ] );
+				}
+				dataPriv.remove( elem, "fxshow" );
+				for ( prop in orig ) {
+					jQuery.style( elem, prop, orig[ prop ] );
+				}
+			} );
+		}
+
+		// Per-property setup
+		propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim );
+		if ( !( prop in dataShow ) ) {
+			dataShow[ prop ] = propTween.start;
+			if ( hidden ) {
+				propTween.end = propTween.start;
+				propTween.start = 0;
+			}
+		}
+	}
+}
+
+function propFilter( props, specialEasing ) {
+	var index, name, easing, value, hooks;
+
+	// camelCase, specialEasing and expand cssHook pass
+	for ( index in props ) {
+		name = camelCase( index );
+		easing = specialEasing[ name ];
+		value = props[ index ];
+		if ( Array.isArray( value ) ) {
+			easing = value[ 1 ];
+			value = props[ index ] = value[ 0 ];
+		}
+
+		if ( index !== name ) {
+			props[ name ] = value;
+			delete props[ index ];
+		}
+
+		hooks = jQuery.cssHooks[ name ];
+		if ( hooks && "expand" in hooks ) {
+			value = hooks.expand( value );
+			delete props[ name ];
+
+			// Not quite $.extend, this won't overwrite existing keys.
+			// Reusing 'index' because we have the correct "name"
+			for ( index in value ) {
+				if ( !( index in props ) ) {
+					props[ index ] = value[ index ];
+					specialEasing[ index ] = easing;
+				}
+			}
+		} else {
+			specialEasing[ name ] = easing;
+		}
+	}
+}
+
+function Animation( elem, properties, options ) {
+	var result,
+		stopped,
+		index = 0,
+		length = Animation.prefilters.length,
+		deferred = jQuery.Deferred().always( function() {
+
+			// Don't match elem in the :animated selector
+			delete tick.elem;
+		} ),
+		tick = function() {
+			if ( stopped ) {
+				return false;
+			}
+			var currentTime = fxNow || createFxNow(),
+				remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ),
+
+				// Support: Android 2.3 only
+				// Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497)
+				temp = remaining / animation.duration || 0,
+				percent = 1 - temp,
+				index = 0,
+				length = animation.tweens.length;
+
+			for ( ; index < length; index++ ) {
+				animation.tweens[ index ].run( percent );
+			}
+
+			deferred.notifyWith( elem, [ animation, percent, remaining ] );
+
+			// If there's more to do, yield
+			if ( percent < 1 && length ) {
+				return remaining;
+			}
+
+			// If this was an empty animation, synthesize a final progress notification
+			if ( !length ) {
+				deferred.notifyWith( elem, [ animation, 1, 0 ] );
+			}
+
+			// Resolve the animation and report its conclusion
+			deferred.resolveWith( elem, [ animation ] );
+			return false;
+		},
+		animation = deferred.promise( {
+			elem: elem,
+			props: jQuery.extend( {}, properties ),
+			opts: jQuery.extend( true, {
+				specialEasing: {},
+				easing: jQuery.easing._default
+			}, options ),
+			originalProperties: properties,
+			originalOptions: options,
+			startTime: fxNow || createFxNow(),
+			duration: options.duration,
+			tweens: [],
+			createTween: function( prop, end ) {
+				var tween = jQuery.Tween( elem, animation.opts, prop, end,
+					animation.opts.specialEasing[ prop ] || animation.opts.easing );
+				animation.tweens.push( tween );
+				return tween;
+			},
+			stop: function( gotoEnd ) {
+				var index = 0,
+
+					// If we are going to the end, we want to run all the tweens
+					// otherwise we skip this part
+					length = gotoEnd ? animation.tweens.length : 0;
+				if ( stopped ) {
+					return this;
+				}
+				stopped = true;
+				for ( ; index < length; index++ ) {
+					animation.tweens[ index ].run( 1 );
+				}
+
+				// Resolve when we played the last frame; otherwise, reject
+				if ( gotoEnd ) {
+					deferred.notifyWith( elem, [ animation, 1, 0 ] );
+					deferred.resolveWith( elem, [ animation, gotoEnd ] );
+				} else {
+					deferred.rejectWith( elem, [ animation, gotoEnd ] );
+				}
+				return this;
+			}
+		} ),
+		props = animation.props;
+
+	propFilter( props, animation.opts.specialEasing );
+
+	for ( ; index < length; index++ ) {
+		result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts );
+		if ( result ) {
+			if ( isFunction( result.stop ) ) {
+				jQuery._queueHooks( animation.elem, animation.opts.queue ).stop =
+					result.stop.bind( result );
+			}
+			return result;
+		}
+	}
+
+	jQuery.map( props, createTween, animation );
+
+	if ( isFunction( animation.opts.start ) ) {
+		animation.opts.start.call( elem, animation );
+	}
+
+	// Attach callbacks from options
+	animation
+		.progress( animation.opts.progress )
+		.done( animation.opts.done, animation.opts.complete )
+		.fail( animation.opts.fail )
+		.always( animation.opts.always );
+
+	jQuery.fx.timer(
+		jQuery.extend( tick, {
+			elem: elem,
+			anim: animation,
+			queue: animation.opts.queue
+		} )
+	);
+
+	return animation;
+}
+
+jQuery.Animation = jQuery.extend( Animation, {
+
+	tweeners: {
+		"*": [ function( prop, value ) {
+			var tween = this.createTween( prop, value );
+			adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween );
+			return tween;
+		} ]
+	},
+
+	tweener: function( props, callback ) {
+		if ( isFunction( props ) ) {
+			callback = props;
+			props = [ "*" ];
+		} else {
+			props = props.match( rnothtmlwhite );
+		}
+
+		var prop,
+			index = 0,
+			length = props.length;
+
+		for ( ; index < length; index++ ) {
+			prop = props[ index ];
+			Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || [];
+			Animation.tweeners[ prop ].unshift( callback );
+		}
+	},
+
+	prefilters: [ defaultPrefilter ],
+
+	prefilter: function( callback, prepend ) {
+		if ( prepend ) {
+			Animation.prefilters.unshift( callback );
+		} else {
+			Animation.prefilters.push( callback );
+		}
+	}
+} );
+
+jQuery.speed = function( speed, easing, fn ) {
+	var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : {
+		complete: fn || !fn && easing ||
+			isFunction( speed ) && speed,
+		duration: speed,
+		easing: fn && easing || easing && !isFunction( easing ) && easing
+	};
+
+	// Go to the end state if fx are off
+	if ( jQuery.fx.off ) {
+		opt.duration = 0;
+
+	} else {
+		if ( typeof opt.duration !== "number" ) {
+			if ( opt.duration in jQuery.fx.speeds ) {
+				opt.duration = jQuery.fx.speeds[ opt.duration ];
+
+			} else {
+				opt.duration = jQuery.fx.speeds._default;
+			}
+		}
+	}
+
+	// Normalize opt.queue - true/undefined/null -> "fx"
+	if ( opt.queue == null || opt.queue === true ) {
+		opt.queue = "fx";
+	}
+
+	// Queueing
+	opt.old = opt.complete;
+
+	opt.complete = function() {
+		if ( isFunction( opt.old ) ) {
+			opt.old.call( this );
+		}
+
+		if ( opt.queue ) {
+			jQuery.dequeue( this, opt.queue );
+		}
+	};
+
+	return opt;
+};
+
+jQuery.fn.extend( {
+	fadeTo: function( speed, to, easing, callback ) {
+
+		// Show any hidden elements after setting opacity to 0
+		return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show()
+
+			// Animate to the value specified
+			.end().animate( { opacity: to }, speed, easing, callback );
+	},
+	animate: function( prop, speed, easing, callback ) {
+		var empty = jQuery.isEmptyObject( prop ),
+			optall = jQuery.speed( speed, easing, callback ),
+			doAnimation = function() {
+
+				// Operate on a copy of prop so per-property easing won't be lost
+				var anim = Animation( this, jQuery.extend( {}, prop ), optall );
+
+				// Empty animations, or finishing resolves immediately
+				if ( empty || dataPriv.get( this, "finish" ) ) {
+					anim.stop( true );
+				}
+			};
+
+		doAnimation.finish = doAnimation;
+
+		return empty || optall.queue === false ?
+			this.each( doAnimation ) :
+			this.queue( optall.queue, doAnimation );
+	},
+	stop: function( type, clearQueue, gotoEnd ) {
+		var stopQueue = function( hooks ) {
+			var stop = hooks.stop;
+			delete hooks.stop;
+			stop( gotoEnd );
+		};
+
+		if ( typeof type !== "string" ) {
+			gotoEnd = clearQueue;
+			clearQueue = type;
+			type = undefined;
+		}
+		if ( clearQueue ) {
+			this.queue( type || "fx", [] );
+		}
+
+		return this.each( function() {
+			var dequeue = true,
+				index = type != null && type + "queueHooks",
+				timers = jQuery.timers,
+				data = dataPriv.get( this );
+
+			if ( index ) {
+				if ( data[ index ] && data[ index ].stop ) {
+					stopQueue( data[ index ] );
+				}
+			} else {
+				for ( index in data ) {
+					if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) {
+						stopQueue( data[ index ] );
+					}
+				}
+			}
+
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this &&
+					( type == null || timers[ index ].queue === type ) ) {
+
+					timers[ index ].anim.stop( gotoEnd );
+					dequeue = false;
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Start the next in the queue if the last step wasn't forced.
+			// Timers currently will call their complete callbacks, which
+			// will dequeue but only if they were gotoEnd.
+			if ( dequeue || !gotoEnd ) {
+				jQuery.dequeue( this, type );
+			}
+		} );
+	},
+	finish: function( type ) {
+		if ( type !== false ) {
+			type = type || "fx";
+		}
+		return this.each( function() {
+			var index,
+				data = dataPriv.get( this ),
+				queue = data[ type + "queue" ],
+				hooks = data[ type + "queueHooks" ],
+				timers = jQuery.timers,
+				length = queue ? queue.length : 0;
+
+			// Enable finishing flag on private data
+			data.finish = true;
+
+			// Empty the queue first
+			jQuery.queue( this, type, [] );
+
+			if ( hooks && hooks.stop ) {
+				hooks.stop.call( this, true );
+			}
+
+			// Look for any active animations, and finish them
+			for ( index = timers.length; index--; ) {
+				if ( timers[ index ].elem === this && timers[ index ].queue === type ) {
+					timers[ index ].anim.stop( true );
+					timers.splice( index, 1 );
+				}
+			}
+
+			// Look for any animations in the old queue and finish them
+			for ( index = 0; index < length; index++ ) {
+				if ( queue[ index ] && queue[ index ].finish ) {
+					queue[ index ].finish.call( this );
+				}
+			}
+
+			// Turn off finishing flag
+			delete data.finish;
+		} );
+	}
+} );
+
+jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) {
+	var cssFn = jQuery.fn[ name ];
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return speed == null || typeof speed === "boolean" ?
+			cssFn.apply( this, arguments ) :
+			this.animate( genFx( name, true ), speed, easing, callback );
+	};
+} );
+
+// Generate shortcuts for custom animations
+jQuery.each( {
+	slideDown: genFx( "show" ),
+	slideUp: genFx( "hide" ),
+	slideToggle: genFx( "toggle" ),
+	fadeIn: { opacity: "show" },
+	fadeOut: { opacity: "hide" },
+	fadeToggle: { opacity: "toggle" }
+}, function( name, props ) {
+	jQuery.fn[ name ] = function( speed, easing, callback ) {
+		return this.animate( props, speed, easing, callback );
+	};
+} );
+
+jQuery.timers = [];
+jQuery.fx.tick = function() {
+	var timer,
+		i = 0,
+		timers = jQuery.timers;
+
+	fxNow = Date.now();
+
+	for ( ; i < timers.length; i++ ) {
+		timer = timers[ i ];
+
+		// Run the timer and safely remove it when done (allowing for external removal)
+		if ( !timer() && timers[ i ] === timer ) {
+			timers.splice( i--, 1 );
+		}
+	}
+
+	if ( !timers.length ) {
+		jQuery.fx.stop();
+	}
+	fxNow = undefined;
+};
+
+jQuery.fx.timer = function( timer ) {
+	jQuery.timers.push( timer );
+	jQuery.fx.start();
+};
+
+jQuery.fx.interval = 13;
+jQuery.fx.start = function() {
+	if ( inProgress ) {
+		return;
+	}
+
+	inProgress = true;
+	schedule();
+};
+
+jQuery.fx.stop = function() {
+	inProgress = null;
+};
+
+jQuery.fx.speeds = {
+	slow: 600,
+	fast: 200,
+
+	// Default speed
+	_default: 400
+};
+
+
+// Based off of the plugin by Clint Helfers, with permission.
+// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/
+jQuery.fn.delay = function( time, type ) {
+	time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time;
+	type = type || "fx";
+
+	return this.queue( type, function( next, hooks ) {
+		var timeout = window.setTimeout( next, time );
+		hooks.stop = function() {
+			window.clearTimeout( timeout );
+		};
+	} );
+};
+
+
+( function() {
+	var input = document.createElement( "input" ),
+		select = document.createElement( "select" ),
+		opt = select.appendChild( document.createElement( "option" ) );
+
+	input.type = "checkbox";
+
+	// Support: Android <=4.3 only
+	// Default value for a checkbox should be "on"
+	support.checkOn = input.value !== "";
+
+	// Support: IE <=11 only
+	// Must access selectedIndex to make default options select
+	support.optSelected = opt.selected;
+
+	// Support: IE <=11 only
+	// An input loses its value after becoming a radio
+	input = document.createElement( "input" );
+	input.value = "t";
+	input.type = "radio";
+	support.radioValue = input.value === "t";
+} )();
+
+
+var boolHook,
+	attrHandle = jQuery.expr.attrHandle;
+
+jQuery.fn.extend( {
+	attr: function( name, value ) {
+		return access( this, jQuery.attr, name, value, arguments.length > 1 );
+	},
+
+	removeAttr: function( name ) {
+		return this.each( function() {
+			jQuery.removeAttr( this, name );
+		} );
+	}
+} );
+
+jQuery.extend( {
+	attr: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set attributes on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		// Fallback to prop when attributes are not supported
+		if ( typeof elem.getAttribute === "undefined" ) {
+			return jQuery.prop( elem, name, value );
+		}
+
+		// Attribute hooks are determined by the lowercase version
+		// Grab necessary hook if one is defined
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+			hooks = jQuery.attrHooks[ name.toLowerCase() ] ||
+				( jQuery.expr.match.bool.test( name ) ? boolHook : undefined );
+		}
+
+		if ( value !== undefined ) {
+			if ( value === null ) {
+				jQuery.removeAttr( elem, name );
+				return;
+			}
+
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			elem.setAttribute( name, value + "" );
+			return value;
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		ret = jQuery.find.attr( elem, name );
+
+		// Non-existent attributes return null, we normalize to undefined
+		return ret == null ? undefined : ret;
+	},
+
+	attrHooks: {
+		type: {
+			set: function( elem, value ) {
+				if ( !support.radioValue && value === "radio" &&
+					nodeName( elem, "input" ) ) {
+					var val = elem.value;
+					elem.setAttribute( "type", value );
+					if ( val ) {
+						elem.value = val;
+					}
+					return value;
+				}
+			}
+		}
+	},
+
+	removeAttr: function( elem, value ) {
+		var name,
+			i = 0,
+
+			// Attribute names can contain non-HTML whitespace characters
+			// https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
+			attrNames = value && value.match( rnothtmlwhite );
+
+		if ( attrNames && elem.nodeType === 1 ) {
+			while ( ( name = attrNames[ i++ ] ) ) {
+				elem.removeAttribute( name );
+			}
+		}
+	}
+} );
+
+// Hooks for boolean attributes
+boolHook = {
+	set: function( elem, value, name ) {
+		if ( value === false ) {
+
+			// Remove boolean attributes when set to false
+			jQuery.removeAttr( elem, name );
+		} else {
+			elem.setAttribute( name, name );
+		}
+		return name;
+	}
+};
+
+jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) {
+	var getter = attrHandle[ name ] || jQuery.find.attr;
+
+	attrHandle[ name ] = function( elem, name, isXML ) {
+		var ret, handle,
+			lowercaseName = name.toLowerCase();
+
+		if ( !isXML ) {
+
+			// Avoid an infinite loop by temporarily removing this function from the getter
+			handle = attrHandle[ lowercaseName ];
+			attrHandle[ lowercaseName ] = ret;
+			ret = getter( elem, name, isXML ) != null ?
+				lowercaseName :
+				null;
+			attrHandle[ lowercaseName ] = handle;
+		}
+		return ret;
+	};
+} );
+
+
+
+
+var rfocusable = /^(?:input|select|textarea|button)$/i,
+	rclickable = /^(?:a|area)$/i;
+
+jQuery.fn.extend( {
+	prop: function( name, value ) {
+		return access( this, jQuery.prop, name, value, arguments.length > 1 );
+	},
+
+	removeProp: function( name ) {
+		return this.each( function() {
+			delete this[ jQuery.propFix[ name ] || name ];
+		} );
+	}
+} );
+
+jQuery.extend( {
+	prop: function( elem, name, value ) {
+		var ret, hooks,
+			nType = elem.nodeType;
+
+		// Don't get/set properties on text, comment and attribute nodes
+		if ( nType === 3 || nType === 8 || nType === 2 ) {
+			return;
+		}
+
+		if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) {
+
+			// Fix name and attach hooks
+			name = jQuery.propFix[ name ] || name;
+			hooks = jQuery.propHooks[ name ];
+		}
+
+		if ( value !== undefined ) {
+			if ( hooks && "set" in hooks &&
+				( ret = hooks.set( elem, value, name ) ) !== undefined ) {
+				return ret;
+			}
+
+			return ( elem[ name ] = value );
+		}
+
+		if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) {
+			return ret;
+		}
+
+		return elem[ name ];
+	},
+
+	propHooks: {
+		tabIndex: {
+			get: function( elem ) {
+
+				// Support: IE <=9 - 11 only
+				// elem.tabIndex doesn't always return the
+				// correct value when it hasn't been explicitly set
+				// https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/
+				// Use proper attribute retrieval(#12072)
+				var tabindex = jQuery.find.attr( elem, "tabindex" );
+
+				if ( tabindex ) {
+					return parseInt( tabindex, 10 );
+				}
+
+				if (
+					rfocusable.test( elem.nodeName ) ||
+					rclickable.test( elem.nodeName ) &&
+					elem.href
+				) {
+					return 0;
+				}
+
+				return -1;
+			}
+		}
+	},
+
+	propFix: {
+		"for": "htmlFor",
+		"class": "className"
+	}
+} );
+
+// Support: IE <=11 only
+// Accessing the selectedIndex property
+// forces the browser to respect setting selected
+// on the option
+// The getter ensures a default option is selected
+// when in an optgroup
+// eslint rule "no-unused-expressions" is disabled for this code
+// since it considers such accessions noop
+if ( !support.optSelected ) {
+	jQuery.propHooks.selected = {
+		get: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent && parent.parentNode ) {
+				parent.parentNode.selectedIndex;
+			}
+			return null;
+		},
+		set: function( elem ) {
+
+			/* eslint no-unused-expressions: "off" */
+
+			var parent = elem.parentNode;
+			if ( parent ) {
+				parent.selectedIndex;
+
+				if ( parent.parentNode ) {
+					parent.parentNode.selectedIndex;
+				}
+			}
+		}
+	};
+}
+
+jQuery.each( [
+	"tabIndex",
+	"readOnly",
+	"maxLength",
+	"cellSpacing",
+	"cellPadding",
+	"rowSpan",
+	"colSpan",
+	"useMap",
+	"frameBorder",
+	"contentEditable"
+], function() {
+	jQuery.propFix[ this.toLowerCase() ] = this;
+} );
+
+
+
+
+	// Strip and collapse whitespace according to HTML spec
+	// https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace
+	function stripAndCollapse( value ) {
+		var tokens = value.match( rnothtmlwhite ) || [];
+		return tokens.join( " " );
+	}
+
+
+function getClass( elem ) {
+	return elem.getAttribute && elem.getAttribute( "class" ) || "";
+}
+
+function classesToArray( value ) {
+	if ( Array.isArray( value ) ) {
+		return value;
+	}
+	if ( typeof value === "string" ) {
+		return value.match( rnothtmlwhite ) || [];
+	}
+	return [];
+}
+
+jQuery.fn.extend( {
+	addClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).addClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+						if ( cur.indexOf( " " + clazz + " " ) < 0 ) {
+							cur += clazz + " ";
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	removeClass: function( value ) {
+		var classes, elem, cur, curValue, clazz, j, finalValue,
+			i = 0;
+
+		if ( isFunction( value ) ) {
+			return this.each( function( j ) {
+				jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) );
+			} );
+		}
+
+		if ( !arguments.length ) {
+			return this.attr( "class", "" );
+		}
+
+		classes = classesToArray( value );
+
+		if ( classes.length ) {
+			while ( ( elem = this[ i++ ] ) ) {
+				curValue = getClass( elem );
+
+				// This expression is here for better compressibility (see addClass)
+				cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " );
+
+				if ( cur ) {
+					j = 0;
+					while ( ( clazz = classes[ j++ ] ) ) {
+
+						// Remove *all* instances
+						while ( cur.indexOf( " " + clazz + " " ) > -1 ) {
+							cur = cur.replace( " " + clazz + " ", " " );
+						}
+					}
+
+					// Only assign if different to avoid unneeded rendering.
+					finalValue = stripAndCollapse( cur );
+					if ( curValue !== finalValue ) {
+						elem.setAttribute( "class", finalValue );
+					}
+				}
+			}
+		}
+
+		return this;
+	},
+
+	toggleClass: function( value, stateVal ) {
+		var type = typeof value,
+			isValidValue = type === "string" || Array.isArray( value );
+
+		if ( typeof stateVal === "boolean" && isValidValue ) {
+			return stateVal ? this.addClass( value ) : this.removeClass( value );
+		}
+
+		if ( isFunction( value ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).toggleClass(
+					value.call( this, i, getClass( this ), stateVal ),
+					stateVal
+				);
+			} );
+		}
+
+		return this.each( function() {
+			var className, i, self, classNames;
+
+			if ( isValidValue ) {
+
+				// Toggle individual class names
+				i = 0;
+				self = jQuery( this );
+				classNames = classesToArray( value );
+
+				while ( ( className = classNames[ i++ ] ) ) {
+
+					// Check each className given, space separated list
+					if ( self.hasClass( className ) ) {
+						self.removeClass( className );
+					} else {
+						self.addClass( className );
+					}
+				}
+
+			// Toggle whole class name
+			} else if ( value === undefined || type === "boolean" ) {
+				className = getClass( this );
+				if ( className ) {
+
+					// Store className if set
+					dataPriv.set( this, "__className__", className );
+				}
+
+				// If the element has a class name or if we're passed `false`,
+				// then remove the whole classname (if there was one, the above saved it).
+				// Otherwise bring back whatever was previously saved (if anything),
+				// falling back to the empty string if nothing was stored.
+				if ( this.setAttribute ) {
+					this.setAttribute( "class",
+						className || value === false ?
+							"" :
+							dataPriv.get( this, "__className__" ) || ""
+					);
+				}
+			}
+		} );
+	},
+
+	hasClass: function( selector ) {
+		var className, elem,
+			i = 0;
+
+		className = " " + selector + " ";
+		while ( ( elem = this[ i++ ] ) ) {
+			if ( elem.nodeType === 1 &&
+				( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) {
+				return true;
+			}
+		}
+
+		return false;
+	}
+} );
+
+
+
+
+var rreturn = /\r/g;
+
+jQuery.fn.extend( {
+	val: function( value ) {
+		var hooks, ret, valueIsFunction,
+			elem = this[ 0 ];
+
+		if ( !arguments.length ) {
+			if ( elem ) {
+				hooks = jQuery.valHooks[ elem.type ] ||
+					jQuery.valHooks[ elem.nodeName.toLowerCase() ];
+
+				if ( hooks &&
+					"get" in hooks &&
+					( ret = hooks.get( elem, "value" ) ) !== undefined
+				) {
+					return ret;
+				}
+
+				ret = elem.value;
+
+				// Handle most common string cases
+				if ( typeof ret === "string" ) {
+					return ret.replace( rreturn, "" );
+				}
+
+				// Handle cases where value is null/undef or number
+				return ret == null ? "" : ret;
+			}
+
+			return;
+		}
+
+		valueIsFunction = isFunction( value );
+
+		return this.each( function( i ) {
+			var val;
+
+			if ( this.nodeType !== 1 ) {
+				return;
+			}
+
+			if ( valueIsFunction ) {
+				val = value.call( this, i, jQuery( this ).val() );
+			} else {
+				val = value;
+			}
+
+			// Treat null/undefined as ""; convert numbers to string
+			if ( val == null ) {
+				val = "";
+
+			} else if ( typeof val === "number" ) {
+				val += "";
+
+			} else if ( Array.isArray( val ) ) {
+				val = jQuery.map( val, function( value ) {
+					return value == null ? "" : value + "";
+				} );
+			}
+
+			hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ];
+
+			// If set returns undefined, fall back to normal setting
+			if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
+				this.value = val;
+			}
+		} );
+	}
+} );
+
+jQuery.extend( {
+	valHooks: {
+		option: {
+			get: function( elem ) {
+
+				var val = jQuery.find.attr( elem, "value" );
+				return val != null ?
+					val :
+
+					// Support: IE <=10 - 11 only
+					// option.text throws exceptions (#14686, #14858)
+					// Strip and collapse whitespace
+					// https://html.spec.whatwg.org/#strip-and-collapse-whitespace
+					stripAndCollapse( jQuery.text( elem ) );
+			}
+		},
+		select: {
+			get: function( elem ) {
+				var value, option, i,
+					options = elem.options,
+					index = elem.selectedIndex,
+					one = elem.type === "select-one",
+					values = one ? null : [],
+					max = one ? index + 1 : options.length;
+
+				if ( index < 0 ) {
+					i = max;
+
+				} else {
+					i = one ? index : 0;
+				}
+
+				// Loop through all the selected options
+				for ( ; i < max; i++ ) {
+					option = options[ i ];
+
+					// Support: IE <=9 only
+					// IE8-9 doesn't update selected after form reset (#2551)
+					if ( ( option.selected || i === index ) &&
+
+							// Don't return options that are disabled or in a disabled optgroup
+							!option.disabled &&
+							( !option.parentNode.disabled ||
+								!nodeName( option.parentNode, "optgroup" ) ) ) {
+
+						// Get the specific value for the option
+						value = jQuery( option ).val();
+
+						// We don't need an array for one selects
+						if ( one ) {
+							return value;
+						}
+
+						// Multi-Selects return an array
+						values.push( value );
+					}
+				}
+
+				return values;
+			},
+
+			set: function( elem, value ) {
+				var optionSet, option,
+					options = elem.options,
+					values = jQuery.makeArray( value ),
+					i = options.length;
+
+				while ( i-- ) {
+					option = options[ i ];
+
+					/* eslint-disable no-cond-assign */
+
+					if ( option.selected =
+						jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1
+					) {
+						optionSet = true;
+					}
+
+					/* eslint-enable no-cond-assign */
+				}
+
+				// Force browsers to behave consistently when non-matching value is set
+				if ( !optionSet ) {
+					elem.selectedIndex = -1;
+				}
+				return values;
+			}
+		}
+	}
+} );
+
+// Radios and checkboxes getter/setter
+jQuery.each( [ "radio", "checkbox" ], function() {
+	jQuery.valHooks[ this ] = {
+		set: function( elem, value ) {
+			if ( Array.isArray( value ) ) {
+				return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 );
+			}
+		}
+	};
+	if ( !support.checkOn ) {
+		jQuery.valHooks[ this ].get = function( elem ) {
+			return elem.getAttribute( "value" ) === null ? "on" : elem.value;
+		};
+	}
+} );
+
+
+
+
+// Return jQuery for attributes-only inclusion
+
+
+support.focusin = "onfocusin" in window;
+
+
+var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/,
+	stopPropagationCallback = function( e ) {
+		e.stopPropagation();
+	};
+
+jQuery.extend( jQuery.event, {
+
+	trigger: function( event, data, elem, onlyHandlers ) {
+
+		var i, cur, tmp, bubbleType, ontype, handle, special, lastElement,
+			eventPath = [ elem || document ],
+			type = hasOwn.call( event, "type" ) ? event.type : event,
+			namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : [];
+
+		cur = lastElement = tmp = elem = elem || document;
+
+		// Don't do events on text and comment nodes
+		if ( elem.nodeType === 3 || elem.nodeType === 8 ) {
+			return;
+		}
+
+		// focus/blur morphs to focusin/out; ensure we're not firing them right now
+		if ( rfocusMorph.test( type + jQuery.event.triggered ) ) {
+			return;
+		}
+
+		if ( type.indexOf( "." ) > -1 ) {
+
+			// Namespaced trigger; create a regexp to match event type in handle()
+			namespaces = type.split( "." );
+			type = namespaces.shift();
+			namespaces.sort();
+		}
+		ontype = type.indexOf( ":" ) < 0 && "on" + type;
+
+		// Caller can pass in a jQuery.Event object, Object, or just an event type string
+		event = event[ jQuery.expando ] ?
+			event :
+			new jQuery.Event( type, typeof event === "object" && event );
+
+		// Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true)
+		event.isTrigger = onlyHandlers ? 2 : 3;
+		event.namespace = namespaces.join( "." );
+		event.rnamespace = event.namespace ?
+			new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) :
+			null;
+
+		// Clean up the event in case it is being reused
+		event.result = undefined;
+		if ( !event.target ) {
+			event.target = elem;
+		}
+
+		// Clone any incoming data and prepend the event, creating the handler arg list
+		data = data == null ?
+			[ event ] :
+			jQuery.makeArray( data, [ event ] );
+
+		// Allow special events to draw outside the lines
+		special = jQuery.event.special[ type ] || {};
+		if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) {
+			return;
+		}
+
+		// Determine event propagation path in advance, per W3C events spec (#9951)
+		// Bubble up to document, then to window; watch for a global ownerDocument var (#9724)
+		if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) {
+
+			bubbleType = special.delegateType || type;
+			if ( !rfocusMorph.test( bubbleType + type ) ) {
+				cur = cur.parentNode;
+			}
+			for ( ; cur; cur = cur.parentNode ) {
+				eventPath.push( cur );
+				tmp = cur;
+			}
+
+			// Only add window if we got to document (e.g., not plain obj or detached DOM)
+			if ( tmp === ( elem.ownerDocument || document ) ) {
+				eventPath.push( tmp.defaultView || tmp.parentWindow || window );
+			}
+		}
+
+		// Fire handlers on the event path
+		i = 0;
+		while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) {
+			lastElement = cur;
+			event.type = i > 1 ?
+				bubbleType :
+				special.bindType || type;
+
+			// jQuery handler
+			handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] &&
+				dataPriv.get( cur, "handle" );
+			if ( handle ) {
+				handle.apply( cur, data );
+			}
+
+			// Native handler
+			handle = ontype && cur[ ontype ];
+			if ( handle && handle.apply && acceptData( cur ) ) {
+				event.result = handle.apply( cur, data );
+				if ( event.result === false ) {
+					event.preventDefault();
+				}
+			}
+		}
+		event.type = type;
+
+		// If nobody prevented the default action, do it now
+		if ( !onlyHandlers && !event.isDefaultPrevented() ) {
+
+			if ( ( !special._default ||
+				special._default.apply( eventPath.pop(), data ) === false ) &&
+				acceptData( elem ) ) {
+
+				// Call a native DOM method on the target with the same name as the event.
+				// Don't do default actions on window, that's where global variables be (#6170)
+				if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) {
+
+					// Don't re-trigger an onFOO event when we call its FOO() method
+					tmp = elem[ ontype ];
+
+					if ( tmp ) {
+						elem[ ontype ] = null;
+					}
+
+					// Prevent re-triggering of the same event, since we already bubbled it above
+					jQuery.event.triggered = type;
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.addEventListener( type, stopPropagationCallback );
+					}
+
+					elem[ type ]();
+
+					if ( event.isPropagationStopped() ) {
+						lastElement.removeEventListener( type, stopPropagationCallback );
+					}
+
+					jQuery.event.triggered = undefined;
+
+					if ( tmp ) {
+						elem[ ontype ] = tmp;
+					}
+				}
+			}
+		}
+
+		return event.result;
+	},
+
+	// Piggyback on a donor event to simulate a different one
+	// Used only for `focus(in | out)` events
+	simulate: function( type, elem, event ) {
+		var e = jQuery.extend(
+			new jQuery.Event(),
+			event,
+			{
+				type: type,
+				isSimulated: true
+			}
+		);
+
+		jQuery.event.trigger( e, null, elem );
+	}
+
+} );
+
+jQuery.fn.extend( {
+
+	trigger: function( type, data ) {
+		return this.each( function() {
+			jQuery.event.trigger( type, data, this );
+		} );
+	},
+	triggerHandler: function( type, data ) {
+		var elem = this[ 0 ];
+		if ( elem ) {
+			return jQuery.event.trigger( type, data, elem, true );
+		}
+	}
+} );
+
+
+// Support: Firefox <=44
+// Firefox doesn't have focus(in | out) events
+// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787
+//
+// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1
+// focus(in | out) events fire after focus & blur events,
+// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order
+// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857
+if ( !support.focusin ) {
+	jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) {
+
+		// Attach a single capturing handler on the document while someone wants focusin/focusout
+		var handler = function( event ) {
+			jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) );
+		};
+
+		jQuery.event.special[ fix ] = {
+			setup: function() {
+
+				// Handle: regular nodes (via `this.ownerDocument`), window
+				// (via `this.document`) & document (via `this`).
+				var doc = this.ownerDocument || this.document || this,
+					attaches = dataPriv.access( doc, fix );
+
+				if ( !attaches ) {
+					doc.addEventListener( orig, handler, true );
+				}
+				dataPriv.access( doc, fix, ( attaches || 0 ) + 1 );
+			},
+			teardown: function() {
+				var doc = this.ownerDocument || this.document || this,
+					attaches = dataPriv.access( doc, fix ) - 1;
+
+				if ( !attaches ) {
+					doc.removeEventListener( orig, handler, true );
+					dataPriv.remove( doc, fix );
+
+				} else {
+					dataPriv.access( doc, fix, attaches );
+				}
+			}
+		};
+	} );
+}
+var location = window.location;
+
+var nonce = { guid: Date.now() };
+
+var rquery = ( /\?/ );
+
+
+
+// Cross-browser xml parsing
+jQuery.parseXML = function( data ) {
+	var xml, parserErrorElem;
+	if ( !data || typeof data !== "string" ) {
+		return null;
+	}
+
+	// Support: IE 9 - 11 only
+	// IE throws on parseFromString with invalid input.
+	try {
+		xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" );
+	} catch ( e ) {}
+
+	parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ];
+	if ( !xml || parserErrorElem ) {
+		jQuery.error( "Invalid XML: " + (
+			parserErrorElem ?
+				jQuery.map( parserErrorElem.childNodes, function( el ) {
+					return el.textContent;
+				} ).join( "\n" ) :
+				data
+		) );
+	}
+	return xml;
+};
+
+
+var
+	rbracket = /\[\]$/,
+	rCRLF = /\r?\n/g,
+	rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i,
+	rsubmittable = /^(?:input|select|textarea|keygen)/i;
+
+function buildParams( prefix, obj, traditional, add ) {
+	var name;
+
+	if ( Array.isArray( obj ) ) {
+
+		// Serialize array item.
+		jQuery.each( obj, function( i, v ) {
+			if ( traditional || rbracket.test( prefix ) ) {
+
+				// Treat each array item as a scalar.
+				add( prefix, v );
+
+			} else {
+
+				// Item is non-scalar (array or object), encode its numeric index.
+				buildParams(
+					prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]",
+					v,
+					traditional,
+					add
+				);
+			}
+		} );
+
+	} else if ( !traditional && toType( obj ) === "object" ) {
+
+		// Serialize object item.
+		for ( name in obj ) {
+			buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add );
+		}
+
+	} else {
+
+		// Serialize scalar item.
+		add( prefix, obj );
+	}
+}
+
+// Serialize an array of form elements or a set of
+// key/values into a query string
+jQuery.param = function( a, traditional ) {
+	var prefix,
+		s = [],
+		add = function( key, valueOrFunction ) {
+
+			// If value is a function, invoke it and use its return value
+			var value = isFunction( valueOrFunction ) ?
+				valueOrFunction() :
+				valueOrFunction;
+
+			s[ s.length ] = encodeURIComponent( key ) + "=" +
+				encodeURIComponent( value == null ? "" : value );
+		};
+
+	if ( a == null ) {
+		return "";
+	}
+
+	// If an array was passed in, assume that it is an array of form elements.
+	if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) {
+
+		// Serialize the form elements
+		jQuery.each( a, function() {
+			add( this.name, this.value );
+		} );
+
+	} else {
+
+		// If traditional, encode the "old" way (the way 1.3.2 or older
+		// did it), otherwise encode params recursively.
+		for ( prefix in a ) {
+			buildParams( prefix, a[ prefix ], traditional, add );
+		}
+	}
+
+	// Return the resulting serialization
+	return s.join( "&" );
+};
+
+jQuery.fn.extend( {
+	serialize: function() {
+		return jQuery.param( this.serializeArray() );
+	},
+	serializeArray: function() {
+		return this.map( function() {
+
+			// Can add propHook for "elements" to filter or add form elements
+			var elements = jQuery.prop( this, "elements" );
+			return elements ? jQuery.makeArray( elements ) : this;
+		} ).filter( function() {
+			var type = this.type;
+
+			// Use .is( ":disabled" ) so that fieldset[disabled] works
+			return this.name && !jQuery( this ).is( ":disabled" ) &&
+				rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) &&
+				( this.checked || !rcheckableType.test( type ) );
+		} ).map( function( _i, elem ) {
+			var val = jQuery( this ).val();
+
+			if ( val == null ) {
+				return null;
+			}
+
+			if ( Array.isArray( val ) ) {
+				return jQuery.map( val, function( val ) {
+					return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+				} );
+			}
+
+			return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) };
+		} ).get();
+	}
+} );
+
+
+var
+	r20 = /%20/g,
+	rhash = /#.*$/,
+	rantiCache = /([?&])_=[^&]*/,
+	rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg,
+
+	// #7653, #8125, #8152: local protocol detection
+	rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/,
+	rnoContent = /^(?:GET|HEAD)$/,
+	rprotocol = /^\/\//,
+
+	/* Prefilters
+	 * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example)
+	 * 2) These are called:
+	 *    - BEFORE asking for a transport
+	 *    - AFTER param serialization (s.data is a string if s.processData is true)
+	 * 3) key is the dataType
+	 * 4) the catchall symbol "*" can be used
+	 * 5) execution will start with transport dataType and THEN continue down to "*" if needed
+	 */
+	prefilters = {},
+
+	/* Transports bindings
+	 * 1) key is the dataType
+	 * 2) the catchall symbol "*" can be used
+	 * 3) selection will start with transport dataType and THEN go to "*" if needed
+	 */
+	transports = {},
+
+	// Avoid comment-prolog char sequence (#10098); must appease lint and evade compression
+	allTypes = "*/".concat( "*" ),
+
+	// Anchor tag for parsing the document origin
+	originAnchor = document.createElement( "a" );
+
+originAnchor.href = location.href;
+
+// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport
+function addToPrefiltersOrTransports( structure ) {
+
+	// dataTypeExpression is optional and defaults to "*"
+	return function( dataTypeExpression, func ) {
+
+		if ( typeof dataTypeExpression !== "string" ) {
+			func = dataTypeExpression;
+			dataTypeExpression = "*";
+		}
+
+		var dataType,
+			i = 0,
+			dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || [];
+
+		if ( isFunction( func ) ) {
+
+			// For each dataType in the dataTypeExpression
+			while ( ( dataType = dataTypes[ i++ ] ) ) {
+
+				// Prepend if requested
+				if ( dataType[ 0 ] === "+" ) {
+					dataType = dataType.slice( 1 ) || "*";
+					( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func );
+
+				// Otherwise append
+				} else {
+					( structure[ dataType ] = structure[ dataType ] || [] ).push( func );
+				}
+			}
+		}
+	};
+}
+
+// Base inspection function for prefilters and transports
+function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) {
+
+	var inspected = {},
+		seekingTransport = ( structure === transports );
+
+	function inspect( dataType ) {
+		var selected;
+		inspected[ dataType ] = true;
+		jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) {
+			var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR );
+			if ( typeof dataTypeOrTransport === "string" &&
+				!seekingTransport && !inspected[ dataTypeOrTransport ] ) {
+
+				options.dataTypes.unshift( dataTypeOrTransport );
+				inspect( dataTypeOrTransport );
+				return false;
+			} else if ( seekingTransport ) {
+				return !( selected = dataTypeOrTransport );
+			}
+		} );
+		return selected;
+	}
+
+	return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" );
+}
+
+// A special extend for ajax options
+// that takes "flat" options (not to be deep extended)
+// Fixes #9887
+function ajaxExtend( target, src ) {
+	var key, deep,
+		flatOptions = jQuery.ajaxSettings.flatOptions || {};
+
+	for ( key in src ) {
+		if ( src[ key ] !== undefined ) {
+			( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ];
+		}
+	}
+	if ( deep ) {
+		jQuery.extend( true, target, deep );
+	}
+
+	return target;
+}
+
+/* Handles responses to an ajax request:
+ * - finds the right dataType (mediates between content-type and expected dataType)
+ * - returns the corresponding response
+ */
+function ajaxHandleResponses( s, jqXHR, responses ) {
+
+	var ct, type, finalDataType, firstDataType,
+		contents = s.contents,
+		dataTypes = s.dataTypes;
+
+	// Remove auto dataType and get content-type in the process
+	while ( dataTypes[ 0 ] === "*" ) {
+		dataTypes.shift();
+		if ( ct === undefined ) {
+			ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" );
+		}
+	}
+
+	// Check if we're dealing with a known content-type
+	if ( ct ) {
+		for ( type in contents ) {
+			if ( contents[ type ] && contents[ type ].test( ct ) ) {
+				dataTypes.unshift( type );
+				break;
+			}
+		}
+	}
+
+	// Check to see if we have a response for the expected dataType
+	if ( dataTypes[ 0 ] in responses ) {
+		finalDataType = dataTypes[ 0 ];
+	} else {
+
+		// Try convertible dataTypes
+		for ( type in responses ) {
+			if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) {
+				finalDataType = type;
+				break;
+			}
+			if ( !firstDataType ) {
+				firstDataType = type;
+			}
+		}
+
+		// Or just use first one
+		finalDataType = finalDataType || firstDataType;
+	}
+
+	// If we found a dataType
+	// We add the dataType to the list if needed
+	// and return the corresponding response
+	if ( finalDataType ) {
+		if ( finalDataType !== dataTypes[ 0 ] ) {
+			dataTypes.unshift( finalDataType );
+		}
+		return responses[ finalDataType ];
+	}
+}
+
+/* Chain conversions given the request and the original response
+ * Also sets the responseXXX fields on the jqXHR instance
+ */
+function ajaxConvert( s, response, jqXHR, isSuccess ) {
+	var conv2, current, conv, tmp, prev,
+		converters = {},
+
+		// Work with a copy of dataTypes in case we need to modify it for conversion
+		dataTypes = s.dataTypes.slice();
+
+	// Create converters map with lowercased keys
+	if ( dataTypes[ 1 ] ) {
+		for ( conv in s.converters ) {
+			converters[ conv.toLowerCase() ] = s.converters[ conv ];
+		}
+	}
+
+	current = dataTypes.shift();
+
+	// Convert to each sequential dataType
+	while ( current ) {
+
+		if ( s.responseFields[ current ] ) {
+			jqXHR[ s.responseFields[ current ] ] = response;
+		}
+
+		// Apply the dataFilter if provided
+		if ( !prev && isSuccess && s.dataFilter ) {
+			response = s.dataFilter( response, s.dataType );
+		}
+
+		prev = current;
+		current = dataTypes.shift();
+
+		if ( current ) {
+
+			// There's only work to do if current dataType is non-auto
+			if ( current === "*" ) {
+
+				current = prev;
+
+			// Convert response if prev dataType is non-auto and differs from current
+			} else if ( prev !== "*" && prev !== current ) {
+
+				// Seek a direct converter
+				conv = converters[ prev + " " + current ] || converters[ "* " + current ];
+
+				// If none found, seek a pair
+				if ( !conv ) {
+					for ( conv2 in converters ) {
+
+						// If conv2 outputs current
+						tmp = conv2.split( " " );
+						if ( tmp[ 1 ] === current ) {
+
+							// If prev can be converted to accepted input
+							conv = converters[ prev + " " + tmp[ 0 ] ] ||
+								converters[ "* " + tmp[ 0 ] ];
+							if ( conv ) {
+
+								// Condense equivalence converters
+								if ( conv === true ) {
+									conv = converters[ conv2 ];
+
+								// Otherwise, insert the intermediate dataType
+								} else if ( converters[ conv2 ] !== true ) {
+									current = tmp[ 0 ];
+									dataTypes.unshift( tmp[ 1 ] );
+								}
+								break;
+							}
+						}
+					}
+				}
+
+				// Apply converter (if not an equivalence)
+				if ( conv !== true ) {
+
+					// Unless errors are allowed to bubble, catch and return them
+					if ( conv && s.throws ) {
+						response = conv( response );
+					} else {
+						try {
+							response = conv( response );
+						} catch ( e ) {
+							return {
+								state: "parsererror",
+								error: conv ? e : "No conversion from " + prev + " to " + current
+							};
+						}
+					}
+				}
+			}
+		}
+	}
+
+	return { state: "success", data: response };
+}
+
+jQuery.extend( {
+
+	// Counter for holding the number of active queries
+	active: 0,
+
+	// Last-Modified header cache for next request
+	lastModified: {},
+	etag: {},
+
+	ajaxSettings: {
+		url: location.href,
+		type: "GET",
+		isLocal: rlocalProtocol.test( location.protocol ),
+		global: true,
+		processData: true,
+		async: true,
+		contentType: "application/x-www-form-urlencoded; charset=UTF-8",
+
+		/*
+		timeout: 0,
+		data: null,
+		dataType: null,
+		username: null,
+		password: null,
+		cache: null,
+		throws: false,
+		traditional: false,
+		headers: {},
+		*/
+
+		accepts: {
+			"*": allTypes,
+			text: "text/plain",
+			html: "text/html",
+			xml: "application/xml, text/xml",
+			json: "application/json, text/javascript"
+		},
+
+		contents: {
+			xml: /\bxml\b/,
+			html: /\bhtml/,
+			json: /\bjson\b/
+		},
+
+		responseFields: {
+			xml: "responseXML",
+			text: "responseText",
+			json: "responseJSON"
+		},
+
+		// Data converters
+		// Keys separate source (or catchall "*") and destination types with a single space
+		converters: {
+
+			// Convert anything to text
+			"* text": String,
+
+			// Text to html (true = no transformation)
+			"text html": true,
+
+			// Evaluate text as a json expression
+			"text json": JSON.parse,
+
+			// Parse text as xml
+			"text xml": jQuery.parseXML
+		},
+
+		// For options that shouldn't be deep extended:
+		// you can add your own custom options here if
+		// and when you create one that shouldn't be
+		// deep extended (see ajaxExtend)
+		flatOptions: {
+			url: true,
+			context: true
+		}
+	},
+
+	// Creates a full fledged settings object into target
+	// with both ajaxSettings and settings fields.
+	// If target is omitted, writes into ajaxSettings.
+	ajaxSetup: function( target, settings ) {
+		return settings ?
+
+			// Building a settings object
+			ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) :
+
+			// Extending ajaxSettings
+			ajaxExtend( jQuery.ajaxSettings, target );
+	},
+
+	ajaxPrefilter: addToPrefiltersOrTransports( prefilters ),
+	ajaxTransport: addToPrefiltersOrTransports( transports ),
+
+	// Main method
+	ajax: function( url, options ) {
+
+		// If url is an object, simulate pre-1.5 signature
+		if ( typeof url === "object" ) {
+			options = url;
+			url = undefined;
+		}
+
+		// Force options to be an object
+		options = options || {};
+
+		var transport,
+
+			// URL without anti-cache param
+			cacheURL,
+
+			// Response headers
+			responseHeadersString,
+			responseHeaders,
+
+			// timeout handle
+			timeoutTimer,
+
+			// Url cleanup var
+			urlAnchor,
+
+			// Request state (becomes false upon send and true upon completion)
+			completed,
+
+			// To know if global events are to be dispatched
+			fireGlobals,
+
+			// Loop variable
+			i,
+
+			// uncached part of the url
+			uncached,
+
+			// Create the final options object
+			s = jQuery.ajaxSetup( {}, options ),
+
+			// Callbacks context
+			callbackContext = s.context || s,
+
+			// Context for global events is callbackContext if it is a DOM node or jQuery collection
+			globalEventContext = s.context &&
+				( callbackContext.nodeType || callbackContext.jquery ) ?
+				jQuery( callbackContext ) :
+				jQuery.event,
+
+			// Deferreds
+			deferred = jQuery.Deferred(),
+			completeDeferred = jQuery.Callbacks( "once memory" ),
+
+			// Status-dependent callbacks
+			statusCode = s.statusCode || {},
+
+			// Headers (they are sent all at once)
+			requestHeaders = {},
+			requestHeadersNames = {},
+
+			// Default abort message
+			strAbort = "canceled",
+
+			// Fake xhr
+			jqXHR = {
+				readyState: 0,
+
+				// Builds headers hashtable if needed
+				getResponseHeader: function( key ) {
+					var match;
+					if ( completed ) {
+						if ( !responseHeaders ) {
+							responseHeaders = {};
+							while ( ( match = rheaders.exec( responseHeadersString ) ) ) {
+								responseHeaders[ match[ 1 ].toLowerCase() + " " ] =
+									( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] )
+										.concat( match[ 2 ] );
+							}
+						}
+						match = responseHeaders[ key.toLowerCase() + " " ];
+					}
+					return match == null ? null : match.join( ", " );
+				},
+
+				// Raw string
+				getAllResponseHeaders: function() {
+					return completed ? responseHeadersString : null;
+				},
+
+				// Caches the header
+				setRequestHeader: function( name, value ) {
+					if ( completed == null ) {
+						name = requestHeadersNames[ name.toLowerCase() ] =
+							requestHeadersNames[ name.toLowerCase() ] || name;
+						requestHeaders[ name ] = value;
+					}
+					return this;
+				},
+
+				// Overrides response content-type header
+				overrideMimeType: function( type ) {
+					if ( completed == null ) {
+						s.mimeType = type;
+					}
+					return this;
+				},
+
+				// Status-dependent callbacks
+				statusCode: function( map ) {
+					var code;
+					if ( map ) {
+						if ( completed ) {
+
+							// Execute the appropriate callbacks
+							jqXHR.always( map[ jqXHR.status ] );
+						} else {
+
+							// Lazy-add the new callbacks in a way that preserves old ones
+							for ( code in map ) {
+								statusCode[ code ] = [ statusCode[ code ], map[ code ] ];
+							}
+						}
+					}
+					return this;
+				},
+
+				// Cancel the request
+				abort: function( statusText ) {
+					var finalText = statusText || strAbort;
+					if ( transport ) {
+						transport.abort( finalText );
+					}
+					done( 0, finalText );
+					return this;
+				}
+			};
+
+		// Attach deferreds
+		deferred.promise( jqXHR );
+
+		// Add protocol if not provided (prefilters might expect it)
+		// Handle falsy url in the settings object (#10093: consistency with old signature)
+		// We also use the url parameter if available
+		s.url = ( ( url || s.url || location.href ) + "" )
+			.replace( rprotocol, location.protocol + "//" );
+
+		// Alias method option to type as per ticket #12004
+		s.type = options.method || options.type || s.method || s.type;
+
+		// Extract dataTypes list
+		s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ];
+
+		// A cross-domain request is in order when the origin doesn't match the current origin.
+		if ( s.crossDomain == null ) {
+			urlAnchor = document.createElement( "a" );
+
+			// Support: IE <=8 - 11, Edge 12 - 15
+			// IE throws exception on accessing the href property if url is malformed,
+			// e.g. http://example.com:80x/
+			try {
+				urlAnchor.href = s.url;
+
+				// Support: IE <=8 - 11 only
+				// Anchor's host property isn't correctly set when s.url is relative
+				urlAnchor.href = urlAnchor.href;
+				s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !==
+					urlAnchor.protocol + "//" + urlAnchor.host;
+			} catch ( e ) {
+
+				// If there is an error parsing the URL, assume it is crossDomain,
+				// it can be rejected by the transport if it is invalid
+				s.crossDomain = true;
+			}
+		}
+
+		// Convert data if not already a string
+		if ( s.data && s.processData && typeof s.data !== "string" ) {
+			s.data = jQuery.param( s.data, s.traditional );
+		}
+
+		// Apply prefilters
+		inspectPrefiltersOrTransports( prefilters, s, options, jqXHR );
+
+		// If request was aborted inside a prefilter, stop there
+		if ( completed ) {
+			return jqXHR;
+		}
+
+		// We can fire global events as of now if asked to
+		// Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118)
+		fireGlobals = jQuery.event && s.global;
+
+		// Watch for a new set of requests
+		if ( fireGlobals && jQuery.active++ === 0 ) {
+			jQuery.event.trigger( "ajaxStart" );
+		}
+
+		// Uppercase the type
+		s.type = s.type.toUpperCase();
+
+		// Determine if request has content
+		s.hasContent = !rnoContent.test( s.type );
+
+		// Save the URL in case we're toying with the If-Modified-Since
+		// and/or If-None-Match header later on
+		// Remove hash to simplify url manipulation
+		cacheURL = s.url.replace( rhash, "" );
+
+		// More options handling for requests with no content
+		if ( !s.hasContent ) {
+
+			// Remember the hash so we can put it back
+			uncached = s.url.slice( cacheURL.length );
+
+			// If data is available and should be processed, append data to url
+			if ( s.data && ( s.processData || typeof s.data === "string" ) ) {
+				cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data;
+
+				// #9682: remove data so that it's not used in an eventual retry
+				delete s.data;
+			}
+
+			// Add or update anti-cache param if needed
+			if ( s.cache === false ) {
+				cacheURL = cacheURL.replace( rantiCache, "$1" );
+				uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) +
+					uncached;
+			}
+
+			// Put hash and anti-cache on the URL that will be requested (gh-1732)
+			s.url = cacheURL + uncached;
+
+		// Change '%20' to '+' if this is encoded form body content (gh-2658)
+		} else if ( s.data && s.processData &&
+			( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) {
+			s.data = s.data.replace( r20, "+" );
+		}
+
+		// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+		if ( s.ifModified ) {
+			if ( jQuery.lastModified[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] );
+			}
+			if ( jQuery.etag[ cacheURL ] ) {
+				jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] );
+			}
+		}
+
+		// Set the correct header, if data is being sent
+		if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) {
+			jqXHR.setRequestHeader( "Content-Type", s.contentType );
+		}
+
+		// Set the Accepts header for the server, depending on the dataType
+		jqXHR.setRequestHeader(
+			"Accept",
+			s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ?
+				s.accepts[ s.dataTypes[ 0 ] ] +
+					( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) :
+				s.accepts[ "*" ]
+		);
+
+		// Check for headers option
+		for ( i in s.headers ) {
+			jqXHR.setRequestHeader( i, s.headers[ i ] );
+		}
+
+		// Allow custom headers/mimetypes and early abort
+		if ( s.beforeSend &&
+			( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) {
+
+			// Abort if not done already and return
+			return jqXHR.abort();
+		}
+
+		// Aborting is no longer a cancellation
+		strAbort = "abort";
+
+		// Install callbacks on deferreds
+		completeDeferred.add( s.complete );
+		jqXHR.done( s.success );
+		jqXHR.fail( s.error );
+
+		// Get transport
+		transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR );
+
+		// If no transport, we auto-abort
+		if ( !transport ) {
+			done( -1, "No Transport" );
+		} else {
+			jqXHR.readyState = 1;
+
+			// Send global event
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] );
+			}
+
+			// If request was aborted inside ajaxSend, stop there
+			if ( completed ) {
+				return jqXHR;
+			}
+
+			// Timeout
+			if ( s.async && s.timeout > 0 ) {
+				timeoutTimer = window.setTimeout( function() {
+					jqXHR.abort( "timeout" );
+				}, s.timeout );
+			}
+
+			try {
+				completed = false;
+				transport.send( requestHeaders, done );
+			} catch ( e ) {
+
+				// Rethrow post-completion exceptions
+				if ( completed ) {
+					throw e;
+				}
+
+				// Propagate others as results
+				done( -1, e );
+			}
+		}
+
+		// Callback for when everything is done
+		function done( status, nativeStatusText, responses, headers ) {
+			var isSuccess, success, error, response, modified,
+				statusText = nativeStatusText;
+
+			// Ignore repeat invocations
+			if ( completed ) {
+				return;
+			}
+
+			completed = true;
+
+			// Clear timeout if it exists
+			if ( timeoutTimer ) {
+				window.clearTimeout( timeoutTimer );
+			}
+
+			// Dereference transport for early garbage collection
+			// (no matter how long the jqXHR object will be used)
+			transport = undefined;
+
+			// Cache response headers
+			responseHeadersString = headers || "";
+
+			// Set readyState
+			jqXHR.readyState = status > 0 ? 4 : 0;
+
+			// Determine if successful
+			isSuccess = status >= 200 && status < 300 || status === 304;
+
+			// Get response data
+			if ( responses ) {
+				response = ajaxHandleResponses( s, jqXHR, responses );
+			}
+
+			// Use a noop converter for missing script but not if jsonp
+			if ( !isSuccess &&
+				jQuery.inArray( "script", s.dataTypes ) > -1 &&
+				jQuery.inArray( "json", s.dataTypes ) < 0 ) {
+				s.converters[ "text script" ] = function() {};
+			}
+
+			// Convert no matter what (that way responseXXX fields are always set)
+			response = ajaxConvert( s, response, jqXHR, isSuccess );
+
+			// If successful, handle type chaining
+			if ( isSuccess ) {
+
+				// Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode.
+				if ( s.ifModified ) {
+					modified = jqXHR.getResponseHeader( "Last-Modified" );
+					if ( modified ) {
+						jQuery.lastModified[ cacheURL ] = modified;
+					}
+					modified = jqXHR.getResponseHeader( "etag" );
+					if ( modified ) {
+						jQuery.etag[ cacheURL ] = modified;
+					}
+				}
+
+				// if no content
+				if ( status === 204 || s.type === "HEAD" ) {
+					statusText = "nocontent";
+
+				// if not modified
+				} else if ( status === 304 ) {
+					statusText = "notmodified";
+
+				// If we have data, let's convert it
+				} else {
+					statusText = response.state;
+					success = response.data;
+					error = response.error;
+					isSuccess = !error;
+				}
+			} else {
+
+				// Extract error from statusText and normalize for non-aborts
+				error = statusText;
+				if ( status || !statusText ) {
+					statusText = "error";
+					if ( status < 0 ) {
+						status = 0;
+					}
+				}
+			}
+
+			// Set data for the fake xhr object
+			jqXHR.status = status;
+			jqXHR.statusText = ( nativeStatusText || statusText ) + "";
+
+			// Success/Error
+			if ( isSuccess ) {
+				deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] );
+			} else {
+				deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] );
+			}
+
+			// Status-dependent callbacks
+			jqXHR.statusCode( statusCode );
+			statusCode = undefined;
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError",
+					[ jqXHR, s, isSuccess ? success : error ] );
+			}
+
+			// Complete
+			completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] );
+
+			if ( fireGlobals ) {
+				globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] );
+
+				// Handle the global AJAX counter
+				if ( !( --jQuery.active ) ) {
+					jQuery.event.trigger( "ajaxStop" );
+				}
+			}
+		}
+
+		return jqXHR;
+	},
+
+	getJSON: function( url, data, callback ) {
+		return jQuery.get( url, data, callback, "json" );
+	},
+
+	getScript: function( url, callback ) {
+		return jQuery.get( url, undefined, callback, "script" );
+	}
+} );
+
+jQuery.each( [ "get", "post" ], function( _i, method ) {
+	jQuery[ method ] = function( url, data, callback, type ) {
+
+		// Shift arguments if data argument was omitted
+		if ( isFunction( data ) ) {
+			type = type || callback;
+			callback = data;
+			data = undefined;
+		}
+
+		// The url can be an options object (which then must have .url)
+		return jQuery.ajax( jQuery.extend( {
+			url: url,
+			type: method,
+			dataType: type,
+			data: data,
+			success: callback
+		}, jQuery.isPlainObject( url ) && url ) );
+	};
+} );
+
+jQuery.ajaxPrefilter( function( s ) {
+	var i;
+	for ( i in s.headers ) {
+		if ( i.toLowerCase() === "content-type" ) {
+			s.contentType = s.headers[ i ] || "";
+		}
+	}
+} );
+
+
+jQuery._evalUrl = function( url, options, doc ) {
+	return jQuery.ajax( {
+		url: url,
+
+		// Make this explicit, since user can override this through ajaxSetup (#11264)
+		type: "GET",
+		dataType: "script",
+		cache: true,
+		async: false,
+		global: false,
+
+		// Only evaluate the response if it is successful (gh-4126)
+		// dataFilter is not invoked for failure responses, so using it instead
+		// of the default converter is kludgy but it works.
+		converters: {
+			"text script": function() {}
+		},
+		dataFilter: function( response ) {
+			jQuery.globalEval( response, options, doc );
+		}
+	} );
+};
+
+
+jQuery.fn.extend( {
+	wrapAll: function( html ) {
+		var wrap;
+
+		if ( this[ 0 ] ) {
+			if ( isFunction( html ) ) {
+				html = html.call( this[ 0 ] );
+			}
+
+			// The elements to wrap the target around
+			wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true );
+
+			if ( this[ 0 ].parentNode ) {
+				wrap.insertBefore( this[ 0 ] );
+			}
+
+			wrap.map( function() {
+				var elem = this;
+
+				while ( elem.firstElementChild ) {
+					elem = elem.firstElementChild;
+				}
+
+				return elem;
+			} ).append( this );
+		}
+
+		return this;
+	},
+
+	wrapInner: function( html ) {
+		if ( isFunction( html ) ) {
+			return this.each( function( i ) {
+				jQuery( this ).wrapInner( html.call( this, i ) );
+			} );
+		}
+
+		return this.each( function() {
+			var self = jQuery( this ),
+				contents = self.contents();
+
+			if ( contents.length ) {
+				contents.wrapAll( html );
+
+			} else {
+				self.append( html );
+			}
+		} );
+	},
+
+	wrap: function( html ) {
+		var htmlIsFunction = isFunction( html );
+
+		return this.each( function( i ) {
+			jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html );
+		} );
+	},
+
+	unwrap: function( selector ) {
+		this.parent( selector ).not( "body" ).each( function() {
+			jQuery( this ).replaceWith( this.childNodes );
+		} );
+		return this;
+	}
+} );
+
+
+jQuery.expr.pseudos.hidden = function( elem ) {
+	return !jQuery.expr.pseudos.visible( elem );
+};
+jQuery.expr.pseudos.visible = function( elem ) {
+	return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length );
+};
+
+
+
+
+jQuery.ajaxSettings.xhr = function() {
+	try {
+		return new window.XMLHttpRequest();
+	} catch ( e ) {}
+};
+
+var xhrSuccessStatus = {
+
+		// File protocol always yields status code 0, assume 200
+		0: 200,
+
+		// Support: IE <=9 only
+		// #1450: sometimes IE returns 1223 when it should be 204
+		1223: 204
+	},
+	xhrSupported = jQuery.ajaxSettings.xhr();
+
+support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported );
+support.ajax = xhrSupported = !!xhrSupported;
+
+jQuery.ajaxTransport( function( options ) {
+	var callback, errorCallback;
+
+	// Cross domain only allowed if supported through XMLHttpRequest
+	if ( support.cors || xhrSupported && !options.crossDomain ) {
+		return {
+			send: function( headers, complete ) {
+				var i,
+					xhr = options.xhr();
+
+				xhr.open(
+					options.type,
+					options.url,
+					options.async,
+					options.username,
+					options.password
+				);
+
+				// Apply custom fields if provided
+				if ( options.xhrFields ) {
+					for ( i in options.xhrFields ) {
+						xhr[ i ] = options.xhrFields[ i ];
+					}
+				}
+
+				// Override mime type if needed
+				if ( options.mimeType && xhr.overrideMimeType ) {
+					xhr.overrideMimeType( options.mimeType );
+				}
+
+				// X-Requested-With header
+				// For cross-domain requests, seeing as conditions for a preflight are
+				// akin to a jigsaw puzzle, we simply never set it to be sure.
+				// (it can always be set on a per-request basis or even using ajaxSetup)
+				// For same-domain requests, won't change header if already provided.
+				if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) {
+					headers[ "X-Requested-With" ] = "XMLHttpRequest";
+				}
+
+				// Set headers
+				for ( i in headers ) {
+					xhr.setRequestHeader( i, headers[ i ] );
+				}
+
+				// Callback
+				callback = function( type ) {
+					return function() {
+						if ( callback ) {
+							callback = errorCallback = xhr.onload =
+								xhr.onerror = xhr.onabort = xhr.ontimeout =
+									xhr.onreadystatechange = null;
+
+							if ( type === "abort" ) {
+								xhr.abort();
+							} else if ( type === "error" ) {
+
+								// Support: IE <=9 only
+								// On a manual native abort, IE9 throws
+								// errors on any property access that is not readyState
+								if ( typeof xhr.status !== "number" ) {
+									complete( 0, "error" );
+								} else {
+									complete(
+
+										// File: protocol always yields status 0; see #8605, #14207
+										xhr.status,
+										xhr.statusText
+									);
+								}
+							} else {
+								complete(
+									xhrSuccessStatus[ xhr.status ] || xhr.status,
+									xhr.statusText,
+
+									// Support: IE <=9 only
+									// IE9 has no XHR2 but throws on binary (trac-11426)
+									// For XHR2 non-text, let the caller handle it (gh-2498)
+									( xhr.responseType || "text" ) !== "text"  ||
+									typeof xhr.responseText !== "string" ?
+										{ binary: xhr.response } :
+										{ text: xhr.responseText },
+									xhr.getAllResponseHeaders()
+								);
+							}
+						}
+					};
+				};
+
+				// Listen to events
+				xhr.onload = callback();
+				errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" );
+
+				// Support: IE 9 only
+				// Use onreadystatechange to replace onabort
+				// to handle uncaught aborts
+				if ( xhr.onabort !== undefined ) {
+					xhr.onabort = errorCallback;
+				} else {
+					xhr.onreadystatechange = function() {
+
+						// Check readyState before timeout as it changes
+						if ( xhr.readyState === 4 ) {
+
+							// Allow onerror to be called first,
+							// but that will not handle a native abort
+							// Also, save errorCallback to a variable
+							// as xhr.onerror cannot be accessed
+							window.setTimeout( function() {
+								if ( callback ) {
+									errorCallback();
+								}
+							} );
+						}
+					};
+				}
+
+				// Create the abort callback
+				callback = callback( "abort" );
+
+				try {
+
+					// Do send the request (this may raise an exception)
+					xhr.send( options.hasContent && options.data || null );
+				} catch ( e ) {
+
+					// #14683: Only rethrow if this hasn't been notified as an error yet
+					if ( callback ) {
+						throw e;
+					}
+				}
+			},
+
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432)
+jQuery.ajaxPrefilter( function( s ) {
+	if ( s.crossDomain ) {
+		s.contents.script = false;
+	}
+} );
+
+// Install script dataType
+jQuery.ajaxSetup( {
+	accepts: {
+		script: "text/javascript, application/javascript, " +
+			"application/ecmascript, application/x-ecmascript"
+	},
+	contents: {
+		script: /\b(?:java|ecma)script\b/
+	},
+	converters: {
+		"text script": function( text ) {
+			jQuery.globalEval( text );
+			return text;
+		}
+	}
+} );
+
+// Handle cache's special case and crossDomain
+jQuery.ajaxPrefilter( "script", function( s ) {
+	if ( s.cache === undefined ) {
+		s.cache = false;
+	}
+	if ( s.crossDomain ) {
+		s.type = "GET";
+	}
+} );
+
+// Bind script tag hack transport
+jQuery.ajaxTransport( "script", function( s ) {
+
+	// This transport only deals with cross domain or forced-by-attrs requests
+	if ( s.crossDomain || s.scriptAttrs ) {
+		var script, callback;
+		return {
+			send: function( _, complete ) {
+				script = jQuery( "<script>" )
+					.attr( s.scriptAttrs || {} )
+					.prop( { charset: s.scriptCharset, src: s.url } )
+					.on( "load error", callback = function( evt ) {
+						script.remove();
+						callback = null;
+						if ( evt ) {
+							complete( evt.type === "error" ? 404 : 200, evt.type );
+						}
+					} );
+
+				// Use native DOM manipulation to avoid our domManip AJAX trickery
+				document.head.appendChild( script[ 0 ] );
+			},
+			abort: function() {
+				if ( callback ) {
+					callback();
+				}
+			}
+		};
+	}
+} );
+
+
+
+
+var oldCallbacks = [],
+	rjsonp = /(=)\?(?=&|$)|\?\?/;
+
+// Default jsonp settings
+jQuery.ajaxSetup( {
+	jsonp: "callback",
+	jsonpCallback: function() {
+		var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( nonce.guid++ ) );
+		this[ callback ] = true;
+		return callback;
+	}
+} );
+
+// Detect, normalize options and install callbacks for jsonp requests
+jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) {
+
+	var callbackName, overwritten, responseContainer,
+		jsonProp = s.jsonp !== false && ( rjsonp.test( s.url ) ?
+			"url" :
+			typeof s.data === "string" &&
+				( s.contentType || "" )
+					.indexOf( "application/x-www-form-urlencoded" ) === 0 &&
+				rjsonp.test( s.data ) && "data"
+		);
+
+	// Handle iff the expected data type is "jsonp" or we have a parameter to set
+	if ( jsonProp || s.dataTypes[ 0 ] === "jsonp" ) {
+
+		// Get callback name, remembering preexisting value associated with it
+		callbackName = s.jsonpCallback = isFunction( s.jsonpCallback ) ?
+			s.jsonpCallback() :
+			s.jsonpCallback;
+
+		// Insert callback into url or form data
+		if ( jsonProp ) {
+			s[ jsonProp ] = s[ jsonProp ].replace( rjsonp, "$1" + callbackName );
+		} else if ( s.jsonp !== false ) {
+			s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName;
+		}
+
+		// Use data converter to retrieve json after script execution
+		s.converters[ "script json" ] = function() {
+			if ( !responseContainer ) {
+				jQuery.error( callbackName + " was not called" );
+			}
+			return responseContainer[ 0 ];
+		};
+
+		// Force json dataType
+		s.dataTypes[ 0 ] = "json";
+
+		// Install callback
+		overwritten = window[ callbackName ];
+		window[ callbackName ] = function() {
+			responseContainer = arguments;
+		};
+
+		// Clean-up function (fires after converters)
+		jqXHR.always( function() {
+
+			// If previous value didn't exist - remove it
+			if ( overwritten === undefined ) {
+				jQuery( window ).removeProp( callbackName );
+
+			// Otherwise restore preexisting value
+			} else {
+				window[ callbackName ] = overwritten;
+			}
+
+			// Save back as free
+			if ( s[ callbackName ] ) {
+
+				// Make sure that re-using the options doesn't screw things around
+				s.jsonpCallback = originalSettings.jsonpCallback;
+
+				// Save the callback name for future use
+				oldCallbacks.push( callbackName );
+			}
+
+			// Call if it was a function and we have a response
+			if ( responseContainer && isFunction( overwritten ) ) {
+				overwritten( responseContainer[ 0 ] );
+			}
+
+			responseContainer = overwritten = undefined;
+		} );
+
+		// Delegate to script
+		return "script";
+	}
+} );
+
+
+
+
+// Support: Safari 8 only
+// In Safari 8 documents created via document.implementation.createHTMLDocument
+// collapse sibling forms: the second one becomes a child of the first one.
+// Because of that, this security measure has to be disabled in Safari 8.
+// https://bugs.webkit.org/show_bug.cgi?id=137337
+support.createHTMLDocument = ( function() {
+	var body = document.implementation.createHTMLDocument( "" ).body;
+	body.innerHTML = "<form></form><form></form>";
+	return body.childNodes.length === 2;
+} )();
+
+
+// Argument "data" should be string of html
+// context (optional): If specified, the fragment will be created in this context,
+// defaults to document
+// keepScripts (optional): If true, will include scripts passed in the html string
+jQuery.parseHTML = function( data, context, keepScripts ) {
+	if ( typeof data !== "string" ) {
+		return [];
+	}
+	if ( typeof context === "boolean" ) {
+		keepScripts = context;
+		context = false;
+	}
+
+	var base, parsed, scripts;
+
+	if ( !context ) {
+
+		// Stop scripts or inline event handlers from being executed immediately
+		// by using document.implementation
+		if ( support.createHTMLDocument ) {
+			context = document.implementation.createHTMLDocument( "" );
+
+			// Set the base href for the created document
+			// so any parsed elements with URLs
+			// are based on the document's URL (gh-2965)
+			base = context.createElement( "base" );
+			base.href = document.location.href;
+			context.head.appendChild( base );
+		} else {
+			context = document;
+		}
+	}
+
+	parsed = rsingleTag.exec( data );
+	scripts = !keepScripts && [];
+
+	// Single tag
+	if ( parsed ) {
+		return [ context.createElement( parsed[ 1 ] ) ];
+	}
+
+	parsed = buildFragment( [ data ], context, scripts );
+
+	if ( scripts && scripts.length ) {
+		jQuery( scripts ).remove();
+	}
+
+	return jQuery.merge( [], parsed.childNodes );
+};
+
+
+/**
+ * Load a url into a page
+ */
+jQuery.fn.load = function( url, params, callback ) {
+	var selector, type, response,
+		self = this,
+		off = url.indexOf( " " );
+
+	if ( off > -1 ) {
+		selector = stripAndCollapse( url.slice( off ) );
+		url = url.slice( 0, off );
+	}
+
+	// If it's a function
+	if ( isFunction( params ) ) {
+
+		// We assume that it's the callback
+		callback = params;
+		params = undefined;
+
+	// Otherwise, build a param string
+	} else if ( params && typeof params === "object" ) {
+		type = "POST";
+	}
+
+	// If we have elements to modify, make the request
+	if ( self.length > 0 ) {
+		jQuery.ajax( {
+			url: url,
+
+			// If "type" variable is undefined, then "GET" method will be used.
+			// Make value of this field explicit since
+			// user can override it through ajaxSetup method
+			type: type || "GET",
+			dataType: "html",
+			data: params
+		} ).done( function( responseText ) {
+
+			// Save response for use in complete callback
+			response = arguments;
+
+			self.html( selector ?
+
+				// If a selector was specified, locate the right elements in a dummy div
+				// Exclude scripts to avoid IE 'Permission Denied' errors
+				jQuery( "<div>" ).append( jQuery.parseHTML( responseText ) ).find( selector ) :
+
+				// Otherwise use the full result
+				responseText );
+
+		// If the request succeeds, this function gets "data", "status", "jqXHR"
+		// but they are ignored because response was set above.
+		// If it fails, this function gets "jqXHR", "status", "error"
+		} ).always( callback && function( jqXHR, status ) {
+			self.each( function() {
+				callback.apply( this, response || [ jqXHR.responseText, status, jqXHR ] );
+			} );
+		} );
+	}
+
+	return this;
+};
+
+
+
+
+jQuery.expr.pseudos.animated = function( elem ) {
+	return jQuery.grep( jQuery.timers, function( fn ) {
+		return elem === fn.elem;
+	} ).length;
+};
+
+
+
+
+jQuery.offset = {
+	setOffset: function( elem, options, i ) {
+		var curPosition, curLeft, curCSSTop, curTop, curOffset, curCSSLeft, calculatePosition,
+			position = jQuery.css( elem, "position" ),
+			curElem = jQuery( elem ),
+			props = {};
+
+		// Set position first, in-case top/left are set even on static elem
+		if ( position === "static" ) {
+			elem.style.position = "relative";
+		}
+
+		curOffset = curElem.offset();
+		curCSSTop = jQuery.css( elem, "top" );
+		curCSSLeft = jQuery.css( elem, "left" );
+		calculatePosition = ( position === "absolute" || position === "fixed" ) &&
+			( curCSSTop + curCSSLeft ).indexOf( "auto" ) > -1;
+
+		// Need to be able to calculate position if either
+		// top or left is auto and position is either absolute or fixed
+		if ( calculatePosition ) {
+			curPosition = curElem.position();
+			curTop = curPosition.top;
+			curLeft = curPosition.left;
+
+		} else {
+			curTop = parseFloat( curCSSTop ) || 0;
+			curLeft = parseFloat( curCSSLeft ) || 0;
+		}
+
+		if ( isFunction( options ) ) {
+
+			// Use jQuery.extend here to allow modification of coordinates argument (gh-1848)
+			options = options.call( elem, i, jQuery.extend( {}, curOffset ) );
+		}
+
+		if ( options.top != null ) {
+			props.top = ( options.top - curOffset.top ) + curTop;
+		}
+		if ( options.left != null ) {
+			props.left = ( options.left - curOffset.left ) + curLeft;
+		}
+
+		if ( "using" in options ) {
+			options.using.call( elem, props );
+
+		} else {
+			curElem.css( props );
+		}
+	}
+};
+
+jQuery.fn.extend( {
+
+	// offset() relates an element's border box to the document origin
+	offset: function( options ) {
+
+		// Preserve chaining for setter
+		if ( arguments.length ) {
+			return options === undefined ?
+				this :
+				this.each( function( i ) {
+					jQuery.offset.setOffset( this, options, i );
+				} );
+		}
+
+		var rect, win,
+			elem = this[ 0 ];
+
+		if ( !elem ) {
+			return;
+		}
+
+		// Return zeros for disconnected and hidden (display: none) elements (gh-2310)
+		// Support: IE <=11 only
+		// Running getBoundingClientRect on a
+		// disconnected node in IE throws an error
+		if ( !elem.getClientRects().length ) {
+			return { top: 0, left: 0 };
+		}
+
+		// Get document-relative position by adding viewport scroll to viewport-relative gBCR
+		rect = elem.getBoundingClientRect();
+		win = elem.ownerDocument.defaultView;
+		return {
+			top: rect.top + win.pageYOffset,
+			left: rect.left + win.pageXOffset
+		};
+	},
+
+	// position() relates an element's margin box to its offset parent's padding box
+	// This corresponds to the behavior of CSS absolute positioning
+	position: function() {
+		if ( !this[ 0 ] ) {
+			return;
+		}
+
+		var offsetParent, offset, doc,
+			elem = this[ 0 ],
+			parentOffset = { top: 0, left: 0 };
+
+		// position:fixed elements are offset from the viewport, which itself always has zero offset
+		if ( jQuery.css( elem, "position" ) === "fixed" ) {
+
+			// Assume position:fixed implies availability of getBoundingClientRect
+			offset = elem.getBoundingClientRect();
+
+		} else {
+			offset = this.offset();
+
+			// Account for the *real* offset parent, which can be the document or its root element
+			// when a statically positioned element is identified
+			doc = elem.ownerDocument;
+			offsetParent = elem.offsetParent || doc.documentElement;
+			while ( offsetParent &&
+				( offsetParent === doc.body || offsetParent === doc.documentElement ) &&
+				jQuery.css( offsetParent, "position" ) === "static" ) {
+
+				offsetParent = offsetParent.parentNode;
+			}
+			if ( offsetParent && offsetParent !== elem && offsetParent.nodeType === 1 ) {
+
+				// Incorporate borders into its offset, since they are outside its content origin
+				parentOffset = jQuery( offsetParent ).offset();
+				parentOffset.top += jQuery.css( offsetParent, "borderTopWidth", true );
+				parentOffset.left += jQuery.css( offsetParent, "borderLeftWidth", true );
+			}
+		}
+
+		// Subtract parent offsets and element margins
+		return {
+			top: offset.top - parentOffset.top - jQuery.css( elem, "marginTop", true ),
+			left: offset.left - parentOffset.left - jQuery.css( elem, "marginLeft", true )
+		};
+	},
+
+	// This method will return documentElement in the following cases:
+	// 1) For the element inside the iframe without offsetParent, this method will return
+	//    documentElement of the parent window
+	// 2) For the hidden or detached element
+	// 3) For body or html element, i.e. in case of the html node - it will return itself
+	//
+	// but those exceptions were never presented as a real life use-cases
+	// and might be considered as more preferable results.
+	//
+	// This logic, however, is not guaranteed and can change at any point in the future
+	offsetParent: function() {
+		return this.map( function() {
+			var offsetParent = this.offsetParent;
+
+			while ( offsetParent && jQuery.css( offsetParent, "position" ) === "static" ) {
+				offsetParent = offsetParent.offsetParent;
+			}
+
+			return offsetParent || documentElement;
+		} );
+	}
+} );
+
+// Create scrollLeft and scrollTop methods
+jQuery.each( { scrollLeft: "pageXOffset", scrollTop: "pageYOffset" }, function( method, prop ) {
+	var top = "pageYOffset" === prop;
+
+	jQuery.fn[ method ] = function( val ) {
+		return access( this, function( elem, method, val ) {
+
+			// Coalesce documents and windows
+			var win;
+			if ( isWindow( elem ) ) {
+				win = elem;
+			} else if ( elem.nodeType === 9 ) {
+				win = elem.defaultView;
+			}
+
+			if ( val === undefined ) {
+				return win ? win[ prop ] : elem[ method ];
+			}
+
+			if ( win ) {
+				win.scrollTo(
+					!top ? val : win.pageXOffset,
+					top ? val : win.pageYOffset
+				);
+
+			} else {
+				elem[ method ] = val;
+			}
+		}, method, val, arguments.length );
+	};
+} );
+
+// Support: Safari <=7 - 9.1, Chrome <=37 - 49
+// Add the top/left cssHooks using jQuery.fn.position
+// Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084
+// Blink bug: https://bugs.chromium.org/p/chromium/issues/detail?id=589347
+// getComputedStyle returns percent when specified for top/left/bottom/right;
+// rather than make the css module depend on the offset module, just check for it here
+jQuery.each( [ "top", "left" ], function( _i, prop ) {
+	jQuery.cssHooks[ prop ] = addGetHookIf( support.pixelPosition,
+		function( elem, computed ) {
+			if ( computed ) {
+				computed = curCSS( elem, prop );
+
+				// If curCSS returns percentage, fallback to offset
+				return rnumnonpx.test( computed ) ?
+					jQuery( elem ).position()[ prop ] + "px" :
+					computed;
+			}
+		}
+	);
+} );
+
+
+// Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods
+jQuery.each( { Height: "height", Width: "width" }, function( name, type ) {
+	jQuery.each( {
+		padding: "inner" + name,
+		content: type,
+		"": "outer" + name
+	}, function( defaultExtra, funcName ) {
+
+		// Margin is only for outerHeight, outerWidth
+		jQuery.fn[ funcName ] = function( margin, value ) {
+			var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ),
+				extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" );
+
+			return access( this, function( elem, type, value ) {
+				var doc;
+
+				if ( isWindow( elem ) ) {
+
+					// $( window ).outerWidth/Height return w/h including scrollbars (gh-1729)
+					return funcName.indexOf( "outer" ) === 0 ?
+						elem[ "inner" + name ] :
+						elem.document.documentElement[ "client" + name ];
+				}
+
+				// Get document width or height
+				if ( elem.nodeType === 9 ) {
+					doc = elem.documentElement;
+
+					// Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height],
+					// whichever is greatest
+					return Math.max(
+						elem.body[ "scroll" + name ], doc[ "scroll" + name ],
+						elem.body[ "offset" + name ], doc[ "offset" + name ],
+						doc[ "client" + name ]
+					);
+				}
+
+				return value === undefined ?
+
+					// Get width or height on the element, requesting but not forcing parseFloat
+					jQuery.css( elem, type, extra ) :
+
+					// Set width or height on the element
+					jQuery.style( elem, type, value, extra );
+			}, type, chainable ? margin : undefined, chainable );
+		};
+	} );
+} );
+
+
+jQuery.each( [
+	"ajaxStart",
+	"ajaxStop",
+	"ajaxComplete",
+	"ajaxError",
+	"ajaxSuccess",
+	"ajaxSend"
+], function( _i, type ) {
+	jQuery.fn[ type ] = function( fn ) {
+		return this.on( type, fn );
+	};
+} );
+
+
+
+
+jQuery.fn.extend( {
+
+	bind: function( types, data, fn ) {
+		return this.on( types, null, data, fn );
+	},
+	unbind: function( types, fn ) {
+		return this.off( types, null, fn );
+	},
+
+	delegate: function( selector, types, data, fn ) {
+		return this.on( types, selector, data, fn );
+	},
+	undelegate: function( selector, types, fn ) {
+
+		// ( namespace ) or ( selector, types [, fn] )
+		return arguments.length === 1 ?
+			this.off( selector, "**" ) :
+			this.off( types, selector || "**", fn );
+	},
+
+	hover: function( fnOver, fnOut ) {
+		return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver );
+	}
+} );
+
+jQuery.each(
+	( "blur focus focusin focusout resize scroll click dblclick " +
+	"mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " +
+	"change select submit keydown keypress keyup contextmenu" ).split( " " ),
+	function( _i, name ) {
+
+		// Handle event binding
+		jQuery.fn[ name ] = function( data, fn ) {
+			return arguments.length > 0 ?
+				this.on( name, null, data, fn ) :
+				this.trigger( name );
+		};
+	}
+);
+
+
+
+
+// Support: Android <=4.0 only
+// Make sure we trim BOM and NBSP
+var rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;
+
+// Bind a function to a context, optionally partially applying any
+// arguments.
+// jQuery.proxy is deprecated to promote standards (specifically Function#bind)
+// However, it is not slated for removal any time soon
+jQuery.proxy = function( fn, context ) {
+	var tmp, args, proxy;
+
+	if ( typeof context === "string" ) {
+		tmp = fn[ context ];
+		context = fn;
+		fn = tmp;
+	}
+
+	// Quick check to determine if target is callable, in the spec
+	// this throws a TypeError, but we will just return undefined.
+	if ( !isFunction( fn ) ) {
+		return undefined;
+	}
+
+	// Simulated bind
+	args = slice.call( arguments, 2 );
+	proxy = function() {
+		return fn.apply( context || this, args.concat( slice.call( arguments ) ) );
+	};
+
+	// Set the guid of unique handler to the same of original handler, so it can be removed
+	proxy.guid = fn.guid = fn.guid || jQuery.guid++;
+
+	return proxy;
+};
+
+jQuery.holdReady = function( hold ) {
+	if ( hold ) {
+		jQuery.readyWait++;
+	} else {
+		jQuery.ready( true );
+	}
+};
+jQuery.isArray = Array.isArray;
+jQuery.parseJSON = JSON.parse;
+jQuery.nodeName = nodeName;
+jQuery.isFunction = isFunction;
+jQuery.isWindow = isWindow;
+jQuery.camelCase = camelCase;
+jQuery.type = toType;
+
+jQuery.now = Date.now;
+
+jQuery.isNumeric = function( obj ) {
+
+	// As of jQuery 3.0, isNumeric is limited to
+	// strings and numbers (primitives or objects)
+	// that can be coerced to finite numbers (gh-2662)
+	var type = jQuery.type( obj );
+	return ( type === "number" || type === "string" ) &&
+
+		// parseFloat NaNs numeric-cast false positives ("")
+		// ...but misinterprets leading-number strings, particularly hex literals ("0x...")
+		// subtraction forces infinities to NaN
+		!isNaN( obj - parseFloat( obj ) );
+};
+
+jQuery.trim = function( text ) {
+	return text == null ?
+		"" :
+		( text + "" ).replace( rtrim, "" );
+};
+
+
+
+// Register as a named AMD module, since jQuery can be concatenated with other
+// files that may use define, but not via a proper concatenation script that
+// understands anonymous AMD modules. A named AMD is safest and most robust
+// way to register. Lowercase jquery is used because AMD module names are
+// derived from file names, and jQuery is normally delivered in a lowercase
+// file name. Do this after creating the global so that if an AMD module wants
+// to call noConflict to hide this version of jQuery, it will work.
+
+// Note that for maximum portability, libraries that are not jQuery should
+// declare themselves as anonymous modules, and avoid setting a global if an
+// AMD loader is present. jQuery is a special case. For more information, see
+// https://github.com/jrburke/requirejs/wiki/Updating-existing-libraries#wiki-anon
+
+if ( typeof define === "function" && define.amd ) {
+	define( "jquery", [], function() {
+		return jQuery;
+	} );
+}
+
+
+
+
+var
+
+	// Map over jQuery in case of overwrite
+	_jQuery = window.jQuery,
+
+	// Map over the $ in case of overwrite
+	_$ = window.$;
+
+jQuery.noConflict = function( deep ) {
+	if ( window.$ === jQuery ) {
+		window.$ = _$;
+	}
+
+	if ( deep && window.jQuery === jQuery ) {
+		window.jQuery = _jQuery;
+	}
+
+	return jQuery;
+};
+
+// Expose jQuery and $ identifiers, even in AMD
+// (#7102#comment:10, https://github.com/jquery/jquery/pull/557)
+// and CommonJS for browser emulators (#13566)
+if ( typeof noGlobal === "undefined" ) {
+	window.jQuery = window.$ = jQuery;
+}
+
+
+
+
+return jQuery;
+} );
diff --git a/pr-2241/_static/jquery.js b/pr-2241/_static/jquery.js
new file mode 100644
index 0000000000..c4c6022f29
--- /dev/null
+++ b/pr-2241/_static/jquery.js
@@ -0,0 +1,2 @@
+/*! jQuery v3.6.0 | (c) OpenJS Foundation and other contributors | jquery.org/license */
+!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=[],r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply([],e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=t[r]||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?n[o.call(e)]||"object":typeof e}var f="3.6.0",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0<t&&t-1 in e)}S.fn=S.prototype={jquery:f,constructor:S,length:0,toArray:function(){return s.call(this)},get:function(e){return null==e?s.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=S.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return S.each(this,e)},map:function(n){return this.pushStack(S.map(this,function(e,t){return n.call(e,t,e)}))},slice:function(){return this.pushStack(s.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},even:function(){return this.pushStack(S.grep(this,function(e,t){return(t+1)%2}))},odd:function(){return this.pushStack(S.grep(this,function(e,t){return t%2}))},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(0<=n&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:u,sort:t.sort,splice:t.splice},S.extend=S.fn.extend=function(){var e,t,n,r,i,o,a=arguments[0]||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=arguments[s]||{},s++),"object"==typeof a||m(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=arguments[s]))for(t in e)r=e[t],"__proto__"!==t&&a!==r&&(l&&r&&(S.isPlainObject(r)||(i=Array.isArray(r)))?(n=a[t],o=i&&!Array.isArray(n)?[]:i||S.isPlainObject(n)?n:{},i=!1,a[t]=S.extend(l,o,r)):void 0!==r&&(a[t]=r));return a},S.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==o.call(e))&&(!(t=r(e))||"function"==typeof(n=v.call(t,"constructor")&&t.constructor)&&a.call(n)===l)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e,t,n){b(e,{nonce:t&&t.nonce},n)},each:function(e,t){var n,r=0;if(p(e)){for(n=e.length;r<n;r++)if(!1===t.call(e[r],r,e[r]))break}else for(r in e)if(!1===t.call(e[r],r,e[r]))break;return e},makeArray:function(e,t){var n=t||[];return null!=e&&(p(Object(e))?S.merge(n,"string"==typeof e?[e]:e):u.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:i.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)e[i++]=t[r];return e.length=i,e},grep:function(e,t,n){for(var r=[],i=0,o=e.length,a=!n;i<o;i++)!t(e[i],i)!==a&&r.push(e[i]);return r},map:function(e,t,n){var r,i,o=0,a=[];if(p(e))for(r=e.length;o<r;o++)null!=(i=t(e[o],o,n))&&a.push(i);else for(o in e)null!=(i=t(e[o],o,n))&&a.push(i);return g(a)},guid:1,support:y}),"function"==typeof Symbol&&(S.fn[Symbol.iterator]=t[Symbol.iterator]),S.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){n["[object "+t+"]"]=t.toLowerCase()});var d=function(n){var e,d,b,o,i,h,f,g,w,u,l,T,C,a,E,v,s,c,y,S="sizzle"+1*new Date,p=n.document,k=0,r=0,m=ue(),x=ue(),A=ue(),N=ue(),j=function(e,t){return e===t&&(l=!0),0},D={}.hasOwnProperty,t=[],q=t.pop,L=t.push,H=t.push,O=t.slice,P=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",I="(?:\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+",W="\\["+M+"*("+I+")(?:"+M+"*([*^$|!~]?=)"+M+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+I+"))|)"+M+"*\\]",F=":("+I+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+W+")*)|.*)\\)|)",B=new RegExp(M+"+","g"),$=new RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),_=new RegExp("^"+M+"*,"+M+"*"),z=new RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|[*])"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ee=/[+~]/,te=new RegExp("\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\([^\\r\\n\\f])","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),t[p.childNodes.length].nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||[],"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u[1]){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u[2])return H.apply(n,e.getElementsByTagName(t)),n;if((i=u[3])&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!N[t+" "]&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)l[o]=(s?"#"+s:":scope")+" "+xe(l[o]);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=[];return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete e[r.shift()],e[t+" "]=n}}function le(e){return e[S]=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandle[n[r]]=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a([],e.length,o),i=r.length;while(i--)e[n=r[i]]&&(e[n]=!(t[n]=e[n]))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?[n]:[]}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=[],v=[],(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="<a id='"+S+"'></a><select id='"+S+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&v.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||v.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll("[id~="+S+"-]").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("[name='']").length||v.push("\\["+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.+[+~]"),e.querySelectorAll("\\\f"),v.push("[\\r\\n\\f]")}),ce(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&v.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"[s!='']:x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?pe(a[r],s[r]):a[r]==p?-1:s[r]==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!N[t+" "]&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0<se(t,C,null,[e]).length},se.contains=function(e,t){return(e.ownerDocument||e)!=C&&T(e),y(e,t)},se.attr=function(e,t){(e.ownerDocument||e)!=C&&T(e);var n=b.attrHandle[t.toLowerCase()],r=n&&D.call(b.attrHandle,t.toLowerCase())?n(e,t,!E):void 0;return void 0!==r?r:d.attributes||!E?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},se.escape=function(e){return(e+"").replace(re,ie)},se.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},se.uniqueSort=function(e){var t,n=[],r=0,i=0;if(l=!d.detectDuplicates,u=!d.sortStable&&e.slice(0),e.sort(j),l){while(t=e[i++])t===e[i]&&(r=n.push(i));while(r--)e.splice(n[r],1)}return u=null,e},o=se.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else while(t=e[r++])n+=o(t);return n},(b=se.selectors={cacheLength:50,createPseudo:le,match:G,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(te,ne),e[3]=(e[3]||e[4]||e[5]||"").replace(te,ne),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||se.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&se.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return G.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=m[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1<t.indexOf(i):"$="===r?i&&t.slice(-i.length)===i:"~="===r?-1<(" "+t.replace(B," ")+" ").indexOf(i):"|="===r&&(t===i||t.slice(0,i.length+1)===i+"-"))}},CHILD:function(h,e,t,g,v){var y="nth"!==h.slice(0,3),m="last"!==h.slice(-4),x="of-type"===e;return 1===g&&0===v?function(e){return!!e.parentNode}:function(e,t,n){var r,i,o,a,s,u,l=y!==m?"nextSibling":"previousSibling",c=e.parentNode,f=x&&e.nodeName.toLowerCase(),p=!n&&!x,d=!1;if(c){if(y){while(l){a=e;while(a=a[l])if(x?a.nodeName.toLowerCase()===f:1===a.nodeType)return!1;u=l="only"===h&&!u&&"nextSibling"}return!0}if(u=[m?c.firstChild:c.lastChild],m&&p){d=(s=(r=(i=(o=(a=c)[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]||[])[0]===k&&r[1])&&r[2],a=s&&c.childNodes[s];while(a=++s&&a&&a[l]||(d=s=0)||u.pop())if(1===a.nodeType&&++d&&a===e){i[h]=[k,s,d];break}}else if(p&&(d=s=(r=(i=(o=(a=e)[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]||[])[0]===k&&r[1]),!1===d)while(a=++s&&a&&a[l]||(d=s=0)||u.pop())if((x?a.nodeName.toLowerCase()===f:1===a.nodeType)&&++d&&(p&&((i=(o=a[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]=[k,d]),a===e))break;return(d-=v)===g||d%g==0&&0<=d/g}}},PSEUDO:function(e,o){var t,a=b.pseudos[e]||b.setFilters[e.toLowerCase()]||se.error("unsupported pseudo: "+e);return a[S]?a(o):1<a.length?(t=[e,e,"",o],b.setFilters.hasOwnProperty(e.toLowerCase())?le(function(e,t){var n,r=a(e,o),i=r.length;while(i--)e[n=P(e,r[i])]=!(t[n]=r[i])}):function(e){return a(e,0,t)}):a}},pseudos:{not:le(function(e){var r=[],i=[],s=f(e.replace($,"$1"));return s[S]?le(function(e,t,n,r){var i,o=s(e,null,r,[]),a=e.length;while(a--)(i=o[a])&&(e[a]=!(t[a]=i))}):function(e,t,n){return r[0]=e,s(r,null,n,i),r[0]=null,!i.pop()}}),has:le(function(t){return function(e){return 0<se(t,e).length}}),contains:le(function(t){return t=t.replace(te,ne),function(e){return-1<(e.textContent||o(e)).indexOf(t)}}),lang:le(function(n){return V.test(n||"")||se.error("unsupported lang: "+n),n=n.replace(te,ne).toLowerCase(),function(e){var t;do{if(t=E?e.lang:e.getAttribute("xml:lang")||e.getAttribute("lang"))return(t=t.toLowerCase())===n||0===t.indexOf(n+"-")}while((e=e.parentNode)&&1===e.nodeType);return!1}}),target:function(e){var t=n.location&&n.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===a},focus:function(e){return e===C.activeElement&&(!C.hasFocus||C.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:ge(!1),disabled:ge(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!b.pseudos.empty(e)},header:function(e){return J.test(e.nodeName)},input:function(e){return Q.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:ve(function(){return[0]}),last:ve(function(e,t){return[t-1]}),eq:ve(function(e,t,n){return[n<0?n+t:n]}),even:ve(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:ve(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:ve(function(e,t,n){for(var r=n<0?n+t:t<n?t:n;0<=--r;)e.push(r);return e}),gt:ve(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=b.pseudos.eq,{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})b.pseudos[e]=de(e);for(e in{submit:!0,reset:!0})b.pseudos[e]=he(e);function me(){}function xe(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function be(s,e,t){var u=e.dir,l=e.next,c=l||u,f=t&&"parentNode"===c,p=r++;return e.first?function(e,t,n){while(e=e[u])if(1===e.nodeType||f)return s(e,t,n);return!1}:function(e,t,n){var r,i,o,a=[k,p];if(n){while(e=e[u])if((1===e.nodeType||f)&&s(e,t,n))return!0}else while(e=e[u])if(1===e.nodeType||f)if(i=(o=e[S]||(e[S]={}))[e.uniqueID]||(o[e.uniqueID]={}),l&&l===e.nodeName.toLowerCase())e=e[u]||e;else{if((r=i[c])&&r[0]===k&&r[1]===p)return a[2]=r[2];if((i[c]=a)[2]=s(e,t,n))return!0}return!1}}function we(i){return 1<i.length?function(e,t,n){var r=i.length;while(r--)if(!i[r](e,t,n))return!1;return!0}:i[0]}function Te(e,t,n,r,i){for(var o,a=[],s=0,u=e.length,l=null!=t;s<u;s++)(o=e[s])&&(n&&!n(o,r,i)||(a.push(o),l&&t.push(s)));return a}function Ce(d,h,g,v,y,e){return v&&!v[S]&&(v=Ce(v)),y&&!y[S]&&(y=Ce(y,e)),le(function(e,t,n,r){var i,o,a,s=[],u=[],l=t.length,c=e||function(e,t,n){for(var r=0,i=t.length;r<i;r++)se(e,t[r],n);return n}(h||"*",n.nodeType?[n]:n,[]),f=!d||!e&&h?c:Te(c,s,d,n,r),p=g?y||(e?d:l||v)?[]:t:f;if(g&&g(f,p,n,r),v){i=Te(p,u),v(i,[],n,r),o=i.length;while(o--)(a=i[o])&&(p[u[o]]=!(f[u[o]]=a))}if(e){if(y||d){if(y){i=[],o=p.length;while(o--)(a=p[o])&&i.push(f[o]=a);y(null,p=[],i,r)}o=p.length;while(o--)(a=p[o])&&-1<(i=y?P(e,a):s[o])&&(e[i]=!(t[i]=a))}}else p=Te(p===t?p.splice(l,p.length):p),y?y(null,t,p,r):H.apply(t,p)})}function Ee(e){for(var i,t,n,r=e.length,o=b.relative[e[0].type],a=o||b.relative[" "],s=o?1:0,u=be(function(e){return e===i},a,!0),l=be(function(e){return-1<P(i,e)},a,!0),c=[function(e,t,n){var r=!o&&(n||t!==w)||((i=t).nodeType?u(e,t,n):l(e,t,n));return i=null,r}];s<r;s++)if(t=b.relative[e[s].type])c=[be(we(c),t)];else{if((t=b.filter[e[s].type].apply(null,e[s].matches))[S]){for(n=++s;n<r;n++)if(b.relative[e[n].type])break;return Ce(1<s&&we(c),1<s&&xe(e.slice(0,s-1).concat({value:" "===e[s-2].type?"*":""})).replace($,"$1"),t,s<n&&Ee(e.slice(s,n)),n<r&&Ee(e=e.slice(n)),n<r&&xe(e))}c.push(t)}return we(c)}return me.prototype=b.filters=b.pseudos,b.setFilters=new me,h=se.tokenize=function(e,t){var n,r,i,o,a,s,u,l=x[e+" "];if(l)return t?0:l.slice(0);a=e,s=[],u=b.preFilter;while(a){for(o in n&&!(r=_.exec(a))||(r&&(a=a.slice(r[0].length)||a),s.push(i=[])),n=!1,(r=z.exec(a))&&(n=r.shift(),i.push({value:n,type:r[0].replace($," ")}),a=a.slice(n.length)),b.filter)!(r=G[o].exec(a))||u[o]&&!(r=u[o](r))||(n=r.shift(),i.push({value:n,type:o,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?se.error(e):x(e,s).slice(0)},f=se.compile=function(e,t){var n,v,y,m,x,r,i=[],o=[],a=A[e+" "];if(!a){t||(t=h(e)),n=t.length;while(n--)(a=Ee(t[n]))[S]?i.push(a):o.push(a);(a=A(e,(v=o,m=0<(y=i).length,x=0<v.length,r=function(e,t,n,r,i){var o,a,s,u=0,l="0",c=e&&[],f=[],p=w,d=e||x&&b.find.TAG("*",i),h=k+=null==p?1:Math.random()||.1,g=d.length;for(i&&(w=t==C||t||i);l!==g&&null!=(o=d[l]);l++){if(x&&o){a=0,t||o.ownerDocument==C||(T(o),n=!E);while(s=v[a++])if(s(o,t||C,n)){r.push(o);break}i&&(k=h)}m&&((o=!s&&o)&&u--,e&&c.push(o))}if(u+=l,m&&l!==u){a=0;while(s=y[a++])s(c,f,t,n);if(e){if(0<u)while(l--)c[l]||f[l]||(f[l]=q.call(r));f=Te(f)}H.apply(r,f),i&&!e&&0<f.length&&1<u+y.length&&se.uniqueSort(r)}return i&&(k=h,w=p),c},m?le(r):r))).selector=e}return a},g=se.select=function(e,t,n,r){var i,o,a,s,u,l="function"==typeof e&&e,c=!r&&h(e=l.selector||e);if(n=n||[],1===c.length){if(2<(o=c[0]=c[0].slice(0)).length&&"ID"===(a=o[0]).type&&9===t.nodeType&&E&&b.relative[o[1].type]){if(!(t=(b.find.ID(a.matches[0].replace(te,ne),t)||[])[0]))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}i=G.needsContext.test(e)?0:o.length;while(i--){if(a=o[i],b.relative[s=a.type])break;if((u=b.find[s])&&(r=u(a.matches[0].replace(te,ne),ee.test(o[0].type)&&ye(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&xe(o)))return H.apply(n,r),n;break}}}return(l||f(e,c))(r,t,!E,n,!t||ee.test(e)&&ye(t.parentNode)||t),n},d.sortStable=S.split("").sort(j).join("")===S,d.detectDuplicates=!!l,T(),d.sortDetached=ce(function(e){return 1&e.compareDocumentPosition(C.createElement("fieldset"))}),ce(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||fe("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),d.attributes&&ce(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||fe("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ce(function(e){return null==e.getAttribute("disabled")})||fe(R,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),se}(C);S.find=d,S.expr=d.selectors,S.expr[":"]=S.expr.pseudos,S.uniqueSort=S.unique=d.uniqueSort,S.text=d.getText,S.isXMLDoc=d.isXML,S.contains=d.contains,S.escapeSelector=d.escape;var h=function(e,t,n){var r=[],i=void 0!==n;while((e=e[t])&&9!==e.nodeType)if(1===e.nodeType){if(i&&S(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},k=S.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var N=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1<i.call(n,e)!==r}):S.filter(n,e,r)}S.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?S.find.matchesSelector(r,e)?[r]:[]:S.find.matches(e,S.grep(t,function(e){return 1===e.nodeType}))},S.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(S(e).filter(function(){for(t=0;t<r;t++)if(S.contains(i[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)S.find(e,i[t],n);return 1<r?S.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&k.test(e)?S(e):e||[],!1).length}});var D,q=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&3<=e.length?[null,e,null]:q.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof S?t[0]:t,S.merge(this,S.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r[1])&&S.isPlainObject(t))for(r in t)m(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return(i=E.getElementById(r[2]))&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=e[t])&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(S.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=[],a="string"!=typeof e&&S(e);if(!k.test(e))for(;r<i;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?-1<a.index(n):1===n.nodeType&&S.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(1<o.length?S.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?i.call(S(e),this[0]):i.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(S.uniqueSort(S.merge(this.get(),S(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),S.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return h(e,"parentNode")},parentsUntil:function(e,t,n){return h(e,"parentNode",n)},next:function(e){return O(e,"nextSibling")},prev:function(e){return O(e,"previousSibling")},nextAll:function(e){return h(e,"nextSibling")},prevAll:function(e){return h(e,"previousSibling")},nextUntil:function(e,t,n){return h(e,"nextSibling",n)},prevUntil:function(e,t,n){return h(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return null!=e.contentDocument&&r(e.contentDocument)?e.contentDocument:(A(e,"template")&&(e=e.content||e),S.merge([],e.childNodes))}},function(r,i){S.fn[r]=function(e,t){var n=S.map(this,i,e);return"Until"!==r.slice(-5)&&(t=e),t&&"string"==typeof t&&(n=S.filter(t,n)),1<this.length&&(H[r]||S.uniqueSort(n),L.test(r)&&n.reverse()),this.pushStack(n)}});var P=/[^\x20\t\r\n\f]+/g;function R(e){return e}function M(e){throw e}function I(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}S.Callbacks=function(r){var e,n;r="string"==typeof r?(e=r,n={},S.each(e.match(P)||[],function(e,t){n[t]=!0}),n):S.extend({},r);var i,t,o,a,s=[],u=[],l=-1,c=function(){for(a=a||r.once,o=i=!0;u.length;l=-1){t=u.shift();while(++l<s.length)!1===s[l].apply(t[0],t[1])&&r.stopOnFalse&&(l=s.length,t=!1)}r.memory||(t=!1),i=!1,a&&(s=t?[]:"")},f={add:function(){return s&&(t&&!i&&(l=s.length-1,u.push(t)),function n(e){S.each(e,function(e,t){m(t)?r.unique&&f.has(t)||s.push(t):t&&t.length&&"string"!==w(t)&&n(t)})}(arguments),t&&!i&&c()),this},remove:function(){return S.each(arguments,function(e,t){var n;while(-1<(n=S.inArray(t,s,n)))s.splice(n,1),n<=l&&l--}),this},has:function(e){return e?-1<S.inArray(e,s):0<s.length},empty:function(){return s&&(s=[]),this},disable:function(){return a=u=[],s=t="",this},disabled:function(){return!s},lock:function(){return a=u=[],t||i||(s=t=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],u.push(t),i||c()),this},fire:function(){return f.fireWith(this,arguments),this},fired:function(){return!!o}};return f},S.extend({Deferred:function(e){var o=[["notify","progress",S.Callbacks("memory"),S.Callbacks("memory"),2],["resolve","done",S.Callbacks("once memory"),S.Callbacks("once memory"),0,"resolved"],["reject","fail",S.Callbacks("once memory"),S.Callbacks("once memory"),1,"rejected"]],i="pending",a={state:function(){return i},always:function(){return s.done(arguments).fail(arguments),this},"catch":function(e){return a.then(null,e)},pipe:function(){var i=arguments;return S.Deferred(function(r){S.each(o,function(e,t){var n=m(i[t[4]])&&i[t[4]];s[t[1]](function(){var e=n&&n.apply(this,arguments);e&&m(e.promise)?e.promise().progress(r.notify).done(r.resolve).fail(r.reject):r[t[0]+"With"](this,n?[e]:arguments)})}),i=null}).promise()},then:function(t,n,r){var u=0;function l(i,o,a,s){return function(){var n=this,r=arguments,e=function(){var e,t;if(!(i<u)){if((e=a.apply(n,r))===o.promise())throw new TypeError("Thenable self-resolution");t=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(t)?s?t.call(e,l(u,o,R,s),l(u,o,M,s)):(u++,t.call(e,l(u,o,R,s),l(u,o,M,s),l(u,o,R,o.notifyWith))):(a!==R&&(n=void 0,r=[e]),(s||o.resolveWith)(n,r))}},t=s?e:function(){try{e()}catch(e){S.Deferred.exceptionHook&&S.Deferred.exceptionHook(e,t.stackTrace),u<=i+1&&(a!==M&&(n=void 0,r=[e]),o.rejectWith(n,r))}};i?t():(S.Deferred.getStackHook&&(t.stackTrace=S.Deferred.getStackHook()),C.setTimeout(t))}}return S.Deferred(function(e){o[0][3].add(l(0,e,m(r)?r:R,e.notifyWith)),o[1][3].add(l(0,e,m(t)?t:R)),o[2][3].add(l(0,e,m(n)?n:M))}).promise()},promise:function(e){return null!=e?S.extend(e,a):a}},s={};return S.each(o,function(e,t){var n=t[2],r=t[5];a[t[1]]=n.add,r&&n.add(function(){i=r},o[3-e][2].disable,o[3-e][3].disable,o[0][2].lock,o[0][3].lock),n.add(t[3].fire),s[t[0]]=function(){return s[t[0]+"With"](this===s?void 0:this,arguments),this},s[t[0]+"With"]=n.fireWith}),a.promise(s),e&&e.call(s,s),s},when:function(e){var n=arguments.length,t=n,r=Array(t),i=s.call(arguments),o=S.Deferred(),a=function(t){return function(e){r[t]=this,i[t]=1<arguments.length?s.call(arguments):e,--n||o.resolveWith(r,i)}};if(n<=1&&(I(e,o.done(a(t)).resolve,o.reject,!n),"pending"===o.state()||m(i[t]&&i[t].then)))return o.then();while(t--)I(i[t],a(t),o.reject);return o.promise()}});var W=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;S.Deferred.exceptionHook=function(e,t){C.console&&C.console.warn&&e&&W.test(e.name)&&C.console.warn("jQuery.Deferred exception: "+e.message,e.stack,t)},S.readyException=function(e){C.setTimeout(function(){throw e})};var F=S.Deferred();function B(){E.removeEventListener("DOMContentLoaded",B),C.removeEventListener("load",B),S.ready()}S.fn.ready=function(e){return F.then(e)["catch"](function(e){S.readyException(e)}),this},S.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--S.readyWait:S.isReady)||(S.isReady=!0)!==e&&0<--S.readyWait||F.resolveWith(E,[S])}}),S.ready.then=F.then,"complete"===E.readyState||"loading"!==E.readyState&&!E.documentElement.doScroll?C.setTimeout(S.ready):(E.addEventListener("DOMContentLoaded",B),C.addEventListener("load",B));var $=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===w(n))for(s in i=!0,n)$(e,t,s,n[s],!0,o,a);else if(void 0!==r&&(i=!0,m(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(S(e),n)})),t))for(;s<u;s++)t(e[s],n,a?r:r.call(e[s],s,t(e[s],n)));return i?e:l?t.call(e):u?t(e[0],n):o},_=/^-ms-/,z=/-([a-z])/g;function U(e,t){return t.toUpperCase()}function X(e){return e.replace(_,"ms-").replace(z,U)}var V=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function G(){this.expando=S.expando+G.uid++}G.uid=1,G.prototype={cache:function(e){var t=e[this.expando];return t||(t={},V(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)i[X(t)]=n;else for(r in t)i[X(r)]=t[r];return i},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][X(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(X):(t=X(t))in r?[t]:t.match(P)||[]).length;while(n--)delete r[t[n]]}(void 0===t||S.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!S.isEmptyObject(t)}};var Y=new G,Q=new G,J=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,K=/[A-Z]/g;function Z(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}S.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),S.fn.extend({data:function(n,e){var t,r,i,o=this[0],a=o&&o.attributes;if(void 0===n){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){t=a.length;while(t--)a[t]&&0===(r=a[t].name).indexOf("data-")&&(r=X(r.slice(5)),Z(o,r,i[r]));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof n?this.each(function(){Q.set(this,n)}):$(this,function(e){var t;if(o&&void 0===e)return void 0!==(t=Q.get(o,n))?t:void 0!==(t=Z(o,n))?t:void 0;this.each(function(){Q.set(this,n,e)})},null,e,1<arguments.length,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),S.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,S.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=S.queue(e,t),r=n.length,i=n.shift(),o=S._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){S.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:S.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),S.fn.extend({queue:function(t,n){var e=2;return"string"!=typeof t&&(n=t,t="fx",e--),arguments.length<e?S.queue(this[0],t):void 0===n?this:this.each(function(){var e=S.queue(this,t,n);S._queueHooks(this,t),"fx"===t&&"inprogress"!==e[0]&&S.dequeue(this,t)})},dequeue:function(e){return this.each(function(){S.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,i=S.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,[o])};"string"!=typeof e&&(t=e,e=void 0),e=e||"fx";while(a--)(n=Y.get(o[a],e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var ee=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,te=new RegExp("^(?:([+-])=|)("+ee+")([a-z%]*)$","i"),ne=["Top","Right","Bottom","Left"],re=E.documentElement,ie=function(e){return S.contains(e.ownerDocument,e)},oe={composed:!0};re.getRootNode&&(ie=function(e){return S.contains(e.ownerDocument,e)||e.getRootNode(oe)===e.ownerDocument});var ae=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&ie(e)&&"none"===S.css(e,"display")};function se(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return S.css(e,t,"")},u=s(),l=n&&n[3]||(S.cssNumber[t]?"":"px"),c=e.nodeType&&(S.cssNumber[t]||"px"!==l&&+u)&&te.exec(S.css(e,t));if(c&&c[3]!==l){u/=2,l=l||c[3],c=+u||1;while(a--)S.style(e,t,c+l),(1-o)*(1-(o=s()/u||.5))<=0&&(a=0),c/=o;c*=2,S.style(e,t,c+l),n=n||[]}return n&&(c=+c||+u||0,i=n[1]?c+(n[1]+1)*n[2]:+n[2],r&&(r.unit=l,r.start=c,r.end=i)),i}var ue={};function le(e,t){for(var n,r,i,o,a,s,u,l=[],c=0,f=e.length;c<f;c++)(r=e[c]).style&&(n=r.style.display,t?("none"===n&&(l[c]=Y.get(r,"display")||null,l[c]||(r.style.display="")),""===r.style.display&&ae(r)&&(l[c]=(u=a=o=void 0,a=(i=r).ownerDocument,s=i.nodeName,(u=ue[s])||(o=a.body.appendChild(a.createElement(s)),u=S.css(o,"display"),o.parentNode.removeChild(o),"none"===u&&(u="block"),ue[s]=u)))):"none"!==n&&(l[c]="none",Y.set(r,"display",n)));for(c=0;c<f;c++)null!=l[c]&&(e[c].style.display=l[c]);return e}S.fn.extend({show:function(){return le(this,!0)},hide:function(){return le(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ae(this)?S(this).show():S(this).hide()})}});var ce,fe,pe=/^(?:checkbox|radio)$/i,de=/<([a-z][^\/\0>\x20\t\r\n\f]*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="<textarea>x</textarea>",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="<option></option>",y.option=!!ce.lastChild;var ge={thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?S.merge([e],n):n}function ye(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(e[n],"globalEval",!t||Y.get(t[n],"globalEval"))}ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td,y.option||(ge.optgroup=ge.option=[1,"<select multiple='multiple'>","</select>"]);var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=[],d=0,h=e.length;d<h;d++)if((o=e[d])||0===o)if("object"===w(o))S.merge(p,o.nodeType?[o]:o);else if(me.test(o)){a=a||f.appendChild(t.createElement("div")),s=(de.exec(o)||["",""])[1].toLowerCase(),u=ge[s]||ge._default,a.innerHTML=u[1]+S.htmlPrefilter(o)+u[2],c=u[0];while(c--)a=a.lastChild;S.merge(p,a.childNodes),(a=f.firstChild).textContent=""}else p.push(t.createTextNode(o));f.textContent="",d=0;while(o=p[d++])if(r&&-1<S.inArray(o,r))i&&i.push(o);else if(l=ie(o),a=ve(f.appendChild(o),"script"),l&&ye(a),n){c=0;while(o=a[c++])he.test(o.type||"")&&n.push(o)}return f}var be=/^([^.]*)(?:\.(.+)|)/;function we(){return!0}function Te(){return!1}function Ce(e,t){return e===function(){try{return E.activeElement}catch(e){}}()==("focus"===t)}function Ee(e,t,n,r,i,o){var a,s;if("object"==typeof t){for(s in"string"!=typeof n&&(r=r||n,n=void 0),t)Ee(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Te;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return S().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=S.guid++)),e.each(function(){S.event.add(this,t,i,r,n)})}function Se(e,i,o){o?(Y.set(e,i,!1),S.event.add(e,i,{namespace:!1,handler:function(e){var t,n,r=Y.get(this,i);if(1&e.isTrigger&&this[i]){if(r.length)(S.event.special[i]||{}).delegateType&&e.stopPropagation();else if(r=s.call(arguments),Y.set(this,i,r),t=o(this,i),this[i](),r!==(n=Y.get(this,i))||t?Y.set(this,i,!1):n={},r!==n)return e.stopImmediatePropagation(),e.preventDefault(),n&&n.value}else r.length&&(Y.set(this,i,{value:S.event.trigger(S.extend(r[0],S.Event.prototype),r.slice(1),this)}),e.stopImmediatePropagation())}})):void 0===Y.get(e,i)&&S.event.add(e,i,we)}S.event={global:{},add:function(t,e,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.get(t);if(V(t)){n.handler&&(n=(o=n).handler,i=o.selector),i&&S.find.matchesSelector(re,i),n.guid||(n.guid=S.guid++),(u=v.events)||(u=v.events=Object.create(null)),(a=v.handle)||(a=v.handle=function(e){return"undefined"!=typeof S&&S.event.triggered!==e.type?S.event.dispatch.apply(t,arguments):void 0}),l=(e=(e||"").match(P)||[""]).length;while(l--)d=g=(s=be.exec(e[l])||[])[1],h=(s[2]||"").split(".").sort(),d&&(f=S.event.special[d]||{},d=(i?f.delegateType:f.bindType)||d,f=S.event.special[d]||{},c=S.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&S.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=u[d])||((p=u[d]=[]).delegateCount=0,f.setup&&!1!==f.setup.call(t,r,h,a)||t.addEventListener&&t.addEventListener(d,a)),f.add&&(f.add.call(t,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),S.event.global[d]=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.hasData(e)&&Y.get(e);if(v&&(u=v.events)){l=(t=(t||"").match(P)||[""]).length;while(l--)if(d=g=(s=be.exec(t[l])||[])[1],h=(s[2]||"").split(".").sort(),d){f=S.event.special[d]||{},p=u[d=(r?f.delegateType:f.bindType)||d]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=p[o],!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,v.handle)||S.removeEvent(e,d,v.handle),delete u[d])}else for(d in u)S.event.remove(e,d+t[l],n,r,!0);S.isEmptyObject(u)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=new Array(arguments.length),u=S.event.fix(e),l=(Y.get(this,"events")||Object.create(null))[u.type]||[],c=S.event.special[u.type]||{};for(s[0]=u,t=1;t<arguments.length;t++)s[t]=arguments[t];if(u.delegateTarget=this,!c.preDispatch||!1!==c.preDispatch.call(this,u)){a=S.event.handlers.call(this,u,l),t=0;while((i=a[t++])&&!u.isPropagationStopped()){u.currentTarget=i.elem,n=0;while((o=i.handlers[n++])&&!u.isImmediatePropagationStopped())u.rnamespace&&!1!==o.namespace&&!u.rnamespace.test(o.namespace)||(u.handleObj=o,u.data=o.data,void 0!==(r=((S.event.special[o.origType]||{}).handle||o.handler).apply(i.elem,s))&&!1===(u.result=r)&&(u.preventDefault(),u.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,u),u.result}},handlers:function(e,t){var n,r,i,o,a,s=[],u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&1<=e.button))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=[],a={},n=0;n<u;n++)void 0===a[i=(r=t[n]).selector+" "]&&(a[i]=r.needsContext?-1<S(i,this).index(l):S.find(i,this,null,[l]).length),a[i]&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(t,e){Object.defineProperty(S.Event.prototype,t,{enumerable:!0,configurable:!0,get:m(e)?function(){if(this.originalEvent)return e(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[t]},set:function(e){Object.defineProperty(this,t,{enumerable:!0,configurable:!0,writable:!0,value:e})}})},fix:function(e){return e[S.expando]?e:new S.Event(e)},special:{load:{noBubble:!0},click:{setup:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click",we),!1},trigger:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click"),!0},_default:function(e){var t=e.target;return pe.test(t.type)&&t.click&&A(t,"input")&&Y.get(t,"click")||A(t,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},S.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},S.Event=function(e,t){if(!(this instanceof S.Event))return new S.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?we:Te,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&S.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),this[S.expando]=!0},S.Event.prototype={constructor:S.Event,isDefaultPrevented:Te,isPropagationStopped:Te,isImmediatePropagationStopped:Te,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=we,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=we,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=we,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},S.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,"char":!0,code:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:!0},S.event.addProp),S.each({focus:"focusin",blur:"focusout"},function(e,t){S.event.special[e]={setup:function(){return Se(this,e,Ce),!1},trigger:function(){return Se(this,e),!0},_default:function(){return!0},delegateType:t}}),S.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,i){S.event.special[e]={delegateType:i,bindType:i,handle:function(e){var t,n=e.relatedTarget,r=e.handleObj;return n&&(n===this||S.contains(this,n))||(e.type=r.origType,t=r.handler.apply(this,arguments),e.type=i),t}}}),S.fn.extend({on:function(e,t,n,r){return Ee(this,e,t,n,r)},one:function(e,t,n,r){return Ee(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,S(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,e[i]);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Te),this.each(function(){S.event.remove(this,e,n,t)})}});var ke=/<script|<style|<link/i,Ae=/checked\s*(?:[^=]|=\s*.checked.)/i,Ne=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=s[i].length;n<r;n++)S.event.add(t,i,s[i][n]);Q.hasData(e)&&(o=Q.access(e),a=S.extend({},o),Q.set(t,a))}}function He(n,r,i,o){r=g(r);var e,t,a,s,u,l,c=0,f=n.length,p=f-1,d=r[0],h=m(d);if(h||1<f&&"string"==typeof d&&!y.checkClone&&Ae.test(d))return n.each(function(e){var t=n.eq(e);h&&(r[0]=d.call(this,e,t.html())),He(t,r,i,o)});if(f&&(t=(e=xe(r,n[0].ownerDocument,!1,n,o)).firstChild,1===e.childNodes.length&&(e=t),t||o)){for(s=(a=S.map(ve(e,"script"),De)).length;c<f;c++)u=e,c!==p&&(u=S.clone(u,!0,!0),s&&S.merge(a,ve(u,"script"))),i.call(n[c],u,c);if(s)for(l=a[a.length-1].ownerDocument,S.map(a,qe),c=0;c<s;c++)u=a[c],he.test(u.type||"")&&!Y.access(u,"globalEval")&&S.contains(l,u)&&(u.src&&"module"!==(u.type||"").toLowerCase()?S._evalUrl&&!u.noModule&&S._evalUrl(u.src,{nonce:u.nonce||u.getAttribute("nonce")},l):b(u.textContent.replace(Ne,""),u,l))}return n}function Oe(e,t,n){for(var r,i=t?S.filter(t,e):e,o=0;null!=(r=i[o]);o++)n||1!==r.nodeType||S.cleanData(ve(r)),r.parentNode&&(n&&ie(r)&&ye(ve(r,"script")),r.parentNode.removeChild(r));return e}S.extend({htmlPrefilter:function(e){return e},clone:function(e,t,n){var r,i,o,a,s,u,l,c=e.cloneNode(!0),f=ie(e);if(!(y.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||S.isXMLDoc(e)))for(a=ve(c),r=0,i=(o=ve(e)).length;r<i;r++)s=o[r],u=a[r],void 0,"input"===(l=u.nodeName.toLowerCase())&&pe.test(s.type)?u.checked=s.checked:"input"!==l&&"textarea"!==l||(u.defaultValue=s.defaultValue);if(t)if(n)for(o=o||ve(e),a=a||ve(c),r=0,i=o.length;r<i;r++)Le(o[r],a[r]);else Le(e,c);return 0<(a=ve(c,"script")).length&&ye(a,!f&&ve(e,"script")),c},cleanData:function(e){for(var t,n,r,i=S.event.special,o=0;void 0!==(n=e[o]);o++)if(V(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?S.event.remove(n,r):S.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),S.fn.extend({detach:function(e){return Oe(this,e,!0)},remove:function(e){return Oe(this,e)},text:function(e){return $(this,function(e){return void 0===e?S.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return He(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return He(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(S.cleanData(ve(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return S.clone(this,e,t)})},html:function(e){return $(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!ke.test(e)&&!ge[(de.exec(e)||["",""])[1].toLowerCase()]){e=S.htmlPrefilter(e);try{for(;n<r;n++)1===(t=this[n]||{}).nodeType&&(S.cleanData(ve(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var n=[];return He(this,arguments,function(e){var t=this.parentNode;S.inArray(this,n)<0&&(S.cleanData(ve(this)),t&&t.replaceChild(e,this))},n)}}),S.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,a){S.fn[e]=function(e){for(var t,n=[],r=S(e),i=r.length-1,o=0;o<=i;o++)t=o===i?this:this.clone(!0),S(r[o])[a](t),u.apply(n,t.get());return this.pushStack(n)}});var Pe=new RegExp("^("+ee+")(?!px)[a-z%]+$","i"),Re=function(e){var t=e.ownerDocument.defaultView;return t&&t.opener||(t=C),t.getComputedStyle(e)},Me=function(e,t,n){var r,i,o={};for(i in t)o[i]=e.style[i],e.style[i]=t[i];for(i in r=n.call(e),t)e.style[i]=o[i];return r},Ie=new RegExp(ne.join("|"),"i");function We(e,t,n){var r,i,o,a,s=e.style;return(n=n||Re(e))&&(""!==(a=n.getPropertyValue(t)||n[t])||ie(e)||(a=S.style(e,t)),!y.pixelBoxStyles()&&Pe.test(a)&&Ie.test(t)&&(r=s.width,i=s.minWidth,o=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=i,s.maxWidth=o)),void 0!==a?a+"":a}function Fe(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function e(){if(l){u.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",l.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",re.appendChild(u).appendChild(l);var e=C.getComputedStyle(l);n="1%"!==e.top,s=12===t(e.marginLeft),l.style.right="60%",o=36===t(e.right),r=36===t(e.width),l.style.position="absolute",i=12===t(l.offsetWidth/3),re.removeChild(u),l=null}}function t(e){return Math.round(parseFloat(e))}var n,r,i,o,a,s,u=E.createElement("div"),l=E.createElement("div");l.style&&(l.style.backgroundClip="content-box",l.cloneNode(!0).style.backgroundClip="",y.clearCloneStyle="content-box"===l.style.backgroundClip,S.extend(y,{boxSizingReliable:function(){return e(),r},pixelBoxStyles:function(){return e(),o},pixelPosition:function(){return e(),n},reliableMarginLeft:function(){return e(),s},scrollboxSize:function(){return e(),i},reliableTrDimensions:function(){var e,t,n,r;return null==a&&(e=E.createElement("table"),t=E.createElement("tr"),n=E.createElement("div"),e.style.cssText="position:absolute;left:-11111px;border-collapse:separate",t.style.cssText="border:1px solid",t.style.height="1px",n.style.height="9px",n.style.display="block",re.appendChild(e).appendChild(t).appendChild(n),r=C.getComputedStyle(t),a=parseInt(r.height,10)+parseInt(r.borderTopWidth,10)+parseInt(r.borderBottomWidth,10)===t.offsetHeight,re.removeChild(e)),a}}))}();var Be=["Webkit","Moz","ms"],$e=E.createElement("div").style,_e={};function ze(e){var t=S.cssProps[e]||_e[e];return t||(e in $e?e:_e[e]=function(e){var t=e[0].toUpperCase()+e.slice(1),n=Be.length;while(n--)if((e=Be[n]+t)in $e)return e}(e)||e)}var Ue=/^(none|table(?!-c[ea]).+)/,Xe=/^--/,Ve={position:"absolute",visibility:"hidden",display:"block"},Ge={letterSpacing:"0",fontWeight:"400"};function Ye(e,t,n){var r=te.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function Qe(e,t,n,r,i,o){var a="width"===t?1:0,s=0,u=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(u+=S.css(e,n+ne[a],!0,i)),r?("content"===n&&(u-=S.css(e,"padding"+ne[a],!0,i)),"margin"!==n&&(u-=S.css(e,"border"+ne[a]+"Width",!0,i))):(u+=S.css(e,"padding"+ne[a],!0,i),"padding"!==n?u+=S.css(e,"border"+ne[a]+"Width",!0,i):s+=S.css(e,"border"+ne[a]+"Width",!0,i));return!r&&0<=o&&(u+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-u-s-.5))||0),u}function Je(e,t,n){var r=Re(e),i=(!y.boxSizingReliable()||n)&&"border-box"===S.css(e,"boxSizing",!1,r),o=i,a=We(e,t,r),s="offset"+t[0].toUpperCase()+t.slice(1);if(Pe.test(a)){if(!n)return a;a="auto"}return(!y.boxSizingReliable()&&i||!y.reliableTrDimensions()&&A(e,"tr")||"auto"===a||!parseFloat(a)&&"inline"===S.css(e,"display",!1,r))&&e.getClientRects().length&&(i="border-box"===S.css(e,"boxSizing",!1,r),(o=s in e)&&(a=e[s])),(a=parseFloat(a)||0)+Qe(e,t,n||(i?"border":"content"),o,r,a)+"px"}function Ke(e,t,n,r,i){return new Ke.prototype.init(e,t,n,r,i)}S.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=We(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,gridArea:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnStart:!0,gridRow:!0,gridRowEnd:!0,gridRowStart:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=X(t),u=Xe.test(t),l=e.style;if(u||(t=ze(s)),a=S.cssHooks[t]||S.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:l[t];"string"===(o=typeof n)&&(i=te.exec(n))&&i[1]&&(n=se(e,t,i),o="number"),null!=n&&n==n&&("number"!==o||u||(n+=i&&i[3]||(S.cssNumber[s]?"":"px")),y.clearCloneStyle||""!==n||0!==t.indexOf("background")||(l[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):l[t]=n))}},css:function(e,t,n,r){var i,o,a,s=X(t);return Xe.test(t)||(t=ze(s)),(a=S.cssHooks[t]||S.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=We(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),S.each(["height","width"],function(e,u){S.cssHooks[u]={get:function(e,t,n){if(t)return!Ue.test(S.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,u,n):Me(e,Ve,function(){return Je(e,u,n)})},set:function(e,t,n){var r,i=Re(e),o=!y.scrollboxSize()&&"absolute"===i.position,a=(o||n)&&"border-box"===S.css(e,"boxSizing",!1,i),s=n?Qe(e,u,n,a,i):0;return a&&o&&(s-=Math.ceil(e["offset"+u[0].toUpperCase()+u.slice(1)]-parseFloat(i[u])-Qe(e,u,"border",!1,i)-.5)),s&&(r=te.exec(t))&&"px"!==(r[3]||"px")&&(e.style[u]=t,t=S.css(e,u)),Ye(0,t,s)}}}),S.cssHooks.marginLeft=Fe(y.reliableMarginLeft,function(e,t){if(t)return(parseFloat(We(e,"marginLeft"))||e.getBoundingClientRect().left-Me(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),S.each({margin:"",padding:"",border:"Width"},function(i,o){S.cssHooks[i+o]={expand:function(e){for(var t=0,n={},r="string"==typeof e?e.split(" "):[e];t<4;t++)n[i+ne[t]+o]=r[t]||r[t-2]||r[0];return n}},"margin"!==i&&(S.cssHooks[i+o].set=Ye)}),S.fn.extend({css:function(e,t){return $(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Re(e),i=t.length;a<i;a++)o[t[a]]=S.css(e,t[a],!1,r);return o}return void 0!==n?S.style(e,t,n):S.css(e,t)},e,t,1<arguments.length)}}),((S.Tween=Ke).prototype={constructor:Ke,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||S.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(S.cssNumber[n]?"":"px")},cur:function(){var e=Ke.propHooks[this.prop];return e&&e.get?e.get(this):Ke.propHooks._default.get(this)},run:function(e){var t,n=Ke.propHooks[this.prop];return this.options.duration?this.pos=t=S.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):Ke.propHooks._default.set(this),this}}).init.prototype=Ke.prototype,(Ke.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=S.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){S.fx.step[e.prop]?S.fx.step[e.prop](e):1!==e.elem.nodeType||!S.cssHooks[e.prop]&&null==e.elem.style[ze(e.prop)]?e.elem[e.prop]=e.now:S.style(e.elem,e.prop,e.now+e.unit)}}}).scrollTop=Ke.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},S.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},S.fx=Ke.prototype.init,S.fx.step={};var Ze,et,tt,nt,rt=/^(?:toggle|show|hide)$/,it=/queueHooks$/;function ot(){et&&(!1===E.hidden&&C.requestAnimationFrame?C.requestAnimationFrame(ot):C.setTimeout(ot,S.fx.interval),S.fx.tick())}function at(){return C.setTimeout(function(){Ze=void 0}),Ze=Date.now()}function st(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i["margin"+(n=ne[r])]=i["padding"+n]=e;return t&&(i.opacity=i.width=e),i}function ut(e,t,n){for(var r,i=(lt.tweeners[t]||[]).concat(lt.tweeners["*"]),o=0,a=i.length;o<a;o++)if(r=i[o].call(n,t,e))return r}function lt(o,e,t){var n,a,r=0,i=lt.prefilters.length,s=S.Deferred().always(function(){delete u.elem}),u=function(){if(a)return!1;for(var e=Ze||at(),t=Math.max(0,l.startTime+l.duration-e),n=1-(t/l.duration||0),r=0,i=l.tweens.length;r<i;r++)l.tweens[r].run(n);return s.notifyWith(o,[l,n,t]),n<1&&i?t:(i||s.notifyWith(o,[l,1,0]),s.resolveWith(o,[l]),!1)},l=s.promise({elem:o,props:S.extend({},e),opts:S.extend(!0,{specialEasing:{},easing:S.easing._default},t),originalProperties:e,originalOptions:t,startTime:Ze||at(),duration:t.duration,tweens:[],createTween:function(e,t){var n=S.Tween(o,l.opts,e,t,l.opts.specialEasing[e]||l.opts.easing);return l.tweens.push(n),n},stop:function(e){var t=0,n=e?l.tweens.length:0;if(a)return this;for(a=!0;t<n;t++)l.tweens[t].run(1);return e?(s.notifyWith(o,[l,1,0]),s.resolveWith(o,[l,e])):s.rejectWith(o,[l,e]),this}}),c=l.props;for(!function(e,t){var n,r,i,o,a;for(n in e)if(i=t[r=X(n)],o=e[n],Array.isArray(o)&&(i=o[1],o=e[n]=o[0]),n!==r&&(e[r]=o,delete e[n]),(a=S.cssHooks[r])&&"expand"in a)for(n in o=a.expand(o),delete e[r],o)n in e||(e[n]=o[n],t[n]=i);else t[r]=i}(c,l.opts.specialEasing);r<i;r++)if(n=lt.prefilters[r].call(l,o,c,l.opts))return m(n.stop)&&(S._queueHooks(l.elem,l.opts.queue).stop=n.stop.bind(n)),n;return S.map(c,ut,l),m(l.opts.start)&&l.opts.start.call(o,l),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always),S.fx.timer(S.extend(u,{elem:o,anim:l,queue:l.opts.queue})),l}S.Animation=S.extend(lt,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return se(n.elem,e,te.exec(t),n),n}]},tweener:function(e,t){m(e)?(t=e,e=["*"]):e=e.match(P);for(var n,r=0,i=e.length;r<i;r++)n=e[r],lt.tweeners[n]=lt.tweeners[n]||[],lt.tweeners[n].unshift(t)},prefilters:[function(e,t,n){var r,i,o,a,s,u,l,c,f="width"in t||"height"in t,p=this,d={},h=e.style,g=e.nodeType&&ae(e),v=Y.get(e,"fxshow");for(r in n.queue||(null==(a=S._queueHooks(e,"fx")).unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,S.queue(e,"fx").length||a.empty.fire()})})),t)if(i=t[r],rt.test(i)){if(delete t[r],o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!v||void 0===v[r])continue;g=!0}d[r]=v&&v[r]||S.style(e,r)}if((u=!S.isEmptyObject(t))||!S.isEmptyObject(d))for(r in f&&1===e.nodeType&&(n.overflow=[h.overflow,h.overflowX,h.overflowY],null==(l=v&&v.display)&&(l=Y.get(e,"display")),"none"===(c=S.css(e,"display"))&&(l?c=l:(le([e],!0),l=e.style.display||l,c=S.css(e,"display"),le([e]))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===S.css(e,"float")&&(u||(p.done(function(){h.display=l}),null==l&&(c=h.display,l="none"===c?"":c)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",p.always(function(){h.overflow=n.overflow[0],h.overflowX=n.overflow[1],h.overflowY=n.overflow[2]})),u=!1,d)u||(v?"hidden"in v&&(g=v.hidden):v=Y.access(e,"fxshow",{display:l}),o&&(v.hidden=!g),g&&le([e],!0),p.done(function(){for(r in g||le([e]),Y.remove(e,"fxshow"),d)S.style(e,r,d[r])})),u=ut(g?v[r]:0,r,p),r in v||(v[r]=u.start,g&&(u.end=u.start,u.start=0))}],prefilter:function(e,t){t?lt.prefilters.unshift(e):lt.prefilters.push(e)}}),S.speed=function(e,t,n){var r=e&&"object"==typeof e?S.extend({},e):{complete:n||!n&&t||m(e)&&e,duration:e,easing:n&&t||t&&!m(t)&&t};return S.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in S.fx.speeds?r.duration=S.fx.speeds[r.duration]:r.duration=S.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){m(r.old)&&r.old.call(this),r.queue&&S.dequeue(this,r.queue)},r},S.fn.extend({fadeTo:function(e,t,n,r){return this.filter(ae).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(t,e,n,r){var i=S.isEmptyObject(t),o=S.speed(e,n,r),a=function(){var e=lt(this,S.extend({},t),o);(i||Y.get(this,"finish"))&&e.stop(!0)};return a.finish=a,i||!1===o.queue?this.each(a):this.queue(o.queue,a)},stop:function(i,e,o){var a=function(e){var t=e.stop;delete e.stop,t(o)};return"string"!=typeof i&&(o=e,e=i,i=void 0),e&&this.queue(i||"fx",[]),this.each(function(){var e=!0,t=null!=i&&i+"queueHooks",n=S.timers,r=Y.get(this);if(t)r[t]&&r[t].stop&&a(r[t]);else for(t in r)r[t]&&r[t].stop&&it.test(t)&&a(r[t]);for(t=n.length;t--;)n[t].elem!==this||null!=i&&n[t].queue!==i||(n[t].anim.stop(o),e=!1,n.splice(t,1));!e&&o||S.dequeue(this,i)})},finish:function(a){return!1!==a&&(a=a||"fx"),this.each(function(){var e,t=Y.get(this),n=t[a+"queue"],r=t[a+"queueHooks"],i=S.timers,o=n?n.length:0;for(t.finish=!0,S.queue(this,a,[]),r&&r.stop&&r.stop.call(this,!0),e=i.length;e--;)i[e].elem===this&&i[e].queue===a&&(i[e].anim.stop(!0),i.splice(e,1));for(e=0;e<o;e++)n[e]&&n[e].finish&&n[e].finish.call(this);delete t.finish})}}),S.each(["toggle","show","hide"],function(e,r){var i=S.fn[r];S.fn[r]=function(e,t,n){return null==e||"boolean"==typeof e?i.apply(this,arguments):this.animate(st(r,!0),e,t,n)}}),S.each({slideDown:st("show"),slideUp:st("hide"),slideToggle:st("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,r){S.fn[e]=function(e,t,n){return this.animate(r,e,t,n)}}),S.timers=[],S.fx.tick=function(){var e,t=0,n=S.timers;for(Ze=Date.now();t<n.length;t++)(e=n[t])()||n[t]!==e||n.splice(t--,1);n.length||S.fx.stop(),Ze=void 0},S.fx.timer=function(e){S.timers.push(e),S.fx.start()},S.fx.interval=13,S.fx.start=function(){et||(et=!0,ot())},S.fx.stop=function(){et=null},S.fx.speeds={slow:600,fast:200,_default:400},S.fn.delay=function(r,e){return r=S.fx&&S.fx.speeds[r]||r,e=e||"fx",this.queue(e,function(e,t){var n=C.setTimeout(e,r);t.stop=function(){C.clearTimeout(n)}})},tt=E.createElement("input"),nt=E.createElement("select").appendChild(E.createElement("option")),tt.type="checkbox",y.checkOn=""!==tt.value,y.optSelected=nt.selected,(tt=E.createElement("input")).value="t",tt.type="radio",y.radioValue="t"===tt.value;var ct,ft=S.expr.attrHandle;S.fn.extend({attr:function(e,t){return $(this,S.attr,e,t,1<arguments.length)},removeAttr:function(e){return this.each(function(){S.removeAttr(this,e)})}}),S.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?S.prop(e,t,n):(1===o&&S.isXMLDoc(e)||(i=S.attrHooks[t.toLowerCase()]||(S.expr.match.bool.test(t)?ct:void 0)),void 0!==n?null===n?void S.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=S.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!y.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(P);if(i&&1===e.nodeType)while(n=i[r++])e.removeAttribute(n)}}),ct={set:function(e,t,n){return!1===t?S.removeAttr(e,n):e.setAttribute(n,n),n}},S.each(S.expr.match.bool.source.match(/\w+/g),function(e,t){var a=ft[t]||S.find.attr;ft[t]=function(e,t,n){var r,i,o=t.toLowerCase();return n||(i=ft[o],ft[o]=r,r=null!=a(e,t,n)?o:null,ft[o]=i),r}});var pt=/^(?:input|select|textarea|button)$/i,dt=/^(?:a|area)$/i;function ht(e){return(e.match(P)||[]).join(" ")}function gt(e){return e.getAttribute&&e.getAttribute("class")||""}function vt(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(P)||[]}S.fn.extend({prop:function(e,t){return $(this,S.prop,e,t,1<arguments.length)},removeProp:function(e){return this.each(function(){delete this[S.propFix[e]||e]})}}),S.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&S.isXMLDoc(e)||(t=S.propFix[t]||t,i=S.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=S.find.attr(e,"tabindex");return t?parseInt(t,10):pt.test(e.nodeName)||dt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),y.optSelected||(S.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),S.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){S.propFix[this.toLowerCase()]=this}),S.fn.extend({addClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).addClass(t.call(this,e,gt(this)))});if((e=vt(t)).length)while(n=this[u++])if(i=gt(n),r=1===n.nodeType&&" "+ht(i)+" "){a=0;while(o=e[a++])r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=ht(r))&&n.setAttribute("class",s)}return this},removeClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).removeClass(t.call(this,e,gt(this)))});if(!arguments.length)return this.attr("class","");if((e=vt(t)).length)while(n=this[u++])if(i=gt(n),r=1===n.nodeType&&" "+ht(i)+" "){a=0;while(o=e[a++])while(-1<r.indexOf(" "+o+" "))r=r.replace(" "+o+" "," ");i!==(s=ht(r))&&n.setAttribute("class",s)}return this},toggleClass:function(i,t){var o=typeof i,a="string"===o||Array.isArray(i);return"boolean"==typeof t&&a?t?this.addClass(i):this.removeClass(i):m(i)?this.each(function(e){S(this).toggleClass(i.call(this,e,gt(this),t),t)}):this.each(function(){var e,t,n,r;if(a){t=0,n=S(this),r=vt(i);while(e=r[t++])n.hasClass(e)?n.removeClass(e):n.addClass(e)}else void 0!==i&&"boolean"!==o||((e=gt(this))&&Y.set(this,"__className__",e),this.setAttribute&&this.setAttribute("class",e||!1===i?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=this[r++])if(1===n.nodeType&&-1<(" "+ht(gt(n))+" ").indexOf(t))return!0;return!1}});var yt=/\r/g;S.fn.extend({val:function(n){var r,e,i,t=this[0];return arguments.length?(i=m(n),this.each(function(e){var t;1===this.nodeType&&(null==(t=i?n.call(this,e,S(this).val()):n)?t="":"number"==typeof t?t+="":Array.isArray(t)&&(t=S.map(t,function(e){return null==e?"":e+""})),(r=S.valHooks[this.type]||S.valHooks[this.nodeName.toLowerCase()])&&"set"in r&&void 0!==r.set(this,t,"value")||(this.value=t))})):t?(r=S.valHooks[t.type]||S.valHooks[t.nodeName.toLowerCase()])&&"get"in r&&void 0!==(e=r.get(t,"value"))?e:"string"==typeof(e=t.value)?e.replace(yt,""):null==e?"":e:void 0}}),S.extend({valHooks:{option:{get:function(e){var t=S.find.attr(e,"value");return null!=t?t:ht(S.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],u=a?o+1:i.length;for(r=o<0?u:a?o:0;r<u;r++)if(((n=i[r]).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=S(n).val(),a)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=S.makeArray(t),a=i.length;while(a--)((r=i[a]).selected=-1<S.inArray(S.valHooks.option.get(r),o))&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),S.each(["radio","checkbox"],function(){S.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=-1<S.inArray(S(e).val(),t)}},y.checkOn||(S.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),y.focusin="onfocusin"in C;var mt=/^(?:focusinfocus|focusoutblur)$/,xt=function(e){e.stopPropagation()};S.extend(S.event,{trigger:function(e,t,n,r){var i,o,a,s,u,l,c,f,p=[n||E],d=v.call(e,"type")?e.type:e,h=v.call(e,"namespace")?e.namespace.split("."):[];if(o=f=a=n=n||E,3!==n.nodeType&&8!==n.nodeType&&!mt.test(d+S.event.triggered)&&(-1<d.indexOf(".")&&(d=(h=d.split(".")).shift(),h.sort()),u=d.indexOf(":")<0&&"on"+d,(e=e[S.expando]?e:new S.Event(d,"object"==typeof e&&e)).isTrigger=r?2:3,e.namespace=h.join("."),e.rnamespace=e.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,e.result=void 0,e.target||(e.target=n),t=null==t?[e]:S.makeArray(t,[e]),c=S.event.special[d]||{},r||!c.trigger||!1!==c.trigger.apply(n,t))){if(!r&&!c.noBubble&&!x(n)){for(s=c.delegateType||d,mt.test(s+d)||(o=o.parentNode);o;o=o.parentNode)p.push(o),a=o;a===(n.ownerDocument||E)&&p.push(a.defaultView||a.parentWindow||C)}i=0;while((o=p[i++])&&!e.isPropagationStopped())f=o,e.type=1<i?s:c.bindType||d,(l=(Y.get(o,"events")||Object.create(null))[e.type]&&Y.get(o,"handle"))&&l.apply(o,t),(l=u&&o[u])&&l.apply&&V(o)&&(e.result=l.apply(o,t),!1===e.result&&e.preventDefault());return e.type=d,r||e.isDefaultPrevented()||c._default&&!1!==c._default.apply(p.pop(),t)||!V(n)||u&&m(n[d])&&!x(n)&&((a=n[u])&&(n[u]=null),S.event.triggered=d,e.isPropagationStopped()&&f.addEventListener(d,xt),n[d](),e.isPropagationStopped()&&f.removeEventListener(d,xt),S.event.triggered=void 0,a&&(n[u]=a)),e.result}},simulate:function(e,t,n){var r=S.extend(new S.Event,n,{type:e,isSimulated:!0});S.event.trigger(r,null,t)}}),S.fn.extend({trigger:function(e,t){return this.each(function(){S.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return S.event.trigger(e,t,n,!0)}}),y.focusin||S.each({focus:"focusin",blur:"focusout"},function(n,r){var i=function(e){S.event.simulate(r,e.target,S.event.fix(e))};S.event.special[r]={setup:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r);t||e.addEventListener(n,i,!0),Y.access(e,r,(t||0)+1)},teardown:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r)-1;t?Y.access(e,r,t):(e.removeEventListener(n,i,!0),Y.remove(e,r))}}});var bt=C.location,wt={guid:Date.now()},Tt=/\?/;S.parseXML=function(e){var t,n;if(!e||"string"!=typeof e)return null;try{t=(new C.DOMParser).parseFromString(e,"text/xml")}catch(e){}return n=t&&t.getElementsByTagName("parsererror")[0],t&&!n||S.error("Invalid XML: "+(n?S.map(n.childNodes,function(e){return e.textContent}).join("\n"):e)),t};var Ct=/\[\]$/,Et=/\r?\n/g,St=/^(?:submit|button|image|reset|file)$/i,kt=/^(?:input|select|textarea|keygen)/i;function At(n,e,r,i){var t;if(Array.isArray(e))S.each(e,function(e,t){r||Ct.test(n)?i(n,t):At(n+"["+("object"==typeof t&&null!=t?e:"")+"]",t,r,i)});else if(r||"object"!==w(e))i(n,e);else for(t in e)At(n+"["+t+"]",e[t],r,i)}S.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(null==e)return"";if(Array.isArray(e)||e.jquery&&!S.isPlainObject(e))S.each(e,function(){i(this.name,this.value)});else for(n in e)At(n,e[n],t,i);return r.join("&")},S.fn.extend({serialize:function(){return S.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=S.prop(this,"elements");return e?S.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!S(this).is(":disabled")&&kt.test(this.nodeName)&&!St.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=S(this).val();return null==n?null:Array.isArray(n)?S.map(n,function(e){return{name:t.name,value:e.replace(Et,"\r\n")}}):{name:t.name,value:n.replace(Et,"\r\n")}}).get()}});var Nt=/%20/g,jt=/#.*$/,Dt=/([?&])_=[^&]*/,qt=/^(.*?):[ \t]*([^\r\n]*)$/gm,Lt=/^(?:GET|HEAD)$/,Ht=/^\/\//,Ot={},Pt={},Rt="*/".concat("*"),Mt=E.createElement("a");function It(o){return function(e,t){"string"!=typeof e&&(t=e,e="*");var n,r=0,i=e.toLowerCase().match(P)||[];if(m(t))while(n=i[r++])"+"===n[0]?(n=n.slice(1)||"*",(o[n]=o[n]||[]).unshift(t)):(o[n]=o[n]||[]).push(t)}}function Wt(t,i,o,a){var s={},u=t===Pt;function l(e){var r;return s[e]=!0,S.each(t[e]||[],function(e,t){var n=t(i,o,a);return"string"!=typeof n||u||s[n]?u?!(r=n):void 0:(i.dataTypes.unshift(n),l(n),!1)}),r}return l(i.dataTypes[0])||!s["*"]&&l("*")}function Ft(e,t){var n,r,i=S.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((i[n]?e:r||(r={}))[n]=t[n]);return r&&S.extend(!0,e,r),e}Mt.href=bt.href,S.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:bt.href,type:"GET",isLocal:/^(?:about|app|app-storage|.+-extension|file|res|widget):$/.test(bt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Rt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":S.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?Ft(Ft(e,S.ajaxSettings),t):Ft(S.ajaxSettings,e)},ajaxPrefilter:It(Ot),ajaxTransport:It(Pt),ajax:function(e,t){"object"==typeof e&&(t=e,e=void 0),t=t||{};var c,f,p,n,d,r,h,g,i,o,v=S.ajaxSetup({},t),y=v.context||v,m=v.context&&(y.nodeType||y.jquery)?S(y):S.event,x=S.Deferred(),b=S.Callbacks("once memory"),w=v.statusCode||{},a={},s={},u="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(h){if(!n){n={};while(t=qt.exec(p))n[t[1].toLowerCase()+" "]=(n[t[1].toLowerCase()+" "]||[]).concat(t[2])}t=n[e.toLowerCase()+" "]}return null==t?null:t.join(", ")},getAllResponseHeaders:function(){return h?p:null},setRequestHeader:function(e,t){return null==h&&(e=s[e.toLowerCase()]=s[e.toLowerCase()]||e,a[e]=t),this},overrideMimeType:function(e){return null==h&&(v.mimeType=e),this},statusCode:function(e){var t;if(e)if(h)T.always(e[T.status]);else for(t in e)w[t]=[w[t],e[t]];return this},abort:function(e){var t=e||u;return c&&c.abort(t),l(0,t),this}};if(x.promise(T),v.url=((e||v.url||bt.href)+"").replace(Ht,bt.protocol+"//"),v.type=t.method||t.type||v.method||v.type,v.dataTypes=(v.dataType||"*").toLowerCase().match(P)||[""],null==v.crossDomain){r=E.createElement("a");try{r.href=v.url,r.href=r.href,v.crossDomain=Mt.protocol+"//"+Mt.host!=r.protocol+"//"+r.host}catch(e){v.crossDomain=!0}}if(v.data&&v.processData&&"string"!=typeof v.data&&(v.data=S.param(v.data,v.traditional)),Wt(Ot,v,t,T),h)return T;for(i in(g=S.event&&v.global)&&0==S.active++&&S.event.trigger("ajaxStart"),v.type=v.type.toUpperCase(),v.hasContent=!Lt.test(v.type),f=v.url.replace(jt,""),v.hasContent?v.data&&v.processData&&0===(v.contentType||"").indexOf("application/x-www-form-urlencoded")&&(v.data=v.data.replace(Nt,"+")):(o=v.url.slice(f.length),v.data&&(v.processData||"string"==typeof v.data)&&(f+=(Tt.test(f)?"&":"?")+v.data,delete v.data),!1===v.cache&&(f=f.replace(Dt,"$1"),o=(Tt.test(f)?"&":"?")+"_="+wt.guid+++o),v.url=f+o),v.ifModified&&(S.lastModified[f]&&T.setRequestHeader("If-Modified-Since",S.lastModified[f]),S.etag[f]&&T.setRequestHeader("If-None-Match",S.etag[f])),(v.data&&v.hasContent&&!1!==v.contentType||t.contentType)&&T.setRequestHeader("Content-Type",v.contentType),T.setRequestHeader("Accept",v.dataTypes[0]&&v.accepts[v.dataTypes[0]]?v.accepts[v.dataTypes[0]]+("*"!==v.dataTypes[0]?", "+Rt+"; q=0.01":""):v.accepts["*"]),v.headers)T.setRequestHeader(i,v.headers[i]);if(v.beforeSend&&(!1===v.beforeSend.call(y,T,v)||h))return T.abort();if(u="abort",b.add(v.complete),T.done(v.success),T.fail(v.error),c=Wt(Pt,v,t,T)){if(T.readyState=1,g&&m.trigger("ajaxSend",[T,v]),h)return T;v.async&&0<v.timeout&&(d=C.setTimeout(function(){T.abort("timeout")},v.timeout));try{h=!1,c.send(a,l)}catch(e){if(h)throw e;l(-1,e)}}else l(-1,"No Transport");function l(e,t,n,r){var i,o,a,s,u,l=t;h||(h=!0,d&&C.clearTimeout(d),c=void 0,p=r||"",T.readyState=0<e?4:0,i=200<=e&&e<300||304===e,n&&(s=function(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u[0])u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(s[i]&&s[i].test(r)){u.unshift(i);break}if(u[0]in n)o=u[0];else{for(i in n){if(!u[0]||e.converters[i+" "+u[0]]){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u[0]&&u.unshift(o),n[o]}(v,T,n)),!i&&-1<S.inArray("script",v.dataTypes)&&S.inArray("json",v.dataTypes)<0&&(v.converters["text script"]=function(){}),s=function(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)l[a.toLowerCase()]=e.converters[a];o=c.shift();while(o)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=l[u+" "+o]||l["* "+o]))for(i in l)if((s=i.split(" "))[1]===o&&(a=l[u+" "+s[0]]||l["* "+s[0]])){!0===a?a=l[i]:!0!==l[i]&&(o=s[0],c.unshift(s[1]));break}if(!0!==a)if(a&&e["throws"])t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}(v,s,T,i),i?(v.ifModified&&((u=T.getResponseHeader("Last-Modified"))&&(S.lastModified[f]=u),(u=T.getResponseHeader("etag"))&&(S.etag[f]=u)),204===e||"HEAD"===v.type?l="nocontent":304===e?l="notmodified":(l=s.state,o=s.data,i=!(a=s.error))):(a=l,!e&&l||(l="error",e<0&&(e=0))),T.status=e,T.statusText=(t||l)+"",i?x.resolveWith(y,[o,l,T]):x.rejectWith(y,[T,l,a]),T.statusCode(w),w=void 0,g&&m.trigger(i?"ajaxSuccess":"ajaxError",[T,v,i?o:a]),b.fireWith(y,[T,l]),g&&(m.trigger("ajaxComplete",[T,v]),--S.active||S.event.trigger("ajaxStop")))}return T},getJSON:function(e,t,n){return S.get(e,t,n,"json")},getScript:function(e,t){return S.get(e,void 0,t,"script")}}),S.each(["get","post"],function(e,i){S[i]=function(e,t,n,r){return m(t)&&(r=r||n,n=t,t=void 0),S.ajax(S.extend({url:e,type:i,dataType:r,data:t,success:n},S.isPlainObject(e)&&e))}}),S.ajaxPrefilter(function(e){var t;for(t in e.headers)"content-type"===t.toLowerCase()&&(e.contentType=e.headers[t]||"")}),S._evalUrl=function(e,t,n){return S.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,converters:{"text script":function(){}},dataFilter:function(e){S.globalEval(e,t,n)}})},S.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=S(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(n){return m(n)?this.each(function(e){S(this).wrapInner(n.call(this,e))}):this.each(function(){var e=S(this),t=e.contents();t.length?t.wrapAll(n):e.append(n)})},wrap:function(t){var n=m(t);return this.each(function(e){S(this).wrapAll(n?t.call(this,e):t)})},unwrap:function(e){return this.parent(e).not("body").each(function(){S(this).replaceWith(this.childNodes)}),this}}),S.expr.pseudos.hidden=function(e){return!S.expr.pseudos.visible(e)},S.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},S.ajaxSettings.xhr=function(){try{return new C.XMLHttpRequest}catch(e){}};var Bt={0:200,1223:204},$t=S.ajaxSettings.xhr();y.cors=!!$t&&"withCredentials"in $t,y.ajax=$t=!!$t,S.ajaxTransport(function(i){var o,a;if(y.cors||$t&&!i.crossDomain)return{send:function(e,t){var n,r=i.xhr();if(r.open(i.type,i.url,i.async,i.username,i.password),i.xhrFields)for(n in i.xhrFields)r[n]=i.xhrFields[n];for(n in i.mimeType&&r.overrideMimeType&&r.overrideMimeType(i.mimeType),i.crossDomain||e["X-Requested-With"]||(e["X-Requested-With"]="XMLHttpRequest"),e)r.setRequestHeader(n,e[n]);o=function(e){return function(){o&&(o=a=r.onload=r.onerror=r.onabort=r.ontimeout=r.onreadystatechange=null,"abort"===e?r.abort():"error"===e?"number"!=typeof r.status?t(0,"error"):t(r.status,r.statusText):t(Bt[r.status]||r.status,r.statusText,"text"!==(r.responseType||"text")||"string"!=typeof r.responseText?{binary:r.response}:{text:r.responseText},r.getAllResponseHeaders()))}},r.onload=o(),a=r.onerror=r.ontimeout=o("error"),void 0!==r.onabort?r.onabort=a:r.onreadystatechange=function(){4===r.readyState&&C.setTimeout(function(){o&&a()})},o=o("abort");try{r.send(i.hasContent&&i.data||null)}catch(e){if(o)throw e}},abort:function(){o&&o()}}}),S.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),S.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return S.globalEval(e),e}}}),S.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),S.ajaxTransport("script",function(n){var r,i;if(n.crossDomain||n.scriptAttrs)return{send:function(e,t){r=S("<script>").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r[0])},abort:function(){i&&i()}}});var _t,zt=[],Ut=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=zt.pop()||S.expando+"_"+wt.guid++;return this[e]=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Ut.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes[0])return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?e[a]=e[a].replace(Ut,"$1"+r):!1!==e.jsonp&&(e.url+=(Tt.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters["script json"]=function(){return o||S.error(r+" was not called"),o[0]},e.dataTypes[0]="json",i=C[r],C[r]=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):C[r]=i,e[r]&&(e.jsonpCallback=t.jsonpCallback,zt.push(r)),o&&m(i)&&i(o[0]),o=i=void 0}),"script"}),y.createHTMLDocument=((_t=E.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===_t.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&[],(i=N.exec(e))?[t.createElement(i[1])]:(i=xe([e],t,o),o&&o.length&&S(o).remove(),S.merge([],i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1<s&&(r=ht(e.slice(s)),e=e.slice(0,s)),m(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),0<a.length&&S.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,a.html(r?S("<div>").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this[0];return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fn[t]=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?r[i]:e[t];r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):e[t]=n},t,e,arguments.length)}}),S.each(["top","left"],function(e,n){S.cssHooks[n]=Fe(y.pixelPosition,function(e,t){if(t)return t=We(e,n),Pe.test(t)?S(e).position()[n]+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fn[o]=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e["inner"+a]:e.document.documentElement["client"+a]:9===e.nodeType?(r=e.documentElement,Math.max(e.body["scroll"+a],r["scroll"+a],e.body["offset"+a],r["offset"+a],r["client"+a])):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){S.fn[t]=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fn[n]=function(e,t){return 0<arguments.length?this.on(n,null,e,t):this.trigger(n)}});var Xt=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;S.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=s.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(s.call(arguments)))}).guid=e.guid=e.guid||S.guid++,i},S.holdReady=function(e){e?S.readyWait++:S.ready(!0)},S.isArray=Array.isArray,S.parseJSON=JSON.parse,S.nodeName=A,S.isFunction=m,S.isWindow=x,S.camelCase=X,S.type=w,S.now=Date.now,S.isNumeric=function(e){var t=S.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},S.trim=function(e){return null==e?"":(e+"").replace(Xt,"")},"function"==typeof define&&define.amd&&define("jquery",[],function(){return S});var Vt=C.jQuery,Gt=C.$;return S.noConflict=function(e){return C.$===S&&(C.$=Gt),e&&C.jQuery===S&&(C.jQuery=Vt),S},"undefined"==typeof e&&(C.jQuery=C.$=S),S});
diff --git a/pr-2241/_static/js/badge_only.js b/pr-2241/_static/js/badge_only.js
new file mode 100644
index 0000000000..526d7234b6
--- /dev/null
+++ b/pr-2241/_static/js/badge_only.js
@@ -0,0 +1 @@
+!function(e){var t={};function r(n){if(t[n])return t[n].exports;var o=t[n]={i:n,l:!1,exports:{}};return e[n].call(o.exports,o,o.exports,r),o.l=!0,o.exports}r.m=e,r.c=t,r.d=function(e,t,n){r.o(e,t)||Object.defineProperty(e,t,{enumerable:!0,get:n})},r.r=function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(e){var t=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(t,"a",t),t},r.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r.p="",r(r.s=4)}({4:function(e,t,r){}});
\ No newline at end of file
diff --git a/pr-2241/_static/js/html5shiv-printshiv.min.js b/pr-2241/_static/js/html5shiv-printshiv.min.js
new file mode 100644
index 0000000000..2b43bd062e
--- /dev/null
+++ b/pr-2241/_static/js/html5shiv-printshiv.min.js
@@ -0,0 +1,4 @@
+/**
+* @preserve HTML5 Shiv 3.7.3-pre | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
+*/
+!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=y.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=y.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),y.elements=c+" "+a,j(b)}function f(a){var b=x[a[v]];return b||(b={},w++,a[v]=w,x[w]=b),b}function g(a,c,d){if(c||(c=b),q)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():u.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||t.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),q)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return y.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(y,b.frag)}function j(a){a||(a=b);var d=f(a);return!y.shivCSS||p||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),q||i(a,d),a}function k(a){for(var b,c=a.getElementsByTagName("*"),e=c.length,f=RegExp("^(?:"+d().join("|")+")$","i"),g=[];e--;)b=c[e],f.test(b.nodeName)&&g.push(b.applyElement(l(b)));return g}function l(a){for(var b,c=a.attributes,d=c.length,e=a.ownerDocument.createElement(A+":"+a.nodeName);d--;)b=c[d],b.specified&&e.setAttribute(b.nodeName,b.nodeValue);return e.style.cssText=a.style.cssText,e}function m(a){for(var b,c=a.split("{"),e=c.length,f=RegExp("(^|[\\s,>+~])("+d().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),g="$1"+A+"\\:$2";e--;)b=c[e]=c[e].split("}"),b[b.length-1]=b[b.length-1].replace(f,g),c[e]=b.join("}");return c.join("{")}function n(a){for(var b=a.length;b--;)a[b].removeNode()}function o(a){function b(){clearTimeout(g._removeSheetTimer),d&&d.removeNode(!0),d=null}var d,e,g=f(a),h=a.namespaces,i=a.parentWindow;return!B||a.printShived?a:("undefined"==typeof h[A]&&h.add(A),i.attachEvent("onbeforeprint",function(){b();for(var f,g,h,i=a.styleSheets,j=[],l=i.length,n=Array(l);l--;)n[l]=i[l];for(;h=n.pop();)if(!h.disabled&&z.test(h.media)){try{f=h.imports,g=f.length}catch(o){g=0}for(l=0;g>l;l++)n.push(f[l]);try{j.push(h.cssText)}catch(o){}}j=m(j.reverse().join("")),e=k(a),d=c(a,j)}),i.attachEvent("onafterprint",function(){n(e),clearTimeout(g._removeSheetTimer),g._removeSheetTimer=setTimeout(b,500)}),a.printShived=!0,a)}var p,q,r="3.7.3",s=a.html5||{},t=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,u=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,v="_html5shiv",w=0,x={};!function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",p="hidden"in a,q=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){p=!0,q=!0}}();var y={elements:s.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:r,shivCSS:s.shivCSS!==!1,supportsUnknownElements:q,shivMethods:s.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=y,j(b);var z=/^$|\b(?:all|print)\b/,A="html5shiv",B=!q&&function(){var c=b.documentElement;return!("undefined"==typeof b.namespaces||"undefined"==typeof b.parentWindow||"undefined"==typeof c.applyElement||"undefined"==typeof c.removeNode||"undefined"==typeof a.attachEvent)}();y.type+=" print",y.shivPrint=o,o(b),"object"==typeof module&&module.exports&&(module.exports=y)}("undefined"!=typeof window?window:this,document);
\ No newline at end of file
diff --git a/pr-2241/_static/js/html5shiv.min.js b/pr-2241/_static/js/html5shiv.min.js
new file mode 100644
index 0000000000..cd1c674f5e
--- /dev/null
+++ b/pr-2241/_static/js/html5shiv.min.js
@@ -0,0 +1,4 @@
+/**
+* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
+*/
+!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3-pre",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document);
\ No newline at end of file
diff --git a/pr-2241/_static/js/theme.js b/pr-2241/_static/js/theme.js
new file mode 100644
index 0000000000..1fddb6ee4a
--- /dev/null
+++ b/pr-2241/_static/js/theme.js
@@ -0,0 +1 @@
+!function(n){var e={};function t(i){if(e[i])return e[i].exports;var o=e[i]={i:i,l:!1,exports:{}};return n[i].call(o.exports,o,o.exports,t),o.l=!0,o.exports}t.m=n,t.c=e,t.d=function(n,e,i){t.o(n,e)||Object.defineProperty(n,e,{enumerable:!0,get:i})},t.r=function(n){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(n,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(n,"__esModule",{value:!0})},t.t=function(n,e){if(1&e&&(n=t(n)),8&e)return n;if(4&e&&"object"==typeof n&&n&&n.__esModule)return n;var i=Object.create(null);if(t.r(i),Object.defineProperty(i,"default",{enumerable:!0,value:n}),2&e&&"string"!=typeof n)for(var o in n)t.d(i,o,function(e){return n[e]}.bind(null,o));return i},t.n=function(n){var e=n&&n.__esModule?function(){return n.default}:function(){return n};return t.d(e,"a",e),e},t.o=function(n,e){return Object.prototype.hasOwnProperty.call(n,e)},t.p="",t(t.s=0)}([function(n,e,t){t(1),n.exports=t(3)},function(n,e,t){(function(){var e="undefined"!=typeof window?window.jQuery:t(2);n.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var t=this;void 0===n&&(n=!0),t.isRunning||(t.isRunning=!0,e((function(e){t.init(e),t.reset(),t.win.on("hashchange",t.reset),n&&t.win.on("scroll",(function(){t.linkScroll||t.winScroll||(t.winScroll=!0,requestAnimationFrame((function(){t.onScroll()})))})),t.win.on("resize",(function(){t.winResize||(t.winResize=!0,requestAnimationFrame((function(){t.onResize()})))})),t.onResize()})))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",(function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")})).on("click",".wy-menu-vertical .current ul li a",(function(){var t=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(t),e.hashChange()})).on("click","[data-toggle='rst-current-version']",(function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")})),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),n("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),n("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n('<button class="toctree-expand" title="Open/close menu"></button>'),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}if(t.length>0){$(".wy-menu-vertical .current").removeClass("current").attr("aria-expanded","false"),t.addClass("current").attr("aria-expanded","true"),t.closest("li.toctree-l1").parent().addClass("current").attr("aria-expanded","true");for(let n=1;n<=10;n++)t.closest("li.toctree-l"+n).addClass("current").attr("aria-expanded","true");t[0].scrollIntoView()}}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current").attr("aria-expanded","false"),e.siblings().find("li.current").removeClass("current").attr("aria-expanded","false");var t=e.find("> ul li");t.length&&(t.removeClass("current").attr("aria-expanded","false"),e.toggleClass("current").attr("aria-expanded",(function(n,e){return"true"==e?"false":"true"})))}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t<e.length&&!window.requestAnimationFrame;++t)window.requestAnimationFrame=window[e[t]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[t]+"CancelAnimationFrame"]||window[e[t]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,t){var i=(new Date).getTime(),o=Math.max(0,16-(i-n)),r=window.setTimeout((function(){e(i+o)}),o);return n=i+o,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)})}()}).call(window)},function(n,e){n.exports=jQuery},function(n,e,t){}]);
\ No newline at end of file
diff --git a/pr-2241/_static/jupyterlite_badge_logo.svg b/pr-2241/_static/jupyterlite_badge_logo.svg
new file mode 100644
index 0000000000..5de36d7fd5
--- /dev/null
+++ b/pr-2241/_static/jupyterlite_badge_logo.svg
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="91px" height="20px" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;"><g transform="matrix(1,0,0,1,-17102,-9779)"><g id="lite-badge-launch" transform="matrix(0.0930728,0,0,0.0635416,15477.2,9173.48)"><rect x="17457.1" y="9529.53" width="977.729" height="314.755" style="fill:none;"/><clipPath id="_clip1"><rect x="17457.1" y="9529.53" width="977.729" height="314.755"/></clipPath><g clip-path="url(#_clip1)"><g transform="matrix(1.03361,0,0,1,-586.737,-1.01863e-10)"><g transform="matrix(2.43224,0,0,2.42119,-20084.1,-14912.4)"><path d="M15802.4,10095L15447.7,10095C15440.6,10095 15434.8,10103.8 15434.8,10114.5L15434.8,10205.5C15434.8,10216.3 15440.6,10225 15447.7,10225L15802.4,10225L15802.4,10095Z" style="fill:rgb(85,85,85);"/></g><g transform="matrix(-0.76361,0,0,2.42119,30189.2,-14912.4)"><path d="M15802.4,10095L15475.7,10095C15453.1,10095 15434.8,10103.8 15434.8,10114.5L15434.8,10205.5C15434.8,10216.3 15453.1,10225 15475.7,10225L15802.4,10225L15802.4,10095Z" style="fill:rgb(247,220,30);"/></g><g transform="matrix(2.74885,0,0,12.7513,10841.5,-10210.3)"><g transform="matrix(0.845162,0,0,0.273799,2185.28,1469.95)"><circle cx="316.432" cy="323.632" r="24.936" style="fill:rgb(247,220,30);"/></g><g transform="matrix(0.845162,0,0,0.273799,2185.28,1469.95)"><path d="M326.851,350.903C326.851,349.85 326.002,348.995 324.957,348.995L307.381,348.995C306.336,348.995 305.487,349.85 305.487,350.903C305.487,351.957 306.336,352.812 307.381,352.812L324.957,352.812C326.002,352.812 326.851,351.957 326.851,350.903Z" style="fill:rgb(249,249,249);"/></g><g transform="matrix(0.845162,0,0,0.273799,2185.28,1469.95)"><path d="M326.828,355.958C326.828,354.883 325.962,354.01 324.895,354.01L307.443,354.01C306.376,354.01 305.509,354.883 305.509,355.958C305.509,357.033 306.376,357.906 307.443,357.906L324.895,357.906C325.962,357.906 326.828,357.033 326.828,355.958Z" style="fill:rgb(249,249,249);"/></g><g transform="matrix(0.845162,0,0,0.273799,2185.28,1469.95)"><path d="M322.293,361.032C322.293,359.968 321.436,359.104 320.38,359.104L311.962,359.104C310.906,359.104 310.048,359.968 310.048,361.032C310.048,362.096 310.906,362.959 311.962,362.959L320.38,362.959C321.436,362.959 322.293,362.096 322.293,361.032Z" style="fill:rgb(249,249,249);"/></g><g transform="matrix(0.845162,0,0,0.273799,2425.45,1551.72)"><g transform="matrix(1,0,0,1,-288.772,-300.351)"><path d="M329.047,341.228C326.537,341.125 324.679,339.593 323.472,336.633C322.575,334.405 322.127,331.677 322.127,328.447C322.127,328.28 322.137,328.066 322.157,327.804C322.303,325.607 322.71,323.592 323.378,321.757C324.461,318.802 325.992,317.324 327.97,317.324C328.076,317.324 328.185,317.329 328.299,317.339C330.1,317.453 331.001,318.498 331.001,320.476C331.001,322.635 330.074,325.031 328.219,327.664C327.043,329.342 325.808,330.703 324.515,331.746C324.871,333.724 325.261,335.208 325.687,336.198C326.481,338.03 327.659,338.946 329.221,338.946C329.324,338.946 329.434,338.936 329.55,338.915C329.892,338.852 330.371,338.603 330.986,338.167C331.58,337.759 332.044,337.555 332.376,337.555C332.523,337.555 332.664,337.603 332.8,337.698C333.102,337.905 333.253,338.186 333.253,338.541C333.231,339.083 332.845,339.64 332.097,340.212C331.159,340.889 330.143,341.228 329.047,341.228ZM327.989,319.683C327.371,319.693 326.83,319.957 326.364,320.476C325.174,321.822 324.523,324.631 324.41,328.904C325.035,328.267 325.659,327.516 326.284,326.652C328.013,324.286 328.877,322.29 328.877,320.665C328.877,320.582 328.855,320.484 328.813,320.37C328.646,319.912 328.37,319.683 327.985,319.683L327.989,319.683Z" style="fill:rgb(85,85,85);fill-rule:nonzero;"/></g><g transform="matrix(1,0,0,1,-288.772,-300.351)"><path d="M321.235,316.187C321.235,316.188 321.235,316.189 321.235,316.19C321.235,317.629 320.051,318.813 318.612,318.813L318.612,318.813C317.173,318.813 315.989,317.629 315.989,316.19C315.989,316.189 315.989,316.188 315.989,316.187C315.989,314.748 317.173,313.564 318.612,313.564C320.051,313.564 321.235,314.748 321.235,316.187Z" style="fill:rgb(85,85,85);fill-rule:nonzero;"/></g><g transform="matrix(1,0,0,1,-288.772,-300.351)"><path d="M318.049,319.981C318.727,319.991 319.076,320.432 319.096,321.304L317.361,333.711C319.966,331.721 321.43,330.596 321.753,330.336C322.138,330.004 322.534,329.832 322.94,329.822C323.086,329.822 323.227,329.869 323.363,329.962C323.665,330.171 323.816,330.437 323.816,330.76C323.804,331.261 323.522,331.746 322.97,332.215C321.44,333.505 319.415,335.092 316.893,336.977L316.175,342.15C316.144,342.39 316.098,342.624 316.035,342.853C315.556,344.685 314.353,345.601 312.426,345.601C311.468,345.601 310.624,345.242 309.893,344.524C309.175,343.806 308.816,342.999 308.816,342.105C308.816,341.165 309.041,340.394 309.489,339.792C309.738,339.48 310.227,339.051 310.955,338.507L314.704,335.695C316.027,326.958 316.705,322.365 316.738,321.916C316.738,321.853 316.743,321.796 316.753,321.746C316.866,320.569 317.298,319.981 318.049,319.981ZM313.941,340.899L314.206,338.995L312.471,340.321C311.72,340.883 311.34,341.415 311.33,341.916C311.33,342.092 311.361,342.259 311.424,342.415C311.6,342.874 311.934,343.103 312.426,343.103C312.622,343.103 312.798,343.071 312.955,343.008C313.456,342.789 313.784,342.086 313.937,340.899L313.941,340.899ZM317.331,316.995C317.331,316.809 317.378,316.633 317.471,316.466C317.69,316.058 318.029,315.854 318.488,315.854C318.674,315.854 318.855,315.901 319.032,315.994C319.43,316.213 319.629,316.547 319.629,316.995C319.629,317.182 319.581,317.365 319.485,317.543C319.269,317.939 318.936,318.137 318.488,318.137C318.299,318.137 318.116,318.089 317.94,317.993C317.534,317.787 317.331,317.454 317.331,316.995Z" style="fill:rgb(85,85,85);fill-rule:nonzero;"/></g></g></g><g transform="matrix(3.03205,0,0,14.065,10159.7,-12659.1)"><g transform="matrix(0.295204,0,0,0.0956347,2538.31,1594.22)"><text x="-181.194px" y="0px" style="font-family:'Verdana', sans-serif;font-size:130.5px;fill:rgb(1,1,1);fill-opacity:0.3;">launch</text></g><g transform="matrix(0.295204,0,0,0.0956347,2538.31,1593.26)"><text x="-181.194px" y="0px" style="font-family:'Verdana', sans-serif;font-size:130.5px;fill:white;">launch</text></g></g><g transform="matrix(3.5905,0,0,16.6556,9244.95,-16787)"><g transform="matrix(0.295204,0,0,0.0956347,2538.31,1594.22)"><text x="-181.194px" y="0px" style="font-family:'Verdana', sans-serif;font-size:110px;fill:rgb(1,1,1);fill-opacity:0.1;">lite</text></g><g transform="matrix(0.295204,0,0,0.0956347,2538.31,1593.26)"><text x="-181.194px" y="0px" style="font-family:'Verdana', sans-serif;font-size:110px;fill:rgb(56,56,56);">lite</text></g></g></g></g></g></g></svg>
\ No newline at end of file
diff --git a/pr-2241/_static/language_data.js b/pr-2241/_static/language_data.js
new file mode 100644
index 0000000000..2e22b06ab1
--- /dev/null
+++ b/pr-2241/_static/language_data.js
@@ -0,0 +1,199 @@
+/*
+ * language_data.js
+ * ~~~~~~~~~~~~~~~~
+ *
+ * This script contains the language-specific data used by searchtools.js,
+ * namely the list of stopwords, stemmer, scorer and splitter.
+ *
+ * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"];
+
+
+/* Non-minified version is copied as a separate JS file, is available */
+
+/**
+ * Porter Stemmer
+ */
+var Stemmer = function() {
+
+  var step2list = {
+    ational: 'ate',
+    tional: 'tion',
+    enci: 'ence',
+    anci: 'ance',
+    izer: 'ize',
+    bli: 'ble',
+    alli: 'al',
+    entli: 'ent',
+    eli: 'e',
+    ousli: 'ous',
+    ization: 'ize',
+    ation: 'ate',
+    ator: 'ate',
+    alism: 'al',
+    iveness: 'ive',
+    fulness: 'ful',
+    ousness: 'ous',
+    aliti: 'al',
+    iviti: 'ive',
+    biliti: 'ble',
+    logi: 'log'
+  };
+
+  var step3list = {
+    icate: 'ic',
+    ative: '',
+    alize: 'al',
+    iciti: 'ic',
+    ical: 'ic',
+    ful: '',
+    ness: ''
+  };
+
+  var c = "[^aeiou]";          // consonant
+  var v = "[aeiouy]";          // vowel
+  var C = c + "[^aeiouy]*";    // consonant sequence
+  var V = v + "[aeiou]*";      // vowel sequence
+
+  var mgr0 = "^(" + C + ")?" + V + C;                      // [C]VC... is m>0
+  var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$";    // [C]VC[V] is m=1
+  var mgr1 = "^(" + C + ")?" + V + C + V + C;              // [C]VCVC... is m>1
+  var s_v   = "^(" + C + ")?" + v;                         // vowel in stem
+
+  this.stemWord = function (w) {
+    var stem;
+    var suffix;
+    var firstch;
+    var origword = w;
+
+    if (w.length < 3)
+      return w;
+
+    var re;
+    var re2;
+    var re3;
+    var re4;
+
+    firstch = w.substr(0,1);
+    if (firstch == "y")
+      w = firstch.toUpperCase() + w.substr(1);
+
+    // Step 1a
+    re = /^(.+?)(ss|i)es$/;
+    re2 = /^(.+?)([^s])s$/;
+
+    if (re.test(w))
+      w = w.replace(re,"$1$2");
+    else if (re2.test(w))
+      w = w.replace(re2,"$1$2");
+
+    // Step 1b
+    re = /^(.+?)eed$/;
+    re2 = /^(.+?)(ed|ing)$/;
+    if (re.test(w)) {
+      var fp = re.exec(w);
+      re = new RegExp(mgr0);
+      if (re.test(fp[1])) {
+        re = /.$/;
+        w = w.replace(re,"");
+      }
+    }
+    else if (re2.test(w)) {
+      var fp = re2.exec(w);
+      stem = fp[1];
+      re2 = new RegExp(s_v);
+      if (re2.test(stem)) {
+        w = stem;
+        re2 = /(at|bl|iz)$/;
+        re3 = new RegExp("([^aeiouylsz])\\1$");
+        re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+        if (re2.test(w))
+          w = w + "e";
+        else if (re3.test(w)) {
+          re = /.$/;
+          w = w.replace(re,"");
+        }
+        else if (re4.test(w))
+          w = w + "e";
+      }
+    }
+
+    // Step 1c
+    re = /^(.+?)y$/;
+    if (re.test(w)) {
+      var fp = re.exec(w);
+      stem = fp[1];
+      re = new RegExp(s_v);
+      if (re.test(stem))
+        w = stem + "i";
+    }
+
+    // Step 2
+    re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
+    if (re.test(w)) {
+      var fp = re.exec(w);
+      stem = fp[1];
+      suffix = fp[2];
+      re = new RegExp(mgr0);
+      if (re.test(stem))
+        w = stem + step2list[suffix];
+    }
+
+    // Step 3
+    re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
+    if (re.test(w)) {
+      var fp = re.exec(w);
+      stem = fp[1];
+      suffix = fp[2];
+      re = new RegExp(mgr0);
+      if (re.test(stem))
+        w = stem + step3list[suffix];
+    }
+
+    // Step 4
+    re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
+    re2 = /^(.+?)(s|t)(ion)$/;
+    if (re.test(w)) {
+      var fp = re.exec(w);
+      stem = fp[1];
+      re = new RegExp(mgr1);
+      if (re.test(stem))
+        w = stem;
+    }
+    else if (re2.test(w)) {
+      var fp = re2.exec(w);
+      stem = fp[1] + fp[2];
+      re2 = new RegExp(mgr1);
+      if (re2.test(stem))
+        w = stem;
+    }
+
+    // Step 5
+    re = /^(.+?)e$/;
+    if (re.test(w)) {
+      var fp = re.exec(w);
+      stem = fp[1];
+      re = new RegExp(mgr1);
+      re2 = new RegExp(meq1);
+      re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
+        w = stem;
+    }
+    re = /ll$/;
+    re2 = new RegExp(mgr1);
+    if (re.test(w) && re2.test(w)) {
+      re = /.$/;
+      w = w.replace(re,"");
+    }
+
+    // and turn initial Y back to y
+    if (firstch == "y")
+      w = firstch.toLowerCase() + w.substr(1);
+    return w;
+  }
+}
+
diff --git a/pr-2241/_static/minus.png b/pr-2241/_static/minus.png
new file mode 100644
index 0000000000..d96755fdaf
Binary files /dev/null and b/pr-2241/_static/minus.png differ
diff --git a/pr-2241/_static/nbsphinx-broken-thumbnail.svg b/pr-2241/_static/nbsphinx-broken-thumbnail.svg
new file mode 100644
index 0000000000..4919ca8829
--- /dev/null
+++ b/pr-2241/_static/nbsphinx-broken-thumbnail.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100">
+  <style>
+    svg { fill: lightcoral; }
+    @media (prefers-color-scheme: dark) {
+      svg { fill: crimson; }
+    }
+  </style>
+  <path d="m 80.856887,38.34474 h 2.903414 l 7.066397,13.332221 V 38.34474 h 2.092166 V 54.281494 H 90.01545 L 82.949053,40.949273 v 13.332221 h -2.092166 z m -13.812565,0 h 10.076555 v 1.814633 h -7.920343 v 4.718048 h 7.589439 v 1.814634 h -7.589439 v 5.774805 h 8.11248 v 1.814634 H 67.044322 Z m -14.335606,0 h 2.156212 v 6.735493 L 62.01672,38.34474 h 2.775323 l -7.909669,7.429324 8.475407,8.50743 h -2.839368 l -7.653485,-7.674833 v 7.674833 h -2.156212 z m -10.738365,1.462381 q -2.348349,0 -3.73601,1.750588 -1.376987,1.750588 -1.376987,4.771419 0,3.010158 1.376987,4.760746 1.387661,1.750587 3.73601,1.750587 2.34835,0 3.714663,-1.750587 1.376986,-1.750588 1.376986,-4.760746 0,-3.020831 -1.376986,-4.771419 -1.366313,-1.750588 -3.714663,-1.750588 z m 0,-1.750588 q 3.351736,0 5.358507,2.252281 2.006772,2.241606 2.006772,6.020314 0,3.768034 -2.006772,6.020315 -2.006771,2.241606 -5.358507,2.241606 -3.362409,0 -5.379855,-2.241606 -2.006772,-2.241607 -2.006772,-6.020315 0,-3.778708 2.006772,-6.020314 2.017446,-2.252281 5.379855,-2.252281 z m -14.100771,8.75294 q 0.693831,0.234835 1.344964,1.003385 0.661808,0.768551 1.323615,2.113515 l 2.188235,4.355121 H 30.410068 L 28.371273,50.193231 Q 27.581374,48.592083 26.834172,48.069042 26.097644,47.546 24.816726,47.546 h -2.34835 v 6.735494 H 20.312164 V 38.34474 h 4.867489 q 2.732625,0 4.077588,1.142152 1.344964,1.142151 1.344964,3.447804 0,1.505078 -0.704505,2.49779 -0.69383,0.992711 -2.02812,1.376987 z m -5.401204,-6.692797 v 5.657388 h 2.711277 q 1.55845,0 2.348349,-0.715179 0.800574,-0.725854 0.800574,-2.124189 0,-1.398336 -0.800574,-2.102841 -0.789899,-0.715179 -2.348349,-0.715179 z M 7.4709616,46.670707 v 5.838851 H 10.92944 q 1.739914,0 2.57251,-0.71518 0.843271,-0.725853 0.843271,-2.209583 0,-1.494404 -0.843271,-2.198909 -0.832596,-0.715179 -2.57251,-0.715179 z m 0,-6.554031 v 4.803443 h 3.1916204 q 1.579799,0 2.34835,-0.587088 0.779225,-0.597761 0.779225,-1.814634 0,-1.206197 -0.779225,-1.803959 -0.768551,-0.597762 -2.34835,-0.597762 z M 5.3147497,38.34474 h 5.5079473 q 2.465767,0 3.800057,1.024734 1.334289,1.024734 1.334289,2.914088 0,1.462382 -0.683156,2.327001 -0.683156,0.86462 -2.006772,1.078106 1.590474,0.341579 2.465768,1.430359 0.885968,1.078106 0.885968,2.700602 0,2.134863 -1.451707,3.298364 -1.451707,1.1635 -4.130961,1.1635 H 5.3147497 Z M 65.365328,74.550032 H 67.52154 V 88.67217 h 7.760238 v 1.814634 h -9.91645 z m -6.447298,0 h 2.156214 V 90.486804 H 58.91803 Z m -9.955303,2.124192 -2.924765,7.931025 h 5.860208 z m -1.216872,-2.124192 h 2.444423 l 6.073692,15.936772 h -2.241606 l -1.451709,-4.088268 h -7.183824 l -1.451707,4.088268 H 41.66149 Z m -21.264514,0 h 2.903417 L 36.45116,87.882271 V 74.550032 h 2.092171 V 90.486804 H 35.639914 L 28.573506,77.154569 v 13.332235 h -2.092165 z m 53.454813,-9.781663 v 5.838858 h 3.458479 q 1.739919,0 2.572513,-0.71518 0.843272,-0.725854 0.843272,-2.209586 0,-1.494406 -0.843272,-2.198912 -0.832594,-0.71518 -2.572513,-0.71518 z m 0,-6.554037 v 4.803447 h 3.191622 q 1.579803,0 2.348355,-0.587087 0.779225,-0.597763 0.779225,-1.814636 0,-1.206199 -0.779225,-1.803962 -0.768552,-0.597762 -2.348355,-0.597762 z m -2.156212,-1.771939 h 5.507949 q 2.465772,0 3.800065,1.024736 1.334288,1.024735 1.334288,2.914092 0,1.462383 -0.683157,2.327003 -0.683157,0.864621 -2.006771,1.078107 1.590471,0.341579 2.46577,1.43036 0.885967,1.078107 0.885967,2.700605 0,2.134866 -1.451708,3.298368 -1.451709,1.163502 -4.130963,1.163502 h -5.72144 z m -18.86154,0 h 3.212969 l 4.066921,10.845118 4.088269,-10.845118 H 73.49953 V 72.379166 H 71.396692 V 58.385121 L 67.287075,69.315634 H 65.120183 L 61.010567,58.385121 v 13.994045 h -2.092165 z m -16.246333,0 h 2.166892 v 9.681616 q 0,2.561839 0.928668,3.693318 0.928667,1.120804 3.010159,1.120804 2.070819,0 2.999486,-1.120804 0.928667,-1.131479 0.928667,-3.693318 v -9.681616 h 2.166886 v 9.948474 q 0,3.116904 -1.547776,4.70738 -1.537104,1.590474 -4.547263,1.590474 -3.020833,0 -4.568615,-1.590474 -1.537104,-1.590476 -1.537104,-4.70738 z m -16.192953,0 h 2.156213 v 6.532689 h 7.83496 v -6.532689 h 2.156213 v 15.936773 h -2.156213 v -7.589448 h -7.83496 v 7.589448 h -2.156213 z m -15.563168,0 h 13.481671 v 1.814636 H 18.740226 V 72.379166 H 16.573339 V 58.257029 h -5.657391 z" />
+</svg>
diff --git a/pr-2241/_static/nbsphinx-code-cells.css b/pr-2241/_static/nbsphinx-code-cells.css
new file mode 100644
index 0000000000..a3fb27c30f
--- /dev/null
+++ b/pr-2241/_static/nbsphinx-code-cells.css
@@ -0,0 +1,259 @@
+/* remove conflicting styling from Sphinx themes */
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt *,
+div.nbinput.container div.input_area pre,
+div.nboutput.container div.output_area pre,
+div.nbinput.container div.input_area .highlight,
+div.nboutput.container div.output_area .highlight {
+    border: none;
+    padding: 0;
+    margin: 0;
+    box-shadow: none;
+}
+
+div.nbinput.container > div[class*=highlight],
+div.nboutput.container > div[class*=highlight] {
+    margin: 0;
+}
+
+div.nbinput.container div.prompt *,
+div.nboutput.container div.prompt * {
+    background: none;
+}
+
+div.nboutput.container div.output_area .highlight,
+div.nboutput.container div.output_area pre {
+    background: unset;
+}
+
+div.nboutput.container div.output_area div.highlight {
+    color: unset;  /* override Pygments text color */
+}
+
+/* avoid gaps between output lines */
+div.nboutput.container div[class*=highlight] pre {
+    line-height: normal;
+}
+
+/* input/output containers */
+div.nbinput.container,
+div.nboutput.container {
+    display: -webkit-flex;
+    display: flex;
+    align-items: flex-start;
+    margin: 0;
+    width: 100%;
+}
+@media (max-width: 540px) {
+    div.nbinput.container,
+    div.nboutput.container {
+        flex-direction: column;
+    }
+}
+
+/* input container */
+div.nbinput.container {
+    padding-top: 5px;
+}
+
+/* last container */
+div.nblast.container {
+    padding-bottom: 5px;
+}
+
+/* input prompt */
+div.nbinput.container div.prompt pre,
+/* for sphinx_immaterial theme: */
+div.nbinput.container div.prompt pre > code {
+    color: #307FC1;
+}
+
+/* output prompt */
+div.nboutput.container div.prompt pre,
+/* for sphinx_immaterial theme: */
+div.nboutput.container div.prompt pre > code {
+    color: #BF5B3D;
+}
+
+/* all prompts */
+div.nbinput.container div.prompt,
+div.nboutput.container div.prompt {
+    width: 4.5ex;
+    padding-top: 5px;
+    position: relative;
+    user-select: none;
+}
+
+div.nbinput.container div.prompt > div,
+div.nboutput.container div.prompt > div {
+    position: absolute;
+    right: 0;
+    margin-right: 0.3ex;
+}
+
+@media (max-width: 540px) {
+    div.nbinput.container div.prompt,
+    div.nboutput.container div.prompt {
+        width: unset;
+        text-align: left;
+        padding: 0.4em;
+    }
+    div.nboutput.container div.prompt.empty {
+        padding: 0;
+    }
+
+    div.nbinput.container div.prompt > div,
+    div.nboutput.container div.prompt > div {
+        position: unset;
+    }
+}
+
+/* disable scrollbars and line breaks on prompts */
+div.nbinput.container div.prompt pre,
+div.nboutput.container div.prompt pre {
+    overflow: hidden;
+    white-space: pre;
+}
+
+/* input/output area */
+div.nbinput.container div.input_area,
+div.nboutput.container div.output_area {
+    -webkit-flex: 1;
+    flex: 1;
+    overflow: auto;
+}
+@media (max-width: 540px) {
+    div.nbinput.container div.input_area,
+    div.nboutput.container div.output_area {
+        width: 100%;
+    }
+}
+
+/* input area */
+div.nbinput.container div.input_area {
+    border: 1px solid #e0e0e0;
+    border-radius: 2px;
+    /*background: #f5f5f5;*/
+}
+
+/* override MathJax center alignment in output cells */
+div.nboutput.container div[class*=MathJax] {
+    text-align: left !important;
+}
+
+/* override sphinx.ext.imgmath center alignment in output cells */
+div.nboutput.container div.math p {
+    text-align: left;
+}
+
+/* standard error */
+div.nboutput.container div.output_area.stderr {
+    background: #fdd;
+}
+
+/* ANSI colors */
+.ansi-black-fg { color: #3E424D; }
+.ansi-black-bg { background-color: #3E424D; }
+.ansi-black-intense-fg { color: #282C36; }
+.ansi-black-intense-bg { background-color: #282C36; }
+.ansi-red-fg { color: #E75C58; }
+.ansi-red-bg { background-color: #E75C58; }
+.ansi-red-intense-fg { color: #B22B31; }
+.ansi-red-intense-bg { background-color: #B22B31; }
+.ansi-green-fg { color: #00A250; }
+.ansi-green-bg { background-color: #00A250; }
+.ansi-green-intense-fg { color: #007427; }
+.ansi-green-intense-bg { background-color: #007427; }
+.ansi-yellow-fg { color: #DDB62B; }
+.ansi-yellow-bg { background-color: #DDB62B; }
+.ansi-yellow-intense-fg { color: #B27D12; }
+.ansi-yellow-intense-bg { background-color: #B27D12; }
+.ansi-blue-fg { color: #208FFB; }
+.ansi-blue-bg { background-color: #208FFB; }
+.ansi-blue-intense-fg { color: #0065CA; }
+.ansi-blue-intense-bg { background-color: #0065CA; }
+.ansi-magenta-fg { color: #D160C4; }
+.ansi-magenta-bg { background-color: #D160C4; }
+.ansi-magenta-intense-fg { color: #A03196; }
+.ansi-magenta-intense-bg { background-color: #A03196; }
+.ansi-cyan-fg { color: #60C6C8; }
+.ansi-cyan-bg { background-color: #60C6C8; }
+.ansi-cyan-intense-fg { color: #258F8F; }
+.ansi-cyan-intense-bg { background-color: #258F8F; }
+.ansi-white-fg { color: #C5C1B4; }
+.ansi-white-bg { background-color: #C5C1B4; }
+.ansi-white-intense-fg { color: #A1A6B2; }
+.ansi-white-intense-bg { background-color: #A1A6B2; }
+
+.ansi-default-inverse-fg { color: #FFFFFF; }
+.ansi-default-inverse-bg { background-color: #000000; }
+
+.ansi-bold { font-weight: bold; }
+.ansi-underline { text-decoration: underline; }
+
+
+div.nbinput.container div.input_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight] > pre,
+div.nboutput.container div.output_area div[class*=highlight].math,
+div.nboutput.container div.output_area.rendered_html,
+div.nboutput.container div.output_area > div.output_javascript,
+div.nboutput.container div.output_area:not(.rendered_html) > img{
+    padding: 5px;
+    margin: 0;
+}
+
+/* fix copybtn overflow problem in chromium (needed for 'sphinx_copybutton') */
+div.nbinput.container div.input_area > div[class^='highlight'],
+div.nboutput.container div.output_area > div[class^='highlight']{
+    overflow-y: hidden;
+}
+
+/* hide copy button on prompts for 'sphinx_copybutton' extension ... */
+.prompt .copybtn,
+/* ... and 'sphinx_immaterial' theme */
+.prompt .md-clipboard.md-icon {
+    display: none;
+}
+
+/* Some additional styling taken form the Jupyter notebook CSS */
+.jp-RenderedHTMLCommon table,
+div.rendered_html table {
+  border: none;
+  border-collapse: collapse;
+  border-spacing: 0;
+  color: black;
+  font-size: 12px;
+  table-layout: fixed;
+}
+.jp-RenderedHTMLCommon thead,
+div.rendered_html thead {
+  border-bottom: 1px solid black;
+  vertical-align: bottom;
+}
+.jp-RenderedHTMLCommon tr,
+.jp-RenderedHTMLCommon th,
+.jp-RenderedHTMLCommon td,
+div.rendered_html tr,
+div.rendered_html th,
+div.rendered_html td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+.jp-RenderedHTMLCommon th,
+div.rendered_html th {
+  font-weight: bold;
+}
+.jp-RenderedHTMLCommon tbody tr:nth-child(odd),
+div.rendered_html tbody tr:nth-child(odd) {
+  background: #f5f5f5;
+}
+.jp-RenderedHTMLCommon tbody tr:hover,
+div.rendered_html tbody tr:hover {
+  background: rgba(66, 165, 245, 0.2);
+}
+
diff --git a/pr-2241/_static/nbsphinx-gallery.css b/pr-2241/_static/nbsphinx-gallery.css
new file mode 100644
index 0000000000..365c27a96b
--- /dev/null
+++ b/pr-2241/_static/nbsphinx-gallery.css
@@ -0,0 +1,31 @@
+.nbsphinx-gallery {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
+    gap: 5px;
+    margin-top: 1em;
+    margin-bottom: 1em;
+}
+
+.nbsphinx-gallery > a {
+    padding: 5px;
+    border: 1px dotted currentColor;
+    border-radius: 2px;
+    text-align: center;
+}
+
+.nbsphinx-gallery > a:hover {
+    border-style: solid;
+}
+
+.nbsphinx-gallery img {
+    max-width: 100%;
+    max-height: 100%;
+}
+
+.nbsphinx-gallery > a > div:first-child {
+    display: flex;
+    align-items: start;
+    justify-content: center;
+    height: 120px;
+    margin-bottom: 5px;
+}
diff --git a/pr-2241/_static/nbsphinx-no-thumbnail.svg b/pr-2241/_static/nbsphinx-no-thumbnail.svg
new file mode 100644
index 0000000000..9dca7588fa
--- /dev/null
+++ b/pr-2241/_static/nbsphinx-no-thumbnail.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="100" height="100">
+  <style>
+    svg { fill: #ccc; }
+    @media (prefers-color-scheme: dark) {
+      svg { fill: #999; }
+    }
+  </style>
+  <path d="M 65.365328,74.550032 H 67.52154 V 88.67217 h 7.760238 v 1.814634 h -9.91645 z m -6.447298,0 h 2.156214 V 90.486804 H 58.91803 Z m -9.955303,2.124192 -2.924765,7.931025 h 5.860208 z m -1.216872,-2.124192 h 2.444423 l 6.073692,15.936772 h -2.241606 l -1.451709,-4.088268 h -7.183824 l -1.451707,4.088268 H 41.66149 Z m -21.264514,0 h 2.903417 L 36.45116,87.882271 V 74.550032 h 2.092171 V 90.486804 H 35.639914 L 28.573506,77.154569 v 13.332235 h -2.092165 z m 53.454813,-9.781663 v 5.838858 h 3.458479 q 1.739919,0 2.572513,-0.71518 0.843272,-0.725854 0.843272,-2.209586 0,-1.494406 -0.843272,-2.198912 -0.832594,-0.71518 -2.572513,-0.71518 z m 0,-6.554037 v 4.803447 h 3.191622 q 1.579803,0 2.348355,-0.587087 0.779225,-0.597763 0.779225,-1.814636 0,-1.206199 -0.779225,-1.803962 -0.768552,-0.597762 -2.348355,-0.597762 z m -2.156212,-1.771939 h 5.507949 q 2.465772,0 3.800065,1.024736 1.334288,1.024735 1.334288,2.914092 0,1.462383 -0.683157,2.327003 -0.683157,0.864621 -2.006771,1.078107 1.590471,0.341579 2.46577,1.43036 0.885967,1.078107 0.885967,2.700605 0,2.134866 -1.451708,3.298368 -1.451709,1.163502 -4.130963,1.163502 h -5.72144 z m -18.86154,0 h 3.212969 l 4.066921,10.845118 4.088269,-10.845118 H 73.49953 V 72.379166 H 71.396692 V 58.385121 L 67.287075,69.315634 H 65.120183 L 61.010567,58.385121 v 13.994045 h -2.092165 z m -16.246333,0 h 2.166892 v 9.681616 q 0,2.561839 0.928668,3.693318 0.928667,1.120804 3.010159,1.120804 2.070819,0 2.999486,-1.120804 0.928667,-1.131479 0.928667,-3.693318 v -9.681616 h 2.166886 v 9.948474 q 0,3.116904 -1.547776,4.70738 -1.537104,1.590474 -4.547263,1.590474 -3.020833,0 -4.568615,-1.590474 -1.537104,-1.590476 -1.537104,-4.70738 z m -16.192953,0 h 2.156213 v 6.532689 h 7.83496 v -6.532689 h 2.156213 v 15.936773 h -2.156213 v -7.589448 h -7.83496 v 7.589448 h -2.156213 z m -15.563168,0 h 13.481671 v 1.814636 H 18.740226 V 72.379166 H 16.573339 V 58.257029 H 10.915948 Z M 65.497127,39.809967 q -2.34835,0 -3.736011,1.750588 -1.376987,1.750588 -1.376987,4.771419 0,3.010157 1.376987,4.760745 1.387661,1.750588 3.736011,1.750588 2.348349,0 3.714662,-1.750588 1.376986,-1.750588 1.376986,-4.760745 0,-3.020831 -1.376986,-4.771419 -1.366313,-1.750588 -3.714662,-1.750588 z m 0,-1.750588 q 3.351735,0 5.358506,2.252281 2.006772,2.241606 2.006772,6.020314 0,3.768034 -2.006772,6.020315 -2.006771,2.241606 -5.358506,2.241606 -3.36241,0 -5.379856,-2.241606 -2.006771,-2.241607 -2.006771,-6.020315 0,-3.778708 2.006771,-6.020314 2.017446,-2.252281 5.379856,-2.252281 z m -22.821688,0.288206 h 2.903414 L 52.64525,51.679807 V 38.347585 h 2.092166 V 54.28434 H 51.834001 L 44.767605,40.952119 V 54.28434 h -2.092166 z" />
+</svg>
diff --git a/pr-2241/_static/no_image.png b/pr-2241/_static/no_image.png
new file mode 100644
index 0000000000..8c2d48d5d3
Binary files /dev/null and b/pr-2241/_static/no_image.png differ
diff --git a/pr-2241/_static/nvqpp_workflow.png b/pr-2241/_static/nvqpp_workflow.png
new file mode 100644
index 0000000000..2880e61675
Binary files /dev/null and b/pr-2241/_static/nvqpp_workflow.png differ
diff --git a/pr-2241/_static/openTerminal.png b/pr-2241/_static/openTerminal.png
new file mode 100644
index 0000000000..58e71b0689
Binary files /dev/null and b/pr-2241/_static/openTerminal.png differ
diff --git a/pr-2241/_static/plus.png b/pr-2241/_static/plus.png
new file mode 100644
index 0000000000..7107cec93a
Binary files /dev/null and b/pr-2241/_static/plus.png differ
diff --git a/pr-2241/_static/pygments.css b/pr-2241/_static/pygments.css
new file mode 100644
index 0000000000..c15243c260
--- /dev/null
+++ b/pr-2241/_static/pygments.css
@@ -0,0 +1,85 @@
+pre { line-height: 125%; }
+td.linenos .normal { color: #3c4354; background-color: transparent; padding-left: 5px; padding-right: 5px; }
+span.linenos { color: #3c4354; background-color: transparent; padding-left: 5px; padding-right: 5px; }
+td.linenos .special { color: #3c4354; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
+span.linenos.special { color: #3c4354; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
+.highlight .hll { background-color: #6e7681 }
+.highlight { background: #1d2331; color: #d4d2c8 }
+.highlight .c { color: #7e8aa1 } /* Comment */
+.highlight .err { color: #f88f7f } /* Error */
+.highlight .esc { color: #d4d2c8 } /* Escape */
+.highlight .g { color: #d4d2c8 } /* Generic */
+.highlight .k { color: #FFAD66 } /* Keyword */
+.highlight .l { color: #D5FF80 } /* Literal */
+.highlight .n { color: #d4d2c8 } /* Name */
+.highlight .o { color: #FFAD66 } /* Operator */
+.highlight .x { color: #d4d2c8 } /* Other */
+.highlight .p { color: #d4d2c8 } /* Punctuation */
+.highlight .ch { color: #f88f7f; font-style: italic } /* Comment.Hashbang */
+.highlight .cm { color: #7e8aa1 } /* Comment.Multiline */
+.highlight .cp { color: #FFAD66; font-weight: bold } /* Comment.Preproc */
+.highlight .cpf { color: #7e8aa1 } /* Comment.PreprocFile */
+.highlight .c1 { color: #7e8aa1 } /* Comment.Single */
+.highlight .cs { color: #7e8aa1; font-style: italic } /* Comment.Special */
+.highlight .gd { color: #f88f7f; background-color: #3d1e20 } /* Generic.Deleted */
+.highlight .ge { color: #d4d2c8; font-style: italic } /* Generic.Emph */
+.highlight .ges { color: #d4d2c8 } /* Generic.EmphStrong */
+.highlight .gr { color: #f88f7f } /* Generic.Error */
+.highlight .gh { color: #d4d2c8 } /* Generic.Heading */
+.highlight .gi { color: #6ad4af; background-color: #19362c } /* Generic.Inserted */
+.highlight .go { color: #7e8aa1 } /* Generic.Output */
+.highlight .gp { color: #d4d2c8 } /* Generic.Prompt */
+.highlight .gs { color: #d4d2c8; font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #d4d2c8 } /* Generic.Subheading */
+.highlight .gt { color: #f88f7f } /* Generic.Traceback */
+.highlight .kc { color: #FFAD66 } /* Keyword.Constant */
+.highlight .kd { color: #FFAD66 } /* Keyword.Declaration */
+.highlight .kn { color: #FFAD66 } /* Keyword.Namespace */
+.highlight .kp { color: #FFAD66 } /* Keyword.Pseudo */
+.highlight .kr { color: #FFAD66 } /* Keyword.Reserved */
+.highlight .kt { color: #73D0FF } /* Keyword.Type */
+.highlight .ld { color: #D5FF80 } /* Literal.Date */
+.highlight .m { color: #DFBFFF } /* Literal.Number */
+.highlight .s { color: #D5FF80 } /* Literal.String */
+.highlight .na { color: #FFD173 } /* Name.Attribute */
+.highlight .nb { color: #FFD173 } /* Name.Builtin */
+.highlight .nc { color: #73D0FF } /* Name.Class */
+.highlight .no { color: #FFD173 } /* Name.Constant */
+.highlight .nd { color: #7e8aa1; font-weight: bold; font-style: italic } /* Name.Decorator */
+.highlight .ni { color: #95E6CB } /* Name.Entity */
+.highlight .ne { color: #73D0FF } /* Name.Exception */
+.highlight .nf { color: #FFD173 } /* Name.Function */
+.highlight .nl { color: #d4d2c8 } /* Name.Label */
+.highlight .nn { color: #d4d2c8 } /* Name.Namespace */
+.highlight .nx { color: #d4d2c8 } /* Name.Other */
+.highlight .py { color: #FFD173 } /* Name.Property */
+.highlight .nt { color: #5CCFE6 } /* Name.Tag */
+.highlight .nv { color: #d4d2c8 } /* Name.Variable */
+.highlight .ow { color: #FFAD66 } /* Operator.Word */
+.highlight .pm { color: #d4d2c8 } /* Punctuation.Marker */
+.highlight .w { color: #d4d2c8 } /* Text.Whitespace */
+.highlight .mb { color: #DFBFFF } /* Literal.Number.Bin */
+.highlight .mf { color: #DFBFFF } /* Literal.Number.Float */
+.highlight .mh { color: #DFBFFF } /* Literal.Number.Hex */
+.highlight .mi { color: #DFBFFF } /* Literal.Number.Integer */
+.highlight .mo { color: #DFBFFF } /* Literal.Number.Oct */
+.highlight .sa { color: #F29E74 } /* Literal.String.Affix */
+.highlight .sb { color: #D5FF80 } /* Literal.String.Backtick */
+.highlight .sc { color: #D5FF80 } /* Literal.String.Char */
+.highlight .dl { color: #D5FF80 } /* Literal.String.Delimiter */
+.highlight .sd { color: #7e8aa1 } /* Literal.String.Doc */
+.highlight .s2 { color: #D5FF80 } /* Literal.String.Double */
+.highlight .se { color: #95E6CB } /* Literal.String.Escape */
+.highlight .sh { color: #D5FF80 } /* Literal.String.Heredoc */
+.highlight .si { color: #95E6CB } /* Literal.String.Interpol */
+.highlight .sx { color: #95E6CB } /* Literal.String.Other */
+.highlight .sr { color: #95E6CB } /* Literal.String.Regex */
+.highlight .s1 { color: #D5FF80 } /* Literal.String.Single */
+.highlight .ss { color: #DFBFFF } /* Literal.String.Symbol */
+.highlight .bp { color: #5CCFE6 } /* Name.Builtin.Pseudo */
+.highlight .fm { color: #FFD173 } /* Name.Function.Magic */
+.highlight .vc { color: #d4d2c8 } /* Name.Variable.Class */
+.highlight .vg { color: #d4d2c8 } /* Name.Variable.Global */
+.highlight .vi { color: #d4d2c8 } /* Name.Variable.Instance */
+.highlight .vm { color: #d4d2c8 } /* Name.Variable.Magic */
+.highlight .il { color: #DFBFFF } /* Literal.Number.Integer.Long */
\ No newline at end of file
diff --git a/pr-2241/_static/qpud_fig.png b/pr-2241/_static/qpud_fig.png
new file mode 100644
index 0000000000..66080b1ff5
Binary files /dev/null and b/pr-2241/_static/qpud_fig.png differ
diff --git a/pr-2241/_static/searchtools.js b/pr-2241/_static/searchtools.js
new file mode 100644
index 0000000000..e89e34d4e7
--- /dev/null
+++ b/pr-2241/_static/searchtools.js
@@ -0,0 +1,566 @@
+/*
+ * searchtools.js
+ * ~~~~~~~~~~~~~~~~
+ *
+ * Sphinx JavaScript utilities for the full-text search.
+ *
+ * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+"use strict";
+
+/**
+ * Simple result scoring code.
+ */
+if (typeof Scorer === "undefined") {
+  var Scorer = {
+    // Implement the following function to further tweak the score for each result
+    // The function takes a result array [docname, title, anchor, descr, score, filename]
+    // and returns the new score.
+    /*
+    score: result => {
+      const [docname, title, anchor, descr, score, filename] = result
+      return score
+    },
+    */
+
+    // query matches the full name of an object
+    objNameMatch: 11,
+    // or matches in the last dotted part of the object name
+    objPartialMatch: 6,
+    // Additive scores depending on the priority of the object
+    objPrio: {
+      0: 15, // used to be importantResults
+      1: 5, // used to be objectResults
+      2: -5, // used to be unimportantResults
+    },
+    //  Used when the priority is not in the mapping.
+    objPrioDefault: 0,
+
+    // query found in title
+    title: 15,
+    partialTitle: 7,
+    // query found in terms
+    term: 5,
+    partialTerm: 2,
+  };
+}
+
+const _removeChildren = (element) => {
+  while (element && element.lastChild) element.removeChild(element.lastChild);
+};
+
+/**
+ * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping
+ */
+const _escapeRegExp = (string) =>
+  string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string
+
+const _displayItem = (item, searchTerms) => {
+  const docBuilder = DOCUMENTATION_OPTIONS.BUILDER;
+  const docUrlRoot = DOCUMENTATION_OPTIONS.URL_ROOT;
+  const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX;
+  const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX;
+  const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY;
+
+  const [docName, title, anchor, descr, score, _filename] = item;
+
+  let listItem = document.createElement("li");
+  let requestUrl;
+  let linkUrl;
+  if (docBuilder === "dirhtml") {
+    // dirhtml builder
+    let dirname = docName + "/";
+    if (dirname.match(/\/index\/$/))
+      dirname = dirname.substring(0, dirname.length - 6);
+    else if (dirname === "index/") dirname = "";
+    requestUrl = docUrlRoot + dirname;
+    linkUrl = requestUrl;
+  } else {
+    // normal html builders
+    requestUrl = docUrlRoot + docName + docFileSuffix;
+    linkUrl = docName + docLinkSuffix;
+  }
+  let linkEl = listItem.appendChild(document.createElement("a"));
+  linkEl.href = linkUrl + anchor;
+  linkEl.dataset.score = score;
+  linkEl.innerHTML = title;
+  if (descr)
+    listItem.appendChild(document.createElement("span")).innerHTML =
+      " (" + descr + ")";
+  else if (showSearchSummary)
+    fetch(requestUrl)
+      .then((responseData) => responseData.text())
+      .then((data) => {
+        if (data)
+          listItem.appendChild(
+            Search.makeSearchSummary(data, searchTerms)
+          );
+      });
+  Search.output.appendChild(listItem);
+};
+const _finishSearch = (resultCount) => {
+  Search.stopPulse();
+  Search.title.innerText = _("Search Results");
+  if (!resultCount)
+    Search.status.innerText = Documentation.gettext(
+      "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories."
+    );
+  else
+    Search.status.innerText = _(
+      `Search finished, found ${resultCount} page(s) matching the search query.`
+    );
+};
+const _displayNextItem = (
+  results,
+  resultCount,
+  searchTerms
+) => {
+  // results left, load the summary and display it
+  // this is intended to be dynamic (don't sub resultsCount)
+  if (results.length) {
+    _displayItem(results.pop(), searchTerms);
+    setTimeout(
+      () => _displayNextItem(results, resultCount, searchTerms),
+      5
+    );
+  }
+  // search finished, update title and status message
+  else _finishSearch(resultCount);
+};
+
+/**
+ * Default splitQuery function. Can be overridden in ``sphinx.search`` with a
+ * custom function per language.
+ *
+ * The regular expression works by splitting the string on consecutive characters
+ * that are not Unicode letters, numbers, underscores, or emoji characters.
+ * This is the same as ``\W+`` in Python, preserving the surrogate pair area.
+ */
+if (typeof splitQuery === "undefined") {
+  var splitQuery = (query) => query
+      .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu)
+      .filter(term => term)  // remove remaining empty strings
+}
+
+/**
+ * Search Module
+ */
+const Search = {
+  _index: null,
+  _queued_query: null,
+  _pulse_status: -1,
+
+  htmlToText: (htmlString) => {
+    const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html');
+    htmlElement.querySelectorAll(".headerlink").forEach((el) => { el.remove() });
+    const docContent = htmlElement.querySelector('[role="main"]');
+    if (docContent !== undefined) return docContent.textContent;
+    console.warn(
+      "Content block not found. Sphinx search tries to obtain it via '[role=main]'. Could you check your theme or template."
+    );
+    return "";
+  },
+
+  init: () => {
+    const query = new URLSearchParams(window.location.search).get("q");
+    document
+      .querySelectorAll('input[name="q"]')
+      .forEach((el) => (el.value = query));
+    if (query) Search.performSearch(query);
+  },
+
+  loadIndex: (url) =>
+    (document.body.appendChild(document.createElement("script")).src = url),
+
+  setIndex: (index) => {
+    Search._index = index;
+    if (Search._queued_query !== null) {
+      const query = Search._queued_query;
+      Search._queued_query = null;
+      Search.query(query);
+    }
+  },
+
+  hasIndex: () => Search._index !== null,
+
+  deferQuery: (query) => (Search._queued_query = query),
+
+  stopPulse: () => (Search._pulse_status = -1),
+
+  startPulse: () => {
+    if (Search._pulse_status >= 0) return;
+
+    const pulse = () => {
+      Search._pulse_status = (Search._pulse_status + 1) % 4;
+      Search.dots.innerText = ".".repeat(Search._pulse_status);
+      if (Search._pulse_status >= 0) window.setTimeout(pulse, 500);
+    };
+    pulse();
+  },
+
+  /**
+   * perform a search for something (or wait until index is loaded)
+   */
+  performSearch: (query) => {
+    // create the required interface elements
+    const searchText = document.createElement("h2");
+    searchText.textContent = _("Searching");
+    const searchSummary = document.createElement("p");
+    searchSummary.classList.add("search-summary");
+    searchSummary.innerText = "";
+    const searchList = document.createElement("ul");
+    searchList.classList.add("search");
+
+    const out = document.getElementById("search-results");
+    Search.title = out.appendChild(searchText);
+    Search.dots = Search.title.appendChild(document.createElement("span"));
+    Search.status = out.appendChild(searchSummary);
+    Search.output = out.appendChild(searchList);
+
+    const searchProgress = document.getElementById("search-progress");
+    // Some themes don't use the search progress node
+    if (searchProgress) {
+      searchProgress.innerText = _("Preparing search...");
+    }
+    Search.startPulse();
+
+    // index already loaded, the browser was quick!
+    if (Search.hasIndex()) Search.query(query);
+    else Search.deferQuery(query);
+  },
+
+  /**
+   * execute search (requires search index to be loaded)
+   */
+  query: (query) => {
+    const filenames = Search._index.filenames;
+    const docNames = Search._index.docnames;
+    const titles = Search._index.titles;
+    const allTitles = Search._index.alltitles;
+    const indexEntries = Search._index.indexentries;
+
+    // stem the search terms and add them to the correct list
+    const stemmer = new Stemmer();
+    const searchTerms = new Set();
+    const excludedTerms = new Set();
+    const highlightTerms = new Set();
+    const objectTerms = new Set(splitQuery(query.toLowerCase().trim()));
+    splitQuery(query.trim()).forEach((queryTerm) => {
+      const queryTermLower = queryTerm.toLowerCase();
+
+      // maybe skip this "word"
+      // stopwords array is from language_data.js
+      if (
+        stopwords.indexOf(queryTermLower) !== -1 ||
+        queryTerm.match(/^\d+$/)
+      )
+        return;
+
+      // stem the word
+      let word = stemmer.stemWord(queryTermLower);
+      // select the correct list
+      if (word[0] === "-") excludedTerms.add(word.substr(1));
+      else {
+        searchTerms.add(word);
+        highlightTerms.add(queryTermLower);
+      }
+    });
+
+    if (SPHINX_HIGHLIGHT_ENABLED) {  // set in sphinx_highlight.js
+      localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" "))
+    }
+
+    // console.debug("SEARCH: searching for:");
+    // console.info("required: ", [...searchTerms]);
+    // console.info("excluded: ", [...excludedTerms]);
+
+    // array of [docname, title, anchor, descr, score, filename]
+    let results = [];
+    _removeChildren(document.getElementById("search-progress"));
+
+    const queryLower = query.toLowerCase();
+    for (const [title, foundTitles] of Object.entries(allTitles)) {
+      if (title.toLowerCase().includes(queryLower) && (queryLower.length >= title.length/2)) {
+        for (const [file, id] of foundTitles) {
+          let score = Math.round(100 * queryLower.length / title.length)
+          results.push([
+            docNames[file],
+            titles[file] !== title ? `${titles[file]} > ${title}` : title,
+            id !== null ? "#" + id : "",
+            null,
+            score,
+            filenames[file],
+          ]);
+        }
+      }
+    }
+
+    // search for explicit entries in index directives
+    for (const [entry, foundEntries] of Object.entries(indexEntries)) {
+      if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) {
+        for (const [file, id] of foundEntries) {
+          let score = Math.round(100 * queryLower.length / entry.length)
+          results.push([
+            docNames[file],
+            titles[file],
+            id ? "#" + id : "",
+            null,
+            score,
+            filenames[file],
+          ]);
+        }
+      }
+    }
+
+    // lookup as object
+    objectTerms.forEach((term) =>
+      results.push(...Search.performObjectSearch(term, objectTerms))
+    );
+
+    // lookup as search terms in fulltext
+    results.push(...Search.performTermsSearch(searchTerms, excludedTerms));
+
+    // let the scorer override scores with a custom scoring function
+    if (Scorer.score) results.forEach((item) => (item[4] = Scorer.score(item)));
+
+    // now sort the results by score (in opposite order of appearance, since the
+    // display function below uses pop() to retrieve items) and then
+    // alphabetically
+    results.sort((a, b) => {
+      const leftScore = a[4];
+      const rightScore = b[4];
+      if (leftScore === rightScore) {
+        // same score: sort alphabetically
+        const leftTitle = a[1].toLowerCase();
+        const rightTitle = b[1].toLowerCase();
+        if (leftTitle === rightTitle) return 0;
+        return leftTitle > rightTitle ? -1 : 1; // inverted is intentional
+      }
+      return leftScore > rightScore ? 1 : -1;
+    });
+
+    // remove duplicate search results
+    // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept
+    let seen = new Set();
+    results = results.reverse().reduce((acc, result) => {
+      let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(',');
+      if (!seen.has(resultStr)) {
+        acc.push(result);
+        seen.add(resultStr);
+      }
+      return acc;
+    }, []);
+
+    results = results.reverse();
+
+    // for debugging
+    //Search.lastresults = results.slice();  // a copy
+    // console.info("search results:", Search.lastresults);
+
+    // print the results
+    _displayNextItem(results, results.length, searchTerms);
+  },
+
+  /**
+   * search for object names
+   */
+  performObjectSearch: (object, objectTerms) => {
+    const filenames = Search._index.filenames;
+    const docNames = Search._index.docnames;
+    const objects = Search._index.objects;
+    const objNames = Search._index.objnames;
+    const titles = Search._index.titles;
+
+    const results = [];
+
+    const objectSearchCallback = (prefix, match) => {
+      const name = match[4]
+      const fullname = (prefix ? prefix + "." : "") + name;
+      const fullnameLower = fullname.toLowerCase();
+      if (fullnameLower.indexOf(object) < 0) return;
+
+      let score = 0;
+      const parts = fullnameLower.split(".");
+
+      // check for different match types: exact matches of full name or
+      // "last name" (i.e. last dotted part)
+      if (fullnameLower === object || parts.slice(-1)[0] === object)
+        score += Scorer.objNameMatch;
+      else if (parts.slice(-1)[0].indexOf(object) > -1)
+        score += Scorer.objPartialMatch; // matches in last name
+
+      const objName = objNames[match[1]][2];
+      const title = titles[match[0]];
+
+      // If more than one term searched for, we require other words to be
+      // found in the name/title/description
+      const otherTerms = new Set(objectTerms);
+      otherTerms.delete(object);
+      if (otherTerms.size > 0) {
+        const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase();
+        if (
+          [...otherTerms].some((otherTerm) => haystack.indexOf(otherTerm) < 0)
+        )
+          return;
+      }
+
+      let anchor = match[3];
+      if (anchor === "") anchor = fullname;
+      else if (anchor === "-") anchor = objNames[match[1]][1] + "-" + fullname;
+
+      const descr = objName + _(", in ") + title;
+
+      // add custom score for some objects according to scorer
+      if (Scorer.objPrio.hasOwnProperty(match[2]))
+        score += Scorer.objPrio[match[2]];
+      else score += Scorer.objPrioDefault;
+
+      results.push([
+        docNames[match[0]],
+        fullname,
+        "#" + anchor,
+        descr,
+        score,
+        filenames[match[0]],
+      ]);
+    };
+    Object.keys(objects).forEach((prefix) =>
+      objects[prefix].forEach((array) =>
+        objectSearchCallback(prefix, array)
+      )
+    );
+    return results;
+  },
+
+  /**
+   * search for full-text terms in the index
+   */
+  performTermsSearch: (searchTerms, excludedTerms) => {
+    // prepare search
+    const terms = Search._index.terms;
+    const titleTerms = Search._index.titleterms;
+    const filenames = Search._index.filenames;
+    const docNames = Search._index.docnames;
+    const titles = Search._index.titles;
+
+    const scoreMap = new Map();
+    const fileMap = new Map();
+
+    // perform the search on the required terms
+    searchTerms.forEach((word) => {
+      const files = [];
+      const arr = [
+        { files: terms[word], score: Scorer.term },
+        { files: titleTerms[word], score: Scorer.title },
+      ];
+      // add support for partial matches
+      if (word.length > 2) {
+        const escapedWord = _escapeRegExp(word);
+        Object.keys(terms).forEach((term) => {
+          if (term.match(escapedWord) && !terms[word])
+            arr.push({ files: terms[term], score: Scorer.partialTerm });
+        });
+        Object.keys(titleTerms).forEach((term) => {
+          if (term.match(escapedWord) && !titleTerms[word])
+            arr.push({ files: titleTerms[word], score: Scorer.partialTitle });
+        });
+      }
+
+      // no match but word was a required one
+      if (arr.every((record) => record.files === undefined)) return;
+
+      // found search word in contents
+      arr.forEach((record) => {
+        if (record.files === undefined) return;
+
+        let recordFiles = record.files;
+        if (recordFiles.length === undefined) recordFiles = [recordFiles];
+        files.push(...recordFiles);
+
+        // set score for the word in each file
+        recordFiles.forEach((file) => {
+          if (!scoreMap.has(file)) scoreMap.set(file, {});
+          scoreMap.get(file)[word] = record.score;
+        });
+      });
+
+      // create the mapping
+      files.forEach((file) => {
+        if (fileMap.has(file) && fileMap.get(file).indexOf(word) === -1)
+          fileMap.get(file).push(word);
+        else fileMap.set(file, [word]);
+      });
+    });
+
+    // now check if the files don't contain excluded terms
+    const results = [];
+    for (const [file, wordList] of fileMap) {
+      // check if all requirements are matched
+
+      // as search terms with length < 3 are discarded
+      const filteredTermCount = [...searchTerms].filter(
+        (term) => term.length > 2
+      ).length;
+      if (
+        wordList.length !== searchTerms.size &&
+        wordList.length !== filteredTermCount
+      )
+        continue;
+
+      // ensure that none of the excluded terms is in the search result
+      if (
+        [...excludedTerms].some(
+          (term) =>
+            terms[term] === file ||
+            titleTerms[term] === file ||
+            (terms[term] || []).includes(file) ||
+            (titleTerms[term] || []).includes(file)
+        )
+      )
+        break;
+
+      // select one (max) score for the file.
+      const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w]));
+      // add result to the result list
+      results.push([
+        docNames[file],
+        titles[file],
+        "",
+        null,
+        score,
+        filenames[file],
+      ]);
+    }
+    return results;
+  },
+
+  /**
+   * helper function to return a node containing the
+   * search summary for a given text. keywords is a list
+   * of stemmed words.
+   */
+  makeSearchSummary: (htmlText, keywords) => {
+    const text = Search.htmlToText(htmlText);
+    if (text === "") return null;
+
+    const textLower = text.toLowerCase();
+    const actualStartPosition = [...keywords]
+      .map((k) => textLower.indexOf(k.toLowerCase()))
+      .filter((i) => i > -1)
+      .slice(-1)[0];
+    const startWithContext = Math.max(actualStartPosition - 120, 0);
+
+    const top = startWithContext === 0 ? "" : "...";
+    const tail = startWithContext + 240 < text.length ? "..." : "";
+
+    let summary = document.createElement("p");
+    summary.classList.add("context");
+    summary.textContent = top + text.substr(startWithContext, 240).trim() + tail;
+
+    return summary;
+  },
+};
+
+_ready(Search.init);
diff --git a/pr-2241/_static/sg_gallery-binder.css b/pr-2241/_static/sg_gallery-binder.css
new file mode 100644
index 0000000000..420005d227
--- /dev/null
+++ b/pr-2241/_static/sg_gallery-binder.css
@@ -0,0 +1,11 @@
+/* CSS for binder integration */
+
+div.binder-badge {
+  margin: 1em auto;
+  vertical-align: middle;
+}
+
+div.lite-badge {
+  margin: 1em auto;
+  vertical-align: middle;
+}
diff --git a/pr-2241/_static/sg_gallery-dataframe.css b/pr-2241/_static/sg_gallery-dataframe.css
new file mode 100644
index 0000000000..25be73092e
--- /dev/null
+++ b/pr-2241/_static/sg_gallery-dataframe.css
@@ -0,0 +1,46 @@
+/* Pandas dataframe css */
+/* Taken from: https://github.com/spatialaudio/nbsphinx/blob/fb3ba670fc1ba5f54d4c487573dbc1b4ecf7e9ff/src/nbsphinx.py#L587-L619 */
+html[data-theme="light"] {
+  --sg-text-color: #000;
+  --sg-tr-odd-color: #f5f5f5;
+  --sg-tr-hover-color: rgba(66, 165, 245, 0.2);
+}
+html[data-theme="dark"] {
+  --sg-text-color: #fff;
+  --sg-tr-odd-color: #373737;
+  --sg-tr-hover-color: rgba(30, 81, 122, 0.2);
+}
+
+table.dataframe {
+  border: none !important;
+  border-collapse: collapse;
+  border-spacing: 0;
+  border-color: transparent;
+  color: var(--sg-text-color);
+  font-size: 12px;
+  table-layout: fixed;
+}
+table.dataframe thead {
+  border-bottom: 1px solid var(--sg-text-color);
+  vertical-align: bottom;
+}
+table.dataframe tr,
+table.dataframe th,
+table.dataframe td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+table.dataframe th {
+  font-weight: bold;
+}
+table.dataframe tbody tr:nth-child(odd) {
+  background: var(--sg-tr-odd-color);
+}
+table.dataframe tbody tr:hover {
+  background: var(--sg-tr-hover-color);
+}
diff --git a/pr-2241/_static/sg_gallery-rendered-html.css b/pr-2241/_static/sg_gallery-rendered-html.css
new file mode 100644
index 0000000000..93dc2ffb02
--- /dev/null
+++ b/pr-2241/_static/sg_gallery-rendered-html.css
@@ -0,0 +1,224 @@
+/* Adapted from notebook/static/style/style.min.css */
+html[data-theme="light"] {
+  --sg-text-color: #000;
+  --sg-background-color: #ffffff;
+  --sg-code-background-color: #eff0f1;
+  --sg-tr-hover-color: rgba(66, 165, 245, 0.2);
+  --sg-tr-odd-color: #f5f5f5;
+}
+html[data-theme="dark"] {
+  --sg-text-color: #fff;
+  --sg-background-color: #121212;
+  --sg-code-background-color: #2f2f30;
+  --sg-tr-hover-color: rgba(66, 165, 245, 0.2);
+  --sg-tr-odd-color: #1f1f1f;
+}
+
+.rendered_html {
+  color: var(--sg-text-color);
+  /* any extras will just be numbers: */
+}
+.rendered_html em {
+  font-style: italic;
+}
+.rendered_html strong {
+  font-weight: bold;
+}
+.rendered_html u {
+  text-decoration: underline;
+}
+.rendered_html :link {
+  text-decoration: underline;
+}
+.rendered_html :visited {
+  text-decoration: underline;
+}
+.rendered_html h1 {
+  font-size: 185.7%;
+  margin: 1.08em 0 0 0;
+  font-weight: bold;
+  line-height: 1.0;
+}
+.rendered_html h2 {
+  font-size: 157.1%;
+  margin: 1.27em 0 0 0;
+  font-weight: bold;
+  line-height: 1.0;
+}
+.rendered_html h3 {
+  font-size: 128.6%;
+  margin: 1.55em 0 0 0;
+  font-weight: bold;
+  line-height: 1.0;
+}
+.rendered_html h4 {
+  font-size: 100%;
+  margin: 2em 0 0 0;
+  font-weight: bold;
+  line-height: 1.0;
+}
+.rendered_html h5 {
+  font-size: 100%;
+  margin: 2em 0 0 0;
+  font-weight: bold;
+  line-height: 1.0;
+  font-style: italic;
+}
+.rendered_html h6 {
+  font-size: 100%;
+  margin: 2em 0 0 0;
+  font-weight: bold;
+  line-height: 1.0;
+  font-style: italic;
+}
+.rendered_html h1:first-child {
+  margin-top: 0.538em;
+}
+.rendered_html h2:first-child {
+  margin-top: 0.636em;
+}
+.rendered_html h3:first-child {
+  margin-top: 0.777em;
+}
+.rendered_html h4:first-child {
+  margin-top: 1em;
+}
+.rendered_html h5:first-child {
+  margin-top: 1em;
+}
+.rendered_html h6:first-child {
+  margin-top: 1em;
+}
+.rendered_html ul:not(.list-inline),
+.rendered_html ol:not(.list-inline) {
+  padding-left: 2em;
+}
+.rendered_html ul {
+  list-style: disc;
+}
+.rendered_html ul ul {
+  list-style: square;
+  margin-top: 0;
+}
+.rendered_html ul ul ul {
+  list-style: circle;
+}
+.rendered_html ol {
+  list-style: decimal;
+}
+.rendered_html ol ol {
+  list-style: upper-alpha;
+  margin-top: 0;
+}
+.rendered_html ol ol ol {
+  list-style: lower-alpha;
+}
+.rendered_html ol ol ol ol {
+  list-style: lower-roman;
+}
+.rendered_html ol ol ol ol ol {
+  list-style: decimal;
+}
+.rendered_html * + ul {
+  margin-top: 1em;
+}
+.rendered_html * + ol {
+  margin-top: 1em;
+}
+.rendered_html hr {
+  color: var(--sg-text-color);
+  background-color: var(--sg-text-color);
+}
+.rendered_html pre {
+  margin: 1em 2em;
+  padding: 0px;
+  background-color: var(--sg-background-color);
+}
+.rendered_html code {
+  background-color: var(--sg-code-background-color);
+}
+.rendered_html p code {
+  padding: 1px 5px;
+}
+.rendered_html pre code {
+  background-color: var(--sg-background-color);
+}
+.rendered_html pre,
+.rendered_html code {
+  border: 0;
+  color: var(--sg-text-color);
+  font-size: 100%;
+}
+.rendered_html blockquote {
+  margin: 1em 2em;
+}
+.rendered_html table {
+  margin-left: auto;
+  margin-right: auto;
+  border: none;
+  border-collapse: collapse;
+  border-spacing: 0;
+  color: var(--sg-text-color);
+  font-size: 12px;
+  table-layout: fixed;
+}
+.rendered_html thead {
+  border-bottom: 1px solid var(--sg-text-color);
+  vertical-align: bottom;
+}
+.rendered_html tr,
+.rendered_html th,
+.rendered_html td {
+  text-align: right;
+  vertical-align: middle;
+  padding: 0.5em 0.5em;
+  line-height: normal;
+  white-space: normal;
+  max-width: none;
+  border: none;
+}
+.rendered_html th {
+  font-weight: bold;
+}
+.rendered_html tbody tr:nth-child(odd) {
+  background: var(--sg-tr-odd-color);
+}
+.rendered_html tbody tr:hover {
+  color: var(--sg-text-color);
+  background: var(--sg-tr-hover-color);
+}
+.rendered_html * + table {
+  margin-top: 1em;
+}
+.rendered_html p {
+  text-align: left;
+}
+.rendered_html * + p {
+  margin-top: 1em;
+}
+.rendered_html img {
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
+.rendered_html * + img {
+  margin-top: 1em;
+}
+.rendered_html img,
+.rendered_html svg {
+  max-width: 100%;
+  height: auto;
+}
+.rendered_html img.unconfined,
+.rendered_html svg.unconfined {
+  max-width: none;
+}
+.rendered_html .alert {
+  margin-bottom: initial;
+}
+.rendered_html * + .alert {
+  margin-top: 1em;
+}
+[dir="rtl"] .rendered_html p {
+  text-align: right;
+}
diff --git a/pr-2241/_static/sg_gallery.css b/pr-2241/_static/sg_gallery.css
new file mode 100644
index 0000000000..72227837d3
--- /dev/null
+++ b/pr-2241/_static/sg_gallery.css
@@ -0,0 +1,342 @@
+/*
+Sphinx-Gallery has compatible CSS to fix default sphinx themes
+Tested for Sphinx 1.3.1 for all themes: default, alabaster, sphinxdoc,
+scrolls, agogo, traditional, nature, haiku, pyramid
+Tested for Read the Docs theme 0.1.7 */
+
+/* Define light colors */
+:root, html[data-theme="light"], body[data-theme="light"]{
+  --sg-tooltip-foreground: black;
+  --sg-tooltip-background: rgba(250, 250, 250, 0.9);
+  --sg-tooltip-border: #ccc transparent;
+  --sg-thumb-box-shadow-color: #6c757d40;
+  --sg-thumb-hover-border: #0069d9;
+  --sg-script-out: #888;
+  --sg-script-pre: #fafae2;
+  --sg-pytb-foreground: #000;
+  --sg-pytb-background: #ffe4e4;
+  --sg-pytb-border-color: #f66;
+  --sg-download-a-background-color: #ffc;
+  --sg-download-a-background-image: linear-gradient(to bottom, #ffc, #d5d57e);
+  --sg-download-a-border-color: 1px solid #c2c22d;
+  --sg-download-a-color: #000;
+  --sg-download-a-hover-background-color: #d5d57e;
+  --sg-download-a-hover-box-shadow-1: rgba(255, 255, 255, 0.1);
+  --sg-download-a-hover-box-shadow-2: rgba(0, 0, 0, 0.25);
+}
+@media(prefers-color-scheme: light) {
+  :root[data-theme="auto"], html[data-theme="auto"], body[data-theme="auto"] {
+    --sg-tooltip-foreground: black;
+    --sg-tooltip-background: rgba(250, 250, 250, 0.9);
+    --sg-tooltip-border: #ccc transparent;
+    --sg-thumb-box-shadow-color: #6c757d40;
+    --sg-thumb-hover-border: #0069d9;
+    --sg-script-out: #888;
+    --sg-script-pre: #fafae2;
+    --sg-pytb-foreground: #000;
+    --sg-pytb-background: #ffe4e4;
+    --sg-pytb-border-color: #f66;
+    --sg-download-a-background-color: #ffc;
+    --sg-download-a-background-image: linear-gradient(to bottom, #ffc, #d5d57e);
+    --sg-download-a-border-color: 1px solid #c2c22d;
+    --sg-download-a-color: #000;
+    --sg-download-a-hover-background-color: #d5d57e;
+    --sg-download-a-hover-box-shadow-1: rgba(255, 255, 255, 0.1);
+    --sg-download-a-hover-box-shadow-2: rgba(0, 0, 0, 0.25);
+  }
+}
+
+html[data-theme="dark"], body[data-theme="dark"] {
+  --sg-tooltip-foreground: white;
+  --sg-tooltip-background: rgba(10, 10, 10, 0.9);
+  --sg-tooltip-border: #333 transparent;
+  --sg-thumb-box-shadow-color: #79848d40;
+  --sg-thumb-hover-border: #003975;
+  --sg-script-out: rgb(179, 179, 179);
+  --sg-script-pre: #2e2e22;
+  --sg-pytb-foreground: #fff;
+  --sg-pytb-background: #1b1717;
+  --sg-pytb-border-color: #622;
+  --sg-download-a-background-color: #443;
+  --sg-download-a-background-image: linear-gradient(to bottom, #443, #221);
+  --sg-download-a-border-color: 1px solid #3a3a0d;
+  --sg-download-a-color: #fff;
+  --sg-download-a-hover-background-color: #616135;
+  --sg-download-a-hover-box-shadow-1: rgba(0, 0, 0, 0.1);
+  --sg-download-a-hover-box-shadow-2: rgba(255, 255, 255, 0.25);
+}
+@media(prefers-color-scheme: dark){
+  html[data-theme="auto"], body[data-theme="auto"] {
+    --sg-tooltip-foreground: white;
+    --sg-tooltip-background: rgba(10, 10, 10, 0.9);
+    --sg-tooltip-border: #333 transparent;
+    --sg-thumb-box-shadow-color: #79848d40;
+    --sg-thumb-hover-border: #003975;
+    --sg-script-out: rgb(179, 179, 179);
+    --sg-script-pre: #2e2e22;
+    --sg-pytb-foreground: #fff;
+    --sg-pytb-background: #1b1717;
+    --sg-pytb-border-color: #622;
+    --sg-download-a-background-color: #443;
+    --sg-download-a-background-image: linear-gradient(to bottom, #443, #221);
+    --sg-download-a-border-color: 1px solid #3a3a0d;
+    --sg-download-a-color: #fff;
+    --sg-download-a-hover-background-color: #616135;
+    --sg-download-a-hover-box-shadow-1: rgba(0, 0, 0, 0.1);
+    --sg-download-a-hover-box-shadow-2: rgba(255, 255, 255, 0.25);
+  }
+}
+
+.sphx-glr-thumbnails {
+  width: 100%;
+  margin: 0px 0px 20px 0px;
+
+  /* align thumbnails on a grid */
+  justify-content: space-between;
+  display: grid;
+  /* each grid column should be at least 160px (this will determine
+  the actual number of columns) and then take as much of the
+  remaining width as possible */
+  grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
+  gap: 15px;
+}
+.sphx-glr-thumbnails .toctree-wrapper {
+  /* hide empty toctree divs added to the DOM
+  by sphinx even though the toctree is hidden
+  (they would fill grid places with empty divs) */
+  display: none;
+}
+.sphx-glr-thumbcontainer {
+  background: transparent;
+  -moz-border-radius: 5px;
+  -webkit-border-radius: 5px;
+  border-radius: 5px;
+  box-shadow: 0 0 10px var(--sg-thumb-box-shadow-color);
+
+  /* useful to absolutely position link in div */
+  position: relative;
+
+  /* thumbnail width should include padding and borders
+  and take all available space */
+  box-sizing: border-box;
+  width: 100%;
+  padding: 10px;
+  border: 1px solid transparent;
+
+  /* align content in thumbnail */
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 7px;
+}
+.sphx-glr-thumbcontainer p {
+  position: absolute;
+  top: 0;
+  left: 0;
+}
+.sphx-glr-thumbcontainer p,
+.sphx-glr-thumbcontainer p a {
+  /* link should cover the whole thumbnail div */
+  width: 100%;
+  height: 100%;
+}
+.sphx-glr-thumbcontainer p a span {
+  /* text within link should be masked
+  (we are just interested in the href) */
+  display: none;
+}
+.sphx-glr-thumbcontainer:hover {
+  border: 1px solid;
+  border-color: var(--sg-thumb-hover-border);
+  cursor: pointer;
+}
+.sphx-glr-thumbcontainer a.internal {
+  bottom: 0;
+  display: block;
+  left: 0;
+  box-sizing: border-box;
+  padding: 150px 10px 0;
+  position: absolute;
+  right: 0;
+  top: 0;
+}
+/* Next one is to avoid Sphinx traditional theme to cover all the
+thumbnail with its default link Background color */
+.sphx-glr-thumbcontainer a.internal:hover {
+  background-color: transparent;
+}
+
+.sphx-glr-thumbcontainer p {
+  margin: 0 0 0.1em 0;
+}
+.sphx-glr-thumbcontainer .figure {
+  margin: 10px;
+  width: 160px;
+}
+.sphx-glr-thumbcontainer img {
+  display: inline;
+  max-height: 112px;
+  max-width: 160px;
+}
+.sphx-glr-thumbcontainer[tooltip]:hover:after {
+  background: var(--sg-tooltip-background);
+  -webkit-border-radius: 4px;
+  -moz-border-radius: 4px;
+  border-radius: 4px;
+  color: var(--sg-tooltip-foreground);
+  content: attr(tooltip);
+  padding: 10px;
+  z-index: 98;
+  width: 100%;
+  height: 100%;
+  position: absolute;
+  pointer-events: none;
+  top: 0;
+  box-sizing: border-box;
+  overflow: hidden;
+  backdrop-filter: blur(3px);
+}
+
+.sphx-glr-script-out {
+  color: var(--sg-script-out);
+  display: flex;
+  gap: 0.5em;
+}
+.sphx-glr-script-out::before {
+  content: "Out:";
+  /* These numbers come from the pre style in the pydata sphinx theme. This
+   * turns out to match perfectly on the rtd theme, but be a bit too low for
+   * the pydata sphinx theme. As I could not find a dimension to use that was
+   * scaled the same way, I just picked one option that worked pretty close for
+   * both. */
+  line-height: 1.4;
+  padding-top: 10px;
+}
+.sphx-glr-script-out .highlight {
+  background-color: transparent;
+  /* These options make the div expand... */
+  flex-grow: 1;
+  /* ... but also keep it from overflowing its flex container. */
+  overflow: auto;
+}
+.sphx-glr-script-out .highlight pre {
+  background-color: var(--sg-script-pre);
+  border: 0;
+  max-height: 30em;
+  overflow: auto;
+  padding-left: 1ex;
+  /* This margin is necessary in the pydata sphinx theme because pre has a box
+   * shadow which would be clipped by the overflow:auto in the parent div
+   * above. */
+  margin: 2px;
+  word-break: break-word;
+}
+.sphx-glr-script-out + p {
+  margin-top: 1.8em;
+}
+blockquote.sphx-glr-script-out {
+  margin-left: 0pt;
+}
+.sphx-glr-script-out.highlight-pytb .highlight pre {
+  color: var(--sg-pytb-foreground);
+  background-color: var(--sg-pytb-background);
+  border: 1px solid var(--sg-pytb-border-color);
+  margin-top: 10px;
+  padding: 7px;
+}
+
+div.sphx-glr-footer {
+  text-align: center;
+}
+
+div.sphx-glr-download {
+  margin: 1em auto;
+  vertical-align: middle;
+}
+
+div.sphx-glr-download a {
+  background-color: var(--sg-download-a-background-color);
+  background-image: var(--sg-download-a-background-image);
+  border-radius: 4px;
+  border: 1px solid var(--sg-download-a-border-color);
+  color: var(--sg-download-a-color);
+  display: inline-block;
+  font-weight: bold;
+  padding: 1ex;
+  text-align: center;
+}
+
+div.sphx-glr-download code.download {
+  display: inline-block;
+  white-space: normal;
+  word-break: normal;
+  overflow-wrap: break-word;
+  /* border and background are given by the enclosing 'a' */
+  border: none;
+  background: none;
+}
+
+div.sphx-glr-download a:hover {
+  box-shadow: inset 0 1px 0 var(--sg-download-a-hover-box-shadow-1), 0 1px 5px var(--sg-download-a-hover-box-shadow-2);
+  text-decoration: none;
+  background-image: none;
+  background-color: var(--sg-download-a-hover-background-color);
+}
+
+.sphx-glr-example-title:target::before {
+  display: block;
+  content: "";
+  margin-top: -50px;
+  height: 50px;
+  visibility: hidden;
+}
+
+ul.sphx-glr-horizontal {
+  list-style: none;
+  padding: 0;
+}
+ul.sphx-glr-horizontal li {
+  display: inline;
+}
+ul.sphx-glr-horizontal img {
+  height: auto !important;
+}
+
+.sphx-glr-single-img {
+  margin: auto;
+  display: block;
+  max-width: 100%;
+}
+
+.sphx-glr-multi-img {
+  max-width: 42%;
+  height: auto;
+}
+
+div.sphx-glr-animation {
+  margin: auto;
+  display: block;
+  max-width: 100%;
+}
+div.sphx-glr-animation .animation {
+  display: block;
+}
+
+p.sphx-glr-signature a.reference.external {
+  -moz-border-radius: 5px;
+  -webkit-border-radius: 5px;
+  border-radius: 5px;
+  padding: 3px;
+  font-size: 75%;
+  text-align: right;
+  margin-left: auto;
+  display: table;
+}
+
+.sphx-glr-clear {
+  clear: both;
+}
+
+a.sphx-glr-backref-instance {
+  text-decoration: none;
+}
diff --git a/pr-2241/_static/sphinx_highlight.js b/pr-2241/_static/sphinx_highlight.js
new file mode 100644
index 0000000000..aae669d7ea
--- /dev/null
+++ b/pr-2241/_static/sphinx_highlight.js
@@ -0,0 +1,144 @@
+/* Highlighting utilities for Sphinx HTML documentation. */
+"use strict";
+
+const SPHINX_HIGHLIGHT_ENABLED = true
+
+/**
+ * highlight a given string on a node by wrapping it in
+ * span elements with the given class name.
+ */
+const _highlight = (node, addItems, text, className) => {
+  if (node.nodeType === Node.TEXT_NODE) {
+    const val = node.nodeValue;
+    const parent = node.parentNode;
+    const pos = val.toLowerCase().indexOf(text);
+    if (
+      pos >= 0 &&
+      !parent.classList.contains(className) &&
+      !parent.classList.contains("nohighlight")
+    ) {
+      let span;
+
+      const closestNode = parent.closest("body, svg, foreignObject");
+      const isInSVG = closestNode && closestNode.matches("svg");
+      if (isInSVG) {
+        span = document.createElementNS("http://www.w3.org/2000/svg", "tspan");
+      } else {
+        span = document.createElement("span");
+        span.classList.add(className);
+      }
+
+      span.appendChild(document.createTextNode(val.substr(pos, text.length)));
+      parent.insertBefore(
+        span,
+        parent.insertBefore(
+          document.createTextNode(val.substr(pos + text.length)),
+          node.nextSibling
+        )
+      );
+      node.nodeValue = val.substr(0, pos);
+
+      if (isInSVG) {
+        const rect = document.createElementNS(
+          "http://www.w3.org/2000/svg",
+          "rect"
+        );
+        const bbox = parent.getBBox();
+        rect.x.baseVal.value = bbox.x;
+        rect.y.baseVal.value = bbox.y;
+        rect.width.baseVal.value = bbox.width;
+        rect.height.baseVal.value = bbox.height;
+        rect.setAttribute("class", className);
+        addItems.push({ parent: parent, target: rect });
+      }
+    }
+  } else if (node.matches && !node.matches("button, select, textarea")) {
+    node.childNodes.forEach((el) => _highlight(el, addItems, text, className));
+  }
+};
+const _highlightText = (thisNode, text, className) => {
+  let addItems = [];
+  _highlight(thisNode, addItems, text, className);
+  addItems.forEach((obj) =>
+    obj.parent.insertAdjacentElement("beforebegin", obj.target)
+  );
+};
+
+/**
+ * Small JavaScript module for the documentation.
+ */
+const SphinxHighlight = {
+
+  /**
+   * highlight the search words provided in localstorage in the text
+   */
+  highlightSearchWords: () => {
+    if (!SPHINX_HIGHLIGHT_ENABLED) return;  // bail if no highlight
+
+    // get and clear terms from localstorage
+    const url = new URL(window.location);
+    const highlight =
+        localStorage.getItem("sphinx_highlight_terms")
+        || url.searchParams.get("highlight")
+        || "";
+    localStorage.removeItem("sphinx_highlight_terms")
+    url.searchParams.delete("highlight");
+    window.history.replaceState({}, "", url);
+
+    // get individual terms from highlight string
+    const terms = highlight.toLowerCase().split(/\s+/).filter(x => x);
+    if (terms.length === 0) return; // nothing to do
+
+    // There should never be more than one element matching "div.body"
+    const divBody = document.querySelectorAll("div.body");
+    const body = divBody.length ? divBody[0] : document.querySelector("body");
+    window.setTimeout(() => {
+      terms.forEach((term) => _highlightText(body, term, "highlighted"));
+    }, 10);
+
+    const searchBox = document.getElementById("searchbox");
+    if (searchBox === null) return;
+    searchBox.appendChild(
+      document
+        .createRange()
+        .createContextualFragment(
+          '<p class="highlight-link">' +
+            '<a href="javascript:SphinxHighlight.hideSearchWords()">' +
+            _("Hide Search Matches") +
+            "</a></p>"
+        )
+    );
+  },
+
+  /**
+   * helper function to hide the search marks again
+   */
+  hideSearchWords: () => {
+    document
+      .querySelectorAll("#searchbox .highlight-link")
+      .forEach((el) => el.remove());
+    document
+      .querySelectorAll("span.highlighted")
+      .forEach((el) => el.classList.remove("highlighted"));
+    localStorage.removeItem("sphinx_highlight_terms")
+  },
+
+  initEscapeListener: () => {
+    // only install a listener if it is really needed
+    if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return;
+
+    document.addEventListener("keydown", (event) => {
+      // bail for input elements
+      if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return;
+      // bail with special keys
+      if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return;
+      if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) {
+        SphinxHighlight.hideSearchWords();
+        event.preventDefault();
+      }
+    });
+  },
+};
+
+_ready(SphinxHighlight.highlightSearchWords);
+_ready(SphinxHighlight.initEscapeListener);
diff --git a/pr-2241/_static/startVscode.png b/pr-2241/_static/startVscode.png
new file mode 100644
index 0000000000..f7f78a1209
Binary files /dev/null and b/pr-2241/_static/startVscode.png differ
diff --git a/pr-2241/_static/tabs.css b/pr-2241/_static/tabs.css
new file mode 100644
index 0000000000..13042e5672
--- /dev/null
+++ b/pr-2241/_static/tabs.css
@@ -0,0 +1,110 @@
+/* body[data-theme] { */
+:root {
+  --tabs--label-text: #4b5563;
+  --tabs--label-text--hover: #4b5563;
+  --tabs--label-text--active: #0ea5e9;
+  --tabs--label-text--active--hover: #0ea5e9;
+  --tabs--label-background: transparent;
+  --tabs--label-background--hover: transparent;
+  --tabs--label-background--active: transparent;
+  --tabs--label-background--active--hover: transparent;
+  --tabs--label-border: transparent;
+  --tabs--label-border--hover: #d1d5db;
+  --tabs--label-border--active: #0ea5e9;
+  --tabs--label-border--active--hover: #0ea5e9;
+  --tabs--padding-x: 1.25em;
+  --tabs--margin-x: 0;
+  --tabs--border: #e6e6e6;
+}
+
+/* Hide radio buttons */
+.tab-set > input {
+  position: absolute;
+  opacity: 0;
+}
+
+/* Tab set container */
+.tab-set {
+  border-radius: 2px;
+  display: flex;
+  flex-wrap: wrap;
+  margin: 0.75em 0;
+  position: relative;
+}
+
+/* Tab label */
+.tab-set > label {
+  z-index: 1;
+
+  width: auto;
+  border-bottom: 2px solid var(--tabs--label-border);
+  padding: 1em var(--tabs--padding-x) 0.5em;
+  margin-left: var(--tabs--margin-x);
+
+  color: var(--tabs--label-text);
+  background: var(--tabs--label-background);
+
+  transition: color 250ms;
+
+  cursor: pointer;
+
+  font-size: 0.875em;
+  font-weight: 700;
+}
+.tab-set > label:nth-child(2) {
+  margin-left: 0;
+}
+
+/* Hovered label */
+.tab-set > label:hover {
+  color: var(--tabs--label-text--hover);
+  background: var(--tabs--label-background--hover);
+  border-color: var(--tabs--label-border--hover);
+}
+
+/* Active tab label */
+.tab-set > input:checked + label {
+  color: var(--tabs--label-text--active);
+  background: var(--tabs--label-background--active);
+  border-color: var(--tabs--label-border--active);
+}
+.tab-set > input:checked + label:hover {
+  color: var(--tabs--label-text--active--hover);
+  background: var(--tabs--label-background--active--hover);
+  border-color: var(--tabs--label-border--active--hover);
+}
+
+/* Tab content */
+.tab-content {
+  order: 99;
+  display: none;
+  width: 100%;
+  box-shadow: 0 -0.0625rem var(--tabs--border);
+}
+
+/* Show content, when input is checked. */
+.tab-set > input:checked + label + .tab-content {
+  display: block;
+}
+.tab-content > p:first-child {
+  margin-top: 0.75rem;
+}
+/* Remove the top border on first code block */
+.tab-content > [class^="highlight-"]:first-child .highlight {
+  border-top: none;
+  border-top-left-radius: 0;
+  border-top-right-radius: 0;
+}
+
+/* Remove margins on children */
+.tab-content > *:first-child {
+  margin-top: 0;
+}
+.tab-content > *:last-child {
+  margin-bottom: 0;
+}
+
+/* Remove margins on nested tabs */
+.tab-content > .tab-set {
+  margin: 0;
+}
diff --git a/pr-2241/_static/tabs.js b/pr-2241/_static/tabs.js
new file mode 100644
index 0000000000..58d2cdddd4
--- /dev/null
+++ b/pr-2241/_static/tabs.js
@@ -0,0 +1,30 @@
+var labels_by_text = {};
+
+function ready() {
+  var li = document.getElementsByClassName("tab-label");
+  const urlParams = new URLSearchParams(window.location.search);
+  const tabs = urlParams.getAll("tabs");
+
+  for (const label of li) {
+    label.onclick = onLabelClick;
+    const text = label.textContent;
+    if (!labels_by_text[text]) {
+      labels_by_text[text] = [];
+    }
+    labels_by_text[text].push(label);
+  }
+
+  for (const tab of tabs) {
+    for (label of labels_by_text[tab]) {
+      label.previousSibling.checked = true;
+    }
+  }
+}
+
+function onLabelClick() {
+  // Activate other labels with the same text.
+  for (label of labels_by_text[this.textContent]) {
+    label.previousSibling.checked = true;
+  }
+}
+document.addEventListener("DOMContentLoaded", ready, false);
diff --git a/pr-2241/_static/underscore-1.13.1.js b/pr-2241/_static/underscore-1.13.1.js
new file mode 100644
index 0000000000..ffd77af964
--- /dev/null
+++ b/pr-2241/_static/underscore-1.13.1.js
@@ -0,0 +1,2042 @@
+(function (global, factory) {
+  typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+  typeof define === 'function' && define.amd ? define('underscore', factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, (function () {
+    var current = global._;
+    var exports = global._ = factory();
+    exports.noConflict = function () { global._ = current; return exports; };
+  }()));
+}(this, (function () {
+  //     Underscore.js 1.13.1
+  //     https://underscorejs.org
+  //     (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors
+  //     Underscore may be freely distributed under the MIT license.
+
+  // Current version.
+  var VERSION = '1.13.1';
+
+  // Establish the root object, `window` (`self`) in the browser, `global`
+  // on the server, or `this` in some virtual machines. We use `self`
+  // instead of `window` for `WebWorker` support.
+  var root = typeof self == 'object' && self.self === self && self ||
+            typeof global == 'object' && global.global === global && global ||
+            Function('return this')() ||
+            {};
+
+  // Save bytes in the minified (but not gzipped) version:
+  var ArrayProto = Array.prototype, ObjProto = Object.prototype;
+  var SymbolProto = typeof Symbol !== 'undefined' ? Symbol.prototype : null;
+
+  // Create quick reference variables for speed access to core prototypes.
+  var push = ArrayProto.push,
+      slice = ArrayProto.slice,
+      toString = ObjProto.toString,
+      hasOwnProperty = ObjProto.hasOwnProperty;
+
+  // Modern feature detection.
+  var supportsArrayBuffer = typeof ArrayBuffer !== 'undefined',
+      supportsDataView = typeof DataView !== 'undefined';
+
+  // All **ECMAScript 5+** native function implementations that we hope to use
+  // are declared here.
+  var nativeIsArray = Array.isArray,
+      nativeKeys = Object.keys,
+      nativeCreate = Object.create,
+      nativeIsView = supportsArrayBuffer && ArrayBuffer.isView;
+
+  // Create references to these builtin functions because we override them.
+  var _isNaN = isNaN,
+      _isFinite = isFinite;
+
+  // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed.
+  var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString');
+  var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString',
+    'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString'];
+
+  // The largest integer that can be represented exactly.
+  var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1;
+
+  // Some functions take a variable number of arguments, or a few expected
+  // arguments at the beginning and then a variable number of values to operate
+  // on. This helper accumulates all remaining arguments past the function’s
+  // argument length (or an explicit `startIndex`), into an array that becomes
+  // the last argument. Similar to ES6’s "rest parameter".
+  function restArguments(func, startIndex) {
+    startIndex = startIndex == null ? func.length - 1 : +startIndex;
+    return function() {
+      var length = Math.max(arguments.length - startIndex, 0),
+          rest = Array(length),
+          index = 0;
+      for (; index < length; index++) {
+        rest[index] = arguments[index + startIndex];
+      }
+      switch (startIndex) {
+        case 0: return func.call(this, rest);
+        case 1: return func.call(this, arguments[0], rest);
+        case 2: return func.call(this, arguments[0], arguments[1], rest);
+      }
+      var args = Array(startIndex + 1);
+      for (index = 0; index < startIndex; index++) {
+        args[index] = arguments[index];
+      }
+      args[startIndex] = rest;
+      return func.apply(this, args);
+    };
+  }
+
+  // Is a given variable an object?
+  function isObject(obj) {
+    var type = typeof obj;
+    return type === 'function' || type === 'object' && !!obj;
+  }
+
+  // Is a given value equal to null?
+  function isNull(obj) {
+    return obj === null;
+  }
+
+  // Is a given variable undefined?
+  function isUndefined(obj) {
+    return obj === void 0;
+  }
+
+  // Is a given value a boolean?
+  function isBoolean(obj) {
+    return obj === true || obj === false || toString.call(obj) === '[object Boolean]';
+  }
+
+  // Is a given value a DOM element?
+  function isElement(obj) {
+    return !!(obj && obj.nodeType === 1);
+  }
+
+  // Internal function for creating a `toString`-based type tester.
+  function tagTester(name) {
+    var tag = '[object ' + name + ']';
+    return function(obj) {
+      return toString.call(obj) === tag;
+    };
+  }
+
+  var isString = tagTester('String');
+
+  var isNumber = tagTester('Number');
+
+  var isDate = tagTester('Date');
+
+  var isRegExp = tagTester('RegExp');
+
+  var isError = tagTester('Error');
+
+  var isSymbol = tagTester('Symbol');
+
+  var isArrayBuffer = tagTester('ArrayBuffer');
+
+  var isFunction = tagTester('Function');
+
+  // Optimize `isFunction` if appropriate. Work around some `typeof` bugs in old
+  // v8, IE 11 (#1621), Safari 8 (#1929), and PhantomJS (#2236).
+  var nodelist = root.document && root.document.childNodes;
+  if (typeof /./ != 'function' && typeof Int8Array != 'object' && typeof nodelist != 'function') {
+    isFunction = function(obj) {
+      return typeof obj == 'function' || false;
+    };
+  }
+
+  var isFunction$1 = isFunction;
+
+  var hasObjectTag = tagTester('Object');
+
+  // In IE 10 - Edge 13, `DataView` has string tag `'[object Object]'`.
+  // In IE 11, the most common among them, this problem also applies to
+  // `Map`, `WeakMap` and `Set`.
+  var hasStringTagBug = (
+        supportsDataView && hasObjectTag(new DataView(new ArrayBuffer(8)))
+      ),
+      isIE11 = (typeof Map !== 'undefined' && hasObjectTag(new Map));
+
+  var isDataView = tagTester('DataView');
+
+  // In IE 10 - Edge 13, we need a different heuristic
+  // to determine whether an object is a `DataView`.
+  function ie10IsDataView(obj) {
+    return obj != null && isFunction$1(obj.getInt8) && isArrayBuffer(obj.buffer);
+  }
+
+  var isDataView$1 = (hasStringTagBug ? ie10IsDataView : isDataView);
+
+  // Is a given value an array?
+  // Delegates to ECMA5's native `Array.isArray`.
+  var isArray = nativeIsArray || tagTester('Array');
+
+  // Internal function to check whether `key` is an own property name of `obj`.
+  function has$1(obj, key) {
+    return obj != null && hasOwnProperty.call(obj, key);
+  }
+
+  var isArguments = tagTester('Arguments');
+
+  // Define a fallback version of the method in browsers (ahem, IE < 9), where
+  // there isn't any inspectable "Arguments" type.
+  (function() {
+    if (!isArguments(arguments)) {
+      isArguments = function(obj) {
+        return has$1(obj, 'callee');
+      };
+    }
+  }());
+
+  var isArguments$1 = isArguments;
+
+  // Is a given object a finite number?
+  function isFinite$1(obj) {
+    return !isSymbol(obj) && _isFinite(obj) && !isNaN(parseFloat(obj));
+  }
+
+  // Is the given value `NaN`?
+  function isNaN$1(obj) {
+    return isNumber(obj) && _isNaN(obj);
+  }
+
+  // Predicate-generating function. Often useful outside of Underscore.
+  function constant(value) {
+    return function() {
+      return value;
+    };
+  }
+
+  // Common internal logic for `isArrayLike` and `isBufferLike`.
+  function createSizePropertyCheck(getSizeProperty) {
+    return function(collection) {
+      var sizeProperty = getSizeProperty(collection);
+      return typeof sizeProperty == 'number' && sizeProperty >= 0 && sizeProperty <= MAX_ARRAY_INDEX;
+    }
+  }
+
+  // Internal helper to generate a function to obtain property `key` from `obj`.
+  function shallowProperty(key) {
+    return function(obj) {
+      return obj == null ? void 0 : obj[key];
+    };
+  }
+
+  // Internal helper to obtain the `byteLength` property of an object.
+  var getByteLength = shallowProperty('byteLength');
+
+  // Internal helper to determine whether we should spend extensive checks against
+  // `ArrayBuffer` et al.
+  var isBufferLike = createSizePropertyCheck(getByteLength);
+
+  // Is a given value a typed array?
+  var typedArrayPattern = /\[object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\]/;
+  function isTypedArray(obj) {
+    // `ArrayBuffer.isView` is the most future-proof, so use it when available.
+    // Otherwise, fall back on the above regular expression.
+    return nativeIsView ? (nativeIsView(obj) && !isDataView$1(obj)) :
+                  isBufferLike(obj) && typedArrayPattern.test(toString.call(obj));
+  }
+
+  var isTypedArray$1 = supportsArrayBuffer ? isTypedArray : constant(false);
+
+  // Internal helper to obtain the `length` property of an object.
+  var getLength = shallowProperty('length');
+
+  // Internal helper to create a simple lookup structure.
+  // `collectNonEnumProps` used to depend on `_.contains`, but this led to
+  // circular imports. `emulatedSet` is a one-off solution that only works for
+  // arrays of strings.
+  function emulatedSet(keys) {
+    var hash = {};
+    for (var l = keys.length, i = 0; i < l; ++i) hash[keys[i]] = true;
+    return {
+      contains: function(key) { return hash[key]; },
+      push: function(key) {
+        hash[key] = true;
+        return keys.push(key);
+      }
+    };
+  }
+
+  // Internal helper. Checks `keys` for the presence of keys in IE < 9 that won't
+  // be iterated by `for key in ...` and thus missed. Extends `keys` in place if
+  // needed.
+  function collectNonEnumProps(obj, keys) {
+    keys = emulatedSet(keys);
+    var nonEnumIdx = nonEnumerableProps.length;
+    var constructor = obj.constructor;
+    var proto = isFunction$1(constructor) && constructor.prototype || ObjProto;
+
+    // Constructor is a special case.
+    var prop = 'constructor';
+    if (has$1(obj, prop) && !keys.contains(prop)) keys.push(prop);
+
+    while (nonEnumIdx--) {
+      prop = nonEnumerableProps[nonEnumIdx];
+      if (prop in obj && obj[prop] !== proto[prop] && !keys.contains(prop)) {
+        keys.push(prop);
+      }
+    }
+  }
+
+  // Retrieve the names of an object's own properties.
+  // Delegates to **ECMAScript 5**'s native `Object.keys`.
+  function keys(obj) {
+    if (!isObject(obj)) return [];
+    if (nativeKeys) return nativeKeys(obj);
+    var keys = [];
+    for (var key in obj) if (has$1(obj, key)) keys.push(key);
+    // Ahem, IE < 9.
+    if (hasEnumBug) collectNonEnumProps(obj, keys);
+    return keys;
+  }
+
+  // Is a given array, string, or object empty?
+  // An "empty" object has no enumerable own-properties.
+  function isEmpty(obj) {
+    if (obj == null) return true;
+    // Skip the more expensive `toString`-based type checks if `obj` has no
+    // `.length`.
+    var length = getLength(obj);
+    if (typeof length == 'number' && (
+      isArray(obj) || isString(obj) || isArguments$1(obj)
+    )) return length === 0;
+    return getLength(keys(obj)) === 0;
+  }
+
+  // Returns whether an object has a given set of `key:value` pairs.
+  function isMatch(object, attrs) {
+    var _keys = keys(attrs), length = _keys.length;
+    if (object == null) return !length;
+    var obj = Object(object);
+    for (var i = 0; i < length; i++) {
+      var key = _keys[i];
+      if (attrs[key] !== obj[key] || !(key in obj)) return false;
+    }
+    return true;
+  }
+
+  // If Underscore is called as a function, it returns a wrapped object that can
+  // be used OO-style. This wrapper holds altered versions of all functions added
+  // through `_.mixin`. Wrapped objects may be chained.
+  function _$1(obj) {
+    if (obj instanceof _$1) return obj;
+    if (!(this instanceof _$1)) return new _$1(obj);
+    this._wrapped = obj;
+  }
+
+  _$1.VERSION = VERSION;
+
+  // Extracts the result from a wrapped and chained object.
+  _$1.prototype.value = function() {
+    return this._wrapped;
+  };
+
+  // Provide unwrapping proxies for some methods used in engine operations
+  // such as arithmetic and JSON stringification.
+  _$1.prototype.valueOf = _$1.prototype.toJSON = _$1.prototype.value;
+
+  _$1.prototype.toString = function() {
+    return String(this._wrapped);
+  };
+
+  // Internal function to wrap or shallow-copy an ArrayBuffer,
+  // typed array or DataView to a new view, reusing the buffer.
+  function toBufferView(bufferSource) {
+    return new Uint8Array(
+      bufferSource.buffer || bufferSource,
+      bufferSource.byteOffset || 0,
+      getByteLength(bufferSource)
+    );
+  }
+
+  // We use this string twice, so give it a name for minification.
+  var tagDataView = '[object DataView]';
+
+  // Internal recursive comparison function for `_.isEqual`.
+  function eq(a, b, aStack, bStack) {
+    // Identical objects are equal. `0 === -0`, but they aren't identical.
+    // See the [Harmony `egal` proposal](https://wiki.ecmascript.org/doku.php?id=harmony:egal).
+    if (a === b) return a !== 0 || 1 / a === 1 / b;
+    // `null` or `undefined` only equal to itself (strict comparison).
+    if (a == null || b == null) return false;
+    // `NaN`s are equivalent, but non-reflexive.
+    if (a !== a) return b !== b;
+    // Exhaust primitive checks
+    var type = typeof a;
+    if (type !== 'function' && type !== 'object' && typeof b != 'object') return false;
+    return deepEq(a, b, aStack, bStack);
+  }
+
+  // Internal recursive comparison function for `_.isEqual`.
+  function deepEq(a, b, aStack, bStack) {
+    // Unwrap any wrapped objects.
+    if (a instanceof _$1) a = a._wrapped;
+    if (b instanceof _$1) b = b._wrapped;
+    // Compare `[[Class]]` names.
+    var className = toString.call(a);
+    if (className !== toString.call(b)) return false;
+    // Work around a bug in IE 10 - Edge 13.
+    if (hasStringTagBug && className == '[object Object]' && isDataView$1(a)) {
+      if (!isDataView$1(b)) return false;
+      className = tagDataView;
+    }
+    switch (className) {
+      // These types are compared by value.
+      case '[object RegExp]':
+        // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i')
+      case '[object String]':
+        // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is
+        // equivalent to `new String("5")`.
+        return '' + a === '' + b;
+      case '[object Number]':
+        // `NaN`s are equivalent, but non-reflexive.
+        // Object(NaN) is equivalent to NaN.
+        if (+a !== +a) return +b !== +b;
+        // An `egal` comparison is performed for other numeric values.
+        return +a === 0 ? 1 / +a === 1 / b : +a === +b;
+      case '[object Date]':
+      case '[object Boolean]':
+        // Coerce dates and booleans to numeric primitive values. Dates are compared by their
+        // millisecond representations. Note that invalid dates with millisecond representations
+        // of `NaN` are not equivalent.
+        return +a === +b;
+      case '[object Symbol]':
+        return SymbolProto.valueOf.call(a) === SymbolProto.valueOf.call(b);
+      case '[object ArrayBuffer]':
+      case tagDataView:
+        // Coerce to typed array so we can fall through.
+        return deepEq(toBufferView(a), toBufferView(b), aStack, bStack);
+    }
+
+    var areArrays = className === '[object Array]';
+    if (!areArrays && isTypedArray$1(a)) {
+        var byteLength = getByteLength(a);
+        if (byteLength !== getByteLength(b)) return false;
+        if (a.buffer === b.buffer && a.byteOffset === b.byteOffset) return true;
+        areArrays = true;
+    }
+    if (!areArrays) {
+      if (typeof a != 'object' || typeof b != 'object') return false;
+
+      // Objects with different constructors are not equivalent, but `Object`s or `Array`s
+      // from different frames are.
+      var aCtor = a.constructor, bCtor = b.constructor;
+      if (aCtor !== bCtor && !(isFunction$1(aCtor) && aCtor instanceof aCtor &&
+                               isFunction$1(bCtor) && bCtor instanceof bCtor)
+                          && ('constructor' in a && 'constructor' in b)) {
+        return false;
+      }
+    }
+    // Assume equality for cyclic structures. The algorithm for detecting cyclic
+    // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
+
+    // Initializing stack of traversed objects.
+    // It's done here since we only need them for objects and arrays comparison.
+    aStack = aStack || [];
+    bStack = bStack || [];
+    var length = aStack.length;
+    while (length--) {
+      // Linear search. Performance is inversely proportional to the number of
+      // unique nested structures.
+      if (aStack[length] === a) return bStack[length] === b;
+    }
+
+    // Add the first object to the stack of traversed objects.
+    aStack.push(a);
+    bStack.push(b);
+
+    // Recursively compare objects and arrays.
+    if (areArrays) {
+      // Compare array lengths to determine if a deep comparison is necessary.
+      length = a.length;
+      if (length !== b.length) return false;
+      // Deep compare the contents, ignoring non-numeric properties.
+      while (length--) {
+        if (!eq(a[length], b[length], aStack, bStack)) return false;
+      }
+    } else {
+      // Deep compare objects.
+      var _keys = keys(a), key;
+      length = _keys.length;
+      // Ensure that both objects contain the same number of properties before comparing deep equality.
+      if (keys(b).length !== length) return false;
+      while (length--) {
+        // Deep compare each member
+        key = _keys[length];
+        if (!(has$1(b, key) && eq(a[key], b[key], aStack, bStack))) return false;
+      }
+    }
+    // Remove the first object from the stack of traversed objects.
+    aStack.pop();
+    bStack.pop();
+    return true;
+  }
+
+  // Perform a deep comparison to check if two objects are equal.
+  function isEqual(a, b) {
+    return eq(a, b);
+  }
+
+  // Retrieve all the enumerable property names of an object.
+  function allKeys(obj) {
+    if (!isObject(obj)) return [];
+    var keys = [];
+    for (var key in obj) keys.push(key);
+    // Ahem, IE < 9.
+    if (hasEnumBug) collectNonEnumProps(obj, keys);
+    return keys;
+  }
+
+  // Since the regular `Object.prototype.toString` type tests don't work for
+  // some types in IE 11, we use a fingerprinting heuristic instead, based
+  // on the methods. It's not great, but it's the best we got.
+  // The fingerprint method lists are defined below.
+  function ie11fingerprint(methods) {
+    var length = getLength(methods);
+    return function(obj) {
+      if (obj == null) return false;
+      // `Map`, `WeakMap` and `Set` have no enumerable keys.
+      var keys = allKeys(obj);
+      if (getLength(keys)) return false;
+      for (var i = 0; i < length; i++) {
+        if (!isFunction$1(obj[methods[i]])) return false;
+      }
+      // If we are testing against `WeakMap`, we need to ensure that
+      // `obj` doesn't have a `forEach` method in order to distinguish
+      // it from a regular `Map`.
+      return methods !== weakMapMethods || !isFunction$1(obj[forEachName]);
+    };
+  }
+
+  // In the interest of compact minification, we write
+  // each string in the fingerprints only once.
+  var forEachName = 'forEach',
+      hasName = 'has',
+      commonInit = ['clear', 'delete'],
+      mapTail = ['get', hasName, 'set'];
+
+  // `Map`, `WeakMap` and `Set` each have slightly different
+  // combinations of the above sublists.
+  var mapMethods = commonInit.concat(forEachName, mapTail),
+      weakMapMethods = commonInit.concat(mapTail),
+      setMethods = ['add'].concat(commonInit, forEachName, hasName);
+
+  var isMap = isIE11 ? ie11fingerprint(mapMethods) : tagTester('Map');
+
+  var isWeakMap = isIE11 ? ie11fingerprint(weakMapMethods) : tagTester('WeakMap');
+
+  var isSet = isIE11 ? ie11fingerprint(setMethods) : tagTester('Set');
+
+  var isWeakSet = tagTester('WeakSet');
+
+  // Retrieve the values of an object's properties.
+  function values(obj) {
+    var _keys = keys(obj);
+    var length = _keys.length;
+    var values = Array(length);
+    for (var i = 0; i < length; i++) {
+      values[i] = obj[_keys[i]];
+    }
+    return values;
+  }
+
+  // Convert an object into a list of `[key, value]` pairs.
+  // The opposite of `_.object` with one argument.
+  function pairs(obj) {
+    var _keys = keys(obj);
+    var length = _keys.length;
+    var pairs = Array(length);
+    for (var i = 0; i < length; i++) {
+      pairs[i] = [_keys[i], obj[_keys[i]]];
+    }
+    return pairs;
+  }
+
+  // Invert the keys and values of an object. The values must be serializable.
+  function invert(obj) {
+    var result = {};
+    var _keys = keys(obj);
+    for (var i = 0, length = _keys.length; i < length; i++) {
+      result[obj[_keys[i]]] = _keys[i];
+    }
+    return result;
+  }
+
+  // Return a sorted list of the function names available on the object.
+  function functions(obj) {
+    var names = [];
+    for (var key in obj) {
+      if (isFunction$1(obj[key])) names.push(key);
+    }
+    return names.sort();
+  }
+
+  // An internal function for creating assigner functions.
+  function createAssigner(keysFunc, defaults) {
+    return function(obj) {
+      var length = arguments.length;
+      if (defaults) obj = Object(obj);
+      if (length < 2 || obj == null) return obj;
+      for (var index = 1; index < length; index++) {
+        var source = arguments[index],
+            keys = keysFunc(source),
+            l = keys.length;
+        for (var i = 0; i < l; i++) {
+          var key = keys[i];
+          if (!defaults || obj[key] === void 0) obj[key] = source[key];
+        }
+      }
+      return obj;
+    };
+  }
+
+  // Extend a given object with all the properties in passed-in object(s).
+  var extend = createAssigner(allKeys);
+
+  // Assigns a given object with all the own properties in the passed-in
+  // object(s).
+  // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign)
+  var extendOwn = createAssigner(keys);
+
+  // Fill in a given object with default properties.
+  var defaults = createAssigner(allKeys, true);
+
+  // Create a naked function reference for surrogate-prototype-swapping.
+  function ctor() {
+    return function(){};
+  }
+
+  // An internal function for creating a new object that inherits from another.
+  function baseCreate(prototype) {
+    if (!isObject(prototype)) return {};
+    if (nativeCreate) return nativeCreate(prototype);
+    var Ctor = ctor();
+    Ctor.prototype = prototype;
+    var result = new Ctor;
+    Ctor.prototype = null;
+    return result;
+  }
+
+  // Creates an object that inherits from the given prototype object.
+  // If additional properties are provided then they will be added to the
+  // created object.
+  function create(prototype, props) {
+    var result = baseCreate(prototype);
+    if (props) extendOwn(result, props);
+    return result;
+  }
+
+  // Create a (shallow-cloned) duplicate of an object.
+  function clone(obj) {
+    if (!isObject(obj)) return obj;
+    return isArray(obj) ? obj.slice() : extend({}, obj);
+  }
+
+  // Invokes `interceptor` with the `obj` and then returns `obj`.
+  // The primary purpose of this method is to "tap into" a method chain, in
+  // order to perform operations on intermediate results within the chain.
+  function tap(obj, interceptor) {
+    interceptor(obj);
+    return obj;
+  }
+
+  // Normalize a (deep) property `path` to array.
+  // Like `_.iteratee`, this function can be customized.
+  function toPath$1(path) {
+    return isArray(path) ? path : [path];
+  }
+  _$1.toPath = toPath$1;
+
+  // Internal wrapper for `_.toPath` to enable minification.
+  // Similar to `cb` for `_.iteratee`.
+  function toPath(path) {
+    return _$1.toPath(path);
+  }
+
+  // Internal function to obtain a nested property in `obj` along `path`.
+  function deepGet(obj, path) {
+    var length = path.length;
+    for (var i = 0; i < length; i++) {
+      if (obj == null) return void 0;
+      obj = obj[path[i]];
+    }
+    return length ? obj : void 0;
+  }
+
+  // Get the value of the (deep) property on `path` from `object`.
+  // If any property in `path` does not exist or if the value is
+  // `undefined`, return `defaultValue` instead.
+  // The `path` is normalized through `_.toPath`.
+  function get(object, path, defaultValue) {
+    var value = deepGet(object, toPath(path));
+    return isUndefined(value) ? defaultValue : value;
+  }
+
+  // Shortcut function for checking if an object has a given property directly on
+  // itself (in other words, not on a prototype). Unlike the internal `has`
+  // function, this public version can also traverse nested properties.
+  function has(obj, path) {
+    path = toPath(path);
+    var length = path.length;
+    for (var i = 0; i < length; i++) {
+      var key = path[i];
+      if (!has$1(obj, key)) return false;
+      obj = obj[key];
+    }
+    return !!length;
+  }
+
+  // Keep the identity function around for default iteratees.
+  function identity(value) {
+    return value;
+  }
+
+  // Returns a predicate for checking whether an object has a given set of
+  // `key:value` pairs.
+  function matcher(attrs) {
+    attrs = extendOwn({}, attrs);
+    return function(obj) {
+      return isMatch(obj, attrs);
+    };
+  }
+
+  // Creates a function that, when passed an object, will traverse that object’s
+  // properties down the given `path`, specified as an array of keys or indices.
+  function property(path) {
+    path = toPath(path);
+    return function(obj) {
+      return deepGet(obj, path);
+    };
+  }
+
+  // Internal function that returns an efficient (for current engines) version
+  // of the passed-in callback, to be repeatedly applied in other Underscore
+  // functions.
+  function optimizeCb(func, context, argCount) {
+    if (context === void 0) return func;
+    switch (argCount == null ? 3 : argCount) {
+      case 1: return function(value) {
+        return func.call(context, value);
+      };
+      // The 2-argument case is omitted because we’re not using it.
+      case 3: return function(value, index, collection) {
+        return func.call(context, value, index, collection);
+      };
+      case 4: return function(accumulator, value, index, collection) {
+        return func.call(context, accumulator, value, index, collection);
+      };
+    }
+    return function() {
+      return func.apply(context, arguments);
+    };
+  }
+
+  // An internal function to generate callbacks that can be applied to each
+  // element in a collection, returning the desired result — either `_.identity`,
+  // an arbitrary callback, a property matcher, or a property accessor.
+  function baseIteratee(value, context, argCount) {
+    if (value == null) return identity;
+    if (isFunction$1(value)) return optimizeCb(value, context, argCount);
+    if (isObject(value) && !isArray(value)) return matcher(value);
+    return property(value);
+  }
+
+  // External wrapper for our callback generator. Users may customize
+  // `_.iteratee` if they want additional predicate/iteratee shorthand styles.
+  // This abstraction hides the internal-only `argCount` argument.
+  function iteratee(value, context) {
+    return baseIteratee(value, context, Infinity);
+  }
+  _$1.iteratee = iteratee;
+
+  // The function we call internally to generate a callback. It invokes
+  // `_.iteratee` if overridden, otherwise `baseIteratee`.
+  function cb(value, context, argCount) {
+    if (_$1.iteratee !== iteratee) return _$1.iteratee(value, context);
+    return baseIteratee(value, context, argCount);
+  }
+
+  // Returns the results of applying the `iteratee` to each element of `obj`.
+  // In contrast to `_.map` it returns an object.
+  function mapObject(obj, iteratee, context) {
+    iteratee = cb(iteratee, context);
+    var _keys = keys(obj),
+        length = _keys.length,
+        results = {};
+    for (var index = 0; index < length; index++) {
+      var currentKey = _keys[index];
+      results[currentKey] = iteratee(obj[currentKey], currentKey, obj);
+    }
+    return results;
+  }
+
+  // Predicate-generating function. Often useful outside of Underscore.
+  function noop(){}
+
+  // Generates a function for a given object that returns a given property.
+  function propertyOf(obj) {
+    if (obj == null) return noop;
+    return function(path) {
+      return get(obj, path);
+    };
+  }
+
+  // Run a function **n** times.
+  function times(n, iteratee, context) {
+    var accum = Array(Math.max(0, n));
+    iteratee = optimizeCb(iteratee, context, 1);
+    for (var i = 0; i < n; i++) accum[i] = iteratee(i);
+    return accum;
+  }
+
+  // Return a random integer between `min` and `max` (inclusive).
+  function random(min, max) {
+    if (max == null) {
+      max = min;
+      min = 0;
+    }
+    return min + Math.floor(Math.random() * (max - min + 1));
+  }
+
+  // A (possibly faster) way to get the current timestamp as an integer.
+  var now = Date.now || function() {
+    return new Date().getTime();
+  };
+
+  // Internal helper to generate functions for escaping and unescaping strings
+  // to/from HTML interpolation.
+  function createEscaper(map) {
+    var escaper = function(match) {
+      return map[match];
+    };
+    // Regexes for identifying a key that needs to be escaped.
+    var source = '(?:' + keys(map).join('|') + ')';
+    var testRegexp = RegExp(source);
+    var replaceRegexp = RegExp(source, 'g');
+    return function(string) {
+      string = string == null ? '' : '' + string;
+      return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string;
+    };
+  }
+
+  // Internal list of HTML entities for escaping.
+  var escapeMap = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#x27;',
+    '`': '&#x60;'
+  };
+
+  // Function for escaping strings to HTML interpolation.
+  var _escape = createEscaper(escapeMap);
+
+  // Internal list of HTML entities for unescaping.
+  var unescapeMap = invert(escapeMap);
+
+  // Function for unescaping strings from HTML interpolation.
+  var _unescape = createEscaper(unescapeMap);
+
+  // By default, Underscore uses ERB-style template delimiters. Change the
+  // following template settings to use alternative delimiters.
+  var templateSettings = _$1.templateSettings = {
+    evaluate: /<%([\s\S]+?)%>/g,
+    interpolate: /<%=([\s\S]+?)%>/g,
+    escape: /<%-([\s\S]+?)%>/g
+  };
+
+  // When customizing `_.templateSettings`, if you don't want to define an
+  // interpolation, evaluation or escaping regex, we need one that is
+  // guaranteed not to match.
+  var noMatch = /(.)^/;
+
+  // Certain characters need to be escaped so that they can be put into a
+  // string literal.
+  var escapes = {
+    "'": "'",
+    '\\': '\\',
+    '\r': 'r',
+    '\n': 'n',
+    '\u2028': 'u2028',
+    '\u2029': 'u2029'
+  };
+
+  var escapeRegExp = /\\|'|\r|\n|\u2028|\u2029/g;
+
+  function escapeChar(match) {
+    return '\\' + escapes[match];
+  }
+
+  // In order to prevent third-party code injection through
+  // `_.templateSettings.variable`, we test it against the following regular
+  // expression. It is intentionally a bit more liberal than just matching valid
+  // identifiers, but still prevents possible loopholes through defaults or
+  // destructuring assignment.
+  var bareIdentifier = /^\s*(\w|\$)+\s*$/;
+
+  // JavaScript micro-templating, similar to John Resig's implementation.
+  // Underscore templating handles arbitrary delimiters, preserves whitespace,
+  // and correctly escapes quotes within interpolated code.
+  // NB: `oldSettings` only exists for backwards compatibility.
+  function template(text, settings, oldSettings) {
+    if (!settings && oldSettings) settings = oldSettings;
+    settings = defaults({}, settings, _$1.templateSettings);
+
+    // Combine delimiters into one regular expression via alternation.
+    var matcher = RegExp([
+      (settings.escape || noMatch).source,
+      (settings.interpolate || noMatch).source,
+      (settings.evaluate || noMatch).source
+    ].join('|') + '|$', 'g');
+
+    // Compile the template source, escaping string literals appropriately.
+    var index = 0;
+    var source = "__p+='";
+    text.replace(matcher, function(match, escape, interpolate, evaluate, offset) {
+      source += text.slice(index, offset).replace(escapeRegExp, escapeChar);
+      index = offset + match.length;
+
+      if (escape) {
+        source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'";
+      } else if (interpolate) {
+        source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'";
+      } else if (evaluate) {
+        source += "';\n" + evaluate + "\n__p+='";
+      }
+
+      // Adobe VMs need the match returned to produce the correct offset.
+      return match;
+    });
+    source += "';\n";
+
+    var argument = settings.variable;
+    if (argument) {
+      // Insure against third-party code injection. (CVE-2021-23358)
+      if (!bareIdentifier.test(argument)) throw new Error(
+        'variable is not a bare identifier: ' + argument
+      );
+    } else {
+      // If a variable is not specified, place data values in local scope.
+      source = 'with(obj||{}){\n' + source + '}\n';
+      argument = 'obj';
+    }
+
+    source = "var __t,__p='',__j=Array.prototype.join," +
+      "print=function(){__p+=__j.call(arguments,'');};\n" +
+      source + 'return __p;\n';
+
+    var render;
+    try {
+      render = new Function(argument, '_', source);
+    } catch (e) {
+      e.source = source;
+      throw e;
+    }
+
+    var template = function(data) {
+      return render.call(this, data, _$1);
+    };
+
+    // Provide the compiled source as a convenience for precompilation.
+    template.source = 'function(' + argument + '){\n' + source + '}';
+
+    return template;
+  }
+
+  // Traverses the children of `obj` along `path`. If a child is a function, it
+  // is invoked with its parent as context. Returns the value of the final
+  // child, or `fallback` if any child is undefined.
+  function result(obj, path, fallback) {
+    path = toPath(path);
+    var length = path.length;
+    if (!length) {
+      return isFunction$1(fallback) ? fallback.call(obj) : fallback;
+    }
+    for (var i = 0; i < length; i++) {
+      var prop = obj == null ? void 0 : obj[path[i]];
+      if (prop === void 0) {
+        prop = fallback;
+        i = length; // Ensure we don't continue iterating.
+      }
+      obj = isFunction$1(prop) ? prop.call(obj) : prop;
+    }
+    return obj;
+  }
+
+  // Generate a unique integer id (unique within the entire client session).
+  // Useful for temporary DOM ids.
+  var idCounter = 0;
+  function uniqueId(prefix) {
+    var id = ++idCounter + '';
+    return prefix ? prefix + id : id;
+  }
+
+  // Start chaining a wrapped Underscore object.
+  function chain(obj) {
+    var instance = _$1(obj);
+    instance._chain = true;
+    return instance;
+  }
+
+  // Internal function to execute `sourceFunc` bound to `context` with optional
+  // `args`. Determines whether to execute a function as a constructor or as a
+  // normal function.
+  function executeBound(sourceFunc, boundFunc, context, callingContext, args) {
+    if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args);
+    var self = baseCreate(sourceFunc.prototype);
+    var result = sourceFunc.apply(self, args);
+    if (isObject(result)) return result;
+    return self;
+  }
+
+  // Partially apply a function by creating a version that has had some of its
+  // arguments pre-filled, without changing its dynamic `this` context. `_` acts
+  // as a placeholder by default, allowing any combination of arguments to be
+  // pre-filled. Set `_.partial.placeholder` for a custom placeholder argument.
+  var partial = restArguments(function(func, boundArgs) {
+    var placeholder = partial.placeholder;
+    var bound = function() {
+      var position = 0, length = boundArgs.length;
+      var args = Array(length);
+      for (var i = 0; i < length; i++) {
+        args[i] = boundArgs[i] === placeholder ? arguments[position++] : boundArgs[i];
+      }
+      while (position < arguments.length) args.push(arguments[position++]);
+      return executeBound(func, bound, this, this, args);
+    };
+    return bound;
+  });
+
+  partial.placeholder = _$1;
+
+  // Create a function bound to a given object (assigning `this`, and arguments,
+  // optionally).
+  var bind = restArguments(function(func, context, args) {
+    if (!isFunction$1(func)) throw new TypeError('Bind must be called on a function');
+    var bound = restArguments(function(callArgs) {
+      return executeBound(func, bound, context, this, args.concat(callArgs));
+    });
+    return bound;
+  });
+
+  // Internal helper for collection methods to determine whether a collection
+  // should be iterated as an array or as an object.
+  // Related: https://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength
+  // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094
+  var isArrayLike = createSizePropertyCheck(getLength);
+
+  // Internal implementation of a recursive `flatten` function.
+  function flatten$1(input, depth, strict, output) {
+    output = output || [];
+    if (!depth && depth !== 0) {
+      depth = Infinity;
+    } else if (depth <= 0) {
+      return output.concat(input);
+    }
+    var idx = output.length;
+    for (var i = 0, length = getLength(input); i < length; i++) {
+      var value = input[i];
+      if (isArrayLike(value) && (isArray(value) || isArguments$1(value))) {
+        // Flatten current level of array or arguments object.
+        if (depth > 1) {
+          flatten$1(value, depth - 1, strict, output);
+          idx = output.length;
+        } else {
+          var j = 0, len = value.length;
+          while (j < len) output[idx++] = value[j++];
+        }
+      } else if (!strict) {
+        output[idx++] = value;
+      }
+    }
+    return output;
+  }
+
+  // Bind a number of an object's methods to that object. Remaining arguments
+  // are the method names to be bound. Useful for ensuring that all callbacks
+  // defined on an object belong to it.
+  var bindAll = restArguments(function(obj, keys) {
+    keys = flatten$1(keys, false, false);
+    var index = keys.length;
+    if (index < 1) throw new Error('bindAll must be passed function names');
+    while (index--) {
+      var key = keys[index];
+      obj[key] = bind(obj[key], obj);
+    }
+    return obj;
+  });
+
+  // Memoize an expensive function by storing its results.
+  function memoize(func, hasher) {
+    var memoize = function(key) {
+      var cache = memoize.cache;
+      var address = '' + (hasher ? hasher.apply(this, arguments) : key);
+      if (!has$1(cache, address)) cache[address] = func.apply(this, arguments);
+      return cache[address];
+    };
+    memoize.cache = {};
+    return memoize;
+  }
+
+  // Delays a function for the given number of milliseconds, and then calls
+  // it with the arguments supplied.
+  var delay = restArguments(function(func, wait, args) {
+    return setTimeout(function() {
+      return func.apply(null, args);
+    }, wait);
+  });
+
+  // Defers a function, scheduling it to run after the current call stack has
+  // cleared.
+  var defer = partial(delay, _$1, 1);
+
+  // Returns a function, that, when invoked, will only be triggered at most once
+  // during a given window of time. Normally, the throttled function will run
+  // as much as it can, without ever going more than once per `wait` duration;
+  // but if you'd like to disable the execution on the leading edge, pass
+  // `{leading: false}`. To disable execution on the trailing edge, ditto.
+  function throttle(func, wait, options) {
+    var timeout, context, args, result;
+    var previous = 0;
+    if (!options) options = {};
+
+    var later = function() {
+      previous = options.leading === false ? 0 : now();
+      timeout = null;
+      result = func.apply(context, args);
+      if (!timeout) context = args = null;
+    };
+
+    var throttled = function() {
+      var _now = now();
+      if (!previous && options.leading === false) previous = _now;
+      var remaining = wait - (_now - previous);
+      context = this;
+      args = arguments;
+      if (remaining <= 0 || remaining > wait) {
+        if (timeout) {
+          clearTimeout(timeout);
+          timeout = null;
+        }
+        previous = _now;
+        result = func.apply(context, args);
+        if (!timeout) context = args = null;
+      } else if (!timeout && options.trailing !== false) {
+        timeout = setTimeout(later, remaining);
+      }
+      return result;
+    };
+
+    throttled.cancel = function() {
+      clearTimeout(timeout);
+      previous = 0;
+      timeout = context = args = null;
+    };
+
+    return throttled;
+  }
+
+  // When a sequence of calls of the returned function ends, the argument
+  // function is triggered. The end of a sequence is defined by the `wait`
+  // parameter. If `immediate` is passed, the argument function will be
+  // triggered at the beginning of the sequence instead of at the end.
+  function debounce(func, wait, immediate) {
+    var timeout, previous, args, result, context;
+
+    var later = function() {
+      var passed = now() - previous;
+      if (wait > passed) {
+        timeout = setTimeout(later, wait - passed);
+      } else {
+        timeout = null;
+        if (!immediate) result = func.apply(context, args);
+        // This check is needed because `func` can recursively invoke `debounced`.
+        if (!timeout) args = context = null;
+      }
+    };
+
+    var debounced = restArguments(function(_args) {
+      context = this;
+      args = _args;
+      previous = now();
+      if (!timeout) {
+        timeout = setTimeout(later, wait);
+        if (immediate) result = func.apply(context, args);
+      }
+      return result;
+    });
+
+    debounced.cancel = function() {
+      clearTimeout(timeout);
+      timeout = args = context = null;
+    };
+
+    return debounced;
+  }
+
+  // Returns the first function passed as an argument to the second,
+  // allowing you to adjust arguments, run code before and after, and
+  // conditionally execute the original function.
+  function wrap(func, wrapper) {
+    return partial(wrapper, func);
+  }
+
+  // Returns a negated version of the passed-in predicate.
+  function negate(predicate) {
+    return function() {
+      return !predicate.apply(this, arguments);
+    };
+  }
+
+  // Returns a function that is the composition of a list of functions, each
+  // consuming the return value of the function that follows.
+  function compose() {
+    var args = arguments;
+    var start = args.length - 1;
+    return function() {
+      var i = start;
+      var result = args[start].apply(this, arguments);
+      while (i--) result = args[i].call(this, result);
+      return result;
+    };
+  }
+
+  // Returns a function that will only be executed on and after the Nth call.
+  function after(times, func) {
+    return function() {
+      if (--times < 1) {
+        return func.apply(this, arguments);
+      }
+    };
+  }
+
+  // Returns a function that will only be executed up to (but not including) the
+  // Nth call.
+  function before(times, func) {
+    var memo;
+    return function() {
+      if (--times > 0) {
+        memo = func.apply(this, arguments);
+      }
+      if (times <= 1) func = null;
+      return memo;
+    };
+  }
+
+  // Returns a function that will be executed at most one time, no matter how
+  // often you call it. Useful for lazy initialization.
+  var once = partial(before, 2);
+
+  // Returns the first key on an object that passes a truth test.
+  function findKey(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var _keys = keys(obj), key;
+    for (var i = 0, length = _keys.length; i < length; i++) {
+      key = _keys[i];
+      if (predicate(obj[key], key, obj)) return key;
+    }
+  }
+
+  // Internal function to generate `_.findIndex` and `_.findLastIndex`.
+  function createPredicateIndexFinder(dir) {
+    return function(array, predicate, context) {
+      predicate = cb(predicate, context);
+      var length = getLength(array);
+      var index = dir > 0 ? 0 : length - 1;
+      for (; index >= 0 && index < length; index += dir) {
+        if (predicate(array[index], index, array)) return index;
+      }
+      return -1;
+    };
+  }
+
+  // Returns the first index on an array-like that passes a truth test.
+  var findIndex = createPredicateIndexFinder(1);
+
+  // Returns the last index on an array-like that passes a truth test.
+  var findLastIndex = createPredicateIndexFinder(-1);
+
+  // Use a comparator function to figure out the smallest index at which
+  // an object should be inserted so as to maintain order. Uses binary search.
+  function sortedIndex(array, obj, iteratee, context) {
+    iteratee = cb(iteratee, context, 1);
+    var value = iteratee(obj);
+    var low = 0, high = getLength(array);
+    while (low < high) {
+      var mid = Math.floor((low + high) / 2);
+      if (iteratee(array[mid]) < value) low = mid + 1; else high = mid;
+    }
+    return low;
+  }
+
+  // Internal function to generate the `_.indexOf` and `_.lastIndexOf` functions.
+  function createIndexFinder(dir, predicateFind, sortedIndex) {
+    return function(array, item, idx) {
+      var i = 0, length = getLength(array);
+      if (typeof idx == 'number') {
+        if (dir > 0) {
+          i = idx >= 0 ? idx : Math.max(idx + length, i);
+        } else {
+          length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1;
+        }
+      } else if (sortedIndex && idx && length) {
+        idx = sortedIndex(array, item);
+        return array[idx] === item ? idx : -1;
+      }
+      if (item !== item) {
+        idx = predicateFind(slice.call(array, i, length), isNaN$1);
+        return idx >= 0 ? idx + i : -1;
+      }
+      for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) {
+        if (array[idx] === item) return idx;
+      }
+      return -1;
+    };
+  }
+
+  // Return the position of the first occurrence of an item in an array,
+  // or -1 if the item is not included in the array.
+  // If the array is large and already in sort order, pass `true`
+  // for **isSorted** to use binary search.
+  var indexOf = createIndexFinder(1, findIndex, sortedIndex);
+
+  // Return the position of the last occurrence of an item in an array,
+  // or -1 if the item is not included in the array.
+  var lastIndexOf = createIndexFinder(-1, findLastIndex);
+
+  // Return the first value which passes a truth test.
+  function find(obj, predicate, context) {
+    var keyFinder = isArrayLike(obj) ? findIndex : findKey;
+    var key = keyFinder(obj, predicate, context);
+    if (key !== void 0 && key !== -1) return obj[key];
+  }
+
+  // Convenience version of a common use case of `_.find`: getting the first
+  // object containing specific `key:value` pairs.
+  function findWhere(obj, attrs) {
+    return find(obj, matcher(attrs));
+  }
+
+  // The cornerstone for collection functions, an `each`
+  // implementation, aka `forEach`.
+  // Handles raw objects in addition to array-likes. Treats all
+  // sparse array-likes as if they were dense.
+  function each(obj, iteratee, context) {
+    iteratee = optimizeCb(iteratee, context);
+    var i, length;
+    if (isArrayLike(obj)) {
+      for (i = 0, length = obj.length; i < length; i++) {
+        iteratee(obj[i], i, obj);
+      }
+    } else {
+      var _keys = keys(obj);
+      for (i = 0, length = _keys.length; i < length; i++) {
+        iteratee(obj[_keys[i]], _keys[i], obj);
+      }
+    }
+    return obj;
+  }
+
+  // Return the results of applying the iteratee to each element.
+  function map(obj, iteratee, context) {
+    iteratee = cb(iteratee, context);
+    var _keys = !isArrayLike(obj) && keys(obj),
+        length = (_keys || obj).length,
+        results = Array(length);
+    for (var index = 0; index < length; index++) {
+      var currentKey = _keys ? _keys[index] : index;
+      results[index] = iteratee(obj[currentKey], currentKey, obj);
+    }
+    return results;
+  }
+
+  // Internal helper to create a reducing function, iterating left or right.
+  function createReduce(dir) {
+    // Wrap code that reassigns argument variables in a separate function than
+    // the one that accesses `arguments.length` to avoid a perf hit. (#1991)
+    var reducer = function(obj, iteratee, memo, initial) {
+      var _keys = !isArrayLike(obj) && keys(obj),
+          length = (_keys || obj).length,
+          index = dir > 0 ? 0 : length - 1;
+      if (!initial) {
+        memo = obj[_keys ? _keys[index] : index];
+        index += dir;
+      }
+      for (; index >= 0 && index < length; index += dir) {
+        var currentKey = _keys ? _keys[index] : index;
+        memo = iteratee(memo, obj[currentKey], currentKey, obj);
+      }
+      return memo;
+    };
+
+    return function(obj, iteratee, memo, context) {
+      var initial = arguments.length >= 3;
+      return reducer(obj, optimizeCb(iteratee, context, 4), memo, initial);
+    };
+  }
+
+  // **Reduce** builds up a single result from a list of values, aka `inject`,
+  // or `foldl`.
+  var reduce = createReduce(1);
+
+  // The right-associative version of reduce, also known as `foldr`.
+  var reduceRight = createReduce(-1);
+
+  // Return all the elements that pass a truth test.
+  function filter(obj, predicate, context) {
+    var results = [];
+    predicate = cb(predicate, context);
+    each(obj, function(value, index, list) {
+      if (predicate(value, index, list)) results.push(value);
+    });
+    return results;
+  }
+
+  // Return all the elements for which a truth test fails.
+  function reject(obj, predicate, context) {
+    return filter(obj, negate(cb(predicate)), context);
+  }
+
+  // Determine whether all of the elements pass a truth test.
+  function every(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var _keys = !isArrayLike(obj) && keys(obj),
+        length = (_keys || obj).length;
+    for (var index = 0; index < length; index++) {
+      var currentKey = _keys ? _keys[index] : index;
+      if (!predicate(obj[currentKey], currentKey, obj)) return false;
+    }
+    return true;
+  }
+
+  // Determine if at least one element in the object passes a truth test.
+  function some(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var _keys = !isArrayLike(obj) && keys(obj),
+        length = (_keys || obj).length;
+    for (var index = 0; index < length; index++) {
+      var currentKey = _keys ? _keys[index] : index;
+      if (predicate(obj[currentKey], currentKey, obj)) return true;
+    }
+    return false;
+  }
+
+  // Determine if the array or object contains a given item (using `===`).
+  function contains(obj, item, fromIndex, guard) {
+    if (!isArrayLike(obj)) obj = values(obj);
+    if (typeof fromIndex != 'number' || guard) fromIndex = 0;
+    return indexOf(obj, item, fromIndex) >= 0;
+  }
+
+  // Invoke a method (with arguments) on every item in a collection.
+  var invoke = restArguments(function(obj, path, args) {
+    var contextPath, func;
+    if (isFunction$1(path)) {
+      func = path;
+    } else {
+      path = toPath(path);
+      contextPath = path.slice(0, -1);
+      path = path[path.length - 1];
+    }
+    return map(obj, function(context) {
+      var method = func;
+      if (!method) {
+        if (contextPath && contextPath.length) {
+          context = deepGet(context, contextPath);
+        }
+        if (context == null) return void 0;
+        method = context[path];
+      }
+      return method == null ? method : method.apply(context, args);
+    });
+  });
+
+  // Convenience version of a common use case of `_.map`: fetching a property.
+  function pluck(obj, key) {
+    return map(obj, property(key));
+  }
+
+  // Convenience version of a common use case of `_.filter`: selecting only
+  // objects containing specific `key:value` pairs.
+  function where(obj, attrs) {
+    return filter(obj, matcher(attrs));
+  }
+
+  // Return the maximum element (or element-based computation).
+  function max(obj, iteratee, context) {
+    var result = -Infinity, lastComputed = -Infinity,
+        value, computed;
+    if (iteratee == null || typeof iteratee == 'number' && typeof obj[0] != 'object' && obj != null) {
+      obj = isArrayLike(obj) ? obj : values(obj);
+      for (var i = 0, length = obj.length; i < length; i++) {
+        value = obj[i];
+        if (value != null && value > result) {
+          result = value;
+        }
+      }
+    } else {
+      iteratee = cb(iteratee, context);
+      each(obj, function(v, index, list) {
+        computed = iteratee(v, index, list);
+        if (computed > lastComputed || computed === -Infinity && result === -Infinity) {
+          result = v;
+          lastComputed = computed;
+        }
+      });
+    }
+    return result;
+  }
+
+  // Return the minimum element (or element-based computation).
+  function min(obj, iteratee, context) {
+    var result = Infinity, lastComputed = Infinity,
+        value, computed;
+    if (iteratee == null || typeof iteratee == 'number' && typeof obj[0] != 'object' && obj != null) {
+      obj = isArrayLike(obj) ? obj : values(obj);
+      for (var i = 0, length = obj.length; i < length; i++) {
+        value = obj[i];
+        if (value != null && value < result) {
+          result = value;
+        }
+      }
+    } else {
+      iteratee = cb(iteratee, context);
+      each(obj, function(v, index, list) {
+        computed = iteratee(v, index, list);
+        if (computed < lastComputed || computed === Infinity && result === Infinity) {
+          result = v;
+          lastComputed = computed;
+        }
+      });
+    }
+    return result;
+  }
+
+  // Sample **n** random values from a collection using the modern version of the
+  // [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher–Yates_shuffle).
+  // If **n** is not specified, returns a single random element.
+  // The internal `guard` argument allows it to work with `_.map`.
+  function sample(obj, n, guard) {
+    if (n == null || guard) {
+      if (!isArrayLike(obj)) obj = values(obj);
+      return obj[random(obj.length - 1)];
+    }
+    var sample = isArrayLike(obj) ? clone(obj) : values(obj);
+    var length = getLength(sample);
+    n = Math.max(Math.min(n, length), 0);
+    var last = length - 1;
+    for (var index = 0; index < n; index++) {
+      var rand = random(index, last);
+      var temp = sample[index];
+      sample[index] = sample[rand];
+      sample[rand] = temp;
+    }
+    return sample.slice(0, n);
+  }
+
+  // Shuffle a collection.
+  function shuffle(obj) {
+    return sample(obj, Infinity);
+  }
+
+  // Sort the object's values by a criterion produced by an iteratee.
+  function sortBy(obj, iteratee, context) {
+    var index = 0;
+    iteratee = cb(iteratee, context);
+    return pluck(map(obj, function(value, key, list) {
+      return {
+        value: value,
+        index: index++,
+        criteria: iteratee(value, key, list)
+      };
+    }).sort(function(left, right) {
+      var a = left.criteria;
+      var b = right.criteria;
+      if (a !== b) {
+        if (a > b || a === void 0) return 1;
+        if (a < b || b === void 0) return -1;
+      }
+      return left.index - right.index;
+    }), 'value');
+  }
+
+  // An internal function used for aggregate "group by" operations.
+  function group(behavior, partition) {
+    return function(obj, iteratee, context) {
+      var result = partition ? [[], []] : {};
+      iteratee = cb(iteratee, context);
+      each(obj, function(value, index) {
+        var key = iteratee(value, index, obj);
+        behavior(result, value, key);
+      });
+      return result;
+    };
+  }
+
+  // Groups the object's values by a criterion. Pass either a string attribute
+  // to group by, or a function that returns the criterion.
+  var groupBy = group(function(result, value, key) {
+    if (has$1(result, key)) result[key].push(value); else result[key] = [value];
+  });
+
+  // Indexes the object's values by a criterion, similar to `_.groupBy`, but for
+  // when you know that your index values will be unique.
+  var indexBy = group(function(result, value, key) {
+    result[key] = value;
+  });
+
+  // Counts instances of an object that group by a certain criterion. Pass
+  // either a string attribute to count by, or a function that returns the
+  // criterion.
+  var countBy = group(function(result, value, key) {
+    if (has$1(result, key)) result[key]++; else result[key] = 1;
+  });
+
+  // Split a collection into two arrays: one whose elements all pass the given
+  // truth test, and one whose elements all do not pass the truth test.
+  var partition = group(function(result, value, pass) {
+    result[pass ? 0 : 1].push(value);
+  }, true);
+
+  // Safely create a real, live array from anything iterable.
+  var reStrSymbol = /[^\ud800-\udfff]|[\ud800-\udbff][\udc00-\udfff]|[\ud800-\udfff]/g;
+  function toArray(obj) {
+    if (!obj) return [];
+    if (isArray(obj)) return slice.call(obj);
+    if (isString(obj)) {
+      // Keep surrogate pair characters together.
+      return obj.match(reStrSymbol);
+    }
+    if (isArrayLike(obj)) return map(obj, identity);
+    return values(obj);
+  }
+
+  // Return the number of elements in a collection.
+  function size(obj) {
+    if (obj == null) return 0;
+    return isArrayLike(obj) ? obj.length : keys(obj).length;
+  }
+
+  // Internal `_.pick` helper function to determine whether `key` is an enumerable
+  // property name of `obj`.
+  function keyInObj(value, key, obj) {
+    return key in obj;
+  }
+
+  // Return a copy of the object only containing the allowed properties.
+  var pick = restArguments(function(obj, keys) {
+    var result = {}, iteratee = keys[0];
+    if (obj == null) return result;
+    if (isFunction$1(iteratee)) {
+      if (keys.length > 1) iteratee = optimizeCb(iteratee, keys[1]);
+      keys = allKeys(obj);
+    } else {
+      iteratee = keyInObj;
+      keys = flatten$1(keys, false, false);
+      obj = Object(obj);
+    }
+    for (var i = 0, length = keys.length; i < length; i++) {
+      var key = keys[i];
+      var value = obj[key];
+      if (iteratee(value, key, obj)) result[key] = value;
+    }
+    return result;
+  });
+
+  // Return a copy of the object without the disallowed properties.
+  var omit = restArguments(function(obj, keys) {
+    var iteratee = keys[0], context;
+    if (isFunction$1(iteratee)) {
+      iteratee = negate(iteratee);
+      if (keys.length > 1) context = keys[1];
+    } else {
+      keys = map(flatten$1(keys, false, false), String);
+      iteratee = function(value, key) {
+        return !contains(keys, key);
+      };
+    }
+    return pick(obj, iteratee, context);
+  });
+
+  // Returns everything but the last entry of the array. Especially useful on
+  // the arguments object. Passing **n** will return all the values in
+  // the array, excluding the last N.
+  function initial(array, n, guard) {
+    return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n)));
+  }
+
+  // Get the first element of an array. Passing **n** will return the first N
+  // values in the array. The **guard** check allows it to work with `_.map`.
+  function first(array, n, guard) {
+    if (array == null || array.length < 1) return n == null || guard ? void 0 : [];
+    if (n == null || guard) return array[0];
+    return initial(array, array.length - n);
+  }
+
+  // Returns everything but the first entry of the `array`. Especially useful on
+  // the `arguments` object. Passing an **n** will return the rest N values in the
+  // `array`.
+  function rest(array, n, guard) {
+    return slice.call(array, n == null || guard ? 1 : n);
+  }
+
+  // Get the last element of an array. Passing **n** will return the last N
+  // values in the array.
+  function last(array, n, guard) {
+    if (array == null || array.length < 1) return n == null || guard ? void 0 : [];
+    if (n == null || guard) return array[array.length - 1];
+    return rest(array, Math.max(0, array.length - n));
+  }
+
+  // Trim out all falsy values from an array.
+  function compact(array) {
+    return filter(array, Boolean);
+  }
+
+  // Flatten out an array, either recursively (by default), or up to `depth`.
+  // Passing `true` or `false` as `depth` means `1` or `Infinity`, respectively.
+  function flatten(array, depth) {
+    return flatten$1(array, depth, false);
+  }
+
+  // Take the difference between one array and a number of other arrays.
+  // Only the elements present in just the first array will remain.
+  var difference = restArguments(function(array, rest) {
+    rest = flatten$1(rest, true, true);
+    return filter(array, function(value){
+      return !contains(rest, value);
+    });
+  });
+
+  // Return a version of the array that does not contain the specified value(s).
+  var without = restArguments(function(array, otherArrays) {
+    return difference(array, otherArrays);
+  });
+
+  // Produce a duplicate-free version of the array. If the array has already
+  // been sorted, you have the option of using a faster algorithm.
+  // The faster algorithm will not work with an iteratee if the iteratee
+  // is not a one-to-one function, so providing an iteratee will disable
+  // the faster algorithm.
+  function uniq(array, isSorted, iteratee, context) {
+    if (!isBoolean(isSorted)) {
+      context = iteratee;
+      iteratee = isSorted;
+      isSorted = false;
+    }
+    if (iteratee != null) iteratee = cb(iteratee, context);
+    var result = [];
+    var seen = [];
+    for (var i = 0, length = getLength(array); i < length; i++) {
+      var value = array[i],
+          computed = iteratee ? iteratee(value, i, array) : value;
+      if (isSorted && !iteratee) {
+        if (!i || seen !== computed) result.push(value);
+        seen = computed;
+      } else if (iteratee) {
+        if (!contains(seen, computed)) {
+          seen.push(computed);
+          result.push(value);
+        }
+      } else if (!contains(result, value)) {
+        result.push(value);
+      }
+    }
+    return result;
+  }
+
+  // Produce an array that contains the union: each distinct element from all of
+  // the passed-in arrays.
+  var union = restArguments(function(arrays) {
+    return uniq(flatten$1(arrays, true, true));
+  });
+
+  // Produce an array that contains every item shared between all the
+  // passed-in arrays.
+  function intersection(array) {
+    var result = [];
+    var argsLength = arguments.length;
+    for (var i = 0, length = getLength(array); i < length; i++) {
+      var item = array[i];
+      if (contains(result, item)) continue;
+      var j;
+      for (j = 1; j < argsLength; j++) {
+        if (!contains(arguments[j], item)) break;
+      }
+      if (j === argsLength) result.push(item);
+    }
+    return result;
+  }
+
+  // Complement of zip. Unzip accepts an array of arrays and groups
+  // each array's elements on shared indices.
+  function unzip(array) {
+    var length = array && max(array, getLength).length || 0;
+    var result = Array(length);
+
+    for (var index = 0; index < length; index++) {
+      result[index] = pluck(array, index);
+    }
+    return result;
+  }
+
+  // Zip together multiple lists into a single array -- elements that share
+  // an index go together.
+  var zip = restArguments(unzip);
+
+  // Converts lists into objects. Pass either a single array of `[key, value]`
+  // pairs, or two parallel arrays of the same length -- one of keys, and one of
+  // the corresponding values. Passing by pairs is the reverse of `_.pairs`.
+  function object(list, values) {
+    var result = {};
+    for (var i = 0, length = getLength(list); i < length; i++) {
+      if (values) {
+        result[list[i]] = values[i];
+      } else {
+        result[list[i][0]] = list[i][1];
+      }
+    }
+    return result;
+  }
+
+  // Generate an integer Array containing an arithmetic progression. A port of
+  // the native Python `range()` function. See
+  // [the Python documentation](https://docs.python.org/library/functions.html#range).
+  function range(start, stop, step) {
+    if (stop == null) {
+      stop = start || 0;
+      start = 0;
+    }
+    if (!step) {
+      step = stop < start ? -1 : 1;
+    }
+
+    var length = Math.max(Math.ceil((stop - start) / step), 0);
+    var range = Array(length);
+
+    for (var idx = 0; idx < length; idx++, start += step) {
+      range[idx] = start;
+    }
+
+    return range;
+  }
+
+  // Chunk a single array into multiple arrays, each containing `count` or fewer
+  // items.
+  function chunk(array, count) {
+    if (count == null || count < 1) return [];
+    var result = [];
+    var i = 0, length = array.length;
+    while (i < length) {
+      result.push(slice.call(array, i, i += count));
+    }
+    return result;
+  }
+
+  // Helper function to continue chaining intermediate results.
+  function chainResult(instance, obj) {
+    return instance._chain ? _$1(obj).chain() : obj;
+  }
+
+  // Add your own custom functions to the Underscore object.
+  function mixin(obj) {
+    each(functions(obj), function(name) {
+      var func = _$1[name] = obj[name];
+      _$1.prototype[name] = function() {
+        var args = [this._wrapped];
+        push.apply(args, arguments);
+        return chainResult(this, func.apply(_$1, args));
+      };
+    });
+    return _$1;
+  }
+
+  // Add all mutator `Array` functions to the wrapper.
+  each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) {
+    var method = ArrayProto[name];
+    _$1.prototype[name] = function() {
+      var obj = this._wrapped;
+      if (obj != null) {
+        method.apply(obj, arguments);
+        if ((name === 'shift' || name === 'splice') && obj.length === 0) {
+          delete obj[0];
+        }
+      }
+      return chainResult(this, obj);
+    };
+  });
+
+  // Add all accessor `Array` functions to the wrapper.
+  each(['concat', 'join', 'slice'], function(name) {
+    var method = ArrayProto[name];
+    _$1.prototype[name] = function() {
+      var obj = this._wrapped;
+      if (obj != null) obj = method.apply(obj, arguments);
+      return chainResult(this, obj);
+    };
+  });
+
+  // Named Exports
+
+  var allExports = {
+    __proto__: null,
+    VERSION: VERSION,
+    restArguments: restArguments,
+    isObject: isObject,
+    isNull: isNull,
+    isUndefined: isUndefined,
+    isBoolean: isBoolean,
+    isElement: isElement,
+    isString: isString,
+    isNumber: isNumber,
+    isDate: isDate,
+    isRegExp: isRegExp,
+    isError: isError,
+    isSymbol: isSymbol,
+    isArrayBuffer: isArrayBuffer,
+    isDataView: isDataView$1,
+    isArray: isArray,
+    isFunction: isFunction$1,
+    isArguments: isArguments$1,
+    isFinite: isFinite$1,
+    isNaN: isNaN$1,
+    isTypedArray: isTypedArray$1,
+    isEmpty: isEmpty,
+    isMatch: isMatch,
+    isEqual: isEqual,
+    isMap: isMap,
+    isWeakMap: isWeakMap,
+    isSet: isSet,
+    isWeakSet: isWeakSet,
+    keys: keys,
+    allKeys: allKeys,
+    values: values,
+    pairs: pairs,
+    invert: invert,
+    functions: functions,
+    methods: functions,
+    extend: extend,
+    extendOwn: extendOwn,
+    assign: extendOwn,
+    defaults: defaults,
+    create: create,
+    clone: clone,
+    tap: tap,
+    get: get,
+    has: has,
+    mapObject: mapObject,
+    identity: identity,
+    constant: constant,
+    noop: noop,
+    toPath: toPath$1,
+    property: property,
+    propertyOf: propertyOf,
+    matcher: matcher,
+    matches: matcher,
+    times: times,
+    random: random,
+    now: now,
+    escape: _escape,
+    unescape: _unescape,
+    templateSettings: templateSettings,
+    template: template,
+    result: result,
+    uniqueId: uniqueId,
+    chain: chain,
+    iteratee: iteratee,
+    partial: partial,
+    bind: bind,
+    bindAll: bindAll,
+    memoize: memoize,
+    delay: delay,
+    defer: defer,
+    throttle: throttle,
+    debounce: debounce,
+    wrap: wrap,
+    negate: negate,
+    compose: compose,
+    after: after,
+    before: before,
+    once: once,
+    findKey: findKey,
+    findIndex: findIndex,
+    findLastIndex: findLastIndex,
+    sortedIndex: sortedIndex,
+    indexOf: indexOf,
+    lastIndexOf: lastIndexOf,
+    find: find,
+    detect: find,
+    findWhere: findWhere,
+    each: each,
+    forEach: each,
+    map: map,
+    collect: map,
+    reduce: reduce,
+    foldl: reduce,
+    inject: reduce,
+    reduceRight: reduceRight,
+    foldr: reduceRight,
+    filter: filter,
+    select: filter,
+    reject: reject,
+    every: every,
+    all: every,
+    some: some,
+    any: some,
+    contains: contains,
+    includes: contains,
+    include: contains,
+    invoke: invoke,
+    pluck: pluck,
+    where: where,
+    max: max,
+    min: min,
+    shuffle: shuffle,
+    sample: sample,
+    sortBy: sortBy,
+    groupBy: groupBy,
+    indexBy: indexBy,
+    countBy: countBy,
+    partition: partition,
+    toArray: toArray,
+    size: size,
+    pick: pick,
+    omit: omit,
+    first: first,
+    head: first,
+    take: first,
+    initial: initial,
+    last: last,
+    rest: rest,
+    tail: rest,
+    drop: rest,
+    compact: compact,
+    flatten: flatten,
+    without: without,
+    uniq: uniq,
+    unique: uniq,
+    union: union,
+    intersection: intersection,
+    difference: difference,
+    unzip: unzip,
+    transpose: unzip,
+    zip: zip,
+    object: object,
+    range: range,
+    chunk: chunk,
+    mixin: mixin,
+    'default': _$1
+  };
+
+  // Default Export
+
+  // Add all of the Underscore functions to the wrapper object.
+  var _ = mixin(allExports);
+  // Legacy Node.js API.
+  _._ = _;
+
+  return _;
+
+})));
+//# sourceMappingURL=underscore-umd.js.map
diff --git a/pr-2241/_static/underscore.js b/pr-2241/_static/underscore.js
new file mode 100644
index 0000000000..cf177d4285
--- /dev/null
+++ b/pr-2241/_static/underscore.js
@@ -0,0 +1,6 @@
+!function(n,r){"object"==typeof exports&&"undefined"!=typeof module?module.exports=r():"function"==typeof define&&define.amd?define("underscore",r):(n="undefined"!=typeof globalThis?globalThis:n||self,function(){var t=n._,e=n._=r();e.noConflict=function(){return n._=t,e}}())}(this,(function(){
+//     Underscore.js 1.13.1
+//     https://underscorejs.org
+//     (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors
+//     Underscore may be freely distributed under the MIT license.
+var n="1.13.1",r="object"==typeof self&&self.self===self&&self||"object"==typeof global&&global.global===global&&global||Function("return this")()||{},t=Array.prototype,e=Object.prototype,u="undefined"!=typeof Symbol?Symbol.prototype:null,o=t.push,i=t.slice,a=e.toString,f=e.hasOwnProperty,c="undefined"!=typeof ArrayBuffer,l="undefined"!=typeof DataView,s=Array.isArray,p=Object.keys,v=Object.create,h=c&&ArrayBuffer.isView,y=isNaN,d=isFinite,g=!{toString:null}.propertyIsEnumerable("toString"),b=["valueOf","isPrototypeOf","toString","propertyIsEnumerable","hasOwnProperty","toLocaleString"],m=Math.pow(2,53)-1;function j(n,r){return r=null==r?n.length-1:+r,function(){for(var t=Math.max(arguments.length-r,0),e=Array(t),u=0;u<t;u++)e[u]=arguments[u+r];switch(r){case 0:return n.call(this,e);case 1:return n.call(this,arguments[0],e);case 2:return n.call(this,arguments[0],arguments[1],e)}var o=Array(r+1);for(u=0;u<r;u++)o[u]=arguments[u];return o[r]=e,n.apply(this,o)}}function _(n){var r=typeof n;return"function"===r||"object"===r&&!!n}function w(n){return void 0===n}function A(n){return!0===n||!1===n||"[object Boolean]"===a.call(n)}function x(n){var r="[object "+n+"]";return function(n){return a.call(n)===r}}var S=x("String"),O=x("Number"),M=x("Date"),E=x("RegExp"),B=x("Error"),N=x("Symbol"),I=x("ArrayBuffer"),T=x("Function"),k=r.document&&r.document.childNodes;"function"!=typeof/./&&"object"!=typeof Int8Array&&"function"!=typeof k&&(T=function(n){return"function"==typeof n||!1});var D=T,R=x("Object"),F=l&&R(new DataView(new ArrayBuffer(8))),V="undefined"!=typeof Map&&R(new Map),P=x("DataView");var q=F?function(n){return null!=n&&D(n.getInt8)&&I(n.buffer)}:P,U=s||x("Array");function W(n,r){return null!=n&&f.call(n,r)}var z=x("Arguments");!function(){z(arguments)||(z=function(n){return W(n,"callee")})}();var L=z;function $(n){return O(n)&&y(n)}function C(n){return function(){return n}}function K(n){return function(r){var t=n(r);return"number"==typeof t&&t>=0&&t<=m}}function J(n){return function(r){return null==r?void 0:r[n]}}var G=J("byteLength"),H=K(G),Q=/\[object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\]/;var X=c?function(n){return h?h(n)&&!q(n):H(n)&&Q.test(a.call(n))}:C(!1),Y=J("length");function Z(n,r){r=function(n){for(var r={},t=n.length,e=0;e<t;++e)r[n[e]]=!0;return{contains:function(n){return r[n]},push:function(t){return r[t]=!0,n.push(t)}}}(r);var t=b.length,u=n.constructor,o=D(u)&&u.prototype||e,i="constructor";for(W(n,i)&&!r.contains(i)&&r.push(i);t--;)(i=b[t])in n&&n[i]!==o[i]&&!r.contains(i)&&r.push(i)}function nn(n){if(!_(n))return[];if(p)return p(n);var r=[];for(var t in n)W(n,t)&&r.push(t);return g&&Z(n,r),r}function rn(n,r){var t=nn(r),e=t.length;if(null==n)return!e;for(var u=Object(n),o=0;o<e;o++){var i=t[o];if(r[i]!==u[i]||!(i in u))return!1}return!0}function tn(n){return n instanceof tn?n:this instanceof tn?void(this._wrapped=n):new tn(n)}function en(n){return new Uint8Array(n.buffer||n,n.byteOffset||0,G(n))}tn.VERSION=n,tn.prototype.value=function(){return this._wrapped},tn.prototype.valueOf=tn.prototype.toJSON=tn.prototype.value,tn.prototype.toString=function(){return String(this._wrapped)};var un="[object DataView]";function on(n,r,t,e){if(n===r)return 0!==n||1/n==1/r;if(null==n||null==r)return!1;if(n!=n)return r!=r;var o=typeof n;return("function"===o||"object"===o||"object"==typeof r)&&function n(r,t,e,o){r instanceof tn&&(r=r._wrapped);t instanceof tn&&(t=t._wrapped);var i=a.call(r);if(i!==a.call(t))return!1;if(F&&"[object Object]"==i&&q(r)){if(!q(t))return!1;i=un}switch(i){case"[object RegExp]":case"[object String]":return""+r==""+t;case"[object Number]":return+r!=+r?+t!=+t:0==+r?1/+r==1/t:+r==+t;case"[object Date]":case"[object Boolean]":return+r==+t;case"[object Symbol]":return u.valueOf.call(r)===u.valueOf.call(t);case"[object ArrayBuffer]":case un:return n(en(r),en(t),e,o)}var f="[object Array]"===i;if(!f&&X(r)){if(G(r)!==G(t))return!1;if(r.buffer===t.buffer&&r.byteOffset===t.byteOffset)return!0;f=!0}if(!f){if("object"!=typeof r||"object"!=typeof t)return!1;var c=r.constructor,l=t.constructor;if(c!==l&&!(D(c)&&c instanceof c&&D(l)&&l instanceof l)&&"constructor"in r&&"constructor"in t)return!1}o=o||[];var s=(e=e||[]).length;for(;s--;)if(e[s]===r)return o[s]===t;if(e.push(r),o.push(t),f){if((s=r.length)!==t.length)return!1;for(;s--;)if(!on(r[s],t[s],e,o))return!1}else{var p,v=nn(r);if(s=v.length,nn(t).length!==s)return!1;for(;s--;)if(p=v[s],!W(t,p)||!on(r[p],t[p],e,o))return!1}return e.pop(),o.pop(),!0}(n,r,t,e)}function an(n){if(!_(n))return[];var r=[];for(var t in n)r.push(t);return g&&Z(n,r),r}function fn(n){var r=Y(n);return function(t){if(null==t)return!1;var e=an(t);if(Y(e))return!1;for(var u=0;u<r;u++)if(!D(t[n[u]]))return!1;return n!==hn||!D(t[cn])}}var cn="forEach",ln="has",sn=["clear","delete"],pn=["get",ln,"set"],vn=sn.concat(cn,pn),hn=sn.concat(pn),yn=["add"].concat(sn,cn,ln),dn=V?fn(vn):x("Map"),gn=V?fn(hn):x("WeakMap"),bn=V?fn(yn):x("Set"),mn=x("WeakSet");function jn(n){for(var r=nn(n),t=r.length,e=Array(t),u=0;u<t;u++)e[u]=n[r[u]];return e}function _n(n){for(var r={},t=nn(n),e=0,u=t.length;e<u;e++)r[n[t[e]]]=t[e];return r}function wn(n){var r=[];for(var t in n)D(n[t])&&r.push(t);return r.sort()}function An(n,r){return function(t){var e=arguments.length;if(r&&(t=Object(t)),e<2||null==t)return t;for(var u=1;u<e;u++)for(var o=arguments[u],i=n(o),a=i.length,f=0;f<a;f++){var c=i[f];r&&void 0!==t[c]||(t[c]=o[c])}return t}}var xn=An(an),Sn=An(nn),On=An(an,!0);function Mn(n){if(!_(n))return{};if(v)return v(n);var r=function(){};r.prototype=n;var t=new r;return r.prototype=null,t}function En(n){return _(n)?U(n)?n.slice():xn({},n):n}function Bn(n){return U(n)?n:[n]}function Nn(n){return tn.toPath(n)}function In(n,r){for(var t=r.length,e=0;e<t;e++){if(null==n)return;n=n[r[e]]}return t?n:void 0}function Tn(n,r,t){var e=In(n,Nn(r));return w(e)?t:e}function kn(n){return n}function Dn(n){return n=Sn({},n),function(r){return rn(r,n)}}function Rn(n){return n=Nn(n),function(r){return In(r,n)}}function Fn(n,r,t){if(void 0===r)return n;switch(null==t?3:t){case 1:return function(t){return n.call(r,t)};case 3:return function(t,e,u){return n.call(r,t,e,u)};case 4:return function(t,e,u,o){return n.call(r,t,e,u,o)}}return function(){return n.apply(r,arguments)}}function Vn(n,r,t){return null==n?kn:D(n)?Fn(n,r,t):_(n)&&!U(n)?Dn(n):Rn(n)}function Pn(n,r){return Vn(n,r,1/0)}function qn(n,r,t){return tn.iteratee!==Pn?tn.iteratee(n,r):Vn(n,r,t)}function Un(){}function Wn(n,r){return null==r&&(r=n,n=0),n+Math.floor(Math.random()*(r-n+1))}tn.toPath=Bn,tn.iteratee=Pn;var zn=Date.now||function(){return(new Date).getTime()};function Ln(n){var r=function(r){return n[r]},t="(?:"+nn(n).join("|")+")",e=RegExp(t),u=RegExp(t,"g");return function(n){return n=null==n?"":""+n,e.test(n)?n.replace(u,r):n}}var $n={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;","`":"&#x60;"},Cn=Ln($n),Kn=Ln(_n($n)),Jn=tn.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g},Gn=/(.)^/,Hn={"'":"'","\\":"\\","\r":"r","\n":"n","\u2028":"u2028","\u2029":"u2029"},Qn=/\\|'|\r|\n|\u2028|\u2029/g;function Xn(n){return"\\"+Hn[n]}var Yn=/^\s*(\w|\$)+\s*$/;var Zn=0;function nr(n,r,t,e,u){if(!(e instanceof r))return n.apply(t,u);var o=Mn(n.prototype),i=n.apply(o,u);return _(i)?i:o}var rr=j((function(n,r){var t=rr.placeholder,e=function(){for(var u=0,o=r.length,i=Array(o),a=0;a<o;a++)i[a]=r[a]===t?arguments[u++]:r[a];for(;u<arguments.length;)i.push(arguments[u++]);return nr(n,e,this,this,i)};return e}));rr.placeholder=tn;var tr=j((function(n,r,t){if(!D(n))throw new TypeError("Bind must be called on a function");var e=j((function(u){return nr(n,e,r,this,t.concat(u))}));return e})),er=K(Y);function ur(n,r,t,e){if(e=e||[],r||0===r){if(r<=0)return e.concat(n)}else r=1/0;for(var u=e.length,o=0,i=Y(n);o<i;o++){var a=n[o];if(er(a)&&(U(a)||L(a)))if(r>1)ur(a,r-1,t,e),u=e.length;else for(var f=0,c=a.length;f<c;)e[u++]=a[f++];else t||(e[u++]=a)}return e}var or=j((function(n,r){var t=(r=ur(r,!1,!1)).length;if(t<1)throw new Error("bindAll must be passed function names");for(;t--;){var e=r[t];n[e]=tr(n[e],n)}return n}));var ir=j((function(n,r,t){return setTimeout((function(){return n.apply(null,t)}),r)})),ar=rr(ir,tn,1);function fr(n){return function(){return!n.apply(this,arguments)}}function cr(n,r){var t;return function(){return--n>0&&(t=r.apply(this,arguments)),n<=1&&(r=null),t}}var lr=rr(cr,2);function sr(n,r,t){r=qn(r,t);for(var e,u=nn(n),o=0,i=u.length;o<i;o++)if(r(n[e=u[o]],e,n))return e}function pr(n){return function(r,t,e){t=qn(t,e);for(var u=Y(r),o=n>0?0:u-1;o>=0&&o<u;o+=n)if(t(r[o],o,r))return o;return-1}}var vr=pr(1),hr=pr(-1);function yr(n,r,t,e){for(var u=(t=qn(t,e,1))(r),o=0,i=Y(n);o<i;){var a=Math.floor((o+i)/2);t(n[a])<u?o=a+1:i=a}return o}function dr(n,r,t){return function(e,u,o){var a=0,f=Y(e);if("number"==typeof o)n>0?a=o>=0?o:Math.max(o+f,a):f=o>=0?Math.min(o+1,f):o+f+1;else if(t&&o&&f)return e[o=t(e,u)]===u?o:-1;if(u!=u)return(o=r(i.call(e,a,f),$))>=0?o+a:-1;for(o=n>0?a:f-1;o>=0&&o<f;o+=n)if(e[o]===u)return o;return-1}}var gr=dr(1,vr,yr),br=dr(-1,hr);function mr(n,r,t){var e=(er(n)?vr:sr)(n,r,t);if(void 0!==e&&-1!==e)return n[e]}function jr(n,r,t){var e,u;if(r=Fn(r,t),er(n))for(e=0,u=n.length;e<u;e++)r(n[e],e,n);else{var o=nn(n);for(e=0,u=o.length;e<u;e++)r(n[o[e]],o[e],n)}return n}function _r(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=Array(u),i=0;i<u;i++){var a=e?e[i]:i;o[i]=r(n[a],a,n)}return o}function wr(n){var r=function(r,t,e,u){var o=!er(r)&&nn(r),i=(o||r).length,a=n>0?0:i-1;for(u||(e=r[o?o[a]:a],a+=n);a>=0&&a<i;a+=n){var f=o?o[a]:a;e=t(e,r[f],f,r)}return e};return function(n,t,e,u){var o=arguments.length>=3;return r(n,Fn(t,u,4),e,o)}}var Ar=wr(1),xr=wr(-1);function Sr(n,r,t){var e=[];return r=qn(r,t),jr(n,(function(n,t,u){r(n,t,u)&&e.push(n)})),e}function Or(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o<u;o++){var i=e?e[o]:o;if(!r(n[i],i,n))return!1}return!0}function Mr(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o<u;o++){var i=e?e[o]:o;if(r(n[i],i,n))return!0}return!1}function Er(n,r,t,e){return er(n)||(n=jn(n)),("number"!=typeof t||e)&&(t=0),gr(n,r,t)>=0}var Br=j((function(n,r,t){var e,u;return D(r)?u=r:(r=Nn(r),e=r.slice(0,-1),r=r[r.length-1]),_r(n,(function(n){var o=u;if(!o){if(e&&e.length&&(n=In(n,e)),null==n)return;o=n[r]}return null==o?o:o.apply(n,t)}))}));function Nr(n,r){return _r(n,Rn(r))}function Ir(n,r,t){var e,u,o=-1/0,i=-1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;a<f;a++)null!=(e=n[a])&&e>o&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))>i||u===-1/0&&o===-1/0)&&(o=n,i=u)}));return o}function Tr(n,r,t){if(null==r||t)return er(n)||(n=jn(n)),n[Wn(n.length-1)];var e=er(n)?En(n):jn(n),u=Y(e);r=Math.max(Math.min(r,u),0);for(var o=u-1,i=0;i<r;i++){var a=Wn(i,o),f=e[i];e[i]=e[a],e[a]=f}return e.slice(0,r)}function kr(n,r){return function(t,e,u){var o=r?[[],[]]:{};return e=qn(e,u),jr(t,(function(r,u){var i=e(r,u,t);n(o,r,i)})),o}}var Dr=kr((function(n,r,t){W(n,t)?n[t].push(r):n[t]=[r]})),Rr=kr((function(n,r,t){n[t]=r})),Fr=kr((function(n,r,t){W(n,t)?n[t]++:n[t]=1})),Vr=kr((function(n,r,t){n[t?0:1].push(r)}),!0),Pr=/[^\ud800-\udfff]|[\ud800-\udbff][\udc00-\udfff]|[\ud800-\udfff]/g;function qr(n,r,t){return r in t}var Ur=j((function(n,r){var t={},e=r[0];if(null==n)return t;D(e)?(r.length>1&&(e=Fn(e,r[1])),r=an(n)):(e=qr,r=ur(r,!1,!1),n=Object(n));for(var u=0,o=r.length;u<o;u++){var i=r[u],a=n[i];e(a,i,n)&&(t[i]=a)}return t})),Wr=j((function(n,r){var t,e=r[0];return D(e)?(e=fr(e),r.length>1&&(t=r[1])):(r=_r(ur(r,!1,!1),String),e=function(n,t){return!Er(r,t)}),Ur(n,e,t)}));function zr(n,r,t){return i.call(n,0,Math.max(0,n.length-(null==r||t?1:r)))}function Lr(n,r,t){return null==n||n.length<1?null==r||t?void 0:[]:null==r||t?n[0]:zr(n,n.length-r)}function $r(n,r,t){return i.call(n,null==r||t?1:r)}var Cr=j((function(n,r){return r=ur(r,!0,!0),Sr(n,(function(n){return!Er(r,n)}))})),Kr=j((function(n,r){return Cr(n,r)}));function Jr(n,r,t,e){A(r)||(e=t,t=r,r=!1),null!=t&&(t=qn(t,e));for(var u=[],o=[],i=0,a=Y(n);i<a;i++){var f=n[i],c=t?t(f,i,n):f;r&&!t?(i&&o===c||u.push(f),o=c):t?Er(o,c)||(o.push(c),u.push(f)):Er(u,f)||u.push(f)}return u}var Gr=j((function(n){return Jr(ur(n,!0,!0))}));function Hr(n){for(var r=n&&Ir(n,Y).length||0,t=Array(r),e=0;e<r;e++)t[e]=Nr(n,e);return t}var Qr=j(Hr);function Xr(n,r){return n._chain?tn(r).chain():r}function Yr(n){return jr(wn(n),(function(r){var t=tn[r]=n[r];tn.prototype[r]=function(){var n=[this._wrapped];return o.apply(n,arguments),Xr(this,t.apply(tn,n))}})),tn}jr(["pop","push","reverse","shift","sort","splice","unshift"],(function(n){var r=t[n];tn.prototype[n]=function(){var t=this._wrapped;return null!=t&&(r.apply(t,arguments),"shift"!==n&&"splice"!==n||0!==t.length||delete t[0]),Xr(this,t)}})),jr(["concat","join","slice"],(function(n){var r=t[n];tn.prototype[n]=function(){var n=this._wrapped;return null!=n&&(n=r.apply(n,arguments)),Xr(this,n)}}));var Zr=Yr({__proto__:null,VERSION:n,restArguments:j,isObject:_,isNull:function(n){return null===n},isUndefined:w,isBoolean:A,isElement:function(n){return!(!n||1!==n.nodeType)},isString:S,isNumber:O,isDate:M,isRegExp:E,isError:B,isSymbol:N,isArrayBuffer:I,isDataView:q,isArray:U,isFunction:D,isArguments:L,isFinite:function(n){return!N(n)&&d(n)&&!isNaN(parseFloat(n))},isNaN:$,isTypedArray:X,isEmpty:function(n){if(null==n)return!0;var r=Y(n);return"number"==typeof r&&(U(n)||S(n)||L(n))?0===r:0===Y(nn(n))},isMatch:rn,isEqual:function(n,r){return on(n,r)},isMap:dn,isWeakMap:gn,isSet:bn,isWeakSet:mn,keys:nn,allKeys:an,values:jn,pairs:function(n){for(var r=nn(n),t=r.length,e=Array(t),u=0;u<t;u++)e[u]=[r[u],n[r[u]]];return e},invert:_n,functions:wn,methods:wn,extend:xn,extendOwn:Sn,assign:Sn,defaults:On,create:function(n,r){var t=Mn(n);return r&&Sn(t,r),t},clone:En,tap:function(n,r){return r(n),n},get:Tn,has:function(n,r){for(var t=(r=Nn(r)).length,e=0;e<t;e++){var u=r[e];if(!W(n,u))return!1;n=n[u]}return!!t},mapObject:function(n,r,t){r=qn(r,t);for(var e=nn(n),u=e.length,o={},i=0;i<u;i++){var a=e[i];o[a]=r(n[a],a,n)}return o},identity:kn,constant:C,noop:Un,toPath:Bn,property:Rn,propertyOf:function(n){return null==n?Un:function(r){return Tn(n,r)}},matcher:Dn,matches:Dn,times:function(n,r,t){var e=Array(Math.max(0,n));r=Fn(r,t,1);for(var u=0;u<n;u++)e[u]=r(u);return e},random:Wn,now:zn,escape:Cn,unescape:Kn,templateSettings:Jn,template:function(n,r,t){!r&&t&&(r=t),r=On({},r,tn.templateSettings);var e=RegExp([(r.escape||Gn).source,(r.interpolate||Gn).source,(r.evaluate||Gn).source].join("|")+"|$","g"),u=0,o="__p+='";n.replace(e,(function(r,t,e,i,a){return o+=n.slice(u,a).replace(Qn,Xn),u=a+r.length,t?o+="'+\n((__t=("+t+"))==null?'':_.escape(__t))+\n'":e?o+="'+\n((__t=("+e+"))==null?'':__t)+\n'":i&&(o+="';\n"+i+"\n__p+='"),r})),o+="';\n";var i,a=r.variable;if(a){if(!Yn.test(a))throw new Error("variable is not a bare identifier: "+a)}else o="with(obj||{}){\n"+o+"}\n",a="obj";o="var __t,__p='',__j=Array.prototype.join,"+"print=function(){__p+=__j.call(arguments,'');};\n"+o+"return __p;\n";try{i=new Function(a,"_",o)}catch(n){throw n.source=o,n}var f=function(n){return i.call(this,n,tn)};return f.source="function("+a+"){\n"+o+"}",f},result:function(n,r,t){var e=(r=Nn(r)).length;if(!e)return D(t)?t.call(n):t;for(var u=0;u<e;u++){var o=null==n?void 0:n[r[u]];void 0===o&&(o=t,u=e),n=D(o)?o.call(n):o}return n},uniqueId:function(n){var r=++Zn+"";return n?n+r:r},chain:function(n){var r=tn(n);return r._chain=!0,r},iteratee:Pn,partial:rr,bind:tr,bindAll:or,memoize:function(n,r){var t=function(e){var u=t.cache,o=""+(r?r.apply(this,arguments):e);return W(u,o)||(u[o]=n.apply(this,arguments)),u[o]};return t.cache={},t},delay:ir,defer:ar,throttle:function(n,r,t){var e,u,o,i,a=0;t||(t={});var f=function(){a=!1===t.leading?0:zn(),e=null,i=n.apply(u,o),e||(u=o=null)},c=function(){var c=zn();a||!1!==t.leading||(a=c);var l=r-(c-a);return u=this,o=arguments,l<=0||l>r?(e&&(clearTimeout(e),e=null),a=c,i=n.apply(u,o),e||(u=o=null)):e||!1===t.trailing||(e=setTimeout(f,l)),i};return c.cancel=function(){clearTimeout(e),a=0,e=u=o=null},c},debounce:function(n,r,t){var e,u,o,i,a,f=function(){var c=zn()-u;r>c?e=setTimeout(f,r-c):(e=null,t||(i=n.apply(a,o)),e||(o=a=null))},c=j((function(c){return a=this,o=c,u=zn(),e||(e=setTimeout(f,r),t&&(i=n.apply(a,o))),i}));return c.cancel=function(){clearTimeout(e),e=o=a=null},c},wrap:function(n,r){return rr(r,n)},negate:fr,compose:function(){var n=arguments,r=n.length-1;return function(){for(var t=r,e=n[r].apply(this,arguments);t--;)e=n[t].call(this,e);return e}},after:function(n,r){return function(){if(--n<1)return r.apply(this,arguments)}},before:cr,once:lr,findKey:sr,findIndex:vr,findLastIndex:hr,sortedIndex:yr,indexOf:gr,lastIndexOf:br,find:mr,detect:mr,findWhere:function(n,r){return mr(n,Dn(r))},each:jr,forEach:jr,map:_r,collect:_r,reduce:Ar,foldl:Ar,inject:Ar,reduceRight:xr,foldr:xr,filter:Sr,select:Sr,reject:function(n,r,t){return Sr(n,fr(qn(r)),t)},every:Or,all:Or,some:Mr,any:Mr,contains:Er,includes:Er,include:Er,invoke:Br,pluck:Nr,where:function(n,r){return Sr(n,Dn(r))},max:Ir,min:function(n,r,t){var e,u,o=1/0,i=1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;a<f;a++)null!=(e=n[a])&&e<o&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))<i||u===1/0&&o===1/0)&&(o=n,i=u)}));return o},shuffle:function(n){return Tr(n,1/0)},sample:Tr,sortBy:function(n,r,t){var e=0;return r=qn(r,t),Nr(_r(n,(function(n,t,u){return{value:n,index:e++,criteria:r(n,t,u)}})).sort((function(n,r){var t=n.criteria,e=r.criteria;if(t!==e){if(t>e||void 0===t)return 1;if(t<e||void 0===e)return-1}return n.index-r.index})),"value")},groupBy:Dr,indexBy:Rr,countBy:Fr,partition:Vr,toArray:function(n){return n?U(n)?i.call(n):S(n)?n.match(Pr):er(n)?_r(n,kn):jn(n):[]},size:function(n){return null==n?0:er(n)?n.length:nn(n).length},pick:Ur,omit:Wr,first:Lr,head:Lr,take:Lr,initial:zr,last:function(n,r,t){return null==n||n.length<1?null==r||t?void 0:[]:null==r||t?n[n.length-1]:$r(n,Math.max(0,n.length-r))},rest:$r,tail:$r,drop:$r,compact:function(n){return Sr(n,Boolean)},flatten:function(n,r){return ur(n,r,!1)},without:Kr,uniq:Jr,unique:Jr,union:Gr,intersection:function(n){for(var r=[],t=arguments.length,e=0,u=Y(n);e<u;e++){var o=n[e];if(!Er(r,o)){var i;for(i=1;i<t&&Er(arguments[i],o);i++);i===t&&r.push(o)}}return r},difference:Cr,unzip:Hr,transpose:Hr,zip:Qr,object:function(n,r){for(var t={},e=0,u=Y(n);e<u;e++)r?t[n[e]]=r[e]:t[n[e][0]]=n[e][1];return t},range:function(n,r,t){null==r&&(r=n||0,n=0),t||(t=r<n?-1:1);for(var e=Math.max(Math.ceil((r-n)/t),0),u=Array(e),o=0;o<e;o++,n+=t)u[o]=n;return u},chunk:function(n,r){if(null==r||r<1)return[];for(var t=[],e=0,u=n.length;e<u;)t.push(i.call(n,e,e+=r));return t},mixin:Yr,default:tn});return Zr._=Zr,Zr}));
\ No newline at end of file
diff --git a/pr-2241/api/api.html b/pr-2241/api/api.html
new file mode 100644
index 0000000000..77850a497e
--- /dev/null
+++ b/pr-2241/api/api.html
@@ -0,0 +1,662 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Code documentation &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="CUDA-Q C++ API" href="languages/cpp_api.html" />
+    <link rel="prev" title="Quake Dialect" href="../specification/quake-dialect.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Code documentation</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/api/api.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../specification/quake-dialect.html" class="btn btn-neutral float-left" title="Quake Dialect" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="languages/cpp_api.html" class="btn btn-neutral float-right" title="CUDA-Q C++ API" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="code-documentation">
+<h1>Code documentation<a class="headerlink" href="#code-documentation" title="Permalink to this heading">¶</a></h1>
+<div class="toctree-wrapper compound">
+<p class="caption" role="heading"><span class="caption-text">CUDA-Q API</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="languages/cpp_api.html">C++ API</a></li>
+<li class="toctree-l1"><a class="reference internal" href="languages/python_api.html">Python API</a></li>
+<li class="toctree-l1"><a class="reference internal" href="default_ops.html">Quantum Operations</a></li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../specification/quake-dialect.html" class="btn btn-neutral float-left" title="Quake Dialect" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="languages/cpp_api.html" class="btn btn-neutral float-right" title="CUDA-Q C++ API" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/api/default_ops.html b/pr-2241/api/default_ops.html
new file mode 100644
index 0000000000..bc6d39bff8
--- /dev/null
+++ b/pr-2241/api/default_ops.html
@@ -0,0 +1,1383 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quantum Operations &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="CUDA-Q Versions" href="../versions.html" />
+    <link rel="prev" title="CUDA-Q Python API" href="languages/python_api.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="api.html">   API Reference</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="api.html">Code documentation</a></li>
+      <li class="breadcrumb-item active">Quantum Operations</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/api/default_ops.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="languages/python_api.html" class="btn btn-neutral float-left" title="CUDA-Q Python API" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../versions.html" class="btn btn-neutral float-right" title="CUDA-Q Versions" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-operations">
+<h1>Quantum Operations<a class="headerlink" href="#quantum-operations" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q provides a default set of quantum operations on qubits.
+These operations can be used to define custom kernels and libraries.
+Since the set of quantum intrinsic operations natively supported on a specific target
+depends on the backends architecture, the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> compiler automatically
+decomposes the default operations into the appropriate set of intrinsic operations
+for that target.</p>
+<p>The sections <a class="reference internal" href="#unitary-operations-on-qubits">Unitary Operations on Qubits</a> and <a class="reference internal" href="#measurements-on-qubits">Measurements on Qubits</a> list the default set of quantum operations on qubits.</p>
+<p>Operations that implement unitary transformations of the quantum state are templated.
+The template argument allows to invoke the adjoint and controlled version of the quantum transformation, see the section on <a class="reference internal" href="#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a>.</p>
+<p>CUDA-Q additionally provides overloads to support broadcasting of
+single-qubit operations across a vector of qubits.  For example,
+<code class="code docutils literal notranslate"><span class="pre">x(cudaq::qvector&lt;&gt;&amp;)</span></code> flips the state of each qubit in the provided
+<code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code>.</p>
+<section id="unitary-operations-on-qubits">
+<h2>Unitary Operations on Qubits<a class="headerlink" href="#unitary-operations-on-qubits" title="Permalink to this heading">¶</a></h2>
+<section id="x">
+<h3><code class="code docutils literal notranslate"><span class="pre">x</span></code><a class="headerlink" href="#x" title="Permalink to this heading">¶</a></h3>
+<p>This operation implements the transformation defined by the Pauli-X matrix. It is also known as the quantum version of a <code class="code docutils literal notranslate"><span class="pre">NOT</span></code>-gate.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># X = | 0  1 |</span>
+<span class="c1">#     | 1  0 |</span>
+<span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// X = | 0  1 |</span>
+<span class="c1">//     | 1  0 |</span>
+<span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="y">
+<h3><code class="code docutils literal notranslate"><span class="pre">y</span></code><a class="headerlink" href="#y" title="Permalink to this heading">¶</a></h3>
+<p>This operation implements the transformation defined by the Pauli-Y matrix.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># Y = | 0  -i |</span>
+<span class="c1">#     | i   0 |</span>
+<span class="n">y</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// Y = | 0  -i |</span>
+<span class="c1">//     | i   0 |</span>
+<span class="n">y</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="z">
+<h3><code class="code docutils literal notranslate"><span class="pre">z</span></code><a class="headerlink" href="#z" title="Permalink to this heading">¶</a></h3>
+<p>This operation implements the transformation defined by the Pauli-Z matrix.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># Z = | 1   0 |</span>
+<span class="c1">#     | 0  -1 |</span>
+<span class="n">z</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// Z = | 1   0 |</span>
+<span class="c1">//     | 0  -1 |</span>
+<span class="n">z</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="h">
+<h3><code class="code docutils literal notranslate"><span class="pre">h</span></code><a class="headerlink" href="#h" title="Permalink to this heading">¶</a></h3>
+<p>This operation is a rotation by π about the X+Z axis, and
+enables one to create a superposition of computational basis states.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># H = (1 / sqrt(2)) * | 1   1 |</span>
+<span class="c1">#                     | 1  -1 |</span>
+<span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// H = (1 / sqrt(2)) * | 1   1 |</span>
+<span class="c1">//                     | 1  -1 |</span>
+<span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="r1">
+<h3><code class="code docutils literal notranslate"><span class="pre">r1</span></code><a class="headerlink" href="#r1" title="Permalink to this heading">¶</a></h3>
+<p>This operation is an arbitrary rotation about the <code class="code docutils literal notranslate"><span class="pre">|1&gt;</span></code> state.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># R1(λ) = | 1     0    |</span>
+<span class="c1">#         | 0  exp(iλ) |</span>
+<span class="n">r1</span><span class="p">(</span><span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// R1(λ) = | 1     0    |</span>
+<span class="c1">//         | 0  exp(iλ) |</span>
+<span class="n">r1</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">numbers</span><span class="o">::</span><span class="n">pi</span><span class="p">,</span><span class="w"> </span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="rx">
+<h3><code class="code docutils literal notranslate"><span class="pre">rx</span></code><a class="headerlink" href="#rx" title="Permalink to this heading">¶</a></h3>
+<p>This operation is an arbitrary rotation about the X axis.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--5-input--1" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># Rx(θ) = |  cos(θ/2)  -isin(θ/2) |</span>
+<span class="c1">#         | -isin(θ/2)  cos(θ/2)  |</span>
+<span class="n">rx</span><span class="p">(</span><span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--5-input--2" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// Rx(θ) = |  cos(θ/2)  -isin(θ/2) |</span>
+<span class="c1">//         | -isin(θ/2)  cos(θ/2)  |</span>
+<span class="n">rx</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">numbers</span><span class="o">::</span><span class="n">pi</span><span class="p">,</span><span class="w"> </span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="ry">
+<h3><code class="code docutils literal notranslate"><span class="pre">ry</span></code><a class="headerlink" href="#ry" title="Permalink to this heading">¶</a></h3>
+<p>This operation is an arbitrary rotation about the Y axis.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--6-input--1" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># Ry(θ) = | cos(θ/2)  -sin(θ/2) |</span>
+<span class="c1">#         | sin(θ/2)   cos(θ/2) |</span>
+<span class="n">ry</span><span class="p">(</span><span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--6-input--2" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// Ry(θ) = | cos(θ/2)  -sin(θ/2) |</span>
+<span class="c1">//         | sin(θ/2)   cos(θ/2) |</span>
+<span class="n">ry</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">numbers</span><span class="o">::</span><span class="n">pi</span><span class="p">,</span><span class="w"> </span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="rz">
+<h3><code class="code docutils literal notranslate"><span class="pre">rz</span></code><a class="headerlink" href="#rz" title="Permalink to this heading">¶</a></h3>
+<p>This operation is an arbitrary rotation about the Z axis.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--7-input--1" name="tab-set--7" type="radio"><label class="tab-label" for="tab-set--7-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># Rz(λ) = | exp(-iλ/2)      0     |</span>
+<span class="c1">#         |     0       exp(iλ/2) |</span>
+<span class="n">rz</span><span class="p">(</span><span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--7-input--2" name="tab-set--7" type="radio"><label class="tab-label" for="tab-set--7-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// Rz(λ) = | exp(-iλ/2)      0     |</span>
+<span class="c1">//         |     0       exp(iλ/2) |</span>
+<span class="n">rz</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">numbers</span><span class="o">::</span><span class="n">pi</span><span class="p">,</span><span class="w"> </span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="s">
+<h3><code class="code docutils literal notranslate"><span class="pre">s</span></code><a class="headerlink" href="#s" title="Permalink to this heading">¶</a></h3>
+<p>This operation applies to its target a rotation by π/2 about the Z axis.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--8-input--1" name="tab-set--8" type="radio"><label class="tab-label" for="tab-set--8-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># S = | 1   0 |</span>
+<span class="c1">#     | 0   i |</span>
+<span class="n">s</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--8-input--2" name="tab-set--8" type="radio"><label class="tab-label" for="tab-set--8-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// S = | 1   0 |</span>
+<span class="c1">//     | 0   i |</span>
+<span class="n">s</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="t">
+<h3><code class="code docutils literal notranslate"><span class="pre">t</span></code><a class="headerlink" href="#t" title="Permalink to this heading">¶</a></h3>
+<p>This operation applies to its target a π/4 rotation about the Z axis.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--9-input--1" name="tab-set--9" type="radio"><label class="tab-label" for="tab-set--9-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># T = | 1      0     |</span>
+<span class="c1">#     | 0  exp(iπ/4) |</span>
+<span class="n">t</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--9-input--2" name="tab-set--9" type="radio"><label class="tab-label" for="tab-set--9-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// T = | 1      0     |</span>
+<span class="c1">//     | 0  exp(iπ/4) |</span>
+<span class="n">t</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="swap">
+<h3><code class="code docutils literal notranslate"><span class="pre">swap</span></code><a class="headerlink" href="#swap" title="Permalink to this heading">¶</a></h3>
+<p>This operation swaps the states of two qubits.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--10-input--1" name="tab-set--10" type="radio"><label class="tab-label" for="tab-set--10-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit_1</span><span class="p">,</span> <span class="n">qubit_2</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># Swap = | 1 0 0 0 |</span>
+<span class="c1">#        | 0 0 1 0 |</span>
+<span class="c1">#        | 0 1 0 0 |</span>
+<span class="c1">#        | 0 0 0 1 |</span>
+<span class="n">swap</span><span class="p">(</span><span class="n">qubit_1</span><span class="p">,</span> <span class="n">qubit_2</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--10-input--2" name="tab-set--10" type="radio"><label class="tab-label" for="tab-set--10-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit_1</span><span class="p">,</span><span class="w"> </span><span class="n">qubit_2</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// Swap = | 1 0 0 0 |</span>
+<span class="c1">//        | 0 0 1 0 |</span>
+<span class="c1">//        | 0 1 0 0 |</span>
+<span class="c1">//        | 0 0 0 1 |</span>
+<span class="n">swap</span><span class="p">(</span><span class="n">qubit_1</span><span class="p">,</span><span class="w"> </span><span class="n">qubit_2</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="u3">
+<h3><code class="code docutils literal notranslate"><span class="pre">u3</span></code><a class="headerlink" href="#u3" title="Permalink to this heading">¶</a></h3>
+<p>This operation applies the universal three-parameters operator to target qubit. The three parameters are Euler angles - theta (θ), phi (φ), and lambda (λ).</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--11-input--1" name="tab-set--11" type="radio"><label class="tab-label" for="tab-set--11-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># U3(θ,φ,λ) = | cos(θ/2)            -exp(iλ) * sin(θ/2)       |</span>
+<span class="c1">#             | exp(iφ) * sin(θ/2)   exp(i(λ + φ)) * cos(θ/2) |</span>
+<span class="n">u3</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--11-input--2" name="tab-set--11" type="radio"><label class="tab-label" for="tab-set--11-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// U3(θ,φ,λ) = | cos(θ/2)            -exp(iλ) * sin(θ/2)       |</span>
+<span class="c1">//             | exp(iφ) * sin(θ/2)   exp(i(λ + φ)) * cos(θ/2) |</span>
+<span class="n">u3</span><span class="p">(</span><span class="n">M_PI</span><span class="p">,</span><span class="w"> </span><span class="n">M_PI</span><span class="p">,</span><span class="w"> </span><span class="n">M_PI_2</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+</section>
+<section id="adjoint-and-controlled-operations">
+<h2>Adjoint and Controlled Operations<a class="headerlink" href="#adjoint-and-controlled-operations" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--12-input--1" name="tab-set--12" type="radio"><label class="tab-label" for="tab-set--12-input--1">Python</label><div class="tab-content docutils">
+<p>The <code class="code docutils literal notranslate"><span class="pre">adj</span></code> method of any gate can be used to invoke the
+<a class="reference external" href="https://en.wikipedia.org/wiki/Conjugate_transpose">adjoint</a> transformation:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create a kernel and allocate a qubit in a |0&gt; state.</span>
+<span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+<span class="c1"># Apply the unitary transformation defined by the matrix</span>
+<span class="c1"># T = | 1      0     |</span>
+<span class="c1">#     | 0  exp(iπ/4) |</span>
+<span class="c1"># to the state of the qubit `q`:</span>
+<span class="n">t</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+<span class="c1"># Apply its adjoint transformation defined by the matrix</span>
+<span class="c1"># T† = | 1      0     |</span>
+<span class="c1">#      | 0  exp(-iπ/4) |</span>
+<span class="n">t</span><span class="o">.</span><span class="n">adj</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+<span class="c1"># `qubit` is now again in the initial state |0&gt;.</span>
+</pre></div>
+</div>
+<p>The <code class="code docutils literal notranslate"><span class="pre">ctrl</span></code> method of any gate can be used to apply the transformation
+conditional on the state of one or more control qubits, see also this
+<a class="reference external" href="https://en.wikipedia.org/wiki/Quantum_logic_gate#Controlled_gates">Wikipedia entry</a>.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Create a kernel and allocate qubits in a |0&gt; state.</span>
+<span class="n">ctrl_1</span><span class="p">,</span> <span class="n">ctrl_2</span><span class="p">,</span> <span class="n">target</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="c1"># Create a superposition.</span>
+<span class="n">h</span><span class="p">(</span><span class="n">ctrl_1</span><span class="p">)</span>
+<span class="c1"># `ctrl_1` is now in a state (|0&gt; + |1&gt;) / √2.</span>
+
+<span class="c1"># Apply the unitary transformation</span>
+<span class="c1"># | 1  0  0  0 |</span>
+<span class="c1"># | 0  1  0  0 |</span>
+<span class="c1"># | 0  0  0  1 |</span>
+<span class="c1"># | 0  0  1  0 |</span>
+<span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">ctrl_1</span><span class="p">,</span> <span class="n">ctrl_2</span><span class="p">)</span>
+<span class="c1"># `ctrl_1` and `ctrl_2` are in a state (|00&gt; + |11&gt;) / √2.</span>
+
+<span class="c1"># Set the state of `target` to |1&gt;:</span>
+<span class="n">x</span><span class="p">(</span><span class="n">target</span><span class="p">)</span>
+<span class="c1"># Apply the transformation T only if both</span>
+<span class="c1"># control qubits are in a |1&gt; state:</span>
+<span class="n">t</span><span class="o">.</span><span class="n">ctrl</span><span class="p">([</span><span class="n">ctrl_1</span><span class="p">,</span> <span class="n">ctrl_2</span><span class="p">],</span> <span class="n">target</span><span class="p">)</span>
+<span class="c1"># The qubits ctrl_1, ctrl_2, and target are now in a state</span>
+<span class="c1"># (|000&gt; + exp(iπ/4)|111&gt;) / √2.</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--12-input--2" name="tab-set--12" type="radio"><label class="tab-label" for="tab-set--12-input--2">C++</label><div class="tab-content docutils">
+<p>The template argument <code class="code docutils literal notranslate"><span class="pre">cudaq::adj</span></code> can be used to invoke the
+<a class="reference external" href="https://en.wikipedia.org/wiki/Conjugate_transpose">adjoint</a> transformation:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Allocate a qubit in a |0&gt; state.</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+
+<span class="c1">// Apply the unitary transformation defined by the matrix</span>
+<span class="c1">// T = | 1      0     |</span>
+<span class="c1">//     | 0  exp(iπ/4) |</span>
+<span class="c1">// to the state of the qubit `q`:</span>
+<span class="n">t</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+
+<span class="c1">// Apply its adjoint transformation defined by the matrix</span>
+<span class="c1">// T† = | 1      0     |</span>
+<span class="c1">//      | 0  exp(-iπ/4) |</span>
+<span class="n">t</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">adj</span><span class="o">&gt;</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+<span class="c1">// Qubit `q` is now again in the initial state |0&gt;.</span>
+</pre></div>
+</div>
+<p>The template argument <code class="code docutils literal notranslate"><span class="pre">cudaq::ctrl</span></code> can be used to apply the transformation
+conditional on the state of one or more control qubits, see also this
+<a class="reference external" href="https://en.wikipedia.org/wiki/Quantum_logic_gate#Controlled_gates">Wikipedia entry</a>.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Allocate qubits in a |0&gt; state.</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">ctrl_1</span><span class="p">,</span><span class="w"> </span><span class="n">ctrl_2</span><span class="p">,</span><span class="w"> </span><span class="n">target</span><span class="p">;</span>
+<span class="c1">// Create a superposition.</span>
+<span class="n">h</span><span class="p">(</span><span class="n">ctrl_1</span><span class="p">);</span>
+<span class="c1">// Qubit ctrl_1 is now in a state (|0&gt; + |1&gt;) / √2.</span>
+
+<span class="c1">// Apply the unitary transformation</span>
+<span class="c1">// | 1  0  0  0 |</span>
+<span class="c1">// | 0  1  0  0 |</span>
+<span class="c1">// | 0  0  0  1 |</span>
+<span class="c1">// | 0  0  1  0 |</span>
+<span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ctrl_1</span><span class="p">,</span><span class="w"> </span><span class="n">ctrl_2</span><span class="p">);</span>
+<span class="c1">// The qubits ctrl_1 and ctrl_2 are in a state (|00&gt; + |11&gt;) / √2.</span>
+
+<span class="c1">// Set the state of `target` to |1&gt;:</span>
+<span class="n">x</span><span class="p">(</span><span class="n">target</span><span class="p">);</span>
+<span class="c1">// Apply the transformation T only if both</span>
+<span class="c1">// control qubits are in a |1&gt; state:</span>
+<span class="n">t</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ctrl_1</span><span class="p">,</span><span class="w"> </span><span class="n">ctrl_2</span><span class="p">,</span><span class="w"> </span><span class="n">target</span><span class="p">);</span>
+<span class="c1">// The qubits ctrl_1, ctrl_2, and target are now in a state</span>
+<span class="c1">// (|000&gt; + exp(iπ/4)|111&gt;) / √2.</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Following common convention, by default the transformation is applied to the target qubit(s)
+if all control qubits are in a <code class="code docutils literal notranslate"><span class="pre">|1&gt;</span></code> state.
+However, that behavior can be changed to instead apply the transformation when a control qubit is in
+a <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> state by negating the polarity of the control qubit.
+The syntax for negating the polarity is the not-operator preceding the
+control qubit:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--13-input--1" name="tab-set--13" type="radio"><label class="tab-label" for="tab-set--13-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">c</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="n">h</span><span class="p">(</span><span class="n">c</span><span class="p">);</span>
+<span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="o">!</span><span class="n">c</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="c1">// The qubits c and q are in a state (|01&gt; + |10&gt;) / √2.</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>This notation is only supported in the context of applying a controlled operation and is only valid for control qubits. For example, negating either of the target qubits in the
+<code class="code docutils literal notranslate"><span class="pre">swap</span></code> operation is not allowed.
+Negating the polarity of control qubits is similarly supported when using <code class="code docutils literal notranslate"><span class="pre">cudaq::control</span></code> to conditionally apply a custom quantum kernel.</p>
+</section>
+<section id="measurements-on-qubits">
+<h2>Measurements on Qubits<a class="headerlink" href="#measurements-on-qubits" title="Permalink to this heading">¶</a></h2>
+<section id="mz">
+<h3><code class="code docutils literal notranslate"><span class="pre">mz</span></code><a class="headerlink" href="#mz" title="Permalink to this heading">¶</a></h3>
+<p>This operation measures a qubit with respect to the computational basis,
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-Z matrix.
+This is a non-linear transformation, and no template overloads are available.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--14-input--1" name="tab-set--14" type="radio"><label class="tab-label" for="tab-set--14-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--14-input--2" name="tab-set--14" type="radio"><label class="tab-label" for="tab-set--14-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+<span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="mx">
+<h3><code class="code docutils literal notranslate"><span class="pre">mx</span></code><a class="headerlink" href="#mx" title="Permalink to this heading">¶</a></h3>
+<p>This operation measures a qubit with respect to the Pauli-X basis,
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-X matrix.
+This is a non-linear transformation, and no template overloads are available.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--15-input--1" name="tab-set--15" type="radio"><label class="tab-label" for="tab-set--15-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="n">mx</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--15-input--2" name="tab-set--15" type="radio"><label class="tab-label" for="tab-set--15-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+<span class="n">mx</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="my">
+<h3><code class="code docutils literal notranslate"><span class="pre">my</span></code><a class="headerlink" href="#my" title="Permalink to this heading">¶</a></h3>
+<p>This operation measures a qubit with respect to the Pauli-Y basis,
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-Y matrix.
+This is a non-linear transformation, and no template overloads are available.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--16-input--1" name="tab-set--16" type="radio"><label class="tab-label" for="tab-set--16-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">my</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--16-input--2" name="tab-set--16" type="radio"><label class="tab-label" for="tab-set--16-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+<span class="n">my</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+</section>
+<section id="user-defined-custom-operations">
+<h2>User-Defined Custom Operations<a class="headerlink" href="#user-defined-custom-operations" title="Permalink to this heading">¶</a></h2>
+<p>Users can define a custom quantum operation by its unitary matrix. First use
+the API to register a custom operation, outside of a CUDA-Q kernel. Then the
+operation can be used within a CUDA-Q kernel like any of the built-in operations
+defined above.
+Custom operations are supported on qubits only (<code class="code docutils literal notranslate"><span class="pre">qudit</span></code> with <code class="code docutils literal notranslate"><span class="pre">level</span> <span class="pre">=</span> <span class="pre">2</span></code>).</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--17-input--1" name="tab-set--17" type="radio"><label class="tab-label" for="tab-set--17-input--1">Python</label><div class="tab-content docutils">
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq.register_operation</span></code> API accepts an identifier string for
+the custom operation and its unitary matrix. The matrix can be a <code class="code docutils literal notranslate"><span class="pre">list</span></code> or
+<code class="code docutils literal notranslate"><span class="pre">numpy</span></code> array of complex numbers. A 1D matrix is interpreted as row-major.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">register_operation</span><span class="p">(</span><span class="s2">&quot;custom_h&quot;</span><span class="p">,</span> <span class="mf">1.</span> <span class="o">/</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="mf">2.</span><span class="p">)</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">]))</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">register_operation</span><span class="p">(</span><span class="s2">&quot;custom_x&quot;</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">]))</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">bell</span><span class="p">():</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">custom_h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">custom_x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">bell</span><span class="p">)</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--17-input--2" name="tab-set--17" type="radio"><label class="tab-label" for="tab-set--17-input--2">C++</label><div class="tab-content docutils">
+<p>The macro <code class="code docutils literal notranslate"><span class="pre">CUDAQ_REGISTER_OPERATION</span></code> accepts a unique name for the
+operation, the number of target qubits, the number of rotation parameters
+(can be 0), and the unitary matrix as a 1D row-major <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;complex&gt;</span></code>
+representation.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="n">CUDAQ_REGISTER_OPERATION</span><span class="p">(</span><span class="n">custom_h</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
+<span class="w">                        </span><span class="p">{</span><span class="n">M_SQRT1_2</span><span class="p">,</span><span class="w"> </span><span class="n">M_SQRT1_2</span><span class="p">,</span><span class="w"> </span><span class="n">M_SQRT1_2</span><span class="p">,</span><span class="w"> </span><span class="o">-</span><span class="n">M_SQRT1_2</span><span class="p">})</span>
+
+<span class="n">CUDAQ_REGISTER_OPERATION</span><span class="p">(</span><span class="n">custom_x</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">})</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">bell_pair</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">;</span>
+<span class="w">    </span><span class="n">custom_h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">custom_x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">bell_pair</span><span class="p">);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;%s</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">.</span><span class="n">data</span><span class="p">());</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>For multi-qubit operations, the matrix is interpreted with MSB qubit ordering,
+i.e. big-endian convention. The following example shows two different custom
+operations, each operating on 2 qubits.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--18-input--1" name="tab-set--18" type="radio"><label class="tab-label" for="tab-set--18-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># Create and test a custom CNOT operation.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">register_operation</span><span class="p">(</span><span class="s2">&quot;my_cnot&quot;</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span>
+                                              <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span>
+                                              <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span>
+                                              <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">]))</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">bell_pair</span><span class="p">():</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">my_cnot</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="c1"># `my_cnot(control, target)`</span>
+
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">bell_pair</span><span class="p">)</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span> <span class="c1"># prints { 11:500 00:500 } (exact numbers will be random)</span>
+
+
+<span class="c1"># Construct a custom unitary matrix for X on the first qubit and Y</span>
+<span class="c1"># on the second qubit.</span>
+<span class="n">X</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mi">0</span><span class="p">,</span>  <span class="mi">1</span> <span class="p">],</span> <span class="p">[</span><span class="mi">1</span> <span class="p">,</span> <span class="mi">0</span><span class="p">]])</span>
+<span class="n">Y</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mi">0</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="n">j</span><span class="p">],</span> <span class="p">[</span><span class="mi">1</span><span class="n">j</span><span class="p">,</span> <span class="mi">0</span><span class="p">]])</span>
+<span class="n">XY</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">kron</span><span class="p">(</span><span class="n">X</span><span class="p">,</span> <span class="n">Y</span><span class="p">)</span>
+
+<span class="c1"># Register the custom operation</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">register_operation</span><span class="p">(</span><span class="s2">&quot;my_XY&quot;</span><span class="p">,</span> <span class="n">XY</span><span class="p">)</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">custom_xy_test</span><span class="p">():</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">my_XY</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">y</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="c1"># undo the prior Y gate on qubit 1</span>
+
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">custom_xy_test</span><span class="p">)</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span> <span class="c1"># prints { 10:1000 }</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--18-input--2" name="tab-set--18" type="radio"><label class="tab-label" for="tab-set--18-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="n">CUDAQ_REGISTER_OPERATION</span><span class="p">(</span><span class="n">MyCNOT</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
+<span class="w">                         </span><span class="p">{</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">});</span>
+
+<span class="n">CUDAQ_REGISTER_OPERATION</span><span class="p">(</span>
+<span class="w">    </span><span class="n">MyXY</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span>
+<span class="w">    </span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">-1</span><span class="p">},</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">},</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">-1</span><span class="p">},</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">},</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">});</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">bell_pair</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">;</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">MyCNOT</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span><span class="w"> </span><span class="c1">// MyCNOT(control, target)</span>
+<span class="p">}</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">custom_xy_test</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">;</span>
+<span class="w">  </span><span class="n">MyXY</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">y</span><span class="p">(</span><span class="n">r</span><span class="p">);</span><span class="w"> </span><span class="c1">// undo the prior Y gate on qubit 1</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">bell_pair</span><span class="p">);</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span><span class="w"> </span><span class="c1">// prints { 11:500 00:500 } (exact numbers will be random)</span>
+
+<span class="w">  </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">custom_xy_test</span><span class="p">);</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span><span class="w"> </span><span class="c1">// prints { 10:1000 }</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Custom operations are currently supported only on <a class="reference internal" href="../using/backends/simulators.html"><span class="doc">CUDA-Q Simulation Backends</span></a>.
+Attempt to use with a hardware backend will result in runtime error.</p>
+</div>
+</section>
+<section id="photonic-operations-on-qudits">
+<h2>Photonic Operations on Qudits<a class="headerlink" href="#photonic-operations-on-qudits" title="Permalink to this heading">¶</a></h2>
+<p>These operations are valid only on the <code class="code docutils literal notranslate"><span class="pre">photonics</span></code> target which does not support the quantum operations above.</p>
+<section id="plus">
+<h3><code class="code docutils literal notranslate"><span class="pre">plus</span></code><a class="headerlink" href="#plus" title="Permalink to this heading">¶</a></h3>
+<p>This is a place-holder, to be updated later.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--19-input--1" name="tab-set--19" type="radio"><label class="tab-label" for="tab-set--19-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">q</span> <span class="o">=</span> <span class="n">qudit</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span>
+<span class="n">plus</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--19-input--2" name="tab-set--19" type="radio"><label class="tab-label" for="tab-set--19-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="o">&lt;</span><span class="mi">3</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+<span class="n">plus</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="phase-shift">
+<h3><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code><a class="headerlink" href="#phase-shift" title="Permalink to this heading">¶</a></h3>
+<p>This is a place-holder, to be updated later.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--20-input--1" name="tab-set--20" type="radio"><label class="tab-label" for="tab-set--20-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">q</span> <span class="o">=</span> <span class="n">qudit</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
+<span class="n">phase_shift</span><span class="p">(</span><span class="n">q</span><span class="p">,</span> <span class="mf">0.17</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--20-input--2" name="tab-set--20" type="radio"><label class="tab-label" for="tab-set--20-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="o">&lt;</span><span class="mi">4</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+<span class="n">phase_shift</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="mf">0.17</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="beam-splitter">
+<h3><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code><a class="headerlink" href="#beam-splitter" title="Permalink to this heading">¶</a></h3>
+<p>This is a place-holder, to be updated later.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--21-input--1" name="tab-set--21" type="radio"><label class="tab-label" for="tab-set--21-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">q</span> <span class="o">=</span> <span class="p">[</span><span class="n">qudit</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">)]</span>
+<span class="n">beam_splitter</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="mf">0.34</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--21-input--2" name="tab-set--21" type="radio"><label class="tab-label" for="tab-set--21-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="o">&lt;</span><span class="mi">3</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="n">beam_splitter</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="mf">0.34</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="id1">
+<h3><code class="code docutils literal notranslate"><span class="pre">mz</span></code><a class="headerlink" href="#id1" title="Permalink to this heading">¶</a></h3>
+<p>This operation returns the measurement results of the input qudit(s).</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--22-input--1" name="tab-set--22" type="radio"><label class="tab-label" for="tab-set--22-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qutrits</span> <span class="o">=</span> <span class="p">[</span><span class="n">qudit</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">)]</span>
+<span class="n">mz</span><span class="p">(</span><span class="n">qutrits</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--22-input--2" name="tab-set--22" type="radio"><label class="tab-label" for="tab-set--22-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="o">&lt;</span><span class="mi">3</span><span class="o">&gt;</span><span class="w"> </span><span class="n">qutrits</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="n">mz</span><span class="p">(</span><span class="n">qutrits</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="languages/python_api.html" class="btn btn-neutral float-left" title="CUDA-Q Python API" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../versions.html" class="btn btn-neutral float-right" title="CUDA-Q Versions" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/api/languages/cpp_api.html b/pr-2241/api/languages/cpp_api.html
new file mode 100644
index 0000000000..3baebb5946
--- /dev/null
+++ b/pr-2241/api/languages/cpp_api.html
@@ -0,0 +1,3806 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q C++ API &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="CUDA-Q Python API" href="python_api.html" />
+    <link rel="prev" title="Code documentation" href="../api.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../api.html">   API Reference</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../api.html">Code documentation</a></li>
+      <li class="breadcrumb-item active">CUDA-Q C++ API</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/api/languages/cpp_api.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../api.html" class="btn btn-neutral float-left" title="Code documentation" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="python_api.html" class="btn btn-neutral float-right" title="CUDA-Q Python API" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-c-api">
+<h1>CUDA-Q C++ API<a class="headerlink" href="#cuda-q-c-api" title="Permalink to this heading">¶</a></h1>
+<section id="operators">
+<h2>Operators<a class="headerlink" href="#operators" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opE">
+<span class="target" id="classcudaq_1_1spin__op"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> represents a general sum of Pauli tensor products. It exposes the typical algebraic operations that allow programmers to define primitive Pauli operators and use them to compose larger, more complex Pauli tensor products and sums thereof. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-types">Public Types</p>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op12spin_op_termE">
+<span class="target" id="classcudaq_1_1spin__op_1ae504b902ef95b21439e04d51143e3bc4"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">spin_op_term</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">bool</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>We represent the <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> terms in binary symplectic form, i.e. each term is a vector of 1s and 0s of size 2 * nQubits, where the first n elements represent X, the next n elements represent Z, and X=Z=1 -&gt; Y on site i, X=1, Z=0 -&gt; X on site i, and X=0, Z=1 -&gt; Z on site i. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op12csr_spmatrixE">
+<span class="target" id="classcudaq_1_1spin__op_1a3cc72dd5fc9a07f1c6912083f7012dcb"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">csr_spmatrix</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">tuple</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op12csr_spmatrixE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Typedef for a vector of non-zero sparse matrix elements. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERNSt4pairIK12spin_op_termNSt7complexIdEEEE">
+<span class="target" id="classcudaq_1_1spin__op_1aec0f837d1cb83ed2f0b73ad24a30763c"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="cudaq::spin_op::spin_op_term"><span class="n"><span class="pre">spin_op_term</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">termData</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERNSt4pairIK12spin_op_termNSt7complexIdEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes a single term / coefficient pair. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERKNSt4pairIK12spin_op_termNSt7complexIdEEEE">
+<span class="target" id="classcudaq_1_1spin__op_1ae1320f34fcd101466b5e6d6983bbeb6e"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="cudaq::spin_op::spin_op_term"><span class="n"><span class="pre">spin_op_term</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">termData</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERKNSt4pairIK12spin_op_termNSt7complexIdEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes a single term / coefficient constant pair. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE">
+<span class="target" id="classcudaq_1_1spin__op_1aa563dacd8019e741e03fb2d85c0fa7e0"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">pauli</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">id</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">coeff</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">1.0</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the Pauli type, the qubit site, and the term coefficient. Constructs a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref"><span class="pre">spin_op</span></span></a></code> of one Pauli on one qubit. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE">
+<span class="target" id="classcudaq_1_1spin__op_1aaaf4fe4875eea54d2ca5844b5f69d77c"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="cudaq::spin_op::spin_op_term"><span class="n"><span class="pre">spin_op_term</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">term</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">coeff</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the binary representation of a single term and its coefficient. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERKNSt13unordered_mapI12spin_op_termNSt7complexIdEEEE">
+<span class="target" id="classcudaq_1_1spin__op_1a5bb6434a82fe4479a72860ba5f1e7930"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">unordered_map</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="cudaq::spin_op::spin_op_term"><span class="n"><span class="pre">spin_op_term</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">_terms</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERKNSt13unordered_mapI12spin_op_termNSt7complexIdEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a full set of terms for the composite spin op as an unordered_map mapping individual terms to their coefficient. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE">
+<span class="target" id="classcudaq_1_1spin__op_1ae66b0d0da05c6566d3aa70473a035662"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="cudaq::spin_op::spin_op_term"><span class="n"><span class="pre">spin_op_term</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">bsf</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">coeffs</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct from a vector of term data. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opEv">
+<span class="target" id="classcudaq_1_1spin__op_1a2eec6685f70a7e710460ec2c3813a149"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, creates the identity term. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opENSt6size_tE">
+<span class="target" id="classcudaq_1_1spin__op_1afe98dbe82f7f7792dc9c7002f8d980a8"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">numQubits</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct the identity term on the given number of qubits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERK7spin_op">
+<span class="target" id="classcudaq_1_1spin__op_1a5fbe20bdec4f57a728853f773b88d2da"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op7spin_opERK7spin_op" title="cudaq::spin_op::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">o</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE">
+<span class="target" id="classcudaq_1_1spin__op_1a110eb5dc534fddf1277901c8663e08b4"></span><span class="sig-name descname"><span class="n"><span class="pre">spin_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">data_rep</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">nQubits</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> from a serialized representation. Specifically, this encoding is via a vector of doubles. The encoding is as follows: for each term, a list of doubles where element <code class="docutils literal notranslate"><span class="pre">i</span></code> is a 3.0 for a Y, a 1.0 for a X, and a 2.0 for a Z on qubit i, followed by the real and imaginary part of the coefficient. Each term is appended to the array forming one large 1d array of doubles. The array is ended with the total number of terms represented as a double. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opD0Ev">
+<span class="target" id="classcudaq_1_1spin__op_1a11c0ef8ecb9670dec2a186a7589476cf"></span><span class="sig-name descname"><span class="n"><span class="pre">~spin_op</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opD0Ev" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The destructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op5beginEv">
+<span class="target" id="classcudaq_1_1spin__op_1aa44b7656a7aae6708fd76385cda157bd"></span><a class="reference internal" href="#_CPPv4I0EN5cudaq7spin_op8iteratorE" title="cudaq::spin_op::iterator"><span class="n"><span class="pre">iterator</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">begin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op5beginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return iterator to start of <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> terms. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op3endEv">
+<span class="target" id="classcudaq_1_1spin__op_1a8f4570cf5e66c8b764756c6d939ba216"></span><a class="reference internal" href="#_CPPv4I0EN5cudaq7spin_op8iteratorE" title="cudaq::spin_op::iterator"><span class="n"><span class="pre">iterator</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">end</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op3endEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return iterator to end of <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> terms. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op5beginEv">
+<span class="target" id="classcudaq_1_1spin__op_1a13fe416609d6696e805ee0e9ac189587"></span><a class="reference internal" href="#_CPPv4I0EN5cudaq7spin_op8iteratorE" title="cudaq::spin_op::iterator"><span class="n"><span class="pre">iterator</span></span></a><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">begin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op5beginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return constant iterator to start of <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref"><span class="pre">spin_op</span></span></a></code> terms. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op3endEv">
+<span class="target" id="classcudaq_1_1spin__op_1a1fe8f68270d5c9306dffb1f805944cdc"></span><a class="reference internal" href="#_CPPv4I0EN5cudaq7spin_op8iteratorE" title="cudaq::spin_op::iterator"><span class="n"><span class="pre">iterator</span></span></a><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">end</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op3endEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return constant iterator to end of <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref"><span class="pre">spin_op</span></span></a></code> terms. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opaSERK7spin_op">
+<span class="target" id="classcudaq_1_1spin__op_1ad18f3c40dbae543892e2b43aa21e4079"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opaSERK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the provided <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> equal to this one and return *this. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_oppLERK7spin_op">
+<span class="target" id="classcudaq_1_1spin__op_1a55cda5390f5f4ebd3cb41e5d749c86a8"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">+=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_oppLERK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> to this one and return *this. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opmIERK7spin_op">
+<span class="target" id="classcudaq_1_1spin__op_1a80fb43e29ae5fc1dce8804803879303b"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">-=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opmIERK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Subtract the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> from this one and return *this. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opmLERK7spin_op">
+<span class="target" id="classcudaq_1_1spin__op_1af79d857df22289d4b6791c2a711f8841"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opmLERK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> with this one and return *this. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_opeqERK7spin_op">
+<span class="target" id="classcudaq_1_1spin__op_1acb27a068fa567944e3b452892d2a4780"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">==</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_opeqERK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> is equal to the given one. Equality here does not consider the coefficients. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opmLEKd">
+<span class="target" id="classcudaq_1_1spin__op_1acfb4b53c76a0363ff89ac260fdbf21cf"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opmLEKd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> by the given double. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_opmLEKNSt7complexIdEE">
+<span class="target" id="classcudaq_1_1spin__op_1ae6d43a1e540454bc3b951c97bb8b3337"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4N5cudaq7spin_opmLEKNSt7complexIdEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> by the given complex value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op10num_qubitsEv">
+<span class="target" id="classcudaq_1_1spin__op_1a6bd7db85c9189b0e85245856bbd986cd"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">num_qubits</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op10num_qubitsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of qubits this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> is on. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op9num_termsEv">
+<span class="target" id="classcudaq_1_1spin__op_1ad75e50a6a1547192de5f4acd7ad3f2de"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">num_terms</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op9num_termsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of terms in this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op15get_coefficientEv">
+<span class="target" id="classcudaq_1_1spin__op_1a7a0579252345b90f6bc3b808724381f3"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_coefficient</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op15get_coefficientEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>For a <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> with 1 term, get that terms’ coefficient. Throws an exception for spin_ops with &gt; 1 terms. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op12get_raw_dataEv">
+<span class="target" id="classcudaq_1_1spin__op_1a7b693c256dda5c7e933a91f85d0455eb"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12spin_op_termE" title="cudaq::spin_op::spin_op_term"><span class="n"><span class="pre">spin_op_term</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_raw_data</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op12get_raw_dataEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the binary symplectic form data. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op11is_identityEv">
+<span class="target" id="classcudaq_1_1spin__op_1a95b0b23ea81105da74dc5d4d6a1fa07e"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">is_identity</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op11is_identityEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Is this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> == to the identity. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op4dumpEv">
+<span class="target" id="classcudaq_1_1spin__op_1abb3b7b89c257333db3fa0577712d77d2"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op4dumpEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump a string representation of this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> to standard out. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op9to_stringEb">
+<span class="target" id="classcudaq_1_1spin__op_1a72332ac65d2cc57ec6669dc6b4bcda8e"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">to_string</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">printCoefficients</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">true</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op9to_stringEb" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a string representation of this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op21getDataRepresentationEv">
+<span class="target" id="classcudaq_1_1spin__op_1a05ba20691749439da3866abda0a454e6"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getDataRepresentation</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op21getDataRepresentationEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the vector&lt;double&gt; serialized representation of this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. (see the constructor for the encoding) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op12getDataTupleEv">
+<span class="target" id="classcudaq_1_1spin__op_1a997cacbd50b8ab6549a08e3fb959f876"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">tuple</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getDataTuple</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op12getDataTupleEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the serialized representation of this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>, such that it is fully constructible with a <a class="reference internal" href="#classcudaq_1_1spin__op_1a2eec6685f70a7e710460ec2c3813a149"><span class="std std-ref">spin_op()</span></a> constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op16distribute_termsENSt6size_tE">
+<span class="target" id="classcudaq_1_1spin__op_1a8fb7080ea8c312013fbbf2e530a1178f"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">distribute_terms</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">numChunks</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op16distribute_termsENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a vector of <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> representing a distribution of the terms in this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> into equally sized chunks. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op13for_each_termERRNSt8functionIFvR7spin_opEEE">
+<span class="target" id="classcudaq_1_1spin__op_1ac237866d1edf80aca645197c39e4c054"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">for_each_term</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op13for_each_termERRNSt8functionIFvR7spin_opEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Apply the give functor on each term of this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. This method can enable general reductions via lambda capture variables. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op14for_each_pauliERRNSt8functionIFv5pauliNSt6size_tEEEE">
+<span class="target" id="classcudaq_1_1spin__op_1a5e1833312240d4a94317a56db778c5f0"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">for_each_pauli</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">pauli</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op14for_each_pauliERRNSt8functionIFv5pauliNSt6size_tEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Apply the functor on each Pauli in this 1-term <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. An exception is thrown if there are more than 1 terms. Users should pass a functor that takes the <code class="docutils literal notranslate"><span class="pre">pauli</span></code> type and the qubit index. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op9to_matrixEv">
+<span class="target" id="classcudaq_1_1spin__op_1a5c3a338d5593536cceca3fb96958ae16"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrixE" title="cudaq::complex_matrix"><span class="n"><span class="pre">complex_matrix</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">to_matrix</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op9to_matrixEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a dense matrix representation of this <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7spin_op16to_sparse_matrixEv">
+<span class="target" id="classcudaq_1_1spin__op_1a2fccd38728e453a173e02b90c6a36257"></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_op12csr_spmatrixE" title="cudaq::spin_op::csr_spmatrix"><span class="n"><span class="pre">csr_spmatrix</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">to_sparse_matrix</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7spin_op16to_sparse_matrixEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a sparse matrix representation of this <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref"><span class="pre">spin_op</span></span></a></code>. The return type encodes all non-zero <code class="docutils literal notranslate"><span class="pre">(row,</span> <span class="pre">col,</span> <span class="pre">value)</span></code> elements. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-static-functions">Public Static Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj">
+<span class="target" id="classcudaq_1_1spin__op_1a86568d7681059dc9f0cc3eb13d3286ed"></span><span class="k"><span class="pre">static</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">random</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">nQubits</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">nTerms</span></span>, <span class="kt"><span class="pre">unsigned</span></span><span class="w"> </span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">seed</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">random_device</span></span><span class="p"><span class="pre">{</span></span><span class="p"><span class="pre">}</span></span><span class="p"><span class="pre">(</span></span><span class="p"><span class="pre">)</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a random spin operator acting on the specified number of qubits and composed of the given number of terms. Override <code class="docutils literal notranslate"><span class="pre">seed</span></code> for repeatability. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7spin_op9from_wordERKNSt6stringE">
+<span class="target" id="classcudaq_1_1spin__op_1a6ad8a07f5a8f595f3fee45c9062c64a3"></span><span class="k"><span class="pre">static</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">from_word</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">pauliWord</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7spin_op9from_wordERKNSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref"><span class="pre">spin_op</span></span></a></code> representative of the input Pauli word, e.g. XYX for a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref"><span class="pre">spin_op</span></span></a></code> on 3 qubits with a X support on the first and 3rd and Y support on the second. </p>
+</dd></dl>
+
+</div>
+<dl class="cpp struct">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq7spin_op8iteratorE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QualifiedSpinOp</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="structcudaq_1_1spin__op_1_1iterator"></span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">iterator</span></span></span><a class="headerlink" href="#_CPPv4I0EN5cudaq7spin_op8iteratorE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="quantum">
+<h2>Quantum<a class="headerlink" href="#quantum" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3dynE">
+<span class="target" id="qspan_8h_1a2c3fa68d916be379bab257d559f25d24"></span><span class="k"><span class="pre">constexpr</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">dyn</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="o"><span class="pre">~</span></span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq3dynE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I_NSt6size_tEEN5cudaq5quditE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Levels</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1qudit"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qudit</span></span></span><a class="headerlink" href="#_CPPv4I_NSt6size_tEEN5cudaq5quditE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The qudit models a general d-level quantum system. This type is templated on the number of levels d. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5qudit5quditEv">
+<span class="target" id="classcudaq_1_1qudit_1aae29ba66c8a87724c34d939787087608"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qudit</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5qudit5quditEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct a qudit, will allocated a new unique index. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">N</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq3dynE" title="cudaq::dyn"><span class="n"><span class="pre">dyn</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Levels</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">2</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="p"><span class="pre">(</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE" title="cudaq::qreg::N"><span class="n"><span class="pre">N</span></span></a><span class="w"> </span><span class="o"><span class="pre">&gt;</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1qreg"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qreg</span></span></span><a class="headerlink" href="#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A <code class="docutils literal notranslate"><span class="pre">qreg</span></code> is a container for qudits. This container can be dynamic or compile-time-size specified. By default, the <code class="docutils literal notranslate"><span class="pre">qreg</span></code> is constructed as a dynamic register (vector-like) of qubits (2-level). This can be changed via the <code class="docutils literal notranslate"><span class="pre">qreg</span></code> type template parameters. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-types">Public Types</p>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg10value_typeE">
+<span class="target" id="classcudaq_1_1qreg_1a609490620e68c0ec536e2ef6a3d921f4"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">value_type</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5quditE" title="cudaq::qudit"><span class="n"><span class="pre">qudit</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE" title="cudaq::qreg::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq4qreg10value_typeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Useful typedef indicating the underlying qudit type. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg5beginEv">
+<span class="target" id="classcudaq_1_1qreg_1aeaf9c41b1f57bb63ecf3acf411367bdc"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">auto</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">begin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg5beginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Iterator interface, begin. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qregixEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1qreg_1a1dba67a7873d440e7b94f584914f0266"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq4qreg10value_typeE" title="cudaq::qreg::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">[]</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qregixEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the qudit at <code class="docutils literal notranslate"><span class="pre">idx</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg5frontENSt6size_tE">
+<span class="target" id="classcudaq_1_1qreg_1a1fd9a79ba06a022d5d8299bb00bc9669"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE" title="cudaq::qspan"><span class="n"><span class="pre">qspan</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq3dynE" title="cudaq::dyn"><span class="n"><span class="pre">dyn</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE" title="cudaq::qreg::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">front</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">count</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg5frontENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the <code class="docutils literal notranslate"><span class="pre">[0,</span> <span class="pre">count)</span></code> qudits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg5frontEv">
+<span class="target" id="classcudaq_1_1qreg_1a32a03f7a1ca19a220db168caabdb4f71"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq4qreg10value_typeE" title="cudaq::qreg::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="n"><span class="pre">front</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg5frontEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the first qudit. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg4backENSt6size_tE">
+<span class="target" id="classcudaq_1_1qreg_1a176a76f8829ff346b7e5f9ca41e6d20b"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE" title="cudaq::qspan"><span class="n"><span class="pre">qspan</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq3dynE" title="cudaq::dyn"><span class="n"><span class="pre">dyn</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE" title="cudaq::qreg::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">back</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">count</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg4backENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the <code class="docutils literal notranslate"><span class="pre">[count,</span> <a class="reference internal" href="#classcudaq_1_1qreg_1ac65686ebfda02852643371396350fba6"><span class="std std-ref"><span class="pre">size()</span></span></a><span class="pre">)</span></code> qudits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg4backEv">
+<span class="target" id="classcudaq_1_1qreg_1ad9adbd2e3a216840f470061c5b999a73"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq4qreg10value_typeE" title="cudaq::qreg::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="n"><span class="pre">back</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg4backEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the last qudit. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE">
+<span class="target" id="classcudaq_1_1qreg_1a7dfda2cff5b477b77440f3a794d76e7b"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE" title="cudaq::qspan"><span class="n"><span class="pre">qspan</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq3dynE" title="cudaq::dyn"><span class="n"><span class="pre">dyn</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE" title="cudaq::qreg::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">slice</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">start</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">size</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the <code class="docutils literal notranslate"><span class="pre">[start,</span> <span class="pre">start+size)</span></code> qudits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq4qreg4sizeEv">
+<span class="target" id="classcudaq_1_1qreg_1ac65686ebfda02852643371396350fba6"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">size</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq4qreg4sizeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the number of contained qudits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4qreg5clearEv">
+<span class="target" id="classcudaq_1_1qreg_1a7747f90309085d531f8fafa248e19c4d"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clear</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4qreg5clearEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Destroys all contained qudits. Postcondition: <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1qreg_1ac65686ebfda02852643371396350fba6"><span class="std std-ref"><span class="pre">size()</span></span></a> <span class="pre">==</span> <span class="pre">0</span></code>. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I_NSt6size_tEEN5cudaq7qvectorE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Levels</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">2</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1qvector"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qvector</span></span></span><a class="headerlink" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A <code class="docutils literal notranslate"><span class="pre">qvector</span></code> is an owning, dynamically sized container for qudits. The semantics of the <code class="docutils literal notranslate"><span class="pre">qvector</span></code> follows that of a <code class="docutils literal notranslate"><span class="pre">std::vector</span></code> for qudits. It is templated on the number of levels for the held qudits. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-types">Public Types</p>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector10value_typeE">
+<span class="target" id="classcudaq_1_1qvector_1ae682d4685f2f82df11ee2fba64b15979"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">value_type</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5quditE" title="cudaq::qudit"><span class="n"><span class="pre">qudit</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="cudaq::qvector::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq7qvector10value_typeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Useful typedef indicating the underlying qudit type. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector7qvectorENSt6size_tE">
+<span class="target" id="classcudaq_1_1qvector_1abae7b7b8afbba68eb00a0132242ca772"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qvector</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">size</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector7qvectorENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct a <code class="docutils literal notranslate"><span class="pre">qvector</span></code> with <code class="docutils literal notranslate"><span class="pre">size</span></code> qudits in the |0&gt; state. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb">
+<span class="target" id="classcudaq_1_1qvector_1a1207f490dab570c43527a9563d29d57a"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">explicit</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qvector</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7complexE" title="cudaq::complex"><span class="n"><span class="pre">complex</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">vector</span></span>, <span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">validate</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct a <code class="docutils literal notranslate"><span class="pre">qvector</span></code> from an input state vector. The number of qubits is determined by the size of the input vector. If <code class="docutils literal notranslate"><span class="pre">validate</span></code> is set, it will check the norm of input state vector. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector7qvectorERK5state">
+<span class="target" id="classcudaq_1_1qvector_1a0fd2545386af75c0d1aed18c8b3b50ef"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">explicit</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qvector</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7qvector7qvectorERK5state" title="cudaq::qvector::qvector::state"><span class="n"><span class="pre">state</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">state</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector7qvectorERK5state" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct a <code class="docutils literal notranslate"><span class="pre">qvector</span></code> from a pre-existing <code class="docutils literal notranslate"><span class="pre">state</span></code>. This <code class="docutils literal notranslate"><span class="pre">state</span></code> could be constructed with <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1state_1a2e9b7d521f974822246d180d43160d2e"><span class="std std-ref"><span class="pre">state::from_data</span></span></a></code> or retrieved from an cudaq::get_state. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector7qvectorERK7qvector">
+<span class="target" id="classcudaq_1_1qvector_1a3c728c95d13fa476066e3d4379b42577"></span><span class="sig-name descname"><span class="n"><span class="pre">qvector</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq7qvector7qvectorERK7qvector" title="cudaq::qvector::qvector"><span class="n"><span class="pre">qvector</span></span></a><span class="w"> </span><span class="k"><span class="pre">const</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">delete</span></span><a class="headerlink" href="#_CPPv4N5cudaq7qvector7qvectorERK7qvector" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><code class="docutils literal notranslate"><span class="pre">qvectors</span></code> cannot be copied </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector7qvectorERR7qvector">
+<span class="target" id="classcudaq_1_1qvector_1a82d3fe912eea5c553ca16535202a0153"></span><span class="sig-name descname"><span class="n"><span class="pre">qvector</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq7qvector7qvectorERR7qvector" title="cudaq::qvector::qvector"><span class="n"><span class="pre">qvector</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">delete</span></span><a class="headerlink" href="#_CPPv4N5cudaq7qvector7qvectorERR7qvector" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><code class="docutils literal notranslate"><span class="pre">qvectors</span></code> cannot be moved </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvectoraSERK7qvector">
+<span class="target" id="classcudaq_1_1qvector_1a6c5ea26ff88b2878e489abe0decf0443"></span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="cudaq::qvector"><span class="n"><span class="pre">qvector</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="cudaq::qvector"><span class="n"><span class="pre">qvector</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">delete</span></span><a class="headerlink" href="#_CPPv4N5cudaq7qvectoraSERK7qvector" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><code class="docutils literal notranslate"><span class="pre">qvectors</span></code> cannot be copy assigned. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector5beginEv">
+<span class="target" id="classcudaq_1_1qvector_1a70e0810339d14fd4dd2318e64ba0e8bf"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">auto</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">begin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector5beginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Iterator interface, begin. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector3endEv">
+<span class="target" id="classcudaq_1_1qvector_1a318de5f80ce8de87d4ab93c23c7bb4e1"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">auto</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">end</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector3endEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Iterator interface, end. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvectorixEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1qvector_1a0f523009b5ed3508b2ed82782519a162"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7qvector10value_typeE" title="cudaq::qvector::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">[]</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvectorixEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the qudit at <code class="docutils literal notranslate"><span class="pre">idx</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector5frontENSt6size_tE">
+<span class="target" id="classcudaq_1_1qvector_1a1a432e3062bdc3a20bb60325d13dc0f8"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5qviewE" title="cudaq::qview"><span class="n"><span class="pre">qview</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="cudaq::qvector::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">front</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">count</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector5frontENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the <code class="docutils literal notranslate"><span class="pre">[0,</span> <span class="pre">count)</span></code> qudits as a non-owning <code class="docutils literal notranslate"><span class="pre">qview</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector5frontEv">
+<span class="target" id="classcudaq_1_1qvector_1a91033e3edd4c8d5bdeb8c4413b8dca46"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7qvector10value_typeE" title="cudaq::qvector::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="n"><span class="pre">front</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector5frontEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the first qudit. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector4backENSt6size_tE">
+<span class="target" id="classcudaq_1_1qvector_1a23e6307b94f7cfe671257e1aea073e3c"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5qviewE" title="cudaq::qview"><span class="n"><span class="pre">qview</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="cudaq::qvector::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">back</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">count</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector4backENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the <code class="docutils literal notranslate"><span class="pre">[count,</span> <a class="reference internal" href="#classcudaq_1_1qvector_1a47fdee3b43a7df454bfc60e1095c12a1"><span class="std std-ref"><span class="pre">size()</span></span></a><span class="pre">)</span></code> qudits as a non-owning <code class="docutils literal notranslate"><span class="pre">qview</span></code> </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector4backEv">
+<span class="target" id="classcudaq_1_1qvector_1a661d4e8d60e511508e2fbae8089f0bb0"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7qvector10value_typeE" title="cudaq::qvector::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="n"><span class="pre">back</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector4backEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the last qudit. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE">
+<span class="target" id="classcudaq_1_1qvector_1a0ce059332fd013ed919762961e306323"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5qviewE" title="cudaq::qview"><span class="n"><span class="pre">qview</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE" title="cudaq::qvector::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">slice</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">start</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">size</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the <code class="docutils literal notranslate"><span class="pre">[start,</span> <span class="pre">start+size)</span></code> qudits as a non-owning <code class="docutils literal notranslate"><span class="pre">qview</span></code> </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq7qvector4sizeEv">
+<span class="target" id="classcudaq_1_1qvector_1a47fdee3b43a7df454bfc60e1095c12a1"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">size</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq7qvector4sizeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns the number of contained qudits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7qvector5clearEv">
+<span class="target" id="classcudaq_1_1qvector_1a8b77c953437148f72de1a1150674f653"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clear</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7qvector5clearEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Destroys all contained qudits. Postcondition: <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1qvector_1a47fdee3b43a7df454bfc60e1095c12a1"><span class="std std-ref"><span class="pre">size()</span></span></a> <span class="pre">==</span> <span class="pre">0</span></code>. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">N</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq3dynE" title="cudaq::dyn"><span class="n"><span class="pre">dyn</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Levels</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">2</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1qspan"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qspan</span></span></span><a class="headerlink" href="#_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I_NSt6size_tEEN5cudaq5qviewE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Levels</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">2</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1qview"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qview</span></span></span><a class="headerlink" href="#_CPPv4I_NSt6size_tEEN5cudaq5qviewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <code class="docutils literal notranslate"><span class="pre">qview</span></code> represents a non-owning container of qudits. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-types">Public Types</p>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5qview10value_typeE">
+<span class="target" id="classcudaq_1_1qview_1a6433c4ac3fb63793c67d05e48c5d7cd5"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">value_type</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5quditE" title="cudaq::qudit"><span class="n"><span class="pre">qudit</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5qviewE" title="cudaq::qview::Levels"><span class="n"><span class="pre">Levels</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq5qview10value_typeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Useful typedef exposing the underlying qudit type that this <code class="docutils literal notranslate"><span class="pre">qview</span></code> contains. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5qubitE">
+<span class="target" id="qudit_8h_1addd3b55f27803bd8ed9a66e354a951ee"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">qubit</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I_NSt6size_tEEN5cudaq5quditE" title="cudaq::qudit"><span class="n"><span class="pre">qudit</span></span></a><span class="p"><span class="pre">&lt;</span></span><span class="m"><span class="pre">2</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq5qubitE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+</section>
+<section id="common">
+<h2>Common<a class="headerlink" href="#common" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_resultE">
+<span class="target" id="classcudaq_1_1observe__result"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">observe_result</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq14observe_resultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1observe__result"><span class="std std-ref">observe_result</span></a> encapsulates all data generated from a cudaq”::”observe call. This includes all measurement counts from the execution of each ansatz + measure circuit, and the global expected value of the <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> passed to observe. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op">
+<span class="target" id="classcudaq_1_1observe__result_1aba859a67c28ee73dee0943043de4b419"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">observe_result</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">e</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">H</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the precomputed expectation value for &lt;psi(x) | H | psi(x)&gt; for the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result">
+<span class="target" id="classcudaq_1_1observe__result_1a0f3241a87d3924049763257e7f4caece"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">observe_result</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">e</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">H</span></span>, <a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">counts</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the precomputed expectation value for &lt;psi(x) | H | psi(x)&gt; for the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. If this execution was shots based, also provide the <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> data containing counts for each term in H. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_result8raw_dataEv">
+<span class="target" id="classcudaq_1_1observe__result_1a1220b104814b47514af78f957cd3a543"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">raw_data</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_result8raw_dataEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the raw counts data for all terms. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_resultcvdEv">
+<span class="target" id="classcudaq_1_1observe__result_1aa3bb86339bb588bdc812ae27c9e8eb8a"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_resultcvdEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Conversion operator for this <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1observe__result"><span class="std std-ref"><span class="pre">observe_result</span></span></a></code> to <code class="docutils literal notranslate"><span class="pre">double</span></code>. Simply returns the precomputed expectation value for the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. This enables one to ignore the fine-grain <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> data, and explicitly request the expected value: double exp = cudaq”::”observe(…); as opposed to cudaq”::”observe_data data = cudaq::observe(…); auto exp = data.expectation();. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_result11expectationEv">
+<span class="target" id="classcudaq_1_1observe__result_1af008438d29b9d0c567a6d471f5e6a843"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">expectation</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_result11expectationEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the expected value for the provided <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">SpinOpType</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1observe__result_1a3afd54ce62aa411173a1cb89d56d803d"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">expectation</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType" title="cudaq::observe_result::expectation::SpinOpType"><span class="n"><span class="pre">SpinOpType</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">term</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the expectation value for a sub-term in the provided <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">SpinOpType</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1observe__result_1a3a2c8f6b6ddeb50d33b7d8adbb101db5"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">counts</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType" title="cudaq::observe_result::counts::SpinOpType"><span class="n"><span class="pre">SpinOpType</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">term</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the counts data for the given <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a>. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>term</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_result14id_coefficientEv">
+<span class="target" id="classcudaq_1_1observe__result_1a3a21317de754b336ff177896783906b8"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">id_coefficient</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_result14id_coefficientEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the coefficient of the identity term. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14observe_result4dumpEv">
+<span class="target" id="classcudaq_1_1observe__result_1af43589c960a37f213670479486ae65f4"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14observe_result4dumpEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump the counts data to standard out. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContextE">
+<span class="target" id="classcudaq_1_1ExecutionContext"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionContext</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContextE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1ExecutionContext"><span class="std std-ref">ExecutionContext</span></a> is an abstraction to indicate how a CUDA-Q kernel should be executed. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a81f2130cf99da78739b73ef090e5d0d7"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionContext</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">n</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The Constructor, takes the name of the context. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>n</strong> – The name of the context </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a0154a84697873509b800fd83d932df61"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionContext</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">n</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">shots_</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes the name and the number of shots. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>n</strong> – The name of the context </p></li>
+<li><p><strong>shots_</strong> – The number of shots </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-members">Public Members</p>
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext4nameE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a76b9d8d9cb2b6edd033519c0c31232df"></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">name</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext4nameE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The name of the context ({basic, sampling, observe}) </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext5shotsE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a427fb572338e5d8917ff37e0da27c70b"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">shots</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext5shotsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The number of execution shots. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext4spinE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a5a1a666610ce7feeaa990de0c77cb244"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">spin</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext4spinE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>An optional spin operator. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext6resultE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a427813b94672a42814459459e30e0930"></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">result</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext6resultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Measurement counts for a CUDA-Q kernel invocation. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext16expectationValueE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a6eefeeea0be24e461e56eb8150004cb9"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">expectationValue</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">nullopt</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext16expectationValueE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A computed expectation value. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext9optResultE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a7a508d29f07472fa255e3193ef3281dc"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq19optimization_resultE" title="cudaq::optimization_result"><span class="n"><span class="pre">optimization_result</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">optResult</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">nullopt</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext9optResultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>An optimization result. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext31hasConditionalsOnMeasureResultsE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a642d36be68417213256b572f0ba180cb"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">hasConditionalsOnMeasureResults</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext31hasConditionalsOnMeasureResultsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The kernel being executed in this context has conditional statements on measure results. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext10noiseModelE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1aae5795038c44595b2af0b3297b2ef7c7"></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq11noise_modelE" title="cudaq::noise_model"><span class="n"><span class="pre">noise_model</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="sig-name descname"><span class="n"><span class="pre">noiseModel</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">nullptr</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext10noiseModelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Noise model to apply to the current execution. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext16canHandleObserveE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a2d9c2a355ea502e92b23a03ed2913005"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">canHandleObserve</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext16canHandleObserveE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Flag to indicate if backend can handle <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> observe task under this <a class="reference internal" href="#classcudaq_1_1ExecutionContext"><span class="std std-ref">ExecutionContext</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext9asyncExecE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a7bd212c313ec3a8800ad6193af5845c6"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">asyncExec</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext9asyncExecE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Flag indicating that the current execution should occur asynchronously. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext12futureResultE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a53330c89e4b1c462523dabe7edc6b696"></span><a class="reference internal" href="#_CPPv4N5cudaq7detailsE" title="cudaq::details"><span class="n"><span class="pre">details</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7details6futureE" title="cudaq::details::future"><span class="n"><span class="pre">future</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">futureResult</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext12futureResultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>When execution asynchronously, store the expected results as a cudaq::future here. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext15simulationStateE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1ad9af730512e65f603c4060850017f2a3"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">unique_ptr</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">simulationState</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext15simulationStateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Pointer to simulation-specific simulation data. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext13amplitudeMapsE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a225ca6c6264dc4bab3ebffd1d23252c5"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">map</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">int</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">amplitudeMaps</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext13amplitudeMapsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A map of basis-state amplitudes. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext20overlapComputeStatesE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1aa33674ead54268a410e60557fdaeb8e0"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">overlapComputeStates</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext20overlapComputeStatesE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>List of pairs of states to compute the overlap. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext13overlapResultE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a82f52405385514432d039465fde1ddee"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">overlapResult</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext13overlapResultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Overlap results. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext11kernelTraceE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a832079b8beaec29c27462f27704d6386"></span><a class="reference internal" href="#_CPPv4N5cudaq5TraceE" title="cudaq::Trace"><span class="n"><span class="pre">Trace</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kernelTrace</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext11kernelTraceE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>When run under the tracer context, persist the traced quantum resources here. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext10kernelNameE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a2c25b49d493c82f6a0660d0a41af6ea6"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kernelName</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="s"><span class="pre">&quot;&quot;</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext10kernelNameE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The name of the kernel being executed. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext14batchIterationE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a0c0571f6674fe3e6af79fd064d828cb6"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">batchIteration</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext14batchIterationE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The current iteration for a batch execution, used by observe_n and sample_n. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext15totalIterationsE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a688a9bdfda43ff68bb48124bedf6a9f4"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">totalIterations</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext15totalIterationsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>For batch execution, the total number of batch iterations. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext13registerNamesE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1aff429589472a75c69a48edd06ced97d6"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">registerNames</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext13registerNamesE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>For mid-circuit measurements in library mode keep track of the register names. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext10reorderIdxE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a33d991dd8e3d37e040eb8fc625228c19"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">reorderIdx</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext10reorderIdxE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A vector containing information about how to reorder the global register after execution. Empty means no reordering. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16ExecutionContext22invocationResultBufferE">
+<span class="target" id="classcudaq_1_1ExecutionContext_1a2cbc25e01de0353f7909f3e434cb2065"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">char</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">invocationResultBuffer</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16ExecutionContext22invocationResultBufferE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A buffer containing the return value of a kernel invocation. Note: this is only needed for invocation not able to return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref"><span class="pre">sample_result</span></span></a></code>. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details6futureE">
+<span class="target" id="classcudaq_1_1details_1_1future"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">future</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq7details6futureE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The future type models the expected result of a CUDA-Q kernel execution under a specific execution context. This type is returned from asynchronous execution calls. It encapsulates the job-specific circuit execution identifiers, the name of the <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> the job executed on, and any extra configuration information needed to retrieve the results later from the server. This type can be persisted to file and read in later to retrieve execution results. It also optionally wraps a std::future&lt;T&gt; type, and in this case, persistence to file is not allowed, .get() must be invoked at some later point within the same runtime context. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details6future6futureEv">
+<span class="target" id="classcudaq_1_1details_1_1future_1a8a3afaa7207cba1092a88568d2bc2d14"></span><span class="sig-name descname"><span class="n"><span class="pre">future</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq7details6future6futureEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details6future6futureERR6future">
+<span class="target" id="classcudaq_1_1details_1_1future_1aefd8a6533355358a082435396fe3a56a"></span><span class="sig-name descname"><span class="n"><span class="pre">future</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq7details6future6futureERR6future" title="cudaq::details::future::future"><span class="n"><span class="pre">future</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq7details6future6futureERR6future" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>move constructor </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE">
+<span class="target" id="classcudaq_1_1details_1_1future_1a19fc0a152a0df1e22d915f170c4e84d8"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">future</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">Job</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">_jobs</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">qpuNameIn</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">map</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">config</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes all info required to be able to retrieve results at a later date, even after file persistence. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq12async_resultE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">T</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1async__result"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">async_result</span></span></span><a class="headerlink" href="#_CPPv4I0EN5cudaq12async_resultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>the <a class="reference internal" href="#classcudaq_1_1async__result"><span class="std std-ref">async_result</span></a> type is a user facing, future-like type that is returned from CUDA-Q public asynchronous API functions. It wraps a <a class="reference internal" href="#classcudaq_1_1details_1_1future"><span class="std std-ref">details::future</span></a> type, which can itself be constructed from a std::future or a collection of data pertinent to remote <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> REST invocation. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq12async_result3getEv">
+<span class="target" id="classcudaq_1_1async__result_1a0c48022f940cc2ed79ce4598636f1305"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I0EN5cudaq12async_resultE" title="cudaq::async_result::T"><span class="n"><span class="pre">T</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq12async_result3getEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the asynchronously computed data, will wait until the data is ready. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp struct">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResultE">
+<span class="target" id="structcudaq_1_1ExecutionResult"></span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> models the result of a typical quantum state sampling task. It will contain the observed measurement bit strings and corresponding number of times observed, as well as an expected value with respect to the Z…Z operator. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq15ExecutionResult9serializeEv">
+<span class="target" id="structcudaq_1_1ExecutionResult_1acaf9ec8da53554bd1b695843cf91cd88"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">serialize</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq15ExecutionResult9serializeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Serialize this sample result to a vector of integers. Encoding: 1st element is size of the register name N, then next N represent register name, next is the number of bitstrings M, then for each bit string a triple {string mapped to long, bit string length, count}. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult11deserializeERNSt6vectorINSt6size_tEEE">
+<span class="target" id="structcudaq_1_1ExecutionResult_1aa0fe4b59ed066f031e1064f1f5d8f8f7"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">deserialize</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">data</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult11deserializeERNSt6vectorINSt6size_tEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Deserialize a vector of integers to a <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>data</strong> – The data with encoding discussed in the brief for <code class="docutils literal notranslate"><span class="pre">serialize</span></code>. </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultEv">
+<span class="target" id="structcudaq_1_1ExecutionResult_1ae497123925b5f7dc7ef428b74ef88253"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionary">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a401208ff36537998547f2d5ade549529"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">CountsDictionary</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">c</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionary" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct from a CountsDictionary, assumes registerName == <strong>global</strong> </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>c</strong> – the counts </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultENSt6stringE">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a39c076328f75a06d1c3b3eb09507ed7c"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">name</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultENSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct from a register name. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultEd">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a2a6967f366c85814d8f85b5c566975b7"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">expVal</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct from a precomputed expectation value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a42e857f1f0c7fe45151f08dba075433a"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">CountsDictionary</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">c</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">name</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct from a <code class="docutils literal notranslate"><span class="pre">CountsDictionary</span></code>, specify the register name. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>c</strong> – the counts </p></li>
+<li><p><strong>name</strong> – the register name </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd">
+<span class="target" id="structcudaq_1_1ExecutionResult_1adb4703d48e39256d9f6cd53f0116f426"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">CountsDictionary</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">c</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">e</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Construct from a <code class="docutils literal notranslate"><span class="pre">CountsDictionary</span></code> and expected value. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>c</strong> – The counts </p></li>
+<li><p><strong>e</strong> – The precomputed expected value </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a87a8487490ca376b5501753b0deb5cbc"></span><span class="sig-name descname"><span class="n"><span class="pre">ExecutionResult</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult" title="cudaq::ExecutionResult::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy constructor. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>other</strong> – </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResultaSERK15ExecutionResult">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a46de0f6522e69f94787afb745768b0b8"></span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResultaSERK15ExecutionResult" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set this <a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref">ExecutionResult</span></a> equal to the provided one. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>other</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq15ExecutionResulteqERK15ExecutionResult">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a279c6d2312fd6805f8a8dabc746cd2e0"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">==</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">result</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq15ExecutionResulteqERK15ExecutionResult" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if the given <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> is the same as this one. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>result</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE">
+<span class="target" id="structcudaq_1_1ExecutionResult_1aeacb5c5af18a345820c72c95b56891a2"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">appendResult</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">bitString</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">count</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Append the bitstring and count to this <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>bitString</strong> – </p></li>
+<li><p><strong>count</strong> – </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-members">Public Members</p>
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult12registerNameE">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a246582d8c877dd21fe814b467bc7ee25"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">registerName</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult12registerNameE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Register name for the classical bits. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15ExecutionResult14sequentialDataE">
+<span class="target" id="structcudaq_1_1ExecutionResult_1a9d8a73796ba7990851dec099bcfb5997"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">sequentialData</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15ExecutionResult14sequentialDataE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Sequential bit strings observed (not collated into a map) </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_resultE">
+<span class="target" id="classcudaq_1_1sample__result"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq13sample_resultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> abstraction wraps a set of <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code>s for a single quantum kernel execution under the sampling or observation <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1ExecutionContext"><span class="std std-ref"><span class="pre">ExecutionContext</span></span></a></code>. Each <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> is mapped to a register name, with a default <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> with name <strong>global</strong> representing the observed measurement results holistically for the quantum kernel. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13sample_resultEv">
+<span class="target" id="classcudaq_1_1sample__result_1ae8f611495ea923027a4008a4da8019a8"></span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13sample_resultEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Nullary constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13sample_resultERR15ExecutionResult">
+<span class="target" id="classcudaq_1_1sample__result_1ab6d5dd37a325832f89d8ee70130d6b80"></span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">result</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13sample_resultERR15ExecutionResult" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, sets the <strong>global</strong> sample result. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13sample_resultER15ExecutionResult">
+<span class="target" id="classcudaq_1_1sample__result_1a3435574a1e7adc5b540aa13649e4c202"></span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">result</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13sample_resultER15ExecutionResult" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, sets the <strong>global</strong> sample result. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>result</strong> – </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13sample_resultERNSt6vectorI15ExecutionResultEE">
+<span class="target" id="classcudaq_1_1sample__result_1a85b8eb7d587ab955167da8757b9e2337"></span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">results</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13sample_resultERNSt6vectorI15ExecutionResultEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, appends all provided <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code>s. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE">
+<span class="target" id="classcudaq_1_1sample__result_1adbab6e399339691a0c26c97fc0f5157f"></span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">preComputedExp</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">results</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes a precomputed expectation value and stores it with the <code class="docutils literal notranslate"><span class="pre">__global__</span></code> <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13sample_resultERK13sample_result">
+<span class="target" id="classcudaq_1_1sample__result_1aa4a1bd43b9b18cca2ef7a722ab6f8697"></span><span class="sig-name descname"><span class="n"><span class="pre">sample_result</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13sample_result13sample_resultERK13sample_result" title="cudaq::sample_result::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13sample_resultERK13sample_result" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy Constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_resultD0Ev">
+<span class="target" id="classcudaq_1_1sample__result_1adc32e8aaef0e8a7cd2a542c63c8c1ae6"></span><span class="sig-name descname"><span class="n"><span class="pre">~sample_result</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq13sample_resultD0Ev" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The destructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result15has_expectationEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a4289ace00d8ea97a2448491c4754fc67"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">has_expectation</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result15has_expectationEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if the <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> with the specified register name has a precomputed expectation value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result6appendER15ExecutionResult">
+<span class="target" id="classcudaq_1_1sample__result_1ad4f5a8c72c564a51709e426cb8ffafd4"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">append</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq15ExecutionResultE" title="cudaq::ExecutionResult"><span class="n"><span class="pre">ExecutionResult</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">result</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result6appendER15ExecutionResult" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add another <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref"><span class="pre">ExecutionResult</span></span></a></code> to this <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref"><span class="pre">sample_result</span></span></a></code>. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>result</strong> – </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result14register_namesEv">
+<span class="target" id="classcudaq_1_1sample__result_1acf4d522001068f239b866577b2f66cb6"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">register_names</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result14register_namesEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return all register names. Can be used in tandem with sample_result::to_map(regName : string) to retrieve the counts for each register. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_resultaSER13sample_result">
+<span class="target" id="classcudaq_1_1sample__result_1a8073f38162b3cc1fa4a11ccaae13e222"></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">counts</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_resultaSER13sample_result" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> equal to the provided one. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>counts</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_resultpLERK13sample_result">
+<span class="target" id="classcudaq_1_1sample__result_1a1c46b862576afe8241e79ab0fdb6b278"></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">+=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_resultpLERK13sample_result" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Append all the data from other to this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a>. Merge when necessary. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>other</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result9serializeEv">
+<span class="target" id="classcudaq_1_1sample__result_1a2bcff2b0f3cb9f46167643523308fc6b"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">serialize</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result9serializeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Serialize this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a>. See <code class="docutils literal notranslate"><a class="reference internal" href="#structcudaq_1_1ExecutionResult_1acaf9ec8da53554bd1b695843cf91cd88"><span class="std std-ref"><span class="pre">ExecutionResult::serialize()</span></span></a></code> documentation for information. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result11deserializeERNSt6vectorINSt6size_tEEE">
+<span class="target" id="classcudaq_1_1sample__result_1a5504a7067b1c3df42f4a86cdf4fba742"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">deserialize</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">data</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result11deserializeERNSt6vectorINSt6size_tEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Create this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> from the serialized data. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>data</strong> – </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_resulteqERK13sample_result">
+<span class="target" id="classcudaq_1_1sample__result_1af4d503a2b4753ef79760e96ad3e75039"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">==</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">counts</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_resulteqERK13sample_result" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> is the same as the given one. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>counts</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result11expectationEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a41787cee42b2648000f64dde69700171"></span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">expectation</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result11expectationEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the expected value &lt;Z…Z&gt; </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result9exp_val_zEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1aac21a1dd74311c9da0af96104e23fd51"></span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">exp_val_z</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result9exp_val_zEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Deprecated: Return the expected value &lt;Z…Z&gt; </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1ab0254228518d127b6d8c0dae37a5b7cb"></span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">probability</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">bitString</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the probability of observing the given bit string. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>bitString</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result13most_probableEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a87107f8bedab62a4cc94823b4a244ac5"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">most_probable</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result13most_probableEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the most probable bit string. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>registerName</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a3397619ea681dfe67f30b5d9627a05e4"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">count</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">bitString</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of times the given bitstring was observed. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>bitString</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result4sizeEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a892be2a88dec700cb2ad80c948d459dc"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">size</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">noexcept</span></span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result4sizeEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of observed bit strings. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result4dumpEv">
+<span class="target" id="classcudaq_1_1sample__result_1a2d4334a130fa2366c646308009cd87c5"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result4dumpEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> to standard out. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result4dumpERNSt7ostreamE">
+<span class="target" id="classcudaq_1_1sample__result_1a111c891c53b2e3c09a2dc8d3a2dfe381"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">os</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result4dumpERNSt7ostreamE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> to the given output stream. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result5clearEv">
+<span class="target" id="classcudaq_1_1sample__result_1a3caca71867a11d885f5deb13fe4a6d0c"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clear</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result5clearEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Clear this <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result6to_mapEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a0a60737d23dbfdf816e2c2e2cf79478e"></span><span class="n"><span class="pre">CountsDictionary</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">to_map</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result6to_mapEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Extract the ExecutionResults as a std::unordered&lt;string, size_t&gt; map. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>registerName</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1ad8e018d850d54e543bf3e7aa49256e62"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_marginal</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">marginalIndices</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Extract marginal counts, that is those counts for a subset of measured qubits. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>marginalIndices</strong> – The qubit indices as an <code class="docutils literal notranslate"><span class="pre">rvalue</span></code> </p></li>
+<li><p><strong>registerName</strong> – </p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1a8629fa9d4639eb03fa89a4671611ecb6"></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_marginal</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">marginalIndices</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Extract marginal counts, that is those counts for a subset of measured qubits. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>marginalIndices</strong> – The qubit indices as an reference </p></li>
+<li><p><strong>registerName</strong> – </p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1af47dab420f03957899761a4c98ed8d7f"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">reorder</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">index</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">registerName</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">GlobalRegisterName</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Reorder the bits in an <a class="reference internal" href="#structcudaq_1_1ExecutionResult"><span class="std std-ref">ExecutionResult</span></a>. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>index</strong> – Vector of indices such that <code class="docutils literal notranslate"><span class="pre">newBitStr(:)=oldBitStr(index(:))</span></code> </p></li>
+<li><p><strong>registerName</strong> – register name to process (defaults to global) </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result5beginEv">
+<span class="target" id="classcudaq_1_1sample__result_1a48c579a0025b54f83244d46f56de888d"></span><span class="n"><span class="pre">CountsDictionary</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">iterator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">begin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result5beginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Range-based iterator begin function. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result3endEv">
+<span class="target" id="classcudaq_1_1sample__result_1a7583d8f9a5149f591cc662f28f761a09"></span><span class="n"><span class="pre">CountsDictionary</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">iterator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">end</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result3endEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Range-based iterator end function. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result6cbeginEv">
+<span class="target" id="classcudaq_1_1sample__result_1a975023596652b87e6786fbfe2141facd"></span><span class="n"><span class="pre">CountsDictionary</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">const_iterator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">cbegin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result6cbeginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Range-based constant iterator begin function. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result4cendEv">
+<span class="target" id="classcudaq_1_1sample__result_1a0ee5a30d7055959acf917d58532a3800"></span><span class="n"><span class="pre">CountsDictionary</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">const_iterator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">cend</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result4cendEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Range-based constant iterator end function. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result5beginEv">
+<span class="target" id="classcudaq_1_1sample__result_1a8aab3104495d16b9663c9f0b13147ca6"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">CountsDictionary</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">const_iterator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">begin</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result5beginEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Range-based constant iterator begin function. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13sample_result3endEv">
+<span class="target" id="classcudaq_1_1sample__result_1a275bb2f44328b76376b706e742512a13"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">CountsDictionary</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">const_iterator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">end</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13sample_result3endEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Range-based constant iterator end function. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-static-functions">Public Static Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13sample_result15has_even_parityENSt11string_viewE">
+<span class="target" id="classcudaq_1_1sample__result_1ac3543c7649c64439ea15aba613223b35"></span><span class="k"><span class="pre">static</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">has_even_parity</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string_view</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">bitString</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13sample_result15has_even_parityENSt11string_viewE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if the bit string has even parity. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>bitString</strong> – </p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15SimulationStateE">
+<span class="target" id="classcudaq_1_1SimulationState"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">SimulationState</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15SimulationStateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1SimulationState"><span class="std std-ref"><span class="pre">SimulationState</span></span></a></code> interface provides and extension point for concrete circuit simulation sub-types to describe their underlying quantum state data in an efficient manner. The <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1SimulationState"><span class="std std-ref"><span class="pre">SimulationState</span></span></a></code> provides a handle on the data for clients, with data remaining on GPU device or CPU memory. The primary goal of this type and its sub-types is to minimize data transfers for the state. </p>
+<p>Subclassed by <a class="reference internal" href="#classcudaq_1_1CusvState"><span class="std std-ref">cudaq::CusvState&lt; ScalarType &gt;</span></a>, <a class="reference internal" href="#classcudaq_1_1RemoteSimulationState"><span class="std std-ref">cudaq::RemoteSimulationState</span></a>, <a class="reference internal" href="#classnvqir_1_1MPSSimulationState"><span class="std std-ref">nvqir::MPSSimulationState</span></a>, <a class="reference internal" href="#classnvqir_1_1TensorNetSimulationState"><span class="std std-ref">nvqir::TensorNetSimulationState</span></a></p>
+</dd></dl>
+
+<dl class="cpp struct">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15SimulationState6TensorE">
+<span class="target" id="structcudaq_1_1SimulationState_1_1Tensor"></span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Tensor</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15SimulationState6TensorE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Simulation states are made up of a vector of Tensors. Each tensor tracks its data pointer and the tensor extents. </p>
+</dd></dl>
+
+<dl class="cpp enum-class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15SimulationState9precisionE">
+<span class="target" id="classcudaq_1_1SimulationState_1a3fd90ce5445534e830b461b43b3dcf2f"></span><span class="k"><span class="pre">enum</span></span><span class="w"> </span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">precision</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15SimulationState9precisionE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Runtime-known precision for the simulation data. </p>
+<p><em>Values:</em></p>
+<dl class="cpp enumerator">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15SimulationState9precision4fp32E">
+<span class="target" id="classcudaq_1_1SimulationState_1a3fd90ce5445534e830b461b43b3dcf2fa4e1bd87474ad81110395b71013094b35"></span><span class="k"><span class="pre">enumerator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">fp32</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15SimulationState9precision4fp32E" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp enumerator">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15SimulationState9precision4fp64E">
+<span class="target" id="classcudaq_1_1SimulationState_1a3fd90ce5445534e830b461b43b3dcf2fa36dd759373a12bd5960718d0c482a2d4"></span><span class="k"><span class="pre">enumerator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">fp64</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq15SimulationState9precision4fp64E" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+</dd></dl>
+
+<dl class="cpp enum-class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq20simulation_precisionE">
+<span class="target" id="host__config_8h_1ae727392959b51f54546b3bb55cfc31b5"></span><span class="k"><span class="pre">enum</span></span><span class="w"> </span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">simulation_precision</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq20simulation_precisionE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Define an enumeration of possible simulation floating point precision types. </p>
+<p><em>Values:</em></p>
+<dl class="cpp enumerator">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq20simulation_precision4fp32E">
+<span class="target" id="host__config_8h_1ae727392959b51f54546b3bb55cfc31b5a4e1bd87474ad81110395b71013094b35"></span><span class="k"><span class="pre">enumerator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">fp32</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq20simulation_precision4fp32E" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp enumerator">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq20simulation_precision4fp64E">
+<span class="target" id="host__config_8h_1ae727392959b51f54546b3bb55cfc31b5a36dd759373a12bd5960718d0c482a2d4"></span><span class="k"><span class="pre">enumerator</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">fp64</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq20simulation_precision4fp64E" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq6tensorE">
+<span class="target" id="qis_2state_8h_1a41df817a76288726556bc3340e71ee40"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">tensor</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationState6TensorE" title="cudaq::SimulationState::Tensor"><span class="n"><span class="pre">Tensor</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq6tensorE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15TensorStateDataE">
+<span class="target" id="SimulationState_8h_1a492cfc761cde8697c6e6263a23812c9e"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">TensorStateData</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq15TensorStateDataE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Encapsulates a list of tensors (data pointer and dimensions). </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10state_dataE">
+<span class="target" id="SimulationState_8h_1a4cec83b0c73799f1df02d25e49270ae2"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">state_data</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">variant</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">float</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">float</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq15TensorStateDataE" title="cudaq::TensorStateData"><span class="n"><span class="pre">TensorStateData</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq10state_dataE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>state_data is a variant type encoding different forms of user state vector data we support. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq9CusvStateE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ScalarType</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1CusvState"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">CusvState</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><a class="headerlink" href="#_CPPv4I0EN5cudaq9CusvStateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><a class="reference internal" href="#classcudaq_1_1CusvState"><span class="std std-ref">CusvState</span></a> provides an implementation of <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1SimulationState"><span class="std std-ref"><span class="pre">SimulationState</span></span></a></code> that encapsulates the state data for the Custatevec Circuit Simulator. It attempts to keep the simulation data on GPU device and care is taken to ensure operations and comparisons with other states operate on compatible floating point element types. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5nvqir18MPSSimulationStateE">
+<span class="target" id="classnvqir_1_1MPSSimulationState"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">MPSSimulationState</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><a class="headerlink" href="#_CPPv4N5nvqir18MPSSimulationStateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5nvqir24TensorNetSimulationStateE">
+<span class="target" id="classnvqir_1_1TensorNetSimulationState"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">TensorNetSimulationState</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><a class="headerlink" href="#_CPPv4N5nvqir24TensorNetSimulationStateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq21RemoteSimulationStateE">
+<span class="target" id="classcudaq_1_1RemoteSimulationState"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">RemoteSimulationState</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq21RemoteSimulationStateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Implementation of <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1SimulationState"><span class="std std-ref"><span class="pre">SimulationState</span></span></a></code> for remote simulator backends. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq8registry14RegisteredTypeE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">T</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1registry_1_1RegisteredType"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">RegisteredType</span></span></span><a class="headerlink" href="#_CPPv4I0EN5cudaq8registry14RegisteredTypeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><a class="reference internal" href="#classcudaq_1_1registry_1_1RegisteredType"><span class="std std-ref">RegisteredType</span></a> allows interface types to declare themselves as plugin interfaces. Used as follows class MyInterface : public RegisteredType&lt;MyInterface&gt; {…};. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrixE">
+<span class="target" id="classcudaq_1_1complex__matrix"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">complex_matrix</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrixE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1complex__matrix"><span class="std std-ref">complex_matrix</span></a> provides an abstraction for describing a matrix with N rows and M columns containing complex elements. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1complex__matrix_1afc709728054288800d83c362714d7571"></span><span class="sig-name descname"><span class="n"><span class="pre">complex_matrix</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">rows</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">cols</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Create a matrix of the given sizes, all elements initialized to 0.0. The <a class="reference internal" href="#classcudaq_1_1complex__matrix"><span class="std std-ref">complex_matrix</span></a> owns the matrix data and will delete it upon destruction. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1complex__matrix_1a680edda8dad30affa4b28c83d6b49573"></span><span class="sig-name descname"><span class="n"><span class="pre">complex_matrix</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="cudaq::complex_matrix::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">rawData</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">rows</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">cols</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Create a matrix from an existing data pointer. The <a class="reference internal" href="#classcudaq_1_1complex__matrix"><span class="std std-ref">complex_matrix</span></a> does not own this memory and will not delete it upon destruction. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrix4dataEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1a807081f855a6780dfeda25627c1d9cae"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="cudaq::complex_matrix::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="sig-name descname"><span class="n"><span class="pre">data</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrix4dataEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the internal data representation. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrix4rowsEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1a46f26ea0e1b0ab761b8bc16a25dc753c"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">rows</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrix4rowsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of rows. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrix4colsEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1a7676167f15afd42963e189e96f1628f6"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">cols</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrix4colsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of columns. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrixmlER14complex_matrix">
+<span class="target" id="classcudaq_1_1complex__matrix_1a4bd641605635b405f6627f00198331f0"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrixE" title="cudaq::complex_matrix"><span class="n"><span class="pre">complex_matrix</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrixE" title="cudaq::complex_matrix"><span class="n"><span class="pre">complex_matrix</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrixmlER14complex_matrix" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply this matrix with the provided other matrix. This does not modify this matrix but instead returns a new matrix value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrixmlERNSt6vectorI10value_typeEE">
+<span class="target" id="classcudaq_1_1complex__matrix_1afc56d7e45004ac896d20f7b86aac63fb"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrixE" title="cudaq::complex_matrix"><span class="n"><span class="pre">complex_matrix</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="cudaq::complex_matrix::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrixmlERNSt6vectorI10value_typeEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply this matrix by a vector (A*x) such that x is provided as a std vector of the correct size. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE">
+<span class="target" id="classcudaq_1_1complex__matrix_1a83cebaf41d1000f8e92078eb9f4a5018"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="cudaq::complex_matrix::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">()</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">i</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">j</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the element at the row <code class="docutils literal notranslate"><span class="pre">i</span></code> and column <code class="docutils literal notranslate"><span class="pre">j</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrix18minimal_eigenvalueEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1ad4e60a0ac829f448a26f7f5e869e540b"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="cudaq::complex_matrix::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">minimal_eigenvalue</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrix18minimal_eigenvalueEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the minimal eigenvalue for this matrix. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrix11eigenvaluesEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1a9fdab2211e97c8a54f2df7a35e19190e"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="cudaq::complex_matrix::value_type"><span class="n"><span class="pre">value_type</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">eigenvalues</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrix11eigenvaluesEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return this matrix’s eigenvalues. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq14complex_matrix12eigenvectorsEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1a8c4268a30ace97758990c16f2c6e6e21"></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrixE" title="cudaq::complex_matrix"><span class="n"><span class="pre">complex_matrix</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">eigenvectors</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq14complex_matrix12eigenvectorsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the eigenvectors of this matrix. They are returned as the columns of a new matrix. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrix8set_zeroEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1aa6f1e9da2a940a56319d97723dd694b8"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">set_zero</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrix8set_zeroEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set all elements in this matrix to 0.0. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrix4dumpERNSt7ostreamE">
+<span class="target" id="classcudaq_1_1complex__matrix_1af7a3f8bb36d85f5714cde14105aa6463"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">os</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrix4dumpERNSt7ostreamE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Print this matrix to the given output stream. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrix4dumpEv">
+<span class="target" id="classcudaq_1_1complex__matrix_1aa024a067b22061a372f51114e4ca94ff"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrix4dumpEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Print this matrix to standard out. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5TraceE">
+<span class="target" id="classcudaq_1_1Trace"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Trace</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq5TraceE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A trace is a circuit representation of the executed computation, as seen by the execution manager. (Here, a circuit is represented as a list of instructions on qudits). Since the execution manager cannot “see” control flow, the trace of a kernel with control flow represents a single execution path, and thus two calls to the same kernel might produce traces. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ElementType</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_integral_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="o"><span class="pre">&amp;&amp;</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_signed_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="cudaq__utils_8h_1ab5c4da9827fd0d2f3575706bda49941c"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">range</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">N</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a vector of integers. The first element is zero, and the remaining elements are all values incremented by 1 to the total size value provided (exclusive). </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ElementType</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_integral_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="o"><span class="pre">&amp;&amp;</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_signed_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="cudaq__utils_8h_1aaf2865114850e54f70afe8b087297ce9"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">range</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">start</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">stop</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="cudaq::range::ElementType"><span class="n"><span class="pre">ElementType</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">step</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">1</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a vector of integers. The first element is the user-specified <code class="docutils literal notranslate"><span class="pre">start</span></code> value. The remaining values are all values incremented by <code class="docutils literal notranslate"><span class="pre">step</span></code> (defaults to 1) until the <code class="docutils literal notranslate"><span class="pre">stop</span></code> value is reached (exclusive). </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">Args</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_invocable_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args" title="cudaq::draw::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args" title="cudaq::draw::Args"><span class="n"><span class="pre">Args</span></span></a><span class="p"><span class="pre">...</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="draw_8h_1a3aa261b1dafc10d75e7fb62c84243b5c"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">draw</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args" title="cudaq::draw::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args" title="cudaq::draw::Args"><span class="n"><span class="pre">Args</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">...</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">args</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns a drawing of the execution path, i.e., the trace, of the kernel. The drawing is a UTF-8 encoded string. </p>
+<p>
+Usage: <div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithms/draw.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+
+<span class="k">auto</span><span class="w"> </span><span class="n">bell_pair</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="p">};</span>
+<span class="p">...</span>
+<span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">draw</span><span class="p">(</span><span class="n">bell_pair</span><span class="p">);</span>
+<span class="cm">/* Output:</span>
+<span class="cm">     ╭───╮     </span>
+<span class="cm">q0 : ┤ h ├──●──</span>
+<span class="cm">     ╰───╯╭─┴─╮</span>
+<span class="cm">q1 : ─────┤ x ├</span>
+<span class="cm">          ╰───╯</span>
+<span class="cm">*/</span>
+
+<span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">float</span><span class="w"> </span><span class="n">angle</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="p">};</span>
+<span class="p">...</span>
+<span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="mf">0.59</span><span class="p">);</span>
+<span class="cm">/* Output:</span>
+<span class="cm">     ╭───╮╭──────────╮</span>
+<span class="cm">q0 : ┤ h ├┤ ry(0.59) ├</span>
+<span class="cm">     ╰───╯╰──────────╯</span>
+<span class="cm">*/</span><span class="w">      </span>
+</pre></div>
+</div>
+ </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> – The quantum callable with non-trivial function signature. </p></li>
+<li><p><strong>args</strong> – The arguments required for evaluation of the quantum kernel. </p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The UTF-8 encoded string of the circuit, without measurement operations.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9ResourcesE">
+<span class="target" id="classcudaq_1_1Resources"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Resources</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq9ResourcesE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1Resources"><span class="std std-ref">Resources</span></a> type encodes information regarding the currently executing kernel’s resource usage. This includes number and type of quantum operation, circuit depth, etc. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14complex_matrix10value_typeE">
+<span class="target" id="classcudaq_1_1complex__matrix_1ade050d2b1512d2fe61d2f69810419bc4"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq14complex_matrixE" title="cudaq::complex_matrix"><span class="n"><span class="pre">complex_matrix</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">value_type</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq14complex_matrix10value_typeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+</section>
+<section id="noise-modeling">
+<h2>Noise Modeling<a class="headerlink" href="#noise-modeling" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp struct">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_opE">
+<span class="target" id="structcudaq_1_1kraus__op"></span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kraus_op</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_opE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A <a class="reference internal" href="#structcudaq_1_1kraus__op"><span class="std std-ref">kraus_op</span></a> represents a single Kraus operation, described as a complex matrix of specific size. The matrix is represented here as a 1d array (specifically a std::vector). </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_op8kraus_opERK8kraus_op">
+<span class="target" id="structcudaq_1_1kraus__op_1a2f5c2b8930af146a4dbd3fadd7938fbc"></span><span class="sig-name descname"><span class="n"><span class="pre">kraus_op</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_op8kraus_opERK8kraus_op" title="cudaq::kraus_op::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_op8kraus_opERK8kraus_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_op8kraus_opENSt6vectorIN5cudaq7complexEEE">
+<span class="target" id="structcudaq_1_1kraus__op_1a14137e8fb637563b68c2353d2d6834cd"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kraus_op</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7complexE" title="cudaq::complex"><span class="n"><span class="pre">complex</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">d</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_op8kraus_opENSt6vectorIN5cudaq7complexEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, initialize from vector data. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">T</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="structcudaq_1_1kraus__op_1ae05531f8a2507a0397e13250c622d512"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kraus_op</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">initializer_list</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE" title="cudaq::kraus_op::kraus_op::T"><span class="n"><span class="pre">T</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">initList</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, initialize from initializer_list. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_opaSERK8kraus_op">
+<span class="target" id="structcudaq_1_1kraus__op_1ac7cdeb5fa87ffea343ea695710abb7a2"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_opaSERK8kraus_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set this <a class="reference internal" href="#structcudaq_1_1kraus__op"><span class="std std-ref">kraus_op</span></a> equal to the other. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq8kraus_op7adjointEv">
+<span class="target" id="structcudaq_1_1kraus__op_1a515b1d2dcfc3b07156eeee9ce394e706"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">adjoint</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq8kraus_op7adjointEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the adjoint of this <a class="reference internal" href="#structcudaq_1_1kraus__op"><span class="std std-ref">kraus_op</span></a>. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-members">Public Members</p>
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_op4dataE">
+<span class="target" id="structcudaq_1_1kraus__op_1a9ad38665040cf71ea3ce73d76ad4989a"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7complexE" title="cudaq::complex"><span class="n"><span class="pre">complex</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">data</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_op4dataE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Matrix data, represented as a 1d flattened. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_op5nRowsE">
+<span class="target" id="structcudaq_1_1kraus__op_1a6ae29957ac012da913831f2d3e8760a6"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">nRows</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_op5nRowsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The number of rows in the matrix. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8kraus_op5nColsE">
+<span class="target" id="structcudaq_1_1kraus__op_1a037b5b46c6f29c3b93c70ce35c899709"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">nCols</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq8kraus_op5nColsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The number of columns in the matrix NOTE we currently assume nRows == nCols. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channelE">
+<span class="target" id="classcudaq_1_1kraus__channel"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kraus_channel</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> represents a quantum noise channel on specific qubits. The action of the noise channel is described by a vector of Kraus operations - matrices with size equal to 2**nQubits x 2**nQubits, where the number of qubits is the number of provided qubit indices at construction. </p>
+<p>Subclassed by <a class="reference internal" href="#classcudaq_1_1amplitude__damping__channel"><span class="std std-ref">cudaq::amplitude_damping_channel</span></a>, <a class="reference internal" href="#classcudaq_1_1bit__flip__channel"><span class="std std-ref">cudaq::bit_flip_channel</span></a>, <a class="reference internal" href="#classcudaq_1_1depolarization__channel"><span class="std std-ref">cudaq::depolarization_channel</span></a>, <a class="reference internal" href="#classcudaq_1_1phase__flip__channel"><span class="std std-ref">cudaq::phase_flip_channel</span></a></p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channel13kraus_channelEv">
+<span class="target" id="classcudaq_1_1kraus__channel_1acdd8db7bacc17f9913d4b137cb323445"></span><span class="sig-name descname"><span class="n"><span class="pre">kraus_channel</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channel13kraus_channelEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The nullary constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel">
+<span class="target" id="classcudaq_1_1kraus__channel_1a5b4f645289e858e99a1e15d1d2e5794f"></span><span class="sig-name descname"><span class="n"><span class="pre">kraus_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel" title="cudaq::kraus_channel::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The copy constructor. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>other</strong> – </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">T</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1kraus__channel_1a78aab1847e17c4776ab2fb69ad82f5d9"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kraus_channel</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">initializer_list</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE" title="cudaq::kraus_channel::kraus_channel::T"><span class="n"><span class="pre">T</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">...</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">inputLists</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, initializes kraus_ops internally from the provided initializer_lists. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channel13kraus_channelERNSt6vectorI8kraus_opEE">
+<span class="target" id="classcudaq_1_1kraus__channel_1a1e8483e5f2a06bcebdd41012396d3de5"></span><span class="sig-name descname"><span class="n"><span class="pre">kraus_channel</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">ops</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channel13kraus_channelERNSt6vectorI8kraus_opEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, take qubits and channel kraus_ops as lvalue reference. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channel13kraus_channelERRNSt6vectorI8kraus_opEE">
+<span class="target" id="classcudaq_1_1kraus__channel_1ad31e6da920dad2e42f8564dc3552f776"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kraus_channel</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">ops</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channel13kraus_channelERRNSt6vectorI8kraus_opEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, take qubits and channel kraus_ops as rvalue reference. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13kraus_channel4sizeEv">
+<span class="target" id="classcudaq_1_1kraus__channel_1ab48189c8c25838c7c485b29291c2a5fa"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">size</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13kraus_channel4sizeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of kraus_ops that make up this channel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq13kraus_channel5emptyEv">
+<span class="target" id="classcudaq_1_1kraus__channel_1a2f5ef656cfdae14b49667813159c1965"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">empty</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq13kraus_channel5emptyEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if there are no ops in this channel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channelixEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1kraus__channel_1a082da012db5a565347714f1e8c9aab99"></span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">[]</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channelixEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the <a class="reference internal" href="#structcudaq_1_1kraus__op"><span class="std std-ref">kraus_op</span></a> at the given index. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channelaSERK13kraus_channel">
+<span class="target" id="classcudaq_1_1kraus__channel_1abfdcf9c8f4a943e938744863d6cb1d59"></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channelaSERK13kraus_channel" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set this <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> equal to the given one. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channel7get_opsEv">
+<span class="target" id="classcudaq_1_1kraus__channel_1ad86a7f7a00f7cea74d4d3ab684e32a35"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_ops</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channel7get_opsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return all kraus_ops in this channel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq13kraus_channel9push_backE8kraus_op">
+<span class="target" id="classcudaq_1_1kraus__channel_1a4c0ce018d87610e19c8783386211a6b9"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">push_back</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq8kraus_opE" title="cudaq::kraus_op"><span class="n"><span class="pre">kraus_op</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">op</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq13kraus_channel9push_backE8kraus_op" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add a <a class="reference internal" href="#structcudaq_1_1kraus__op"><span class="std std-ref">kraus_op</span></a> to this channel. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq25amplitude_damping_channelE">
+<span class="target" id="classcudaq_1_1amplitude__damping__channel"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">amplitude_damping_channel</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq25amplitude_damping_channelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><a class="reference internal" href="#classcudaq_1_1amplitude__damping__channel"><span class="std std-ref">amplitude_damping_channel</span></a> is a <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> that automates the creation of the kraus_ops that make up a single-qubit amplitude damping error channel. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16bit_flip_channelE">
+<span class="target" id="classcudaq_1_1bit__flip__channel"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">bit_flip_channel</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq16bit_flip_channelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><a class="reference internal" href="#classcudaq_1_1bit__flip__channel"><span class="std std-ref">bit_flip_channel</span></a> is a <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> that automates the creation of the kraus_ops that make up a single-qubit bit flipping error channel. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18phase_flip_channelE">
+<span class="target" id="classcudaq_1_1phase__flip__channel"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">phase_flip_channel</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq18phase_flip_channelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><a class="reference internal" href="#classcudaq_1_1phase__flip__channel"><span class="std std-ref">phase_flip_channel</span></a> is a <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> that automates the creation of the kraus_ops that make up a single-qubit phase flip error channel. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq22depolarization_channelE">
+<span class="target" id="classcudaq_1_1depolarization__channel"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">depolarization_channel</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq22depolarization_channelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p><a class="reference internal" href="#classcudaq_1_1depolarization__channel"><span class="std std-ref">depolarization_channel</span></a> is a <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> that automates the creation of the kraus_ops that make up a single-qubit depolarization error channel. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11noise_modelE">
+<span class="target" id="classcudaq_1_1noise__model"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">noise_model</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq11noise_modelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1noise__model"><span class="std std-ref">noise_model</span></a> type keeps track of a set of kraus_channels to be applied after the execution of quantum operations. Each quantum operation maps to a Kraus channel containing a number of kraus_ops to be applied to the density matrix representation of the state. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-types">Public Types</p>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11noise_model15PredicateFuncTyE">
+<span class="target" id="classcudaq_1_1noise__model_1aeb88e7dafa1e41c5925e30983b4eb36e"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">PredicateFuncTy</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="p"><span class="pre">(</span></span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq11noise_model15PredicateFuncTyE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Callback function type for noise channel. Given the qubit operands and gate parameters, this function should return a concrete noise channel. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11noise_model11noise_modelEv">
+<span class="target" id="classcudaq_1_1noise__model_1a5c366911696095b18a8bcf1c55fe1dac"></span><span class="sig-name descname"><span class="n"><span class="pre">noise_model</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq11noise_model11noise_modelEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>default constructor </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq11noise_model5emptyEv">
+<span class="target" id="classcudaq_1_1noise__model_1ae7a17c0d42e97d2750c9f2138e61b9d6"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">empty</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq11noise_model5emptyEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if there are no kraus_channels in this noise model. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel">
+<span class="target" id="classcudaq_1_1noise__model_1a179b0a307af0f9a056ce91852fd26e8d"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">add_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">quantumOp</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">qubits</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">channel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the Kraus channel to the specified one-qubit quantum operation. It applies to the quantumOp operation for the specified qubits in the <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy">
+<span class="target" id="classcudaq_1_1noise__model_1af62dda77eade243217de8a8a0959d8c0"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">add_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">quantumOp</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq11noise_model15PredicateFuncTyE" title="cudaq::noise_model::PredicateFuncTy"><span class="n"><span class="pre">PredicateFuncTy</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">pred</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the Kraus channel as a callback to the specified quantum operation. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>quantumOp</strong> – Quantum operation that the noise channel applies to. </p></li>
+<li><p><strong>pred</strong> – Callback function that generates a noise channel. </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli">
+<span class="target" id="classcudaq_1_1noise__model_1ae7127d90f75c57418d423d717a04abcf"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">add_all_qubit_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">quantumOp</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">channel</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">numControls</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the Kraus channel that applies to a quantum operation on any arbitrary qubits. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>quantumOp</strong> – Quantum operation that the noise channel applies to. </p></li>
+<li><p><strong>channel</strong> – The Kraus channel to apply. </p></li>
+<li><p><strong>numControls</strong> – Number of control qubits for the gate. Default is 0 (gate without a control modifier). </p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">QuantumOp</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1noise__model_1a4cd1510fa429dd4a3a51ce7364dc4c4d"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">add_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">qubits</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">channel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the provided <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> to all specified quantum operations. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">QuantumOp</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1noise__model_1a64a6ad51e15b64cce3970c4c6d27044e"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">add_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq11noise_model15PredicateFuncTyE" title="cudaq::noise_model::PredicateFuncTy"><span class="n"><span class="pre">PredicateFuncTy</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">pred</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the provided <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> callback to all specified quantum operations. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">QuantumOp</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1noise__model_1a5613f092904482de026ca4594e436341"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">add_all_qubit_channel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">channel</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">numControls</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add the provided <a class="reference internal" href="#classcudaq_1_1kraus__channel"><span class="std std-ref">kraus_channel</span></a> to all specified quantum operations applying on arbitrary qubits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE">
+<span class="target" id="classcudaq_1_1noise__model_1a49ca0172344eb9663fc818a3c4b68d7b"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_channels</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">quantumOp</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">targetQubits</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">controlQubits</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="p"><span class="pre">{</span></span><span class="p"><span class="pre">}</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">params</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="p"><span class="pre">{</span></span><span class="p"><span class="pre">}</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return relevant kraus_channels on the specified qubits for. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumOp</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1noise__model_1aab36695296be377853de07e763bccb93"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq13kraus_channelE" title="cudaq::kraus_channel"><span class="n"><span class="pre">kraus_channel</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_channels</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">targetQubits</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">controlQubits</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="p"><span class="pre">{</span></span><span class="p"><span class="pre">}</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">params</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="p"><span class="pre">{</span></span><span class="p"><span class="pre">}</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get all kraus_channels on the given qubits. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+</section>
+<section id="kernel-builder">
+<h2>Kernel Builder<a class="headerlink" href="#kernel-builder" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4IDpEN5cudaq14kernel_builderE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">Args</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1kernel__builder"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kernel_builder</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7detailsE" title="cudaq::details"><span class="n"><span class="pre">details</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7details19kernel_builder_baseE" title="cudaq::details::kernel_builder_base"><span class="n"><span class="pre">kernel_builder_base</span></span></a><a class="headerlink" href="#_CPPv4IDpEN5cudaq14kernel_builderE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder14kernel_builderERNSt6vectorIN7details17KernelBuilderTypeEEE">
+<span class="target" id="classcudaq_1_1kernel__builder_1abeef4b926dd7f39ec1264903d92be8a0"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kernel_builder</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq7detailsE" title="cudaq::details"><span class="n"><span class="pre">details</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7details17KernelBuilderTypeE" title="cudaq::details::KernelBuilderType"><span class="n"><span class="pre">KernelBuilderType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">types</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder14kernel_builderERNSt6vectorIN7details17KernelBuilderTypeEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes the input <code class="docutils literal notranslate"><span class="pre">KernelBuilderType</span></code>s which is used to create the MLIR function type. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder12getArgumentsEv">
+<span class="target" id="classcudaq_1_1kernel__builder_1a9da8c65636070b6e4d96a34792317819"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">auto</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="n"><span class="pre">getArguments</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder12getArgumentsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> arguments. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder11isArgStdVecENSt6size_tE">
+<span class="target" id="classcudaq_1_1kernel__builder_1a93e1e94ce81d273f342834d75ecfbe55"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">isArgStdVec</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder11isArgStdVecENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return <code class="docutils literal notranslate"><span class="pre">true</span></code> if the argument to the kernel is a <code class="docutils literal notranslate"><span class="pre">std::vector</span></code>, <code class="docutils literal notranslate"><span class="pre">false</span></code> otherwise. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder4nameEv">
+<span class="target" id="classcudaq_1_1kernel__builder_1a4b181a0f89e0c03025646fcc868f1d64"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">name</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder4nameEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the name of this kernel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder12getNumParamsEv">
+<span class="target" id="classcudaq_1_1kernel__builder_1a9b3e71aecd1f34f4f1ef30aa98a72b57"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getNumParams</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder12getNumParamsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of function arguments. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder6qallocEv">
+<span class="target" id="classcudaq_1_1kernel__builder_1ace7af6cc7bcb2e14f2b81aa23a256f83"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qalloc</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder6qallocEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> representing the allocated qubit. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder6qallocEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1kernel__builder_1a0233bdb257aa60a73b0eaee70fd2ab89"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qalloc</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">nQubits</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder6qallocEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> representing the allocated <code class="docutils literal notranslate"><span class="pre">QVec</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder6qallocE10QuakeValue">
+<span class="target" id="classcudaq_1_1kernel__builder_1a0d0bd9a759aaf3bbafae68d5ab78377e"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qalloc</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">size</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder6qallocE10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> representing the allocated <code class="docutils literal notranslate"><span class="pre">Veq</span></code>, size is from a pre-allocated size <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> or <code class="docutils literal notranslate"><span class="pre">BlockArgument</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder6qallocERNSt6vectorINSt7complexIdEEEE">
+<span class="target" id="classcudaq_1_1kernel__builder_1a1823a80e0f41cab9edcd403d39c3e219"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">qalloc</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">state</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder6qallocERNSt6vectorINSt7complexIdEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> representing the allocated quantum register, initialized to the given state vector, <code class="docutils literal notranslate"><span class="pre">state</span></code>.</p>
+<p>Note: input argument is a <em>true</em> reference here, the calling context has to own the data. Specifically, the builder object will capture variables by reference (implemented as a container of pointers for simplicity) but the builder does not create, own, or copy these vectors. This implies that if the captured vector goes out of scope before the kernel is invoked, the reference may contain garbage. This behavior is identical to a C++ lambda capture by reference. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder11constantValEd">
+<span class="target" id="classcudaq_1_1kernel__builder_1aaad4791d9bdb3ae7a855f8ea35defcc3"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">constantVal</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">val</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder11constantValEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref"><span class="pre">QuakeValue</span></span></a></code> representing the constant floating-point value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue">
+<span class="target" id="classcudaq_1_1kernel__builder_1a27162cfcecff29cb112fc946e98527b8"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">swap</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">first</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">second</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>SWAP operation for swapping the quantum states of two qubits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">mod</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_same_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue" title="cudaq::kernel_builder::swap::mod"><span class="n"><span class="pre">mod</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ctrl</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1kernel__builder_1ac2a97ab1f89609efc12dad9a77e6759c"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">swap</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">control</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">first</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">second</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>SWAP operation for performing a Fredkin gate between two qubits, based on the state of input <code class="docutils literal notranslate"><span class="pre">control</span></code> qubit/s. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">mod</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_same_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue" title="cudaq::kernel_builder::swap::mod"><span class="n"><span class="pre">mod</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ctrl</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1kernel__builder_1a2950291e3c57ed184cf5e7bcd4b61f35"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">swap</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">controls</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">first</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">second</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>SWAP operation for performing a Fredkin gate between two qubits, based on the state of an input vector of <code class="docutils literal notranslate"><span class="pre">controls</span></code>. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValueE">
+<span class="target" id="classcudaq_1_1QuakeValue"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuakeValue</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValueE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> is meant to provide a thin wrapper around an mlir::Value instance. These QuakeValues represent handles to function arguments and return values from MLIR Operations, specifically Quake Dialect operations. The <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> also exposes and algebraic API enabling one to negate, add, subtract, and multiply QuakeValues with each other as well as with primitive arithmetic types, e.g. double. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq10QuakeValue8getValueEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1a405ee59cc3ef467a1bcedac32012c8a9"></span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">Value</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getValue</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq10QuakeValue8getValueEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the actual MLIR Value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE">
+<span class="target" id="classcudaq_1_1QuakeValue_1a7fd98aad59579fb7df2a82ff298abf5c"></span><span class="sig-name descname"><span class="n"><span class="pre">QuakeValue</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ImplicitLocOpBuilder</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">builder</span></span>, <span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">Value</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes the builder and the value to wrap. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd">
+<span class="target" id="classcudaq_1_1QuakeValue_1a80819c12221b08a9746e9058bb32b013"></span><span class="sig-name descname"><span class="n"><span class="pre">QuakeValue</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ImplicitLocOpBuilder</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">builder</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">v</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes the builder and a constant double value, which will map to an arith::ConstantFloatOp Value. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue4dumpEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1a8244774853762e984d8cc17e49094951"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue4dumpEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump the <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> to standard out. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue4dumpERNSt7ostreamE">
+<span class="target" id="classcudaq_1_1QuakeValue_1aa07fe57eeb25b3e7119f00ddad8f40e2"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue4dumpERNSt7ostreamE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump the <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> to the given output stream. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue22canValidateNumElementsEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1acc754ef5c14737881caf8bc44d06a761"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">canValidateNumElements</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue22canValidateNumElementsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> of StdVecType can validate its number of unique elements. We cannot do this in the case of <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> extractions within for loops where we do not know the bounds of the loop. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1QuakeValue_1a4d77a06940f26f478b781b3f6b4672b9"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">slice</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">startIdx</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">count</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>For a subscriptable <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>, extract a sub set of the elements starting at the given startIdx and including the following count elements. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue4sizeEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1af7d27118ed68e75175ab7e7927e16000"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">size</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue4sizeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>For a <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> with type StdVec or Veq, return the size <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue12constantSizeEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1ab54c3d0ca18fc34f09e6e8f664cb6c67"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">constantSize</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue12constantSizeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the constant size of this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> if it is of Veq type. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue8isStdVecEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1a9a744ebbea0a51a5cda2f90684ab6ec8"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">isStdVec</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue8isStdVecEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> is of type StdVec. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValue19getRequiredElementsEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1af63960107eb641d65b04e0eff5889d68"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getRequiredElements</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValue19getRequiredElementsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>For a <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> of type StdVec, return the number of required elements, i.e. the number of unique extractions observed. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValueixEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1QuakeValue_1ad6347f7655d24d2b540783a91fef8274"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">[]</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValueixEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a new <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> when the current value is indexed, specifically for QuakeValues of type StdVecType and VeqType. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValueixERK10QuakeValue">
+<span class="target" id="classcudaq_1_1QuakeValue_1a055e4cc59ef7a83cffdf2a6d90d56060"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">[]</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValueixERK10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a new <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> when the current value is indexed, specifically for QuakeValues of type StdVecType and VeqType. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq10QuakeValuemiEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1a63a98bacfbe17a183206883f0f1b45f6"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">-</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq10QuakeValuemiEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the negation of this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuemlEKd">
+<span class="target" id="classcudaq_1_1QuakeValue_1a24abc47f5ce02e98717d349e8d3e3094"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuemlEKd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> by the given double. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuemlE10QuakeValue">
+<span class="target" id="classcudaq_1_1QuakeValue_1ac30ca2eea7293d25ae0126503b6fd002"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">*</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuemlE10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Multiply this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> by the given <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuedvEKd">
+<span class="target" id="classcudaq_1_1QuakeValue_1ab3a2057299dd94693dd8d32a1b48061f"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">/</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuedvEKd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Divide this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> by the given double. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuedvE10QuakeValue">
+<span class="target" id="classcudaq_1_1QuakeValue_1a8a34931fe0357e9072cb0abfd9cfd2ac"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">/</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuedvE10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Divide this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> by the given <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValueplEKd">
+<span class="target" id="classcudaq_1_1QuakeValue_1a32e330261b099d9e58cefda0f9ab95d3"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">+</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValueplEKd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> with the given double. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValueplEKi">
+<span class="target" id="classcudaq_1_1QuakeValue_1a760df950070c0dba099a48f42f65e030"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">+</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">int</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValueplEKi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> with the given int. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValueplE10QuakeValue">
+<span class="target" id="classcudaq_1_1QuakeValue_1a75db83861eb822ab9daebedaa08b0afa"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">+</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValueplE10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Add this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> with the given <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuemiEKd">
+<span class="target" id="classcudaq_1_1QuakeValue_1afc857a20787542c9c802952cdc5a9e38"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">-</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuemiEKd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Subtract the given double from this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuemiEKi">
+<span class="target" id="classcudaq_1_1QuakeValue_1a9048069e1023244e4a5200ddd82fcc71"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">-</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">int</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuemiEKi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Subtract the given int from this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq10QuakeValuemiE10QuakeValue">
+<span class="target" id="classcudaq_1_1QuakeValue_1acdaddb1a8d5f3c8608a50e5ebbc3bca6"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">-</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq10QuakeValuemiE10QuakeValue" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Subtract the given <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a> from this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq10QuakeValue7inverseEv">
+<span class="target" id="classcudaq_1_1QuakeValue_1a68fb96c779ac2645503c6aaf72322675"></span><a class="reference internal" href="#_CPPv4N5cudaq10QuakeValueE" title="cudaq::QuakeValue"><span class="n"><span class="pre">QuakeValue</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">inverse</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq10QuakeValue7inverseEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the inverse (1/x) of this <a class="reference internal" href="#classcudaq_1_1QuakeValue"><span class="std std-ref">QuakeValue</span></a>. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details19kernel_builder_baseE">
+<span class="target" id="classcudaq_1_1details_1_1kernel__builder__base"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">kernel_builder_base</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq7details19kernel_builder_baseE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1details_1_1kernel__builder__base"><span class="std std-ref"><span class="pre">kernel_builder_base</span></span></a></code> provides a base type for the templated kernel builder so that we can get a single handle on an instance within the runtime. </p>
+<p>Subclassed by <a class="reference internal" href="#classcudaq_1_1kernel__builder"><span class="std std-ref">cudaq::kernel_builder&lt; Args &gt;</span></a></p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-friends">Friends</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base">
+<span class="target" id="classcudaq_1_1details_1_1kernel__builder__base_1a3b4d8b805718a31695e63c798775ab55"></span><span class="k"><span class="pre">friend</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">&lt;&lt;</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">stream</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7details19kernel_builder_baseE" title="cudaq::details::kernel_builder_base"><span class="n"><span class="pre">kernel_builder_base</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">builder</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Write the <a class="reference internal" href="#classcudaq_1_1kernel__builder"><span class="std std-ref">kernel_builder</span></a> to the given output stream. This outputs the Quake representation. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details17KernelBuilderTypeE">
+<span class="target" id="classcudaq_1_1details_1_1KernelBuilderType"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelBuilderType</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq7details17KernelBuilderTypeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <code class="docutils literal notranslate"><span class="pre">kernel_builder::Type</span></code> allows us to track input C++ types representing the quake function argument types in a way that does not expose MLIR Type to the CUDA-Q code. This type keeps track of a functor that generates the MLIR Type in implementation code when <a class="reference internal" href="#classcudaq_1_1details_1_1KernelBuilderType_1ae62efe009d225bfc935230fd0d74fca7"><span class="std std-ref">create()</span></a> is invoked. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details17KernelBuilderType17KernelBuilderTypeERRNSt8functionIFN4mlir4TypeEPN4mlir11MLIRContextEEEE">
+<span class="target" id="classcudaq_1_1details_1_1KernelBuilderType_1a4dadceff6c1aaa5620aa246e037c4856"></span><span class="sig-name descname"><span class="n"><span class="pre">KernelBuilderType</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">Type</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">MLIRContext</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">ctx</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">f</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7details17KernelBuilderType17KernelBuilderTypeERRNSt8functionIFN4mlir4TypeEPN4mlir11MLIRContextEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, take the Type generation functor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7details17KernelBuilderType6createEPN4mlir11MLIRContextE">
+<span class="target" id="classcudaq_1_1details_1_1KernelBuilderType_1ae62efe009d225bfc935230fd0d74fca7"></span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">Type</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">create</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">mlir</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">MLIRContext</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">ctx</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq7details17KernelBuilderType6createEPN4mlir11MLIRContextE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Create the MLIR Type. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+</section>
+<section id="algorithms">
+<h2>Algorithms<a class="headerlink" href="#algorithms" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9optimizerE">
+<span class="target" id="classcudaq_1_1optimizer"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">optimizer</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq9optimizerE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1optimizer"><span class="std std-ref">cudaq::optimizer</span></a> provides a high-level interface for general optimization of user-specified objective functions. This is meant to serve an interface for clients working with concrete subtypes providing specific optimization algorithms possibly delegating to third party libraries. This interface provides an optimize(…) method that takes the number of objective function input parameters (the dimension), and a user-specified objective function that takes the function input parameters as a immutable (<code class="docutils literal notranslate"><span class="pre">const</span></code>) vector&lt;double&gt; reference and a mutable vector&lt;double&gt; reference modeling the current iteration gradient vector (dF / dx_i, for all i parameters). This function must return a scalar double, the value of this function at the current input parameters. The optimizer also exposes a method for querying whether the current optimization strategy requires gradients or not. Parameterizing optimization strategies is left as a task for sub-types (things like initial parameters, max function evaluations, etc.).</p>
+<p><div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">optimizers</span><span class="o">::</span><span class="n">cobyla</span><span class="w"> </span><span class="n">opt</span><span class="p">;</span>
+<span class="n">assert</span><span class="p">(</span><span class="o">!</span><span class="n">opt</span><span class="p">.</span><span class="n">requiresGradients</span><span class="p">()</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="s">&quot;Cobyla algo does not use gradients.&quot;</span><span class="p">);</span>
+<span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">opt_val</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">opt</span><span class="p">.</span><span class="n">optimize</span><span class="p">(</span><span class="mi">2</span><span class="p">,</span>
+<span class="w">              </span><span class="p">[</span><span class="o">&amp;</span><span class="p">](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">dx</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">                  </span><span class="p">...</span><span class="w"> </span><span class="n">use</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">modify</span><span class="w"> </span><span class="n">dx</span><span class="p">,</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">scalar</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="p">...</span>
+<span class="w">              </span><span class="p">}</span>
+<span class="w">            </span><span class="p">);</span>
+</pre></div>
+</div>
+ </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9optimizer17requiresGradientsEv">
+<span class="target" id="classcudaq_1_1optimizer_1a872567d3394d98475967a00fdade1e7f"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">requiresGradients</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq9optimizer17requiresGradientsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Returns true if this optimization strategy requires gradients to achieve its optimization goals. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function">
+<span class="target" id="classcudaq_1_1optimizer_1af1f7e250c72ce293529ba760f162d4eb"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq19optimization_resultE" title="cudaq::optimization_result"><span class="n"><span class="pre">optimization_result</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">optimize</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">dim</span></span>, <a class="reference internal" href="#_CPPv4N5cudaq20optimizable_functionE" title="cudaq::optimizable_function"><span class="n"><span class="pre">optimizable_function</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">opt_function</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Run the optimization strategy defined by concrete sub-type implementations. Takes the number of variational parameters, and a custom objective function that takes the function input parameters as a immutable (<code class="docutils literal notranslate"><span class="pre">const</span></code>) vector&lt;double&gt; reference and a mutable vector&lt;double&gt; reference modeling the current iteration gradient vector (dF / dx_i, for all i parameters). This function must return a scalar double, the value of this function at the current input parameters. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq20optimizable_functionE">
+<span class="target" id="classcudaq_1_1optimizable__function"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">optimizable_function</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq20optimizable_functionE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>An <a class="reference internal" href="#classcudaq_1_1optimizable__function"><span class="std std-ref">optimizable_function</span></a> wraps a user-provided objective function to be optimized. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq19optimization_resultE">
+<span class="target" id="optimizer_8h_1a93240fa136c0cb1c044af3126c958b92"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">optimization_result</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">tuple</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq19optimization_resultE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Typedef modeling the result of an optimization strategy, a double representing the optimal value and the corresponding optimal parameters. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5stateE">
+<span class="target" id="classcudaq_1_1state"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">state</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq5stateE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1state"><span class="std std-ref">cudaq::state</span></a> encapsulate backend simulation state vector or density matrix data. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5state5stateEP15SimulationState">
+<span class="target" id="classcudaq_1_1state_1ae07a132f3563b069e3e2acd494ec4eec"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">explicit</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">state</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">ptrToOwn</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5state5stateEP15SimulationState" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, takes the simulation data and owns it. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5state5stateERK5state">
+<span class="target" id="classcudaq_1_1state_1a4037eab50e004c821c32010a043461cc"></span><span class="sig-name descname"><span class="n"><span class="pre">state</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq5state5stateERK5state" title="cudaq::state::state"><span class="n"><span class="pre">state</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq5state5stateERK5state" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy constructor (default) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5stateaSERR5state">
+<span class="target" id="classcudaq_1_1state_1acbe39e2bb1d4d4180dd4055be938eeff"></span><a class="reference internal" href="#_CPPv4N5cudaq5stateE" title="cudaq::state"><span class="n"><span class="pre">state</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">=</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq5stateE" title="cudaq::state"><span class="n"><span class="pre">state</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5stateaSERR5state" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy assignment. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5stateixENSt6size_tE">
+<span class="target" id="classcudaq_1_1state_1a09a14ee2f7ea1ac49caca188341e8aa4"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">[]</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5stateixENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Convenience function for extracting from a known vector. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE">
+<span class="target" id="classcudaq_1_1state_1a9abced2d45ce495bf0bb3d4c0391a929"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">()</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">idx</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">jdx</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Convenience function for extracting from a known matrix. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5stateclERKNSt16initializer_listINSt6size_tEEENSt6size_tE">
+<span class="target" id="classcudaq_1_1state_1a09276630f1773cfffc4346dd0df34057"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="k"><span class="pre">operator</span></span><span class="o"><span class="pre">()</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">initializer_list</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&amp;</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">tensorIdx</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5stateclERKNSt16initializer_listINSt6size_tEEENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>General extraction operator for state data. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state10get_tensorENSt6size_tE">
+<span class="target" id="classcudaq_1_1state_1aa59a231f12caabb305ed2053913290b1"></span><a class="reference internal" href="#_CPPv4N5cudaq6tensorE" title="cudaq::tensor"><span class="n"><span class="pre">tensor</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_tensor</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">tensorIdx</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state10get_tensorENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the tensor at the given index for this state representation. For state-vector and density matrix simulation states, there is just one tensor with rank 1 or 2 respectively. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state11get_tensorsEv">
+<span class="target" id="classcudaq_1_1state_1af9f27534930537d903acfe367e174745"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq6tensorE" title="cudaq::tensor"><span class="n"><span class="pre">tensor</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_tensors</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state11get_tensorsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return all tensors that represent this simulation state. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state15get_num_tensorsEv">
+<span class="target" id="classcudaq_1_1state_1ac7031054d0e32f7957ec9478f40d1497"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_num_tensors</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state15get_num_tensorsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of tensors that represent this state. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state14get_num_qubitsEv">
+<span class="target" id="classcudaq_1_1state_1a79d449c7e66ae1a83dacbf6ea2573a2c"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_num_qubits</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state14get_num_qubitsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of qubits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state13get_precisionEv">
+<span class="target" id="classcudaq_1_1state_1a72d54ecbe1db8b8f49865d14da424243"></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationStateE" title="cudaq::SimulationState"><span class="n"><span class="pre">SimulationState</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq15SimulationState9precisionE" title="cudaq::SimulationState::precision"><span class="n"><span class="pre">precision</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_precision</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state13get_precisionEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the underlying floating point precision for this state. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state9is_on_gpuEv">
+<span class="target" id="classcudaq_1_1state_1a47e0b8240490f3b5e6045c3baf936a69"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">is_on_gpu</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state9is_on_gpuEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if this a state on the GPU. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ScalarType</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1state_1aacdfdccf258f11a78270fcdba4a87005"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">to_host</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE" title="cudaq::state::to_host::ScalarType"><span class="n"><span class="pre">ScalarType</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">hostPtr</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">numElements</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Copy this state from device to. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state4dumpEv">
+<span class="target" id="classcudaq_1_1state_1a8b3cca5e2ba7672a8fc23a92f33700ca"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state4dumpEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump the state to standard out. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq5state4dumpERNSt7ostreamE">
+<span class="target" id="classcudaq_1_1state_1aaffdb68ddd91dfe2527f3e906f4d53e5"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">dump</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">os</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq5state4dumpERNSt7ostreamE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Dump the state to given output stream. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5state7overlapERK5state">
+<span class="target" id="classcudaq_1_1state_1ac52a47246232d55fff20665e2d8139da"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">overlap</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq5stateE" title="cudaq::state"><span class="n"><span class="pre">state</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">other</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5state7overlapERK5state" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the overlap of this state with the other one. For state vectors (pure states), it is computed as <code class="docutils literal notranslate"><span class="pre">|&lt;this</span> <span class="pre">|</span> <span class="pre">other&gt;|</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5state9amplitudeERKNSt6vectorIiEE">
+<span class="target" id="classcudaq_1_1state_1a17f056d04cecd168f83cfec31f25f1c5"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">amplitude</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">int</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">basisState</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5state9amplitudeERKNSt6vectorIiEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the amplitude of the given computational basis state. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5state10amplitudesERKNSt6vectorINSt6vectorIiEEEE">
+<span class="target" id="classcudaq_1_1state_1a3341e4701bfc271215631ac9a7c73c82"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">amplitudes</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">int</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">basisStates</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5state10amplitudesERKNSt6vectorINSt6vectorIiEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the amplitudes of the given list of computational basis states. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-static-functions">Public Static Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5state9from_dataERK10state_data">
+<span class="target" id="classcudaq_1_1state_1a2e9b7d521f974822246d180d43160d2e"></span><span class="k"><span class="pre">static</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq5stateE" title="cudaq::state"><span class="n"><span class="pre">state</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">from_data</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq10state_dataE" title="cudaq::state_data"><span class="n"><span class="pre">state_data</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">data</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5state9from_dataERK10state_data" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Create a new state from user-provided data. The data can be host or device data. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8gradientE">
+<span class="target" id="classcudaq_1_1gradient"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq8gradientE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1gradient"><span class="std std-ref">cudaq::gradient</span></a> represents a base type for all gradient strategies leveraged by variational algorithms. </p>
+<p>The <a class="reference internal" href="#classcudaq_1_1gradient"><span class="std std-ref">cudaq::gradient</span></a> tracks a std::function with signature void(std::vector&lt;double&gt;) representing the parameterized kernel ansatz. For ansatzes that do not follow this signature, a separate Argument Mapper must be provided which takes std::vector&lt;double&gt; to a tuple of custom function arguments. All gradient subtypes should inherit the base class constructors (using gradient::gradient), but provide a concrete implementation of <a class="reference internal" href="#classcudaq_1_1gradient_1a00ec8d88812a7d459ee134e4b5c9593c"><span class="std std-ref">gradient::compute()</span></a>. The compute method takes as input the current iteration parameters, a reference to the gradient vector which <a class="reference internal" href="#classcudaq_1_1gradient_1a00ec8d88812a7d459ee134e4b5c9593c"><span class="std std-ref">compute()</span></a> must update, the <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">cudaq::spin_op</span></a> for this variational algorithm, and the expected value of the <a class="reference internal" href="#classcudaq_1_1spin__op"><span class="std std-ref">spin_op</span></a> at the current iteration’s parameters. Subtypes can leverage the protected gradient::getExpectedValue() method to compute &lt;psi(x) | H | psi(x)&gt; at the provided set of variational parameters. </p>
+<p>Subclassed by <a class="reference internal" href="#classcudaq_1_1gradients_1_1central__difference"><span class="std std-ref">cudaq::gradients::central_difference</span></a>, <a class="reference internal" href="#classcudaq_1_1gradients_1_1forward__difference"><span class="std std-ref">cudaq::gradients::forward_difference</span></a>, <a class="reference internal" href="#classcudaq_1_1gradients_1_1parameter__shift"><span class="std std-ref">cudaq::gradients::parameter_shift</span></a></p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8gradient8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">
+<span class="target" id="classcudaq_1_1gradient_1ab284b63287df8a9c5f30a10c472e77eb"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq8gradient8gradientERRNSt8functionIFvNSt6vectorIdEEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with prescribed signature. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8gradient8gradientEv">
+<span class="target" id="classcudaq_1_1gradient_1acc76a46b709b332d3475ce585abf2e99"></span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq8gradient8gradientEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Empty constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradient_1adcc5f751cb413adec4a5baccd652a4d9"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradient::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradient::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">...</span></span><span class="sig-name descname"><span class="n"><span class="pre">Args</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradient_1ad768f534886884dd9b53efd61a6dfed4"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setArgs</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args" title="cudaq::gradient::setArgs::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args" title="cudaq::gradient::setArgs::Args"><span class="n"><span class="pre">Args</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">...</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">args</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Take the quantum kernel and concrete arguments for all arguments except the first std::vector&lt;double&gt; argument, which is used for the variational parameters for the gradient. Serialize and save those arguments into this object. (Useful for NVQC.) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradient_1afdec4982d0785dc116c1e63ccc4c1ce4"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setKernel</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel" title="cudaq::gradient::setKernel::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the kernel after the gradient has been constructed. Use of this function requires that the kernel ONLY accept the variational parameters. It cannot have any non-variational parameters. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq8gradient8gradientER7KernelT">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_invocable_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq8gradient8gradientER7KernelT" title="cudaq::gradient::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradient_1a7470fe58b0990b6f097d476470a337ff"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq8gradient8gradientER7KernelT" title="cudaq::gradient::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq8gradient8gradientER7KernelT" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable that must have the prescribed call signature (void(std::vector&lt;double&gt;)) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradient_1a1ed77d0851f57c219123cf612c096177"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradient::gradient::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradient::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">
+<span class="target" id="classcudaq_1_1gradient_1a00ec8d88812a7d459ee134e4b5c9593c"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">dx</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">h</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">funcAtX</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the current iterations gradient vector and update the provided vector&lt;double reference (<code class="docutils literal notranslate"><span class="pre">dx</span></code>). </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">
+<span class="target" id="classcudaq_1_1gradient_1ab8cb7ac40ff72370b2ac1f29da889518"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">func</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">funcAtX</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the gradient vector for the provided objective function, <code class="docutils literal notranslate"><span class="pre">func</span></code>, at the given set of parameters, <code class="docutils literal notranslate"><span class="pre">x</span></code>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8gradient5cloneEv">
+<span class="target" id="classcudaq_1_1gradient_1a3cd5c1a4a12b19aa3078e49f9ecaa886"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">unique_ptr</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clone</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq8gradient5cloneEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Clone the object. Must be implemented by derived classes. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18central_differenceE">
+<span class="target" id="classcudaq_1_1gradients_1_1central__difference"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">central_difference</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq9gradients18central_differenceE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18central_difference5cloneEv">
+<span class="target" id="classcudaq_1_1gradients_1_1central__difference_1a687f4a1033a66fa3755c95a6d0e46c7c"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">unique_ptr</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clone</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18central_difference5cloneEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Clone the object. Must be implemented by derived classes. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">
+<span class="target" id="classcudaq_1_1gradients_1_1central__difference_1a10744d416a2c6b72cc1932907761b079"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">dx</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">h</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">exp_h</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the current iterations gradient vector and update the provided vector&lt;double reference (<code class="docutils literal notranslate"><span class="pre">dx</span></code>). </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">
+<span class="target" id="classcudaq_1_1gradients_1_1central__difference_1a972e199322d35bf761b46f5ccf563691"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">func</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">funcAtX</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1gradients_1_1central__difference"><span class="std std-ref"><span class="pre">central_difference</span></span></a></code> gradient for the arbitrary function, <code class="docutils literal notranslate"><span class="pre">func</span></code>, passed in by the user. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18central_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">
+<span class="target" id="classcudaq_1_1gradients_1_1central__difference_1ab284b63287df8a9c5f30a10c472e77eb"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18central_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with prescribed signature. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18central_difference8gradientEv">
+<span class="target" id="classcudaq_1_1gradients_1_1central__difference_1acc76a46b709b332d3475ce585abf2e99"></span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18central_difference8gradientEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Empty constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1central__difference_1adcc5f751cb413adec4a5baccd652a4d9"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradients::central_difference::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradients::central_difference::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_invocable_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT" title="cudaq::gradients::central_difference::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1central__difference_1a7470fe58b0990b6f097d476470a337ff"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT" title="cudaq::gradients::central_difference::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable that must have the prescribed call signature (void(std::vector&lt;double&gt;)) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1central__difference_1a1ed77d0851f57c219123cf612c096177"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradients::central_difference::gradient::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradients::central_difference::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients15parameter_shiftE">
+<span class="target" id="classcudaq_1_1gradients_1_1parameter__shift"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">parameter_shift</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq9gradients15parameter_shiftE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients15parameter_shift5cloneEv">
+<span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1aa4a4d2be3b9c98c41376617c5a4dff51"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">unique_ptr</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clone</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients15parameter_shift5cloneEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Clone the object. Must be implemented by derived classes. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">
+<span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1a83289c003b373ee92073b7327f250cb4"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">dx</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">h</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">exp_h</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the current iterations gradient vector and update the provided vector&lt;double reference (<code class="docutils literal notranslate"><span class="pre">dx</span></code>). </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">
+<span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1a5b92a24b1b7bfed20963a5e4affa0e75"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">func</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">funcAtX</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1gradients_1_1parameter__shift"><span class="std std-ref"><span class="pre">parameter_shift</span></span></a></code> gradient for the arbitrary function, <code class="docutils literal notranslate"><span class="pre">func</span></code>, passed in by the user. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients15parameter_shift8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">
+<span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1ab284b63287df8a9c5f30a10c472e77eb"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq9gradients15parameter_shift8gradientERRNSt8functionIFvNSt6vectorIdEEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with prescribed signature. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients15parameter_shift8gradientEv">
+<span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1acc76a46b709b332d3475ce585abf2e99"></span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients15parameter_shift8gradientEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Empty constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1adcc5f751cb413adec4a5baccd652a4d9"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradients::parameter_shift::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradients::parameter_shift::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_invocable_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT" title="cudaq::gradients::parameter_shift::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1a7470fe58b0990b6f097d476470a337ff"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT" title="cudaq::gradients::parameter_shift::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable that must have the prescribed call signature (void(std::vector&lt;double&gt;)) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1parameter__shift_1a1ed77d0851f57c219123cf612c096177"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradients::parameter_shift::gradient::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradients::parameter_shift::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18forward_differenceE">
+<span class="target" id="classcudaq_1_1gradients_1_1forward__difference"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">forward_difference</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq9gradients18forward_differenceE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the first order forward difference approximation for the gradient. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18forward_difference5cloneEv">
+<span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1aabbca1c2829aa67ed5902c9e7c4284cd"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">unique_ptr</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clone</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18forward_difference5cloneEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Clone the object. Must be implemented by derived classes. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">
+<span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1a601410b8137564ce7fb76891322a2a7f"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">dx</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">h</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">funcAtX</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1gradients_1_1forward__difference"><span class="std std-ref"><span class="pre">forward_difference</span></span></a></code> gradient. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">
+<span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1a2b21090e517c7cec2b3d776e60f35419"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">compute</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">x</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">func</span></span>, <span class="kt"><span class="pre">double</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">funcAtX</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">override</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Compute the <code class="docutils literal notranslate"><a class="reference internal" href="#classcudaq_1_1gradients_1_1forward__difference"><span class="std std-ref"><span class="pre">forward_difference</span></span></a></code> gradient for the arbitrary function, <code class="docutils literal notranslate"><span class="pre">func</span></code>, passed in by the user. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18forward_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">
+<span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1ab284b63287df8a9c5f30a10c472e77eb"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18forward_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with prescribed signature. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9gradients18forward_difference8gradientEv">
+<span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1acc76a46b709b332d3475ce585abf2e99"></span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq9gradients18forward_difference8gradientEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Empty constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1adcc5f751cb413adec4a5baccd652a4d9"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradients::forward_difference::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper" title="cudaq::gradients::forward_difference::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">KernelT</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">enable_if_t</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">is_invocable_v</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT" title="cudaq::gradients::forward_difference::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1a7470fe58b0990b6f097d476470a337ff"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT" title="cudaq::gradients::forward_difference::gradient::KernelT"><span class="n"><span class="pre">KernelT</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes a callable that must have the prescribed call signature (void(std::vector&lt;double&gt;)) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QuantumKernel</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">ArgsMapper</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="classcudaq_1_1gradients_1_1forward__difference_1a1ed77d0851f57c219123cf612c096177"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">gradient</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradients::forward_difference::gradient::QuantumKernel"><span class="n"><span class="pre">QuantumKernel</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">kernel</span></span>, <a class="reference internal" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper" title="cudaq::gradients::forward_difference::gradient::ArgsMapper"><span class="n"><span class="pre">ArgsMapper</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">argsMapper</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor, takes the quantum kernel with non-standard signature the Argument Mapper function object that maps the parameters to concrete arguments for the quantum kernel. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+</section>
+<section id="platform">
+<h2>Platform<a class="headerlink" href="#platform" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPUE">
+<span class="target" id="classcudaq_1_1QPU"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QPU</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8registryE" title="cudaq::registry"><span class="n"><span class="pre">registry</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4I0EN5cudaq8registry14RegisteredTypeE" title="cudaq::registry::RegisteredType"><span class="n"><span class="pre">RegisteredType</span></span></a><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq3QPUE" title="cudaq::QPU"><span class="n"><span class="pre">QPU</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPUE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A CUDA-Q <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> is an abstraction on the quantum processing unit which executes quantum kernel expressions. The <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> exposes certain information about the <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> being targeting, such as the number of available qubits, the logical ID for this <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> in a set of available QPUs, and its qubit connectivity. The <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> keeps track of an execution queue for enqueuing asynchronous tasks that execute quantum kernel expressions. The <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> also tracks the client-provided execution context to enable quantum kernel related tasks such as sampling and observation.</p>
+<p>This type is meant to be subtyped by concrete <a class="reference internal" href="#classcudaq_1_1quantum__platform"><span class="std std-ref">quantum_platform</span></a> subtypes. </p>
+<p>Subclassed by <a class="reference internal" href="#classcudaq_1_1BaseRemoteRESTQPU"><span class="std std-ref">cudaq::BaseRemoteRESTQPU</span></a>, <a class="reference internal" href="#classcudaq_1_1BaseRemoteSimulatorQPU"><span class="std std-ref">cudaq::BaseRemoteSimulatorQPU</span></a></p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU3QPUEv">
+<span class="target" id="classcudaq_1_1QPU_1a6ede419124b2032208c082990a6113d2"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QPU</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU3QPUEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, initializes the execution queue. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU3QPUENSt6size_tE">
+<span class="target" id="classcudaq_1_1QPU_1ab3fcfc8b6722f3ee1d28e0e84138d3ff"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">QPU</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">_qpuId</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU3QPUENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The constructor, sets the current <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> Id and initializes the execution queue </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU3QPUERR3QPU">
+<span class="target" id="classcudaq_1_1QPU_1a3b371e46e9435f8c563870e640d38e1a"></span><span class="sig-name descname"><span class="n"><span class="pre">QPU</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq3QPU3QPUERR3QPU" title="cudaq::QPU::QPU"><span class="n"><span class="pre">QPU</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPU3QPUERR3QPU" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Move constructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPUD0Ev">
+<span class="target" id="classcudaq_1_1QPU_1a3a66227bdbd3c46981cd068ae1814057"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">~QPU</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">default</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPUD0Ev" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The destructor. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU5setIdENSt6size_tE">
+<span class="target" id="classcudaq_1_1QPU_1a839ee0e4a992dc05855f5c31892b0ad7"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setId</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">_qpuId</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU5setIdENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the current <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> Id. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq3QPU20getExecutionThreadIdEv">
+<span class="target" id="classcudaq_1_1QPU_1a79378c8539dd40594956b157b31d469e"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">thread</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">id</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getExecutionThreadId</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq3QPU20getExecutionThreadIdEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get id of the thread this <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>’s queue executes on. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU12getNumQubitsEv">
+<span class="target" id="classcudaq_1_1QPU_1aed29436f93c96339d245b906862e0443"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getNumQubits</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU12getNumQubitsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of qubits. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU15getConnectivityEv">
+<span class="target" id="classcudaq_1_1QPU_1a783a0450e73f35edad0322e1c07bc702"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="kt"><span class="pre">auto</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getConnectivity</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU15getConnectivityEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the qubit connectivity. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU11isSimulatorEv">
+<span class="target" id="classcudaq_1_1QPU_1a7c1850650ce0720da66de1e3e4b460df"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">isSimulator</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU11isSimulatorEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Is this <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> a simulator ? </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU27supportsConditionalFeedbackEv">
+<span class="target" id="classcudaq_1_1QPU_1ac9fdfb6b9fd22acc4207c48a0162c480"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">supportsConditionalFeedback</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU27supportsConditionalFeedbackEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return whether this <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> has conditional feedback support. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq3QPU21getRemoteCapabilitiesEv">
+<span class="target" id="classcudaq_1_1QPU_1ada538a4355a21ae9d4920238bed65f30"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq18RemoteCapabilitiesE" title="cudaq::RemoteCapabilities"><span class="n"><span class="pre">RemoteCapabilities</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">getRemoteCapabilities</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq3QPU21getRemoteCapabilitiesEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the remote capabilities for this platform. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU8setShotsEi">
+<span class="target" id="classcudaq_1_1QPU_1a0a2adbf1c6212a49b36ed30f06626982"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setShots</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">_nShots</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU8setShotsEi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Base class handling of shots is do-nothing, subclasses can handle as they wish </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU10isEmulatedEv">
+<span class="target" id="classcudaq_1_1QPU_1a04df7e40bc230f5a27afcf72ac8cf23f"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">isEmulated</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU10isEmulatedEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Is this a local emulator of a remote <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>? </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU7enqueueER11QuantumTask">
+<span class="target" id="classcudaq_1_1QPU_1a369c5f7ebc7d5ff79e2e55210bd1ec1b"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">enqueue</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq11QuantumTaskE" title="cudaq::QuantumTask"><span class="n"><span class="pre">QuantumTask</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">task</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPU7enqueueER11QuantumTask" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Enqueue a quantum task on the asynchronous execution queue. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU19setExecutionContextEP16ExecutionContext">
+<span class="target" id="classcudaq_1_1QPU_1a796e2d78252c0b990bcbdda4512cad14"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setExecutionContext</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv4N5cudaq16ExecutionContextE" title="cudaq::ExecutionContext"><span class="n"><span class="pre">ExecutionContext</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">context</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPU19setExecutionContextEP16ExecutionContext" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the execution context, meant for subtype specification. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU21resetExecutionContextEv">
+<span class="target" id="classcudaq_1_1QPU_1af4a531bc79686767ffe8b412c22567e2"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">resetExecutionContext</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPU21resetExecutionContextEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Reset the execution context, meant for subtype specification. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE">
+<span class="target" id="classcudaq_1_1QPU_1a9dc04ad0e36a3358c9a3895480e4a2f4"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">launchKernel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">name</span></span>, <span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="p"><span class="pre">(</span></span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">kernelFunc</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">(</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">)</span></span>, <span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">args</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">uint64_t</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">uint64_t</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">rawArgs</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><a class="headerlink" href="#_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Launch the kernel with given name (to extract its Quake representation). The raw function pointer is also provided, as are the runtime arguments, as a struct-packed void pointer and its corresponding size. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE">
+<span class="target" id="classcudaq_1_1QPU_1a5a02ed81eab2209910562c4161660404"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">launchKernel</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">name</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">rawArgs</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Launch the kernel with given name and argument arrays. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE">
+<span class="target" id="classcudaq_1_1QPU_1a1d10a4aec2af11778d55f97cd959243f"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">launchSerializedCodeExecution</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">name</span></span>, <a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq30SerializedCodeExecutionContextE" title="cudaq::SerializedCodeExecutionContext"><span class="n"><span class="pre">SerializedCodeExecutionContext</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">serializeCodeExecutionObject</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Launch serialized code for remote execution. Subtypes that support this should override this function. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3QPU15onRandomSeedSetENSt6size_tE">
+<span class="target" id="classcudaq_1_1QPU_1ab4915615be5d425122d93d59ac1a22cd"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">onRandomSeedSet</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">seed</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3QPU15onRandomSeedSetENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Notify the <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> that a new random seed value is set. By default do nothing, let subclasses override. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq17BaseRemoteRESTQPUE">
+<span class="target" id="classcudaq_1_1BaseRemoteRESTQPU"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">BaseRemoteRESTQPU</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3QPUE" title="cudaq::QPU"><span class="n"><span class="pre">QPU</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq17BaseRemoteRESTQPUE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq22BaseRemoteSimulatorQPUE">
+<span class="target" id="classcudaq_1_1BaseRemoteSimulatorQPU"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">BaseRemoteSimulatorQPU</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3QPUE" title="cudaq::QPU"><span class="n"><span class="pre">QPU</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq22BaseRemoteSimulatorQPUE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Subclassed by <a class="reference internal" href="#classcudaq_1_1BaseNvcfSimulatorQPU"><span class="std std-ref">cudaq::BaseNvcfSimulatorQPU</span></a></p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq20BaseNvcfSimulatorQPUE">
+<span class="target" id="classcudaq_1_1BaseNvcfSimulatorQPU"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">BaseNvcfSimulatorQPU</span></span></span><span class="w"> </span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="k"><span class="pre">public</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq22BaseRemoteSimulatorQPUE" title="cudaq::BaseRemoteSimulatorQPU"><span class="n"><span class="pre">BaseRemoteSimulatorQPU</span></span></a><a class="headerlink" href="#_CPPv4N5cudaq20BaseNvcfSimulatorQPUE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Implementation of base <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> subtype that submits simulation request to NVCF. </p>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platformE">
+<span class="target" id="classcudaq_1_1quantum__platform"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">quantum_platform</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platformE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1quantum__platform"><span class="std std-ref">quantum_platform</span></a> corresponds to a specific quantum architecture. The <a class="reference internal" href="#classcudaq_1_1quantum__platform"><span class="std std-ref">quantum_platform</span></a> exposes a public API for programmers to query specific information about the targeted QPU(s) (e.g. number of qubits, qubit connectivity, etc.). This type is meant to be subclassed for concrete realizations of quantum platforms, which are intended to populate this platformQPUs member of this base class. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform12connectivityEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1aa0162be5a19283a7fe9a933ff93425c2"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq17QubitConnectivityE" title="cudaq::QubitConnectivity"><span class="n"><span class="pre">QubitConnectivity</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">connectivity</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform12connectivityEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Fetch the connectivity info. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform14get_num_qubitsEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a3daf9ab69de7ba94d639043de23ba977"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_num_qubits</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform14get_num_qubitsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get the number of qubits for the current <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform26supports_task_distributionEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1aa3371a29fdf210c5a0831f199c2604a7"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">supports_task_distribution</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform26supports_task_distributionEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if this platform exposes multiple QPUs and supports parallel distribution of quantum tasks. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform14get_num_qubitsENSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a01da4519c0c507cd59cfea0e7f493608"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_num_qubits</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform14get_num_qubitsENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get the number of qubits for the <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> with ID qpu_id. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform9get_shotsEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a73c885b661d50e6fc7315270846facb8"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">optional</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">int</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_shots</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform9get_shotsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Getter for the shots. This will be deprecated once <code class="docutils literal notranslate"><span class="pre">set_shots</span></code> and <code class="docutils literal notranslate"><span class="pre">clear_shots</span></code> are removed. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform9set_shotsEi">
+<span class="target" id="classcudaq_1_1quantum__platform_1a102472165450ce351417e897d813b9f3"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">set_shots</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">numShots</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform9set_shotsEi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Setter for the shots. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform11clear_shotsEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a996c2cc3b40e8c531ad1504af1d212de"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">clear_shots</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform11clear_shotsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Reset shots. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a6f25ae9f5846cf99e58794b604a1b0d2"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">set_exec_ctx</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq16ExecutionContextE" title="cudaq::ExecutionContext"><span class="n"><span class="pre">ExecutionContext</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">ctx</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Specify the execution context for this platform. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform12get_exec_ctxEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a96f71234cc01a1def47d0093e1315e61"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq16ExecutionContextE" title="cudaq::ExecutionContext"><span class="n"><span class="pre">ExecutionContext</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="sig-name descname"><span class="n"><span class="pre">get_exec_ctx</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform12get_exec_ctxEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the current execution context. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform14reset_exec_ctxENSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1ac98cd229d35948309412a2139ec5fc80"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">reset_exec_ctx</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform14reset_exec_ctxENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Reset the execution context for this platform. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform8num_qpusEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a6c795a09a2880fc7d7e973fc40c9f976"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">num_qpus</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform8num_qpusEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get the number of QPUs available with this platform. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform12is_simulatorEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a2cbc4b549fe8a3e1e9c8edc1193135a3"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">is_simulator</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform12is_simulatorEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return whether this platform is simulating the architecture. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform29supports_conditional_feedbackEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1ac477ee8827975113e29a01fc638bcd5a"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">supports_conditional_feedback</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform29supports_conditional_feedbackEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return whether the <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> has conditional feedback support. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform4nameEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a16b8cb93fb7a325cc1bd78076c832674"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">name</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform4nameEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The name of the platform, which also corresponds to the name of the platform file. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform15get_current_qpuEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1ad6cc6e01d40b010e8ae07e0332c61656"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_current_qpu</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform15get_current_qpuEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get the ID of the current <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform15set_current_qpuEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a67006ab2622bc51fa3f92310d65137f1"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">set_current_qpu</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">device_id</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform15set_current_qpuEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the current <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> via its device ID. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform9is_remoteEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a61163027d2aa2e064e0d1ff2e65e4d5a"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">is_remote</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpuId</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform9is_remoteEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if the <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> is remote. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform11is_emulatedEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1aaa21661369c0930137d6e6c0f4d98ec5"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">is_emulated</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpuId</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform11is_emulatedEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a> is locally emulating a remote <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform9set_noiseEPK11noise_model">
+<span class="target" id="classcudaq_1_1quantum__platform_1a6e798c291d46aff40ce8fdad40e6fb90"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">set_noise</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4N5cudaq11noise_modelE" title="cudaq::noise_model"><span class="n"><span class="pre">noise_model</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">model</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform9set_noiseEPK11noise_model" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the noise model for future invocations of quantum kernels. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4NK5cudaq16quantum_platform23get_remote_capabilitiesEKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a1459a03708bb0236c804148fb6775cbf"></span><a class="reference internal" href="#_CPPv4N5cudaq18RemoteCapabilitiesE" title="cudaq::RemoteCapabilities"><span class="n"><span class="pre">RemoteCapabilities</span></span></a><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">get_remote_capabilities</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpuId</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">0</span></span><span class="sig-paren">)</span><span class="w"> </span><span class="k"><span class="pre">const</span></span><a class="headerlink" href="#_CPPv4NK5cudaq16quantum_platform23get_remote_capabilitiesEKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get the remote capabilities (only applicable for remote platforms) </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform11reset_noiseEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a39b49eb99f389ffbf2d6aa64698e6110"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">reset_noise</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform11reset_noiseEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Turn off any noise models. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask">
+<span class="target" id="classcudaq_1_1quantum__platform_1a3d25480de207ff5d5ebffb0c93551470"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">future</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">enqueueAsyncTask</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span>, <a class="reference internal" href="#_CPPv4N5cudaq19KernelExecutionTaskE" title="cudaq::KernelExecutionTask"><span class="n"><span class="pre">KernelExecutionTask</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">t</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Enqueue an asynchronous sampling task. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a1a72901becdfed7bca93b52a0805534b"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">enqueueAsyncTask</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">qpu_id</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">f</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Enqueue a general task that runs on the specified <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a100d2ad5ac344001c5842a32e4788649"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">launchVQE</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">kernelName</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">kernelArgs</span></span>, <a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq8gradientE" title="cudaq::gradient"><span class="n"><span class="pre">gradient</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">gradient</span></span>, <a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq7spin_opE" title="cudaq::spin_op"><span class="n"><span class="pre">spin_op</span></span></a><span class="w"> </span><span class="n sig-param"><span class="pre">H</span></span>, <a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq9optimizerE" title="cudaq::optimizer"><span class="n"><span class="pre">optimizer</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">optimizer</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">n_params</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">shots</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Launch a VQE operation on the platform. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform16setTargetBackendERKNSt6stringE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a237421abcf74b7ac220aa84f6fccc3d2"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setTargetBackend</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">name</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform16setTargetBackendERKNSt6stringE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the target backend, by default do nothing, let subclasses override. </p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>name</strong> – </p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform15onRandomSeedSetENSt6size_tE">
+<span class="target" id="classcudaq_1_1quantum__platform_1af1694e06135ecdfab51f20ecc87f7ee8"></span><span class="k"><span class="pre">virtual</span></span><span class="w"> </span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">onRandomSeedSet</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">seed</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform15onRandomSeedSetENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Called by the runtime to notify that a new random seed value is set. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform14resetLogStreamEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a02bbc42f21f59ca9fa992db36e9dfd7b"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">resetLogStream</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform14resetLogStreamEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Turn off any custom logging stream. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform12getLogStreamEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1ab77a8ffa73c4f4097f6374095e96bd1f"></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="sig-name descname"><span class="n"><span class="pre">getLogStream</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform12getLogStreamEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Get the stream for info logging. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform12setLogStreamERNSt7ostreamE">
+<span class="target" id="classcudaq_1_1quantum__platform_1a0939ab8f5192e22be54aa85f741f9c49"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">setLogStream</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">ostream</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">logStream</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform12setLogStreamERNSt7ostreamE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set the info logging stream. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-static-functions">Public Static Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq16quantum_platform14list_platformsEv">
+<span class="target" id="classcudaq_1_1quantum__platform_1a75f4168edb243d52ca8df2e78ad905f9"></span><span class="k"><span class="pre">static</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">list_platforms</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq16quantum_platform14list_platformsEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>List all available platforms. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp struct">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18RemoteCapabilitiesE">
+<span class="target" id="structcudaq_1_1RemoteCapabilities"></span><span class="k"><span class="pre">struct</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">RemoteCapabilities</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq18RemoteCapabilitiesE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A structure of boolean fields to indicate whether a given remote server has specific capabilities. </p>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-functions">Public Functions</p>
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18RemoteCapabilities18RemoteCapabilitiesEb">
+<span class="target" id="structcudaq_1_1RemoteCapabilities_1a436f02286cef89972c62bc8e3cc98122"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">RemoteCapabilities</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">initValue</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq18RemoteCapabilities18RemoteCapabilitiesEb" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Constructor that broadcasts <code class="docutils literal notranslate"><span class="pre">initValue</span></code> to all fields. </p>
+</dd></dl>
+
+</div>
+<div class="breathe-sectiondef docutils container">
+<p class="breathe-sectiondef-title rubric" id="breathe-section-title-public-members">Public Members</p>
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18RemoteCapabilities12stateOverlapE">
+<span class="target" id="structcudaq_1_1RemoteCapabilities_1a534e4bef1df86badcf37620ec8e41aec"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">stateOverlap</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq18RemoteCapabilities12stateOverlapE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>True if the remote can perform state overlap operations. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18RemoteCapabilities18serializedCodeExecE">
+<span class="target" id="structcudaq_1_1RemoteCapabilities_1a59e51afc4c9baeefbad76528f0291857"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">serializedCodeExec</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq18RemoteCapabilities18serializedCodeExecE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>True if the remote can perform serialized code execution (raw Python commands). </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18RemoteCapabilities3vqeE">
+<span class="target" id="structcudaq_1_1RemoteCapabilities_1a9747aef4cba0c08f8a8c762848663c64"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">vqe</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq18RemoteCapabilities3vqeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>True if the remote can perform an entire VQE operation without and back-and-forth client/server communications. </p>
+</dd></dl>
+
+<dl class="cpp var">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18RemoteCapabilities17isRemoteSimulatorE">
+<span class="target" id="structcudaq_1_1RemoteCapabilities_1ae0e06cc1b438c44d0751a43688407a8e"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">isRemoteSimulator</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="k"><span class="pre">false</span></span><a class="headerlink" href="#_CPPv4N5cudaq18RemoteCapabilities17isRemoteSimulatorE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>True if execution is performed on a remote simulator - i.e. IR generation (including synthesis) and execution are performed in different processes. </p>
+</dd></dl>
+
+</div>
+</dd></dl>
+
+<dl class="cpp class">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq30SerializedCodeExecutionContextE">
+<span class="target" id="classcudaq_1_1SerializedCodeExecutionContext"></span><span class="k"><span class="pre">class</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">SerializedCodeExecutionContext</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq30SerializedCodeExecutionContextE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The <a class="reference internal" href="#classcudaq_1_1SerializedCodeExecutionContext"><span class="std std-ref">SerializedCodeExecutionContext</span></a> is an abstraction to indicate how a serialized code should be executed. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11QuantumTaskE">
+<span class="target" id="QuantumExecutionQueue_8h_1a234ec4683d248518f1c276dc20fc3472"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">QuantumTask</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">void</span></span><span class="p"><span class="pre">(</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq11QuantumTaskE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The QuantumTask is ultimately what gets added to the execution queue. It is meant to wrap any Sampling or Observe task with an appropriate std::promise instance being provided and set. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq17QubitConnectivityE">
+<span class="target" id="quantum__platform_8h_1a104e794b18a96a94b7b3ee6fbd96698d"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">QubitConnectivity</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq9QubitEdgeE" title="cudaq::QubitEdge"><span class="n"><span class="pre">QubitEdge</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq17QubitConnectivityE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9QubitEdgeE">
+<span class="target" id="quantum__platform_8h_1aa2ee059741b84fd4577879dad8e672ef"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">QubitEdge</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">pair</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq9QubitEdgeE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Typedefs for defining the connectivity structure of a <a class="reference internal" href="#classcudaq_1_1QPU"><span class="std std-ref">QPU</span></a>. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq19KernelExecutionTaskE">
+<span class="target" id="quantum__platform_8h_1a2126c891aff3a4b8d4e49df0bdac3a78"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">KernelExecutionTask</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="p"><span class="pre">(</span></span><span class="p"><span class="pre">)</span></span><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq19KernelExecutionTaskE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>A sampling tasks takes no input arguments and returns a <a class="reference internal" href="#classcudaq_1_1sample__result"><span class="std std-ref">sample_result</span></a> instance. </p>
+</dd></dl>
+
+</section>
+<section id="utilities">
+<h2>Utilities<a class="headerlink" href="#utilities" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7complexE">
+<span class="target" id="host__config_8h_1aed5a2a46851a0e70522e1f2ff4201094"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">complex</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">complex</span></span><span class="p"><span class="pre">&lt;</span></span><a class="reference internal" href="#_CPPv4N5cudaq4realE" title="cudaq::real"><span class="n"><span class="pre">real</span></span></a><span class="p"><span class="pre">&gt;</span></span><a class="headerlink" href="#_CPPv4N5cudaq7complexE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4realE">
+<span class="target" id="host__config_8h_1a4b7ad2191c1c3ad1233eb18016821c99"></span><span class="k"><span class="pre">using</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">real</span></span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="kt"><span class="pre">double</span></span><a class="headerlink" href="#_CPPv4N5cudaq4realE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq5rangeENSt6size_tE">
+<span class="target" id="cudaq__utils_8h_1afba25b385ea0f6fa692a7c4baad5f4bc"></span><span class="k"><span class="pre">inline</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">range</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">N</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq5rangeENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return a vector of unsigned integers. The first element is zero, and the remaining elements are all values incremented by 1 to the total size value provided (exclusive). </p>
+</dd></dl>
+
+</section>
+<section id="namespaces">
+<h2>Namespaces<a class="headerlink" href="#namespaces" title="Permalink to this heading">¶</a></h2>
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv45cudaq">
+<span class="target" id="namespacecudaq"></span><span class="k"><span class="pre">namespace</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">cudaq</span></span></span><a class="headerlink" href="#_CPPv45cudaq" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq18num_available_gpusEv">
+<span class="target" id="cudaq_8h_1a1f10ecfee89d8754d4e899d178aa1040"></span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">num_available_gpus</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq18num_available_gpusEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>The number of available GPUs. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq15set_random_seedENSt6size_tE">
+<span class="target" id="cudaq_8h_1a0635ad8b98868ed14865bab138e23ff0"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">set_random_seed</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">seed</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq15set_random_seedENSt6size_tE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set a seed for any random number generators used in backend simulations. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq9set_noiseERKN5cudaq11noise_modelE">
+<span class="target" id="cudaq_8h_1a11add49cd36f05bfd240d84a35678868"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">set_noise</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq11noise_modelE" title="cudaq::noise_model"><span class="n"><span class="pre">noise_model</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">model</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq9set_noiseERKN5cudaq11noise_modelE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Set a custom noise model for simulation. The caller must also call <code class="docutils literal notranslate"><span class="pre">cudaq::unset_noise</span></code> before <code class="docutils literal notranslate"><span class="pre">model</span></code> gets deallocated or goes out of scope. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq11unset_noiseEv">
+<span class="target" id="cudaq_8h_1afbecd5e530b3ef32c7872b87541c0a43"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">unset_noise</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq11unset_noiseEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Remove an existing noise model from simulation. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq7detailsE">
+<span class="target" id="namespacecudaq_1_1details"></span><span class="k"><span class="pre">namespace</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">details</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq7detailsE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq8registryE">
+<span class="target" id="namespacecudaq_1_1registry"></span><span class="k"><span class="pre">namespace</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">registry</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq8registryE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpiE">
+<span class="target" id="namespacecudaq_1_1mpi"></span><span class="k"><span class="pre">namespace</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">mpi</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq3mpiE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi10initializeEv">
+<span class="target" id="cudaq_8h_1a9d165737129a8ca7423ce1e0b0c9ca7e"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">initialize</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi10initializeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Initialize MPI if available. This function is a no-op if there CUDA-Q has not been built against MPI. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi10initializeEiPPc">
+<span class="target" id="cudaq_8h_1a6c944ecd26dfb16504034fb023a04a99"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">initialize</span></span></span><span class="sig-paren">(</span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">argc</span></span>, <span class="kt"><span class="pre">char</span></span><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="p"><span class="pre">*</span></span><span class="n sig-param"><span class="pre">argv</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi10initializeEiPPc" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Initialize MPI if available. This function is a no-op if there CUDA-Q has not been built against MPI. Takes program arguments as input. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi14is_initializedEv">
+<span class="target" id="cudaq_8h_1a2c7d083e6db96bf244206e1da6f44774"></span><span class="kt"><span class="pre">bool</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">is_initialized</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi14is_initializedEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return true if MPI is already initialized, false otherwise. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi8finalizeEv">
+<span class="target" id="cudaq_8h_1adbce8f0a621b7c6073e3f358d452b5ed"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">finalize</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi8finalizeEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Finalize MPI. This function is a no-op if there CUDA-Q has not been built against MPI. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi4rankEv">
+<span class="target" id="cudaq_8h_1ae314e6dc9f293eebe6b9dcb44efef7c3"></span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">rank</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi4rankEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the rank of the calling process. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi9num_ranksEv">
+<span class="target" id="cudaq_8h_1ae3a3c06ca899063fbabb0f0c936d3c41"></span><span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">num_ranks</span></span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi9num_ranksEv" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Return the number of MPI ranks. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE">
+<span class="target" id="cudaq_8h_1aaa5aebe9903c057fa3f1ae8fce98a50b"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">all_gather</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">global</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">local</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Gather all vector data (floating point numbers) locally into the provided global vector. </p>
+<p>Global vector must be sized to fit all vector elements coming from individual ranks. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE">
+<span class="target" id="cudaq_8h_1ac382bb3637b38312a88615b20a4f8b3f"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">all_gather</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">int</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">global</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">int</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">local</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Gather all vector data (integers) locally into the provided global vector. </p>
+<p>Global vector must be sized to fit all vector elements coming from individual ranks. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">T</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">Func</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="observe_8h_1a872bbab143f7cd999c07290b023ecb81"></span><a class="reference internal" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func" title="cudaq::mpi::all_reduce::T"><span class="n"><span class="pre">T</span></span></a><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">all_reduce</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func" title="cudaq::mpi::all_reduce::T"><span class="n"><span class="pre">T</span></span></a><span class="p"><span class="pre">&amp;</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func" title="cudaq::mpi::all_reduce::Func"><span class="n"><span class="pre">Func</span></span></a><span class="p"><span class="pre">&amp;</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction">
+<span class="k"><span class="pre">template</span></span><span class="p"><span class="pre">&lt;</span></span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">T</span></span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="k"><span class="pre">typename</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">BinaryFunction</span></span></span><span class="p"><span class="pre">&gt;</span></span><br /><span class="target" id="cudaq_8h_1acf510f9fe029c39b4d475c75fb876dc3"></span><a class="reference internal" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction" title="cudaq::mpi::all_reduce::T"><span class="n"><span class="pre">T</span></span></a><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">all_reduce</span></span></span><span class="sig-paren">(</span><span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction" title="cudaq::mpi::all_reduce::T"><span class="n"><span class="pre">T</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">localValue</span></span>, <span class="k"><span class="pre">const</span></span><span class="w"> </span><a class="reference internal" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction" title="cudaq::mpi::all_reduce::BinaryFunction"><span class="n"><span class="pre">BinaryFunction</span></span></a><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">function</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Reduce all values across ranks with the specified binary function. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi">
+<span class="target" id="cudaq_8h_1a16e7663348b7ff4e38d5a2177881c232"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">broadcast</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">data</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">rootRank</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Broadcast a vector from a process (rootRank) to all other processes. </p>
+</dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi">
+<span class="target" id="cudaq_8h_1abf82bc930287d1b8f8411c98bb38a384"></span><span class="kt"><span class="pre">void</span></span><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq3mpiE" title="cudaq::mpi"><span class="n"><span class="pre">mpi</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">broadcast</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">string</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">data</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">rootRank</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Broadcast a string from a process (rootRank) to all other processes. </p>
+</dd></dl>
+
+<dl class="cpp type">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4orcaE">
+<span class="target" id="namespacecudaq_1_1orca"></span><span class="k"><span class="pre">namespace</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">orca</span></span></span><a class="headerlink" href="#_CPPv4N5cudaq4orcaE" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi">
+<span class="target" id="orca__qpu_8h_1a9c37d2732edc2ea6e8a5da2fcf980854"></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq4orcaE" title="cudaq::orca"><span class="n"><span class="pre">orca</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">sample</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">input_state</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">loop_lengths</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">bs_angles</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">n_samples</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">10000</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi" title="Permalink to this definition">¶</a><br /></dt>
+<dd></dd></dl>
+
+<dl class="cpp function">
+<dt class="sig sig-object cpp" id="_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi">
+<span class="target" id="orca__qpu_8h_1ad69656cd91704b89890e60a2fd561b3a"></span><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq13sample_resultE" title="cudaq::sample_result"><span class="n"><span class="pre">sample_result</span></span></a><span class="w"> </span><span class="sig-prename descclassname"><a class="reference internal" href="#_CPPv45cudaq" title="cudaq"><span class="n"><span class="pre">cudaq</span></span></a><span class="p"><span class="pre">::</span></span><a class="reference internal" href="#_CPPv4N5cudaq4orcaE" title="cudaq::orca"><span class="n"><span class="pre">orca</span></span></a><span class="p"><span class="pre">::</span></span></span><span class="sig-name descname"><span class="n"><span class="pre">sample</span></span></span><span class="sig-paren">(</span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">input_state</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">size_t</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">loop_lengths</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">bs_angles</span></span>, <span class="n"><span class="pre">std</span></span><span class="p"><span class="pre">::</span></span><span class="n"><span class="pre">vector</span></span><span class="p"><span class="pre">&lt;</span></span><span class="kt"><span class="pre">double</span></span><span class="p"><span class="pre">&gt;</span></span><span class="w"> </span><span class="p"><span class="pre">&amp;</span></span><span class="n sig-param"><span class="pre">ps_angles</span></span>, <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="n sig-param"><span class="pre">n_samples</span></span><span class="w"> </span><span class="p"><span class="pre">=</span></span><span class="w"> </span><span class="m"><span class="pre">10000</span></span><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi" title="Permalink to this definition">¶</a><br /></dt>
+<dd><p>Implementation of the sample method of the cudaq::orca namespace. </p>
+</dd></dl>
+
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../api.html" class="btn btn-neutral float-left" title="Code documentation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="python_api.html" class="btn btn-neutral float-right" title="CUDA-Q Python API" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/api/languages/python_api.html b/pr-2241/api/languages/python_api.html
new file mode 100644
index 0000000000..a41e210d34
--- /dev/null
+++ b/pr-2241/api/languages/python_api.html
@@ -0,0 +1,3591 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Python API &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Quantum Operations" href="../default_ops.html" />
+    <link rel="prev" title="CUDA-Q C++ API" href="cpp_api.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../api.html">   API Reference</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../api.html">Code documentation</a></li>
+      <li class="breadcrumb-item active">CUDA-Q Python API</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/api/languages/python_api.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cpp_api.html" class="btn btn-neutral float-left" title="CUDA-Q C++ API" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../default_ops.html" class="btn btn-neutral float-right" title="Quantum Operations" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="module-cudaq">
+<span id="cuda-q-python-api"></span><h1>CUDA-Q Python API<a class="headerlink" href="#module-cudaq" title="Permalink to this heading">¶</a></h1>
+<section id="program-construction">
+<h2>Program Construction<a class="headerlink" href="#program-construction" title="Permalink to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.make_kernel">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">make_kernel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.make_kernel" title="Permalink to this definition">¶</a></dt>
+<dd><blockquote>
+<div><p>Create a <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>: An empty kernel function to be used for quantum
+program construction. This kernel is non-parameterized if it accepts no
+arguments, else takes the provided types as arguments.</p>
+<p>Returns a kernel if it is non-parameterized, else a tuple containing the
+kernel and a <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> for each kernel argument.</p>
+</div></blockquote>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="c1"># Non-parameterized kernel.</span>
+<span class="n">kernel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+
+<span class="c1"># Example:</span>
+<span class="c1"># Parameterized kernel that accepts an `int` and `float` as arguments.</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">int_value</span><span class="p">,</span> <span class="n">float_value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="nb">float</span><span class="p">)</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.PyKernel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">PyKernel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">argTypeList</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernel" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> provides an API for dynamically constructing quantum
+circuits. The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> programmatically represents the circuit as an MLIR
+function using the Quake dialect.</p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="cudaq.PyKernel.name">
+<span class="sig-name descname"><span class="pre">name</span></span><a class="headerlink" href="#cudaq.PyKernel.name" title="Permalink to this definition">¶</a></dt>
+<dd><p>The name of the <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> function. Read-only.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">str</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="cudaq.PyKernel.arguments">
+<span class="sig-name descname"><span class="pre">arguments</span></span><a class="headerlink" href="#cudaq.PyKernel.arguments" title="Permalink to this definition">¶</a></dt>
+<dd><p>The arguments accepted by the
+<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> function. Read-only.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>List[<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>]</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="cudaq.PyKernel.argument_count">
+<span class="sig-name descname"><span class="pre">argument_count</span></span><a class="headerlink" href="#cudaq.PyKernel.argument_count" title="Permalink to this definition">¶</a></dt>
+<dd><p>The number of arguments accepted by the
+<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> function. Read-only.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)">int</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="cudaq.Kernel">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">Kernel</span></span><a class="headerlink" href="#cudaq.Kernel" title="Permalink to this definition">¶</a></dt>
+<dd><p>alias of <a class="reference internal" href="#cudaq.PyKernel" title="cudaq.kernel.kernel_builder.PyKernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">PyKernel</span></code></a></p>
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">PyKernelDecorator</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">function</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">verbose</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">module</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">kernelName</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">funcSrc</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">signature</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">location</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">overrideGlobalScopedVars</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code> serves as a standard Python decorator that takes
+the decorated function as input and optionally lowers its  AST
+representation to executable code via MLIR. This decorator enables full JIT
+compilation mode, where the function is lowered to an MLIR representation.</p>
+<p>This decorator exposes a call overload that executes the code via the
+MLIR <code class="code docutils literal notranslate"><span class="pre">ExecutionEngine</span></code> for the MLIR mode.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator.__call__">
+<span class="sig-name descname"><span class="pre">__call__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator.__call__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Invoke the CUDA-Q kernel. JIT compilation of the kernel AST to MLIR
+will occur here if it has not already occurred, except when the target
+requires custom handling.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator.__str__">
+<span class="sig-name descname"><span class="pre">__str__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator.__str__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the MLIR Module string representation for this kernel.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator.compile">
+<span class="sig-name descname"><span class="pre">compile</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator.compile" title="Permalink to this definition">¶</a></dt>
+<dd><p>Compile the Python function AST to MLIR. This is a no-op
+if the kernel is already compiled.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">jStr</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">overrideDict</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator.from_json" title="Permalink to this definition">¶</a></dt>
+<dd><p>Convert a JSON string into a new PyKernelDecorator object.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator.to_json" title="Permalink to this definition">¶</a></dt>
+<dd><p>Convert <code class="code docutils literal notranslate"><span class="pre">self</span></code> to a JSON-serialized version of the kernel such that
+<code class="code docutils literal notranslate"><span class="pre">from_json</span></code> can reconstruct it elsewhere.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PyKernelDecorator.type_to_str">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">type_to_str</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PyKernelDecorator.type_to_str" title="Permalink to this definition">¶</a></dt>
+<dd><p>This converts types to strings in a clean JSON-compatible way.
+int -&gt; ‘int’
+list[float] -&gt; ‘list[float]’
+List[float] -&gt; ‘list[float]’</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.kernel">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">kernel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.kernel" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">cudaq.kernel</span></code> represents the CUDA-Q language function
+attribute that programmers leverage to indicate the following function
+is a CUDA-Q kernel and should be compile and executed on
+an available quantum coprocessor.</p>
+<p>Verbose logging can be enabled via <code class="code docutils literal notranslate"><span class="pre">verbose=True</span></code>.</p>
+</dd></dl>
+
+</section>
+<section id="kernel-execution">
+<h2>Kernel Execution<a class="headerlink" href="#kernel-execution" title="Permalink to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.sample">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">sample</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots_count</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1000</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">noise_model</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.sample" title="Permalink to this definition">¶</a></dt>
+<dd><p>Sample the state generated by the provided <code class="code docutils literal notranslate"><span class="pre">kernel</span></code> at the given kernel
+<code class="code docutils literal notranslate"><span class="pre">arguments</span></code> over the specified number of circuit executions (<code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>).
+Each argument in <code class="code docutils literal notranslate"><span class="pre">arguments</span></code> provided can be a list or <code class="code docutils literal notranslate"><span class="pre">ndarray</span></code> of arguments
+of the specified kernel argument type, and in this case, the <code class="code docutils literal notranslate"><span class="pre">sample</span></code>
+functionality will be broadcasted over all argument sets and a list of
+<code class="code docutils literal notranslate"><span class="pre">sample_result</span></code> instances will be returned.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to execute <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>
+times on the QPU.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments. For
+example, if the kernel takes two <code class="code docutils literal notranslate"><span class="pre">float</span></code> values as input, the <code class="code docutils literal notranslate"><span class="pre">sample</span></code> call
+should be structured as <code class="code docutils literal notranslate"><span class="pre">cudaq.sample(kernel,</span> <span class="pre">firstFloat,</span> <span class="pre">secondFloat)</span></code>. For
+broadcasting of the <code class="code docutils literal notranslate"><span class="pre">sample</span></code> function, the arguments should be structured as a
+<code class="code docutils literal notranslate"><span class="pre">list</span></code> or <code class="code docutils literal notranslate"><span class="pre">ndarray</span></code> of argument values of the specified kernel argument type.</p></li>
+<li><p><strong>shots_count</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The number of kernel executions on the QPU.
+Defaults to 1000. Key-word only.</p></li>
+<li><p><strong>noise_model</strong> (Optional[<code class="code docutils literal notranslate"><span class="pre">NoiseModel</span></code>]) – The optional <a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.NoiseModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">NoiseModel</span></code></a>
+to add noise to the kernel execution on the simulator. Defaults to
+an empty noise model.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A dictionary containing the measurement count results for the <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>,
+or a list of such results in the case of <code class="code docutils literal notranslate"><span class="pre">sample</span></code> function broadcasting.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> or <code class="code docutils literal notranslate"><span class="pre">list[SampleResult]</span></code></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.sample_async">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">sample_async</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.sample_async" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">sample_async</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots_count:</span> <span class="pre">int</span> <span class="pre">=</span> <span class="pre">1000</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">qpu_id:</span> <span class="pre">int</span> <span class="pre">=</span> <span class="pre">0</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.AsyncSampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncSampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncSampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Asynchronously sample the state of the provided <code class="code docutils literal notranslate"><span class="pre">kernel</span></code> at the
+specified number of circuit executions (<code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>).
+When targeting a quantum platform with more than one QPU, the optional
+<code class="code docutils literal notranslate"><span class="pre">qpu_id</span></code> allows for control over which QPU to enable. Will return a
+future whose results can be retrieved via <code class="code docutils literal notranslate"><span class="pre">future.get()</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to execute <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>
+times on the QPU.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+<li><p><strong>shots_count</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The number of kernel executions on the
+QPU. Defaults to 1000. Key-word only.</p></li>
+<li><p><strong>qpu_id</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The optional identification for which QPU
+on the platform to target. Defaults to zero. Key-word only.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A dictionary containing the measurement count results for the <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.AsyncSampleResult" title="cudaq.AsyncSampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.observe">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">observe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_operator</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots_count</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">0</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">noise_model</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">execution</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.observe" title="Permalink to this definition">¶</a></dt>
+<dd><p>Compute the expected value of the <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> with respect to
+the <code class="code docutils literal notranslate"><span class="pre">kernel</span></code>. If the input <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> is a list of <code class="code docutils literal notranslate"><span class="pre">SpinOperator</span></code> then compute
+the expected value of every operator in the list and return a list of results.
+If the kernel accepts arguments, it will be evaluated
+with respect to <code class="code docutils literal notranslate"><span class="pre">kernel(*arguments)</span></code>. Each argument in <code class="code docutils literal notranslate"><span class="pre">arguments</span></code> provided
+can be a list or <code class="code docutils literal notranslate"><span class="pre">ndarray</span></code> of arguments of the specified kernel argument
+type, and in this case, the <code class="code docutils literal notranslate"><span class="pre">observe</span></code> functionality will be broadcasted over
+all argument sets and a list of <code class="code docutils literal notranslate"><span class="pre">observe_result</span></code> instances will be returned.
+If both the input <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> and <code class="code docutils literal notranslate"><span class="pre">arguments</span></code> are broadcast lists,
+a nested list of results over <code class="code docutils literal notranslate"><span class="pre">arguments</span></code> then <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> will be returned.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to evaluate the
+expectation value with respect to.</p></li>
+<li><p><strong>spin_operator</strong> (<a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> or <code class="code docutils literal notranslate"><span class="pre">list[SpinOperator]</span></code>) – The Hermitian spin operator to
+calculate the expectation of, or a list of such operators.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the
+kernel function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+<li><p><strong>shots_count</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The number of shots to use for QPU
+execution. Defaults to -1 implying no shots-based sampling. Key-word only.</p></li>
+<li><p><strong>noise_model</strong> (Optional[<code class="code docutils literal notranslate"><span class="pre">NoiseModel</span></code>]) – The optional <a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.NoiseModel"><code class="xref py py-class docutils literal notranslate"><span class="pre">NoiseModel</span></code></a> to add
+noise to the kernel execution on the simulator. Defaults to an empty
+noise model.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A data-type containing the expectation value of the <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> with
+respect to the <code class="code docutils literal notranslate"><span class="pre">kernel(*arguments)</span></code>, or a list of such results in the case
+of <code class="code docutils literal notranslate"><span class="pre">observe</span></code> function broadcasting. If <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code> was provided, the
+<a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.ObserveResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">ObserveResult</span></code></a> will also contain a <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> dictionary.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.ObserveResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.observe_async">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">observe_async</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.observe_async" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">observe_async</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_operator:</span> <span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">qpu_id:</span> <span class="pre">int</span> <span class="pre">=</span> <span class="pre">0</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots_count:</span> <span class="pre">int</span> <span class="pre">=</span> <span class="pre">-1</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.AsyncObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncObserveResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Compute the expected value of the <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> with respect to
+the <code class="code docutils literal notranslate"><span class="pre">kernel</span></code> asynchronously. If the kernel accepts arguments, it will
+be evaluated with respect to <code class="code docutils literal notranslate"><span class="pre">kernel(*arguments)</span></code>. When targeting a
+quantum platform with more than one QPU, the optional <code class="code docutils literal notranslate"><span class="pre">qpu_id</span></code> allows
+for control over which QPU to enable. Will return a future whose results
+can be retrieved via <code class="code docutils literal notranslate"><span class="pre">future.get()</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to evaluate the
+expectation value with respect to.</p></li>
+<li><p><strong>spin_operator</strong> (<a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>) – The Hermitian spin operator to
+calculate the expectation of.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the
+kernel function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+<li><p><strong>qpu_id</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The optional identification for which QPU on
+the platform to target. Defaults to zero. Key-word only.</p></li>
+<li><p><strong>shots_count</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The number of shots to use for QPU
+execution. Defaults to -1 implying no shots-based sampling. Key-word only.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A future containing the result of the call to observe.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.AsyncObserveResult" title="cudaq.AsyncObserveResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.get_state">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_state</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.get_state" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_state</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <a class="reference internal" href="#cudaq.State" title="cudaq.State"><code class="xref py py-class docutils literal notranslate"><span class="pre">State</span></code></a> of the system after execution of the provided <code class="code docutils literal notranslate"><span class="pre">kernel</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to execute on the QPU.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+</ul>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># Define a kernel that will produced the all |11...1&gt; state.</span>
+<span class="n">kernel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+<span class="n">qubits</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span>
+<span class="c1"># Prepare qubits in the 1-state.</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+<span class="c1"># Get the state of the system. This will execute the provided kernel</span>
+<span class="c1"># and, depending on the selected target, will return the state as a</span>
+<span class="c1"># vector or matrix.</span>
+<span class="n">state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="p">)</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.get_state_async">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_state_async</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.get_state_async" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_state_async</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">qpu_id:</span> <span class="pre">int</span> <span class="pre">=</span> <span class="pre">0</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.AsyncStateResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncStateResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncStateResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Asynchronously retrieve the state generated by the given quantum kernel.
+When targeting a quantum platform with more than one QPU, the optional
+<code class="code docutils literal notranslate"><span class="pre">qpu_id</span></code> allows for control over which QPU to enable. Will return a
+future whose results can be retrieved via <code class="code docutils literal notranslate"><span class="pre">future.get()</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to execute on the QPU.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+<li><p><strong>qpu_id</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The optional identification for which QPU
+on the platform to target. Defaults to zero. Key-word only.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>Quantum state (state vector or density matrix) data).</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.AsyncStateResult" title="cudaq.AsyncStateResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.vqe">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">vqe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.vqe" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">vqe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel</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#object" title="(in Python v3.12)"><span class="pre">object</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_operator</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">optimizer</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.optimizer" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots</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.12)"><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">-1</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">vqe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel</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#object" title="(in Python v3.12)"><span class="pre">object</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_operator</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">optimizer</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.optimizer" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">argument_mapper</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots</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.12)"><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">-1</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">vqe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel</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#object" title="(in Python v3.12)"><span class="pre">object</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">gradient_strategy</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.gradient" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_operator</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">optimizer</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.optimizer" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots</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.12)"><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">-1</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">vqe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel</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#object" title="(in Python v3.12)"><span class="pre">object</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">gradient_strategy</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.gradient" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">spin_operator</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">optimizer</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.optimizer" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.optimizer</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">argument_mapper</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shots</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.12)"><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">-1</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.draw">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">draw</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.draw" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">draw</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0:</span> <span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg1:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a string representing the drawing of the execution path,
+in the format specified as the first argument. If the format is
+‘ascii’, the output will be a UTF-8 encoded string. If the format
+is ‘latex’, the output will be a LaTeX string.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>format</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The format of the output. Can be ‘ascii’ or ‘latex’.</p></li>
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to draw.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+</ul>
+</dd>
+</dl>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">draw</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a UTF-8 encoded string representing drawing of the execution
+path, i.e., the trace, of the provided <code class="code docutils literal notranslate"><span class="pre">kernel</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to draw.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The UTF-8 encoded string of the circuit, without measurement operations.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">bell_pair</span><span class="p">():</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">cx</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">bell_pair</span><span class="p">))</span>
+<span class="c1"># Output</span>
+<span class="c1">#      ╭───╮</span>
+<span class="c1"># q0 : ┤ h ├──●──</span>
+<span class="c1">#      ╰───╯╭─┴─╮</span>
+<span class="c1"># q1 : ─────┤ x ├</span>
+<span class="c1">#           ╰───╯</span>
+
+<span class="c1"># Example with arguments</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angle</span><span class="p">:</span><span class="nb">float</span><span class="p">):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="mf">0.59</span><span class="p">))</span>
+<span class="c1"># Output</span>
+<span class="c1">#      ╭───╮╭──────────╮</span>
+<span class="c1"># q0 : ┤ h ├┤ ry(0.59) ├</span>
+<span class="c1">#      ╰───╯╰──────────╯</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.translate">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">translate</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.translate" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">translate</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">kernel:</span> <span class="pre">object</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*args</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">format:</span> <span class="pre">str</span> <span class="pre">=</span> <span class="pre">'qir'</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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a UTF-8 encoded string representing drawing of the execution
+path, i.e., the trace, of the provided <code class="code docutils literal notranslate"><span class="pre">kernel</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>format</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – format to translate to. Available formats: <code class="code docutils literal notranslate"><span class="pre">qir</span></code>, <code class="code docutils literal notranslate"><span class="pre">qir-base</span></code>,
+<code class="code docutils literal notranslate"><span class="pre">qir-adaptive</span></code>, <code class="code docutils literal notranslate"><span class="pre">openqasm2</span></code>.</p></li>
+<li><p><strong>kernel</strong> (<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>) – The <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> to translate.</p></li>
+<li><p><strong>*arguments</strong> (<em>Optional</em><em>[</em><em>Any</em><em>]</em>) – The concrete values to evaluate the kernel
+function at. Leave empty if the kernel doesn’t accept any arguments.</p></li>
+<li><p><strong>Note</strong> – Translating functions with arguments to OpenQASM 2.0 is not supported.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The UTF-8 encoded string of the circuit, without measurement operations.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">bell_pair</span><span class="p">():</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">cx</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">translate</span><span class="p">(</span><span class="n">bell_pair</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="s2">&quot;qir&quot;</span><span class="p">))</span>
+
+<span class="c1"># Output</span>
+<span class="p">;</span> <span class="n">ModuleID</span> <span class="o">=</span> <span class="s1">&#39;LLVMDialectModule&#39;</span>
+<span class="n">source_filename</span> <span class="o">=</span> <span class="s1">&#39;LLVMDialectModule&#39;</span>
+
+<span class="o">%</span><span class="n">Array</span> <span class="o">=</span> <span class="nb">type</span> <span class="n">opaque</span>
+<span class="o">%</span><span class="n">Result</span> <span class="o">=</span> <span class="nb">type</span> <span class="n">opaque</span>
+<span class="o">%</span><span class="n">Qubit</span> <span class="o">=</span> <span class="nb">type</span> <span class="n">opaque</span>
+
+<span class="o">...</span>
+<span class="o">...</span>
+
+<span class="n">define</span> <span class="n">void</span> <span class="nd">@__nvqpp__mlirgen__function_variable_qreg</span><span class="o">.</span><span class="n">_Z13variable_qregv</span><span class="p">()</span> <span class="n">local_unnamed_addr</span> <span class="p">{</span>
+  <span class="o">%</span><span class="mi">1</span> <span class="o">=</span> <span class="n">tail</span> <span class="n">call</span> <span class="o">%</span><span class="n">Array</span><span class="o">*</span> <span class="nd">@__quantum__rt__qubit_allocate_array</span><span class="p">(</span><span class="n">i64</span> <span class="mi">2</span><span class="p">)</span>
+  <span class="o">...</span>
+  <span class="o">%</span><span class="mi">8</span> <span class="o">=</span> <span class="n">tail</span> <span class="n">call</span> <span class="o">%</span><span class="n">Result</span><span class="o">*</span> <span class="nd">@__quantum__qis__mz</span><span class="p">(</span><span class="o">%</span><span class="n">Qubit</span><span class="o">*</span> <span class="o">%</span><span class="mi">4</span><span class="p">)</span>
+  <span class="o">%</span><span class="mi">9</span> <span class="o">=</span> <span class="n">tail</span> <span class="n">call</span> <span class="o">%</span><span class="n">Result</span><span class="o">*</span> <span class="nd">@__quantum__qis__mz</span><span class="p">(</span><span class="o">%</span><span class="n">Qubit</span><span class="o">*</span> <span class="o">%</span><span class="mi">7</span><span class="p">)</span>
+  <span class="n">tail</span> <span class="n">call</span> <span class="n">void</span> <span class="nd">@__quantum__rt__qubit_release_array</span><span class="p">(</span><span class="o">%</span><span class="n">Array</span><span class="o">*</span> <span class="o">%</span><span class="mi">1</span><span class="p">)</span>
+  <span class="n">ret</span> <span class="n">void</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</dd></dl>
+
+</section>
+<section id="backend-configuration">
+<h2>Backend Configuration<a class="headerlink" href="#backend-configuration" title="Permalink to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.has_target">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">has_target</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.has_target" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">has_target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return true if the <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> with the given name exists.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.get_target">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.get_target" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> with the given name. Will raise an exception if the name is not valid.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_target</span></span><span class="sig-paren">(</span><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.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> with the given name. Will raise an exception if the name is not valid.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.get_targets">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_targets</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.get_targets" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">get_targets</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cudaq.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return all available <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> instances on the current system.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.set_target">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.set_target" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0:</span> <span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*\*kwargs</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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Set the <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> to be used for CUDA-Q kernel execution. Can provide optional, target-specific configuration data via Python kwargs.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_target</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0:</span> <span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">\*\*kwargs</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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Set the <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> with given name to be used for CUDA-Q kernel execution. Can provide optional, target-specific configuration data via Python kwargs.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.reset_target">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">reset_target</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.reset_target" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">reset_target</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Reset the current <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> to the default.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.set_noise">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_noise</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.set_noise" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_noise</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.NoiseModel"><span class="pre">cudaq.NoiseModel</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Set the underlying noise model.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.unset_noise">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">unset_noise</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.unset_noise" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">unset_noise</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Clear backend simulation from any existing noise models.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.initialize_cudaq">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">initialize_cudaq</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.initialize_cudaq" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">initialize_cudaq</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">\*\*kwargs</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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Initialize the CUDA-Q environment.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.num_available_gpus">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">num_available_gpus</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.num_available_gpus" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">num_available_gpus</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>The number of available GPUs detected on the system.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.set_random_seed">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_random_seed</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.set_random_seed" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">set_random_seed</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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.12)"><span class="pre">int</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Provide the seed for backend quantum kernel simulation.</p>
+</dd></dl>
+
+</section>
+<section id="data-types">
+<h2>Data Types<a class="headerlink" href="#data-types" title="Permalink to this heading">¶</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.SimulationPrecision">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">SimulationPrecision</span></span><a class="headerlink" href="#cudaq.SimulationPrecision" title="Permalink to this definition">¶</a></dt>
+<dd><p>Enumeration describing the precision of the underyling simulation.</p>
+<p>Members:</p>
+<blockquote>
+<div><p>fp32</p>
+<p>fp64</p>
+</div></blockquote>
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.SimulationPrecision.name">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">name</span></span><a class="headerlink" href="#cudaq.SimulationPrecision.name" title="Permalink to this definition">¶</a></dt>
+<dd><p>object) -&gt; str
+:noindex:</p>
+<dl class="field-list">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">name(self</span></span></dt>
+<dd></dd></dl>
+
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.Target">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">Target</span></span><a class="headerlink" href="#cudaq.Target" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> represents the underlying infrastructure that CUDA-Q kernels will execute on. Instances of <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> describe what simulator they may leverage, the quantum_platform required for execution, and a description for the target.</p>
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.Target.description">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">description</span></span><a class="headerlink" href="#cudaq.Target.description" title="Permalink to this definition">¶</a></dt>
+<dd><p>A string describing the features for this <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.Target.get_precision">
+<span class="sig-name descname"><span class="pre">get_precision</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.Target.get_precision" 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">get_precision</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a></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.SimulationPrecision" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SimulationPrecision"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SimulationPrecision</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the simulation precision for the current target.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.Target.is_emulated">
+<span class="sig-name descname"><span class="pre">is_emulated</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.Target.is_emulated" 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">is_emulated</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns true if the emulation mode for the target has been activated.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.Target.is_remote">
+<span class="sig-name descname"><span class="pre">is_remote</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.Target.is_remote" 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">is_remote</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns true if the target consists of a remote REST QPU.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.Target.name">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">name</span></span><a class="headerlink" href="#cudaq.Target.name" title="Permalink to this definition">¶</a></dt>
+<dd><p>The name of the <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.Target.num_qpus">
+<span class="sig-name descname"><span class="pre">num_qpus</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.Target.num_qpus" 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">num_qpus</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.Target" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Target</span></a></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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the number of QPUs available in this <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code>.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.Target.platform">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">platform</span></span><a class="headerlink" href="#cudaq.Target.platform" title="Permalink to this definition">¶</a></dt>
+<dd><p>The name of the quantum_platform implementation this <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> leverages.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.Target.simulator">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">simulator</span></span><a class="headerlink" href="#cudaq.Target.simulator" title="Permalink to this definition">¶</a></dt>
+<dd><p>The name of the simulator this <code class="code docutils literal notranslate"><span class="pre">cudaq.Target</span></code> leverages. This will be empty for physical QPUs.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.State">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">State</span></span><a class="headerlink" href="#cudaq.State" title="Permalink to this definition">¶</a></dt>
+<dd><p>A data-type representing the quantum state of the internal simulator. This type is not user-constructible and instances can only be retrieved via the <code class="code docutils literal notranslate"><span class="pre">cudaq.get_state(...)</span></code> function or the static cudaq.State.from_data() method.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.amplitude">
+<span class="sig-name descname"><span class="pre">amplitude</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.amplitude" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">amplitude</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the amplitude of a state in computational basis.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="c1"># Create a simulation state.</span>
+<span class="n">state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># Return the amplitude of |0101&gt;, assuming this is a 4-qubit state.</span>
+<span class="n">amplitude</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">amplitude</span><span class="p">([</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">])</span>
+</pre></div>
+</div>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">amplitude</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the amplitude of a state in computational basis.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="c1"># Create a simulation state.</span>
+<span class="n">state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># Return the amplitude of |0101&gt;, assuming this is a 4-qubit state.</span>
+<span class="n">amplitude</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">amplitude</span><span class="p">(</span><span class="s1">&#39;0101&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.amplitudes">
+<span class="sig-name descname"><span class="pre">amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.amplitudes" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the amplitude of a list of states in computational basis.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="c1"># Create a simulation state.</span>
+<span class="n">state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># Return the amplitude of |0101&gt; and |1010&gt;, assuming this is a 4-qubit state.</span>
+<span class="n">amplitudes</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">amplitudes</span><span class="p">([[</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">],</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">,</span><span class="mi">0</span><span class="p">]])</span>
+</pre></div>
+</div>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">amplitudes</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the amplitudes of a list of states in computational basis.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="c1"># Create a simulation state.</span>
+<span class="n">state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># Return the amplitudes of |0101&gt; and |1010&gt;, assuming this is a 4-qubit state.</span>
+<span class="n">amplitudes</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">amplitudes</span><span class="p">([</span><span class="s1">&#39;0101&#39;</span><span class="p">,</span> <span class="s1">&#39;1010&#39;</span><span class="p">])</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.dump">
+<span class="sig-name descname"><span class="pre">dump</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.dump" 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">dump</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Print the state to the console.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.from_data">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.from_data" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">from_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="(in NumPy v2.1)"><span class="pre">numpy.ndarray</span></a></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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a state from data.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">from_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="(in NumPy v2.1)"><span class="pre">numpy.ndarray</span></a><span class="p"><span class="pre">]</span></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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a state from matrix product state tensor data.</p>
+<ol class="arabic" start="3">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">from_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cudaq.Tensor" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Tensor"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Tensor</span></a><span class="p"><span class="pre">]</span></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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a state from matrix product state tensor data.</p>
+<ol class="arabic" start="4">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">from_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#object" title="(in Python v3.12)"><span class="pre">object</span></a><span class="p"><span class="pre">]</span></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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a state from matrix product state tensor data (as CuPy ndarray).</p>
+<ol class="arabic" start="5">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">from_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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#object" title="(in Python v3.12)"><span class="pre">object</span></a></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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return a state from CuPy device array.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.getTensor">
+<span class="sig-name descname"><span class="pre">getTensor</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.getTensor" 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">getTensor</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">idx</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.12)"><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">0</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.Tensor" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Tensor"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Tensor</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <code class="code docutils literal notranslate"><span class="pre">idx</span></code> tensor making up this state representation.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.getTensors">
+<span class="sig-name descname"><span class="pre">getTensors</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.getTensors" 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">getTensors</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cudaq.Tensor" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Tensor"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.Tensor</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return all the tensors that comprise this state representation.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.is_on_gpu">
+<span class="sig-name descname"><span class="pre">is_on_gpu</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.is_on_gpu" 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">is_on_gpu</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return True if this state is on the GPU.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.num_qubits">
+<span class="sig-name descname"><span class="pre">num_qubits</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.num_qubits" 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">num_qubits</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns the number of qubits represented by this state.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.State.overlap">
+<span class="sig-name descname"><span class="pre">overlap</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.State.overlap" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">overlap</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Compute the overlap between the provided <a class="reference internal" href="#cudaq.State" title="cudaq.State"><code class="xref py py-class docutils literal notranslate"><span class="pre">State</span></code></a>’s.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">overlap</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="(in NumPy v2.1)"><span class="pre">numpy.ndarray</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Compute the overlap between the provided <a class="reference internal" href="#cudaq.State" title="cudaq.State"><code class="xref py py-class docutils literal notranslate"><span class="pre">State</span></code></a>’s.</p>
+<ol class="arabic" start="3">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">overlap</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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#object" title="(in Python v3.12)"><span class="pre">object</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Compute overlap with general CuPy device array.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.Tensor">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">Tensor</span></span><a class="headerlink" href="#cudaq.Tensor" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">Tensor</span></code> describes a pointer to simulation data as well as the rank and extents for that tensorial data it represents.</p>
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.QuakeValue">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">QuakeValue</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">mlirValue</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">pyKernel</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">size</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue" title="Permalink to this definition">¶</a></dt>
+<dd><p>A <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> represents a handle to an individual function
+argument of a <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a>, or a return value from an operation within
+it. As documented in <a class="reference internal" href="#cudaq.make_kernel" title="cudaq.make_kernel"><code class="xref py py-func docutils literal notranslate"><span class="pre">make_kernel()</span></code></a>, a <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> can hold
+values of the following types: int, float, list/List, <a class="reference internal" href="#cudaq.qubit" title="cudaq.qubit"><code class="xref py py-class docutils literal notranslate"><span class="pre">qubit</span></code></a>, or
+<a class="reference internal" href="#cudaq.qvector" title="cudaq.qvector"><code class="xref py py-class docutils literal notranslate"><span class="pre">qvector</span></code></a>. The <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> can also hold kernel operations
+such as qubit allocations and measurements.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__add__">
+<span class="sig-name descname"><span class="pre">__add__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">other</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__add__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the sum of <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>) and <code class="code docutils literal notranslate"><span class="pre">other</span></code> (float).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="n">value</span> <span class="o">+</span> <span class="mf">5.0</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__radd__">
+<span class="sig-name descname"><span class="pre">__radd__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">other</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__radd__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the sum of <code class="code docutils literal notranslate"><span class="pre">other</span></code> (float) and <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="mf">5.0</span> <span class="o">+</span> <span class="n">value</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__sub__">
+<span class="sig-name descname"><span class="pre">__sub__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">other</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__sub__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the difference of <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>) and <code class="code docutils literal notranslate"><span class="pre">other</span></code> (float).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="n">value</span> <span class="o">-</span> <span class="mf">5.0</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__rsub__">
+<span class="sig-name descname"><span class="pre">__rsub__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">other</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__rsub__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the difference of <code class="code docutils literal notranslate"><span class="pre">other</span></code> (float) and <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="mf">5.0</span> <span class="o">-</span> <span class="n">value</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__neg__">
+<span class="sig-name descname"><span class="pre">__neg__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__neg__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the negation of <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="o">-</span><span class="n">value</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__mul__">
+<span class="sig-name descname"><span class="pre">__mul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">other</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__mul__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the product of <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>) with <code class="code docutils literal notranslate"><span class="pre">other</span></code> (float).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="n">value</span> <span class="o">*</span> <span class="mf">5.0</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__rmul__">
+<span class="sig-name descname"><span class="pre">__rmul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">other</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__rmul__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the product of <code class="code docutils literal notranslate"><span class="pre">other</span></code> (float) with <code class="code docutils literal notranslate"><span class="pre">self</span></code> (<a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Raises<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if the underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> type is not a float.</p>
+</dd>
+</dl>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">new_value</span><span class="p">:</span> <span class="n">QuakeValue</span> <span class="o">=</span> <span class="mf">5.0</span> <span class="o">*</span> <span class="n">value</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.__getitem__">
+<span class="sig-name descname"><span class="pre">__getitem__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">idx</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.__getitem__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the element of <code class="code docutils literal notranslate"><span class="pre">self</span></code> at the provided <code class="code docutils literal notranslate"><span class="pre">index</span></code>.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Only <code class="code docutils literal notranslate"><span class="pre">list</span></code> or <a class="reference internal" href="#cudaq.qvector" title="cudaq.qvector"><code class="xref py py-class docutils literal notranslate"><span class="pre">qvector</span></code></a> type <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>’s may be indexed.</p>
+</div>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>index</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a>) – The element of <code class="code docutils literal notranslate"><span class="pre">self</span></code> that you’d like to return.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A new <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> for the <code class="code docutils literal notranslate"><span class="pre">index</span></code> element of <code class="code docutils literal notranslate"><span class="pre">self</span></code>.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></p>
+</dd>
+<dt class="field-even">Raises<span class="colon">:</span></dt>
+<dd class="field-even"><p><a class="reference external" href="https://docs.python.org/3/library/exceptions.html#RuntimeError" title="(in Python v3.12)"><strong>RuntimeError</strong></a> – if <code class="code docutils literal notranslate"><span class="pre">self</span></code> is a non-subscriptable <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>.</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.QuakeValue.slice">
+<span class="sig-name descname"><span class="pre">slice</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">startIdx</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">count</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.QuakeValue.slice" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return a slice of the given <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> as a new <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a>.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The underlying <a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a> must be a <code class="code docutils literal notranslate"><span class="pre">list</span></code> or <code class="code docutils literal notranslate"><span class="pre">veq</span></code>.</p>
+</div>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>start</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a>) – The index to begin the slice from.</p></li>
+<li><p><strong>count</strong> (<a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a>) – The number of elements to extract after the <code class="code docutils literal notranslate"><span class="pre">start</span></code> index.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A new <code class="code docutils literal notranslate"><span class="pre">QuakeValue</span></code> containing a slice of <code class="code docutils literal notranslate"><span class="pre">self</span></code>
+from the <code class="code docutils literal notranslate"><span class="pre">start</span></code> element to the <code class="code docutils literal notranslate"><span class="pre">start</span> <span class="pre">+</span> <span class="pre">count</span></code> element.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.QuakeValue" title="cudaq.QuakeValue"><code class="xref py py-class docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.qubit">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">qubit</span></span><a class="headerlink" href="#cudaq.qubit" title="Permalink to this definition">¶</a></dt>
+<dd><p>The qubit is the primary unit of information in a quantum computer. Qubits can be created individually or as part of larger registers.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="cudaq.qreg">
+<span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">qreg</span></span><a class="headerlink" href="#cudaq.qreg" title="Permalink to this definition">¶</a></dt>
+<dd><p>alias of <a class="reference internal" href="#cudaq.qvector" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.qvector"><code class="xref py py-class docutils literal notranslate"><span class="pre">qvector</span></code></a></p>
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.qvector">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">qvector</span></span><a class="headerlink" href="#cudaq.qvector" title="Permalink to this definition">¶</a></dt>
+<dd><p>An owning, dynamically sized container for qubits. The semantics of the <code class="code docutils literal notranslate"><span class="pre">qvector</span></code> follows that of a <code class="code docutils literal notranslate"><span class="pre">std::vector</span></code> or <code class="code docutils literal notranslate"><span class="pre">list</span></code> for qubits.</p>
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.ComplexMatrix">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">ComplexMatrix</span></span><a class="headerlink" href="#cudaq.ComplexMatrix" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.ComplexMatrix"><code class="xref py py-class docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a> is a thin wrapper around a matrix of complex&lt;double&gt; elements.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ComplexMatrix.__getitem__">
+<span class="sig-name descname"><span class="pre">__getitem__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ComplexMatrix.__getitem__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__getitem__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg1</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.12)"><span class="pre">int</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the matrix element at i, j.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__getitem__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the matrix element at i, j.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ComplexMatrix.__str__">
+<span class="sig-name descname"><span class="pre">__str__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ComplexMatrix.__str__" 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">__str__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Write this matrix to a string representation.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ComplexMatrix.minimal_eigenvalue">
+<span class="sig-name descname"><span class="pre">minimal_eigenvalue</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ComplexMatrix.minimal_eigenvalue" 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">minimal_eigenvalue</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the lowest eigenvalue for this <a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.ComplexMatrix"><code class="xref py py-class docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.SpinOperator">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">SpinOperator</span></span><a class="headerlink" href="#cudaq.SpinOperator" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__eq__">
+<span class="sig-name descname"><span class="pre">__eq__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__eq__" 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">__eq__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return true if the two <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>’s are equal. Equality does not consider the coefficients.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__add__">
+<span class="sig-name descname"><span class="pre">__add__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__add__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__add__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Add the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> to this one and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__add__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Add a double to the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__radd__">
+<span class="sig-name descname"><span class="pre">__radd__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__radd__" 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">__radd__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Add a <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> to the given double and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__sub__">
+<span class="sig-name descname"><span class="pre">__sub__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__sub__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__sub__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Subtract the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> from this one and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__sub__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Subtract a double from the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__rsub__">
+<span class="sig-name descname"><span class="pre">__rsub__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__rsub__" 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">__rsub__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Subtract a <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> from the given double and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__mul__">
+<span class="sig-name descname"><span class="pre">__mul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__mul__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__mul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Multiply the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>’s together and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__mul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Multiply the <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> by the given double and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+<ol class="arabic" start="3">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__mul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Multiply the <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> by the given complex value and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__rmul__">
+<span class="sig-name descname"><span class="pre">__rmul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__rmul__" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__rmul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Multiply the double by the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">__rmul__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">other</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#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Multiply the complex value by the given <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> and return result as a new <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.__iter__">
+<span class="sig-name descname"><span class="pre">__iter__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.__iter__" 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">__iter__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Iterator</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Loop through each term of this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.distribute_terms">
+<span class="sig-name descname"><span class="pre">distribute_terms</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.distribute_terms" 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">distribute_terms</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">chunk_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.12)"><span class="pre">int</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a list of <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> representing a distribution of the terms in this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> into <code class="code docutils literal notranslate"><span class="pre">chunk_count</span></code> sized chunks.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.dump">
+<span class="sig-name descname"><span class="pre">dump</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.dump" 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">dump</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Print a string representation of this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.for_each_pauli">
+<span class="sig-name descname"><span class="pre">for_each_pauli</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.for_each_pauli" 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">for_each_pauli</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>For a single <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> term, apply the given function to each pauli element in the term. The function must have <code class="code docutils literal notranslate"><span class="pre">void(pauli,</span> <span class="pre">int)</span></code> signature where <code class="code docutils literal notranslate"><span class="pre">pauli</span></code> is the Pauli matrix type and the <code class="code docutils literal notranslate"><span class="pre">int</span></code> is the qubit index.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.for_each_term">
+<span class="sig-name descname"><span class="pre">for_each_term</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.for_each_term" 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">for_each_term</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Apply the given function to all terms in this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>. The input function must have <code class="code docutils literal notranslate"><span class="pre">void(SpinOperator)</span></code> signature.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string (‘[[d1, d2, d3, …], numQubits]’) to spin_op</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.from_word">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_word</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.from_word" 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">from_word</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">word</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> corresponding to the provided Pauli <code class="code docutils literal notranslate"><span class="pre">word</span></code>.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example:</span>
+<span class="c1"># The first and third qubits will receive a Pauli X,</span>
+<span class="c1"># while the second qubit will receive a Pauli Y.</span>
+<span class="n">word</span> <span class="o">=</span> <span class="s2">&quot;XYX&quot;</span>
+<span class="c1"># Convert word to spin operator.</span>
+<span class="n">spin_operator</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="o">.</span><span class="n">from_word</span><span class="p">(</span><span class="n">word</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">spin_operator</span><span class="p">)</span> <span class="c1"># prints: `[1+0j] XYX`</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.get_coefficient">
+<span class="sig-name descname"><span class="pre">get_coefficient</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.get_coefficient" 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">get_coefficient</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the coefficient of this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>. Must be a <code class="code docutils literal notranslate"><span class="pre">SpinOperator</span></code> with one term, otherwise an exception is thrown.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.get_qubit_count">
+<span class="sig-name descname"><span class="pre">get_qubit_count</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.get_qubit_count" 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">get_qubit_count</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the number of qubits this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> is on.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.get_raw_data">
+<span class="sig-name descname"><span class="pre">get_raw_data</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.get_raw_data" 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">get_raw_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the raw data of this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.get_term_count">
+<span class="sig-name descname"><span class="pre">get_term_count</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.get_term_count" 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">get_term_count</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the number of terms in this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.is_identity">
+<span class="sig-name descname"><span class="pre">is_identity</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.is_identity" 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">is_identity</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns a bool indicating if this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> is equal to the identity.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.random">
+<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.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.12)"><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.12)"><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.12)"><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">2475644365</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.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a random <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> on the given number of qubits (<code class="code docutils literal notranslate"><span class="pre">qubit_count</span></code>) and composed of the given number of terms (<code class="code docutils literal notranslate"><span class="pre">term_count</span></code>). An optional seed value may also be provided.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.serialize">
+<span class="sig-name descname"><span class="pre">serialize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.serialize" 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">serialize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a serialized representation of the <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>. Specifically, this encoding is via a vector of doubles. The encoding is as follows: for each term, a list of doubles where the ith element is a 3.0 for a Y, a 1.0 for a X, and a 2.0 for a Z on qubit i, followed by the real and imaginary part of the coefficient. Each term is appended to the array forming one large 1d array of doubles. The array is ended with the total number of terms represented as a double.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#object" title="(in Python v3.12)"><span class="pre">object</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert spin_op to JSON string: ‘[[d1, d2, d3, …], numQubits]’</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.to_matrix">
+<span class="sig-name descname"><span class="pre">to_matrix</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.to_matrix" 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">to_matrix</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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.ComplexMatrix" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ComplexMatrix</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return <code class="code docutils literal notranslate"><span class="pre">self</span></code> as a <a class="reference internal" href="#cudaq.ComplexMatrix" title="cudaq.ComplexMatrix"><code class="xref py py-class docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.to_sparse_matrix">
+<span class="sig-name descname"><span class="pre">to_sparse_matrix</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.to_sparse_matrix" 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">to_sparse_matrix</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#complex" title="(in Python v3.12)"><span class="pre">complex</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return <code class="code docutils literal notranslate"><span class="pre">self</span></code> as a sparse matrix. This representation is a <code class="code docutils literal notranslate"><span class="pre">Tuple[list[complex],</span> <span class="pre">list[int],</span> <span class="pre">list[int]]</span></code>, encoding the non-zero values, rows, and columns of the matrix. This format is supported by <code class="code docutils literal notranslate"><span class="pre">scipy.sparse.csr_array</span></code>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SpinOperator.to_string">
+<span class="sig-name descname"><span class="pre">to_string</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SpinOperator.to_string" 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">to_string</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SpinOperator</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">print_coefficient</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#bool" title="(in Python v3.12)"><span class="pre">bool</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">True</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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a string representation of this <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.spin.i">
+<span class="sig-prename descclassname"><span class="pre">spin.</span></span><span class="sig-name descname"><span class="pre">i</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.spin.i" 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">i</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">target</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.12)"><span class="pre">int</span></a></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.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return an identity <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> on the given target qubit index.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.spin.x">
+<span class="sig-prename descclassname"><span class="pre">spin.</span></span><span class="sig-name descname"><span class="pre">x</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.spin.x" 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">x</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">target</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.12)"><span class="pre">int</span></a></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.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return an X <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> on the given target qubit index.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.spin.y">
+<span class="sig-prename descclassname"><span class="pre">spin.</span></span><span class="sig-name descname"><span class="pre">y</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.spin.y" 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">y</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">target</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.12)"><span class="pre">int</span></a></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.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a Y <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> on the given target qubit index.</p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="cudaq.spin.z">
+<span class="sig-prename descclassname"><span class="pre">spin.</span></span><span class="sig-name descname"><span class="pre">z</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.spin.z" 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">z</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">target</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.12)"><span class="pre">int</span></a></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.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return a Z <a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a> on the given target qubit index.</p>
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.SampleResult">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">SampleResult</span></span><a class="headerlink" href="#cudaq.SampleResult" title="Permalink to this definition">¶</a></dt>
+<dd><p>A data-type containing the results of a call to <a class="reference internal" href="#cudaq.sample" title="cudaq.sample"><code class="xref py py-func docutils literal notranslate"><span class="pre">sample()</span></code></a>.
+This includes all measurement counts data from both mid-circuit and
+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>
+</div>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="cudaq.SampleResult.register_names">
+<span class="sig-name descname"><span class="pre">register_names</span></span><a class="headerlink" href="#cudaq.SampleResult.register_names" title="Permalink to this definition">¶</a></dt>
+<dd><p>A list of the names of each measurement
+register that are stored in <code class="code docutils literal notranslate"><span class="pre">self</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Type<span class="colon">:</span></dt>
+<dd class="field-odd"><p>List[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)">str</a>]</p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.__getitem__">
+<span class="sig-name descname"><span class="pre">__getitem__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.__getitem__" 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">__getitem__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">bitstring</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the measurement counts for the given <code class="code docutils literal notranslate"><span class="pre">bitstring</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>bitstring</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The binary string to return the measurement data of.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The number of times the given <code class="code docutils literal notranslate"><span class="pre">bitstring</span></code> was measured
+during the <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code> number of executions on the QPU.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)">float</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.__iter__">
+<span class="sig-name descname"><span class="pre">__iter__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.__iter__" 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">__iter__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Iterator</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Iterate through the <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> dictionary.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.__len__">
+<span class="sig-name descname"><span class="pre">__len__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.__len__" 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">__len__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the number of elements in <code class="code docutils literal notranslate"><span class="pre">self</span></code>. Equivalent to the number of uniquely measured bitstrings.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.clear">
+<span class="sig-name descname"><span class="pre">clear</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.clear" 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">clear</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Clear out all metadata from <code class="code docutils literal notranslate"><span class="pre">self</span></code>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.count">
+<span class="sig-name descname"><span class="pre">count</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.count" 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">count</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">bitstring</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</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">'__global__'</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 external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the number of times the given bitstring was observed.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>bitstring</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The binary string to return the measurement counts for.</p></li>
+<li><p><strong>register_name</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a><em>]</em>) – The optional measurement register name to
+extract the probability from. Defaults to the ‘__global__’ register.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The number of times the given bitstring was measured during the experiment.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)">int</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.deserialize">
+<span class="sig-name descname"><span class="pre">deserialize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.deserialize" 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">deserialize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Deserialize this SampleResult from an existing vector of integers adhering to the implicit encoding.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.dump">
+<span class="sig-name descname"><span class="pre">dump</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.dump" 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">dump</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Print a string of the raw measurement counts data to the terminal.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.expectation">
+<span class="sig-name descname"><span class="pre">expectation</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.expectation" 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">expectation</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</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">'__global__'</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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the expectation value in the Z-basis of the <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> that was sampled.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.expectation_z">
+<span class="sig-name descname"><span class="pre">expectation_z</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.expectation_z" 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">expectation_z</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</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">'__global__'</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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the expectation value in the Z-basis of the <a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> that was sampled.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.get_marginal_counts">
+<span class="sig-name descname"><span class="pre">get_marginal_counts</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.get_marginal_counts" 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">get_marginal_counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="pre">self:</span> <span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult,</span> <span class="pre">marginal_indices:</span> <span class="pre">list[int],</span> <span class="pre">\*,</span> <span class="pre">register_name:</span> <span class="pre">str</span> <span class="pre">=</span> <span class="pre">'__global__'</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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Extract the measurement counts data for the provided subset of
+qubits (<code class="code docutils literal notranslate"><span class="pre">marginal_indices</span></code>).</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>marginal_indices</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><em>list</em></a><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – A list of the qubit indices to extract the
+measurement data from.</p></li>
+<li><p><strong>register_name</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a><em>]</em>) – The optional measurement register name to extract
+the counts data from. Defaults to the ‘__global__’ register.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>A new <code class="code docutils literal notranslate"><span class="pre">SampleResult</span></code> dictionary containing the extracted measurement data.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.get_register_counts">
+<span class="sig-name descname"><span class="pre">get_register_counts</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.get_register_counts" 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">get_register_counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Extract the provided sub-register (<code class="code docutils literal notranslate"><span class="pre">register_name</span></code>) as a new <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.get_sequential_data">
+<span class="sig-name descname"><span class="pre">get_sequential_data</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.get_sequential_data" 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">get_sequential_data</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</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">'__global__'</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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the data from the given register (<code class="code docutils literal notranslate"><span class="pre">register_name</span></code>) as it was collected sequentially. A list of measurement results, not collated into a map.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.items">
+<span class="sig-name descname"><span class="pre">items</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.items" 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">items</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Iterator</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the key/value pairs in this <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> dictionary.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.most_probable">
+<span class="sig-name descname"><span class="pre">most_probable</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.most_probable" 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">most_probable</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</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">'__global__'</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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the bitstring that was measured most frequently in the
+experiment.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>register_name</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a><em>]</em>) – The optional measurement register
+name to extract the most probable bitstring from. Defaults to the
+‘__global__’ register.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The most frequently measured binary string during the experiment.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)">str</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.probability">
+<span class="sig-name descname"><span class="pre">probability</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.probability" 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">probability</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">bitstring</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">register_name</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</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">'__global__'</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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the probability of measuring the given <code class="code docutils literal notranslate"><span class="pre">bitstring</span></code>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>bitstring</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The binary string to return the measurement
+probability of.</p></li>
+<li><p><strong>register_name</strong> (<em>Optional</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a><em>]</em>) – The optional measurement register
+name to extract the probability from. Defaults to the ‘__global__’
+register.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The probability of measuring the given <code class="code docutils literal notranslate"><span class="pre">bitstring</span></code>. Equivalent
+to the proportion of the total times the bitstring was measured
+vs. the number of experiments (<code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>).</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)">float</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.serialize">
+<span class="sig-name descname"><span class="pre">serialize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.serialize" 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">serialize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Serialize this SampleResult to a vector of integer encoding.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.SampleResult.values">
+<span class="sig-name descname"><span class="pre">values</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.SampleResult.values" 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">values</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Iterator</span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return all values (the counts) in this <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> dictionary.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.AsyncSampleResult">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">AsyncSampleResult</span></span><a class="headerlink" href="#cudaq.AsyncSampleResult" title="Permalink to this definition">¶</a></dt>
+<dd><p>A data-type containing the results of a call to <a class="reference internal" href="#cudaq.sample_async" title="cudaq.sample_async"><code class="xref py py-func docutils literal notranslate"><span class="pre">sample_async()</span></code></a>.
+The <code class="code docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code> models a future-like type, whose
+<a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> may be returned via an invocation of the <code class="code docutils literal notranslate"><span class="pre">get</span></code> method. This
+kicks off a wait on the current thread until the results are available.
+See <a class="reference external" href="https://en.cppreference.com/w/cpp/thread/future">future</a>
+for more information on this programming pattern.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.AsyncSampleResult.get">
+<span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.AsyncSampleResult.get" 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">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.AsyncSampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncSampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncSampleResult</span></a></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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> from the asynchronous sample execution.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.ObserveResult">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">ObserveResult</span></span><a class="headerlink" href="#cudaq.ObserveResult" title="Permalink to this definition">¶</a></dt>
+<dd><p>A data-type containing the results of a call to <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>. This includes any measurement counts data, as well as the global expectation value of the user-defined <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code>.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ObserveResult.counts">
+<span class="sig-name descname"><span class="pre">counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ObserveResult.counts" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Returns a <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> dictionary with the measurement results from the experiment. The result for each individual term of the <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> is stored in its own measurement register. Each register name corresponds to the string representation of the spin term (without any coefficients).</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">counts</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">sub_term</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Given a <code class="code docutils literal notranslate"><span class="pre">sub_term</span></code> of the global <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> that was passed
+to <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>, return its measurement counts.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>sub_term</strong> (<a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>) – An individual sub-term of the
+<code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code>.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The measurement counts data for the individual <code class="code docutils literal notranslate"><span class="pre">sub_term</span></code>.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ObserveResult.dump">
+<span class="sig-name descname"><span class="pre">dump</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ObserveResult.dump" 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">dump</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Dump the raw data from the <a class="reference internal" href="#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">SampleResult</span></code></a> that are stored in <a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.ObserveResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">ObserveResult</span></code></a> to the terminal.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ObserveResult.expectation">
+<span class="sig-name descname"><span class="pre">expectation</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ObserveResult.expectation" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">expectation</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the expectation value of the <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> that was provided in <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">expectation</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">sub_term</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the expectation value of an individual <code class="code docutils literal notranslate"><span class="pre">sub_term</span></code> of the
+global <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> that was passed to <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>sub_term</strong> (<a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>) – An individual sub-term of the
+<code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code>.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The expectation value of the <code class="code docutils literal notranslate"><span class="pre">sub_term</span></code> with respect to the
+<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> that was passed to <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)">float</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ObserveResult.expectation_z">
+<span class="sig-name descname"><span class="pre">expectation_z</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ObserveResult.expectation_z" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">expectation_z</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the expectation value of the <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> that was
+provided in <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p><code class="code docutils literal notranslate"><span class="pre">expectation_z</span></code> has been deprecated in favor of <code class="code docutils literal notranslate"><span class="pre">expectation</span></code>.</p>
+</div>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">expectation_z</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">sub_term</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></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 external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Return the expectation value of an individual <code class="code docutils literal notranslate"><span class="pre">sub_term</span></code> of the
+global <code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code> that was passed to <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p><code class="code docutils literal notranslate"><span class="pre">expectation_z</span></code> has been deprecated in favor of <code class="code docutils literal notranslate"><span class="pre">expectation</span></code>.</p>
+</div>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>sub_term</strong> (<a class="reference internal" href="#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">SpinOperator</span></code></a>) – An individual sub-term of the
+<code class="code docutils literal notranslate"><span class="pre">spin_operator</span></code>.</p>
+</dd>
+<dt class="field-even">Returns<span class="colon">:</span></dt>
+<dd class="field-even"><p>The expectation value of the <code class="code docutils literal notranslate"><span class="pre">sub_term</span></code> with respect to the
+<a class="reference internal" href="#cudaq.Kernel" title="cudaq.Kernel"><code class="xref py py-class docutils literal notranslate"><span class="pre">Kernel</span></code></a> that was passed to <a class="reference internal" href="#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe()</span></code></a>.</p>
+</dd>
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)">float</a></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.ObserveResult.get_spin">
+<span class="sig-name descname"><span class="pre">get_spin</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.ObserveResult.get_spin" 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">get_spin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></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.SpinOperator" title="cudaq.SpinOperator"><span class="pre">cudaq.SpinOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <code class="code docutils literal notranslate"><span class="pre">SpinOperator</span></code> corresponding to this <code class="code docutils literal notranslate"><span class="pre">ObserveResult</span></code>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.AsyncObserveResult">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">AsyncObserveResult</span></span><a class="headerlink" href="#cudaq.AsyncObserveResult" title="Permalink to this definition">¶</a></dt>
+<dd><p>A data-type containing the results of a call to <a class="reference internal" href="#cudaq.observe_async" title="cudaq.observe_async"><code class="xref py py-func docutils literal notranslate"><span class="pre">observe_async()</span></code></a>.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code> contains a future, whose <a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.ObserveResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">ObserveResult</span></code></a>
+may be returned via an invocation of the <code class="code docutils literal notranslate"><span class="pre">get</span></code> method.</p>
+<p>This kicks off a wait on the current thread until the results are available.</p>
+<p>See <a class="reference external" href="https://en.cppreference.com/w/cpp/thread/future">future</a>
+for more information on this programming pattern.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.AsyncObserveResult.get">
+<span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.AsyncObserveResult.get" 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">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.AsyncObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncObserveResult</span></a></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.ObserveResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.ObserveResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns the <a class="reference internal" href="#cudaq.ObserveResult" title="cudaq.ObserveResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">ObserveResult</span></code></a> from the asynchronous observe execution.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.AsyncStateResult">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">AsyncStateResult</span></span><a class="headerlink" href="#cudaq.AsyncStateResult" title="Permalink to this definition">¶</a></dt>
+<dd><p>A data-type containing the results of a call to <a class="reference internal" href="#cudaq.get_state_async" title="cudaq.get_state_async"><code class="xref py py-func docutils literal notranslate"><span class="pre">get_state_async()</span></code></a>.
+The <code class="code docutils literal notranslate"><span class="pre">AsyncStateResult</span></code> models a future-like type, whose
+<a class="reference internal" href="#cudaq.State" title="cudaq.State"><code class="xref py py-class docutils literal notranslate"><span class="pre">State</span></code></a> may be returned via an invocation of the <code class="code docutils literal notranslate"><span class="pre">get</span></code> method. This
+kicks off a wait on the current thread until the results are available.
+See <a class="reference external" href="https://en.cppreference.com/w/cpp/thread/future">future</a>
+for more information on this programming pattern.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.AsyncStateResult.get">
+<span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.AsyncStateResult.get" 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">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.AsyncStateResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncStateResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AsyncStateResult</span></a></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.State" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.State</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <a class="reference internal" href="#cudaq.State" title="cudaq.State"><code class="xref py py-class docutils literal notranslate"><span class="pre">State</span></code></a> from the asynchronous <code class="code docutils literal notranslate"><span class="pre">get_state</span></code> accessor execution.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.OptimizationResult">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">OptimizationResult</span></span><a class="headerlink" href="#cudaq.OptimizationResult" title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<section id="optimizers">
+<h3>Optimizers<a class="headerlink" href="#optimizers" title="Permalink to this heading">¶</a></h3>
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.optimizers.optimizer">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.optimizers.</span></span><span class="sig-name descname"><span class="pre">optimizer</span></span><a class="headerlink" href="#cudaq.optimizers.optimizer" title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.optimizers.</span></span><span class="sig-name descname"><span class="pre">GradientDescent</span></span><a class="headerlink" href="#cudaq.optimizers.GradientDescent" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.optimizers.GradientDescent" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to optimizer</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.initial_parameters">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">initial_parameters</span></span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.initial_parameters" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the initial parameter values for the optimization.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.lower_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">lower_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.lower_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the lower value bound for the optimization parameters.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.max_iterations">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">max_iterations</span></span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.max_iterations" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the maximum number of optimizer iterations.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.optimize">
+<span class="sig-name descname"><span class="pre">optimize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.optimize" 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">optimize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.GradientDescent" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">dimensions</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Run <code class="code docutils literal notranslate"><span class="pre">cudaq.optimize()</span></code> on the provided objective function.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.requires_gradients">
+<span class="sig-name descname"><span class="pre">requires_gradients</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.requires_gradients" 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">requires_gradients</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.GradientDescent" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns whether the optimizer requires gradient.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.GradientDescent" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.GradientDescent</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert optimizer to JSON string</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.GradientDescent.upper_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">upper_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.GradientDescent.upper_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the upper value bound for the optimization parameters.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.optimizers.</span></span><span class="sig-name descname"><span class="pre">COBYLA</span></span><a class="headerlink" href="#cudaq.optimizers.COBYLA" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.COBYLA.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.optimizers.COBYLA" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to optimizer</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.initial_parameters">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">initial_parameters</span></span><a class="headerlink" href="#cudaq.optimizers.COBYLA.initial_parameters" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the initial parameter values for the optimization.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.lower_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">lower_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.COBYLA.lower_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the lower value bound for the optimization parameters.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.max_iterations">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">max_iterations</span></span><a class="headerlink" href="#cudaq.optimizers.COBYLA.max_iterations" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the maximum number of optimizer iterations.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.optimize">
+<span class="sig-name descname"><span class="pre">optimize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.COBYLA.optimize" 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">optimize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.COBYLA" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">dimensions</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Run <code class="code docutils literal notranslate"><span class="pre">cudaq.optimize()</span></code> on the provided objective function.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.requires_gradients">
+<span class="sig-name descname"><span class="pre">requires_gradients</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.COBYLA.requires_gradients" 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">requires_gradients</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.COBYLA" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns whether the optimizer requires gradient.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.COBYLA.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.COBYLA" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.COBYLA</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert optimizer to JSON string</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.COBYLA.upper_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">upper_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.COBYLA.upper_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the upper value bound for the optimization parameters.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.optimizers.</span></span><span class="sig-name descname"><span class="pre">NelderMead</span></span><a class="headerlink" href="#cudaq.optimizers.NelderMead" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.NelderMead.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.optimizers.NelderMead" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to optimizer</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.initial_parameters">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">initial_parameters</span></span><a class="headerlink" href="#cudaq.optimizers.NelderMead.initial_parameters" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the initial parameter values for the optimization.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.lower_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">lower_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.NelderMead.lower_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the lower value bound for the optimization parameters.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.max_iterations">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">max_iterations</span></span><a class="headerlink" href="#cudaq.optimizers.NelderMead.max_iterations" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the maximum number of optimizer iterations.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.optimize">
+<span class="sig-name descname"><span class="pre">optimize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.NelderMead.optimize" 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">optimize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.NelderMead" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">dimensions</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Run <code class="code docutils literal notranslate"><span class="pre">cudaq.optimize()</span></code> on the provided objective function.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.requires_gradients">
+<span class="sig-name descname"><span class="pre">requires_gradients</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.NelderMead.requires_gradients" 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">requires_gradients</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.NelderMead" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns whether the optimizer requires gradient.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.NelderMead.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.NelderMead" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.NelderMead</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert optimizer to JSON string</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.NelderMead.upper_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">upper_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.NelderMead.upper_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the upper value bound for the optimization parameters.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.optimizers.</span></span><span class="sig-name descname"><span class="pre">LBFGS</span></span><a class="headerlink" href="#cudaq.optimizers.LBFGS" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.LBFGS.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.optimizers.LBFGS" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to optimizer</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.initial_parameters">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">initial_parameters</span></span><a class="headerlink" href="#cudaq.optimizers.LBFGS.initial_parameters" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the initial parameter values for the optimization.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.lower_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">lower_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.LBFGS.lower_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the lower value bound for the optimization parameters.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.max_iterations">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">max_iterations</span></span><a class="headerlink" href="#cudaq.optimizers.LBFGS.max_iterations" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the maximum number of optimizer iterations.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.optimize">
+<span class="sig-name descname"><span class="pre">optimize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.LBFGS.optimize" 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">optimize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.LBFGS" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">dimensions</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</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 external" href="https://docs.python.org/3/library/stdtypes.html#tuple" title="(in Python v3.12)"><span class="pre">tuple</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Run <code class="code docutils literal notranslate"><span class="pre">cudaq.optimize()</span></code> on the provided objective function.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.requires_gradients">
+<span class="sig-name descname"><span class="pre">requires_gradients</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.LBFGS.requires_gradients" 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">requires_gradients</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.LBFGS" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS</span></a></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 external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns whether the optimizer requires gradient.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.optimizers.LBFGS.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.optimizers.LBFGS" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.optimizers.LBFGS</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert optimizer to JSON string</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.optimizers.LBFGS.upper_bounds">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">upper_bounds</span></span><a class="headerlink" href="#cudaq.optimizers.LBFGS.upper_bounds" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the upper value bound for the optimization parameters.</p>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="gradients">
+<h3>Gradients<a class="headerlink" href="#gradients" title="Permalink to this heading">¶</a></h3>
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.gradients.gradient">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.gradients.</span></span><span class="sig-name descname"><span class="pre">gradient</span></span><a class="headerlink" href="#cudaq.gradients.gradient" title="Permalink to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.gradients.CentralDifference">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.gradients.</span></span><span class="sig-name descname"><span class="pre">CentralDifference</span></span><a class="headerlink" href="#cudaq.gradients.CentralDifference" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.CentralDifference.compute">
+<span class="sig-name descname"><span class="pre">compute</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.CentralDifference.compute" 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">compute</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.gradient" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_vector</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">funcAtX</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Compute the gradient of the provided <code class="code docutils literal notranslate"><span class="pre">parameter_vector</span></code> with respect to its loss function, using the <code class="code docutils literal notranslate"><span class="pre">CentralDifference</span></code> method.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.CentralDifference.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.CentralDifference.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.gradients.CentralDifference" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.CentralDifference"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.CentralDifference</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to gradient</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.CentralDifference.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.CentralDifference.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.CentralDifference" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.CentralDifference"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.CentralDifference</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert gradient to JSON string</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.gradients.ForwardDifference">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.gradients.</span></span><span class="sig-name descname"><span class="pre">ForwardDifference</span></span><a class="headerlink" href="#cudaq.gradients.ForwardDifference" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.ForwardDifference.compute">
+<span class="sig-name descname"><span class="pre">compute</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.ForwardDifference.compute" 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">compute</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.gradient" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_vector</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">funcAtX</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Compute the gradient of the provided <code class="code docutils literal notranslate"><span class="pre">parameter_vector</span></code> with respect to its loss function, using the <code class="code docutils literal notranslate"><span class="pre">ForwardDifference</span></code> method.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.ForwardDifference.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.ForwardDifference.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.gradients.ForwardDifference" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ForwardDifference"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ForwardDifference</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to gradient</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.ForwardDifference.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.ForwardDifference.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.ForwardDifference" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ForwardDifference"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ForwardDifference</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert gradient to JSON string</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.gradients.ParameterShift">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.gradients.</span></span><span class="sig-name descname"><span class="pre">ParameterShift</span></span><a class="headerlink" href="#cudaq.gradients.ParameterShift" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.ParameterShift.compute">
+<span class="sig-name descname"><span class="pre">compute</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.ParameterShift.compute" 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">compute</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.gradient" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.gradient</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">parameter_vector</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">function</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">funcAtX</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Compute the gradient of the provided <code class="code docutils literal notranslate"><span class="pre">parameter_vector</span></code> with respect to its loss function, using the <code class="code docutils literal notranslate"><span class="pre">ParameterShift</span></code> method.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.ParameterShift.from_json">
+<em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">from_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.ParameterShift.from_json" 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">from_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></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.gradients.ParameterShift" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ParameterShift"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ParameterShift</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert JSON string to gradient</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.gradients.ParameterShift.to_json">
+<span class="sig-name descname"><span class="pre">to_json</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.gradients.ParameterShift.to_json" 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">to_json</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.gradients.ParameterShift" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ParameterShift"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.gradients.ParameterShift</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Convert gradient to JSON string</p>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="noisy-simulation">
+<h3>Noisy Simulation<a class="headerlink" href="#noisy-simulation" title="Permalink to this heading">¶</a></h3>
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.NoiseModel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">NoiseModel</span></span><a class="headerlink" href="#cudaq.NoiseModel" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">NoiseModel</span></code> defines a set of <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a>’s applied to specific qubits after the invocation of specified quantum operations.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.NoiseModel.__init__">
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.NoiseModel.__init__" 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">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Construct an empty noise model.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.NoiseModel.add_all_qubit_channel">
+<span class="sig-name descname"><span class="pre">add_all_qubit_channel</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.NoiseModel.add_all_qubit_channel" 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">add_all_qubit_channel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">operator</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">channel</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><span class="pre">cudaq.KrausChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">num_controls</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.12)"><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">0</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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Add the given <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a> to be applied after invocation
+of the specified quantum operation on arbitrary qubits.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>operator</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The quantum operator to apply the noise channel to.</p></li>
+<li><p><strong>channel</strong> (<a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><em>cudaq.KrausChannel</em></a>) – The <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a> to apply
+to the specified <code class="code docutils literal notranslate"><span class="pre">operator</span></code> on any arbitrary qubits.</p></li>
+<li><p><strong>num_controls</strong> – Number of control bits. Default is 0 (no control bits).</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.NoiseModel.add_channel">
+<span class="sig-name descname"><span class="pre">add_channel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.NoiseModel.add_channel" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">add_channel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">operator</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">qubits</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">channel</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><span class="pre">cudaq.KrausChannel</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Add the given <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a> to be applied after invocation
+of the specified quantum operation.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>operator</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The quantum operator to apply the noise channel to.</p></li>
+<li><p><strong>qubits</strong> (<em>List</em><em>[</em><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><em>int</em></a><em>]</em>) – The qubit/s to apply the noise channel to.</p></li>
+<li><p><strong>channel</strong> (<a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><em>cudaq.KrausChannel</em></a>) – The <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a> to apply
+to the specified <code class="code docutils literal notranslate"><span class="pre">operator</span></code> on the specified <code class="code docutils literal notranslate"><span class="pre">qubits</span></code>.</p></li>
+</ul>
+</dd>
+</dl>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-name descname"><span class="pre">add_channel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">operator</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">pre</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Callable</span><span class="p"><span class="pre">[</span></span><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">]</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><span class="pre">cudaq.KrausChannel</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Add the given <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a> generator callback to be applied after invocation
+of the specified quantum operation.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>operator</strong> (<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><em>str</em></a>) – The quantum operator to apply the noise channel to.</p></li>
+<li><p><strong>pre</strong> (<em>Callable</em>) – The callback which takes qubits operands and gate parameters and returns a concrete <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a> to apply
+to the specified <code class="code docutils literal notranslate"><span class="pre">operator</span></code>.</p></li>
+</ul>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.NoiseModel.get_channels">
+<span class="sig-name descname"><span class="pre">get_channels</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.NoiseModel.get_channels" 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">get_channels</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.NoiseModel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.NoiseModel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">operator</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/stdtypes.html#str" title="(in Python v3.12)"><span class="pre">str</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">qubits</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><span class="pre">cudaq.KrausChannel</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a>’s that make up this noise model.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.BitFlipChannel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">BitFlipChannel</span></span><a class="headerlink" href="#cudaq.BitFlipChannel" title="Permalink to this definition">¶</a></dt>
+<dd><p>Models the decoherence of the qubit state. Its constructor expects a
+float value, <code class="code docutils literal notranslate"><span class="pre">probability</span></code>, representing the probability that the qubit
+flips from the 1-state to the 0-state, or vice versa. E.g, the
+probability of a random X-180 rotation being applied to the qubit.</p>
+<p>The Kraus Channels are thereby defined to be:</p>
+<p>K_0 = sqrt(1 - probability) * I</p>
+<p>K_1 = sqrt(probability ) * X</p>
+<p>The probability of the qubit remaining in the same state is therefore <code class="code docutils literal notranslate"><span class="pre">1</span> <span class="pre">-</span>
+<span class="pre">probability</span></code>.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.BitFlipChannel.__init__">
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.BitFlipChannel.__init__" 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">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.BitFlipChannel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.BitFlipChannel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.BitFlipChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">probability</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Initialize the <code class="code docutils literal notranslate"><span class="pre">BitFlipChannel</span></code> with the provided <code class="code docutils literal notranslate"><span class="pre">probability</span></code>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.PhaseFlipChannel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">PhaseFlipChannel</span></span><a class="headerlink" href="#cudaq.PhaseFlipChannel" title="Permalink to this definition">¶</a></dt>
+<dd><p>Models the decoherence of the qubit phase. Its constructor expects a
+float value, <code class="code docutils literal notranslate"><span class="pre">probability</span></code>, representing the probability of a random
+Z-180 rotation being applied to the qubit.</p>
+<p>The Kraus Channels are thereby defined to be:</p>
+<p>K_0 = sqrt(1 - probability) * I</p>
+<p>K_1 = sqrt(probability ) * Z</p>
+<p>The probability of the qubit phase remaining untouched is therefore
+<code class="code docutils literal notranslate"><span class="pre">1</span> <span class="pre">-</span> <span class="pre">probability</span></code>.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.PhaseFlipChannel.__init__">
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.PhaseFlipChannel.__init__" 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">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.PhaseFlipChannel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.PhaseFlipChannel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.PhaseFlipChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">probability</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Initialize the <code class="code docutils literal notranslate"><span class="pre">PhaseFlipChannel</span></code> with the provided <code class="code docutils literal notranslate"><span class="pre">probability</span></code>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.DepolarizationChannel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">DepolarizationChannel</span></span><a class="headerlink" href="#cudaq.DepolarizationChannel" title="Permalink to this definition">¶</a></dt>
+<dd><p>Models the decoherence of the qubit state and phase into a mixture ”
+of the computational basis states, <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> and <code class="code docutils literal notranslate"><span class="pre">|1&gt;</span></code>.</p>
+<p>The Kraus Channels are thereby defined to be:</p>
+<p>K_0 = sqrt(1 - probability) * I</p>
+<p>K_1 = sqrt(probability / 3) * X</p>
+<p>K_2 = sqrt(probability / 3) * Y</p>
+<p>K_3 = sqrt(probability / 3) * Z</p>
+<p>where I, X, Y, Z are the 2x2 Pauli matrices.</p>
+<p>The constructor expects a float value, <code class="code docutils literal notranslate"><span class="pre">probability</span></code>, representing the
+probability the state decay will occur. The qubit will remain untouched,
+therefore, with a probability of <code class="code docutils literal notranslate"><span class="pre">1</span> <span class="pre">-</span> <span class="pre">probability</span></code>. And the X,Y,Z operators
+will be applied with a probability of <code class="code docutils literal notranslate"><span class="pre">probability</span> <span class="pre">/</span> <span class="pre">3</span></code>.</p>
+<p>For <code class="code docutils literal notranslate"><span class="pre">probability</span> <span class="pre">=</span> <span class="pre">0.0</span></code>, the channel will behave noise-free.
+For <code class="code docutils literal notranslate"><span class="pre">probability</span> <span class="pre">=</span> <span class="pre">0.75</span></code>, the channel will fully depolarize the state.
+For <code class="code docutils literal notranslate"><span class="pre">probability</span> <span class="pre">=</span> <span class="pre">1.0</span></code>, the channel will be uniform.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.DepolarizationChannel.__init__">
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.DepolarizationChannel.__init__" 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">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.DepolarizationChannel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.DepolarizationChannel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.DepolarizationChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">probability</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Initialize the <code class="code docutils literal notranslate"><span class="pre">DepolarizationChannel</span></code> with the provided <code class="code docutils literal notranslate"><span class="pre">probability</span></code>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.AmplitudeDampingChannel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">AmplitudeDampingChannel</span></span><a class="headerlink" href="#cudaq.AmplitudeDampingChannel" title="Permalink to this definition">¶</a></dt>
+<dd><p>Models the dissipation of energy due to system interactions with the
+environment.</p>
+<p>The Kraus Channels are thereby defined to be:</p>
+<p>K_0 = sqrt(1 - probability) * I</p>
+<p>K_1 = sqrt(probability) * 0.5 * (X + iY)</p>
+<p>Its constructor expects a float value, <code class="code docutils literal notranslate"><span class="pre">probability</span></code>,
+representing the probablity that the qubit will decay to its ground
+state. The probability of the qubit remaining in the same state is
+therefore <code class="code docutils literal notranslate"><span class="pre">1</span> <span class="pre">-</span> <span class="pre">probability</span></code>.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.AmplitudeDampingChannel.__init__">
+<span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.AmplitudeDampingChannel.__init__" 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">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.AmplitudeDampingChannel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AmplitudeDampingChannel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.AmplitudeDampingChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">probability</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#float" title="(in Python v3.12)"><span class="pre">float</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Initialize the <code class="code docutils literal notranslate"><span class="pre">AmplitudeDampingChannel</span></code> with the provided <code class="code docutils literal notranslate"><span class="pre">probability</span></code>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.KrausChannel">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">KrausChannel</span></span><a class="headerlink" href="#cudaq.KrausChannel" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">KrausChannel</span></code> is composed of a list of <a class="reference internal" href="#cudaq.KrausOperator" title="cudaq.KrausOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausOperator</span></code></a>’s and is applied to a specific qubit or set of qubits.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.KrausChannel.__getitem__">
+<span class="sig-name descname"><span class="pre">__getitem__</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.KrausChannel.__getitem__" 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">__getitem__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausChannel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">index</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.12)"><span class="pre">int</span></a></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.KrausOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausOperator</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the <a class="reference internal" href="#cudaq.KrausOperator" title="cudaq.KrausOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausOperator</span></code></a> at the given index in this <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.KrausChannel.append">
+<span class="sig-name descname"><span class="pre">append</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.KrausChannel.append" 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">append</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausChannel"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausChannel</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg0</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="#cudaq.KrausOperator" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausOperator"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.KrausOperator</span></a></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 external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Add a <a class="reference internal" href="#cudaq.KrausOperator" title="cudaq.KrausOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausOperator</span></code></a> to this <a class="reference internal" href="#cudaq.KrausChannel" title="cudaq.KrausChannel"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausChannel</span></code></a>.</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="cudaq.KrausOperator">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">cudaq.</span></span><span class="sig-name descname"><span class="pre">KrausOperator</span></span><a class="headerlink" href="#cudaq.KrausOperator" title="Permalink to this definition">¶</a></dt>
+<dd><p>The <code class="code docutils literal notranslate"><span class="pre">KrausOperator</span></code> is represented by a matrix and serves as an element of a quantum channel such that <code class="code docutils literal notranslate"><span class="pre">Sum</span> <span class="pre">Ki</span> <span class="pre">Ki^dag</span> <span class="pre">=</span> <span class="pre">I.</span></code></p>
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.KrausOperator.col_count">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">col_count</span></span><a class="headerlink" href="#cudaq.KrausOperator.col_count" title="Permalink to this definition">¶</a></dt>
+<dd><p>The number of columns in the matrix representation of this <a class="reference internal" href="#cudaq.KrausOperator" title="cudaq.KrausOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausOperator</span></code></a>.</p>
+</dd></dl>
+
+<dl class="py property">
+<dt class="sig sig-object py" id="cudaq.KrausOperator.row_count">
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">row_count</span></span><a class="headerlink" href="#cudaq.KrausOperator.row_count" title="Permalink to this definition">¶</a></dt>
+<dd><p>The number of rows in the matrix representation of this <a class="reference internal" href="#cudaq.KrausOperator" title="cudaq.KrausOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">KrausOperator</span></code></a>.</p>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+</section>
+<section id="mpi-submodule">
+<h2>MPI Submodule<a class="headerlink" href="#mpi-submodule" title="Permalink to this heading">¶</a></h2>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.initialize">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">initialize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.initialize" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">initialize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Initialize MPI if available.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.rank">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">rank</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.rank" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">rank</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the rank of this process.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.num_ranks">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">num_ranks</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.num_ranks" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">num_ranks</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Return the total number of ranks.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.all_gather">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">all_gather</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.all_gather" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">all_gather</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg1</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Gather and scatter the <code class="code docutils literal notranslate"><span class="pre">local</span></code> list of floating-point numbers, returning a concatenation of all lists across all ranks. The total global list size must be provided.</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">all_gather</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg1</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Gather and scatter the <code class="code docutils literal notranslate"><span class="pre">local</span></code> list of integers, returning a concatenation of all lists across all ranks. The total global list size must be provided.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.broadcast">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">broadcast</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.broadcast" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">broadcast</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">arg0</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg1</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.12)"><span class="pre">int</span></a></span></em>, <em class="sig-param"><span class="n"><span class="pre">arg2</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.12)"><span class="pre">int</span></a></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 external" href="https://docs.python.org/3/library/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></span></dt>
+<dd></dd></dl>
+
+<p>Broadcast an array from a process (rootRank) to all other processes. The size of broadcast array must be provided.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.is_initialized">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">is_initialized</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.is_initialized" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">is_initialized</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><span class="pre">bool</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Returns true if MPI has already been initialized.</p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.mpi.finalize">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">finalize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.mpi.finalize" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.mpi.</span></span><span class="sig-name descname"><span class="pre">finalize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></span></span></dt>
+<dd></dd></dl>
+
+<p>Finalize MPI.</p>
+</dd></dl>
+
+</section>
+<section id="orca-submodule">
+<h2>ORCA Submodule<a class="headerlink" href="#orca-submodule" title="Permalink to this heading">¶</a></h2>
+<dl class="py method">
+<dt class="sig sig-object py" id="cudaq.orca.sample">
+<span class="sig-prename descclassname"><span class="pre">cudaq.orca.</span></span><span class="sig-name descname"><span class="pre">sample</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cudaq.orca.sample" title="Permalink to this definition">¶</a></dt>
+<dd><p>Overloaded function.</p>
+<ol class="arabic">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.orca.</span></span><span class="sig-name descname"><span class="pre">sample</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">input_state</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">loop_lengths</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bs_angles</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ps_angles</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_samples</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.12)"><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">10000</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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Performs Time Bin Interferometer (TBI) boson sampling experiments on ORCA’s backends</p>
+<ol class="arabic" start="2">
+<li><dl class="py function">
+<dt class="sig sig-object py">
+<span class="sig-prename descclassname"><span class="pre">cudaq.orca.</span></span><span class="sig-name descname"><span class="pre">sample</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">input_state</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">loop_lengths</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#int" title="(in Python v3.12)"><span class="pre">int</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bs_angles</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/stdtypes.html#list" title="(in Python v3.12)"><span class="pre">list</span></a><span class="p"><span class="pre">[</span></span><a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><span class="pre">float</span></a><span class="p"><span class="pre">]</span></span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n_samples</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.12)"><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">10000</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.SampleResult" title="cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult"><span class="pre">cudaq.mlir._mlir_libs._quakeDialects.cudaq_runtime.SampleResult</span></a></span></span></dt>
+<dd></dd></dl>
+
+</li>
+</ol>
+<p>Performs Time Bin Interferometer (TBI) boson sampling experiments on ORCA’s backends</p>
+</dd></dl>
+
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cpp_api.html" class="btn btn-neutral float-left" title="CUDA-Q C++ API" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../default_ops.html" class="btn btn-neutral float-right" title="Quantum Operations" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/Divisive_clustering.html b/pr-2241/examples/python/tutorials/Divisive_clustering.html
new file mode 100644
index 0000000000..8b101d0779
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/Divisive_clustering.html
@@ -0,0 +1,1488 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Divisive Clustering With Coresets Using CUDA-Q &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Multi-Reference Quantum Krylov Algorithm (H2 Example)" href="H2-MRQKS.html" />
+    <link rel="prev" title="Water Molecule with Active Space (CPU vs. GPU)" href="vqe_water_active_space.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Divisive Clustering With Coresets Using CUDA-Q</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/Divisive_clustering.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="vqe_water_active_space.html" class="btn btn-neutral float-left" title="Water Molecule with Active Space (CPU vs. GPU)" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="H2-MRQKS.html" class="btn btn-neutral float-right" title="Multi-Reference Quantum Krylov Algorithm (H2 Example)" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Divisive-Clustering-With-Coresets-Using-CUDA-Q">
+<h1>Divisive Clustering With Coresets Using CUDA-Q<a class="headerlink" href="#Divisive-Clustering-With-Coresets-Using-CUDA-Q" title="Permalink to this heading">¶</a></h1>
+<p>This tutorial will explore a CUDA-Q implementation of recent research (ArXiv Paper: <a class="reference external" href="https://arxiv.org/pdf/2402.01529.pdf">https://arxiv.org/pdf/2402.01529.pdf</a>) performed by a team from the University of Edinburgh. This tutorial was jointly developed by NVIDIA and the authors so users can better understand their method and explore how CUDA-Q removed barriers to scaling.</p>
+<p>The code for this tutorial is based off the MIT licensed code found here: <a class="reference external" href="https://github.com/Boniface316/bigdata_vqa">https://github.com/Boniface316/bigdata_vqa</a></p>
+<p>Clustering is a common unsupervised learning technique aimed at grouping data with similar characteristics. The unique properties of quantum computers could allow for enhanced pattern finding in clustering applications and enable more reliable data analysis. However, quantum computers today are severely limited by qubit count and noise. Performing practical clustering applications would require far too many qubits. The Edinburgh team developed a new method (extending the work of Harrow) to
+leverage coresets for clustering applications on quantum computers and use far fewer qubits. This tutorial will walk through an example using this approach for divisive clustering and emphasize the utility of CUDA-Q for scaling quantum simulations.</p>
+<p>The goal of divisive clustering is to begin with all data points as one set, and iteratively bipartition the data until each point is its own cluster. The branching behavior of this process can be used to understand similarities in the data points.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># If you are running outside of a CUDA-Q container or CUDA-Q directory tree, you may need to uncomment these lines to fetch the files.</span>
+<span class="c1"># If you are running inside a CUDA-Q tree, then this step can be skipped.</span>
+<span class="c1"># !mkdir divisive_clustering_src</span>
+<span class="c1"># !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py</span>
+<span class="c1"># !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install the relevant packages.</span>
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">mpi4py</span><span class="o">==</span><span class="m">3</span>.1.6
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">networkx</span><span class="o">==</span><span class="m">2</span>.8.8
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">pandas</span><span class="o">==</span><span class="m">2</span>.2.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span>scikit-learn<span class="o">==</span><span class="m">1</span>.4.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">tqdm</span><span class="o">==</span><span class="m">4</span>.66.2
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+
+<span class="c1"># Auxillary Imports</span>
+<span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">networkx</span> <span class="k">as</span> <span class="nn">nx</span>
+<span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+<span class="kn">import</span> <span class="nn">warnings</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
+<span class="kn">from</span> <span class="nn">divisive_clustering_src.divisive_clustering</span> <span class="kn">import</span> <span class="n">Coreset</span><span class="p">,</span> <span class="n">DivisiveClustering</span><span class="p">,</span> <span class="n">Dendrogram</span><span class="p">,</span> <span class="n">Voironi_Tessalation</span>
+
+<span class="n">warnings</span><span class="o">.</span><span class="n">filterwarnings</span><span class="p">(</span><span class="s2">&quot;ignore&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>The settings below are global parameters for the quantum simulation and can be toggled by the user.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">circuit_depth</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="n">max_iterations</span> <span class="o">=</span> <span class="mi">75</span>
+<span class="n">max_shots</span> <span class="o">=</span> <span class="mi">1000</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>Given a data set <span class="math notranslate nohighlight">\(X = (x_1, x_2, \cdots, x_N)\)</span>, a coreset is weighted data set of much smaller size (<span class="math notranslate nohighlight">\(X', w\)</span>) that represents <span class="math notranslate nohighlight">\(X\)</span> enough such that analysis of (<span class="math notranslate nohighlight">\(X', w\)</span>) can allow us to draw reasonable approximate conclusions about <span class="math notranslate nohighlight">\(X\)</span>. There are various approaches to build coresets. They can be found in Practical Coreset Construction for Machine Learning (<a class="reference external" href="https://arxiv.org/pdf/1703.06476.pdf">https://arxiv.org/pdf/1703.06476.pdf</a>) and New Streaming Algorithms for Coresets in Machine Learning
+(<a class="reference external" href="https://arxiv.org/pdf/1703.06476.pdf">https://arxiv.org/pdf/1703.06476.pdf</a>).</p>
+<p>Essentially, coreset construction boils down to finding the optimal coreset size and weights given some error tolerance. Given the constraints of a quantum computer, in this work, a coreset size is selected <span class="math notranslate nohighlight">\(a\)</span> <span class="math notranslate nohighlight">\(priori\)</span>, and the error is determined for each model.</p>
+<p>The following is an example <span class="math notranslate nohighlight">\(M=10\)</span> coreset constructed from a 1000-point data set and loaded into a pandas data frame. See the image below where the coreset is represented by the black stars, the size of which corresponds to the weights.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">raw_data</span> <span class="o">=</span> <span class="n">Coreset</span><span class="o">.</span><span class="n">create_dataset</span><span class="p">(</span><span class="mi">1000</span><span class="p">)</span>
+<span class="n">coreset</span> <span class="o">=</span> <span class="n">Coreset</span><span class="p">(</span>
+    <span class="n">raw_data</span><span class="o">=</span><span class="n">raw_data</span><span class="p">,</span>
+    <span class="n">number_of_sampling_for_centroids</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
+    <span class="n">coreset_size</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
+    <span class="n">number_of_coresets_to_evaluate</span><span class="o">=</span><span class="mi">4</span><span class="p">,</span>
+    <span class="n">coreset_method</span><span class="o">=</span><span class="s2">&quot;BFL2&quot;</span><span class="p">,</span>
+<span class="p">)</span>
+
+
+<span class="n">coreset_vectors</span><span class="p">,</span> <span class="n">coreset_weights</span> <span class="o">=</span> <span class="n">coreset</span><span class="o">.</span><span class="n">get_best_coresets</span><span class="p">()</span>
+
+<span class="n">coreset_df</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span>
+    <span class="p">{</span><span class="s2">&quot;X&quot;</span><span class="p">:</span> <span class="n">coreset_vectors</span><span class="p">[:,</span> <span class="mi">0</span><span class="p">],</span> <span class="s2">&quot;Y&quot;</span><span class="p">:</span> <span class="n">coreset_vectors</span><span class="p">[:,</span> <span class="mi">1</span><span class="p">],</span> <span class="s2">&quot;weights&quot;</span><span class="p">:</span> <span class="n">coreset_weights</span><span class="p">}</span>
+<span class="p">)</span>
+<span class="n">coreset_df</span><span class="p">[</span><span class="s2">&quot;Name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="nb">chr</span><span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">65</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">coreset_df</span><span class="o">.</span><span class="n">index</span><span class="p">]</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">coreset_df</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Using BFL2 method to generate coresets
+          X         Y     weights Name
+0  7.028364  1.669787  234.230716    A
+1  7.167441  0.354792  101.319288    B
+2  1.022889 -0.921443  125.158339    C
+3  2.706134 -2.636852   13.650774    D
+4  6.998497  0.455847  116.758239    E
+5  7.507918  0.630311  120.727176    F
+6 -2.102508  2.297727   53.294127    G
+7  5.722463  1.400433   77.415840    H
+8 -1.425868  2.341136   42.847985    I
+9  7.985373 -0.063209  240.116237    J
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">plt</span><span class="o">.</span><span class="n">scatter</span><span class="p">(</span><span class="n">raw_data</span><span class="p">[:,</span> <span class="mi">0</span><span class="p">],</span> <span class="n">raw_data</span><span class="p">[:,</span> <span class="mi">1</span><span class="p">],</span> <span class="n">label</span><span class="o">=</span><span class="s2">&quot;Raw Data&quot;</span><span class="p">,</span> <span class="n">c</span><span class="o">=</span><span class="s2">&quot;#7eba00&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">scatter</span><span class="p">(</span>
+    <span class="n">coreset_df</span><span class="p">[</span><span class="s2">&quot;X&quot;</span><span class="p">],</span>
+    <span class="n">coreset_df</span><span class="p">[</span><span class="s2">&quot;Y&quot;</span><span class="p">],</span>
+    <span class="n">s</span><span class="o">=</span><span class="n">coreset_df</span><span class="p">[</span><span class="s2">&quot;weights&quot;</span><span class="p">],</span>
+    <span class="n">label</span><span class="o">=</span><span class="s2">&quot;Coreset&quot;</span><span class="p">,</span>
+    <span class="n">color</span><span class="o">=</span><span class="s2">&quot;black&quot;</span><span class="p">,</span>
+    <span class="n">marker</span><span class="o">=</span><span class="s2">&quot;*&quot;</span><span class="p">,</span>
+<span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s2">&quot;X&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s2">&quot;Y&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">title</span><span class="p">(</span><span class="s2">&quot;Raw data and its best 10 coreset using BFL2&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">legend</span><span class="p">()</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_Divisive_clustering_11_0.png" src="../../../_images/examples_python_tutorials_Divisive_clustering_11_0.png" />
+</div>
+</div>
+<section id="Data-preprocessing">
+<h2>Data preprocessing<a class="headerlink" href="#Data-preprocessing" title="Permalink to this heading">¶</a></h2>
+<p>In order to cluster data on a quantum computer, the task needs to be cast into the form of a binary optimization problem. Each qubit represents a coreset point, and the quantum algorithm determines how to bipartition the coreset points at each iteration of the divisive clustering routine.</p>
+<p>The first step is to convert coreset points into a fully connected graph. The edge weight is calculated by:</p>
+<p><span class="math notranslate nohighlight">\(e_{ij} = w_iw_jd_{ij}\)</span> where <span class="math notranslate nohighlight">\(d_{ij}\)</span> is the Euclidean distance between points <span class="math notranslate nohighlight">\(i\)</span> and <span class="math notranslate nohighlight">\(j\)</span>.</p>
+<p>This process is handled by <code class="docutils literal notranslate"><span class="pre">Coreset.coreset_to_graph()</span></code>. The function returns a fully connected graph <span class="math notranslate nohighlight">\(G\)</span> with edge weights.</p>
+</section>
+<section id="Quantum-functions">
+<h2>Quantum functions<a class="headerlink" href="#Quantum-functions" title="Permalink to this heading">¶</a></h2>
+<p>The divisive clustering problem will be implemented on a quantum computer using a variational quantum algorithm (VQA) approach. A VQA takes a Hamiltonian (encoded with the optimization problem) and a parameterized ansatz and evaluates expectation values (quantum computer) that inform updates to the ansatz parameters (classical computer). The graph <span class="math notranslate nohighlight">\(G\)</span> (Code in the “src” file) is used to construct the Hamiltonian, derived specifically for the divisive clustering problem, and motivated by a
+max-cut Hamiltonian. The <code class="docutils literal notranslate"><span class="pre">spin.z(i)</span></code> method in CUDA-Q adds a Pauli Z operation that acts on qubit <span class="math notranslate nohighlight">\(i\)</span> to the Hamiltonian.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_K2_Hamiltonian</span><span class="p">(</span><span class="n">G</span><span class="p">:</span> <span class="n">nx</span><span class="o">.</span><span class="n">Graph</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Returns the K2 Hamiltonian for the given graph G</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        G (nx.Graph): Weighted graph</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">H</span> <span class="o">=</span> <span class="mi">0</span>
+
+    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">j</span> <span class="ow">in</span> <span class="n">G</span><span class="o">.</span><span class="n">edges</span><span class="p">():</span>
+        <span class="n">weight</span> <span class="o">=</span> <span class="n">G</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="n">j</span><span class="p">][</span><span class="s2">&quot;weight&quot;</span><span class="p">]</span>
+        <span class="n">H</span> <span class="o">+=</span> <span class="n">weight</span> <span class="o">*</span> <span class="p">(</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">i</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">j</span><span class="p">))</span>
+
+    <span class="k">return</span> <span class="n">H</span>
+</pre></div>
+</div>
+</div>
+<p>The code below constructs a quantum kernel, defining the circuit which will serve as an ansatz. The structure of the circuit is a hardware efficient ansatz consisting of layers of parameterized <span class="math notranslate nohighlight">\(R_Z\)</span> and <span class="math notranslate nohighlight">\(R_Y\)</span> gate acting on each qubit, followed by a linear cascade of CNOT gates, and two more rotation gates.</p>
+<p>The <code class="docutils literal notranslate"><span class="pre">&#64;cudaq.kernel</span></code> decorator allows us to define a quantum circuit in the new kernel mode syntax which provides performance benefits to JIT compilation.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_VQE_circuit</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">Kernel</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Returns the VQE circuit for the given number of qubits and circuit depth</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        number_of_qubits (int): Number of qubits</span>
+<span class="sd">        circuit_depth (int): Circuit depth</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        cudaq.Kernel: VQE Circuit</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+    <span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">thetas</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span> <span class="n">number_of_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;VQE Circuit</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">            thetas (list[float]): List of parameters</span>
+<span class="sd">            number_of_qubits (int): Number of qubits</span>
+<span class="sd">            circuit_depth (int): Circuit depth</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">)</span>
+
+        <span class="n">theta_position</span> <span class="o">=</span> <span class="mi">0</span>
+
+        <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">circuit_depth</span><span class="p">):</span>
+            <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">):</span>
+                <span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">theta_position</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+                <span class="n">rz</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">theta_position</span> <span class="o">+</span> <span class="mi">1</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+
+                <span class="n">theta_position</span> <span class="o">+=</span> <span class="mi">2</span>
+
+            <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">number_of_qubits</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+                <span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+
+            <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">):</span>
+                <span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">theta_position</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+                <span class="n">rz</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">theta_position</span> <span class="o">+</span> <span class="mi">1</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+
+                <span class="n">theta_position</span> <span class="o">+=</span> <span class="mi">2</span>
+
+    <span class="k">return</span> <span class="n">kernel</span>
+</pre></div>
+</div>
+</div>
+<p>We can visualize the circuit using the <code class="docutils literal notranslate"><span class="pre">cudaq.draw()</span></code> method. Below, we are drawing the circuit for 5 qubits.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">parameter_count</span> <span class="o">=</span> <span class="mi">4</span> <span class="o">*</span> <span class="n">circuit_depth</span> <span class="o">*</span> <span class="mi">5</span>
+<span class="n">parameters</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">rand</span><span class="p">(</span><span class="n">parameter_count</span><span class="p">)</span>
+
+<span class="n">circuit</span> <span class="o">=</span> <span class="n">get_VQE_circuit</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">circuit</span><span class="p">,</span> <span class="n">parameters</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭────────────╮ ╭────────────╮      ╭────────────╮╭────────────╮»
+q0 : ┤ ry(0.8904) ├─┤ rz(0.7335) ├───●──┤ ry(0.4343) ├┤ rz(0.2236) ├»
+     ├────────────┤ ├────────────┤ ╭─┴─╮╰────────────╯├────────────┤»
+q1 : ┤ ry(0.7937) ├─┤ rz(0.9981) ├─┤ x ├──────●───────┤ ry(0.3945) ├»
+     ├───────────┬╯ ├────────────┤ ╰───╯    ╭─┴─╮     ╰────────────╯»
+q2 : ┤ ry(0.696) ├──┤ rz(0.3352) ├──────────┤ x ├───────────●───────»
+     ├───────────┴╮╭┴────────────┤          ╰───╯         ╭─┴─╮     »
+q3 : ┤ ry(0.6658) ├┤ rz(0.05277) ├────────────────────────┤ x ├─────»
+     ├───────────┬╯├─────────────┴╮                       ╰───╯     »
+q4 : ┤ ry(0.791) ├─┤ rz(0.003569) ├─────────────────────────────────»
+     ╰───────────╯ ╰──────────────╯                                 »
+
+################################################################################
+
+
+─────────────────────────────────────────────
+╭────────────╮
+┤ rz(0.4119) ├───────────────────────────────
+├────────────┤╭────────────╮
+┤ ry(0.3205) ├┤ rz(0.3504) ├─────────────────
+╰────────────╯├────────────┤ ╭────────────╮
+──────●───────┤ ry(0.3913) ├─┤ rz(0.7392) ├──
+    ╭─┴─╮     ├────────────┤╭┴────────────┴─╮
+────┤ x ├─────┤ ry(0.3171) ├┤ rz(0.0008056) ├
+    ╰───╯     ╰────────────╯╰───────────────╯
+
+</pre></div></div>
+</div>
+<p>The next step is to select a classical optimizer. There are multiple <a class="reference external" href="https://nvidia.github.io/cuda-quantum/latest/api/languages/python_api.html#optimizers">optimizers</a> built-in to CUDA-Q that can be selected. The code below returns the optimizer with the proper number of initial parameters.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_optimizer</span><span class="p">(</span>
+    <span class="n">optimizer</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">optimizer</span><span class="p">,</span> <span class="n">max_iterations</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">optimizer</span><span class="p">,</span> <span class="nb">int</span><span class="p">]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Returns the optimizer with the given parameters</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        optimizer (cudaq.optimizers.optimizer): Optimizer</span>
+<span class="sd">        max_iterations (int): Maximum number of iterations</span>
+<span class="sd">        **kwargs: Additional arguments</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">parameter_count</span> <span class="o">=</span> <span class="mi">4</span> <span class="o">*</span> <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;circuit_depth&quot;</span><span class="p">]</span> <span class="o">*</span> <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;qubits&quot;</span><span class="p">]</span>
+    <span class="n">initial_params</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">8.0</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">8.0</span><span class="p">,</span> <span class="n">parameter_count</span><span class="p">)</span>
+    <span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span> <span class="o">=</span> <span class="n">initial_params</span>
+
+    <span class="n">optimizer</span><span class="o">.</span><span class="n">max_iterations</span> <span class="o">=</span> <span class="n">max_iterations</span>
+    <span class="k">return</span> <span class="n">optimizer</span><span class="p">,</span> <span class="n">parameter_count</span>
+</pre></div>
+</div>
+</div>
+</section>
+<section id="Divisive-Clustering-Function">
+<h2>Divisive Clustering Function<a class="headerlink" href="#Divisive-Clustering-Function" title="Permalink to this heading">¶</a></h2>
+<p>The <code class="docutils literal notranslate"><span class="pre">DivisiveClusteringVQA</span></code> class enables the procedure to iteratively bipartition the coreset points until each is its own cluster. If you wish to develop on top of this or see how the underlying code works, please see the <code class="docutils literal notranslate"><span class="pre">divisive_clustering.py</span></code> file in the src directory.</p>
+<p><code class="docutils literal notranslate"><span class="pre">run_divisive_clustering</span></code>, takes the current iteration’s coreset points that will be bipartitioned as inputs, extracts the appropriate weights, and builds a graph <span class="math notranslate nohighlight">\(G\)</span>. The graph is then an input into the <code class="docutils literal notranslate"><span class="pre">get_counts_from_simulation</span></code> function.</p>
+<p><code class="docutils literal notranslate"><span class="pre">get_counts_from_simulation</span></code> handles preparation and execution of the quantum simulation. First, it takes <span class="math notranslate nohighlight">\(G\)</span> and from it builds a spin Hamiltonian. Second, it defines a cost function, which in this case is a lambda function that returns the expectation value of our parameterized quantum circuit and the Hamiltonian. This value is obtained using the CUDA-Q <code class="docutils literal notranslate"><span class="pre">observe</span></code> command, accelerated by GPUs. After the expectation value is minimized, the quantum circuit corresponding to the optimal
+parameters is sampled using the CUDA-Q <code class="docutils literal notranslate"><span class="pre">sample</span></code> function. The bitstrings and their associated counts are returned by <code class="docutils literal notranslate"><span class="pre">get_counts_from_simulation</span></code>.</p>
+<p>A subset of these counts is evaluated to compute their exact cost. The best bitstring is returned and later used to assign the coreset points to one of two clusters.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">DivisiveClusteringVQA</span><span class="p">(</span><span class="n">DivisiveClustering</span><span class="p">):</span>
+    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+        <span class="bp">self</span><span class="p">,</span>
+        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
+    <span class="p">):</span>
+        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+
+    <span class="k">def</span> <span class="nf">run_divisive_clustering</span><span class="p">(</span>
+        <span class="bp">self</span><span class="p">,</span>
+        <span class="n">coreset_vectors_df_for_iteration</span><span class="p">:</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">,</span>
+    <span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Runs the Divisive Clustering algorithm</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">            coreset_vectors_df_for_iteration (pd.DataFrame): Coreset vectors for the iteration</span>
+
+<span class="sd">        Returns:</span>
+<span class="sd">            str: Best bitstring</span>
+
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">coreset_vectors_for_iteration_np</span><span class="p">,</span> <span class="n">coreset_weights_for_iteration_np</span> <span class="o">=</span> <span class="p">(</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">_get_iteration_coreset_vectors_and_weights</span><span class="p">(</span><span class="n">coreset_vectors_df_for_iteration</span><span class="p">)</span>
+        <span class="p">)</span>
+
+        <span class="n">G</span> <span class="o">=</span> <span class="n">Coreset</span><span class="o">.</span><span class="n">coreset_to_graph</span><span class="p">(</span>
+            <span class="n">coreset_vectors_for_iteration_np</span><span class="p">,</span>
+            <span class="n">coreset_weights_for_iteration_np</span><span class="p">,</span>
+            <span class="n">metric</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">coreset_to_graph_metric</span><span class="p">,</span>
+        <span class="p">)</span>
+
+        <span class="n">counts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_counts_from_simulation</span><span class="p">(</span>
+            <span class="n">G</span><span class="p">,</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">circuit_depth</span><span class="p">,</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">max_iterations</span><span class="p">,</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">max_shots</span><span class="p">,</span>
+        <span class="p">)</span>
+
+        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_best_bitstring</span><span class="p">(</span><span class="n">counts</span><span class="p">,</span> <span class="n">G</span><span class="p">)</span>
+
+    <span class="k">def</span> <span class="nf">get_counts_from_simulation</span><span class="p">(</span>
+        <span class="bp">self</span><span class="p">,</span> <span class="n">G</span><span class="p">:</span> <span class="n">nx</span><span class="o">.</span><span class="n">graph</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">max_iterations</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">max_shots</span><span class="p">:</span> <span class="nb">int</span>
+    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SampleResult</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Runs the VQA simulation</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">            G (nx.graph): Graph</span>
+<span class="sd">            circuit_depth (int): Circuit depth</span>
+<span class="sd">            max_iterations (int): Maximum number of iterations</span>
+<span class="sd">            max_shots (int): Maximum number of shots</span>
+
+<span class="sd">        Returns:</span>
+<span class="sd">            cudaq.SampleResult: Measurement from the experiment</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+
+        <span class="n">qubits</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">G</span><span class="o">.</span><span class="n">nodes</span><span class="p">)</span>
+        <span class="n">Hamiltonian</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_Hamiltonian</span><span class="p">(</span><span class="n">G</span><span class="p">)</span>
+        <span class="n">optimizer</span><span class="p">,</span> <span class="n">parameter_count</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">optimizer_function</span><span class="p">(</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">optimizer</span><span class="p">,</span> <span class="n">max_iterations</span><span class="p">,</span> <span class="n">qubits</span><span class="o">=</span><span class="n">qubits</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="o">=</span><span class="n">circuit_depth</span>
+        <span class="p">)</span>
+
+        <span class="n">kernel</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_circuit</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">)</span>
+
+        <span class="k">def</span> <span class="nf">objective_function</span><span class="p">(</span>
+            <span class="n">parameter_vector</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span>
+            <span class="n">hamiltonian</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span> <span class="o">=</span> <span class="n">Hamiltonian</span><span class="p">,</span>
+            <span class="n">kernel</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">Kernel</span> <span class="o">=</span> <span class="n">kernel</span><span class="p">,</span>
+        <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+<span class="w">            </span><span class="sd">&quot;&quot;&quot;</span>
+
+<span class="sd">            Objective function that returns the cost of the simulation</span>
+
+<span class="sd">            Args:</span>
+<span class="sd">                parameter_vector (List[float]):</span>
+<span class="sd">                hamiltonian (cudaq.SpinOperator): Circuit parameter values as a vector</span>
+<span class="sd">                kernel (cudaq.Kernel) : Circuit configuration</span>
+
+<span class="sd">            Returns:</span>
+<span class="sd">                float: Expectation value of the circuit</span>
+
+<span class="sd">            &quot;&quot;&quot;</span>
+
+            <span class="n">get_result</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">parameter_vector</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span>
+                <span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">parameter_vector</span><span class="p">,</span> <span class="n">qubits</span><span class="p">,</span> <span class="n">circuit_depth</span>
+            <span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+            <span class="n">cost</span> <span class="o">=</span> <span class="n">get_result</span><span class="p">(</span><span class="n">parameter_vector</span><span class="p">)</span>
+
+            <span class="k">return</span> <span class="n">cost</span>
+
+        <span class="n">energy</span><span class="p">,</span> <span class="n">optimal_parameters</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span>
+            <span class="n">dimensions</span><span class="o">=</span><span class="n">parameter_count</span><span class="p">,</span> <span class="n">function</span><span class="o">=</span><span class="n">objective_function</span>
+        <span class="p">)</span>
+
+        <span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span>
+            <span class="n">kernel</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">,</span> <span class="n">qubits</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">max_shots</span>
+        <span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">counts</span>
+</pre></div>
+</div>
+</div>
+<p>An instance of the <code class="docutils literal notranslate"><span class="pre">DivisiveClusteringVQA</span></code> class is mostly constructed from variables previously discussed like the functions for building the Hamiltonians and quantum circuits. Parameters related to the quantum simulation can also be specified here such as <code class="docutils literal notranslate"><span class="pre">circuit_depth</span></code> and <code class="docutils literal notranslate"><span class="pre">max_shots</span></code>. The <code class="docutils literal notranslate"><span class="pre">threshold_for_max_cut</span></code> parameter specifies what percent of the sample results from the quantum computer are checked for the best bitstring value.</p>
+<p>The other options specify advanced features like if the data is normalized and how the graph weights are computed.</p>
+<p>Finally, the <code class="docutils literal notranslate"><span class="pre">get_divisive_sequence</span></code> method performs the iterations and produces the clustering data which we will analyze below. Note that this postprocessing code is not exposed in this tutorial but can be found in the source code.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[12]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">COBYLA</span><span class="p">()</span>
+
+<span class="n">divisive_clustering</span> <span class="o">=</span> <span class="n">DivisiveClusteringVQA</span><span class="p">(</span>
+    <span class="n">circuit_depth</span><span class="o">=</span><span class="n">circuit_depth</span><span class="p">,</span>
+    <span class="n">max_iterations</span><span class="o">=</span><span class="n">max_iterations</span><span class="p">,</span>
+    <span class="n">max_shots</span><span class="o">=</span><span class="n">max_shots</span><span class="p">,</span>
+    <span class="n">threshold_for_max_cut</span><span class="o">=</span><span class="mf">0.75</span><span class="p">,</span>
+    <span class="n">create_Hamiltonian</span><span class="o">=</span><span class="n">get_K2_Hamiltonian</span><span class="p">,</span>
+    <span class="n">optimizer</span><span class="o">=</span><span class="n">optimizer</span><span class="p">,</span>
+    <span class="n">optimizer_function</span><span class="o">=</span><span class="n">get_optimizer</span><span class="p">,</span>
+    <span class="n">create_circuit</span><span class="o">=</span><span class="n">get_VQE_circuit</span><span class="p">,</span>
+    <span class="n">normalize_vectors</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+    <span class="n">sort_by_descending</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+    <span class="n">coreset_to_graph_metric</span><span class="o">=</span><span class="s2">&quot;dist&quot;</span><span class="p">,</span>
+<span class="p">)</span>
+
+<span class="n">hierarchial_clustering_sequence</span> <span class="o">=</span> <span class="n">divisive_clustering</span><span class="o">.</span><span class="n">get_divisive_sequence</span><span class="p">(</span><span class="n">coreset_df</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area stderr docutils container">
+<div class="highlight"><pre>
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 129/129 [00:00&lt;00:00, 12075.19it/s]
+100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00&lt;00:00, 35025.50it/s]
+100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 18/18 [00:00&lt;00:00, 44254.09it/s]
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00, 15827.56it/s]
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00, 13617.87it/s]
+</pre></div></div>
+</div>
+<p>The data can be nicely visualized with a Dendrogram which maps where the bipartitionings occurred. Early splits generally mark divisions between the least similar data.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[13]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">dendo</span> <span class="o">=</span> <span class="n">Dendrogram</span><span class="p">(</span><span class="n">coreset_df</span><span class="p">,</span> <span class="n">hierarchial_clustering_sequence</span><span class="p">)</span>
+<span class="n">dendo</span><span class="o">.</span><span class="n">plot_dendrogram</span><span class="p">(</span><span class="n">plot_title</span><span class="o">=</span><span class="s2">&quot;Dendrogram of Coreset using VQE&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_Divisive_clustering_29_0.png" src="../../../_images/examples_python_tutorials_Divisive_clustering_29_0.png" />
+</div>
+</div>
+<p>Each branch point in the dendrogram aboves corresponds to one of the plots below. Notice the first iterations are the most complicated, and the final iterations become trivial bipartitioning of two points. Occasionally, especially in the first iteration, the partitioning might be puzzling at first glance. The data might seem to naturally cluster into two groups. However, there are cases where a stray point seems to belong in the wrong cluster. There are two explanations for this. 1) The quantum
+sampling is approximate and stochastic. It is possible that too few shots were taken to sample the ground state of the problem. 2) It is important to remember that we are clustering coresets and not data points. There can be cases where it is optimal to pay a penalty by excluding a point based on proximity if the weights are small enough that the penalty has less impact. Usually, if a point looks unusually clustered and you go look at the original coresets plotted above, that point will have a
+small weight.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[14]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">Dendrogram</span><span class="o">.</span><span class="n">plot_hierarchial_split</span><span class="p">(</span><span class="n">hierarchial_clustering_sequence</span><span class="p">,</span> <span class="n">coreset_df</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_Divisive_clustering_31_0.png" src="../../../_images/examples_python_tutorials_Divisive_clustering_31_0.png" />
+</div>
+</div>
+<p>The hierarchical clustering can be converted to flat clustering by drawing a line perpendicular to the branches. Any data point that intersects the line is considered to be in the same cluster. The function below performs this task at threshold height of 1.5. If you want to use the number of clusters instead of height, you can use <code class="docutils literal notranslate"><span class="pre">dendo.get_clusters_using_k()</span></code> method. You pass the number of desired clusters as an argument. The figure below shows the clusters that are formed at threshold
+height of 1.5.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[15]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">threshold_height</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="n">clusters</span> <span class="o">=</span> <span class="n">dendo</span><span class="o">.</span><span class="n">get_clusters_using_height</span><span class="p">(</span><span class="n">threshold_height</span><span class="p">)</span>
+<span class="n">colors</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;red&quot;</span><span class="p">,</span> <span class="s2">&quot;blue&quot;</span><span class="p">,</span> <span class="s2">&quot;green&quot;</span><span class="p">,</span> <span class="s2">&quot;black&quot;</span><span class="p">,</span> <span class="s2">&quot;purple&quot;</span><span class="p">,</span> <span class="s2">&quot;orange&quot;</span><span class="p">,</span> <span class="s2">&quot;yellow&quot;</span><span class="p">]</span>
+<span class="n">dendo</span><span class="o">.</span><span class="n">plot_dendrogram</span><span class="p">(</span>
+    <span class="n">plot_title</span><span class="o">=</span><span class="s2">&quot;Dendrogram of Coreset using VQE&quot;</span><span class="p">,</span>
+    <span class="n">colors</span><span class="o">=</span><span class="n">colors</span><span class="p">,</span>
+    <span class="n">clusters</span><span class="o">=</span><span class="n">clusters</span><span class="p">,</span>
+    <span class="n">color_threshold</span><span class="o">=</span><span class="n">threshold_height</span><span class="p">,</span>
+<span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_Divisive_clustering_33_0.png" src="../../../_images/examples_python_tutorials_Divisive_clustering_33_0.png" />
+</div>
+</div>
+<p>You can visualize the flat clusters using <code class="docutils literal notranslate"><span class="pre">dendo.plot_clusters()</span></code> method. The function takes the clusters and colors as arguments. The clusters are represented by different colors.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[16]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">dendo</span><span class="o">.</span><span class="n">plot_clusters</span><span class="p">(</span>
+    <span class="n">clusters</span><span class="p">,</span> <span class="n">colors</span><span class="p">,</span> <span class="n">plot_title</span><span class="o">=</span><span class="s2">&quot;Clusters of Coreset using VQE&quot;</span><span class="p">,</span> <span class="n">show_annotation</span><span class="o">=</span><span class="kc">True</span>
+<span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_Divisive_clustering_35_0.png" src="../../../_images/examples_python_tutorials_Divisive_clustering_35_0.png" />
+</div>
+</div>
+<p>The function below uses the <code class="docutils literal notranslate"><span class="pre">dendo.get_voronoi_tessalation()</span></code> method to convert the clusters into regions. <code class="docutils literal notranslate"><span class="pre">coreset_df</span></code>, <code class="docutils literal notranslate"><span class="pre">clusters</span></code> and <code class="docutils literal notranslate"><span class="pre">colors</span></code> need to be passed as the arguments to create the regions. This function creates a region for each coreset point separately and then colors them according to the clusters with colors passed as arguments. Another option is to create regions using the centroids of the clusters. You need to pass <code class="docutils literal notranslate"><span class="pre">tesslation_by_cluster=True</span></code> to the function to
+perform this task.</p>
+<p>Once the region creation is complete, you can use <code class="docutils literal notranslate"><span class="pre">plot_voironi()</span></code> method to plot the regions. The function takes the clusters and colors as arguments.</p>
+<p>Remembering that these regions were based on coresets, they can overlay the original data set and be used to cluster the data based on the coreset analysis.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[17]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">vt</span> <span class="o">=</span> <span class="n">Voironi_Tessalation</span><span class="p">(</span><span class="n">coreset_df</span><span class="p">,</span> <span class="n">clusters</span><span class="p">,</span> <span class="n">colors</span><span class="p">,</span> <span class="n">tesslation_by_cluster</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+<span class="n">vt</span><span class="o">.</span><span class="n">plot_voironi</span><span class="p">(</span><span class="n">plot_title</span><span class="o">=</span><span class="s2">&quot;Voironi Tessalation of Coreset using VQE&quot;</span><span class="p">,</span> <span class="n">show_annotation</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_Divisive_clustering_37_0.png" src="../../../_images/examples_python_tutorials_Divisive_clustering_37_0.png" />
+</div>
+</div>
+</section>
+<section id="QAOA-Implementation">
+<h2>QAOA Implementation<a class="headerlink" href="#QAOA-Implementation" title="Permalink to this heading">¶</a></h2>
+<p>CUDA-Q is designed to be a flexible tool for developers so they can test different implementations of the same code. For example, one can perform the same analysis, instead using a QAOA approach. Only the kernel needs to be changed as is done below.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[18]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_QAOA_circuit</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">Kernel</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Returns the QAOA circuit for the given number of qubits and circuit depth</span>
+
+
+<span class="sd">    Args:</span>
+<span class="sd">        number_of_qubits (int): Number of qubits</span>
+<span class="sd">        circuit_depth (int): Circuit depth</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        cudaq.Kernel: QAOA Circuit</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+    <span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">thetas</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span> <span class="n">number_of_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+        <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">)</span>
+
+        <span class="n">layers</span> <span class="o">=</span> <span class="n">circuit_depth</span>
+
+        <span class="k">for</span> <span class="n">layer</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">layers</span><span class="p">):</span>
+            <span class="k">for</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">number_of_qubits</span><span class="p">):</span>
+                <span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[(</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">%</span> <span class="n">number_of_qubits</span><span class="p">])</span>
+                <span class="n">rz</span><span class="p">(</span><span class="mf">2.0</span> <span class="o">*</span> <span class="n">thetas</span><span class="p">[</span><span class="n">layer</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[(</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">%</span> <span class="n">number_of_qubits</span><span class="p">])</span>
+                <span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[(</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">%</span> <span class="n">number_of_qubits</span><span class="p">])</span>
+
+            <span class="n">rx</span><span class="p">(</span><span class="mf">2.0</span> <span class="o">*</span> <span class="n">thetas</span><span class="p">[</span><span class="n">layer</span> <span class="o">+</span> <span class="n">layers</span><span class="p">],</span> <span class="n">qubits</span><span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">kernel</span>
+
+
+<span class="n">circuit</span> <span class="o">=</span> <span class="n">get_QAOA_circuit</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">circuit</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">rand</span><span class="p">(</span><span class="mi">2</span> <span class="o">*</span> <span class="n">circuit_depth</span><span class="p">),</span> <span class="mi">5</span><span class="p">,</span> <span class="n">circuit_depth</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+                                                                             »
+q0 : ──●──────────────────●──────────────────────────────────────────────────»
+     ╭─┴─╮╭────────────╮╭─┴─╮                                                »
+q1 : ┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──────────────────────────»
+     ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮                        »
+q2 : ────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──»
+                             ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮»
+q3 : ────────────────────────────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├»
+                                                     ╰───╯╰────────────╯╰───╯»
+q4 : ────────────────────────────────────────────────────────────────────────»
+                                                                             »
+
+################################################################################
+
+                        ╭───╮╭────────────╮╭───╮╭───────────╮
+────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├┤ rx(1.111) ├
+                        ╰─┬─╯╰────────────╯╰─┬─╯├───────────┤
+──────────────────────────┼──────────────────┼──┤ rx(1.111) ├
+                          │                  │  ├───────────┤
+──────────────────────────┼──────────────────┼──┤ rx(1.111) ├
+                          │                  │  ├───────────┤
+──●──────────────────●────┼──────────────────┼──┤ rx(1.111) ├
+╭─┴─╮╭────────────╮╭─┴─╮  │                  │  ├───────────┤
+┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──┤ rx(1.111) ├
+╰───╯╰────────────╯╰───╯                        ╰───────────╯
+
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[19]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_optimizer</span><span class="p">(</span>
+    <span class="n">optimizer</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">optimizer</span><span class="p">,</span> <span class="n">max_iterations</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+<span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">optimizer</span><span class="p">,</span> <span class="nb">int</span><span class="p">]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Returns the optimizer with the given parameters</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        optimizer (cudaq.optimizers.optimizer): Optimizer</span>
+<span class="sd">        max_iterations (int): Maximum number of iterations</span>
+<span class="sd">        **kwargs: Additional arguments</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="n">parameter_count</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;circuit_depth&quot;</span><span class="p">]</span>
+    <span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">8.0</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">8.0</span><span class="p">,</span> <span class="n">parameter_count</span><span class="p">)</span>
+    <span class="n">optimizer</span><span class="o">.</span><span class="n">max_iterations</span> <span class="o">=</span> <span class="n">max_iterations</span>
+    <span class="k">return</span> <span class="n">optimizer</span><span class="p">,</span> <span class="n">parameter_count</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[20]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">COBYLA</span><span class="p">()</span>
+
+<span class="n">divisive_clustering</span> <span class="o">=</span> <span class="n">DivisiveClusteringVQA</span><span class="p">(</span>
+    <span class="n">circuit_depth</span><span class="o">=</span><span class="n">circuit_depth</span><span class="p">,</span>
+    <span class="n">max_iterations</span><span class="o">=</span><span class="n">max_iterations</span><span class="p">,</span>
+    <span class="n">max_shots</span><span class="o">=</span><span class="n">max_shots</span><span class="p">,</span>
+    <span class="n">threshold_for_max_cut</span><span class="o">=</span><span class="mf">0.75</span><span class="p">,</span>
+    <span class="n">create_Hamiltonian</span><span class="o">=</span><span class="n">get_K2_Hamiltonian</span><span class="p">,</span>
+    <span class="n">optimizer</span><span class="o">=</span><span class="n">optimizer</span><span class="p">,</span>
+    <span class="n">optimizer_function</span><span class="o">=</span><span class="n">get_optimizer</span><span class="p">,</span>
+    <span class="n">create_circuit</span><span class="o">=</span><span class="n">get_QAOA_circuit</span><span class="p">,</span>
+    <span class="n">normalize_vectors</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+    <span class="n">sort_by_descending</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+    <span class="n">coreset_to_graph_metric</span><span class="o">=</span><span class="s2">&quot;dist&quot;</span><span class="p">,</span>
+<span class="p">)</span>
+
+<span class="n">hierarchial_clustering_sequence</span> <span class="o">=</span> <span class="n">divisive_clustering</span><span class="o">.</span><span class="n">get_divisive_sequence</span><span class="p">(</span><span class="n">coreset_df</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area stderr docutils container">
+<div class="highlight"><pre>
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 484/484 [00:00&lt;00:00, 12163.89it/s]
+100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00&lt;00:00, 52703.30it/s]
+100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 48/48 [00:00&lt;00:00, 31987.07it/s]
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00&lt;00:00, 36393.09it/s]
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00&lt;00:00, 37957.50it/s]
+100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00&lt;00:00, 42473.96it/s]
+</pre></div></div>
+</div>
+</section>
+<section id="Scaling-simulations-with-CUDA-Q">
+<h2>Scaling simulations with CUDA-Q<a class="headerlink" href="#Scaling-simulations-with-CUDA-Q" title="Permalink to this heading">¶</a></h2>
+<p>The University of Edinburgh team quickly encountered scaling challenges when they were developing this method. By developing with CUDA-Q they were able to port their code to an HPC environment once GPUs became available. GPUs massively accelerated their development and testing and allowed them to produce the 25 qubit experiments presented in their publication. If you have a GPU available, run the following code examples and see how the times compare on your device. Each call executes the
+divisive clustering procedure using the QAOA method, 100000 simulated shots for each VQE loop, and maximum 75 VQE iterations.</p>
+<p>First, try a slightly larger N=18 problem using the CPU (<code class="docutils literal notranslate"><span class="pre">qpp-cpu</span></code>) backend.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Uncomment the following line if you want to explicitly execute this step on your system.</span>
+<span class="c1"># !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 18</span>
+</pre></div>
+</div>
+</div>
+<p>Now try the N=18 example on the GPU backend (<code class="docutils literal notranslate"><span class="pre">nvidia</span></code>).</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[25]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="o">!</span>python3<span class="w"> </span>divisive_clustering_src/main_divisive_clustering.py<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--M<span class="w"> </span><span class="m">18</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Using BFL2 method to generate coresets
+100%|███████████████████████████████████████| 751/751 [00:00&lt;00:00, 3460.26it/s]
+100%|████████████████████████████████████████| 16/16 [00:00&lt;00:00, 42771.74it/s]
+100%|█████████████████████████████████████| 4064/4064 [00:00&lt;00:00, 6862.37it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 56871.92it/s]
+100%|████████████████████████████████████████| 16/16 [00:00&lt;00:00, 44979.13it/s]
+100%|██████████████████████████████████████| 128/128 [00:00&lt;00:00, 19366.94it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 53773.13it/s]
+100%|██████████████████████████████████████████| 8/8 [00:00&lt;00:00, 54648.91it/s]
+100%|██████████████████████████████████████████| 8/8 [00:00&lt;00:00, 51941.85it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 56111.09it/s]
+Total time for the execution: 461.866833317
+Total time spent on CUDA-Q: 10.452308367999706
+</pre></div></div>
+</div>
+<p>Scaling up to N=25, the task becomes even more onerous on a CPU. Depending on your device, the simulation may not even run. Try it and feel free to interrupt after your patience has worn out.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># target = &#39;qpp-cpu&#39;</span>
+<span class="c1"># Uncomment the following line if you want to explicitly execute this step on your system.</span>
+<span class="c1"># !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 25</span>
+</pre></div>
+</div>
+</div>
+<p>N=25 can still easily be completed by a single GPU.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[27]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># target = &#39;nvidia&#39;</span>
+<span class="o">!</span>python3<span class="w"> </span>divisive_clustering_src/main_divisive_clustering.py<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--M<span class="w"> </span><span class="m">25</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Using BFL2 method to generate coresets
+100%|█████████████████████████████████████| 7352/7352 [00:03&lt;00:00, 2063.82it/s]
+100%|███████████████████████████████████| 16492/16492 [00:03&lt;00:00, 4739.44it/s]
+100%|██████████████████████████████████████| 256/256 [00:00&lt;00:00, 15185.58it/s]
+100%|████████████████████████████████████████| 64/64 [00:00&lt;00:00, 23728.05it/s]
+100%|██████████████████████████████████████| 256/256 [00:00&lt;00:00, 15437.97it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 50840.05it/s]
+100%|████████████████████████████████████████| 32/32 [00:00&lt;00:00, 33562.82it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 54120.05it/s]
+100%|██████████████████████████████████████████| 8/8 [00:00&lt;00:00, 54560.05it/s]
+100%|██████████████████████████████████████████| 8/8 [00:00&lt;00:00, 55924.05it/s]
+100%|████████████████████████████████████████| 16/16 [00:00&lt;00:00, 42717.29it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 55007.27it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 53601.33it/s]
+100%|██████████████████████████████████████████| 4/4 [00:00&lt;00:00, 47127.01it/s]
+Total time for the execution: 67.61674502899999
+Total time spent on CUDA-Q: 21.439895901
+</pre></div></div>
+</div>
+<p>If we want to push the simulation to an <span class="math notranslate nohighlight">\(N=34\)</span> coreset, a single GPU (assuming A100) will run out of memory. Run the code below to see for yourself.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[28]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># target = &#39;nvidia&#39;</span>
+<span class="o">!</span>python3<span class="w"> </span>divisive_clustering_src/main_divisive_clustering.py<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--M<span class="w"> </span><span class="m">34</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Using BFL2 method to generate coresets
+RuntimeError: NLOpt runtime error: nlopt failure
+</pre></div></div>
+</div>
+<p>To compute a problem with 34 qubits, we need to pool the memory of multiple GPUs. If you have multiple GPUs available, try the code below to run the same computation on 4 GPUs. You do not need to wait for the code to finish, just note how it does not fail immediately due to memory issues.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[30]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># target = &#39;nvidia-mgpu&#39;</span>
+<span class="n">gpu_count</span> <span class="o">=</span> <span class="o">!</span>nvidia-smi<span class="w"> </span>-L<span class="w"> </span><span class="p">|</span><span class="w"> </span>wc<span class="w"> </span>-l
+<span class="k">try</span><span class="p">:</span>
+    <span class="n">gpu_count</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">gpu_count</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+<span class="k">except</span><span class="p">:</span>
+    <span class="n">gpu_count</span> <span class="o">=</span> <span class="mi">0</span>
+<span class="k">if</span> <span class="n">gpu_count</span> <span class="o">&gt;=</span> <span class="mi">4</span><span class="p">:</span>
+    <span class="o">!</span>mpirun<span class="w"> </span>-np<span class="w"> </span><span class="m">4</span><span class="w"> </span>python3<span class="w"> </span>divisive_clustering_src/main_divisive_clustering.py<span class="w"> </span>--target<span class="w"> </span>nvidia-mgpu<span class="w"> </span>--M<span class="w"> </span><span class="m">34</span>
+<span class="k">else</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Not enough GPUs found on this system (</span><span class="si">{</span><span class="n">gpu_count</span><span class="si">}</span><span class="s1">) to run this step&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Using BFL2 method to generate coresets
+Using BFL2 method to generate coresets
+Using BFL2 method to generate coresets
+Using BFL2 method to generate coresets
+^C
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span>
+</pre></div>
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="vqe_water_active_space.html" class="btn btn-neutral float-left" title="Water Molecule with Active Space (CPU vs. GPU)" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="H2-MRQKS.html" class="btn btn-neutral float-right" title="Multi-Reference Quantum Krylov Algorithm (H2 Example)" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/Divisive_clustering.ipynb b/pr-2241/examples/python/tutorials/Divisive_clustering.ipynb
new file mode 100644
index 0000000000..bfb75e8bf4
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/Divisive_clustering.ipynb
@@ -0,0 +1,1089 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Divisive Clustering With Coresets Using CUDA-Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This tutorial will explore a CUDA-Q implementation of recent research (ArXiv Paper: https://arxiv.org/pdf/2402.01529.pdf) performed by a team from the University of Edinburgh. This tutorial was jointly developed by NVIDIA and the authors so users can better understand their method and explore how CUDA-Q removed barriers to scaling. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The code for this tutorial is based off the MIT licensed code found here: https://github.com/Boniface316/bigdata_vqa"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Clustering is a common unsupervised learning technique aimed at grouping data with similar characteristics. The unique properties of quantum computers could allow for enhanced pattern finding in clustering applications and enable more reliable data analysis. However, quantum computers today are severely limited by qubit count and noise.  Performing practical clustering applications would require far too many qubits.  The Edinburgh team developed a new method (extending the work of Harrow) to leverage coresets for clustering applications on quantum computers and use far fewer qubits.  This tutorial will walk through an example using this approach for divisive clustering and emphasize the utility of CUDA-Q for scaling quantum simulations.\n",
+    "\n",
+    "The goal of divisive clustering is to begin with all data points as one set, and iteratively bipartition the data until each point is its own cluster.  The branching behavior of this process can be used to understand similarities in the data points.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# If you are running outside of a CUDA-Q container or CUDA-Q directory tree, you may need to uncomment these lines to fetch the files.\n",
+    "# If you are running inside a CUDA-Q tree, then this step can be skipped.\n",
+    "# !mkdir divisive_clustering_src\n",
+    "# !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py\n",
+    "# !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "!pip install mpi4py==3.1.6\n",
+    "!pip install networkx==2.8.8\n",
+    "!pip install pandas==2.2.2\n",
+    "!pip install scikit-learn==1.4.2\n",
+    "!pip install tqdm==4.66.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "\n",
+    "# Auxillary Imports\n",
+    "import os\n",
+    "import numpy as np\n",
+    "import networkx as nx\n",
+    "import pandas as pd\n",
+    "import matplotlib.pyplot as plt\n",
+    "import warnings\n",
+    "from typing import Tuple\n",
+    "from divisive_clustering_src.divisive_clustering import Coreset, DivisiveClustering, Dendrogram, Voironi_Tessalation\n",
+    "\n",
+    "warnings.filterwarnings(\"ignore\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The settings below are global parameters for the quantum simulation and can be toggled by the user.  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "circuit_depth = 1\n",
+    "max_iterations = 75\n",
+    "max_shots = 1000\n",
+    "np.random.seed(10)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "\n",
+    "Given a data set $X = (x_1, x_2, \\cdots, x_N)$, a coreset is weighted data set of much smaller size ($X', w$) that represents $X$ enough such that analysis of ($X', w$) can allow us to draw reasonable approximate conclusions about $X$. There are various approaches to build coresets. They can be found in Practical Coreset Construction for Machine Learning (https://arxiv.org/pdf/1703.06476.pdf) and New Streaming Algorithms for Coresets in Machine Learning (https://arxiv.org/pdf/1703.06476.pdf).\n",
+    "\n",
+    "\n",
+    "Essentially, coreset construction boils down to finding the optimal coreset size and weights given some error tolerance.  Given the constraints of a quantum computer, in this work, a coreset size is selected $a$ $priori$, and the error is determined for each model.\n",
+    "\n",
+    "\n",
+    "The following is an example $M=10$ coreset constructed from a 1000-point data set and loaded into a pandas data frame. See the image below where the coreset is represented by the black stars, the size of which corresponds to the weights.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "          X         Y     weights Name\n",
+      "0  7.028364  1.669787  234.230716    A\n",
+      "1  7.167441  0.354792  101.319288    B\n",
+      "2  1.022889 -0.921443  125.158339    C\n",
+      "3  2.706134 -2.636852   13.650774    D\n",
+      "4  6.998497  0.455847  116.758239    E\n",
+      "5  7.507918  0.630311  120.727176    F\n",
+      "6 -2.102508  2.297727   53.294127    G\n",
+      "7  5.722463  1.400433   77.415840    H\n",
+      "8 -1.425868  2.341136   42.847985    I\n",
+      "9  7.985373 -0.063209  240.116237    J\n"
+     ]
+    }
+   ],
+   "source": [
+    "raw_data = Coreset.create_dataset(1000)\n",
+    "coreset = Coreset(\n",
+    "    raw_data=raw_data,\n",
+    "    number_of_sampling_for_centroids=10,\n",
+    "    coreset_size=10,\n",
+    "    number_of_coresets_to_evaluate=4,\n",
+    "    coreset_method=\"BFL2\",\n",
+    ")\n",
+    "\n",
+    "\n",
+    "coreset_vectors, coreset_weights = coreset.get_best_coresets()\n",
+    "\n",
+    "coreset_df = pd.DataFrame(\n",
+    "    {\"X\": coreset_vectors[:, 0], \"Y\": coreset_vectors[:, 1], \"weights\": coreset_weights}\n",
+    ")\n",
+    "coreset_df[\"Name\"] = [chr(i + 65) for i in coreset_df.index]\n",
+    "print(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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3nzzTbRo0QK//fYbxo4dq7MdbD788EMUFxfj9u3bWLRoEQDA29sbAPDtt9/inXfewdChQzFp0iQ8evQI586dw7FjxzB69Gi9x547dy4EAgGmT5+O/Px8LF68GD179sTZs2fh4eEBAPj777/Rt29fJCQkYNasWRAKhVi9ejWeeeYZpKeno1OnTgCAN998E5s3b8bEiRMRHx+PwsJCHDp0CJcuXUKHDh10/hymOnPmDLy8vDT+JpVtO3PmDLp27cr6/nPnziExMRGurq54/fXXERkZievXr+OPP/7A3LlzAQAXL15EYmIiJBIJ3n//fbi6umLlypVISkrCgQMH8OSTT6odc/z48QgMDMTMmTNRXl4OAPj5558xduxY9O7dG59//jkqKiqwfPlydO3aFWfOnFEFeUOGDMHFixfx9ttvIzIyEvn5+di7dy9u3bql2ofLsfRdN6aYPXs25s2bh9deew2dOnVCSUkJTp48idOnT+PZZ5/V+d5Dhw4hNTUV48ePh4+PD7766isMGTIEt27dQkBAAADF/7M+ffogNDQUc+bMgUwmwyeffILAwECD2nn//n0Aimv3xo0bmD59OgICAvD8889r7FtaWqraX8nf318jSDFUWVkZysrK0LBhQ5OO41QY4lRWr17NAGD++usvpqCggMnJyWE2b97MBAYGMmKxmMnJyVHtW1NTw0ilUrX3P3jwgAkODmZeeeUV1bZNmzYxAJiMjAyGYRhm27ZtjFgsZgYMGMCMGDFCtV+bNm2YF154QWf7Fi9ezABgNm7cqNpWXl7ONG3alAHA7N+/X7W9oqJC4/3z5s1jBAIBk52drdo2YcIEhu1Pvf4xqqqqmFatWjHPPPOMznYacv6xY8cyAJhPPvlEbd/27dszCQkJqu9///13BgAzf/581baamhomMTGRAcCsXr1aZ3v279+v8Tvq168fExERobHvwIEDmZYtW+r5CdnP0bhxY6akpES1fePGjQwAZsmSJQzDMIxcLmdiY2OZ3r17M3K5XLVfRUUFExUVxTz77LOqbb6+vsyECRN0npft5+BC13v79evHREdHa2wvLy9nADAzZszQeexu3boxPj4+av+/GYZR+5kHDRrEuLm5MdevX1dtu3PnDuPj48N069ZNtU15bXbt2pWpqalRbS8tLWUaNGjAjBs3Tu0c9+7dY3x9fVXbHzx4wABg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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.scatter(raw_data[:, 0], raw_data[:, 1], label=\"Raw Data\", c=\"#7eba00\")\n",
+    "plt.scatter(\n",
+    "    coreset_df[\"X\"],\n",
+    "    coreset_df[\"Y\"],\n",
+    "    s=coreset_df[\"weights\"],\n",
+    "    label=\"Coreset\",\n",
+    "    color=\"black\",\n",
+    "    marker=\"*\",\n",
+    ")\n",
+    "plt.xlabel(\"X\")\n",
+    "plt.ylabel(\"Y\")\n",
+    "plt.title(\"Raw data and its best 10 coreset using BFL2\")\n",
+    "plt.legend()\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Data preprocessing"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In order to cluster data on a quantum computer, the task needs to be cast into the form of a binary optimization problem.  Each qubit represents a coreset point, and the quantum algorithm determines how to bipartition the coreset points at each iteration of the divisive clustering routine. \n",
+    "\n",
+    "The first step is to convert coreset points into a fully connected graph. The edge weight is calculated by:\n",
+    "\n",
+    "$e_{ij} = w_iw_jd_{ij}$ where $d_{ij}$ is the Euclidean distance between points $i$ and $j$. \n",
+    "\n",
+    "This process is handled by `Coreset.coreset_to_graph()`. The function returns a fully connected graph $G$ with edge weights."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum functions"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The divisive clustering problem will be implemented on a quantum computer using a variational quantum algorithm (VQA) approach.  A VQA takes a Hamiltonian (encoded with the optimization problem) and a parameterized ansatz and evaluates expectation values (quantum computer) that inform updates to the ansatz parameters (classical computer).  The graph $G$ (Code in the \"src\" file) is used to construct the Hamiltonian, derived specifically for the divisive clustering problem, and motivated by a max-cut Hamiltonian.  The `spin.z(i)` method in CUDA-Q adds a Pauli Z operation that acts on qubit $i$ to the Hamiltonian."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_K2_Hamiltonian(G: nx.Graph) -> cudaq.SpinOperator:\n",
+    "    \"\"\"Returns the K2 Hamiltonian for the given graph G\n",
+    "\n",
+    "    Args:\n",
+    "        G (nx.Graph): Weighted graph\n",
+    "    \"\"\"\n",
+    "    H = 0\n",
+    "\n",
+    "    for i, j in G.edges():\n",
+    "        weight = G[i][j][\"weight\"]\n",
+    "        H += weight * (spin.z(i) * spin.z(j))\n",
+    "\n",
+    "    return H"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The code below constructs a quantum kernel, defining the circuit which will serve as an ansatz.  The structure of the circuit is a hardware efficient ansatz consisting of layers of parameterized $R_Z$ and $R_Y$ gate acting on each qubit, followed by a linear cascade of CNOT gates, and two more rotation gates.\n",
+    "\n",
+    "The `@cudaq.kernel` decorator allows us to define a quantum circuit in the new kernel mode syntax which provides performance benefits to JIT compilation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_VQE_circuit(number_of_qubits: int, circuit_depth: int) -> cudaq.Kernel:\n",
+    "    \"\"\"Returns the VQE circuit for the given number of qubits and circuit depth\n",
+    "\n",
+    "    Args:\n",
+    "        number_of_qubits (int): Number of qubits\n",
+    "        circuit_depth (int): Circuit depth\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq.Kernel: VQE Circuit\n",
+    "    \"\"\"\n",
+    "\n",
+    "    @cudaq.kernel\n",
+    "    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):\n",
+    "        \"\"\"VQE Circuit\n",
+    "\n",
+    "        Args:\n",
+    "            thetas (list[float]): List of parameters\n",
+    "            number_of_qubits (int): Number of qubits\n",
+    "            circuit_depth (int): Circuit depth\n",
+    "        \"\"\"\n",
+    "        qubits = cudaq.qvector(number_of_qubits)\n",
+    "\n",
+    "        theta_position = 0\n",
+    "\n",
+    "        for i in range(circuit_depth):\n",
+    "            for j in range(number_of_qubits):\n",
+    "                ry(thetas[theta_position], qubits[j])\n",
+    "                rz(thetas[theta_position + 1], qubits[j])\n",
+    "\n",
+    "                theta_position += 2\n",
+    "\n",
+    "            for j in range(number_of_qubits - 1):\n",
+    "                cx(qubits[j], qubits[j + 1])\n",
+    "\n",
+    "            for j in range(number_of_qubits):\n",
+    "                ry(thetas[theta_position], qubits[j])\n",
+    "                rz(thetas[theta_position + 1], qubits[j])\n",
+    "\n",
+    "                theta_position += 2\n",
+    "\n",
+    "    return kernel"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can visualize the circuit using the `cudaq.draw()` method. Below, we are drawing the circuit for 5 qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭────────────╮ ╭────────────╮      ╭────────────╮╭────────────╮»\n",
+      "q0 : ┤ ry(0.8904) ├─┤ rz(0.7335) ├───●──┤ ry(0.4343) ├┤ rz(0.2236) ├»\n",
+      "     ├────────────┤ ├────────────┤ ╭─┴─╮╰────────────╯├────────────┤»\n",
+      "q1 : ┤ ry(0.7937) ├─┤ rz(0.9981) ├─┤ x ├──────●───────┤ ry(0.3945) ├»\n",
+      "     ├───────────┬╯ ├────────────┤ ╰───╯    ╭─┴─╮     ╰────────────╯»\n",
+      "q2 : ┤ ry(0.696) ├──┤ rz(0.3352) ├──────────┤ x ├───────────●───────»\n",
+      "     ├───────────┴╮╭┴────────────┤          ╰───╯         ╭─┴─╮     »\n",
+      "q3 : ┤ ry(0.6658) ├┤ rz(0.05277) ├────────────────────────┤ x ├─────»\n",
+      "     ├───────────┬╯├─────────────┴╮                       ╰───╯     »\n",
+      "q4 : ┤ ry(0.791) ├─┤ rz(0.003569) ├─────────────────────────────────»\n",
+      "     ╰───────────╯ ╰──────────────╯                                 »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                                             \n",
+      "─────────────────────────────────────────────\n",
+      "╭────────────╮                               \n",
+      "┤ rz(0.4119) ├───────────────────────────────\n",
+      "├────────────┤╭────────────╮                 \n",
+      "┤ ry(0.3205) ├┤ rz(0.3504) ├─────────────────\n",
+      "╰────────────╯├────────────┤ ╭────────────╮  \n",
+      "──────●───────┤ ry(0.3913) ├─┤ rz(0.7392) ├──\n",
+      "    ╭─┴─╮     ├────────────┤╭┴────────────┴─╮\n",
+      "────┤ x ├─────┤ ry(0.3171) ├┤ rz(0.0008056) ├\n",
+      "    ╰───╯     ╰────────────╯╰───────────────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "parameter_count = 4 * circuit_depth * 5\n",
+    "parameters = np.random.rand(parameter_count)\n",
+    "\n",
+    "circuit = get_VQE_circuit(5, circuit_depth)\n",
+    "print(cudaq.draw(circuit, parameters, 5, circuit_depth))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The next step is to select a classical optimizer. There are multiple [optimizers](https://nvidia.github.io/cuda-quantum/latest/api/languages/python_api.html#optimizers) built-in to CUDA-Q that can be selected. The code below returns the optimizer with the proper number of initial parameters. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_optimizer(\n",
+    "    optimizer: cudaq.optimizers.optimizer, max_iterations, **kwargs\n",
+    ") -> Tuple[cudaq.optimizers.optimizer, int]:\n",
+    "    \"\"\"Returns the optimizer with the given parameters\n",
+    "\n",
+    "    Args:\n",
+    "        optimizer (cudaq.optimizers.optimizer): Optimizer\n",
+    "        max_iterations (int): Maximum number of iterations\n",
+    "        **kwargs: Additional arguments\n",
+    "\n",
+    "    Returns:\n",
+    "        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count\n",
+    "    \"\"\"\n",
+    "    parameter_count = 4 * kwargs[\"circuit_depth\"] * kwargs[\"qubits\"]\n",
+    "    initial_params = np.random.uniform(-np.pi / 8.0, np.pi / 8.0, parameter_count)\n",
+    "    optimizer.initial_parameters = initial_params\n",
+    "\n",
+    "    optimizer.max_iterations = max_iterations\n",
+    "    return optimizer, parameter_count"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Divisive Clustering Function"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The `DivisiveClusteringVQA` class enables the procedure to iteratively bipartition the coreset points until each is its own cluster. If you wish to develop on top of this or see how the underlying code works, please see the `divisive_clustering.py` file in the src directory. \n",
+    "\n",
+    "`run_divisive_clustering`, takes the current iteration's coreset points that will be bipartitioned as inputs, extracts the appropriate weights, and builds a graph $G$. The graph is then an input into the `get_counts_from_simulation` function. \n",
+    "\n",
+    "\n",
+    "`get_counts_from_simulation` handles preparation and execution of the quantum simulation. First, it takes $G$ and from it builds a spin Hamiltonian. Second, it defines a cost function, which in this case is a lambda function that returns the expectation value of our parameterized quantum circuit and the Hamiltonian. This value is obtained using the CUDA-Q `observe` command, accelerated by GPUs.  After the expectation value is minimized, the quantum circuit corresponding to the optimal parameters is sampled using the CUDA-Q `sample` function. The bitstrings and their associated counts are returned by `get_counts_from_simulation`.\n",
+    "\n",
+    "A subset of these counts is evaluated to compute their exact cost. The best bitstring is returned and later used to assign the coreset points to one of two clusters.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class DivisiveClusteringVQA(DivisiveClustering):\n",
+    "    def __init__(\n",
+    "        self,\n",
+    "        **kwargs,\n",
+    "    ):\n",
+    "        super().__init__(**kwargs)\n",
+    "\n",
+    "    def run_divisive_clustering(\n",
+    "        self,\n",
+    "        coreset_vectors_df_for_iteration: pd.DataFrame,\n",
+    "    ):\n",
+    "        \"\"\"Runs the Divisive Clustering algorithm\n",
+    "\n",
+    "        Args:\n",
+    "            coreset_vectors_df_for_iteration (pd.DataFrame): Coreset vectors for the iteration\n",
+    "\n",
+    "        Returns:\n",
+    "            str: Best bitstring\n",
+    "\n",
+    "        \"\"\"\n",
+    "        coreset_vectors_for_iteration_np, coreset_weights_for_iteration_np = (\n",
+    "            self._get_iteration_coreset_vectors_and_weights(coreset_vectors_df_for_iteration)\n",
+    "        )\n",
+    "\n",
+    "        G = Coreset.coreset_to_graph(\n",
+    "            coreset_vectors_for_iteration_np,\n",
+    "            coreset_weights_for_iteration_np,\n",
+    "            metric=self.coreset_to_graph_metric,\n",
+    "        )\n",
+    "\n",
+    "        counts = self.get_counts_from_simulation(\n",
+    "            G,\n",
+    "            self.circuit_depth,\n",
+    "            self.max_iterations,\n",
+    "            self.max_shots,\n",
+    "        )\n",
+    "\n",
+    "        return self._get_best_bitstring(counts, G)\n",
+    "\n",
+    "    def get_counts_from_simulation(\n",
+    "        self, G: nx.graph, circuit_depth: int, max_iterations: int, max_shots: int\n",
+    "    ) -> cudaq.SampleResult:\n",
+    "        \"\"\"\n",
+    "        Runs the VQA simulation\n",
+    "\n",
+    "        Args:\n",
+    "            G (nx.graph): Graph\n",
+    "            circuit_depth (int): Circuit depth\n",
+    "            max_iterations (int): Maximum number of iterations\n",
+    "            max_shots (int): Maximum number of shots\n",
+    "\n",
+    "        Returns:\n",
+    "            cudaq.SampleResult: Measurement from the experiment\n",
+    "        \"\"\"\n",
+    "\n",
+    "        qubits = len(G.nodes)\n",
+    "        Hamiltonian = self.create_Hamiltonian(G)\n",
+    "        optimizer, parameter_count = self.optimizer_function(\n",
+    "            self.optimizer, max_iterations, qubits=qubits, circuit_depth=circuit_depth\n",
+    "        )\n",
+    "\n",
+    "        kernel = self.create_circuit(qubits, circuit_depth)\n",
+    "\n",
+    "        def objective_function(\n",
+    "            parameter_vector: list[float],\n",
+    "            hamiltonian: cudaq.SpinOperator = Hamiltonian,\n",
+    "            kernel: cudaq.Kernel = kernel,\n",
+    "        ) -> float:\n",
+    "            \"\"\"\n",
+    "\n",
+    "            Objective function that returns the cost of the simulation\n",
+    "\n",
+    "            Args:\n",
+    "                parameter_vector (List[float]):\n",
+    "                hamiltonian (cudaq.SpinOperator): Circuit parameter values as a vector\n",
+    "                kernel (cudaq.Kernel) : Circuit configuration\n",
+    "\n",
+    "            Returns:\n",
+    "                float: Expectation value of the circuit\n",
+    "\n",
+    "            \"\"\"\n",
+    "\n",
+    "            get_result = lambda parameter_vector: cudaq.observe(\n",
+    "                kernel, hamiltonian, parameter_vector, qubits, circuit_depth\n",
+    "            ).expectation()\n",
+    "\n",
+    "            cost = get_result(parameter_vector)\n",
+    "\n",
+    "            return cost\n",
+    "\n",
+    "        energy, optimal_parameters = optimizer.optimize(\n",
+    "            dimensions=parameter_count, function=objective_function\n",
+    "        )\n",
+    "\n",
+    "        counts = cudaq.sample(\n",
+    "            kernel, optimal_parameters, qubits, circuit_depth, shots_count=max_shots\n",
+    "        )\n",
+    "\n",
+    "        return counts"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "An instance of the `DivisiveClusteringVQA` class is mostly constructed from variables previously discussed like the functions for building the Hamiltonians and quantum circuits. Parameters related to the quantum simulation can also be specified here such as `circuit_depth` and `max_shots`.  The ` threshold_for_max_cut` parameter specifies what percent of the sample results from the quantum computer are checked for the best bitstring value.\n",
+    "\n",
+    "The other options specify advanced features like if the data is normalized and how the graph weights are computed.\n",
+    "\n",
+    "\n",
+    "Finally, the `get_divisive_sequence` method performs the iterations and produces the clustering data which we will analyze below. Note that this postprocessing code is not exposed in this tutorial but can be found in the source code. \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 129/129 [00:00<00:00, 12075.19it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00<00:00, 35025.50it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 18/18 [00:00<00:00, 44254.09it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 15827.56it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 13617.87it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "divisive_clustering = DivisiveClusteringVQA(\n",
+    "    circuit_depth=circuit_depth,\n",
+    "    max_iterations=max_iterations,\n",
+    "    max_shots=max_shots,\n",
+    "    threshold_for_max_cut=0.75,\n",
+    "    create_Hamiltonian=get_K2_Hamiltonian,\n",
+    "    optimizer=optimizer,\n",
+    "    optimizer_function=get_optimizer,\n",
+    "    create_circuit=get_VQE_circuit,\n",
+    "    normalize_vectors=True,\n",
+    "    sort_by_descending=True,\n",
+    "    coreset_to_graph_metric=\"dist\",\n",
+    ")\n",
+    "\n",
+    "hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The data can be nicely visualized with a Dendrogram which maps where the bipartitionings occurred. Early splits generally mark divisions between the least similar data."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAy0AAANICAYAAADKKQDvAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9MElEQVR4nO3deXzU9Z348Xc4EsItCFUEOcQbRSueaAFLtQhatIpFLIqVWkUrtehP2vVAu6Xq6oquUnVV3AqLYLXrsWhVFrteVUHXo2qBB1i0CooSrhCOfH9/uJklJCABwnwgz+fjMQ+Yme985z1DSPLK90hBlmVZAAAAJKpevgcAAADYFNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAtQJnTp1inPPPTffY+zQnnrqqTjkkEOiUaNGUVBQEEuWLMn3SHVWQUFBXHvttfkeA2C7ES3ANjFhwoQoKCjIXRo1ahTt2rWLE088MW677bZYtmxZvkdkKyxevDgGDRoUxcXFcccdd8Tvfve7aNKkySYfM3fu3LjggguiS5cu0ahRo2jevHn07Nkzxo0bF6Wlpdtp8tqxcuXKuPbaa2PGjBn5HmW7ueWWW6KgoCCeffbZjS5zzz33REFBQTz22GO527Isi9/97nfxrW99K1q2bBmNGzeOgw46KH71q1/FypUrq6yjd+/elT6XrH/Zb7/9auW1AelrkO8BgJ3LddddF507d441a9bEp59+GjNmzIiRI0fGLbfcEo899lgcfPDB+R6RLfDaa6/FsmXL4vrrr4++fft+7fJPPvlknHHGGVFUVBRDhw6Nbt26xerVq+OFF16Iyy+/PN599924++67t8PktWPlypUxZsyYiPjqm+ztrbS0NBo02L5fwn/wgx/E5ZdfHpMmTdrox8CkSZOidevW0a9fv4iIWLduXZx11lkxZcqUOO644+Laa6+Nxo0bx3//93/HNddcE1OmTIlnn3022rZtW2k97du3j7Fjx1ZZf4sWLbb9CwN2CKIF2Kb69esXPXr0yF0fPXp0TJ8+PQYMGBCnnHJKvPfee1FcXJzHCTduxYoVX7v1YFtZtWpVFBYWRr16O8YG70WLFkVERMuWLb922Xnz5sUPfvCD6NixY0yfPj1233333H0jRoyIOXPmxJNPPrnVM2VZFqtWrUr246k2NWrUaLs/Z7t27aJPnz7xyCOPxPjx46OoqKjS/R9//HH86U9/ih//+MfRsGHDiIi48cYbY8qUKTFq1Ki46aabcsv++Mc/jkGDBsXAgQNj2LBhVT4eWrRoEWeffXbtvyhgh7FjfLUEdmjHH398XHXVVfHhhx/Ggw8+WOm+999/P04//fRo1apVNGrUKHr06FFp15KI/9v17MUXX4zLLrss2rRpE02aNIlTTz01Pvvss0rLZlkWv/rVr6J9+/bRuHHj6NOnT7z77rtVZqpY5/PPPx8XXXRRtG3bNtq3b5+7/84774wDDzwwioqKol27djFixIhqj+G44447okuXLlFcXBxHHHFE/Pd//3f07t270k/fZ8yYEQUFBTF58uT4h3/4h9hjjz2icePGsXTp0vjiiy9i1KhRcdBBB0XTpk2jefPm0a9fv/if//mfSs9TsY4pU6bEmDFjYo899ohmzZrF6aefHiUlJVFWVhYjR46Mtm3bRtOmTWPYsGFRVla2Wf8+U6dOjcMOOyyKi4tj1113jbPPPjs+/vjj3P29e/eOc845JyIiDj/88CgoKNjk8UE33nhjLF++PO69995KwVKha9eucemll+aur127Nq6//vrYa6+9oqioKDp16hS/+MUvqszfqVOnGDBgQDz99NPRo0ePKC4ujrvuuisiIpYsWRIjR46MDh06RFFRUXTt2jVuuOGGKC8vr7SOyZMnx2GHHRbNmjWL5s2bx0EHHRTjxo2rtMzXrWv+/PnRpk2biIgYM2ZMbtelTR1jcu2110ZBQUGV2ys+DufPn5+77fXXX48TTzwxdt111yguLo7OnTvHeeedV+lxGz5fxfrnzJkT5557brRs2TJatGgRw4YNq7ILVmlpafz0pz+NXXfdNZo1axannHJKfPzxx5t1nMzZZ58dJSUl1Ubn5MmTo7y8PIYMGZJ7nptuuin22WefareanHzyyXHOOefEf/7nf8arr766yecFsKUF2C5++MMfxi9+8Yv44x//GMOHD4+IiHfffTd69uwZe+yxR1x55ZXRpEmTmDJlSgwcODB+//vfx6mnnlppHZdccknssssucc0118T8+fPj1ltvjYsvvjgeeuih3DJXX311/OpXv4qTTjopTjrppJg1a1accMIJsXr16mrnuuiii6JNmzZx9dVXx4oVKyLiq28Ax4wZE3379o0L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mDHxz//8z9G7d+8YOHBgnHXWWVUOfK/Opv6PNG/ePPd+b/g+bvj+b0q/fv2iVatWMWnSpNyxTf/+7/8e3bt3jwMPPDC33MaCZH0V92149rAmTZps1lnqgLpDtADbxUcffRQlJSW5b44qDmoeNWpUlZ+cV9jwG6n1t4isL8uyLZ5re555qrrn+vWvfx1XXXVVnHfeeXH99ddHq1atol69ejFy5MgqB5FHbPw9qI33Zks0b9482rVrF++8806NHlfdQerVqe49LC8vj+985ztxxRVXVPuYffbZJyK++sb4zTffjKeffjqmTZsW06ZNi/vvvz+GDh0aDzzwQI3WVVMbe33rR2rFcg8//HC88sor8fjjj8fTTz8d5513Xtx8883xyiuvRNOmTTf5PNvj46Bhw4YxaNCguOeee2LhwoXxt7/9LWbPnh033nhjpeUOOOCAiIh46623YuDAgdWu66233oqIiC5dumyz+YCdk2gBtovf/e53ERG5QKn4JqVhw4bb7CeqHTt2jIivflq+/jdBn332WW5rzOau44MPPqi0jtWrV8e8efNys1YsN2fOnOjTp09uubVr18b8+fM3+6Dshx9+OPr06RP33ntvpduXLFkSu+6662atY0ut/1qPP/74Svd98MEHuftrasCAAXH33XfHyy+/HEcfffTXzlBeXh6zZ8+O/fffP3f7woULY8mSJZs1w1577RXLly/frI+jwsLCOPnkk+Pkk0+O8vLyuOiii+Kuu+6Kq666Krp27brZ69rcyKpQscVjyZIllU4bveGWpApHHXVUHHXUUfGP//iPMWnSpBgyZEhMnjw5zj///Bo974Yq3u958+ZV2iI5Z86cGq1nyJAh8dvf/jYeeuihmDdvXhQUFMTgwYMrLdOzZ89o2bJlTJo0KX75y19WG1T/9m//FhERZ5xxxha8GqAucUwLUOumT58e119/fXTu3Dm3z3vbtm2jd+/ecdddd8Unn3xS5TEbnsp4c/Tt2zcaNmwYt99+e6WfLFecPWpz11FYWBi33XZbpXXce++9UVJSkjvLUo8ePaJ169Zxzz33VDpuZOLEiZsdSBFf/WR8w5+CT506tcrxPLWhR48e0bZt2/jtb39b6fTC06ZNi/fee2+zzyi1oSuuuCKaNGkS559/fixcuLDK/XPnzs2dZvikk06KiKr/RrfccktExGbNMGjQoHj55Zfj6aefrnLfkiVLcv8+ixcvrnRfvXr1cnFZ8fo3d12NGzfO3bY5Ks62tv4xMStWrMht4anw5ZdfVvl4OOSQQyrNuDUqfmhw5513Vrr99ttvr9F6evbsGZ06dYoHH3wwHnrooejVq1eVM+Y1btw4rrjiivjggw/il7/8ZZV1PPnkkzFhwoQ4+eST46CDDqrhKwHqGltagG1q2rRp8f7778fatWtj4cKFMX369HjmmWeiY8eO8dhjj1U64PuOO+6IY489Ng466KAYPnx4dOnSJRYuXBgvv/xyfPTRR1V+V8nXadOmTYwaNSrGjh0bAwYMiJNOOineeOONmDZt2mZvtWjTpk2MHj06xowZE9/97nfjlFNOiQ8++CDuvPPOOPzww3O/8K6wsDCuvfbauOSSS+L444+PQYMGxfz582PChAmx1157bfZP4gcMGBDXXXddDBs2LI455ph4++23Y+LEidtld5mGDRvGDTfcEMOGDYtevXrF4MGDc6c87tSpU/zsZz/bovXutddeMWnSpDjzzDNj//33j6FDh0a3bt1i9erV8dJLL8XUqVNzx0J07949zjnnnLj77rtjyZIl0atXr3j11VfjgQceiIEDB1bairUxl19+eTz22GMxYMCAOPfcc+Owww6LFStWxNtvvx0PP/xwzJ8/P3bdddc4//zz44svvojjjz8+2rdvHx9++GHcfvvtccghh+S28mzuuoqLi+OAAw6Ihx56KPbZZ59o1apVdOvWLbp161btjCeccELsueee8aMf/Sguv/zyqF+/ftx3333Rpk2b+Nvf/pZb7oEHHog777wzTj311Nhrr71i2bJlcc8990Tz5s1zgbc1DjvssPj+978ft956ayxevDh3yuO//vWvEbH5W5AKCgrirLPOil//+tcREXHddddVu9wVV1wRb775Ztxwww3x8ssvx/e///0oLi6OF154IR588ME48MADY8KECVUeV1JSUuV3OlXwSyehjsrbecuAnUrFqVsrLoWFhdluu+2Wfec738nGjRuXLV26tNrHzZ07Nxs6dGi22267ZQ0bNsz22GOPbMCAAdnDDz9cZd0bnga24jTA//Vf/5W7bd26ddmYMWOy3XffPSsuLs569+6dvfPOO1nHjh2rPeXxxk4t+y//8i/ZfvvtlzVs2DD7xje+kV144YXZl19+WWW52267LevYsWNWVFSUHXHEEdmLL76YHXbYYdl3v/vdKnNOnTq1yuNXrVqV/fznP8/N27Nnz+zll1/OevXqVe1pkzdcx8ZeR8UpcD/77LNqX9/6HnrooezQQw/NioqKslatWmVDhgzJPvroo816nk3561//mg0fPjzr1KlTVlhYmDVr1izr2bNndvvtt1c6zfWaNWuyMWPGZJ07d84aNmyYdejQIRs9enSlZbLsq1Me9+/fv9rnWrZsWTZ69Oisa9euWWFhYbbrrrtmxxxzTPZP//RPuVNEP/zww9kJJ5yQtW3bNissLMz23HPP7IILLsg++eSTGq8ry7LspZdeyg477LCssLBws04XPHPmzOzII4/MPfctt9xS5ZTHs2bNygYPHpztueeeWVFRUda2bdtswIAB2euvv15pXRs+38b+vTdcf5Zl2YoVK7IRI0ZkrVq1ypo2bZoNHDgw++CDD7KIyH7zm99s8jWs7913380iIisqKqr2/0aF8vLybMKECVnPnj2zZs2a5T5H9O3bNysrK6uy/KZOeezbFqi7CrJsOx+lCbATKy8vjzZt2sRpp50W99xzT77Hgc3y5ptvxqGHHhoPPvhgpdMW14Y1a9bEySefHM8991w8/vjjlc7eBrAxjmkB2EKrVq2qcvzBv/3bv8UXX3wRvXv3zs9Q8DVKS0ur3HbrrbdGvXr14lvf+latP3/Dhg3j97//fRxyyCFxxhlnVPv7iAA2ZEsLwBaaMWNG/OxnP4szzjgjWrduHbNmzYp777039t9//5g5c2YUFhbme0SoYsyYMTFz5szo06dPNGjQIHf65x//+Mdx11135Xs8gGqJFoAtNH/+/PjpT38ar776anzxxRfRqlWrOOmkk+I3v/lNlV+WB6l45plnYsyYMfGXv/wlli9fHnvuuWf88Ic/jF/+8pfRoIHz8wBpEi0AAEDSHNMCAAAkTbQAAABJ2+47r5aXl8ff//73aNas2Wb/EisAAGDnk2VZLFu2LNq1axf16m18e8p2j5a///3v0aFDh+39tAAAQKIWLFgQ7du33+j92z1amjVrFhFfDda8efPt/fQAAEAili5dGh06dMg1wsZs92ip2CWsefPmogUAAPjaw0YciA8AACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQtAb5HgDyKcuyKF2zLt9jAMB2U9ywfhQUFOR7DKgR0UKdlWVZnP7bl2Pmh1/mexQA2G56dNwlpv7kaOHCDsXuYdRZpWvWCRYA6pzXP/zSXgbscGxpgYh4/R/6RuPC+vkeAwBqzcrV66LHr57N9xiwRUQLRETjwvrRuNB/BwCAFNk9DAAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJJWo2i59tpro6CgoNJlv/32q63ZAAAAokFNH3DggQfGs88++38raFDjVQAAAGy2GhdHgwYNYrfddquNWQAAAKqo8TEts2fPjnbt2kWXLl1iyJAh8be//a025gIAAIiIGm5pOfLII2PChAmx7777xieffBJjxoyJ4447Lt55551o1qxZtY8pKyuLsrKy3PWlS5du3cQAAECdUqNo6devX+7vBx98cBx55JHRsWPHmDJlSvzoRz+q9jFjx46NMWPGbN2UAABAnbVVpzxu2bJl7LPPPjFnzpyNLjN69OgoKSnJXRYsWLA1TwkAANQxWxUty5cvj7lz58buu+++0WWKioqiefPmlS4AAACbq0bRMmrUqHj++edj/vz58dJLL8Wpp54a9evXj8GDB9fWfAAAQB1Xo2NaPvrooxg8eHAsXrw42rRpE8cee2y88sor0aZNm9qaDwAAqONqFC2TJ0+urTkAAACqtVXHtAAAANQ20QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkLQG+R6Ar5dlWZSuWZfvMXY6K1evrfbvbDvFDetHQUFBvscAAHZwoiVxWZbF6b99OWZ++GW+R9mp9fjVc/keYafUo+MuMfUnRwsXAGCr2D0scaVr1gkWdlivf/ilrYQAwFazpWUH8vo/9I3GhfXzPQZ8rZWr10WPXz2b7zEAgJ2EaNmBNC6sH40L/ZMBAFC32D0MAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACStlXR8pvf/CYKCgpi5MiR22gcAACAyrY4Wl577bW466674uCDD96W8wAAAFSyRdGyfPnyGDJkSNxzzz2xyy67bOuZAAAAcrYoWkaMGBH9+/ePvn37but5AAAAKmlQ0wdMnjw5Zs2aFa+99tpmLV9WVhZlZWW560uXLq3pUwIAAHVYjba0LFiwIC699NKYOHFiNGrUaLMeM3bs2GjRokXu0qFDhy0aFAAAqJtqFC0zZ86MRYsWxTe/+c1o0KBBNGjQIJ5//vm47bbbokGDBrFu3boqjxk9enSUlJTkLgsWLNhmwwMAADu/Gu0e9u1vfzvefvvtSrcNGzYs9ttvv/h//+//Rf369as8pqioKIqKirZuSgAAoM6qUbQ0a9YsunXrVum2Jk2aROvWravcDgAAsC1s1S+XBAAAqG01PnvYhmbMmLENxgAAAKieLS0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJq1G0jB8/Pg4++OBo3rx5NG/ePI4++uiYNm1abc0GAABQs2hp3759/OY3v4mZM2fG66+/Hscff3x873vfi3fffbe25gMAAOq4BjVZ+OSTT650/R//8R9j/Pjx8corr8SBBx64TQcDAACIqGG0rG/dunUxderUWLFiRRx99NHbciYAAICcGkfL22+/HUcffXSsWrUqmjZtGo8++mgccMABG12+rKwsysrKcteXLl26ZZMCAAB1Uo3PHrbvvvvGm2++GX/+85/jwgsvjHPOOSf+8pe/bHT5sWPHRosWLXKXDh06bNXAAABA3VLjaCksLIyuXbvGYYcdFmPHjo3u3bvHuHHjNrr86NGjo6SkJHdZsGDBVg0MAADULVt8TEuF8vLySrt/baioqCiKioq29mkAAIA6qkbRMnr06OjXr1/sueeesWzZspg0aVLMmDEjnn766dqaDwAAqONqFC2LFi2KoUOHxieffBItWrSIgw8+OJ5++un4zne+U1vzAQAAdVyNouXee++trTkAAACqVeMD8QEAALYn0QIAACRtq88eBtRMlmVRurY032PUqpVr1q3399KIgvp5nGb7KG5QHAUFBfkeAwB2SqIFtqMsy2LotKHx5mdv5nuUWpWVN4yI6yMioveUXlFQb01+B9oODm17aDzw3QeECwDUAtEC21Hp2tKdPlgiIgrqrYlm+1+Z7zG2qzcWvRGla0ujccPG+R4FAHY6ogXyZMagGVHcoDjfY7CVSteWRu8pvfM9BgDs1EQL5Elxg2I/lQcA2AzOHgYAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASatRtIwdOzYOP/zwaNasWbRt2zYGDhwYH3zwQW3NBgAAULNoef7552PEiBHxyiuvxDPPPBNr1qyJE044IVasWFFb8wEAAHVcg5os/NRTT1W6PmHChGjbtm3MnDkzvvWtb23TwQAAACJqGC0bKikpiYiIVq1abXSZsrKyKCsry11funTp1jwlAABQx2zxgfjl5eUxcuTI6NmzZ3Tr1m2jy40dOzZatGiRu3To0GFLnxIAAKiDtjhaRowYEe+8805Mnjx5k8uNHj06SkpKcpcFCxZs6VMCAAB10BbtHnbxxRfHE088EX/605+iffv2m1y2qKgoioqKtmg4AACAGkVLlmVxySWXxKOPPhozZsyIzp0719ZcAAAAEVHDaBkxYkRMmjQp/uM//iOaNWsWn376aUREtGjRIoqLi2tlQAAAoG6r0TEt48ePj5KSkujdu3fsvvvuuctDDz1UW/MBAAB1XI13DwPIhyzLonRtab7HqGL9mVKcr7hBcRQUFOR7DADYKlv1e1oAtocsy2LotKHx5mdv5nuUTeo9pXe+R6ji0LaHxgPffUC4ALBD2+JTHgNsL6VrS5MPllS9seiNJLcAAUBN2NIC7FBmDJoRxQ2c+OPrlK4tTXLLDwBsCdEC7FCKGxRH44aN8z0GALAd2T0MAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACS1iDfAyQjyyLWrMz3FFWtXrfe31dGRP28jbJRDRtHFBTkewoAAHZSoiXiq2C578SIBX/O9yRVZUURcf9Xf7+pa0RBWV7HqVaHoyLOe0q4AABQK0RLxFdbWFIMlohoXFAW8xudle8xNm3BK1+9h4VN8j0JAAA7IdGyoVFzIgob53uKHcPqlRH/1DXfUwAAsJMTLRsqbGyLAQAAJMTZwwAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABIWoN8DwAAsL4syyIrLc33GDud8tXr/u/vK0ujfG39PE6zcyooLo6CgoJ8j7FTEi0AQDKyLIsPzxoSpW+8ke9Rdjqr6hdGnPzriIiY3fPYaLRudZ4n2vkUf/Ob0XHig8KlFogWACAZWWmpYKkljdatjml/GJXvMXZqpbNmRVZaGgWNG+d7lJ2OaAEAkrT3iy9EveLifI8BX6u8tDRm9zw232Ps1EQLAJCkesXFUc9PrIFw9jAAACBxNY6WP/3pT3HyySdHu3btoqCgIP7whz/UwlgAAABfqXG0rFixIrp37x533HFHbcwDAABQSY2PaenXr1/069evNmYBAACootYPxC8rK4uysrLc9aVLl9b2UwIAADuRWj8Qf+zYsdGiRYvcpUOHDrX9lAAAwE6k1qNl9OjRUVJSkrssWLCgtp8SAADYidT67mFFRUVRVFRU208DAADspPyeFgAAIGk13tKyfPnymDNnTu76vHnz4s0334xWrVrFnnvuuU2HAwAAqHG0vP7669GnT5/c9csuuywiIs4555yYMGHCNhsMAAAgYguipXfv3pFlWW3MAgAAUIVjWgAAgKTV+tnDAABgW8iyLLLS0nyPUUX5ejOVJzhfRERBcXEUFBTke4wtJloAAEhelmXx4VlDovSNN/I9yibN7nlsvkeoVvE3vxkdJz64w4aL3cMAAEheVlqafLCkrHTWrCS3Um0uW1oAANih7P3iC1GvuDjfY+wQyktLk936UxOiBQCAHUq94uKo17hxvsdgO7J7GAAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASWuQ7wEAgM2TZVlkpaX5HqNWla/3+sp38tcaEVFQXBwFBQX5HgOSJ1oAYAeQZVl8eNaQKH3jjXyPst3M7nlsvkeodcXf/GZ0nPigcIGvYfcwANgBZKWldSpY6orSWbN2+q1nsC3Y0gIAO5i9X3wh6hUX53sMtkJ5aWmd2JIE24poAYAdTL3i4qjXuHG+xwDYbuweBgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJc8pjAFhPlmVJ/rK/8vVmKk9wvoLiYr/VHag1ogUA/leWZfHhWUOS/83zKf5SwuJvfjM6TnxQuAC1wu5hAPC/stLS5IMlVaWzZiW5hQrYOdjSAgDV2PvFF6JecXG+x0heeWlpklt+gJ3LFkXLHXfcETfddFN8+umn0b1797j99tvjiCOO2NazAUDe1CsujnqNG+d7DABiC3YPe+ihh+Kyyy6La665JmbNmhXdu3ePE088MRYtWlQb8wEAAHVcjaPllltuieHDh8ewYcPigAMOiN/+9rfRuHHjuO+++2pjPgAAoI6r0e5hq1evjpkzZ8bo0aNzt9WrVy/69u0bL7/8crWPKSsri7Kystz1kpKSiIhYunTplsxbO1aviCjLvvr70qURhevyO8+OwvtWYyvXrIx1pV+9T0uXLo21DdfmeaIdg/et5rxnW6Z85cpYvu7/3rd6a71vX8d7tmW8bzXnPdsyqb9vFU2QZdmmF8xq4OOPP84iInvppZcq3X755ZdnRxxxRLWPueaaa7KIcHFxcXFxcXFxcXFxqfayYMGCTXZIrZ89bPTo0XHZZZflrpeXl8cXX3wRrVu3di53AACow7Isi2XLlkW7du02uVyNomXXXXeN+vXrx8KFCyvdvnDhwthtt92qfUxRUVEUFRVVuq1ly5Y1eVoAAGAn1aJFi69dpkYH4hcWFsZhhx0Wzz33XO628vLyeO655+Loo4+u+YQAAABfo8a7h1122WVxzjnnRI8ePeKII46IW2+9NVasWBHDhg2rjfkAAIA6rsbRcuaZZ8Znn30WV199dXz66adxyCGHxFNPPRXf+MY3amM+AACgjivIvvb8YgAAAPlT418uCQAAsD2JFgAAIGmiBQAASJpoAQAAkiZa/tedd94ZBQUFceSRR+Z7lORNmDAhCgoKKl3atm0bffr0iWnTpuV7vKTNnTs3LrjggujSpUs0atQomjdvHj179oxx48ZFaWlpvsdLSsXH2euvv17t/b17945u3bpt56l2PF/3PvJ/qvvcVnG58sor8z1e0nyc1cy8efPi4osvjn322ScaN24cjRs3jgMOOCBGjBgRb731Vr7HS86G/zcbNWoU7dq1ixNPPDFuu+22WLZsWb5HTNKmPqcVFBTEK6+8ku8Ra6TGpzzeWU2cODE6deoUr776asyZMye6du2a75GSd91110Xnzp0jy7JYuHBhTJgwIU466aR4/PHHY8CAAfkeLzlPPvlknHHGGVFUVBRDhw6Nbt26xerVq+OFF16Iyy+/PN599924++678z0m1HkVn9vWJ5DZVp544ok488wzo0GDBjFkyJDo3r171KtXL95///145JFHYvz48TFv3rzo2LFjvkdNTsX/zTVr1sSnn34aM2bMiJEjR8Ytt9wSjz32WBx88MH5HjFJ1X1Oi4gd7ntd0RJf/cTjpZdeikceeSQuuOCCmDhxYlxzzTX5Hit5/fr1ix49euSu/+hHP4pvfOMb8e///u+iZQPz5s2LH/zgB9GxY8eYPn167L777rn7RowYEXPmzIknn3wyjxMCFTb83Abbyty5c3NfC5577rlKXwsiIm644Ya48847o149O8JUZ8P/m6NHj47p06fHgAED4pRTTon33nsviouL8zhhmnaWz2n+V8RXW1l22WWX6N+/f5x++ukxceLEfI+0Q2rZsmUUFxdHgwZaeEM33nhjLF++PO69994qX6Qivvppx6WXXpqHyQDYXm688cZYsWJF3H///dV+LWjQoEH89Kc/jQ4dOuRhuh3T8ccfH1dddVV8+OGH8eCDD+Z7HGqRaImvouW0006LwsLCGDx4cMyePTtee+21fI+VvJKSkvj888/js88+i3fffTcuvPDCWL58eZx99tn5Hi05jz/+eHTp0iWOOeaYfI+yw6n4ONvwsmbNmnyPxk6quo852BaeeOKJ6Nq1q+Nnt7Ef/vCHERHxxz/+Mc+TpKm6z2mLFy/O91g1Vud/JD5z5sx4//334/bbb4+IiGOPPTbat28fEydOjMMPPzzP06Wtb9++la4XFRXFfffdF9/5znfyNFGali5dGh9//HF873vfy/coO6QNP87Wd+CBB27HSagrqvuYy7IsD5OwM1m6dGn8/e9/j4EDB1a5b8mSJbF27drc9SZNmtjNqQbat28fLVq0iLlz5+Z7lCRV9zmtqKgoVq1alYdptlydj5aJEyfGN77xjejTp09ERBQUFMSZZ54ZDz74YNx8881Rv379PE+YrjvuuCP22WefiIhYuHBhPPjgg3H++edHs2bN4rTTTsvzdOlYunRpREQ0a9Ysz5PsmNb/OFvfz3/+81i3bl0eJmJnt7GPOdgaFV8LmjZtWuW+3r17x//8z//krt90000xatSo7TbbzqBp06bOIrYR1X1O2xG/v63T0bJu3bqYPHly9OnTJ+bNm5e7/cgjj4ybb745nnvuuTjhhBPyOGHajjjiiEoHdg0ePDgOPfTQuPjii2PAgAFRWFiYx+nS0bx584gIn0y30IYfZxV22WUXu+1QKzb2MQdbo+IHV8uXL69y31133RXLli2LhQsX2sV6Cy1fvjzatm2b7zGStLN8TqvT0TJ9+vT45JNPYvLkyTF58uQq90+cOFG01EC9evWiT58+MW7cuJg9e7Zdd/5X8+bNo127dvHOO+/kexQA8qRFixax++67V/u1oOIYl/nz52/nqXYOH330UZSUlOxwp/ClZur0gfgTJ06Mtm3bxtSpU6tcBg8eHI8++qhf+FdDFfvkVveTpLpswIABMXfu3Hj55ZfzPQoAedK/f/+YM2dOvPrqq/keZafyu9/9LiIiTjzxxDxPQm2qs9FSWloajzzySAwYMCBOP/30KpeLL744li1bFo899li+R91hrFmzJv74xz9GYWFh7L///vkeJylXXHFFNGnSJM4///xYuHBhlfvnzp0b48aNy8NkAGwvV1xxRTRu3DjOO++8ar8WOOFDzU2fPj2uv/766Ny5cwwZMiTf41CL6uzuYY899lgsW7YsTjnllGrvP+qoo6JNmzYxceLEOPPMM7fzdDuGadOmxfvvvx8REYsWLYpJkybF7Nmz48orr8wdx8FX9tprr5g0aVKceeaZsf/++8fQoUOjW7dusXr16njppZdi6tSpce655+Z7TABq0d577x2TJk2KwYMHx7777htDhgyJ7t27R5ZlMW/evJg0aVLUq1cv2rdvn+9Rk1TxfcfatWtj4cKFMX369HjmmWeiY8eO8dhjj0WjRo3yPWKS1v9+bX3HHHNMdOnSJQ8TbZk6Gy0TJ06MRo0abfT0vPXq1Yv+/fvHxIkTY/HixdG6devtPGH6rr766tzfGzVqFPvtt1+MHz8+LrjggjxOla5TTjkl3nrrrbjpppviP/7jP2L8+PFRVFQUBx98cNx8880xfPjwfI8IsEUqthDsiGck2t6+973vxdtvvx0333xz/PGPf4z77rsvCgoKomPHjtG/f//4yU9+Et27d8/3mEmq+L6jsLAwWrVqFQcddFDceuutMWzYMGfo3IT1v19b3/33379DRUtBZlskALAVbrvttrj00ktjzpw5sddee+V7HGAnVGePaQEAto3XXnstmjRpEh07dsz3KMBOqs7uHgYAbJ3f//73MWPGjJg4cWKcf/750aCBbyuA2mH3MABgi3Tu3DmWLVsWp556atx6663RpEmTfI8E7KRECwAAkDTHtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJ+/9NVsdwRnDnBwAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 1000x1000 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "dendo = Dendrogram(coreset_df, hierarchial_clustering_sequence)\n",
+    "dendo.plot_dendrogram(plot_title=\"Dendrogram of Coreset using VQE\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Each branch point in the dendrogram aboves corresponds to one of the plots below. Notice the first iterations are the most complicated, and the final iterations become trivial bipartitioning of two points. Occasionally, especially in the first iteration, the partitioning might be puzzling at first glance. The data might seem to naturally cluster into two groups. However, there are cases where a stray point seems to belong in the wrong cluster.  There are two explanations for this.  1) The quantum sampling is approximate and stochastic. It is possible that too few shots were taken to sample the ground state of the problem. 2) It is important to remember that we are clustering coresets and not data points. There can be cases where it is optimal to pay a penalty by excluding a point based on proximity if the weights are small enough that the penalty has less impact. Usually, if a point looks unusually clustered and you go look at the original coresets plotted above, that point will have a small weight."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAABKUAAASmCAYAAAD/KRjlAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAEAAElEQVR4nOzdeVwV9f7H8fcAcsAFXNkUFbXct1wIbdEi0cwr1TX12nVJ7Wbq1Uub9CuXLM1WM00zt7pm2mplXdQw9Zq4R2qppbnLwRUQVEDO/P7geurEIhqcA4fX8/GYh57vfGfOZ0aZL/OZ7/c7hmmapgAAAAAAAAAn8nB1AAAAAAAAACh/SEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISqFY1a9fX4MHD3Z1GNdl0aJFMgxDhw4dcnUoxWbw4MGqX7++q8O4Jl26dFGXLl1cHQaAYkb7ULrQPgAoLWgfShfaBzgbSSkUyYEDB/SPf/xDDRo0kI+Pj/z8/NS5c2e98cYbunjxolNiuHDhgiZOnKi1a9c65ftKo40bN2rixIlKSUm5ru1Lyzn86aefNHHixFLXgNtsNr300ksKCwuTj4+PWrVqpQ8++MDVYQGlGu1D6UD7ULJeeOEF/eUvf1FgYKAMw9DEiRNdHRJQ6tE+lA60DyVn7969evLJJ9WmTRtVqVJFwcHB6tmzp7Zt2+bq0MoWE7iKFStWmL6+vmbVqlXNf/7zn+bcuXPNmTNnmv369TMrVKhgDh8+3F63Xr165qBBg0okjlOnTpmSzAkTJpTI/i9fvmxevHjRtNlsJbL/4vDyyy+bksyDBw8WqX5WVpZ56dIl++eSPodF9dFHH5mSzG+//TbPuszMTDMzM9P5QZmmOW7cOFOSOXz4cHPu3Llmz549TUnmBx984JJ4gNKO9qH0oH0oWZLMoKAgMyoqqlScJ6C0o30oPWgfSs5jjz1mVq1a1Rw6dKj59ttvmy+99JLZsGFD09PT01y9erXT4ymrvJyfBkNZcvDgQfXr10/16tXTmjVrFBwcbF83cuRI7d+/X1999ZULI/zzMjIyVKlSJXl6esrT09PV4RSrChUqOOV7rpzD4uDt7V0s+7lWx48f16uvvqqRI0dq5syZkqRhw4bp9ttv1xNPPKE+ffq43f8P4M+gfSjbaB+uzcGDB1W/fn2dPn1atWrVclkcQFlA+1C20T4UXf/+/TVx4kRVrlzZXvbQQw+padOmmjhxoiIjI10SV5nj6qwYSrdHHnnElGR+9913Rar/xycdEyZMMPP7b7Zw4cI8GfutW7ea3bp1M2vUqGH6+PiY9evXN4cMGWKapmkePHjQlJRn+X3Gfs+ePeb9999vVqtWzbRYLGa7du3Mzz//PN/vXbt2rTlixAizVq1aZtWqVQuMqV69embPnj3N//73v2aHDh1Mi8VihoWFme+++26eY/rhhx/M2267zfTx8TFr165tTp482VywYEGRnkz88MMP5qBBg8ywsDDTYrGYgYGB5pAhQ8zTp0/nOZd/XArb96BBg8x69eo57RweOnTIHDFihHnjjTeaPj4+ZvXq1c2//vWvDjFe2f6Py5WnHrfffrt5++23O3xncnKy+dBDD5kBAQGmxWIxW7VqZS5atMihzpXje/nll823337bbNCggent7W22b9/e3LJlS6Hn3zRNc9asWaYk88cff3QoX7JkiSnJ/O9//3vVfQDlCe0D7UN5aR9+r7T0GABKM9oH2ofy2D783n333WdWr179urcvb+gphUJ9+eWXatCggTp16lSi33Py5El169ZNtWrV0rhx41S1alUdOnRIn376qSSpVq1amj17tkaMGKF7771X9913nySpVatWkqQff/xRnTt3Vu3atTVu3DhVqlRJH374oaKjo/XJJ5/o3nvvdfi+Rx99VLVq1dL48eOVkZFRaGz79+/XX//6Vw0dOlSDBg3SggULNHjwYLVr107NmzeXlNvLpmvXrjIMQ7GxsapUqZLmzZsni8VSpONfvXq1fv31Vw0ZMkRBQUH68ccfNXfuXP3444/atGmTDMPQfffdp59//lkffPCBXn/9ddWsWdN+borCGedw69at2rhxo/r166c6dero0KFDmj17trp06aKffvpJFStW1G233aZ//vOfmjFjhp5++mk1bdpUkux//tHFixfVpUsX7d+/X6NGjVJYWJg++ugjDR48WCkpKRozZoxD/SVLluj8+fP6xz/+IcMw9NJLL+m+++7Tr7/+WuiTn++//16VKlXKE0fHjh3t62+55ZYinWugPKB9oH0oL+0DgGtD+0D7UN7bB6vVaj/XKAJXZ8VQeqWmppqSzN69exd5m+t90vHZZ5+ZksytW7cWuO/Cnk7eeeedZsuWLR3GP9tsNrNTp07mDTfckOd7b7nlFvPy5cuFxnTleCSZ69evt5edPHnStFgs5mOPPWYvGz16tGkYhvn999/by86cOWNWr169SE86Lly4kKfsgw8+yPPd1zom/PdPOkyz5M9hfseRkJBgSjLfe+89e1lhY8L/+KRj+vTppiRz8eLF9rKsrCwzIiLCrFy5spmWlmaa5m9POmrUqGGePXvWXvfzzz83JZlffvll3hP0Oz179jQbNGiQpzwjI8OUZI4bN67Q7YHyhPaB9qE8tQ+/R08poHC0D7QP5bV9uGL9+vWmYRjms88+e83blle8fQ8FSktLkyRVqVKlxL+ratWqkqQVK1YoOzv7mrY9e/as1qxZowceeEDnz5/X6dOndfr0aZ05c0ZRUVH65ZdfdPz4cYdthg8fXuTx382aNdOtt95q/1yrVi01btxYv/76q70sLi5OERERatOmjb2sevXqGjBgQJG+w9fX1/73S5cu6fTp07r55pslSTt27CjSPv6M4jqHvz+O7OxsnTlzRo0aNVLVqlWv+zi+/vprBQUFqX///vayChUq6J///KfS09O1bt06h/p9+/ZVtWrV7J+v/Nv9/t8rPxcvXsz3yZSPj499PYBctA+5aB/KR/sAoOhoH3LRPpTP9uHkyZP629/+prCwMD355JPXFXt5RFIKBfLz85MknT9/vsS/6/bbb9f999+vSZMmqWbNmurdu7cWLlyozMzMq267f/9+maapZ599VrVq1XJYJkyYICn3AvF7YWFhRY6tbt26ecqqVaumc+fO2T8fPnxYjRo1ylMvv7L8nD17VmPGjFFgYKB8fX1Vq1Yte4ypqalFjvV6Fdc5vHjxosaPH6/Q0FBZLBbVrFlTtWrVUkpKynUfx+HDh3XDDTfIw8PxcnWlu+7hw4cdyv/473Wlgfn9v1d+fH198/3/dunSJft6ALloH3LRPpSP9gFA0dE+5KJ9KH/tQ0ZGhu655x6dP39en3/+ucPk5ygcc0qhQH5+fgoJCdHu3buvex+GYeRbnpOTk6fexx9/rE2bNunLL7/UypUr9dBDD+nVV1/Vpk2bCv2httlskqTHH39cUVFR+db548X9WhIMBT0RMU2zyPu4mgceeEAbN27UE088oTZt2qhy5cqy2Wzq3r27/fhKUnGdw9GjR2vhwoUaO3asIiIi5O/vL8Mw1K9fP6cch3T9/17BwcH69ttvZZqmw//bpKQkSVJISEjxBQmUcbQPuWgfcrl7+wCg6GgfctE+5Cov7UNWVpbuu+8+7dy5UytXrlSLFi2KMzy3R1IKhbrnnns0d+5cJSQkKCIi4pq3v5JlTklJsXexlfJmp6+4+eabdfPNN+uFF17QkiVLNGDAAC1dulTDhg0rsIFq0KCBpNwuma567Wa9evW0f//+POX5lf3RuXPnFB8fr0mTJmn8+PH28l9++SVP3YLOQVGV9Dn8+OOPNWjQIL366qv2skuXLiklJaVIceSnXr162rlzp2w2m8PTjr1799rXF4c2bdpo3rx52rNnj5o1a2Yv37x5s309gN/QPhQN7UOustw+ALg2tA9FQ/uQq6y3DzabTQMHDlR8fLw+/PBD3X777cW27/KC4Xso1JNPPqlKlSpp2LBhSk5OzrP+wIEDeuONNwrcvmHDhpKk9evX28syMjL07rvvOtQ7d+5cnkz0lSTAlS64FStWlKQ8F6iAgAB16dJFb7/9tr1Xy++dOnWqwPiKS1RUlBISEpSYmGgvO3v2rN5///2rbnslM//H458+fXqeupUqVZKU9xwUVUmfQ09PzzzH8eabb+Z5snUtx3H33XfLarVq2bJl9rLLly/rzTffVOXKlYvtwt+7d29VqFBBb731lr3MNE3NmTNHtWvXLvE3yABlDe1D0dA+5CrL7QOAa0P7UDS0D7nKevswevRoLVu2TG+99Zb97YS4NvSUQqEaNmyoJUuWqG/fvmratKkGDhyoFi1aKCsrSxs3brS/WrMg3bp1U926dTV06FA98cQT8vT01IIFC1SrVi0dOXLEXu/dd9/VW2+9pXvvvVcNGzbU+fPn9c4778jPz0933323pNzuns2aNdOyZct04403qnr16mrRooVatGihWbNm6ZZbblHLli01fPhwNWjQQMnJyUpISNCxY8f0ww8/lOh5evLJJ7V48WLdddddGj16tP2VrnXr1tXZs2cLzez7+fnptttu00svvaTs7GzVrl1bq1at0sGDB/PUbdeunSTp//7v/9SvXz9VqFBBvXr1sl+kr6akz+E999yjf//73/L391ezZs2UkJCgb775RjVq1HCo16ZNG3l6emratGlKTU2VxWLRHXfc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vSw8PFyLFi1SXFycZs+erYMHD+rWW2/V+fPn891HZmam0tLSHJayzrzwkSTPAtdnZplKOrhIVqvVvpw+fdp5AQIoM9wqKTV79my1atVKfn5+9okJ//Of/xS6zUcffaQmTZrIx8dHLVu21Ndff+2kaIHSy3roZJ6yEzqk6gqQl1FBknT+XIYuZVySJN1///3atm2bdu7c6dQ4AXdgPXhSnhUcf7H/48+baTN16mjufB38vAGAcyxZskSTJk3Shx9+qICAAHt5jx491KdPH7Vq1UpRUVH6+uuvlZKSog8//DDf/UydOlX+/v72JTQ01FmHUHJyjkrKKXD1ym8vqHbL7xQcHGxfbrnlFufFB6DMcKukVJ06dfTiiy9q+/bt2rZtm+644w717t1bP/74Y771N27cqP79+2vo0KH6/vvvFR0drejoaO3evdvJkQOlS5VqlR3mtpGkNkZntTV++2XCy9tL3r7ekqSOHTvKNE21atXKqXEC7qBK9cqy5dgcyv7483alnsTPGwA4w9KlSzVs2DB9+OGHioyMLLRu1apVdeONN2r//v35ro+NjVVqaqp9OXr0aEmE7FweVVVQT6mFbwQpJ+kG5Vg7yDRN+7J3716nhgigbHCrpFSvXr10991364YbbtCNN96oF154QZUrV9amTZvyrf/GG2+oe/fueuKJJ9S0aVNNnjxZN910k2bOnOnkyIHSpWv/W5RzueCnXx5eHurar7M8PQvutg2gaG79682Frjc8DDXu0EhB9QMKrQcAKB4ffPCBhgwZog8++EA9e/a8av309HQdOHBAwcHB+a63WCz2kRxXlrLO8LlHhfWUkjwl32gnRQOgLHOrpNTv5eTkaOnSpcrIyFBERES+dRISEvI8+YiKilJCQkKh+3bHceHA7zXv1Fjto9rkmVdKkjw8PFTBu4L6PhXt/MCAfJTE0G3TNDV+/HgFBwfL19dXkZGR+uWXX0ok/poh1RU9uof+0DkxlyHJlB56oX+JfDcAuLv09HQlJiYqMTFRknTw4EElJibaJyaPjY3VwIED7fWXLFmigQMH6tVXX1V4eLh9PqTU1FR7nccff1zr1q3ToUOHtHHjRt17773y9PRU//7l6FptuV2q0Fr595bylIxKMioNdnJQAMoit0tK7dq1S5UrV5bFYtEjjzyizz77TM2aNcu3rtVqVWBgoENZYGCg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Zw4LANwKPaUAAG4lNTVVklS9evUib3PhwgVlZ2fn2Wbt2rUKCAhQ48aNNWLECJ05c6bAfWRmZiotLc1hAQCULRERERo4cKDatGmj22+/XZ9++qlq1aqlt99++7r3OXXqVPn7+9uX0NDQYowYAMo2klIAALdhs9k0duxYde7cWS1atCjydk899ZRCQkIchmN0795d7733nuLj4zVt2jStW7dOPXr0UE5OTr774KYDAEqXmjVrytPTU8nJyQ7lycnJRe4FW6FCBbVt21b79++XJPt217LP2NhYpaam2pejR49e66EAgNsiKQUAcBsjR47U7t27tXTp0iJv8+KLL2rp0qX67LPPHF773a9fP/3lL39Ry5YtFR0drRUrVmjr1q1au3ZtvvvhpgMAShdvb2+1a9dO8fHx9jKbzab4+HhFREQUaR85OTnatWuXgoODJUlhYWEKCgpy2GdaWpo2b95c4D4tFov8/PwcFgBALrdKSq1fv169evVSSEiIDMO46hsw1q5dm+fNSoZhFDgeHABQeo0aNUorVqzQt99+qzp16hRpm1deeUUvvviiVq1apVatWhVat0GDBqpZs6b9afkfcdMBAKVPTEyM3nnnHb377rvas2ePRowYoYyMDA0ZMkSSNHDgQMXGxtrrP/fcc1q1apV+/fVX7dixQw8++KAOHz6sYcOGScp9M9/YsWP1/PPP64svvtCuXbs0cOBAhYSEKDo62hWHCABlmltNdJ6RkaHWrVvroYce0n333Vfk7fbt2+dw8xAQEFAS4QEASoBpmho9erQ+++wzrV27VmFhYUXa7qWXXtILL7yglStXqn379letf+zYMZ05c8b+tBwAUPr17dtXp06d0vjx42W1WtWmTRvFxcXZJyo/cuSIPDx+e05/7tw5DR8+XFarVdWqVVO7du20ceNGNWvWzF7nySefVEZGhh5++GGlpKTolltuUVxcnENvWwBA0RimaZquDqIkGIahzz77rNAnFmvXrlXXrl117tw5Va1a9bq/Ky0tTf7+/kpNTeXJOIAyp6xfwx599FEtWbJEn3/+uRo3bmwv9/f3l6+vr6TcJ+G1a9fW1KlTJUnTpk3T+PHjtWTJEnXu3Nm+TeXKlVW5cmWlp6dr0qRJuv/++xUUFKQDBw7oySef1Pnz57Vr1y5ZLJarxlXWzysAcB0rGZxXAGVdcV7H3Gr4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iRO213/++afq16+fq19ebXk5fvy4RowYoZCQEJUvX15BQUG2GNPS0god69Uqrn14+vRpjRkzRuHh4bJarapataqCgoKUmpp61eP4888/1aBBA3l42B+uLp6u++eff9q1X/5+XUwwl75fBalVq5aioqLUr18/ffrpp6pbt66ioqIoTAGXID9cQH4oG/nhrbfe0tGjR21PnwKQP/LDBeSHspEf8hIYGKhBgwZp+/btOnDgQJGXL4u4pxTy5efnp7CwMG3ZsuWq12GxWPJsz87OztVv7ty5Wrt2rb755hstWbJEgwcP1htvvKG1a9eqUqVK+W7j4iNLn3jiCUVHR+fZ5/KDe1HuD5TfLyLGmEKv40ruvfderVmzRk8++aRatmypSpUqKScnR927d7d7JKujFNc+HD58uGbOnKmRI0cqIiJC/v7+slgs6tu3r1PGIRX/+3X33Xdr2rRpWrVqVb77BihryA8XkB8uKM35IS0tTS+++KIeffRRpaen284CycjIkDFGe/fuVYUKFRQcHOyQmAF3Q364gPxwQWnODwUJDw+XdKFwWKNGjauOq6ygKIUC3X777Zo6daoSExMVERFR5OUvVplTU1Ntp9hKuavTF91444268cYb9dJLLykhIUH9+/fX7Nmz9eCDD+aboOrWrSvpwimZUVFRRY6xONSqVUs7d+7M1Z5X2+VOnDihZcuWafz48RozZoytfceOHbn65rcPCsvR+3Du3LkaOHCg3njjDVvbmTNnlJqaWqg48lKrVi398ssvysnJsfu14/fff7fNd6SLZ0g54xcnwJ2QHwqH/HCBu+aHEydOKCMjQ6+99ppee+21XPPr1KmjO+64Q/Pnz7/mbQGlBfmhcMgPF7hrfijIxcv+CntD+bKOy/dQoKeeekoVK1bUgw8+qJSUlFzzd+3apbfffjvf5evVqydJWrVqla0tMzNTH330kV2/EydO5KpEX7y++uIpuBUqVJCkXAeo4OBgRUZG6oMPPtDhw4dzxfDXX3/lG19xiY6OVmJiopKSkmxtx48f16effnrFZS9W5i8f/8SJE3P1rVixoqTc+6CwHL0PPT09c43j3XffzfXLVlHGcdtttyk5OVmff/65re38+fN69913ValSJXXp0qVQsV1JfmOcPn26LBaLbrjhhmLZDlBakB8Kh/xwgbvmh+DgYM2bNy/X1LVrV/n4+GjevHkaPXr0NW8HKE3ID4VDfrjAXfODlPcYDx48qBkzZqh58+aqVq1asWyntONMKRSoXr16SkhIUJ8+fdS4cWMNGDBATZs21dmzZ7VmzRrbozXz061bN9WsWVNDhgzRk08+KU9PT82YMUNBQUHat2+frd9HH32k999/X71791a9evV08uRJTZs2TX5+frrtttskXTjds0mTJvr888913XXXKTAwUE2bNlXTpk01adIk3XTTTWrWrJmGDh2qunXrKiUlRYmJiTpw4IB+/vlnh+6np556Sp988oluvfVWDR8+3PZI15o1a+r48eMFVvb9/PzUuXNnvfbaazp37pyqV6+u7777Tnv27MnVt3Xr1pKkZ599Vn379lW5cuXUq1cv20H6Shy9D2+//Xb9+9//lr+/v5o0aaLExER9//33qlKlil2/li1bytPTU6+++qrS0tJktVp1880353n5w0MPPaQPPvhAsbGx2rRpk2rXrq25c+dq9erVmjhxYrHdSPOll17S6tWr1b17d9v79uWXX2rDhg0aPnx4oa/vB8oK8kPhkB8ucNf8UKFCBcXExORqnz9/vtavX5/nPKCsIz8UDvnhAnfND9KF93DXrl265ZZbFBYWpr179+qDDz5QZmZmgYVXXMaZj/qD+/rjjz/M0KFDTe3atY23t7fx9fU1HTt2NO+++67dI0Avf6SrMcZs2rTJtG/f3nh7e5uaNWuaN998M9fjU3/66SfTr18/U7NmTWO1Wk1wcLC5/fbbzcaNG+3WtWbNGtO6dWvj7e2d69Gku3btMgMGDDChoaGmXLlypnr16ub22283c+fOtfW5uN28Hh2b3yNde/bsmavv5Y8dNcaYzZs3m06dOhmr1Wpq1Khh4uPjzTvvvGMkmeTk5AL374EDB0zv3r1NQECA8ff3N/fcc485dOhQno9ffeGFF0z16tWNh4fHFR/vevkjXY1x7D48ceKEGTRokKlataqpVKmSiY6ONr///nue/y6mTZtm6tatazw9Pe0e75rXvk1JSbGt19vb2zRr1szMnDnTrs/FR7q+/vrrueLKaz9e7rvvvjO33367CQsLM+XKlbP9G585c6bJyckpcFmgLCM/2CM/lL78kJeBAweaihUrFnk5oCwhP9gjP5S+/JCQkGA6d+5sgoKCjJeXl6latarp3bu32bRpU4HLwZ7FmGK82xoA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tmypjz/+WLfccou2bNmiBg0aODzu4nK17/0//vEPdejQQXfccYejQ3Soqx3/pY4ePaoXXnhBDz30kCNCLDZHjx5VdnZ2nt+7fv/99zyXKZbvaUU/oQslwb59+0xwcLD5+eefbW1XuhSuQYMGJjw83Jw/f97W9sYbb5jQ0FBHhmpzNTH/8MMPJiQkxEybNs388ssv5quvvjLh4eHmX//6lxMitnfixAnj5+dnPvzwwzznlytXziQkJNi1TZo0yQQHBzsjvDxdKeZLxcfHm8qVK9u9P85WULzp6emmdu3aZtGiRbY2V18ecqX96+rP3OWuFG9J+rzhgnLlypmIiAi7tuHDh5sbb7wx32W2bt1qqlWrZl577TXz888/m8WLF5tmzZqZwYMHOzrcIuvWrZu5/fbbC+xTEo+tBSnMmC5VEo69V3KlMZXE4/OVFOZ9KmnH8CspzJg4zuNy//znP42kAqfffvvNvPTSS+a6667LtXxQUJB5//33813/sGHDTLt27cz3339vkpKSzLhx44y/v7/55ZdfHDmsQnHk2FevXm0kmdGjR9u1N2vWzDz99NMOGU9ROXL8CxYsMPXr1zcnT560tamEXb7n6H/7F6WlpZl27dqZ7t27l/jLwQ8ePGgkmTVr1ti1P/nkk6Zdu3Z5LlMc39M4U8pNbdq0SUeOHNENN9xga8vOztaqVav03nvvKSsrS56ennbLVKtWTeXKlbNrb9y4sZKTk3X27Fl5e3uXuJiff/55PfDAA3rwwQclSc2aNVNmZqYeeughPfvss069UWBAQICuu+467dy5M8/5oaGhSklJsWtLSUlx6emqV4r5ogkTJuiVV17R999/f8WbzztSQfHu2rVLe/fuVa9evWxtOTk5ki78WrF9+3bVq1fPabFKV96/rv7MXe5K8ZakzxsuqFatmpo0aWLX1rhx4wKfXBQfH6+OHTvqySeflCQ1b95cFStWVKdOnfTiiy+qWrVqDo25sP788099//33V7z5ekk8tuansGO6qKQcewtSmDGVxONzQQr7PpW0Y3hBCjsmjvO43OOPP37FMzvr1q2r0NBQHTlyxK79/PnzOn78eL7H4127dum9997Tli1bdP3110uSWrRoof/7v//TpEmTNGXKlGIZw9Vy5Ngv5tq8cnhRbq3hSI4c//Lly7Vr165cD4a466671KlTJ61YseIa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/LKzQgZchvzg3sgPRVPY/PC3v/1Nqamp8vX11YQJE5SUlOS8IN2Rq6tiKNkefvhhI8msXr26UP0v//Vj7NixJq9/ZjNnzsxVMd6wYYPp1q2bqVKlivHx8TG1a9c2gwYNMsYYs2fPHiMp13Rpdfq3334zd911l6lcubKxWq2mdevWZsGCBXlud8WKFeaRRx4xQUFBJiAgIN+YatWqZXr27Gn+7//+z7Rt29ZYrVZTp04d89FHH+Ua088//2w6d+5sfHx8TPXq1c0LL7xgZsyYUajK+M8//2wGDhxo6tSpY6xWqwkJCTGDBg2y+6X14r68fCpo3QMHDjS1atVy2j7cu3eveeSRR8x1111nfHx8TGBgoLn77rvtYry4/OXTxV9CunTpYrp06WK3zZSUFDN48GATHBxsrFarad68uZk1a5Zdn4vje/31180HH3xg6tata7y9vU2bNm3M+vXrC9z/xhjzn//8x0gyixYtMsYYk5mZac6fP3/F5YCygFxALigrueBSVzpjoG3btqZt27a52rt162bq1atXpG0B7or8QH4gPxSsqGevlUWcKYUCffPNN6pbt646dOjg0O0cOXJE3bp1U1BQkJ5++mkFBARo7969+uqrryRJQUFBmjx5sh555BH17t1bd955pySpefPmkqStW7eqY8eOql69up5++mlVrFhRX3zxhWJiYvTll1+qd+/edtt79NFHFRQUpDFjxigzM7PA2Hbu3Km7775bQ4YM0cCBAzVjxgzFxsaqdevWuv766yVduKdE165dZbFYNHr0aFWsWFEffvihrFZroca/dOlS7d69W4MGDVJoaKi2bt2qqVOnauvWrVq7dq0sFovuvPNO/fHHH/rss8/01ltvqWrVqrZ9UxjO2IcbNmzQmjVr1LdvX9WoUUN79+7V5MmTFRkZqW3btqlChQrq3LmzHnvsMb3zzjt65pln1LhxY0my/fdyp0+fVmRkpHbu3Klhw4apTp06mjNnjmJjY5WamqoRI0bY9U9ISNDJkyf197//XRaLRa+99pruvPNO7d69u8Bfg77//ntJktVqVZs2bbRp0yZ5e3urd+/eev/99xUYGFio/QyURuQCckFZyQWFlZOTo19++UWDBw/ONa9du3b67rvvdPLkSfn6+l7ztoCSjPxAfiA/4Jq5uiqGkistLc1IMnfccUehl7naXz/mzZtnJJkNGzbku+6CKtK33HKLadasmd010Tk5OaZDhw6mQYMGubZ700035ToLJr9fPySZVatW2dqOHDlirFarefzxx21tw4cPNxaLxWzevNnWduzYMRMYGFioyvipU6dytX322We5tl3USvulv34Y4/h9mNc4EhMTjSTz8ccf29oKuk788l8/Jk6caCSZTz75xNZ29uxZExERYSpVqmTS09ONMf/79aNKlSrm+PHjtr4LFiwwksw333yTewdd4m9/+5tt+f79+5u5c+ea559/3nh5eZkOHTqU6PsHAI5ELiAXlKVccKmC9tPFef/6179yzZs0aZKRZH7//fdCbwtwR+QH8gP5YewV+3Km1JXx9D3kKz09XZKc8itfQECAJGnhwoU6d+5ckZY9fvy4li9frnvvvVcnT57U0aNHdfToUR07dkzR0dHasWOHDh48aLfM0KFDC31NeJMmTdSpUyfb66CgIDVs2NDu6TqLFy9WRESEWrZsaWsLDAxU//79C7WNS+9fdObMGR09elQ33nijJOmnn34q1DquRXHtw0vHce7cOR07dkz169dXQEDAVY9j0aJFCg0NVb9+/Wxt5cqV02OPPaaMjAytXLnSrn+fPn1UuXJl2+uL792VnoaUkZEhSWrbtq0++eQT3XXXXfrXv/6lF154QWvWrNGyZcuuKn7A3ZELLiAXlI1cUFgXnyaW11kOPj4+dn2A0or8cAH5gfyAa0NRCvny8/OTJJ08edLh2+rSpYvuuusujR8/XlWrVtUdd9yhmTNnKisr64rL7ty5U8YYPf/88woKCrKbxo4dK+nCKb+XqlOnTqFjq1mzZq62ypUr68SJE7bXf/75p+rXr5+rX15teTl+/LhGjBihkJAQlS9fXkFBQbYY09LSCh3r1SqufXj69GmNGTNG4eHhslqtqlq1qoKCgpSamnrV4/jzzz/VoEEDeXjYH64unsL7559/2rVf/n5dTDqXvl95uZgkL01oknTfffdJuvCIXaAsIhdcQC4oG7mgsC7mjLz+bZ45c8auD1BakR8uID+QH3BtuKcU8uXn56ewsDBt2bLlqtdhsVjybM/Ozs7Vb+7cuVq7dq2++eYbLVmyRIMHD9Ybb7yhtWvXqlKlSvluIycnR5L0xBNPKDo6Os8+lx/wi/JFMb9fSYwxhV7Hldx7771as2aNnnzySbVs2VKVKlVSTk6OunfvbhufIxXXPhw+fLhmzpypkSNHKiIiQv7+/rJYLOrbt69TxiFd/fsVFhYmSQoJCbFrDw4OlkSiQtlFLriAXHBBac8FhRUYGCir1arDhw/nmnex7WJeAUor8sMF5IcLyA+4WhSlUKDbb79dU6dOVWJioiIiIoq8/MXKc2pqqu20Wyl3xfqiG2+8UTfeeKNeeuklJSQkqH///po9e7YefPDBfJNW3bp1JV04TTMqKqrIMRaHWrVqaefOnbna82q73IkTJ7Rs2TKNHz9eY8aMsbXv2LEjV9/89kFhOXofzp07VwMHDtQbb7xhaztz5oxSU1MLFUdeatWqpV9++UU5OTl2v4D8/vvvtvnFoXXr1po2bVquU48PHTokqfA3iQRKI3JB4ZALLnDnXFBYHh4eatasmTZu3Jhr3rp161S3bl1uco4ygfxQOOSHC8pCfkDRcfkeCvTUU0+pYsWKevDBB5WSkpJr/q5du/T222/nu3y9evUkSatWrbK1ZWZm6qOPPrLrd+LEiVzV6YvXXF88LbdChQqSlOugFRwcrMjISH3wwQd5/mL5119/5RtfcYmOjlZiYqKSkpJsbcePH9enn356xWUvVusvH//EiRNz9a1YsaKk3PugsBy9Dz09PXON49133831a1dRxnHbbbcpOTlZn3/+ua3t/Pnzevfdd1WpUiV16dKlULFdyR133CGr1aqZM2fa/VLz4YcfSpJuvfXWYtkO4I7IBYVDLrjAnXNBUdx9993asGGDXWFq+/btWr58ue655x6nxwO4AvmhcMgPF5SV/ICi4UwpFKhevXpKSEhQnz591LhxYw0YMEBNmzbV2bNntWbNGtvjNvPTrVs31axZU0OGDNGTTz4pT09PzZgxQ0FBQdq3b5+t30cffaT3339fvXv3Vr169XTy5ElNmzZNfn5+uu222yRdOAW0SZMm+vzzz3XdddcpMDBQTZs2VdOmTTVp0iTddNNNatasmYYOHaq6desqJSVFiYmJOnDggH7++WeH7qennnpKn3zyiW699VYNHz7c9pjXmjVr6vjx4wVW+/38/NS5c2e99tprOnfunKpXr67vvvtOe/bsydW3devWkqRnn31Wffv2Vbly5dSrVy/bgftKHL0Pb7/9dv373/+Wv7+/mjRposTERH3//feqUqWKXb+WLVvK09NTr776qtLS0mS1WnXzzTfbLpW71EMPPaQPPvhAsbGx2rRpk2rXrq25c+dq9erVmjhxYrH9Eh0aGqpnn31WY8aMUffu3RUTE6Off/5Z06ZNU79+/dS2bdti2Q7gjsgFhUMuuMCdc4Ek/fvf/9aff/6pU6dOSbrwx/KLL74oSXrggQdsv7o/+uijmjZtmnr27KknnnhC5cqV05tvvqmQkBA9/vjjxRYPUJKRHwqH/HBBWckPaWlpevfddyVJq1evliS99957CggIUEBAgIYNG1ZsMZUKTn3WH9zWH3/8YYYOHWpq165tvL29ja+vr+nYsaN599137R4LevljXo0xZtOmTaZ9+/bG29vb1KxZ07z55pu5Hqn6008/mX79+pmaNWsaq9VqgoODze233242btxot641a9aY1q1bG29v71yP4dy1a5cZMGCACQ0NNeXKlTPVq1c3t99+u5k7d66tz8Xt5vU42fwe89qzZ89cfS9/FKkxxmzevNl06tTJWK1WU6NGDRMfH2/eeecdI8kkJycXuH8PHDhgevfubQICAoy/v7+55557zKFDh/J81OgLL7xgqlevbjw8PK74eNHLH/NqjGP34YkTJ8ygQYNM1apVTaVKlUx0dLT5/fff8/x3MW3aNFO3bl3j6elp98jXvPZtSkqKbb3e3t6mWbNmZubMmXZ9Lj7m9fXXX88VV177MS85OTnm3XffNdddd50pV66cCQ8PN88995w5e/bsFZcFygJygT1yQenMBV26dDGS8pwufzz5/v37zd133238/PxMpUqVzO2332527NhxxW0ApQ35wR75oWznh4vbymu6fH/DGIsx3NELcJSRI0fqgw8+UEZGRqEfKwsAKF3IBQCAvJAfAO4pBRSb06dP270+duyY/v3vf+umm24iyQBAGUEuAADkhfwA5I17SgHFJCIiQpGRkWrcuLFSUlI0ffp0paen6/nnn3d1aAAAJyEXAADyQn4A8kZRCigmt912m+bOnaupU6fKYrHohhtu0PTp09W5c2dXhwYAcBJyAQAgL+QHIG/cUwoAAAAAAABOxz2lAAAAAAAA4HQUpQAAAAAAAOB03FOqGOTk5OjQoUPy9fWVxWJxdTgAUCTGGJ08eVJhYWHy8OC3iuJCbgDg7sgPjkF+AODuijM/UJQqBocOHVJ4eLirwwCAa7J//37VqFHD1WGUGuQGAKUF+aF4kR8AlBbFkR8o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L72kO++8U71791ZAgOsQe/bsadIEAQCtD8cbAGgZ2J8DAOrTqKKUJH311Vd666231LFjR91xxx01DioAADSFpjzebN++XfPnz1dBQYGKioq0YcMGjRo1qt4+DodDc+fO1WuvvSabzabOnTsrIyND99577yXnAQCtEX8/AADq0qgjwrJlyzRjxgwlJCRo//79CgsLc1deAIBWrKmPN+Xl5YqOjta9996rO++8s0F9fvWrX6m4uFjLly9Xjx49VFRUpOrq6svKAwBaG/5+AADUp8FFqaSkJOXn5+ull15ScnKyO3Oq15IlSzR//nzZbDZFR0dr8eLFGjRoUK2xy5Yt06uvvqp9+/ZJkmJjY/XMM8+4xE+YMEGrV6926ZeYmKjs7Gz3TQIAUCd3HG+GDx+u4cOHNzg+OztbH3zwgb788kuFhoZKkrp27dokuQBAa9Fc/n4AADRfDS5KVVVV6dNPP9VPfvITd+ZTr9dff11paWnKyspSXFycXnzxRSUmJurQoUMKDw+vEb9t2zbdfffduvHGGxUUFKTnnntOw4YN0/79+3XVVVc545KSkrRy5Urna7PZ7JH5AABqag7Hm02bNmngwIF6/vnn9f/+3//TFVdcof/6r//SvHnz1LZt21r7OBwOORwO52u73e6pdAGgWWoO+3MAQPPW4KJUTk6OO/NokIULFyolJUUTJ06UJGVlZelvf/ubVqxYoVmzZtWIX7NmjcvrP/3pT/rLX/6i3Nxcl29rzGazrFare5MHADRIczjefPnll/rwww8VFBSkDRs26PTp03rggQd05swZly8xfigzM1NPPvmkhzMFgOarOezPAQDNm5+3E2ioCxcuqKCgQAkJCc42Pz8/JSQkKC8vr0FjnD9/XhUVFc5LMb63bds2hYeHq2fPnrr//vt15syZesdxOByy2+0uCwCg5aiurpbJZNKaNWs0aNAgjRgxQgsXLtTq1av173//u9Y+6enpKi0tdS7Hjx/3cNYAAACAb/GZotTp06dVVVWliIgIl/aIiAjZbLYGjTFz5kxFRka6FLaSkpL06quvKjc3V88995w++OADDR8+XFVVVXWOk5mZqeDgYOcSFRV1aZMCADRLnTt31lVXXaXg4GBnW+/evWUYhr7++uta+5jNZlksFpcFAAAAQN1azfNYn332Wa1bt07btm1TUFCQs33s2LHOf/fr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",
+      "text/plain": [
+       "<Figure size 1200x1200 with 9 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "Dendrogram.plot_hierarchial_split(hierarchial_clustering_sequence, coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The hierarchical clustering can be converted to flat clustering by drawing a line perpendicular to the branches. Any data point that intersects the line is considered to be in the same cluster. The function below performs this task at threshold height of 1.5. If you want to use the number of clusters instead of height, you can use `dendo.get_clusters_using_k()` method. You pass the number of desired clusters as an argument. The figure below shows the clusters that are formed at threshold height of 1.5."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAy0AAANICAYAAADKKQDvAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA+1UlEQVR4nO3deZhcZYH3729n6c5CFgKJGAghgIDsDrsRA4hg2AQFFFE2QQaQETH4En1ZAjpRdHhBBEQGiCNk2JQZwAFEERyBsA6joALhl2hETFg7G1lIzu+PtjvpdCekk3TqSXLf13UuuqqeOvV0pbroT5+l6qqqqgIAAFCoLrWeAAAAwLKIFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRZgnbDZZpvlhBNOqPU01mj33ntvdt555/To0SN1dXV56623aj2ldVZdXV0uvPDCWk8DYLURLcAqMW7cuNTV1bUsPXr0yODBg3PggQfme9/7XmbMmFHrKbISXn/99Rx99NHp2bNnrrzyyvz4xz9O7969l3mfl156Kaeeemo233zz9OjRI3379s3w4cNz+eWX5+23315NM+8cs2fPzoUXXpgHH3yw1lNZbS699NLU1dXlF7/4xVLHXHvttamrq8udd97Zcl1VVfnxj3+cD3/4w+nfv3969eqVHXbYId/4xjcye/bsNuvYZ599Wr2XLL5ss802nfK9AeXrVusJAGuXiy66KMOGDcv8+fPzt7/9LQ8++GDOOuusXHrppbnzzjuz44471nqKrIAnnngiM2bMyMUXX5z999//Xcf/7Gc/y1FHHZWGhoYcd9xx2X777TNv3rz85je/yTnnnJPnnnsuP/zhD1fDzDvH7NmzM2bMmCRNv2Svbm+//Xa6dVu9/wv/9Kc/nXPOOSfjx49f6mtg/Pjx2WCDDTJy5MgkyYIFC/KZz3wmt956a/bee+9ceOGF6dWrV/77v/87F1xwQW699db84he/yKBBg1qtZ5NNNsnYsWPbrL9fv36r/hsD1giiBVilRo4cmV133bXl8ujRo/PAAw/kkEMOyWGHHZY//OEP6dmzZw1nuHSzZs16160Hq8qcOXNSX1+fLl3WjA3e06ZNS5L079//XcdOmjQpn/70pzN06NA88MADee9739ty2xlnnJGJEyfmZz/72UrPqaqqzJkzp9jXU2fq0aPHan/MwYMHZ999981Pf/rTXH311WloaGh1+8svv5xf//rX+cIXvpDu3bsnSS655JLceuutGTVqVL7zne+0jP3CF76Qo48+OocffnhOPPHENq+Hfv365bOf/Wznf1PAGmPN+L8lsEbbb7/9ct555+VPf/pTbrzxxla3/fGPf8yRRx6ZAQMGpEePHtl1111b7VqSLNr17OGHH87ZZ5+dgQMHpnfv3jniiCPy6quvthpbVVW+8Y1vZJNNNkmvXr2y77775rnnnmszp+Z1PvTQQzn99NMzaNCgbLLJJi23X3XVVdluu+3S0NCQwYMH54wzzmj3GI4rr7wym2++eXr27Jndd989//3f/5199tmn1V/fH3zwwdTV1eXmm2/O//2//zcbb7xxevXqlenTp+eNN97IqFGjssMOO2S99dZL3759M3LkyPzv//5vq8dpXsett96aMWPGZOONN06fPn1y5JFHprGxMXPnzs1ZZ52VQYMGZb311suJJ56YuXPnLte/z2233ZZddtklPXv2zIYbbpjPfvazefnll1tu32effXL88ccnSXbbbbfU1dUt8/igSy65JDNnzsx1113XKliabbnllvnSl77Ucvmdd97JxRdfnC222CINDQ3ZbLPN8rWvfa3N/DfbbLMccsghue+++7LrrrumZ8+eueaaa5Ikb731Vs4666wMGTIkDQ0N2XLLLfPtb387CxcubLWOm2++Obvsskv69OmTvn37Zocddsjll1/easy7rWvy5MkZOHBgkmTMmDEtuy4t6xiTCy+8MHV1dW2ub34dTp48ueW6J598MgceeGA23HDD9OzZM8OGDctJJ53U6n5LPl7z+idOnJgTTjgh/fv3T79+/XLiiSe22QXr7bffzj/90z9lww03TJ8+fXLYYYfl5ZdfXq7jZD772c+msbGx3ei8+eabs3Dhwhx77LEtj/Od73wnW221VbtbTQ499NAcf/zx+a//+q88/vjjy3xcAFtagNXic5/7XL72ta/l5z//eU455ZQkyXPPPZfhw4dn4403zrnnnpvevXvn1ltvzeGHH56f/OQnOeKII1qt48wzz8z666+fCy64IJMnT85ll12WL37xi7nllltaxpx//vn5xje+kYMOOigHHXRQnn766RxwwAGZN29eu/M6/fTTM3DgwJx//vmZNWtWkqZfAMeMGZP9998/p512Wp5//vlcffXVeeKJJ/Lwww+3/BX56quvzhe/+MXsvffe+fKXv5zJkyfn8MMPz/rrr98qgJpdfPHFqa+vz6hRozJ37tzU19fn97//ff7jP/4jRx11VIYNG5apU6fmmmuuyYgRI/L73/8+gwcPbrWOsWPHpmfPnjn33HMzceLEXHHFFenevXu6dOmSN998MxdeeGEmTJiQcePGZdiwYTn//POX+e8ybty4nHjiidltt90yduzYTJ06NZdffnkefvjh/M///E/69++fr3/969l6663zwx/+sGX3vy222GKp67zrrruy+eab54Mf/OAyH7vZySefnB/96Ec58sgj85WvfCWPPfZYxo4dmz/84Q+54447Wo19/vnnc8wxx+TUU0/NKaeckq233jqzZ8/OiBEj8vLLL+fUU0/NpptumkceeSSjR4/OK6+8kssuuyxJcv/99+eYY47JRz7ykXz7299OkvzhD3/Iww8/3BJRy7OugQMH5uqrr85pp52WI444Ip/4xCeSZJXs+jht2rQccMABGThwYM4999z0798/kydPzk9/+tPluv/RRx+dYcOGZezYsXn66afzr//6rxk0aFDL95skJ5xwQm699dZ87nOfy5577pmHHnooBx988HKt/xOf+EROO+20jB8/vuX7bjZ+/PgMHTo0w4cPT5L85je/yZtvvpkvfelLS92V7bjjjssNN9yQu+66K7vvvnvL9QsWLMhrr73WZnzPnj1X29ZQoDAVwCpwww03VEmqJ554Yqlj+vXrV33gAx9oufyRj3yk2mGHHao5c+a0XLdw4cLqgx/8YPW+972vzbr333//auHChS3Xf/nLX666du1avfXWW1VVVdW0adOq+vr66uCDD2417mtf+1qVpDr++OPbrPNDH/pQ9c4777Rc37yOAw44oFqwYEHL9d///verJNX1119fVVVVzZ07t9pggw2q3XbbrZo/f37LuHHjxlVJqhEjRrRc96tf/apKUm2++ebV7NmzWz0nc+bMafU4VVVVkyZNqhoaGqqLLrqozTq23377at68eS3XH3PMMVVdXV01cuTIVuvYa6+9qqFDh1bLMm/evGrQoEHV9ttvX7399tst1999991Vkur8889v83wt69+3qqqqsbGxSlJ9/OMfX+a4Zs8880yVpDr55JNbXT9q1KgqSfXAAw+0XDd06NAqSXXvvfe2GnvxxRdXvXv3rl544YVW15977rlV165dqz//+c9VVVXVl770papv376t/r2XtLzrevXVV6sk1QUXXLBc3+cFF1xQtfe/3ObnddKkSVVVVdUdd9yxXM/zko/dvP6TTjqp1bgjjjii2mCDDVouP/XUU1WS6qyzzmo17oQTTlju7+eoo46qevToUTU2NrZc98c//rFKUo0ePbrlussuu6xKUt1xxx1LXdcbb7xRJak+8YlPtFw3YsSIKkm7y6mnnvqu8wPWTnYPA1ab9dZbr+UsYm+88UYeeOCBHH300ZkxY0Zee+21vPbaa3n99ddz4IEH5sUXX2y1i1LStB/84rvY7L333lmwYEH+9Kc/JUl+8YtfZN68eTnzzDNbjTvrrLOWOqdTTjklXbt2bbncvI6zzjqr1fEmp5xySvr27duyW8yTTz6Z119/PaecckqrvyIfe+yxWX/99dt9rOOPP77N8RcNDQ0tj7NgwYK8/vrrWW+99bL11lvn6aefbrOO4447rmVLT5Lsscceqaqqze5De+yxR6ZMmZJ33nlnqd/7k08+mWnTpuX0009vdYzEwQcfnG222WaFjjuZPn16kqRPnz7LNf6//uu/kiRnn312q+u/8pWvJEmbOQwbNiwHHnhgq+tuu+227L333ll//fVbXkevvfZa9t9//yxYsCC//vWvkzQdjzNr1qzcf//9S53P8q6rszQfM3T33Xdn/vz5Hb7/P/7jP7a6vPfee+f1119v+Xe59957kzRtYVzcmWeeudyP8dnPfjZz5sxptfVn/PjxSdKya1iSlp/1Zb0Wmm9b8uyCm222We6///42y7J+loG1m93DgNVm5syZLWcJmjhxYqqqynnnnZfzzjuv3fHTpk3Lxhtv3HJ50003bXV7cxy8+eabSdISL+973/tajRs4cOBSQ2LYsGGtLjevY+utt251fX19fTbffPOW25v/u+WWW7Ya161bt2y22WbL9VhJsnDhwlx++eW56qqrMmnSpCxYsKDltg022KDN+CWfg+azKQ0ZMqTN9QsXLkxjY2O761n8e1jye02SbbbZJr/5zW/avd+y9O3bN0nbX0KX5k9/+lO6dOnS5nncaKON0r9//5Y5NmvvOXzxxRfz29/+tuU4kyU1n0Tg9NNPz6233pqRI0dm4403zgEHHJCjjz46H/vYxzq8rs4yYsSIfPKTn8yYMWPy//7f/8s+++yTww8/PJ/5zGfaHPjenmX9jPTt27fl+V7yeVzy+V+WkSNHZsCAARk/fnzLsU3//u//np122inbbbddy7ilBcnimm9b8uxhvXv3Xq6z1AHrDtECrBZ/+ctf0tjY2PLLUfNBzaNGjWrzl/NmS/4itfgWkcVVVbXC81qdZ55q77H++Z//Oeedd15OOumkXHzxxRkwYEC6dOmSs846q81B5MnSn4POeG5WRN++fTN48OA8++yzHbpfewept6e953DhwoX56Ec/mq9+9avt3merrbZK0vSL8TPPPJP77rsv99xzT+65557ccMMNOe644/KjH/2oQ+vqqKV9f4tHavO422+/PRMmTMhdd92V++67LyeddFL+5V/+JRMmTMh66623zMdZHa+D7t275+ijj861116bqVOn5s9//nNefPHFXHLJJa3GbbvttkmS3/72tzn88MPbXddvf/vbJMnmm2++yuYHrJ1EC7Ba/PjHP06SlkBp/iWle/fuq+wvqkOHDk3S9NfyxX8JevXVV1u2xizvOp5//vlW65g3b14mTZrUMtfmcRMnTsy+++7bMu6dd97J5MmTl/ug7Ntvvz377rtvrrvuulbXv/XWW9lwww2Xax0ravHvdb/99mt12/PPP99ye0cdcsgh+eEPf5hHH300e+2117vOYeHChXnxxRfz/ve/v+X6qVOn5q233lquOWyxxRaZOXPmcr2O6uvrc+ihh+bQQw/NwoULc/rpp+eaa67Jeeedly233HK517W8kdWseYvHW2+91eq00UtuSWq25557Zs8998w3v/nNjB8/Pscee2xuvvnmnHzyyR163CU1P9+TJk1qtUVy4sSJHVrPsccemx/84Ae55ZZbMmnSpNTV1eWYY45pNWb48OHp379/xo8fn69//evtBtW//du/JUmOOuqoFfhugHWJY1qATvfAAw/k4osvzrBhw1r2eR80aFD22WefXHPNNXnllVfa3GfJUxkvj/333z/du3fPFVdc0eovy81nj1reddTX1+d73/teq3Vcd911aWxsbDnL0q677poNNtgg1157bavjRm666ablDqSk6S/jS/4V/LbbbmtzPE9n2HXXXTNo0KD84Ac/aHV64XvuuSd/+MMflvuMUkv66le/mt69e+fkk0/O1KlT29z+0ksvtZxm+KCDDkrS9t/o0ksvTZLlmsPRRx+dRx99NPfdd1+b2956662Wf5/XX3+91W1dunRpicvm739519WrV6+W65ZH89nWFj8mZtasWS1beJq9+eabbV4PO++8c6s5rozmPxpcddVVra6/4oorOrSe4cOHZ7PNNsuNN96YW265JSNGjGhzxrxevXrlq1/9ap5//vl8/etfb7OOn/3sZxk3blwOPfTQ7LDDDh38ToB1jS0twCp1zz335I9//GPeeeedTJ06NQ888EDuv//+DB06NHfeeWerA76vvPLKfOhDH8oOO+yQU045JZtvvnmmTp2aRx99NH/5y1/afFbJuxk4cGBGjRqVsWPH5pBDDslBBx2U//mf/8k999yz3FstBg4cmNGjR2fMmDH52Mc+lsMOOyzPP/98rrrqquy2224tH3hXX1+fCy+8MGeeeWb222+/HH300Zk8eXLGjRuXLbbYYrn/En/IIYfkoosuyoknnpgPfvCD+d3vfpebbrpptewu071793z729/OiSeemBEjRuSYY45pOeXxZpttli9/+csrtN4tttgi48ePz6c+9am8//3vz3HHHZftt98+8+bNyyOPPJLbbrut5ViInXbaKccff3x++MMf5q233sqIESPy+OOP50c/+lEOP/zwVluxluacc87JnXfemUMOOSQnnHBCdtlll8yaNSu/+93vcvvtt2fy5MnZcMMNc/LJJ+eNN97Ifvvtl0022SR/+tOfcsUVV2TnnXdu2cqzvOvq2bNntt1229xyyy3ZaqutMmDAgGy//fbZfvvt253jAQcckE033TSf//znc84556Rr1665/vrrM3DgwPz5z39uGfejH/0oV111VY444ohsscUWmTFjRq699tr07du3JfBWxi677JJPfvKTueyyy/L666+3nPL4hRdeSLL8W5Dq6urymc98Jv/8z/+cJLnooovaHffVr341zzzzTL797W/n0UcfzSc/+cn07Nkzv/nNb3LjjTdmu+22y7hx49rcr7Gxsc1nOjXzoZOwjqrZecuAtUrzqVubl/r6+mqjjTaqPvrRj1aXX355NX369Hbv99JLL1XHHXdctdFGG1Xdu3evNt544+qQQw6pbr/99jbrXvI0sM2nAf7Vr37Vct2CBQuqMWPGVO9973urnj17Vvvss0/17LPPVkOHDm33lMdLO7Xs97///WqbbbapunfvXr3n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M2fmpZdeynvf+96ljmloaEjfvn1bLQAAAMurQ9EyatSoPPTQQ5k8eXIeeeSRHHHEEenatWuOOeaYzpofAACwjuvQMS1/+ctfcswxx+T111/PwIED86EPfSgTJkzIwIEDO2t+AADAOq5D0XLzzTd31jwAAADatVLHtAAAAHQ20QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAULRutZ4Ay6Gqkvmzaz2Ltc+82e1/zarTvVdSV1frWQAAazjRUrqqSq4/MJnyWK1nsnb77pa1nsHaacieyUn3ChcAYKXYPax082cLFtZcUybYSggArDRbWtYkoyYm9b1qPQt4d/Nm23oFAKwyomVNUt8rqe9d61kAAMBqZfcwAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAo2kpFy7e+9a3U1dXlrLPOWkXTAQAAaG2Fo+WJJ57INddckx133HFVzgcAAKCVFYqWmTNn5thjj821116b9ddff1XPCQAAoMUKRcsZZ5yRgw8+OPvvv/+qng8AAEAr3Tp6h5tvvjlPP/10nnjiieUaP3fu3MydO7fl8vTp0zv6kAAAwDqsQ1tapkyZki996Uu56aab0qNHj+W6z9ixY9OvX7+WZciQISs0UQAAYN3UoWh56qmnMm3atPzDP/xDunXrlm7duuWhhx7K9773vXTr1i0LFixoc5/Ro0ensbGxZZkyZcoqmzwAALD269DuYR/5yEfyu9/9rtV1J554YrbZZpv8n//zf9K1a9c292loaEhDQ8PKzRIAAFhndSha+vTpk+23377Vdb17984GG2zQ5noAAIBVYaU+XBIAAKCzdfjsYUt68MEHV8E0AAAA2mdLCwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNE6FC1XX311dtxxx/Tt2zd9+/bNXnvtlXvuuaez5gYAANCxaNlkk03yrW99K0899VSefPLJ7Lfffvn4xz+e5557rrPmBwAArOO6dWTwoYce2uryN7/5zVx99dWZMGFCtttuu1U6MQAAgKSD0bK4BQsW5LbbbsusWbOy1157rco5AQAAtOhwtPzud7/LXnvtlTlz5mS99dbLHXfckW233Xap4+fOnZu5c+e2XJ4+ffqKzRQAAFgndfjsYVtvvXWeeeaZPPbYYznttNNy/PHH5/e///1Sx48dOzb9+vVrWYYMGbJSEwYAANYtHY6W+vr6bLnlltlll10yduzY7LTTTrn88suXOn706NFpbGxsWaZMmbJSEwYAANYtK3xMS7OFCxe22v1rSQ0NDWloaFjZhwEAANZRHYqW0aNHZ+TIkdl0000zY8aMjB8/Pg8++GDuu+++zpofAACwjutQtEybNi3HHXdcXnnllfTr1y877rhj7rvvvnz0ox/trPkBAADruA5Fy3XXXddZ8wAAAGhXhw/EBwAAWJ1ECwAAULSVPnsY0EFVlcyfXetZdK55s9v/em3WvVdSV1frWQDAWkm0wOpUVcn1ByZTHqv1TFaf725Z6xmsHkP2TE66V7gAQCewexisTvNnr1vBsi6ZMmHt34IGADViSwvUyqiJSX2vWs+ClTVv9rqzNQkAakS0QK3U90rqe9d6FgAAxbN7GAAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUrUPRMnbs2Oy2227p06dPBg0alMMPPzzPP/98Z80NAACgY9Hy0EMP5YwzzsiECRNy//33Z/78+TnggAMya9aszpofAACwjuvWkcH33ntvq8vjxo3LoEGD8tRTT+XDH/7wKp0YAABA0sFoWVJjY2OSZMCAAUsdM3fu3MydO7fl8vTp01fmIQEAgHXMCh+Iv3Dhwpx11lkZPnx4tt9++6WOGzt2bPr169eyDBkyZEUfEgAAWAetcLScccYZefbZZ3PzzTcvc9zo0aPT2NjYskyZMmVFHxIAAFgHrdDuYV/84hdz991359e//nU22WSTZY5taGhIQ0PDCk0OAACgQ9FSVVXOPPPM3HHHHXnwwQczbNiwzpoXAABAkg5GyxlnnJHx48fnP//zP9OnT5/87W9/S5L069cvPXv27JQJAgAA67YOHdNy9dVXp7GxMfvss0/e+973tiy33HJLZ80PAABYx3V49zCAmqiqZP7sWs+irXmz2/+6FN17JXV1tZ4FAKyUlfqcFoDVoqqS6w9MpjxW65ks23e3rPUM2hqyZ3LSvcIFgDXaCp/yGGC1mT+7/GAp1ZQJZW6hAoAOsKUFWLOMmpjU96r1LMo3b3aZW34AYAWIFmDNUt8rqe9d61kAAKuR3cMAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBo3Wo9gWJUVTJ/dq1n0da82e1/XZLuvZK6ulrPAgCAtZRoSZqC5foDkymP1Xomy/bdLWs9g/YN2TM56V7hAgBAp7B7WNK0haX0YCnZlAllbqUCAGCtYEvLkkZNTOp71XoWa4Z5s8vd+gMAwFpDtCypvldS37vWswAAAP7O7mEAAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFK1brScAANBKVSXzZ9d6FmufebPb/5pVp3uvpK6u1rNYK4kWAKAcVZVcf2Ay5bFaz2Tt9t0taz2DtdOQPZOT7hUuncDuYQBAOebPFiysuaZMsJWwk9jSAgCUadTEpL5XrWcB727ebFuvOploAQDKVN8rqe9d61kABbB7GAAAULQOR8uvf/3rHHrooRk8eHDq6uryH//xH50wLQAAgCYdjpZZs2Zlp512ypVXXtkZ8wEAAGilw8e0jBw5MiNHjlz5R541K+nate31XbsmPXq0Hrc0XbokPXuu2NjZs5tOq5gk82Yl86pF63inLunVq/2xS6pbYuzbbycLFy59Hr17r9jYOXOSBQtWzdhei51DfO7c5J13Vmzsks9bt55Nz3OSzJuXzJ+/9PX27MDYHj0WvVY6Mnb+/KbxS9PQkHTr1vGx77zT9FwsTX190r17+2OXfM7qFhu7YEHTv93SdO/etO6Ojl24sOm1tirGduvW9FwkTT8Ts5dxhpSOjH23n/vFn7c5c1rv47463iOWtOTPfYnvEUu+1upr8B6xpI783K+r7xHLGruuvEcs+dqdn479blCL3yOWtCa8R6zMWO8RTdq8Ryzxul3aWO8RTV83/9wv6+ducdVKSFLdcccdyxwzZ86cqrGxsWWZMmVKlaRqbJpq2+Wgg1qvoFev9sclVTViROuxG2649LG77tp67NChSx+77batx2677dLHDh3aeuyuuy597IYbth47YsTSx/bq1XrsQQctfeyS/4xHHrnssTNnLhp7/PHLHjtt2qKxp5++7LGTJi0aO2rUssc+++yisRdcsOyxjz++aOwllyx77K9+tWjs97+/7LF3371o7A03LHvsrbcuGnvrrcsee8MNi8beffeyx37/+4vG/upXyx57ySWLxj7++LLHXnDBorHPPrvssaNGLRo7adKyx55++qKx06Yte+zxxy8aO3PmssceeWTVyrLGfuzA1mO9RzTxHtHEe0STdfk9wu8RTYv3iEXL6niPuPYHyx7rPaJpaec9ojGpklSNjY3VsnT6gfhjx45Nv379WpYhQ4Z09kMCAABrkbqqqqoVvnNdXe64444cfvjhSx0zd+7czF1ss9b06dMzZMiQNP71r+nbt2/bO9Rq97Dv/P3c2udMTBrWs1l3ecYu+bz123AN36y7mnYPW/w5W2/9NX+z7qoYuzy7hzU/b+dOSvpusPSxi1uXd/1Y8rW2/qClj12SXT+a2D2s42NX1e5hi79263vbPWxxa9PvEUtak98jZr2VfHPTpq+bX7dLG+s9ounrv//cT58+Pf0GD05jY2P7bdB816WvddVoaGhIQ/PkFte7d+sfkKVZnjErMnbxN4juSerrFq1jyQ+y6rXE5WVZ/A1tVY5d/A14VY5taFj04uno2CWfty6Lbbirr1/0An43nTW2e/dFP8ircmy3boveeDo6dsnnbPHH7Np1+V/DHRnbpUvnjK2r65yxSduxiz9vS76+V8d7xKocu7reI5Z8rS1r7LKszHvEsniP6PjYdeU9os3/k9tZR2f93K9L7xGraqz3iEVj3+1128x7RJPmn/tlBfLiq16+tQIAANRGh7e0zJw5MxMnTmy5PGnSpDzzzDMZMGBANt1001U6OQAAgA5Hy5NPPpl999235fLZZ5+dJDn++OMzbty4VTYxAACAZAWiZZ999slKHLsPAADQIY5pAQAAitbpZw8DAIBVoqqS+cs4lXatzJvd/tcl6b7Y6afXQKIFAIDyVVVy/YHJlMdqPZNl++6WtZ5B+4bsmZx07xobLnYPAwCgfPNnlx8sJZsyocytVMvJlhYAANYsoya2/TBw2jdvdrlbfzpAtAAAsGap77XsT51nrWP3MAAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAitat1hMA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",
+      "text/plain": [
+       "<Figure size 1000x1000 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "threshold_height = 1\n",
+    "clusters = dendo.get_clusters_using_height(threshold_height)\n",
+    "colors = [\"red\", \"blue\", \"green\", \"black\", \"purple\", \"orange\", \"yellow\"]\n",
+    "dendo.plot_dendrogram(\n",
+    "    plot_title=\"Dendrogram of Coreset using VQE\",\n",
+    "    colors=colors,\n",
+    "    clusters=clusters,\n",
+    "    color_threshold=threshold_height,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can visualize the flat clusters using `dendo.plot_clusters()` method. The function takes the clusters and colors as arguments. The clusters are represented by different colors."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAr8AAAGzCAYAAAAmM38IAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAABkU0lEQVR4nO3dfVxUZf7/8dcBZUQExAJEGBW8SbzNMM27lNKkG9MVq201tW/ZWmjeta3urqWpkWvuauZ9bdqvtEzRdiVR897SLInNFE1MxBswWxW8KdTh/P5AJkdAQRlGmffz8TgPd65znXM+M2PL24vrXMcwTdNERERERMQNeLi6ABERERGR8qLwKyIiIiJuQ+FXRERERNyGwq+IiIiIuA2FXxERERFxGwq/IiIiIuI2FH5FRERExG0o/IqIiIiI21D4FRERERG3ofArbqlu3boMGDDA1WXctPbt28cDDzyAv78/hmGwfPlyV5fktjp37kznzp1dXYaISIWh8CsVyv79+/njH/9IREQEVapUwc/Pj/bt2zNt2jR++eWXcqnh3LlzjB07lg0bNpTL9Zyhf//+7Ny5k4kTJ/L//t//o1WrVlftn5OTw7hx42jRogXVqlXD29ubpk2b8uc//5mjR4+WU9XOM3PmTObPn+/qMspNcnIyhmHwt7/9rdg++/btwzAMRowY4dD+xRdf8Lvf/Y7g4GAsFgt169Zl0KBBHDp0qNA5xo4di2EYxW5ZWVll/t5ERCq5ugCRspKYmMhjjz2GxWKhX79+NG3alPPnz7Nlyxb+9Kc/sWvXLubOnev0Os6dO8e4ceMAbskRu19++YWtW7fy17/+lcGDB1+z/48//kiXLl3IyMjgscce47nnnsPLy4vvvvuOd999l2XLlvHDDz+UQ+XOM3PmTG6//XaX/LZg9erV5X7Nu+66i0aNGrFo0SImTJhQZJ+FCxcC0LdvX3vb9OnTGTp0KBEREQwZMoSQkBBSU1N55513+Pjjj1m5ciX33HNPoXPNmjWLatWqFWqvXr162bwhEZHLKPxKhXDgwAF+//vfU6dOHdatW0dISIh9X1xcHGlpaSQmJrqwwht39uxZfHx8nH6d48ePAyULHhcvXqRXr14cO3aMDRs20KFDB4f9EydOZNKkSWVSV3m9/5uNl5eXS67bp08fxowZw7Zt24oMrIsWLaJRo0bcddddQP6I77Bhw+jQoQNJSUlUrVrV3vf555+nffv2xMbGsmvXrkJ/t3r37s3tt9/u1PcjImJnilQAgwYNMgHziy++KFH/OnXqmP3797e/fvXVV82i/nN47733TMA8cOCAve3rr782H3jgAfO2224zq1SpYtatW9d8+umnTdM0zQMHDphAoe3VV1+1H5+ammrGxsaaAQEBpsViMaOiosxPP/20yOtu2LDBfP75583AwECzevXqpmmaZk5Ojjl06FCzTp06ppeXlxkYGGh26dLF3LFjxzXfd3JyshkTE2P6+vqaPj4+5n333Wdu3bq10Odw+VanTp1iz/fRRx+ZgDlx4sRrXrvA4sWLzbvuususUqWKedttt5l9+vQxDx8+7NCnf//+po+Pj5mWlmY++OCDZrVq1cwePXqYpmmaNpvN/Oc//2k2btzYtFgsZlBQkPncc8+ZJ06ccDjH1b6nAiU5V506dQp9Jp06dSr2/a1fv94EzPXr1zu0F/zdeO+99+xtmZmZ5oABA8zQ0FDTy8vLrFmzpvnoo486/H3r1KmTw/UKzv/xxx+bEyZMMENDQ02LxWLed9995r59+wrV8/bbb5vh4eFmlSpVzLvvvtvctGlToXMW5ccffzQBc8iQIYX2ffPNNyZgjh8/3t7WrVs309PT0/zxxx+LPN+CBQtMwJw0aZK9reDv2/Hjx69ai4hIWdLIr1QI//nPf4iIiKBdu3ZOvc5PP/3EAw88QGBgIKNGjaJ69eqkp6eTkJAAQGBgILNmzeL555/nd7/7Hb169QKgefPmAOzatYv27dsTGhrKqFGj8PHxYfHixfTs2ZOlS5fyu9/9zuF6L7zwAoGBgbzyyiucPXsWgEGDBrFkyRIGDx5M48aN+d///seWLVtITU21j8IVZdeuXXTs2BE/Pz9efvllKleuzJw5c+jcuTMbN26kTZs29OrVi+rVqzN8+HCefPJJHnrooSJ/HV3g3//+NwBPPfVUiT6/+fPn8/TTT3P33XcTHx/PsWPHmDZtGl988QXffvutw4jgxYsX6datGx06dODNN9+0jyT+8Y9/tJ/nxRdf5MCBA7z99tt8++23fPHFF1SuXPma31OBkpxr6tSpDBkyhGrVqvHXv/4VgODg4BK932spGAkdMmQIdevW5aeffmLNmjVkZGRQt27dqx77xhtv4OHhwUsvvUR2djZ///vf6dOnD1999ZW9z6xZsxg8eDAdO3Zk+PDhpKen07NnTwICAggLC7vq+cPDw2nXrh2LFy/mn//8J56envZ9BVMe/vCHPwD5U33Wrl1Lx44dCQ8PL/J8TzzxBM899xz/+c9/ePnllx32nThxolD/SpUqadqDiDiHq9O3yI3Kzs42AfvIYElc78jvsmXLTMD8+uuviz338ePHC432Frj//vvNZs2amb/++qu9LS8vz2zXrp3ZoEGDQtft0KGDefHiRYdz+Pv7m3FxcSV8p7/p2bOn6eXlZe7fv9/edvToUdPX19e899577W0FI5STJ0++5jlbtmxp+vv7l+j658+fN4OCgsymTZuav/zyi719xYoVJmC+8sor9rb+/fubgDlq1CiHc2zevNkEzA8//NChPSkpyaG9JN9TSc9lmqbZpEmTa46UFijpyO/JkydL9DkXN/IbGRlp5ubm2tunTZtmAubOnTtN0zTN3Nxc87bbbjPvvvtu88KFC/Z+8+fPv+bodYEZM2aYgLlq1Sp7m81mM0NDQ822bdva21JSUkzAHDp06FXP17x5c7NGjRr210X9pqFgu+OOO65Zn4jI9dBqD3LLy8nJAcDX19fp1yoYiVqxYgUXLlwo1bEnTpxg3bp1PP7445w+fZqff/6Zn3/+mf/9739069aNffv2ceTIEYdjBg4c6DDiVlDDV199VapVFGw2G6tXr6Znz55ERETY20NCQvjDH/7Ali1b7J9jaeTk5JT4c//mm2/46aefeOGFF6hSpYq9/eGHH6ZRo0ZFzsl+/vnnHV5/8skn+Pv707VrV/vn9/PPPxMVFUW1atVYv349ULLvqaTnchZvb2+8vLzYsGEDJ0+eLPXxTz/9tMN84I4dOwL5NyBC/uf9v//9j4EDB1Kp0m+/5OvTpw8BAQElusYTTzxB5cqV7SO9ABs3buTIkSP06dPH3nb69Gng2v8N+vr62vtebunSpaxZs8Zhe++990pUo4hIaSn8yi3Pz88PoMgfqmWtU6dOxMbGMm7cOG6//XZ69OjBe++9R25u7jWPTUtLwzRNxowZQ2BgoMP26quvAvnTKi5X1K+Q//73v/P9999jtVpp3bo1Y8eOtQee4hw/fpxz585xxx13FNoXGRlJXl5ekUtRXYufn1+JP/eDBw8CFFlDo0aN7PsLVKpUqdCv5vft20d2djZBQUGFPsMzZ87YP7+SfE8lPZezWCwWJk2axMqVKwkODubee+/l73//e4mX96pdu7bD64JAWxCkCz7P+vXrO/SrVKnSNadUFLjtttvo1q0by5Yt49dffwXypzxUqlSJxx9/3N6vIPRe6+/C6dOnCQoKKtR+77330qVLF4etbdu2JapRRKS0NOdXbnl+fn7UqlWL77///rrPYRhGke02m61QvyVLlrBt2zb+85//sGrVKv7v//6PKVOmsG3btqvOj83LywPgpZdeolu3bkX2uTKoeHt7F+rz+OOP07FjR5YtW8bq1auZPHkykyZNIiEhgQcffPCq77OsNWrUiG+//ZZDhw5htVrL9NwWiwUPD8d/n+fl5REUFMSHH35Y5DGBgYFAyb6nkp6rtEr6dwlg2LBhdO/eneXLl7Nq1SrGjBlDfHw869ato2XLlle9zpW/EShgmmbpi76Kvn37smLFClasWMGjjz7K0qVL7fOpCzRo0IBKlSrx3XffFXue3Nxc9u7dS+vWrcu0PhGR0tLIr1QIjzzyCPv372fr1q3XdXzBqNmpU6cc2q8cjSxwzz33MHHiRL755hs+/PBDdu3axUcffQQUH34KphtUrly50ChXwVbSKQQhISG88MILLF++nAMHDnDbbbcxceLEYvsHBgZStWpV9u7dW2jfnj178PDwuK7w2r17dwA++OCDa/atU6cOQJE17N27177/aurVq8f//vc/2rdvX+Tn16JFC4f+V/ueSnOu4r7TopT271K9evUYOXIkq1ev5vvvv+f8+fNMmTKlxNcrTsHnmZaW5tB+8eJF0tPTS3yeRx99FF9fXxYuXMjKlSs5efKkw5QHgKpVq3L//fezadOmYt/n4sWLyc3N5bHHHivdGxERKWMKv1IhvPzyy/j4+PDss89y7NixQvv379/PtGnTij2+Xr16AGzatMnedvbsWRYsWODQ7+TJk4VG1u68804A+6/UC1YluDL8BAUF0blzZ+bMmUNmZmahGgrW170am81GdnZ2ofPWqlXrqlMvPD09eeCBB/j0008dgs+xY8dYuHAhHTp0sE8fKY3evXvTrFkzJk6cWOQ/PE6fPm1fIaFVq1YEBQUxe/Zsh1pXrlxJamoqDz/88DWv9/jjj2Oz2Rg/fnyhfRcvXrR/5iX5nkp6LgAfH59C32dx6tSpg6enp8PfJch/UMblzp07Z59KUKBe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DRtGrVq19N3ITUPhtwK7/fbb8fT05NixYw7tx44do2bNmi6qSq40ePBgVqxYwaZNmwgLC3N1OQLs2LGDn376ibvuusveZrPZ2LRpE2+//Ta5ubl4enq6sEL3FhISQuPGjR3aIiMjWbp0qYsqkgJ/+tOfGDVqFL///e8BaNasGQcPHiQ+Pl7hV24amvNbgXl5eREVFcXatWvtbXl5eaxdu5a2bdu6sDIBME2TwYMHs2zZMtatW0d4eLirS5JL7r//fnbu3ElKSop9a9WqFX369CElJUXB18Xat29faFnAH374gTp16rioIilw7tw5PDwco4Wnpyd5eXkuqkikMI38VnAjRoygf//+tGrVitatWzN16lTOnj3L008/7erS3F5cXBwLFy7k008/xdfXl6ysLAD8/f3x9vZ2cXXuzdfXt9Dcax8fH2677TbNyb4JDB8+nHbt2vH666/z+OOPs337dubOncvcuXNdXZrb6969OxMnTqR27do0adKEb7/9ln/84x/83//9n6tLE7HTUmdu4O2332by5MlkZWVx55138tZbb9GmTRtXl+X2DMMosv29995jwIAB5VuMXFPnzp211NlNZMWKFYwePZp9+/YRHh7OiBEjGDhwoKvLcnunT59mzJgxLFu2jJ9++olatWrx5JNP8sorr+Dl5eXq8kQAhV8RERERcSOa8ysiIiIibkPhV0RERETchsKviIiIiLgNhV8RERERcRsKvyIiIiLiNhR+RURERMRtKPyKiIiIiNtQ+BURERERt6HwKyIiIiJuQ+FXRERERNyGwq+IiIiIuI3/D41GRMsQk+8TAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "dendo.plot_clusters(\n",
+    "    clusters, colors, plot_title=\"Clusters of Coreset using VQE\", show_annotation=True\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The function below uses the `dendo.get_voronoi_tessalation()` method to convert the clusters into regions. `coreset_df`, `clusters` and `colors` need to be passed as the arguments to create the regions. This function creates a region for each coreset point separately and then colors them according to the clusters with colors passed as arguments. Another option is to create regions using the centroids of the clusters. You need to pass `tesslation_by_cluster=True` to the function to perform this task.\n",
+    "\n",
+    "Once the region creation is complete, you can use `plot_voironi()` method to plot the regions. The function takes the clusters and colors as arguments. \n",
+    "\n",
+    "Remembering that these regions were based on coresets, they can overlay the original data set and be used to cluster the data based on the coreset analysis."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAiUAAAJCCAYAAAAfnLcJAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAABqUElEQVR4nO3dd5hU5d0+8Puc6bM72/suu/QqRWkCKlIEsSdqFDWCMTEqiEpiIskbS14VNT9LbKh5jRAS7FHz+iYqIIoFpAliAVTa0stWdvrM8/tj3ZVl++zMPKfcn+va64LZ2Znvzs6cuecp36MIIQSIiIiIJFNlF0BEREQEMJQQERGRRjCUEBERkSYwlBAREZEmMJQQERGRJjCUEBERkSYwlBAREZEmMJQQERGRJjCUEBERkSYwlFDC7dy5E4qiYOHChVLuf+HChVAUBTt37pRy/4n0/vvvQ1EUvP/++3G9XUVRcNddd8X1NuNt7dq1GDt2LFJSUqAoCjZu3Ci7JNPq3r07Zs6cKbsMMgCGEmriggsugNvtRm1tbavXufLKK2G323H06NEkVpY4DaGpI19GCjb//ve/NR88WhMKhXDppZeioqICjzzyCBYvXoyysrI2f+bgwYP49a9/jf79+8PtdiMlJQXDhw/HPffcg6qqquQUnkD33Xcf3njjDdllJM0///lPKIqC//mf/2n1OkuXLoWiKHjssceaXP7WW2/h7LPPRnZ2NpxOJ/r27YvbbrsNFRUVzW5j5syZrR4PnE5n3H8vs1N47hs63ksvvYTLL78cixYtwtVXX93s+16vF3l5eZg4cSL+9a9/deg2hRAIBAKw2WywWCzxLrldkUgEoVAIDocDiqI0+35dXR1ef/31Jpc99NBD2LNnDx555JEml//oRz9CSkpKQuvtjPfffx8TJkzAihUrcOaZZ3bqZ2fPno0nn3wSLR0C/H4/rFYrrFZrnCqNry1btmDAgAH4y1/+gp///OftXn/t2rU455xzcOzYMVx11VUYPnw4AGDdunV48cUXMXbsWLz77ruJLjuhUlNTcckll0gZkQwEAlBVFTabLan3mZ+fj1NOOQXvvfdei9e55pprsHjxYuzbtw95eXkAgF//+td46KGHMHToUFxxxRXIysrChg0b8Ne//hV5eXlYvnw5+vTp03gbM2fOxIsvvthi+LFYLJg+fXpifkGzEkTH8Xq9wuPxiKlTp7b4/SVLlggA4sUXX4z7fR87dizutxmrc889V5SVlckuo10rVqwQAMSKFSs6/bOzZs0Sej0EfPDBBwKAeOWVV9q9bmVlpSguLhb5+fni66+/bvb9AwcOiP/+7/+OS111dXVxuZ1YpKSkiBkzZki7fxmuvfZaoaqq2Lt3b7Pv+Xw+kZ6eLs4+++zGyxqOX5dddpkIh8NNrv/pp58Kt9sthg4dKkKhUOPlM2bMECkpKYn7JagJfR6RKKFmzJghrFarOHjwYLPvnXfeecLj8Qiv1yuEEOK7774Tl1xyicjMzBQul0uMHj1avPXWW01+ZseOHQKAeP7555vcR0pKivj222/FtGnTRGpqqrjwwguFEPXhZO7cuaKkpETY7XbRt29f8ac//UlEo9EmtwtAzJo1S7z++uti0KBBwm63i4EDB4r//Oc/Ta73/PPPCwBix44dHX4MWgolfr9f3HHHHaJXr17CbreLkpIScdtttwm/39/keu+++64YN26cSE9PFykpKaJv375i3rx5Ta7z2GOPiYEDBwqXyyUyMjLE8OHDxT/+8Y/G7+/cuVPccMMNom/fvsLpdIqsrCxxySWXNPsdWgolK1euFJdccono1q1bY5233HJL499MiPrHH0Czr+Mf2zvvvLPJfW3YsEGcffbZwuPxiJSUFDFx4kSxatWqJtdpeKw/+ugjceutt4qcnBzhdrvFRRddJA4dOtTewy6EEGL58uXitNNOE263W6Snp4sLLrhAfPXVV23WPn78+FZv7/777xcAmjy+7XnyySfFwIEDhd1uF4WFheLGG28UlZWVTa4zfvx4MWjQILFu3Tpx+umnC5fLJW6++WYhRHyfKx25rZb+lm0FlNZeEy09n7Zt2yZ+/OMfi/z8fOFwOERxcbG47LLLRFVVVeN1ysrKmtxfZ54HkUhE3HnnnaKwsFC4XC5x5plnii+//LLZbbakod6HHnqo2fdeffVVAUAsXry48bJ+/fqJzMxMUV1d3eLt3X333QKAeOmllxovYyhJLm2OzZJUV155JRYtWoSXX34Zs2fPbry8oqIC77zzDqZPnw6Xy4WDBw9i7Nix8Hq9mDNnDrKzs7Fo0SJccMEFePXVV/GjH/2ozfsJh8OYOnUqTjvtNPy///f/4Ha7IYTABRdcgBUrVuDaa6/FsGHD8M477+C2227D3r17m02nfPTRR/jnP/+JG2+8ER6PB4899hguvvhi7N69G9nZ2XF7TKLRKC644AJ89NFHuO666zBgwABs3rwZjzzyCLZt29Y4l//ll1/ivPPOw5AhQ/DHP/4RDocD3377LT7++OPG2/rLX/6COXPm4JJLLsHNN98Mv9+Pzz//HJ9++imuuOIKAPXTDZ988gkuv/xylJSUYOfOnViwYAHOPPNMfPXVV3C73a3W+sorr8Dr9eKGG25AdnY21qxZg8cffxx79uzBK6+8AgD45S9/iX379mHp0qVYvHhxu7//l19+idNPPx1paWn4zW9+A5vNhmeeeQZnnnkmPvjgA4wePbrJ9W+66SZkZmbizjvvxM6dO/Hoo49i9uzZeOmll9q8n2XLlmHatGno2bMn7rrrLvh8Pjz++OMYN24cNmzYgO7du+OXv/wliouLcd9992HOnDkYOXIk8vPzW73Nf/3rX3C5XLjkkkva/T0B4K677sLdd9+NyZMn44YbbsDWrVuxYMECrF27Fh9//HGTKYqjR49i2rRpuPzyy3HVVVchPz8/rs+Vjt7W4sWL8fOf/xyjRo3CddddBwDo1atXh37ftgSDQUydOhWBQAA33XQTCgoKsHfvXrz11luoqqpCenp6mz/fkefBvHnz8OCDD+L888/H1KlTsWnTJkydOhV+v7/d+s444wyUlJRgyZIlmDt3bpPvLVmyBG63GxdddBEA4JtvvsHWrVsxc+ZMpKWltXh7V199Ne6880787//+L37yk580+d6RI0eaXd9ut7d6WxQj2amItCccDovCwkIxZsyYJpc//fTTAoB45513hBBC3HLLLQKA+PDDDxuvU1tbK3r06CG6d+8uIpGIEKL1kRIA4vbbb29yH2+88YYAIO65554ml19yySVCURTx7bffNl4GQNjt9iaXbdq0SQAQjz/+eONl8RgpWbx4sVBVtcnvevxj8vHHHwshhHjkkUcEAHH48OFWb/vCCy8UgwYNavP+jx/VaLBq1SoBQPztb39rvKylT7Yt/ez8+fOFoihi165djZe1NX2DE0ZKLrroImG328V3333XeNm+ffuEx+MRZ5xxRuNlDY/15MmTm4xs3XrrrcJisTT5dN2SYcOGiby8PHH06NHGyzZt2iRUVRVXX311s9+7I9M3mZmZYujQoe1eTwghDh06JOx2u5gyZUrj81cIIZ544gkBQPz1r39tvGz8+PECgHj66aeb3EY8nysdvS0hOjd909GRks8++6xDj3NrIyXtPQ8OHDggrFaruOiii5rc3l133dXuaE+D2267TQAQW7dubbysurpaOJ1OMX369MbLGo4tjzzySJu3l5aWJk455ZTG/7c2qgig1Wluih1331AzFosFl19+OVatWtVkt8mSJUuQn5+PSZMmAajfvTFq1CicdtppjddJTU3Fddddh507d+Krr75q975uuOGGJv//97//DYvFgjlz5jS5/Fe/+hWEEPjPf/7T5PLJkyc3+UQ4ZMgQpKWlYfv27R3+fTvilVdewYABA9C/f38cOXKk8WvixIkAgBUrVgAAMjIyAABvvvkmotFoi7eVkZGBPXv2YO3ata3en8vlavx3KBTC0aNH0bt3b2RkZGDDhg1t1nr8z9bV1eHIkSMYO3YshBD47LPPOvT7Hi8SieDdd9/FRRddhJ49ezZeXlhYiCuuuAIfffQRampqmvzMdddd12RR8emnn45IJIJdu3a1ej/79+/Hxo0bMXPmTGRlZTVePmTIEJx11ln497//3enaAaCmpgYej6dD1122bBmCwSBuueUWqOoPh8df/OIXSEtLw//93/81ub7D4cA111zT5LJ4Plc6eluJ0jAS8s4778Dr9Xb659t7HixfvhzhcBg33nhjk5+76aabOnwfV111FYD641OD1157DX6/H1deeWXjZQ07Ctt7Lng8nma7D51OJ5YuXdrs6/777+9wndQxDCXUooYXc8MLfc+ePfjwww9x+eWXN+6g2bVrF/r169fsZwcMGND4/bZYrVaUlJQ0uWzXrl0oKipqduBo7TZLS0ub3W5mZiYqKyvbvO/O+uabb/Dll18iNze3yVffvn0BAIcOHQIAXHbZZRg3bhx+/vOfIz8/H5dffjlefvnlJm86v/3tb5GamopRo0ahT58+mDVrVpMhewDw+Xy444470K1bNzgcDuTk5CA3NxdVVVWorq5us9bdu3c3vrGnpqYiNzcX48ePB4B2f7Ylhw8fhtfrbfVvHY1GUV5e3uTyE/8umZmZANDm36Xhb9va/Rw5cgR1dXWdrj8tLa3NLe4dqcFut6Nnz57Nnn/FxcWw2+1NLovnc6Wjt5UoPXr0wNy5c/E///M/yMnJwdSpU/Hkk092+HnU3vOg4fHs3bt3k+tlZWU1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20VRUZGYPn262LZtW+PtPPPMM+KMM84Q2dnZwuFwiF69eonbbrutSUOnyspKcc0114icnByRmpoqpk6dKrZs2dLsd2tpS/BXX30lJk+eLFJTU0VOTo74xS9+0bhV+vi/QTgcFjfddJPIzc0ViqJ0qHna1KlTRWpqqnC73WLChAnik08+aXKdhsd67dq1TS7vTOfZZcuWiXHjxgmXyyXS0tLE+eef36R52vG315EtwQ327dsnbr311saGdG63WwwfPlzce++9zZppPfHEE6J///7CZrOJ/Px8ccMNN7TaPK0l8XqudPS2hBBiy5Yt4owzzhAul6tD22m/++47MXnyZOFwOER+fr743e9+J5YuXdrk77R9+3bxs5/9TPTq1auxid+ECRPEsmXLmtxWa6+5jjwPwuGw+MMf/iAKCgqEy+USEydOFF9//bXIzs4W119/fZu/w/EqKiqEw+EQAJo9X070r3/9S0yePFlkZGQ0bu8dNGhQi03V2toS3NnjCrWP574hIiJNqaqqQmZmJu65555WRz3i6ec//zmee+65Dp9LiRKH0zdERCSNz+drtovp0UcfBYBOn2QyVs888wwOHjyIG264AUVFRTGvX6Ku40gJERFJs3DhQixcuBDnnHMOUlNT8dFHH+GFF17AlClT8M4778guj5KMIyVERCTNkCFDYLVa8eCDD6KmpqZx8WtXtxuTPnGkhIiIiDSBfUqIiIhIExhKiIiISBNMtaYkGo1i37598Hg8nWrKQ0RERLERQqC2thZFRUXtN9WU2COlS+bPny8AiJtvvrnDP1NeXt5mExx+8Ytf/OIXv/iVmK/y8vJ236d1OVKydu1aPPPMMxgyZEinfq6hhXd5+f1IS3MmojSiH2x1A594ZVdBZHj/HGxDtSUkuwxqhb/Oj9vPvb3FkyCeSHeh5NixY7jyyivxl7/8pdNbxhqmbNLSnEhLa37KcaK46m4HPhOyqyAytIiqIJQu4NLf25npdGTZhO4Wus6aNQvnnntuh04hHggEUFNT0+SLKGky+cmNKNGqU61g9DcOXUXLF198ERs2bMDatWs7dP358+fj7rvvTnBVRK2wRoFcG3CY4YQoUSo8VgB8jRmFbkZKysvLcfPNN+Mf//gHnM6OrQeZN28eqqurG7/Ky8sTXCXRCYp1lfuJdKeSM/GGopsj5vr163Ho0CGccsop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KiZPnoxVq1ZJrMy4qqurAQBZWVmSKzGmWbNm4dxzz23ynKb4+Ne//oURI0bg0ksvRV5eHk4++WT85S9/kV2W4YwdOxbLly/Htm3bAACbNm3CRx99hGnTpkmurONMdUI+ip8jR44gEokgPz+/yeX5+fnYsmWLpKqMKxqN4pZbbsG4ceNw0kknyS7HcF588UVs2LABa9eulV2KIW3fvh0LFizA3Llz8bvf/Q5r167FnDlzYLfbMWPGDNnlGcbtt9+Ompoa9O/fHxaLBZFIBPfeey+uvPJK2aV1GEMJkQ7MmjULX3zxBT766CPZpRhOeXk5br75ZixduhROp1N2OYYUjUYxYsQI3HfffQCAk08+GV988QWefvpphpI4evnll/GPf/wDS5YswaBBg7Bx40bccsstKCoq0s3jzFBCMcnJyYHFYsHBgwebXH7w4EEUFBRIqsqYZs+ejbfeegsrV65ESUmJ7HIMZ/369Th06BBOOeWUxssikQhWrlyJJ554AoFAABaLRWKF+ldYWIiBAwc2uWzAgAF47bXXJFVkTLfddhtuv/12XH755QCAwYMHY9euXZg/f75uQgnXlFBM7HY7hg8fjuXLlzdeFo1GsXz5cowZM0ZiZcYhhMDs2bPx+uuv47333kOPHj1kl2RIkyZNwubNm7Fx48bGrxEjRuDKK6/Exo0bGUjiYNy4cc22s2/btg1lZWWSKjImr9cLVW36tm6xWBCNRiVV1HkcKaGYzZ07FzNmzMCIESMwatQoPProo6irq8M111wjuzRDmDVrFpYsWYI333wTHo8HBw4cAACkp6fD5XJJrs44PB5Ps3U6KSkpyM7O5vqdOLn11lsxduxY3HffffjJT36CNWvW4Nlnn8Wzzz4ruzRDOf/883HvvfeitLQUgwYNwmeffYaHH34YP/vZz2SX1nGCqAsef/xxUVpaKux2uxg1apRYvXq17JIMA0CLX88//7zs0gxv/Pjx4uabb5ZdhqH87//+rzjppJOEw+EQ/fv3F88++6zskgynpqZG3HzzzaK0tFQ4nU7Rs2dP8fvf/14EAgHZpXUY+5QQERGRJnBNCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJEWnW4cOHUVBQgPvuu6/xsk8++QR2ux3Lly+XWBkRJQJPyEdEmvbvf/8bF110ET755BP069cPw4YNw4UXXoiHH35YdmlEFGcMJUSkebNmzcKyZcswYsQIbN68GWvXroXD4ZBdFhHFGUMJEWmez+fDSSedhPLycqxfvx6DBw+WXRIRJQDXlBCR5n333XfYt28fotEodu7cKbscIkoQjpQQkaYFg0GMGjUKw4YNQ79+/fDoo49i8+bNyMvLk10aEcUZQwkRadptt92GV199FZs2bUJqairGjx+P9PR0vPXWW7JLI6I44/QNEWnW+++/j0cffRSLFy9GWloaVFXF4sWL8eGHH2LBggWyyyOiOONICREREWkCR0qIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBP+P47pALgePnBfAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 800x800 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "vt = Voironi_Tessalation(coreset_df, clusters, colors, tesslation_by_cluster=False)\n",
+    "vt.plot_voironi(plot_title=\"Voironi Tessalation of Coreset using VQE\", show_annotation=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## QAOA Implementation\n",
+    "\n",
+    "CUDA-Q is designed to be a flexible tool for developers so they can test different implementations of the same code. For example, one can perform the same analysis, instead using a QAOA approach. Only the kernel needs to be changed as is done below."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "                                                                             »\n",
+      "q0 : ──●──────────────────●──────────────────────────────────────────────────»\n",
+      "     ╭─┴─╮╭────────────╮╭─┴─╮                                                »\n",
+      "q1 : ┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──────────────────────────»\n",
+      "     ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮                        »\n",
+      "q2 : ────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──»\n",
+      "                             ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮»\n",
+      "q3 : ────────────────────────────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├»\n",
+      "                                                     ╰───╯╰────────────╯╰───╯»\n",
+      "q4 : ────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                             »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                        ╭───╮╭────────────╮╭───╮╭───────────╮\n",
+      "────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├┤ rx(1.111) ├\n",
+      "                        ╰─┬─╯╰────────────╯╰─┬─╯├───────────┤\n",
+      "──────────────────────────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "                          │                  │  ├───────────┤\n",
+      "──────────────────────────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "                          │                  │  ├───────────┤\n",
+      "──●──────────────────●────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "╭─┴─╮╭────────────╮╭─┴─╮  │                  │  ├───────────┤\n",
+      "┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──┤ rx(1.111) ├\n",
+      "╰───╯╰────────────╯╰───╯                        ╰───────────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "def get_QAOA_circuit(number_of_qubits, circuit_depth) -> cudaq.Kernel:\n",
+    "    \"\"\"Returns the QAOA circuit for the given number of qubits and circuit depth\n",
+    "\n",
+    "\n",
+    "    Args:\n",
+    "        number_of_qubits (int): Number of qubits\n",
+    "        circuit_depth (int): Circuit depth\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq.Kernel: QAOA Circuit\n",
+    "    \"\"\"\n",
+    "\n",
+    "    @cudaq.kernel\n",
+    "    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):\n",
+    "        qubits = cudaq.qvector(number_of_qubits)\n",
+    "\n",
+    "        layers = circuit_depth\n",
+    "\n",
+    "        for layer in range(layers):\n",
+    "            for qubit in range(number_of_qubits):\n",
+    "                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])\n",
+    "                rz(2.0 * thetas[layer], qubits[(qubit + 1) % number_of_qubits])\n",
+    "                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])\n",
+    "\n",
+    "            rx(2.0 * thetas[layer + layers], qubits)\n",
+    "\n",
+    "    return kernel\n",
+    "\n",
+    "\n",
+    "circuit = get_QAOA_circuit(5, circuit_depth)\n",
+    "\n",
+    "print(cudaq.draw(circuit, np.random.rand(2 * circuit_depth), 5, circuit_depth))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_optimizer(\n",
+    "    optimizer: cudaq.optimizers.optimizer, max_iterations, **kwargs\n",
+    ") -> Tuple[cudaq.optimizers.optimizer, int]:\n",
+    "    \"\"\"\n",
+    "    Returns the optimizer with the given parameters\n",
+    "\n",
+    "    Args:\n",
+    "        optimizer (cudaq.optimizers.optimizer): Optimizer\n",
+    "        max_iterations (int): Maximum number of iterations\n",
+    "        **kwargs: Additional arguments\n",
+    "\n",
+    "    Returns:\n",
+    "        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count\n",
+    "    \"\"\"\n",
+    "\n",
+    "    parameter_count = 2 * kwargs[\"circuit_depth\"]\n",
+    "    optimizer.initial_parameters = np.random.uniform(-np.pi / 8.0, np.pi / 8.0, parameter_count)\n",
+    "    optimizer.max_iterations = max_iterations\n",
+    "    return optimizer, parameter_count"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 484/484 [00:00<00:00, 12163.89it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00<00:00, 52703.30it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 48/48 [00:00<00:00, 31987.07it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 36393.09it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 37957.50it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 42473.96it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "divisive_clustering = DivisiveClusteringVQA(\n",
+    "    circuit_depth=circuit_depth,\n",
+    "    max_iterations=max_iterations,\n",
+    "    max_shots=max_shots,\n",
+    "    threshold_for_max_cut=0.75,\n",
+    "    create_Hamiltonian=get_K2_Hamiltonian,\n",
+    "    optimizer=optimizer,\n",
+    "    optimizer_function=get_optimizer,\n",
+    "    create_circuit=get_QAOA_circuit,\n",
+    "    normalize_vectors=True,\n",
+    "    sort_by_descending=True,\n",
+    "    coreset_to_graph_metric=\"dist\",\n",
+    ")\n",
+    "\n",
+    "hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Scaling simulations with CUDA-Q\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The University of Edinburgh team quickly encountered scaling challenges when they were developing this method. By developing with CUDA-Q they were able to port their code to an HPC environment once GPUs became available. GPUs massively accelerated their development and testing and allowed them to produce the 25 qubit experiments presented in their publication. If you have a GPU available, run the following code examples and see how the times compare on your device. Each call executes the divisive clustering procedure using the QAOA method, 100000 simulated shots for each VQE loop, and maximum 75 VQE iterations."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "First, try a slightly larger N=18 problem using the CPU (`qpp-cpu`) backend."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Uncomment the following line if you want to explicitly execute this step on your system.\n",
+    "# !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 18"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now try the N=18 example on the GPU backend (`nvidia`)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "100%|███████████████████████████████████████| 751/751 [00:00<00:00, 3460.26it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 42771.74it/s]\n",
+      "100%|█████████████████████████████████████| 4064/4064 [00:00<00:00, 6862.37it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 56871.92it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 44979.13it/s]\n",
+      "100%|██████████████████████████████████████| 128/128 [00:00<00:00, 19366.94it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 53773.13it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 54648.91it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 51941.85it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 56111.09it/s]\n",
+      "Total time for the execution: 461.866833317\n",
+      "Total time spent on CUDA-Q: 10.452308367999706\n"
+     ]
+    }
+   ],
+   "source": [
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 18"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Scaling up to N=25, the task becomes even more onerous on a CPU. Depending on your device, the simulation may not even run. Try it and feel free to interrupt after your patience has worn out."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# target = 'qpp-cpu'\n",
+    "# Uncomment the following line if you want to explicitly execute this step on your system.\n",
+    "# !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 25"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "N=25 can still easily be completed by a single GPU."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "100%|█████████████████████████████████████| 7352/7352 [00:03<00:00, 2063.82it/s]\n",
+      "100%|███████████████████████████████████| 16492/16492 [00:03<00:00, 4739.44it/s]\n",
+      "100%|██████████████████████████████████████| 256/256 [00:00<00:00, 15185.58it/s]\n",
+      "100%|████████████████████████████████████████| 64/64 [00:00<00:00, 23728.05it/s]\n",
+      "100%|██████████████████████████████████████| 256/256 [00:00<00:00, 15437.97it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 50840.05it/s]\n",
+      "100%|████████████████████████████████████████| 32/32 [00:00<00:00, 33562.82it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 54120.05it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 54560.05it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 55924.05it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 42717.29it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 55007.27it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 53601.33it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 47127.01it/s]\n",
+      "Total time for the execution: 67.61674502899999\n",
+      "Total time spent on CUDA-Q: 21.439895901\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia'\n",
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 25"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If we want to push the simulation to an $N=34$ coreset, a single GPU (assuming A100) will run out of memory.  Run the code below to see for yourself. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "RuntimeError: NLOpt runtime error: nlopt failure\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia'\n",
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 34"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To compute a problem with 34 qubits, we need to pool the memory of multiple GPUs.  If you have multiple GPUs available, try the code below to run the same computation on 4 GPUs. You do not need to wait for the code to finish, just note how it does not fail immediately due to memory issues."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "^C\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia-mgpu'\n",
+    "gpu_count = !nvidia-smi -L | wc -l\n",
+    "try:\n",
+    "    gpu_count = int(gpu_count[0])\n",
+    "except:\n",
+    "    gpu_count = 0    \n",
+    "if gpu_count >= 4:\n",
+    "    !mpirun -np 4 python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia-mgpu --M 34\n",
+    "else:\n",
+    "    print(f'Not enough GPUs found on this system ({gpu_count}) to run this step')"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/examples/python/tutorials/H2-MRQKS.html b/pr-2241/examples/python/tutorials/H2-MRQKS.html
new file mode 100644
index 0000000000..345eec99b6
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/H2-MRQKS.html
@@ -0,0 +1,1072 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Multi-Reference Quantum Krylov Algorithm (H2 Example) &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Factoring Integers With Shor’s Algorithm" href="Shors.html" />
+    <link rel="prev" title="Divisive Clustering With Coresets Using CUDA-Q" href="Divisive_clustering.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Multi-Reference Quantum Krylov Algorithm (H2 Example)</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/H2-MRQKS.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="Divisive_clustering.html" class="btn btn-neutral float-left" title="Divisive Clustering With Coresets Using CUDA-Q" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="Shors.html" class="btn btn-neutral float-right" title="Factoring Integers With Shor’s Algorithm" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Multi-Reference-Quantum-Krylov-Algorithm-(H2-Example)">
+<h1>Multi-Reference Quantum Krylov Algorithm (H2 Example)<a class="headerlink" href="#Multi-Reference-Quantum-Krylov-Algorithm-(H2-Example)" title="Permalink to this heading">¶</a></h1>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Package installs</span>
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">pyscf</span><span class="o">==</span><span class="m">2</span>.6.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">openfermionpyscf</span><span class="o">==</span><span class="m">0</span>.5
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">openfermion</span><span class="o">==</span><span class="m">1</span>.6.1
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">scipy</span>
+
+<span class="c1"># Single-node, single gpu</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+<span class="n">multi_gpu</span> <span class="o">=</span> <span class="kc">False</span>
+
+<span class="c1"># Single-node, multi-GPU</span>
+<span class="c1">#cudaq.set_target(&quot;nvidia&quot;, option=&#39;mqpu,fp64&#39;)</span>
+<span class="c1">#multi_gpu = True</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define H2 molecule</span>
+<span class="n">geometry</span> <span class="o">=</span> <span class="p">[(</span><span class="s1">&#39;H&#39;</span><span class="p">,</span> <span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">)),</span> <span class="p">(</span><span class="s1">&#39;H&#39;</span><span class="p">,</span> <span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.7474</span><span class="p">))]</span>
+
+<span class="n">hamiltonian</span><span class="p">,</span> <span class="n">data</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">chemistry</span><span class="o">.</span><span class="n">create_molecular_hamiltonian</span><span class="p">(</span>
+    <span class="n">geometry</span><span class="p">,</span> <span class="s1">&#39;sto-3g&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
+
+<span class="n">electron_count</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">n_electrons</span>
+<span class="n">qubits_num</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">data</span><span class="o">.</span><span class="n">n_orbitals</span>
+
+<span class="n">spin_ham_matrix</span> <span class="o">=</span> <span class="n">hamiltonian</span><span class="o">.</span><span class="n">to_matrix</span><span class="p">()</span>
+<span class="n">e</span><span class="p">,</span> <span class="n">c</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">eig</span><span class="p">(</span><span class="n">spin_ham_matrix</span><span class="p">)</span>
+
+<span class="c1"># Find the ground state energy and the corresponding eigenvector</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Ground state energy (classical simulation)= &#39;</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">min</span><span class="p">(</span><span class="n">e</span><span class="p">),</span> <span class="s1">&#39;, index= &#39;</span><span class="p">,</span>
+      <span class="n">np</span><span class="o">.</span><span class="n">argmin</span><span class="p">(</span><span class="n">e</span><span class="p">))</span>
+<span class="n">min_indices</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">argmin</span><span class="p">(</span><span class="n">e</span><span class="p">)</span>
+
+<span class="c1"># Eigen vector can be used to initialize the qubits</span>
+<span class="n">vec</span> <span class="o">=</span> <span class="n">c</span><span class="p">[:,</span> <span class="n">min_indices</span><span class="p">]</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Ground state energy (classical simulation)=  (-1.1371757102406843+0j) , index=  3
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Collect coefficients from a spin operator so we can pass them to a kernel</span>
+<span class="k">def</span> <span class="nf">termCoefficients</span><span class="p">(</span><span class="n">ham</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">]:</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="n">ham</span><span class="o">.</span><span class="n">for_each_term</span><span class="p">(</span><span class="k">lambda</span> <span class="n">term</span><span class="p">:</span> <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">term</span><span class="o">.</span><span class="n">get_coefficient</span><span class="p">()))</span>
+    <span class="k">return</span> <span class="n">result</span>
+
+
+<span class="c1"># Collect Pauli words from a spin operator so we can pass them to a kernel</span>
+<span class="k">def</span> <span class="nf">termWords</span><span class="p">(</span><span class="n">ham</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="n">ham</span><span class="o">.</span><span class="n">for_each_term</span><span class="p">(</span><span class="k">lambda</span> <span class="n">term</span><span class="p">:</span> <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">term</span><span class="o">.</span><span class="n">to_string</span><span class="p">(</span><span class="kc">False</span><span class="p">)))</span>
+    <span class="k">return</span> <span class="n">result</span>
+
+
+<span class="n">coefficient</span> <span class="o">=</span> <span class="n">termCoefficients</span><span class="p">(</span><span class="n">hamiltonian</span><span class="p">)</span>
+<span class="n">pauli_string</span> <span class="o">=</span> <span class="n">termWords</span><span class="p">(</span><span class="n">hamiltonian</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">U_psi</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">dt</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">coefficients</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">],</span>
+          <span class="n">words</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">pauli_word</span><span class="p">]):</span>
+    <span class="c1"># Compute U_m = exp(-i m dt H)</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">coefficients</span><span class="p">)):</span>
+        <span class="n">exp_pauli</span><span class="p">(</span><span class="n">dt</span> <span class="o">*</span> <span class="n">coefficients</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">real</span><span class="p">,</span> <span class="n">qubits</span><span class="p">,</span> <span class="n">words</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">U_phi</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">dt</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">coefficients</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">],</span>
+          <span class="n">words</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">pauli_word</span><span class="p">]):</span>
+    <span class="c1"># Compute U_n = exp(-i n dt H)</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">coefficients</span><span class="p">)):</span>
+        <span class="n">exp_pauli</span><span class="p">(</span><span class="n">dt</span> <span class="o">*</span> <span class="n">coefficients</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">real</span><span class="p">,</span> <span class="n">qubits</span><span class="p">,</span> <span class="n">words</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">apply_pauli</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">word</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+
+    <span class="c1"># Add H (Hamiltonian operator)</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">word</span><span class="p">)):</span>
+        <span class="k">if</span> <span class="n">word</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="k">if</span> <span class="n">word</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
+            <span class="n">y</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="k">if</span> <span class="n">word</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">==</span> <span class="mi">3</span><span class="p">:</span>
+            <span class="n">z</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">qfd_kernel</span><span class="p">(</span><span class="n">dt_alpha</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">dt_beta</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">coefficients</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">],</span>
+               <span class="n">words</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">pauli_word</span><span class="p">],</span> <span class="n">word_list</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+               <span class="n">vec</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">]):</span>
+
+    <span class="n">ancilla</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">qreg</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">vec</span><span class="p">)</span>
+
+    <span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+
+    <span class="n">x</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">U_psi</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">qreg</span><span class="p">,</span> <span class="n">dt_alpha</span><span class="p">,</span> <span class="n">coefficients</span><span class="p">,</span> <span class="n">words</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">apply_pauli</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">qreg</span><span class="p">,</span> <span class="n">word_list</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">U_phi</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">qreg</span><span class="p">,</span> <span class="n">dt_beta</span><span class="p">,</span> <span class="n">coefficients</span><span class="p">,</span> <span class="n">words</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">pauli_str</span><span class="p">(</span><span class="n">pauli_word</span><span class="p">,</span> <span class="n">qubits_num</span><span class="p">):</span>
+
+    <span class="n">my_list</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubits_num</span><span class="p">):</span>
+        <span class="k">if</span> <span class="nb">str</span><span class="p">(</span><span class="n">pauli_word</span><span class="p">[</span><span class="n">i</span><span class="p">])</span> <span class="o">==</span> <span class="s1">&#39;I&#39;</span><span class="p">:</span>
+            <span class="n">my_list</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+        <span class="k">if</span> <span class="nb">str</span><span class="p">(</span><span class="n">pauli_word</span><span class="p">[</span><span class="n">i</span><span class="p">])</span> <span class="o">==</span> <span class="s1">&#39;X&#39;</span><span class="p">:</span>
+            <span class="n">my_list</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+        <span class="k">if</span> <span class="nb">str</span><span class="p">(</span><span class="n">pauli_word</span><span class="p">[</span><span class="n">i</span><span class="p">])</span> <span class="o">==</span> <span class="s1">&#39;Y&#39;</span><span class="p">:</span>
+            <span class="n">my_list</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+        <span class="k">if</span> <span class="nb">str</span><span class="p">(</span><span class="n">pauli_word</span><span class="p">[</span><span class="n">i</span><span class="p">])</span> <span class="o">==</span> <span class="s1">&#39;Z&#39;</span><span class="p">:</span>
+            <span class="n">my_list</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">my_list</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the spin-op x for real component and y for the imaginary component.</span>
+
+<span class="n">x_0</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+<span class="n">y_0</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1">#Define parameters for the quantum Krylov space</span>
+
+<span class="n">dt</span> <span class="o">=</span> <span class="mf">0.5</span>
+
+<span class="c1"># Dimension of the Krylov space</span>
+<span class="n">m_qfd</span> <span class="o">=</span> <span class="mi">4</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Compute the basis overlap matrix</span>
+
+
+<span class="c1">## Single GPU:</span>
+<span class="k">if</span> <span class="ow">not</span> <span class="n">multi_gpu</span><span class="p">:</span>
+
+    <span class="c1"># Add identity operator to compute overlap of basis</span>
+
+    <span class="n">observe_op</span> <span class="o">=</span> <span class="mf">1.0</span>
+    <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubits_num</span><span class="p">):</span>
+        <span class="n">observe_op</span> <span class="o">*=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">m</span><span class="p">)</span>
+
+    <span class="n">identity_word</span> <span class="o">=</span> <span class="n">observe_op</span><span class="o">.</span><span class="n">to_string</span><span class="p">(</span><span class="kc">False</span><span class="p">)</span>
+
+    <span class="n">pauli_list</span> <span class="o">=</span> <span class="n">pauli_str</span><span class="p">(</span><span class="n">identity_word</span><span class="p">,</span> <span class="n">qubits_num</span><span class="p">)</span>
+    <span class="c1">#print(pauli_list)</span>
+
+    <span class="n">wf_overlap</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">m_qfd</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+
+    <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m_qfd</span><span class="p">):</span>
+        <span class="n">dt_m</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">m</span>
+        <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">):</span>
+            <span class="n">dt_n</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">n</span>
+            <span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">qfd_kernel</span><span class="p">,</span> <span class="p">[</span><span class="n">x_0</span><span class="p">,</span> <span class="n">y_0</span><span class="p">],</span> <span class="n">dt_m</span><span class="p">,</span> <span class="n">dt_n</span><span class="p">,</span>
+                                    <span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">,</span> <span class="n">pauli_list</span><span class="p">,</span> <span class="n">vec</span><span class="p">)</span>
+            <span class="n">temp</span> <span class="o">=</span> <span class="p">[</span><span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span> <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">results</span><span class="p">]</span>
+            <span class="n">wf_overlap</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">]</span> <span class="o">=</span> <span class="n">temp</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+</span> <span class="n">temp</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="mi">1</span><span class="n">j</span>
+            <span class="k">if</span> <span class="n">n</span> <span class="o">!=</span> <span class="n">m</span><span class="p">:</span>
+                <span class="n">wf_overlap</span><span class="p">[</span><span class="n">n</span><span class="p">,</span> <span class="n">m</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">conj</span><span class="p">(</span><span class="n">wf_overlap</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">])</span>
+
+<span class="k">else</span><span class="p">:</span>
+
+    <span class="c1">## Multi-GPU</span>
+
+    <span class="c1"># Compute the basis overlap matrix</span>
+
+    <span class="c1"># Add identity operator to compute overlap of basis</span>
+
+    <span class="n">observe_op</span> <span class="o">=</span> <span class="mf">1.0</span>
+    <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubits_num</span><span class="p">):</span>
+        <span class="n">observe_op</span> <span class="o">*=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">m</span><span class="p">)</span>
+
+    <span class="n">identity_word</span> <span class="o">=</span> <span class="n">observe_op</span><span class="o">.</span><span class="n">to_string</span><span class="p">(</span><span class="kc">False</span><span class="p">)</span>
+
+    <span class="n">pauli_list</span> <span class="o">=</span> <span class="n">pauli_str</span><span class="p">(</span><span class="n">identity_word</span><span class="p">,</span> <span class="n">qubits_num</span><span class="p">)</span>
+    <span class="c1">#print(pauli_list)</span>
+
+    <span class="n">wf_overlap</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">m_qfd</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+
+    <span class="n">collect_overlap_real</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="n">collect_overlap_img</span> <span class="o">=</span> <span class="p">[]</span>
+
+    <span class="n">count</span><span class="o">=</span><span class="mi">0</span>
+    <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m_qfd</span><span class="p">):</span>
+        <span class="n">dt_m</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">m</span>
+        <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">):</span>
+            <span class="n">dt_n</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">n</span>
+
+            <span class="n">count_id</span><span class="o">=</span><span class="n">count</span><span class="o">%</span><span class="k">2</span>
+            <span class="c1">#print(count_id)</span>
+            <span class="n">collect_overlap_real</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">qfd_kernel</span><span class="p">,</span> <span class="n">x_0</span><span class="p">,</span> <span class="n">dt_m</span><span class="p">,</span> <span class="n">dt_n</span><span class="p">,</span>
+                                    <span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">,</span> <span class="n">pauli_list</span><span class="p">,</span> <span class="n">vec</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">count_id</span><span class="p">))</span>
+
+            <span class="n">collect_overlap_img</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">qfd_kernel</span><span class="p">,</span> <span class="n">y_0</span><span class="p">,</span> <span class="n">dt_m</span><span class="p">,</span> <span class="n">dt_n</span><span class="p">,</span>
+                                    <span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">,</span> <span class="n">pauli_list</span><span class="p">,</span> <span class="n">vec</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">count_id</span><span class="o">+</span><span class="mi">2</span><span class="p">))</span>
+            <span class="n">count</span> <span class="o">+=</span> <span class="mi">1</span>
+
+    <span class="n">tot_dim</span> <span class="o">=</span> <span class="mi">0</span>
+
+    <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m_qfd</span><span class="p">):</span>
+        <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n</span><span class="p">,</span><span class="n">m_qfd</span><span class="p">):</span>
+            <span class="n">observe_result</span> <span class="o">=</span> <span class="n">collect_overlap_real</span><span class="p">[</span><span class="n">tot_dim</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+            <span class="n">real_val</span> <span class="o">=</span> <span class="n">observe_result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+            <span class="n">observe_result</span><span class="o">=</span><span class="n">collect_overlap_img</span><span class="p">[</span><span class="n">tot_dim</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+            <span class="n">img_val</span><span class="o">=</span><span class="n">observe_result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+            <span class="n">wf_overlap</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">]</span> <span class="o">=</span> <span class="n">real_val</span> <span class="o">+</span> <span class="n">img_val</span> <span class="o">*</span> <span class="mi">1</span><span class="n">j</span>
+            <span class="k">if</span> <span class="n">n</span> <span class="o">!=</span> <span class="n">m</span><span class="p">:</span>
+                <span class="n">wf_overlap</span><span class="p">[</span><span class="n">n</span><span class="p">,</span> <span class="n">m</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">conj</span><span class="p">(</span><span class="n">wf_overlap</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">])</span>
+
+            <span class="n">tot_dim</span> <span class="o">+=</span> <span class="mi">1</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Compute the matrix Hamiltonian</span>
+
+
+<span class="c1">## Single GPU:</span>
+<span class="k">if</span> <span class="ow">not</span> <span class="n">multi_gpu</span><span class="p">:</span>
+    <span class="n">ham_matrx</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">m_qfd</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+
+    <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m_qfd</span><span class="p">):</span>
+        <span class="n">dt_m</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">m</span>
+        <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">):</span>
+            <span class="n">dt_n</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">n</span>
+
+            <span class="n">tot_e</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+            <span class="k">for</span> <span class="n">coef</span><span class="p">,</span> <span class="n">word</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">):</span>
+                <span class="c1">#print(coef,word)</span>
+
+                <span class="n">pauli_list</span> <span class="o">=</span> <span class="n">pauli_str</span><span class="p">(</span><span class="n">word</span><span class="p">,</span> <span class="n">qubits_num</span><span class="p">)</span>
+                <span class="c1">#print(pauli_list)</span>
+
+                <span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">qfd_kernel</span><span class="p">,</span> <span class="p">[</span><span class="n">x_0</span><span class="p">,</span> <span class="n">y_0</span><span class="p">],</span> <span class="n">dt_m</span><span class="p">,</span> <span class="n">dt_n</span><span class="p">,</span>
+                                        <span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">,</span> <span class="n">pauli_list</span><span class="p">,</span> <span class="n">vec</span><span class="p">)</span>
+
+                <span class="n">temp</span> <span class="o">=</span> <span class="p">[</span><span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span> <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">results</span><span class="p">]</span>
+                <span class="c1">#print(temp)</span>
+                <span class="n">temp</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">=</span> <span class="n">coef</span><span class="o">.</span><span class="n">real</span> <span class="o">*</span> <span class="n">temp</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+                <span class="n">temp</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">=</span> <span class="n">coef</span><span class="o">.</span><span class="n">imag</span> <span class="o">*</span> <span class="n">temp</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
+
+                <span class="n">tot_e</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+=</span> <span class="n">temp</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+                <span class="n">tot_e</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">+=</span> <span class="n">temp</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
+
+            <span class="n">ham_matrx</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">]</span> <span class="o">=</span> <span class="n">tot_e</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+</span> <span class="n">tot_e</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="mi">1</span><span class="n">j</span>
+            <span class="k">if</span> <span class="n">n</span> <span class="o">!=</span> <span class="n">m</span><span class="p">:</span>
+                <span class="n">ham_matrx</span><span class="p">[</span><span class="n">n</span><span class="p">,</span> <span class="n">m</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">conj</span><span class="p">(</span><span class="n">ham_matrx</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">])</span>
+<span class="k">else</span><span class="p">:</span>
+    <span class="c1">## Multi-GPU</span>
+
+    <span class="n">ham_matrx</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">m_qfd</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+
+
+    <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m_qfd</span><span class="p">):</span>
+        <span class="n">dt_m</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">m</span>
+        <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">m</span><span class="p">,</span> <span class="n">m_qfd</span><span class="p">):</span>
+            <span class="n">dt_n</span> <span class="o">=</span> <span class="n">dt</span> <span class="o">*</span> <span class="n">n</span>
+
+            <span class="n">ham_matrix_real</span> <span class="o">=</span> <span class="p">[]</span>
+            <span class="n">ham_matrix_imag</span> <span class="o">=</span> <span class="p">[]</span>
+
+            <span class="n">count</span><span class="o">=</span><span class="mi">0</span>
+            <span class="n">tot_e</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+            <span class="k">for</span> <span class="n">coef</span><span class="p">,</span> <span class="n">word</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">):</span>
+                <span class="n">count_id</span><span class="o">=</span><span class="n">count</span><span class="o">%</span><span class="k">2</span>
+                <span class="c1">#print(coef,word)</span>
+
+                <span class="n">pauli_list</span> <span class="o">=</span> <span class="n">pauli_str</span><span class="p">(</span><span class="n">word</span><span class="p">,</span> <span class="n">qubits_num</span><span class="p">)</span>
+                <span class="c1">#print(pauli_list)</span>
+
+                <span class="n">ham_matrix_real</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">qfd_kernel</span><span class="p">,</span> <span class="n">x_0</span><span class="p">,</span> <span class="n">dt_m</span><span class="p">,</span> <span class="n">dt_n</span><span class="p">,</span>
+                                        <span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">,</span> <span class="n">pauli_list</span><span class="p">,</span> <span class="n">vec</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">count_id</span><span class="p">))</span>
+                <span class="n">ham_matrix_imag</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">qfd_kernel</span><span class="p">,</span> <span class="n">y_0</span><span class="p">,</span> <span class="n">dt_m</span><span class="p">,</span> <span class="n">dt_n</span><span class="p">,</span>
+                                        <span class="n">coefficient</span><span class="p">,</span> <span class="n">pauli_string</span><span class="p">,</span> <span class="n">pauli_list</span><span class="p">,</span> <span class="n">vec</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">count_id</span><span class="o">+</span><span class="mi">2</span><span class="p">))</span>
+
+                <span class="n">count</span> <span class="o">+=</span> <span class="mi">1</span>
+
+            <span class="n">i</span> <span class="o">=</span> <span class="mi">0</span>
+            <span class="k">for</span> <span class="n">coef</span> <span class="ow">in</span> <span class="n">coefficient</span><span class="p">:</span>
+
+                <span class="n">observe_result</span> <span class="o">=</span> <span class="n">ham_matrix_real</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+                <span class="n">real_val</span> <span class="o">=</span> <span class="n">observe_result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+                <span class="n">observe_result</span><span class="o">=</span><span class="n">ham_matrix_imag</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+                <span class="n">img_val</span><span class="o">=</span><span class="n">observe_result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+                <span class="n">tot_e</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+=</span> <span class="n">real_val</span> <span class="o">*</span> <span class="n">coef</span><span class="o">.</span><span class="n">real</span>
+                <span class="n">tot_e</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">+=</span> <span class="n">img_val</span> <span class="o">*</span> <span class="n">coef</span><span class="o">.</span><span class="n">imag</span>
+
+                <span class="n">i</span><span class="o">+=</span><span class="mi">1</span>
+
+            <span class="n">ham_matrx</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">]</span> <span class="o">=</span> <span class="n">tot_e</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+</span> <span class="n">tot_e</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="mi">1</span><span class="n">j</span>
+            <span class="k">if</span> <span class="n">n</span> <span class="o">!=</span> <span class="n">m</span><span class="p">:</span>
+                <span class="n">ham_matrx</span><span class="p">[</span><span class="n">n</span><span class="p">,</span> <span class="n">m</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">conj</span><span class="p">(</span><span class="n">ham_matrx</span><span class="p">[</span><span class="n">m</span><span class="p">,</span> <span class="n">n</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Diagonalize the matrix</span>
+
+
+<span class="k">def</span> <span class="nf">eig</span><span class="p">(</span><span class="n">H</span><span class="p">,</span> <span class="n">s</span><span class="p">):</span>
+    <span class="c1">#Solver for generalized eigenvalue problem</span>
+
+    <span class="c1"># HC = SCE</span>
+
+    <span class="n">THRESHOLD</span> <span class="o">=</span> <span class="mf">1e-20</span>
+    <span class="n">s_diag</span><span class="p">,</span> <span class="n">u</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">eig</span><span class="p">(</span><span class="n">s</span><span class="p">)</span>
+    <span class="n">s_prime</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">sii</span> <span class="ow">in</span> <span class="n">s_diag</span><span class="p">:</span>
+        <span class="k">if</span> <span class="n">np</span><span class="o">.</span><span class="n">imag</span><span class="p">(</span><span class="n">sii</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mf">1e-7</span><span class="p">:</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+                <span class="s2">&quot;S may not be hermitian, large imag. eval component.&quot;</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">np</span><span class="o">.</span><span class="n">real</span><span class="p">(</span><span class="n">sii</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">THRESHOLD</span><span class="p">:</span>
+            <span class="n">s_prime</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">real</span><span class="p">(</span><span class="n">sii</span><span class="p">))</span>
+
+    <span class="n">X_prime</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="nb">len</span><span class="p">(</span><span class="n">s_diag</span><span class="p">),</span> <span class="nb">len</span><span class="p">(</span><span class="n">s_prime</span><span class="p">)),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">complex</span><span class="p">)</span>
+
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">s_diag</span><span class="p">)):</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">s_prime</span><span class="p">)):</span>
+            <span class="n">X_prime</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="n">j</span><span class="p">]</span> <span class="o">=</span> <span class="n">u</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="n">j</span><span class="p">]</span> <span class="o">/</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="n">s_prime</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+
+    <span class="n">H_prime</span> <span class="o">=</span> <span class="p">(((</span><span class="n">X_prime</span><span class="o">.</span><span class="n">conjugate</span><span class="p">())</span><span class="o">.</span><span class="n">transpose</span><span class="p">())</span><span class="o">.</span><span class="n">dot</span><span class="p">(</span><span class="n">H</span><span class="p">))</span><span class="o">.</span><span class="n">dot</span><span class="p">(</span><span class="n">X_prime</span><span class="p">)</span>
+    <span class="n">e_prime</span><span class="p">,</span> <span class="n">C_prime</span> <span class="o">=</span> <span class="n">scipy</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">eig</span><span class="p">(</span><span class="n">H_prime</span><span class="p">)</span>
+    <span class="n">C</span> <span class="o">=</span> <span class="n">X_prime</span><span class="o">.</span><span class="n">dot</span><span class="p">(</span><span class="n">C_prime</span><span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">e_prime</span><span class="p">,</span> <span class="n">C</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[12]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">eigen_value</span><span class="p">,</span> <span class="n">eigen_vect</span> <span class="o">=</span> <span class="n">eig</span><span class="p">(</span><span class="n">ham_matrx</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="n">m_qfd</span><span class="p">,</span> <span class="mi">0</span><span class="p">:</span><span class="n">m_qfd</span><span class="p">],</span> <span class="n">wf_overlap</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="n">m_qfd</span><span class="p">,</span>
+                                                                      <span class="mi">0</span><span class="p">:</span><span class="n">m_qfd</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Energy from QFD:&#39;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">min</span><span class="p">(</span><span class="n">eigen_value</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Energy from QFD:
+(-1.1367554712424826+3.373828079812224e-20j)
+</pre></div></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="Divisive_clustering.html" class="btn btn-neutral float-left" title="Divisive Clustering With Coresets Using CUDA-Q" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="Shors.html" class="btn btn-neutral float-right" title="Factoring Integers With Shor’s Algorithm" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/H2-MRQKS.ipynb b/pr-2241/examples/python/tutorials/H2-MRQKS.ipynb
new file mode 100644
index 0000000000..f919d08673
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/H2-MRQKS.ipynb
@@ -0,0 +1,458 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Multi-Reference Quantum Krylov Algorithm (H2 Example)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Package installs\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermionpyscf==0.5\n",
+    "!pip install openfermion==1.6.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "import scipy\n",
+    "\n",
+    "# Single-node, single gpu\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "multi_gpu = False\n",
+    "\n",
+    "# Single-node, multi-GPU\n",
+    "#cudaq.set_target(\"nvidia\", option='mqpu,fp64')\n",
+    "#multi_gpu = True\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Ground state energy (classical simulation)=  (-1.1371757102406843+0j) , index=  3\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Define H2 molecule\n",
+    "geometry = [('H', (0.0, 0.0, 0.0)), ('H', (0.0, 0.0, 0.7474))]\n",
+    "\n",
+    "hamiltonian, data = cudaq.chemistry.create_molecular_hamiltonian(\n",
+    "    geometry, 'sto-3g', 1, 0)\n",
+    "\n",
+    "electron_count = data.n_electrons\n",
+    "qubits_num = 2 * data.n_orbitals\n",
+    "\n",
+    "spin_ham_matrix = hamiltonian.to_matrix()\n",
+    "e, c = np.linalg.eig(spin_ham_matrix)\n",
+    "\n",
+    "# Find the ground state energy and the corresponding eigenvector\n",
+    "print('Ground state energy (classical simulation)= ', np.min(e), ', index= ',\n",
+    "      np.argmin(e))\n",
+    "min_indices = np.argmin(e)\n",
+    "\n",
+    "# Eigen vector can be used to initialize the qubits\n",
+    "vec = c[:, min_indices]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Collect coefficients from a spin operator so we can pass them to a kernel\n",
+    "def termCoefficients(ham: cudaq.SpinOperator) -> list[complex]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.get_coefficient()))\n",
+    "    return result\n",
+    "\n",
+    "\n",
+    "# Collect Pauli words from a spin operator so we can pass them to a kernel\n",
+    "def termWords(ham: cudaq.SpinOperator) -> list[str]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.to_string(False)))\n",
+    "    return result\n",
+    "\n",
+    "\n",
+    "coefficient = termCoefficients(hamiltonian)\n",
+    "pauli_string = termWords(hamiltonian)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def U_psi(qubits: cudaq.qview, dt: float, coefficients: list[complex],\n",
+    "          words: list[cudaq.pauli_word]):\n",
+    "    # Compute U_m = exp(-i m dt H)\n",
+    "    for i in range(len(coefficients)):\n",
+    "        exp_pauli(dt * coefficients[i].real, qubits, words[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def U_phi(qubits: cudaq.qview, dt: float, coefficients: list[complex],\n",
+    "          words: list[cudaq.pauli_word]):\n",
+    "    # Compute U_n = exp(-i n dt H)\n",
+    "    for i in range(len(coefficients)):\n",
+    "        exp_pauli(dt * coefficients[i].real, qubits, words[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def apply_pauli(qubits: cudaq.qview, word: list[int]):\n",
+    "\n",
+    "    # Add H (Hamiltonian operator)\n",
+    "    for i in range(len(word)):\n",
+    "        if word[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "        if word[i] == 2:\n",
+    "            y(qubits[i])\n",
+    "        if word[i] == 3:\n",
+    "            z(qubits[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def qfd_kernel(dt_alpha: float, dt_beta: float, coefficients: list[complex],\n",
+    "               words: list[cudaq.pauli_word], word_list: list[int],\n",
+    "               vec: list[complex]):\n",
+    "\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    qreg = cudaq.qvector(vec)\n",
+    "\n",
+    "    h(ancilla)\n",
+    "\n",
+    "    x(ancilla)\n",
+    "    cudaq.control(U_psi, ancilla, qreg, dt_alpha, coefficients, words)\n",
+    "    x(ancilla)\n",
+    "\n",
+    "    cudaq.control(apply_pauli, ancilla, qreg, word_list)\n",
+    "    cudaq.control(U_phi, ancilla, qreg, dt_beta, coefficients, words)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def pauli_str(pauli_word, qubits_num):\n",
+    "\n",
+    "    my_list = []\n",
+    "    for i in range(qubits_num):\n",
+    "        if str(pauli_word[i]) == 'I':\n",
+    "            my_list.append(0)\n",
+    "        if str(pauli_word[i]) == 'X':\n",
+    "            my_list.append(1)\n",
+    "        if str(pauli_word[i]) == 'Y':\n",
+    "            my_list.append(2)\n",
+    "        if str(pauli_word[i]) == 'Z':\n",
+    "            my_list.append(3)\n",
+    "    return my_list"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define the spin-op x for real component and y for the imaginary component.\n",
+    "\n",
+    "x_0 = cudaq.spin.x(0)\n",
+    "y_0 = cudaq.spin.y(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#Define parameters for the quantum Krylov space\n",
+    "\n",
+    "dt = 0.5\n",
+    "\n",
+    "# Dimension of the Krylov space\n",
+    "m_qfd = 4"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Compute the basis overlap matrix\n",
+    "\n",
+    "\n",
+    "## Single GPU:\n",
+    "if not multi_gpu:\n",
+    "\n",
+    "    # Add identity operator to compute overlap of basis\n",
+    "\n",
+    "    observe_op = 1.0\n",
+    "    for m in range(qubits_num):\n",
+    "        observe_op *= cudaq.spin.i(m)\n",
+    "\n",
+    "    identity_word = observe_op.to_string(False)\n",
+    "\n",
+    "    pauli_list = pauli_str(identity_word, qubits_num)\n",
+    "    #print(pauli_list)\n",
+    "\n",
+    "    wf_overlap = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "            results = cudaq.observe(qfd_kernel, [x_0, y_0], dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec)\n",
+    "            temp = [result.expectation() for result in results]\n",
+    "            wf_overlap[m, n] = temp[0] + temp[1] * 1j\n",
+    "            if n != m:\n",
+    "                wf_overlap[n, m] = np.conj(wf_overlap[m, n])\n",
+    "\n",
+    "else:\n",
+    "\n",
+    "    ## Multi-GPU\n",
+    "\n",
+    "    # Compute the basis overlap matrix\n",
+    "\n",
+    "    # Add identity operator to compute overlap of basis\n",
+    "\n",
+    "    observe_op = 1.0\n",
+    "    for m in range(qubits_num):\n",
+    "        observe_op *= cudaq.spin.i(m)\n",
+    "\n",
+    "    identity_word = observe_op.to_string(False)\n",
+    "\n",
+    "    pauli_list = pauli_str(identity_word, qubits_num)\n",
+    "    #print(pauli_list)\n",
+    "\n",
+    "    wf_overlap = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    collect_overlap_real = []\n",
+    "    collect_overlap_img = []\n",
+    "\n",
+    "    count=0\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "            \n",
+    "            count_id=count%2\n",
+    "            #print(count_id)\n",
+    "            collect_overlap_real.append(cudaq.observe_async(qfd_kernel, x_0, dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec, qpu_id=count_id))\n",
+    "            \n",
+    "            collect_overlap_img.append(cudaq.observe_async(qfd_kernel, y_0, dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec, qpu_id=count_id+2))\n",
+    "            count += 1\n",
+    "\n",
+    "    tot_dim = 0\n",
+    "\n",
+    "    for n in range(m_qfd):\n",
+    "        for m in range(n,m_qfd):\n",
+    "            observe_result = collect_overlap_real[tot_dim].get()\n",
+    "            real_val = observe_result.expectation()  \n",
+    "        \n",
+    "            observe_result=collect_overlap_img[tot_dim].get()\n",
+    "            img_val=observe_result.expectation() \n",
+    "        \n",
+    "            wf_overlap[m, n] = real_val + img_val * 1j\n",
+    "            if n != m:\n",
+    "                wf_overlap[n, m] = np.conj(wf_overlap[m, n])\n",
+    "            \n",
+    "            tot_dim += 1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Compute the matrix Hamiltonian\n",
+    "\n",
+    "\n",
+    "## Single GPU:\n",
+    "if not multi_gpu:\n",
+    "    ham_matrx = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "\n",
+    "            tot_e = np.zeros(2)\n",
+    "            for coef, word in zip(coefficient, pauli_string):\n",
+    "                #print(coef,word)\n",
+    "\n",
+    "                pauli_list = pauli_str(word, qubits_num)\n",
+    "                #print(pauli_list)\n",
+    "\n",
+    "                results = cudaq.observe(qfd_kernel, [x_0, y_0], dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec)\n",
+    "\n",
+    "                temp = [result.expectation() for result in results]\n",
+    "                #print(temp)\n",
+    "                temp[0] = coef.real * temp[0]\n",
+    "                temp[1] = coef.imag * temp[1]\n",
+    "\n",
+    "                tot_e[0] += temp[0]\n",
+    "                tot_e[1] += temp[1]\n",
+    "\n",
+    "            ham_matrx[m, n] = tot_e[0] + tot_e[1] * 1j\n",
+    "            if n != m:\n",
+    "                ham_matrx[n, m] = np.conj(ham_matrx[m, n])\n",
+    "else:\n",
+    "    ## Multi-GPU\n",
+    "\n",
+    "    ham_matrx = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "\n",
+    "            ham_matrix_real = []\n",
+    "            ham_matrix_imag = []\n",
+    "            \n",
+    "            count=0\n",
+    "            tot_e = np.zeros(2)\n",
+    "            for coef, word in zip(coefficient, pauli_string):\n",
+    "                count_id=count%2\n",
+    "                #print(coef,word)\n",
+    "\n",
+    "                pauli_list = pauli_str(word, qubits_num)\n",
+    "                #print(pauli_list)\n",
+    "\n",
+    "                ham_matrix_real.append(cudaq.observe_async(qfd_kernel, x_0, dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec, qpu_id=count_id))\n",
+    "                ham_matrix_imag.append(cudaq.observe_async(qfd_kernel, y_0, dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec, qpu_id=count_id+2))\n",
+    "\n",
+    "                count += 1\n",
+    "            \n",
+    "            i = 0\n",
+    "            for coef in coefficient:\n",
+    "                \n",
+    "                observe_result = ham_matrix_real[i].get()\n",
+    "                real_val = observe_result.expectation()  \n",
+    "        \n",
+    "                observe_result=ham_matrix_imag[i].get()\n",
+    "                img_val=observe_result.expectation() \n",
+    "                \n",
+    "                tot_e[0] += real_val * coef.real \n",
+    "                tot_e[1] += img_val * coef.imag\n",
+    "                \n",
+    "                i+=1\n",
+    "            \n",
+    "            ham_matrx[m, n] = tot_e[0] + tot_e[1] * 1j\n",
+    "            if n != m:\n",
+    "                ham_matrx[n, m] = np.conj(ham_matrx[m, n])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Diagonalize the matrix\n",
+    "\n",
+    "\n",
+    "def eig(H, s):\n",
+    "    #Solver for generalized eigenvalue problem\n",
+    "\n",
+    "    # HC = SCE\n",
+    "\n",
+    "    THRESHOLD = 1e-20\n",
+    "    s_diag, u = scipy.linalg.eig(s)\n",
+    "    s_prime = []\n",
+    "    for sii in s_diag:\n",
+    "        if np.imag(sii) > 1e-7:\n",
+    "            raise ValueError(\n",
+    "                \"S may not be hermitian, large imag. eval component.\")\n",
+    "        if np.real(sii) > THRESHOLD:\n",
+    "            s_prime.append(np.real(sii))\n",
+    "\n",
+    "    X_prime = np.zeros((len(s_diag), len(s_prime)), dtype=complex)\n",
+    "\n",
+    "    for i in range(len(s_diag)):\n",
+    "        for j in range(len(s_prime)):\n",
+    "            X_prime[i][j] = u[i][j] / np.sqrt(s_prime[j])\n",
+    "\n",
+    "    H_prime = (((X_prime.conjugate()).transpose()).dot(H)).dot(X_prime)\n",
+    "    e_prime, C_prime = scipy.linalg.eig(H_prime)\n",
+    "    C = X_prime.dot(C_prime)\n",
+    "\n",
+    "    return e_prime, C"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Energy from QFD:\n",
+      "(-1.1367554712424826+3.373828079812224e-20j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "eigen_value, eigen_vect = eig(ham_matrx[0:m_qfd, 0:m_qfd], wf_overlap[0:m_qfd,\n",
+    "                                                                      0:m_qfd])\n",
+    "print('Energy from QFD:')\n",
+    "print(np.min(eigen_value))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/Shors.html b/pr-2241/examples/python/tutorials/Shors.html
new file mode 100644
index 0000000000..06c3667d8b
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/Shors.html
@@ -0,0 +1,1416 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Factoring Integers With Shor’s Algorithm &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Compiling Unitaries Using Diffusion Models" href="unitary_compilation.html" />
+    <link rel="prev" title="Multi-Reference Quantum Krylov Algorithm (H2 Example)" href="H2-MRQKS.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Factoring Integers With Shor’s Algorithm</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/Shors.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="H2-MRQKS.html" class="btn btn-neutral float-left" title="Multi-Reference Quantum Krylov Algorithm (H2 Example)" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="unitary_compilation.html" class="btn btn-neutral float-right" title="Compiling Unitaries Using Diffusion Models" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Factoring-Integers-With-Shor's-Algorithm">
+<h1>Factoring Integers With Shor’s Algorithm<a class="headerlink" href="#Factoring-Integers-With-Shor's-Algorithm" title="Permalink to this heading">¶</a></h1>
+<p>The most famous application of quantum computers is factoring integers using Shor’s algorithm. This algorithm is particularly significant because an efficient factorization algorithm could potentially break modern asymmetric encryption schemes, such as RSA.</p>
+<p>For small integers, this quantum algorithm can be simulated on classical computers. The main challenge in classical implementation lies in the order-finding algorithm. We will first introduce the classical implementation of this algorithm as a preliminary step, and then proceed to explain the quantum order-finding algorithm.</p>
+<p>First let’s install some libraries.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span>contfrac
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[156]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">math</span> <span class="kn">import</span> <span class="n">gcd</span><span class="p">,</span> <span class="n">log2</span><span class="p">,</span> <span class="n">ceil</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">random</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="o">*</span>
+<span class="kn">import</span> <span class="nn">fractions</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+<span class="kn">import</span> <span class="nn">contfrac</span>
+<br/></pre></div>
+</div>
+</div>
+<section id="Shor's-algorithm">
+<h2>Shor’s algorithm<a class="headerlink" href="#Shor's-algorithm" title="Permalink to this heading">¶</a></h2>
+<p>The factoring problem for an integer <span class="math notranslate nohighlight">\(N\)</span> aims to find integers <span class="math notranslate nohighlight">\(a_1\)</span>, <span class="math notranslate nohighlight">\(a_2\)</span> which are factors of <span class="math notranslate nohighlight">\(N\)</span>. This problem is interesting when <span class="math notranslate nohighlight">\(N\)</span> is not prime and the solutions <span class="math notranslate nohighlight">\(a_1\)</span> and <span class="math notranslate nohighlight">\(a_2\)</span> are non-trivial. In other words, we will attempt to find integers <span class="math notranslate nohighlight">\(a_1\)</span> and <span class="math notranslate nohighlight">\(a_2\)</span> satisfying <span class="math notranslate nohighlight">\(N=a_1\cdot a_2\)</span> with <span class="math notranslate nohighlight">\(a_1\neq 1\)</span> and <span class="math notranslate nohighlight">\(a_2\neq 1\)</span>.</p>
+<p>The algorithm consists of two ideas:</p>
+<ul class="simple">
+<li><p>Reduce the problem of factoring the integer <span class="math notranslate nohighlight">\(N\)</span> to the order-finding problem.</p></li>
+<li><p>Solve the order-finding problem: Given integers <span class="math notranslate nohighlight">\(a\)</span> and <span class="math notranslate nohighlight">\(N\)</span> so that <span class="math notranslate nohighlight">\(a\)</span> and <span class="math notranslate nohighlight">\(N\)</span> share no common factors (i.e., the greatest common divisor of <span class="math notranslate nohighlight">\(a\)</span> and <span class="math notranslate nohighlight">\(N\)</span> is 1), find the smallest positive integer which satisfies <span class="math notranslate nohighlight">\(a^r \equiv 1 \mod N\)</span>. This value <span class="math notranslate nohighlight">\(r\)</span> is refered to as the <em>order of</em> <span class="math notranslate nohighlight">\(a \mod N\)</span>.</p></li>
+</ul>
+<p>These two ideas are combined in the following steps in Shor’s algorithm:</p>
+<ol class="arabic simple" start="0">
+<li><p>Rule out the easy case that <span class="math notranslate nohighlight">\(N\)</span> is even</p></li>
+<li><p>Select a random integer <span class="math notranslate nohighlight">\(a\)</span> between <span class="math notranslate nohighlight">\(2\)</span> and <span class="math notranslate nohighlight">\(N-1\)</span></p></li>
+<li><p>Check to see if <span class="math notranslate nohighlight">\(a\)</span> is a factor of <span class="math notranslate nohighlight">\(N\)</span> (if so we’re done!)</p></li>
+<li><p>Find the order of <span class="math notranslate nohighlight">\(a \mod N\)</span>, (i.e., find <span class="math notranslate nohighlight">\(r\)</span> so that <span class="math notranslate nohighlight">\(a^r\equiv 1 \mod N\)</span>)</p></li>
+<li><p>Check to see if <span class="math notranslate nohighlight">\(a^{\frac{r}{2}}-1\)</span> or <span class="math notranslate nohighlight">\(a^{\frac{r}{2}}+1\)</span> are integers and share common, non-trivial, divisors with <span class="math notranslate nohighlight">\(N\)</span> (if so we’re done!)</p></li>
+<li><p>If no factor is found, repeat steps 1 through 4 above.</p></li>
+</ol>
+<p>The function <code class="docutils literal notranslate"><span class="pre">shors_algorithm</span></code> below outlines these steps for both the classical and the quantum implementation of Shor’s algorithm. For the purposes of demonstration, we will also control the initial random integer selected in step 1 so that we can investigate cases in which the selected integer produces common divisors of <span class="math notranslate nohighlight">\(N\)</span> in step 4 and others in which step 4 produces no common factors.</p>
+<p><strong>Note about terminology:</strong> Some literature refers to the “period-finding problem” in Shor’s algorithm. The order-finding problem, as we have described above, can be recast as finding the period of the function <span class="math notranslate nohighlight">\(f(x) = a^x\mod N\)</span>, by noticing that the period of <span class="math notranslate nohighlight">\(f(x)\)</span> is one more than the order of <span class="math notranslate nohighlight">\(a\mod N\)</span>. The period finding problem is more general than the order-finding problem since it aims to find the period of any periodic function, not just modular exponentiation.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">shors_algorithm</span><span class="p">(</span><span class="n">N</span><span class="p">,</span> <span class="n">initial</span><span class="p">,</span> <span class="n">quantum</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot; Factor N using Shor&#39;s algorithm with initial starting value and choice of</span>
+<span class="sd">    using either classical or quantum approach for the period finding step</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    N: int</span>
+<span class="sd">        Integer to be factored (assumed to be non-prime and &gt;1)</span>
+<span class="sd">    initial: int</span>
+<span class="sd">        Initial choice of the random integer between 2 and N-1</span>
+<span class="sd">    quantum: boolean</span>
+<span class="sd">        True if we will call the quantum order-finding algorithm, and false if we call the classical one for step 3.</span>
+
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    a1, a2: int</span>
+<span class="sd">        Non-trivial factors of N</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1"># 0. Check to see if N is even.</span>
+    <span class="k">if</span> <span class="n">N</span> <span class="o">%</span> <span class="mi">2</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+        <span class="n">divisor1</span> <span class="o">=</span> <span class="mi">2</span>
+        <span class="n">divisor2</span> <span class="o">=</span> <span class="n">N</span> <span class="o">//</span> <span class="mi">2</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Found factors:&quot;</span><span class="p">,</span> <span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span><span class="p">)</span>
+        <span class="k">return</span> <span class="p">(</span><span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span><span class="p">)</span>
+
+    <span class="n">attempts</span> <span class="o">=</span> <span class="p">[</span><span class="n">initial</span><span class="p">]</span>
+    <span class="k">while</span> <span class="p">(</span><span class="kc">True</span><span class="p">):</span>
+        <span class="c1"># 1. Select a random integer between 2 and N-1</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">attempts</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">a</span> <span class="o">=</span> <span class="n">initial</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="n">a</span> <span class="o">=</span> <span class="n">random</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span>
+                <span class="p">[</span><span class="n">n</span> <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">N</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span> <span class="k">if</span> <span class="n">n</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">attempts</span> <span class="ow">and</span> <span class="n">n</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">])</span>
+
+        <span class="c1"># 2. See if the integer selected in step 1 happens to factor N</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Trying a =&quot;</span><span class="p">,</span> <span class="n">a</span><span class="p">)</span>
+        <span class="n">divisor1</span> <span class="o">=</span> <span class="n">gcd</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">divisor1</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">divisor2</span> <span class="o">=</span> <span class="n">N</span> <span class="o">//</span> <span class="n">divisor1</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Found factors of N=</span><span class="si">{}</span><span class="s2"> by chance: </span><span class="si">{}</span><span class="s2"> and </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">N</span><span class="p">,</span> <span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span><span class="p">))</span>
+            <span class="k">return</span> <span class="p">(</span><span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span><span class="p">)</span>
+
+        <span class="c1"># 3. Find the order of a mod N (i.e., r, where a^r = 1 (mod N))</span>
+        <span class="k">if</span> <span class="n">quantum</span> <span class="o">==</span> <span class="kc">True</span><span class="p">:</span>
+            <span class="n">r</span> <span class="o">=</span> <span class="n">find_order_quantum</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">)</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="n">r</span> <span class="o">=</span> <span class="n">find_order_classical</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;The order of a = </span><span class="si">{}</span><span class="s2"> is </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">a</span><span class="p">,</span><span class="n">r</span><span class="p">))</span>
+
+        <span class="c1"># 4. If the order of a is found and it is</span>
+        <span class="c1"># * even and</span>
+        <span class="c1"># * not a^(r/2) = -1 (mod N),</span>
+        <span class="c1"># then test a^(r/2)-1 and a^(r/2)+1 to see if they share factors with N.</span>
+        <span class="c1"># We also want to rule out the case of finding the trivial factors: 1 and N.</span>
+        <span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span> <span class="o">=</span> <span class="n">test_order</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">r</span><span class="p">,</span> <span class="n">N</span><span class="p">)</span>
+        <span class="k">if</span> <span class="p">(</span><span class="n">divisor1</span> <span class="o">!=</span> <span class="mi">0</span><span class="p">):</span>  <span class="c1"># test_order will return a 0 if no factor is found</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Found factors of N = </span><span class="si">{}</span><span class="s2">: </span><span class="si">{}</span><span class="s2"> and </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">N</span><span class="p">,</span><span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span><span class="p">))</span>
+            <span class="k">return</span> <span class="n">divisor1</span><span class="p">,</span> <span class="n">divisor2</span>
+
+        <span class="c1"># 5. Repeat</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;retrying...&quot;</span><span class="p">)</span>
+        <span class="n">attempts</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">a</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>Let’s first explore the idea of reducing the factoring problem into the order-finding problem. This gets captured in step 4 described above. In this step, we have already established that <span class="math notranslate nohighlight">\(a\)</span> and <span class="math notranslate nohighlight">\(N\)</span> share no factors other than <span class="math notranslate nohighlight">\(1\)</span> (i.e., <span class="math notranslate nohighlight">\(\gcd(a,N)=1\)</span>) and we have found <span class="math notranslate nohighlight">\(r\)</span>, the order of <span class="math notranslate nohighlight">\(a\mod N.\)</span> With this information we know that <span class="math notranslate nohighlight">\(a^r \equiv 1 \mod N.\)</span> Rewritten in another way:</p>
+<div class="math notranslate nohighlight">
+\[a^r -1 \equiv 0\mod N
+\tag{1}.\]</div>
+<p>If <span class="math notranslate nohighlight">\(r\)</span> is even, we can rewrite <span class="math notranslate nohighlight">\(a^r\)</span> as <span class="math notranslate nohighlight">\(x^2\)</span> where <span class="math notranslate nohighlight">\(x=a^\frac{r}{2}\)</span>. Next, we can factor equation <span class="math notranslate nohighlight">\((1)\)</span> using the identity <span class="math notranslate nohighlight">\(x^2-1 = (x-1)(x+1)\)</span>:</p>
+<div class="math notranslate nohighlight">
+\[ (a^{\frac{r}{2}} - 1)(a^{\frac{r}{2}} + 1) \equiv 0\mod N
+\tag{2}.\]</div>
+<p>If, in addition, the equation</p>
+<div class="math notranslate nohighlight">
+\[a^{\frac{r}{2}}  \not\equiv -1\mod N
+\tag{3}\]</div>
+<p>is satisfied, then at least one of the terms <span class="math notranslate nohighlight">\(a^{\frac{r}{2}} - 1\)</span> or <span class="math notranslate nohighlight">\(a^{\frac{r}{2}} + 1\)</span> must share a common factor with <span class="math notranslate nohighlight">\(N\)</span>. <a class="reference external" href="https://arxiv.org/abs/quant-ph/9508027">Peter Shor</a> demonstrated that there is greater than a <span class="math notranslate nohighlight">\(50\%\)</span> chance of randomly selecting a value for <span class="math notranslate nohighlight">\(a\)</span> satisfying these properties.</p>
+<p>The code block below defines a function that tests whether <span class="math notranslate nohighlight">\(r\)</span> is even and whether equation <span class="math notranslate nohighlight">\((3)\)</span> is satisfied and searches for a non-trivial factor of <span class="math notranslate nohighlight">\(N\)</span>.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[157]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">test_order</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">r</span><span class="p">,</span> <span class="n">N</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Checks whether or not a^(r/2)+1 or a^(r/2)-1 share a non-trivial common factor with N</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    a: int</span>
+<span class="sd">    r: int</span>
+<span class="sd">    N: int</span>
+
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    int, int factors of N, if found; 0,0 otherwise</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="k">if</span> <span class="n">r</span> <span class="o">!=</span> <span class="kc">None</span> <span class="ow">and</span> <span class="p">(</span><span class="n">r</span> <span class="o">%</span> <span class="mi">2</span> <span class="o">==</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">and</span> <span class="n">a</span><span class="o">**</span><span class="n">r</span> <span class="o">%</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="k">if</span> <span class="p">(</span><span class="n">a</span><span class="o">**</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">r</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)))</span> <span class="o">%</span> <span class="n">N</span> <span class="o">!=</span> <span class="o">-</span><span class="mi">1</span><span class="p">:</span>
+            <span class="n">possible_factors</span> <span class="o">=</span> <span class="p">[</span><span class="n">gcd</span><span class="p">(</span><span class="n">r</span> <span class="o">-</span> <span class="mi">1</span><span class="p">,</span> <span class="n">N</span><span class="p">),</span> <span class="n">gcd</span><span class="p">(</span><span class="n">r</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">N</span><span class="p">)]</span>
+            <span class="k">for</span> <span class="n">test_factor</span> <span class="ow">in</span> <span class="n">possible_factors</span><span class="p">:</span>
+                <span class="k">if</span> <span class="n">test_factor</span> <span class="o">!=</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">test_factor</span> <span class="o">!=</span> <span class="n">N</span><span class="p">:</span>
+                    <span class="k">return</span> <span class="n">test_factor</span><span class="p">,</span> <span class="n">N</span> <span class="o">//</span> <span class="n">test_factor</span>
+    <span class="c1"># period did not produce a factor</span>
+    <span class="k">else</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;No non-trivial factor found&#39;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span>
+<br/></pre></div>
+</div>
+</div>
+<section id="Solving-the-order-finding-problem-classically">
+<h3>Solving the order-finding problem classically<a class="headerlink" href="#Solving-the-order-finding-problem-classically" title="Permalink to this heading">¶</a></h3>
+<p>The key component of Shor’s algorithm is an efficient quantum algorithm to find the order <span class="math notranslate nohighlight">\(r\)</span> of <span class="math notranslate nohighlight">\(a \mod N\)</span>. While a straightforward classical algorithm can solve this problem, it is notably inefficient:</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[158]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">find_order_classical</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;A naive classical method to find the order r of a (mod N).</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    a: int</span>
+<span class="sd">        an integer in the interval [2,N-1]</span>
+<span class="sd">    N: int</span>
+
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    r: int</span>
+<span class="sd">        Period of a^x (mod N)</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">assert</span> <span class="mi">1</span> <span class="o">&lt;</span> <span class="n">a</span> <span class="ow">and</span> <span class="n">a</span> <span class="o">&lt;</span> <span class="n">N</span>
+    <span class="n">r</span> <span class="o">=</span> <span class="mi">1</span>
+    <span class="n">y</span> <span class="o">=</span> <span class="n">a</span>
+    <span class="k">while</span> <span class="n">y</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="n">y</span> <span class="o">=</span> <span class="n">y</span> <span class="o">*</span> <span class="n">a</span> <span class="o">%</span> <span class="n">N</span>
+        <span class="n">r</span> <span class="o">+=</span> <span class="mi">1</span>
+    <span class="k">return</span> <span class="n">r</span>
+</pre></div>
+</div>
+</div>
+<p>Let’s see how Shor’s algorithm works on a few examples using the classical order-finding problem. Notice how often our choice of value for the initial guess for <span class="math notranslate nohighlight">\(a\)</span> produces factors of <span class="math notranslate nohighlight">\(N\)</span>.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[159]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">my_integer</span> <span class="o">=</span> <span class="mi">123</span>  <span class="c1">#edit this value to try out a few examples</span>
+<span class="c1"># Edit the value in the line below to try out different initial guesses for a.</span>
+<span class="c1"># What happens when you choose a = 42 for the integer 123?</span>
+<span class="c1"># What happens when you choose a = 100 for the integer 123?</span>
+<span class="n">initial_value_to_start</span> <span class="o">=</span> <span class="mi">42</span>  <span class="c1"># edit this value; it should be less than my_integer</span>
+
+<span class="n">shors_algorithm</span><span class="p">(</span><span class="n">my_integer</span><span class="p">,</span> <span class="n">initial_value_to_start</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Trying a = 42
+Found factors of N=123 by chance: 3 and 41
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[159]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+(3, 41)
+</pre></div></div>
+</div>
+</section>
+<section id="Solving-the-order-finding-problem-with-a-quantum-algorithm">
+<h3>Solving the order-finding problem with a quantum algorithm<a class="headerlink" href="#Solving-the-order-finding-problem-with-a-quantum-algorithm" title="Permalink to this heading">¶</a></h3>
+<p>The Fourier transform is a classical computation that provides a more efficient algorithm than the one encoded in <code class="docutils literal notranslate"><span class="pre">find_order_classical</span></code> for identifying the period of <span class="math notranslate nohighlight">\(f(x) = a^x\mod N\)</span>. The quantum version of the Fourier transform is the central idea of Shor’s Algorithm. This efficient quantum solution derives the period from a measurement of <span class="math notranslate nohighlight">\(n = \lceil log2(N) \rceil\)</span> qubits.</p>
+<p>The image below outlines the quantum kernel used to find the order of <span class="math notranslate nohighlight">\(a\)</span>. Notice the last step involves applying the Inverse Quantum Fourier Transform.</p>
+<p><img alt="image0" src="../../../_images/shor_circuit.png" /></p>
+<p>Figure. Circuit diagram for finding the phase of the modular multiplication gate $U|x:nbsphinx-math:<cite>rangle `= |a^x:nbsphinx-math:</cite>mod <cite>N:nbsphinx-math:</cite>rangle <cite>$, which will be used to compute the order of :math:`a</cite> modulo <span class="math notranslate nohighlight">\(N\)</span>. The number of qubits in the control register determines the accuracy of estimating the phase of <span class="math notranslate nohighlight">\(U\)</span>. The size of the work register depends on <span class="math notranslate nohighlight">\(N\)</span>. The goal of this section is to code the diagram as a kernel named <code class="docutils literal notranslate"><span class="pre">phase_kernel</span></code>.</p>
+<p>We will need to create a quantum kernel for the Inverse Quantum Fourier Transform. Additionally we’ll need to create a kernel for modular multiplication: <span class="math notranslate nohighlight">\(g(y) = ay \mod N\)</span>, which can be repeatedly applied <span class="math notranslate nohighlight">\(x\)</span>-times to <span class="math notranslate nohighlight">\(y=1\)</span> to carry our modular exponentation <span class="math notranslate nohighlight">\(f(x)=a^x\mod N\)</span>.</p>
+<section id="Inverse-quantum-Fourier-transform">
+<h4>Inverse quantum Fourier transform<a class="headerlink" href="#Inverse-quantum-Fourier-transform" title="Permalink to this heading">¶</a></h4>
+<p>In the code block below we define a kernel for the quantum Fourier transform and then use <code class="docutils literal notranslate"><span class="pre">cudaq.adjoint</span></code> to create a kernel for the inverse quantum Fourier transform used in the quantum order-finding algorithm.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[160]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define kernels for the quantum Fourier transform and the inverse quantum Fourier transform</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">quantum_fourier_transform</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">qubit_count</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+    <span class="c1"># Apply Hadamard gates and controlled rotation gates.</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+        <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">):</span>
+            <span class="n">angle</span> <span class="o">=</span> <span class="p">(</span><span class="mi">2</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="p">(</span><span class="n">j</span> <span class="o">-</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">))</span>
+            <span class="n">cr1</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="p">[</span><span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">]],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">inverse_qft</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">adjoint</span><span class="p">(</span><span class="n">quantum_fourier_transform</span><span class="p">,</span> <span class="n">qubits</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</section>
+<section id="Quantum-kernels-for-modular-exponentiation">
+<h4>Quantum kernels for modular exponentiation<a class="headerlink" href="#Quantum-kernels-for-modular-exponentiation" title="Permalink to this heading">¶</a></h4>
+<p>While Shor’s algorithm provably can factor numbers faster than known classical techniques, the resources required for implementing Shor’s algorithm are hefty. A full-scale implementation to factor an <span class="math notranslate nohighlight">\(L\)</span>-bit number could require a quantum kernel with <span class="math notranslate nohighlight">\(5L+1\)</span> qubits to achieve accuracy for the continued fractions part of the algoirthm and as many as <span class="math notranslate nohighlight">\(72L^3\)</span> quantum gates for the modular exponentiaion <a class="reference external" href="https://arxiv.org/pdf/quant-ph/9602016">(Beckman, Chari, Devabhaktuni, &amp; Preskill,
+1996)</a>. Both of these are well beyond the capabilities of modern quantum hardware for numbers of interest. Advancements to reduce the number of gates and qubits required focus on optimizing the kernel for <span class="math notranslate nohighlight">\(f(x) = a\cdot x \mod N\)</span> for properties of the number to be factored. The difficulty is to create efficient quantum kernels (in terms of qubit and gate count) that compute <span class="math notranslate nohighlight">\(a\cdot x \mod{N}\)</span>.</p>
+<p>For the purposes of this demonstration, we will consider only the order-finding problem for the values of <span class="math notranslate nohighlight">\(a\)</span> to be either <span class="math notranslate nohighlight">\(4\)</span> or <span class="math notranslate nohighlight">\(5\)</span> with <span class="math notranslate nohighlight">\(N=21\)</span>. We’ll be using the quantum circuits depicted in <a class="reference external" href="https://arxiv.org/abs/2103.13855">this paper</a> and <a class="reference external" href="https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf">this report</a>, respectively.</p>
+<section id="The-case-N-=-21-and-a-=-5:">
+<h5>The case N = 21 and a = 5:<a class="headerlink" href="#The-case-N-=-21-and-a-=-5:" title="Permalink to this heading">¶</a></h5>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[161]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">modular_mult_5_21</span><span class="p">(</span><span class="n">work</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;&quot;Kernel for multiplying by 5 mod 21</span>
+<span class="sd">    based off of the circuit diagram in</span>
+<span class="sd">    https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf</span>
+<span class="sd">    Modifications were made to change the ordering of the qubits&quot;&quot;&quot;</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">4</span><span class="p">])</span>
+
+    <span class="n">swap</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">4</span><span class="p">])</span>
+    <span class="n">swap</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">modular_exp_5_21</span><span class="p">(</span><span class="n">exponent</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">work</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span>
+                     <span class="n">control_size</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot; Controlled modular exponentiation kernel used in Shor&#39;s algorithm</span>
+<span class="sd">    |x&gt; U^x |y&gt; = |x&gt; |(5^x)y mod 21&gt;</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="k">for</span> <span class="n">exp</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">control_size</span><span class="p">):</span>
+        <span class="n">ctrl_qubit</span> <span class="o">=</span> <span class="n">exponent</span><span class="p">[</span><span class="n">exp</span><span class="p">]</span>
+        <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="p">(</span><span class="n">exp</span><span class="p">)):</span>
+            <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">modular_mult_5_21</span><span class="p">,</span> <span class="n">ctrl_qubit</span><span class="p">,</span> <span class="n">work</span><span class="p">)</span>
+<br/><br/></pre></div>
+</div>
+</div>
+<p>Verify in the code block below that the kernels defined above do in fact carry out multiplication and exponentiation with <span class="math notranslate nohighlight">\(a=5\)</span> and <span class="math notranslate nohighlight">\(N=21\)</span> by changing the <code class="docutils literal notranslate"><span class="pre">iterations</span></code> variable below.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[198]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Demonstrate iterated application of 5y mod 21 where y = 1</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">demonstrate_mod_exponentiation</span><span class="p">(</span><span class="n">iterations</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> <span class="c1"># initalizes the qubits in the state for y = 1 which is |10000&gt;</span>
+    <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">iterations</span><span class="p">):</span>
+        <span class="n">modular_mult_5_21</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+
+<span class="n">shots</span> <span class="o">=</span> <span class="mi">200</span>
+
+<span class="c1"># The iterations variable determines the exponent in 5^x mod 21.</span>
+<span class="c1"># Change this value to verify that the demonstrate_mod_exponentiation</span>
+<span class="c1"># kernel carries out the desired calculation.</span>
+<span class="n">iterations</span> <span class="o">=</span> <span class="mi">1</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">demonstrate_mod_exponentiation</span><span class="p">,</span> <span class="n">iterations</span><span class="p">))</span>
+
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">demonstrate_mod_exponentiation</span><span class="p">,</span>
+                       <span class="n">iterations</span><span class="p">,</span>
+                       <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measurement results from sampling:&quot;</span><span class="p">,</span> <span class="n">results</span><span class="p">)</span>
+
+<span class="c1"># Reverse the order of the most probable measured bit string</span>
+<span class="c1"># and convert the binary string to an integer</span>
+<span class="n">integer_result</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">results</span><span class="o">.</span><span class="n">most_probable</span><span class="p">()[::</span><span class="o">-</span><span class="mi">1</span><span class="p">],</span><span class="mi">2</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;For x = </span><span class="si">{}</span><span class="s2">, 5^x mod 21 = </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">iterations</span><span class="p">,</span> <span class="p">(</span><span class="mi">5</span><span class="o">**</span><span class="n">iterations</span><span class="p">)</span> <span class="o">%</span> <span class="mi">21</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;For x = </span><span class="si">{}</span><span class="s2">, the computed result of the circuit is </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+    <span class="n">iterations</span><span class="p">,</span> <span class="n">integer_result</span><span class="p">))</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮╭───╮
+q0 : ┤ x ├┤ x ├─╳──╳─
+     ╰───╯╰───╯ │  │
+q1 : ───────────┼──┼─
+     ╭───╮      │  │
+q2 : ┤ x ├──────┼──╳─
+     ╰───╯      │
+q3 : ───────────┼────
+     ╭───╮      │
+q4 : ┤ x ├──────╳────
+     ╰───╯
+
+Measurement results from sampling: { 10100:200 }
+
+For x = 1, 5^x mod 21 = 5
+For x = 1, the computed result of the circuit is 5
+</pre></div></div>
+</div>
+</section>
+<section id="The-case-N-=-21-and-a-=-4:">
+<h5>The case N = 21 and a = 4:<a class="headerlink" href="#The-case-N-=-21-and-a-=-4:" title="Permalink to this heading">¶</a></h5>
+<p>The example below is one where the work register has been optimized to use fewer gates and qubits than would have been necessary through a straightforward implementation of modular multiplication as seen in the previous case.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[199]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">modular_exp_4_21</span><span class="p">(</span><span class="n">exponent</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">work</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot; Controlled modular exponentiation kernel used in Shor&#39;s algorithm</span>
+<span class="sd">     |x&gt; U^x |y&gt; = |x&gt; |(4^x)y mod 21&gt;</span>
+<span class="sd">     based off of the circuit diagram in https://arxiv.org/abs/2103.13855</span>
+<span class="sd">     Modifications were made to account for qubit ordering differences&quot;&quot;&quot;</span>
+    <span class="n">swap</span><span class="p">(</span><span class="n">exponent</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">exponent</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="c1"># x = 1</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">exponent</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+    <span class="c1"># x = 2</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">exponent</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">([</span><span class="n">exponent</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">]],</span> <span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+    <span class="c1"># x = 4</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">([</span><span class="n">exponent</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">]],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">([</span><span class="n">exponent</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">]],</span> <span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">work</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">work</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">swap</span><span class="p">(</span><span class="n">exponent</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">exponent</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<p>Now we are ready to define the <code class="docutils literal notranslate"><span class="pre">phase_kernel</span></code> to carry out the instructions in the circuit diagram drawn at the beginning of this section.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[200]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">phase_kernel</span><span class="p">(</span><span class="n">control_register_size</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">work_register_size</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">a</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+                 <span class="n">N</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Kernel to estimate the phase of the modular multiplication gate |x&gt; U |y&gt; = |x&gt; |a*y mod 21&gt; for a = 4 or 5</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">control_register_size</span> <span class="o">+</span> <span class="n">work_register_size</span><span class="p">)</span>
+    <span class="n">control_register</span> <span class="o">=</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">:</span><span class="n">control_register_size</span><span class="p">]</span>
+    <span class="n">work_register</span> <span class="o">=</span> <span class="n">qubits</span><span class="p">[</span><span class="n">control_register_size</span><span class="p">:</span><span class="n">control_register_size</span> <span class="o">+</span>
+                           <span class="n">work_register_size</span><span class="p">]</span>
+
+    <span class="n">h</span><span class="p">(</span><span class="n">control_register</span><span class="p">)</span>
+
+    <span class="k">if</span> <span class="n">a</span> <span class="o">==</span> <span class="mi">4</span> <span class="ow">and</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">21</span><span class="p">:</span>
+        <span class="n">modular_exp_4_21</span><span class="p">(</span><span class="n">control_register</span><span class="p">,</span> <span class="n">work_register</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">a</span> <span class="o">==</span> <span class="mi">5</span> <span class="ow">and</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">21</span><span class="p">:</span>
+        <span class="n">modular_exp_5_21</span><span class="p">(</span><span class="n">control_register</span><span class="p">,</span> <span class="n">work_register</span><span class="p">,</span> <span class="n">control_register_size</span><span class="p">)</span>
+
+    <span class="n">inverse_qft</span><span class="p">(</span><span class="n">control_register</span><span class="p">)</span>
+
+    <span class="c1"># Measure only the control_register and not the work_register</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">control_register</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[201]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">control_register_size</span> <span class="o">=</span> <span class="mi">3</span>
+<span class="n">work_register_size</span> <span class="o">=</span> <span class="mi">5</span>
+<span class="n">values_for_a</span> <span class="o">=</span> <span class="p">[</span><span class="mi">4</span><span class="p">,</span> <span class="mi">5</span><span class="p">]</span>
+<span class="n">idx</span> <span class="o">=</span> <span class="mi">1</span>  <span class="c1"># change to 1 to select 5</span>
+<span class="n">N</span> <span class="o">=</span> <span class="mi">21</span>
+<span class="n">shots</span> <span class="o">=</span> <span class="mi">15000</span>
+
+<span class="nb">print</span><span class="p">(</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">phase_kernel</span><span class="p">,</span> <span class="n">control_register_size</span><span class="p">,</span> <span class="n">work_register_size</span><span class="p">,</span>
+               <span class="n">values_for_a</span><span class="p">[</span><span class="n">idx</span><span class="p">],</span> <span class="n">N</span><span class="p">))</span>
+
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">phase_kernel</span><span class="p">,</span>
+                       <span class="n">control_register_size</span><span class="p">,</span>
+                       <span class="n">work_register_size</span><span class="p">,</span>
+                       <span class="n">values_for_a</span><span class="p">[</span><span class="n">idx</span><span class="p">],</span>
+                       <span class="n">N</span><span class="p">,</span>
+                       <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span>
+    <span class="s2">&quot;Measurement results for a=</span><span class="si">{}</span><span class="s2"> and N=</span><span class="si">{}</span><span class="s2"> with </span><span class="si">{}</span><span class="s2"> qubits in the control register &quot;</span>
+    <span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">values_for_a</span><span class="p">[</span><span class="n">idx</span><span class="p">],</span> <span class="n">N</span><span class="p">,</span> <span class="n">control_register_size</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">results</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮                                                                    »
+q0 : ┤ h ├──●────●────●───●──●────────────────────────────────────────────────»
+     ├───┤  │    │    │   │  │                                                »
+q1 : ┤ h ├──┼────┼────┼───┼──┼───●────●────●───●──●───●────●────●───●──●──────»
+     ├───┤  │    │    │   │  │   │    │    │   │  │   │    │    │   │  │      »
+q2 : ┤ h ├──┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───●──»
+     ├───┤╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮»
+q3 : ┤ x ├┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├»
+     ╰───╯╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯»
+q4 : ────────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼──────»
+               ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      »
+q5 : ──────────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────»
+               ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         »
+q6 : ─────────────────┼───┼────────────────┼───┼────────────────┼───┼─────────»
+                    ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │         »
+q7 : ───────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─────────»
+                    ╰───╯                ╰───╯                ╰───╯           »
+
+################################################################################
+
+                                                                            »
+────────────────────────────────────────────────────────────────────────────»
+                                                                            »
+────────────────────────────────────────────────────────────────────────────»
+                                                                            »
+──●────●───●──●───●────●────●───●──●───●────●────●───●──●───●────●────●───●─»
+  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │ »
+──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳─»
+  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │ »
+──┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼─»
+╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │ »
+┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼─»
+╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │ »
+───────┼───┼────────────────┼───┼────────────────┼───┼────────────────┼───┼─»
+     ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │ »
+─────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─»
+     ╰───╯                ╰───╯                ╰───╯                ╰───╯   »
+
+################################################################################
+
+                           ╭─────────────╮╭────────────╮╭───╮
+───────────────────────────┤ r1(-0.7854) ├┤ r1(-1.571) ├┤ h ├
+        ╭────────────╮╭───╮╰──────┬──────╯╰─────┬──────╯╰───╯
+────────┤ r1(-1.571) ├┤ h ├───────┼─────────────●────────────
+   ╭───╮╰─────┬──────╯╰───╯       │
+─●─┤ h ├──────●───────────────────●──────────────────────────
+ │ ╰───╯
+─╳───────────────────────────────────────────────────────────
+ │
+─┼───────────────────────────────────────────────────────────
+ │
+─╳───────────────────────────────────────────────────────────
+
+─────────────────────────────────────────────────────────────
+
+─────────────────────────────────────────────────────────────
+
+
+Measurement results for a=5 and N=21 with 3 qubits in the control register
+{ 000:2843 010:913 111:1850 001:1935 011:1830 100:2846 101:1861 110:922 }
+
+</pre></div></div>
+</div>
+</section>
+</section>
+</section>
+<section id="Determining-the-order-from-the-measurement-results-of-the-phase-kernel">
+<h3>Determining the order from the measurement results of the phase kernel<a class="headerlink" href="#Determining-the-order-from-the-measurement-results-of-the-phase-kernel" title="Permalink to this heading">¶</a></h3>
+<p>The measurement results from sampling the <code class="docutils literal notranslate"><span class="pre">phase_kernel</span></code> can be used to estimate the phase of the operator <span class="math notranslate nohighlight">\(U|x\rangle = ax\mod N\)</span>. We will only be interested in the most probable non-zero outcomes of the sampling. Therefore, we’ll create a function <code class="docutils literal notranslate"><span class="pre">top_results</span></code> to extract those values.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[202]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">top_results</span><span class="p">(</span><span class="n">sample_results</span><span class="p">,</span> <span class="n">zeros</span><span class="p">,</span> <span class="n">threshold</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Function to output the non-zero results whose counts are above the given threshold</span>
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">        dict[str, int]: keys are bit-strings and values are the respective counts</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">results_dictionary</span> <span class="o">=</span> <span class="p">{</span><span class="n">k</span><span class="p">:</span> <span class="n">v</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">sample_results</span><span class="o">.</span><span class="n">items</span><span class="p">()}</span>
+    <span class="k">if</span> <span class="n">zeros</span> <span class="ow">in</span> <span class="n">results_dictionary</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+        <span class="n">results_dictionary</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">zeros</span><span class="p">)</span>
+    <span class="n">sorted_results</span> <span class="o">=</span> <span class="p">{</span>
+        <span class="n">k</span><span class="p">:</span> <span class="n">v</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">sorted</span><span class="p">(</span>
+            <span class="n">results_dictionary</span><span class="o">.</span><span class="n">items</span><span class="p">(),</span> <span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">item</span><span class="p">:</span> <span class="n">item</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">reverse</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+    <span class="p">}</span>
+    <span class="n">top_key</span> <span class="o">=</span> <span class="nb">next</span><span class="p">(</span><span class="nb">iter</span><span class="p">(</span><span class="n">sorted_results</span><span class="p">))</span>
+    <span class="n">max_value</span> <span class="o">=</span> <span class="n">sorted_results</span><span class="p">[</span><span class="n">top_key</span><span class="p">]</span>
+    <span class="n">top_results_dictionary</span> <span class="o">=</span> <span class="p">{</span><span class="n">top_key</span><span class="p">:</span> <span class="n">max_value</span><span class="p">}</span>
+
+    <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">sorted_results</span><span class="p">:</span>
+        <span class="k">if</span> <span class="n">results_dictionary</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">&gt;</span> <span class="nb">min</span><span class="p">(</span><span class="n">threshold</span><span class="p">,</span> <span class="n">max_value</span><span class="p">):</span>
+            <span class="n">top_results_dictionary</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">results_dictionary</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
+    <span class="k">return</span> <span class="n">top_results_dictionary</span>
+</pre></div>
+</div>
+</div>
+<p>Let’s see how the <code class="docutils literal notranslate"><span class="pre">top_results</span></code> extracts the top results from the measurement results for a=4 and N=21 with 3 qubits in the control register that we computed above. One of these top result is likely to be an estimate for the phase of <span class="math notranslate nohighlight">\(U\)</span>.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[203]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Example</span>
+<span class="n">top_results</span><span class="p">(</span><span class="n">results</span><span class="p">,</span> <span class="s1">&#39;000&#39;</span><span class="p">,</span> <span class="mi">750</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[203]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{&#39;100&#39;: 2846,
+ &#39;001&#39;: 1935,
+ &#39;101&#39;: 1861,
+ &#39;111&#39;: 1850,
+ &#39;011&#39;: 1830,
+ &#39;110&#39;: 922,
+ &#39;010&#39;: 913}
+</pre></div></div>
+</div>
+<p>The algorithm for translating the phase estimate of the operator <span class="math notranslate nohighlight">\(U|x\rangle = ax\mod N\)</span> into the order of <span class="math notranslate nohighlight">\(a \mod N\)</span> involves continued fractions. The function <code class="docutils literal notranslate"><span class="pre">find_order_quantum</span></code> below carries out this computation. To learn more about how the phase of <span class="math notranslate nohighlight">\(U\)</span> relates to the period of <span class="math notranslate nohighlight">\(a \mod N\)</span>, check out these three lectures by Scott Aaronson: lecture <a class="reference external" href="https://www.scottaaronson.com/qclec/19.pdf">19</a>, <a class="reference external" href="https://www.scottaaronson.com/qclec/20.pdf">20</a>,
+<a class="reference external" href="https://www.scottaaronson.com/qclec/21.pdf">21</a>.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[204]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_order_from_phase</span><span class="p">(</span><span class="n">phase</span><span class="p">,</span> <span class="n">phase_nbits</span><span class="p">,</span> <span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Uses continued fractions to find the order of a mod N</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    phase: int</span>
+<span class="sd">        Integer result from the phase estimate of U|x&gt; = ax mod N</span>
+<span class="sd">    phase_nbits: int</span>
+<span class="sd">        Number of qubits used to estimate the phase</span>
+<span class="sd">    a: int</span>
+<span class="sd">        For this demonstration a is either 4 or 5</span>
+<span class="sd">    N: int</span>
+<span class="sd">        For this demonstration N = 21</span>
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    int: period of a mod N if found, otherwise returns None</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="k">assert</span> <span class="n">phase_nbits</span> <span class="o">&gt;</span> <span class="mi">0</span>
+    <span class="k">assert</span> <span class="n">a</span> <span class="o">&gt;</span> <span class="mi">0</span>
+    <span class="k">assert</span> <span class="n">N</span> <span class="o">&gt;</span> <span class="mi">0</span>
+
+    <span class="n">eigenphase</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="n">phase</span><span class="p">)</span> <span class="o">/</span> <span class="mi">2</span><span class="o">**</span><span class="p">(</span><span class="n">phase_nbits</span><span class="p">)</span>
+
+    <span class="n">f</span> <span class="o">=</span> <span class="n">fractions</span><span class="o">.</span><span class="n">Fraction</span><span class="o">.</span><span class="n">from_float</span><span class="p">(</span><span class="n">eigenphase</span><span class="p">)</span><span class="o">.</span><span class="n">limit_denominator</span><span class="p">(</span><span class="n">N</span><span class="p">)</span>
+
+    <span class="k">if</span> <span class="n">f</span><span class="o">.</span><span class="n">numerator</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="k">return</span> <span class="kc">None</span>
+    <span class="n">eigenphase</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">numerator</span> <span class="o">/</span> <span class="n">f</span><span class="o">.</span><span class="n">denominator</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;eigenphase is &#39;</span><span class="p">,</span> <span class="n">eigenphase</span><span class="p">)</span>
+    <span class="n">coefficients_continued_fraction</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span>
+        <span class="n">contfrac</span><span class="o">.</span><span class="n">continued_fraction</span><span class="p">(</span><span class="n">eigenphase</span><span class="p">))</span>
+
+    <span class="n">convergents_continued_fraction</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">contfrac</span><span class="o">.</span><span class="n">convergents</span><span class="p">(</span><span class="n">eigenphase</span><span class="p">))</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;convergent sequence of fractions for this eigenphase is&#39;</span><span class="p">,</span> <span class="n">convergents_continued_fraction</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">r</span> <span class="ow">in</span> <span class="n">convergents_continued_fraction</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;using the denominators of the fractions in the convergent sequence, testing order =&#39;</span><span class="p">,</span> <span class="n">r</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+        <span class="k">if</span> <span class="n">a</span><span class="o">**</span><span class="n">r</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">%</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Found order:&#39;</span><span class="p">,</span> <span class="n">r</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+            <span class="k">return</span> <span class="p">(</span><span class="n">r</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="k">return</span> <span class="kc">None</span>
+<br/></pre></div>
+</div>
+</div>
+<p>We are now ready to combine all the elements above into a function to find the order of <span class="math notranslate nohighlight">\(a\)</span> <span class="math notranslate nohighlight">\(\mod N\)</span> and test it in the factoring algoithm.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[205]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">find_order_quantum</span><span class="p">(</span><span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;The quantum algorithm to find the order of a mod N, when x = 4 or x =5 and N = 21</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    a: int</span>
+<span class="sd">        For this demonstration a will be either 4 or 5</span>
+<span class="sd">    N: int</span>
+<span class="sd">        For this demonstration N will be 21</span>
+<span class="sd">    Returns</span>
+<span class="sd">    r: int the period if it is found, or None if no period is found</span>
+<span class="sd">    -------</span>
+
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="k">if</span> <span class="p">(</span><span class="n">a</span> <span class="o">==</span> <span class="mi">4</span> <span class="ow">and</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">21</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="n">a</span> <span class="o">==</span> <span class="mi">5</span> <span class="ow">and</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">21</span><span class="p">):</span>
+        <span class="n">shots</span> <span class="o">=</span> <span class="mi">15000</span>
+        <span class="k">if</span> <span class="n">a</span> <span class="o">==</span> <span class="mi">4</span> <span class="ow">and</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">21</span><span class="p">:</span>
+            <span class="n">control_register_size</span> <span class="o">=</span> <span class="mi">3</span>
+            <span class="n">work_register_size</span> <span class="o">=</span> <span class="mi">2</span>
+        <span class="k">if</span> <span class="n">a</span> <span class="o">==</span> <span class="mi">5</span> <span class="ow">and</span> <span class="n">N</span> <span class="o">==</span> <span class="mi">21</span><span class="p">:</span>
+            <span class="n">control_register_size</span> <span class="o">=</span> <span class="mi">5</span>
+            <span class="n">work_register_size</span> <span class="o">=</span> <span class="mi">5</span>
+
+        <span class="c1">#cudaq.set_random_seed(123)</span>
+        <span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">phase_kernel</span><span class="p">,</span>
+                               <span class="n">control_register_size</span><span class="p">,</span>
+                               <span class="n">work_register_size</span><span class="p">,</span>
+                               <span class="n">a</span><span class="p">,</span>
+                               <span class="n">N</span><span class="p">,</span>
+                               <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measurement results:&quot;</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="n">results</span><span class="p">)</span>
+
+        <span class="c1"># We will want to ignore the all zero result</span>
+        <span class="n">zero_result</span> <span class="o">=</span> <span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
+            <span class="p">[</span><span class="nb">str</span><span class="p">(</span><span class="n">elem</span><span class="p">)</span> <span class="k">for</span> <span class="n">elem</span> <span class="ow">in</span> <span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">control_register_size</span><span class="p">])</span>
+        <span class="c1"># We&#39;ll only consider the top results from the sampling</span>
+        <span class="n">threshold</span> <span class="o">=</span> <span class="n">shots</span> <span class="o">*</span> <span class="p">(</span><span class="mf">.1</span><span class="p">)</span>
+        <span class="n">most_probable_bitpatterns</span> <span class="o">=</span> <span class="n">top_results</span><span class="p">(</span><span class="n">results</span><span class="p">,</span> <span class="n">zero_result</span><span class="p">,</span> <span class="n">threshold</span><span class="p">)</span>
+
+        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">most_probable_bitpatterns</span><span class="p">:</span>
+            <span class="c1"># Convert the key bit string into an integer</span>
+            <span class="c1"># This integer divided by 8 is an estimate for the phase</span>
+            <span class="n">reverse_result</span> <span class="o">=</span> <span class="n">key</span><span class="p">[::</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+            <span class="n">phase</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">reverse_result</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+
+            <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Trying nonzero bitpattern from the phase estimation:&quot;</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span>
+                  <span class="s2">&quot;=&quot;</span><span class="p">,</span> <span class="n">phase</span><span class="p">)</span>
+            <span class="n">r</span> <span class="o">=</span> <span class="n">get_order_from_phase</span><span class="p">(</span><span class="n">phase</span><span class="p">,</span> <span class="n">control_register_size</span><span class="p">,</span> <span class="n">a</span><span class="p">,</span> <span class="n">N</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">r</span> <span class="o">==</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;No period found.&#39;</span><span class="p">)</span>
+
+                <span class="k">continue</span>
+
+            <span class="k">return</span> <span class="n">r</span>
+            <span class="k">break</span>
+    <span class="k">else</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span>
+            <span class="s2">&quot;A different quantum kernel is required for this choice of a and N.&quot;</span>
+        <span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[206]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">my_integer</span> <span class="o">=</span> <span class="mi">21</span>
+<span class="n">initial_value_to_start</span> <span class="o">=</span> <span class="mi">5</span>  <span class="c1"># Try replacing 5 with 4</span>
+<span class="n">quantum</span> <span class="o">=</span> <span class="kc">True</span>
+<span class="n">shors_algorithm</span><span class="p">(</span><span class="n">my_integer</span><span class="p">,</span> <span class="n">initial_value_to_start</span><span class="p">,</span> <span class="n">quantum</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Trying a = 5
+Measurement results:
+{ 11010:452 11001:92 11101:47 00000:2485 01001:96 00100:131 01011:1747 00101:1654 10101:1736 00110:475 11111:23 01000:50 01101:38 01110:35 01010:420 11110:22 01111:26 00011:50 01100:120 10011:35 00010:25 00001:22 11011:1710 00111:79 11100:113 10001:14 10010:29 10100:129 10110:467 10000:2536 10111:81 11000:61 }
+
+Trying nonzero bitpattern from the phase estimation: 10000 = 1
+No period found.
+Trying nonzero bitpattern from the phase estimation: 01011 = 26
+eigenphase is  0.8125
+convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (4, 5), (13, 16)]
+using the denominators of the fractions in the convergent sequence, testing order = 1
+using the denominators of the fractions in the convergent sequence, testing order = 1
+using the denominators of the fractions in the convergent sequence, testing order = 5
+using the denominators of the fractions in the convergent sequence, testing order = 16
+No period found.
+Trying nonzero bitpattern from the phase estimation: 10101 = 21
+eigenphase is  0.65
+convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (1, 2), (2, 3), (13, 20)]
+using the denominators of the fractions in the convergent sequence, testing order = 1
+using the denominators of the fractions in the convergent sequence, testing order = 1
+using the denominators of the fractions in the convergent sequence, testing order = 2
+using the denominators of the fractions in the convergent sequence, testing order = 3
+using the denominators of the fractions in the convergent sequence, testing order = 20
+No period found.
+Trying nonzero bitpattern from the phase estimation: 11011 = 27
+eigenphase is  0.8421052631578947
+convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (5, 6), (16, 19)]
+using the denominators of the fractions in the convergent sequence, testing order = 1
+using the denominators of the fractions in the convergent sequence, testing order = 1
+using the denominators of the fractions in the convergent sequence, testing order = 6
+Found order: 6
+The order of a =5 is 6
+Found factors of N = 21: 7 and 3
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[206]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+(7, 3)
+</pre></div></div>
+</div>
+</section>
+<section id="Postscript">
+<h3>Postscript<a class="headerlink" href="#Postscript" title="Permalink to this heading">¶</a></h3>
+<p>Recent <a class="reference external" href="https://arxiv.org/abs/2308.06572">work of Oded Regev</a> improves Shor’s Algorithm by reducing the number of gates needed. You can read more about it <a class="reference external" href="https://www.quantamagazine.org/thirty-years-later-a-speed-boost-for-quantum-factoring-20231017/">here</a>.</p>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="H2-MRQKS.html" class="btn btn-neutral float-left" title="Multi-Reference Quantum Krylov Algorithm (H2 Example)" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="unitary_compilation.html" class="btn btn-neutral float-right" title="Compiling Unitaries Using Diffusion Models" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/Shors.ipynb b/pr-2241/examples/python/tutorials/Shors.ipynb
new file mode 100644
index 0000000000..dbfff32498
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/Shors.ipynb
@@ -0,0 +1,987 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "628c747b-084c-4fb6-843e-7c7f4cbf07a1",
+   "metadata": {},
+   "source": [
+    "# Factoring Integers With Shor's Algorithm"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6d0627c4-95bd-47b9-9ab5-e8374d25508e",
+   "metadata": {},
+   "source": [
+    "The most famous application of quantum computers is factoring integers using Shor's algorithm. This algorithm is particularly significant because an efficient factorization algorithm could potentially break modern asymmetric encryption schemes, such as RSA.\n",
+    "\n",
+    "For small integers, this quantum algorithm can be simulated on classical computers. The main challenge in classical implementation lies in the order-finding algorithm. We will first introduce the classical implementation of this algorithm as a preliminary step, and then proceed to explain the quantum order-finding algorithm.\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "148568d8",
+   "metadata": {},
+   "source": [
+    "First let's install some libraries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "486fb3d4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install contfrac"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 156,
+   "id": "88619b35-624e-4853-8d2e-6d9952390e5e",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "from math import gcd, log2, ceil\n",
+    "import numpy as np\n",
+    "import random\n",
+    "import cudaq\n",
+    "from cudaq import *\n",
+    "import fractions\n",
+    "import matplotlib.pyplot as plt\n",
+    "import contfrac\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c8523c6f-d729-4d5e-8df9-1780c343a58e",
+   "metadata": {},
+   "source": [
+    "## Shor's algorithm\n",
+    "The factoring problem for an integer $N$ aims to find integers $a_1$, $a_2$ which are factors of $N$.  This problem is interesting when $N$ is not prime and the solutions $a_1$ and $a_2$ are non-trivial.  In other words, we will attempt to find integers $a_1$ and $a_2$ satisfying $N=a_1\\cdot a_2$ with $a_1\\neq 1$ and $a_2\\neq 1$.\n",
+    "\n",
+    "The algorithm consists of two ideas:\n",
+    "\n",
+    "* Reduce the problem of factoring the integer $N$ to the order-finding problem.\n",
+    "* Solve the order-finding problem: \n",
+    "Given integers $a$ and $N$ so that $a$ and $N$ share no common factors (i.e., the greatest common divisor of $a$ and $N$ is 1), find the smallest positive integer which satisfies $a^r \\equiv 1 \\mod N$.  This value $r$ is refered to as the *order of* $a \\mod N$.\n",
+    "\n",
+    "These two ideas are combined in the following steps in Shor's algorithm:\n",
+    "\n",
+    "0. Rule out the easy case that $N$ is even\n",
+    "1. Select a random integer $a$ between $2$ and $N-1$\n",
+    "2. Check to see if $a$ is a factor of $N$ (if so we're done!)\n",
+    "3. Find the order of $a \\mod N$, (i.e., find $r$ so that $a^r\\equiv 1 \\mod N$)\n",
+    "4. Check to see if $a^{\\frac{r}{2}}-1$ or $a^{\\frac{r}{2}}+1$ are integers and share common, non-trivial, divisors with $N$ (if so we're done!)\n",
+    "5. If no factor is found, repeat steps 1 through 4 above.\n",
+    "\n",
+    "The function `shors_algorithm` below outlines these steps for both the classical and the quantum implementation of Shor's algorithm. For the purposes of demonstration, we will also control the initial random integer selected in step 1 so that we can investigate cases in which the selected integer produces common divisors of $N$ in step 4 and others in which step 4 produces no common factors.\n",
+    "\n",
+    "\n",
+    "**Note about terminology:** Some literature refers to the \"period-finding problem\" in Shor's algorithm.  The order-finding problem, as we have described above, can be recast as finding the period of the function $f(x) = a^x\\mod N$, by noticing that the period of $f(x)$ is one more than the order of $a\\mod N$. The period finding problem is more general than the order-finding problem since it aims to find the period of any periodic function, not just modular exponentiation.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "7dd05729",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def shors_algorithm(N, initial, quantum):\n",
+    "    \"\"\" Factor N using Shor's algorithm with initial starting value and choice of \n",
+    "    using either classical or quantum approach for the period finding step\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    N: int \n",
+    "        Integer to be factored (assumed to be non-prime and >1)\n",
+    "    initial: int \n",
+    "        Initial choice of the random integer between 2 and N-1\n",
+    "    quantum: boolean\n",
+    "        True if we will call the quantum order-finding algorithm, and false if we call the classical one for step 3.   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    a1, a2: int\n",
+    "        Non-trivial factors of N\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # 0. Check to see if N is even.\n",
+    "    if N % 2 == 0:\n",
+    "        divisor1 = 2\n",
+    "        divisor2 = N // 2\n",
+    "        print(\"Found factors:\", divisor1, divisor2)\n",
+    "        return (divisor1, divisor2)\n",
+    "\n",
+    "    attempts = [initial]\n",
+    "    while (True):\n",
+    "        # 1. Select a random integer between 2 and N-1\n",
+    "        if len(attempts) == 1:\n",
+    "            a = initial\n",
+    "        else:\n",
+    "            a = random.choice(\n",
+    "                [n for n in range(N - 1) if n not in attempts and n != 1])\n",
+    "\n",
+    "        # 2. See if the integer selected in step 1 happens to factor N\n",
+    "        print(\"Trying a =\", a)\n",
+    "        divisor1 = gcd(a, N)\n",
+    "        if divisor1 != 1:\n",
+    "            divisor2 = N // divisor1\n",
+    "            print(\"Found factors of N={} by chance: {} and {}\".format(N, divisor1, divisor2))\n",
+    "            return (divisor1, divisor2)\n",
+    "\n",
+    "        # 3. Find the order of a mod N (i.e., r, where a^r = 1 (mod N))\n",
+    "        if quantum == True:\n",
+    "            r = find_order_quantum(a, N)\n",
+    "        else:\n",
+    "            r = find_order_classical(a, N)\n",
+    "        print(\"The order of a = {} is {}\".format(a,r))\n",
+    "\n",
+    "        # 4. If the order of a is found and it is\n",
+    "        # * even and\n",
+    "        # * not a^(r/2) = -1 (mod N),\n",
+    "        # then test a^(r/2)-1 and a^(r/2)+1 to see if they share factors with N.\n",
+    "        # We also want to rule out the case of finding the trivial factors: 1 and N.\n",
+    "        divisor1, divisor2 = test_order(a, r, N)\n",
+    "        if (divisor1 != 0):  # test_order will return a 0 if no factor is found\n",
+    "            print(\"Found factors of N = {}: {} and {}\".format(N,divisor1, divisor2))\n",
+    "            return divisor1, divisor2\n",
+    "\n",
+    "        # 5. Repeat\n",
+    "        print(\"retrying...\")\n",
+    "        attempts.append(a)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ed682e81",
+   "metadata": {},
+   "source": [
+    "Let's first explore the idea of reducing the factoring problem into the order-finding problem. This gets captured in step 4 described above.  In this step, we have already established that $a$ and $N$ share no factors other than $1$ (i.e., $\\gcd(a,N)=1$) and we have found $r$, the order of $a\\mod N.$  With this information we know that $a^r \\equiv 1 \\mod N.$  Rewritten in another way:\n",
+    "$$\n",
+    "a^r -1 \\equiv 0\\mod N\n",
+    "\\tag{1}.\n",
+    "$$ \n",
+    " \n",
+    " If $r$ is even, we can rewrite $a^r$ as $x^2$ where $x=a^\\frac{r}{2}$. Next, we can factor equation $(1)$ using the identity $x^2-1 = (x-1)(x+1)$:\n",
+    " $$ \n",
+    " (a^{\\frac{r}{2}} - 1)(a^{\\frac{r}{2}} + 1) \\equiv 0\\mod N\n",
+    "\\tag{2}.\n",
+    "$$  \n",
+    "\n",
+    "If, in addition, the equation\n",
+    "$$\n",
+    "a^{\\frac{r}{2}}  \\not\\equiv -1\\mod N\n",
+    "\\tag{3}\n",
+    "$$\n",
+    "is satisfied, then  at least one of the terms $a^{\\frac{r}{2}} - 1$ or $a^{\\frac{r}{2}} + 1$ must share a common factor with $N$. [Peter Shor](https://arxiv.org/abs/quant-ph/9508027) demonstrated that there is greater than a $50\\%$ chance of randomly selecting a value for $a$ satisfying these properties.\n",
+    "\n",
+    "The code block below defines a function that tests whether $r$ is even and whether equation $(3)$ is satisfied and searches for a non-trivial factor of $N$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 157,
+   "id": "6c8eed12",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def test_order(a, r, N):\n",
+    "    \"\"\"Checks whether or not a^(r/2)+1 or a^(r/2)-1 share a non-trivial common factor with N\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "    r: int\n",
+    "    N: int\n",
+    "    \n",
+    "    Returns\n",
+    "    -------\n",
+    "    int, int factors of N, if found; 0,0 otherwise  \n",
+    "    \"\"\"\n",
+    "\n",
+    "    if r != None and (r % 2 == 0) and a**r % N == 1:\n",
+    "        if (a**(int(r / 2))) % N != -1:\n",
+    "            possible_factors = [gcd(r - 1, N), gcd(r + 1, N)]\n",
+    "            for test_factor in possible_factors:\n",
+    "                if test_factor != 1 and test_factor != N:\n",
+    "                    return test_factor, N // test_factor\n",
+    "    # period did not produce a factor\n",
+    "    else:\n",
+    "        print('No non-trivial factor found')\n",
+    "        return 0, 0\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a43af433-905c-4070-94b3-0f6be6f67f6b",
+   "metadata": {},
+   "source": [
+    "### Solving the order-finding problem classically\n",
+    "\n",
+    "The key component of Shor's algorithm is an efficient quantum algorithm to find the order $r$ of $a \\mod N$. While a straightforward classical algorithm can solve this problem, it is notably inefficient:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 158,
+   "id": "14f4b0d8",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_order_classical(a, N):\n",
+    "    \"\"\"A naive classical method to find the order r of a (mod N).\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "        an integer in the interval [2,N-1]\n",
+    "    N: int\n",
+    "    \n",
+    "    Returns\n",
+    "    -------\n",
+    "    r: int \n",
+    "        Period of a^x (mod N)\n",
+    "    \"\"\"\n",
+    "    assert 1 < a and a < N\n",
+    "    r = 1\n",
+    "    y = a\n",
+    "    while y != 1:\n",
+    "        y = y * a % N\n",
+    "        r += 1\n",
+    "    return r"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "aae6b36d",
+   "metadata": {},
+   "source": [
+    "Let's see how Shor's algorithm works on a few examples using the classical order-finding problem.  Notice how often our choice of value for the initial guess for $a$ produces factors of $N$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 159,
+   "id": "3f75b314-9f0c-40c5-a7bc-58ae235fc183",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Trying a = 42\n",
+      "Found factors of N=123 by chance: 3 and 41\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "(3, 41)"
+      ]
+     },
+     "execution_count": 159,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "my_integer = 123  #edit this value to try out a few examples\n",
+    "# Edit the value in the line below to try out different initial guesses for a.\n",
+    "# What happens when you choose a = 42 for the integer 123?\n",
+    "# What happens when you choose a = 100 for the integer 123?\n",
+    "initial_value_to_start = 42  # edit this value; it should be less than my_integer\n",
+    "\n",
+    "shors_algorithm(my_integer, initial_value_to_start, False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "275efced-b10e-4438-9b5e-f3534079304b",
+   "metadata": {},
+   "source": [
+    "### Solving the order-finding problem with a quantum algorithm\n",
+    "\n",
+    "\n",
+    "The Fourier transform is a classical computation that provides a more efficient algorithm than the one encoded in `find_order_classical` for identifying the period of $f(x) = a^x\\mod N$. The quantum version of the Fourier transform is the central idea of Shor's Algorithm. This efficient quantum solution derives the period from a measurement of $n = \\lceil log2(N) \\rceil$ qubits. \n",
+    "\n",
+    "The image below outlines the quantum kernel used to find the order of $a$. Notice the last step involves applying the Inverse Quantum Fourier Transform."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "aba9fbd7",
+   "metadata": {},
+   "source": [
+    "![](images/shor_circuit.png)\n",
+    "\n",
+    "Figure. Circuit diagram for finding the phase of the modular multiplication gate $U|x\\rangle = |a^x\\mod N\\rangle $, which will be used to compute the order of $a$ modulo $N$.  The number of qubits in the control register determines the accuracy of estimating the phase of $U$. The size of the work register depends on $N$. The goal of this section is to code the  diagram as a kernel named `phase_kernel`. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d7eff3b6",
+   "metadata": {},
+   "source": [
+    "We will need to create a quantum kernel for the Inverse Quantum Fourier Transform.  Additionally we'll need to create a kernel for modular multiplication: $g(y) = ay \\mod N$, which can be repeatedly applied $x$-times to $y=1$ to carry our modular exponentation $f(x)=a^x\\mod N$."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "567e104e",
+   "metadata": {},
+   "source": [
+    "#### Inverse quantum Fourier transform\n",
+    "In the code block below we define a kernel for the quantum Fourier transform and then use `cudaq.adjoint` to create a kernel for the inverse quantum Fourier transform used in the quantum order-finding algorithm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 160,
+   "id": "0e04a0a4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define kernels for the quantum Fourier transform and the inverse quantum Fourier transform\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform(qubits: cudaq.qview):\n",
+    "    qubit_count = len(qubits)\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def inverse_qft(qubits: cudaq.qview):\n",
+    "    cudaq.adjoint(quantum_fourier_transform, qubits)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39db9e6a",
+   "metadata": {},
+   "source": [
+    "#### Quantum kernels for modular exponentiation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b8b8884",
+   "metadata": {},
+   "source": [
+    "\n",
+    "While Shor's algorithm provably can factor numbers faster than known classical techniques, the resources required for implementing Shor's algorithm are hefty. A full-scale implementation to factor an $L$-bit number could require a quantum kernel with $5L+1$ qubits to achieve accuracy for the continued fractions part of the algoirthm and as many as $72L^3$ quantum gates for the modular exponentiaion [(Beckman, Chari, Devabhaktuni, & Preskill, 1996)](https://arxiv.org/pdf/quant-ph/9602016).  Both of these are well beyond the capabilities of modern quantum hardware for numbers of interest. Advancements to reduce the number of gates and qubits required focus on optimizing the kernel for $f(x) = a\\cdot x \\mod N$ for properties of the number to be factored. The difficulty is to create efficient quantum kernels (in terms of qubit and gate count) that compute $a\\cdot x \\mod{N}$.  \n",
+    "\n",
+    "For the purposes of this demonstration, we will consider only the order-finding problem for the values of $a$ to be either $4$ or $5$ with $N=21$. We'll be using the quantum circuits depicted in [this paper](https://arxiv.org/abs/2103.13855) and [this report](https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf), respectively. \n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a48d6fa1",
+   "metadata": {},
+   "source": [
+    "##### The case N = 21 and a = 5:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 161,
+   "id": "c4b8e2e4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def modular_mult_5_21(work: cudaq.qview):\n",
+    "    \"\"\"\"Kernel for multiplying by 5 mod 21\n",
+    "    based off of the circuit diagram in \n",
+    "    https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf\n",
+    "    Modifications were made to change the ordering of the qubits\"\"\"\n",
+    "    x(work[0])\n",
+    "    x(work[2])\n",
+    "    x(work[4])\n",
+    "    \n",
+    "    swap(work[0], work[4])\n",
+    "    swap(work[0], work[2])\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def modular_exp_5_21(exponent: cudaq.qview, work: cudaq.qview,\n",
+    "                     control_size: int):\n",
+    "    \"\"\" Controlled modular exponentiation kernel used in Shor's algorithm\n",
+    "    |x> U^x |y> = |x> |(5^x)y mod 21>\n",
+    "    \"\"\"\n",
+    "    x(work[0])\n",
+    "    for exp in range(control_size):\n",
+    "        ctrl_qubit = exponent[exp]\n",
+    "        for _ in range(2**(exp)):\n",
+    "            cudaq.control(modular_mult_5_21, ctrl_qubit, work)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0c644786",
+   "metadata": {},
+   "source": [
+    "Verify in the code block below that the kernels defined above do in fact carry out multiplication and exponentiation with $a=5$ and $N=21$ by changing the `iterations` variable below. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 198,
+   "id": "e93fcf39",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮      \n",
+      "q0 : ┤ x ├┤ x ├─╳──╳─\n",
+      "     ╰───╯╰───╯ │  │ \n",
+      "q1 : ───────────┼──┼─\n",
+      "     ╭───╮      │  │ \n",
+      "q2 : ┤ x ├──────┼──╳─\n",
+      "     ╰───╯      │    \n",
+      "q3 : ───────────┼────\n",
+      "     ╭───╮      │    \n",
+      "q4 : ┤ x ├──────╳────\n",
+      "     ╰───╯           \n",
+      "\n",
+      "Measurement results from sampling: { 10100:200 }\n",
+      "\n",
+      "For x = 1, 5^x mod 21 = 5\n",
+      "For x = 1, the computed result of the circuit is 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Demonstrate iterated application of 5y mod 21 where y = 1\n",
+    "@cudaq.kernel\n",
+    "def demonstrate_mod_exponentiation(iterations: int):\n",
+    "    qubits = cudaq.qvector(5)\n",
+    "    x(qubits[0]) # initalizes the qubits in the state for y = 1 which is |10000>\n",
+    "    for _ in range(iterations):\n",
+    "        modular_mult_5_21(qubits)\n",
+    "\n",
+    "\n",
+    "shots = 200\n",
+    "\n",
+    "# The iterations variable determines the exponent in 5^x mod 21. \n",
+    "# Change this value to verify that the demonstrate_mod_exponentiation\n",
+    "# kernel carries out the desired calculation.\n",
+    "iterations = 1  \n",
+    "\n",
+    "print(cudaq.draw(demonstrate_mod_exponentiation, iterations))\n",
+    "\n",
+    "results = cudaq.sample(demonstrate_mod_exponentiation,\n",
+    "                       iterations,\n",
+    "                       shots_count=shots)\n",
+    "\n",
+    "print(\"Measurement results from sampling:\", results)\n",
+    "\n",
+    "# Reverse the order of the most probable measured bit string\n",
+    "# and convert the binary string to an integer\n",
+    "integer_result = int(results.most_probable()[::-1],2)\n",
+    "\n",
+    "print(\"For x = {}, 5^x mod 21 = {}\".format(iterations, (5**iterations) % 21))\n",
+    "print(\"For x = {}, the computed result of the circuit is {}\".format(\n",
+    "    iterations, integer_result))\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ff07579c",
+   "metadata": {},
+   "source": [
+    "##### The case N = 21 and a = 4:\n",
+    "\n",
+    "The example below is one where the work register has been optimized to use fewer gates and qubits than would have been necessary through a straightforward implementation of modular multiplication as seen in the previous case."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 199,
+   "id": "69963075",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def modular_exp_4_21(exponent: cudaq.qview, work: cudaq.qview):\n",
+    "    \"\"\" Controlled modular exponentiation kernel used in Shor's algorithm\n",
+    "     |x> U^x |y> = |x> |(4^x)y mod 21>\n",
+    "     based off of the circuit diagram in https://arxiv.org/abs/2103.13855\n",
+    "     Modifications were made to account for qubit ordering differences\"\"\"\n",
+    "    swap(exponent[0], exponent[2])\n",
+    "    # x = 1\n",
+    "    x.ctrl(exponent[2], work[1])\n",
+    "\n",
+    "    # x = 2\n",
+    "    x.ctrl(exponent[1], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    x.ctrl([exponent[1], work[0]], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "\n",
+    "    # x = 4\n",
+    "    x(work[1])\n",
+    "    x.ctrl([exponent[0], work[1]], work[0])\n",
+    "    x(work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    x.ctrl([exponent[0], work[0]], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    swap(exponent[0], exponent[2])\n",
+    "    "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "84a197e2",
+   "metadata": {},
+   "source": [
+    "Now we are ready to define the `phase_kernel` to carry out the instructions in the circuit diagram drawn at the beginning of this section."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 200,
+   "id": "206bcac3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def phase_kernel(control_register_size: int, work_register_size: int, a: int,\n",
+    "                 N: int):\n",
+    "    \"\"\" \n",
+    "    Kernel to estimate the phase of the modular multiplication gate |x> U |y> = |x> |a*y mod 21> for a = 4 or 5\n",
+    "    \"\"\"\n",
+    "\n",
+    "    qubits = cudaq.qvector(control_register_size + work_register_size)\n",
+    "    control_register = qubits[0:control_register_size]\n",
+    "    work_register = qubits[control_register_size:control_register_size +\n",
+    "                           work_register_size]\n",
+    "\n",
+    "    h(control_register)\n",
+    "\n",
+    "    if a == 4 and N == 21:\n",
+    "        modular_exp_4_21(control_register, work_register)\n",
+    "    if a == 5 and N == 21:\n",
+    "        modular_exp_5_21(control_register, work_register, control_register_size)\n",
+    "\n",
+    "    inverse_qft(control_register)\n",
+    "\n",
+    "    # Measure only the control_register and not the work_register\n",
+    "    mz(control_register)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 201,
+   "id": "ca9b570a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮                                                                    »\n",
+      "q0 : ┤ h ├──●────●────●───●──●────────────────────────────────────────────────»\n",
+      "     ├───┤  │    │    │   │  │                                                »\n",
+      "q1 : ┤ h ├──┼────┼────┼───┼──┼───●────●────●───●──●───●────●────●───●──●──────»\n",
+      "     ├───┤  │    │    │   │  │   │    │    │   │  │   │    │    │   │  │      »\n",
+      "q2 : ┤ h ├──┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───●──»\n",
+      "     ├───┤╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮»\n",
+      "q3 : ┤ x ├┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├»\n",
+      "     ╰───╯╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯»\n",
+      "q4 : ────────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼──────»\n",
+      "               ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      »\n",
+      "q5 : ──────────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────»\n",
+      "               ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         »\n",
+      "q6 : ─────────────────┼───┼────────────────┼───┼────────────────┼───┼─────────»\n",
+      "                    ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │         »\n",
+      "q7 : ───────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─────────»\n",
+      "                    ╰───╯                ╰───╯                ╰───╯           »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                                                                            »\n",
+      "────────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                            »\n",
+      "────────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                            »\n",
+      "──●────●───●──●───●────●────●───●──●───●────●────●───●──●───●────●────●───●─»\n",
+      "  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │ »\n",
+      "──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳─»\n",
+      "  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │ »\n",
+      "──┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼─»\n",
+      "╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │ »\n",
+      "┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼─»\n",
+      "╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │ »\n",
+      "───────┼───┼────────────────┼───┼────────────────┼───┼────────────────┼───┼─»\n",
+      "     ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │ »\n",
+      "─────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─»\n",
+      "     ╰───╯                ╰───╯                ╰───╯                ╰───╯   »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                           ╭─────────────╮╭────────────╮╭───╮\n",
+      "───────────────────────────┤ r1(-0.7854) ├┤ r1(-1.571) ├┤ h ├\n",
+      "        ╭────────────╮╭───╮╰──────┬──────╯╰─────┬──────╯╰───╯\n",
+      "────────┤ r1(-1.571) ├┤ h ├───────┼─────────────●────────────\n",
+      "   ╭───╮╰─────┬──────╯╰───╯       │                          \n",
+      "─●─┤ h ├──────●───────────────────●──────────────────────────\n",
+      " │ ╰───╯                                                     \n",
+      "─╳───────────────────────────────────────────────────────────\n",
+      " │                                                           \n",
+      "─┼───────────────────────────────────────────────────────────\n",
+      " │                                                           \n",
+      "─╳───────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "─────────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "─────────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "\n",
+      "Measurement results for a=5 and N=21 with 3 qubits in the control register \n",
+      "{ 000:2843 010:913 111:1850 001:1935 011:1830 100:2846 101:1861 110:922 }\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "control_register_size = 3\n",
+    "work_register_size = 5\n",
+    "values_for_a = [4, 5]\n",
+    "idx = 1  # change to 1 to select 5\n",
+    "N = 21\n",
+    "shots = 15000\n",
+    "\n",
+    "print(\n",
+    "    cudaq.draw(phase_kernel, control_register_size, work_register_size,\n",
+    "               values_for_a[idx], N))\n",
+    "\n",
+    "results = cudaq.sample(phase_kernel,\n",
+    "                       control_register_size,\n",
+    "                       work_register_size,\n",
+    "                       values_for_a[idx],\n",
+    "                       N,\n",
+    "                       shots_count=shots)\n",
+    "print(\n",
+    "    \"Measurement results for a={} and N={} with {} qubits in the control register \"\n",
+    "    .format(values_for_a[idx], N, control_register_size))\n",
+    "print(results)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4718d04f",
+   "metadata": {},
+   "source": [
+    "### Determining the order from the measurement results of the phase kernel\n",
+    "\n",
+    "The measurement results from sampling the `phase_kernel` can be used to estimate the phase of the operator $U|x\\rangle = ax\\mod N$. We will only be interested in the most probable non-zero outcomes of the sampling.  Therefore, we'll create a function `top_results` to extract those values."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 202,
+   "id": "9e96846f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def top_results(sample_results, zeros, threshold):\n",
+    "    \"\"\"Function to output the non-zero results whose counts are above the given threshold\n",
+    "    Returns\n",
+    "    -------\n",
+    "        dict[str, int]: keys are bit-strings and values are the respective counts  \n",
+    "    \"\"\"\n",
+    "    results_dictionary = {k: v for k, v in sample_results.items()}\n",
+    "    if zeros in results_dictionary.keys():\n",
+    "        results_dictionary.pop(zeros)\n",
+    "    sorted_results = {\n",
+    "        k: v for k, v in sorted(\n",
+    "            results_dictionary.items(), key=lambda item: item[1], reverse=True)\n",
+    "    }\n",
+    "    top_key = next(iter(sorted_results))\n",
+    "    max_value = sorted_results[top_key]\n",
+    "    top_results_dictionary = {top_key: max_value}\n",
+    "\n",
+    "    for key in sorted_results:\n",
+    "        if results_dictionary[key] > min(threshold, max_value):\n",
+    "            top_results_dictionary[key] = results_dictionary[key]\n",
+    "    return top_results_dictionary"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b55ab5a",
+   "metadata": {},
+   "source": [
+    "Let's see how the `top_results` extracts the top results from the measurement results for a=4 and N=21 with 3 qubits in the control register that we computed above.  One of these top result is likely to be an estimate for the phase of $U$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 203,
+   "id": "cb717231",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'100': 2846,\n",
+       " '001': 1935,\n",
+       " '101': 1861,\n",
+       " '111': 1850,\n",
+       " '011': 1830,\n",
+       " '110': 922,\n",
+       " '010': 913}"
+      ]
+     },
+     "execution_count": 203,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example\n",
+    "top_results(results, '000', 750)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "cda8137a",
+   "metadata": {},
+   "source": [
+    "The algorithm for translating the phase estimate of the operator $U|x\\rangle = ax\\mod N$ into the order of $a \\mod N$ involves continued fractions. The function `find_order_quantum` below carries out this computation.  To learn more about how the phase of $U$ relates to the period of $a \\mod N$, check out these three lectures by Scott Aaronson: lecture [19](https://www.scottaaronson.com/qclec/19.pdf), [20](https://www.scottaaronson.com/qclec/20.pdf), [21](https://www.scottaaronson.com/qclec/21.pdf)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 204,
+   "id": "a562fde9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_order_from_phase(phase, phase_nbits, a, N):\n",
+    "    \"\"\"Uses continued fractions to find the order of a mod N  \n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    phase: int\n",
+    "        Integer result from the phase estimate of U|x> = ax mod N\n",
+    "    phase_nbits: int\n",
+    "        Number of qubits used to estimate the phase\n",
+    "    a: int\n",
+    "        For this demonstration a is either 4 or 5\n",
+    "    N: int\n",
+    "        For this demonstration N = 21\n",
+    "    Returns\n",
+    "    -------\n",
+    "    int: period of a mod N if found, otherwise returns None\n",
+    "    \"\"\"\n",
+    "\n",
+    "    assert phase_nbits > 0\n",
+    "    assert a > 0\n",
+    "    assert N > 0\n",
+    "\n",
+    "    eigenphase = float(phase) / 2**(phase_nbits)\n",
+    "\n",
+    "    f = fractions.Fraction.from_float(eigenphase).limit_denominator(N)\n",
+    "\n",
+    "    if f.numerator == 1:\n",
+    "        return None\n",
+    "    eigenphase = float(f.numerator / f.denominator)\n",
+    "    print('eigenphase is ', eigenphase)\n",
+    "    coefficients_continued_fraction = list(\n",
+    "        contfrac.continued_fraction(eigenphase))\n",
+    "    \n",
+    "    convergents_continued_fraction = list(contfrac.convergents(eigenphase))\n",
+    "    print('convergent sequence of fractions for this eigenphase is', convergents_continued_fraction)\n",
+    "    for r in convergents_continued_fraction:\n",
+    "        print('using the denominators of the fractions in the convergent sequence, testing order =', r[1])\n",
+    "        if a**r[1] % N == 1:\n",
+    "            print('Found order:', r[1])\n",
+    "            return (r[1])\n",
+    "    return None\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "47511fbe",
+   "metadata": {},
+   "source": [
+    "We are now ready to combine all the elements above into a function to find the order of $a$ $\\mod N$ and test it in the factoring algoithm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 205,
+   "id": "7ad0abcf",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_order_quantum(a, N):\n",
+    "    \"\"\"The quantum algorithm to find the order of a mod N, when x = 4 or x =5 and N = 21\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "        For this demonstration a will be either 4 or 5\n",
+    "    N: int\n",
+    "        For this demonstration N will be 21\n",
+    "    Returns\n",
+    "    r: int the period if it is found, or None if no period is found\n",
+    "    -------\n",
+    "    \n",
+    "    \"\"\"\n",
+    "\n",
+    "    if (a == 4 and N == 21) or (a == 5 and N == 21):\n",
+    "        shots = 15000\n",
+    "        if a == 4 and N == 21:\n",
+    "            control_register_size = 3\n",
+    "            work_register_size = 2\n",
+    "        if a == 5 and N == 21:\n",
+    "            control_register_size = 5\n",
+    "            work_register_size = 5\n",
+    "\n",
+    "        #cudaq.set_random_seed(123)\n",
+    "        results = cudaq.sample(phase_kernel,\n",
+    "                               control_register_size,\n",
+    "                               work_register_size,\n",
+    "                               a,\n",
+    "                               N,\n",
+    "                               shots_count=shots)\n",
+    "        print(\"Measurement results:\")\n",
+    "        print(results)\n",
+    "\n",
+    "        # We will want to ignore the all zero result\n",
+    "        zero_result = ''.join(\n",
+    "            [str(elem) for elem in [0] * control_register_size])\n",
+    "        # We'll only consider the top results from the sampling\n",
+    "        threshold = shots * (.1)\n",
+    "        most_probable_bitpatterns = top_results(results, zero_result, threshold)\n",
+    "\n",
+    "        for key in most_probable_bitpatterns:\n",
+    "            # Convert the key bit string into an integer \n",
+    "            # This integer divided by 8 is an estimate for the phase\n",
+    "            reverse_result = key[::-1]\n",
+    "            phase = int(reverse_result, 2)\n",
+    "            \n",
+    "            print(\"Trying nonzero bitpattern from the phase estimation:\", key,\n",
+    "                  \"=\", phase)\n",
+    "            r = get_order_from_phase(phase, control_register_size, a, N)\n",
+    "            if r == None:\n",
+    "                print('No period found.')\n",
+    "\n",
+    "                continue\n",
+    "\n",
+    "            return r\n",
+    "            break\n",
+    "    else:\n",
+    "        print(\n",
+    "            \"A different quantum kernel is required for this choice of a and N.\"\n",
+    "        )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 206,
+   "id": "79927898",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Trying a = 5\n",
+      "Measurement results:\n",
+      "{ 11010:452 11001:92 11101:47 00000:2485 01001:96 00100:131 01011:1747 00101:1654 10101:1736 00110:475 11111:23 01000:50 01101:38 01110:35 01010:420 11110:22 01111:26 00011:50 01100:120 10011:35 00010:25 00001:22 11011:1710 00111:79 11100:113 10001:14 10010:29 10100:129 10110:467 10000:2536 10111:81 11000:61 }\n",
+      "\n",
+      "Trying nonzero bitpattern from the phase estimation: 10000 = 1\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 01011 = 26\n",
+      "eigenphase is  0.8125\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (4, 5), (13, 16)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 5\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 16\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 10101 = 21\n",
+      "eigenphase is  0.65\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (1, 2), (2, 3), (13, 20)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 2\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 3\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 20\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 11011 = 27\n",
+      "eigenphase is  0.8421052631578947\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (5, 6), (16, 19)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 6\n",
+      "Found order: 6\n",
+      "The order of a =5 is 6\n",
+      "Found factors of N = 21: 7 and 3\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "(7, 3)"
+      ]
+     },
+     "execution_count": 206,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "my_integer = 21\n",
+    "initial_value_to_start = 5  # Try replacing 5 with 4\n",
+    "quantum = True\n",
+    "shors_algorithm(my_integer, initial_value_to_start, quantum)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c243a5ee",
+   "metadata": {},
+   "source": [
+    "### Postscript\n",
+    "Recent [work of Oded Regev](https://arxiv.org/abs/2308.06572) improves Shor's Algorithm by reducing the number of gates needed.  You can read more about it [here](https://www.quantamagazine.org/thirty-years-later-a-speed-boost-for-quantum-factoring-20231017/)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "db11e690",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/examples/python/tutorials/afqmc.html b/pr-2241/examples/python/tutorials/afqmc.html
new file mode 100644
index 0000000000..7f38edf7e3
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/afqmc.html
@@ -0,0 +1,1047 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quantum Enhanced Auxiliary Field Quantum Monte Carlo &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Deutsch’s Algorithm" href="deutschs_algorithm.html" />
+    <link rel="prev" title="CUDA-Q Tutorials" href="../../../using/tutorials.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/afqmc.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../../../using/tutorials.html" class="btn btn-neutral float-left" title="CUDA-Q Tutorials" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="deutschs_algorithm.html" class="btn btn-neutral float-right" title="Deutsch’s Algorithm" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Quantum-Enhanced-Auxiliary-Field-Quantum-Monte-Carlo">
+<h1>Quantum Enhanced Auxiliary Field Quantum Monte Carlo<a class="headerlink" href="#Quantum-Enhanced-Auxiliary-Field-Quantum-Monte-Carlo" title="Permalink to this heading">¶</a></h1>
+<p>This work was done in collaboration with the Next Generation Computing team at <a class="reference external" href="https://www.basf.com/global/en.html">BASF</a>.</p>
+<p>In this tutorial we implement a quantum-classical hybrid workflow for computing the ground state energies of a strongly interacting molecular system. The algorithm consists of two parts:</p>
+<ol class="arabic simple">
+<li><p>A variational quantum eigensolver that uses the quantum-number-preserving ansatz proposed by <a class="reference external" href="https://doi.org/10.1088/1367-2630/ac2cb3">Anselmetti et al. (2021)</a> to generate a quantum trial wave function <span class="math notranslate nohighlight">\(|\Psi_T\rangle\)</span> using CUDA Quantum.</p></li>
+<li><p>An Auxiliary-Field Quantum Monte Carlo simulation that realizes a classical imaginary time evolution and collects the ground state energy estimates.</p></li>
+</ol>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Package installs</span>
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">pyscf</span><span class="o">==</span><span class="m">2</span>.6.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">openfermion</span><span class="o">==</span><span class="m">1</span>.6.1
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">ipie</span><span class="o">==</span><span class="m">0</span>.7.1
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Relevant imports</span>
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+
+<span class="kn">from</span> <span class="nn">pyscf</span> <span class="kn">import</span> <span class="n">gto</span><span class="p">,</span> <span class="n">scf</span><span class="p">,</span> <span class="n">ao2mo</span><span class="p">,</span> <span class="n">mcscf</span>
+
+<span class="kn">from</span> <span class="nn">afqmc_src.vqe_cudaq_qnp</span> <span class="kn">import</span> <span class="n">VQE</span><span class="p">,</span> <span class="n">get_cudaq_hamiltonian</span>
+<span class="kn">from</span> <span class="nn">afqmc_src.utils_ipie</span> <span class="kn">import</span> <span class="n">get_coeff_wf</span><span class="p">,</span> <span class="n">gen_ipie_input_from_pyscf_chk</span>
+
+<span class="kn">from</span> <span class="nn">ipie.hamiltonians.generic</span> <span class="kn">import</span> <span class="n">Generic</span> <span class="k">as</span> <span class="n">HamGeneric</span>
+<span class="kn">from</span> <span class="nn">ipie.qmc.afqmc</span> <span class="kn">import</span> <span class="n">AFQMC</span>
+<span class="kn">from</span> <span class="nn">ipie.systems.generic</span> <span class="kn">import</span> <span class="n">Generic</span>
+<span class="kn">from</span> <span class="nn">ipie.trial_wavefunction.particle_hole</span> <span class="kn">import</span> <span class="n">ParticleHole</span>
+<span class="kn">from</span> <span class="nn">ipie.analysis.extraction</span> <span class="kn">import</span> <span class="n">extract_observable</span>
+
+<span class="kn">from</span> <span class="nn">ipie.config</span> <span class="kn">import</span> <span class="n">config</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+
+<span class="c1"># Ipie has recently added GPU support however this remains a bit tricky to use as it requires manual installation of several packages.</span>
+<span class="c1"># Once this is streamlined, we can set the GPU option to True in the tutorial.</span>
+<span class="n">config</span><span class="o">.</span><span class="n">update_option</span><span class="p">(</span><span class="s2">&quot;use_gpu&quot;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<p>We start by defining the structure of the molecule, the basis set, and its spin. We build the molecule object with PySCF and run a preliminary Hartree-Fock computation. Here we choose as an example a <a class="reference external" href="https://doi.org/10.1021/acs.jctc.3c01375">chelating agent</a> representing a relevant class of substances industrially produced at large scales. Their use ranges, among the others, from water softeners in cleaning applications, modulators of redox behaviour in oxidative bleaching, scale
+suppressants, soil remediation and ligands for catalysts. In particular we focus here in a Fe(III)-NTA complex whose structure is given in the file imported below.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define the molecular structure and the basis set for the Fenta molecule.</span>
+
+<span class="n">atom</span> <span class="o">=</span> <span class="s2">&quot;afqmc_src/geo_fenta.xyz&quot;</span>
+<span class="n">basis</span> <span class="o">=</span> <span class="s2">&quot;cc-pVTZ&quot;</span>
+<span class="n">spin</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="n">num_active_orbitals</span> <span class="o">=</span> <span class="mi">5</span>
+<span class="n">num_active_electrons</span> <span class="o">=</span> <span class="mi">5</span>
+
+<span class="c1"># You can swap to O3 which is a smaller system and takes less computational resources and time to run.</span>
+
+<span class="n">atom</span> <span class="o">=</span> <span class="s2">&quot;afqmc_src/geo_o3.xyz&quot;</span>
+<span class="n">basis</span> <span class="o">=</span> <span class="s2">&quot;cc-pVTZ&quot;</span>
+<span class="n">spin</span> <span class="o">=</span> <span class="mi">0</span>
+<span class="n">num_active_orbitals</span> <span class="o">=</span> <span class="mi">9</span>
+<span class="n">num_active_electrons</span> <span class="o">=</span> <span class="mi">12</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># PYSCF helps to build the molecule and run Hartree-Fock.</span>
+
+<span class="c1"># Define the molecule.</span>
+<span class="n">molecule</span> <span class="o">=</span> <span class="n">gto</span><span class="o">.</span><span class="n">M</span><span class="p">(</span><span class="n">atom</span><span class="o">=</span><span class="n">atom</span><span class="p">,</span> <span class="n">spin</span><span class="o">=</span><span class="n">spin</span><span class="p">,</span> <span class="n">basis</span><span class="o">=</span><span class="n">basis</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="c1"># Restriced open shell HF.</span>
+<span class="n">hartee_fock</span> <span class="o">=</span> <span class="n">scf</span><span class="o">.</span><span class="n">ROHF</span><span class="p">(</span><span class="n">molecule</span><span class="p">)</span>
+<span class="n">hartee_fock</span><span class="o">.</span><span class="n">chkfile</span> <span class="o">=</span> <span class="s2">&quot;afqmc_src/output.chk&quot;</span>
+
+<span class="c1"># Run Hartree-Fock.</span>
+<span class="n">hartee_fock</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+-224.34048064812262
+</pre></div></div>
+</div>
+<section id="Hamiltonian-preparation-for-VQE">
+<h2>Hamiltonian preparation for VQE<a class="headerlink" href="#Hamiltonian-preparation-for-VQE" title="Permalink to this heading">¶</a></h2>
+<p>Since this molecule contains of around 600 orbitals (which would correspond to 1200 qubits) and 143 total electrons, it is impossible to perform a full VQE with full statevector simulation. Therefore, we need to identify an active space with fewer orbitals and electrons that contribute to the strongly interacting part of the whole molecule. We then run a post Hartree-Fock computation with the PySCF’s built-in CASCI method in order to obtain the one-body (<span class="math notranslate nohighlight">\(t_{pq}\)</span>) and two-body
+(<span class="math notranslate nohighlight">\(V_{prqs}\)</span>) integrals that define the molecular Hamiltonian in the active space:</p>
+<div class="math notranslate nohighlight">
+\[H= \sum_{pq}t_{pq}\hat{a}_{p}^\dagger \hat {a}_{q}+\sum_{pqrs}  V_{prqs}\hat a_{p}^\dagger \hat a_{q}^\dagger \hat a_{s}\hat a_{r} \tag{1}\]</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">openfermion.transforms</span> <span class="kn">import</span> <span class="n">jordan_wigner</span>
+<span class="kn">from</span> <span class="nn">openfermion</span> <span class="kn">import</span> <span class="n">generate_hamiltonian</span>
+
+<span class="c1"># Run a CASCI simulation for computing the Hamiltonian in the active space.</span>
+<span class="n">casci</span> <span class="o">=</span> <span class="n">mcscf</span><span class="o">.</span><span class="n">CASCI</span><span class="p">(</span><span class="n">hartee_fock</span><span class="p">,</span> <span class="n">num_active_orbitals</span><span class="p">,</span> <span class="n">num_active_electrons</span><span class="p">)</span>
+<span class="n">casci</span><span class="o">.</span><span class="n">fix_spin_</span><span class="p">(</span><span class="n">ss</span><span class="o">=</span><span class="p">(</span><span class="n">molecule</span><span class="o">.</span><span class="n">spin</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">*</span> <span class="p">(</span><span class="n">molecule</span><span class="o">.</span><span class="n">spin</span> <span class="o">/</span> <span class="mi">2</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)))</span>
+
+
+<span class="c1"># Executes the kernel to compute the hamiltonian in the active space.</span>
+<span class="n">casci</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+
+<span class="c1"># Compute the one-body (h1) and two-body integrals (tbi) as shown in equation 1.</span>
+<span class="n">h1</span><span class="p">,</span> <span class="n">energy_core</span> <span class="o">=</span> <span class="n">casci</span><span class="o">.</span><span class="n">get_h1eff</span><span class="p">()</span>
+
+<span class="n">h2</span> <span class="o">=</span> <span class="n">casci</span><span class="o">.</span><span class="n">get_h2eff</span><span class="p">()</span>
+<span class="n">h2_no_symmetry</span> <span class="o">=</span> <span class="n">ao2mo</span><span class="o">.</span><span class="n">restore</span><span class="p">(</span><span class="s1">&#39;1&#39;</span><span class="p">,</span> <span class="n">h2</span><span class="p">,</span> <span class="n">num_active_orbitals</span><span class="p">)</span>
+
+<span class="c1"># V_pqrs terms in H.</span>
+<span class="n">tbi</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">asarray</span><span class="p">(</span><span class="n">h2_no_symmetry</span><span class="o">.</span><span class="n">transpose</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">1</span><span class="p">),</span> <span class="n">order</span><span class="o">=</span><span class="s1">&#39;C&#39;</span><span class="p">)</span>
+
+<span class="c1"># Compute the hamiltonian and convert it to a CUDA-Q operator.</span>
+<span class="n">mol_ham</span> <span class="o">=</span> <span class="n">generate_hamiltonian</span><span class="p">(</span><span class="n">h1</span><span class="p">,</span> <span class="n">tbi</span><span class="p">,</span> <span class="n">energy_core</span><span class="o">.</span><span class="n">item</span><span class="p">())</span>
+<span class="n">jw_hamiltonian</span> <span class="o">=</span> <span class="n">jordan_wigner</span><span class="p">(</span><span class="n">mol_ham</span><span class="p">)</span>
+<span class="n">hamiltonian</span><span class="p">,</span> <span class="n">constant_term</span> <span class="o">=</span> <span class="n">get_cudaq_hamiltonian</span><span class="p">(</span><span class="n">jw_hamiltonian</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+</section>
+<section id="Run-VQE-with-CUDA-Q">
+<h2>Run VQE with CUDA-Q<a class="headerlink" href="#Run-VQE-with-CUDA-Q" title="Permalink to this heading">¶</a></h2>
+<p>We can now execute the VQE algorithm using the quantum number preserving ansatz. At the end of the VQE, we store the final statevector that will be used in the classical AFQMC computation as an initial guess.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define some options for the VQE.</span>
+<span class="n">options</span> <span class="o">=</span> <span class="p">{</span>
+ <span class="s1">&#39;n_vqe_layers&#39;</span><span class="p">:</span> <span class="mi">1</span><span class="p">,</span>
+ <span class="s1">&#39;maxiter&#39;</span><span class="p">:</span> <span class="mi">100</span><span class="p">,</span>
+ <span class="s1">&#39;energy_core&#39;</span><span class="p">:</span> <span class="n">constant_term</span><span class="p">,</span>
+ <span class="s1">&#39;return_final_state_vec&#39;</span><span class="p">:</span> <span class="kc">True</span>
+<span class="p">}</span>
+
+<span class="n">n_qubits</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">num_active_orbitals</span>
+
+<span class="n">vqe</span> <span class="o">=</span> <span class="n">VQE</span><span class="p">(</span><span class="n">n_qubits</span><span class="o">=</span><span class="n">n_qubits</span><span class="p">,</span>
+ <span class="n">num_active_electrons</span><span class="o">=</span><span class="n">num_active_electrons</span><span class="p">,</span>
+ <span class="n">spin</span><span class="o">=</span><span class="n">spin</span><span class="p">,</span>
+ <span class="n">options</span><span class="o">=</span><span class="n">options</span>
+<span class="p">)</span>
+
+<span class="n">results</span> <span class="o">=</span> <span class="n">vqe</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">hamiltonian</span><span class="p">)</span>
+
+<span class="c1"># Best energy from VQE.</span>
+<span class="n">optimized_energy</span> <span class="o">=</span> <span class="n">results</span><span class="p">[</span><span class="s1">&#39;energy_optimized&#39;</span><span class="p">]</span>
+
+<span class="c1"># Final state vector.</span>
+<span class="n">final_state_vector</span> <span class="o">=</span> <span class="n">results</span><span class="p">[</span><span class="s2">&quot;state_vec&quot;</span><span class="p">]</span>
+
+<span class="c1"># Energies during the optimization loop.</span>
+<span class="n">vqe_energies</span> <span class="o">=</span> <span class="n">results</span><span class="p">[</span><span class="s2">&quot;callback_energies&quot;</span><span class="p">]</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+# Using cudaq optimizer
+# Num Params: 16
+# Qubits: 18
+# N_layers: 1
+# Energy after the VQE: -224.3901690611431
+</pre></div></div>
+</div>
+</section>
+<section id="Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">
+<h2>Auxiliary Field Quantum Monte Carlo (AFQMC)<a class="headerlink" href="#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)" title="Permalink to this heading">¶</a></h2>
+<p>AFQMC is a numerical method for computing relevant properties of strongly interacting molecules. AFQMC is a type of Quantum Monte Carlo method that combines the use of random walks with an auxiliary field to simulate the imaginary-time evolution of a quantum system and drive it to the lowest energy state. This method can provide accurate results for ground-state properties of a wide range of physical systems, including atoms, molecules, and solids. Here we summarize the main features of AFQMC
+while a detailed introduction to can be found <a class="reference external" href="https://www.cond-mat.de/events/correl13/manuscripts/zhang.pdf">here</a>.</p>
+<p>We consider the electronic Hamiltonian in the second quantization <span class="math">\begin{equation}
+H = {H}_1 + {H}_2
+=\sum_{pq} h_{pq} {a}_{p}^{\dagger} {a}_{q} + \frac{1}{2} \sum_{pqrs} v_{pqrs}{a}_{p}^{\dagger} {a}_r {a}^{\dagger}_{q} {a}_s \tag{2}
+\end{equation}</span> where <span class="math notranslate nohighlight">\({a}_{p}^{\dagger}\)</span> and <span class="math notranslate nohighlight">\({a}_{q}\)</span> are fermionic creation and annihilation operators of orbitals <span class="math notranslate nohighlight">\(p\)</span> and <span class="math notranslate nohighlight">\(q\)</span>, respectively. The terms $h_{pq} $ and <span class="math notranslate nohighlight">\(v_{pqrs}\)</span> are the matrix elements of the one-body, <span class="math notranslate nohighlight">\(H_1\)</span>, and two-body, <span class="math notranslate nohighlight">\(H_2\)</span>, interactions of <span class="math notranslate nohighlight">\(H\)</span>, respectively. Here, we omit the spin indices for simplicity.</p>
+<p>AFQMC realizes an imaginary time propagation of an initial state (chosen as a Slater determinant) <span class="math notranslate nohighlight">\(\ket{\Psi_{I}}\)</span> towards the ground state <span class="math notranslate nohighlight">\(\ket{\Psi_0}\)</span> of a given hamiltonian, <span class="math notranslate nohighlight">\(H\)</span>, with <span class="math">\begin{equation}
+\ket{\Psi_0} \sim\lim_{n \to \infty} \left[ e^{-\Delta\tau H  }  \right]^{n} \ket{\Psi_{I}}
+\tag{3}
+\end{equation}</span> where <span class="math notranslate nohighlight">\(\Delta\tau\)</span> is the imaginary time step.</p>
+<p>AFQMC relies on decomposing the two-body interactions <span class="math notranslate nohighlight">\(H_2\)</span> in terms of sum of squares of one-body operators <span class="math notranslate nohighlight">\({v}_\gamma\)</span> such that the Hamiltonian <span class="math notranslate nohighlight">\({H}\)</span> becomes <span class="math">\begin{equation}
+H = v_0 - \frac{1}{2}\sum_{\gamma=1}^{N_\gamma} {v}_\gamma^2
+\tag{4}
+\end{equation}</span> with ${v}<em>0 = {H}1 $ and $ {v}:nbsphinx-math:`gamma `= i :nbsphinx-math:`sum`</em>{pq} L<sup>{:nbsphinx-math:</sup>gamma`}{pq} {a}{p}`{<span class="math">\dagger</span>}{a}_{q}. $ The <span class="math notranslate nohighlight">\(N_\gamma\)</span> matrices <span class="math notranslate nohighlight">\(L^{\gamma}_{pq}\)</span> are called Cholesky vectors as they are obtained via a Cholesky decomposition of the two-body matrix elements <span class="math notranslate nohighlight">\(v_{pqrs}\)</span> via <span class="math notranslate nohighlight">\(v_{pqrs} = \sum_{\gamma=1}^{N_\gamma} L^{\gamma}_{pr} L^{\gamma}_{qs}\)</span>.</p>
+<p>The imaginary time propagation evolves an ensemble of walkers <span class="math notranslate nohighlight">\(\{\phi^{(n)}\}\)</span> (that are Slater determinants) and allows one to access observables of the system. For example, the local energy <span class="math">\begin{equation}
+\mathcal{E}_{\text{loc}}(\phi^{(n)}) = \frac{\bra{\Psi_\mathrm{T}}H\ket{\phi^{(n)}}}{\braket{\Psi_\mathrm{T}| \phi^{(n)}}}
+\tag{5}
+\end{equation}</span> defined as the mixed expectation value of the Hamiltonian with the trial wave function <span class="math notranslate nohighlight">\(\ket{\Psi_\mathrm{T}}\)</span>.</p>
+<p>The trial wavefunction can be in general a single or a multi-Slater determinant coming from VQE for example. This might help in achieving more accurate ground state energy estimates.</p>
+<p>The implementation of AFQMC we use here is from <a class="reference external" href="https://github.com/JoonhoLee-Group/ipie">ipie</a> that supports both CPUs and GPUs and requires the following steps:</p>
+<ol class="arabic simple">
+<li><p>Preparation of the molecular Hamiltonian by performing the Cholesky decomposition</p></li>
+<li><p>Preparation of the trial state from the VQE wavefunction</p></li>
+<li><p>Executing AFQMC</p></li>
+</ol>
+</section>
+<section id="Preparation-of-the-molecular-Hamiltonian">
+<h2>Preparation of the molecular Hamiltonian<a class="headerlink" href="#Preparation-of-the-molecular-Hamiltonian" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># AFQMC.</span>
+
+<span class="c1"># Generate the input Hamiltonian for ipie from the checkpoint file from pyscf.</span>
+<span class="n">ipie_hamiltonian</span> <span class="o">=</span> <span class="n">gen_ipie_input_from_pyscf_chk</span><span class="p">(</span><span class="n">hartee_fock</span><span class="o">.</span><span class="n">chkfile</span><span class="p">,</span>
+            <span class="n">mcscf</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+            <span class="n">chol_cut</span><span class="o">=</span><span class="mf">1e-5</span><span class="p">)</span>
+
+
+<span class="n">h1e</span><span class="p">,</span> <span class="n">cholesky_vectors</span><span class="p">,</span> <span class="n">e0</span> <span class="o">=</span> <span class="n">ipie_hamiltonian</span>
+
+
+<span class="n">num_basis</span> <span class="o">=</span> <span class="n">cholesky_vectors</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
+<span class="n">num_chol</span> <span class="o">=</span> <span class="n">cholesky_vectors</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+
+
+<span class="n">system</span> <span class="o">=</span> <span class="n">Generic</span><span class="p">(</span><span class="n">nelec</span><span class="o">=</span><span class="n">molecule</span><span class="o">.</span><span class="n">nelec</span><span class="p">)</span>
+
+
+<span class="n">afqmc_hamiltonian</span> <span class="o">=</span> <span class="n">HamGeneric</span><span class="p">(</span>
+ <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="n">h1e</span><span class="p">,</span> <span class="n">h1e</span><span class="p">]),</span>
+ <span class="n">cholesky_vectors</span><span class="o">.</span><span class="n">transpose</span><span class="p">((</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">0</span><span class="p">))</span><span class="o">.</span><span class="n">reshape</span><span class="p">((</span><span class="n">num_basis</span> <span class="o">*</span> <span class="n">num_basis</span><span class="p">,</span> <span class="n">num_chol</span><span class="p">)),</span>
+ <span class="n">e0</span>
+<span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+# Number of electrons in simulation: (12, 12)
+</pre></div></div>
+</div>
+</section>
+<section id="Preparation-of-the-trial-wave-function">
+<h2>Preparation of the trial wave function<a class="headerlink" href="#Preparation-of-the-trial-wave-function" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Build the trial wavefunction from the state vector computed via VQE.</span>
+<span class="n">wavefunction</span> <span class="o">=</span> <span class="n">get_coeff_wf</span><span class="p">(</span><span class="n">final_state_vector</span><span class="p">,</span>
+ <span class="n">n_active_elec</span><span class="o">=</span><span class="n">num_active_electrons</span><span class="p">,</span>
+ <span class="n">spin</span><span class="o">=</span><span class="n">spin</span>
+<span class="p">)</span>
+
+
+<span class="n">trial</span> <span class="o">=</span> <span class="n">ParticleHole</span><span class="p">(</span><span class="n">wavefunction</span><span class="p">,</span>
+ <span class="n">molecule</span><span class="o">.</span><span class="n">nelec</span><span class="p">,</span>
+ <span class="n">num_basis</span><span class="p">,</span>
+ <span class="n">num_dets_for_props</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">wavefunction</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span>
+ <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span>
+<span class="p">)</span>
+
+
+<span class="n">trial</span><span class="o">.</span><span class="n">compute_trial_energy</span> <span class="o">=</span> <span class="kc">True</span>
+<span class="n">trial</span><span class="o">.</span><span class="n">build</span><span class="p">()</span>
+<span class="n">trial</span><span class="o">.</span><span class="n">half_rotate</span><span class="p">(</span><span class="n">afqmc_hamiltonian</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+</section>
+<section id="Setup-of-the-AFQMC-parameters">
+<h2>Setup of the AFQMC parameters<a class="headerlink" href="#Setup-of-the-AFQMC-parameters" title="Permalink to this heading">¶</a></h2>
+<p>Here we can choose the input options like the timestep <span class="math notranslate nohighlight">\(\Delta\tau\)</span>, the total number of walkers <code class="docutils literal notranslate"><span class="pre">num_walkers</span></code> and the total number of AFQMC iterations <code class="docutils literal notranslate"><span class="pre">num_blocks</span></code>.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Setup the AFQMC parameters.</span>
+<span class="n">afqmc_msd</span> <span class="o">=</span> <span class="n">AFQMC</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="n">molecule</span><span class="o">.</span><span class="n">nelec</span><span class="p">,</span>
+ <span class="n">afqmc_hamiltonian</span><span class="p">,</span>
+ <span class="n">trial</span><span class="p">,</span>
+ <span class="n">num_walkers</span><span class="o">=</span><span class="mi">100</span><span class="p">,</span>
+ <span class="n">num_steps_per_block</span><span class="o">=</span><span class="mi">25</span><span class="p">,</span>
+ <span class="n">num_blocks</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span>
+ <span class="n">timestep</span><span class="o">=</span><span class="mf">0.005</span><span class="p">,</span>
+ <span class="n">stabilize_freq</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span>
+ <span class="n">seed</span><span class="o">=</span><span class="mi">96264512</span><span class="p">,</span>
+ <span class="n">pop_control_freq</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span>
+ <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span>
+<span class="p">)</span>
+
+
+<span class="c1"># Run the AFQMC.</span>
+<span class="n">afqmc_msd</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">estimator_filename</span> <span class="o">=</span> <span class="s1">&#39;afqmc_src/estimates.0.h5&#39;</span><span class="p">)</span>
+<span class="n">afqmc_msd</span><span class="o">.</span><span class="n">finalise</span><span class="p">(</span><span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+
+
+<span class="c1"># Extract the energies.</span>
+<span class="n">qmc_data</span> <span class="o">=</span> <span class="n">extract_observable</span><span class="p">(</span><span class="n">afqmc_msd</span><span class="o">.</span><span class="n">estimators</span><span class="o">.</span><span class="n">filename</span><span class="p">,</span> <span class="s2">&quot;energy&quot;</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+# random seed is 96264512
+            Block                   Weight            WeightFactor            HybridEnergy                  ENumer                  EDenom                  ETotal                  E1Body                  E2Body
+                0   1.0000000000000000e+02  1.0000000000000000e+02  0.0000000000000000e+00 -2.2440857214519274e+04  1.0000000000000000e+02 -2.2440857214519275e+02 -3.7639365236571126e+02  1.5198508022051851e+02
+                1   4.2236163323978462e+02  1.4108003803708052e+03 -1.1705550836048852e+02 -2.2476129978632798e+04  9.9999999999999986e+01 -2.2476129978632804e+02 -3.7647651634374250e+02  1.5171521655741444e+02
+                2   1.0031021642240592e+02  3.8270298551287897e+02 -1.1736348706942081e+02 -2.2491539833590265e+04  1.0000000000000001e+02 -2.2491539833590261e+02 -3.7652287235836400e+02  1.5160747402246139e+02
+                3   9.9896411716010476e+01  1.0006803820092617e+02 -1.1729991834244650e+02 -2.2498086858011950e+04  1.0000000000000001e+02 -2.2498086858011945e+02 -3.7661217900078998e+02  1.5163131042067059e+02
+                4   1.0008819642734720e+02  1.0003952238189274e+02 -1.1741988525943451e+02 -2.2497768126542338e+04  1.0000000000000001e+02 -2.2497768126542334e+02 -3.7677859321228260e+02  1.5180091194685932e+02
+                5   9.9996395539611001e+01  1.0010162124437146e+02 -1.1745900551679516e+02 -2.2504859704025963e+04  1.0000000000000003e+02 -2.2504859704025955e+02 -3.7665382466690920e+02  1.5160522762664974e+02
+                6   1.0011117020963695e+02  1.0017267435124782e+02 -1.1762740654751367e+02 -2.2514761055266557e+04  1.0000000000000000e+02 -2.2514761055266558e+02 -3.7663824192346226e+02  1.5149063137079673e+02
+                7   9.9926957189505018e+01  9.9904869631265882e+01 -1.1757145502349162e+02 -2.2517665690169804e+04  1.0000000000000000e+02 -2.2517665690169804e+02 -3.7662872023157632e+02  1.5145206332987829e+02
+                8   9.9902183781120897e+01  9.9910184942535295e+01 -1.1753639400107765e+02 -2.2518490004346189e+04  9.9999999999999986e+01 -2.2518490004346194e+02 -3.7677944704924283e+02  1.5159454700578092e+02
+                9   1.0011182782239581e+02  1.0010647250586344e+02 -1.1771801521929217e+02 -2.2513893408438777e+04  1.0000000000000001e+02 -2.2513893408438773e+02 -3.7679469177919265e+02  1.5165575769480495e+02
+               10   9.9639946364053955e+01  9.9242085331654422e+01 -1.1742082647888712e+02 -2.2519016506034994e+04  1.0000000000000003e+02 -2.2519016506034987e+02 -3.7690149012513956e+02  1.5171132506478972e+02
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Plot the energies.</span>
+
+<span class="n">vqe_y</span> <span class="o">=</span> <span class="n">vqe_energies</span>
+<span class="n">vqe_x</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">vqe_y</span><span class="p">)))</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">vqe_x</span><span class="p">,</span> <span class="n">vqe_y</span><span class="p">,</span> <span class="n">label</span><span class="o">=</span><span class="s2">&quot;VQE&quot;</span><span class="p">)</span>
+
+<span class="n">afqmc_y</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">qmc_data</span><span class="p">[</span><span class="s2">&quot;ETotal&quot;</span><span class="p">])</span>
+<span class="n">afqmc_x</span> <span class="o">=</span> <span class="p">[</span><span class="n">i</span> <span class="o">+</span> <span class="n">vqe_x</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">list</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">afqmc_y</span><span class="p">)))]</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">afqmc_x</span><span class="p">,</span> <span class="n">afqmc_y</span><span class="p">,</span> <span class="n">label</span><span class="o">=</span><span class="s2">&quot;AFQMC&quot;</span><span class="p">)</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s2">&quot;Optimization steps&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s2">&quot;Energy [Ha]&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">legend</span><span class="p">()</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+&lt;matplotlib.legend.Legend at 0x7ab848ece110&gt;
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_afqmc_22_1.png" src="../../../_images/examples_python_tutorials_afqmc_22_1.png" />
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">__version__</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+CUDA-Q Version proto-0.8.0 (https://github.com/NVIDIA/cuda-quantum 57e1893b9a5b57ef1a1c2662bcf4527f87b9ef89)
+</pre></div></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../../../using/tutorials.html" class="btn btn-neutral float-left" title="CUDA-Q Tutorials" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="deutschs_algorithm.html" class="btn btn-neutral float-right" title="Deutsch’s Algorithm" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/afqmc.ipynb b/pr-2241/examples/python/tutorials/afqmc.ipynb
new file mode 100644
index 0000000000..76d62e3014
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/afqmc.ipynb
@@ -0,0 +1,531 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Quantum Enhanced Auxiliary Field Quantum Monte Carlo\n",
+    "\n",
+    "This work was done in collaboration with the Next Generation Computing team at [BASF](https://www.basf.com/global/en.html).\n",
+    "\n",
+    "In this tutorial we implement a quantum-classical hybrid workflow for computing the ground state energies of a strongly interacting molecular system. The algorithm consists of two parts:\n",
+    "\n",
+    "\n",
+    "1. A variational quantum eigensolver that uses the quantum-number-preserving ansatz proposed by [Anselmetti et al. (2021)](https://doi.org/10.1088/1367-2630/ac2cb3) to generate a quantum trial wave function $|\\Psi_T\\rangle$ using CUDA Quantum.\n",
+    "\n",
+    "2. An Auxiliary-Field Quantum Monte Carlo simulation that realizes a classical imaginary time evolution and collects the ground state energy estimates.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Package installs\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermion==1.6.1\n",
+    "!pip install ipie==0.7.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Relevant imports\n",
+    "\n",
+    "import cudaq\n",
+    "\n",
+    "import numpy as np\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "from pyscf import gto, scf, ao2mo, mcscf\n",
+    "\n",
+    "from afqmc_src.vqe_cudaq_qnp import VQE, get_cudaq_hamiltonian\n",
+    "from afqmc_src.utils_ipie import get_coeff_wf, gen_ipie_input_from_pyscf_chk\n",
+    "\n",
+    "from ipie.hamiltonians.generic import Generic as HamGeneric\n",
+    "from ipie.qmc.afqmc import AFQMC\n",
+    "from ipie.systems.generic import Generic\n",
+    "from ipie.trial_wavefunction.particle_hole import ParticleHole\n",
+    "from ipie.analysis.extraction import extract_observable\n",
+    "\n",
+    "from ipie.config import config\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "\n",
+    "# Ipie has recently added GPU support however this remains a bit tricky to use as it requires manual installation of several packages.\n",
+    "# Once this is streamlined, we can set the GPU option to True in the tutorial.\n",
+    "config.update_option(\"use_gpu\", False)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We start by defining the structure of the molecule, the basis set, and its spin. We build the molecule object with PySCF and run a preliminary Hartree-Fock computation. Here we choose as an example a [chelating agent](https://doi.org/10.1021/acs.jctc.3c01375) representing a relevant class of substances industrially produced at large scales. Their use ranges, among the others, from water softeners in cleaning applications, modulators of redox behaviour in oxidative bleaching, scale suppressants, soil remediation and ligands for catalysts. In particular we focus here in a Fe(III)-NTA complex whose structure is given in the file imported below.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define the molecular structure and the basis set for the Fenta molecule.\n",
+    "\n",
+    "atom = \"afqmc_src/geo_fenta.xyz\"\n",
+    "basis = \"cc-pVTZ\"\n",
+    "spin = 1\n",
+    "num_active_orbitals = 5\n",
+    "num_active_electrons = 5\n",
+    "\n",
+    "# You can swap to O3 which is a smaller system and takes less computational resources and time to run.\n",
+    "\n",
+    "atom = \"afqmc_src/geo_o3.xyz\"\n",
+    "basis = \"cc-pVTZ\"\n",
+    "spin = 0\n",
+    "num_active_orbitals = 9\n",
+    "num_active_electrons = 12\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "-224.34048064812262"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# PYSCF helps to build the molecule and run Hartree-Fock.\n",
+    "\n",
+    "# Define the molecule.\n",
+    "molecule = gto.M(atom=atom, spin=spin, basis=basis, verbose=0)\n",
+    "\n",
+    "# Restriced open shell HF.\n",
+    "hartee_fock = scf.ROHF(molecule)\n",
+    "hartee_fock.chkfile = \"afqmc_src/output.chk\"\n",
+    "\n",
+    "# Run Hartree-Fock.\n",
+    "hartee_fock.kernel()\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Hamiltonian preparation for VQE\n",
+    "\n",
+    "Since this molecule contains of around 600 orbitals (which would correspond to 1200 qubits) and 143 total electrons, it is impossible to perform a full VQE with full statevector simulation. Therefore, we need to identify an active space with fewer orbitals and electrons that contribute to the strongly interacting part of the whole molecule. We then run a post Hartree-Fock computation with the PySCF's built-in CASCI method in order to obtain the one-body ($t_{pq}$) and two-body \n",
+    "($V_{prqs}$) integrals that define the molecular Hamiltonian in the active space:\n",
+    "\n",
+    "$$ H= \\sum_{pq}t_{pq}\\hat{a}_{p}^\\dagger \\hat {a}_{q}+\\sum_{pqrs}  V_{prqs}\\hat a_{p}^\\dagger \\hat a_{q}^\\dagger \\hat a_{s}\\hat a_{r} \\tag{1}$$\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from openfermion.transforms import jordan_wigner\n",
+    "from openfermion import generate_hamiltonian\n",
+    "\n",
+    "# Run a CASCI simulation for computing the Hamiltonian in the active space.\n",
+    "casci = mcscf.CASCI(hartee_fock, num_active_orbitals, num_active_electrons)\n",
+    "casci.fix_spin_(ss=(molecule.spin / 2 * (molecule.spin / 2 + 1)))\n",
+    "\n",
+    "\n",
+    "# Executes the kernel to compute the hamiltonian in the active space.\n",
+    "casci.kernel()\n",
+    "\n",
+    "# Compute the one-body (h1) and two-body integrals (tbi) as shown in equation 1.\n",
+    "h1, energy_core = casci.get_h1eff()\n",
+    "\n",
+    "h2 = casci.get_h2eff()\n",
+    "h2_no_symmetry = ao2mo.restore('1', h2, num_active_orbitals)\n",
+    "\n",
+    "# V_pqrs terms in H.\n",
+    "tbi = np.asarray(h2_no_symmetry.transpose(0, 2, 3, 1), order='C')\n",
+    "\n",
+    "# Compute the hamiltonian and convert it to a CUDA-Q operator.\n",
+    "mol_ham = generate_hamiltonian(h1, tbi, energy_core.item())\n",
+    "jw_hamiltonian = jordan_wigner(mol_ham)\n",
+    "hamiltonian, constant_term = get_cudaq_hamiltonian(jw_hamiltonian)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Run VQE with CUDA-Q\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can now execute the VQE algorithm using the quantum number preserving ansatz. At the end of the VQE, we store the final statevector that will be used in the classical AFQMC computation as an initial guess.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Using cudaq optimizer\n",
+      "# Num Params: 16\n",
+      "# Qubits: 18\n",
+      "# N_layers: 1\n",
+      "# Energy after the VQE: -224.3901690611431\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Define some options for the VQE.\n",
+    "options = {\n",
+    " 'n_vqe_layers': 1,\n",
+    " 'maxiter': 100,\n",
+    " 'energy_core': constant_term,\n",
+    " 'return_final_state_vec': True\n",
+    "}\n",
+    "\n",
+    "n_qubits = 2 * num_active_orbitals\n",
+    "\n",
+    "vqe = VQE(n_qubits=n_qubits,\n",
+    " num_active_electrons=num_active_electrons,\n",
+    " spin=spin,\n",
+    " options=options\n",
+    ")\n",
+    "\n",
+    "results = vqe.execute(hamiltonian)\n",
+    "\n",
+    "# Best energy from VQE.\n",
+    "optimized_energy = results['energy_optimized']\n",
+    "\n",
+    "# Final state vector.\n",
+    "final_state_vector = results[\"state_vec\"]\n",
+    "\n",
+    "# Energies during the optimization loop.\n",
+    "vqe_energies = results[\"callback_energies\"]\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Auxiliary Field Quantum Monte Carlo (AFQMC)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "AFQMC is a numerical method for computing relevant properties of strongly interacting molecules. AFQMC is a type of Quantum Monte Carlo method that combines the use of random walks with an auxiliary field to simulate the imaginary-time evolution of a quantum system and drive it to the lowest energy state. This method can provide accurate results for ground-state properties of a wide range of physical systems, including atoms, molecules, and solids. Here we summarize the main features of AFQMC while a detailed introduction to can be found [here](https://www.cond-mat.de/events/correl13/manuscripts/zhang.pdf).\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We consider the electronic Hamiltonian in the second quantization\n",
+    "\\begin{equation}\n",
+    "H = {H}_1 + {H}_2 \n",
+    "=\\sum_{pq} h_{pq} {a}_{p}^{\\dagger} {a}_{q} + \\frac{1}{2} \\sum_{pqrs} v_{pqrs}{a}_{p}^{\\dagger} {a}_r {a}^{\\dagger}_{q} {a}_s \\tag{2}\n",
+    "\\end{equation}\n",
+    "where ${a}_{p}^{\\dagger}$ and ${a}_{q}$ are fermionic creation and annihilation operators of orbitals $p$ and $q$, respectively. The terms $h_{pq} $ and \n",
+    "$v_{pqrs}$ are the matrix elements of the one-body, $H_1$, and two-body, $H_2$, interactions of $H$, respectively. Here, we omit the spin indices for simplicity.\n",
+    "\n",
+    "AFQMC realizes an imaginary time propagation of an initial state (chosen as a Slater determinant) $\\ket{\\Psi_{I}}$ towards the ground state $\\ket{\\Psi_0}$ of a given hamiltonian, $H$, with\n",
+    "\\begin{equation}\n",
+    "\\ket{\\Psi_0} \\sim\\lim_{n \\to \\infty} \\left[ e^{-\\Delta\\tau H  }  \\right]^{n} \\ket{\\Psi_{I}}\n",
+    "\\tag{3}\n",
+    "\\end{equation} \n",
+    "where $\\Delta\\tau$ is the imaginary time step.\n",
+    "\n",
+    "AFQMC relies on decomposing the two-body interactions $H_2$ in terms of sum of squares of one-body operators ${v}_\\gamma$ such that the Hamiltonian ${H}$ becomes\n",
+    "\\begin{equation}\n",
+    "H = v_0 - \\frac{1}{2}\\sum_{\\gamma=1}^{N_\\gamma} {v}_\\gamma^2\n",
+    "\\tag{4}\n",
+    "\\end{equation}\n",
+    "with ${v}_0 = {H}_1 $ and $\n",
+    "{v}_\\gamma = i \\sum_{pq} L^{\\gamma}_{pq} {a}_{p}^{\\dagger}{a}_{q}.\n",
+    "$\n",
+    "The $N_\\gamma$ matrices $L^{\\gamma}_{pq}$ are called Cholesky vectors as they are  obtained via a Cholesky decomposition of the two-body matrix elements \n",
+    "$v_{pqrs}$ via $v_{pqrs} = \\sum_{\\gamma=1}^{N_\\gamma} L^{\\gamma}_{pr} L^{\\gamma}_{qs}$.\n",
+    "\n",
+    "The imaginary time propagation evolves an ensemble of walkers $\\{\\phi^{(n)}\\}$ (that are Slater determinants) and allows one to access observables of the system. For example, the local energy\n",
+    "\\begin{equation}\n",
+    "\\mathcal{E}_{\\text{loc}}(\\phi^{(n)}) = \\frac{\\bra{\\Psi_\\mathrm{T}}H\\ket{\\phi^{(n)}}}{\\braket{\\Psi_\\mathrm{T}| \\phi^{(n)}}}\n",
+    "\\tag{5}\n",
+    "\\end{equation}\n",
+    "defined as the mixed expectation value of the Hamiltonian with the trial wave function $\\ket{\\Psi_\\mathrm{T}}$.\n",
+    "\n",
+    "\n",
+    "The trial wavefunction can be in general a single or a multi-Slater determinant coming from VQE for example. This might help in achieving more accurate ground state energy estimates.\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "The implementation of AFQMC we use here is from [ipie](https://github.com/JoonhoLee-Group/ipie) that supports both CPUs and GPUs and requires the following steps:\n",
+    "\n",
+    "\n",
+    "1. Preparation of the molecular Hamiltonian by performing the Cholesky decomposition\n",
+    "\n",
+    "2. Preparation of the trial state from the VQE wavefunction\n",
+    "\n",
+    "3. Executing AFQMC\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Preparation of the molecular Hamiltonian\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Number of electrons in simulation: (12, 12)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# AFQMC.\n",
+    "\n",
+    "# Generate the input Hamiltonian for ipie from the checkpoint file from pyscf.\n",
+    "ipie_hamiltonian = gen_ipie_input_from_pyscf_chk(hartee_fock.chkfile,\n",
+    "            mcscf=True,\n",
+    "            chol_cut=1e-5)\n",
+    "\n",
+    "\n",
+    "h1e, cholesky_vectors, e0 = ipie_hamiltonian\n",
+    "\n",
+    "\n",
+    "num_basis = cholesky_vectors.shape[1]\n",
+    "num_chol = cholesky_vectors.shape[0]\n",
+    "\n",
+    "\n",
+    "system = Generic(nelec=molecule.nelec)\n",
+    "\n",
+    "\n",
+    "afqmc_hamiltonian = HamGeneric(\n",
+    " np.array([h1e, h1e]),\n",
+    " cholesky_vectors.transpose((1, 2, 0)).reshape((num_basis * num_basis, num_chol)),\n",
+    " e0\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Preparation of the trial wave function\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Build the trial wavefunction from the state vector computed via VQE.\n",
+    "wavefunction = get_coeff_wf(final_state_vector,\n",
+    " n_active_elec=num_active_electrons,\n",
+    " spin=spin\n",
+    ")\n",
+    "\n",
+    "\n",
+    "trial = ParticleHole(wavefunction,\n",
+    " molecule.nelec,\n",
+    " num_basis,\n",
+    " num_dets_for_props=len(wavefunction[0]),\n",
+    " verbose=False\n",
+    ")\n",
+    "\n",
+    "\n",
+    "trial.compute_trial_energy = True\n",
+    "trial.build()\n",
+    "trial.half_rotate(afqmc_hamiltonian)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Setup of the AFQMC parameters\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Here we can choose the input options like the timestep $\\Delta\\tau$, the total number of walkers `num_walkers` and the total number of AFQMC iterations `num_blocks`.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# random seed is 96264512\n",
+      "            Block                   Weight            WeightFactor            HybridEnergy                  ENumer                  EDenom                  ETotal                  E1Body                  E2Body\n",
+      "                0   1.0000000000000000e+02  1.0000000000000000e+02  0.0000000000000000e+00 -2.2440857214519274e+04  1.0000000000000000e+02 -2.2440857214519275e+02 -3.7639365236571126e+02  1.5198508022051851e+02\n",
+      "                1   4.2236163323978462e+02  1.4108003803708052e+03 -1.1705550836048852e+02 -2.2476129978632798e+04  9.9999999999999986e+01 -2.2476129978632804e+02 -3.7647651634374250e+02  1.5171521655741444e+02\n",
+      "                2   1.0031021642240592e+02  3.8270298551287897e+02 -1.1736348706942081e+02 -2.2491539833590265e+04  1.0000000000000001e+02 -2.2491539833590261e+02 -3.7652287235836400e+02  1.5160747402246139e+02\n",
+      "                3   9.9896411716010476e+01  1.0006803820092617e+02 -1.1729991834244650e+02 -2.2498086858011950e+04  1.0000000000000001e+02 -2.2498086858011945e+02 -3.7661217900078998e+02  1.5163131042067059e+02\n",
+      "                4   1.0008819642734720e+02  1.0003952238189274e+02 -1.1741988525943451e+02 -2.2497768126542338e+04  1.0000000000000001e+02 -2.2497768126542334e+02 -3.7677859321228260e+02  1.5180091194685932e+02\n",
+      "                5   9.9996395539611001e+01  1.0010162124437146e+02 -1.1745900551679516e+02 -2.2504859704025963e+04  1.0000000000000003e+02 -2.2504859704025955e+02 -3.7665382466690920e+02  1.5160522762664974e+02\n",
+      "                6   1.0011117020963695e+02  1.0017267435124782e+02 -1.1762740654751367e+02 -2.2514761055266557e+04  1.0000000000000000e+02 -2.2514761055266558e+02 -3.7663824192346226e+02  1.5149063137079673e+02\n",
+      "                7   9.9926957189505018e+01  9.9904869631265882e+01 -1.1757145502349162e+02 -2.2517665690169804e+04  1.0000000000000000e+02 -2.2517665690169804e+02 -3.7662872023157632e+02  1.5145206332987829e+02\n",
+      "                8   9.9902183781120897e+01  9.9910184942535295e+01 -1.1753639400107765e+02 -2.2518490004346189e+04  9.9999999999999986e+01 -2.2518490004346194e+02 -3.7677944704924283e+02  1.5159454700578092e+02\n",
+      "                9   1.0011182782239581e+02  1.0010647250586344e+02 -1.1771801521929217e+02 -2.2513893408438777e+04  1.0000000000000001e+02 -2.2513893408438773e+02 -3.7679469177919265e+02  1.5165575769480495e+02\n",
+      "               10   9.9639946364053955e+01  9.9242085331654422e+01 -1.1742082647888712e+02 -2.2519016506034994e+04  1.0000000000000003e+02 -2.2519016506034987e+02 -3.7690149012513956e+02  1.5171132506478972e+02\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Setup the AFQMC parameters.\n",
+    "afqmc_msd = AFQMC.build(molecule.nelec,\n",
+    " afqmc_hamiltonian,\n",
+    " trial,\n",
+    " num_walkers=100,\n",
+    " num_steps_per_block=25,\n",
+    " num_blocks=10,\n",
+    " timestep=0.005,\n",
+    " stabilize_freq=5,\n",
+    " seed=96264512,\n",
+    " pop_control_freq=5,\n",
+    " verbose=False\n",
+    ")\n",
+    "\n",
+    "\n",
+    "# Run the AFQMC.\n",
+    "afqmc_msd.run(estimator_filename = 'afqmc_src/estimates.0.h5')\n",
+    "afqmc_msd.finalise(verbose=False)\n",
+    "\n",
+    "\n",
+    "# Extract the energies.\n",
+    "qmc_data = extract_observable(afqmc_msd.estimators.filename, \"energy\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "<matplotlib.legend.Legend at 0x7ab848ece110>"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAlQAAAGwCAYAAABvpfsgAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjkuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8hTgPZAAAACXBIWXMAAA9hAAAPYQGoP6dpAABtDklEQVR4nO3de1xUZf4H8M+ZgeF+EeQqiIgoqHlJu6CZutl6w3Bzy0wlFTU3tzTN0s3NzbbQQq0sTU1Ff1GulmnZTVMxTU285RUUFVFuIgrD/TJzfn8Mc2BggOE6M/B5v17zgjnnmXOeOe4un/0+z3mOIIqiCCIiIiJqMJmxO0BERERk7hioiIiIiBqJgYqIiIiokRioiIiIiBqJgYqIiIiokRioiIiIiBqJgYqIiIiokSyM3YG2QK1WIzU1FQ4ODhAEwdjdISIiIgOIoojc3Fx4e3tDJqu9BsVA1QJSU1Ph6+tr7G4QERFRA9y6dQs+Pj61tmGgagEODg4ANP8gjo6ORu4NERERGUKpVMLX11f6O14bBqoWoB3mc3R0ZKAiIiIyM4ZM1+GkdCIiIqJGYqAiIiIiaiQGKiIiIqJG4hwqIiIiI1GpVCgtLTV2N9o0hUJR55IIhmCgIiIiamGiKCI9PR3Z2dnG7kqbJ5PJ4O/vD4VC0ajjMFARERG1MG2Ycnd3h62tLRd9NhLtwttpaWno2LFjo/4dGKiIiIhakEqlksKUq6ursbvT5rm5uSE1NRVlZWWwtLRs8HE4KZ2IiKgFaedM2draGrknBEAa6lOpVI06DgMVERGREXCYzzQ01b8DAxURERFRIzFQERERETUSAxURERFRIzFQkVkoKlVBpRaN3Q0iojZrzJgxGDFihN59hw8fhiAIOHfuHABgy5YteOihh2BrawsHBwcMHjwYe/bs0flMbGwsBEHQ+0pPT2/279PUGKjIpJWq1Fj/2zX0XboP06LjjN0dIqI2KyIiAvv27cPt27er7du8eTP69++PXr164bXXXsOLL76I8ePH49y5czhx4gQee+wxhIWF4ZNPPqn22YSEBKSlpem83N3dW+IrNSmuQ0Um60zyffzr2wu4nKYEAJy+ed/IPSIiah6iKKKwtHG37TeUjaXcoDvdQkND4ebmhujoaCxevFjanpeXhx07duCDDz7A8ePHsWLFCnz88cd4+eWXpTbvvvsuioqKMG/ePISFhcHX11fa5+7uDmdn5yb9TsbAQEUmp1Slxrs/XMaWY0kQRcDBygK5xWXILS6DSi1CLuOtxkTUuhSWqtD9rV+Mcu5LS4fDVlF3HLCwsEB4eDiio6Px5ptvSiFsx44dUKlUmDBhAt566y3Y29vjxRdfrPb5+fPnY+XKlfjmm28wd+7cpv4aRschPzI5v13JRPRRTZga96APfp0/WNqXW8SHiBIRGcu0adNw7do1HDp0SNq2efNmjBs3Dk5OTrhy5QoCAgL0PhfP29sbjo6OuHLlis52Hx8f2NvbS68ePXo0+/doDqxQkcm5m1cMABjc1Q0rnu0NQFOSLixVQVlYBmfbxj3AkojI1NhYynFp6XCjndtQQUFBGDBgADZt2oQhQ4YgMTERhw8fxtKlS6U2olj7DURVw9bhw4fh4OAgvW/M41+MiYGKTE5OoaYK5WJX8V86JxtLTaBihYqIWiFBEAwadjMFERERePnll/Hpp59i8+bNCAgIwODBmpGEwMBAHDlyBCUlJdWCU2pqKpRKJbp27aqz3d/fv1XMoeKQH5kcbaBysqn4fymONhY6+4iIyDieffZZyGQyfPnll9i6dSumTZsmzaeaMGEC8vLysG7dumqfi4qKgrW1NcaPH9/SXW4R5hGHqU3RhibHyoHKWvO7koGKiMio7O3tMX78eCxatAhKpRJTpkyR9oWEhGDOnDlYsGABSkpKMHbsWJSWluKLL77Axx9/jOjoaLi6uuoc786dOygqKtLZ5urqanZDfwxUZHJyCssA6FaotL9zyI+IyPgiIiKwceNGjBo1Ct7e3jr7PvzwQ/Tq1Qtr1qzB4sWLUVRUBIVCgQMHDuDxxx+vdqxu3bpV23bs2DE8+uijzdb/5sBARSZH/5Cfpc4+IiIynpCQkFonn0+bNg3Tpk0DACQlJWHw4MFYs2YNBg4cCLlcMwl+yJAhdU5gNyecQ0UmR2+gstZkf2V59YqIiMxDp06dEBsbi6CgIJw9e9bY3Wk2rFCRyVHqCVQc8iMiMl/+/v74z3/+Y+xuNCtWqMjkcMiPiIjMDQMVmRRRFGsY8uNdfkREZLoYqMik5JeooFJrJinqq1ApiziHioiITA8DFZkUbXVKIZfB2rLiP55c2JOIiEwZAxWZlJyCikU9tSvvAhzyIyIi08ZARSalYv6U7g2ovMuPiIhMGQMVmRR9E9KBijlURaVqFJepWrxfREREtWGgIpOibw0qAHCwsoB2BJCLexIRkalhoCKTUlOFSiYT4GBVvlo6h/2IiIzq2LFjkMvlGD16tM72pKQkCIJQ7TVp0iSddlu2bMFDDz0EW1tbODg4YPDgwdizZ49Om9jYWAiCgHbt2lV7eHJcXJx07MpEUcT69evxyCOPwN7eHs7Ozujfvz8+/PBDFBQUNOEVqM4sAlVSUhIiIiLg7+8PGxsbBAQEYMmSJSgpKZHaxMbGIiwsDF5eXrCzs0OfPn0QExNT4zG3bdsGQRAwduzYOs8fGxuLBx98EFZWVujSpQuio6Ob4FuRPjUFKoCLexIRmYqNGzfi5Zdfxm+//YbU1NRq+3/99VekpaVJr08//VTa99prr+HFF1/E+PHjce7cOZw4cQKPPfYYwsLC8Mknn1Q7loODA7799ttq5+/YsWO1tpMnT8bcuXMRFhaGgwcP4uzZs/j3v/+N3bt3Y+/evU3wzWtmFo+eiY+Ph1qtxrp169ClSxdcuHABM2bMQH5+PqKiogAAR48eRa9evfDGG2/Aw8MDe/bsQXh4OJycnBAaGqpzvKSkJLz22msYNGhQnee+ceMGRo8ejVmzZiEmJgb79+/H9OnT4eXlheHDhzfL923Lag1U1pYACnmnHxG1PqIIlDZvBaVGlrZAlUpPbfLy8vC///0PJ0+eRHp6OqKjo/Gvf/1Lp42rqys8PT2rffb48eNYsWIFPv74Y7z88svS9nfffRdFRUWYN28ewsLC4OvrK+174YUXsGnTJkyYMAEAUFhYiG3btuGVV17BO++8I7Xbvn07YmJisGvXLoSFhUnbO3XqhKeeegpKpdLg79gQZhGoRowYgREjRkjvO3fujISEBKxdu1YKVFX/MefMmYO9e/di586dOoFKpVJh4sSJePvtt3H48GFkZ2fXeu7PPvsM/v7+WLFiBQAgODgYR44cwapVq2oMVMXFxSguLpbeN/c/YmuiDVSOegKVExf3JKLWqrQAeM/bOOf+VyqgsDO4+fbt2xEUFIRu3bph0qRJmDt3LhYtWlRt+E2fr776Cvb29njxxRer7Zs/fz5WrlyJb775BnPnzpW2T548GR988AGSk5PRsWNHfPPNN+jUqRMefPBBnc/HxMSgW7duOmFKSxAEODk5GfwdG8Ishvz0ycnJgYuLS73bLF26FO7u7oiIiDDoPMeOHcOwYcN0tg0fPhzHjh2r8TORkZFwcnKSXpWTNtWu9iE/Lu5JRGRsGzdulOZEjRgxAjk5OTh06JBOmwEDBsDe3l56nTlzBgBw5coVBAQEQKFQVDuut7c3HB0dceXKFZ3t7u7uGDlypDTdZtOmTZg2bVq1z1+9ehXdunVriq/YIGZRoaoqMTERq1evlqpT+mzfvh1xcXFYt26dtO3IkSPYuHEjzp49a/C50tPT4eHhobPNw8MDSqUShYWFsLGxqfaZRYsWYd68edJ7pVLJUGWguof8uLgnEbVClraaSpGxzm2ghIQEnDhxQprTZGFhgfHjx2Pjxo0YMmSI1O5///sfgoODpfeV/waKoljrOfSFrWnTpmHOnDmYNGkSjh07hh07duDw4cM6beo6bnMzaqBauHAhli9fXmuby5cvIygoSHqfkpKCESNG4JlnnsGMGTP0fubgwYOYOnUqNmzYgB49egAAcnNzMXnyZGzYsAHt27dvui+hh5WVFaysrJr1HK1VTcsmVN7Gu/yIqNURhHoNuxnLxo0bUVZWBm/viuFJURRhZWWlM6Hc19cXXbp0qfb5wMBAHDlyBCUlJdWCU2pqKpRKJbp27VrtcyNHjsTMmTMRERGBMWPGwNXVtVqbrl27Ij4+vjFfr1GMOuQ3f/58XL58udZX586dpfapqakYOnQoBgwYgPXr1+s95qFDhzBmzBisWrUK4eHh0vZr164hKSkJY8aMgYWFBSwsLLB161Z89913sLCwwLVr1/Qez9PTExkZGTrbMjIy4OjoqLc6RY0jVahsa77LjxUqIqKWV1ZWhq1bt2LFihU4e/as9Przzz/h7e2Nr776qs5jTJgwAXl5eTqjR1pRUVGwtrbG+PHjq+2zsLBAeHg4YmNj9Q73AcDzzz+PK1euYPfu3dX2iaKInJwcA75lwxm1QuXm5gY3NzeD2qakpGDo0KHo168fNm/eDJmsehaMjY1FaGgoli9fjpkzZ+rsCwoKwvnz53W2LV68GLm5ufjoo49qHJILCQnBjz/+qLNt3759CAkJMajfZDhRFOsY8itfh4oLexIRtbg9e/bg/v37iIiIqDbBe9y4cdi4caPODWT6hISEYM6cOViwYAFKSkowduxYlJaW4osvvsDHH3+M6OhovdUnAHjnnXewYMGCGvc/++yz+PbbbzFhwgQsXrwYf/3rX+Hm5obz589j1apVePnllw1aKqmhzGIOVUpKCoYMGQI/Pz9ERUUhMzNT2qe9LfPgwYMIDQ3FnDlzMG7cOKSnpwPQjMW6uLjA2toaPXv21Dmus7MzAOhsX7RoEVJSUrB161YAwKxZs/DJJ5/g9ddfx7Rp03DgwAFs374dP/zwQ3N+5TapoESFMrVmDFzvkJ8th/yIiIxl48aNGDZsmN675caNG4f333/foLvaP/zwQ/Tq1Qtr1qzB4sWLUVRUBIVCgQMHDuDxxx+v8XMKhaLWKTuCIODLL7/E+vXrsWnTJrz77ruwsLBAYGAgwsPDm32pI7MIVPv27UNiYiISExPh4+Ojs087CW3Lli0oKChAZGQkIiMjpf2DBw9GbGyswedKS0tDcnKy9N7f3x8//PADXn31VXz00Ufw8fHB559/zjWomoG2OmUpF2BjKa+2XzspnXf5ERG1vO+//77GfQ8//LD099iQyeHTpk2Thu6SkpIwePBgrFmzBgMHDoRcrvnf/yFDhtR6rLFjx1bbL5PJMGvWLMyaNavOPjQ1QTT2tPg2QKlUwsnJCTk5OXB0dDR2d0zW5TQlRn50GO3tFTi5+Mlq++OS7uGZz46hk6stYhcMNUIPiYgar6ioCDdu3IC/vz+sra2N3R2TcOPGDWzZsgVjxoxBv379WvTctf171Ofvt1lUqKhtqG1RT4ALexIRtVb+/v74z3/+Y+xuNIrZLuxJrU9tE9IB3SE/FlaJiMiUMFCRyagzUJWvlK5SiygoUbVYv4iImgP/j6FpaKp/BwYqMhm1LeoJADaWcljKNc+K4p1+RGSuLC01/xtXUGCkhyGTjpKSEgCQJsM3FOdQkcmoq0IlCAIcrS2RlV+CnMJSeDlxYVUiMj9yuRzOzs64c+cOAMDW1tagBwtT01Or1cjMzIStrS0sLBoXiRioyGTUFagAzYT1rPwSLu5JRGZNu4aiNlSR8chkMnTs2LHRoZaBikyGoYEK4ONniMi8CYIALy8vuLu7o7SU/3tmTAqFQu/TV+qLgYpMRl3LJgAVj5/h4p5E1BrI5fJGz90h08BJ6WQy6lWh4qR0IiIyIQxUZDIMCVTS4p6cQ0VERCaEgYpMRk6BARUqa1aoiIjI9DBQkUkQRdHAIT/OoSIiItPDQEUmoaBEhTK1ZrVaw4b8GKiIiMh0MFCRSdBWnCxkAmwVNd/xwiE/IiIyRQxUZBIqD/fVtria9i6/HE5KJyIiE8JARSbBkPlTlfdzyI+IiEwJAxWZBEMW9QQqFvbkkB8REZkSBioyCYZWqLSBK7eoDKrySexERETGxkBFJkFpaKCyrtifV8R5VEREZBoYqMgkGFqhUljIYGOpuQuQw35ERGQqGKjIJBgaqICGLe55OU2Jf++6gPScooZ1kIiIqBYMVGQS6hOoGnKn34bD1/F/x29i7v/OQBQ594qIiJoWAxWZhHpVqBqwuGdWXgkA4Pj1e9gWd6sBPSQiIqoZAxWZBEOXTajcpj5DfpXbvvfDZQ79ERFRk2KgIpPQsCE/w+/yq3wXYW5xGRbvOs+hPyIiajIMVGQSDF02AWjY4p7awLY0rAcs5QJ+vXwHe86lNaCnRERE1TFQkdGJolhRobJt+iG/ysd/qJMLZg/tAgD4z3cXcS+/pCFdJiIi0sFARUZXWKpCqUoz/NYcd/kVlKhQpq44/ktDuqCbhwOy8kuw6ciNBvaaiIioAgMVGZ22eiSXCbBTyOtsX3GXn2FzqLTHt5AJsFXIobCQ4Zn+PgCA5HsFDekyERGRDgYqMrrKE9IFQaizfX0X9tS2c7atOL6zrQIAcL+AQ35ERNR4DFRkdDkFhk9IByrmUBk65KdvSYZ25XO1sgv4+BoiImo8BioyuvqsQQXUf2FPfUsysEJFRERNycLYHaCGKy5T4dTN+8buRqOduZUNwPAKlbZddkEpjl67K233c7VDB2ebau31BSpWqIiIqCkxUJmxnMJSPL/hD2N3o8k4GxqoysNQcZla5/sr5DL8vvAvcHOw0mmvb42rduUVqrziMpSUqaGwYLGWiIgajoHKjFnIZOjqYV9nO30Lghsw91vn83W1r6tNXfsVFjI895CvQf1xtLbElAGd8HtiRXXqZlYBSlRqXM/MqxaosvXM0XK0sYQgaPqVXVgCdwdrg85NRESkDwOVGXOxU2Dvq4ON3Q2j+M9TPXTej1t7FKdu3te7UKe+IT+5TICTjSWyC0qRXVDKQEVERI3CcQ5qFVztNEN4WQYGKqBi2O8+V0snIqJGYqCiVsHVvjxQ5dUcqKreRehcPhfrPiemExFRIzFQUavgUl6hupdfXG1fXRWqbC6dQEREjcRARa2Cq51mIrq+IT99d/kBrFAREVHTYaCiVsGQIT9WqIiIqLmYRaBKSkpCREQE/P39YWNjg4CAACxZsgQlJRV/CGNjYxEWFgYvLy/Y2dmhT58+iImJqfGY27ZtgyAIGDt2bK3n3rlzJ5588km4ubnB0dERISEh+OWXX5rqq1ETqRjy0w1HoijWEqi0FSoGKiIiahyzCFTx8fFQq9VYt24dLl68iFWrVuGzzz7Dv/71L6nN0aNH0atXL3zzzTc4d+4cpk6divDwcOzZs6fa8ZKSkvDaa69h0KBBdZ77t99+w5NPPokff/wRp06dwtChQzFmzBicOXOmSb8jNU5NQ34FJSqUqTULcVUf8tM+foZDfkRE1DhmsQ7ViBEjMGLECOl9586dkZCQgLVr1yIqKgoAdMIVAMyZMwd79+7Fzp07ERoaKm1XqVSYOHEi3n77bRw+fBjZ2dm1nvvDDz/Uef/ee+9h9+7d+P7779G3b9/GfTFqMtohv/sFJVCrRchkmlVEtdUpC5kAW4Vc5zMc8iMioqZiFhUqfXJycuDi4lLvNkuXLoW7uzsiIiIadF61Wo3c3Nxaz11cXAylUqnzoualDUcqdcUQH6A7f0qoslR7O05KJyKiJmKWgSoxMRGrV6/Giy++WGOb7du3Iy4uDlOnTpW2HTlyBBs3bsSGDRsafO6oqCjk5eXh2WefrbFNZGQknJycpJevr2GPVKGGU1jI4GitKbhWHvaraf4UUDHkxwoVERE1llED1cKFCyEIQq2v+Ph4nc+kpKRgxIgReOaZZzBjxgy9xz148CCmTp2KDRs2oEcPzSNKcnNzMXnyZGzYsAHt27dvUH+//PJLvP3229i+fTvc3d1rbLdo0SLk5ORIr1u3bjXofFQ/rvbl86jyKtaikgKVbfVA1c5Osy27oBSivgceEhERGcioc6jmz5+PKVOm1Nqmc+fO0u+pqakYOnQoBgwYgPXr1+ttf+jQIYwZMwarVq1CeHi4tP3atWtISkrCmDFjpG1qtRoAYGFhgYSEBAQEBNTYj23btmH69OnYsWMHhg0bVmufraysYGVlVWsbanoudgrcuJuvc6dfbRUq7TBhmVpEbnEZHK2rtyEiIjKEUQOVm5sb3NzcDGqbkpKCoUOHol+/fti8eTNksurFtdjYWISGhmL58uWYOXOmzr6goCCcP39eZ9vixYuRm5uLjz76qNZhua+++grTpk3Dtm3bMHr0aIP6Sy3PRc/z/Gpa1BMArC3lsLaUoahUjez8UgYqIiJqMLO4yy8lJQVDhgyBn58foqKikJmZKe3z9PQEoBnmCw0NxZw5czBu3Dikp6cDABQKBVxcXGBtbY2ePXvqHNfZ2RkAdLYvWrQIKSkp2Lp1KwDNMN8LL7yAjz76CI888oh0XBsbGzg5OTXbd6b6a29ffS2q2ipUgKZKlZZThPsFJejoatv8nSQiolbJLCal79u3D4mJidi/fz98fHzg5eUlvbS2bNmCgoICREZG6ux/+umn63WutLQ0JCcnS+/Xr1+PsrIyzJ49W+e4c+bMabLvR01DqlBVmkOVXVB7oKpYi4oT04mIqOHMokI1ZcqUOudaRUdHIzo6ul7H1de+6rbY2Nh6HZOMx0XP4p51V6gqJqYTERE1lFlUqIgMUduQn2MtQ34AK1RERNQ4DFTUalQM+RleoXLm4p5ERNQEGKio1ajvXX4AHz9DRERNg4GKWo325Qt7ap/nB7BCRURELYOBilqNqs/zE0XRoGUTgLZdoUrJLkRJmdrY3SAiMmsMVNRqKCxkcKj0PL+CEhXKyitVNQYqO22Fqm0GqgspORi47ADm7/jT2F0hIjJrDFTUqmiH/e7ll0jVKQuZAFuFXG97aR2q/LY55Hfq5n0AwMmke0buCRGReWOgolal8uKelYf7BEHQ276tD/klZeUDANJyilBUqjJyb4iIzBcDFbUqle/0q2v+FFCxsGd+iapNziNKupsv/X4zq0Bvm/O3c3DudnaNx9h6LAmjPjqMDGWR3v3nbmdj5EeHEZtwp1F9JSIyZQxU1KpUXtyzrkU9AcDR2hKy8uJVW6xSJVUKUTcqhSutolIVnlt/DOPXHUdBSZneY2w9dhOX0pTYf1l/YPr2TAoupynxv7hbTdNpEyWKIvKK9V8jImr9GKioVdFWqCoHKu3SCPrIZIJUwWprSyeUqdS4da8iUGmH/ypLvJOH/BIVCktVSLyTV21/qUotVbmu3snVex7t5/R9vqnkF5fhxI17EEWx2c6Rml1Y61yzHSdvo+eSX7DnXGqz9YGITBcDFbUq2uf53c0rrnNRT622+viZ2/cLpbsgAd3hP63KIelqRvVAdDMrXzpGTYFJuz0pKx+lquYZVl32UzyeXXcMP5xP07s/v7gM//nuYq1Dl4evZuLsrZr3vxRzGs+sO4ZLqUq9+/deygAA7DydYnC/iaj1YKCiVsVVT4WqrkDlLD0guW0FqhtVKlL6KlSVQ9QVPRWoyiHqmp5AlVdchrQczdyqUpVY4zytulzNyEVcLdWhY9ezAABHr2Xp3b8t7haijyZh2U/xevenZhdiyuY4vLDpBMr0hL6iUhXO3c6GKAKnk+/rPcaVDM31OXHjnt5jEFHrxkBFrYprpTlU2QX1rVC1rSG/m+UVKU9HawBA0t3qYedKpUCVqKdCVTlQpeYUVZtDVDVkNWTYTxRFTNr4ByasP64zRKlVVKrC9UzNcWuqHl1IyQEAXExV6h0WPHc7W1oQtqahT20xLyG9erAsKCnDrfuavuUVl+F8+fmIqO1goKJWRTuH6m5efSpUbXPITzshfUg3NwBAurIIhSW6SyckVh7y0xOGqm6rGqCq7k+sYZ5VbZLvFSBDWYwytYgzeobkrmZUhJ34dCVU6uqBSRuocgpLkZJdWG3/xUpB7KKeUHY5rWKbvkCVeCcPlXOatmJGRG0HAxW1Kq52Fc/zyzbgLj+gYumE7DZWodLe1dfb11kKnZWrM0WlKtysVBG6db9AT+DSBCZ5+a2SVStQde03xIUUZaXfq1d+LqdX7C8qVePGXd1zFJSU4VpmxTZ9VazKIepyWvXAFF8pRCVk5Farcl2pUr07VsPQIxG1XgxU1KpoK1QqtSgND9U55GenXS29rVWoNOGpk6sdOrW302yrNDH9Wqam6uJsa4l2tpYQRegEE7ValN4PCHAFUHNFKqSzZn9iZgMCVWpFiDp/W0+gStMNSFUrTJfTclG5aHUpTV+gyql1f+WqVE5hKTKUxTr7tfOnHu3sAgA4mXS/Ta5rRtSWMVBRq1L5eX7JBgYq7aT0tjSHqlSlxu37mqEv//Z28He1BaA7UV07Ib2ruwMCPRw02yoN2aVkF6KoVA2FXIYh3dwB1FyhGtHTU3qv1jMkV5vKVakLqTnVqkPx5RUlx/J/96oVqMphSfNed//dvGKdgFQ1oAGaoUQAsJQLOu+1tIFqdC9vuNopUFiqwp+13FFIRK0PAxW1Oq6VqlSA4ZPS29JdfrfuFUClFmFjKYeHo5VUobpZaWK6Njx18bBHoLu9ZlvlSerlYcm/vR2CPTWBq3IFq6hUJYXaJ4LdYSkXUFSq1juHqSaiKOoEoNyiMumY2v3aIb8xvb0BVK8waQPZw5001aPqgUvz3tvJGoIAZOYWIzO3ImBl5hbjbl4JBAF4PFAz36zqPKor5e+DPB3waHk1jsN+RG0LAxW1Oq7lD0jWMrxC1XYClXa4z8/VFoIgoJOrJlBVrlBdkSpUlQLVneqBqou7PbqU77+ZlS89E/DG3XyoRU3lyNPRGv7loa0+w35pOUW4l18CuUxAUHloq3wHXYayGNkFpZDLBIT16QCg+p182jlYz/T3AaCprFUOz9oK1oN+7eBffh0qV6m01Sh/Vzv08XUGoBuolEWlSC1fGqKruwMeLR/+PHrtrsHfk4jMHwMVtTraeVRahleo2s6Qn3aJBG3I0TeHShuYAj0qhvwqD+lpK1gB7vZwc7CCo7UF1GJFWLtaKXAJgoBA9/Jj6Fl+oSba6lKguz36+bUDoBuotMGnc3s79PJxglwm4F5+iTSEV1ymkobjQgJc4etiA0C3iqWtWPXwdkKwt2O1/drw1M3TAd3KQ13lSeraqp2HoxWcbC2l+WSnk7P5wGmiNoSBilod10qBykImwFYhr7W9FKgKS5v10SWmRJqQXh6ktJWZO7nFyC8u09zhV94msNKQX+UKlBS4ygNTlyrDghX7NSEkoHx/fe70u1Aednp2cMIDHZw02yoHqvLqUZCXI6wt5Qhw03yPS2k5Ul/K1CKcbS3RwdkG3b3KA1OqvkDlKO2vXKHS3vUX5OmIIE/N/sTMPGnxTm1g61oeOju3t4O7gxVKytQ4fVP/IqBE1PowUFGro13cE9BUpwRBqLW9dshPpRahLGobD7fVLpmgDVJO5XfyAZqwdT1TM1znZGMJN3sruDlYwcnGEmoRuJ6ZD1EUdYb8Kv/Ubr9Ww/6anvmnz8Xy8NTT2xE9pUBVMaSnDTvBXpowow1EF8uH+S5In3eCIAjo4a05hjZE5ReXScOclQNV5cAVL4U2B/i0s4GtQo6SMrUUSqsGKkEQEFJepeJ6VERtBwMVtTra5/kBdQ/3AYC1pRw2lpoqVluZmF61QlX595tZBVLo0VafNEN2FYEoM68YyqIyyISKYUNpSK98jlTlSe3aYwHaRTANqwRql0zo2cEJXT0coJDLkFNYKt2hGF9eSQourxxJgal8u/bzPTpo9kuBqXz/5TQlRFGzWryrvRW6lw/5Xb+rqcSVqdTS0GWQpwNkMkEa/tQO+2kDVbfy7UDFMhKcmE7UdjBQUatTecivrkU9tdq1oaUTSsrUSCkPJJ3Kl0vQ/F4+Mf1uvjRsF1gpJAR6VAQi7Tyoji62sC4Po1KFKkMzHKatgnVx02z3b28HmQAoi8qQmae7jpM+d3KLkKEshiAAwV6OUFjIpDlM51NyNI+cKT9HcHlQ0gYi7Z172gnpPcuDljZYXb2Th6JSldSuR/nn3B2s4GKngEot4kpGLpKy8lFSpoatQg7fdpprFVR+Ta5IgUp7reylvod0bg8AOHsrG/nFbaPqSdTWMVBRq1N1yM8Q0uNn2sDinsn3CqAWATuFHG4OFdU8baBKupuvU6HS6lJegbqakSdVobro7Nf8fuNuPm7czUepSrMsQwdnzURwa0s5OrpoQokhE9O1YadzezvYWWnWmNIO+51PyUHinTyoyudHeThqvoe2ApV8rwDZBSXSXCjt5zwdrdHO1hIqtYirGXnSHX7aICYIgs6wn3ZIsVt5dUr7O6CpUN3PL5GWWKgcPn1dbNDB2QZlahEnOY+KqE1goKJWp/JdfoYGqnZ2bWfphJvSkgl2OvPLOrXXhJ2krIoKVdfKFapKQ37aeVIBlQJVB2cbWFvKUKJS40D8nfL9dlIQASpVsQxYOkGaP1UehjS/a8LOhZQcadgu2NNR+h7t7BTwdtI87Pn7c2koLlPD3soCfuVBThAEKTxdSsupVqECKuZjXU5TVsyf8qy4DtrfEzJypeG+Ds42sC8PfdrzaOdRfXogEadu3mszNzwQtVUMVNTquFaaQ6WdcF6Xigckt/4hP2lCeqX5U5XfX72TJ82xqjyMpf09KatAmrStnTcFADKZgIDy4b2fLqQDqBju06pc5apL1eE6ADp3+mmrT0FeDjqf0wam7XG3pPeVQ512ntXZWzlSIOpR6RzdKy2dkJBecYeflrZClXyvAGfLH9bczVO3DwDw9IMdIBOAE0n3MG7tMTz1ye/Yefo2H0lD1EoxUFGro602AfWoUEkPSDatClVyVgGyDJhvVB8VE9Jtdbb7lQ/5ZReUSgtyulcaEvR0tIaDlQVUahGnkzXDWJWH/ICKKpY2aFTdX/VOwNpUnVAOaIKLpVzA/YJSqQqmnT+lpR2yO1/pDj99+3+6kIZSlQhHawv4tLOR9gdLSyfkVloyoSIwudpbob29FUQR+OF8muZ7e+h+TwAYENAee14ehGf7+0BhIcP5lBzM2/4nXvnqTJ3fnYjMDwMVtTpWFnLpeX6GBypthcp0AlVswh0MXRGLoVGx0kOGm4J2UU/tnCktJxtLneHSQA8HnSFBQRCkO/a0j+PTrvukVT1AOejdX9eQX3ZBiXQnX+XqkZWFXBqGvJml+R7dqwaqKgGqZwfd/drhPe1Crt29HXW+Z4CbPRRyGfKKy6TH5FSuUGnea/pwrvxhzZXv8NPtiyPe/3tvHF/0BBYM7wYLmYCfL6bjxI17tX5/IjI/DFTUKmnv9DP0Lj/tkN+Z5Gx8feo2Tty4h7ScQuQWleq8mnIeTNLdfLz57XkcTLhTbd/lNCX++eUZaW2sqdFxuNtElaqahvwA3bv+At2rV10qb/NysoaDte71rakiVfV9Zm4xcmoZXtXOberoYlstFD9QaU6VXCZUO0fl+VCA7hwsQPO9rSxkldrr7reUy3QqTl5O1nCqMnRcdYivaw2BSsvFToHZQ7tg/EO+AICoXxI4p4qolbGouwmR+fF1sUVSVgG8nWzqbgygg7NmIvPFVCVe2/Fnje38XG3xn6d6YGg391qPV1iiwsYj13Ek8S4mPeqH0Q946VRBfrmYjte2/4nc4jLE/JGMfwwJwPwnu8JCLkOGsgjTouOQV1yGh/1dkJ5ThOR7BZix9SS+mvGotExBTmEp1v92DUlZBZj1eAAe8NENBqIo4vfELPx6OQNjenuhn58LikpVSM0pXzJBX6Bqb4fTydkAdO9a06o8Z6pqkNFsq9hvKRfg56o7rGhvZQEvJ2uk5RQhMTMX/fxc9F4/7YKcD1QJQwDQo4MTUD4/qnN7O+l6aPm0s4GDtQVyi8pgbSlD5yrf00IuQ5CXI/4sH5asGsAATdVLG+qC9MyPqhyoBEH/tdDn5b8EYsep2ziRdA+Hr97F413dDPocEZk+Bipqld4J64mTN+9LCyzW5S9BHlga1gOX05RIvleAW/cKkZJdCJVat4pwM6sAUzfHYdQDnngrtAc8y+8o01KrRXx7JgUf/JKAdKXmgbnHr9/Dpo438Obo7ujl44QPfknA+t+uA9DcXn/rXiHWxl7DmeT7WD6uF16KOY20nCIEuNlhw+T+uJtfjKfXHMWZ5GzM3/4nVjzbG18cv4lPDiZKw1Y/nEtDWB9vvPbXbvB1scWJG/ewYm8C/igfWoo+moTBXd0wtq83RFETbFyrPPMQqFg5HdBfoepSqXIT4FZ9v5+rLSxkAsrUIjq52sFSXr0I3sXdHmk5RbiakQf/9vbYcy4Vey9mwMVOgXH9fPBYl/bSI2d6dKgediqHrCCv6vu1Sx/8ceMegr0cYaGnD911AlX10FZ5XlY3z+rnqByy/CqtxVUXTydrTH7UDxuP3EDU3gQMCmxf50r+RGQeGKioVerU3k5vBaYmCgsZwkM66WxTqUWUqSvuyCoqUeOTg1ex6fck/Hg+HYcSMjHh4Y6w1d4uL4o4kHBHujutg7MNnuzugf/F3cLp5GyMW3sUPu1spLlB0x/zxxsjg/DzhXQs/OYcjl+/h6FRsVCLmiHLzVMehpOtJZxsLbFucj9M3vgHfjifhsNXM6VH5AS626OrpwN+OJeG3WdT8dP5dAR7V4QFhVyGkABXHEm8i0NXMnHoSmb59bHV+4e88jXTN4xVOWTpm4htKZehU3s7JN7Jq7Fq08XdHoev3sWHv17F4l0XUFYptH73Zyq8nKxRUKJ5XmDVCeWAJsxoQ1uwl/6htl4+Tvjjxj309nHWu197J5+VhazaPLDK+wHoPUeguwMEARDFuof7qvrHkAB8dSIZ527nYN+lDPy1h2e9Pk/NIzmrAGk5hXiks2H/J4yoKgYqohrIZQLksorKg5WFHG+O7o6/9fXBm7vO40xyNj4/cqPa5xysLDD7L10wZUAnWFvK8Y8hAVixNwE7Tt3G7fuFsLeywAd/74WRD3gBAMb09kawlyP+8cUpXL2TBysLGTa80B8dKw2XPdrZFcvH9cK87X9CWVQGD0crzHuyK8Y96AMLuQz/GJyD9368jKPXsvDnrWxYyAQ8+5Av/jm0C7ydbZB0Nx8f77+KXWdToBarL2egpa06OdlULJZZWQdnG9gp5MgvUdV4jK4e9ki8k6e3wqXZrwkg2gpezw6OCOvdAbfuF2D32VSk5RRJbfUNx1lbyvGAjxPOJGejr287ved4aUgX2FtZYtKjHfXuHxjgCoVchkGBbnorWLoVquqByUYhh1/5sHJ9A1V7eytMHdgJnx68hpX7rmBYsIfOsg5aecVlOHwlE8Vlagzv4QmbOh7yTQ2Xml2IsWt+x738Enz6/IMY3cvL2F0iMySInBnZ7JRKJZycnJCTkwNHx+p/IMj8qNUidp1NwZny+UZarvYKTH7UD6721cPIpVQlfr6Qhr896KN3QnhBSRm2HruJ/n7t0L+T/rlFe86l4m5uMZ59yBe2Ct3/PySKIn67ehcnk+7hmX6+OoFMK/FOLr77Mw1P9+2gt4IniiI+O3QdAW52NVZOon+/gT9v5+CDv/fSG0bO3srGxiM38MaIbvBpV70PecVlWLL7ItwdrfB03w46c7WKSlX49XIGvv8zFd08HTHvya56+5B0Nx/x6UqM6NnwP3xpOYVwtLaUVmGvauXeBNzNL8F/w3rqDTxv7b6Arcdu4qsZj0qLeBoqp6AUj71/ALlFZVgypjse6uQCtShCpRZxISUH+y7fwfFrWShRaSqk7e0VmDGoMyY+6qezgGhLuJqRi3O3c/BUH2+9Q7jmrqRMjefWH5PmDjpaW+DnuY/D29mw+Zct6V5+CXaevo3QXt7VphtQ86jP328GqhbAQEXU+hSVqpChLJLW76qv1fuvYsW+K7W26eRqi1KVKC3f4GxriYiB/pjxeGeD523V5VKqEhZyQW+lbd+lDLz81WkUlaoxtJsbPp34YLUgb+6Wfn8Jm36/AQdrC/i2s8WlNCUe8XfBlzMehVxPkDaWkjI1xq8/hjPJ2ejkaoudLw3UWeaEmgcDlYlhoCKiqvKLNcthJN3Nh0wQIJcJEATNAqpPBHvgye4eCHCzQ5laxK4zKVgTe01a8qKTqy0in+5V78pYZXfzihH5Yzy+OX0bggBMeLgjXh/eTVpC5IvjN/HW7guofF9Gbx8nbJrykN4KrKnLLSqFIAg6Fb6fzqfhHzGnAQAbwvsj0N0eoz8+jPwSFRYM74bZQ7tIbbPyinElIw99Ozo3WZitTFsdPpKYif+M6VHtLtv/7rmkM8Wgn187xEx/pFn6QhUYqEwMAxURNZZKLWLPuVRE/hgvzT+b8HBHLBoVBEdrw9Zb0x7nqxPJeP/neOnmBi0XOwUWjQxCUlY+Pj14DQAwvr8v/t7fBzO3nsT9glJ0crXF1mmP6B1SNpZSlRrXM/Ph086m2hBuSnYhPjmQiB0nNUtt9O/UDkO7uSPIyxGzY04jr7gMLz7eGYtGBQMAdpy8hQVfn4OFTMA3/xgAmSAg+mgSvj+XipIyNbydrDH/r93wt74ddIaCE+/k4vfELPTycULfjvrn9tVEFEVE/hQv3f3rZGOJTVMeQj8/zXH2XkzHzP87BQBYODIIaw4mQllUhtG9vLD6ub56h6SpaTBQmRgGKiJqKsqiUiz/KR4xfyQD0IQgT0driIC0WGhxmRrFpSoUlalRUqaGXCbAykIGK0sZSstEKZD18HbEO2N7orRMjX/vvoArVZ6xOHdYIOY8EQhBEHAtMw/hG08gJbsQLnYKDApsDz9XO/i52MLXxRYWcs0f9ap/UQQBEIBqd5XKy6tyFnIBFjIBgiBALYpQq0WpKiaXCbCUl7eTyVD5ELlFpTh6LQuHr97FsWtZyCsug6VcQD+/dni8qxv6dWyH78+l4n9xt1CqqvnP3MOdXBAz4xFpfpgoivjnV2fww7k0WFvKUFRacaev9oYM7bWb80QgbtzNx+6zqdLDugHNjSY1zSGsShRFvLPnMjb9rqk++bna4mZWAawtZVgz8UEEujtg9MeHoSwqQ8Rj/vh3aHccvXYXL2w6gVKViFmDA7BwZFCd56GGYaAyMQxURNTUjl/PwqKd56VhwPpwsLLA/L92xaRH/aQbC0pVamw6cgMf/noVJSo13vtbT4x/SPcuyTvKIkzZHKcTHkyFlYUMxTU8eHpAgCtefbIrPByscTDhDg4m3MGxa1lwtVPg29kD4eGoO8E7p6AUIz/6Dak5RbCUCxj1gBemDOiEYC9HRB9NwqcHE5FbpbpnIRPQy8cJZ25lQxQ1/Zn5eGdMDvGDm72V3mVKRFHEf767iC3HbgIA3v1bT/ytbwe8FHMasQmZkMsEdHC2QfK9AvTt6Iz/zQyBonyV/52nb2Peds0ixH/r2wFPBLvjsS7tpSFbahoMVCaGgYqImkNRqQqnb95HiUoNmSCUV4MEWFnKNBUpCzkUFjKo1CKKy1QoLq9YBXk61PiH915+CfKLy+Dror+6UlSqwqErmbhxNx83swpwMysfKdmFUIsiBGhCgzY7iCIgQqxWtRJFTZgoVWvubCxTqSGKgEwmQCZoKlOiCJSV7y9VqaVFdrWHspAJ6NvRGYMC3fB4oBt6eDvi5r0CHL6aid+uZOLUzfsI8nTEnGGBeFTP2lLFZZpKk5WF/jlISXfzcTjxLoZ394B7lcB1L78EH++/iu/+TEWguz3C+nTAyJ6eaGenwMXUHCz9/pK0qC6gWefOy8ka3k42sLOSo0QlorRMjezCUlxOU0IQgGVPPyAF2FKVGq9/fQ7fnkkBoLkZ4YdXBqFDlTsPP95/FSsr3dggCEAvH2f4trPRLPsiCJDJBNgp5HCxs4KLvQLt7RSwt7aAXNBUBTXXWpT+s1FcpkaZWg1rSzlsFZqXjaUF3B01DwVva1pdoEpKSsI777yDAwcOID09Hd7e3pg0aRLefPNNKBSa/1GIjY3FqlWrcOLECSiVSgQGBmLBggWYOHGi3mNu27YNEyZMQFhYGHbt2mVQP37//XcMHjwYPXv2xNmzZw3uPwMVEVHbIYoifrmYgZX7EnD1Tl61QFmZIADvj+uFZ/r76mxXq0Ws2JeAXWdSEfn0AzU+pujotbs4cPkODl+9i4SMpnuIelUzBvnjzdHdm+34pqo+f7/N4v7X+Ph4qNVqrFu3Dl26dMGFCxcwY8YM5OfnIyoqCgBw9OhR9OrVC2+88QY8PDywZ88ehIeHw8nJCaGhoTrHS0pKwmuvvYZBgwYZ3Ifs7GyEh4fjiSeeQEZGRpN+PyIiaj0EQcCInp4Y0dMTJWVqZCiLkJZThNTsQhSWqqCQy2BpIYOi/EHc+h7jJJMJWDA8CAuG1z4/akBAewwIaA8ASM8pwvHrWcguKIFK1ISyMrWIvOJS3Msvwd28EqkCqRY1c9XU5WnPykJeXtWUQS4TUFiqQmGJCoWlKhSUqDiUaACzqFDp88EHH2Dt2rW4fv16jW1Gjx4NDw8PbNq0SdqmUqnw+OOPY9q0aTh8+DCys7MNqlA999xzCAwMhFwux65du2qtUBUXF6O4uFh6r1Qq4evrywoVERGRGalPhcpsl73NycmBi4v+1aRra7N06VK4u7sjIiLC4HNt3rwZ169fx5IlSwxqHxkZCScnJ+nl6+tb94eIiIjIbBk05Pfggw/W66CCIOC7775Dhw4dGtSpuiQmJmL16tXScJ8+27dvR1xcHNatWydtO3LkCDZu3Fiv+U9Xr17FwoULcfjwYVhYGDZCumjRIsybN096r61QERERmZW0c0BmAuDWFfDqbezemDSDEsLZs2cxf/582Nvrf9hpZaIoYtmyZTpDXjVZuHAhli9fXmuby5cvIyioYgw5JSUFI0aMwDPPPIMZM2bo/czBgwcxdepUbNiwAT169AAA5ObmYvLkydiwYQPat29fZ98AzfDg888/j7fffhtdu+p/ppg+VlZWsLJqe3dDEBFRK3M2BvjjM+CxeQxUdTBoDpVMJkN6ejrc3d0NOqiDgwP+/PNPdO7cudZ2mZmZyMrKqrVN586dpTv5UlNTMWTIEDz66KOIjo6GTFZ9xPLQoUMYPXo0Vq5ciZkzZ0rbz549i759+0Iur7hFVq1WS98vISEBAQEBOsfKzs5Gu3btqn1GFEXI5XLs3bsXf/nLX2rtP8C7/IiIyEztXwocXgE8MgsYWXsBpDVq8rv8bty4ATc3/bds6nPp0iV4e3vX2c7Nzc3g46akpGDo0KHo168fNm/erDdMxcbGIjQ0FMuXL9cJUwAQFBSE8+fP62xbvHgxcnNz8dFHH+kdknN0dKz2mTVr1uDAgQP4+uuv4e/vb1DfiYiIzJJl+XpkJXm1tyPDApWfn1+9DtrU84VSUlIwZMgQ+Pn5ISoqCpmZmdI+T09PAJphvtDQUMyZMwfjxo1Deno6AEChUMDFxQXW1tbo2bOnznGdnZ0BQGf7okWLkJKSgq1bt0Imk1X7jLu7u95jERERtTqK8qk+JQXG7YcZaPA6VAUFBUhOTkZJSYnO9l69ejW6U1Xt27cPiYmJSExMhI+Pj84+7Yjlli1bUFBQgMjISERGRkr7Bw8ejNjYWIPPlZaWhuTk5CbpNxERkVlTaCtU9X/EUVtT73WoMjMzMXXqVPz0009696tUqibpWGvCOVRERGSWLnwDfD0N6DQImLLH2L1pcc26DtXcuXORnZ2NP/74AzY2Nvj555+xZcsWBAYG4rvvvmtwp4mIiMjEWNppfnIOVZ3qPeR34MAB7N69G/3794dMJoOfnx+efPJJODo6IjIyEqNHj26OfhIREVFLk4b8OIeqLvWuUOXn50vLJ7Rr106aIP7AAw/g9OnTTds7IiIiMh5FeYWqlIGqLvUOVN26dUNCQgIAoHfv3li3bh1SUlLw2WefwcvLq8k7SEREREbCIT+D1XvIb86cOUhLSwMALFmyBCNGjEBMTAwUCgWio6Obun9ERERkLNoKFYf86lTvQDVp0iTp9379+uHmzZuIj49Hx44dDX6kCxEREZkBbaBSFQOqMkDe4NWWWr1GXxlbW9t6PzyZiIiIzIA2UAFAaT4gdzJeX0ycwYFq3rx5BrVbuXJlgztDREREJkSuAAQ5IKo0i3taM1DVxOBAdebMGZ33R44cQb9+/WBjYyNtEwSh6XpGRERExiUImipVsZLzqOpgcKA6ePCgznsHBwd8+eWX6Ny5c5N3ioiIiEyENlCV8vEztan3sglERETUhljyeX6GYKAiIiKimnHpBIMwUBEREVHNFFzc0xAGz6E6d+6czntRFBEfH4+8PN0L3KtXr6bpGRERERkfHz9jEIMDVZ8+fSAIAkRRlLaFhoYCgLRdEASoVKqm7yUREREZB+dQGcTgQHXjxo3m7AcRERGZImnIj4GqNgYHKj8/v+bsBxEREZkiDvkZxKBJ6efOnYNarTb4oBcvXkRZWVmDO0VEREQmgkN+BjEoUPXt2xdZWVkGHzQkJATJyckN7hQRERGZCIW95icDVa0MGvITRRH//ve/YWtra9BBS0pKGtUpIiIiMhEKVqgMYVCgevzxx5GQkGDwQUNCQnSe8UdERERminOoDGJQoIqNjW3mbhAREZFJsuTCnobgSulERERUM2nIjxWq2jBQERERUc045GcQBioiIiKqGYf8DMJARURERDWTVkpnhao29Q5U+fm8bZKIiKjN4LIJBql3oPLw8MC0adNw5MiR5ugPERERmRLtwp6lBUA9nprS1tQ7UH3xxRe4d+8e/vKXv6Br165YtmwZUlNTm6NvREREZGzaR89ABMoKjdoVU1bvQDV27Fjs2rULKSkpmDVrFr788kv4+fkhNDQUO3fu5DP8iIiIWhPLSk9J4TyqGjV4UrqbmxvmzZuHc+fOYeXKlfj111/x97//Hd7e3njrrbdQUMCLTkREZPZksopQVcp5VDUxaKV0fTIyMrBlyxZER0fj5s2b+Pvf/46IiAjcvn0by5cvx/Hjx7F3796m7CsREREZg6WtZg4VJ6bXqN6BaufOndi8eTN++eUXdO/eHS+99BImTZoEZ2dnqc2AAQMQHBzclP0kIiIiY1HYAQV3OeRXi3oHqqlTp+K5557D77//joceekhvG29vb7z55puN7hwRERGZAAUX96xLvQNVWloabG1ta21jY2ODJUuWNLhTREREZEL4+Jk61TtQlZWVQalUVtsuCAKsrKygUCiapGNERERkIiy5uGdd6h2onJ2dIQhCjft9fHwwZcoULFmyBDIZn2xDRERk9qQhPwaqmtQ7UEVHR+PNN9/ElClT8PDDDwMATpw4gS1btmDx4sXIzMxEVFQUrKys8K9//avJO0xEREQtjEN+dap3oNqyZQtWrFiBZ599Vto2ZswYPPDAA1i3bh3279+Pjh074t1332WgIiIiag045Feneo/JHT16FH379q22vW/fvjh27BgA4LHHHkNycnLje0dERETGp32eHwNVjeodqHx9fbFx48Zq2zdu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+9HEGKiIiIio5bh10/zMTDBuP5oYAxURERG1nPblgYoVKiIiIqIGcuuq+ZmV2Kru9GOgIiIiopbj5AtYWAOqEuB+krF702QYqIiIiKjlyOQVj6BpRcN+DFRERETUsrTDfq1oYjoDFREREbWsVjgxnYGKiIiIWlYrXIuKgYqIiIhalrQW1RVAFI3blybCQEVEREQty7ULIMiA4hwgL8PYvWkSDFRERETUsiysgHadNL+3konpDFRERETU8tqX3+nXSuZRMVARERFRy2OgIiIiImqkVvaQZAYqIiIianmtbC0qBioiIiJqedq1qHLTgCKlcfvSBBioiIiIqOXZOAP2Hprf7141aleaAgMVERERGYc0Md3851ExUBEREZFxtKKJ6QxUREREZBxShYpDfkREREQN05AhP7UKOLYGyLjYPH1qIAYqIiIiMg7tkN+9G0BZiWGfOfMF8MsiYOeLzdevBmCgIiIiIuNw8AIUDoCoAu5dM+wzF77W/Mw4D9xParau1RcDFRERERmHIABu5cN+t/6ou31uBpB0pOJ9wk/N068GYKAiIiIi4wkeo/n52wqgtKj2tpd2A6IagKB5H/9Ds3atPhioiIiIyHgefhFw8AZykoG4z2tve+Gb8s/M0Py8eRQovN+8/TMQAxUREREZj8IWGLpI8/vhKKAwW3+7nNvAreMABOCxVwH37pq5V1f3tVRPa8VARURERMbV+3nALUhTbTqySn+bi99qfvoNABy9gW6jNO9NZNiPgYqIiIiMS24BDPuP5vc/PtNUo6rSDvf1+JvmpzZQJf4KlBU3exfrwkBFRERExtd1BNBxAFBWBByM1N2XdQ1IPQMIMqD7WM02776AvSdQkgckHW7x7lbFQEVERETGJwjAk0s1v//5JXD114p92uE+/8GAvZvmd5kM6DZS83v8jy3XzxowUBEREZFp8H0I6B6mWRohZhywdSyQcgq4sFOzv+c43fbaYb+EnwBRbNGuVmVh1LMTERERVfbUasDeAzi5Gbh+UPMCAJklEByq29b/ccDSDshN1QwJdniw5ftbjhUqIiIiMh3WTsCoD4CXTwF9JmrmTQFAlycAm3a6bS2tNdsBo6+abhaBKikpCREREfD394eNjQ0CAgKwZMkSlJRUPEgxNjYWYWFh8PLygp2dHfr06YOYmBid40RHR0MQBJ2XtbV1refeuXMnnnzySbi5ucHR0REhISH45ZdfmuV7EhERUbl2fsDYNcBLx4G/LAZGr9TfLmi05meCcedRmcWQX3x8PNRqNdatW4cuXbrgwoULmDFjBvLz8xEVFQUAOHr0KHr16oU33ngDHh4e2LNnD8LDw+Hk5ITQ0IoSoaOjIxISEqT3giDUeu7ffvsNTz75JN577z04Oztj8+bNGDNmDP744w/07du3eb4wERERabh1A9wW1Lw/8K+AIAcgAMV5gJV9i3WtMkEUjTyLq4E++OADrF27FtevX6+xzejRo+Hh4YFNmzYB0FSo5s6di+zs7Eadu0ePHhg/fjzeeustg9orlUo4OTkhJycHjo6OjTo3ERERVZF3B7B3b/LD1ufvt1kM+emTk5MDFxeXerfJy8uDn58ffH19ERYWhosXL9brvGq1Grm5ubWeu7i4GEqlUudFREREzaQZwlR9mWWgSkxMxOrVq/Hiiy/W2Gb79u2Ii4vD1KlTpW3dunXDpk2bsHv3bnzxxRdQq9UYMGAAbt/WsyJrDaKiopCXl4dnn322xjaRkZFwcnKSXr6+vgYfn4iIiMyPUYf8Fi5ciOXLl9fa5vLlywgKCpLep6SkYPDgwRgyZAg+/1z/U6kPHjyI0NBQrF27FuHh4TUeu7S0FMHBwZgwYQLeeeedOvv75ZdfYsaMGdi9ezeGDRtWY7vi4mIUF1csg69UKuHr68shPyIiIjNSnyE/o05Knz9/PqZMmVJrm86dO0u/p6amYujQoRgwYADWr1+vt/2hQ4cwZswYrFq1qtYwBQCWlpbo27cvEhMT6+zrtm3bMH36dOzYsaPWMAUAVlZWsLKyqvOYRERE1DoYNVC5ubnBzc3NoLYpKSkYOnQo+vXrh82bN0Mmqz5aGRsbi9DQUCxfvhwzZ86s85gqlQrnz5/HqFGjam331VdfYdq0adi2bRtGjx5tUH+JiIio7TCLZRNSUlIwZMgQ+Pn5ISoqCpmZmdI+T09PABXDfHPmzMG4ceOQnp4OAFAoFNIE8qVLl+LRRx9Fly5dkJ2djQ8++AA3b97E9OnTpeMtWrQIKSkp2Lp1KwDNMN8LL7yAjz76CI888oh0XBsbGzg5ObXI9yciIiLTZhaT0vft24fExETs378fPj4+8PLykl5aW7ZsQUFBASIjI3X2P/3001Kb+/fvY8aMGQgODsaoUaOgVCpx9OhRdO/eXWqTlpaG5ORk6f369etRVlaG2bNn6xx3zpw5LfPliYiIyOSZ7TpU5oTrUBEREZmfNrEOFREREZGpYKAiIiIiaiQGKiIiIqJGYqAiIiIiaiQGKiIiIqJGYqAiIiIiaiSzWNjT3GlXplAqlUbuCRERERlK+3fbkBWmGKhaQG5uLgDA19fXyD0hIiKi+srNza3z6Shc2LMFqNVqpKamwsHBAYIgNOmxlUolfH19cevWLS4a2ki8lk2D17Hp8Fo2HV7LptOWrqUoisjNzYW3t7feZwhXxgpVC5DJZPDx8WnWczg6Orb6/2C3FF7LpsHr2HR4LZsOr2XTaSvX0tDn9nJSOhEREVEjMVARERERNRIDlZmzsrLCkiVLYGVlZeyumD1ey6bB69h0eC2bDq9l0+G11I+T0omIiIgaiRUqIiIiokZioCIiIiJqJAYqIiIiokZioCIiIiJqJAYqM/bpp5+iU6dOsLa2xiOPPIITJ04Yu0smLzIyEg899BAcHBzg7u6OsWPHIiEhQadNUVERZs+eDVdXV9jb22PcuHHIyMgwUo/Nw7JlyyAIAubOnStt43U0XEpKCiZNmgRXV1fY2NjggQcewMmTJ6X9oijirbfegpeXF2xsbDBs2DBcvXrViD02TSqVCv/+97/h7+8PGxsbBAQE4J133tF5DhuvpX6//fYbxowZA29vbwiCgF27dunsN+S63bt3DxMnToSjoyOcnZ0RERGBvLy8FvwWxsVAZab+97//Yd68eViyZAlOnz6N3r17Y/jw4bhz546xu2bSDh06hNmzZ+P48ePYt28fSktL8de//hX5+flSm1dffRXff/89duzYgUOHDiE1NRVPP/20EXtt2uLi4rBu3Tr06tVLZzuvo2Hu37+PgQMHwtLSEj/99BMuXbqEFStWoF27dlKb999/Hx9//DE+++wz/PHHH7Czs8Pw4cNRVFRkxJ6bnuXLl2Pt2rX45JNPcPnyZSxfvhzvv/8+Vq9eLbXhtdQvPz8fvXv3xqeffqp3vyHXbeLEibh48SL27duHPXv24LfffsPMmTNb6isYn0hm6eGHHxZnz54tvVepVKK3t7cYGRlpxF6Znzt37ogAxEOHDomiKIrZ2dmipaWluGPHDqnN5cuXRQDisWPHjNVNk5WbmysGBgaK+/btEwcPHizOmTNHFEVex/p44403xMcee6zG/Wq1WvT09BQ/+OADaVt2drZoZWUlfvXVVy3RRbMxevRocdq0aTrbnn76aXHixImiKPJaGgqA+O2330rvDbluly5dEgGIcXFxUpuffvpJFARBTElJabG+GxMrVGaopKQEp06dwrBhw6RtMpkMw4YNw7Fjx4zYM/OTk5MDAHBxcQEAnDp1CqWlpTrXNigoCB07duS11WP27NkYPXq0zvUCeB3r47vvvkP//v3xzDPPwN3dHX379sWGDRuk/Tdu3EB6errOtXRycsIjjzzCa1nFgAEDsH//fly5cgUA8Oeff+LIkSMYOXIkAF7LhjLkuh07dgzOzs7o37+/1GbYsGGQyWT4448/WrzPxsCHI5uhu3fvQqVSwcPDQ2e7h4cH4uPjjdQr86NWqzF37lwMHDgQPXv2BACkp6dDoVDA2dlZp62HhwfS09ON0EvTtW3bNpw+fRpxcXHV9vE6Gu769etYu3Yt5s2bh3/961+Ii4vDK6+8AoVCgRdeeEG6Xvr++85rqWvhwoVQKpUICgqCXC6HSqXCu+++i4kTJwIAr2UDGXLd0tPT4e7urrPfwsICLi4ubebaMlBRmzV79mxcuHABR44cMXZXzM6tW7cwZ84c7Nu3D9bW1sbujllTq9Xo378/3nvvPQBA3759ceHCBXz22Wd44YUXjNw787J9+3bExMTgyy+/RI8ePXD27FnMnTsX3t7evJbU7DjkZ4bat28PuVxe7Y6pjIwMeHp6GqlX5uWf//wn9uzZg4MHD8LHx0fa7unpiZKSEmRnZ+u057XVderUKdy5cwcPPvggLCwsYGFhgUOHDuHjjz+GhYUFPDw8eB0N5OXlhe7du+tsCw4ORnJyMgBI14v/fa/bggULsHDhQjz33HN44IEHMHnyZLz66quIjIwEwGvZUIZcN09Pz2o3RZWVleHevXtt5toyUJkhhUKBfv36Yf/+/dI2tVqN/fv3IyQkxIg9M32iKOKf//wnvv32Wxw4cAD+/v46+/v16wdLS0uda5uQkIDk5GRe20qeeOIJnD9/HmfPnpVe/fv3x8SJE6XfeR0NM3DgwGpLd1y5cgV+fn4AAH9/f3h6eupcS6VSiT/++IPXsoqCggLIZLp/1uRyOdRqNQBey4Yy5LqFhIQgOzsbp06dktocOHAAarUajzzySIv32SiMPSueGmbbtm2ilZWVGB0dLV66dEmcOXOm6OzsLKanpxu7aybtH//4h+jk5CTGxsaKaWlp0qugoEBqM2vWLLFjx47igQMHxJMnT4ohISFiSEiIEXttHirf5SeKvI6GOnHihGhhYSG+++674tWrV8WYmBjR1tZW/OKLL6Q2y5YtE52dncXdu3eL586dE8PCwkR/f3+xsLDQiD03PS+88ILYoUMHcc+ePeKNGzfEnTt3iu3btxdff/11qQ2vpX65ubnimTNnxDNnzogAxJUrV4pnzpwRb968KYqiYddtxIgRYt++fcU//vhDPHLkiBgYGChOmDDBWF+pxTFQmbHVq1eLHTt2FBUKhfjwww+Lx48fN3aXTB4Ava/NmzdLbQoLC8WXXnpJbNeunWhrayv+7W9/E9PS0ozXaTNRNVDxOhru+++/F3v27ClaWVmJQUFB4vr163X2q9Vq8d///rfo4eEhWllZiU888YSYkJBgpN6aLqVSKc6ZM0fs2LGjaG1tLXbu3Fl88803xeLiYqkNr6V+Bw8e1Pu/jS+88IIoioZdt6ysLHHChAmivb296OjoKE6dOlXMzc01wrcxDkEUKy0hS0RERET1xjlURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURGQW/vOf/6BPnz6NOkZSUhIEQcDZs2ebpE81GTJkCObOndus5yAi08JARURN4tatW5g2bRq8vb2hUCjg5+eHOXPmICsrq97HEgQBu3bt0tn22muv6TyctSF8fX2RlpaGnj17Nuo4WrGxsRAEAdnZ2Trbd+7ciXfeeadJztEQLRUciagCAxURNdr169fRv39/XL16FV999RUSExPx2WefYf/+/QgJCcG9e/cafQ57e3u4uro26hhyuRyenp6wsLBodH9q4+LiAgcHh2Y9BxGZFgYqImq02bNnQ6FQYO/evRg8eDA6duyIkSNH4tdff0VKSgrefPNNqW2nTp3wzjvvYMKECbCzs0OHDh3w6aef6uwHgL/97W8QBEF6X3XIb8qUKRg7dizee+89eHh4wNnZGUuXLkVZWRkWLFgAFxcX+Pj4YPPmzdJnqlZupkyZAkEQqr1iY2MBAP/3f/+H/v37w8HBAZ6ennj++edx584d6VhDhw4FALRr1w6CIGDKlCkAqg/53b9/H+Hh4WjXrh1sbW0xcuRI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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plot the energies.\n",
+    "\n",
+    "vqe_y = vqe_energies\n",
+    "vqe_x = list(range(len(vqe_y)))\n",
+    "plt.plot(vqe_x, vqe_y, label=\"VQE\")\n",
+    "\n",
+    "afqmc_y = list(qmc_data[\"ETotal\"])\n",
+    "afqmc_x = [i + vqe_x[-1] for i in list(range(len(afqmc_y)))]\n",
+    "plt.plot(afqmc_x, afqmc_y, label=\"AFQMC\")\n",
+    "\n",
+    "plt.xlabel(\"Optimization steps\")\n",
+    "plt.ylabel(\"Energy [Ha]\")\n",
+    "plt.legend()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version proto-0.8.0 (https://github.com/NVIDIA/cuda-quantum 57e1893b9a5b57ef1a1c2662bcf4527f87b9ef89)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/cost_minimization.html b/pr-2241/examples/python/tutorials/cost_minimization.html
new file mode 100644
index 0000000000..55bb155237
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/cost_minimization.html
@@ -0,0 +1,799 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Cost Minimization &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Variational Quantum Eigensolver" href="vqe.html" />
+    <link rel="prev" title="Quantum Fourier Transform" href="quantum_fourier_transform.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Cost Minimization</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/cost_minimization.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="quantum_fourier_transform.html" class="btn btn-neutral float-left" title="Quantum Fourier Transform" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="vqe.html" class="btn btn-neutral float-right" title="Variational Quantum Eigensolver" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Cost-Minimization">
+<h1>Cost Minimization<a class="headerlink" href="#Cost-Minimization" title="Permalink to this heading">¶</a></h1>
+<p>Below we start with a basic example of a hybrid variational algorithm which involves flipping the Bloch vector of a qubit from the <span class="math notranslate nohighlight">\(\ket{0}\)</span> to the <span class="math notranslate nohighlight">\(\ket{1}\)</span> state. First we import the relevant packages and set our backend to simulate our workflow on NVIDIA GPUs.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Initialize a kernel/ ansatz and variational parameters.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angles</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+    <span class="c1"># Allocate a qubit that is initialized to the |0&gt; state.</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="c1"># Define gates and the qubits they act upon.</span>
+    <span class="n">rx</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubit</span><span class="p">)</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Our Hamiltonian will be the Z expectation value of our qubit.</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="c1"># Initial gate parameters which intialize the qubit in the zero state</span>
+<span class="n">initial_parameters</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">initial_parameters</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+
+q0 : ──────────────────
+
+q1 : ──────────────────
+     ╭───────╮╭───────╮
+q2 : ┤ rx(0) ├┤ ry(0) ├
+     ╰───────╯╰───────╯
+
+</pre></div></div>
+</div>
+<p>We build our cost function such that its minimal value corresponds to the qubit being in the <span class="math notranslate nohighlight">\(\ket{1}\)</span> state. The observe call below allows us to simulate our statevector <span class="math notranslate nohighlight">\(\ket{\psi}\)</span>, and calculate <span class="math notranslate nohighlight">\(\bra{\psi}Z\ket{\psi}\)</span>.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">cost_values</span> <span class="o">=</span> <span class="p">[]</span>
+
+
+<span class="k">def</span> <span class="nf">cost</span><span class="p">(</span><span class="n">parameters</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Returns the expectation value as our cost.&quot;&quot;&quot;</span>
+    <span class="n">expectation_value</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span>
+                                      <span class="n">parameters</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+    <span class="n">cost_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">expectation_value</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">expectation_value</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># We see that the initial value of our cost function is one, demonstrating that our qubit is in the zero state</span>
+<span class="n">initial_cost_value</span> <span class="o">=</span> <span class="n">cost</span><span class="p">(</span><span class="n">initial_parameters</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">initial_cost_value</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+1.0
+</pre></div></div>
+</div>
+<p>Below we use our built-in optimization suite to minimize the cost function. We will be using the gradient-free COBYLA alogrithm.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define a CUDA-Q optimizer.</span>
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">COBYLA</span><span class="p">()</span>
+<span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span> <span class="o">=</span> <span class="n">initial_parameters</span>
+
+<span class="n">result</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span><span class="n">dimensions</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">function</span><span class="o">=</span><span class="n">cost</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># %pip install matplotlib</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Plotting how the value of the cost function decreases during the minimization procedure.</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+
+<span class="n">x_values</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">cost_values</span><span class="p">)))</span>
+<span class="n">y_values</span> <span class="o">=</span> <span class="n">cost_values</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x_values</span><span class="p">,</span> <span class="n">y_values</span><span class="p">)</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s2">&quot;Epochs&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s2">&quot;Cost Value&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Text(0, 0.5, &#39;Cost Value&#39;)
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_cost_minimization_9_1.png" src="../../../_images/examples_python_tutorials_cost_minimization_9_1.png" />
+</div>
+</div>
+<p>We see that the final value or our cost function, <span class="math notranslate nohighlight">\(\bra{\psi}Z\ket{\psi} = -1\)</span> demonstrating that the qubit is in the <span class="math notranslate nohighlight">\(\ket{1}\)</span> state.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="quantum_fourier_transform.html" class="btn btn-neutral float-left" title="Quantum Fourier Transform" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="vqe.html" class="btn btn-neutral float-right" title="Variational Quantum Eigensolver" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/cost_minimization.ipynb b/pr-2241/examples/python/tutorials/cost_minimization.ipynb
new file mode 100644
index 0000000000..eaa08eeda5
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/cost_minimization.ipynb
@@ -0,0 +1,219 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Cost Minimization\n",
+    "\n",
+    "Below we start with a basic example of a hybrid variational algorithm which involves flipping the Bloch vector of a qubit from the $\\ket{0}$ to the $\\ket{1}$ state. First we import the relevant packages and set our backend to simulate our workflow on NVIDIA GPUs. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from typing import List\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "                       \n",
+      "q0 : ──────────────────\n",
+      "                       \n",
+      "q1 : ──────────────────\n",
+      "     ╭───────╮╭───────╮\n",
+      "q2 : ┤ rx(0) ├┤ ry(0) ├\n",
+      "     ╰───────╯╰───────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Initialize a kernel/ ansatz and variational parameters.\n",
+    "@cudaq.kernel\n",
+    "def kernel(angles: List[float]):\n",
+    "    # Allocate a qubit that is initialized to the |0> state.\n",
+    "    qubit = cudaq.qubit()\n",
+    "    # Define gates and the qubits they act upon.\n",
+    "    rx(angles[0], qubit)\n",
+    "    ry(angles[1], qubit)\n",
+    "\n",
+    "\n",
+    "# Our Hamiltonian will be the Z expectation value of our qubit.\n",
+    "hamiltonian = cudaq.spin.z(0)\n",
+    "\n",
+    "# Initial gate parameters which intialize the qubit in the zero state\n",
+    "initial_parameters = [0, 0]\n",
+    "\n",
+    "print(cudaq.draw(kernel, initial_parameters))"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We build our cost function such that its minimal value corresponds to the qubit being in the $\\ket{1}$ state. The observe call below allows us to simulate our statevector $\\ket{\\psi}$, and calculate $\\bra{\\psi}Z\\ket{\\psi}$.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cost_values = []\n",
+    "\n",
+    "\n",
+    "def cost(parameters):\n",
+    "    \"\"\"Returns the expectation value as our cost.\"\"\"\n",
+    "    expectation_value = cudaq.observe(kernel, hamiltonian,\n",
+    "                                      parameters).expectation()\n",
+    "    cost_values.append(expectation_value)\n",
+    "    return expectation_value"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "1.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "# We see that the initial value of our cost function is one, demonstrating that our qubit is in the zero state\n",
+    "initial_cost_value = cost(initial_parameters)\n",
+    "print(initial_cost_value)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below we use our built-in optimization suite to minimize the cost function. We will be using the gradient-free COBYLA alogrithm. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define a CUDA-Q optimizer.\n",
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "optimizer.initial_parameters = initial_parameters\n",
+    "\n",
+    "result = optimizer.optimize(dimensions=2, function=cost)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install matplotlib"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {
+    "tags": [
+     "nbsphinx-thumbnail"
+    ]
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Text(0, 0.5, 'Cost Value')"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "data": {
+      "image/png": "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d96JN99802pbQECA9HNUVJTVvqioKBw6dAgAkJmZif79+8PLy0vaP2zYMJjNZpw4cQKCICA7OxvR0dE2a+jXr5/0s5eXF3x8fJCXlwcAmD59OsaMGYODBw8iNjYWCQkJGDp0aIveKxG1LYYlImoXvLy86lwWsxcPD48mHefq6mr1uyAIMJvNAICRI0fi999/x5dffont27cjOjoaM2bMwCuvvGL3eonIvjhmiYicwr59++r83qdPHwBAnz59cPjwYZSWlkr79+7dC5VKhV69esHb2xthYWFIS0u7rhqCgoIwYcIEvPfee1ixYgVWr159XecjorbBzhIRtQsVFRUwGAxW21xcXKRB1Fu2bMHgwYMxfPhwbNy4EQcOHMDatWsBAOPGjUNKSgomTJiAZ555BhcvXsSsWbPwyCOPQKfTAQCeeeYZTJs2DVqtFiNHjkRxcTH27t2LWbNmNam+RYsWYdCgQbjxxhtRUVGBzz//XAprRKRsDEtE1C6kpqYiODjYaluvXr1w/PhxADV3qm3evBmPPfYYgoOD8f777yMiIgIA4Onpif/97394/PHHccstt8DT0xNjxozB8uXLpXNNmDAB5eXlePXVV/Hkk08iMDAQf/7zn5tcn5ubG5KTk3H27Fl4eHjgtttuw+bNm+3wzomotQmiKIpyF0FE1JoEQcC2bduQkJAgdylE5IA4ZomIiIjIBoYlIiIiIhs4ZomI2j2ONiCi68HOEhEREZENDEtERERENjAsEREREdnAsERERERkA8MSERERkQ0MS0REREQ2MCwRERER2cCwRERERGTD/wNOOWlAeHvZ8QAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plotting how the value of the cost function decreases during the minimization procedure.\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "x_values = list(range(len(cost_values)))\n",
+    "y_values = cost_values\n",
+    "\n",
+    "plt.plot(x_values, y_values)\n",
+    "\n",
+    "plt.xlabel(\"Epochs\")\n",
+    "plt.ylabel(\"Cost Value\")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We see that the final value or our cost function, $\\bra{\\psi}Z\\ket{\\psi} = -1$ demonstrating that the qubit is in the $\\ket{1}$ state."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12 (main, Nov 20 2023, 15:14:05) [GCC 11.4.0]"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/deutschs_algorithm.html b/pr-2241/examples/python/tutorials/deutschs_algorithm.html
new file mode 100644
index 0000000000..18add2a8c7
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/deutschs_algorithm.html
@@ -0,0 +1,914 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Deutsch’s Algorithm &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Quantum Fourier Transform" href="quantum_fourier_transform.html" />
+    <link rel="prev" title="Quantum Enhanced Auxiliary Field Quantum Monte Carlo" href="afqmc.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Deutsch’s Algorithm</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/deutschs_algorithm.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="afqmc.html" class="btn btn-neutral float-left" title="Quantum Enhanced Auxiliary Field Quantum Monte Carlo" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="quantum_fourier_transform.html" class="btn btn-neutral float-right" title="Quantum Fourier Transform" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Deutsch's-Algorithm">
+<h1>Deutsch’s Algorithm<a class="headerlink" href="#Deutsch's-Algorithm" title="Permalink to this heading">¶</a></h1>
+<p>We have a function which takes in a bit and outputs a bit. This can be represented as <span class="math notranslate nohighlight">\(f: \{0,1\} \longrightarrow \{0,1\}\)</span>.</p>
+<p>The function <span class="math notranslate nohighlight">\(f\)</span> has a property; either it is constant or balanced.</p>
+<p>If constant, the outputs are the same regardless of the inputs, i.e., <span class="math notranslate nohighlight">\(f(0) = f(1) = 0\)</span> or <span class="math notranslate nohighlight">\(f(0) = f(1) = 1\)</span>.</p>
+<p>If balanced, the ouputs are balanced across their possibilities, i.e, if <span class="math notranslate nohighlight">\(f(0) = 0\)</span> then <span class="math notranslate nohighlight">\(f(1) = 1\)</span> or if <span class="math notranslate nohighlight">\(f(0) = 1\)</span> then <span class="math notranslate nohighlight">\(f(1) = 0\)</span>.</p>
+<p>The question we would like to answer is if the function is constant or balanced.</p>
+<p>Classically, if we are given a function <span class="math notranslate nohighlight">\(f\)</span>, we can solve to find its property via the code below:</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Treat the code snippet below like a black box, i.e., you don&#39;t have access to the value of the property argument and can just query f with different inputs.</span>
+
+
+<span class="k">def</span> <span class="nf">f</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="nb">property</span><span class="o">=</span><span class="s1">&#39;constant&#39;</span><span class="p">):</span>
+
+    <span class="k">if</span> <span class="nb">property</span> <span class="o">==</span> <span class="s1">&#39;constant&#39;</span><span class="p">:</span>
+
+        <span class="c1"># The output is a 1 regardless of the input; we can also make the output to be 0.</span>
+
+        <span class="k">if</span> <span class="n">x</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+            <span class="k">return</span> <span class="mi">1</span>
+        <span class="k">elif</span> <span class="n">x</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="k">return</span> <span class="mi">1</span>
+
+    <span class="k">if</span> <span class="nb">property</span> <span class="o">==</span> <span class="s1">&#39;balanced&#39;</span><span class="p">:</span>
+
+        <span class="c1"># The output depends on the input.</span>
+
+        <span class="k">if</span> <span class="n">x</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+            <span class="k">return</span> <span class="mi">1</span>
+        <span class="k">elif</span> <span class="n">x</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="k">return</span> <span class="mi">0</span>
+</pre></div>
+</div>
+</div>
+<p>Let us now classically find out if the function we defined above is constant or balanced.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="n">f</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+    <span class="k">if</span> <span class="n">f</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The function is constant&#39;</span><span class="p">)</span>
+    <span class="k">elif</span> <span class="n">f</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The function is balanced&#39;</span><span class="p">)</span>
+
+<span class="k">elif</span> <span class="n">f</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+    <span class="k">if</span> <span class="n">f</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The function is constant&#39;</span><span class="p">)</span>
+    <span class="k">elif</span> <span class="n">f</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The function is balanced&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+The function is constant
+</pre></div></div>
+</div>
+<p>If you step through the <code class="docutils literal notranslate"><span class="pre">if</span></code> statements above, one can see that we require 2 calls to the function to determine its property. That is, we have to query <span class="math notranslate nohighlight">\(f\)</span> twice.</p>
+<p>The claim is that Deutsch’s algorithm can solve for this property with 1 function evalulation, demonstrating quantum advantage.</p>
+<p>Below we first go through the math and then the implementation in CUDA Quantum.</p>
+<section id="XOR-\oplus">
+<h2>XOR <span class="math notranslate nohighlight">\(\oplus\)</span><a class="headerlink" href="#XOR-\oplus" title="Permalink to this heading">¶</a></h2>
+<p>You may have seen the <span class="math notranslate nohighlight">\(\oplus\)</span> symbol floating around. This is the exclusive OR or the XOR operation. It follows the rules of addition modulo 2. For example,</p>
+<ol class="arabic simple">
+<li><p><span class="math notranslate nohighlight">\(3\oplus5 = (3+5)_{\%2} = 8_{\%2} = 0\)</span></p></li>
+<li><p><span class="math notranslate nohighlight">\(5\oplus4 = (5+4)_{\%2} = 9_{\%2} = 1\)</span></p></li>
+</ol>
+<p>A quick way to perform the <span class="math notranslate nohighlight">\(\oplus\)</span> calculation is if the result of the addition is an even number, the result is 0 otherwise 1.</p>
+</section>
+<section id="Quantum-oracles">
+<h2>Quantum oracles<a class="headerlink" href="#Quantum-oracles" title="Permalink to this heading">¶</a></h2>
+<p><img alt="7f1f8ede98514584b8e565d9c123e4af" 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 logic 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">
+\[\begin{aligned}
+U_f\ket{x}\ket{y}  =  \ket{x}\ket{y \oplus f(x)}
+\end{aligned}\]</div>
+<p>If <span class="math notranslate nohighlight">\(y = 0\)</span>, then <span class="math notranslate nohighlight">\(U_f\ket{x}\ket{y} = U_f\ket{x}\ket{0} = \ket{x}\ket{0 \oplus f(x)} = \ket{x}\ket{f(x)}\)</span> since <span class="math notranslate nohighlight">\(f(x)\)</span> can either be <span class="math notranslate nohighlight">\(0/1\)</span> and <span class="math notranslate nohighlight">\(0 \oplus 0 = 0\)</span> and <span class="math notranslate nohighlight">\(0 \oplus 1 = 1\)</span>.</p>
+<p>This is remarkable because by setting <span class="math notranslate nohighlight">\(\ket{y} = \ket{0}\)</span>, we can extract the value of <span class="math notranslate nohighlight">\(f(x)\)</span> by measuring the value of the second qubit.</p>
+</section>
+<section id="Phase-oracle">
+<h2>Phase oracle<a class="headerlink" href="#Phase-oracle" title="Permalink to this heading">¶</a></h2>
+<p>Since <span class="math notranslate nohighlight">\(f(x)\)</span> can be either <span class="math notranslate nohighlight">\(0\)</span> or <span class="math notranslate nohighlight">\(1\)</span>, we have that <span class="math notranslate nohighlight">\(0 \oplus f(x) = 0 \oplus 0 = 0 = f(x)\)</span> or <span class="math notranslate nohighlight">\(0 \oplus f(x) = 0 \oplus 1 = 1 = f(x)\)</span>.</p>
+<p>Similarly, <span class="math notranslate nohighlight">\(1 \oplus f(x) = 1 \oplus 0 = 1 = \overline{f(x)}\)</span> or <span class="math notranslate nohighlight">\(1 \oplus f(x) = 1 \oplus 1 = 0 = \overline{f(x)}\)</span> where the bar on top of <span class="math notranslate nohighlight">\(f(x)\)</span> denotes ‘not <span class="math notranslate nohighlight">\(f(x)\)</span>’.</p>
+<p>Let us now prove a result which we shall use later:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{aligned}
+U_f\ket{x}\ket{-}  &amp;=   U_f \ket{x} \tfrac{1}{\sqrt{2}}(\ket{0} - \ket{1}) \\
+&amp;= \tfrac{1}{\sqrt{2}}  (U_f\ket{x}\ket{0} - U_f\ket{x}\ket{1}) \\
+&amp;= \tfrac{1}{\sqrt{2}}  (\ket{x}\ket{0 \oplus f(x)} - \ket{x}\ket{1 \oplus f(x)}) \\
+&amp;= \tfrac{1}{\sqrt{2}}  (\ket{x}\ket{f(x)} - \ket{x}\ket{\overline{f(x)}}) \\
+&amp;=
+\begin{cases}
+      \tfrac{1}{\sqrt{2}}  (\ket{x}\ket{0} - \ket{x}\ket{1}) = \ket{x}\ket{-} &amp;   f(x) = 0 \\
+      \tfrac{1}{\sqrt{2}}  (\ket{x}\ket{1} - \ket{x}\ket{0}) = -\ket{x}\ket{-} &amp;   f(x) = 1 \\
+\end{cases} \\
+&amp;= (-1)^{f(x)}\ket{x}\ket{-}
+\end{aligned}\end{split}\]</div>
+<p>In summary, <span class="math notranslate nohighlight">\(U_f\ket{x}\ket{-} = (-1)^{f(x)}\ket{x}\ket{-}\)</span> where the <span class="math notranslate nohighlight">\(\ket{-}\)</span> qubit was left unchanged and a phase was applied to <span class="math notranslate nohighlight">\(\ket{x}\)</span>.</p>
+</section>
+<section id="Quantum-parallelism">
+<h2>Quantum parallelism<a class="headerlink" href="#Quantum-parallelism" title="Permalink to this heading">¶</a></h2>
+<p>Consider:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{aligned}
+U_f\ket{+}\ket{0} &amp;= U_f \tfrac{1}{\sqrt{2}}(\ket{0}+\ket{1}) \ket{0} \\
+&amp;= U_f \tfrac{1}{\sqrt{2}}(\ket{0}\ket{0}+\ket{1}\ket{0}) \\
+&amp;= \tfrac{1}{\sqrt{2}}(U_f \ket{0}\ket{0} + U_f \ket{1}\ket{0})  \\
+&amp;= \tfrac{1}{\sqrt{2}}(U_f \ket{0}\ket{0} + U_f \ket{1}\ket{0})  \\
+&amp;= \tfrac{1}{\sqrt{2}}(\ket{0}\ket{0 \oplus f(0)} + \ket{1}\ket{0 \oplus f(1)})  \\
+&amp;= \tfrac{1}{\sqrt{2}}(\ket{0}\ket{f(0)} + \ket{1}\ket{f(1)})  \\
+\end{aligned}\end{split}\]</div>
+<p>We have calculated information about both <span class="math notranslate nohighlight">\(f(0)\)</span> and <span class="math notranslate nohighlight">\(f(1)\)</span> simultaneously. Quantum mechanics allows for parallelism by exploiting the ability of superposition states.</p>
+</section>
+<section id="Deutschs'-Algorithm:">
+<h2>Deutschs’ Algorithm:<a class="headerlink" href="#Deutschs'-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="3c3a3d3b7312414a83bb1af856a70975" 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>
+<div class="math notranslate nohighlight">
+\[\ket{\psi_1}  =   H_1H_0\ket{\psi_0} = H_1H_0\ket{01} = \ket{+-} = \frac{1}{\sqrt{2}} (\ket{0}+\ket{1})\ket{-}
+\tag{2}\]</div>
+<div class="math notranslate nohighlight">
+\[\ket{\psi_2}  =   U_f\ket{\psi_1} = \frac{1}{\sqrt{2}} (U_f\ket{0}\ket{-} + U_f\ket{1}\ket{-})
+\tag{3}\]</div>
+<p>using <span class="math notranslate nohighlight">\(U_f\ket{x}\ket{-} = (-1)^{f(x)}\ket{x}\ket{-}\)</span> which we proved in the phase oracle section above:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{aligned}
+\ket{\psi_2}  =  \frac{1}{\sqrt{2}} ((-1)^{f(0)}\ket{0}\ket{-} + (-1)^{f(1)}\ket{1}\ket{-}) \\
+= \frac{1}{\sqrt{2}} ((-1)^{f(0)}\ket{0} + (-1)^{f(1)}\ket{1}) \ket{-} \\
+\end{aligned}\end{split}\]</div>
+<p>We now drop the second, qubit in the <span class="math notranslate nohighlight">\(\ket{-}\)</span> state from our derivations as the figure above has no further gate operations acting on it. Remember our aim is to find out if <span class="math notranslate nohighlight">\(f(x)\)</span> is a constant or a balanced function. We have the following options:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{aligned}
+\ket{\psi_{2}}=
+\begin{cases}
+      \tfrac{1}{\sqrt{2}} (\ket{0} + \ket{1})  &amp;   f(0) = 0, f(1) = 0, f(x)  \text{ is constant} \\
+      -\tfrac{1}{\sqrt{2}} (\ket{0} + \ket{1})  &amp;   f(0) = 1, f(1) = 1, f(x)  \text{ is constant} \\
+      \tfrac{1}{\sqrt{2}} (\ket{0} - \ket{1})  &amp;   f(0) = 0, f(1) = 1, f(x)  \text{ is balanced} \\
+      -\tfrac{1}{\sqrt{2}} (\ket{0} - \ket{1})  &amp;   f(0) = 1, f(1) = 0, f(x)  \text{ is balanced} \\
+\end{cases}
+\end{aligned}\end{split}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{aligned}
+\ket{\psi_{2}} =
+\begin{cases}
+      \pm \tfrac{1}{\sqrt{2}} (\ket{0} + \ket{1}) = \pm \ket{+}  &amp;    f(x)  \text{ is constant} \\
+      \pm \tfrac{1}{\sqrt{2}} (\ket{0} - \ket{1})= \pm \ket{-}  &amp;    f(x)  \text{ is balanced} \\
+\end{cases}
+\end{aligned}\end{split}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{aligned}
+\ket{\psi_{3}}= H\ket{\psi_{2}}
+\begin{cases}
+      \pm H\ket{+} =  \pm \ket{0} &amp;    f(x)  \text{ is constant} \\
+      \pm H\ket{-}  = \pm \ket{1}  &amp;   f(x)  \text{ is balanced} \\
+\end{cases}
+\end{aligned}\end{split}\]</div>
+<p>We can now measure the first qubit to yield either a <span class="math notranslate nohighlight">\(0\)</span> or a <span class="math notranslate nohighlight">\(1\)</span> to determine if <span class="math notranslate nohighlight">\(f(x)\)</span> is constant or balanced.</p>
+<p>Deutsch’s algorithm may not be practically useful but does demonstrate quantum advantage since it uses one function call to determine the property of <span class="math notranslate nohighlight">\(f\)</span> in comparison to two for classical methods.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Import the CUDA-Q package and set the target to run on NVIDIA GPUs.</span>
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Here we input the values of [f(0), f(1)] which allows us to represent constant or balanced functions.</span>
+
+<span class="n">fx</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Let us now code up the circuit shown above following the state Psi after each step.</span>
+
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">2</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">fx</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+    <span class="n">qubit_0</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">qubit_1</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+    <span class="c1"># Psi 0</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubit_1</span><span class="p">)</span>
+
+    <span class="c1"># Psi 1</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit_1</span><span class="p">)</span>
+
+    <span class="c1"># Psi 2 - oracle</span>
+    <span class="k">if</span> <span class="n">fx</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">,</span> <span class="n">qubit_1</span><span class="p">)</span>
+        <span class="n">x</span><span class="p">(</span><span class="n">qubit_1</span><span class="p">)</span>
+
+    <span class="k">if</span> <span class="n">fx</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">,</span> <span class="n">qubit_1</span><span class="p">)</span>
+
+    <span class="c1"># Psi 3</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">)</span>
+
+    <span class="c1"># Measure the qubit to yield if the function is constant or balanced.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">)</span>
+
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">fx</span><span class="p">))</span>
+
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">fx</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+
+<span class="k">if</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">result</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;0&#39;</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;f(x) is a constant function&#39;</span><span class="p">)</span>
+<span class="k">elif</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">result</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s1">&#39;1&#39;</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;f(x) is a balanced function&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮          ╭───╮
+q0 : ┤ h ├───────●──┤ h ├
+     ├───┤╭───╮╭─┴─╮╰───╯
+q1 : ┤ x ├┤ h ├┤ x ├─────
+     ╰───╯╰───╯╰───╯
+
+f(x) is a balanced function
+</pre></div></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="afqmc.html" class="btn btn-neutral float-left" title="Quantum Enhanced Auxiliary Field Quantum Monte Carlo" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="quantum_fourier_transform.html" class="btn btn-neutral float-right" title="Quantum Fourier Transform" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/deutschs_algorithm.ipynb b/pr-2241/examples/python/tutorials/deutschs_algorithm.ipynb
new file mode 100644
index 0000000000..c5bec66cab
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/deutschs_algorithm.ipynb
@@ -0,0 +1,413 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Deutsch's Algorithm "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We have a function which takes in a bit and outputs a bit. This can be represented as $f: \\{0,1\\} \\longrightarrow \\{0,1\\}$. \n",
+    "\n",
+    "The function $f$ has a property; either it is constant or balanced. \n",
+    "\n",
+    "If constant, the outputs are the same regardless of the inputs, i.e., $f(0) = f(1) = 0$ or $f(0) = f(1) = 1$.\n",
+    "\n",
+    "If balanced, the ouputs are balanced across their possibilities, i.e,  if $f(0) = 0$ then $f(1) = 1$ or if $f(0) = 1$ then $f(1) = 0$.\n",
+    "\n",
+    "The question we would like to answer is if the function is constant or balanced. \n",
+    " \n",
+    "Classically, if we are given a function $f$, we can solve to find its property via the code below: \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Treat the code snippet below like a black box, i.e., you don't have access to the value of the property argument and can just query f with different inputs.\n",
+    "\n",
+    "\n",
+    "def f(x, property='constant'):\n",
+    "\n",
+    "    if property == 'constant':\n",
+    "\n",
+    "        # The output is a 1 regardless of the input; we can also make the output to be 0.\n",
+    "\n",
+    "        if x == 0:\n",
+    "            return 1\n",
+    "        elif x == 1:\n",
+    "            return 1\n",
+    "\n",
+    "    if property == 'balanced':\n",
+    "\n",
+    "        # The output depends on the input.\n",
+    "\n",
+    "        if x == 0:\n",
+    "            return 1\n",
+    "        elif x == 1:\n",
+    "            return 0"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let us now classically find out if the function we defined above is constant or balanced. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The function is constant\n"
+     ]
+    }
+   ],
+   "source": [
+    "if f(0) == 0:\n",
+    "    if f(1) == 0:\n",
+    "        print('The function is constant')\n",
+    "    elif f(1) == 1:\n",
+    "        print('The function is balanced')\n",
+    "\n",
+    "elif f(0) == 1:\n",
+    "    if f(1) == 1:\n",
+    "        print('The function is constant')\n",
+    "    elif f(1) == 0:\n",
+    "        print('The function is balanced')"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you step through the `if` statements above, one can see that we require 2 calls to the function to determine its property. That is, we have to query $f$ twice.\n",
+    "\n",
+    "The claim is that Deutsch's algorithm can solve for this property with 1 function evalulation, demonstrating quantum advantage. \n",
+    "\n",
+    "Below we first go through the math and then the implementation in CUDA Quantum. \n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## XOR $\\oplus$\n",
+    "\n",
+    "You may have seen the $\\oplus$ symbol floating around. This is the exclusive OR or the XOR operation. It follows the rules of addition modulo 2. For example, \n",
+    "\n",
+    "\n",
+    "1. $3\\oplus5 = (3+5)_{\\%2} = 8_{\\%2} = 0$\n",
+    "\n",
+    "2. $5\\oplus4 = (5+4)_{\\%2} = 9_{\\%2} = 1$\n",
+    "\n",
+    "A quick way to perform the $\\oplus$ calculation is if the result of the addition is an even number, the result is 0 otherwise 1. "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum oracles\n",
+    "\n",
+    "<img src=\"images/oracle.png\"  width=\"300\" height=\"150\">\n",
+    "\n",
+    "Suppose we have $f(x): \\{0,1\\} \\longrightarrow \\{0,1\\}$. 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 logic gates. \n",
+    "\n",
+    "Above you see an oracle represented as $U_f$ which allows us to transform the state $\\ket{x}\\ket{y}$ into: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{x}\\ket{y}  =  \\ket{x}\\ket{y \\oplus f(x)}\n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "If $y = 0$, then $U_f\\ket{x}\\ket{y} = U_f\\ket{x}\\ket{0}  =   \\ket{x}\\ket{0 \\oplus f(x)} =  \\ket{x}\\ket{f(x)}$ since $f(x)$ can either be $0/1$ and $0 \\oplus 0 = 0$ and $0 \\oplus 1 = 1$.\n",
+    "\n",
+    "This is remarkable because by setting $\\ket{y} = \\ket{0}$, we can extract the value of $f(x)$ by measuring the value of the second qubit. \n",
+    " \n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Phase oracle\n",
+    "\n",
+    "\n",
+    "Since $f(x)$ can be either $0$ or $1$, we have that $0 \\oplus f(x) = 0 \\oplus 0 =  0 = f(x)$ or $0 \\oplus f(x) = 0 \\oplus 1 =  1 = f(x)$. \n",
+    "\n",
+    "Similarly, $1 \\oplus f(x) = 1 \\oplus 0 =  1 = \\overline{f(x)}$ or $1 \\oplus f(x) = 1 \\oplus 1 =  0 = \\overline{f(x)}$ where the bar on top of $f(x)$ denotes 'not $f(x)$'. \n",
+    "\n",
+    "\n",
+    "Let us now prove a result which we shall use later: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{x}\\ket{-}  &=   U_f \\ket{x} \\tfrac{1}{\\sqrt{2}}(\\ket{0} - \\ket{1}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (U_f\\ket{x}\\ket{0} - U_f\\ket{x}\\ket{1}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{0 \\oplus f(x)} - \\ket{x}\\ket{1 \\oplus f(x)}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{f(x)} - \\ket{x}\\ket{\\overline{f(x)}}) \\\\\n",
+    "&= \n",
+    "\\begin{cases}\n",
+    "      \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{0} - \\ket{x}\\ket{1}) = \\ket{x}\\ket{-} &   f(x) = 0 \\\\\n",
+    "      \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{1} - \\ket{x}\\ket{0}) = -\\ket{x}\\ket{-} &   f(x) = 1 \\\\\n",
+    "\\end{cases} \\\\\n",
+    "&= (-1)^{f(x)}\\ket{x}\\ket{-}    \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "In summary, $U_f\\ket{x}\\ket{-} = (-1)^{f(x)}\\ket{x}\\ket{-}$ where the $\\ket{-}$ qubit was left unchanged and a phase was applied to $\\ket{x}$. \n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "## Quantum parallelism\n",
+    "\n",
+    "Consider: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{+}\\ket{0} &= U_f \\tfrac{1}{\\sqrt{2}}(\\ket{0}+\\ket{1}) \\ket{0} \\\\\n",
+    "&= U_f \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{0}+\\ket{1}\\ket{0}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}(U_f \\ket{0}\\ket{0} + U_f \\ket{1}\\ket{0})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(U_f \\ket{0}\\ket{0} + U_f \\ket{1}\\ket{0})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{0 \\oplus f(0)} + \\ket{1}\\ket{0 \\oplus f(1)})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{f(0)} + \\ket{1}\\ket{f(1)})  \\\\   \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We have calculated information about both $f(0)$ and $f(1)$ simultaneously. Quantum mechanics allows for parallelism by exploiting the ability of superposition states.  "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Deutschs' Algorithm: \n",
+    "\n",
+    "Our aim is to find out if $f: \\{0,1\\} \\longrightarrow \\{0,1\\}$ is a constant or a balanced function? If constant, $f(0) = f(1)$, and if balanced, $f(0) \\neq f(1)$.\n",
+    "\n",
+    "We step through the circuit diagram below and follow the math after the application of each gate.\n",
+    "\n",
+    "<img src=\"images/deutsch.png\"  width=\"500\" height=\"210\">\n",
+    "\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\ket{\\psi_0}  =  \\ket{01}\n",
+    "\\tag{1}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\\ket{\\psi_1}  =   H_1H_0\\ket{\\psi_0} = H_1H_0\\ket{01} = \\ket{+-} = \\frac{1}{\\sqrt{2}} (\\ket{0}+\\ket{1})\\ket{-}\n",
+    "\\tag{2}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\ket{\\psi_2}  =   U_f\\ket{\\psi_1} = \\frac{1}{\\sqrt{2}} (U_f\\ket{0}\\ket{-} + U_f\\ket{1}\\ket{-})\n",
+    "\\tag{3}\n",
+    "$$\n",
+    "\n",
+    "using $U_f\\ket{x}\\ket{-} = (-1)^{f(x)}\\ket{x}\\ket{-}$ which we proved in the phase oracle section above: \n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_2}  =  \\frac{1}{\\sqrt{2}} ((-1)^{f(0)}\\ket{0}\\ket{-} + (-1)^{f(1)}\\ket{1}\\ket{-}) \\\\\n",
+    "= \\frac{1}{\\sqrt{2}} ((-1)^{f(0)}\\ket{0} + (-1)^{f(1)}\\ket{1}) \\ket{-} \\\\\n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We now drop the second, qubit in the $\\ket{-}$ state from our derivations as the figure above has no further gate operations acting on it. Remember our aim is to find out if $f(x)$ is a constant or a balanced function. We have the following options: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned}\n",
+    "\\ket{\\psi_{2}}=\n",
+    "\\begin{cases}\n",
+    "      \\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1})  &   f(0) = 0, f(1) = 0, f(x)  \\text{ is constant} \\\\\n",
+    "      -\\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1})  &   f(0) = 1, f(1) = 1, f(x)  \\text{ is constant} \\\\\n",
+    "      \\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})  &   f(0) = 0, f(1) = 1, f(x)  \\text{ is balanced} \\\\\n",
+    "      -\\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})  &   f(0) = 1, f(1) = 0, f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_{2}} =\n",
+    "\\begin{cases}\n",
+    "      \\pm \\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1}) = \\pm \\ket{+}  &    f(x)  \\text{ is constant} \\\\\n",
+    "      \\pm \\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})= \\pm \\ket{-}  &    f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_{3}}= H\\ket{\\psi_{2}}\n",
+    "\\begin{cases}\n",
+    "      \\pm H\\ket{+} =  \\pm \\ket{0} &    f(x)  \\text{ is constant} \\\\\n",
+    "      \\pm H\\ket{-}  = \\pm \\ket{1}  &   f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We can now measure the first qubit to yield either a $0$ or a $1$ to determine if $f(x)$ is constant or balanced. \n",
+    "\n",
+    "Deutsch's algorithm may not be practically useful but does demonstrate quantum advantage since it uses one function call to determine the property of $f$ in comparison to two for classical methods. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Import the CUDA-Q package and set the target to run on NVIDIA GPUs.\n",
+    "\n",
+    "import cudaq\n",
+    "import numpy as np\n",
+    "\n",
+    "from typing import List\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Here we input the values of [f(0), f(1)] which allows us to represent constant or balanced functions.\n",
+    "\n",
+    "fx = [0, 1]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮          ╭───╮\n",
+      "q0 : ┤ h ├───────●──┤ h ├\n",
+      "     ├───┤╭───╮╭─┴─╮╰───╯\n",
+      "q1 : ┤ x ├┤ h ├┤ x ├─────\n",
+      "     ╰───╯╰───╯╰───╯     \n",
+      "\n",
+      "f(x) is a balanced function\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Let us now code up the circuit shown above following the state Psi after each step.\n",
+    "\n",
+    "qubit_count = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(fx: List[int]):\n",
+    "    qubit_0 = cudaq.qubit()\n",
+    "    qubit_1 = cudaq.qubit()\n",
+    "\n",
+    "    # Psi 0\n",
+    "    x(qubit_1)\n",
+    "\n",
+    "    # Psi 1\n",
+    "    h(qubit_0)\n",
+    "    h(qubit_1)\n",
+    "\n",
+    "    # Psi 2 - oracle\n",
+    "    if fx[0] == 1:\n",
+    "        x.ctrl(qubit_0, qubit_1)\n",
+    "        x(qubit_1)\n",
+    "\n",
+    "    if fx[1] == 1:\n",
+    "        x.ctrl(qubit_0, qubit_1)\n",
+    "\n",
+    "    # Psi 3\n",
+    "    h(qubit_0)\n",
+    "\n",
+    "    # Measure the qubit to yield if the function is constant or balanced.\n",
+    "    mz(qubit_0)\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(kernel, fx))\n",
+    "\n",
+    "result = cudaq.sample(kernel, fx, shots_count=1)\n",
+    "\n",
+    "if np.array(result)[0] == '0':\n",
+    "    print('f(x) is a constant function')\n",
+    "elif np.array(result)[0] == '1':\n",
+    "    print('f(x) is a balanced function')"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "916dbcbb3f70747c44a77c7bcd40155683ae19c65e1c03b4aa3499c5328201f1"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/hadamard_test.html b/pr-2241/examples/python/tutorials/hadamard_test.html
new file mode 100644
index 0000000000..e40e42b4f9
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/hadamard_test.html
@@ -0,0 +1,903 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Hadamard Test and Application &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Hybrid Quantum Neural Networks" href="hybrid_qnns.html" />
+    <link rel="prev" title="Max-Cut with QAOA" href="qaoa.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Hadamard Test and Application</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/hadamard_test.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="qaoa.html" class="btn btn-neutral float-left" title="Max-Cut with QAOA" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hybrid_qnns.html" class="btn btn-neutral float-right" title="Hybrid Quantum Neural Networks" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Hadamard-Test-and-Application">
+<h1>Hadamard Test and Application<a class="headerlink" href="#Hadamard-Test-and-Application" title="Permalink to this heading">¶</a></h1>
+<p>Consider the observable <span class="math notranslate nohighlight">\(O\)</span> and two generic quantum states <span class="math notranslate nohighlight">\(\ket{\psi}\)</span> and <span class="math notranslate nohighlight">\(\ket{\phi}\)</span>. We want to calculate the quantity</p>
+<div class="math notranslate nohighlight">
+\[\braket{\psi | O | \psi}.\]</div>
+<p>where <span class="math notranslate nohighlight">\(O\)</span> is a Pauli operator.</p>
+<p>First of all we shall prepare the states <span class="math notranslate nohighlight">\(\ket{\psi}\)</span> and <span class="math notranslate nohighlight">\(\ket{\phi}\)</span> using a quantum circuit for each of them. So we have</p>
+<div class="math notranslate nohighlight">
+\[\ket{\psi} = U_{\psi}\ket{0} \qquad \ket{\phi} = U_{\phi}\ket{0}\]</div>
+<p>Let’s define an observable we want to use:</p>
+<div class="math notranslate nohighlight">
+\[O = X_1X_2\]</div>
+<p>Now we can evaluate the matrix element using the following fact:</p>
+<div class="math notranslate nohighlight">
+\[\bra{\psi}O\ket{\phi} = \bra{0}U_\psi^\dagger O U_\phi\ket{0}\]</div>
+<p>This is just an expectation value which can be solved with a simple Hadamard test. The probability to measure <span class="math notranslate nohighlight">\(0\)</span> or <span class="math notranslate nohighlight">\(1\)</span> in the ancilla qubit is</p>
+<div class="math notranslate nohighlight">
+\[P(0) = \frac{1}{2} \left[ I + \operatorname{Re} \bra{\psi} O \ket{\phi} \right]\]</div>
+<div class="math notranslate nohighlight">
+\[P(1) = \frac{1}{2} \left[ I - \operatorname{Re} \bra{\psi} O \ket{\phi} \right]\]</div>
+<p>The difference between the probability of <span class="math notranslate nohighlight">\(0\)</span> and <span class="math notranslate nohighlight">\(1\)</span> gives</p>
+<div class="math notranslate nohighlight">
+\[\braket{X} = P(0)-P(1) = \operatorname{Re} \braket{\psi | O |
+\phi}.\]</div>
+<p>Similarly, the imaginary part can be obtained from Y measurement</p>
+<div class="math notranslate nohighlight">
+\[\braket{Y} = \operatorname{Im} \braket{\psi | O | \phi}.\]</div>
+<p>Combining these results, the quantity <span class="math notranslate nohighlight">\(\braket{\psi | O | \psi}\)</span> is obtained.</p>
+<section id="Numerical-result-as-a-reference:">
+<h2>Numerical result as a reference:<a class="headerlink" href="#Numerical-result-as-a-reference:" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">functools</span> <span class="kn">import</span> <span class="n">reduce</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+
+<span class="n">num_qubits</span> <span class="o">=</span> <span class="mi">2</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">psi</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">phi</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="n">psi_state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">psi</span><span class="p">,</span> <span class="n">num_qubits</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Psi state: &quot;</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">psi_state</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">psi</span><span class="p">,</span> <span class="mi">2</span><span class="p">))</span>
+
+<span class="n">phi_state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">phi</span><span class="p">,</span> <span class="n">num_qubits</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Phi state: &quot;</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">phi_state</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">phi</span><span class="p">,</span> <span class="mi">2</span><span class="p">))</span>
+
+<span class="n">ham</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+<span class="n">ham_matrix</span> <span class="o">=</span> <span class="n">ham</span><span class="o">.</span><span class="n">to_matrix</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;hamiltonian: &quot;</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">ham_matrix</span><span class="p">),</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="n">ev_numerical</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">psi_state</span><span class="p">)</span><span class="o">.</span><span class="n">conj</span><span class="p">()</span> <span class="o">@</span> <span class="n">ham_matrix</span> <span class="o">@</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">phi_state</span><span class="p">)</span><span class="o">.</span><span class="n">T</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Numerical expectation value: &quot;</span><span class="p">,</span> <span class="n">ev_numerical</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Psi state:  [0.70710677+0.j 0.        +0.j 0.70710677+0.j 0.        +0.j]
+
+q0 : ─────
+     ╭───╮
+q1 : ┤ h ├
+     ╰───╯
+
+Phi state:  [0.+0.j 1.+0.j 0.+0.j 0.+0.j]
+     ╭───╮
+q0 : ┤ x ├
+     ╰───╯
+
+hamiltonian:  [[0.+0.j 0.+0.j 0.+0.j 1.+0.j]
+ [0.+0.j 0.+0.j 1.+0.j 0.+0.j]
+ [0.+0.j 1.+0.j 0.+0.j 0.+0.j]
+ [1.+0.j 0.+0.j 0.+0.j 0.+0.j]]
+
+Numerical expectation value:  (0.7071067690849304+0j)
+</pre></div></div>
+</div>
+</section>
+<section id="Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">
+<h2>Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.<a class="headerlink" href="#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits." title="Permalink to this heading">¶</a></h2>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">u_psi</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">u_phi</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">apply_pauli</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">ancilla</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">u_phi</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">apply_pauli</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">u_psi</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+
+
+<span class="n">num_qubits</span> <span class="o">=</span> <span class="mi">2</span>
+<span class="n">shots</span> <span class="o">=</span> <span class="mi">100000</span>
+<span class="n">x_0</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+<span class="n">y_0</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="p">[</span><span class="n">x_0</span><span class="p">,</span> <span class="n">y_0</span><span class="p">],</span> <span class="n">num_qubits</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">)</span>
+<span class="n">evs</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span> <span class="k">for</span> <span class="n">result</span> <span class="ow">in</span> <span class="n">results</span><span class="p">])</span>
+<span class="n">std_errs</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">((</span><span class="mi">1</span> <span class="o">-</span> <span class="n">evs</span><span class="o">**</span><span class="mi">2</span><span class="p">)</span> <span class="o">/</span> <span class="n">shots</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;QC result: </span><span class="si">{</span><span class="n">evs</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="si">:</span><span class="s2">.3f</span><span class="si">}</span><span class="s2">+</span><span class="si">{</span><span class="n">evs</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="si">:</span><span class="s2">.3f</span><span class="si">}</span><span class="s2">i ± </span><span class="si">{</span><span class="n">std_errs</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="si">:</span><span class="s2">.3f</span><span class="si">}</span><span class="s2">+</span><span class="si">{</span><span class="n">std_errs</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="si">:</span><span class="s2">.3f</span><span class="si">}</span><span class="s2">i&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Numerical result&quot;</span><span class="p">,</span> <span class="n">ev_numerical</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+QC result: 0.705+-0.007i ± 0.002+0.003i
+Numerical result (0.7071067690849304+0j)
+</pre></div></div>
+</div>
+</section>
+<section id="Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">
+<h2>Use multi-GPUs to compute multiple Hadamard test in parallel<a class="headerlink" href="#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Use multi-QPUs</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia-mqpu&quot;</span><span class="p">)</span>
+
+<span class="n">target</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span>
+<span class="n">num_qpus</span> <span class="o">=</span> <span class="n">target</span><span class="o">.</span><span class="n">num_qpus</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Number of QPUs:&quot;</span><span class="p">,</span> <span class="n">num_qpus</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">u_psi</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">theta</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">u_phi</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">theta</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+    <span class="n">s</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">rx</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">s</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">ham_circuit</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angle0</span><span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">angle1</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+    <span class="n">ancilla</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">u_phi</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">,</span> <span class="n">angle0</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">ham_circuit</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">u_psi</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">,</span> <span class="n">angle1</span><span class="p">)</span>
+
+
+<span class="n">angles</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">rand</span><span class="p">(</span><span class="mi">10</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">angles</span><span class="si">=}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="n">async_results</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span>
+        <span class="n">kernel</span><span class="p">,</span>
+        <span class="n">x_0</span><span class="p">,</span>
+        <span class="nb">float</span><span class="p">(</span><span class="n">angle</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span>
+        <span class="nb">float</span><span class="p">(</span><span class="n">angle</span><span class="p">[</span><span class="mi">1</span><span class="p">]),</span>
+        <span class="n">qpu_id</span><span class="o">=</span><span class="n">i</span> <span class="o">%</span> <span class="n">num_qpus</span><span class="p">,</span>
+    <span class="p">)</span>
+    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">angle</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">angles</span><span class="p">)</span>
+<span class="p">]</span>
+
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">async_result</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">async_results</span><span class="p">):</span>
+    <span class="n">ev</span> <span class="o">=</span> <span class="n">async_result</span><span class="o">.</span><span class="n">get</span><span class="p">()</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">i</span><span class="si">}</span><span class="s2">-th </span><span class="si">{</span><span class="n">ev</span><span class="si">=}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Number of QPUs: 5
+angles=array([[1.56322878, 3.09176639],
+       [0.04025496, 5.59986135],
+       [1.87024074, 0.93078226],
+       [4.44015281, 5.05675948],
+       [1.92402471, 2.12981374],
+       [0.49704605, 3.6020906 ],
+       [4.50280746, 2.78988978],
+       [4.006956  , 3.7581442 ],
+       [3.00524035, 3.10937881],
+       [3.13405202, 1.33235091]])
+0-th ev=-0.7042075991630554
+1-th ev=-0.006743329111486673
+2-th ev=-0.36111390590667725
+3-th ev=-0.45839524269104004
+4-th ev=-0.7175908088684082
+5-th ev=-0.23948131501674652
+6-th ev=-0.765204668045044
+7-th ev=-0.865047037601471
+8-th ev=-0.9975475072860718
+9-th ev=-0.6179792881011963
+</pre></div></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="qaoa.html" class="btn btn-neutral float-left" title="Max-Cut with QAOA" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hybrid_qnns.html" class="btn btn-neutral float-right" title="Hybrid Quantum Neural Networks" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/hadamard_test.ipynb b/pr-2241/examples/python/tutorials/hadamard_test.ipynb
new file mode 100644
index 0000000000..104d99ddb5
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/hadamard_test.ipynb
@@ -0,0 +1,310 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hadamard Test and Application\n",
+    "\n",
+    "Consider the observable $O$ and two generic quantum states $\\ket{\\psi}$ and $\\ket{\\phi}$. We want to calculate the quantity\n",
+    "$$\n",
+    "\\braket{\\psi | O | \\psi}.\n",
+    "$$\n",
+    "where $O$ is a Pauli operator.\n",
+    "\n",
+    "First of all we shall prepare the states $\\ket{\\psi}$ and $\\ket{\\phi}$ using a quantum circuit for each of them. So we  have\n",
+    "$$\n",
+    "\\ket{\\psi} = U_{\\psi}\\ket{0} \\qquad \\ket{\\phi} = U_{\\phi}\\ket{0}\n",
+    "$$\n",
+    "\n",
+    "Let's define an observable we want to use:\n",
+    "$$\n",
+    "O = X_1X_2\n",
+    "$$\n",
+    "\n",
+    "Now we can evaluate the matrix element using the following fact:\n",
+    "$$\n",
+    "\\bra{\\psi}O\\ket{\\phi} = \\bra{0}U_\\psi^\\dagger O U_\\phi\\ket{0}\n",
+    "$$\n",
+    "This is just an expectation value which can be solved with a simple Hadamard test. The probability to measure $0$ or $1$ in the ancilla qubit is\n",
+    "\n",
+    "$$\n",
+    "P(0) = \\frac{1}{2} \\left[ I + \\operatorname{Re} \\bra{\\psi} O \\ket{\\phi} \\right]\n",
+    "$$\n",
+    "\n",
+    "$$\n",
+    "P(1) = \\frac{1}{2} \\left[ I - \\operatorname{Re} \\bra{\\psi} O \\ket{\\phi} \\right]\n",
+    "$$\n",
+    "\n",
+    "The difference between the probability of $0$ and $1$ gives \n",
+    "\n",
+    "$$\n",
+    "\\braket{X} = P(0)-P(1) = \\operatorname{Re} \\braket{\\psi | O | \n",
+    "\\phi}.\n",
+    "$$\n",
+    "\n",
+    "Similarly, the imaginary part can be obtained from Y measurement\n",
+    "$$\n",
+    "\\braket{Y} = \\operatorname{Im} \\braket{\\psi | O | \\phi}.\n",
+    "$$\n",
+    "\n",
+    "Combining these results, the quantity $\\braket{\\psi | O | \\psi}$ is obtained."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Numerical result as a reference: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Psi state:  [0.70710677+0.j 0.        +0.j 0.70710677+0.j 0.        +0.j]\n",
+      "          \n",
+      "q0 : ─────\n",
+      "     ╭───╮\n",
+      "q1 : ┤ h ├\n",
+      "     ╰───╯\n",
+      "\n",
+      "Phi state:  [0.+0.j 1.+0.j 0.+0.j 0.+0.j]\n",
+      "     ╭───╮\n",
+      "q0 : ┤ x ├\n",
+      "     ╰───╯\n",
+      "\n",
+      "hamiltonian:  [[0.+0.j 0.+0.j 0.+0.j 1.+0.j]\n",
+      " [0.+0.j 0.+0.j 1.+0.j 0.+0.j]\n",
+      " [0.+0.j 1.+0.j 0.+0.j 0.+0.j]\n",
+      " [1.+0.j 0.+0.j 0.+0.j 0.+0.j]] \n",
+      "\n",
+      "Numerical expectation value:  (0.7071067690849304+0j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "from functools import reduce\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "import cudaq\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "\n",
+    "num_qubits = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def psi(num_qubits: int):\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    h(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def phi(num_qubits: int):\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    x(q[0])\n",
+    "\n",
+    "\n",
+    "psi_state = cudaq.get_state(psi, num_qubits)\n",
+    "print(\"Psi state: \", np.array(psi_state))\n",
+    "print(cudaq.draw(psi, 2))\n",
+    "\n",
+    "phi_state = cudaq.get_state(phi, num_qubits)\n",
+    "print(\"Phi state: \", np.array(phi_state))\n",
+    "print(cudaq.draw(phi, 2))\n",
+    "\n",
+    "ham = cudaq.spin.x(0) * cudaq.spin.x(1)\n",
+    "ham_matrix = ham.to_matrix()\n",
+    "print(\"hamiltonian: \", np.array(ham_matrix), \"\\n\")\n",
+    "\n",
+    "ev_numerical = np.array(psi_state).conj() @ ham_matrix @ np.array(phi_state).T\n",
+    "\n",
+    "print(\"Numerical expectation value: \", ev_numerical)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using ``observe`` algorithmic primitive to compute the expectation value for ancilla qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "QC result: 0.705+-0.007i ± 0.002+0.003i\n",
+      "Numerical result (0.7071067690849304+0j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "@cudaq.kernel\n",
+    "def u_psi(q: cudaq.qview):\n",
+    "    h(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_phi(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def apply_pauli(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "    x(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(num_qubits: int):\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    h(ancilla)\n",
+    "    cudaq.control(u_phi, ancilla, q)\n",
+    "    cudaq.control(apply_pauli, ancilla, q)\n",
+    "    cudaq.control(u_psi, ancilla, q)\n",
+    "\n",
+    "\n",
+    "num_qubits = 2\n",
+    "shots = 100000\n",
+    "x_0 = cudaq.spin.x(0)\n",
+    "y_0 = cudaq.spin.y(0)\n",
+    "results = cudaq.observe(kernel, [x_0, y_0], num_qubits, shots_count=shots)\n",
+    "evs = np.array([result.expectation() for result in results])\n",
+    "std_errs = np.sqrt((1 - evs**2) / shots)\n",
+    "\n",
+    "print(f\"QC result: {evs[0]:.3f}+{evs[1]:.3f}i ± {std_errs[0]:.3f}+{std_errs[1]:.3f}i\")\n",
+    "print(\"Numerical result\", ev_numerical)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Use multi-GPUs to compute multiple Hadamard test in parallel"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Number of QPUs: 5\n",
+      "angles=array([[1.56322878, 3.09176639],\n",
+      "       [0.04025496, 5.59986135],\n",
+      "       [1.87024074, 0.93078226],\n",
+      "       [4.44015281, 5.05675948],\n",
+      "       [1.92402471, 2.12981374],\n",
+      "       [0.49704605, 3.6020906 ],\n",
+      "       [4.50280746, 2.78988978],\n",
+      "       [4.006956  , 3.7581442 ],\n",
+      "       [3.00524035, 3.10937881],\n",
+      "       [3.13405202, 1.33235091]])\n",
+      "0-th ev=-0.7042075991630554\n",
+      "1-th ev=-0.006743329111486673\n",
+      "2-th ev=-0.36111390590667725\n",
+      "3-th ev=-0.45839524269104004\n",
+      "4-th ev=-0.7175908088684082\n",
+      "5-th ev=-0.23948131501674652\n",
+      "6-th ev=-0.765204668045044\n",
+      "7-th ev=-0.865047037601471\n",
+      "8-th ev=-0.9975475072860718\n",
+      "9-th ev=-0.6179792881011963\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Use multi-QPUs\n",
+    "cudaq.set_target(\"nvidia-mqpu\")\n",
+    "\n",
+    "target = cudaq.get_target()\n",
+    "num_qpus = target.num_qpus()\n",
+    "print(\"Number of QPUs:\", num_qpus)\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_psi(q: cudaq.qview, theta: float):\n",
+    "    ry(theta, q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_phi(q: cudaq.qview, theta: float):\n",
+    "    s(q[0])\n",
+    "    rx(theta, q[0])\n",
+    "    s(q[0])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def ham_circuit(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "    x(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(angle0: float, angle1: float):\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    q = cudaq.qvector(2)\n",
+    "    h(ancilla)\n",
+    "    cudaq.control(u_phi, ancilla, q, angle0)\n",
+    "    cudaq.control(ham_circuit, ancilla, q)\n",
+    "    cudaq.control(u_psi, ancilla, q, angle1)\n",
+    "\n",
+    "\n",
+    "angles = 2 * np.pi * np.random.rand(10, 2)\n",
+    "print(f\"{angles=}\")\n",
+    "\n",
+    "async_results = [\n",
+    "    cudaq.observe_async(\n",
+    "        kernel,\n",
+    "        x_0,\n",
+    "        float(angle[0]),\n",
+    "        float(angle[1]),\n",
+    "        qpu_id=i % num_qpus,\n",
+    "    )\n",
+    "    for i, angle in enumerate(angles)\n",
+    "]\n",
+    "\n",
+    "for i, async_result in enumerate(async_results):\n",
+    "    ev = async_result.get().expectation()\n",
+    "    print(f\"{i}-th {ev=}\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/examples/python/tutorials/hybrid_qnns.html b/pr-2241/examples/python/tutorials/hybrid_qnns.html
new file mode 100644
index 0000000000..a9afb8d7d2
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/hybrid_qnns.html
@@ -0,0 +1,1068 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Hybrid Quantum Neural Networks &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Molecular docking via DC-QAOA" href="maximum_vertex_weight_clique.html" />
+    <link rel="prev" title="Hadamard Test and Application" href="hadamard_test.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Hybrid Quantum Neural Networks</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/hybrid_qnns.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="hadamard_test.html" class="btn btn-neutral float-left" title="Hadamard Test and Application" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="maximum_vertex_weight_clique.html" class="btn btn-neutral float-right" title="Molecular docking via DC-QAOA" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Hybrid-Quantum-Neural-Networks">
+<h1>Hybrid Quantum Neural Networks<a class="headerlink" href="#Hybrid-Quantum-Neural-Networks" title="Permalink to this heading">¶</a></h1>
+<p>The example below highlights a hybrid quantum neural network workflow with CUDA-Q and PyTorch where both layers can GPU accelerated to maximise performance.</p>
+<p><img alt="hybrid" class="no-scaled-link" src="../../../_images/hybrid.png" style="width: 600px;" /></p>
+<p>We perform binary classification on the MNIST dataset where data flows through the neural network architecture to the quantum circuit whose output is used to classify hand written digits.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install the relevant packages.</span>
+
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">matplotlib</span><span class="o">==</span><span class="m">3</span>.8.4
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">torch</span><span class="o">==</span><span class="m">2</span>.2.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">torchvision</span><span class="o">==</span><span class="m">0</span>.17.0
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span>scikit-learn<span class="o">==</span><span class="m">1</span>.4.2
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><br/><span></span><span class="c1"># Import the relevant libraries</span>
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="kn">import</span> <span class="nn">torch</span>
+<span class="kn">from</span> <span class="nn">torch.autograd</span> <span class="kn">import</span> <span class="n">Function</span>
+<span class="kn">from</span> <span class="nn">torchvision</span> <span class="kn">import</span> <span class="n">datasets</span><span class="p">,</span> <span class="n">transforms</span>
+<span class="kn">import</span> <span class="nn">torch.optim</span> <span class="k">as</span> <span class="nn">optim</span>
+<span class="kn">import</span> <span class="nn">torch.nn</span> <span class="k">as</span> <span class="nn">nn</span>
+<span class="kn">import</span> <span class="nn">torchvision</span>
+
+<span class="kn">from</span> <span class="nn">sklearn.model_selection</span> <span class="kn">import</span> <span class="n">train_test_split</span>
+
+<span class="n">torch</span><span class="o">.</span><span class="n">manual_seed</span><span class="p">(</span><span class="mi">22</span><span class="p">)</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_random_seed</span><span class="p">(</span><span class="mi">44</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Set CUDAQ and PyTorch to run on either CPU or GPU.</span>
+
+<span class="n">device</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">device</span><span class="p">(</span><span class="s1">&#39;cpu&#39;</span><span class="p">)</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;qpp-cpu&quot;</span><span class="p">)</span>
+
+<span class="c1">#cudaq.set_target(&quot;nvidia&quot;)</span>
+<span class="c1">#device = torch.device(&quot;cuda:0&quot;)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">prepare_data</span><span class="p">(</span><span class="n">target_digits</span><span class="p">,</span> <span class="n">sample_count</span><span class="p">,</span> <span class="n">test_size</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Load and prepare the MNIST dataset to be used</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        target_digits (list): digits to perform classification of</span>
+<span class="sd">        sample_count (int): total number of images to be used</span>
+<span class="sd">        test_size (float): percentage of sample_count to be used as test set, the remainder is the training set</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        dataset in train, test format with targets</span>
+
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="n">transform</span> <span class="o">=</span> <span class="n">transforms</span><span class="o">.</span><span class="n">Compose</span><span class="p">(</span>
+        <span class="p">[</span><span class="n">transforms</span><span class="o">.</span><span class="n">ToTensor</span><span class="p">(),</span>
+         <span class="n">transforms</span><span class="o">.</span><span class="n">Normalize</span><span class="p">((</span><span class="mf">0.1307</span><span class="p">),</span> <span class="p">(</span><span class="mf">0.3081</span><span class="p">))])</span>
+
+    <span class="n">dataset</span> <span class="o">=</span> <span class="n">datasets</span><span class="o">.</span><span class="n">MNIST</span><span class="p">(</span><span class="s2">&quot;./data&quot;</span><span class="p">,</span>
+                             <span class="n">train</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+                             <span class="n">download</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+                             <span class="n">transform</span><span class="o">=</span><span class="n">transform</span><span class="p">)</span>
+
+    <span class="c1"># Filter out the required labels.</span>
+    <span class="n">idx</span> <span class="o">=</span> <span class="p">(</span><span class="n">dataset</span><span class="o">.</span><span class="n">targets</span> <span class="o">==</span> <span class="n">target_digits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span> <span class="o">|</span> <span class="p">(</span><span class="n">dataset</span><span class="o">.</span><span class="n">targets</span>
+                                                   <span class="o">==</span> <span class="n">target_digits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">dataset</span><span class="o">.</span><span class="n">data</span> <span class="o">=</span> <span class="n">dataset</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
+    <span class="n">dataset</span><span class="o">.</span><span class="n">targets</span> <span class="o">=</span> <span class="n">dataset</span><span class="o">.</span><span class="n">targets</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
+
+    <span class="c1"># Select a subset based on number of datapoints specified by sample_count.</span>
+    <span class="n">subset_indices</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">randperm</span><span class="p">(</span><span class="n">dataset</span><span class="o">.</span><span class="n">data</span><span class="o">.</span><span class="n">size</span><span class="p">(</span><span class="mi">0</span><span class="p">))[:</span><span class="n">sample_count</span><span class="p">]</span>
+
+    <span class="n">x</span> <span class="o">=</span> <span class="n">dataset</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="n">subset_indices</span><span class="p">]</span><span class="o">.</span><span class="n">float</span><span class="p">()</span><span class="o">.</span><span class="n">unsqueeze</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+    <span class="n">y</span> <span class="o">=</span> <span class="n">dataset</span><span class="o">.</span><span class="n">targets</span><span class="p">[</span><span class="n">subset_indices</span><span class="p">]</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span><span class="o">.</span><span class="n">float</span><span class="p">()</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+    <span class="c1"># Relabel the targets as a 0 or a 1.</span>
+    <span class="n">y</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="n">y</span> <span class="o">==</span> <span class="nb">min</span><span class="p">(</span><span class="n">target_digits</span><span class="p">),</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">)</span>
+
+    <span class="n">x_train</span><span class="p">,</span> <span class="n">x_test</span><span class="p">,</span> <span class="n">y_train</span><span class="p">,</span> <span class="n">y_test</span> <span class="o">=</span> <span class="n">train_test_split</span><span class="p">(</span><span class="n">x</span><span class="p">,</span>
+                                                        <span class="n">y</span><span class="p">,</span>
+                                                        <span class="n">test_size</span><span class="o">=</span><span class="n">test_size</span> <span class="o">/</span>
+                                                        <span class="mi">100</span><span class="p">,</span>
+                                                        <span class="n">shuffle</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+                                                        <span class="n">random_state</span><span class="o">=</span><span class="mi">42</span><span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">x_train</span><span class="p">,</span> <span class="n">x_test</span><span class="p">,</span> <span class="n">y_train</span><span class="p">,</span> <span class="n">y_test</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Classical parameters.</span>
+
+<span class="n">sample_count</span> <span class="o">=</span> <span class="mi">1000</span>  <span class="c1"># Total number of images to use.</span>
+<span class="n">target_digits</span> <span class="o">=</span> <span class="p">[</span><span class="mi">5</span><span class="p">,</span> <span class="mi">6</span><span class="p">]</span>  <span class="c1"># Hand written digits to classify.</span>
+<span class="n">test_size</span> <span class="o">=</span> <span class="mi">30</span>  <span class="c1"># Percentage of dataset to be used for testing.</span>
+<span class="n">classification_threshold</span> <span class="o">=</span> <span class="mf">0.5</span>  <span class="c1"># Classification boundary used to measure accuracy.</span>
+<span class="n">epochs</span> <span class="o">=</span> <span class="mi">1000</span>  <span class="c1"># Number of epochs to train for.</span>
+
+<span class="c1"># Quantum parmeters.</span>
+
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>  <span class="c1"># Measurement operator.</span>
+<span class="n">shift</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">(</span><span class="n">torch</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="p">)</span>  <span class="c1"># Magnitude of parameter shift.</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">x_train</span><span class="p">,</span> <span class="n">x_test</span><span class="p">,</span> <span class="n">y_train</span><span class="p">,</span> <span class="n">y_test</span> <span class="o">=</span> <span class="n">prepare_data</span><span class="p">(</span><span class="n">target_digits</span><span class="p">,</span> <span class="n">sample_count</span><span class="p">,</span>
+                                                <span class="n">test_size</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Plot some images from the training set to visualise.</span>
+<span class="k">if</span> <span class="n">device</span> <span class="o">!=</span> <span class="s1">&#39;cpu&#39;</span><span class="p">:</span>
+    <span class="n">sample_to_plot</span> <span class="o">=</span> <span class="n">x_train</span><span class="p">[:</span><span class="mi">10</span><span class="p">]</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">torch</span><span class="o">.</span><span class="n">device</span><span class="p">(</span><span class="s1">&#39;cpu&#39;</span><span class="p">))</span>
+<span class="k">else</span><span class="p">:</span>
+    <span class="n">sample_to_plot</span> <span class="o">=</span> <span class="n">x_train</span><span class="p">[:</span><span class="mi">10</span><span class="p">]</span>
+
+<span class="n">grid_img</span> <span class="o">=</span> <span class="n">torchvision</span><span class="o">.</span><span class="n">utils</span><span class="o">.</span><span class="n">make_grid</span><span class="p">(</span><span class="n">sample_to_plot</span><span class="p">,</span>
+                                       <span class="n">nrow</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span>
+                                       <span class="n">padding</span><span class="o">=</span><span class="mi">3</span><span class="p">,</span>
+                                       <span class="n">normalize</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">imshow</span><span class="p">(</span><span class="n">grid_img</span><span class="o">.</span><span class="n">permute</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">0</span><span class="p">))</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">axis</span><span class="p">(</span><span class="s1">&#39;off&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_hybrid_qnns_9_0.png" src="../../../_images/examples_python_tutorials_hybrid_qnns_9_0.png" />
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">QuantumFunction</span><span class="p">(</span><span class="n">Function</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Allows the quantum circuit to input data, output expectation values</span>
+<span class="sd">    and calculate gradients of variational parameters via finite difference&quot;&quot;&quot;</span>
+
+    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Define the quantum circuit in CUDA Quantum&quot;&quot;&quot;</span>
+
+        <span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+        <span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">thetas</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">):</span>
+
+            <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+
+            <span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+            <span class="n">rx</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">kernel</span> <span class="o">=</span> <span class="n">kernel</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">qubit_count</span> <span class="o">=</span> <span class="n">qubit_count</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">hamiltonian</span> <span class="o">=</span> <span class="n">hamiltonian</span>
+
+    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">theta_vals</span><span class="p">:</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Excetute the quantum circuit to output an expectation value&quot;&quot;&quot;</span>
+
+        <span class="c1">#If running on GPU, thetas is a torch.tensor that will live on GPU memory. The observe function calls a .tolist() method on inputs which moves thetas from GPU to CPU.</span>
+
+        <span class="n">qubit_count</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">qubit_count</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">theta_vals</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">])]</span>
+
+        <span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">kernel</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">hamiltonian</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span>
+                                <span class="n">theta_vals</span><span class="p">)</span>
+
+        <span class="n">exp_vals</span> <span class="o">=</span> <span class="p">[</span><span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">results</span><span class="p">))]</span>
+        <span class="n">exp_vals</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">Tensor</span><span class="p">(</span><span class="n">exp_vals</span><span class="p">)</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">exp_vals</span>
+
+    <span class="nd">@staticmethod</span>
+    <span class="k">def</span> <span class="nf">forward</span><span class="p">(</span><span class="n">ctx</span><span class="p">,</span> <span class="n">thetas</span><span class="p">:</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">,</span> <span class="n">quantum_circuit</span><span class="p">,</span>
+                <span class="n">shift</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">:</span>
+
+        <span class="c1"># Save shift and quantum_circuit in context to use in backward.</span>
+        <span class="n">ctx</span><span class="o">.</span><span class="n">shift</span> <span class="o">=</span> <span class="n">shift</span>
+        <span class="n">ctx</span><span class="o">.</span><span class="n">quantum_circuit</span> <span class="o">=</span> <span class="n">quantum_circuit</span>
+
+        <span class="c1"># Calculate expectation value.</span>
+        <span class="n">exp_vals</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">quantum_circuit</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">thetas</span><span class="p">)</span><span class="o">.</span><span class="n">reshape</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+
+        <span class="n">ctx</span><span class="o">.</span><span class="n">save_for_backward</span><span class="p">(</span><span class="n">thetas</span><span class="p">,</span> <span class="n">exp_vals</span><span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">exp_vals</span>
+
+    <span class="nd">@staticmethod</span>
+    <span class="k">def</span> <span class="nf">backward</span><span class="p">(</span><span class="n">ctx</span><span class="p">,</span> <span class="n">grad_output</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Backward pass computation via finite difference&quot;&quot;&quot;</span>
+
+        <span class="n">thetas</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">saved_tensors</span>
+
+        <span class="n">gradients</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">thetas</span><span class="o">.</span><span class="n">shape</span><span class="p">,</span> <span class="n">device</span><span class="o">=</span><span class="n">device</span><span class="p">)</span>
+
+        <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">thetas</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">1</span><span class="p">]):</span>
+
+            <span class="n">thetas_plus</span> <span class="o">=</span> <span class="n">thetas</span><span class="o">.</span><span class="n">clone</span><span class="p">()</span>
+            <span class="n">thetas_plus</span><span class="p">[:,</span> <span class="n">i</span><span class="p">]</span> <span class="o">+=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">shift</span>
+            <span class="n">exp_vals_plus</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">quantum_circuit</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">thetas_plus</span><span class="p">)</span>
+
+            <span class="n">thetas_minus</span> <span class="o">=</span> <span class="n">thetas</span><span class="o">.</span><span class="n">clone</span><span class="p">()</span>
+            <span class="n">thetas_minus</span><span class="p">[:,</span> <span class="n">i</span><span class="p">]</span> <span class="o">-=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">shift</span>
+            <span class="n">exp_vals_minus</span> <span class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span class="n">quantum_circuit</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">thetas_minus</span><span class="p">)</span>
+
+            <span class="n">gradients</span><span class="p">[:,</span> <span class="n">i</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">exp_vals_plus</span> <span class="o">-</span> <span class="n">exp_vals_minus</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span><span class="mi">2</span> <span class="o">*</span> <span class="n">ctx</span><span class="o">.</span><span class="n">shift</span><span class="p">)</span>
+
+        <span class="n">gradients</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">mul</span><span class="p">(</span><span class="n">grad_output</span><span class="p">,</span> <span class="n">gradients</span><span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">gradients</span><span class="p">,</span> <span class="kc">None</span><span class="p">,</span> <span class="kc">None</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">QuantumLayer</span><span class="p">(</span><span class="n">nn</span><span class="o">.</span><span class="n">Module</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Encapsulates a quantum circuit into a quantum layer adhering PyTorch convention&quot;&quot;&quot;</span>
+
+    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">shift</span><span class="p">:</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">):</span>
+        <span class="nb">super</span><span class="p">(</span><span class="n">QuantumLayer</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">quantum_circuit</span> <span class="o">=</span> <span class="n">QuantumFunction</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">shift</span> <span class="o">=</span> <span class="n">shift</span>
+
+    <span class="k">def</span> <span class="nf">forward</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="nb">input</span><span class="p">):</span>
+
+        <span class="n">result</span> <span class="o">=</span> <span class="n">QuantumFunction</span><span class="o">.</span><span class="n">apply</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">quantum_circuit</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">shift</span><span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">result</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">Hybrid_QNN</span><span class="p">(</span><span class="n">nn</span><span class="o">.</span><span class="n">Module</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Structure of the hybrid neural network with classical fully connected layers and quantum layers&quot;&quot;&quot;</span>
+
+    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="nb">super</span><span class="p">(</span><span class="n">Hybrid_QNN</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">fc1</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="mi">28</span> <span class="o">*</span> <span class="mi">28</span><span class="p">,</span> <span class="mi">256</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">fc2</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="mi">256</span><span class="p">,</span> <span class="mi">128</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">dropout</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Dropout</span><span class="p">(</span><span class="mf">0.25</span><span class="p">)</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">fc3</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="mi">128</span><span class="p">,</span> <span class="mi">64</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">fc4</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="mi">64</span><span class="p">,</span> <span class="mi">32</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">fc5</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="mi">32</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">dropout</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Dropout</span><span class="p">(</span><span class="mf">0.25</span><span class="p">)</span>
+
+        <span class="c1"># The 2 outputs from PyTorch fc5 layer feed into the 2 variational gates in the quantum circuit.</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">quantum</span> <span class="o">=</span> <span class="n">QuantumLayer</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">shift</span><span class="p">)</span>
+
+    <span class="k">def</span> <span class="nf">forward</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">x</span><span class="p">):</span>
+
+        <span class="n">x</span> <span class="o">=</span> <span class="n">x</span><span class="o">.</span><span class="n">view</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="mi">28</span> <span class="o">*</span> <span class="mi">28</span><span class="p">)</span>  <span class="c1"># Turns images into vectors.</span>
+
+        <span class="n">x</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">relu</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fc1</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">relu</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fc2</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dropout</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
+
+        <span class="n">x</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">relu</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fc3</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">relu</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fc4</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">relu</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">fc5</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dropout</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
+
+        <span class="c1"># Quantum circuit outputs an expectation value which is fed into the sigmoid activation function to perform classification.</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">sigmoid</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">quantum</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+
+        <span class="k">return</span> <span class="n">x</span><span class="o">.</span><span class="n">view</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">accuracy_score</span><span class="p">(</span><span class="n">y</span><span class="p">,</span> <span class="n">y_hat</span><span class="p">):</span>
+    <span class="k">return</span> <span class="nb">sum</span><span class="p">((</span><span class="n">y</span> <span class="o">==</span> <span class="p">(</span><span class="n">y_hat</span> <span class="o">&gt;=</span> <span class="n">classification_threshold</span><span class="p">)))</span> <span class="o">/</span> <span class="nb">len</span><span class="p">(</span><span class="n">y</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">hybrid_model</span> <span class="o">=</span> <span class="n">Hybrid_QNN</span><span class="p">()</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">optim</span><span class="o">.</span><span class="n">Adadelta</span><span class="p">(</span><span class="n">hybrid_model</span><span class="o">.</span><span class="n">parameters</span><span class="p">(),</span>
+                           <span class="n">lr</span><span class="o">=</span><span class="mf">0.001</span><span class="p">,</span>
+                           <span class="n">weight_decay</span><span class="o">=</span><span class="mf">0.8</span><span class="p">)</span>
+
+<span class="n">loss_function</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">BCELoss</span><span class="p">()</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+<span class="n">training_cost</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="n">testing_cost</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="n">training_accuracy</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="n">testing_accuracy</span> <span class="o">=</span> <span class="p">[]</span>
+
+<span class="n">hybrid_model</span><span class="o">.</span><span class="n">train</span><span class="p">()</span>
+<span class="k">for</span> <span class="n">epoch</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">epochs</span><span class="p">):</span>
+
+    <span class="n">optimizer</span><span class="o">.</span><span class="n">zero_grad</span><span class="p">()</span>
+
+    <span class="n">y_hat_train</span> <span class="o">=</span> <span class="n">hybrid_model</span><span class="p">(</span><span class="n">x_train</span><span class="p">)</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+    <span class="n">train_cost</span> <span class="o">=</span> <span class="n">loss_function</span><span class="p">(</span><span class="n">y_hat_train</span><span class="p">,</span> <span class="n">y_train</span><span class="p">)</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+    <span class="n">train_cost</span><span class="o">.</span><span class="n">backward</span><span class="p">()</span>
+
+    <span class="n">optimizer</span><span class="o">.</span><span class="n">step</span><span class="p">()</span>
+
+    <span class="n">training_accuracy</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">accuracy_score</span><span class="p">(</span><span class="n">y_train</span><span class="p">,</span> <span class="n">y_hat_train</span><span class="p">))</span>
+    <span class="n">training_cost</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">train_cost</span><span class="o">.</span><span class="n">item</span><span class="p">())</span>
+
+    <span class="n">hybrid_model</span><span class="o">.</span><span class="n">eval</span><span class="p">()</span>
+    <span class="k">with</span> <span class="n">torch</span><span class="o">.</span><span class="n">no_grad</span><span class="p">():</span>
+
+        <span class="n">y_hat_test</span> <span class="o">=</span> <span class="n">hybrid_model</span><span class="p">(</span><span class="n">x_test</span><span class="p">)</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+        <span class="n">test_cost</span> <span class="o">=</span> <span class="n">loss_function</span><span class="p">(</span><span class="n">y_hat_test</span><span class="p">,</span> <span class="n">y_test</span><span class="p">)</span><span class="o">.</span><span class="n">to</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+
+        <span class="n">testing_accuracy</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">accuracy_score</span><span class="p">(</span><span class="n">y_test</span><span class="p">,</span> <span class="n">y_hat_test</span><span class="p">))</span>
+        <span class="n">testing_cost</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">test_cost</span><span class="o">.</span><span class="n">item</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[12]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">plt</span><span class="o">.</span><span class="n">figure</span><span class="p">(</span><span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">10</span><span class="p">,</span> <span class="mi">5</span><span class="p">))</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">subplot</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">training_cost</span><span class="p">,</span> <span class="n">label</span><span class="o">=</span><span class="s1">&#39;Train&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">testing_cost</span><span class="p">,</span> <span class="n">label</span><span class="o">=</span><span class="s1">&#39;Test&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s1">&#39;Epochs&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s1">&#39;Cost&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">legend</span><span class="p">()</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">subplot</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">training_accuracy</span><span class="p">,</span> <span class="n">label</span><span class="o">=</span><span class="s1">&#39;Train&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">testing_accuracy</span><span class="p">,</span> <span class="n">label</span><span class="o">=</span><span class="s1">&#39;Test&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s1">&#39;Epochs&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s1">&#39;Accuracy&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">legend</span><span class="p">()</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">tight_layout</span><span class="p">()</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_hybrid_qnns_15_0.png" src="../../../_images/examples_python_tutorials_hybrid_qnns_15_0.png" />
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[13]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">__version__</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)
+</pre></div></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="hadamard_test.html" class="btn btn-neutral float-left" title="Hadamard Test and Application" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="maximum_vertex_weight_clique.html" class="btn btn-neutral float-right" title="Molecular docking via DC-QAOA" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/hybrid_qnns.ipynb b/pr-2241/examples/python/tutorials/hybrid_qnns.ipynb
new file mode 100644
index 0000000000..069af35d1d
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/hybrid_qnns.ipynb
@@ -0,0 +1,486 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hybrid Quantum Neural Networks\n",
+    "\n",
+    "The example below highlights a hybrid quantum neural network workflow with CUDA-Q and PyTorch where both layers can GPU accelerated to maximise performance."
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img src=\"images/hybrid.png\" alt=\"hybrid\" width=\"600\">\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We perform binary classification on the MNIST dataset where data flows through the neural network architecture to the quantum circuit whose output is used to classify hand written digits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install torch==2.2.2\n",
+    "!pip install torchvision==0.17.0\n",
+    "!pip install scikit-learn==1.4.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Import the relevant libraries \n",
+    "\n",
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "import torch\n",
+    "from torch.autograd import Function\n",
+    "from torchvision import datasets, transforms\n",
+    "import torch.optim as optim\n",
+    "import torch.nn as nn\n",
+    "import torchvision\n",
+    "\n",
+    "from sklearn.model_selection import train_test_split\n",
+    "\n",
+    "torch.manual_seed(22)\n",
+    "cudaq.set_random_seed(44)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Set CUDAQ and PyTorch to run on either CPU or GPU.\n",
+    "\n",
+    "device = torch.device('cpu')\n",
+    "cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "#cudaq.set_target(\"nvidia\")\n",
+    "#device = torch.device(\"cuda:0\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def prepare_data(target_digits, sample_count, test_size):\n",
+    "    \"\"\"Load and prepare the MNIST dataset to be used \n",
+    "    \n",
+    "    Args: \n",
+    "        target_digits (list): digits to perform classification of \n",
+    "        sample_count (int): total number of images to be used\n",
+    "        test_size (float): percentage of sample_count to be used as test set, the remainder is the training set\n",
+    "        \n",
+    "    Returns: \n",
+    "        dataset in train, test format with targets \n",
+    "    \n",
+    "    \"\"\"\n",
+    "\n",
+    "    transform = transforms.Compose(\n",
+    "        [transforms.ToTensor(),\n",
+    "         transforms.Normalize((0.1307), (0.3081))])\n",
+    "\n",
+    "    dataset = datasets.MNIST(\"./data\",\n",
+    "                             train=True,\n",
+    "                             download=True,\n",
+    "                             transform=transform)\n",
+    "\n",
+    "    # Filter out the required labels.\n",
+    "    idx = (dataset.targets == target_digits[0]) | (dataset.targets\n",
+    "                                                   == target_digits[1])\n",
+    "    dataset.data = dataset.data[idx]\n",
+    "    dataset.targets = dataset.targets[idx]\n",
+    "\n",
+    "    # Select a subset based on number of datapoints specified by sample_count.\n",
+    "    subset_indices = torch.randperm(dataset.data.size(0))[:sample_count]\n",
+    "\n",
+    "    x = dataset.data[subset_indices].float().unsqueeze(1).to(device)\n",
+    "\n",
+    "    y = dataset.targets[subset_indices].to(device).float().to(device)\n",
+    "\n",
+    "    # Relabel the targets as a 0 or a 1.\n",
+    "    y = torch.where(y == min(target_digits), 0.0, 1.0)\n",
+    "\n",
+    "    x_train, x_test, y_train, y_test = train_test_split(x,\n",
+    "                                                        y,\n",
+    "                                                        test_size=test_size /\n",
+    "                                                        100,\n",
+    "                                                        shuffle=True,\n",
+    "                                                        random_state=42)\n",
+    "\n",
+    "    return x_train, x_test, y_train, y_test"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Classical parameters.\n",
+    "\n",
+    "sample_count = 1000  # Total number of images to use.\n",
+    "target_digits = [5, 6]  # Hand written digits to classify.\n",
+    "test_size = 30  # Percentage of dataset to be used for testing.\n",
+    "classification_threshold = 0.5  # Classification boundary used to measure accuracy.\n",
+    "epochs = 1000  # Number of epochs to train for.\n",
+    "\n",
+    "# Quantum parmeters.\n",
+    "\n",
+    "qubit_count = 1\n",
+    "hamiltonian = spin.z(0)  # Measurement operator.\n",
+    "shift = torch.tensor(torch.pi / 2)  # Magnitude of parameter shift."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "x_train, x_test, y_train, y_test = prepare_data(target_digits, sample_count,\n",
+    "                                                test_size)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAgMAAADgCAYAAACelGVSAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAAAcxElEQVR4nO3dd5TU1f3/8YsoIEUMRYOAIk0RkSYqoUgHUQgQUJESQJrBKBIQJRRBAQUikAiCFCmiIkWKaGgiAU44hCKBwEosSAkckar09vvDn+/v6zPOsLPLzu7O3Ofjr9fsfj4z9+zszt5z37dkuXz58mUHAAC8dU1GNwAAAGQsOgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADguWujvTBLliyxbAcAAIiBaDYaZmQAAADP0RkAAMBzdAYAAPAcnQEAADxHZwAAAM/RGQAAwHN0BgAA8BydAQAAPEdnAAAAz9EZAADAc3QGAADwHJ0BAAA8R2cAAADP0RkAAMBzUR9hDMSKHo9dvXp1ywMHDrRco0YNyzNnzrTcpUuXGLcOkeTPn9/y5s2bLd96662WW7ZsaXnevHnp0zAAKcbIAAAAnqMzAACA5ygTIMPlyZPH8vTp0y2PHz/e8sSJEy1PmzbNMmWCjNO+fXvLRYoUsXzp0qWMaE6mpiWVpUuXWq5UqZLlL774wvK9994buP/kyZMxbB3AyAAAAN6jMwAAgOcoEyDDnThxwnLFihUtHz9+3PLo0aMtL1u2LH0ahoBatWoFHg8ZMiTsdXv37k2H1sSXOnXqWNbf8cuXL1suXbp02Oycc1u2bIlh6wBGBgAA8B6dAQAAPOddmeCZZ56x3KJFC8uFCxcOXPfOO+9Y1pnACxcuvKrXT0pKsrx///6req5EpKWBmjVrWu7Ro4dlXU2A2Kpdu7bluXPnBr6XM2dOy7NmzbKs79X1118fw9YBSCuMDAAA4Dk6AwAAeC7LZZ3OeqULZf/4ePbmm29a7tatW8xfL7QU0KdPH8vvv/9+zF8/3hQoUMDytm3bLB89etRylSpVLLMZS9rT8sySJUssa1nAueAmORUqVLB87ty52DUuTrVr185ypDLXxYsXLYduOvTvf/87Ju2CH6L5N8/IAAAAnqMzAACA5+gMAADgOS+WFt5xxx2WmzRpYvn8+fOWr7km2C+aPXu25TfeeCPVr611VeeCtW/8ROej6MFDBQsWtKy73TFPIO2VK1fO8qRJkyzrPIEDBw4E7mnZsqVl5glcWZs2bZK9ZuvWrZaZI5DYdCl7vnz5wl6jc6bSAyMDAAB4js4AAACeS9gyQbZs2SzPmDHDsu6I1rlzZ8t169YN3L9q1SrL69evj0UT8f81aNDA8tChQy3PnDnTsi4JRdrIlSuX5XXr1oX9+qVLlyz/5S9/Cdy/Y8eOGLYu/ml58sEHH0z2+k2bNsWyOUiFvHnzWtbdUe+55x7LeoCXLo3WkrRzzhUrVsxyjhw5LF+4cMHyokWLLEdTWkpLjAwAAOA5OgMAAHguYcsEw4cPt6w71umsdB2G/uCDD9KnYXDOBYffPvnkE8s7d+603L1793Rtkw9uvPFGy3PmzLGspQHVv39/y6NHj45ZuxLRE088YVnLlpG8+uqrV/V6jz76qOVOnTpZ/uGHHyzrIVLOOffdd99d1WsmgtDddbUc1rNnT8snTpywrJ9furufrqr573//G3hePcxr9erVlrU0cPbs2ZQ0PU0xMgAAgOfoDAAA4LmEKhM0b97c8mOPPWZ5165dliMdDpSRwzM+2rhxo+V9+/ZZ1vfw9OnT6dqmRJU1a1bLWj6rU6eOZR3q1FLaiBEjYty6xJI7d27L1apVS/Z6HXrWv4NQuvlTixYtLP/tb3+znCdPHsuRDpYL/bqWFnTlSKIrWrSo5dBVMr/73e8sf/vtt5b1f8fnn39uWVfVHDlyxHLoIXWZHSMDAAB4js4AAACei/sywS233GJZN6zRrz/11FOWk5KS0qdhCHj77bcDj4sXL25ZN2TRkg5SR2c6O+fcK6+8Yrlr166WtTTQr18/y5QGUk/P1qhdu3ay148cOdKybj4TelbK9OnTLWuZQGkJINL59VqGc8657NmzW070slz+/PktT5482XL9+vUD1+nZHL169bKc6GeiMDIAAIDn6AwAAOC5LJcjjSeFXhhhdmpGe/fddy0//vjjlpcsWWK5WbNmli9evJgu7fKVDm9q2aZv376B69q1a2dZN+PA1dMhUOec69ixY9jr9IjUChUqhL2matWqll944YXA9woVKhT2Ht1jX0sO33zzTfgGx7Frrw1WWpctW2Y50nkEeqx52bJlLVesWNHyRx99FLjn5ptvDvtcuqHQ0qVLLevx0leiqx8SsUygP9/58+dbLlmypOUxY8YE7nn++ectJ8r/i2j+zTMyAACA5+gMAADgubhfTaAbqqjXXnvNcqIM9cSDAQMGWNbSgJ4D4Zxzs2fPTtHz6pGfuv+3TxulXEm3bt0sd+jQIeJ1ug96pKHkPn36WNb99fXY1iupXLmyZd3cRWdmJ8qqkd/85jeBx9EcVTxv3jzLWn7V0kCksoBzwd/5KVOmWH799dctR3pvP/7448DjRNxs7b777rO8ePFiywULFrSsmz1VqlQpcP/LL79sedy4cZbjbROhlGJkAAAAz9EZAADAc3QGAADwXNzPGYikTZs2lteuXZuBLUl89erVs/ynP/3J8oYNGyzrzmzOBXdba9q0qWWtdZYrV85yrly5LGvN9c033ww87549e1LU9njWuXNny3/9618thy4D1kNVdG6BLjd65plnLPfv39+y1vZ1/oBzzh04cMBysWLFLOt78tBDD1neuXOnZZ2XEM9Cd/SL5Pvvv7es75XOnbnSPAGtcevfyObNmy0vXLgw7L36+xB6KE8izrk5duyY5VOnTlmeO3euZZ13FLqzoP5dPfvss5ZLlSpl+X//+1+atDUzYWQAAADP0RkAAMBzcb8DoS5d+vTTTy2XKFHCsp5JvXr16rDPs3z58sDjgwcPWl63bp3lM2fOpL6xCaRAgQKW169fb1mH/xs2bGj5+PHjgfv1HHbdOXLNmjWWP/vsM8u605vuKBk6zFmrVi3LOlyYKPT3WofddYmt7gDonHMPP/yw5UOHDllu3LixZV2C9cYbb1jW5aHR/u6PHj3aspYf9P3QQ2Pijf4uhi6RvO2228Leozul6s/6vffeC3t96O91o0aNLGv5TZ+rRo0aYZ/rq6++shy606QOo+MnWpKcOHGi5fLly1vWEmY8YAdCAACQLDoDAAB4Lu5XE+zdu9dygwYNLA8ZMsSynivevn37sM8T6evOOTdjxgzLV9rdzSfDhg2zXLx4ccv6HujQlB7O4lxw5rMOuSUlJSX72jqD+oMPPgh8r0iRIpYTsUzQpEkTy1oa0CH8p59+OnCPlgb0Z/3+++9b1p+VlnCiLQ1oqUdXLKjQUly8at26teVIZYFQeoCRrtaI5O233w48/u677yxHUxpQurKKskDydHXB7t27Lev7njdvXsuhJdB4xcgAAACeozMAAIDn4r5MoPS89Hbt2lnWmcu6cYQevHLDDTcEnmv48OGWW7VqZXnUqFGWt2/ffpUtji86+1zLJZMnT7a8YsUKyzqUpht+OBfcdCaaoUudwa0z1HUFiXOJ/57069cv7NePHDliWWebh6pfv75lnTXdvXt3y19++WXYe6tUqRJ4PGjQIMt16tSxnD17dsv6vifKRkO6SiZ0lZWWxiJtTFO2bNlkX+ORRx4JPNYh6pw5c4a9R1cgzJkzx7KW1ZAy58+ft3z06FHLiVIaUIwMAADgOToDAAB4LqHKBJEcPnw4bNbNckLdfffdlnWlQe7cudO4dfFDh5h12F5nnysdSuvRo0dUr6HPq8OpAwYMsKznlevseh9EGiK+Ei0H6F7rOgQ6adIky4ULF7asZ0r84Q9/CDyvlt90731dTaBlnHg+D15/L0uWLGn5Spu55MuXz7L+3KNxpXMKItHSQOg5EvEqdLWGnoeh5wukJX3ftNy8b9++mLxeZsHIAAAAnqMzAACA57woE6SGbqKis6s3btyYEc3J1FJzbLBufnP77bdb1uHNRx991PLWrVst6177kc6aSFS6l32nTp0s67CyHpHrXHA4Xzdl0tnnixYtsqxlmIIFC1q+ePFi4Hl1xc24ceMs61BuotAzN/TzQH9WzgXLBjly5LBcsWLFq3p9XbWgGxD17t3bcqRzDuLZiy++GHj8wAMPWB4/frxl3UBLj3uOhpaAnAuuetHPpunTp6foeeMNIwMAAHiOzgAAAJ6jMwAAgOeyXI7moGP3y522Eo3uMuicc7Nnz7a8YMECyy1atEivJmU6esCKHgSlB+HogSy63KxAgQKB59Id1fTAHT14atasWZa1Pp3SmmAi0fkSWudPS1qT1jkyI0aMCFy3Zs2amLx+ZlevXj3L8+bNC3wvrZYeh34sjxkzxvKECRMsR9otMlFcd911gceDBw+23LNnT8s6n2XlypWWIy0f1+WzlSpVCnxP54Horra1atWyHGl3ycwqmn/zjAwAAOA5OgMAAHjO6zLBvffea/njjz8OfE+XVFWtWtXylXYtTHS6BOfVV1+1XKJECcvVqlWzrKWBbdu2BZ5r7dq1lnWo9Z///Kfl06dPX2WLE48eAqTLypo1a2Y5dNgzEl1aOHToUMt68FSi77p2tXS3Reec69u3r+XQ3fPC0c9V/SjWHSGdCx4khZ/ozppt27a1rId56ZLbbNmyWT579qzl0KWwupOjvg/xXJKhTAAAAJJFZwAAAM95USbQHdh69eplWYdZQ2et6jB248aNLf/444+xaCKABHDjjTdaLl26tOXixYtb1l319EC0qVOnWtYVA845t2nTprRspjd01YAeQKQroA4ePJiubcoIlAkAAECy6AwAAOC5uCwT3HnnnZb1UImvv/7acpkyZSzXrl3bcqFChSx/9dVXlocNGxZ4DZ3h7vMmNwCA+EaZAAAAJIvOAAAAnovLMoFuHpGUlGS5WLFiYa/fvXu35blz51p+6aWXLJ86dSrN2gcAQGZBmQAAACSLzgAAAJ6LyzIBAACIDmUCAACQLDoDAAB4js4AAACeozMAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADgOToDAAB4js4AAACeozMAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADguWszugHwQ548eQKPFy1aZLlWrVqW77//fssbNmyIebsA+GHFihWW69SpY/nEiROB6+rWrWt506ZNsW9YJsHIAAAAnqMzAACA5ygTIF306NEj8LhmzZqWL126lN7NwRVUrlzZ8vLlyy0fO3YscF2jRo0s79q1K+bt8tlNN91kedWqVZZ37NhhuVWrVunapnigJUj9zLl8+bJl/R13zrlt27bFvF2ZESMDAAB4js4AAACe865McM01/9f/efLJJy0PGjQocF3hwoWTfa5Ro0ZZ7tatm+WJEydaPn36dOCe4cOHR/xeomnbtq3lgQMHRrxu6tSplrdu3RrTNiE8fX969uxp+YYbbgibnXNuzpw5lsuXLx+7xsFNmTLFcpkyZSyvXLkyI5oTNxo3bmw5a9aslg8dOmR58ODBgXvOnTsX+4ZlQowMAADgOToDAAB4zosyQalSpSy/9NJLlh9//HHLSUlJgXvGjh2b7PNqOaBIkSKWv/vuu4j3PP3005ZHjhyZ7GvEGy3DNG/e3HL27NkD1+nM9C5dusS8XfiJbv5UvXp1y/oe5M2b17LOug4VWjZA2unQoUPgsQ53q7lz56ZDa+LXXXfdFfbrBQsWtFyxYsXA97Zv3x7TNmVWjAwAAOA5OgMAAHjOizLB6NGjLRctWtRyr169LO/evTtwz8KFC1P0Gq1bt05d4xJMmzZtLDdr1izidR9++GE6tAahXnvtNctdu3ZN0b1nz54NPH7rrbfSpE34pdDPkyxZslieMGGC5XXr1qVbm+KRlgPUqVOnLB88eDC9mpOpMTIAAIDn6AwAAOC5hC0T3HrrrZbLli1r+bnnnrO8YMGC9GySF5o0aRLVdYsXL45xS/CzChUqWI72/QkndHOWESNGpPq58Ev9+vWzXL9+/cD39u3bZ3nmzJmWL168GPuGJaA9e/ZYDj2bwFeMDAAA4Dk6AwAAeC7uywQFChSwnDt3bst6VoCWDJ599lnLlAnSXtWqVcN+/V//+lfg8dKlS9OjOV7SI4idCw6D6oZCkejGUbqZ1v79+9OgdVAPPvig5eeff97y5s2bA9c1bNjQ8uHDh2PfsAQ3a9asjG5CpsPIAAAAnqMzAACA5+gMAADguUw7Z0DPni5RokTge4888ojlzp07W9Zap561/uc//9ny0aNH07SdCNaVr7/++rDXfPPNN4HHZ86ciWmbfKaHYTkXPFDoSgcP/axHjx6W2Z0t7ennlB6cpu9TgwYNAvccOXIk5u3yyY4dOzK6CZkOIwMAAHiOzgAAAJ7LVGUCLQ3cfffdlvVwFeecq1WrlmVdNnU1u6sh9e677z7Lv/rVr8JeE3rIDdKWLplt37594HvRlAbGjh1refz48Zbz589vOXRXvD/+8Y9hn6t3796WN23aZPncuXPJtsMH1apVs6xLCz/55BPLlAWQ3hgZAADAc3QGAADwXIaXCXRmre7ANXDgQMvffvtt4J5BgwZZDi0hIHOaNGlSRjch4egqm+7du0d1j5ZrRo0aZfmdd96xXLRoUcsTJkywrLvgXcnatWstDx06NGz2rWyUK1cuy/q3oD+H/v37p2ubAMXIAAAAnqMzAACA5zK8THDddddZfuWVV8Jeky9fvsDjd99913KfPn0sr1mzxvKuXbssMzM3tlq1ahWT59VDj0aPHm15586dlrt06RK458KFCzFpS2Y0bNgwy6VKlYrqHj0AR8ttv/3tby3Pnz/fcjQrEa6kX79+lnW1kG4E5gPdyKl06dKWBw8ebHnLli0R77///vstt2zZ0vLJkycta9nnxx9/TH1j49wdd9xh+ZZbbrGcJUuWjGhO3GBkAAAAz9EZAADAcxleJnjxxReTvUY3PnHOuVWrVlm+/fbbw96zbNkyyzNnzrTcoUOHqNo1efJkyxs2bLCcI0cOy0lJSVE9V6K76aab0uy59Oe7YMECywUKFLBcpUqVsNc751zr1q3TrC2ZkZZOdLhY6Qod55y7dOmS5ddff92y7os/YMCAsPfrvdGKdL9usOMbfa/Onz9v+dChQ5ZHjhxp+YEHHgjcrxsVKR36rlOnjmU9v+XEiROpaHH8uuuuuyxrmWDjxo2WP/roozR7vY4dO1rWz6x4OweHkQEAADxHZwAAAM9leJlgyJAhlnWzEl0lEGrJkiWW9+zZY7lcuXKWq1evblmHQ0OP0v2ZDkM751zPnj0t69GiWrL44osvLLdo0cIyqxdST8szoe9JOJGGTxNV+fLlLUea6R86tD9t2jTLWg645557wj6X3q9fP3z4cOB5P/3007Dt0tncev/VrkyIN7oCplKlSpZ1aF/PhNDVFnpOgXPOderUKexraOnl97//vWU9L2TFihUpaXbC0nNTtHyg/0OuRM/i6Nu3r+Wbb77Zctu2bS0/9thjgfu///776BubARgZAADAc3QGAADwHJ0BAAA8l+FzBrQ+qbWt1NS5dFmHKly4sOX9+/eHvUbrSc4Fz15v2rSp5bfeestyjRo1LJctW9ay7oTog9mzZ1uuVatW2Gt0uY9zzq1bty7sdSVLlgz7dd118t5777UcurRUl1dpTTtRtGvXLsX36Hty2223pejeTZs2Wdbd8pxzbuXKlZanTp1qWecM+KxevXqWQ5d7/kyXuOl8meXLlweu088jpUsTdc6AziVgzsBPihcvblnncITOGdD5L3qPzrcJXe7+M/1be++99wLfe+KJJyzr+5ZZMDIAAIDn6AwAAOC5DC8TpIdIpQF1pd2idLhHz3ofPny45blz51rWg0iOHz8edTvj1WeffWb5hx9+sJwnTx7LOnzvXPBMd/2ZatYS0gcffGBZSzJ60JVzzuXNmzclTY8LuutgNAcS6dJb5365m11yZs2aZblbt26WQ5cs9u/f33LoMqpwfPhbuPPOOy3r54B67rnnLE+YMMHy2bNnU/x6tWvXDvt1n5c36+eRHmpWpkwZy71797bcqFGjwP16aJfurqrlhM8//zzsaxcsWNBy6GeeLn3PjCVMRgYAAPAcnQEAADznRZkgLR08eDDs13W3PN1JzAe7du2yHKlMELpToK4u0J+pnsN+4MABy19++aXlYsWKXV2D40yRIkUs58uXL9nrCxUqFHicLVu2FL1e+/btLVeoUMFy6K6g0ZQGXn75Zcu6EidRNW/e3LKWsPSwoA8//NByakoDuXLlCvt6Z86csbx48eIUP2+i0JLvyZMnw16jpTfNzjl38eJFy/r7qwfeffXVV2GfV98PLR0759yTTz5pmTIBAADIdOgMAADgOcoESFPbt2+3rIeB6MZPzjn397//3bJuzvLQQw9Z1pKDbmSjKwZChwEjHUQVz/RgG82R6KZMzv1yFUByIh1aFK0tW7ZYHjNmjGUfVhPkzJkz7Nd1w6ZoD8aJRFcx6aZbgwYNsqxlNZ+lZnOfiRMnWtZD7qKhqwlC6QZGmREjAwAAeI7OAAAAnqNMkEI6uxq/1KxZM8urV6+2XKVKlcB1Wjb4z3/+Y/n999+3rEOgej670jMLnIu8GUg802F7zZGEDu1Hc0+k+6O9V3/udevWtexDaSAaV3teyVNPPWW5e/fulrUsNn78+Kt6jUTUpUsXy8uWLbMcelaK0s2BQsub4bzwwguW27ZtG/G60NUFmQ0jAwAAeI7OAAAAnqNMEIHO/OzVq5flrl27hr1+2rRplo8dOxarZmV6uomK7muvM6Cdc65hw4aW9XhXPeYzEj1romfPnqlpZlzRDUr03IGHH344Xduhqzucc65v376WdZMbSgO/pOdpbNy40bJuzKXHd+tnjnPOtW7d2rKuRtC/o8OHD6dNYxOIblym50Do55Fu4uRc8Gh6/Vnr51SkVTYXLlywrKtqnAse9Z4ZMTIAAIDn6AwAAOC5LJejnC4czWYn6aV+/fqW+/XrZ3ns2LGWFyxYYFlnuEfa175jx46Bx3pd7ty5k22T3j9jxoxkr/eNDoc651zTpk0tN2nSxHKrVq0snz592vKUKVMs6/HHusmRDypXrmxZf8f1PILQv9Vo/sS1tKUbOQ0ZMsTy119/Hbhn1apVyT6vb3TDJy2d6EZZ//jHPyzr+5k/f37L58+fDzzvvHnzLGt5Zu/evVfZYj/pzzq0JKOrA1SkMoGWHDZv3mx5/vz5V93OtBLNZwAjAwAAeI7OAAAAnqMzAACA5+JyzkD27Nktt2zZ0rKeS61nsufIkcNy1qxZr+q1dbe8Ro0aWT548KDl1BzuAqSUzsPQs9Jr1qwZuE7nZ0TSu3dvy3q4EFLv17/+tWWd25IvXz7LOg9jzpw5lseNGxd4rn379sWiifAEcwYAAECy6AwAAOC5uCwTRKJtvPba/9tcUXfvWr9+vWUdTi1atGjguSZPnmxZSwD649LdpgAAyIwoEwAAgGTRGQAAwHMJVSYAAABBlAkAAECy6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5+gMAADgOToDAAB4js4AAACeozMAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA566N9sLLly/Hsh0AACCDMDIAAIDn6AwAAOA5OgMAAHiOzgAAAJ6jMwAAgOfoDAAA4Dk6AwAAeI7OAAAAnqMzAACA5/4f5kKbg4Vh3lIAAAAASUVORK5CYII=",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plot some images from the training set to visualise.\n",
+    "if device != 'cpu':\n",
+    "    sample_to_plot = x_train[:10].to(torch.device('cpu'))\n",
+    "else:\n",
+    "    sample_to_plot = x_train[:10]\n",
+    "    \n",
+    "grid_img = torchvision.utils.make_grid(sample_to_plot,\n",
+    "                                       nrow=5,\n",
+    "                                       padding=3,\n",
+    "                                       normalize=True)\n",
+    "plt.imshow(grid_img.permute(1, 2, 0))\n",
+    "plt.axis('off')\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class QuantumFunction(Function):\n",
+    "    \"\"\"Allows the quantum circuit to input data, output expectation values \n",
+    "    and calculate gradients of variational parameters via finite difference\"\"\"\n",
+    "\n",
+    "    def __init__(self, qubit_count: int, hamiltonian: cudaq.SpinOperator):\n",
+    "        \"\"\"Define the quantum circuit in CUDA Quantum\"\"\"\n",
+    "\n",
+    "        @cudaq.kernel\n",
+    "        def kernel(qubit_count: int, thetas: np.ndarray):\n",
+    "\n",
+    "            qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "            ry(thetas[0], qubits[0])\n",
+    "            rx(thetas[1], qubits[0])\n",
+    "\n",
+    "        self.kernel = kernel\n",
+    "        self.qubit_count = qubit_count\n",
+    "        self.hamiltonian = hamiltonian\n",
+    "\n",
+    "    def run(self, theta_vals: torch.tensor) -> torch.tensor:\n",
+    "        \"\"\"Excetute the quantum circuit to output an expectation value\"\"\"\n",
+    "\n",
+    "        #If running on GPU, thetas is a torch.tensor that will live on GPU memory. The observe function calls a .tolist() method on inputs which moves thetas from GPU to CPU.\n",
+    "\n",
+    "        qubit_count = [self.qubit_count for _ in range(theta_vals.shape[0])]\n",
+    "\n",
+    "        results = cudaq.observe(self.kernel, self.hamiltonian, qubit_count,\n",
+    "                                theta_vals)\n",
+    "\n",
+    "        exp_vals = [results[i].expectation() for i in range(len(results))]\n",
+    "        exp_vals = torch.Tensor(exp_vals).to(device)\n",
+    "\n",
+    "        return exp_vals\n",
+    "\n",
+    "    @staticmethod\n",
+    "    def forward(ctx, thetas: torch.tensor, quantum_circuit,\n",
+    "                shift) -> torch.tensor:\n",
+    "\n",
+    "        # Save shift and quantum_circuit in context to use in backward.\n",
+    "        ctx.shift = shift\n",
+    "        ctx.quantum_circuit = quantum_circuit\n",
+    "\n",
+    "        # Calculate expectation value.\n",
+    "        exp_vals = ctx.quantum_circuit.run(thetas).reshape(-1, 1)\n",
+    "\n",
+    "        ctx.save_for_backward(thetas, exp_vals)\n",
+    "\n",
+    "        return exp_vals\n",
+    "\n",
+    "    @staticmethod\n",
+    "    def backward(ctx, grad_output):\n",
+    "        \"\"\"Backward pass computation via finite difference\"\"\"\n",
+    "\n",
+    "        thetas, _ = ctx.saved_tensors\n",
+    "\n",
+    "        gradients = torch.zeros(thetas.shape, device=device)\n",
+    "\n",
+    "        for i in range(thetas.shape[1]):\n",
+    "\n",
+    "            thetas_plus = thetas.clone()\n",
+    "            thetas_plus[:, i] += ctx.shift\n",
+    "            exp_vals_plus = ctx.quantum_circuit.run(thetas_plus)\n",
+    "\n",
+    "            thetas_minus = thetas.clone()\n",
+    "            thetas_minus[:, i] -= ctx.shift\n",
+    "            exp_vals_minus = ctx.quantum_circuit.run(thetas_minus)\n",
+    "\n",
+    "            gradients[:, i] = (exp_vals_plus - exp_vals_minus) / (2 * ctx.shift)\n",
+    "\n",
+    "        gradients = torch.mul(grad_output, gradients)\n",
+    "\n",
+    "        return gradients, None, None"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class QuantumLayer(nn.Module):\n",
+    "    \"\"\"Encapsulates a quantum circuit into a quantum layer adhering PyTorch convention\"\"\"\n",
+    "\n",
+    "    def __init__(self, qubit_count: int, hamiltonian, shift: torch.tensor):\n",
+    "        super(QuantumLayer, self).__init__()\n",
+    "\n",
+    "        self.quantum_circuit = QuantumFunction(qubit_count, hamiltonian)\n",
+    "        self.shift = shift\n",
+    "\n",
+    "    def forward(self, input):\n",
+    "\n",
+    "        result = QuantumFunction.apply(input, self.quantum_circuit, self.shift)\n",
+    "\n",
+    "        return result"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class Hybrid_QNN(nn.Module):\n",
+    "    \"\"\"Structure of the hybrid neural network with classical fully connected layers and quantum layers\"\"\"\n",
+    "\n",
+    "    def __init__(self):\n",
+    "        super(Hybrid_QNN, self).__init__()\n",
+    "\n",
+    "        self.fc1 = nn.Linear(28 * 28, 256)\n",
+    "        self.fc2 = nn.Linear(256, 128)\n",
+    "        self.dropout = nn.Dropout(0.25)\n",
+    "\n",
+    "        self.fc3 = nn.Linear(128, 64)\n",
+    "        self.fc4 = nn.Linear(64, 32)\n",
+    "        self.fc5 = nn.Linear(32, 2)\n",
+    "        self.dropout = nn.Dropout(0.25)\n",
+    "\n",
+    "        # The 2 outputs from PyTorch fc5 layer feed into the 2 variational gates in the quantum circuit.\n",
+    "        self.quantum = QuantumLayer(qubit_count, hamiltonian, shift)\n",
+    "\n",
+    "    def forward(self, x):\n",
+    "\n",
+    "        x = x.view(-1, 28 * 28)  # Turns images into vectors.\n",
+    "\n",
+    "        x = torch.relu(self.fc1(x))\n",
+    "        x = torch.relu(self.fc2(x))\n",
+    "        x = self.dropout(x)\n",
+    "\n",
+    "        x = torch.relu(self.fc3(x))\n",
+    "        x = torch.relu(self.fc4(x))\n",
+    "        x = torch.relu(self.fc5(x))\n",
+    "        x = self.dropout(x)\n",
+    "\n",
+    "        # Quantum circuit outputs an expectation value which is fed into the sigmoid activation function to perform classification.\n",
+    "        x = torch.sigmoid(self.quantum(x))\n",
+    "\n",
+    "        return x.view(-1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def accuracy_score(y, y_hat):\n",
+    "    return sum((y == (y_hat >= classification_threshold))) / len(y)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "hybrid_model = Hybrid_QNN().to(device)\n",
+    "\n",
+    "optimizer = optim.Adadelta(hybrid_model.parameters(),\n",
+    "                           lr=0.001,\n",
+    "                           weight_decay=0.8)\n",
+    "\n",
+    "loss_function = nn.BCELoss().to(device)\n",
+    "\n",
+    "training_cost = []\n",
+    "testing_cost = []\n",
+    "training_accuracy = []\n",
+    "testing_accuracy = []\n",
+    "\n",
+    "hybrid_model.train()\n",
+    "for epoch in range(epochs):\n",
+    "\n",
+    "    optimizer.zero_grad()\n",
+    "\n",
+    "    y_hat_train = hybrid_model(x_train).to(device)\n",
+    "\n",
+    "    train_cost = loss_function(y_hat_train, y_train).to(device)\n",
+    "\n",
+    "    train_cost.backward()\n",
+    "\n",
+    "    optimizer.step()\n",
+    "\n",
+    "    training_accuracy.append(accuracy_score(y_train, y_hat_train))\n",
+    "    training_cost.append(train_cost.item())\n",
+    "\n",
+    "    hybrid_model.eval()\n",
+    "    with torch.no_grad():\n",
+    "\n",
+    "        y_hat_test = hybrid_model(x_test).to(device)\n",
+    "\n",
+    "        test_cost = loss_function(y_hat_test, y_test).to(device)\n",
+    "\n",
+    "        testing_accuracy.append(accuracy_score(y_test, y_hat_test))\n",
+    "        testing_cost.append(test_cost.item())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA9wAAAHpCAYAAABweDQqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAACj50lEQVR4nOzdd3hUVf7H8ffMpAeSkF4IJKGETiBAqNZAEBfFihVFRX8sroVVVyxgW7GyrMouiuCirgvKWtgVsQRBkSoR6SW0hJJOEhJIm5nfHwODWQIkIclN+bye5z4zc+beO5+ZnXX45px7jslut9sRERERERERkTplNjqAiIiIiIiISHOkgltERERERESkHqjgFhEREREREakHKrhFRERERERE6oEKbhEREREREZF6oIJbREREREREpB6o4BYRERERERGpByq4RUREREREROqBCm4RERERERGReqCCW0RERERERKQeGF5wz5o1i6ioKDw8PEhISGDdunXn3H/mzJnExsbi6elJZGQkDz/8MCUlJRd0ThEREREREZG65mLkiy9cuJDJkycze/ZsEhISmDlzJklJSezcuZPg4OAz9v/oo494/PHHmTdvHoMHD2bXrl3ceeedmEwmZsyYUatzVsVms3H48GFat26NyWSq0/csIiJSXXa7nWPHjhEeHo7ZbPjfyA2n32cREWkMavT7bDfQgAED7JMmTXI+tlqt9vDwcPv06dOr3H/SpEn2yy67rFLb5MmT7UOGDKn1OauSnp5uB7Rp06ZNm7ZGsaWnp1f7N6w50++zNm3atGlrTFt1fp8N6+EuKytjw4YNTJkyxdlmNptJTExk9erVVR4zePBgPvzwQ9atW8eAAQPYu3cvS5Ys4fbbb6/1OQFKS0spLS11Prbb7QCkp6fj4+NzQe9TRESktgoLC4mMjKR169ZGR2kUTn0O+n0WEREj1eT32bCCOycnB6vVSkhISKX2kJAQduzYUeUxt9xyCzk5OQwdOhS73U5FRQX/93//xxNPPFHrcwJMnz6dZ5999ox2Hx8f/aCLiIjhNHza4dTnoN9nERFpDKrz+9ykLghbvnw5L774In/7299ISUnh008/5csvv+T555+/oPNOmTKFgoIC55aenl5HiUVERERERKSlMqyHOzAwEIvFQmZmZqX2zMxMQkNDqzzm6aef5vbbb+eee+4BoGfP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MBqN4plnnvG06c8xczgc4sCBA+LAgQMCgHjttdfEgQMHRH5+vhCia2Jjs9mEyWQSs2bNEkePHhUbNmwQWq2W04J1A+bnVszRV4/5uWPMz75jfr603pifWXD72ZtvvikSEhKEUqkUEydOFDt37gx0l7odgHaX999/39Omrq5OPPbYYyI8PFxotVpx5513iuLiYq/jnD17VkyfPl1oNBphNBrFk08+KRobG7v5bALn4oTOmHn74osvxMiRI4VKpRJDhw4V77zzjtd+t9stli5dKkwmk1CpVGLatGkiNzfXq015ebm4//77RWhoqNDpdGL27NnC4XB052l0G7vdLhYuXCgSEhKEWq0WgwYNEs8//7zXFBj9OWbfffdduz+3srKyhBBdF5tDhw6JKVOmCJVKJeLi4sSqVau66xT7PeZnCXP01WN+vjTmZ98wP19ab8zPMiGE8H1cnIiIiIiIiIguhfdwExEREREREfkBC24iIiIiIiIiP2DBTUREREREROQHLLiJiIiIiIiI/IAFNxEREREREZEfsOAmIiIiIiIi8gMW3ERERERERER+wIKbiIiIiIiIyA9YcBNRwMlkMmzatCnQ3SAiIqILMD8TXT0W3ET93EMPPQSZTNZmueWWWwLdNSIion6L+ZmobwgKdAeIKPBuueUWvP/++17bVCpVgHpDREREAPMzUV/AEW4igkqlgtls9lrCw8MBSJeTrV27FtOnT4dGo8GgQYPwz3/+0+vzR44cwS9+8QtoNBpERkZizpw5qK6u9mqzbt06jBgxAiqVCjExMViwYIHX/rKyMtx5553QarVITk7G559/7tlXWVmJzMxMREVFQaPRIDk5uc0vIERERH0N8zNR78eCm4gua+nSpZg5cyYOHTqEzMxM3HfffcjJyQEA1NTUICMjA+Hh4dizZw82btyIb775xithr127FvPnz8ecOXNw5MgRfP755xg8eLDX13jppZdwzz334PDhw7j11luRmZmJiooKz9c/fvw4Nm/ejJycHKxduxZGo7H7AkBERNQDMT8T9QKCiPq1rKwsoVAoREhIiNeyYsUKIYQQAMTcuXO9PpOamirmzZsnhBDinXfeEeHh4aK6utqz/1//+peQy+XCYrEIIYSIjY0Vzz//fId9ACBeeOEFz/vq6moBQGzevFkIIcTtt98uZs+e3TUnTERE1AswPxP1DbyHm4hw0003Ye3atV7bIiIiPOtpaWle+9LS0nDw4EEAQE5ODsaMGYOQkBDP/smTJ8PtdiM3NxcymQxFRUWYNm3aJfswevRoz3pISAh0Oh1KSkoAAPPmzcPMmTOxf/9+3HzzzZgxYwYmTZp0RedKRETUWzA/E/V+LLiJCCEhIW0uIesqGo2mU+2Cg4O93stkMrjdbgDA9OnTkZ+fj6+++gpbt27FtGnTMH/+fPzpT3/q8v4SERH1FMzPRL0f7+EmosvauXNnm/fDhg0DAAwbNgyHDh1CTU2NZ/9PP/0EuVyOIUOGICwsDImJicjOzr6qPkRFRSErKwsffvghVq9ejXfeeeeqjkdERNTbMT8T9Xwc4SYiOJ1OWCwWr21BQUGeB59s3LgRKSkpmDJlCj766CPs3r0b7733HgAgMzMTy5cvR1ZWFl588UWUlpbi8ccfx6xZs2AymQAAL774IubOnYvo6GhMnz4dDocDP/30Ex5//PFO9W/ZsmUYP348RowYAafTiS+//NLzCwUREVFfxfxM1Pux4CYibNmyBTExMV7bhgwZghMnTgCQnlC6YcMGPPbYY4iJicH69esxfPhwAIBWq8XXX3+NhQsXYsKECdBqtZg5cyZee+01z7GysrJQX1+PP//5z3jqqadgNBpx1113dbp/SqUSS5YswdmzZ6HRaDB16lRs2LChC86ciIio52J+Jur9ZEIIEehOEFHPJZPJ8Omnn2LGjBmB7goRERE1Y34m6h14DzcRERERERGRH7DgJiIiIiIiIvIDXlJORERERERE5Acc4SYiIiIiIiLyAxbcRERERERERH7AgpuIiIiIiIjID1hwExEREREREfkBC24iIiIiIiIiP2DBTUREREREROQHLLiJiIiIiIiI/IAFNxEREREREZEf/H8rxRwfOwOqAAAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 1000x500 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.figure(figsize=(10, 5))\n",
+    "\n",
+    "plt.subplot(1, 2, 1)\n",
+    "plt.plot(training_cost, label='Train')\n",
+    "plt.plot(testing_cost, label='Test')\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Cost')\n",
+    "plt.legend()\n",
+    "\n",
+    "plt.subplot(1, 2, 2)\n",
+    "plt.plot(training_accuracy, label='Train')\n",
+    "plt.plot(testing_accuracy, label='Test')\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Accuracy')\n",
+    "plt.legend()\n",
+    "\n",
+    "plt.tight_layout()\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/maximum_vertex_weight_clique.html b/pr-2241/examples/python/tutorials/maximum_vertex_weight_clique.html
new file mode 100644
index 0000000000..cd3037da27
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/maximum_vertex_weight_clique.html
@@ -0,0 +1,935 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Molecular docking via DC-QAOA &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Noisy Simulation" href="noisy_simulations.html" />
+    <link rel="prev" title="Hybrid Quantum Neural Networks" href="hybrid_qnns.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Molecular docking via DC-QAOA</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/maximum_vertex_weight_clique.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="hybrid_qnns.html" class="btn btn-neutral float-left" title="Hybrid Quantum Neural Networks" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="noisy_simulations.html" class="btn btn-neutral float-right" title="Noisy Simulation" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Molecular-docking-via-DC-QAOA">
+<h1>Molecular docking via DC-QAOA<a class="headerlink" href="#Molecular-docking-via-DC-QAOA" title="Permalink to this heading">¶</a></h1>
+<p>The data of the clique graph for the molecular docking are taken from this <a class="reference external" href="https://arxiv.org/pdf/2308.04098">paper</a></p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># GPU: Default If an NVIDIA GPU and CUDA runtime libraries are available</span>
+<span class="c1">#cudaq.set_target(&#39;nvidia&#39;)</span>
+
+<span class="c1"># CPU</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;qpp-cpu&#39;</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># The two graphs input from the paper</span>
+
+<span class="c1"># BIG 1</span>
+
+<span class="n">nodes</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">]</span>
+<span class="n">qubit_num</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">nodes</span><span class="p">)</span>
+<span class="n">edges</span> <span class="o">=</span> <span class="p">[[</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">],[</span><span class="mi">0</span><span class="p">,</span><span class="mi">2</span><span class="p">],[</span><span class="mi">0</span><span class="p">,</span><span class="mi">4</span><span class="p">],[</span><span class="mi">0</span><span class="p">,</span><span class="mi">5</span><span class="p">],[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">],[</span><span class="mi">1</span><span class="p">,</span><span class="mi">3</span><span class="p">],[</span><span class="mi">1</span><span class="p">,</span><span class="mi">5</span><span class="p">],[</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">],[</span><span class="mi">2</span><span class="p">,</span><span class="mi">4</span><span class="p">],[</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">],[</span><span class="mi">3</span><span class="p">,</span><span class="mi">5</span><span class="p">],[</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">]]</span>
+<span class="n">non_edges</span> <span class="o">=</span> <span class="p">[[</span><span class="n">u</span><span class="p">,</span><span class="n">v</span><span class="p">]</span> <span class="k">for</span> <span class="n">u</span> <span class="ow">in</span> <span class="n">nodes</span> <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">nodes</span> <span class="k">if</span> <span class="n">u</span><span class="o">&lt;</span><span class="n">v</span> <span class="ow">and</span> <span class="p">[</span><span class="n">u</span><span class="p">,</span><span class="n">v</span><span class="p">]</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">edges</span><span class="p">]</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Edges: &#39;</span><span class="p">,</span> <span class="n">edges</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Non-Edges: &#39;</span><span class="p">,</span> <span class="n">non_edges</span><span class="p">)</span>
+<span class="n">weights</span> <span class="o">=</span> <span class="p">[</span><span class="mf">0.6686</span><span class="p">,</span><span class="mf">0.6686</span><span class="p">,</span><span class="mf">0.6686</span><span class="p">,</span><span class="mf">0.1453</span><span class="p">,</span><span class="mf">0.1453</span><span class="p">,</span><span class="mf">0.1453</span><span class="p">]</span>
+<span class="n">penalty</span> <span class="o">=</span> <span class="mf">6.0</span>
+<span class="n">num_layers</span> <span class="o">=</span> <span class="mi">3</span>
+
+<span class="c1"># BIG 2 (More expensive simulation)</span>
+
+<span class="c1">#nodes=[0,1,2,3,4,5,6,7]</span>
+<span class="c1">#qubit_num=len(nodes)</span>
+<span class="c1">#edges=[[0,1],[0,2],[0,5],[0,6],[0,7],[1,2],[1,4],[1,6],[1,7],[2,4],[2,5],[2,7],[3,4],[3,5],[3,6],\</span>
+<span class="c1">#    [4,5],[4,6],[5,6]]</span>
+<span class="c1">#non_edges=[[u,v] for u in nodes for v in nodes if u&lt;v and [u,v] not in edges]</span>
+<span class="c1">#print(&#39;Edges: &#39;, edges)</span>
+<span class="c1">#print(&#39;Non-edges: &#39;, non_edges)</span>
+<span class="c1">#weights=[0.6686,0.6686,0.6886,0.1091,0.0770,0.0770,0.0770,0.0770]</span>
+<span class="c1">#penalty=8.0</span>
+<span class="c1">#num_layers=8</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Edges:  [[0, 1], [0, 2], [0, 4], [0, 5], [1, 2], [1, 3], [1, 5], [2, 3], [2, 4], [3, 4], [3, 5], [4, 5]]
+Non-Edges:  [[0, 3], [1, 4], [2, 5]]
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Generate the Hamiltonian</span>
+<span class="k">def</span> <span class="nf">ham_clique</span><span class="p">(</span><span class="n">penalty</span><span class="p">,</span> <span class="n">nodes</span><span class="p">,</span> <span class="n">weights</span><span class="p">,</span> <span class="n">non_edges</span><span class="p">)</span><span class="o">-&gt;</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">:</span>
+
+    <span class="n">spin_ham</span> <span class="o">=</span> <span class="mf">0.0</span>
+    <span class="k">for</span> <span class="n">wt</span><span class="p">,</span><span class="n">node</span> <span class="ow">in</span> <span class="nb">zip</span><span class="p">(</span><span class="n">weights</span><span class="p">,</span><span class="n">nodes</span><span class="p">):</span>
+        <span class="c1">#print(wt,node)</span>
+        <span class="n">spin_ham</span> <span class="o">+=</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">wt</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">node</span><span class="p">)</span>
+        <span class="n">spin_ham</span> <span class="o">-=</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">wt</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">node</span><span class="p">)</span>
+
+    <span class="k">for</span> <span class="n">non_edge</span> <span class="ow">in</span> <span class="n">non_edges</span><span class="p">:</span>
+        <span class="n">u</span><span class="p">,</span><span class="n">v</span><span class="o">=</span><span class="p">(</span><span class="n">non_edge</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="n">non_edge</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+        <span class="c1">#print(u,v)</span>
+        <span class="n">spin_ham</span> <span class="o">+=</span> <span class="n">penalty</span><span class="o">/</span><span class="mf">4.0</span> <span class="o">*</span> <span class="p">(</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">u</span><span class="p">)</span><span class="o">*</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">-</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">u</span><span class="p">)</span><span class="o">-</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">v</span><span class="p">)</span><span class="o">+</span><span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">u</span><span class="p">)</span><span class="o">*</span><span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">v</span><span class="p">))</span>
+
+    <span class="k">return</span> <span class="n">spin_ham</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Collect coefficients from a spin operator so we can pass them to a kernel</span>
+<span class="k">def</span> <span class="nf">term_coefficients</span><span class="p">(</span><span class="n">ham</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">]:</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="n">ham</span><span class="o">.</span><span class="n">for_each_term</span><span class="p">(</span><span class="k">lambda</span> <span class="n">term</span><span class="p">:</span> <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">term</span><span class="o">.</span><span class="n">get_coefficient</span><span class="p">()))</span>
+    <span class="k">return</span> <span class="n">result</span>
+
+    <span class="c1"># Collect Pauli words from a spin operator so we can pass them to a kernel</span>
+<span class="k">def</span> <span class="nf">term_words</span><span class="p">(</span><span class="n">ham</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="n">ham</span><span class="o">.</span><span class="n">for_each_term</span><span class="p">(</span><span class="k">lambda</span> <span class="n">term</span><span class="p">:</span> <span class="n">result</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">term</span><span class="o">.</span><span class="n">to_string</span><span class="p">(</span><span class="kc">False</span><span class="p">)))</span>
+    <span class="k">return</span> <span class="n">result</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">dc_qaoa</span><span class="p">(</span><span class="n">qubit_num</span><span class="p">:</span><span class="nb">int</span><span class="p">,</span> <span class="n">num_layers</span><span class="p">:</span><span class="nb">int</span><span class="p">,</span><span class="n">thetas</span><span class="p">:</span><span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span>\
+    <span class="n">coef</span><span class="p">:</span><span class="nb">list</span><span class="p">[</span><span class="nb">complex</span><span class="p">],</span> <span class="n">words</span><span class="p">:</span><span class="nb">list</span><span class="p">[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">pauli_word</span><span class="p">]):</span>
+
+    <span class="n">qubits</span><span class="o">=</span><span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_num</span><span class="p">)</span>
+
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+    <span class="n">count</span><span class="o">=</span><span class="mi">0</span>
+    <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">num_layers</span><span class="p">):</span>
+
+        <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">coef</span><span class="p">)):</span>
+            <span class="n">exp_pauli</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">count</span><span class="p">]</span><span class="o">*</span><span class="n">coef</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">real</span><span class="p">,</span><span class="n">qubits</span><span class="p">,</span><span class="n">words</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+            <span class="n">count</span><span class="o">+=</span><span class="mi">1</span>
+
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_num</span><span class="p">):</span>
+            <span class="n">rx</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">count</span><span class="p">],</span><span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+            <span class="n">count</span><span class="o">+=</span><span class="mi">1</span>
+
+        <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_num</span><span class="p">):</span>
+            <span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="n">count</span><span class="p">],</span><span class="n">qubits</span><span class="p">[</span><span class="n">k</span><span class="p">])</span>
+            <span class="n">count</span><span class="o">+=</span><span class="mi">1</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">ham</span><span class="o">=</span> <span class="n">ham_clique</span><span class="p">(</span><span class="n">penalty</span><span class="p">,</span><span class="n">nodes</span><span class="p">,</span><span class="n">weights</span><span class="p">,</span><span class="n">non_edges</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">ham</span><span class="p">)</span>
+
+<span class="n">coef</span><span class="o">=</span><span class="n">term_coefficients</span><span class="p">(</span><span class="n">ham</span><span class="p">)</span>
+<span class="n">words</span><span class="o">=</span><span class="n">term_words</span><span class="p">(</span><span class="n">ham</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">term_coefficients</span><span class="p">(</span><span class="n">ham</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">term_words</span><span class="p">(</span><span class="n">ham</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[1.5+0j] IIZIIZ
+[1.5+0j] ZIIZII
+[-1.1657+0j] IZIIII
+[1.5+0j] IZIIZI
+[-1.42735+0j] IIIZII
+[3.2791499999999996+0j] IIIIII
+[-1.1657+0j] IIZIII
+[-1.42735+0j] IIIIIZ
+[-1.1657+0j] ZIIIII
+[-1.42735+0j] IIIIZI
+
+[(1.5+0j), (1.5+0j), (-1.1657+0j), (1.5+0j), (-1.42735+0j), (3.2791499999999996+0j), (-1.1657+0j), (-1.42735+0j), (-1.1657+0j), (-1.42735+0j)]
+[&#39;IIZIIZ&#39;, &#39;ZIIZII&#39;, &#39;IZIIII&#39;, &#39;IZIIZI&#39;, &#39;IIIZII&#39;, &#39;IIIIII&#39;, &#39;IIZIII&#39;, &#39;IIIIIZ&#39;, &#39;ZIIIII&#39;, &#39;IIIIZI&#39;]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Optimizer</span>
+
+<span class="c1"># Specify the optimizer and its initial parameters.</span>
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">NelderMead</span><span class="p">()</span>
+<span class="c1">#optimizer = cudaq.optimizers.COBYLA()</span>
+
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_random_seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>
+
+<span class="c1"># if dc_qaoa used</span>
+<span class="n">parameter_count</span><span class="o">=</span><span class="p">(</span><span class="mi">2</span><span class="o">*</span><span class="n">qubit_num</span><span class="o">+</span><span class="nb">len</span><span class="p">(</span><span class="n">coef</span><span class="p">))</span><span class="o">*</span><span class="n">num_layers</span>
+
+<span class="c1"># if qaoa used</span>
+<span class="c1"># parameter_count=(qubit_num+len(coef))*num_layers</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total number of parameters: &#39;</span><span class="p">,</span> <span class="n">parameter_count</span><span class="p">)</span>
+<span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="o">/</span><span class="mi">8</span> <span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="o">/</span><span class="mi">8</span> <span class="p">,</span><span class="n">parameter_count</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Initial parameters = &quot;</span><span class="p">,</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Total number of parameters:  66
+Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064, 0.37118004688049144, -0.03656087558321203, 0.08564174998504231, 0.21639801853794682, 0.11122286088634259, 0.1743727097033635, -0.36518146001762486, -0.15829741539542244, -0.3467434780387345, 0.28043500852894776, -0.09986021299050934, 0.14125225086023052, -0.19141728018199775, -0.11970943368650361, -0.3853063093646483, -0.1112643868789806, 0.3527177454825464, -0.22156160012057186, -0.1418496891385843, 0.32811766468303116, -0.367642000671186, -0.34158180583996006, 0.10196745745501312, 0.29359239180502594, -0.3858537615546677, 0.19366130907065582, 0.24570488114056754, -0.3332307385378807, 0.12287973244618389, 0.007274514934614895, -0.015799547372526146, 0.3578070967202224, -0.39268963055535144, -0.19872246354138554, 0.16668715544467982, -0.13777293592446055, -0.17514665212709513, 0.15350249947988204, 0.32872977428061945, -0.20068831419712105, -0.032919322131134854, -0.19399909325771983, -0.09477141125241506, 0.08210460401106645, 0.21392577760158515, -0.3393568044538389, 0.14615087942938465, 0.03790339186006314, -0.2843250892879255, -0.3151384847055956, -0.19983741137121905, -0.27348611567665115, 0.33457528180906904, 0.14145414847455462, -0.20604220093940323, 0.05410235084309195, 0.04447870918600966, -0.3355714098595045, 0.266806440171265, -0.07436189654442632, -0.2789176729721685, -0.2427508182662484]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">cost_values</span><span class="o">=</span><span class="p">[]</span>
+<span class="k">def</span> <span class="nf">objective</span><span class="p">(</span><span class="n">parameters</span><span class="p">):</span>
+
+    <span class="n">cost</span><span class="o">=</span><span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">dc_qaoa</span><span class="p">,</span> <span class="n">ham</span><span class="p">,</span> <span class="n">qubit_num</span><span class="p">,</span> <span class="n">num_layers</span><span class="p">,</span> <span class="n">parameters</span><span class="p">,</span><span class="n">coef</span><span class="p">,</span><span class="n">words</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+    <span class="n">cost_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cost</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">cost</span>
+
+<span class="c1"># Optimize!</span>
+<span class="n">optimal_expectation</span><span class="p">,</span> <span class="n">optimal_parameters</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span>
+    <span class="n">dimensions</span><span class="o">=</span><span class="n">parameter_count</span><span class="p">,</span> <span class="n">function</span><span class="o">=</span><span class="n">objective</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;optimal_expectation =&#39;</span><span class="p">,</span> <span class="n">optimal_expectation</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;optimal_parameters =&#39;</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+optimal_expectation = -2.0057970170760537
+optimal_parameters = [2.0617900450255213, -0.008832997414504553, 0.5446745231437978, 0.9170743966952536, 0.5684145055308018, 0.45653992738579674, 0.48765328828009236, 0.08690545932812363, 0.4396413285058074, 0.18459993158979182, -1.309747594917737, 1.2588385005776594, -0.834255663515425, 0.674712608431175, -0.40174553656823186, 0.1936475123928361, 0.11292461472367524, -0.40520422214477836, 0.5249647407525035, -0.8276837818165452, 0.2945660883282474, -0.8060498989662159, 0.08051672267342141, 0.016438756265571293, 1.5245041151262497, 1.4087477995498743, 0.24688680789607903, 2.1121838066265077, 1.1445970943333728, -0.22281558391261153, 0.29034932090910637, -1.0492037973620043, 0.2734013684834806, 0.5265417924961102, 0.5099056677967553, 0.8636684922225737, -0.6164906874232119, -0.42851259141848624, 0.09675272347583658, 0.05697275350531247, -0.7102412317670379, -0.11174687408874051, 0.32505750242276577, -0.4397450017834574, -0.023604090020531092, 2.072436348972407, -0.38357054930488194, 0.13613334013073858, -0.10505045798768743, 2.0359359294549595, -0.24377425227508304, 0.10609870738840588, -0.2073332743736556, 0.07232539343493427, -0.6190529241716675, -0.03799182564866846, 0.17548654124993912, 0.5257077568577536, -0.23376653076971432, 0.3391308272563698, 0.4193139961661264, 0.02390444901420668, 0.2521154835623746, 1.1843328649807838, -0.6609672889772077, -0.2612231428844001]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">shots</span><span class="o">=</span><span class="mi">200000</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">dc_qaoa</span><span class="p">,</span> <span class="n">qubit_num</span><span class="p">,</span> <span class="n">num_layers</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">,</span><span class="n">coef</span><span class="p">,</span><span class="n">words</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The MVWCP is given by the partition: &#39;</span><span class="p">,</span> <span class="nb">max</span><span class="p">(</span><span class="n">counts</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">counts</span><span class="p">[</span><span class="n">x</span><span class="p">]))</span>
+
+<span class="c1"># Alternative</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The MVWCP is given by the partition: &#39;</span><span class="p">,</span> <span class="n">counts</span><span class="o">.</span><span class="n">most_probable</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{ 111000:200000 }
+
+The MVWCP is given by the partition:  111000
+The MVWCP is given by the partition:  111000
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+
+<span class="n">x_values</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">cost_values</span><span class="p">)))</span>
+<span class="n">y_values</span> <span class="o">=</span> <span class="n">cost_values</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x_values</span><span class="p">,</span> <span class="n">y_values</span><span class="p">)</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s2">&quot;Epochs&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s2">&quot;Cost Value&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_maximum_vertex_weight_clique_10_0.png" src="../../../_images/examples_python_tutorials_maximum_vertex_weight_clique_10_0.png" />
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="hybrid_qnns.html" class="btn btn-neutral float-left" title="Hybrid Quantum Neural Networks" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="noisy_simulations.html" class="btn btn-neutral float-right" title="Noisy Simulation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/maximum_vertex_weight_clique.ipynb b/pr-2241/examples/python/tutorials/maximum_vertex_weight_clique.ipynb
new file mode 100644
index 0000000000..1b25ce1f3f
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/maximum_vertex_weight_clique.ipynb
@@ -0,0 +1,325 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Molecular docking via DC-QAOA\n",
+    "\n",
+    "The data of the clique graph for the molecular docking are taken from this [paper](https://arxiv.org/pdf/2308.04098)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "import numpy as np\n",
+    "\n",
+    "# GPU: Default If an NVIDIA GPU and CUDA runtime libraries are available\n",
+    "#cudaq.set_target('nvidia')\n",
+    "\n",
+    "# CPU\n",
+    "cudaq.set_target('qpp-cpu')\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Edges:  [[0, 1], [0, 2], [0, 4], [0, 5], [1, 2], [1, 3], [1, 5], [2, 3], [2, 4], [3, 4], [3, 5], [4, 5]]\n",
+      "Non-Edges:  [[0, 3], [1, 4], [2, 5]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# The two graphs input from the paper\n",
+    "\n",
+    "# BIG 1\n",
+    "\n",
+    "nodes = [0,1,2,3,4,5]\n",
+    "qubit_num=len(nodes)\n",
+    "edges = [[0,1],[0,2],[0,4],[0,5],[1,2],[1,3],[1,5],[2,3],[2,4],[3,4],[3,5],[4,5]]\n",
+    "non_edges = [[u,v] for u in nodes for v in nodes if u<v and [u,v] not in edges]\n",
+    "print('Edges: ', edges)\n",
+    "print('Non-Edges: ', non_edges)\n",
+    "weights = [0.6686,0.6686,0.6686,0.1453,0.1453,0.1453]\n",
+    "penalty = 6.0\n",
+    "num_layers = 3\n",
+    "\n",
+    "# BIG 2 (More expensive simulation)\n",
+    "\n",
+    "#nodes=[0,1,2,3,4,5,6,7]\n",
+    "#qubit_num=len(nodes)\n",
+    "#edges=[[0,1],[0,2],[0,5],[0,6],[0,7],[1,2],[1,4],[1,6],[1,7],[2,4],[2,5],[2,7],[3,4],[3,5],[3,6],\\\n",
+    "#    [4,5],[4,6],[5,6]]\n",
+    "#non_edges=[[u,v] for u in nodes for v in nodes if u<v and [u,v] not in edges]\n",
+    "#print('Edges: ', edges)\n",
+    "#print('Non-edges: ', non_edges)\n",
+    "#weights=[0.6686,0.6686,0.6886,0.1091,0.0770,0.0770,0.0770,0.0770]\n",
+    "#penalty=8.0\n",
+    "#num_layers=8"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Generate the Hamiltonian\n",
+    "def ham_clique(penalty, nodes, weights, non_edges)-> cudaq.SpinOperator:\n",
+    "    \n",
+    "    spin_ham = 0.0\n",
+    "    for wt,node in zip(weights,nodes):\n",
+    "        #print(wt,node)\n",
+    "        spin_ham += 0.5 * wt * spin.z(node)\n",
+    "        spin_ham -= 0.5 * wt * spin.i(node)\n",
+    "    \n",
+    "    for non_edge in non_edges:\n",
+    "        u,v=(non_edge[0],non_edge[1])\n",
+    "        #print(u,v)\n",
+    "        spin_ham += penalty/4.0 * (spin.z(u)*spin.z(v)-spin.z(u)-spin.z(v)+spin.i(u)*spin.i(v))\n",
+    "    \n",
+    "    return spin_ham   "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Collect coefficients from a spin operator so we can pass them to a kernel\n",
+    "def term_coefficients(ham: cudaq.SpinOperator) -> list[complex]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.get_coefficient()))\n",
+    "    return result\n",
+    "\n",
+    "    # Collect Pauli words from a spin operator so we can pass them to a kernel\n",
+    "def term_words(ham: cudaq.SpinOperator) -> list[str]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.to_string(False)))\n",
+    "    return result\n",
+    "    "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def dc_qaoa(qubit_num:int, num_layers:int,thetas:list[float],\\\n",
+    "    coef:list[complex], words:list[cudaq.pauli_word]):\n",
+    "    \n",
+    "    qubits=cudaq.qvector(qubit_num)\n",
+    "    \n",
+    "    h(qubits)\n",
+    "    \n",
+    "    count=0\n",
+    "    for p in range(num_layers):\n",
+    "        \n",
+    "        for i in range(len(coef)):\n",
+    "            exp_pauli(thetas[count]*coef[i].real,qubits,words[i])\n",
+    "            count+=1\n",
+    "        \n",
+    "        for j in range(qubit_num):\n",
+    "            rx(thetas[count],qubits[j])\n",
+    "            count+=1 \n",
+    "        \n",
+    "        for k in range(qubit_num):\n",
+    "            ry(thetas[count],qubits[k])\n",
+    "            count+=1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[1.5+0j] IIZIIZ\n",
+      "[1.5+0j] ZIIZII\n",
+      "[-1.1657+0j] IZIIII\n",
+      "[1.5+0j] IZIIZI\n",
+      "[-1.42735+0j] IIIZII\n",
+      "[3.2791499999999996+0j] IIIIII\n",
+      "[-1.1657+0j] IIZIII\n",
+      "[-1.42735+0j] IIIIIZ\n",
+      "[-1.1657+0j] ZIIIII\n",
+      "[-1.42735+0j] IIIIZI\n",
+      "\n",
+      "[(1.5+0j), (1.5+0j), (-1.1657+0j), (1.5+0j), (-1.42735+0j), (3.2791499999999996+0j), (-1.1657+0j), (-1.42735+0j), (-1.1657+0j), (-1.42735+0j)]\n",
+      "['IIZIIZ', 'ZIIZII', 'IZIIII', 'IZIIZI', 'IIIZII', 'IIIIII', 'IIZIII', 'IIIIIZ', 'ZIIIII', 'IIIIZI']\n"
+     ]
+    }
+   ],
+   "source": [
+    "ham= ham_clique(penalty,nodes,weights,non_edges)\n",
+    "print(ham)\n",
+    "\n",
+    "coef=term_coefficients(ham)\n",
+    "words=term_words(ham)\n",
+    "\n",
+    "print(term_coefficients(ham))\n",
+    "print(term_words(ham))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Total number of parameters:  66\n",
+      "Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064, 0.37118004688049144, -0.03656087558321203, 0.08564174998504231, 0.21639801853794682, 0.11122286088634259, 0.1743727097033635, -0.36518146001762486, -0.15829741539542244, -0.3467434780387345, 0.28043500852894776, -0.09986021299050934, 0.14125225086023052, -0.19141728018199775, -0.11970943368650361, -0.3853063093646483, -0.1112643868789806, 0.3527177454825464, -0.22156160012057186, -0.1418496891385843, 0.32811766468303116, -0.367642000671186, -0.34158180583996006, 0.10196745745501312, 0.29359239180502594, -0.3858537615546677, 0.19366130907065582, 0.24570488114056754, -0.3332307385378807, 0.12287973244618389, 0.007274514934614895, -0.015799547372526146, 0.3578070967202224, -0.39268963055535144, -0.19872246354138554, 0.16668715544467982, -0.13777293592446055, -0.17514665212709513, 0.15350249947988204, 0.32872977428061945, -0.20068831419712105, -0.032919322131134854, -0.19399909325771983, -0.09477141125241506, 0.08210460401106645, 0.21392577760158515, -0.3393568044538389, 0.14615087942938465, 0.03790339186006314, -0.2843250892879255, -0.3151384847055956, -0.19983741137121905, -0.27348611567665115, 0.33457528180906904, 0.14145414847455462, -0.20604220093940323, 0.05410235084309195, 0.04447870918600966, -0.3355714098595045, 0.266806440171265, -0.07436189654442632, -0.2789176729721685, -0.2427508182662484]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Optimizer\n",
+    "\n",
+    "# Specify the optimizer and its initial parameters.\n",
+    "optimizer = cudaq.optimizers.NelderMead()\n",
+    "#optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "np.random.seed(13)\n",
+    "cudaq.set_random_seed(13)\n",
+    "\n",
+    "# if dc_qaoa used\n",
+    "parameter_count=(2*qubit_num+len(coef))*num_layers\n",
+    "\n",
+    "# if qaoa used\n",
+    "# parameter_count=(qubit_num+len(coef))*num_layers\n",
+    "\n",
+    "print('Total number of parameters: ', parameter_count)\n",
+    "optimizer.initial_parameters = np.random.uniform(-np.pi/8 , np.pi/8 ,parameter_count)\n",
+    "print(\"Initial parameters = \", optimizer.initial_parameters)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "optimal_expectation = -2.0057970170760537\n",
+      "optimal_parameters = [2.0617900450255213, -0.008832997414504553, 0.5446745231437978, 0.9170743966952536, 0.5684145055308018, 0.45653992738579674, 0.48765328828009236, 0.08690545932812363, 0.4396413285058074, 0.18459993158979182, -1.309747594917737, 1.2588385005776594, -0.834255663515425, 0.674712608431175, -0.40174553656823186, 0.1936475123928361, 0.11292461472367524, -0.40520422214477836, 0.5249647407525035, -0.8276837818165452, 0.2945660883282474, -0.8060498989662159, 0.08051672267342141, 0.016438756265571293, 1.5245041151262497, 1.4087477995498743, 0.24688680789607903, 2.1121838066265077, 1.1445970943333728, -0.22281558391261153, 0.29034932090910637, -1.0492037973620043, 0.2734013684834806, 0.5265417924961102, 0.5099056677967553, 0.8636684922225737, -0.6164906874232119, -0.42851259141848624, 0.09675272347583658, 0.05697275350531247, -0.7102412317670379, -0.11174687408874051, 0.32505750242276577, -0.4397450017834574, -0.023604090020531092, 2.072436348972407, -0.38357054930488194, 0.13613334013073858, -0.10505045798768743, 2.0359359294549595, -0.24377425227508304, 0.10609870738840588, -0.2073332743736556, 0.07232539343493427, -0.6190529241716675, -0.03799182564866846, 0.17548654124993912, 0.5257077568577536, -0.23376653076971432, 0.3391308272563698, 0.4193139961661264, 0.02390444901420668, 0.2521154835623746, 1.1843328649807838, -0.6609672889772077, -0.2612231428844001]\n"
+     ]
+    }
+   ],
+   "source": [
+    "cost_values=[]\n",
+    "def objective(parameters):\n",
+    "\n",
+    "    cost=cudaq.observe(dc_qaoa, ham, qubit_num, num_layers, parameters,coef,words).expectation()\n",
+    "    cost_values.append(cost)\n",
+    "    return cost\n",
+    "\n",
+    "# Optimize!\n",
+    "optimal_expectation, optimal_parameters = optimizer.optimize(\n",
+    "    dimensions=parameter_count, function=objective)\n",
+    "\n",
+    "print('optimal_expectation =', optimal_expectation)\n",
+    "print('optimal_parameters =', optimal_parameters)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 111000:200000 }\n",
+      "\n",
+      "The MVWCP is given by the partition:  111000\n",
+      "The MVWCP is given by the partition:  111000\n"
+     ]
+    }
+   ],
+   "source": [
+    "shots=200000\n",
+    "\n",
+    "counts = cudaq.sample(dc_qaoa, qubit_num, num_layers, optimal_parameters,coef,words, shots_count=shots)\n",
+    "print(counts)\n",
+    "\n",
+    "print('The MVWCP is given by the partition: ', max(counts, key=lambda x: counts[x]))\n",
+    "\n",
+    "# Alternative\n",
+    "print('The MVWCP is given by the partition: ', counts.most_probable())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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17/+VZGRkUpISCg3c1GnTh01b97ca1mzZs20f/9+SRf25Up/H2rXrq2srCyv9efOndOxY8f8mi+7jRkzxnP0qFWrVho0aJB+//vfe44ulqe5sArlfl9uTGmcl/PF6Mcff9TSpUs9R42k8jMfX331lbKyspScnOz5t/THH3/U448/rvr160sqXXNBOSqBqKgotW/fXsuWLfMsc7vdWrZsmTp16mRjspIxxmjEiBGaP3++li9frgYNGnitb9++vSpUqOC137t379b+/fs9+92pUydt27bN6w/6+X8Uzv+C7dSpk9c2zo8pTXPXvXt3bdu2TWlpaZ5Hhw4dNHDgQM/P5WUuunTpctEtHb799ltdddVVkqQGDRqodu3aXvuRk5Ojb775xmsuTpw4odTUVM+Y5cuXy+12q2PHjp4xq1evVkFBgWfM0qVL1aRJE1WtWjVo++eP06dPy+n0/uczIiJCbrdbUvmaC6tQ7nc4/J2RLhSj7777Tl9++aWqV6/utb68zMegQYO0detWr39LExMTNWbMGC1ZskRSKZsLn0/dxiXNmTPHuFwuM3v2bLNjxw7z8MMPmypVqnhdmRRuhg0bZuLj483KlSvNoUOHPI/Tp097xgwdOtQkJyeb5cuXm40bN5pOnTqZTp06edafv3y9Z8+eJi0tzSxevNjUrFnzkpevjxkzxuzcudNMnz691F2+finWq9WMKT9zsX79ehMZGWmmTJlivvvuO/Pee++ZmJgY889//tMzZtq0aaZKlSrm008/NVu3bjV33HHHJS/jbtu2rfnmm2/M119/bRo3bux1qe6JEydMQkKCGTRokElPTzdz5swxMTExpepS/pSUFFO3bl3Ppfzz5s0zNWrUME888YRnTFmdi5MnT5rNmzebzZs3G0nmpZdeMps3b/ZcfRWq/V6zZo2JjIw0L774otm5c6eZNGmSLZfyX2k+8vPzza9//WtTr149k5aW5vXvqfVqq7IyH0X92filX16tZkzpmQvKUQC89tprJjk52URFRZnrr7/erFu3zu5IJSLpko933nnHM+bMmTPmd7/7nalataqJiYkxd955pzl06JDXdn744QfTu3dvEx0dbWrUqGEef/xxU1BQ4DVmxYoV5tprrzVRUVGmYcOGXu9RWv2yHJWnufj8889Ny5YtjcvlMk2bNjVvvfWW13q3220mTJhgEhISjMvlMt27dze7d+/2GvPTTz+Z++67z1SuXNnExcWZBx980Jw8edJrzJYtW8yNN95oXC6XqVu3rpk2bVrQ980fOTk5ZuTIkSY5OdlUrFjRNGzY0IwbN87rF15ZnYsVK1Zc8t+HlJQUY0xo9/ujjz4y11xzjYmKijItWrQwCxYsCNp+X86V5mPfvn2X/fd0xYoVnm2Ulfko6s/GL12qHJWWuXAYY7mlKwAAQDnHOUcAAAAWlCMAAAALyhEAAIAF5QgAAMCCcgQAAGBBOQIAALCgHAEAAFhQjgAAACwoRwDKFYfDoU8++cTuGABKMcoRgJAZPHiwHA7HRY/bbrvN7mgA4BFpdwAA5cttt92md955x2uZy+WyKQ0AXIwjRwBCyuVyqXbt2l6PqlWrSvr5I68ZM2aod+/eio6OVsOGDfXxxx97vX7btm3q1q2boqOjVb16dT388MPKzc31GjNr1iy1aNFCLpdLderU0YgRI7zWHz16VHfeeadiYmLUuHFjffbZZ551x48f18CBA1WzZk1FR0ercePGF5U5AGUb5QhAqTJhwgTdfffd2rJliwYOHKh7771XO3fulCSdOnVKvXr1UtWqVbVhwwbNnTtXX375pVf5mTFjhoYPH66HH35Y27Zt02effaZGjRp5vcfkyZN1zz33aOvWrerTp48GDhyoY8eOed5/x44dWrRokXbu3KkZM2aoRo0aoZsAAPYzABAiKSkpJiIiwlSqVMnrMWXKFGOMMZLM0KFDvV7TsWNHM2zYMGOMMW+99ZapWrWqyc3N9axfsGCBcTqdJjMz0xhjTGJiohk3btxlM0gy48eP9zzPzc01ksyiRYuMMcb069fPPPjgg4HZYQBhiXOOAIRU165dNWPGDK9l1apV8/zcqVMnr3WdOnVSWlqaJGnnzp1q06aNKlWq5FnfpUsXud1u7d69Ww6HQwcPHlT37t2vmKF169aenytVqqS4uDhlZWVJkoYNG6a7775bmzZtUs+ePdW/f3917ty5WPsKIDxRjgCEVKVKlS76mCtQoqOjfRpXoUIFr+cOh0Nut1uS1Lt3b/34449auHChli5dqu7du2v48OF68cUXA54XQOnEOUcASpV169Zd9LxZs2aSpGbNmmnLli06deqUZ/2aNWvkdDrVpEkTxcbGqn79+lq2bFmJMtSsWVMpKSn65z//qVdeeUVvvfVWibYHILxw5AhASOXl5SkzM9NrWWRkpOek57lz56pDhw668cYb9d5772n9+vV6++23JUkDBw7UpEmTlJKSoqefflpHjhzRo48+qkGDBikhIUGS9PTTT2vo0KGqVauWevfurZMnT2rNmjV69NFHfco3ceJEtW/fXi1atFBeXp6++OILTzkDUD5QjgCE1OLFi1WnTh2vZU2aNNGuXbsk/Xwl2Zw5c/S73/1OderU0QcffKDmzZtLkmJiYrRkyRKNHDlS1113nWJiYnT33XfrpZde8mwrJSVFZ8+e1csvv6w//OEPqlGjhv7nf/7H53xRUVEaO3asfvjhB0VHR+tXv/qV5syZE4A9BxAuHMYYY3cIAJB+Pvdn/vz56t+/v91RAJRjnHMEAABgQTkCAACw4JwjAKUGn/IDKA04cgQAAGBBOQIAALCgHAEAAFhQjgAAACwoRwAAABaUIwAAAAvKEQAAgAXlCAAAwOL/ASxEkL8STAhjAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "x_values = list(range(len(cost_values)))\n",
+    "y_values = cost_values\n",
+    "\n",
+    "plt.plot(x_values, y_values)\n",
+    "\n",
+    "plt.xlabel(\"Epochs\")\n",
+    "plt.ylabel(\"Cost Value\")\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/noisy_simulations.html b/pr-2241/examples/python/tutorials/noisy_simulations.html
new file mode 100644
index 0000000000..21d29fa01e
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/noisy_simulations.html
@@ -0,0 +1,813 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Noisy Simulation &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Readout Error Mitigation" href="readout_error_mitigation.html" />
+    <link rel="prev" title="Molecular docking via DC-QAOA" href="maximum_vertex_weight_clique.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Noisy Simulation</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/noisy_simulations.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="maximum_vertex_weight_clique.html" class="btn btn-neutral float-left" title="Molecular docking via DC-QAOA" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="readout_error_mitigation.html" class="btn btn-neutral float-right" title="Readout Error Mitigation" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Noisy-Simulation">
+<h1>Noisy Simulation<a class="headerlink" href="#Noisy-Simulation" title="Permalink to this heading">¶</a></h1>
+<p>Quantum noise can be characterized into coherent and incoherent sources of errors that arise during a computation. Coherent noise is commonly due to systematic errors originating from device miscalibrations, for example, gates implementing a rotation <span class="math notranslate nohighlight">\(\theta + \epsilon\)</span> instead of <span class="math notranslate nohighlight">\(\theta\)</span>.</p>
+<p>Incoherent noise has its origins in quantum states being entangled with the environment due to decoherence. This leads to mixed states which are probability distributions over pure states and are described by employing the density matrix formalism.</p>
+<p>We can model incoherent noise via quantum channels which are linear, completely positive, and trace preserving maps. These maps are called Kraus operators, <span class="math notranslate nohighlight">\(\{ K_i \}\)</span>, which satisfy the condition <span class="math notranslate nohighlight">\(\sum_{i} K_i^\dagger K_i = \mathbb{I}\)</span>.</p>
+<p>The bit-flip channel flips the qubit with probability <span class="math notranslate nohighlight">\(p\)</span> and leaves it unchanged with probability <span class="math notranslate nohighlight">\(1-p\)</span>. This can be represented by employing Kraus operators:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}K_0 = \sqrt{1-p} \begin{pmatrix}
+    1 &amp; 0 \\
+    0 &amp; 1
+\end{pmatrix}\end{split}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}K_1 = \sqrt{p} \begin{pmatrix}
+  0 &amp; 1 \\
+  1 &amp; 0
+\end{pmatrix}\end{split}\]</div>
+<p>Let’s implement the bit-flip channel using CUDA-Q:</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># To model quantum noise, we need to utilize the density matrix simulator target.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;density-matrix-cpu&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Let&#39;s define a simple kernel that we will add noise to.</span>
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">2</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮
+q0 : ┤ x ├
+     ├───┤
+q1 : ┤ x ├
+     ╰───╯
+
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># In the ideal noiseless case, we get |11&gt; 100% of the time.</span>
+
+<span class="n">ideal_counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">)</span>
+<span class="n">ideal_counts</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{ 11:1000 }
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># First, we will define an out of the box noise channel. In this case,</span>
+<span class="c1"># we choose depolarization noise. This depolarization will result in</span>
+<span class="c1"># the qubit state decaying into a mix of the basis states, |0&gt; and |1&gt;,</span>
+<span class="c1"># with our provided probability.</span>
+<span class="n">error_probability</span> <span class="o">=</span> <span class="mf">0.1</span>
+<span class="n">depolarization_channel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">DepolarizationChannel</span><span class="p">(</span><span class="n">error_probability</span><span class="p">)</span>
+
+<span class="c1"># We can also define our own, custom noise channels through</span>
+<span class="c1"># Kraus operators. Here we will define two operators representing</span>
+<span class="c1"># bit flip errors.</span>
+
+<span class="c1"># Define the Kraus Error Operator as a complex ndarray.</span>
+<span class="n">kraus_0</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">error_probability</span><span class="p">)</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mf">1.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">],</span> <span class="p">[</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">]],</span>
+                                                    <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+<span class="n">kraus_1</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="n">error_probability</span><span class="p">)</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">],</span> <span class="p">[</span><span class="mf">1.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">]],</span>
+                                                <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+
+<span class="c1"># Add the Kraus Operator to create a quantum channel.</span>
+<span class="n">bitflip_channel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">KrausChannel</span><span class="p">([</span><span class="n">kraus_0</span><span class="p">,</span> <span class="n">kraus_1</span><span class="p">])</span>
+
+<span class="c1"># Add the two channels to our Noise Model.</span>
+<span class="n">noise_model</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+<span class="c1"># Apply the depolarization channel to any X-gate on the 0th qubit.</span>
+<span class="n">noise_model</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s2">&quot;x&quot;</span><span class="p">,</span> <span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">depolarization_channel</span><span class="p">)</span>
+<span class="c1"># Apply the bitflip channel to any X-gate on the 1st qubit.</span>
+<span class="n">noise_model</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s2">&quot;x&quot;</span><span class="p">,</span> <span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">bitflip_channel</span><span class="p">)</span>
+
+<span class="c1"># Due to the impact of noise, our measurements will no longer be uniformly</span>
+<span class="c1"># in the |11&gt; state.</span>
+<span class="n">noisy_counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                            <span class="n">qubit_count</span><span class="p">,</span>
+                            <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_model</span><span class="p">,</span>
+                            <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">)</span>
+<span class="n">noisy_counts</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{ 11:850 10:88 01:56 00:6 }
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># We can also use noise models with the observe function</span>
+
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="n">noisy_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                             <span class="n">hamiltonian</span><span class="p">,</span>
+                             <span class="n">qubit_count</span><span class="p">,</span>
+                             <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_model</span><span class="p">)</span>
+
+<span class="n">noisy_result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+-0.8666666666666666
+</pre></div></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="maximum_vertex_weight_clique.html" class="btn btn-neutral float-left" title="Molecular docking via DC-QAOA" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="readout_error_mitigation.html" class="btn btn-neutral float-right" title="Readout Error Mitigation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/noisy_simulations.ipynb b/pr-2241/examples/python/tutorials/noisy_simulations.ipynb
new file mode 100644
index 0000000000..cad766e29e
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/noisy_simulations.ipynb
@@ -0,0 +1,205 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Noisy Simulation \n",
+    "\n",
+    "Quantum noise can be characterized into coherent and incoherent sources of errors that arise during a computation. Coherent noise is commonly due to systematic errors originating from device miscalibrations, for example, gates implementing a rotation $\\theta + \\epsilon$ instead of $\\theta$.\n",
+    "\n",
+    "Incoherent noise has its origins in quantum states being entangled with the environment due to decoherence. This leads to mixed states which are probability distributions over pure states and are described by employing the density matrix formalism. \n",
+    "\n",
+    "We can model incoherent noise via quantum channels which are linear, completely positive, and trace preserving maps. These maps are called Kraus operators, $\\{ K_i \\}$, which satisfy the condition $\\sum_{i} K_i^\\dagger K_i = \\mathbb{I}$. \n",
+    "\n",
+    "The bit-flip channel flips the qubit with probability $p$ and leaves it unchanged with probability $1-p$. This can be represented by employing Kraus operators: \n",
+    "\n",
+    "$$K_0 = \\sqrt{1-p} \\begin{pmatrix}\n",
+    "    1 & 0 \\\\\n",
+    "    0 & 1\n",
+    "\\end{pmatrix}$$\n",
+    "\n",
+    "$$K_1 = \\sqrt{p} \\begin{pmatrix}\n",
+    "  0 & 1 \\\\\n",
+    "  1 & 0\n",
+    "\\end{pmatrix}$$\n",
+    "\n",
+    "Let's implement the bit-flip channel using CUDA-Q:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "# To model quantum noise, we need to utilize the density matrix simulator target.\n",
+    "cudaq.set_target(\"density-matrix-cpu\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮\n",
+      "q0 : ┤ x ├\n",
+      "     ├───┤\n",
+      "q1 : ┤ x ├\n",
+      "     ╰───╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Let's define a simple kernel that we will add noise to.\n",
+    "qubit_count = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(qubit_count: int):\n",
+    "    qvector = cudaq.qvector(qubit_count)\n",
+    "    x(qvector)\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(kernel, qubit_count))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11:1000 }\n"
+     ]
+    }
+   ],
+   "source": [
+    "# In the ideal noiseless case, we get |11> 100% of the time.\n",
+    "\n",
+    "ideal_counts = cudaq.sample(kernel, qubit_count, shots_count=1000)\n",
+    "ideal_counts.dump()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11:850 10:88 01:56 00:6 }\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First, we will define an out of the box noise channel. In this case,\n",
+    "# we choose depolarization noise. This depolarization will result in\n",
+    "# the qubit state decaying into a mix of the basis states, |0> and |1>,\n",
+    "# with our provided probability.\n",
+    "error_probability = 0.1\n",
+    "depolarization_channel = cudaq.DepolarizationChannel(error_probability)\n",
+    "\n",
+    "# We can also define our own, custom noise channels through\n",
+    "# Kraus operators. Here we will define two operators representing\n",
+    "# bit flip errors.\n",
+    "\n",
+    "# Define the Kraus Error Operator as a complex ndarray.\n",
+    "kraus_0 = np.sqrt(1 - error_probability) * np.array([[1.0, 0.0], [0.0, 1.0]],\n",
+    "                                                    dtype=np.complex128)\n",
+    "kraus_1 = np.sqrt(error_probability) * np.array([[0.0, 1.0], [1.0, 0.0]],\n",
+    "                                                dtype=np.complex128)\n",
+    "\n",
+    "# Add the Kraus Operator to create a quantum channel.\n",
+    "bitflip_channel = cudaq.KrausChannel([kraus_0, kraus_1])\n",
+    "\n",
+    "# Add the two channels to our Noise Model.\n",
+    "noise_model = cudaq.NoiseModel()\n",
+    "\n",
+    "# Apply the depolarization channel to any X-gate on the 0th qubit.\n",
+    "noise_model.add_channel(\"x\", [0], depolarization_channel)\n",
+    "# Apply the bitflip channel to any X-gate on the 1st qubit.\n",
+    "noise_model.add_channel(\"x\", [1], bitflip_channel)\n",
+    "\n",
+    "# Due to the impact of noise, our measurements will no longer be uniformly\n",
+    "# in the |11> state.\n",
+    "noisy_counts = cudaq.sample(kernel,\n",
+    "                            qubit_count,\n",
+    "                            noise_model=noise_model,\n",
+    "                            shots_count=1000)\n",
+    "noisy_counts.dump()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "-0.8666666666666666"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# We can also use noise models with the observe function\n",
+    "\n",
+    "hamiltonian = spin.z(0)\n",
+    "\n",
+    "noisy_result = cudaq.observe(kernel,\n",
+    "                             hamiltonian,\n",
+    "                             qubit_count,\n",
+    "                             noise_model=noise_model)\n",
+    "\n",
+    "noisy_result.expectation()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.15 (default, Sep 23 2021, 15:41:43) [GCC]"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/qaoa.html b/pr-2241/examples/python/tutorials/qaoa.html
new file mode 100644
index 0000000000..2564b8591a
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/qaoa.html
@@ -0,0 +1,962 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Max-Cut with QAOA &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Hadamard Test and Application" href="hadamard_test.html" />
+    <link rel="prev" title="Variational Quantum Eigensolver" href="vqe.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Max-Cut with QAOA</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/qaoa.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="vqe.html" class="btn btn-neutral float-left" title="Variational Quantum Eigensolver" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hadamard_test.html" class="btn btn-neutral float-right" title="Hadamard Test and Application" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Max-Cut-with-QAOA">
+<h1>Max-Cut with QAOA<a class="headerlink" href="#Max-Cut-with-QAOA" title="Permalink to this heading">¶</a></h1>
+<p><a class="reference external" href="https://arxiv.org/abs/1411.4028">Farhi et al.</a> introduced the quantum approximation optimization algorithm (QAOA) to solve optimization problems like the max cut problem. Before diving into the details of QAOA, we’ll first define the max cut problem.</p>
+<p><a class="reference external" href="https://en.wikipedia.org/wiki/Maximum_cut">Max Cut</a> is the problem of finding a partition of a graph’s nodes into two sets which maximizes the edges between the two sets. Although this problem is relatively easy to solve for graphs with few vertices, this problem is <a class="reference external" href="https://en.wikipedia.org/wiki/NP-hardness#:~:text=7%20References-,Definition,complete%20problem%20G%20to%20H.">NP-hard</a>. The max cut problem has a wide range of applications including <a class="reference external" href="https://jmlr.org/papers/volume14/wang13a/wang13a.pdf">machine
+learning</a>, <a class="reference external" href="https://math.mit.edu/research/highschool/primes/materials/2020/Hong-Lee-Wei.pdf">circuit design</a> and <a class="reference external" href="https://www.researchgate.net/publication/262162554_An_Application_of_Combinatorial_Optimization_to_Statistical_Physics_and_Circuit_Layout_Design">statistical physics</a>, among others. Furthermore, the QAOA algorithm presented in this tutorial can be adapted to other related optimization problems with an even wider
+application field including <a class="reference external" href="https://journals.aps.org/prresearch/pdf/10.1103/PhysRevResearch.4.043204">portfolio optimization</a> and <a class="reference external" href="https://www.sciencedirect.com/science/article/pii/S0377221723002072">job shop scheduling</a>, just to name a few.</p>
+<p>We take the convention that <span class="math notranslate nohighlight">\(G=(V,E)\)</span> represents a graph with vertex set <span class="math notranslate nohighlight">\(V\subseteq \mathbb{N}\)</span> and edge set <span class="math notranslate nohighlight">\(E\subseteq V\times V\)</span>. We use the terms vertex and node interchangeably. For this tutorial we assume that the graphs are undirected (that is, <span class="math notranslate nohighlight">\((u,v)\)</span> and <span class="math notranslate nohighlight">\((v,u)\)</span> represent the same edge). Our graphs contain no self loops (i.e., for every vertex <span class="math notranslate nohighlight">\(v\)</span>, there is no edge <span class="math notranslate nohighlight">\((v,v)\)</span>). A <em>cut</em> of the graph <span class="math notranslate nohighlight">\(G\)</span> is a partition, <span class="math notranslate nohighlight">\((V_0,V_1)\)</span>, of
+the vertex set such that every vertex of <span class="math notranslate nohighlight">\(V\)</span> is a member of exactly one of <span class="math notranslate nohighlight">\(V_0\)</span> or <span class="math notranslate nohighlight">\(V_1\)</span> (i.e., <span class="math notranslate nohighlight">\(V_0\bigcup V_1 = V\)</span> and <span class="math notranslate nohighlight">\(V_0\bigcap V_0=\emptyset\)</span>). The <em>cut value</em> for a partition is the sum of the edges with one node in <span class="math notranslate nohighlight">\(V_0\)</span> and one node in <span class="math notranslate nohighlight">\(V_1\)</span>.</p>
+<p>In the images below, we illustrate two cuts of a graph with the dotted lines. Each of these cuts partitions the graph into two disjoint sets. The cut on the left is not optimal, and the cut on the right is the max cut. The cut on the left divides the graph into disjoint sets <span class="math notranslate nohighlight">\(\{1,2\}\)</span> and <span class="math notranslate nohighlight">\(\{0,3,4\}\)</span>, and that cut contains 3 edges. To more easily visualize the cut, we have colored the vertices in one set of the partition green and the vertices in the other set of the partition gray.
+The cut depicted in the diagram on the right divides the graph vertices into two disjoint sets <span class="math notranslate nohighlight">\(V_0=\{0,2\}\)</span>, colored gray, and <span class="math notranslate nohighlight">\(V_1=\{1,3,4\}\)</span>, colored green. The number of edges connecting vertices in the distinct sets is computed by</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\sum_{\substack{u \in V_0; v\in V_1\\ (u,v) \in E}}1.\end{split}\]</div>
+<p>For the graph on the right, the number of edges in the cut (in this case there are <span class="math notranslate nohighlight">\(5\)</span> edges) is maximal, and this value is referred to as the <em>max cut value</em>. The partitioning <span class="math notranslate nohighlight">\((V_0,V_1)\)</span> — and sometimes the set of edges connecting vertices in <span class="math notranslate nohighlight">\(V_0\)</span> and <span class="math notranslate nohighlight">\(V_1\)</span> — is referred to as a <em>max cut of a graph</em>. Note that the max cut of a graph need not be unique; that is, two distinct partitions may produce the same cut value.</p>
+<p><img alt="image0" src="../../../_images/max-cut-illustration.png" /></p>
+<p>We will use bitstrings to identify vertices in each of the two partitions. For example using the ordering of the vertices, the bitstring <code class="docutils literal notranslate"><span class="pre">01100</span></code> captures the partition in the image above on the left with vertices <span class="math notranslate nohighlight">\(1\)</span> and <span class="math notranslate nohighlight">\(2\)</span> in <span class="math notranslate nohighlight">\(V_1\)</span>, and the bitstring <code class="docutils literal notranslate"><span class="pre">01011</span></code> codes the partition in the image on the right with vertices <span class="math notranslate nohighlight">\(1\)</span>, <span class="math notranslate nohighlight">\(3\)</span>, and <span class="math notranslate nohighlight">\(4\)</span> in <span class="math notranslate nohighlight">\(V_1\)</span>.</p>
+<p>Let’s code our graph data as lists of integers so that we can call these variables when we create the <code class="docutils literal notranslate"><span class="pre">cudaq.kernel</span></code> for QAOA.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+<span class="c1"># We&#39;ll use the graph below to illustrate how QAOA can be used to</span>
+<span class="c1"># solve a max cut problem</span>
+
+<span class="c1">#       v1  0--------------0 v2</span>
+<span class="c1">#           |              | \</span>
+<span class="c1">#           |              |  \</span>
+<span class="c1">#           |              |   \</span>
+<span class="c1">#           |              |    \</span>
+<span class="c1">#       v0  0--------------0 v3-- 0 v4</span>
+<span class="c1"># The max cut solutions are 01011, 10100, 01010, 10101 .</span>
+
+<span class="c1"># First we define the graph nodes (i.e., vertices) and edges as lists of integers so that they can be broadcast into</span>
+<span class="c1"># a cudaq.kernel.</span>
+<span class="n">nodes</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">4</span><span class="p">]</span>
+<span class="n">edges</span> <span class="o">=</span> <span class="p">[[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">],</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">],</span> <span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">],</span> <span class="p">[</span><span class="mi">3</span><span class="p">,</span> <span class="mi">0</span><span class="p">],</span> <span class="p">[</span><span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">],</span> <span class="p">[</span><span class="mi">3</span><span class="p">,</span> <span class="mi">4</span><span class="p">]]</span>
+<span class="n">edges_src</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">edges</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">edges</span><span class="p">))]</span>
+<span class="n">edges_tgt</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">edges</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="mi">1</span><span class="p">]</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">edges</span><span class="p">))]</span>
+</pre></div>
+</div>
+</div>
+<p>QAOA is a variational algortihm with a particular ansatz. QAOA is made up of a variational quantum circuit (i.e., a kernel that depends on a set of parameter values) and a classical optimizer. The aim of QAOA is to use the classical optimizer to identify parameter values that generate a quantum circuit whose expectation value for a given cost Hamilitonian is minimized.</p>
+<p>What distinguishes QAOA from other variational algorithms is the structure of the quantum circuit. For each vertex in the graph, there is an associated qubit in the circuit. The circuit is initialized in a superposition state. The remainder of the QAOA circuit is made up of blocks (referred to as layers). The more layers there are, the better the approximation the algorithm achieves.</p>
+<p><img alt="diagram of QAOA circuit layers" src="../../../_images/qaoa-circuit-layers.png" /></p>
+<p>Each layer contains a problem kernel and a mixer kernel. The mixer kernel is composed of parameterized rotation gates applied to each qubit, depicted in green in the image above. The problem kernel encodes the graph edges. The image below shows an example of an graph edge encoded with controlled-X gates and a parameterized rotation gate.</p>
+<p><img alt="diagram of a QAOA problem kernel for a max cut problem" src="../../../_images/qaoa-problem-kernel.png" /></p>
+<p>Let’s implement the QAOA circuit for our max cut problem in CUDA-Q.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Problem parameters</span>
+<span class="c1"># The number of qubits we&#39;ll need is the same as the number of vertices in our graph</span>
+<span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">nodes</span><span class="p">)</span>
+
+<span class="c1"># We can set the layer count to be any positive integer.  Larger values will create deeper circuits</span>
+<span class="n">layer_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">2</span>
+
+<span class="c1"># Each layer of the QAOA kernel contains 2 parameters</span>
+<span class="n">parameter_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">layer_count</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">qaoaProblem</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">,</span> <span class="n">qubit_1</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">,</span> <span class="n">alpha</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Build the QAOA gate sequence between two qubits that represent an edge of the graph</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    qubit_0: cudaq.qubit</span>
+<span class="sd">        Qubit representing the first vertex of an edge</span>
+<span class="sd">    qubit_1: cudaq.qubit</span>
+<span class="sd">        Qubit representing the second vertex of an edge</span>
+<span class="sd">    thetas: List[float]</span>
+<span class="sd">        Free variable</span>
+
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    cudaq.Kernel</span>
+<span class="sd">        Subcircuit of the problem kernel for Max-Cut of the graph with a given edge</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">,</span> <span class="n">qubit_1</span><span class="p">)</span>
+    <span class="n">rz</span><span class="p">(</span><span class="mf">2.0</span> <span class="o">*</span> <span class="n">alpha</span><span class="p">,</span> <span class="n">qubit_1</span><span class="p">)</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubit_0</span><span class="p">,</span> <span class="n">qubit_1</span><span class="p">)</span>
+
+
+<span class="c1"># We now define the kernel_qaoa function which will be the QAOA circuit for our graph</span>
+<span class="c1"># Since the QAOA circuit for max cut depends on the structure of the graph,</span>
+<span class="c1"># we&#39;ll feed in global concrete variable values into the kernel_qaoa function for the qubit_count, layer_count, edges_src, edges_tgt.</span>
+<span class="c1"># The types for these variables are restricted to Quake Values (e.g. qubit, int, List[int], ...)</span>
+<span class="c1"># The thetas plaeholder will be our free parameters</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel_qaoa</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">layer_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">edges_src</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+                <span class="n">edges_tgt</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span> <span class="n">thetas</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Build the QAOA circuit for max cut of the graph with given edges and nodes</span>
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    qubit_count: int</span>
+<span class="sd">        Number of qubits in the circuit, which is the same as the number of nodes in our graph</span>
+<span class="sd">    layer_count : int</span>
+<span class="sd">        Number of layers in the QAOA kernel</span>
+<span class="sd">    edges_src: List[int]</span>
+<span class="sd">        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes</span>
+<span class="sd">    edges_tgt: List[int]</span>
+<span class="sd">        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes</span>
+<span class="sd">    thetas: List[float]</span>
+<span class="sd">        Free variables to be optimized</span>
+
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    cudaq.Kernel</span>
+<span class="sd">        QAOA circuit for Max-Cut for max cut of the graph with given edges and nodes</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="c1"># Let&#39;s allocate the qubits</span>
+    <span class="n">qreg</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="c1"># And then place the qubits in superposition</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qreg</span><span class="p">)</span>
+
+    <span class="c1"># Each layer has two components: the problem kernel and the mixer</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">layer_count</span><span class="p">):</span>
+        <span class="c1"># Add the problem kernel to each layer</span>
+        <span class="k">for</span> <span class="n">edge</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">edges_src</span><span class="p">)):</span>
+            <span class="n">qubitu</span> <span class="o">=</span> <span class="n">edges_src</span><span class="p">[</span><span class="n">edge</span><span class="p">]</span>
+            <span class="n">qubitv</span> <span class="o">=</span> <span class="n">edges_tgt</span><span class="p">[</span><span class="n">edge</span><span class="p">]</span>
+            <span class="n">qaoaProblem</span><span class="p">(</span><span class="n">qreg</span><span class="p">[</span><span class="n">qubitu</span><span class="p">],</span> <span class="n">qreg</span><span class="p">[</span><span class="n">qubitv</span><span class="p">],</span> <span class="n">thetas</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="c1"># Add the mixer kernel to each layer</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+            <span class="n">rx</span><span class="p">(</span><span class="mf">2.0</span> <span class="o">*</span> <span class="n">thetas</span><span class="p">[</span><span class="n">i</span> <span class="o">+</span> <span class="n">layer_count</span><span class="p">],</span> <span class="n">qreg</span><span class="p">[</span><span class="n">j</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<p>As mentioned earlier, QAOA is a variational algorithm that aims to minimize a cost function. To apply QAOA to the max cut problem, we assign a binary variable <span class="math notranslate nohighlight">\(z_v\)</span> to each vertex <span class="math notranslate nohighlight">\(v\)</span>. These variables will take on the vales <span class="math notranslate nohighlight">\(-1\)</span> or <span class="math notranslate nohighlight">\(1\)</span>. Notice that an assignment of variable values corresponds to a partition of the graph. For example, <span class="math notranslate nohighlight">\(\bar z = [-1, 1, -1, 1, 1]\)</span> would partition the graph into two sets: <span class="math notranslate nohighlight">\(\{0,2\}\)</span> and <span class="math notranslate nohighlight">\(\{1,3,4\}.\)</span> We can compute the cut
+value of the graph for an arbirtrary assignment of variable values by the formula:</p>
+<div class="math notranslate nohighlight">
+\[C(\bar{z})= \frac{1}{2} \sum_{(u,v)\in E} (1-z_uz_v),\]</div>
+<p>where <span class="math notranslate nohighlight">\(E\)</span> is the set of edges of our graph. Our goal is to find a variable assignment that maximizes <span class="math notranslate nohighlight">\(C(\bar z)\)</span>. Equivalently, we want to find a variable assignment that minimizes <span class="math notranslate nohighlight">\(-C(\bar z)\)</span>. Since QAOA identifies minimum values, we have reframed the max cut optimization problem from one of maximization to minimization. Furthermore, we can promote this equation to a matrix equation by replacing <span class="math notranslate nohighlight">\(z_uz_v-1\)</span> with Pauli-Z operators acting on qubits associated with nodes
+<span class="math notranslate nohighlight">\(u\)</span> and <span class="math notranslate nohighlight">\(v\)</span>, respectively, and replacing 1 with the identity matrix. This leads to the reformulation of the problem from one of maximizing <span class="math notranslate nohighlight">\(C(\bar{z})\)</span> to one of minimizing the eigenvalues of</p>
+<div class="math notranslate nohighlight">
+\[H= \frac{1}{2}\sum_{(u,v)\in E} (Z_uZ_v-II).\]</div>
+<p>We can code this Hamiltonian using the <code class="docutils literal notranslate"><span class="pre">cudaq.spin</span></code> operators.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># The problem Hamiltonian</span>
+<span class="c1"># Define a function to generate the Hamiltonian for a max cut problem using the graph</span>
+<span class="c1"># with the given edges</span>
+
+
+<span class="k">def</span> <span class="nf">hamiltonian_max_cut</span><span class="p">(</span><span class="n">edges_src</span><span class="p">,</span> <span class="n">edges_tgt</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Hamiltonian for finding the max cut for the graph with given edges and nodes</span>
+
+<span class="sd">    Parameters</span>
+<span class="sd">    ----------</span>
+<span class="sd">    edges_src: List[int]</span>
+<span class="sd">        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes</span>
+<span class="sd">    edges_tgt: List[int]</span>
+<span class="sd">        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes</span>
+
+<span class="sd">    Returns</span>
+<span class="sd">    -------</span>
+<span class="sd">    cudaq.SpinOperator</span>
+<span class="sd">        Hamiltonian for finding the max cut of the graph with given edges</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="n">hamiltonian</span> <span class="o">=</span> <span class="mi">0</span>
+
+    <span class="k">for</span> <span class="n">edge</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">edges_src</span><span class="p">)):</span>
+
+        <span class="n">qubitu</span> <span class="o">=</span> <span class="n">edges_src</span><span class="p">[</span><span class="n">edge</span><span class="p">]</span>
+        <span class="n">qubitv</span> <span class="o">=</span> <span class="n">edges_tgt</span><span class="p">[</span><span class="n">edge</span><span class="p">]</span>
+        <span class="c1"># Add a term to the Hamiltonian for the edge (u,v)</span>
+        <span class="n">hamiltonian</span> <span class="o">+=</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="p">(</span><span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">qubitu</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="n">qubitv</span><span class="p">)</span> <span class="o">-</span>
+                              <span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">qubitu</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">i</span><span class="p">(</span><span class="n">qubitv</span><span class="p">))</span>
+
+    <span class="k">return</span> <span class="n">hamiltonian</span>
+</pre></div>
+</div>
+</div>
+<p>To inititiate the QAOA algorithm, we need to identify initial parameters and specify the classical optimization routine.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Specify the optimizer and its initial parameters.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_random_seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">NelderMead</span><span class="p">()</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>
+<span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">8</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">8</span><span class="p">,</span>
+                                                 <span class="n">parameter_count</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Initial parameters = &quot;</span><span class="p">,</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064]
+</pre></div></div>
+</div>
+<p>We can either use the <code class="docutils literal notranslate"><span class="pre">observe</span></code> primitive or the <code class="docutils literal notranslate"><span class="pre">vqe</span></code> primitive to code up the optimization loop of QAOA.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1">#cudaq.set_target(&#39;nvidia&#39;)</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;qpp-cpu&#39;</span><span class="p">)</span>
+
+<span class="c1"># Generate the Hamiltonian for our graph</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="n">hamiltonian_max_cut</span><span class="p">(</span><span class="n">edges_src</span><span class="p">,</span> <span class="n">edges_tgt</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">hamiltonian</span><span class="p">)</span>
+
+<span class="c1"># Define the objective, return `&lt;state(params) | H | state(params)&gt;`</span>
+<span class="c1"># Note that in the `observe` call we list the kernel, the hamiltonian, and then the concrete global variable values of our kernel</span>
+<span class="c1"># followed by the parameters to be optimized.</span>
+
+
+<span class="k">def</span> <span class="nf">objective</span><span class="p">(</span><span class="n">parameters</span><span class="p">):</span>
+    <span class="k">return</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel_qaoa</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">layer_count</span><span class="p">,</span>
+                         <span class="n">edges_src</span><span class="p">,</span> <span class="n">edges_tgt</span><span class="p">,</span> <span class="n">parameters</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+
+<span class="c1"># Optimize!</span>
+<span class="n">optimal_expectation</span><span class="p">,</span> <span class="n">optimal_parameters</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span>
+    <span class="n">dimensions</span><span class="o">=</span><span class="n">parameter_count</span><span class="p">,</span> <span class="n">function</span><span class="o">=</span><span class="n">objective</span><span class="p">)</span>
+
+<span class="c1"># Alternatively we can use the vqe call (just comment out the above code and uncomment the code below)</span>
+<span class="c1"># optimal_expectation, optimal_parameters = cudaq.vqe(</span>
+<span class="c1">#    kernel=kernel_qaoa,</span>
+<span class="c1">#    spin_operator=hamiltonian,</span>
+<span class="c1">#    argument_mapper=lambda parameter_vector: (qubit_count, layer_count, edges_src, edges_tgt, parameter_vector),</span>
+<span class="c1">#    optimizer=optimizer,</span>
+<span class="c1">#    parameter_count=parameter_count)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;optimal_expectation =&#39;</span><span class="p">,</span> <span class="n">optimal_expectation</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Therefore, the max cut value is at least &#39;</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span> <span class="o">*</span> <span class="n">optimal_expectation</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;optimal_parameters =&#39;</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[0.5+0j] IIZIZ
+[0.5+0j] IZZII
+[-3+0j] IIIII
+[0.5+0j] ZZIII
+[0.5+0j] IIIZZ
+[0.5+0j] IIZZI
+[0.5+0j] ZIIZI
+
+optimal_expectation = -4.495973826282007
+Therefore, the max cut value is at least  4.495973826282007
+optimal_parameters = [0.51349181993727, -0.21299416361632417, 0.3250526425808945, 0.886630847343767]
+</pre></div></div>
+</div>
+<p>Now that we have identified the optimal parameters, we can read out the partitioning(s) that gives us a max cut of the graph using the <code class="docutils literal notranslate"><span class="pre">sample</span></code> primitive.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Sample the circuit using the optimized parameters</span>
+<span class="c1"># Since our kernel has more than one argument, we need to list the values for each of these variables in order in the `sample` call.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel_qaoa</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">layer_count</span><span class="p">,</span> <span class="n">edges_src</span><span class="p">,</span>
+                      <span class="n">edges_tgt</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+
+<span class="c1"># Identify the most likely outcome from the sample</span>
+<span class="n">max_cut</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">counts</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">counts</span><span class="p">[</span><span class="n">x</span><span class="p">])</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;The max cut is given by the partition: &#39;</span><span class="p">,</span>
+      <span class="nb">max</span><span class="p">(</span><span class="n">counts</span><span class="p">,</span> <span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">counts</span><span class="p">[</span><span class="n">x</span><span class="p">]))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{ 11111:4 11110:1 01101:2 01010:148 01110:47 01000:3 00110:54 10101:165 00101:2 01011:154 00100:3 01001:41 00000:1 00011:3 01100:8 10011:7 00010:2 01111:2 11011:3 00111:10 11100:7 10001:65 10010:7 10100:144 10110:40 10000:5 10111:3 11000:7 11101:1 11001:59 11010:2 }
+
+The max cut is given by the partition:  10101
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">__version__</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)
+</pre></div></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="vqe.html" class="btn btn-neutral float-left" title="Variational Quantum Eigensolver" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hadamard_test.html" class="btn btn-neutral float-right" title="Hadamard Test and Application" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/qaoa.ipynb b/pr-2241/examples/python/tutorials/qaoa.ipynb
new file mode 100644
index 0000000000..b064182dd6
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/qaoa.ipynb
@@ -0,0 +1,376 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Max-Cut with QAOA\n",
+    "\n",
+    "[Farhi et al.](https://arxiv.org/abs/1411.4028) introduced the quantum approximation optimization algorithm (QAOA) to solve optimization problems like the max cut problem. Before diving into the details of QAOA, we'll first define the max cut problem. \n",
+    "\n",
+    "[Max Cut](https://en.wikipedia.org/wiki/Maximum_cut) is the problem of finding a partition of a graph's nodes into two sets which maximizes the edges between the two sets. Although this problem is relatively easy to solve for graphs with few vertices, this problem is [NP-hard](https://en.wikipedia.org/wiki/NP-hardness#:~:text=7%20References-,Definition,complete%20problem%20G%20to%20H.). The max cut problem has a wide range of applications including [machine learning](https://jmlr.org/papers/volume14/wang13a/wang13a.pdf), [circuit design](https://math.mit.edu/research/highschool/primes/materials/2020/Hong-Lee-Wei.pdf) and [statistical physics](https://www.researchgate.net/publication/262162554_An_Application_of_Combinatorial_Optimization_to_Statistical_Physics_and_Circuit_Layout_Design), among others. Furthermore, the QAOA algorithm presented in this tutorial can be adapted to other related optimization problems with an even wider application field including [portfolio optimization](https://journals.aps.org/prresearch/pdf/10.1103/PhysRevResearch.4.043204) and [job shop scheduling](https://www.sciencedirect.com/science/article/pii/S0377221723002072), just to name a few.\n",
+    "\n",
+    "We take the convention that $G=(V,E)$ represents a graph with vertex set $V\\subseteq \\mathbb{N}$ and edge set $E\\subseteq V\\times V$. We use the terms vertex and node interchangeably.  For this tutorial we assume that the graphs are undirected (that is, $(u,v)$ and $(v,u)$ represent the same edge). Our graphs contain no self loops (i.e., for every vertex $v$, there is no edge $(v,v)$). A *cut* of the graph $G$ is a partition, $(V_0,V_1)$, of the vertex set such that every vertex of $V$ is a member of exactly one of $V_0$ or $V_1$ (i.e., $V_0\\bigcup V_1 = V$ and $V_0\\bigcap V_0=\\emptyset$). The *cut value* for a partition is the sum of the edges with one node in $V_0$ and one node in $V_1$.\n",
+    "\n",
+    "In the images below, we illustrate two cuts of a graph with the dotted lines. Each of these cuts partitions the graph into two disjoint sets. The cut on the left is not optimal, and the cut on the right is the max cut. The cut on the left divides the graph into disjoint sets $\\{1,2\\}$ and $\\{0,3,4\\}$, and that cut contains 3 edges. To more easily visualize the cut, we have colored the vertices in one set of the partition green and the vertices in the other set of the partition gray.\n",
+    "The cut depicted in the diagram on the right divides the graph vertices into two disjoint sets $V_0=\\{0,2\\}$, colored gray, and $V_1=\\{1,3,4\\}$, colored green. The number of edges connecting vertices in the distinct sets is computed by $$\\sum_{\\substack{u \\in V_0; v\\in V_1\\\\ (u,v) \\in E}}1.$$ For the graph on the right, the number of edges in the cut (in this case there are $5$ edges) is maximal, and this value is referred to as the *max cut value*. The partitioning $(V_0,V_1)$  &mdash; and sometimes the set of edges connecting vertices in $V_0$ and $V_1$  &mdash; is referred to as a *max cut of a graph*. Note that the max cut of a graph need not be unique; that is, two distinct partitions may produce the same cut value.\n",
+    " \n",
+    "![](images/max-cut-illustration.png)\n",
+    " \n",
+    "We will use bitstrings to identify vertices in each of the two partitions. For example using the ordering of the vertices, the bitstring `01100` captures the partition in the image above on the left with vertices $1$ and $2$ in $V_1$, and the bitstring `01011` codes the partition in the image on the right with vertices $1$, $3$, and $4$ in $V_1$.\n",
+    "\n",
+    "Let's code our graph data as lists of integers so that we can call these variables when we create the `cudaq.kernel` for QAOA. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "from typing import List\n",
+    "\n",
+    "# We'll use the graph below to illustrate how QAOA can be used to\n",
+    "# solve a max cut problem\n",
+    "\n",
+    "#       v1  0--------------0 v2\n",
+    "#           |              | \\\n",
+    "#           |              |  \\\n",
+    "#           |              |   \\\n",
+    "#           |              |    \\\n",
+    "#       v0  0--------------0 v3-- 0 v4\n",
+    "# The max cut solutions are 01011, 10100, 01010, 10101 .\n",
+    "\n",
+    "# First we define the graph nodes (i.e., vertices) and edges as lists of integers so that they can be broadcast into\n",
+    "# a cudaq.kernel.\n",
+    "nodes: List[int] = [0, 1, 2, 3, 4]\n",
+    "edges = [[0, 1], [1, 2], [2, 3], [3, 0], [2, 4], [3, 4]]\n",
+    "edges_src: List[int] = [edges[i][0] for i in range(len(edges))]\n",
+    "edges_tgt: List[int] = [edges[i][1] for i in range(len(edges))]"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "QAOA is a variational algortihm with a particular ansatz. QAOA is made up of a variational quantum circuit (i.e., a kernel that depends on a set of parameter values) and a classical optimizer. The aim of QAOA is to use the classical optimizer to identify parameter values that generate a quantum circuit whose expectation value for a given cost Hamilitonian is minimized. \n",
+    "\n",
+    "What distinguishes QAOA from other variational algorithms is the structure of the quantum circuit. For each vertex in the graph, there is an associated qubit in the circuit. The circuit is initialized in a superposition state. The remainder of the QAOA circuit is made up of blocks (referred to as layers). The more layers there are, the better the approximation the algorithm achieves.\n",
+    "\n",
+    "![diagram of QAOA circuit layers](images/qaoa-circuit-layers.png)\n",
+    "\n",
+    "\n",
+    "\n",
+    "Each layer contains a problem kernel and a mixer kernel. The mixer kernel is composed of parameterized rotation gates applied to each qubit, depicted in green in the image above. The problem kernel encodes the graph edges. The image below shows an example of an graph edge encoded with controlled-X gates and a parameterized rotation gate.\n",
+    "\n",
+    "![diagram of a QAOA problem kernel for a max cut problem](images/qaoa-problem-kernel.png)\n",
+    "\n",
+    "Let's implement the QAOA circuit for our max cut problem in CUDA-Q."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Problem parameters\n",
+    "# The number of qubits we'll need is the same as the number of vertices in our graph\n",
+    "qubit_count: int = len(nodes)\n",
+    "\n",
+    "# We can set the layer count to be any positive integer.  Larger values will create deeper circuits\n",
+    "layer_count: int = 2\n",
+    "\n",
+    "# Each layer of the QAOA kernel contains 2 parameters\n",
+    "parameter_count: int = 2 * layer_count\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def qaoaProblem(qubit_0: cudaq.qubit, qubit_1: cudaq.qubit, alpha: float):\n",
+    "    \"\"\"Build the QAOA gate sequence between two qubits that represent an edge of the graph\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    qubit_0: cudaq.qubit \n",
+    "        Qubit representing the first vertex of an edge\n",
+    "    qubit_1: cudaq.qubit \n",
+    "        Qubit representing the second vertex of an edge\n",
+    "    thetas: List[float]\n",
+    "        Free variable   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.Kernel\n",
+    "        Subcircuit of the problem kernel for Max-Cut of the graph with a given edge\n",
+    "    \"\"\"\n",
+    "    x.ctrl(qubit_0, qubit_1)\n",
+    "    rz(2.0 * alpha, qubit_1)\n",
+    "    x.ctrl(qubit_0, qubit_1)\n",
+    "\n",
+    "\n",
+    "# We now define the kernel_qaoa function which will be the QAOA circuit for our graph\n",
+    "# Since the QAOA circuit for max cut depends on the structure of the graph,\n",
+    "# we'll feed in global concrete variable values into the kernel_qaoa function for the qubit_count, layer_count, edges_src, edges_tgt.\n",
+    "# The types for these variables are restricted to Quake Values (e.g. qubit, int, List[int], ...)\n",
+    "# The thetas plaeholder will be our free parameters\n",
+    "@cudaq.kernel\n",
+    "def kernel_qaoa(qubit_count: int, layer_count: int, edges_src: List[int],\n",
+    "                edges_tgt: List[int], thetas: List[float]):\n",
+    "    \"\"\"Build the QAOA circuit for max cut of the graph with given edges and nodes\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    qubit_count: int \n",
+    "        Number of qubits in the circuit, which is the same as the number of nodes in our graph\n",
+    "    layer_count : int \n",
+    "        Number of layers in the QAOA kernel\n",
+    "    edges_src: List[int]\n",
+    "        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    edges_tgt: List[int]\n",
+    "        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    thetas: List[float]\n",
+    "        Free variables to be optimized   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.Kernel\n",
+    "        QAOA circuit for Max-Cut for max cut of the graph with given edges and nodes\n",
+    "    \"\"\"\n",
+    "    # Let's allocate the qubits\n",
+    "    qreg = cudaq.qvector(qubit_count)\n",
+    "    # And then place the qubits in superposition\n",
+    "    h(qreg)\n",
+    "\n",
+    "    # Each layer has two components: the problem kernel and the mixer\n",
+    "    for i in range(layer_count):\n",
+    "        # Add the problem kernel to each layer\n",
+    "        for edge in range(len(edges_src)):\n",
+    "            qubitu = edges_src[edge]\n",
+    "            qubitv = edges_tgt[edge]\n",
+    "            qaoaProblem(qreg[qubitu], qreg[qubitv], thetas[i])\n",
+    "        # Add the mixer kernel to each layer\n",
+    "        for j in range(qubit_count):\n",
+    "            rx(2.0 * thetas[i + layer_count], qreg[j])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "As mentioned earlier, QAOA is a variational algorithm that aims to minimize a cost function. To apply QAOA to the max cut problem, we assign a binary variable $z_v$ to each vertex $v$. These variables will take on the vales $-1$ or $1$. Notice that an assignment of variable values corresponds to a partition of the graph.  For example, $\\bar z = [-1, 1, -1, 1, 1]$ would partition the graph into two sets: $\\{0,2\\}$ and $\\{1,3,4\\}.$ We can compute the cut value of the graph for an arbirtrary assignment of variable values by the formula: $$C(\\bar{z})= \\frac{1}{2} \\sum_{(u,v)\\in E} (1-z_uz_v),$$ where $E$ is the set of edges of our graph.  Our goal is to find a variable assignment that maximizes $C(\\bar z)$.  Equivalently, we want to find a variable assignment that minimizes $-C(\\bar z)$. Since QAOA identifies minimum values, we have reframed the max cut optimization problem from one of maximization to minimization. Furthermore, we can promote this equation to a matrix equation by replacing $z_uz_v-1$ with Pauli-Z operators acting on qubits associated with nodes $u$ and $v$, respectively, and replacing 1 with the identity matrix. This leads to the reformulation of the problem from one of maximizing $C(\\bar{z})$ to one of minimizing the eigenvalues of $$H= \\frac{1}{2}\\sum_{(u,v)\\in E} (Z_uZ_v-II).$$  \n",
+    "\n",
+    "We can code this Hamiltonian using the `cudaq.spin` operators."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The problem Hamiltonian\n",
+    "# Define a function to generate the Hamiltonian for a max cut problem using the graph\n",
+    "# with the given edges\n",
+    "\n",
+    "\n",
+    "def hamiltonian_max_cut(edges_src, edges_tgt):\n",
+    "    \"\"\"Hamiltonian for finding the max cut for the graph with given edges and nodes\n",
+    "        \n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    edges_src: List[int]\n",
+    "        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    edges_tgt: List[int]\n",
+    "        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.SpinOperator\n",
+    "        Hamiltonian for finding the max cut of the graph with given edges \n",
+    "    \"\"\"\n",
+    "\n",
+    "    hamiltonian = 0\n",
+    "\n",
+    "    for edge in range(len(edges_src)):\n",
+    "\n",
+    "        qubitu = edges_src[edge]\n",
+    "        qubitv = edges_tgt[edge]\n",
+    "        # Add a term to the Hamiltonian for the edge (u,v)\n",
+    "        hamiltonian += 0.5 * (spin.z(qubitu) * spin.z(qubitv) -\n",
+    "                              spin.i(qubitu) * spin.i(qubitv))\n",
+    "\n",
+    "    return hamiltonian"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To inititiate the QAOA algorithm, we need to identify initial parameters and specify the classical optimization routine."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Specify the optimizer and its initial parameters.\n",
+    "cudaq.set_random_seed(13)\n",
+    "optimizer = cudaq.optimizers.NelderMead()\n",
+    "np.random.seed(13)\n",
+    "optimizer.initial_parameters = np.random.uniform(-np.pi / 8, np.pi / 8,\n",
+    "                                                 parameter_count)\n",
+    "print(\"Initial parameters = \", optimizer.initial_parameters)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can either use the `observe` primitive or the `vqe` primitive to code up the optimization loop of QAOA."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[0.5+0j] IIZIZ\n",
+      "[0.5+0j] IZZII\n",
+      "[-3+0j] IIIII\n",
+      "[0.5+0j] ZZIII\n",
+      "[0.5+0j] IIIZZ\n",
+      "[0.5+0j] IIZZI\n",
+      "[0.5+0j] ZIIZI\n",
+      "\n",
+      "optimal_expectation = -4.495973826282007\n",
+      "Therefore, the max cut value is at least  4.495973826282007\n",
+      "optimal_parameters = [0.51349181993727, -0.21299416361632417, 0.3250526425808945, 0.886630847343767]\n"
+     ]
+    }
+   ],
+   "source": [
+    "#cudaq.set_target('nvidia')\n",
+    "cudaq.set_target('qpp-cpu')\n",
+    "\n",
+    "# Generate the Hamiltonian for our graph\n",
+    "hamiltonian = hamiltonian_max_cut(edges_src, edges_tgt)\n",
+    "print(hamiltonian)\n",
+    "\n",
+    "# Define the objective, return `<state(params) | H | state(params)>`\n",
+    "# Note that in the `observe` call we list the kernel, the hamiltonian, and then the concrete global variable values of our kernel\n",
+    "# followed by the parameters to be optimized.\n",
+    "\n",
+    "\n",
+    "def objective(parameters):\n",
+    "    return cudaq.observe(kernel_qaoa, hamiltonian, qubit_count, layer_count,\n",
+    "                         edges_src, edges_tgt, parameters).expectation()\n",
+    "\n",
+    "\n",
+    "# Optimize!\n",
+    "optimal_expectation, optimal_parameters = optimizer.optimize(\n",
+    "    dimensions=parameter_count, function=objective)\n",
+    "\n",
+    "# Alternatively we can use the vqe call (just comment out the above code and uncomment the code below)\n",
+    "# optimal_expectation, optimal_parameters = cudaq.vqe(\n",
+    "#    kernel=kernel_qaoa,\n",
+    "#    spin_operator=hamiltonian,\n",
+    "#    argument_mapper=lambda parameter_vector: (qubit_count, layer_count, edges_src, edges_tgt, parameter_vector),\n",
+    "#    optimizer=optimizer,\n",
+    "#    parameter_count=parameter_count)\n",
+    "\n",
+    "print('optimal_expectation =', optimal_expectation)\n",
+    "print('Therefore, the max cut value is at least ', -1 * optimal_expectation)\n",
+    "print('optimal_parameters =', optimal_parameters)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now that we have identified the optimal parameters, we can read out the partitioning(s) that gives us a max cut of the graph using the `sample` primitive."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11111:4 11110:1 01101:2 01010:148 01110:47 01000:3 00110:54 10101:165 00101:2 01011:154 00100:3 01001:41 00000:1 00011:3 01100:8 10011:7 00010:2 01111:2 11011:3 00111:10 11100:7 10001:65 10010:7 10100:144 10110:40 10000:5 10111:3 11000:7 11101:1 11001:59 11010:2 }\n",
+      "\n",
+      "The max cut is given by the partition:  10101\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Sample the circuit using the optimized parameters\n",
+    "# Since our kernel has more than one argument, we need to list the values for each of these variables in order in the `sample` call.\n",
+    "counts = cudaq.sample(kernel_qaoa, qubit_count, layer_count, edges_src,\n",
+    "                      edges_tgt, optimal_parameters)\n",
+    "print(counts)\n",
+    "\n",
+    "# Identify the most likely outcome from the sample\n",
+    "max_cut = max(counts, key=lambda x: counts[x])\n",
+    "print('The max cut is given by the partition: ',\n",
+    "      max(counts, key=lambda x: counts[x]))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/quantum_fourier_transform.html b/pr-2241/examples/python/tutorials/quantum_fourier_transform.html
new file mode 100644
index 0000000000..16dbf1e925
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/quantum_fourier_transform.html
@@ -0,0 +1,914 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quantum Fourier Transform &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Cost Minimization" href="cost_minimization.html" />
+    <link rel="prev" title="Deutsch’s Algorithm" href="deutschs_algorithm.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Quantum Fourier Transform</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/quantum_fourier_transform.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="deutschs_algorithm.html" class="btn btn-neutral float-left" title="Deutsch’s Algorithm" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cost_minimization.html" class="btn btn-neutral float-right" title="Cost Minimization" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Quantum-Fourier-Transform">
+<h1>Quantum Fourier Transform<a class="headerlink" href="#Quantum-Fourier-Transform" title="Permalink to this heading">¶</a></h1>
+<p>Classical Fourier transforms aid many areas such as signal processing and data compression. Below, we quantize it to enable Quantum Fourier Transforms (QFT) in CUDA-Q.</p>
+<p>QFT is a key ingredient in Shor’s algorithm which is exponentially faster at factoring prime numbers and also plays a vital role in many other interesting quantum algorithms.</p>
+<p>The idea with classical Fourier transforms is to take the problem from the frequency domain, to the time domain where it is easier to solve. This is the same analogy we draw with QFT, where we take the basis state from the computational basis to the Fourier basis.</p>
+<p>The Quantum Fourier Transform is defined to be the linear operation which takes a basis state, <span class="math notranslate nohighlight">\(\ket{x}\)</span>,</p>
+<div class="math notranslate nohighlight">
+\[\begin{equation}
+\text{QFT}\ket{x}  =   \frac{1}{\sqrt{N}}\sum_{y=0}^{N-1} e^{\frac{2\pi ixy}{N}} \ket{y}
+\tag{1}
+\end{equation}\]</div>
+<p>where <span class="math notranslate nohighlight">\(n\)</span> is the number of qubits and <span class="math notranslate nohighlight">\(N= 2^n\)</span>.</p>
+<p>It is convenient to represent states like <span class="math notranslate nohighlight">\(\ket{x} = \ket{101}\)</span> in their binary representation which in this case would be <span class="math notranslate nohighlight">\(2^2 \times 1 + 2^1 \times 0 + 2^0 \times 1 = \ket{5}\)</span>.</p>
+<p>For the <span class="math notranslate nohighlight">\(n=1\)</span> qubit case, we have the following basis states: <span class="math notranslate nohighlight">\(\ket{0}, \ket{1}\)</span>. The QFT on these is as follows:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{equation}
+\begin{aligned}
+\text{QFT}|0\rangle &amp;= \frac{1}{\sqrt{2}}\sum_{y=0}^{2-1} e^{\frac{2\pi i(0)y}{2}}|y\rangle \\
+&amp;= \frac{1}{\sqrt{2}}\left(e^0|0\rangle + e^0|1\rangle\right) \\
+&amp;= \frac{1}{\sqrt{2}}(|0\rangle + |1\rangle) \\
+&amp;= \ket{+} \\
+\end{aligned}
+\tag{2}
+\end{equation}\end{split}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{equation}
+\begin{aligned}
+\text{QFT}|1\rangle &amp;= \frac{1}{\sqrt{2}}\sum_{y=0}^{2-1} e^{\frac{2\pi i(1)y}{2}}|y\rangle \\
+&amp;= \frac{1}{\sqrt{2}}\left(e^0|0\rangle + e^{\pi i}|1\rangle\right) \\
+&amp;= \frac{1}{\sqrt{2}}(|0\rangle - |1\rangle) \\
+&amp;= \ket{-} \\
+\end{aligned}
+\tag{3}
+\end{equation}\end{split}\]</div>
+<p>To summarize, <span class="math notranslate nohighlight">\(\text{QFT}|0\rangle = \ket{+}\)</span> and <span class="math notranslate nohighlight">\(\text{QFT}|1\rangle = \ket{-}\)</span> which can be achieved by applying Hadamard gates.</p>
+<p>Let us now extend this and see how we can apply this to <span class="math notranslate nohighlight">\(n=3\)</span> qubits.</p>
+<p>For <span class="math notranslate nohighlight">\(n=3, N = 2^3 = 8\)</span> and we would like to perform <span class="math notranslate nohighlight">\(\text{QFT}|101\rangle\)</span> which in binary is <span class="math notranslate nohighlight">\(2^2 \times 1 + 2^1 \times 0 + 2^0 \times 1 = 5\)</span>:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{equation}
+\begin{aligned}
+\text{QFT}|101\rangle = \text{QFT}|5\rangle &amp;= \frac{1}{\sqrt{8}}\sum_{y=0}^{8-1} e^{\frac{2\pi i(5)y}{8}}|y\rangle \\
+&amp;= \frac{1}{\sqrt{8}} [ e^{0}\ket{0} + e^{\frac{5i\pi (1)}{4}}\ket{1}  + e^{\frac{5i\pi (2)}{4}}\ket{2} +...++ e^{\frac{5i\pi (7)}{4}}\ket{7} ]   \\
+&amp;= \frac{1}{\sqrt{8}} [ \ket{000} + e^{\frac{5i\pi (1)}{4}}\ket{001}  + e^{\frac{5i\pi (2)}{4}}\ket{010} +...++ e^{\frac{5i\pi (7)}{4}}\ket{111} ]   \\
+&amp;=  (0.35+0i) \ket{000} + (-0.25-0.25i)\ket{001}  + (0+0.35i)\ket{010} +...+ (-0.25+0.25i)\ket{111}    \\
+\end{aligned}
+\tag{4}
+\end{equation}\end{split}\]</div>
+<p>where we have used the fact that <span class="math notranslate nohighlight">\(e^{i\theta} = \cos(\theta) + i\sin(\theta).\)</span></p>
+<p>Here, we see how in addition to the Hadamard gates, we need some phase gates to apply the appropriate phases to the basis states. It turns out that the gate we need is the controlled <span class="math notranslate nohighlight">\(R_k\)</span> rotation where the <span class="math notranslate nohighlight">\(R_k\)</span> gate is denoted by:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{equation}
+R_k = \begin{bmatrix}
+1 &amp; 0 \\
+0 &amp; e^{2\pi i/ 2^{k}}
+\end{bmatrix}
+\tag{5}
+\end{equation}\end{split}\]</div>
+<p>Here is a generalized ciruit for a <span class="math notranslate nohighlight">\(n\)</span>-qubit quantum Fourier transform:</p>
+<p><img alt="qft" class="no-scaled-link" src="../../../_images/qft.png" style="width: 600px;" /></p>
+<p>Below we show the code for a QFT implementation in CUDA-Q based on the circuit diagram above:</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">quantum_fourier_transform</span><span class="p">(</span><span class="n">input_state</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+<span class="w">    </span><span class="sd">&#39;&#39;&#39;Args:</span>
+<span class="sd">    input_state (list[int]): specifies the input state to be Fourier transformed.  &#39;&#39;&#39;</span>
+
+    <span class="n">qubit_count</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">input_state</span><span class="p">)</span>
+
+    <span class="c1"># Initialize qubits.</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+
+    <span class="c1"># Initialize the quantum circuit to the initial state.</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+        <span class="k">if</span> <span class="n">input_state</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+    <span class="c1"># Apply Hadamard gates and controlled rotation gates.</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+        <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">):</span>
+            <span class="n">angle</span> <span class="o">=</span> <span class="p">(</span><span class="mi">2</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="p">(</span><span class="n">j</span> <span class="o">-</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">))</span>
+            <span class="n">cr1</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="p">[</span><span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">]],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1">#Can be changed to &#39;nvidia&#39; for single gpu, &#39;nvidia-mgpu&#39; for multi-GPU or quantum hardware.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;qpp-cpu&quot;</span><span class="p">)</span>
+
+<span class="c1"># The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.</span>
+<span class="n">input_state</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span>
+
+<span class="c1"># Number of decimal points to round up the statevector to.</span>
+<span class="n">precision</span> <span class="o">=</span> <span class="mi">2</span>
+
+<span class="c1"># Draw the quantum circuit.</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">quantum_fourier_transform</span><span class="p">,</span> <span class="n">input_state</span><span class="p">))</span>
+
+<span class="c1"># Print the statevector to the specified precision</span>
+<span class="n">statevector</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">quantum_fourier_transform</span><span class="p">,</span> <span class="n">input_state</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">round</span><span class="p">(</span><span class="n">statevector</span><span class="p">,</span> <span class="n">precision</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮╭───╮╭───────────╮╭────────────╮
+q0 : ┤ x ├┤ h ├┤ r1(1.571) ├┤ r1(0.7854) ├───────────────────────
+     ╰───╯╰───╯╰─────┬─────╯╰─────┬──────╯╭───╮╭───────────╮
+q1 : ────────────────●────────────┼───────┤ h ├┤ r1(1.571) ├─────
+     ╭───╮                        │       ╰───╯╰─────┬─────╯╭───╮
+q2 : ┤ x ├────────────────────────●──────────────────●──────┤ h ├
+     ╰───╯                                                  ╰───╯
+
+[ 0.35+0.j   -0.25-0.25j  0.  +0.35j  0.25-0.25j -0.35+0.j    0.25+0.25j
+ -0.  -0.35j -0.25+0.25j]
+</pre></div></div>
+</div>
+<p>We can verify that this is the correct answer as above we worked out that:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{equation}
+\begin{aligned}
+\text{QFT}|101\rangle = \text{QFT}|5\rangle &amp;= \frac{1}{\sqrt{8}}\sum_{y=0}^{8-1} e^{\frac{2\pi i(5)y}{8}}|y\rangle \\
+&amp;=  (0.35+0i) \ket{000} + (-0.25-0.25i)\ket{001}  + (0+0.35i)\ket{010} +...+ (-0.25+0.25i)\ket{111}.   \\
+\end{aligned}
+\tag{6}
+\end{equation}\end{split}\]</div>
+<p>Barring the gates used in the state preparation step, the circuit starts off by implementing a Hadamard gate and then <span class="math notranslate nohighlight">\(n-1\)</span> rotations on the zeroth qubit - a total of <span class="math notranslate nohighlight">\(n\)</span> gates. This is followed by a Hadamard and <span class="math notranslate nohighlight">\(n-2\)</span> conditional rotations on the first qubit which totals to <span class="math notranslate nohighlight">\(n -1\)</span> gates. If we continue the series, we get <span class="math notranslate nohighlight">\(n + (n-1) + (n-2)... = n(n+1)/2\)</span> gates. Hence, this circuit provides an algorithm with <span class="math notranslate nohighlight">\(O(n^2)\)</span> gates for computing the QFT.</p>
+<p>The best classical algorithms for computing fast Fourier transforms on <span class="math notranslate nohighlight">\(2^{n}\)</span> elements require <span class="math notranslate nohighlight">\(O(n2^{n})\)</span> gates. This means that it requires exponentially more operations to compute the fast Fourier transform on a classical computer than it does to implement the QFT on a quantum computer.</p>
+<p>Why are we not using QFT for real life applications then? The problem lies in quantum measurement. The quantum-Fourier-transformed amplitudes cannot be accessed by quantum measurement. However there are other quantum algorithms that do make use of QFT such as Shor’s algorithm.</p>
+<p>One can also invert the QFT where the circuit is executed in reverse with the inverse of each gate. The figure below shows the general <span class="math notranslate nohighlight">\(n\)</span>-qubit inverse QFT. Why don’t you try implementing this in CUDA-Q?</p>
+<p><img alt="qft" class="no-scaled-link" src="../../../_images/inverse_qft.png" style="width: 600px;" /></p>
+<section id="Quantum-Fourier-Transform-revisited">
+<h2>Quantum Fourier Transform revisited<a class="headerlink" href="#Quantum-Fourier-Transform-revisited" title="Permalink to this heading">¶</a></h2>
+<p>We provided one implementation of the Quantum Fourier Transform above. To demonstrate some of the other features of CUDA-Q, let’s define a new kernel for the Quantum Fourier Transform, which we’ll call <code class="docutils literal notranslate"><span class="pre">quantum_fourier_transform2</span></code>. Pay attention to how the kernel definition differs from the example above.</p>
+<p>Since the Quantum Fourier Transform is a unitary operator, its inverse is its adjoint. Therefore, once we have implemented the Quantum Fourier Transform as a kernel in CUDA-Q, we can use the built-in <code class="docutils literal notranslate"><span class="pre">adjoint</span></code> operation to create the Inverse Quantum Fourier Transform.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define kernels for the Quantum Fourier Transform and the Inverse Quantum Fourier Transform</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">quantum_fourier_transform2</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&#39;&#39;&#39;Args:</span>
+<span class="sd">    qubits (cudaq.qview): specifies the quantum register to which apply the QFT.&#39;&#39;&#39;</span>
+    <span class="n">qubit_count</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+    <span class="c1"># Apply Hadamard gates and controlled rotation gates.</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+        <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">):</span>
+            <span class="n">angle</span> <span class="o">=</span> <span class="p">(</span><span class="mi">2</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">)</span> <span class="o">/</span> <span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="p">(</span><span class="n">j</span> <span class="o">-</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">))</span>
+            <span class="n">cr1</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="p">[</span><span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">]],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">inverse_qft</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&#39;&#39;&#39;Args:</span>
+<span class="sd">    qubits (cudaq.qview): specifies the quantum register to which apply the inverse QFT.&#39;&#39;&#39;</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">adjoint</span><span class="p">(</span><span class="n">quantum_fourier_transform2</span><span class="p">,</span> <span class="n">qubits</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>Let’s see that this approach gives us the same results as the section above.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">verification_example</span><span class="p">(</span><span class="n">input_state</span> <span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+<span class="w">    </span><span class="sd">&#39;&#39;&#39;Args:</span>
+<span class="sd">    input_state (list[int]): specifies the input state to be transformed with QFT and the inverse QFT.  &#39;&#39;&#39;</span>
+    <span class="n">qubit_count</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">input_state</span><span class="p">)</span>
+    <span class="c1"># Initialize qubits.</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+
+    <span class="c1"># Initialize the quantum circuit to the initial state.</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+        <span class="k">if</span> <span class="n">input_state</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+    <span class="c1"># Apply the quantum Fourier Transform</span>
+    <span class="n">quantum_fourier_transform2</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+    <span class="c1"># Apply the inverse quantum Fourier Transform</span>
+    <span class="n">inverse_qft</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+<span class="c1"># The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.</span>
+<span class="n">input_state</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span>
+
+
+<span class="c1"># Number of decimal points to round up the statevector to.</span>
+<span class="n">precision</span> <span class="o">=</span> <span class="mi">2</span>
+
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">verification_example</span><span class="p">,</span> <span class="n">input_state</span><span class="p">))</span>
+
+<span class="c1"># Print the statevector to the specified precision</span>
+<span class="n">statevector</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">verification_example</span><span class="p">,</span> <span class="n">input_state</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">round</span><span class="p">(</span><span class="n">statevector</span><span class="p">,</span> <span class="n">precision</span><span class="p">))</span> <span class="c1"># The result should be the input state</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮╭───╮╭─────────╮╭──────────╮                                      »
+q0 : ┤ x ├┤ h ├┤ r1(1.5) ├┤ r1(0.75) ├──────────────────────────────────────»
+     ╰───╯╰───╯╰────┬────╯╰────┬─────╯╭───╮╭─────────╮          ╭──────────╮»
+q1 : ───────────────●──────────┼──────┤ h ├┤ r1(1.5) ├──────────┤ r1(-1.5) ├»
+     ╭───╮                     │      ╰───╯╰────┬────╯╭───╮╭───╮╰────┬─────╯»
+q2 : ┤ x ├─────────────────────●────────────────●─────┤ h ├┤ h ├─────●──────»
+     ╰───╯                                            ╰───╯╰───╯            »
+
+################################################################################
+
+     ╭───────────╮╭──────────╮╭───╮
+─────┤ r1(-0.75) ├┤ r1(-1.5) ├┤ h ├
+╭───╮╰─────┬─────╯╰────┬─────╯╰───╯
+┤ h ├──────┼───────────●───────────
+╰───╯      │
+───────────●───────────────────────
+
+
+[0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 1.-0.j 0.-0.j 0.+0.j]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">__version__</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)
+</pre></div></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="deutschs_algorithm.html" class="btn btn-neutral float-left" title="Deutsch’s Algorithm" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cost_minimization.html" class="btn btn-neutral float-right" title="Cost Minimization" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/quantum_fourier_transform.ipynb b/pr-2241/examples/python/tutorials/quantum_fourier_transform.ipynb
new file mode 100644
index 0000000000..deb1125fb7
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/quantum_fourier_transform.ipynb
@@ -0,0 +1,412 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Quantum Fourier Transform "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Classical Fourier transforms aid many areas such as signal processing and data compression. Below, we quantize it to enable Quantum Fourier Transforms (QFT) in CUDA-Q.\n",
+    "\n",
+    "QFT is a key ingredient in Shor's algorithm which is exponentially faster at factoring prime numbers and also plays a vital role in many other interesting quantum algorithms. \n",
+    "\n",
+    "The idea with classical Fourier transforms is to take the problem from the frequency domain, to the time domain where it is easier to solve. This is the same analogy we draw with QFT, where we take the basis state from the computational basis to the Fourier basis. "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The Quantum Fourier Transform is defined to be the linear operation which takes a basis state, $\\ket{x}$, \n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\text{QFT}\\ket{x}  =   \\frac{1}{\\sqrt{N}}\\sum_{y=0}^{N-1} e^{\\frac{2\\pi ixy}{N}} \\ket{y}\n",
+    "\\tag{1}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "where $n$ is the number of qubits and $N= 2^n$. \n",
+    "\n",
+    "It is convenient to represent states like $\\ket{x}  = \\ket{101}$ in their binary representation which in this case would be $2^2 \\times 1 + 2^1 \\times 0 + 2^0 \\times 1 = \\ket{5}$. \n",
+    "\n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "For the $n=1$ qubit case, we have the following basis states: $\\ket{0}, \\ket{1}$. The QFT on these is as follows: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|0\\rangle &= \\frac{1}{\\sqrt{2}}\\sum_{y=0}^{2-1} e^{\\frac{2\\pi i(0)y}{2}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}\\left(e^0|0\\rangle + e^0|1\\rangle\\right) \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}(|0\\rangle + |1\\rangle) \\\\\n",
+    "&= \\ket{+} \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{2}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|1\\rangle &= \\frac{1}{\\sqrt{2}}\\sum_{y=0}^{2-1} e^{\\frac{2\\pi i(1)y}{2}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}\\left(e^0|0\\rangle + e^{\\pi i}|1\\rangle\\right) \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}(|0\\rangle - |1\\rangle) \\\\\n",
+    "&= \\ket{-} \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{3}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "             \n",
+    "\n",
+    "To summarize, $\\text{QFT}|0\\rangle = \\ket{+}$ and $\\text{QFT}|1\\rangle = \\ket{-}$ which can be achieved by applying Hadamard gates. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "Let us now extend this and see how we can apply this to $n=3$ qubits. \n",
+    "\n",
+    "For $n=3, N = 2^3 = 8$ and we would like to perform $\\text{QFT}|101\\rangle$ which in binary is $2^2 \\times 1 + 2^1 \\times 0 + 2^0 \\times 1 = 5$: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|101\\rangle = \\text{QFT}|5\\rangle &= \\frac{1}{\\sqrt{8}}\\sum_{y=0}^{8-1} e^{\\frac{2\\pi i(5)y}{8}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{8}} [ e^{0}\\ket{0} + e^{\\frac{5i\\pi (1)}{4}}\\ket{1}  + e^{\\frac{5i\\pi (2)}{4}}\\ket{2} +...++ e^{\\frac{5i\\pi (7)}{4}}\\ket{7} ]   \\\\\n",
+    "&= \\frac{1}{\\sqrt{8}} [ \\ket{000} + e^{\\frac{5i\\pi (1)}{4}}\\ket{001}  + e^{\\frac{5i\\pi (2)}{4}}\\ket{010} +...++ e^{\\frac{5i\\pi (7)}{4}}\\ket{111} ]   \\\\\n",
+    "&=  (0.35+0i) \\ket{000} + (-0.25-0.25i)\\ket{001}  + (0+0.35i)\\ket{010} +...+ (-0.25+0.25i)\\ket{111}    \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{4}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "where we have used the fact that $e^{i\\theta} = \\cos(\\theta) + i\\sin(\\theta).$\n",
+    "\n",
+    "Here, we see how in addition to the Hadamard gates, we need some phase gates to apply the appropriate phases to the basis states. It turns out that the gate we need is the controlled $R_k$ rotation where the $R_k$ gate is denoted by:\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "R_k = \\begin{bmatrix}\n",
+    "1 & 0 \\\\\n",
+    "0 & e^{2\\pi i/ 2^{k}}\n",
+    "\\end{bmatrix}\n",
+    "\\tag{5}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "\n",
+    "Here is a generalized ciruit for a $n$-qubit quantum Fourier transform:"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "<img src=\"images/qft.png\" alt=\"qft\" width=\"600\">\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below we show the code for a QFT implementation in CUDA-Q based on the circuit diagram above: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "from typing import List\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform(input_state: List[int]):\n",
+    "    '''Args: \n",
+    "    input_state (list[int]): specifies the input state to be Fourier transformed.  '''\n",
+    "\n",
+    "    qubit_count = len(input_state)\n",
+    "\n",
+    "    # Initialize qubits.\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    # Initialize the quantum circuit to the initial state.\n",
+    "    for i in range(qubit_count):\n",
+    "        if input_state[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮╭───────────╮╭────────────╮                       \n",
+      "q0 : ┤ x ├┤ h ├┤ r1(1.571) ├┤ r1(0.7854) ├───────────────────────\n",
+      "     ╰───╯╰───╯╰─────┬─────╯╰─────┬──────╯╭───╮╭───────────╮     \n",
+      "q1 : ────────────────●────────────┼───────┤ h ├┤ r1(1.571) ├─────\n",
+      "     ╭───╮                        │       ╰───╯╰─────┬─────╯╭───╮\n",
+      "q2 : ┤ x ├────────────────────────●──────────────────●──────┤ h ├\n",
+      "     ╰───╯                                                  ╰───╯\n",
+      "\n",
+      "[ 0.35+0.j   -0.25-0.25j  0.  +0.35j  0.25-0.25j -0.35+0.j    0.25+0.25j\n",
+      " -0.  -0.35j -0.25+0.25j]\n"
+     ]
+    }
+   ],
+   "source": [
+    "#Can be changed to 'nvidia' for single gpu, 'nvidia-mgpu' for multi-GPU or quantum hardware.\n",
+    "cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "# The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.\n",
+    "input_state = [1, 0, 1]\n",
+    "\n",
+    "# Number of decimal points to round up the statevector to.\n",
+    "precision = 2\n",
+    "\n",
+    "# Draw the quantum circuit.\n",
+    "print(cudaq.draw(quantum_fourier_transform, input_state))\n",
+    "\n",
+    "# Print the statevector to the specified precision\n",
+    "statevector = np.array(cudaq.get_state(quantum_fourier_transform, input_state))\n",
+    "print(np.round(statevector, precision))"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can verify that this is the correct answer as above we worked out that: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|101\\rangle = \\text{QFT}|5\\rangle &= \\frac{1}{\\sqrt{8}}\\sum_{y=0}^{8-1} e^{\\frac{2\\pi i(5)y}{8}}|y\\rangle \\\\\n",
+    "&=  (0.35+0i) \\ket{000} + (-0.25-0.25i)\\ket{001}  + (0+0.35i)\\ket{010} +...+ (-0.25+0.25i)\\ket{111}.   \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{6}\n",
+    "\\end{equation}\n",
+    "$$\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Barring the gates used in the state preparation step, the circuit starts off by implementing a Hadamard gate and then $n-1$ rotations on the zeroth qubit - a total of $n$ gates. This is followed by a Hadamard and $n-2$ conditional rotations on the first qubit which totals to $n -1$ gates. If we continue the series, we get $n + (n-1) + (n-2)... = n(n+1)/2$ gates. Hence, this circuit provides an algorithm with $O(n^2)$ gates for computing the QFT. \n",
+    "\n",
+    "The best classical algorithms for computing fast Fourier transforms on $2^{n}$ elements require $O(n2^{n})$ gates. This means that it requires exponentially more operations to compute the fast Fourier transform on a classical computer than it does to implement the QFT on a quantum computer.\n",
+    "\n",
+    "Why are we not using QFT for real life applications then? The problem lies in quantum measurement. The quantum-Fourier-transformed amplitudes cannot be accessed by quantum measurement. However there are other quantum algorithms that do make use of QFT such as Shor's algorithm. \n",
+    "\n",
+    "One can also invert the QFT where the circuit is executed in reverse with the inverse of each gate. The figure below shows the general $n$-qubit inverse QFT. Why don't you try implementing this in CUDA-Q?\n",
+    "\n",
+    "<img src=\"images/inverse_qft.png\" alt=\"qft\" width=\"600\">\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum Fourier Transform revisited\n",
+    "We provided one implementation of the Quantum Fourier Transform above.  To demonstrate some of the other features of CUDA-Q, let's define a new kernel for the Quantum Fourier Transform, which we'll call `quantum_fourier_transform2`.  Pay attention to how the kernel definition differs from the example above.\n",
+    "\n",
+    " Since the Quantum Fourier Transform is a unitary operator, its inverse is its adjoint.  Therefore, once we have implemented the Quantum Fourier Transform as a kernel in CUDA-Q, we can use the built-in `adjoint` operation to create the Inverse Quantum Fourier Transform."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define kernels for the Quantum Fourier Transform and the Inverse Quantum Fourier Transform\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform2(qubits: cudaq.qview):\n",
+    "    '''Args: \n",
+    "    qubits (cudaq.qview): specifies the quantum register to which apply the QFT.'''\n",
+    "    qubit_count = len(qubits)\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])\n",
+    "            \n",
+    "@cudaq.kernel\n",
+    "def inverse_qft(qubits: cudaq.qview):\n",
+    "    '''Args: \n",
+    "    qubits (cudaq.qview): specifies the quantum register to which apply the inverse QFT.'''\n",
+    "    cudaq.adjoint(quantum_fourier_transform2, qubits)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's see that this approach gives us the same results as the section above. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮╭─────────╮╭──────────╮                                      »\n",
+      "q0 : ┤ x ├┤ h ├┤ r1(1.5) ├┤ r1(0.75) ├──────────────────────────────────────»\n",
+      "     ╰───╯╰───╯╰────┬────╯╰────┬─────╯╭───╮╭─────────╮          ╭──────────╮»\n",
+      "q1 : ───────────────●──────────┼──────┤ h ├┤ r1(1.5) ├──────────┤ r1(-1.5) ├»\n",
+      "     ╭───╮                     │      ╰───╯╰────┬────╯╭───╮╭───╮╰────┬─────╯»\n",
+      "q2 : ┤ x ├─────────────────────●────────────────●─────┤ h ├┤ h ├─────●──────»\n",
+      "     ╰───╯                                            ╰───╯╰───╯            »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "     ╭───────────╮╭──────────╮╭───╮\n",
+      "─────┤ r1(-0.75) ├┤ r1(-1.5) ├┤ h ├\n",
+      "╭───╮╰─────┬─────╯╰────┬─────╯╰───╯\n",
+      "┤ h ├──────┼───────────●───────────\n",
+      "╰───╯      │                       \n",
+      "───────────●───────────────────────\n",
+      "                                   \n",
+      "\n",
+      "[0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 1.-0.j 0.-0.j 0.+0.j]\n"
+     ]
+    }
+   ],
+   "source": [
+    "@cudaq.kernel\n",
+    "def verification_example(input_state : List[int]):\n",
+    "    '''Args: \n",
+    "    input_state (list[int]): specifies the input state to be transformed with QFT and the inverse QFT.  '''\n",
+    "    qubit_count = len(input_state)\n",
+    "    # Initialize qubits.\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    # Initialize the quantum circuit to the initial state.\n",
+    "    for i in range(qubit_count):\n",
+    "        if input_state[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "    \n",
+    "    # Apply the quantum Fourier Transform\n",
+    "    quantum_fourier_transform2(qubits)\n",
+    "\n",
+    "    # Apply the inverse quantum Fourier Transform\n",
+    "    inverse_qft(qubits)\n",
+    "\n",
+    "# The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.\n",
+    "input_state = [1, 0, 1]\n",
+    "\n",
+    "\n",
+    "# Number of decimal points to round up the statevector to.\n",
+    "precision = 2\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(verification_example, input_state))\n",
+    "\n",
+    "# Print the statevector to the specified precision\n",
+    "statevector = np.array(cudaq.get_state(verification_example, input_state))\n",
+    "print(np.round(statevector, precision)) # The result should be the input state"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/readout_error_mitigation.html b/pr-2241/examples/python/tutorials/readout_error_mitigation.html
new file mode 100644
index 0000000000..8a812e4799
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/readout_error_mitigation.html
@@ -0,0 +1,1373 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Readout Error Mitigation &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Water Molecule with Active Space (CPU vs. GPU)" href="vqe_water_active_space.html" />
+    <link rel="prev" title="Noisy Simulation" href="noisy_simulations.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Readout Error Mitigation</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/readout_error_mitigation.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="noisy_simulations.html" class="btn btn-neutral float-left" title="Noisy Simulation" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="vqe_water_active_space.html" class="btn btn-neutral float-right" title="Water Molecule with Active Space (CPU vs. GPU)" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Readout-Error-Mitigation">
+<h1>Readout Error Mitigation<a class="headerlink" href="#Readout-Error-Mitigation" title="Permalink to this heading">¶</a></h1>
+<p>Readout errors are caused by imperfect qubit measurement and are a common source of error in quantum computing. Properly modelling these errors in simulation can give the user tools to understand better what these errors are and how to mitigate them when running on actual quantum devices.</p>
+<p>Readout errors can be mitigated with a confusion matrix <span class="math notranslate nohighlight">\(A\)</span>. It is a square matrix of size <span class="math notranslate nohighlight">\(2^n \times 2^n\)</span> and tells about the probability of observing the state <span class="math notranslate nohighlight">\(|y\rangle\)</span> given the true state <span class="math notranslate nohighlight">\(|x\rangle\)</span>. The confusion matrix characterizes the readout error of the device and is circuit-independent. Once <span class="math notranslate nohighlight">\(A\)</span> is estimated, we can compute its pseudoinverse <span class="math notranslate nohighlight">\(A^+\)</span> which can be applied to the noisy probability distribution <span class="math notranslate nohighlight">\(p_{\text{noisy}}\)</span> to obtain an
+adjusted quasi-probability distribution</p>
+<div class="math notranslate nohighlight">
+\[p_{\text{mitigated}} = A^+ p_{\text{noisy}}\]</div>
+<p>In this tutorial, we show how to build a confusion matrix with the following approaches.</p>
+<ul class="simple">
+<li><p>Using a single qubit model</p></li>
+<li><p>Using <span class="math notranslate nohighlight">\(k\)</span> local confusion matrices</p></li>
+<li><p>A full confusion matrix for each <span class="math notranslate nohighlight">\(2^n\)</span> combination</p></li>
+</ul>
+<p>The last method works well for correcting correlated errors (which affect multiple qubits together). However, it becomes impractical for large numbers of qubits.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install the relevant packages.</span>
+
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">matplotlib</span><span class="o">==</span><span class="m">3</span>.8.4
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">pandas</span><span class="o">==</span><span class="m">2</span>.2.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">scipy</span><span class="o">==</span><span class="m">1</span>.13.1
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">seaborn</span><span class="o">==</span><span class="m">0</span>.13.2
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+<span class="kn">import</span> <span class="nn">seaborn</span> <span class="k">as</span> <span class="nn">sns</span>
+<span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
+<span class="kn">import</span> <span class="nn">itertools</span>
+<span class="kn">from</span> <span class="nn">functools</span> <span class="kn">import</span> <span class="n">reduce</span>
+<span class="kn">from</span> <span class="nn">scipy.optimize</span> <span class="kn">import</span> <span class="n">minimize</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+
+<span class="n">sns</span><span class="o">.</span><span class="n">set_style</span><span class="p">(</span><span class="s2">&quot;dark&quot;</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;density-matrix-cpu&quot;</span><span class="p">)</span>
+<span class="n">seed</span> <span class="o">=</span> <span class="mi">42</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_random_seed</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="n">seed</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>To model the readout error, we apply a bitflip channel on every qubit at the end of the circuit using an Identity gate. The probability of bitflip <code class="docutils literal notranslate"><span class="pre">probs</span></code> can be the same or different for all the qubits.</p>
+<div class="alert alert-block alert-success"><p>Note: In principle, readout error is applied to the measurement gate but we use the Identity gate because adding a quantum error on the measurement gate is not yet supported. Also, the Identity gate is not present in the add_channel method, so we model the Identity gate using a rotation gate with an angle of 0.0.</p>
+</div><div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_noise</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">probs</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">float</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">]]):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Creates a noise model with specified probabilities of bit flip errors on each qubit.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        n_qubits (int): The number of qubits in the quantum circuit.</span>
+<span class="sd">        probs (Union[float, list[float]]): Probabilities of a bit flip error occurring on each qubit.</span>
+<span class="sd">        If a single probability value is provided, it will be applied to all qubits. If a list of</span>
+<span class="sd">        probabilities is provided, each qubit will have its own probability.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        cudaq noise model</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">noise</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">probs</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
+        <span class="n">probs</span> <span class="o">=</span> <span class="p">[</span><span class="n">probs</span><span class="p">]</span> <span class="o">*</span> <span class="n">n_qubits</span>
+
+    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">p</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">probs</span><span class="p">):</span>
+        <span class="n">bit_flip</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">BitFlipChannel</span><span class="p">(</span><span class="n">p</span><span class="p">)</span>
+        <span class="n">noise</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s2">&quot;rx&quot;</span><span class="p">,</span> <span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">bit_flip</span><span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">noise</span>
+</pre></div>
+</div>
+</div>
+<p>We define a cudaq kernel which will help create a set of quantum circuits to take measurements of the basis states for <span class="math notranslate nohighlight">\(n\)</span> qubits. The kernel takes the number of qubits and the basis state as arguments.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">state_label</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">val</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">state_label</span><span class="p">):</span>
+        <span class="k">if</span> <span class="n">val</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="n">rx</span><span class="p">(</span>
+            <span class="mf">0.0</span><span class="p">,</span> <span class="n">qvector</span><span class="p">[</span><span class="n">i</span><span class="p">]</span>
+        <span class="p">)</span>  <span class="c1"># Identity gate at the end on each qubit to model readout error</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>For the tutorial, we will use the GHZ state on three qubits to test readout error mitigation. The GHZ state on 3 qubits is described as:</p>
+<div class="math notranslate nohighlight">
+\[\frac{|000\rangle + |111\rangle}{\sqrt{2}}\]</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">ghz_kernel</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">)</span>
+
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_qubits</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+        <span class="n">cx</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+
+    <span class="c1"># Apply identity gates for readout error mitigation</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">):</span>
+        <span class="n">rx</span><span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="n">qvector</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Function to draw the confusion matrix</span>
+<span class="k">def</span> <span class="nf">plot_cmat</span><span class="p">(</span><span class="n">mat</span><span class="p">):</span>
+    <span class="n">fig</span><span class="p">,</span> <span class="n">ax</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">subplots</span><span class="p">()</span>
+    <span class="n">n</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">mat</span><span class="p">)</span>
+    <span class="n">im2</span> <span class="o">=</span> <span class="n">ax</span><span class="o">.</span><span class="n">matshow</span><span class="p">(</span><span class="n">mat</span><span class="p">,</span> <span class="n">cmap</span><span class="o">=</span><span class="n">plt</span><span class="o">.</span><span class="n">cm</span><span class="o">.</span><span class="n">Reds</span><span class="p">,</span> <span class="n">vmin</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">vmax</span><span class="o">=</span><span class="mf">1.0</span><span class="p">)</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_yticks</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">arange</span><span class="p">(</span><span class="n">n</span><span class="p">))</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_xticks</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">arange</span><span class="p">(</span><span class="n">n</span><span class="p">))</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_yticklabels</span><span class="p">(</span><span class="n">n</span> <span class="o">*</span> <span class="p">[</span><span class="s2">&quot;&quot;</span><span class="p">])</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_xticklabels</span><span class="p">(</span><span class="n">n</span> <span class="o">*</span> <span class="p">[</span><span class="s2">&quot;&quot;</span><span class="p">])</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_title</span><span class="p">(</span><span class="sa">r</span><span class="s2">&quot;Confusion Matrix&quot;</span><span class="p">,</span> <span class="n">fontsize</span><span class="o">=</span><span class="mi">16</span><span class="p">)</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_xlabel</span><span class="p">(</span><span class="s2">&quot;Prepared State&quot;</span><span class="p">)</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">xaxis</span><span class="o">.</span><span class="n">set_label_position</span><span class="p">(</span><span class="s2">&quot;top&quot;</span><span class="p">)</span>
+    <span class="n">ax</span><span class="o">.</span><span class="n">set_ylabel</span><span class="p">(</span><span class="s2">&quot;Measured State&quot;</span><span class="p">)</span>
+    <span class="n">fig</span><span class="o">.</span><span class="n">colorbar</span><span class="p">(</span><span class="n">im2</span><span class="p">,</span> <span class="n">ax</span><span class="o">=</span><span class="n">ax</span><span class="p">)</span>
+    <span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<p>It is possible that the adjusted quasi-probability distribution <span class="math notranslate nohighlight">\(p_{\text{mitigated}}\)</span> obtained by application of <span class="math notranslate nohighlight">\(A^+\)</span> to <span class="math notranslate nohighlight">\(p_{\text{noisy}}\)</span> may be non-positive. We need to find the closest positive probability distribution in such a case.</p>
+<div class="math notranslate nohighlight">
+\[p'' = \min_{p_{\rm positive}} \|p_{\rm noisy} - p_{\rm positive}\|_1\]</div>
+<p>Then, we can draw samples from <span class="math notranslate nohighlight">\(p''\)</span>.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">find_closest_distribution</span><span class="p">(</span><span class="n">empirical_dist</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Find the closest distribution to an empirical distribution by minimizing the L1 norm.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        empirical_dist: Empirical distribution that you want to find the closest distribution to.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        Closest distribution to `empirical_dist`</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="k">def</span> <span class="nf">objective</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
+        <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">norm</span><span class="p">(</span><span class="n">empirical_dist</span> <span class="o">-</span> <span class="n">x</span><span class="p">,</span> <span class="nb">ord</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+
+    <span class="c1"># Constraint: all elements of p must be positive, and the distribution must sum to 1</span>
+    <span class="n">cons</span> <span class="o">=</span> <span class="p">(</span>
+        <span class="p">{</span><span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;ineq&quot;</span><span class="p">,</span> <span class="s2">&quot;fun&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">p</span><span class="p">:</span> <span class="n">p</span><span class="p">},</span>
+        <span class="p">{</span><span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;eq&quot;</span><span class="p">,</span> <span class="s2">&quot;fun&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">p</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">sum</span><span class="p">(</span><span class="n">p</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span><span class="p">},</span>
+    <span class="p">)</span>
+    <span class="n">bnds</span> <span class="o">=</span> <span class="p">[(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">empirical_dist</span><span class="p">))]</span>
+    <span class="n">initial_value</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="n">size</span><span class="o">=</span><span class="nb">len</span><span class="p">(</span><span class="n">empirical_dist</span><span class="p">))</span>
+
+    <span class="n">res</span> <span class="o">=</span> <span class="n">minimize</span><span class="p">(</span>
+        <span class="n">objective</span><span class="p">,</span>
+        <span class="n">initial_value</span><span class="p">,</span>
+        <span class="n">method</span><span class="o">=</span><span class="s2">&quot;SLSQP&quot;</span><span class="p">,</span>
+        <span class="n">options</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;maxiter&quot;</span><span class="p">:</span> <span class="mi">1000</span><span class="p">},</span>
+        <span class="n">bounds</span><span class="o">=</span><span class="n">bnds</span><span class="p">,</span>
+        <span class="n">constraints</span><span class="o">=</span><span class="n">cons</span><span class="p">,</span>
+    <span class="p">)</span>
+
+    <span class="k">return</span> <span class="n">res</span><span class="o">.</span><span class="n">x</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">get_counts_from_distribution</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">size</span><span class="p">,</span> <span class="n">dist</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Generates samples based on a given distribution and returns the counts of each sample value.</span>
+
+<span class="sd">    Args:</span>
+<span class="sd">        n_qubits: The number of qubits in the quantum circuit.</span>
+<span class="sd">        dist: The probability distribution from which samples are drawn.</span>
+
+<span class="sd">    Returns:</span>
+<span class="sd">        An array of counts for each possible value in the distribution. The array has a length of 2^n_qubits.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="n">samples</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">choice</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">arange</span><span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">n_qubits</span><span class="p">),</span> <span class="n">size</span><span class="o">=</span><span class="n">size</span><span class="p">,</span> <span class="n">p</span><span class="o">=</span><span class="n">dist</span><span class="p">)</span>
+    <span class="n">values</span><span class="p">,</span> <span class="n">counts</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">unique</span><span class="p">(</span><span class="n">samples</span><span class="p">,</span> <span class="n">return_counts</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+    <span class="n">res</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">int</span><span class="p">)</span>
+    <span class="n">res</span><span class="p">[</span><span class="n">values</span><span class="p">]</span> <span class="o">=</span> <span class="n">counts</span>
+    <span class="k">return</span> <span class="n">res</span>
+</pre></div>
+</div>
+</div>
+<p>Let’s run the <code class="docutils literal notranslate"><span class="pre">ghz_kernel</span></code> with the noise model. We will perform two experiments. First, we keep the bitflip probability the same for all the qubits. In the second experiment, we use different bitflip probabilities for qubits.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">n_qubits</span> <span class="o">=</span> <span class="mi">3</span>
+<span class="n">shots</span> <span class="o">=</span> <span class="mi">1024</span>
+
+<span class="n">labels</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">map</span><span class="p">(</span><span class="nb">list</span><span class="p">,</span> <span class="n">itertools</span><span class="o">.</span><span class="n">product</span><span class="p">([</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">],</span> <span class="n">repeat</span><span class="o">=</span><span class="n">n_qubits</span><span class="p">)))</span>
+<span class="n">states</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">map</span><span class="p">(</span><span class="k">lambda</span> <span class="n">label</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="nb">map</span><span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">label</span><span class="p">)),</span> <span class="n">labels</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="mf">0.1</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;bitflip probability: </span><span class="si">{</span><span class="n">p</span><span class="si">}</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="n">noise_1</span> <span class="o">=</span> <span class="n">get_noise</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">p</span><span class="p">)</span>
+
+<span class="n">ghz_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz_kernel</span><span class="p">,</span> <span class="n">n_qubits</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_1</span><span class="p">)</span>
+<span class="n">noisy_dict_1</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">ghz_result</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span>
+
+<span class="n">noisy_res_1</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="n">noisy_dict_1</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">state</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">states</span><span class="p">)])</span>
+
+<span class="n">noisy_dict_1</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+bitflip probability: 0.1
+
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{&#39;000&#39;: 352,
+ &#39;010&#39;: 43,
+ &#39;111&#39;: 367,
+ &#39;001&#39;: 47,
+ &#39;011&#39;: 47,
+ &#39;100&#39;: 54,
+ &#39;101&#39;: 61,
+ &#39;110&#39;: 53}
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">p</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="n">low</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span> <span class="n">high</span><span class="o">=</span><span class="mf">0.4</span><span class="p">,</span> <span class="n">size</span><span class="o">=</span><span class="n">n_qubits</span><span class="p">))</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;bitflip probability: </span><span class="si">{</span><span class="n">p</span><span class="si">}</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="n">noise_2</span> <span class="o">=</span> <span class="n">get_noise</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">p</span><span class="p">)</span>
+
+<span class="n">ghz_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz_kernel</span><span class="p">,</span> <span class="n">n_qubits</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_2</span><span class="p">)</span>
+<span class="n">noisy_dict_2</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">ghz_result</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span>
+
+<span class="n">noisy_res_2</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="n">noisy_dict_2</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">state</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">states</span><span class="p">)])</span>
+
+<span class="n">noisy_dict_2</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+bitflip probability: [0.149816047538945, 0.3802857225639665, 0.292797576724562]
+
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+{&#39;000&#39;: 212,
+ &#39;010&#39;: 122,
+ &#39;111&#39;: 189,
+ &#39;001&#39;: 111,
+ &#39;011&#39;: 87,
+ &#39;100&#39;: 78,
+ &#39;101&#39;: 131,
+ &#39;110&#39;: 94}
+</pre></div></div>
+</div>
+<section id="Inverse-confusion-matrix-from-single-qubit-noise-model">
+<h2>Inverse confusion matrix from single-qubit noise model<a class="headerlink" href="#Inverse-confusion-matrix-from-single-qubit-noise-model" title="Permalink to this heading">¶</a></h2>
+<p>Here we assume that the readout error of each qubit is independent with the same confusion probabilities. Then, the confusion matrix <span class="math notranslate nohighlight">\(A_1\)</span> for a single qubit can be defined as</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}A_1 = \begin{bmatrix}
+P(0|0) &amp; P(0|1)\\
+P(1|0) &amp; P(1|1)
+\end{bmatrix}\end{split}\]</div>
+<p>where <span class="math notranslate nohighlight">\(P(y|x)\)</span> is the probability of observing state <span class="math notranslate nohighlight">\(|y\rangle\)</span> when measuring the true state <span class="math notranslate nohighlight">\(|x\rangle\)</span>. Using <span class="math notranslate nohighlight">\(A_1\)</span>, the full <span class="math notranslate nohighlight">\(2^n \times 2^n\)</span> confusion matrix <span class="math notranslate nohighlight">\(A\)</span> can be written as</p>
+<div class="math notranslate nohighlight">
+\[A = A_1 \otimes \dots \otimes A_1\]</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[12]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">single_qubit_labels</span> <span class="o">=</span> <span class="p">[[</span><span class="mi">0</span><span class="p">],</span> <span class="p">[</span><span class="mi">1</span><span class="p">]]</span>
+<span class="n">single_qubit_states</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;0&quot;</span><span class="p">,</span> <span class="s2">&quot;1&quot;</span><span class="p">]</span>  <span class="c1"># Used for dictionary keys</span>
+
+<span class="c1"># we use noise_1 which has same bitflip probability for all qubits</span>
+<span class="n">results</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="n">label</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_1</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">label</span> <span class="ow">in</span> <span class="n">single_qubit_labels</span>
+<span class="p">]</span>
+
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">single_qubit_states</span><span class="p">):</span>
+    <span class="n">res</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">state</span><span class="si">}</span><span class="s2"> becomes </span><span class="si">{</span><span class="n">res</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+0 becomes {&#39;0&#39;: 924, &#39;1&#39;: 100}
+1 becomes {&#39;0&#39;: 104, &#39;1&#39;: 920}
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[13]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Construct confusion matrix for single qubit</span>
+
+<span class="n">A_1</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="mi">2</span><span class="p">,</span> <span class="mi">2</span><span class="p">))</span>
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">single_qubit_states</span><span class="p">):</span>
+    <span class="n">true_state</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">state</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">val</span> <span class="ow">in</span> <span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+        <span class="n">observed_state</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+        <span class="n">A_1</span><span class="p">[</span><span class="n">observed_state</span><span class="p">][</span><span class="n">true_state</span><span class="p">]</span> <span class="o">=</span> <span class="n">val</span> <span class="o">/</span> <span class="n">shots</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">A_1</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[[0.90234375 0.1015625 ]
+ [0.09765625 0.8984375 ]]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[14]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">A</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">kron</span><span class="p">,</span> <span class="p">[</span><span class="n">A_1</span><span class="p">]</span> <span class="o">*</span> <span class="n">n_qubits</span><span class="p">)</span>  <span class="c1"># joint confusion matrix</span>
+<span class="n">A_pinv</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">pinv</span><span class="p">(</span><span class="n">A</span><span class="p">)</span>  <span class="c1"># Generate pseudoinverse confusion matrix.</span>
+<span class="n">mitigated</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">dot</span><span class="p">(</span><span class="n">A_pinv</span><span class="p">,</span> <span class="n">noisy_res_1</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">int</span><span class="p">)</span>  <span class="c1"># Obtain mitigated counts</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Mitigated counts:</span><span class="se">\n</span><span class="si">{</span><span class="n">mitigated</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="k">if</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">all</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">&gt;=</span> <span class="mi">0</span><span class="p">):</span>
+    <span class="n">positive_dist</span> <span class="o">=</span> <span class="n">find_closest_distribution</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">/</span> <span class="n">shots</span><span class="p">)</span>
+    <span class="n">mitigated</span> <span class="o">=</span> <span class="n">get_counts_from_distribution</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">positive_dist</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">Corrected for negative counts:</span><span class="se">\n</span><span class="si">{</span><span class="n">mitigated</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Mitigated counts:
+[476   3   0   1  12  19   9 501]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[15]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">df</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span>
+    <span class="p">{</span>
+        <span class="s2">&quot;states&quot;</span><span class="p">:</span> <span class="n">states</span><span class="p">,</span>
+        <span class="s2">&quot;noisy&quot;</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">around</span><span class="p">(</span><span class="n">noisy_res_1</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">noisy_res_1</span><span class="p">),</span> <span class="mi">3</span><span class="p">),</span>
+        <span class="s2">&quot;mitigated_sg&quot;</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">around</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">mitigated</span><span class="p">),</span> <span class="mi">3</span><span class="p">),</span>
+    <span class="p">}</span>
+<span class="p">)</span>
+
+<span class="n">ax</span> <span class="o">=</span> <span class="n">df</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="s2">&quot;states&quot;</span><span class="p">,</span> <span class="n">y</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;noisy&quot;</span><span class="p">,</span> <span class="s2">&quot;mitigated_sg&quot;</span><span class="p">],</span> <span class="n">kind</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">,</span> <span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">8</span><span class="p">,</span> <span class="mi">5</span><span class="p">))</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;noisy&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;mitigated_sg&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">set_ylabel</span><span class="p">(</span><span class="s2">&quot;probabilities&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_readout_error_mitigation_21_0.png" src="../../../_images/examples_python_tutorials_readout_error_mitigation_21_0.png" />
+</div>
+</div>
+</section>
+<section id="Inverse-confusion-matrix-from-k-local-confusion-matrices">
+<h2>Inverse confusion matrix from k local confusion matrices<a class="headerlink" href="#Inverse-confusion-matrix-from-k-local-confusion-matrices" title="Permalink to this heading">¶</a></h2>
+<p>This method works under the assumption that the readout errors for different qubits are independent of each other and the confusion matrix <span class="math notranslate nohighlight">\(A\)</span> can be factorized into the product of <span class="math notranslate nohighlight">\(k\)</span> small local confusion matrices. We consider the special case when <span class="math notranslate nohighlight">\(k = n\)</span> for <span class="math notranslate nohighlight">\(n\)</span> qubits and different <span class="math notranslate nohighlight">\(2 \times 2\)</span> confusion matrices for each qubit</p>
+<div class="math notranslate nohighlight">
+\[A = A_1 \otimes \dots \otimes A_n\]</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[16]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">local_labels</span> <span class="o">=</span> <span class="p">[[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="n">n_qubits</span><span class="p">,</span> <span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">*</span> <span class="n">n_qubits</span><span class="p">]</span>
+<span class="n">local_states</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;0&quot;</span> <span class="o">*</span> <span class="n">n_qubits</span><span class="p">,</span> <span class="s2">&quot;1&quot;</span> <span class="o">*</span> <span class="n">n_qubits</span><span class="p">]</span>
+
+<span class="n">results</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">n_qubits</span><span class="p">,</span> <span class="n">label</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_2</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">label</span> <span class="ow">in</span> <span class="n">local_labels</span>
+<span class="p">]</span>
+
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">local_states</span><span class="p">):</span>
+    <span class="n">res</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">state</span><span class="si">}</span><span class="s2"> becomes </span><span class="si">{</span><span class="n">res</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+000 becomes {&#39;000&#39;: 388, &#39;010&#39;: 235, &#39;111&#39;: 18, &#39;001&#39;: 174, &#39;011&#39;: 79, &#39;100&#39;: 58, &#39;101&#39;: 28, &#39;110&#39;: 44}
+111 becomes {&#39;000&#39;: 23, &#39;010&#39;: 38, &#39;111&#39;: 370, &#39;001&#39;: 40, &#39;011&#39;: 60, &#39;100&#39;: 107, &#39;101&#39;: 224, &#39;110&#39;: 162}
+</pre></div></div>
+</div>
+<p>The local confusion matrices are generated using the marginal probability distribution for each qubit.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[17]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">counts</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">local_states</span><span class="p">)]</span>
+<span class="n">matrices</span> <span class="o">=</span> <span class="p">[]</span>
+
+<span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">):</span>
+    <span class="n">matrix</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">([</span><span class="mi">2</span><span class="p">,</span> <span class="mi">2</span><span class="p">],</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">float</span><span class="p">)</span>
+    <span class="n">marginalized_counts</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="n">total_shots</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">):</span>
+        <span class="n">marginal_cts</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">get_marginal_counts</span><span class="p">([</span><span class="n">k</span><span class="p">])</span><span class="o">.</span><span class="n">items</span><span class="p">())</span>
+        <span class="n">marginalized_counts</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">marginal_cts</span><span class="p">)</span>
+        <span class="n">total_shots</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">sum</span><span class="p">(</span><span class="n">marginal_cts</span><span class="o">.</span><span class="n">values</span><span class="p">()))</span>
+
+    <span class="c1"># matrix[i][j] is the probability of counting i for expected j</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">):</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">):</span>
+            <span class="n">matrix</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="n">j</span><span class="p">]</span> <span class="o">=</span> <span class="n">marginalized_counts</span><span class="p">[</span><span class="n">j</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">i</span><span class="p">),</span> <span class="mi">0</span><span class="p">)</span> <span class="o">/</span> <span class="n">total_shots</span><span class="p">[</span><span class="n">j</span><span class="p">]</span>
+    <span class="n">matrices</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">matrix</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[18]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="n">matrices</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">m</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[[0.85546875 0.15722656]
+ [0.14453125 0.84277344]]
+
+[[0.6328125  0.38476562]
+ [0.3671875  0.61523438]]
+
+[[0.70800781 0.32226562]
+ [0.29199219 0.67773438]]
+
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[19]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># To find the joint pseudoinverse confusion matrix, we can first perform pseudoinverse of the</span>
+<span class="c1"># local confusion matrices and then do the tensor product</span>
+
+<span class="n">pinv_confusion_matrices</span> <span class="o">=</span> <span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">pinv</span><span class="p">(</span><span class="n">m</span><span class="p">)</span> <span class="k">for</span> <span class="n">m</span> <span class="ow">in</span> <span class="n">matrices</span><span class="p">]</span>
+<span class="n">A_pinv</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">kron</span><span class="p">,</span> <span class="n">pinv_confusion_matrices</span><span class="p">)</span>
+
+<span class="n">mitigated</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">dot</span><span class="p">(</span><span class="n">A_pinv</span><span class="p">,</span> <span class="n">noisy_res_2</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">int</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Mitigated counts:</span><span class="se">\n</span><span class="si">{</span><span class="n">mitigated</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="k">if</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">all</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">&gt;=</span> <span class="mi">0</span><span class="p">):</span>
+    <span class="n">positive_dist</span> <span class="o">=</span> <span class="n">find_closest_distribution</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">/</span> <span class="n">shots</span><span class="p">)</span>
+    <span class="n">mitigated</span> <span class="o">=</span> <span class="n">get_counts_from_distribution</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">positive_dist</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">Corrected for negative counts:</span><span class="se">\n</span><span class="si">{</span><span class="n">mitigated</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="n">A_joint</span> <span class="o">=</span> <span class="n">reduce</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">kron</span><span class="p">,</span> <span class="n">matrices</span><span class="p">)</span>
+<span class="n">plot_cmat</span><span class="p">(</span><span class="n">A_joint</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Mitigated counts:
+[559  -1 -58  32 -28  26 -16 510]
+
+Corrected for negative counts:
+[521   0   0  35   0  22   0 446]
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_readout_error_mitigation_27_1.png" src="../../../_images/examples_python_tutorials_readout_error_mitigation_27_1.png" />
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[20]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">df</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span>
+    <span class="p">{</span>
+        <span class="s2">&quot;states&quot;</span><span class="p">:</span> <span class="n">states</span><span class="p">,</span>
+        <span class="s2">&quot;noisy&quot;</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">around</span><span class="p">(</span><span class="n">noisy_res_2</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">noisy_res_2</span><span class="p">),</span> <span class="mi">3</span><span class="p">),</span>
+        <span class="s2">&quot;mitigated_k_local&quot;</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">around</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">mitigated</span><span class="p">),</span> <span class="mi">3</span><span class="p">),</span>
+    <span class="p">}</span>
+<span class="p">)</span>
+
+<span class="n">ax</span> <span class="o">=</span> <span class="n">df</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="s2">&quot;states&quot;</span><span class="p">,</span> <span class="n">y</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;noisy&quot;</span><span class="p">,</span> <span class="s2">&quot;mitigated_k_local&quot;</span><span class="p">],</span> <span class="n">kind</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">,</span> <span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">8</span><span class="p">,</span> <span class="mi">5</span><span class="p">))</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;noisy&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;mitigated_k_local&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">set_ylabel</span><span class="p">(</span><span class="s2">&quot;probabilities&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_readout_error_mitigation_28_0.png" src="../../../_images/examples_python_tutorials_readout_error_mitigation_28_0.png" />
+</div>
+</div>
+</section>
+<section id="Inverse-of-full-confusion-matrix">
+<h2>Inverse of full confusion matrix<a class="headerlink" href="#Inverse-of-full-confusion-matrix" title="Permalink to this heading">¶</a></h2>
+<p>Here we generate a quantum circuit for each of the basis states of <span class="math notranslate nohighlight">\(n\)</span> qubits (i.e., <span class="math notranslate nohighlight">\(2^n\)</span> combinations). This gives more accurate readout error mitigation. Since it scales exponentially with the number of qubits, it is only practical for small devices.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[21]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">results</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">n_qubits</span><span class="p">,</span> <span class="n">label</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="n">shots</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise_2</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">label</span> <span class="ow">in</span> <span class="n">labels</span>
+<span class="p">]</span>
+
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">states</span><span class="p">):</span>
+    <span class="n">res</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">()))</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">state</span><span class="si">}</span><span class="s2"> becomes </span><span class="si">{</span><span class="n">res</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+000 becomes {&#39;000&#39;: 367, &#39;010&#39;: 248, &#39;111&#39;: 17, &#39;001&#39;: 159, &#39;011&#39;: 83, &#39;100&#39;: 68, &#39;101&#39;: 35, &#39;110&#39;: 47}
+001 becomes {&#39;000&#39;: 161, &#39;010&#39;: 93, &#39;111&#39;: 46, &#39;001&#39;: 363, &#39;011&#39;: 253, &#39;100&#39;: 17, &#39;101&#39;: 76, &#39;110&#39;: 15}
+010 becomes {&#39;000&#39;: 234, &#39;010&#39;: 378, &#39;111&#39;: 27, &#39;001&#39;: 100, &#39;011&#39;: 150, &#39;100&#39;: 36, &#39;101&#39;: 25, &#39;110&#39;: 74}
+011 becomes {&#39;000&#39;: 106, &#39;010&#39;: 145, &#39;111&#39;: 65, &#39;001&#39;: 251, &#39;011&#39;: 386, &#39;100&#39;: 11, &#39;101&#39;: 30, &#39;110&#39;: 30}
+100 becomes {&#39;000&#39;: 83, &#39;010&#39;: 34, &#39;111&#39;: 99, &#39;001&#39;: 29, &#39;011&#39;: 18, &#39;100&#39;: 388, &#39;101&#39;: 144, &#39;110&#39;: 229}
+101 becomes {&#39;000&#39;: 22, &#39;010&#39;: 13, &#39;111&#39;: 247, &#39;001&#39;: 70, &#39;011&#39;: 43, &#39;100&#39;: 163, &#39;101&#39;: 371, &#39;110&#39;: 95}
+110 becomes {&#39;000&#39;: 32, &#39;010&#39;: 77, &#39;111&#39;: 157, &#39;001&#39;: 14, &#39;011&#39;: 30, &#39;100&#39;: 233, &#39;101&#39;: 85, &#39;110&#39;: 396}
+111 becomes {&#39;000&#39;: 14, &#39;010&#39;: 31, &#39;111&#39;: 393, &#39;001&#39;: 38, &#39;011&#39;: 60, &#39;100&#39;: 95, &#39;101&#39;: 233, &#39;110&#39;: 160}
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[22]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># generate full confusion matrix</span>
+<span class="n">A_full</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="mi">2</span><span class="o">**</span><span class="n">n_qubits</span><span class="p">,</span> <span class="mi">2</span><span class="o">**</span><span class="n">n_qubits</span><span class="p">))</span>
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">state</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">states</span><span class="p">):</span>
+    <span class="n">true_state</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">state</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">val</span> <span class="ow">in</span> <span class="n">results</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+        <span class="n">observed_state</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+        <span class="n">A_full</span><span class="p">[</span><span class="n">observed_state</span><span class="p">][</span><span class="n">true_state</span><span class="p">]</span> <span class="o">=</span> <span class="n">val</span> <span class="o">/</span> <span class="n">shots</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[23]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">plot_cmat</span><span class="p">(</span><span class="n">A_full</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_readout_error_mitigation_32_0.png" src="../../../_images/examples_python_tutorials_readout_error_mitigation_32_0.png" />
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[24]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Distance between full confusion matrix and tensored confusion matrix</span>
+<span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">norm</span><span class="p">(</span><span class="n">A_joint</span> <span class="o">-</span> <span class="n">A_full</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[24]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+0.09734490298929
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[25]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">A_pinv</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linalg</span><span class="o">.</span><span class="n">pinv</span><span class="p">(</span><span class="n">A_full</span><span class="p">)</span>
+<span class="n">mitigated</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">dot</span><span class="p">(</span><span class="n">A_pinv</span><span class="p">,</span> <span class="n">noisy_res_2</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">int</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Mitigated counts:</span><span class="se">\n</span><span class="si">{</span><span class="n">mitigated</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+<span class="k">if</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">all</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">&gt;=</span> <span class="mi">0</span><span class="p">):</span>
+    <span class="n">positive_dist</span> <span class="o">=</span> <span class="n">find_closest_distribution</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">/</span> <span class="n">shots</span><span class="p">)</span>
+    <span class="n">mitigated</span> <span class="o">=</span> <span class="n">get_counts_from_distribution</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">,</span> <span class="n">shots</span><span class="p">,</span> <span class="n">positive_dist</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">Corrected for negative counts:</span><span class="se">\n</span><span class="si">{</span><span class="n">mitigated</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Mitigated counts:
+[ 714 -100 -211  152  -49   63   32  422]
+
+Corrected for negative counts:
+[683   0   0  39   0   0   0 302]
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[26]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;mitigated_full&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">around</span><span class="p">(</span><span class="n">mitigated</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">mitigated</span><span class="p">),</span> <span class="mi">3</span><span class="p">)</span>
+
+<span class="n">ax</span> <span class="o">=</span> <span class="n">df</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span>
+    <span class="n">x</span><span class="o">=</span><span class="s2">&quot;states&quot;</span><span class="p">,</span>
+    <span class="n">y</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;noisy&quot;</span><span class="p">,</span> <span class="s2">&quot;mitigated_k_local&quot;</span><span class="p">,</span> <span class="s2">&quot;mitigated_full&quot;</span><span class="p">],</span>
+    <span class="n">kind</span><span class="o">=</span><span class="s2">&quot;bar&quot;</span><span class="p">,</span>
+    <span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">12</span><span class="p">,</span> <span class="mi">5</span><span class="p">),</span>
+<span class="p">)</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;noisy&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;mitigated_k_local&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">bar_label</span><span class="p">(</span><span class="n">ax</span><span class="o">.</span><span class="n">containers</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">labels</span><span class="o">=</span><span class="n">df</span><span class="p">[</span><span class="s2">&quot;mitigated_full&quot;</span><span class="p">])</span>
+<span class="n">ax</span><span class="o">.</span><span class="n">set_ylabel</span><span class="p">(</span><span class="s2">&quot;probabilities&quot;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_readout_error_mitigation_35_0.png" src="../../../_images/examples_python_tutorials_readout_error_mitigation_35_0.png" />
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="noisy_simulations.html" class="btn btn-neutral float-left" title="Noisy Simulation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="vqe_water_active_space.html" class="btn btn-neutral float-right" title="Water Molecule with Active Space (CPU vs. GPU)" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/readout_error_mitigation.ipynb b/pr-2241/examples/python/tutorials/readout_error_mitigation.ipynb
new file mode 100644
index 0000000000..1d1fee4095
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/readout_error_mitigation.ipynb
@@ -0,0 +1,900 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "5b2ac00e-c7fc-45cc-888e-8c26dabf80d2",
+   "metadata": {},
+   "source": [
+    "# Readout Error Mitigation\n",
+    "\n",
+    "Readout errors are caused by imperfect qubit measurement and are a common source of error in quantum computing. Properly modelling these errors in simulation can give the user tools to understand better what these errors are and how to mitigate them when running on actual quantum devices.\n",
+    "\n",
+    "Readout errors can be mitigated with a confusion matrix $A$. It is a square matrix of size $2^n \\times 2^n$ and tells about the probability of observing the state $|y\\rangle$ given the true state $|x\\rangle$. The confusion matrix characterizes the readout error of the device and is circuit-independent. Once $A$ is estimated, we can compute its pseudoinverse $A^+$ which can be applied to the noisy probability distribution $p_{\\text{noisy}}$ to obtain an adjusted quasi-probability distribution \n",
+    "\n",
+    "$$\n",
+    "p_{\\text{mitigated}} = A^+ p_{\\text{noisy}}\n",
+    "$$\n",
+    "\n",
+    "In this tutorial, we show how to build a confusion matrix with the following approaches.\n",
+    "\n",
+    "- Using a  single qubit model\n",
+    "- Using $k$ local confusion matrices\n",
+    "- A full confusion matrix for each $2^n$ combination\n",
+    "\n",
+    "The last method works well for correcting correlated errors (which affect multiple qubits together). However, it becomes impractical for large numbers of qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "04b58854-7dab-4f1b-8c59-d8b9506bce44",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install pandas==2.2.2\n",
+    "!pip install scipy==1.13.1\n",
+    "!pip install seaborn==0.13.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "710a2a46-4e55-4508-a0b7-21969aac6a87",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "import seaborn as sns\n",
+    "import pandas as pd\n",
+    "import itertools\n",
+    "from functools import reduce\n",
+    "from scipy.optimize import minimize\n",
+    "from typing import Union\n",
+    "\n",
+    "sns.set_style(\"dark\")\n",
+    "\n",
+    "cudaq.set_target(\"density-matrix-cpu\")\n",
+    "seed = 42\n",
+    "\n",
+    "cudaq.set_random_seed(seed)\n",
+    "np.random.seed(seed)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8eab761a-0a82-4e20-8cf8-54602cd05d6a",
+   "metadata": {},
+   "source": [
+    "To model the readout error, we apply a bitflip channel on every qubit at the end of the circuit using an Identity gate. The probability of bitflip `probs` can be the same or different for all the qubits.\n",
+    "\n",
+    "<div class=\"alert alert-block alert-success\"><b>Note: </b>\n",
+    "In principle, readout error is applied to the measurement gate but we use the Identity gate because adding a quantum error on the measurement gate is not yet supported. Also, the Identity gate is not present in the <kbd>add_channel</kbd> method, so we model the Identity gate using a rotation gate with an angle of 0.0.\n",
+    "</div>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "d84bb420-4fab-4c26-919a-7efa8d3a219b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_noise(n_qubits: int, probs: Union[float, list[float]]):\n",
+    "    \"\"\"\n",
+    "    Creates a noise model with specified probabilities of bit flip errors on each qubit.\n",
+    "\n",
+    "    Args:\n",
+    "        n_qubits (int): The number of qubits in the quantum circuit.\n",
+    "        probs (Union[float, list[float]]): Probabilities of a bit flip error occurring on each qubit.\n",
+    "        If a single probability value is provided, it will be applied to all qubits. If a list of\n",
+    "        probabilities is provided, each qubit will have its own probability.\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq noise model\n",
+    "    \"\"\"\n",
+    "    noise = cudaq.NoiseModel()\n",
+    "\n",
+    "    if not isinstance(probs, list):\n",
+    "        probs = [probs] * n_qubits\n",
+    "\n",
+    "    for i, p in enumerate(probs):\n",
+    "        bit_flip = cudaq.BitFlipChannel(p)\n",
+    "        noise.add_channel(\"rx\", [i], bit_flip)\n",
+    "\n",
+    "    return noise"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bb4c7a14-1c0c-4fab-a6aa-7174c23baa7f",
+   "metadata": {},
+   "source": [
+    "We define a cudaq kernel which will help create a set of quantum circuits to take measurements of the basis states for $n$ qubits. The kernel takes the number of qubits and the basis state as arguments."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "53e3f450-000f-49b8-ad5c-57aa74461694",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel(n_qubits: int, state_label: list[int]):\n",
+    "    qvector = cudaq.qvector(n_qubits)\n",
+    "    for i, val in enumerate(state_label):\n",
+    "        if val == 1:\n",
+    "            x(qvector[i])\n",
+    "        rx(\n",
+    "            0.0, qvector[i]\n",
+    "        )  # Identity gate at the end on each qubit to model readout error\n",
+    "    mz(qvector)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "95411463-cd1e-499f-baef-d624acc0122c",
+   "metadata": {},
+   "source": [
+    "For the tutorial, we will use the GHZ state on three qubits to test readout error mitigation. The GHZ state on 3 qubits is described as:\n",
+    "\n",
+    "$$\n",
+    "\\frac{|000\\rangle + |111\\rangle}{\\sqrt{2}}\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "c1476028-923d-4f2b-b5fc-39ebcc8cbab9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def ghz_kernel(n_qubits: int):\n",
+    "    qvector = cudaq.qvector(n_qubits)\n",
+    "\n",
+    "    h(qvector[0])\n",
+    "    for i in range(n_qubits - 1):\n",
+    "        cx(qvector[i], qvector[i + 1])\n",
+    "\n",
+    "    # Apply identity gates for readout error mitigation\n",
+    "    for i in range(n_qubits):\n",
+    "        rx(0.0, qvector[i])\n",
+    "\n",
+    "    mz(qvector)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "900d2110-d613-426a-8aa9-6c12b1238536",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Function to draw the confusion matrix\n",
+    "def plot_cmat(mat):\n",
+    "    fig, ax = plt.subplots()\n",
+    "    n = len(mat)\n",
+    "    im2 = ax.matshow(mat, cmap=plt.cm.Reds, vmin=0, vmax=1.0)\n",
+    "    ax.set_yticks(np.arange(n))\n",
+    "    ax.set_xticks(np.arange(n))\n",
+    "    ax.set_yticklabels(n * [\"\"])\n",
+    "    ax.set_xticklabels(n * [\"\"])\n",
+    "    ax.set_title(r\"Confusion Matrix\", fontsize=16)\n",
+    "    ax.set_xlabel(\"Prepared State\")\n",
+    "    ax.xaxis.set_label_position(\"top\")\n",
+    "    ax.set_ylabel(\"Measured State\")\n",
+    "    fig.colorbar(im2, ax=ax)\n",
+    "    plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "032f6898-c953-4d30-a2bf-e8b46ee77c62",
+   "metadata": {},
+   "source": [
+    "It is possible that the adjusted quasi-probability distribution $p_{\\text{mitigated}}$ obtained by application of $A^+$ to $p_{\\text{noisy}}$ may be non-positive. We need to find the closest positive probability distribution in such a case.\n",
+    "\n",
+    " $$ p'' = \\min_{p_{\\rm positive}} \\|p_{\\rm noisy} - p_{\\rm positive}\\|_1$$\n",
+    "\n",
+    "Then, we can draw samples from $p''$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "9b355dcb-bf80-42a1-ae11-dcc9f11ba1e3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_closest_distribution(empirical_dist):\n",
+    "    \"\"\"\n",
+    "    Find the closest distribution to an empirical distribution by minimizing the L1 norm.\n",
+    "\n",
+    "    Args:\n",
+    "        empirical_dist: Empirical distribution that you want to find the closest distribution to.\n",
+    "\n",
+    "    Returns:\n",
+    "        Closest distribution to `empirical_dist`\n",
+    "    \"\"\"\n",
+    "\n",
+    "    def objective(x):\n",
+    "        return np.linalg.norm(empirical_dist - x, ord=1)\n",
+    "\n",
+    "    # Constraint: all elements of p must be positive, and the distribution must sum to 1\n",
+    "    cons = (\n",
+    "        {\"type\": \"ineq\", \"fun\": lambda p: p},\n",
+    "        {\"type\": \"eq\", \"fun\": lambda p: np.sum(p) - 1},\n",
+    "    )\n",
+    "    bnds = [(0, 1) for _ in range(len(empirical_dist))]\n",
+    "    initial_value = np.random.uniform(size=len(empirical_dist))\n",
+    "\n",
+    "    res = minimize(\n",
+    "        objective,\n",
+    "        initial_value,\n",
+    "        method=\"SLSQP\",\n",
+    "        options={\"maxiter\": 1000},\n",
+    "        bounds=bnds,\n",
+    "        constraints=cons,\n",
+    "    )\n",
+    "\n",
+    "    return res.x"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "0ceb5a15-cecf-47ed-b1cc-cea79fa936f7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_counts_from_distribution(n_qubits, size, dist):\n",
+    "    \"\"\"\n",
+    "    Generates samples based on a given distribution and returns the counts of each sample value.\n",
+    "\n",
+    "    Args:\n",
+    "        n_qubits: The number of qubits in the quantum circuit.\n",
+    "        dist: The probability distribution from which samples are drawn.\n",
+    "\n",
+    "    Returns:\n",
+    "        An array of counts for each possible value in the distribution. The array has a length of 2^n_qubits.\n",
+    "    \"\"\"\n",
+    "    samples = np.random.choice(np.arange(2**n_qubits), size=size, p=dist)\n",
+    "    values, counts = np.unique(samples, return_counts=True)\n",
+    "    res = np.zeros(2**n_qubits, dtype=int)\n",
+    "    res[values] = counts\n",
+    "    return res"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1225d4de-fcc8-4a56-846b-44d6a52a272f",
+   "metadata": {},
+   "source": [
+    "Let's run the `ghz_kernel` with the noise model. We will perform two experiments. First, we keep the bitflip probability the same for all the qubits. In the second experiment, we use different bitflip probabilities for qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "53453484-a8d5-416c-8aad-7c982cad7191",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "n_qubits = 3\n",
+    "shots = 1024\n",
+    "\n",
+    "labels = list(map(list, itertools.product([0, 1], repeat=n_qubits)))\n",
+    "states = list(map(lambda label: \"\".join(map(str, label)), labels))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "2d147fe7-ce5e-475c-9014-59d4ff63a644",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "bitflip probability: 0.1\n",
+      "\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'000': 352,\n",
+       " '010': 43,\n",
+       " '111': 367,\n",
+       " '001': 47,\n",
+       " '011': 47,\n",
+       " '100': 54,\n",
+       " '101': 61,\n",
+       " '110': 53}"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "p = 0.1\n",
+    "print(f\"bitflip probability: {p}\\n\")\n",
+    "\n",
+    "noise_1 = get_noise(n_qubits, p)\n",
+    "\n",
+    "ghz_result = cudaq.sample(ghz_kernel, n_qubits, shots_count=shots, noise_model=noise_1)\n",
+    "noisy_dict_1 = dict(list(ghz_result.items()))\n",
+    "\n",
+    "noisy_res_1 = np.array([noisy_dict_1.get(state, 0) for i, state in enumerate(states)])\n",
+    "\n",
+    "noisy_dict_1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "976f13da-277b-4754-9a58-277a5988f739",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "bitflip probability: [0.149816047538945, 0.3802857225639665, 0.292797576724562]\n",
+      "\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'000': 212,\n",
+       " '010': 122,\n",
+       " '111': 189,\n",
+       " '001': 111,\n",
+       " '011': 87,\n",
+       " '100': 78,\n",
+       " '101': 131,\n",
+       " '110': 94}"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "p = list(np.random.uniform(low=0.0, high=0.4, size=n_qubits))\n",
+    "print(f\"bitflip probability: {p}\\n\")\n",
+    "\n",
+    "noise_2 = get_noise(n_qubits, p)\n",
+    "\n",
+    "ghz_result = cudaq.sample(ghz_kernel, n_qubits, shots_count=shots, noise_model=noise_2)\n",
+    "noisy_dict_2 = dict(list(ghz_result.items()))\n",
+    "\n",
+    "noisy_res_2 = np.array([noisy_dict_2.get(state, 0) for i, state in enumerate(states)])\n",
+    "\n",
+    "noisy_dict_2"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1889f50a-f051-4f0e-bace-18477122eafe",
+   "metadata": {},
+   "source": [
+    "## Inverse confusion matrix from single-qubit noise model\n",
+    "\n",
+    "Here we assume that the readout error of each qubit is independent with the same confusion probabilities. Then, the confusion matrix $A_1$ for a single qubit can be defined as\n",
+    "\n",
+    "$$\n",
+    "A_1 = \\begin{bmatrix}\n",
+    "P(0|0) & P(0|1)\\\\\n",
+    "P(1|0) & P(1|1)\n",
+    "\\end{bmatrix}\n",
+    "$$\n",
+    "\n",
+    "where $P(y|x)$ is the probability of observing state $|y\\rangle$ when measuring the true state $|x\\rangle$. Using $A_1$, the full $2^n \\times 2^n$ confusion matrix $A$ can be written as \n",
+    "\n",
+    "$$\n",
+    "A = A_1 \\otimes \\dots \\otimes A_1\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "e6ceb0a9-c2ec-4fcd-bb23-457890a8b57e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0 becomes {'0': 924, '1': 100}\n",
+      "1 becomes {'0': 104, '1': 920}\n"
+     ]
+    }
+   ],
+   "source": [
+    "single_qubit_labels = [[0], [1]]\n",
+    "single_qubit_states = [\"0\", \"1\"]  # Used for dictionary keys\n",
+    "\n",
+    "# we use noise_1 which has same bitflip probability for all qubits\n",
+    "results = [\n",
+    "    cudaq.sample(kernel, 1, label, shots_count=shots, noise_model=noise_1)\n",
+    "    for label in single_qubit_labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(single_qubit_states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "9f030f99-0ad9-4f89-8d99-a570b3c5e745",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[0.90234375 0.1015625 ]\n",
+      " [0.09765625 0.8984375 ]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Construct confusion matrix for single qubit\n",
+    "\n",
+    "A_1 = np.zeros((2, 2))\n",
+    "for i, state in enumerate(single_qubit_states):\n",
+    "    true_state = int(state, 2)\n",
+    "    for key, val in results[i].items():\n",
+    "        observed_state = int(key, 2)\n",
+    "        A_1[observed_state][true_state] = val / shots\n",
+    "\n",
+    "print(A_1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "cbc4a228-935f-413c-9ad3-b6e26f22e802",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[476   3   0   1  12  19   9 501]\n"
+     ]
+    }
+   ],
+   "source": [
+    "A = reduce(np.kron, [A_1] * n_qubits)  # joint confusion matrix\n",
+    "A_pinv = np.linalg.pinv(A)  # Generate pseudoinverse confusion matrix.\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_1), dtype=int)  # Obtain mitigated counts\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "b65c4657-87f7-44df-b205-7fc6195b95a4",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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Tp1q1woCAAAAaclUmI2KilLBggUlSVu3btUzzzyjMmXKqG3btjpy5IhdKwgAAACkJVNh1tfXV8eOHVNCQoJ+/vln/fvf/5Yk3bp1SxaLJcPnW7lypRo3bqwqVarohRde0N69e9Ms+91336lNmzYKCgpS9erV1apVK61bty4zzQAAAIDBuWTmoDZt2qh///4qWLCgTCaTgoODJUl79uyRn59fhs61fv16hYSEaOzYsapWrZqWLVumbt26aePGjfLx8UlR3sPDQ7169ZKfn59cXV31ww8/aMSIEfLx8VH9+vUz0xwAAAAYVKbCbL9+/VSuXDldvHhRzzzzjNzc3CRJFotF3bt3z9C5lixZonbt2qlt27aSpLFjx+rHH39UaGioevTokaJ8nTp1bH7u0qWL1q1bp507dxJmAQAAHjGZCrOS9Mwzz0iSbt++bd323HPPZegccXFxOnDggF5//XXrNrPZrODgYO3evfuBxyclJen333/X33//rcGDB2foswEAAGB8mQqzCQkJmjt3rlavXq2IiAh9++23KlGihKZNm6ZixYrphRdeSNd5oqKilJCQkGI4gY+Pj06cOJHmcTdu3FCDBg0UFxcns9ms0aNHW8ftAgAA4NGRqQlgc+bM0eeff64hQ4bI1dXVur18+fL69NNP7Va5tOTLl0/r1q3Tp59+qgEDBui9995jfVsAAIBHUKbC7BdffKFx48bp2Wefldn8zykqVKhw3zuq/8vLy0sWi0URERE22yMiIuTr65vmcWazWaVKlVLFihX16quvqmnTppo/f37GGwIAAABDy1SYvXTpkkqWLJlie1JSkuLj49N9Hjc3N1WuXFlhYWHWbYmJiQoLC1ONGjXSfZ7ExETFxcWluzwAAAByhkyNmS1btqx27NihYsWK2WzfuHGjKlasmKFzde3aVcOGDVNgYKCqVq2qZcuWKTY2Vm3atJEkDR06VIULF9agQYMkSfPmzVNgYKBKliypuLg4bd26VV9++aXGjBmTmaYAAADAwDIVZnv37q233npLly5dUlJSkr777jv9/fffWrdunebNm5ehczVr1kyRkZGaMWOGwsPDVbFiRS1cuNA6zODChQs2QxliYmI0duxYXbx4Ublz55afn58++OADNWvWLDNNAQAAgIFlKsw2adJEc+fO1ezZs5UnTx7NmDFDlSpV0ty5czO1qkDHjh3VsWPHVPetWLHC5ucBAwZowIABmak2AAAAcphMrzMbFBSkJUuW2LMuAAAAQIZkagIYAAAA4AzSfWe2du3a2rhxo7y9vVWrVi2ZTKY0y27bts0ulQMAAADuJ91hdvjw4cqfP7/17/cLswAAAEB2SHeYfe6556x/v7tsFgAAAOBImRozW7FixRRv7ZKkqKioDK8zCwAAAGRWpsJsUlJSqtvj4uLk6ur6UBUCAAAA0itDS3MtX75ckmQymbR27VrlzZvXui8xMVHbt2+Xn5+ffWsIAAAApCFDYXbp0qWSku/Mrl692ubNXK6uripevLjGjh1r1woCAAAAaclQmN2yZYskqVOnTpo1a5Y8PDyypFIAAABAemTqDWD/+4pZAAAAwBHSHWZDQkL05ptvKm/evAoJCblv2eHDhz90xQAAAIAHSXeYPXjwoOLj461/TwsvUwAAAEB2SXeYvXdoAcMMAAAA4Awytc4sAAAA4AzSfWe2b9++6T7prFmzMlUZAAAAICPSHWbd3d2zsh4AAABAhmVoNQMAAADAmTBmFgAAAIaV7juzzz33nJYuXSoPDw+1bt36vktwff7553apHAAAAHA/6Q6zTz75pNzc3CRJTZo0ybIKAQAAAOmVqdUMMrKyAQAAAJBV0h1mU7Nv3z4dP35cklS2bFkFBgbapVIAAABAemQqzF68eFEDBw7Url27VKBAAUnS9evXVaNGDU2dOlVFihSxayUBAACA1GRqNYORI0cqPj5e69ev17Zt27Rt2zatX79eSUlJGjlypL3rCAAAAKQqU3dmt2/frtWrV8vPz8+6zc/PT2+//bY6dOhgt8oBAAAA95OpO7OPPfaY4uPjU2xPTExUoUKFHrpSAAAAQHpkKswOGTJE48aN0759+6zb9u3bpwkTJmjYsGF2qxwAAABwP+keZlCrVi2bFyXExMSoXbt2slgskqSEhARZLBaNGDGCdWgBAACQLdIdZkeMGJGV9QAAAAAyLEOvswUAAACcyUO9NEGSbt++rTt37thsy58//8OeFgAAAHigTIXZmJgYTZ48WRs2bNDVq1dT7D906NDD1gsAAAB4oEytZvDBBx/o999/15gxY+Tm5qbx48erX79+KlSokN5//3171xEAAABIVabC7A8//KDRo0eradOmslgsCgoKUu/evTVgwAB99dVX9q4jAAAAkKpMhdlr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",
+      "text/plain": [
+       "<Figure size 800x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(\n",
+    "    {\n",
+    "        \"states\": states,\n",
+    "        \"noisy\": np.around(noisy_res_1 / sum(noisy_res_1), 3),\n",
+    "        \"mitigated_sg\": np.around(mitigated / sum(mitigated), 3),\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "ax = df.plot(x=\"states\", y=[\"noisy\", \"mitigated_sg\"], kind=\"bar\", figsize=(8, 5))\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_sg\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2927e72-98bb-41cf-8e77-35ea9572474a",
+   "metadata": {},
+   "source": [
+    "## Inverse confusion matrix from k local confusion matrices\n",
+    "\n",
+    "This method works under the assumption that the readout errors for different qubits are independent of each other and the confusion matrix $A$ can be factorized into the product of $k$ small local confusion matrices. We consider the special case when $k = n$ for $n$ qubits and different $2 \\times 2$ confusion matrices for each qubit\n",
+    "\n",
+    "$$\n",
+    "A = A_1 \\otimes \\dots \\otimes A_n\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "1e8fd13a-e0cf-4139-84ca-d81f7a71baa6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "000 becomes {'000': 388, '010': 235, '111': 18, '001': 174, '011': 79, '100': 58, '101': 28, '110': 44}\n",
+      "111 becomes {'000': 23, '010': 38, '111': 370, '001': 40, '011': 60, '100': 107, '101': 224, '110': 162}\n"
+     ]
+    }
+   ],
+   "source": [
+    "local_labels = [[0] * n_qubits, [1] * n_qubits]\n",
+    "local_states = [\"0\" * n_qubits, \"1\" * n_qubits]\n",
+    "\n",
+    "results = [\n",
+    "    cudaq.sample(kernel, n_qubits, label, shots_count=shots, noise_model=noise_2)\n",
+    "    for label in local_labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(local_states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0f592fb8-2ded-498e-b4fe-eff6eac74750",
+   "metadata": {},
+   "source": [
+    "The local confusion matrices are generated using the marginal probability distribution for each qubit."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "id": "7fabcc1f-8d9c-42c2-b02a-3ce42c1e34c6",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "counts = [dict(list(results[i].items())) for i, state in enumerate(local_states)]\n",
+    "matrices = []\n",
+    "\n",
+    "for k in range(n_qubits):\n",
+    "    matrix = np.zeros([2, 2], dtype=float)\n",
+    "    marginalized_counts = []\n",
+    "    total_shots = []\n",
+    "    for i in range(2):\n",
+    "        marginal_cts = dict(results[i].get_marginal_counts([k]).items())\n",
+    "        marginalized_counts.append(marginal_cts)\n",
+    "        total_shots.append(sum(marginal_cts.values()))\n",
+    "\n",
+    "    # matrix[i][j] is the probability of counting i for expected j\n",
+    "    for i in range(2):\n",
+    "        for j in range(2):\n",
+    "            matrix[i][j] = marginalized_counts[j].get(str(i), 0) / total_shots[j]\n",
+    "    matrices.append(matrix)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "7f016f9b-3243-42b3-ab59-4d03f7765b82",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[0.85546875 0.15722656]\n",
+      " [0.14453125 0.84277344]]\n",
+      "\n",
+      "[[0.6328125  0.38476562]\n",
+      " [0.3671875  0.61523438]]\n",
+      "\n",
+      "[[0.70800781 0.32226562]\n",
+      " [0.29199219 0.67773438]]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "for m in matrices:\n",
+    "    print(m)\n",
+    "    print()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "id": "51734299-307f-4081-b8cc-1968ebfc7d52",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[559  -1 -58  32 -28  26 -16 510]\n",
+      "\n",
+      "Corrected for negative counts:\n",
+      "[521   0   0  35   0  22   0 446]\n"
+     ]
+    },
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAe0AAAHACAYAAACPhjATAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9VUlEQVR4nO3deVxVdf7H8fe9CKJiolAuaIs64AIkalrmMmJO5ZZgWuOWW4uplT8dxTLLzKFmstxaLM20LCsVncZtKiudRHJBLTVLM0FDQ1CLRUE4vz8cbt1AvZtcjvf1nMdt4tzzPedzsfrcz+d8z/dYDMMwBAAAKjyrtwMAAACOIWkDAGASJG0AAEyCpA0AgEmQtAEAMAmSNgAAJkHSBgDAJEjaAACYBEkbAACTqOTtAFBxffnll/r3v/+tHTt2KDMzUwUFBQoODtaf/vQnderUSb169VKtWrW8GuOBAwf04osvKjU1VadOnVJxcbFGjx6tMWPGlFsMERERkqT9+/eX2zmdFRsbq6NHj0qSBg0apMmTJ19w3/nz5+uf//ynJMnPz0979+4tlxgdceTIEXXp0kVhYWHasGGDt8MByh1JG6VkZ2dr3Lhx2rx5syQpLCxMbdu2VdWqVZWZmanU1FRt3rxZs2bN0ltvvaUbb7zRK3Hm5eXpgQce0NGjRxUZGan27dvLz89PTZs29Uo8ZvHRRx9pwoQJCggIKPP95cuXe/ycJFvAM0jasPPrr7+qf//+OnTokBo2bKhp06apdevWdvsUFBQoKSlJc+bMUWZmppcilb7++msdPXpUMTExWrp0qdfiWLNmjdfO7azIyEh98803+vTTT3XnnXeWen/Hjh364YcfFBUVpa+//toLEV5c7dq1tWbNGvn7+3s7FMAruKYNO9OmTdOhQ4cUFham9957r1TClqSAgADdc889WrlypRo2bOiFKM/LyMiQJF1//fVei0GSGjVqpEaNGnk1Bkf16dNH0oWr6WXLltntV9H4+/urUaNGuvbaa70dCuAVJG3YpKen69///rckadKkSQoODr7o/qGhoWUm7dWrV+u+++5TmzZtFBkZqc6dO2vSpEk6dOhQmceJjY1VRESEjhw5oi1btmjYsGG66aabFB0drbi4OK1cudJu/5SUFEVERGjixImSpKSkJEVERNheJf748x8NGjRIERERSklJsdv+66+/6qWXXlLPnj3VokULW+v93nvv1axZs1RYWGi3/8XOc+rUKb344ovq3r27brzxRsXExCg+Pl5vvPGGzpw5U2r/ks82aNAgFRYW6vXXX1f37t0VHR2ttm3bavTo0Tp48OAFP9OlhIeHKzIyUl9++aWOHz9u915ubq7Wrl2rOnXqqH379hc8xoEDBzR79mzde++96tChgyIjI9W2bVsNGTKkzK5DQkKCunTpIkk6evSo3Z/V739vc+bMUUREhObMmaOffvpJjz/+uDp16qTmzZsrISFB0vk2e0REhGJjY+3OMW3aNEVERKh///46d+5cqRheeuklRUREKC4uTmfPnnX8FwZUMLTHYfPZZ5+pqKhIV111Van/KDrCMAwlJCRo5cqVqlSpklq3bq2QkBDt2bNHK1as0Nq1azV79mx17NixzPHLly/Xq6++qmbNmqlDhw46evSodu7cqYkTJ+rUqVMaMmSIpPNfFuLi4nT48GHt2LFD1157rVq1auXOR7fJz89X//799d1336lWrVq6+eabbdfyDx06pFdeeUVDhw51qD2bnp6u++67T0ePHlWtWrXUqVMnFRYWKiUlRS+88ILWrl2rhQsXqkaNGqXGFhYW6oEHHlBqaqpat26tRo0aaffu3fr444+VkpKipKQk1a9f36XP2KdPH33zzTdasWKFRo4cadu+du1a5eXlafDgwbJYLBccv3DhQi1btkwNGzZUeHi4rrrqKmVkZCglJUXJycnatWuXJk2aZNu/VatWysvL0/r161W1alXdfvvtF43vxx9/VFxcnPz9/dWyZUsZhqGaNWtedMzEiRO1c+dObd++XTNnztT48eNt723cuFHz5s1TUFCQZs6cqcqVK1/qVwRUXAbwP3/729+M8PBwY/DgwS6Nf/fdd43w8HCjbdu2xt69e23bi4uLjdmzZxvh4eFG69atjaysLLtxnTt3NsLDw43mzZsbGzZssHtv+fLlRnh4uNGqVSsjPz+/zPcmTpxYZjzh4eFGeHj4BeMdOHCgER4ebmzZssW2LSkpyQgPDzdGjBhhFBQU2O1fVFRkpKSkGGfPnnXoPH379jXCw8ONhx56yMjNzbVtz8rKMuLi4ozw8HDj//7v/+zGbNmyxXa83r17Gz///LPtvTNnzhjDhg0zwsPDjSeffPKCn6ssJb/jrVu3Gr/88osRHR1tdO3a1W6fe++914iIiDDS0tKM9PR0Izw83GjatGmpY6WkpBhpaWmlth88eNDo2LGjER4ebuzatcvuvZLjde7c+YIxlvwzEh4ebowfP77U7/lSx0lLSzNat25tREREGJ9//rlhGIaRkZFhtG3b1ggPDzfWrFlzwXMDZkF7HDbZ2dmSpJCQEJfGv/nmm5KkUaNG2c3gtlgsGj16tCIiIvTLL7/ogw8+KHP8wIED1blzZ7tt8fHxatiwoX799Vd98803LsXljBMnTkiSbr311lLVtNVqVZs2bS446/r3tm3bpl27dqlKlSqaNm2aqlatanuvVq1aeuaZZySdn8R27NixUuMtFosSExN19dVX27ZVrlxZjzzyiCTZZva7onr16uratasOHz6sr776SpL0ww8/aMeOHbrpppvUoEGDi45v06ZNmfs0bNhQDz/8sCRp3bp1LscXHBysKVOmOPR7/r0GDRooMTFRhmFowoQJSk9P19ixY3Xy5EkNHDiwzIl3gNmQtOERx44dU1pamiQpLi6u1PsWi0Xx8fGSVOoacok/JuwSJZO8/ngN9nKIioqSdP5e5ZUrV+rUqVMuHackGXbo0EGhoaGl3o+MjFSTJk1UXFxs2/f36tWrpyZNmpTa7qnfxR8npJX8v6MT0Equf7/44ot68sknlZCQoISEBP3nP/+RpAvOX3DELbfcourVq7s09rbbbtPQoUN16tQpxcXFaceOHYqMjLTNfwDMjmvasClZKCUrK8vpsSVJJDg4WEFBQWXuUzLj90IJp169emVuLzleeUwgatu2re6//34tWLBAEydOlMVi0XXXXaeWLVuqS5cuio2NldV66e+6JZ/xYtedr732Wn377bdl/j7q1q1b5piS30VBQYEjH+eCbr75ZtWvX1/r16/X448/rlWrVikoKEh33HHHJcdu2LBBkyZNuugXmpycHJdjCwsLc3msJI0fP16bNm3SgQMHVLVqVc2cOdPpqh2oqKi0YdO8eXNJ0t69e1VUVFTu57/Y5KfLobi4uMzt48eP18cff6zJkyfrjjvuUH5+vlasWKFRo0apX79+ysvLu+yxOfLFwB0Wi0VxcXHKz8/XxIkTlZmZqe7duyswMPCi444fP66xY8fq1KlTGjFihFatWqXt27dr37592r9/vxYsWOB2bJeK4VJ27dqlH3/8UdL5BXi+++47t2MCKgqSNmw6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rZLV+tt34BdeeEEJCQlq2rSpKleurH/961+aNWuWpkyZoqZNm2rfvn168sknVbVqVcXFxSk3N1cPPvig2rVrp3/+8586cuTIJR+kUatWLVmtVq1fv1733Xef/Pz8Su3z4Ycfqm/fvnrrrbfUuHFjW8Wfm5ur3r17a/LkyZKkN998Uw888IDWr1+voKAgLVu2TLfccosSExPVoUMH27G3bdumiRMnavLkyWrdurXS0tL05JNPSpJGjx7tyh8dAGcYgMlMnDjRGDlypGEYhlFcXGx8+eWXRmRkpPHcc8/Z3m/Xrp1x9uxZ25iVK1cat99+u1FcXGzbdvbsWSM6OtrYtGmTbVybNm2MvLw82z7vvvuu0aJFC6OoqKjMWLKysozw8HBj//79hmEYRnp6uhEeHm689dZbdvvddtttxkcffWS37eWXXzbuuecewzAMY+nSpUabNm2MM2fO2J07PDzc2Lt37wV/F++8845x4403GjExMcagQYOMuXPnGmlpabb3S+K52DEMwzCKioqMmJgYY8OGDbZt4eHhxscff2y333333We89tprdttWrlxp3HrrrRc9PgDPoNKGKX3++eeKiYlRYWGhDMNQjx49NGbMGNv74eHhdtexv/32W6Wlpally5Z2xzl79qxde7vkueElYmJilJeXp4yMDIWFhenHH3/U7NmztWvXLp08eVLG/x6Sl5GRofDwcNu4yMhI29/n5eUpLS1NTzzxhK0qlaRz586pevXqkqSDBw8qIiJClStXtjv3pQwYMEB33XWXvvrqK+3atUvr1q3TvHnz9Oqrr+rWW2+94LgTJ05o5syZ+uqrr5SVlaXi4mLl5+frp59+uuj5vv32W+3YsUOvvfaabVtRUZHOnj2r/Px8u98dAM8jacOU2rZtq6efflr+/v665pprVKmS/T/Kf0weeXl5at68uV544YVSx6pVq5bD533ooYcUFhamZ599Vtdcc42Ki4vVo0cP27OhS1StWtXu3JI0bdo03XjjjXb7/b6l7qqgoCDFxsYqNjZWjz32mIYPH37JpD1x4kSdOnVKTzzxhOrVq6eAgADdc889pT7HH+Xl5WnMmDH6y1/+Uuq933/hAHB5kLRhSlWqVNF1113n8P7NmzfX2rVrFRISoqCgoAvut3//fp05c0aBgYGSpJ07d6pq1aqqW7euTp48qUOHDunZZ59V69atJZ2/xnspoaGhuuaaa5Senq5evXqVuU+jRo20atUqnT171pb8du7c6fDnK2GxWNSwYUPt2LFDkmzXsIuKiuz227Fjh5566il16tRJ0vlOwcmTJ+328ff3LzWuWbNmOnTokFO/ewCew+xx+ISePXuqZs2aGjlypLZt26b09HSlpKTo2Wef1bFjx2z7FRQU6IknntCBAwf0xRdfaM6cORo4cKCsVqtq1Kih4OBgvf/++zp8+LCSk5P13HPPOXT+Rx55RK+//roWL16sQ4cOaf/+/Vq+fLltolyPHj1ksVg0efJk27nffPPNix5z3759GjlypNatW6cDBw7o8OHD+vDDD7V8+XLbrPGQkBAFBgZq06ZNOnHihO1WsOuvv17/+te/dPDgQe3atUvjx4+3fVEpERYWpuTkZGVmZur06dOSZJt0N3fuXH3//fc6ePCgVq9erZdeesmxPwgAbiFpwydUqVJF77zzjurVq6fRo0erW7dueuKJJ3T27Fm7yvuWW27RddddpwEDBuixxx5TbGys7Vq51WrVSy+9pD179qhHjx5KTEzUhAkTHDp/37599eyzz2rFihXq2bOnBg0apKSkJNWvX1+SVK1aNb322mv67rvv1Lt3b7300ksaP378RY9Zu3ZthYWF6eWXX1bfvn0VFxenxYsXa8yYMRo5cqQkqVKlSpo8ebLef/99dejQQQ8//LAkafr06Tp9+rTi4uI0YcIEDRo0SCEhIXbHnzhxojZv3qw///nPiouLk3T+/vjXXntN//3vf3X33XerX79+euuttxQWFubQ7wGAeyxGyUwawMclJCTol19+0SuvvOLtUACgTFTaAACYBEkbAACToD0OAIBJUGkDAGASJG0AAEyCpA0AgEmQtAEAMAmSNgAAJkHSBgDAJHwyaRcUFGjOnDkqKCjwdihOM2vsxF2+iLv8mTV2s8btq3w2ac+dO9eU/5CaNXbiLl/EXf7MGrtZ4/a2rVu36qGHHlL79u0VERGhTz755JJjUlJSFBcXp8jISHXt2lUrVqxw+rw+mbQBAHBHXl6eIiIi9NRTTzm0f3p6uh588EG1bdtWq1at0n333afJkydr06ZNTp2X52kDAOCkTp062Z5H74ilS5eqfv36SkhIkCQ1atRI27dv11tvvaUOHTo4fByfrbSrVavm7RBcZtbYibt8EXf5M2vsZo3b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",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# To find the joint pseudoinverse confusion matrix, we can first perform pseudoinverse of the\n",
+    "# local confusion matrices and then do the tensor product\n",
+    "\n",
+    "pinv_confusion_matrices = [np.linalg.pinv(m) for m in matrices]\n",
+    "A_pinv = reduce(np.kron, pinv_confusion_matrices)\n",
+    "\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_2), dtype=int)\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")\n",
+    "\n",
+    "A_joint = reduce(np.kron, matrices)\n",
+    "plot_cmat(A_joint)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "4261d8a3-b701-4939-8219-c0d823d42747",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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iIiIyN04ZWendu3a8fLLL1OyZEkMBgP169cHYM+ePfj6+uZogSIiIiIid5OtMDto0CCqVq3KxYsXeeqpp3BxcQHAZDLRu3fvHC1QRERERORushVmAZ566ikAbt26ZW175pln7r8iEREREZFMytac2dTUVObMmUPDhg2pU6cOZ86cAeDdd9+1LtklIiIiIpLbshVm586dyyeffMKIESNwdna2tlerVo2PPvoox4oTEREREbmXbIXZzz77jIkTJ/L0009jNP55iOrVq3Py5MkcK05ERERE5F6yFWYvXbpExYoV07WnpaWRkpJy30WJiIiIiGRGtsKsv78/O3bsSNe+ceNGAgMDs3y8FStW0LRpU0JCQujQoQN79+69a9+vv/6adu3aERoaSu3atWnTpg2ffvppls8pIiIiIo4vW6sZ9O/fn1deeYVLly6RlpbG119/ze+//86nn37K/Pnzs3Ss9evXEx4ezoQJE6hVqxZLly6lV69ebNy4ES8vr3T93d3d6devH76+vjg7O/Ptt98yevRovLy8aNiwYXYuR0REREQcVLbuzDZv3px58+YRFRVF4cKFmTlzJidOnGDevHnWt4Fl1uLFi+nYsSPt27fH39+fCRMm4OrqSmRkZIb969Wrx+OPP46fnx8VK1ake/fuVK9enZ07d2bnUkRERETEgWV7ndnQ0FAWL158XydPSkriwIED9O3b19pmNBqpX78+u3fv/sf909LS+OWXX/j9998ZPnz4fdUiIiIiIo4n22E2J8TFxZGamppuOoGXl9c9V0W4fv06jRo1IikpCaPRyLhx47J8R1hEREREHF+mw+zDDz/Mxo0b8fT05KGHHsJgMNy177Zt23KkuLspWrQon376KQkJCURFRTFlyhQqVKhAvXr1cvW8IiIiIpK/ZDrMhoWF4ebmZv37vcJsZnl4eGAymYiNjbVpj42Nxdvb+677GY1GKlWqBEBgYCAnTpxgwYIFCrMiIiIiD5hMh9lnnnnG+vd27drlyMldXFwICgoiKiqK5s2bA2CxWIiKiqJLly6ZPo7FYiEpKSlHahIRERERx5Gt1QwCAwPT3U2F23Ngs7rObM+ePVmzZg2ffPIJJ06cYPz48SQmJloD88iRI5k2bZq1//z58/npp584c+YMJ06cYNGiRXz++ec8/fTT2bkUEREREXFg2XoALC0tLcP2pKQk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",
+      "text/plain": [
+       "<Figure size 800x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(\n",
+    "    {\n",
+    "        \"states\": states,\n",
+    "        \"noisy\": np.around(noisy_res_2 / sum(noisy_res_2), 3),\n",
+    "        \"mitigated_k_local\": np.around(mitigated / sum(mitigated), 3),\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "ax = df.plot(x=\"states\", y=[\"noisy\", \"mitigated_k_local\"], kind=\"bar\", figsize=(8, 5))\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_k_local\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9329a30d-9224-42b1-9a66-1e87ba7c2674",
+   "metadata": {},
+   "source": [
+    "## Inverse of full confusion matrix\n",
+    "\n",
+    "Here we generate a quantum circuit for each of the basis states of $n$ qubits (i.e., $2^n$ combinations). This gives more accurate readout error mitigation. Since it scales exponentially with the number of qubits, it is only practical for small devices."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "id": "cf6025e8-1755-4c8f-96fa-1b67830d448d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "000 becomes {'000': 367, '010': 248, '111': 17, '001': 159, '011': 83, '100': 68, '101': 35, '110': 47}\n",
+      "001 becomes {'000': 161, '010': 93, '111': 46, '001': 363, '011': 253, '100': 17, '101': 76, '110': 15}\n",
+      "010 becomes {'000': 234, '010': 378, '111': 27, '001': 100, '011': 150, '100': 36, '101': 25, '110': 74}\n",
+      "011 becomes {'000': 106, '010': 145, '111': 65, '001': 251, '011': 386, '100': 11, '101': 30, '110': 30}\n",
+      "100 becomes {'000': 83, '010': 34, '111': 99, '001': 29, '011': 18, '100': 388, '101': 144, '110': 229}\n",
+      "101 becomes {'000': 22, '010': 13, '111': 247, '001': 70, '011': 43, '100': 163, '101': 371, '110': 95}\n",
+      "110 becomes {'000': 32, '010': 77, '111': 157, '001': 14, '011': 30, '100': 233, '101': 85, '110': 396}\n",
+      "111 becomes {'000': 14, '010': 31, '111': 393, '001': 38, '011': 60, '100': 95, '101': 233, '110': 160}\n"
+     ]
+    }
+   ],
+   "source": [
+    "results = [\n",
+    "    cudaq.sample(kernel, n_qubits, label, shots_count=shots, noise_model=noise_2)\n",
+    "    for label in labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "id": "28f2b2cb-13d3-4806-852d-06ea91e58c1d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# generate full confusion matrix\n",
+    "A_full = np.zeros((2**n_qubits, 2**n_qubits))\n",
+    "for i, state in enumerate(states):\n",
+    "    true_state = int(state, 2)\n",
+    "    for key, val in results[i].items():\n",
+    "        observed_state = int(key, 2)\n",
+    "        A_full[observed_state][true_state] = val / shots"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "id": "c3b0b80b-63ac-438a-9f3d-a6a3687da167",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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slqtOnfunNN3rapWrZqkS5c4Xa7KSklJsRt7rRWek75cPD///PNl59aqVUsDBw7UvHnztHnzZn3wwQeqU6eOvvnmGy1ZsuSqxy78jIWfuTgl/fv4o169eslqterzzz+X5FhrfNOmTTp//rw6d+6sv/3tb2rQoIECAwNtXzJ++umnaxrz1WRkZOj//u//dPHiRfXq1UsWi0VTpkyx3cIVMDuSNmxuvvlmde3aVZL03HPPXfV8bnp6un744QdJUvXq1W3t7zVr1hQZaxiG4uPjJV1qQZeEm266SZJsMf7et99+a7s5iyOaNGmifv36SZIOHjx41fGtWrWSJG3ZssW2uO33Dhw4oIMHD8pqteq2225zOA5Pqlmzpjp16qSgoCA1a9bModvRnj171jb3jwzD0EcffVTsvMIvUMVdQ+0phQvQTpw4oZ49eyouLk5Dhw7V2bNnNX78+CLX1wNmRNKGnWnTpumWW27RsWPH1K9fP+3YsaPImNzcXK1atUo9e/a0S4jDhg2TJL300kv69ttvbdsNw9BLL72kgwcP6oYbblDfvn2v/QeR1KZNG0nSokWL7M4BHzt2TLGxsTIMo8icTz75RNu3by/SOs/Ly9OWLVskOXbOtWXLlmratKnOnz+v6dOnKycnx/ZeRkaGpk+fLknq0qXLZc9fl4RFixYpMTFR7733nkPjCxfCbdy4Ub/88otte35+vubPn6+kpKRi51WtWlVly5bVqVOnXF7cdzWLFy/Wli1bVL9+fT311FOSpAkTJigqKkp79uyxPQQFMDMWosFO5cqV9e677+rxxx/X119/rf79+6tWrVoKDw9X+fLlderUKe3du1fZ2dkKDAy0VbOS9OCDDyopKUkffvihevfurdtuu812c5WjR48qICBAs2fPLrEng40aNUobN27Ul19+qbvvvluRkZHKyMjQN998o+bNmysqKqpIkvn666+1fPlyValSRY0aNVLVqlWVlZWlPXv2KD09XdWqVdOIESMcOv6cOXM0ePBgffbZZ+rUqZNatmypixcvKjExUZmZmWrcuLEteZtFx44d1bhxY+3fv1933323WrVqpfLly2vv3r365ZdfNHLkSL322mtF5pUtW1bR0dHauHGjevbsqRYtWtjOXc+aNcvtuLZv364FCxaofPnymj9/vu0SuzJlyuiFF15QTEyM3nzzTbVq1Up33XWX28cDvIWkjSKCg4P11ltvafPmzfr444+VlJSkhIQE5eXlKSgoSFFRUerQoYPuu+8+u1udWiwW/eMf/1D79u313nvvaf/+/crJyVFISIh69eqlkSNHlui9ymvXrq2VK1dq3rx5SkxM1Oeff67Q0FA9/PDDGjFihK0z8Hu9evVSQECAdu7cqcOHDysjI0OVKlVSjRo1NHjwYPXt2/eqd+f6/fHXrFmj119/XZ9++qm++OILWa1W3Xrrrbr33ns1aNAgtxddlbQyZcrorbfe0quvvqqNGzcqISFBgYGBioqK0oIFC5SVlVVs0pakZ555RkFBQdqyZYs2btxoa1e7m7QLz2Pn5+dr+vTpql+/vt37NWvWVFxcnB555BE98cQTatCggct3kwO8zWIU1yMEAAClDue0AQAwCZI2AAAmQdIGAMAkSNoAAJgESRsAAJMgaQMAYBIkbQAATIKkDZRSx44dU3h4uEP3OgfgG0jaMJ3Y2FiFh4crPDxcERER6ty5sxYtWnRNH0ZRWqWkpGjChAlq27atIiMj1b59e40ePVpHjhyR5F7iDw8P16effurpkAG4gduYwpTatWunuLg45ebm6ssvv9QzzzyjsmXLatSoUUXG5ubmyt/f3wtRXpKXl2d7ypWn9zts2DDdeuutWrRokW688UadOHFCmzdv1q+//urx4wHwPiptmJK/v79uvPFGhYaGql+/fmrTpo3tGeCxsbF65JFH9PLLL6tt27a65557JEmpqal67LHH1LJlS7Vq1UqjR4/WsWPHbPssnLdo0SLdfvvtat68uaZPn273hLDNmzfrr3/9q1q2bKnWrVtr1KhRSk5Otr1fWNmuW7dOAwYMUGRkpO1xlR988IHuvfdeRUZG6p577tGKFSvsPtPevXvVs2dPRUZGqlevXletjg8fPqzk5GQ99dRTatasmUJDQ9WiRQuNHz9ezZo1kyR16tRJktSzZ0+Fh4dr4MCBtmMNHTpUrVu3VosWLTRgwADt37/ftu/o6GhJ0pgxYxQeHm77WZI+/fRTxcTEKDIyUp06dfLZLgfgDVTauC6UK1fO7pGPhQ+yWLZsmaRLVenw4cPVrFkzrVixQmXKlNFLL72kESNG6F//+petEk9ISFC5cuX01ltv6fjx45oyZYqqVKmi8ePHS5JycnI0dOhQhYeHKzs7W/Pnz9eYMWP04Ycfymr97Tvw7NmzFRsbq4YNG6pcuXL617/+pfnz52v69Olq2LChDh48qGnTpqlChQqKiYlRVlaWRo0apTZt2uif//ynjh07dtUHaVStWlVWq1UbN27U4MGD5efnV2TMBx98oD59+uiNN95Q/fr1bRV/VlaWevbsqalTp0qSXn/9dT300EPauHGjAgMDtWrVKt1xxx2Ki4tTu3btbPvesWOHJk+erKlTp6ply5ZKTk7WtGnTJEljx4515V8dAGcYgMlMnjzZGD16tGEYhlFQUGB89dVXRkREhPHcc8/Z3m/Tpo1x4cIF25y1a9cad999t1FQUGDbduHCBaNJkybGli1bbPNatWplZGdn28a88847RrNmzYz8/PxiY0lPTzfCwsKMQ4cOGYZhGCkpKUZYWJjxxhtv2I276667jI8++shu24svvmg88MADhmEYxsqVK41WrVoZ58+ftzt2WFiYceDAgcv+Lt5++22jadOmRlRUlDFw4EBj0aJFRnJysu39wniutA/DMIz8/HwjKirK2LRpk21bWFiY8cknn9iNGzx4sPHKK6/YbVu7dq1x5513XnH/ADyDShum9MUXXygqKkp5eXkyDEPdunXTuHHjbO+HhYXZncf+9ttvlZycrObNm9vt58KFC3bt7cLnhheKiopSdna2UlNTFRoaqh9//FELFizQnj17dPr0aRn/e0heamqqwsLCbPMiIiJs/zs7O1vJycl68sknbVWpJF28eFGVKlWSJB05ckTh4eEqV66c3bGvpn///rrvvvv09ddfa8+ePdqwYYMWL16sl19+WXfeeedl5506dUrz5s3T119/rfT0dBUUFCgnJ0c///zzFY/37bffateuXXrllVds2/Lz83XhwgXl5OTY/e4AeB5JG6bUunVrPf300ypbtqxuuukmlSlj/0f5j8kjOztbjRs31uzZs4vsq2rVqg4f9+GHH1ZoaKieffZZ3XTTTSooKFC3bt1sz4YuVKFCBbtjS9LMmTPVtGlTu3G/b6m7KjAwUNHR0YqOjtbjjz+u4cOHXzVpT548WWfOnNGTTz6pmjVryt/fXw888ECRz/FH2dnZGjdunP7yl78Uee/3XzgAXBskbZhS+fLldcsttzg8vnHjxlq/fr2Cg4MVGBh42XGHDh3S+fPnFRAQIEnavXu3KlSooBo1auj06dM6evSonn32WbVs2VLSpXO8VxMSEqKbbrpJKSkp6tGjR7Fj6tWrpw8//FAXLlywJb/du3c7/PkKWSwW1a1bV7t27ZIk2zns/Px8u3G7du3SU089pQ4dOki61Ck4ffq03ZiyZcsWmdeoUSMdPXrUqd89AM9h9Th8Qvfu3VWlShWNHj1aO3bsUEpKihITE/Xss8/qxIkTtnG5ubl68skndfjwYX355ZdauHChBgwYIKvVqsqVKysoKEjvvfeefvrpJyUkJOi5555z6PiPPvqoXn31VS1fvlxHjx7VoUOHtHr1attCuW7duslisWjq1Km2Y7/++utX3OfBgwc1evRobdiwQYcPH9ZPP/2kDz74QKtXr7atGg8ODlZAQIC2bNmiU6dO2S4Fq1Onjv71r3/pyJEj2rNnjyZOnGj7olIoNDRUCQkJSktL09mzZyXJtuhu0aJF+v7773XkyBF9/PHHmjt3rmP/IgC4haQNn1C+fHm9/fbbqlmzpsaOHasuXbroySef1IULF+wq7zvuuEO33HKL+vfvr8cff1zR0dG2c+VWq1Vz587V/v371a1bN8XFxWnSpEkOHb9Pnz569tlntWbNGnXv3l0DBw5UfHy8atWqJUmqWLGiXnnlFX333Xfq2bOn5s6dq4kTJ15xn9WqVVNoaKhefPFF9enTRzExMVq+fLnGjRun0aNHS5LKlCmjqVOn6r333lO7du30yCOPSJJmzZqls2fPKiYmRpMmTdLAgQMVHBxst//Jkydr69at+vOf/6yYmBhJl66Pf+WVV/Tf//5X999/v/r27as33nhDoaGhDv0eALjHYhSupAF8XGxsrM6dO6eXXnrJ26EAQLGotAEAMAmSNgAAJkF7HAAAk6DSBgDAJEjaAACYBEkbAACTIGkDAGASJG0AAEyCpA0AgEn4ZNLOzc3VwoULlZub6+1QnGbW2Im7ZBF3yTNr7GaN21f5bNJetGiRKf+QmjV24i5ZxF3yzBq7WeP2tu3bt+vhhx9W27ZtFR4erk8//fSqcxITExUTE6OIiAh17txZa9ascfq4Ppm0AQBwR3Z2tsLDw/XUU085ND4lJUWjRo1S69at9eGHH2rw4MGaOnWqtmzZ4tRxeZ42AABO6tChg+159I5YuXKlatWqpdjYWElSvXr1tHPnTr3xxhtq166dw/vx2Uq7YsWK3g7BZWaNnbhLFnGXPLPGbta4PS03N1eZmZl2L0+dNti9e7fuuOMOu21t27bV7t27ndqPT1bagYGB2rVrl7fDcIlZYyfukkXcJc+ssZs17t87m3pClWtUd3s/eXl5uuOOO+wS9dixYzVu3Di3933q1CmFhITYbQsJCVFmZqbOnz+vgIAAh/ZT6pN2/vI4Ke+Ct8NwiqXtvd4OwSXGqePeDsFl1joR3g7BNWXKejsC15S/wdsRuKYg39sRuK5Mqf/ruliWwKrX/BiVa1TXE7Ua6Py5X13eR8ANlfT3Y98qISHBbru/v7+74XlU6f9TkHfBdEnbtH8x5F/0dgSuMwq8HYFrTPuQPeJG6XL+3K86/6vrSbtQYGCgB6IpKiQkRKdOnbLbdurUKQUGBjpcZUtmSNoAAFyF1WKR1WJxa/611KxZM23evNlu29atW9WsWTOn9uOzC9EAANcPqwdezsjKytLBgwd18OBBSdKxY8d08OBB/fzzz5KkOXPmaNKkSbbxDz74oFJSUvSPf/xDR44c0YoVK7R+/XoNGTLEqeNSaQMA4KR9+/Zp0KBBtp/j4uIkSTExMXruueeUlpam1NRU2/u1a9fW4sWLFRcXp+XLl6t69ep69tlnnbrcS5IshlG6T6rlL33adOe0LR26ezsElxhpx7wdgsusdZt4OwTXlCldi1wcVoGFaCXOpIsWS2IhmiRNDqqlC26c0y5XqZKeP1P6/w6k0gYAmJ4rLe4/zjcDs8QJAIDPo9IGAJheaV897ikkbQCA6flKe5ykDQAwPavl0sud+WZgli8XAAD4PCptAIDp0R4HAMAkLBaLLG4sJnNnbkkyy5cLAAB8HpU2AMD0aI8DAGASrB4HAAClCpU2AMD0LHKvCjVJoU3SBgCYn6/cxpT2OAAAJkGlDQAwPVaPAwBgEr6yepykDQAwPV+ptM0SJwAAPo9KGwBgelZZZHXjwi135pYkkjYAwPR85Zw27XEAAEyCShsAYHq+shCNpA0AMD3a4wAAoFSh0gYAmN6lB4a4Xi6bpNAmaQMAzI/2OAAAKFWotAEApsfqcQAATMJX2uMkbQCA6fnKbUzN0hEAAMDnUWkDAEyP9jgAACZhkXvXWpskZ9MeBwDALKi0AQCmR3scAACTYPU4AAAoVUp9pW1p11UqyPd2GE4xNn/k7RBcYu06yNshuKzg0HZvh+ASa4u/eDsE15zP8nYErqlQydsRuO5irrcjcEHJVa+0xwEAMIlLT/lyb74Z0B4HAMAkqLQBAKbnK9dpk7QBAKZntVhktbixetyNuSWJpA0AMD1fqbQ5pw0AgElQaQMATM9XKm2SNgDA9HwladMeBwDAJKi0AQCmZ7FYZHFjBbg7c0sSSRsAYHq0xwEAQKlCpQ0AMD2r3KtCzVLBkrQBAKZnsVx6uTPfDMzy5QIAAJ9HpQ0AMD3L//7jznwzIGkDAEzPV1aPk7QBAKbnK0mbc9oAAJgElTYAwPSskqxulMtmqWBJ2gAA0/OVhWhm+XIBAIDPo9IGAFwXzFEru4ekDQAwPe6IBgAArmjFihWKjo5WZGSk+vTpo717915x/BtvvKG7775bTZo0UYcOHfT3v/9dFy5ccPh4JG0AgOlZPPBy1rp16xQXF6cxY8YoPj5eDRo00PDhw5Wenl7s+I8++khz5szR2LFjtW7dOs2aNUvr1q3TCy+84PAxSdoAANOzyuL2y1nLli1T37591bt3b9WvX18zZsxQQECAVq9eXez4pKQkNW/eXN27d1etWrXUtm1bdevW7arVuf3nBAAAkqTMzEy7V25ubrHjcnNztX//frVp08a2zWq1qk2bNkpKSip2TlRUlPbv329L0ikpKfryyy/VoUMHh+NjIRoAwPQ8dRvT9u3bKysry7Z97NixGjduXJHxp0+fVn5+voKDg+22BwcH64cffij2GN27d9fp06fVr18/GYahixcv6sEHH9TDDz/scJwkbQCA6Xlq9fjmzZvttvv7+7sRlb3ExEQtXrxYTz31lJo0aaLk5GTNmjVLL774osaMGePQPkjaAADT81SlHRgY6ND4KlWqyM/Pr8iis/T0dIWEhBQ7Z/78+erRo4f69OkjSQoPD1d2dramT5+u0aNHy2q9+hlrzmkDAOAkf39/NW7cWAkJCbZtBQUFSkhIUFRUVLFzzp8/XyQx+/n5SZIMw3DouFTaAADT88a9x4cOHarJkycrIiJCTZo00ZtvvqmcnBz16tVLkjRp0iRVq1ZNEyZMkCR17NhRy5YtU6NGjWzt8fnz56tjx4625H01JG0AgOlZLZLhzlO+XJjbpUsXZWRkaMGCBUpLS1PDhg21ZMkSW3s8NTXVrrIePXq0LBaL5s2bp5MnT6pq1arq2LGjxo8f7/AxLYajNbmXFHy3XSrI93YYTjE2f+TtEFxi7TrI2yG4rODQdm+H4BJri794OwTXXMjxdgSuqVDJ2xG47mLxlx6VbhZZgqqVyJG+qtdA+ZmZLs/3CwzUnUe+9WBE1waVNgDA9Dy1EK20I2kDAEzPV5I2q8cBADAJKm0AgOl5Y/W4N5C0AQCmx/O0AQBAqUKlDQAwPaskd65fNksFS9IGAJier6weJ2kDAMzPYpHFB05qm6UjAACAzyv1lbaR+oOUn+ftMJxi7TbE2yG4pCD+VW+H4DLL3Q94OwTXlO67CF+eWW8HmnXW2xG4LqCityNwQclVr7THAQAwCV9J2rTHAQAwCSptAIDpWdxciObWIrYSRNIGAJie1c3+uCvP0/YG2uMAAJgElTYAwPQsVossbpTL7swtSSRtAIDp8cAQAABQqlBpAwBMz1cqbZI2AMD0uOQLAACT8JVKm3PaAACYBJU2AMD0aI8DAGAStMcBAECpQqUNADA9q5ulttUkpTZJGwBgerTHAQBAqUKlDQAwPYvcXD3uznM9SxBJGwBgehbrpZc7883AJGECAAAqbQCA+bl5cxWzrEQjaQMATM9ikdw5LW2SnE3SBgCY36Wk7c5tTD0Xy7XEOW0AAEyCShsAYHq0xwEAMAmrxSLDB57yRXscAACToNIGAJge7XEAAEzC4uYTQ2iPAwAAj6LSBgCYHu1xAABMwleSNu1xAABMgkobAGB6FqtFsrqxEM2NuSWJpA0AMD1faY+TtAEApscd0QAAQKlCpQ0AMD3a4wAAmAR3RLuCixcvauvWrVq5cqUyMzMlSSdPnlRWVpZHgwMAAL9xutI+fvy4RowYodTUVOXm5urOO+9UYGCgXnvtNeXm5uqZZ565FnECAHBZFts/3JhvAk5X2rNmzVJERIS+/vprlStXzra9c+fO2rZtm0eDAwDAERaLxe2XGThdae/cuVPvvvuu/P397baHhobq5MmTHgsMAADYczppFxQUqKCgoMj2EydOqGLFih4JCgAAp7i3Ds00/XGn2+N33nmn3nzzTbttWVlZWrhwoTp06OCxwAAAcJSvtMcthmEYzkw4ceKEhg8fLsMw9NNPPykiIkI//vijqlSpohUrVig4ONijARonj0rOheh1Bfu+8nYILrHc0sDbIbisYP273g7BJX5Dn/R2CK65mOvtCFxj9fN2BK7LO+/tCJxnscgSXLtEDnW68+1SthtXMFWoqCqflP51WU63x6tXr64PP/xQ69at07fffqvs7Gzdf//96t69uwICAq5FjAAAXJHFKvfu8WmS+4M6nbS3b9+uqKgo9ejRQz169LBtv3jxorZv367bbrvNowECAHA17t5cxSy3RHP6u8WgQYN09uzZItt//fVXDRo0yCNBAQDglMJHc7rzMgGnk7ZhGMWesD9z5ozKly/vkaAAAEBRDrfHx44dK+lSCyI2NtbuOu38/HwdOnRIUVFRno8QAICr8ZH2uMNJu1KlSpIuVdoVK1a0W3RWtmxZNWvWTH369PF8hAAAXIW3zmmvWLFCS5cuVVpamho0aKBp06apSZMmlx1/7tw5zZ07V5988onOnDmj0NBQPfHEEw5fMu1w0o6Li5N06c5nw4YNU4UKFRydCgDAdWfdunWKi4vTjBkz1LRpU7355psaPny4NmzYUOzlz7m5uRo6dKiCg4M1f/58VatWTT///LNuuOEGh4/p9OrxwjY5AAClhruLyVyYu2zZMvXt21e9e/eWJM2YMUNffPGFVq9erYceeqjI+NWrV+vs2bNauXKlypYtK0mqVauWU8d06XnaGzZs0Pr165Wamqq8vDy79+Lj413ZJQAArvNQe7zwcdOF/P39izxrQ7pUNe/fv1+jRo2ybbNarWrTpo2SkpKKPcSmTZvUrFkzPfPMM/rss89UtWpVdevWTSNHjpSfn2M3/nF69fjy5cs1ZcoUhYSE6MCBA4qMjFRQUJBSUlLUvn17Z3cHAECp0b59e7Vo0cL2Wrx4cbHjTp8+rfz8/CJt8ODgYJ06darYOSkpKdq4caPy8/P16quv6pFHHtGyZcv08ssvOxyf05X2O++8o5kzZ6pbt25as2aNRo4cqdq1a2v+/PnFXr8NAMC1ZvFQe3zz5s12m4ursl1lGIaCg4M1c+ZM+fn5KSIiQidPntTSpUsdPvXsdKWdmppqu7QrICBAWVmX7vV633336eOPP3Z2dwAAuK+wPe7OS1JgYKDd63JJu0qVKvLz81N6errd9vT0dIWEhBQ758Ybb1SdOnXsWuF169ZVWlqacnMdu5+/00k7JCTEVlHXqFFDu3fvliQdO3ZMTj57BAAAj7BYLLJY3Xg5eT7c399fjRs3VkJCgm1bQUGBEhISLnvPkubNmys5Odnu8dY//vijbrzxRocreqeT9u23365NmzZJknr37q24uDgNHTpU48eP11133eXs7gAAMKWhQ4fq/fffV3x8vI4cOaKnn35aOTk56tWrlyRp0qRJmjNnjm38X//6V505c0azZs3S0aNH9cUXX2jx4sXq37+/w8d0+pz2zJkzbd8S+vfvr6CgICUlJSk6OloPPPCAs7sDAMB9Xri5SpcuXZSRkaEFCxYoLS1NDRs21JIlS2zt8dTUVFmtv9XGNWrU0NKlSxUXF6cePXqoWrVqGjRokEaOHOl4mM4+T/vnn39WjRo1irQSDMNQamqqatas6czurornaZccnqdd8niedgnjedolqwSfp53ZN1rKyXZ9B+UrKPD9TZ4L6Bpxuj3eqVMnZWRkFNl+5swZderUySNBAQCAopxuj1/uKV/Z2dkqV66cR4ICAMAZvvI8bafvPW6xWDRv3jy7x3Dm5+dr7969atDAvO1VAICJeeE2pt7gcNI+cOCApEuV9nfffWe7b6p0ael7gwYNNGzYMM9HCAAAJDmRtN966y1J0pQpU/Tkk08qMDDwmgUFAIBTaI8Xr7BNXuj48ePKyclR3bp17Za2AwBQUixWubC0+ndMkr4cDnPVqlVatmyZ3bZp06bprrvuUvfu3dWtWzelpqZ6PEAAAHCJw0n7/ffft3tQ9+bNm7VmzRo9//zzWrVqlW644QYtWrTomgQJAMAVeeje46Wdw0n7p59+UkREhO3nzz77TJ06dVKPHj3UuHFjjR8/3u4erAAAlBS37jv+v5cZOJy0z58/b7f4LCkpSS1btrT9XLt27cs+QxQAgGuKSttezZo1tX//fklSRkaGDh8+rObNm9veP3XqlCpVquT5CAEAgCQnVo/HxMTomWee0ffff69t27apbt26du3yXbt26U9/+tM1CRIAgCvi5ir2RowYoZycHH3yyScKCQnR/Pnz7d7ftWuXunbt6vEAAQC4Gm5j+gdWq1WPPfaYHnvssWLfX7BggceCAgAARTl9cxUAAEod2uMAAJiFuyvAzZG0TXLjNgAAQKUNADA9FqIBAGAWnNP+zR+f7HUlU6ZMcTkYAABweQ4l7QMHDhT5OT8/X7feeqsk6ccff5TValXjxo09HyEAAFdBe/x33nrrLdv/XrZsmSpWrKjnn39elStXliSdPXtWU6ZMsbsXOQAAJcZH2uNOrx5//fXXNWHCBFvClqTKlSvr8ccf1+uvv+7R4AAAcAgPDCleZmamMjIyimzPyMhQVlaWR4ICAABFOb16vHPnzpoyZYpiY2PVpEkTSdKePXv0j3/8Q3/5y188HiAAAFdj8ZH2uNNJe8aMGXr++ec1YcIEXbx4UZLk5+en+++/X5MmTfJ4gAAAXBUL0YpXvnx5Pf3005o0aZKSk5MlSTfffLMqVKjg8eAAAMBvXL6NaVpamtLS0lSnTh1VqFBBhmF4Mi4AABxn1W8ryF16efsDOMbpSvv06dN6/PHHlZiYKIvFov/85z+qXbu2nnjiCVWuXFmxsbHXIk4AAC6L67QvIy4uTmXKlNEXX3yhe++917a9S5cueu655zyftK1+ksmqeGvrLt4OwTX5ed6OwGV+w6Z5OwSX5C99xtshuMT6lz7eDsElRtoxb4fgMmv9KG+H4DyLScpXE3E6aX/11VdaunSpqlevbre9Tp06+vnnnz0WGAAADmP1ePGys7MVEBBQZPuZM2fk7+/vkaAAAHCKj7THne5dtGzZUmvXrrXbVlBQoCVLlqh169aeigsAAPyB05X23/72Nw0ZMkT79u1TXl6e/vnPf+rw4cM6e/as3n333WsRIwAAV+YjlbbTSTssLEwbN27U22+/rYoVKyo7O1udO3dW//79ddNNN12LGAEAuAp37x9+HSbtvLw8jRgxQjNmzNDo0aOvVUwAADjHar30cme+CTgVZdmyZXXo0KFrFQsAALgCp79a9OjRQ6tWrboWsQAA4BofeTSn0+e08/Pz9e6772rr1q2KiIhQ+fLl7d6fMmWKx4IDAMAhLEQr3nfffadGjRpJko4ePWr3nsUkHxoAADNyOmm/9dZb1yIOAABcR6UNAIBJ+MjqcaeT9sCBA6/YBl++fLlbAQEAgOI5nbQbNmxo9/PFixd18OBBff/99+rZs6en4gIAwHG0x4v3xBNPFLt94cKFys7OdjsgAACc5iNJ22NN/B49emj16tWe2h0AAPgDjy1ES0pK4tGcAADv8JFK2+mkPXbsWLufDcNQWlqa9u3bp0ceecRjgQEA4DBWjxevUqVKdj9bLBbdeuutevTRR9W2bVuPBQYAgMOotIsXFxd3LeIAAABX4XTSTk1NlcViUfXq1SVJe/fu1UcffaT69evrgQce8HiAAABclUVuVtoei+SacrqJP2HCBG3btk2SlJaWpiFDhuibb77R3LlztWjRIo8HCADAVfnIU76cTtrff/+9mjRpIklav369wsLCtHLlSs2ePVvx8fEeDxAAAFzidHv84sWLtku7tm7dqujoaElS3bp1lZaW5tnoAABwgMVHVo87HWX9+vW1cuVK7dixQ1u3blX79u0lSb/88ouCgoI8HR8AAA5wtzV+nbbHJ06cqPfee08DBw5U165d1aBBA0nSpk2bbG1zAADgeU63x1u3bq1t27YpMzNTlStXtm3v27evypcv79HgAABwCNdpX56fn59dwpakWrVqeSQgAACcRtK+vA0bNmj9+vVKTU1VXl6e3XusIAcA4Npw+pz28uXLNWXKFIWEhOjAgQOKjIxUUFCQUlJSbIvSAAAoUYWrx915mYDTlfY777yjmTNnqlu3blqzZo1Gjhyp2rVra/78+Tp79uy1iBEAgCvzkfa4018tUlNTFRUVJUkKCAhQVlaWJOm+++7Txx9/7NnoAABwBHdEK15ISIitoq5Ro4Z2794tSTp27JgMw/BocAAA4DdOJ+3bb79dmzZtkiT17t1bcXFxGjp0qMaPH6+77rrL4wECAHBVXqq0V6xYoejoaEVGRqpPnz7au3evQ/M+/vhjhYeH65FHHnHqeE6f0545c6YKCgokSf3791dQUJCSkpIUHR3NU74AAN7hhduYrlu3TnFxcZoxY4aaNm2qN998U8OHD9eGDRsUHBx82XnHjh3T888/r5YtWzofptMTrFaVKfNbru/ataumTp2qgQMH2u5JDgDA9W7ZsmXq27evevfurfr162vGjBkKCAjQ6tWrLzsnPz9fEydO1Lhx41S7dm2nj+nS15IdO3Zo4sSJeuCBB3Ty5ElJ0tq1a7Vjxw5XdgcAgHs81B7PzMy0e+Xm5hZ7uNzcXO3fv19t2rSxbbNarWrTpo2SkpIuG+aLL76o4OBg9enTx6WP6XTS3rhxo4YPH66AgAAdOHDA9oEyMzO1ePFil4IAAMAtHkra7du3V4sWLWyvy+W106dPKz8/v0gbPDg4WKdOnSp2zo4dO7Rq1SrNnDnT5Y/p9Dntl19+WTNmzFDPnj3tLvFq3ry5Xn75ZZcDAQDA2zZv3mz3s6dO+2ZmZmrSpEmaOXOmqlat6vJ+nE7aR48eLfbkeaVKlXTu3DmXAwEAwGUeWogWGBjo0PAqVarIz89P6enpdtvT09MVEhJSZHxKSoqOHz+u0aNH27YVLupu1KiRNmzYoJtvvvmqx3U6aYeEhCg5ObnIA0J27tzp0kl1AADcZpGbd0Rzbri/v78aN26shIQE2+XOBQUFSkhI0IABA4qMr1u3rj766CO7bfPmzVNWVpaefPJJVa9e3aHjOp20+/btq1mzZunvf/+7LBaLTp48qaSkJD3//PNOX28GAIBZDR06VJMnT1ZERISaNGmiN998Uzk5OerVq5ckadKkSapWrZomTJigcuXKKSwszG7+DTfcIElFtl+J00n7oYceUkFBgYYMGaKcnBwNGDBA/v7+GjZsmAYOHOjs7gAAcJ8X7j3epUsXZWRkaMGCBUpLS1PDhg21ZMkSW3s8NTVVVg8/iMRiuHjv0dzcXCUnJys7O1v16tVTxYoVPRpYISMtWTLb7VHLO3ZOpNTJz7v6mNKqTDlvR+CS/KXPeDsEl1j/4trlKt5mpB3zdggus9aP8nYIzrNYZalRr0QOlf9yrJR7wfUd+JeT3+jnPBfQNeLS87SlS/38+vXrezIWAABcY3FzIZrlOns055QpUxwaFxcX53IwxSobIMlklXa2SVfRm7VDIJm2S2Dt2t/bIbjE+GSVt0NwiTVmpLdDcFnBdzu9HYLz/MrIr4QqbV/hcNKOj49XzZo11ahRI57mBQAoXXzkedoOJ+2//vWv+vjjj3Xs2DH16tVLPXr0UFBQ0DUMDQAAB/lI0na4if/UU0/pv//9r0aMGKHPP/9cf/7zn/XYY49py5YtVN4AAJQApxai+fv7q1u3burWrZuOHz+u+Ph4zZgxQ/n5+fr3v/99zVaQAwBwRRare4vJrreFaH9UeO2ZYRjKz8/3WEAAADjNarn0cme+CTiVtHNzc/Wf//xHq1ev1s6dO/XnP/9Z06dPV7t27Tx+ATkAALDncNJ++umntW7dOlWvXl29e/fWnDlz3HpSCQAAHkN73N7KlStVs2ZN1a5dW9u3b9f27duLHbdo0SKPBQcAgEN8ZPW4w0m7Z8+espjkQwEAcD1yOGk/91zpvycrAMBHeeh52qWdy6vHAQAoNWiPAwBgEj6yEM0cUQIAACptAMB1wCI32+Mei+SaImkDAMzPRxaimSNKAABApQ0AuA6wehwAAJNg9TgAAChNqLQBAOZncfPRnLTHAQAoIbTHAQBAaUKlDQAwP1aPAwBgEj7SHidpAwDMz+rmQjR35pYgc3y1AAAAVNoAgOsA57QBADAJHzmnbY4oAQAAlTYA4DrgIwvRSNoAAPOzWNxsj5sjadMeBwDAJKi0AQDmx+pxAABMgtXjAACgNKHSBgCYH6vHAQAwCR9pj5O0AQDm5yML0czx1QIAAFBpAwCuA1brpZc7802ApA0AuA642R4X7XEAAOBBVNoAAPNj9TgAACbB6nEAAFCalP5KuyBfkuHtKJxTsbK3I3BN9jlvR+C6chW8HYFLjNQfvR2CS6z3Dfd2CC7Jf2e+t0NwmfXeB70dgvOsfiV4LKtksHocAIDSj/Y4AAAoTai0AQDmZ7G4uXrcHJU2SRsAYH4+0h4naQMAzM9HrtM2R5QAAIBKGwBwHbBaJMONFreV9jgAACWD9jgAAChNqLQBAObH6nEAAEyC9jgAAChNqLQBAKZnoT0OAIBJ0B4HAAClCUkbAGB+hZW2Oy8XrFixQtHR0YqMjFSfPn20d+/ey459//331a9fP91222267bbbNGTIkCuOLw5JGwBgfhbLpbuaufpy4Zz2unXrFBcXpzFjxig+Pl4NGjTQ8OHDlZ6eXuz4xMREde3aVcuXL9fKlStVo0YNDRs2TCdPnnT4mCRtAID5eaHSXrZsmfr27avevXurfv36mjFjhgICArR69epix8+ZM0f9+/dXw4YNVa9ePT377LMqKChQQkKCw8ckaQMA8D+ZmZl2r9zc3GLH5ebmav/+/WrTpo1tm9VqVZs2bZSUlOTQsXJycnTx4kVVrlzZ4fhYPQ4AMD8PXfLVvn17ZWVl2TaPHTtW48aNKzL89OnTys/PV3BwsN324OBg/fDDDw4dcvbs2brpppvsEv/VkLQBAOZnsbh5ydelpL1582a7zf7+/u5EdVmvvvqq1q1bp+XLl6tcuXIOzyNpAwDwP4GBgQ6Nq1Klivz8/IosOktPT1dISMgV5y5dulSvvvqqli1bpgYNGjgVH+e0AQDmV9ged+flBH9/fzVu3NhuEVnhorKoqKjLznvttdf00ksvacmSJYqMjHT6Y1JpAwDMz2KVLIZ78500dOhQTZ48WREREWrSpInefPNN5eTkqFevXpKkSZMmqVq1apowYYKkSy3xBQsWaM6cOQoNDVVaWpokqUKFCqpYsaJDxyRpAwDggi5duigjI0MLFixQWlqaGjZsqCVLltja46mpqbJaf/sysHLlSuXl5enRRx+128/lFrsVx2IYhhtfTa49IyNVUqkOsSj/AG9H4Jrsc96OwHXlKng7ApcU7N189UGlkLVeU2+H4JL8lQu9HYLLrPc+6O0QnGf1kzW8dYkcquCbL6SCfNd3YPWTNfLPHorm2qHSBgCYnxfa495gjigBAACVNgDgOsDztAEAMAkfaY+TtAEA5ucjlbY5vloAAAAqbQDAdYD2OAAAJmG1yq17eljNkbTNESUAAKDSBgCYn8VHFqKRtAEA5ueh52mXdrTHAQAwCSptAID50R4HAMAsrJJbedccjWdzRAkAAKi0AQDXAYtFbpXatMcBACghVqtb91bhjmgAAJQUH6m0zfHVAgAAUGkDAK4D7ra3aY97SNlycu9EhRfknvd2BK4JqOjtCFx3IdvbEbjEWq+Jt0NwScGh7d4OwSXWLv28HYLLCjas9HYIzvMvJ2t465I5Fu1xAABQmpT+ShsAgKtys9J2784sJYakDQAwP9rjAACgNKHSBgCYn49U2iRtAMB1wDfOadMeBwDAJKi0AQDmR3scAACTcDfnmiNnk7QBANcDzmkDAIBShEobAGB+nNMGAMAkLLZ/uDG/9KM9DgCASVBpAwCuA76xfJykDQAwP3fPSZvknDbtcQAATIJKGwBwHaA9DgCAOdAeBwAApQmVNgDA/Hyk0iZpAwCuA5zTBgDAFCw+UmlzThsAAJOg0gYAmJ+PVNokbQDAdcA3zmnTHgcAwCSotAEA1wGLm8WyOSptkjYAwPzcPidtjqRNexwAAJOg0gYAXAd8o9ImaQMAzI/2OAAAKE2otAEA5meOQtltJG0AwHXAN9rjJG0AgPlxThsAAJQmVNoAAPPzkUqbpA0AuA74RtKmPQ4AgElQaQMAzM9i+8d1jaQNADA/t89pmwPtcQAAXLRixQpFR0crMjJSffr00d69e684fv369brnnnsUGRmp7t2768svv3TqeCRtAMB1wOKBl3PWrVunuLg4jRkzRvHx8WrQoIGGDx+u9PT0Ysfv2rVLEyZM0P3336+1a9eqU6dOGjNmjL777juHj0nSBgCYn8Xi/stJy5YtU9++fdW7d2/Vr19fM2bMUEBAgFavXl3s+OXLl6tdu3YaMWKE6tWrp8cff1yNGjXS22+/7fAxS/057YzcsjIMb0fhLH9vB+CaXG8H4AZLgLcjcI1J/6gosru3I/A9A2Z6OwKnWSxScEkezJ1k8b+knZmZabfZ399f/v5F/4+am5ur/fv3a9SoUbZtVqtVbdq0UVJSUrGH2L17t4YMGWK3rW3btvr0008dDrPUJ+3g4EreDgEAUNqVv8HtXWRlZemOO+5Qbu5vFczYsWM1bty4ImNPnz6t/Px8BQfbfy0JDg7WDz/8UOz+T506pZCQkCLjT5065XCMPtkez8zMVPPmzYt8ozIDs8ZO3CWLuEueWWM3a9zXQtmyZZWQkKCdO3faXr+vpEuDUl9pXytZWVneDsFlZo2duEsWcZc8s8Zu1rg97XKt8OJUqVJFfn5+RRadpaenF6mmC4WEhBSpqq80vjg+WWkDAOAOf39/NW7cWAkJCbZtBQUFSkhIUFRUVLFzmjVrpm3bttlt27p1q5o1a+bwcUnaAAC4YOjQoXr//fcVHx+vI0eO6Omnn1ZOTo569eolSZo0aZLmzJljGz9o0CBt2bJFr7/+uo4cOaKFCxdq3759GjBggMPH9Mn2uL+/v8aOHetwG6Q0MWvsxF2yiLvkmTV2s8ZdGnTp0kUZGRlasGCB0tLS1LBhQy1ZssTW7k5NTZXV+ltt3Lx5c82ePVvz5s3TCy+8oDp16ujFF19UWFiYw8e0GIb5LqgCAMAX0R4HAMAkSNoAAJgESRsAAJMgaQMAYBIkbQAATIKkDQCASZC0AQAwCZI2AAAmQdIGAMAkSNoAAJgESRsAAJP4f5NuX2Us2gpFAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plot_cmat(A_full)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "id": "507852a8-6715-4802-b6a0-10967d09ed94",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "0.09734490298929"
+      ]
+     },
+     "execution_count": 24,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Distance between full confusion matrix and tensored confusion matrix\n",
+    "np.linalg.norm(A_joint - A_full)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "id": "9e6c3874-2905-4c25-9bf0-22ab27756fed",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[ 714 -100 -211  152  -49   63   32  422]\n",
+      "\n",
+      "Corrected for negative counts:\n",
+      "[683   0   0  39   0   0   0 302]\n"
+     ]
+    }
+   ],
+   "source": [
+    "A_pinv = np.linalg.pinv(A_full)\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_2), dtype=int)\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "id": "cb109820-5478-4179-84b8-66e6af1008fc",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 1200x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df[\"mitigated_full\"] = np.around(mitigated / sum(mitigated), 3)\n",
+    "\n",
+    "ax = df.plot(\n",
+    "    x=\"states\",\n",
+    "    y=[\"noisy\", \"mitigated_k_local\", \"mitigated_full\"],\n",
+    "    kind=\"bar\",\n",
+    "    figsize=(12, 5),\n",
+    ")\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_k_local\"])\n",
+    "ax.bar_label(ax.containers[2], labels=df[\"mitigated_full\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/examples/python/tutorials/unitary_compilation.html b/pr-2241/examples/python/tutorials/unitary_compilation.html
new file mode 100644
index 0000000000..4f80717d22
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/unitary_compilation.html
@@ -0,0 +1,1246 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Compiling Unitaries Using Diffusion Models &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="CUDA-Q Backends" href="../../../using/backends/backends.html" />
+    <link rel="prev" title="Factoring Integers With Shor’s Algorithm" href="Shors.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Compiling Unitaries Using Diffusion Models</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/unitary_compilation.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="Shors.html" class="btn btn-neutral float-left" title="Factoring Integers With Shor’s Algorithm" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../../using/backends/backends.html" class="btn btn-neutral float-right" title="CUDA-Q Backends" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Compiling-Unitaries-Using-Diffusion-Models">
+<h1>Compiling Unitaries Using Diffusion Models<a class="headerlink" href="#Compiling-Unitaries-Using-Diffusion-Models" title="Permalink to this heading">¶</a></h1>
+<p>This notebook is based on the work presented in <a class="reference external" href="https://doi.org/10.1038/s42256-024-00831-9">Quantum circuit synthesis with diffusion models, Florian Fürrutter, Gorka Muñoz-Gil &amp; Hans J. Briegel , Nat. Mach. Intell. 6, 515–524 (2024)</a>.</p>
+<p>Quantum computing relies on efficiently translating quantum operations into viable physical realizations on existing quantum hardware. Recently, diffusion models — a powerful class of generative models in machine learning — have demonstrated exceptional performance on this task.</p>
+<p>In this tutorial notebook, we will demonstrate how to use this method to synthesize arbitrary unitaries into a <code class="docutils literal notranslate"><span class="pre">cudaq.kernel</span></code>, effectively decomposing them into sequences of quantum gates, a process commonly known as unitary compilation.</p>
+<p>Our focus will be on generating circuits using a pre-trained model. Specifically, we will illustrate how to compile 3-qubit unitaries.</p>
+<section id="Diffusion-model-pipeline">
+<h2>Diffusion model pipeline<a class="headerlink" href="#Diffusion-model-pipeline" title="Permalink to this heading">¶</a></h2>
+<p>Generative diffusion models (DMs) have recently delivered remarkable results across a wide range of applications, from image generation to protein folding. In this work, we leverage DMs to generate quantum circuits based on a user specified unitary matrix and a text prompt that defines the allowed gate set, effectively using DMs as unitary compilers. The method is thoroughly explained in Ref. <a class="reference external" href="https://doi.org/10.1038/s42256-024-00831-9">(Fürrutter et al., 2024)</a>. The following figure provides
+an overview of the proposed circuit generation pipeline:</p>
+<figure><p><img alt="Quantum circuit generation pipeline overview" class="no-scaled-link" src="../../../_images/pipeline_simplified.png" style="width: 70%;" /></p>
+<figcaption><p>Quantum circuit generation pipeline. Figure adapted from (Fürrutter et al., 2024)</p>
+</figcaption></figure><p>The pipeline consists on 3 main components:</p>
+<p><strong>1) Circuit encoding:</strong> Like any neural network, diffusion models operate with continuous inputs and outputs. However, since the circuits we consider are composed of discrete gates (i.e., with no continuous parameters), we develop a mapping that transforms each gate into a continuous vector. This allows us to represent a given circuit as a three-dimensional tensor, as illustrated. Crucially, this mapping is invertible: when the DM generates continuous tensors, we can apply the inverse map to
+convert them back into the circuit form. An overview of these steps is provided in the figure below:</p>
+<figure><p><img alt="Quantum circuit encoding" class="no-scaled-link" src="../../../_images/circuit_encoding.png" style="width: 60%;" /></p>
+<figcaption><p>Quantum circuit encoding. Figure adapted from (Fürrutter et al., 2024)</p>
+</figcaption></figure><p><strong>2) Conditioning:</strong> The user’s input (the set of available gates and the unitary to compile) is also transformed into a continuous tensor by two neural networks. For the gate set description, where the input is a text prompt (e.g., “Compile using [‘x’, ‘h’]”), we utilize a pre-trained language model. For the unitary, we employ a neural network that is training jointly with the diffusion model.</p>
+<p><strong>3) Unitary compilation:</strong> The generation procedure follows the typical DM process: the model is given a fully noisy tensor which is iteratively de-noised until reaching a clean sample based on the given conditioning (the desired unitary and gate set). The tensors generated by the DM are then mapped to circuits via the inverse encoding procedure. To learn more about the practical implementation of diffusion models we recommend <a class="reference external" href="https://course.fast.ai/Lessons/lesson9.html">this tutorial</a>.</p>
+<p>In the following we will use <code class="docutils literal notranslate"><span class="pre">CUDA-Q</span></code> and <code class="docutils literal notranslate"><span class="pre">genQC</span></code> to perform all these steps and go from a desired unitary matrix, <span class="math notranslate nohighlight">\(U\)</span>, to a quantum circuit that we can execute using CUDA-Q.</p>
+</section>
+<section id="Setup-and-compilation">
+<h2>Setup and compilation<a class="headerlink" href="#Setup-and-compilation" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[24]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">genQC</span><span class="o">==</span><span class="m">0</span>.1.0<span class="w"> </span>-q
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+<span class="ansi-yellow-fg">WARNING: Running pip as the &#39;root&#39; user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv</span><span class="ansi-yellow-fg">
+</span>
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[25]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">genQC</span>
+<span class="kn">from</span> <span class="nn">genQC.imports</span> <span class="kn">import</span> <span class="o">*</span>
+<span class="kn">from</span> <span class="nn">genQC.pipeline.diffusion_pipeline</span> <span class="kn">import</span> <span class="n">DiffusionPipeline</span>
+<span class="kn">from</span> <span class="nn">genQC.inference.export_cudaq</span> <span class="kn">import</span> <span class="n">genqc_to_cudaq</span>
+<span class="kn">import</span> <span class="nn">genQC.inference.infer_compilation</span> <span class="k">as</span> <span class="nn">infer_comp</span>
+<span class="kn">import</span> <span class="nn">genQC.util</span> <span class="k">as</span> <span class="nn">util</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">torch</span>
+
+<span class="c1"># Fixed seed for reproducibility</span>
+<span class="n">torch</span><span class="o">.</span><span class="n">manual_seed</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[26]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">device</span> <span class="o">=</span> <span class="n">util</span><span class="o">.</span><span class="n">infer_torch_device</span><span class="p">()</span>  <span class="c1"># Use CUDA if we can</span>
+<span class="n">util</span><span class="o">.</span><span class="n">MemoryCleaner</span><span class="o">.</span><span class="n">purge_mem</span><span class="p">()</span>  <span class="c1"># Clean existing memory allocation</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">device</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[INFO]: Cuda device has a capability of 8.0 (&gt;= 8), allowing tf32 matmul.
+cuda
+</pre></div></div>
+</div>
+</section>
+<section id="Load-model">
+<h2>Load model<a class="headerlink" href="#Load-model" title="Permalink to this heading">¶</a></h2>
+<p>First, we load the pre-trained model weights and setup the DM pipeline.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[27]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">pipeline</span> <span class="o">=</span> <span class="n">DiffusionPipeline</span><span class="o">.</span><span class="n">from_pretrained</span><span class="p">(</span>
+    <span class="s2">&quot;Floki00/qc_unitary_3qubit&quot;</span><span class="p">,</span> <span class="n">device</span><span class="p">)</span>  <span class="c1"># Download from Hugging Face</span>
+<span class="n">pipeline</span><span class="o">.</span><span class="n">scheduler</span><span class="o">.</span><span class="n">set_timesteps</span><span class="p">(</span><span class="mi">40</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<script type="application/vnd.jupyter.widget-view+json">{"model_id": "543d6667d288478d8d64b8e32c6675f3", "version_major": 2, "version_minor": 0}</script></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[INFO]: `genQC.models.unet_qc.QC_Compilation_UNet` instantiated from given config on cuda.
+[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder` instantiated from given config on cuda.
+[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder`. No save_path` provided. No state dict loaded.
+</pre></div></div>
+</div>
+<p>Set parameters the model was trained on. Note that these are fixed and depend on the pre-trained model.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[28]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">vocab</span>         <span class="o">=</span> <span class="p">{</span><span class="n">i</span><span class="o">+</span><span class="mi">1</span><span class="p">:</span><span class="n">gate</span> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">gate</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">pipeline</span><span class="o">.</span><span class="n">gate_pool</span><span class="p">)}</span>  <span class="c1"># Gateset used during training, used for decoding</span>
+<span class="n">num_of_qubits</span> <span class="o">=</span> <span class="mi">3</span>                                                        <span class="c1"># Number of qubits</span>
+<span class="n">max_gates</span>     <span class="o">=</span> <span class="mi">12</span>                                                       <span class="c1"># Maximum number of gates</span>
+</pre></div>
+</div>
+</div>
+</section>
+<section id="Unitary-compilation">
+<h2>Unitary compilation<a class="headerlink" href="#Unitary-compilation" title="Permalink to this heading">¶</a></h2>
+<p>Let’s start by defining the unitary we want to compile. Note that this model has been trained to compile unitaries that arise from circuits composed of the gates contain in <code class="docutils literal notranslate"><span class="pre">vocab</span></code>. While this is a universal gate set (i.e. can perform universal computation), it can only do so with an infinite number of gates. Because the number of gates in the model is restricted to 12, we can only expect the model to generate unitaries under this constraints. We will consider here the compilation of one of
+such unitary. Nonetheless, stay tuned for bigger and better models!</p>
+<p>We start by defining our unitary as a <code class="docutils literal notranslate"><span class="pre">numpy.matrix</span></code>:</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[29]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">U</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">matrix</span><span class="p">([[</span> <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">],</span>
+               <span class="p">[</span> <span class="mf">0.</span>        <span class="p">,</span> <span class="o">-</span><span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="o">-</span><span class="mf">0.70710678</span><span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">],</span>
+               <span class="p">[</span><span class="o">-</span><span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">],</span>
+               <span class="p">[</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="o">-</span><span class="mf">0.70710678</span><span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">],</span>
+               <span class="p">[</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.70710678</span><span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.70710678</span><span class="p">],</span>
+               <span class="p">[</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">],</span>
+               <span class="p">[</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="o">-</span><span class="mf">0.70710678</span><span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.70710678</span><span class="p">],</span>
+               <span class="p">[</span> <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span><span class="o">-</span><span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span>  <span class="mf">0.</span>        <span class="p">,</span> <span class="mf">0.70710678</span><span class="p">,</span>  <span class="mf">0.</span>        <span class="p">]],</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>and check that the matrix is indeed unitary, i.e. <span class="math notranslate nohighlight">\(U^{\dagger} U = U U^{\dagger} = I\)</span></p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[30]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">assert</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span><span class="n">U</span><span class="o">.</span><span class="n">H</span> <span class="o">@</span> <span class="n">U</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">identity</span><span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">num_of_qubits</span><span class="p">))</span> <span class="ow">and</span> <span class="n">np</span><span class="o">.</span><span class="n">allclose</span><span class="p">(</span>
+    <span class="n">U</span> <span class="o">@</span> <span class="n">U</span><span class="o">.</span><span class="n">H</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">identity</span><span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">num_of_qubits</span><span class="p">))</span>  <span class="c1">#check if unitary</span>
+</pre></div>
+</div>
+</div>
+<p>The loaded model was trained on the gate set <code class="docutils literal notranslate"><span class="pre">['h',</span> <span class="pre">'cx',</span> <span class="pre">'z',</span> <span class="pre">'x',</span> <span class="pre">'ccx',</span> <span class="pre">'swap']</span></code>. Specifically, it was trained to generate circuits using any arbitrary subset of this gate set. Therefore, during inference, we can instruct the model to compile the unitary using any of these subsets. However, it is crucial to follow the prompt structure <code class="docutils literal notranslate"><span class="pre">Compile</span> <span class="pre">using</span> <span class="pre">[...]</span></code>, as the model was trained with this specific format. For example, let’s consider a scenario where we compile the unitary without using
+the <code class="docutils literal notranslate"><span class="pre">x</span></code> gate:</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[31]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Notice how the x gate missing from the prompt since this is a restriction we set</span>
+<span class="n">prompt</span> <span class="o">=</span> <span class="s2">&quot;Compile using: [&#39;h&#39;, &#39;cx&#39;, &#39;z&#39;, &#39;ccx&#39;, &#39;swap&#39;]&quot;</span>
+</pre></div>
+</div>
+</div>
+<p>Now, we call the diffusion model pipeline to generate encoded circuits based on the specified conditions: <code class="docutils literal notranslate"><span class="pre">prompt</span></code> and <code class="docutils literal notranslate"><span class="pre">U</span></code>. One of the key advantages of this method is that, once the model is trained, sampling new circuits is very fast. Therefore, under the same conditions defined above, we will generate 128 circuits and analyze them in the following sections.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[32]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Number of circuits to sample from the trained DM.</span>
+<span class="n">samples</span> <span class="o">=</span> <span class="mi">128</span>
+
+<span class="c1"># As the neural network works only with real numbers, we first separate</span>
+<span class="c1"># the two components and create a 2 dimensional tensor for the magnitude</span>
+<span class="c1"># of each component:</span>
+<span class="n">U_r</span><span class="p">,</span> <span class="n">U_i</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">Tensor</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">real</span><span class="p">(</span><span class="n">U</span><span class="p">)),</span> <span class="n">torch</span><span class="o">.</span><span class="n">Tensor</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">imag</span><span class="p">(</span><span class="n">U</span><span class="p">))</span>
+<span class="n">U_tensor</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">stack</span><span class="p">([</span><span class="n">U_r</span><span class="p">,</span> <span class="n">U_i</span><span class="p">],</span> <span class="n">dim</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="c1"># Now we generate a tensor representation of the desired quantum circuit using the DM based on the prompt and U. This is also known as inference.</span>
+<span class="n">out_tensors</span> <span class="o">=</span> <span class="n">infer_comp</span><span class="o">.</span><span class="n">generate_comp_tensors</span><span class="p">(</span>
+    <span class="n">pipeline</span><span class="o">=</span><span class="n">pipeline</span><span class="p">,</span>
+    <span class="n">prompt</span><span class="o">=</span><span class="n">prompt</span><span class="p">,</span>
+    <span class="n">U</span><span class="o">=</span><span class="n">U_tensor</span><span class="p">,</span>
+    <span class="n">samples</span><span class="o">=</span><span class="n">samples</span><span class="p">,</span>
+    <span class="n">system_size</span><span class="o">=</span>
+    <span class="n">num_of_qubits</span><span class="p">,</span>  <span class="c1"># Max qubit number allowed by the model (this model is only trained with 3 qubits)</span>
+    <span class="n">num_of_qubits</span><span class="o">=</span><span class="n">num_of_qubits</span><span class="p">,</span>
+    <span class="n">max_gates</span><span class="o">=</span><span class="n">max_gates</span><span class="p">,</span>
+    <span class="n">g</span><span class="o">=</span><span class="mi">10</span>  <span class="c1"># classifier-free-guidance (CFG) scale</span>
+<span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<p>Below is an example of a generated tensor which represents a quantum circuit:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[33]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">out_tensors</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[33]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],
+        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],
+        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])
+</pre></div></div>
+</div>
+</section>
+<section id="Convert-tensors-to-CUDA-Q">
+<h2>Convert tensors to CUDA-Q<a class="headerlink" href="#Convert-tensors-to-CUDA-Q" title="Permalink to this heading">¶</a></h2>
+<p>Next, we convert the generated tensors into <code class="docutils literal notranslate"><span class="pre">cudaq.kernels</span></code>.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[34]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;qpp-cpu&#39;</span><span class="p">)</span> <span class="c1"># Note that cpu is faster for 3 qubit kernels</span>
+
+<span class="c1"># cudaq.set_target(&#39;nvidia&#39;) # Set to GPU for larger circuits</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[35]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">kernel_list</span>   <span class="o">=</span> <span class="p">[]</span>
+<span class="n">valid_tensors</span> <span class="o">=</span> <span class="p">[]</span>
+
+<span class="n">invalid_tensors</span> <span class="o">=</span> <span class="mi">0</span>
+<span class="k">for</span> <span class="n">out_tensors_i</span> <span class="ow">in</span> <span class="n">tqdm</span><span class="p">(</span><span class="n">out_tensors</span><span class="p">):</span>
+
+    <span class="c1"># Use a try-except to catch invalid tensors (if any)</span>
+    <span class="k">try</span><span class="p">:</span>    <span class="n">kernel</span> <span class="o">=</span> <span class="n">genqc_to_cudaq</span><span class="p">(</span><span class="n">out_tensors_i</span><span class="p">,</span> <span class="n">vocab</span><span class="p">)</span>  <span class="c1"># Convert out_tensors to CUDA-Q kernels</span>
+    <span class="k">except</span><span class="p">:</span> <span class="n">kernel</span> <span class="o">=</span> <span class="kc">None</span>
+
+    <span class="k">if</span> <span class="n">kernel</span><span class="p">:</span>
+        <span class="n">kernel_list</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+        <span class="n">valid_tensors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">out_tensors_i</span><span class="p">)</span>
+    <span class="k">else</span><span class="p">:</span>
+        <span class="n">invalid_tensors</span> <span class="o">+=</span> <span class="mi">1</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;The model generated </span><span class="si">{</span><span class="n">invalid_tensors</span><span class="si">}</span><span class="s2"> invalid tensors that does not correspond to circuits.&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<script type="application/vnd.jupyter.widget-view+json">{"model_id": "1948691023bb4f03b79174564c1b8223", "version_major": 2, "version_minor": 0}</script></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+The model generated 1 invalid tensors that does not correspond to circuits.
+</pre></div></div>
+</div>
+<p>For example, the following tensor encoding</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[36]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">valid_tensors</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[36]:
+</pre></div>
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],
+        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],
+        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])
+</pre></div></div>
+</div>
+<p>corresponds to the following <code class="docutils literal notranslate"><span class="pre">cudaq.kernel</span></code></p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[37]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Arbitrary input state to the circuit for plotting</span>
+
+<span class="n">input_state</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">num_of_qubits</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel_list</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">input_state</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮╭───╮        ╭───╮╭───╮
+q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──
+     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮
+q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├
+       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯
+q2 : ──●──┤ h ├─╳───●──────────────●──
+          ╰───╯
+
+</pre></div></div>
+</div>
+</section>
+<section id="Evaluate-generated-circuits">
+<h2>Evaluate generated circuits<a class="headerlink" href="#Evaluate-generated-circuits" title="Permalink to this heading">¶</a></h2>
+<p>As mentioned earlier, one of the key advantages of using diffusion models (DMs) as a unitary compiler is the ability to rapidly sample many circuits. However, as is common in machine learning, the model has a certain accuracy, meaning not all generated circuits are expected to exactly compile the specified unitary. In this section, we will evaluate how many of the generated circuits are indeed correct and then perform post-selection to identify (at least) one circuit that successfully performs
+the desired unitary operation.</p>
+</section>
+<section id="Simulate-kernels">
+<h2>Simulate kernels<a class="headerlink" href="#Simulate-kernels" title="Permalink to this heading">¶</a></h2>
+<p>First, we calculate the unitary matrix <span class="math notranslate nohighlight">\(U\)</span> implemented by each of the kernels. The elements of this matrix are defined by the transition amplitudes between the basis states, which can be expressed as:</p>
+<div class="math notranslate nohighlight">
+\[\begin{equation}
+   \langle i|kernel|j\rangle = U_{ij},
+\end{equation}\]</div>
+<p>where <span class="math notranslate nohighlight">\(|i\rangle\)</span> and <span class="math notranslate nohighlight">\(|j\rangle\)</span> are computational basis states (typically in the <span class="math notranslate nohighlight">\(z\)</span>-basis), with <span class="math notranslate nohighlight">\(|n\rangle\)</span> representing the standard basis vector that has a 1 in the <span class="math notranslate nohighlight">\(n\)</span>-th position and 0 elsewhere.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[38]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">N</span> <span class="o">=</span> <span class="mi">2</span><span class="o">**</span><span class="n">num_of_qubits</span>
+
+<span class="n">got_unitaries</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="nb">len</span><span class="p">(</span><span class="n">kernel_list</span><span class="p">),</span> <span class="n">N</span><span class="p">,</span> <span class="n">N</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+
+<span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">kernel</span> <span class="ow">in</span> <span class="n">tqdm</span><span class="p">(</span><span class="nb">enumerate</span><span class="p">(</span><span class="n">kernel_list</span><span class="p">),</span> <span class="n">total</span><span class="o">=</span><span class="n">got_unitaries</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]):</span>
+    <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">N</span><span class="p">):</span>
+        <span class="n">basis_state_j</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">((</span><span class="n">N</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+        <span class="n">basis_state_j</span><span class="p">[</span><span class="n">j</span><span class="p">]</span> <span class="o">=</span> <span class="mi">1</span>
+
+        <span class="n">got_unitaries</span><span class="p">[</span><span class="n">i</span><span class="p">,</span> <span class="p">:,</span>
+                      <span class="n">j</span><span class="p">]</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">basis_state_j</span><span class="p">),</span>
+                                    <span class="n">copy</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<script type="application/vnd.jupyter.widget-view+json">{"model_id": "fdba942957904d7ea41ce9edeb6b9f48", "version_major": 2, "version_minor": 0}</script></div>
+</div>
+<p>For example, the circuit printed above corresponds to the following unitary:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">np</span><span class="o">.</span><span class="n">set_printoptions</span><span class="p">(</span><span class="n">linewidth</span><span class="o">=</span><span class="mi">1000</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">round</span><span class="p">(</span><span class="n">got_unitaries</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="mi">4</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]
+ [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]
+ [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]
+ [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]
+ [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]
+</pre></div></div>
+</div>
+</section>
+<section id="Compare-unitaries">
+<h2>Compare unitaries<a class="headerlink" href="#Compare-unitaries" title="Permalink to this heading">¶</a></h2>
+<p>Now that we have the unitaries for each of the kernels, we compare them to the user provided unitary matrix, <code class="docutils literal notranslate"><span class="pre">U</span></code>. To do so, we compute the infidelity between the exact unitary and the generated ones. The infidelity is a value between 0 and 1, where 0 indicates that the unitaries are identical (up to a global phase).</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">infidelity</span><span class="p">(</span><span class="n">want_unitary</span><span class="p">,</span> <span class="n">got_unitary</span><span class="p">):</span>
+    <span class="k">return</span> <span class="mi">1</span> <span class="o">-</span> <span class="n">np</span><span class="o">.</span><span class="n">abs</span><span class="p">(</span>
+        <span class="n">np</span><span class="o">.</span><span class="n">trace</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">conj</span><span class="p">(</span><span class="n">want_unitary</span><span class="p">)</span><span class="o">.</span><span class="n">T</span> <span class="o">@</span> <span class="n">got_unitary</span><span class="p">)</span> <span class="o">/</span> <span class="mi">2</span><span class="o">**</span><span class="n">num_of_qubits</span><span class="p">)</span><span class="o">**</span><span class="mi">2</span>
+
+
+<span class="n">infidelities</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span>
+    <span class="p">[</span><span class="n">infidelity</span><span class="p">(</span><span class="n">U</span><span class="p">,</span> <span class="n">got_unitary</span><span class="p">)</span> <span class="k">for</span> <span class="n">got_unitary</span> <span class="ow">in</span> <span class="n">got_unitaries</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<p>Let’s now plot an histogram of the infidelities for our generated circuits:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">plt</span><span class="o">.</span><span class="n">figure</span><span class="p">(</span><span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">7</span><span class="p">,</span> <span class="mi">4</span><span class="p">))</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">title</span><span class="p">(</span>
+    <span class="sa">f</span><span class="s2">&quot;Distribution of infidelities for </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">got_unitaries</span><span class="p">)</span><span class="si">}</span><span class="s2"> generated circuits&quot;</span><span class="p">,</span>
+    <span class="n">fontsize</span><span class="o">=</span><span class="mi">12</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s2">&quot;Number of circuits&quot;</span><span class="p">,</span> <span class="n">fontsize</span><span class="o">=</span><span class="mi">14</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s2">&quot;Unitary infidelity&quot;</span><span class="p">,</span> <span class="n">fontsize</span><span class="o">=</span><span class="mi">14</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">hist</span><span class="p">(</span><span class="n">infidelities</span><span class="p">,</span> <span class="n">bins</span><span class="o">=</span><span class="mi">30</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_unitary_compilation_41_0.png" src="../../../_images/examples_python_tutorials_unitary_compilation_41_0.png" />
+</div>
+</div>
+<p>As we can see, the model generated almost 30 circuits that compile the unitary with an infidelity close or equal to zero! The kernel with the lowest infidelity is:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">min_index</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">argmin</span><span class="p">(</span><span class="n">infidelities</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;The best kernel has an infidelity of </span><span class="si">{</span><span class="n">infidelities</span><span class="p">[</span><span class="n">min_index</span><span class="p">]</span><span class="si">:</span><span class="s2">0.2</span><span class="si">}</span><span class="s2">,&quot;</span><span class="p">)</span>
+
+<span class="n">input_state</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">*</span> <span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">num_of_qubits</span><span class="p">)</span>
+<span class="n">input_state</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel_list</span><span class="p">[</span><span class="n">min_index</span><span class="p">],</span> <span class="n">input_state</span><span class="p">))</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;with the unitary:&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">round</span><span class="p">(</span><span class="n">got_unitaries</span><span class="p">[</span><span class="n">min_index</span><span class="p">],</span> <span class="mi">4</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+The best kernel has an infidelity of 3.4e-09,
+     ╭───╮╭───╮        ╭───╮╭───╮
+q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──
+     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮
+q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├
+       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯
+q2 : ──●──┤ h ├─╳───●──────────────●──
+          ╰───╯
+
+with the unitary:
+[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]
+ [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]
+ [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]
+ [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]
+ [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]
+</pre></div></div>
+</div>
+<p>which, as we can see, exactly compiled our wanted unitary:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">round</span><span class="p">(</span><span class="n">U</span><span class="p">,</span> <span class="mi">4</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]
+ [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]
+ [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]
+ [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]
+ [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]
+ [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]
+</pre></div></div>
+</div>
+</section>
+<section id="Choosing-the-circuit-you-need">
+<h2>Choosing the circuit you need<a class="headerlink" href="#Choosing-the-circuit-you-need" title="Permalink to this heading">¶</a></h2>
+<p>As we have seen above, we now have almost 30 kernels that compile the desired unitary! This is particularly valuable when dealing with hardware constraints, where, for instance, we might want to avoid using certain qubits or specific gates. One practical example is finding the circuit with the fewest Toffoli gates (also known as <code class="docutils literal notranslate"><span class="pre">ccx</span></code>). In our <code class="docutils literal notranslate"><span class="pre">vocab</span></code> definition above, we identified that <code class="docutils literal notranslate"><span class="pre">ccx</span></code> corresponds to the label 5 in our tokenized tensors. Let’s use this information to search for the
+circuit that minimizes the number of <code class="docutils literal notranslate"><span class="pre">ccx</span></code> gates:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># First, we remove possible duplicates and only pick distinct circuits</span>
+<span class="n">_</span><span class="p">,</span> <span class="n">idx_unique</span>       <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">unique</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="n">valid_tensors</span><span class="p">),</span> <span class="n">axis</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">return_index</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<span class="n">unique_tensors</span>      <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">stack</span><span class="p">(</span><span class="n">valid_tensors</span><span class="p">)[</span><span class="n">idx_unique</span><span class="p">]</span>
+<span class="n">unique_infidelities</span> <span class="o">=</span> <span class="n">infidelities</span><span class="p">[</span><span class="n">idx_unique</span><span class="p">]</span>
+<span class="n">unique_kernels</span>      <span class="o">=</span> <span class="p">[</span><span class="n">kernel_list</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span> <span class="k">for</span> <span class="n">idx</span> <span class="ow">in</span> <span class="n">idx_unique</span><span class="p">]</span>
+
+<span class="c1"># Then, find the correct circuits</span>
+<span class="n">idx_correct</span>     <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">argwhere</span><span class="p">(</span><span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">(</span><span class="n">unique_infidelities</span><span class="p">)</span> <span class="o">&lt;</span> <span class="mf">0.01</span><span class="p">)</span><span class="o">.</span><span class="n">flatten</span><span class="p">()</span>
+<span class="n">correct_tensors</span> <span class="o">=</span> <span class="n">unique_tensors</span><span class="p">[</span><span class="n">idx_correct</span><span class="p">]</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;The model generated </span><span class="si">{</span><span class="n">correct_tensors</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="si">}</span><span class="s2"> distinct correct circuits.&quot;</span><span class="p">)</span>
+
+<span class="c1"># Now let&#39;s flatten the last two dimensions (related to the actual circuit) and find out how many 5&#39;s (i.e. ccx) gates each circuit has:</span>
+<span class="n">num_ccx</span> <span class="o">=</span> <span class="p">(</span><span class="n">correct_tensors</span><span class="o">.</span><span class="n">flatten</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">)</span> <span class="o">==</span> <span class="mi">5</span><span class="p">)</span><span class="o">.</span><span class="n">sum</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;These circuits have this number of ccx gates:&quot;</span><span class="p">,</span> <span class="n">num_ccx</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+The model generated 17 distinct correct circuits.
+These circuits have this number of ccx gates: tensor([1, 3, 3, 3, 3, 3, 3, 1, 1, 3, 3, 3, 1, 1, 1, 1, 1])
+</pre></div></div>
+</div>
+<p>As we can see, it appears that the diffusion model (DM) requires at least one Toffoli gate to compile the unitary. We can now print a few of these circuits to select the one that best suits our needs, or to study whether there are any interesting patterns the model employs for this specific unitary.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Get the correct kernels</span>
+<span class="n">correct_kernels</span> <span class="o">=</span> <span class="p">[</span><span class="n">unique_kernels</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span> <span class="k">for</span> <span class="n">idx</span> <span class="ow">in</span> <span class="n">idx_correct</span><span class="p">]</span>
+
+<span class="c1"># Get the ones with only one ccx</span>
+<span class="n">correct_kernels_ccx1</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="n">correct_kernels</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span> <span class="k">for</span> <span class="n">idx</span> <span class="ow">in</span> <span class="n">torch</span><span class="o">.</span><span class="n">argwhere</span><span class="p">(</span><span class="n">num_ccx</span> <span class="o">==</span> <span class="mi">1</span><span class="p">)</span><span class="o">.</span><span class="n">flatten</span><span class="p">()</span>
+<span class="p">]</span>
+
+<span class="c1"># Draw a few of this circuits</span>
+<span class="k">for</span> <span class="n">kernel</span> <span class="ow">in</span> <span class="n">correct_kernels_ccx1</span><span class="p">[:</span><span class="mi">3</span><span class="p">]:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">input_state</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+        ╭───╮╭───╮
+q0 : ───┤ x ├┤ z ├───────●───────
+        ╰─┬─╯├───┤╭───╮  │
+q1 : ─╳───●──┤ h ├┤ z ├──┼───────
+      │   │  ├───┤╰───╯╭─┴─╮╭───╮
+q2 : ─╳───●──┤ h ├─────┤ x ├┤ h ├
+             ╰───╯     ╰───╯╰───╯
+
+     ╭───╮╭───╮
+q0 : ┤ x ├┤ z ├──●──────────
+     ╰─┬─╯├───┤╭─┴─╮
+q1 : ──●──┤ h ├┤ x ├─╳──────
+       │  ├───┤├───┤ │ ╭───╮
+q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├
+          ╰───╯╰───╯   ╰───╯
+
+     ╭───╮╭───╮
+q0 : ┤ x ├┤ z ├──●──────────
+     ╰─┬─╯├───┤╭─┴─╮
+q1 : ──●──┤ h ├┤ x ├─╳──────
+       │  ├───┤├───┤ │ ╭───╮
+q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├
+          ╰───╯╰───╯   ╰───╯
+
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">__version__</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;genQC Version&quot;</span><span class="p">,</span> <span class="n">genQC</span><span class="o">.</span><span class="n">__version__</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a1ee37087fbd5c14a31d5de3441f92432d0dca68)
+genQC Version 0.1.0
+</pre></div></div>
+</div>
+<script type="application/vnd.jupyter.widget-state+json">
+{"state": {}, "version_major": 2, "version_minor": 0}
+</script></section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="Shors.html" class="btn btn-neutral float-left" title="Factoring Integers With Shor’s Algorithm" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../../using/backends/backends.html" class="btn btn-neutral float-right" title="CUDA-Q Backends" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/unitary_compilation.ipynb b/pr-2241/examples/python/tutorials/unitary_compilation.ipynb
new file mode 100644
index 0000000000..f0b3b1268b
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/unitary_compilation.ipynb
@@ -0,0 +1,1084 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d60f1e23-2541-4b01-84c8-0aff758061b4",
+   "metadata": {},
+   "source": [
+    "# Compiling Unitaries Using Diffusion Models\n",
+    "\n",
+    "This notebook is based on the work presented in [Quantum circuit synthesis with diffusion models, Florian Fürrutter, Gorka Muñoz-Gil & Hans J. Briegel , Nat. Mach. Intell. **6**, 515–524 (2024)](https://doi.org/10.1038/s42256-024-00831-9)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4b6a7722-f302-458b-9f90-8493e46d786d",
+   "metadata": {},
+   "source": [
+    "Quantum computing relies on efficiently translating quantum operations into viable physical realizations on existing quantum hardware. Recently, diffusion models — a powerful class of generative models in machine learning — have demonstrated exceptional performance on this task. \n",
+    "\n",
+    "In this tutorial notebook, we will demonstrate how to use this method to synthesize arbitrary unitaries into a `cudaq.kernel`, effectively decomposing them into sequences of quantum gates, a process commonly known as unitary compilation.\n",
+    "\n",
+    "Our focus will be on generating circuits using a pre-trained model. Specifically, we will illustrate how to compile 3-qubit unitaries."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "fef3bf4a-1008-4df8-b6e8-d5357db1f6d5",
+   "metadata": {},
+   "source": [
+    "### Diffusion model pipeline\n",
+    "\n",
+    "Generative diffusion models (DMs) have recently delivered remarkable results across a wide range of applications, from image generation to protein folding. In this work, we leverage DMs to generate quantum circuits based on a user specified unitary matrix and a text prompt that defines the allowed gate set, effectively using DMs as unitary compilers. The method is thoroughly explained in Ref. [(Fürrutter et al., 2024)](https://doi.org/10.1038/s42256-024-00831-9). The following figure  provides an overview of the proposed circuit generation pipeline:\n",
+    "\n",
+    "<figure>\n",
+    "  <img src=\"images/pipeline_simplified.png\" alt=\"Quantum circuit generation pipeline overview\" width=\"70%\"/>\n",
+    "  <figcaption><b>Quantum circuit generation pipeline</b>. Figure adapted from <a href=\"https://doi.org/10.1038/s42256-024-00831-9\">(Fürrutter et al., 2024)</a></figcaption>\n",
+    "</figure>\n",
+    "\n",
+    "The pipeline consists on 3 main components:\n",
+    "\n",
+    "**1) Circuit encoding:** Like any neural network, diffusion models operate with continuous inputs and outputs. However, since the circuits we consider are composed of discrete gates (i.e., with no continuous parameters), we develop a mapping that transforms each gate into a continuous vector. This allows us to represent a given circuit as a three-dimensional tensor, as illustrated. Crucially, this mapping is invertible: when the DM generates continuous tensors, we can apply the inverse map to convert them back into the circuit form. An overview of these steps is provided in the figure below:\n",
+    "\n",
+    "<figure>\n",
+    "  <img src=\"images/circuit_encoding.png\" alt=\"Quantum circuit encoding\" width=\"60%\"/>\n",
+    "  <figcaption><b>Quantum circuit encoding</b>. Figure adapted from <a href=\"https://doi.org/10.1038/s42256-024-00831-9\">(Fürrutter et al., 2024)</a></figcaption>\n",
+    "</figure>\n",
+    "\n",
+    "**2) Conditioning:** The user's input (the set of available gates and the unitary to compile) is also transformed into a continuous tensor by two neural networks. For the gate set description, where the input is a text prompt (e.g., \"Compile using ['x', 'h']\"), we utilize a pre-trained language model. For the unitary, we employ a neural network that is training jointly with the diffusion model.\n",
+    "\n",
+    "**3) Unitary compilation:** The generation procedure follows the typical DM process: the model is given a fully noisy tensor which is iteratively de-noised until reaching a clean sample based on the given conditioning (the desired unitary and gate set). The tensors generated by the DM are then mapped to circuits via the inverse encoding procedure. To learn more about the practical implementation of diffusion models we recommend [this tutorial](https://course.fast.ai/Lessons/lesson9.html). \n",
+    "\n",
+    "In the following we will use `CUDA-Q` and `genQC` to perform all these steps and go from a desired unitary matrix, $U$, to a quantum circuit that we can execute using CUDA-Q. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e1453ad1-e4d4-4e38-9684-fd967bc1a8de",
+   "metadata": {},
+   "source": [
+    "### Setup and compilation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "id": "f1b7d96a-92d4-46f3-95a6-1d1e46d63240",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.037362Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.036980Z",
+     "iopub.status.idle": "2024-08-27T18:11:38.867336Z",
+     "shell.execute_reply": "2024-08-27T18:11:38.866445Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.037346Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n",
+      "\u001b[0m"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install genQC==0.1.0 -q"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "id": "07d177c6-60fd-497d-ae2b-41e225b56a2d",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.868456Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.868206Z",
+     "iopub.status.idle": "2024-08-27T18:11:38.872654Z",
+     "shell.execute_reply": "2024-08-27T18:11:38.871931Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.868440Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import genQC\n",
+    "from genQC.imports import *\n",
+    "from genQC.pipeline.diffusion_pipeline import DiffusionPipeline\n",
+    "from genQC.inference.export_cudaq import genqc_to_cudaq\n",
+    "import genQC.inference.infer_compilation as infer_comp\n",
+    "import genQC.util as util\n",
+    "\n",
+    "import numpy as np\n",
+    "import torch\n",
+    "\n",
+    "# Fixed seed for reproducibility\n",
+    "torch.manual_seed(0)\n",
+    "np.random.seed(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "id": "ccb97524-0f13-49ff-893d-983c572e66c6",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.873619Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.873403Z",
+     "iopub.status.idle": "2024-08-27T18:11:39.025224Z",
+     "shell.execute_reply": "2024-08-27T18:11:39.024476Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.873603Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[INFO]: Cuda device has a capability of 8.0 (>= 8), allowing tf32 matmul.\n",
+      "cuda\n"
+     ]
+    }
+   ],
+   "source": [
+    "device = util.infer_torch_device()  # Use CUDA if we can\n",
+    "util.MemoryCleaner.purge_mem()  # Clean existing memory allocation\n",
+    "print(device)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "acf7656c-be92-4b36-8c38-d3ff6c1912e3",
+   "metadata": {},
+   "source": [
+    "### Load model"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "0047cbe9-a21c-4c72-a144-7a2929752329",
+   "metadata": {},
+   "source": [
+    "First, we load the pre-trained model weights and setup the DM pipeline.\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "id": "a6b18d03-6976-4eec-9ab0-7b763d73ad17",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:39.026541Z",
+     "iopub.status.busy": "2024-08-27T18:11:39.025956Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.879166Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.878426Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:39.026521Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "543d6667d288478d8d64b8e32c6675f3",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Fetching 2 files:   0%|          | 0/2 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[INFO]: `genQC.models.unet_qc.QC_Compilation_UNet` instantiated from given config on cuda.\n",
+      "[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder` instantiated from given config on cuda.\n",
+      "[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder`. No save_path` provided. No state dict loaded.\n"
+     ]
+    }
+   ],
+   "source": [
+    "pipeline = DiffusionPipeline.from_pretrained(\n",
+    "    \"Floki00/qc_unitary_3qubit\", device)  # Download from Hugging Face\n",
+    "pipeline.scheduler.set_timesteps(40)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bc112d57-71a8-403c-a0a9-d2f7d0eb7492",
+   "metadata": {},
+   "source": [
+    "Set parameters the model was trained on. Note that these are fixed and depend on the pre-trained model."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "id": "3037d98c-16fb-4a7f-bf37-7e9991b6603e",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.880376Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.879966Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.883994Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.883336Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.880352Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "vocab         = {i+1:gate for i, gate in enumerate(pipeline.gate_pool)}  # Gateset used during training, used for decoding\n",
+    "num_of_qubits = 3                                                        # Number of qubits\n",
+    "max_gates     = 12                                                       # Maximum number of gates"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9d7cc1c9-7ddd-4464-98b8-8dbcaa02a53e",
+   "metadata": {},
+   "source": [
+    "### Unitary compilation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b962aea8-9c46-4795-8b74-bca35900f1ed",
+   "metadata": {},
+   "source": [
+    "Let's start by defining the unitary we want to compile. Note that this model has been trained to compile unitaries that arise from circuits composed of the gates contain in `vocab`. While this is a universal gate set (i.e. can perform universal computation), it can only do so with an infinite number of gates. Because the number of gates in the model is restricted to 12, we can only expect the model to generate unitaries under this constraints. We will consider here the compilation of one of such unitary. Nonetheless, stay tuned for bigger and better models!\n",
+    "\n",
+    "We start by defining our unitary as a `numpy.matrix`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "id": "5107c719-4220-4209-a657-4a9c0766b80a",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.884880Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.884694Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.896385Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.895667Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.884863Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "U = np.matrix([[ 0.70710678,  0.        ,  0.        , 0.        ,  0.70710678,  0.        , 0.        ,  0.        ],\n",
+    "               [ 0.        , -0.70710678,  0.        , 0.        ,  0.        , -0.70710678, 0.        ,  0.        ],\n",
+    "               [-0.70710678,  0.        ,  0.        , 0.        ,  0.70710678,  0.        , 0.        ,  0.        ],\n",
+    "               [ 0.        ,  0.70710678,  0.        , 0.        ,  0.        , -0.70710678, 0.        ,  0.        ],\n",
+    "               [ 0.        ,  0.        ,  0.70710678, 0.        ,  0.        ,  0.        , 0.        ,  0.70710678],\n",
+    "               [ 0.        ,  0.        ,  0.        , 0.70710678,  0.        ,  0.        , 0.70710678,  0.        ],\n",
+    "               [ 0.        ,  0.        , -0.70710678, 0.        ,  0.        ,  0.        , 0.        ,  0.70710678],\n",
+    "               [ 0.        ,  0.        ,  0.        ,-0.70710678,  0.        ,  0.        , 0.70710678,  0.        ]], dtype=np.complex128)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "14954138-f16b-48f6-b35d-5b1ac00cff1e",
+   "metadata": {},
+   "source": [
+    "and check that the matrix is indeed unitary, i.e. $U^{\\dagger} U = U U^{\\dagger} = I$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "57164622-8359-4c58-b4d9-1b64ae603b43",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.897692Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.897368Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.904008Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.903243Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.897677Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "assert np.allclose(U.H @ U, np.identity(2**num_of_qubits)) and np.allclose(\n",
+    "    U @ U.H, np.identity(2**num_of_qubits))  #check if unitary"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c0ba07c5-075a-46ca-9a22-cc758ce33cb9",
+   "metadata": {},
+   "source": [
+    "The loaded model was trained on the gate set `['h', 'cx', 'z', 'x', 'ccx', 'swap']`. Specifically, it was trained to generate circuits using any arbitrary subset of this gate set. Therefore, during inference, we can instruct the model to compile the unitary using any of these subsets. However, it is crucial to follow the prompt structure `Compile using [...]`, as the model was trained with this specific format. For example, let's consider a scenario where we compile the unitary without using the `x` gate:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "0f0d3e85-a22e-4a1b-ad17-b02417e56734",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.905214Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.904884Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.912812Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.911995Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.905195Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "# Notice how the x gate missing from the prompt since this is a restriction we set\n",
+    "prompt = \"Compile using: ['h', 'cx', 'z', 'ccx', 'swap']\""
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "cab3a1e8-a404-4ebb-9a58-251d47eebb4a",
+   "metadata": {},
+   "source": [
+    "Now, we call the diffusion model pipeline to generate encoded circuits based on the specified conditions: `prompt` and `U`. One of the key advantages of this method is that, once the model is trained, sampling new circuits is very fast. Therefore, under the same conditions defined above, we will generate 128 circuits and analyze them in the following sections."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "56edb114-3ef7-455b-b4b8-0e262e7b6316",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.913747Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.913584Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.824624Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.823799Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.913732Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "# Number of circuits to sample from the trained DM.\n",
+    "samples = 128\n",
+    "\n",
+    "# As the neural network works only with real numbers, we first separate\n",
+    "# the two components and create a 2 dimensional tensor for the magnitude\n",
+    "# of each component:\n",
+    "U_r, U_i = torch.Tensor(np.real(U)), torch.Tensor(np.imag(U))\n",
+    "U_tensor = torch.stack([U_r, U_i], dim=0)\n",
+    "\n",
+    "# Now we generate a tensor representation of the desired quantum circuit using the DM based on the prompt and U. This is also known as inference.\n",
+    "out_tensors = infer_comp.generate_comp_tensors(\n",
+    "    pipeline=pipeline,\n",
+    "    prompt=prompt,\n",
+    "    U=U_tensor,\n",
+    "    samples=samples,\n",
+    "    system_size=\n",
+    "    num_of_qubits,  # Max qubit number allowed by the model (this model is only trained with 3 qubits)\n",
+    "    num_of_qubits=num_of_qubits,\n",
+    "    max_gates=max_gates,\n",
+    "    g=10  # classifier-free-guidance (CFG) scale\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "81f09d75-a960-4456-bdb9-57ef7668864e",
+   "metadata": {},
+   "source": [
+    "Below is an example of a generated tensor which represents a quantum circuit: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "13c1af73-11bc-46ca-99dd-bccea29f95c1",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.825914Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.825524Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.831202Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.830421Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.825898Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],\n",
+       "        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],\n",
+       "        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])"
+      ]
+     },
+     "execution_count": 33,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "out_tensors[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5605d0a1-626d-4aa5-8721-0416470215dc",
+   "metadata": {},
+   "source": [
+    "### Convert tensors to CUDA-Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b43d006-1e6a-4911-9283-b5a96eb5cf06",
+   "metadata": {},
+   "source": [
+    "Next, we convert the generated tensors into `cudaq.kernels`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "id": "01efc6f7-8f0f-425f-be58-7fcaf880d0fd",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.832305Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.831956Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.840723Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.839940Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.832289Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "cudaq.set_target('qpp-cpu') # Note that cpu is faster for 3 qubit kernels\n",
+    "\n",
+    "# cudaq.set_target('nvidia') # Set to GPU for larger circuits"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "id": "9d5b9ae5-c11e-413b-af00-4412dc86b48d",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.841741Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.841583Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.438113Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.437219Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.841726Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "1948691023bb4f03b79174564c1b8223",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/128 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The model generated 1 invalid tensors that does not correspond to circuits.\n"
+     ]
+    }
+   ],
+   "source": [
+    "kernel_list   = []\n",
+    "valid_tensors = []\n",
+    "\n",
+    "invalid_tensors = 0\n",
+    "for out_tensors_i in tqdm(out_tensors):\n",
+    "\n",
+    "    # Use a try-except to catch invalid tensors (if any)\n",
+    "    try:    kernel = genqc_to_cudaq(out_tensors_i, vocab)  # Convert out_tensors to CUDA-Q kernels\n",
+    "    except: kernel = None\n",
+    "        \n",
+    "    if kernel:\n",
+    "        kernel_list.append(kernel)\n",
+    "        valid_tensors.append(out_tensors_i)\n",
+    "    else:\n",
+    "        invalid_tensors += 1 \n",
+    "\n",
+    "print(f\"The model generated {invalid_tensors} invalid tensors that does not correspond to circuits.\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0a5823e6-9189-46b7-974d-43a2a0cad531",
+   "metadata": {},
+   "source": [
+    "For example, the following tensor encoding"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "id": "dc7d35c7-a7cb-4663-8220-b1030e534deb",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.439383Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.438787Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.443973Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.443101Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.439367Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],\n",
+       "        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],\n",
+       "        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])"
+      ]
+     },
+     "execution_count": 36,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "valid_tensors[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "47116105-b1e1-454e-80fc-6a03061045f5",
+   "metadata": {},
+   "source": [
+    "corresponds to the following `cudaq.kernel`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "4835c288-b018-49d7-b307-3ff05c2c8c56",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.444990Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.444651Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.569067Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.568320Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.444975Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮        ╭───╮╭───╮     \n",
+      "q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──\n",
+      "     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮\n",
+      "q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├\n",
+      "       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯\n",
+      "q2 : ──●──┤ h ├─╳───●──────────────●──\n",
+      "          ╰───╯                       \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Arbitrary input state to the circuit for plotting\n",
+    "\n",
+    "input_state = [0] * (2**num_of_qubits)\n",
+    "\n",
+    "print(cudaq.draw(kernel_list[0], input_state))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "59809685-5d70-4612-8642-c4e924a1ab6c",
+   "metadata": {},
+   "source": [
+    "### Evaluate generated circuits\n",
+    "\n",
+    "As mentioned earlier, one of the key advantages of using diffusion models (DMs) as a unitary compiler is the ability to rapidly sample many circuits. However, as is common in machine learning, the model has a certain accuracy, meaning not all generated circuits are expected to exactly compile the specified unitary. In this section, we will evaluate how many of the generated circuits are indeed correct and then perform post-selection to identify (at least) one circuit that successfully performs the desired unitary operation."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2685d88b-aceb-4a8c-8404-f744196d34c5",
+   "metadata": {},
+   "source": [
+    "### Simulate kernels"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "f5d1e8ca-3abf-47b4-bbca-932bdff86f94",
+   "metadata": {},
+   "source": [
+    "First, we calculate the unitary matrix $U$ implemented by each of the kernels. The elements of this matrix are defined by the transition amplitudes between the basis states, which can be expressed as:\n",
+    "$$\n",
+    "\\begin{equation}\n",
+    "   \\langle i|kernel|j\\rangle = U_{ij},\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "where $|i\\rangle$ and $|j\\rangle$ are computational basis states (typically in the $z$-basis), with $|n\\rangle$ representing the standard basis vector that has a 1 in the $n$-th position and 0 elsewhere."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "id": "11143924-c33f-4fd5-8f04-422eba9ed5a0",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.570028Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.569786Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.873950Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.873023Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.570011Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "fdba942957904d7ea41ce9edeb6b9f48",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/127 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "N = 2**num_of_qubits\n",
+    "\n",
+    "got_unitaries = np.zeros((len(kernel_list), N, N), dtype=np.complex128)\n",
+    "\n",
+    "for i, kernel in tqdm(enumerate(kernel_list), total=got_unitaries.shape[0]):\n",
+    "    for j in range(N):\n",
+    "        basis_state_j = np.zeros((N), dtype=np.complex128)\n",
+    "        basis_state_j[j] = 1\n",
+    "\n",
+    "        got_unitaries[i, :,\n",
+    "                      j] = np.array(cudaq.get_state(kernel, basis_state_j),\n",
+    "                                    copy=False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5eb62ba-40a6-486c-b307-47b11b9b3226",
+   "metadata": {},
+   "source": [
+    "For example, the circuit printed above corresponds to the following unitary:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4a471612-a3e4-4bea-9f61-dc823283af95",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.875219Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.874792Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.879735Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.878882Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.875200Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "np.set_printoptions(linewidth=1000)\n",
+    "print(np.round(got_unitaries[0], 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "203def54-bb97-4344-8544-6b1374b3f9a3",
+   "metadata": {},
+   "source": [
+    "### Compare unitaries"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e5241775-2692-4b10-b9ef-a75a3ddb0eb8",
+   "metadata": {},
+   "source": [
+    "Now that we have the unitaries for each of the kernels, we compare them to the user provided unitary matrix, `U`. To do so, we compute the infidelity between the exact unitary and the generated ones. The infidelity is a value between 0 and 1, where 0 indicates that the unitaries are identical (up to a global phase)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bb4915e8-5a92-4038-ab49-fa67a0a5b668",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.880925Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.880574Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.891293Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.890501Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.880909Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "def infidelity(want_unitary, got_unitary):\n",
+    "    return 1 - np.abs(\n",
+    "        np.trace(np.conj(want_unitary).T @ got_unitary) / 2**num_of_qubits)**2\n",
+    "\n",
+    "\n",
+    "infidelities = np.array(\n",
+    "    [infidelity(U, got_unitary) for got_unitary in got_unitaries])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2ae9d89-3aab-43db-85cb-2aa6fc494d87",
+   "metadata": {},
+   "source": [
+    "Let's now plot an histogram of the infidelities for our generated circuits:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c8313728-3a69-475b-bf3c-f0a8b8e8324a",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.892419Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.892234Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.982604Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.981724Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.892404Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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iEgimJgRERERSQQTMyIiIiKJYGJGREREJBFMzIiIiIgkgokZERERkUQwMSMiIiKSCCZmRERERBLBxIyIiIhIIpiYEREREUkEEzMiIiIiiWBiRkRERCQRTMyIiIiIJIKJGREREZFEMDEjIiIikggmZkREREQSwcSMiIiISCKYmBERERFJhCQTs1u3buGjjz5CxYoVYWNjg9dffx1Hjx5VrxdCYMKECXB1dYWNjQ2CgoJw5cqVUoyYiIiIyHCSS8wePXoEPz8/WFpaYvv27Th//jxmz54Ne3t7dZ1Zs2bhhx9+wKJFi3D48GGUL18ewcHBePbsWSlGTkRERGQYi9IO4GUzZ86Eh4cHIiMj1WVVq1ZV/78QAnPnzsXXX3+Nzp07AwCWLVsGZ2dnbNy4ET179izxmImIiIiMQXIjZps3b0ajRo3QrVs3VKpUCW+++SYWL16sXn/jxg0kJSUhKChIXaZUKtG0aVPExcXl22ZGRgZSU1M1FiIiIiKpkVxidv36dSxcuBDVq1fHjh078Pnnn+OLL77A0qVLAQBJSUkAAGdnZ43tnJ2d1eteFhERAaVSqV48PDyK900QERER6UFyiVlOTg4aNGiA6dOn480338TAgQMxYMAALFq0SO82w8LCoFKp1EtiYqIRIyYiIiIyDsklZq6urqhTp45GWe3atZGQkAAAcHFxAQAkJydr1ElOTlave5lcLodCodBYiIiIiKRGcomZn58fLl26pFF2+fJleHp6AvjvQgAXFxfs3r1bvT41NRWHDx+Gr69vicZKREREZEySuypzxIgRaN68OaZPn47u3bvjn3/+wc8//4yff/4ZACCTyTB8+HBMnToV1atXR9WqVTF+/Hi4ubmhS5cupRs8ERERkQEkl5g1btwYGzZsQFhYGCZPnoyqVati7ty5+PDDD9V1Ro0ahSdPnmDgwIFISUmBv78/YmJiYG1tXYqRExERERlGJoQQum505swZHDlyBO+//756vtbTp08RGhqKzZs3w8bGBl999RU+++wzowdsDKmpqVAqlVCpVJxvRvQK8RqzzeA24md0NEIkRETa0yXv0GuO2dSpUzF+/HjY2tqqy8aOHYuffvoJaWlpSExMxODBg7Fr1y59miciIiIySXolZv/88w9atWoFmUwGAMjKykJkZCSaNGmCu3fv4saNG3BycsL3339v1GCJiIiI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P/OUNW3aFACM9rPyiwrru1yv6rEmkgomZkQmxtraGt27d8e9e/cwderUPOvPnDmDX375Bba2tnj33XeNvn97e3vIZDIkJibmWVepUiXY2Njg+PHjSE9PV5c/evQIQ4cONWi/n376KbKystCtWzcIIV6Ziei9e/dGZmYmJkyYoFG+c+fOfJ8U0LdvX9ja2mLcuHE4d+5cnvXp6enqeWi6KqzvXvSqHmsiKeAcMyITNHv2bBw+fBiTJk3C1q1bERAQAGtra1y+fBmbN2+GEAK///57offX0leFChXQuHFjHDhwAL1790b16tVhZmaG3r17w9PTE4MGDcLs2bPxxhtvoFOnTkhNTcX27dvh6emZ793ytfXWW2/B09MTN2/ehIuLCzp16mTEd1V8Ro0ahfXr12Px4sU4d+4cWrZsicTERKxZswYdO3bEtm3bNOo7OTlh5cqV6NatG9544w289dZbqFWrFjIyMhAfH4/9+/ejefPmiImJ0TmWovou16t6rImkgIkZkQmqVKkSjhw5gjlz5mDjxo346aefkJmZCRcXF7z//vv46quv8Oabbxbb/pcvX44RI0Zg69atUKlUEELA398fnp6eiIiIgIODA6KiorBgwQI4OzujV69emDhxIl577TW995mbQEydOhV9+vRRT86XuvLly2P//v0ICwvDhg0bcPz4cdStWxerV6+GSqXKk5gB/10deeLECXzzzTeIjY3Frl27UL58ebi7u6Nv37746KOP9I6nsL7L9aoeayIpkAkhRGkHQURUEt5++21ER0fj8uXLqFatWmmHU6bxWBPph3PMiMgknD9/HtHR0Wjbti0ThWLGY02kP44vE1GZtmLFCly6dAnLli0DAISHh5dyRGUXjzWR4ZiYEVGZ9vPPP+PPP/+Ep6cnlixZgubNm5d2SGUWjzWR4TjHjIiIiEgiOMeMiIiISCKYmBERERFJBBMzIiIiIolgYkZEREQkEUzMiIiIiCSCiRkRERGRRDAxIyIiIpIIJmZEREREEvF/hgK9PnrrOcMAAAAASUVORK5CYII=",
+      "text/plain": [
+       "<Figure size 700x400 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.figure(figsize=(7, 4))\n",
+    "plt.title(\n",
+    "    f\"Distribution of infidelities for {len(got_unitaries)} generated circuits\",\n",
+    "    fontsize=12)\n",
+    "plt.ylabel(\"Number of circuits\", fontsize=14)\n",
+    "plt.xlabel(\"Unitary infidelity\", fontsize=14)\n",
+    "plt.hist(infidelities, bins=30)\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f1912f6c-e685-4994-bf3a-fe9530dbd513",
+   "metadata": {},
+   "source": [
+    "As we can see, the model generated almost 30 circuits that compile the unitary with an infidelity close or equal to zero! The kernel with the lowest infidelity is:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "656baf92-5a1e-4227-ac1f-67b5f9394310",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.983493Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.983309Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.988444Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.987556Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.983478Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The best kernel has an infidelity of 3.4e-09,\n",
+      "     ╭───╮╭───╮        ╭───╮╭───╮     \n",
+      "q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──\n",
+      "     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮\n",
+      "q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├\n",
+      "       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯\n",
+      "q2 : ──●──┤ h ├─╳───●──────────────●──\n",
+      "          ╰───╯                       \n",
+      "\n",
+      "with the unitary:\n",
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "min_index = np.argmin(infidelities)\n",
+    "\n",
+    "print(f\"The best kernel has an infidelity of {infidelities[min_index]:0.2},\")\n",
+    "\n",
+    "input_state = [0] * (2**num_of_qubits)\n",
+    "input_state[0] = 1\n",
+    "print(cudaq.draw(kernel_list[min_index], input_state))\n",
+    "\n",
+    "print(f\"with the unitary:\")\n",
+    "print(np.round(got_unitaries[min_index], 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e724b39-cc63-40c8-8ad0-9d90d94e23bd",
+   "metadata": {},
+   "source": [
+    "which, as we can see, exactly compiled our wanted unitary:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "46d190d6-7bed-4490-a343-bf856190a101",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.989293Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.989114Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.996387Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.995546Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.989278Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(np.round(U, 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f8bf2fe6-07ca-4bfa-a46b-96a91daeb185",
+   "metadata": {},
+   "source": [
+    "### Choosing the circuit you need"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "983dc8c1-f3ae-4d06-ad7a-e57addfc6e74",
+   "metadata": {},
+   "source": [
+    "As we have seen above, we now have almost 30 kernels that compile the desired unitary! This is particularly valuable when dealing with hardware constraints, where, for instance, we might want to avoid using certain qubits or specific gates. One practical example is finding the circuit with the fewest Toffoli gates (also known as `ccx`). In our `vocab` definition above, we identified that `ccx` corresponds to the label 5 in our tokenized tensors. Let's use this information to search for the circuit that minimizes the number of `ccx` gates:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "acb0f4d8-2e8a-4b32-9e37-006571ca2aa5",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.997443Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.997033Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.005395Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.004630Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.997427Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The model generated 17 distinct correct circuits.\n",
+      "These circuits have this number of ccx gates: tensor([1, 3, 3, 3, 3, 3, 3, 1, 1, 3, 3, 3, 1, 1, 1, 1, 1])\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First, we remove possible duplicates and only pick distinct circuits\n",
+    "_, idx_unique       = np.unique(np.array(valid_tensors), axis=0, return_index=True)\n",
+    "unique_tensors      = torch.stack(valid_tensors)[idx_unique]\n",
+    "unique_infidelities = infidelities[idx_unique]\n",
+    "unique_kernels      = [kernel_list[idx] for idx in idx_unique]\n",
+    "\n",
+    "# Then, find the correct circuits\n",
+    "idx_correct     = torch.argwhere(torch.tensor(unique_infidelities) < 0.01).flatten()\n",
+    "correct_tensors = unique_tensors[idx_correct]\n",
+    "print(f\"The model generated {correct_tensors.shape[0]} distinct correct circuits.\")\n",
+    "\n",
+    "# Now let's flatten the last two dimensions (related to the actual circuit) and find out how many 5's (i.e. ccx) gates each circuit has:\n",
+    "num_ccx = (correct_tensors.flatten(1,2) == 5).sum(1)\n",
+    "print(\"These circuits have this number of ccx gates:\", num_ccx)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7625aac1-78d8-4ce3-9765-88ae48c92dd3",
+   "metadata": {},
+   "source": [
+    "As we can see, it appears that the diffusion model (DM) requires at least one Toffoli gate to compile the unitary. We can now print a few of these circuits to select the one that best suits our needs, or to study whether there are any interesting patterns the model employs for this specific unitary."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "535501a6-cafb-48e6-b53c-636d7ac5a815",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:56.006584Z",
+     "iopub.status.busy": "2024-08-27T18:11:56.006136Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.013882Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.013117Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:56.006569Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "        ╭───╮╭───╮               \n",
+      "q0 : ───┤ x ├┤ z ├───────●───────\n",
+      "        ╰─┬─╯├───┤╭───╮  │       \n",
+      "q1 : ─╳───●──┤ h ├┤ z ├──┼───────\n",
+      "      │   │  ├───┤╰───╯╭─┴─╮╭───╮\n",
+      "q2 : ─╳───●──┤ h ├─────┤ x ├┤ h ├\n",
+      "             ╰───╯     ╰───╯╰───╯\n",
+      "\n",
+      "     ╭───╮╭───╮             \n",
+      "q0 : ┤ x ├┤ z ├──●──────────\n",
+      "     ╰─┬─╯├───┤╭─┴─╮        \n",
+      "q1 : ──●──┤ h ├┤ x ├─╳──────\n",
+      "       │  ├───┤├───┤ │ ╭───╮\n",
+      "q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├\n",
+      "          ╰───╯╰───╯   ╰───╯\n",
+      "\n",
+      "     ╭───╮╭───╮             \n",
+      "q0 : ┤ x ├┤ z ├──●──────────\n",
+      "     ╰─┬─╯├───┤╭─┴─╮        \n",
+      "q1 : ──●──┤ h ├┤ x ├─╳──────\n",
+      "       │  ├───┤├───┤ │ ╭───╮\n",
+      "q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├\n",
+      "          ╰───╯╰───╯   ╰───╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Get the correct kernels\n",
+    "correct_kernels = [unique_kernels[idx] for idx in idx_correct]\n",
+    "\n",
+    "# Get the ones with only one ccx\n",
+    "correct_kernels_ccx1 = [\n",
+    "    correct_kernels[idx] for idx in torch.argwhere(num_ccx == 1).flatten()\n",
+    "]\n",
+    "\n",
+    "# Draw a few of this circuits\n",
+    "for kernel in correct_kernels_ccx1[:3]:\n",
+    "    print(cudaq.draw(kernel, input_state))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "dd32819f-8bb6-4af8-bf69-84b600ba7ad5",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:56.020863Z",
+     "iopub.status.busy": "2024-08-27T18:11:56.020639Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.027045Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.026361Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:56.020849Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a1ee37087fbd5c14a31d5de3441f92432d0dca68)\n",
+      "genQC Version 0.1.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)\n",
+    "print(\"genQC Version\", genQC.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "widgets": {
+   "application/vnd.jupyter.widget-state+json": {
+    "state": {},
+    "version_major": 2,
+    "version_minor": 0
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/examples/python/tutorials/visualization.html b/pr-2241/examples/python/tutorials/visualization.html
new file mode 100644
index 0000000000..49901db15f
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/visualization.html
@@ -0,0 +1,935 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Visualization &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Computing Expectation Values" href="../../../using/examples/expectation_values.html" />
+    <link rel="prev" title="Quantum Computing 101" href="../../../using/examples/quantum_operations.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/examples/examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Visualization</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/visualization.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../../../using/examples/quantum_operations.html" class="btn btn-neutral float-left" title="Quantum Computing 101" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../../using/examples/expectation_values.html" class="btn btn-neutral float-right" title="Computing Expectation Values" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Visualization">
+<h1>Visualization<a class="headerlink" href="#Visualization" title="Permalink to this heading">¶</a></h1>
+<section id="Qubit-Visualization">
+<h2>Qubit Visualization<a class="headerlink" href="#Qubit-Visualization" title="Permalink to this heading">¶</a></h2>
+<p>What are the possible states a qubit can be in and how can we build up a visual cue to help us make sense of quantum states and their evolution?</p>
+<p>We know our qubit can have two distinct states: <span class="math notranslate nohighlight">\(\ket{0}\)</span> and <span class="math notranslate nohighlight">\(\ket{1}\)</span>. If these were the only two states, we could represent them as two vectors on a one-dimensional line (i.e., the z-axis in the image below). We also know that qubits can be in an equal superposition of states: <span class="math notranslate nohighlight">\(\ket{+}\)</span> and <span class="math notranslate nohighlight">\(\ket{-}\)</span>. In order to capture all of the states in equal superposition, we will need a 2D plane (i.e., the <span class="math notranslate nohighlight">\(xy\)</span>-plane in the image below). If you dive deeper you will learn
+about the existence of other states that will call for a 3D extension.</p>
+<p>In general, a quantum state can be written in the form <span class="math notranslate nohighlight">\(\ket{\psi} = \cos(\frac{\theta}{2})\ket{0}+e^{i\varphi}\sin(\frac{\theta}{2})\ket{1}\)</span> where <span class="math notranslate nohighlight">\(\theta\)</span> is a real number between <span class="math notranslate nohighlight">\(0\)</span> and <span class="math notranslate nohighlight">\(\pi\)</span> and <span class="math notranslate nohighlight">\(\varphi\)</span> is a real value between <span class="math notranslate nohighlight">\(0\)</span> and <span class="math notranslate nohighlight">\(2\pi\)</span>. For example, the minus state, <span class="math notranslate nohighlight">\(\ket{-} = \frac{1}{\sqrt{2}}\ket{0}- \frac{1}{\sqrt{2}}\ket{1}\)</span>, can be rewritten as</p>
+<div class="math notranslate nohighlight">
+\[\ket{-}  = \cos(\frac{\theta}{2})\ket{0}+e^{i\varphi}\sin(\frac{\theta}{2})\ket{1}\text{ with }\theta = \frac{\pi}{2}\text{ and }\varphi = \pi.\]</div>
+<p>This can be visualized in the image below as a unit vector pointing in the direction of the negative <span class="math notranslate nohighlight">\(x\)</span>-axis.</p>
+<p>Using spherical coordinates, it is possible to depict all the possible states of a single qubit on a sphere. This is called a Bloch sphere.</p>
+<p><img alt="Bloch Sphere" class="no-scaled-link" src="../../../_images/Bloch_sphere.png" style="width: 300px; height: 300px;" /></p>
+<p>Let us try to showcase the functionality to render such a 3D representation with CUDA-Q. First, let us define a single-qubit kernel that returns a different state each time. This kernel uses random rotations.</p>
+<p>Note: CUDA-Q uses the <a class="reference external" href="https://qutip.org">QuTiP</a> library to render Bloch spheres. The following code will throw an error if QuTiP is not installed.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># install `qutip` in the current Python kernel. Skip this if `qutip` is already installed.</span>
+<span class="c1"># `matplotlib` is required for all visualization tasks.</span>
+<span class="c1"># Make sure to restart your kernel if you execute this!</span>
+<span class="c1"># In a Jupyter notebook, go to the menu bar &gt; Kernel &gt; Restart Kernel.</span>
+<span class="c1"># In VSCode, click on the Restart button in the Jupyter toolbar.</span>
+
+<span class="c1"># The &#39;\&#39; before the &#39;&gt;&#39; operator is so that the shell does not misunderstand</span>
+<span class="c1"># the &#39;&gt;&#39; qualifier for the bash pipe operation.</span>
+
+<span class="kn">import</span> <span class="nn">sys</span>
+
+<span class="k">try</span><span class="p">:</span>
+    <span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+    <span class="kn">import</span> <span class="nn">qutip</span>
+
+<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Tools not found, installing. Please restart your kernel after this is done.&quot;</span><span class="p">)</span>
+    <span class="o">!{</span>sys.executable<span class="o">}</span><span class="w"> </span>-m<span class="w"> </span>pip<span class="w"> </span>install<span class="w"> </span>qutip<span class="se">\&gt;</span><span class="o">=</span><span class="m">5</span><span class="w"> </span>matplotlib<span class="se">\&gt;</span><span class="o">=</span><span class="m">3</span>.5
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">New libraries have been installed. Please restart your kernel!&quot;</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+Tools not found, installing. Please restart your kernel after this is done.
+Collecting qutip&gt;=5
+  Downloading qutip-5.0.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (28.0 MB)
+     <span class="ansi-black-intense-fg">━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━</span> <span class="ansi-green-fg">28.0/28.0 MB</span> <span class="ansi-red-fg">19.3 MB/s</span> eta <span class="ansi-cyan-fg">0:00:00</span>
+Requirement already satisfied: matplotlib&gt;=3.5 in /usr/local/lib/python3.10/dist-packages (3.9.2)
+Requirement already satisfied: scipy&gt;=1.9 in /usr/local/lib/python3.10/dist-packages (from qutip&gt;=5) (1.10.1)
+Requirement already satisfied: numpy&gt;=1.22 in /usr/local/lib/python3.10/dist-packages (from qutip&gt;=5) (1.26.4)
+Requirement already satisfied: packaging in /usr/local/lib/python3.10/dist-packages (from qutip&gt;=5) (24.1)
+Requirement already satisfied: contourpy&gt;=1.0.1 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (1.3.0)
+Requirement already satisfied: python-dateutil&gt;=2.7 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (2.9.0.post0)
+Requirement already satisfied: fonttools&gt;=4.22.0 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (4.54.1)
+Requirement already satisfied: cycler&gt;=0.10 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (0.12.1)
+Requirement already satisfied: pyparsing&gt;=2.3.1 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (3.1.4)
+Requirement already satisfied: kiwisolver&gt;=1.3.1 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (1.4.7)
+Requirement already satisfied: pillow&gt;=8 in /usr/local/lib/python3.10/dist-packages (from matplotlib&gt;=3.5) (10.4.0)
+Requirement already satisfied: six&gt;=1.5 in /usr/lib/python3/dist-packages (from python-dateutil&gt;=2.7-&gt;matplotlib&gt;=3.5) (1.16.0)
+Installing collected packages: qutip
+Successfully installed qutip-5.0.4
+<span class="ansi-yellow-fg">WARNING: Running pip as the &#39;root&#39; user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv</span><span class="ansi-yellow-fg">
+</span>
+New libraries have been installed. Please restart your kernel!
+</pre></div></div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1">## Retry the subsequent cells by setting the target to density matrix simulator.</span>
+<span class="c1"># cudaq.set_target(&quot;density-matrix-cpu&quot;)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angles</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">):</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">rz</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubit</span><span class="p">)</span>
+    <span class="n">rx</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qubit</span><span class="p">)</span>
+    <span class="n">rz</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">qubit</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<p>Next, we instantiate a random number generator, so we can get random outputs. We then create 4 random single-qubit states by using <code class="docutils literal notranslate"><span class="pre">cudaq.add_to_bloch_sphere()</span></code> on the output state obtained from the random kernel.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="o">=</span><span class="mi">11</span><span class="p">)</span>
+<span class="n">blochSphereList</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">4</span><span class="p">):</span>
+    <span class="n">angleList</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">random</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="o">*</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span>
+    <span class="n">sph</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">add_to_bloch_sphere</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">angleList</span><span class="p">))</span>
+    <span class="n">blochSphereList</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">sph</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<p>We can display the spheres with <code class="docutils literal notranslate"><span class="pre">cudaq.show()</span></code>. Show the first sphere:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">show</span><span class="p">(</span><span class="n">blochSphereList</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_visualization_7_0.png" src="../../../_images/examples_python_tutorials_visualization_7_0.png" />
+</div>
+</div>
+<p>We can also show multiple Bloch spheres side by side - simply set the <code class="docutils literal notranslate"><span class="pre">nrows</span></code> and <code class="docutils literal notranslate"><span class="pre">ncols</span></code> in the call to <code class="docutils literal notranslate"><span class="pre">cudaq.show()</span></code> accordingly. Make sure to have more spaces than spheres in your list, else it will throw an error! Let us show two spheres in a row:</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">show</span><span class="p">(</span><span class="n">blochSphereList</span><span class="p">[:</span><span class="mi">2</span><span class="p">],</span> <span class="n">nrows</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">ncols</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_visualization_9_0.png" src="../../../_images/examples_python_tutorials_visualization_9_0.png" />
+</div>
+</div>
+<p>We can show them in a column too, if we want! Simply set the <code class="docutils literal notranslate"><span class="pre">nrows</span> <span class="pre">=</span> <span class="pre">2</span></code> and <code class="docutils literal notranslate"><span class="pre">ncols</span> <span class="pre">=</span> <span class="pre">1</span></code>.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">show</span><span class="p">(</span><span class="n">blochSphereList</span><span class="p">[:</span><span class="mi">2</span><span class="p">],</span> <span class="n">nrows</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">ncols</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_visualization_11_0.png" src="../../../_images/examples_python_tutorials_visualization_11_0.png" />
+</div>
+</div>
+<p>Can we show the entire list of 4 Bloch spheres we created? Absolutely!</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[7]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">show</span><span class="p">(</span><span class="n">blochSphereList</span><span class="p">[:],</span> <span class="n">nrows</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">ncols</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_visualization_13_0.png" src="../../../_images/examples_python_tutorials_visualization_13_0.png" />
+</div>
+</div>
+<p>What if we had to add multiple vectors to a single Bloch sphere? CUDA-Q uses the <a class="reference external" href="https://www.qutip.org">QuTiP</a> toolbox to construct Bloch spheres. We can then add multiple states to the same Bloch sphere by passing the sphere object as an argument to <code class="docutils literal notranslate"><span class="pre">cudaq.add_to_bloch_sphere()</span></code>.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[8]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">qutip</span>
+
+<span class="n">rng</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="n">seed</span><span class="o">=</span><span class="mi">47</span><span class="p">)</span>
+<span class="n">blochSphere</span> <span class="o">=</span> <span class="n">qutip</span><span class="o">.</span><span class="n">Bloch</span><span class="p">()</span>
+<span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">10</span><span class="p">):</span>
+    <span class="n">angleList</span> <span class="o">=</span> <span class="n">rng</span><span class="o">.</span><span class="n">random</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="o">*</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span>
+    <span class="n">sph</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">add_to_bloch_sphere</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">angleList</span><span class="p">),</span> <span class="n">blochSphere</span><span class="p">)</span>
+<br/></pre></div>
+</div>
+</div>
+<p>This created a single Bloch sphere with 10 random vectors. Let us see how it looks.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[9]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">blochSphere</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_visualization_17_0.png" src="../../../_images/examples_python_tutorials_visualization_17_0.png" />
+</div>
+</div>
+<p>Unfortunately, there is no such handy visualization for multi-qubit states. In particular, a multi-qubit state cannot be visualized as multiple Bloch spheres due to the nature of entanglement that makes quantum computing so powerful.</p>
+</section>
+<section id="Kernel-Visualization">
+<h2>Kernel Visualization<a class="headerlink" href="#Kernel-Visualization" title="Permalink to this heading">¶</a></h2>
+<p>A CUDA-Q kernel can be visualized using the <code class="docutils literal notranslate"><span class="pre">cudaq.draw</span></code> API which returns a string representing the drawing of the execution path, in the specified format. ASCII (default) and LaTeX formats are supported.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[10]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel_to_draw</span><span class="p">():</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">y</span><span class="o">.</span><span class="n">ctrl</span><span class="p">([</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]],</span> <span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="n">z</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+
+    <span class="n">swap</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">swap</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">3</span><span class="p">])</span>
+    <span class="n">swap</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+
+    <span class="n">r1</span><span class="p">(</span><span class="mf">3.14159</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">tdg</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">s</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[11]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel_to_draw</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+     ╭───╮                  ╭───────────╮
+q0 : ┤ h ├──●────●────╳───╳─┤ r1(3.142) ├───────
+     ├───┤╭─┴─╮  │    │   │ ╰───────────╯╭─────╮
+q1 : ┤ h ├┤ x ├──●────╳───┼───────╳──────┤ tdg ├
+     ├───┤╰───╯╭─┴─╮╭───╮ │       │      ╰┬───┬╯
+q2 : ┤ h ├─────┤ y ├┤ z ├─┼───────╳───────┤ s ├─
+     ├───┤     ╰───╯╰───╯ │               ╰───╯
+q3 : ┤ h ├────────────────╳─────────────────────
+     ╰───╯
+
+</pre></div></div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[12]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="s1">&#39;latex&#39;</span><span class="p">,</span> <span class="n">kernel_to_draw</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+\documentclass{minimal}
+\usepackage{quantikz}
+\begin{document}
+\begin{quantikz}
+  \lstick{$q_0$} &amp; \gate{H} &amp; \ctrl{1} &amp; \ctrl{2} &amp; \swap{1} &amp; \swap{3} &amp; \gate{R_1(3.142)} &amp; \qw &amp; \qw \\
+  \lstick{$q_1$} &amp; \gate{H} &amp; \gate{X} &amp; \ctrl{1} &amp; \targX{} &amp; \qw &amp; \swap{1} &amp; \gate{T^\dag} &amp; \qw \\
+  \lstick{$q_2$} &amp; \gate{H} &amp; \qw &amp; \gate{Y} &amp; \gate{Z} &amp; \qw &amp; \targX{} &amp; \gate{S} &amp; \qw \\
+  \lstick{$q_3$} &amp; \gate{H} &amp; \qw &amp; \qw &amp; \qw &amp; \targX{} &amp; \qw &amp; \qw &amp; \qw \\
+\end{quantikz}
+\end{document}
+
+</pre></div></div>
+</div>
+<p>Copy this output string into any LaTeX editor and export it to PDF.</p>
+<p><img alt="Circuit in PDF format" class="no-scaled-link" src="../../../_images/circuit_pdf.png" style="width: 500px; height: 250px;" /></p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../../../using/examples/quantum_operations.html" class="btn btn-neutral float-left" title="Quantum Computing 101" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../../using/examples/expectation_values.html" class="btn btn-neutral float-right" title="Computing Expectation Values" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/visualization.ipynb b/pr-2241/examples/python/tutorials/visualization.ipynb
new file mode 100644
index 0000000000..6ef306f361
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/visualization.ipynb
@@ -0,0 +1,750 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Visualization\n",
+    "\n",
+    "## Qubit Visualization\n",
+    "\n",
+    "What are the possible states a qubit can be in and how can we build up a visual cue to help us make sense of quantum states and their evolution?\n",
+    "\n",
+    "We know our qubit can have two distinct states: $\\ket{0}$ and $\\ket{1}$. If these were the only two states, we could represent them as two vectors on a one-dimensional line (i.e., the z-axis in the image below). We also know that qubits can be in an equal superposition of states: $\\ket{+}$ and $\\ket{-}$. In order to capture all of the states in equal superposition, we will need a 2D plane (i.e., the $xy$-plane in the image below). If you dive deeper you will learn about the existence of other states that will call for a 3D extension. \n",
+    "\n",
+    "In general, a quantum state can be written in the form $\\ket{\\psi} = \\cos(\\frac{\\theta}{2})\\ket{0}+e^{i\\varphi}\\sin(\\frac{\\theta}{2})\\ket{1}$ where $\\theta$ is a real number between $0$ and $\\pi$ and $\\varphi$ is a real value between $0$ and $2\\pi$.  For example, the minus state, $\\ket{-} = \\frac{1}{\\sqrt{2}}\\ket{0}- \\frac{1}{\\sqrt{2}}\\ket{1}$, can be rewritten as\n",
+    "$$\\ket{-}  = \\cos(\\frac{\\theta}{2})\\ket{0}+e^{i\\varphi}\\sin(\\frac{\\theta}{2})\\ket{1}\\text{ with }\\theta = \\frac{\\pi}{2}\\text{ and }\\varphi = \\pi.$$ \n",
+    "This can be visualized in the image below as a unit vector pointing in the direction of the negative $x$-axis.\n",
+    "\n",
+    "Using spherical coordinates, it is possible to depict all the possible states of a single qubit on a sphere. This is called a Bloch sphere. \n",
+    "\n",
+    "<img src=\"images/Bloch_sphere.png\" alt=\"Bloch Sphere\" width=\"300\" height=\"300\">\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let us try to showcase the functionality to render such a 3D representation with CUDA-Q. \n",
+    "First, let us define a single-qubit kernel that returns a different state each time. This kernel uses random rotations.\n",
+    "\n",
+    "Note: CUDA-Q uses the [QuTiP](https://qutip.org) library to render Bloch spheres. The following code will throw an error if QuTiP is not installed. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:18.401657Z",
+     "iopub.status.busy": "2024-10-01T18:34:18.401510Z",
+     "iopub.status.idle": "2024-10-01T18:34:22.187823Z",
+     "shell.execute_reply": "2024-10-01T18:34:22.186908Z"
+    },
+    "scrolled": true
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Tools not found, installing. Please restart your kernel after this is done.\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Collecting qutip>=5\r\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "  Downloading qutip-5.0.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (28.0 MB)\r\n",
+      "\u001b[?25l     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.0/28.0 MB\u001b[0m \u001b[31m?\u001b[0m eta \u001b[36m-:--:--\u001b[0m\r",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.2/28.0 MB\u001b[0m \u001b[31m5.1 MB/s\u001b[0m eta \u001b[36m0:00:06\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.5/28.0 MB\u001b[0m \u001b[31m6.9 MB/s\u001b[0m eta \u001b[36m0:00:04\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m0.8/28.0 MB\u001b[0m \u001b[31m7.9 MB/s\u001b[0m eta \u001b[36m0:00:04\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m1.2/28.0 MB\u001b[0m \u001b[31m8.7 MB/s\u001b[0m eta \u001b[36m0:00:04\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m1.7/28.0 MB\u001b[0m \u001b[31m9.8 MB/s\u001b[0m eta \u001b[36m0:00:03\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m2.3/28.0 MB\u001b[0m \u001b[31m11.0 MB/s\u001b[0m eta \u001b[36m0:00:03\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m2.9/28.0 MB\u001b[0m \u001b[31m12.2 MB/s\u001b[0m eta \u001b[36m0:00:03\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m3.7/28.0 MB\u001b[0m \u001b[31m13.5 MB/s\u001b[0m eta \u001b[36m0:00:02\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m4.6/28.0 MB\u001b[0m \u001b[31m14.9 MB/s\u001b[0m eta \u001b[36m0:00:02\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m5.7/28.0 MB\u001b[0m \u001b[31m16.5 MB/s\u001b[0m eta \u001b[36m0:00:02\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m6.9/28.0 MB\u001b[0m \u001b[31m18.2 MB/s\u001b[0m eta \u001b[36m0:00:02\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m8.3/28.0 MB\u001b[0m \u001b[31m20.0 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m9.3/28.0 MB\u001b[0m \u001b[31m20.8 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m10.4/28.0 MB\u001b[0m \u001b[31m22.5 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m11.5/28.0 MB\u001b[0m \u001b[31m27.0 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m12.7/28.0 MB\u001b[0m \u001b[31m30.3 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m13.8/28.0 MB\u001b[0m \u001b[31m32.0 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m15.0/28.0 MB\u001b[0m \u001b[31m33.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m16.1/28.0 MB\u001b[0m \u001b[31m33.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━━━━\u001b[0m \u001b[32m17.3/28.0 MB\u001b[0m \u001b[31m33.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━━━━\u001b[0m \u001b[32m18.5/28.0 MB\u001b[0m \u001b[31m32.7 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━━━━━━\u001b[0m \u001b[32m19.5/28.0 MB\u001b[0m \u001b[31m32.6 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━━\u001b[0m \u001b[32m20.3/28.0 MB\u001b[0m \u001b[31m31.7 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━━\u001b[0m \u001b[32m21.2/28.0 MB\u001b[0m \u001b[31m31.0 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━━━━━\u001b[0m \u001b[32m22.0/28.0 MB\u001b[0m \u001b[31m30.1 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━━\u001b[0m \u001b[32m22.8/28.0 MB\u001b[0m \u001b[31m29.4 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━━━━━━\u001b[0m \u001b[32m23.7/28.0 MB\u001b[0m \u001b[31m28.5 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━━\u001b[0m \u001b[32m24.5/28.0 MB\u001b[0m \u001b[31m27.8 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━━\u001b[0m \u001b[32m25.3/28.0 MB\u001b[0m \u001b[31m27.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[90m╺\u001b[0m\u001b[90m━━\u001b[0m \u001b[32m26.2/28.0 MB\u001b[0m \u001b[31m26.3 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m\u001b[90m━\u001b[0m \u001b[32m27.0/28.0 MB\u001b[0m \u001b[31m25.7 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m \u001b[32m28.0/28.0 MB\u001b[0m \u001b[31m25.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m \u001b[32m28.0/28.0 MB\u001b[0m \u001b[31m25.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m \u001b[32m28.0/28.0 MB\u001b[0m \u001b[31m25.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\r",
+      "\u001b[2K     \u001b[91m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m\u001b[91m╸\u001b[0m \u001b[32m28.0/28.0 MB\u001b[0m \u001b[31m25.2 MB/s\u001b[0m eta \u001b[36m0:00:01\u001b[0m\r",
+      "\u001b[2K     \u001b[90m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\u001b[0m \u001b[32m28.0/28.0 MB\u001b[0m \u001b[31m19.3 MB/s\u001b[0m eta \u001b[36m0:00:00\u001b[0m\r\n",
+      "\u001b[?25h"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Requirement already satisfied: matplotlib>=3.5 in /usr/local/lib/python3.10/dist-packages (3.9.2)\r\n",
+      "Requirement already satisfied: scipy>=1.9 in /usr/local/lib/python3.10/dist-packages (from qutip>=5) (1.10.1)\r\n",
+      "Requirement already satisfied: numpy>=1.22 in /usr/local/lib/python3.10/dist-packages (from qutip>=5) (1.26.4)\r\n",
+      "Requirement already satisfied: packaging in /usr/local/lib/python3.10/dist-packages (from qutip>=5) (24.1)\r\n",
+      "Requirement already satisfied: contourpy>=1.0.1 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (1.3.0)\r\n",
+      "Requirement already satisfied: python-dateutil>=2.7 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (2.9.0.post0)\r\n",
+      "Requirement already satisfied: fonttools>=4.22.0 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (4.54.1)\r\n",
+      "Requirement already satisfied: cycler>=0.10 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (0.12.1)\r\n",
+      "Requirement already satisfied: pyparsing>=2.3.1 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (3.1.4)\r\n",
+      "Requirement already satisfied: kiwisolver>=1.3.1 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (1.4.7)\r\n",
+      "Requirement already satisfied: pillow>=8 in /usr/local/lib/python3.10/dist-packages (from matplotlib>=3.5) (10.4.0)\r\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Requirement already satisfied: six>=1.5 in /usr/lib/python3/dist-packages (from python-dateutil>=2.7->matplotlib>=3.5) (1.16.0)\r\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Installing collected packages: qutip\r\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Successfully installed qutip-5.0.4\r\n",
+      "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\r\n",
+      "\u001b[0m"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\n",
+      "New libraries have been installed. Please restart your kernel!\n"
+     ]
+    }
+   ],
+   "source": [
+    "# install `qutip` in the current Python kernel. Skip this if `qutip` is already installed.\n",
+    "# `matplotlib` is required for all visualization tasks.\n",
+    "# Make sure to restart your kernel if you execute this!\n",
+    "# In a Jupyter notebook, go to the menu bar > Kernel > Restart Kernel.\n",
+    "# In VSCode, click on the Restart button in the Jupyter toolbar.\n",
+    "\n",
+    "# The '\\' before the '>' operator is so that the shell does not misunderstand\n",
+    "# the '>' qualifier for the bash pipe operation.\n",
+    "\n",
+    "import sys\n",
+    "\n",
+    "try:\n",
+    "    import matplotlib.pyplot as plt\n",
+    "    import qutip\n",
+    "\n",
+    "except ImportError:\n",
+    "    print(\"Tools not found, installing. Please restart your kernel after this is done.\")\n",
+    "    !{sys.executable} -m pip install qutip\\>=5 matplotlib\\>=3.5\n",
+    "    print(\"\\nNew libraries have been installed. Please restart your kernel!\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:22.189754Z",
+     "iopub.status.busy": "2024-10-01T18:34:22.189393Z",
+     "iopub.status.idle": "2024-10-01T18:34:23.376321Z",
+     "shell.execute_reply": "2024-10-01T18:34:23.375296Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "\n",
+    "## Retry the subsequent cells by setting the target to density matrix simulator.\n",
+    "# cudaq.set_target(\"density-matrix-cpu\")\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(angles: np.ndarray):\n",
+    "    qubit = cudaq.qubit()\n",
+    "    rz(angles[0], qubit)\n",
+    "    rx(angles[1], qubit)\n",
+    "    rz(angles[2], qubit)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Next, we instantiate a random number generator, so we can get random outputs. We then create 4 random single-qubit states by using `cudaq.add_to_bloch_sphere()` on the output state obtained from the random kernel."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:23.379834Z",
+     "iopub.status.busy": "2024-10-01T18:34:23.378953Z",
+     "iopub.status.idle": "2024-10-01T18:34:23.508660Z",
+     "shell.execute_reply": "2024-10-01T18:34:23.504630Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "rng = np.random.default_rng(seed=11)\n",
+    "blochSphereList = []\n",
+    "for _ in range(4):\n",
+    "    angleList = rng.random(3) * 2 * np.pi\n",
+    "    sph = cudaq.add_to_bloch_sphere(cudaq.get_state(kernel, angleList))\n",
+    "    blochSphereList.append(sph)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can display the spheres with `cudaq.show()`. Show the first sphere:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:23.511169Z",
+     "iopub.status.busy": "2024-10-01T18:34:23.511002Z",
+     "iopub.status.idle": "2024-10-01T18:34:23.716760Z",
+     "shell.execute_reply": "2024-10-01T18:34:23.716174Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 500x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "cudaq.show(blochSphereList[0])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can also show multiple Bloch spheres side by side - simply set the `nrows` and `ncols` in the call to `cudaq.show()` accordingly. Make sure to have more spaces than spheres in your list, else it will throw an error! Let us show two spheres in a row:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:23.718642Z",
+     "iopub.status.busy": "2024-10-01T18:34:23.718449Z",
+     "iopub.status.idle": "2024-10-01T18:34:23.965377Z",
+     "shell.execute_reply": "2024-10-01T18:34:23.964746Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAgMAAAD1CAYAAADNj/Z6AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjkuMiwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8hTgPZAAAACXBIWXMAAA9hAAAPYQGoP6dpAAEAAElEQVR4nOz9Z5BcaXoeCj7Hn/RZWb7gbcM00I326Gk7MySvzJCiWXJEUpShKN2NuCHqBndv3OCP1V1ppbgrXt4bjI3Y1TJEI0raK0ocaUheijPkmJ6e9t0AuuFNAVUoAOWz0h5vvv3xmTqZlZmVBaC70UA+HYiqzso8efLk+d7vNc/7vBIhhGCAAQYYYIABBnhkIX/eJzDAAAMMMMAAA3y+GDgDAwwwwAADDPCIY+AMPOS4efMmfu3Xfg2HDh1CJpNBqVTCs88+i9/4jd+Abds9X/u3//bfhiRJ+Mmf/MnP6GwHGGCABwUD2/GIgQzwhcU/+Sf/hAAgMzMzHf/+J3/yJySfzxMAHf8dPHiQXLt2revxv/GNbxAAJJPJEMdxPqVPMcAAA3zWGNiOAdoxyAw8pDhz5gx+7ud+DvV6HdlsFv/8n/9zvPPOO/jud7+LX/mVXwEAXL16FX/tr/01NBqNjsf4sR/7MRiGAcuy8N3vfvezPP0BBhjgc8LAdjyaGDgDDyl+9Vd/FY7jQFVV/MVf/AV+/dd/HSdPnsSXv/xl/PZv/zb+5b/8lwDoov7N3/zNjsfIZDL4yle+AgD4kz/5k8/s3AcYYIDPDwPb8Whi4Aw8hPjggw/wwx/+EADwy7/8yzh58uSG5/zar/0aDh8+DAD4rd/6LQRB0PFYP/7jPw4A+NM//VOQQRfqAAM81BjYjkcXA2fgIcQ3v/lN8fvf/bt/t+NzZFnGL/3SLwEAqtUqvv/973d83te+9jVIkoSFhQV8+OGH9/1cBxhggAcHA9vx6GLgDDyEeOuttwDQVN3TTz/d9Xmvvvqq+P3tt9/u+JypqSk8++yzAAbpvgEGeNgxsB2PLgbOwEOIS5cuAQD2798PVVW7Pu/QoUMbXtMJPN03WNADDPBwY2A7Hl0MnIGHDK7rYnV1FQCwffv2ns8dGhpCJpMBANy6davr837iJ34CAHDu3DnMzMzcpzMdYIABHiQMbMejjYEz8JAh2eqTzWY3fT5f0M1ms+tzHn/8cezduxfAwMMfYICHFQPb8Whj4Aw8ZHBdV/yu6/qmzzcMAwDgOE7P5w3SfQMM8HBjYDsebQycgYcMpmmK333f3/T5nucBAFKpVM/n8XTfm2++iWq1evcnOMAAAzyQGNiORxsDZ+AhQy6XE7/3St9xWJYFYPO04PPPPw9JkhCGIT766KN7O8kBBhjggcPAdjzaGDgDDxlM08Tw8DAA4Pbt2z2fW6lUxILesWNHz+e+9dZbIIRA13U8//zz9+dkBxhggAcGA9vxaGPgDDyEOHLkCABgenoaYRh2fd7ly5fF71xRrBv++I//GADw+uuvt0QQAwwwwMODge14dDFwBh5CvPTSSwBoGu/UqVNdn/eDH/xA/P6lL32p5zH/9E//FMA6GWiAAQZ4+DCwHY8uBs7AQ4i/8Tf+hvj9937v9zo+J45j/MEf/AEAoFgs4vXXX+96vDNnzmBubg7AYEEPMMDDjIHteHQxcAYeQjz33HN4+eWXAQC/8zu/g3fffXfDc37zN39TKIf96q/+KjRN63o8nuY7ceLEpmIkAwwwwBcXA9vx6KK73uQAX2j81m/9Fr70pS/BcRz86I/+KH79138dr7/+OhzHwX/4D/8Bv/3bvw0AOHjwIH7t136t57F4fzBvERpggAEeXgxsx6OJgTPwkOLEiRP4wz/8Q/ziL/4i6vU6fv3Xf33Dcw4ePIg/+7M/QzqdFupjhmG0CI7cunULZ86cATBI8w0wwKOArdgOTdNQq9WgqirS6TQkSRLPGdiOLxYGzsAXGK+99hoAWrcDgDAIAEIQxTHiMMSXX3kF7/zwh/j//Kt/hW//xV9gfmEBmqZhz549+ImvfQ1//+/9PaRSKcxMT4MQAkmSIEkSRkZHkUqlIMmySPPt2LEDJ06c+Jw+6QADDHA/kbQdcRwjDgLEAOIoQhRFeK2b7di9Gz/x4z+Of/DLvwwiSZibmRF2w0ilMDI8DEXTIAMD2/EFg0QIIZ/3SQzQGXEcIwxD8S+OY0js6yJRBBLHCHwfvuchDALEcYwoikCYQwBCQAAQQuhmz36P2f+DEDQsC3EcQ5FlyLKMMIogyzIK+TxUWcb/+R//Y7zz3nv4+a9/Hf/8n/5TGKYJTdchKwocx4Hr+ygWi8hmsy1RwQADDPD5gBCCKIoQhqH4iTgGAYA4hgQg9H0EQQDfdREyWxIn/gEQz4/XD0ztCoAgDGFZFiRJgq7rCMMQhBCkUymaIQDw3/7qr+Kdd9/FL3z96/h//ot/Ac006XPjGPVGA7quo1Qq9eQcDPDZYZAZeIBACIHrurAsC2EYwvc8utnbNv3p+4iiCFEc0+g/jiFJElRFga5pG0aOxnEMdNig+SL3fR+e70OWJKRME5AkeJ4HnxBIjQaiKML1GzcwPDyMA3v34vvf+x4c24btOHAdB9yLjAmBrCgoDg2hODyMkZERPPbYYwPC0AADfEaIogiWZcF1XQRBgNDz4LkufM+jwUIYCpsRRREAQJYkaKoKTdehSNL6ega1RRIhG+wHIQSIYzSbTUSEwNR1aKoKQghsx0HAnALbdXHjxg2MjIxgz65d+PM//3PYlgXbcRAx/YKYBSapTAZDpRKGR0cxPj6O48ePt0gjD/DZYOAMPAAghMBxHKyVy2jW63AdB57jUI9ekqBIEmRFoZE3S8mBRfYkjuHHMYIggKqqMHUdpmlCVVVIwPpi5q/j7xlFqEQR9eRNE6ZhIAagKgps2wYAvPGDH8B2HKRME4qioFqrIZ1KYXR0FOlUir6PrsN1HDi2Dcd1UVtawp2ZGbz71luY2rYNr7z2Gvbt2zfIGgwwwKeAMAxRr9dRXVuD3WzCdRwEvo8ojiHLssj4AVjPKjLbEYI6Ea7vw9B1mIYBQ9chy/K67ZAk8TvPLLquC8M0IQMoFAoAgAxAMw5RhCAI8K1vfQuO6yJlmshkMvA9D5lsVpQgU6aJiBBqN2wbjuPg1vQ0Lpw+je/9xV/gyaefxsuvvCImIw7w6WPgDHyOCIIAy4uLWFtZgWNZ8H0fkiyLhamwdJsky1AUBQr7CeYM8MXpBwFczxPlAC8IAAAmIwMSgDoPbEMmABzbhqooUDQN+XweMvtbFEVYWFjAnYUF/Pm3vw3btvHMiRP4KcYG9sOQZhQ8j2Yq4hhmKgXdMFBIfLZKpYKFhQX8x3//75HN5XDk2DE8fuyYSAsOnIMBBrg7EELQrNextLiIWqUCz3FoqU9V6ZrPZKCwjVyWZbrOZRkS3+RBbUAcRXA9Dz6L1Akh8H0fhmHAMAzIirLhveM4hmVZ0DUNmXQapmlCAo3yPdfFzOwsyuUyfvDmm7BtGy88+yz+xo//OC1J+D68IBBlTYkQZLJZpBMbfhAEWFpcxCenTuHjjz7Cth078OSJE9i1Zw8ymQy1fwN8KhhwBj5D8MVmNRqora1hdWUFvu+DxDEkWYZpGMik09A0DZqq0kXMMgIEQMTqfXEcg39tBFh3Cnwfru/DZ84ACIGmacim01BUVaQBCSGoVKuIwhDpVAqpVAp+EODc2bO4efMmIEkYGxvDjp07URoaQhhFiKNofQOXJBDGSYhBDQFh5yTKGOxnrVrF/Pw8Gs0misUiDh85gmKxiOHRUWRzOaS5QRk4BwMM0BVRFMFxHDRqNVRWVlCtVKjzD0BTVaRMEymWEVQTtgNYT8eDEMEHACBIwxFzClzfRxxFItjg2T+RHQDg+T7qjQYkAEPFIiRJwvLyMs58/DGajQYy2SzGx8exe/duyLJMOQZt5UpuK4gkIY4iYdt4CSOKIvieh+XlZSwuLSEmBPv27cP2HTtQLJUwVCohk8kgnU5vKI0OcPcYOAOfMnhardlswqrV4DsOQt9Hw7YRhSEkSUIum4VpGHRhsgURMPIPJ/wpigIZbPNnqT+Zpf4l9jfOGwjDEJ7nwXFd4QBkUinq7UsSgihCpVIBATBUKGBhYQGfnD2LMAhw4MAB5IpFBL4PXdOQTqdFVkGWZWFsFEUR58BvoYhxGBIfHgE7lzt37uDCpUswTRP7DxyApuswTBO5fB6FYhGlUgmFQkGkNAcY4FFHGIbUAWg04DQaCFwXnuui6TiQCIGh68hkMqJmHzHCcRCG1FmXJJoxYGuVb/4ysx+SJEGWJCiyDE3XAUlC4PtwXVdkC1RFEcGEBKDebNIygWFA1zScO3cOs7OzGBkext79+xFEEUAIcpkMLW0CAMtOqIoCVVVp+YI5KjybmdyEJFBb4vs+LNvG+XPnsLy6ip07d2JsbAyKqiKdySA/NIQisx2bjVEeYHMMnIFPCb7vw7ZtNJtNeJYFz7bhex5s5hjELM2fMk0osgywTVBO1OgESZAflHnxfHMWX1yiFqiqKnRNg6HrUBQFPnM4AECVZWQyGXhBAJt1EVy9cgULS0sYHRnBgYMHYRoGgiCA7bowDQOlQqFlAfNMBEAjjpb3Z+fQckMlbq9qrYa33noLsiTh8SeegCLL8IMAsqoik8shm8uhVCpheHgYhmHcx29jgAG+GIjjGK7rwrZtWPU6PMeB7zhwPA+2bcPxPJrxU1UYui7WNi8BiCxiGLasVSJJiBkHqd1ucHuiaxp10nVdZPlasgSGgbVqFVEco16v4+L58wjCEPv378e2qSkAQNOyAFlGPpNBOpOBpijCKRBZTNBMB3dQ6AeQaCdTIpiQEnbu7NmzuHL1Knbt3o0d27cjCEOEUYRUOo1UNkuzjcPDKLJsxQBbx8AZuI+I4xi2bdNFa9uwqlU0Gw14PP0G2pID0E0/nUpRR0CShPeuqip1CFjUDQARS8ODENpiyL3pOBa/8zZEkjgXwtL5IUu98fRhEIZYLZdxZ24Oiqri4MGDGBkehizL0HUduqqiwdqGhopFcR48mmj5zG23D49QkreVMFiSBMuy8NZbb8H3fZw8eRLZTAZN24Zl2yAAzFQKmVwOBba4OUFpgAEeZnhss7dtG26ziVqlAsdxaHYwjhERQkt1oBlAwzAgAYJYzNe2lAgqOC+Ar8mY2wu2PvnvURyLdD0AYVN4pgGs60CWJNiOg7m5OVSrVYyNjuLggQPQdR2qosAwDERhCC8MYeo6Muk0AIhsRBI8cGh5jBCEzE5ycCeHEILr09M4+8knmNq+HSdOnIAfBGiwTIVuGEhls8jmchgaGsLIyEiLeNoAm2PgDNwHRFGEZrOJer2OSrmMOlvIsizD0DTojDDnui5UTYNpGCjm89A0DQpfxIlNNmQLOAlO0mnZZMG8bZaqj6KIlgdYW5Hn+wh8HyFzCBzHQa3ZxPydOwgJQSmfx66dO1HI52HqOtQEsa/eaCAmBNlMBmqCtCOzzgbOUuYERzlRuiCEUAemy63l+z7efe891KtVfOWrX0Umk6GOlOOg3mjA8zwYpolssYhisYjJyUkqgjTw+Ad4yOC6Lur1OmqVCuqVCur1OoIgoHaDbbJcL8DQdWSzWWQZkU5J8AIAaguSY4e5XeAZxWR3kcgYsNKBx2yGw3RLfEYsjOMYfhCgaVlYWVtDuVKBJknYsX07xsfHkUmnoWuaOA8/CGA7DhRZRi6bbfms3GbILPARnVKM3CizsgbXMtgAQjC/sID3P/gAu3buxFNPPQVJkuj5NRpoWBYgSUhns8gVChgbG8Pw8PCAV9AnBs7APSBkwhurq6sol8uolcuQJQkmW8iyLMMwDKRNEyGL7LmgT3JjSy7SmKfnOiBJ/uFiIjxTEDPCnmg7ZAsLoAxdy7JQbzQwMzODgL1mcmIC2VyOnqeuw2RthoqiwLIsBEGAlGnCMIyOnjxHexYgmRbUVJU6GfSJ4nMGQYDvfPe7ME0Tr7zyisiQSHEML4rQqNfRaDaRGxpCvlBAsVjE0NDQwCkY4KGA4zio1+vUdrBuIkPTqFOuKNBUFaZpQjcM+L4PWZZhMpJgCxKbO6/Xt4MkHHPCsotRFImMIc8sSm2vieIYrufBajaxuLSExaUlAMDwyAhyuRwNZhQFadOEkUohZRiIoohKm0sS8rmcyFBwAbT280qCOwqEEKqBoOvULrRhdmYGp0+fxnPPP4/t27YBPHsQx7AcB9VaDTGA4vAwcrkcRkZGkM/nB07BJhg4A3eBOI5Rq9WwsrKCtbU1OJYFKYpgGgZl57NFm2aSvp7nodFsgsQx8oUCtB43ZRjHtCSQAGGbvR8ELWqELYIgbKPljoXCFlUYRQh9H03LwsXz56GoKvbu24dz58/jyKFDUBJkwIgJihimKbz1bCaDLGtx5OpkYYL5yw1K3FYaAGiGgxsnhZGHVNYpIUsSVlZX8eabb+LwoUN47NAh8TqeUgyCAKtra4AsozA0hFw+j0wmg2KxOBAlGeALCc/zsLq6itXVVVSrVcS+D12SqCPObIfJHHAQglq9jiAMoSgK8vk8AKCTK9yeFRCPs9bjIAgQMdtBDyKJv0sJh4JvyNzeRFGEmzdv4tbt25gYG8OdpSU8+fjjkBUFYRRB1zRRjpAVBalUCkEYwtB1lIpFqMwO8Yg/arMdXP2w/Zx5QCRKIKoKjRGkSRzjvXffxUq5jC9/5SstDpIsyyAAmvU6qs0msvk8svk8crkccrkc8vn8oD2xCwau0hZhWRZu3bqFtbU1BJ4HDUBG01BgbPgW4hu7qS3LAgDB/O2FlhY93lUQhiKzIJ4HQGMbLE8X8jQ9WEnC8zwosoxKo4GLFy+ikM/j6OOPw3FdyJKEYrFIF28QCGMSBAHCIIDn+3BcF/V0GmMjIyjkcjTiVxSobZt+xNuW2Hnzhe8z1cRky5DneQAARVWRyWRw4MABXLx0CaPj4yiVSi3tT4qiYHxsjGY1KhU4loV8sYgwDJFOp1EoFAYLe4AvBOI4xvLyMm2zbTQgRREMSYKZzaJQKNAoOhkFEwLbthGylt5cNtvRCVh/Oov84xhBFCFiXQURywIKsIBBZRsr1y6RQNck72CIWXR+ZXoaqysrOH7sGDKpFJaWlzE8NARF04R9kkDLHTGh4ml1y6KdREGAoaEhpFlwIROCZBWfgLU9sgAo6Sg4XCaZHScIAjiOA0mSoGkajh47hjfffBOnPvwQL7GRy/w6A0Amm4Vpmqg2GqisrMBuNhEEATzPQz6fp11SA7Rg4Az0Cc/zMDMzg5WVFZAwhEIIcqaJfC6HXCYDnTkByYE/hBDhCPC0Xzv48wkhdANmyoOdEjaqolDvWNOgMg++/Rg+bylkr19YWMCVy5exbft2PPnEE3BcF67nQZYkZNJpqAld8HwuB0WW0XQcWM0m3djDEGuVCirVKvLZLIZYd0FSs4AzmOU2opCh6yIaCFlWI+AzFJihmtq2DYtLS3j//ffx0ksvIZ1O0w0+wXTOsH7ieqOBpfl5rJXL2LZ9O3zfR45pFQxKBwM8qFheXsbc3BzV8g9DGKpKo9RCAdk2hT2e2QuYkBgIFebp1XIbhiEc16WRfIfsgARA03XaaaSqUBIBCWf4c96THwS0xTkIcO78eTSbTbz44ovIZjKoVKsAO1Y6m4XVbIpMQqlUoh1UTG7YDwJYtg3XcWCYJobYZ012MhD2/jLrpkq69dwuRW0ZUa6nAgCHDh/GmY8/xvkLF3CAERmTXQuKqmKoUEDTtuE0Gpir11EolRBFEWzbRrFYHJQOEhhciT5w69YtzM7OggQB5DhGOpVCaWgIxUKhpRbGW3v4xuT6vqjp59tlNVltnytz8S4DfsNLjMGrMpKhiPrbwI1HHEVoWpZoB1JUFTdnZjB9/ToOHDyIY8eOwXEcABALQJIkZLNZKgfqeaJ/eKhQQCGXg6nrcH0fkiQhCEPUm03U6nXkmFOgs95koAufgLVPqrIM1TBAmMMUxTEdlMIW+NEjR/D+hx/iwsWLOHjwIFTWNqUnCI2GrmOoWEStXofvebh+5QpKIyO0flkoYGhoaKBRMMADBdd1ceXKFVQqFchRBF2SkC8WUWorc/FVLSXWEu+u0Vk/fwsYH8j3PNqp1D5zQFFo1lDTxBCgbs4yj+ptFnVLkoQoDPHxxx8jCEO8+uqrKBYKqDJHgENXVcjZrLA5tm0jk8kgk8kgZRioN5u0pBhFCIMAi8vL0FQVhXxeZEG4bgoYpyH5+UUHEysR8MeDMEQUBAjCEKVSCbt27sTVa9cwVCohnU5DZ62RGm+DlmXks1loioK6ZaGysoJapYLxyUl4riteN8DAGegJ3/fpYi6XIYUhUpqGye3bkc1mITMdAL6A2pcaFxsiANLpNI3iWV0/5NKczMPlUFWVMohZ6l8sYJaC7wSC1sUsyzJSqRQuXbyIGzMzOH78OA7s3w9gvaaYLFVIAFLpNCRZhm3b8DwPBFSkSNE0pFUVxXweruehVq/DY0IgjUYD6UwGxUIBqXYFQV4yaBMh4r+psgzFNGGw52ZzOTy2fz8uXbmC3bt3i3O1JToRzTAMqLIMTVEwVCigWq9DURTUKhXYzSYKpRKCIMDIyMjA0x/ggcDKygquXr2KyHWhAhgeGsLoyAh0TRNqgEJWvG2j9thAMglAOpUSqf2YzSDxWJCRBFcK1DWNOsW8R59PK0TrJgtQp9yyLFGK4Of27jvvQNd1vP7668ik0zRQ6WDnFEVBPpdD07IQhCGajQZy+bzomNKZsFi9XqfaKnGM1UoFa9UqCvk8LT2yLKMgPgMb2wv5T0mCoWkA4ymQOMbx48extLSEW3NzOPjYY7QrwvNEq6OmaZBkWdi4erOJOIqwdOcO6mtrcB0HI2NjyLeRuh9FDCxnF6yurmL62jX4tg0FwMjoKKYmJoReQBTHHSN1juSCNg1jgyfPIUsSvWkZi5iTbZJbf7s6FwdfzEFiMWfSaVy5ehU3btzAU08/jT179kAMJmHnI8myeA/umZumCUlR0Gw04HueEBnibONUOo1MOk15BPU6LTc4DuYtC4ZpIp/Pr6c8WeTCyTykXZkw+TkkOnXx4GOPYfrGDSwvLeHAwYPwPA9xHHdc3PlcDvV6HQCtOdYYidNxHExOTg7IhQN8bgjDEDdu3MDi4iIQBEhpGnbt2IFUOr2+rpMOQAcb4joOXXOscyZkJYOAy4wzaKq6vuGxUp3oROJRNtZLeUl75XkemrYtNvh0JgMQgh+88QY0VcWrr7wiSp/c8VCYSJCwG8xByGaztMQQhmg0mzANg9oAQqAqCs2i5vO0/brZRBiGqNTrqLIsYy6bFVlG4bwknINO4HYsZRh47OBBnDt3DkePHoXEhMzCKELIPh/PFhiGgWwcU2EkUBu9cOsWLMvC5LZtGGZaK48qBs5AG8IwxNzcHObv3EHseTA1DTu2bUM2m6WeNVsQm90yruuKKYANtgCSEOmsthSgxDoBuHdMsD6KWKTVsJ4N4Ein0zAMAzdv3sSFCxdw5MgR7N69W7QVifKDLENNpOP44pYIga6qyKTTsJhoEicRRYRAAXU+DMPAyOgowiBAtV6H4zgIWBpQZxt1hhkWAEKOlL1hx2vFhVT279uH6elpHDl8GOl8Hn4YwmOzFpKLW2OiK4Q5DFxG9fbMDKx6HXv27x9MOxvgM0e1WsXs7Czqa2uQCcFQoYBtU1OCA8P76LtFoJwsF3LmfRShWqu1lOAURaHCYInefg7eDcCDDf46/n4xABJFsNhkQ951lM1kQOIYP3jrLfhBgNdfe004AjFLzfMx5fy47WXBdDqNqNlEFIawbLuFCMw391w+jyzLJDQYoa/RbKJSrSKbzaLICMHJQEG8vodjsHfPHly5cgU3Z2Zw7PhxwTPgARkPKBTGuUoZBlzfp3ZcUVAtl+E0m3B27MD2HTseWYdg4AwkUK1WcefOHdTKZUhBgKF8HlOTk6LNR2KLgEsJJ8HFPSQAruehaVnwfB/ZTEbcXNyT5/K+vcA34RYNAtAWHpttwAAtLfD3WFxcxOlTp7B3714cTrTqcalP/vxOaTgePRgsi8Ejf13TWoyK0A/QNIwODyOMIpoGZKnC5ZUVKJUKhts1AbjT0cPj379vH65du4Yb16/jsUOHhNHjnQl8cftsIQPUQeET2RRFwdrqKizLwqEjR1AoFnte4wEGuB8IwxDz8/NYXVmBValAV1WMj41hZHiYZuHCkDoC3Up9zEmXADSaTTQta31CKSDWpcH77tuzConj8jHnJLkRMwSsxMdtFR9EFBOC999/H81GA6+++ioyTCxIrDGeGehQguNkPVmWaYag0aBTVF1XOOQ8iuc2hmcDbKa14DgOms0mKrUa8rkcSsXi+lyD9Q+2fq3azkHTNOzbtw9Xr10TdiOlKDBNE0EYUgEl1ibJu50EZ4u1QQZBgNnpaTiWhf2PPfZIdik9mi5QG+I4xtzcHG7OzqK5tgaFEIyNjGD7tm005cVrfFi/+TlavG/WWrO8sgKPDfrRNA2pVArFQgHZXA66YWzqCHDiC1cm5O8RsIlh3BFIp1LIMabxWqWC9997D1NTU3jyiSdaiX2Jvt1uN3kyWkmlUlT3XJZbHA9uaJLP5WnAiYkJoVYYhSEWlpawvLoqWguTsskA1UoX6UYG0zSxZ/duXL9+fX0GA2h60jRNFFi/sMFYwzFrt3Rcd50PoWnwHAfnzpzB4p07Pa/zAAPcK5rNJq5evYry0hIc1nGzfWoKoyMjdO0m9PY7ugISlR4PgwBrlQqq9TrCIKCOsK4jxyLmNBsWBLm1/bC93RgSHTzU0jEQx7CaTTSbTRCWui/k87ScRgjOnD6NpZUVvPDCCygmHWiWyYgT63DD6Sc+l8IcApWVF22WXez2/HQqhYnxcYyOjtJyhyyj2Wzi9vw8GvW6IEbyf3z4EiQJ7RqF+/btAwBcv3Gj5b101sJc4NeQOxksWxqykex8UNzSwgLOnT4Nx7Y7fVsPNR55ZyCOY8zOzqK6soKg0YCpaRgbHcVwqUQHdgAbFxwSmQC2WTuui0qthnqziYBFAsOlEgr5PCXY8U24R7qrpSsB6x63Istw2NCj9sUsSRKazSbeeestFEslPPPss0KfnB6MniPfLNUuzkC7wmCayYyCHT+piiiyFcwBitimXCgUqKohG1Bi2zbuLCyg3mi0XnOS0EdnxoY7C/sPHIAfBHSUcgL8enBeRIF1MyiKAl3TKKmx2RQCJVEc4/q1a7h24cKGWusAA9wPNJtN3JiehtdoILRtjAwNYbhUQrFQoCW9tihWjO7lD7B12ajXUavXRRtyNptFaWiIjjPn+vp84+9hPwBa7pNADTtX5avV63SsuSTBNE3kcjkRFFy4eBE3b97Es888g/Hx8fVzbSPztRCa298z8buiKMjlcsLm8M9EP25rMEEIQRBF0HSdZlJGRqCzCYwra2tYWFoSbYQABP+IBwFJ22HoOvbs3o0b169vaK+UQB2VlGGgkM9TArgs06wjy7Rati3ImvV6Hec//hjl5eWe1/phwyPtDMRxjJmZGTQrFZAwFC1zuXQapmmKmy8JkQmQZRCWTq/UarBtW9yo6VQKpVIJOpPxBdYXaSdsmPSXPEfWMsj7f1OmiWxiMXuui7feegumaeLFkydb2PTJrACPyLux7dvPTZKk9UifnUOLl88Wo89Sb3yBK6qKkZERjI2NwWSSzOVqFfOLi3Bdd+P7JgwMAR1UNDkxgRsJD7/tYgnSYTqdRi6bFeNUgyDAarks2jAjNqp5+vLlR9LTH+DTQ71ex43paZAggCpJGB4ZQTqTQSGfp3V70DXPITqP2LCvkMn21mo1eEFAnWFJwv/30m/jb373F/Gzf/Z13KjPduw2SCKZXWt/VhCGVBoYdF3mcjmqisqOd2NmBleuXMHx48exY8eO1hezkmC0SRAhziHxWVUWjUugREUnwW3iz+Xqg0jYxXQ6jcnJSRTyeWiyjCAIcGdxEeVKpYV0nTzH5HH37NkDz3Uxv7DQ4STXM7i6riOfyyHFFB8JIZTH0GjQbgVQuehbs7O4MzfXuW36IcQj6wzEcYwb09OwKxUgimgaKZWCoqpIpdN0g+bDPZBYcOwGdBwHlVoNlm2LmeGZTIZyAhjzHegsHZqEYOV2eG4Ux7Qs4PuQAOQYOU9hBiWKIrz99tsghOBLL73UcUoXfx4A8bpuaP+bLMtImSaVJ41jNOp1MROBT1Pjg0baYZomxsfH6UAmRUEYBFhYWsJquUzVFLtAliRs27YNtVpNZCQ6DW3in0fVNGQzGZSGhqCpKuKYjlfl6mie78N3XVy/cgX1tl7pAQa4G9Trddy8cQPwfRgsS6ex9c/HfCNxjwthHZ4JYE6Az0h8pmEgnU7jjYXv43zlAjz4WHHK+Ad/8d/i27N/2TFQ6OUEAIy31GgIfk+Bl9dYZL6wsICPT5/GwQMHROtxEvyYSa5RNyR5TRyapokyhOM4cF1XTEHk0xd5piD5WlmWMcSHkyVKB3cWFigxsQdyuRyKpRJu37kj5NFFJpc/iRE5JVmmA+OY+iMANB0HtusKYTTX81BeXsbstWsdpZ4fNjySzgB3BNxaDSSOMT46CoXdkBnmOSdvIpJIbTmOg0q1KpwAVVGQZZKigskrUT3tXo4AX8ydnAAAgpgXsLnfuVxObPZ8QV9IKIRxB4Yfu+VY3Lvvpwc/QZLkMDRNTC/rtCD5wu7kTBQKBWybmKApT0WB5TiYn5/fUDpIYnJyErKiYGFxUZRhWmqH/FTjmGZc2OjlkZERmIaBgHVOcMJUw7JACMHN69exsri4+TUYYIAuqNfrmGOOgKnrGBoaEqOEDV0XQQRA7YYo08XxeibA90EAGIm0dRiGuNNcRCiHgmMQkhD/4oP/Gf/s3f8HGkFTnEN7ObEdNiPkEUmCwXgH3GGXJAmO4+D0qVOY2r4dx44dE8cU3UXcjiS4RpvZjmTQxDOSiqpCVlXEhAiuk9T2GpmdU7vDr2kaxsfHMVwqidLB8uoqFpeX4ffYmLdNTmJpaUmMUefZ2uSIZsLI4ADN8BbyeRTZzBjPdSHLsig78sFL1y9fhpfIcDyMeOScgTAMcf3aNeoIEIKp8XG6+Aihoj98Qh/bdDiDPgxDWg5wHMpgTzgBJpstzmvTXBazGwhb7N2e44ch6vU6wiiCItHpX+2L8c6dO7h+/TqOHz+OYrG47mljvTsAWE/JEUAML4oBQchJ1utjQhCS9dnnBLS+D0miaT+JzjzotBglQDhU7VBUFaOjoxgdG4PBeqJ56aDTsVTG21icn++YyRALnBsQlmrUNQ2ZTAa5bBZxHENnU9RqtZqoXS7cvo3lgUMwwF2gVqth7sYNEN+HaZqYmpgQNW0RRCSiUYltirbjoF6ttjgBxUIB2WyWrkkm1z2VmYAPf8P7fvfW9/H3v/0P8cnKOXpcdLYdBECT6W1w7RC+bsVz4hgfffghVFXF0089JSLzpEMfY90R4Ol53lIds0wdtxd8tkDMZyKw6amEXQuTdU9JkiRUFdshJ47fjkw2S0sHuRw0WYbveZhfWEClVuv4HU1OTiKOY5RXV1syDhLrsIgTtkPCevk2n8shk0rBYERCVVHg+z7KlQrtYPI83Jiepi2ZDykeKWcgDEPMXL8Ot9EAIXSEb5orbAFi+hUXyRHzBWwb1XpdtLFlmfIeF9fgqX6fOQPt2gEcIhvQgz/geh6a9TpiQqBrGnJsQFAStmXh1KlT2LZ9O/bs2bPp5+bMfKWNxCjIkTwaaDsvQfRhn4kzbm3LosOJ2iFtVGJMImWamBgfRzGXo6WDMMTCwgLsDtmGqclJrJbLIppojx64QYraFnc6lRL9xBmmvQDQAVOcgLl05w5qlcqm122AATiq1Spuzswg8n2kTROT4+NieJgkyyKIiAGxwYZRhEq9DttxRJReLBSQy2bX53tIEvwwpEqlehohOke98815/Or3/3v8zvnfQ0g2jjiPCUGj0RCqpulMhhLi2nDp8mWsrK7i2eee61hWTJIek+RBDuHwdCA0JkWNRKaAEGQyGTEJ0ekRXYtxx+2PyzKGhoYwPjGBlGlClSRU63UsLi9vKDkWikVkUiksLCx0LF8AEMEPn5tC2HunWJmYKytKkgTf99FsNqnqo+9jZnq64/yHhwGPjDPAyYJOowGJEGybnEQ6lRJDc4D1yJkjCEMqrMOIb4ZhoFgsrk8mTGygooeVkI7OQK/6HoftOLAsCzF7r1yHASUkjvHhRx9BU1WcOHGi483e/rmTUwA3Q3uGgX5MevZmKgWNpexsy+reKtXjnGRZRqFYxOT4uKhhLq2ubiAJTU5NgRBCldz4+SSuRXsUwRc3QJ0OWZLgeR6yjAwaxzElVDGxk9uzs7ATTOcBBuiGer2OudlZEN9HLp3G+Pg4ZNYOCFBHmafHZUBkA2qNBiLWWsjH56ps/QDrEb7QDOkURBAgJlzNk+APLv47/KPv/mPMN9dJciHjyfhBABBC22+T01MZVldWcPniRRw5cgTDw8OdP2zCoU/axX7BP5topyRUqC3Dhom5bKDSxrelDhTP0naCoeuUh1QsQmPre2FhYQMxeWpqCosLCy3BTbKDoZ2MyKesamwAHBiZM5NOQ5Fl0SZp2TZc28atmZm+r8cXCY+MM7C0tAS3Xoccx5hKSNbyerqsKFQnm9WaLNtGjRHReKo+lyDvifQau8l4ulDXtBYPWSj8obsj0JLeA5A2TSrt22FTvXTpElZXV/Hs88939OzbkdQX2Kr2dotgEGM187RjyIRFer22Uy2QQ9M0jI+NIZfJQJNlNBoNLK2siO8jxToykszgpKPSMTPBoKoq7fYAXegqE3tSGBGyaduwbRuz16/D6/EZBhggDEPcnpsDggC5VApjo6PCQefcFE1VRWAQsgDCZpLChq7TAIJt9MmBPPz/uYhWexAREwICAllqNdMX1i7i7//FP8C3Z/+SOri8pMg4OpqmbdhQfc/DBx9+iJGxMTx28GDXz5tcr9y57tVJkERyfSJhO4C2zKJti2MnXyt+38RO5fN5jI2NCS7BwvJyCwdpamoKjueJ4UoiuJEkUaLtBi7CFAYBZEVBigVAALXxjWYT1UoFd+bmeh7ni4hHwhmo1+soLy6CRBFGGcmMI4wiIRssAQiiaEM2oFAsCiU+zgxuv6W4V55c0AQAOjw3CQKINBQAOvWryxStlZUVXLp8GUePHsVwqdT9mB0WdCfBkG4Q55tcONzjVxTh5fNxyy2vazNC3WqB/G/Dw8MolUpQVRWB72N+cVFc+8nJSSwvLW3MAqDN8HQAj4z8IBBiJdlMhjpQhOpC1KpVTF+50tOpGeDRxq2bN0FcF5qiYGxsTDgCvKYusY4W0ikbwJT2ePqbDxJLIgxDQTpOTieMSQwZ3bNsVmjjNz74Tfyvb/9vcAMfqqoin8+LKL5lzRCCU6dPI4oiPPPMM606JEg+rTXtn5yC2C+SG2/7eSQzi+38gZbPuUm5EaCb9sT4OFKpFFRZRrlSwfLqKuI4xvDwMHRN69hiSOK4Z/aB65QQ0MwIAc3Y8CxtFEVoNJuYv337oXMIHnpnIAxDLNy6BUQRsuk0cqyNRNTvWWqKgNaVO2UDRC1LWm8BbE9Zh2FInQoeAbC/ST0iWALAYjPEO6b3Eq/1PQ8ffPABRsfGcPDAge7HJK2aBXezoIHEZtthUeuGIZQUm+0qYx2MVy+HAKAiK+OjoyLTsbi8jEqthpGREdGPnfx8fABUJy4Bh6aqVAIW62OhCWjGgcskB0GAcrmMK+fPDxyCATZgZWkJHlPCG2cZgaTiKM8ABr4vyMUt2QB2PydLhHLbRsfr8pqqQpOp7aAzQeSeNUUVKvLI473FD/DNmW8inywpMtIvx/Xr1zE/P49nnnkGqQ48giTEHINkeXGrWv2J92/f8HlmMdoks7hZuRGgxOTx0VHavizLcBwH84uLCMIQIyMjqLS1EnNxNIAFdF2Oz7833/dpIEHoDINcNiucGcdxMDc7SztLHhI89M7AndlZENeFIkkYGx1d/wOrJymyjDCKqAIYS9MnswFA53q/nPh/3sYiSRJUlp5uf34nWJYFL+EIdCMeghB8dOoUSBzj2R6ePUfyfe+m7kcP0ubht/05nUpR4xjHLQTAbgtM7lEyAOg1Hx8dpS2IsowqG5dMANQSizqO443tSZ1kUhlhC4RQwSasZy64KAof9VqtVnHuzBm4A2GiARisZhPVxUWEQYBSsbg+CTPhDIDVwKssgOiUDehUIkyukWQZT5VVMRysF1SoKKAAEhNEiHCleaWrTahWqzh37hz279uHiYmJvj8/zyjKsrylwT3cQeevaF/zvTKLXY+3yXsWikWMsrJBHEVYWFqCmUq1kIS56umG43e41hor9caEiPHO/HtPMw4SQLkes7OzuHH9+iZn+MXAQz2oaHV+Hn6ziSCKMDUx0TIsg//zPA/NZhOyJCFtmkhnsy31vV4pK1mWEROyvuHyXt4+zs1yHHieB4BGxl0dAVClsIWFBbx48iR0XRepRd7ek5Q55VKdvFOgVq8L9q/DHJVGsyl+JqP/FuIg27x5m5KqqtB0nTpBzECk02k6upRNCOMzA7oRCzdzCBRVxejICOr1OqrVKsI4hq7rWC2XsWPnTqFYtuHQSLCcE4/rug5YFuJEixTAHBNGEOKjYS3LwienT+OJp56C2aVMM8CjgTAMsXLzJsIgoKThoSEArN7PIso4puPDXc+jokGpFHUw25znTraAZxViJsJDCO3J12RtU0dAgYI88iAxQSzFqKOOH9n91Y7PjaMIH37wAXL5PI4cPSpaBUVbIGs5Jm02BITA8304jrPe0kwI6vU6tRuNRmvknrCR/KcfhnAdB0EYUr0B9pklWaa2xDAQ+D6ato1CPt/dZrZxD7qBdyqtlstwWcnVYZ/BME2RTWw5dOI9xNwD0O9H13U0bZsKvrV9J3xipM20ZuZu3ACiCHt7cDG+CHhonQGrUkGVCVSUCgWhhpUUx2myxQxACPvwm38zR4CDy94Cnad6dQKfCAhQjgBPj5M4phyGOBZKf47j4JOzZzE5NQXdNFHl/bWE0KElfJGwDZ9IEp2uiIRoCCfdsQ0xZL3CESEd1QCTG3oYRYijCK7ndfTifd+H53mwbRv5XE4orSmyDFlRWqesoXtaP4l8Pg9d11Eul5HNZLBcLqNaryO7ySbNNSF42YKnAiWW/en0/JRp0tkPrgvbtvHx6dM4/tRTSA8cgkcScRRh5eZNOmALwOjoqHCu+WTBKAxRbzbF2uOdP0D/doM7sBEvLyoKVKW3/ZAho4ACQAAiEQzli/gfnvg1nJw8KbqZ+L8winDj+nVUGw08/9xzgmAnJc4RSDjuCaIzJzXGUQSoqrBvMevYiRKdO/yY/Fj89yAI4IchZEKgdWonJASW41ClUN9HKpWinQeKAoXZjWS2ox+7wfVMarWaIAbfmJ3F3j17BAmwE3jZN2bnBdANP2acgQ3vKtHRzzyYcH0fN2dnEQPY/wV2CB5KZyBoNrEyP48gimj9jnn2SYY7J+3JsoxsOg1JURCEYUv/b7/ce97jrvaRTnNcF41mE3EUwWBqeZ7ndYx6wzDE5cuXIQHYu3ev6AGW2EbLCUlyW32NR/sBG/mrqqrom+VRDQBk2dRDIJHOYz+5OFEYBAijCJqmQeHCI4lIQlFVSL6PMAzRtCw6Bz3pYPBzZAtcURR6/h3IVElwgtCdhQXM3byJcrkMEsfifHuBZyA4J4RHO3EcryuxAYJZzJ2xhmXBtiycPX0ax0+cQJqNYB3g0UAcRagvLdExvFGEsZGRFlIfbwOsN5sgTNRKbcsibsVu8NKCTAgUWYYmdc8OypBRRBEq0ZBR0/iZIz+Fl7e9BEIIKm2aGTEhsG0b16ansWPbNqSZOil3jBX2k9sNnjGVE1lCgI1Hz2ahM6EwzgXIptPIZ7OtQ9voLyIIUZkTIUsSbb0k64OFuO1QNQ0BH2bEgphkgCOxIW0Ssx3c1sk9OqO4JoGuaTh/7hyq1SpWVlcxNjKyqYqiDGoTeDCmahpC5lwlwd+Zy7VHYYgwinBrdhaIY+xPjo//AuGhcwZCy0J1dVWk4MfYKFGAeeKMDcqj3FwmgyCKYNk2PM+jkwC38H4EQMQmgmm6ThdTYlMPWYTPo3yuF24aBpX49bxW3Wy2YcpMk3thYQFPPvkkhkulnqQXfi7tbGBVVWHoestC4KlIWVE2XSCerkOJIqRMs8Uw0reijkEmnUat0UAcRYJgIyRAWSQRxzFCbjATUYiiqlBUFSqLCJIOgiTLGB8dxQwbabxWrSImBAVGAu0JFnXxUdCqpsEPgpZOkmSaUNN1mMwxEyWDEyeQ7sP5GOCLjzgMETQaqJTLCKII+YRoD19znuuiwbQpVFVFLptFpVpFFMfwfR86UyLtB5ytDlmGzjY3TV5fixIkqFChQYMOHUUUIRMFAEFIQhwfPo4wCFoCF56Nk2QZF86dg6HrOH78OFVE3YSQt6G2z9L5BpsMyh+TQO3GZllQRZbhs2Ar0yHLxpULm5oGz/chEQLdNBFHEcI4Boki+i+OgTBEkMhkcO0Cmk2hNizpIBBCYKZSyOfz8D0PURRhaWUF46Ojfckqy4oC37aFcqLveXTybNv149c0k82ixoimt9hgo/2HDm25lfvzxkPlDIS2jch10Wg0EMYxRoaHhefOU3K1RoOS0GQZeaYEJoUhLNtGGIYIgmDDptcNvEbP42BFlsUxAhZRc9JKEAR0siEgBpPI7GbmDkCS5BfHMS5euIDh4WHs3bt30xsrqWeQPAbQmWDXL3g7TSdIkgRFkqAYBsIoEv3S6XRanEdM1mVNuYMQxjEQRdRJCAKhAMlZu9wpUGQZJdZCSaIIiq6jyuZJFAuFnuctAXBdFxIg+puDNmeg5fmyDIONMHVdF45t45MzZ3DimWdgbsLAHuCLjTiOETabtF8/CCBLEkptzrdt27BZultnev+EEOiGAcdx4LguzYr1AVGCY+p3KhuwpUk6MshChwYF67agJJUQxhEAgjrq8CMf37r1bfzikZ8X9iO5xu/Mz2NxaQnPP//8OvFxK9eDkHu2HSTxrxN4hJ/L5UBqNcSgJEqhAguaqYmYzYgS9oMwnlYcRfB5YANAZuqBXE64NDSEO/PzUFUVYRhiaWUFo8PDm+qzREGAMAyhsSAFoJoS3fYFWZaRyWSoYFwc4/atW5AU5QtXMnhonIHI9xG5Lp1YF4Z0rnY2KxazHwRoMBliRVGQz2ahsChWliSkDAMuiwrVQmFTIg+Pwh3Hge04grgnIl/OXmUp6ygMkUqlxNjdzTA9PY16o4Evv/563x5m+7O2ymXodcze1TrasheyReQzMiHAFn2H9+eLPWBZkzAMhXOQnGEugRpfz/NQGh6GZVmoNxogcYwhVv7pBI+VLmTmuTebzZaujw2fk90HhqZBAjP+to0LZ8/ixLPP3pNDNcCDjciyQKIIjXodQRxjqFika4at46ZliUyjyQXBQJ2IlGHAY9Gn47pIb7L5crsRxTFsy4Jt2wh0Ha7rYggF7M7swpK1BIBAkVR8Zep1fHn76/ij6/8Z3135HgJQ9b5vzP5n/OThn8Cw2qo3EkYRPvnkE4yPj2Nqaqqvz9+eFeh3ymkvtJcuu0GRZZipFBzXheO6NMrnmQ4eIHUQYwqjCEEQiBR9EMcgbZwm3TAolymTQcOyEIQhllnJoJtDwPUiJAAaI0RzW9IrSFSYQ2DbNiJWMshmMpjYtm3Ta/Cg4KGwcHEUIbQsgBA0mk34UUQXNDPgHnMSeC2rkM+LDZIP4kmzVrM4juH0aDGL45jW/et1rFUqVAbU80QdTGIp53Q6jWKxSGv1AAzTRKZPR8BxHFy8dAn79u1DoVjs7yJ0WHjCu7+XdBWruW9K3pEkmKYJWZbhOk6r9kCnw4IudoNlSXLZLLKZDFKpFC1rJMRT0pkMqrWaSAtylbfVtbWOx47jWKg5mqZJU52qCiJJPVuZpMT3l0qnQeIY1WoVly9d6vlZBvjiInIcxEymOmQiQoVCgRJRYzpCXHT9ZDLrjgBZFyDjaXCHEeI6gYBlBy0LlVoN1VoNTctqGdSlqSr+x5P/F/zYgR/BTxz9Gv7la/8zfvqxn0QpO4SffeJnEEnrx3ZDF//20r/f8D5Xr1yBY9t44okn+tqM2ztwAIhs5la1SdrBW3k3g2kYlI8Ux4LQ3QuyJEFXVWRSKaTZYLJMJgPTNIW+CM9QEgCVahUGG1rm+z4Wlpa6ahy4zLGTZBlp0xRlhc1aIAk7r3Q6LdoSL1+6hHqXgUoPIr7wmQFCCELG7K03GjQrIMtiRrVl22JjMHQd2US2gG9yfMlks1nU63W4ngdV00R0G4Qh/CBA4PsIwrBlkRHQyJVvaMkIksQxmowcozMyTnsqvxPOnjsHVVVx+PDhrVyIlv9Npvq2rDHQhmSfbS8Yug6PkRYdx+lYK0yCX38+OISnO7UEKSuKY9HCGBMi2v7qzSZWVlfh2DZGRkZg6LoQhbFsW5Ab+XfIuQxBGPYeJMUIXYamASxiWbh9G9lcDjt37uz/og3wwCMOAkSuCxLT8cJBGGKoVGrRHuHdOLlsdl1EiBN52XEMXYen6wiYXG0+nxcbQsAyXUEQCKVBgDoaCqt3F7mEsCQhhzz+4fCviJZnQqgGyZBWwl/Z/d/gz2b+qzj//+PGn+HnDvwMJrOTAGir8JUrV3Do0CFk++W6cOJeAmEiM3C3EDa2Q7dSp+emUymEYQjPdWGw1r1uEMEJ+x4IIAIFsFINHy8P9h1IkoRCPo9qtQrXdTF76xbGRkfp0ChWWgiCQDgjaRbY8C4EXubsmSGUqL5CNptF07IQRhHOffIJnn7uubsq13zW+MJnBiLHofPDWYeAH0UoFYuQJYm2DjJHIGWayDFGPcBupjYBG01VxZdWrdWwVq1irVqlDgLjFEigNb60aaKQzyOXzYros/1GabKUkcJqY7wO3stjX1pawu3bt/HEE0/01B5oQYeNOubKg/eQ6gPW2/X6fW6aETB95jhtOFWsOyq851lC54llvPaXSacRBAHy+Twy6TQKhQKVXpUkNG0bC4uL9HtqNFCuVKjIkCSJsbIAhH58uyZ6JxBJAmQZhq4jZZoghODG1asol8t9XokBHnTEcYyQZQAty6IlJVlGMZ+nY6+5kBB7rMUR6OAcZ9NpOrwoDLGyuopqrYZKpUK7ljyP8pQk2r+ezWQwVCggk07DNIx14jFDGIZiEFiatR7LkoS/8/gvQVU08Fg+iiP87oXfF6/7+MwZpDMZHHzssf4vRCfbcT8yA6wzYbNZAByaptG0vCQJbsaGU8U6TyuZ0ehk33gdn3dW5XM5pFMpjDCpYgnA4tISyqurqNXrqNZqqNbrACHQdV2UEThRUZakju3J3T53JpWiLcu2jYvnz3fNGD1I+EI7A5HvI3ZdSJJEp9H5PlRFQS6fbxX1yWSQSbSJdasbc8/PY2MrK5WKOIaq68hksxgaGkIhl6Oa2IrS0tOehOM48H0fEnv/9tY/HgUnRX+iKMLHH3+M8bExbNtKralHieBevHsgwRnoIzMAQAwF4gpjgkhE1mefd0pNcm2CTjANAx4jA2qqilQqhYmxMUxOTsLUdQRBgApzBiw2XYy3UPLz5um+iM9j7/A+7Z+RG2/TNBGGIa5cuDCQLX5IEFkWEMcgbOJfEIYoFgoghKDGOCmqoqDAJg0CrVnE9jJYxGxHo9FAs9lErVYT9sRkgcNQsYhcJiMcCwAb1i7PJsZsU0olIsqx9Ch+5sBPQpZkEIkgRozvzH0P16s3cOv2bSyvrODJPssDvXA/bIcQIdrCuaSZMmEYRWJWiwgeEgHEhvfq0Wao6zo814Usy1QPIpfDzh07kM/loGsa1mo11BoN1BsNOI4D1/Na2q+BhO1g3R/t6GQ3uA6BLMtYK5cxc/163zb088IX1hmIogiRbQv1qEajgZAQDBWL8D1PZASyLHJPoqVMAEYubDZRqVZh2zYMXYeuacKDTKVSyGezMJmHngQnDiZvyCAI4LBUdTqT6dnOwtXIZEnC9PQ0rC3U+zg63WSdZpHfNRIOSz/PNVkbTshUyER/cR+LodPnNthm3F63y2WzmJiYECnGerMJYL1tk5MN+eAjhQ2jCln/cxIda6eMBGVoGjRVhW1ZuHzxYkeDNMAXB5FtI2ZjdJuszZjPsG8wR0BRlA2DfyRAEIKBdf5QhWUPwzAU611lmcJcNotMOi3a1Di4M9Gy4TKyYhRFkBVF8BOS+PlDX0dGS0ORqHyxJEv41+d/B2c/+QTbpqYwNj6+pdbojtfnbiXMO0CIHPUBmdkOMJ2EIKGYuNkxutlLM5Xa4MArioKJ8XEUCwWYhoEacwYVRRFk5Vq9TjkdQdDSUSBxkngSHc6Nl4PTqRRACOZu3sTqykpf1+HzwhfSGSCEUM+efQmNZlNwBQxdh8XSf6lUiraS8S+rrQffsm1Uq1U0Gg3BYFcUBel0GlOTkygWClBVFbbjUKGgTl86H2TBFnXMPHuCdfJaPwjCENeuXcOB/fvFMKV+NuBu5L770VaYPIdeZ8I3UlH/B93AJUmC63lb8og7LWqu/eAlugw4eGlHYYIkmqpiqFiEpuuIQSM213VRY7MOwjBEwI4jJdKYXc9QoqIsKdOErChYXV7GzdnZvj/PAA8WoiBAyLKJJI5RZ8TBfC4nynoS4xzxjTopKMTV+ZLBA19rhq6jNDRER6TrOs0y1Ot0/kj7ebC2wqTKnuO6Yo5GshMqiYJRwNcf+1nx/xIkfLD0EWa9ORw/flw4LP1k9LrZDb6R3Zc++c26spi94MGCxvgChGmw9P82UseBaAbr9uh0Xjy7a2gagiBAgZUhZUVBjHXCp8UyBgETIEpeG37unY7PpZdTTD/h8gOeWfxCOgOR4wCJGozdbCKMY6QzGeEIGEwvPJmGh7QuOlSpVuE4Dq2tSxIMw0A+n0eBSRfLioJMNiuER/wgQI15/xxiEwTEWMxms0nJK5qGzBb6069du4Y4jnHw4EEhZsFvuuQ/YOMi7VbyAO6dEZwE3/BFyp+Qlqhf1PAAGJoGWVGE8dwK2j+PYRggkiQkRvm5uK6LpmVB0zSUhoaQNgyqENdoIJ1KoZDP04FKbHETwkYXM4Y4IUQsgM26H/hscwCYnZ7eoPo2wIOPOI4RWta6iJDnUWEqSYKiqgiZeFg+m6VRsbQ+rRSEwPM8VFlauT14GBoaQobploisAlMzbTabaLJMIQdpc9YD3xfZxEwm0zMq/+kDP42iUVz/XCTGaf2MSLPzFmeedeQ2sJ343AnJKaf35Ay0lUWTROGWkiHWnRJuR03ThCTLgmuxFbTbu1QqtcEZiOIYzWZT8JBy2SxSqRTWqlVBFs1ns9CZ3eEiao5to9ZoiKxrp3korZeAXgPDMKBpGjzPw6Vz5x7YzOIXzhmIwhBx4ssNwxABE/rhrFhN11s4AgBanADP8xCzNsNMNouhYhGZtnQ+TwvyEgEfLFJrNMSoUr6BcElPiw3mkCSJpvj6XEy+7+PatWvYu3fvhulo7Ug6BBuITIn3S/YKk7a/cSauSL8l/pEOP0kiVbdBSKTNyCBxTUymyOZucVEnZaOB9cwA96qjKILVbArmr6HrGB4eRml4GArjj/AhTFwgJs8WPMAIWo7T0jbWq1uCfz5dVWEaBqI4xtVLlxB0iPgGeHARO46wERIor4cz/EP2XSbnk0gAwCLUaq1GtSpYZNgePLQQk0HZ7YVcTohc8dQzv2dEa6Ik0c2JC5KZ5qaiOGkthb91+OfXPxeJccOdwXuLH9AHkuuxLbPXHli0I0oQjzeUzbAeDLTYDvrBW+WJ2zZ+kjxG27m1gw8CAiEds4G9wDMjHKZhCLtBANGlwaWSM5kMJicmYLIJp6vlsigbpUyTEg/TaSqpzF7faDZFOaeX3Uj+JcW6E8rlMu7cubOlz/RZ4QvnDMScaco2a4el9jiBh8uE8tshZOUA7gQA9GYr5nLI5/OC7JZEe/ufpmkoFApCdMJxXVRrNUqQY2qGHucpEIIsH4/bJ65evQoC4ODdKFZ12Ij5xitJTMc78TcAG8adErQu0vafoqNgi5GCrmlUcOguswP8GnI2NRd4Ej3hEp08mEqlBFEzl8tBkSSa+UlkEjihJ8sIXISRkWz2XfpB0DWlmoxcTNZ73KjXcfvWrQeeFDQARRSGiJIRIr+fPE+UA7KZDPQEWdD1PNQZITBi91sqlUKxUNgQPPDXAK0bL9cWkUAj0nqzKdoY+Zq07iKb+LV9fx3j6THEJIYs0fP/1+d+FzG5t6iTk6tVbjcS6FQ6EA4CfXHLepASr+mLL5T43TRN4G6zA0lnwDTheh5830eT8YcIIdBUlY6NZ1yOkeFhaGwE8uraWosN1TUNuWwW6XQaiiQBcYwgDOm9Ydu0m22zc5JlkWWem5mh8xgeMHyhnIEoCATxh6e+LNtG07ZhMg3tHBP5iaII9WYTVeYEyGCbej7f4v23o8XbTYDPKudjSmNC0LAsNC0Lge+LVqAU8yL7hed5mJ6exv79+2H0KWeaONnerUFS/22B/WCrN4sk0amAEnBXizqZIdBNE/VEepYv0PZrXSgUaGlAkrCyurrBCVEUBbphUCfCMCj/JIrgOg4s26YCUu3XNHkdCaHtk5KE+du3UfsCiYo8yuBdRzyI8D0PnucJ3fl0Ok3LUaAiZdVaDRaL/iRmyIeKRVp67OHod1pvOgsmOH/ID0PUWTDh3GU2UZM1/NjQj7SUt67XruN7t97o74J02Zx5ZqDXZ9wySOfurV7QNQ0aS/l3rPlvAt6qrGoaojimvDIWMPJx08lzUhQFw0xjIvB9lNvKgDIb8MQnVKpMiyJg5HO7m+BU4j1Uxm9ybBu35uYeuMziF8sZcJyW1HgURWgyJmiaRYUScxDWqlVBQNE0DYVisbVNqMPx2z37TjB1HUW24UigEUe5UkGd1SJTW9zQr1y5AkmScGD//tY/9Eke7IRPgy/QL9oXvcYGEd1Nyi9m5L96s0lnJLCpktxL75Z9KZVKQtVsdW2thechs6loXFee93oDdFgNTyNuUBxL8E4URUGaLerF+XkhajXAg4koCBAnSKOQJNRZuY8rYKZME0EYolarocFTwJKEVDotnIBeazLZdtgJiiwjm8mgkM8LASxupxzXpQ7sFjZg3/cxtFLElDHR8vjvnf99hHFvtTx+vp3QscvhPqAvNcS2/zdNE7IkbbnMCFBCtsO0YcBq/iZrLexWhtF1HSXmELiOsz4uHhCj2blYVCqdRi6TgaooIKDTXZvMKWi5tm0Bm8mGxi0tLKBcLj9Q/IEvjDMQ+T4lDRJCvVZJwtrqqlCUGymVEDH5WC5aoek68oUC8iwTkKyVbaiH9eEIcPCIt5DLrYtgsLp6hXn8/XzJjuPgxvXrOHjw4KZ1wq2AC+vcDz39lutxF4QiKUEI8vtc1Hysab1eh+d5VJRIlqGoKrKbkKv4ew6XSlQHoi3tp7B7hw9AkRPePncKCGtL3LCwGQio4TAMA0uLi6KnfIAHEzyI4KWuKIpQrVZFF0E6nYZl26LFTGJOAHf6+UbQDe1lxV5QWQtjhrXD8tkolm3T8kEQ9KxDc9DSooR/8MSvtDx+x5rHn89+q8+z2YgkZ+DzhqZpQh2wH5niOI7heR7q9fq6kJREFRbTqVRfE2lTpolioQBFlmkZgKXzk9cjYvaelx65UwBChAqliPqltrZstneEQYDV5WU0Go2tXpZPDZ//N94nYlb/TTKBm5aFkBCUikU6L6BWQxxFQo44z2pC7Wi/IbbiCCQRMvJRJp1GaWhItLY4rosa0x4Peyzuy1euQFFV7G/PCqC7597Pc+5bW2EH3E3ZgROCOAGnE1oWcmIxqaqKTDoNhWmO9wtFUTAyMkLTfkEg0n78moRR1OIQSgmnQNe0DQu7k/No6jpilvJ9kBb1AOuIwrB1gA0hqFWrCIIAsqKgWCyiyvklhMDQdRRZJqBlnDYvWbU5fVzJdKvwwhAmU0XlegIBm5FQrdfhuG5XB9PzPExfv44D+/bh9V2v4kipVbb8313+/8ENu7ewdbMsSXtyv7OK/fIG2mGaJmT0LjOGYQjbtoVwEFd7NAxDyDJvpUyRzWaRzWahSBLWKhU6/ZR1ZkCS4Lel95N8JD5jgQ864+fS/vx0KoVKuQybZy8eAHwhZhPEQUCjOICmaqIItmXB833qlUsSbRUDRNqv20YoSRI63VJb3eQIocIYIHR2di6Xo0Q5pm/Np/f5vi9IKLquU+dEopKbMzMzOHrkyKYztrucwMaHQKPa5PtGYShGCPOfFZb+qlQqiOIYCpNJbhkfzCQ4N1wndrNvFaZpIrQsuJ4HwzDEUKggCOCz6WPrb0Kvl2EYIgugStKWo29NVTFcKmG1XIbrOKhUq8iyAUTdKD+cJKZpmphGads2NE1rnWnOjINpGFhaWEAun6cG5HMozQzQHTGbQMezAg4z0lEUQdd1OGx2CJ9u2StDJ9qU4/VppOLxLcBjswoAoJDPiw4Vj/EY+KAtx3GgKgo0JoLG762rV65AAnDgwAFIkoRfOfb38N//4P8qjl92y/jmjT/B1w/+bKe372o7+Oh1QghsNo43iiI6QpgQNJjdWGOlN0WW6djghP2Q+c9u12+L0DQNqqaBBAFc16XDhwgRo+LDMGyxC3z4maZpkCQJzUaD2qwtOiLFQoE6Ga6L1bU1jI2OQpYk+FEEvcuxVJa5dD0PjuuK65k2TTF7Ivm5PM9DdW2NklL7HUj3KeIL4QxEbEEDAFitzXVdQQ5TNQ2SLCObTveVbucpQ86CvZto13ZdoWcuJENZK5uu63ToBtuUCauXe0yeWNM0XLp4EZqqYu/evd3fhNDBOq7rwnVdeK4L1/PE/3P5TI9dC74oOt2qyc8YRhFiQnD69OmO3Qgt14MtdMMwqIgTu7FN06RtUIYB0zCowBIT/+kEnaX8vDBEvV6nvf9thBuuAKZp2gZnjvc9b/X7Mk2TRn+VChpMobAfp0JVVeQyGTiuC5cZ7yAMkTIMcY8R0FKU22igWqk8MIt6AIo4CEDCUJDh+CAam42zTbGpdqamIdVnBxBnx/OWxK3ajpgQyiRnWQiubqcwYlvaNIXdCNh43pA5BgpbM9PT03js0CFxH54YO4Fnx5/Gh0unxPv8h8t/iK+Mvw41VqmTkbAdtm3T7if2/7yu3pIpQ6KbqO38z5w5s7Fs0sF2SKoKlelzmKYJU9ehtdkL0zBgmCZVe5U2zicB6Br2fV+08yVlxgH6fWgs2GoPrCQm+X43WYnhUgnRygo838fq6irSmYyYZtkNvISsqyosHky4LtQgQCqZbSIEKdPE0uIi8qy1fSvE808DD7wzEPk+XdDMK+dOQI2NJDZSKaRMk0ZtfabFCUvdEGDDxK5+wGV2AbT0GCehqipNcbPaoM8iYD4W9eatW9i3fz8azSYd3ckWqWVZaDCtbMuyWhwWAoiNWdc0mIzhbJomNF2nHrqiwHEcIWeqatp61M/mIdTrdfzgzTdx8uRJpDMZxGyB8UiA19OjKBLXO44ihOz/K7UafGZcAAhRFgnrtfR8Locsq8em02kYbEE7to2YEGTYhEce+Wiq2tMY82ss30VmIpvJiLHHtXpdKBZuNoVMkmWk02momgbXdRETQsfUMjISP6dUKoWlhQUUikVkmfDMAJ8/Ypb6B0vv27YN13HgeB5iAJlMhpYS26K2XuCZyLtxBAA6RTUmVLG0ozopS28brNPF9334QYAwCBBFEa5duwbIMkZGR2lLrO/DcRx8NfuVFmegGTbxG9/9X/ACnhfnrWuaGIxkMsfVMAyoqiqc8yAMoeu6UOLjNkVWFDSbTfzgBz/AyZMnkclmqb3gtiJhMyJmRyxeJgXNhtSbTTgrK/Bcd33oD6vpS2yOQDaTQS6fRyaTocTOVAqKosDzPDH50WSZRVVVaeagTeo5iZb1nSCf9wPecri0tAQ3CBA1GkilUn0FE5zfxJ2ukFCp6XQqRe2DJNGfrotKuYxUKoVSqdT3uX0aeOCtFvE8QcKIogjNZhMOUxmEJGF4aEj0b24VEgDwFFIc92UQCCFCIISnonq+TpKg8lSXZaFaq4k03/LSEmZnZlqm+3GW6ujYGHaYJtKpFFLsn2maVF+fEeA6vWsURajX64AkoVgodFwknNWfYip9vWCzgU8mc7iAdelQwlKbrufRLAXXAWg0UG82sbi0JORVOXHGSKVgGAaKxSJGhoeRSaXo1LZNILF2TgmgEsJbceIIHQPruK4QDSnkcn1HCzpzqHh2hxMhucIlJyrWazWkUikMDQ31f24DfCqIwxBxYty47TiwLQuu69Jxt7KMkeHhu9LPIECr9G2f95EfBLTDiRCkUqlN7z9e91ZUFfUgQHllBbdv30bKNPHhhx9SgivbmFRVxdPq07gSXkGIEBEiXJQu4x++8A8wWZhcL811aUcGIDIGvNTaDr6xi7JoDxBCBBuf2yECCL0GPq7YcV04bMw8tx0Li4tCjZF372RY66eZSmF0dJTOFWBCPv2AEzU3UxpteQ1oQFAsFrGysiL4TkqHmRGdwL8/VVVhMw6IZVktIkYp08TqygpKIyPwff++Esm3igfaGYjjmGYFAIAQSvSxLChM8tNMpTZt+ekInjZir5MkCYS1nG0GzgfgjGM3WcJIIIoiVCoVlNfWsLa6itVyeZ2IRgg01qI4OTGBTCZDo3vDEHX6mG22/Hx5lC6zWj5XPZQlqWVBJOuY90NbXFwRQgSLNopjWmpgUYAkSTBTKRptsDYecR1YmcNxXZr1qNdRWVujKlzsXAv5PErDwxhhKoLtPcD88/B+ZRmbywdzcNlTSZIwVCxieXlZ1AJz/c58BzUKJuMwWIz007QsMZksbZqora0hXygg20H/YIDPFoSV5CBJVEGwUqGtqawUZbDW4K3YjuRaQHtn0ib3I2HlAQKILFmYcFaSsB0H5dVVlMtlrK2toVariQwhd0JzhYKInPmGc9B+DP/39/4ZYs6KIsC35/4Sv3D45xHFsShJ8Gmp7ePNxQTW+8B7SV6NmAVbMSEIWfaA2w5VVZHN55HN50ULIIfPau+WbcNuNlGr11EulzE7MwMJgKJpGC6VMDw8jOHhYQwNDW1Yd9w2cjGlfksG/FoD9PvK5nIIajU0mk3RdbQZRAcLc2ZsxxHqpwbLcCiKAhJFcJgjNDw83NexPw080M4A8X2xWCuVCqxGA5AkZLNZSjwLQ+hbFeoBOi5cUa/qcaOEUSRIg5zIwl4M13WxtraGMtv4q7WaaD8plUrYt28fSqUSKpUKLly4gC+//voG75sL4PAJfX4YImYjd/mmBkbwabmhpXUd8jAM4XqeGLDUohrGbk5OXvKDQBAvec1QqO2x9+OZAd/3oTPPOOnhJ6FIElUcBK3/qyy92P4ZG2x4SxzHsC0L5bU1rJbLmJmZARgpTyzykREUi8X1Oi37PP0QGXkGg58nV5K0HAdNy8JQQndiM/Ayja5pQCYjmMLcIVCY908IQb1e/1wX9QAQ4mRhGGJlZQURsxWKoiBg5MEtg9fVOziqm9kOi5WXZIl2H/Hx5iSOUWk06MZfLqNcLgvdikw2i+HhYezZvRv5YhEfvP8+SqUSnn322Q3Hj6II2WwWz29/Fm/efgsKFMiQ8fadd/CV7V/GaGoEATbWuyVZFq27TdsG4piWDJgDnXSYOEeL2w36kUmr/QAAFiw0LUsMcuPH6DS9VJLo+HJ+Lny+Q7t98T0PluOIzFy1WkW5XMa1a9dw8eJFSJKEQqGAkZERlJj9aG8l79cZ4DNrOPL5POWqMVXKYqGw6THYG9LrCyCTSsHxPAS+L4iiKcafqDEiIc/MfB54sJ0BtqCr1SoatRoIgNLQkDDgfFLd1g7aPU3GU/7dVAgtXh5gaodzc3O4Mz+PKms/AWiaf6RUws5du1AqlVDI58U5EgBnP/kEU1NTHdNwEqsjqaqKmBCYbOG21+NCtpHy7gEuohMB8DgjGGgZ7JMENzau624awcZcf5vd1DwboSaZxIxFzFuvekXtkiRBNwxELG03MjyMnTt3AqBOytraGtbW1rC6uooLFy/SLhJmnGRZRqVSEc5BR+Go5Hl3uDeyTE8gdhxUarW+U408qohZhJVlQ7EIqwVy0lC9XhfdLZ/Xon7UEbN23iiKsMIyQZqmYWRkBGtra3QNs7rt/ULL/dhWcuQpcTCuTL1ex+zMDFZXV1FvNBAzlcOhYhHbt2+nczaYcBbHwuIimpaFZzo4AgB1vhVFwS8e/wV8e/4v4cc+JEiQIeO/zH0T/+iJ/249KucEPJZ95FFwwMjOKuveage3cf3YDV5GZBeH2kBZhsKuleAjMD4Tf02verym61Bcl8o2ZzIYGxsTf2s2m1hdXcXa2hoWFxcxPT1N+Re6DgLg+vXryBw7RuXnewQSwllpuzdkVi6wmk0xtbLfzGIyGOMzClzWbRBHEZVMZte2Xq9jdHS0r+PebzywzkAcRSBsIE2T9XAXikXkcjk06nXELNV+Vwt6k5pzy8Jmz3M8D41GA+XVVdSqVayurtJJiek0RsfGMDkxgeHh4fXOgg5YXl5GvV7HkydO9HGK65+LLxq+AJN8Ab6AxOAkxqcwGZEv6bXzz6MwZ0pVVRrpthGixDATRjgMwxApXpJJvm+na9hHPV/XdTiMRBRFkWiZ0jQN4+PjGB8fF+9RrVZx/vx5Gt1FEb73/e8jZZqYnJrC1MQEhkdGWlOdCQPUDYVcDi6bWFdrNDDUr5eP9dZKmSnKcRlSXgt0LAuFQgGNRmPgDHxOIMzIVtbW4Ps+VFXF6OgoVFVFEASI4viuMgObkY1FFKooQnuAEIJGs4m1tTVaNlxdhWXbkCQJ+UIBjz32GK2BF4tQezil09evY2hoCMObkMzG0qP48b1fwx9NfwMEBBEifHfhe/iZQz+NPYU9LWtTTBxlpT+POQNcbrt9Il9Hu5H43DwLyf8/juncliR3KZl+34A+rq9mGIhYtjKpIcO1AXbv3g2AZjFu376N8+fPg8Qx5ubmcOvWLYwMD2Nyagrj4+PIJAIywsqgvUqrhq4jk83CYiULgwUA/UACREu7oeuQZRm2bVOBM9tGyjRFkOY4jhiq9lnigXUGiO/DZUNpoihCNpcTZLcgDNedgS0dlKXA+3gqr1HXGw3cun0bc3NzqNXrkGUZ46OjOHb8OErDw7QOqWnI9UEqmb5+HYVisa8Ucq+hOS3tO4xgw+ErCqDrSCVkdtvBRTO4RncvhKxlsb1lcMskvgRkWYahaXAZIa8bATSOY1y5cgXlchmZTAYllkVYmJ/HwsICZq5fh6wowhkbn5joq1avqCry2Swc10Wz2RSpun6RrD+mUymqL88WNZ9uybUePk9C0KOKkJFEHdeFqqoolUqUsMWyBSBka5yORDmwn3teAnXYl5aWcPPmTcwvLiJkrWVTU1OYnJyEpuuI4xj5PrpP6o0GlhYX8cwzz/R1uj9/6Ov489lvwQqpeh4Bwe9d+jf4p8//k5bnybJM9QAUBVIUwdB1SLLc1SaEW7AbESuRtpQpcXdt3EkYrLMnZPop3XQ96vU6Ll68SPVNwhAvv/wyGo0G5ufncf7cOZz95BNks1lMTExgfHISQyzbuBky6TQC34csSahUKhgdHu6PxChJUBj3C6CZqWwmI9olPd+HZ9tIpVKwLGvgDCThNpuwbRuB59Exwvm8+LJ85gz065UB2NLGVavVMDc7i/mFBViWBUmWkS8WcWzXLuzZtQsG2zg4M72fYzeaTSzMz+Opp5++J2LfZu/0aaoPJiG1RQ3i8T5frxsGXQBsUEz7NfE8D++++y4ajQZeeOEFnDt3DrqmYXR0FKOjozh+/DhqtRpu3b6NO3fuYO7WLciShNHRUWzbtg3bd+zoqD7JwTd/PwhQqVYxPjbWd5+5rCgizchFikJWyrEcB45lIZPLwXGcgTPwGSPyPFi840iSkM3lRLbODwLEoNmduyF4brb2oijC/O3buH3nDpaWlxGFIVKZDKYmJ7Fr1y6MjY2J+7zKJKz7aZK9fv06DNPEtu3b+zrPvJbDz+z/Kfyby/9WPPb+4vs4X76Ax4ePdv5s/H7u6x22gA62LqlhsFXIiiICCd/3O26at27dwqlTpzA6Oordu3fj/fffp/yLkRHs3rMHYRBgaWkJt27fxvSNG7h4+TLNNk5OYtfOnRgqlTraaP5ILpejOjNBgIZlobBJZ4UACyJ4oKcoCtLpNJrNJnxWIi0OD8P3/Z6OzqeFB9IZcJtNOJYFz/OgGwadBJgw7NxD7Zs82L5Zd9i8ozDE7du3MTM7i7VyGYZhYGrbNkyMj0NlhiPfPugoQYrZDDdu3ICu69jR54Lu5jB024Q5BCP403YGJKljOybp09FRVVUoi/HWRY5Go4F33nkHcRzj5ZdfRrFYxJkzZ+jz2eeLCUE2n8fhI0dw6PBhWM0mFhYWML+wgDNnzuDs2bPYsXMn9uzevaHVj59hPp9HtVZDEASo1GoY7rMlUJYkRIkoUZLogCrLthHFMRbm57Hv4EG4rtvixA7w6aNRqSAMAoRRhAzTuOD3KK+J63eTFej1nvU6ZmZmcHNuDoHvY3h4GEePHEGhWBRqnoVCoYVsJ9LmmxzfD0PMzs7iwMGD/Q8PkiT89IGfwjdv/Alqfk08/K/P/y7+t1f+l47342c53OxuRYA4dMMQJMZ2nZfLly/j0qVL2L17N5588kncuXNHcEQ48VqSZUxMTWFichJRFGF1dRUL8/OYX1jAjZkZFPJ57N2zBzt27uzoNKqKgkI+T7lsjUaLEFkvcI2KOJHdVRUFpmEIMay1chml4WE4jiOklD8rPHDOQBiGaK6tialhumEgndgoeFsKtrqou6Beq2FmZgZzbCGPT0zghRdewMTEBCRZRrPZhOt50DSt5caQsD4ieLMbO2ALes+ePX17e13LBJu8hnv4WyZWdjsm/6XT8e7xPQym1OgHgXAGVldX8e677yKdTuPFF18Unn8YBEL3u93hkACk02ns3bcPe/ftg+s4mJ2dxezsLGZmZjBULGLPnj3YsWNHS0pWZvXM1XKZytR26a/egLaeZd53nmYpPse2sTA/j6lt2+D7/oA78BmhXqkgsG34vi+EuEQQQaiaJ+L4vgQRcRThzp07mGFEQN0wsHv3buzevRvZbBZRHKNWqSBmnUfAeqsZ3xQEAbgHbs7MII5j7N2zp79zZkipKfzCY38T/+9z/4qebxzjwtoFfLD0IZ6feK7DR113bO8L+PE6/e0eSozAerdBzHgOJhNoOn36NObm5nD06FEcPHgQAIRccVI1UtgtibZXjoyOYoSVfpeXl3FjZgYff/IJzp0/jx3bt2P33r0YKhbF6wiAXCYjWqbXqlWMjYxsGoDx7z4pnEYIgc5KRn4QYOHOHeTy+YEzQAhBZWUFhBHLTNOErutQNE0QcsIwFBe07zRKGzs0iiKaBZiZQZllAfbs3Ys9e/a0bAZhGAqRkE51bcGgTx6/w01+k82u3rtvX9/XotuiTLbKtSNJnrtvmYHNiJbtbUJbWOQaE/PhOuMLCws4ffo0xsbG8Nxzz0Fl3jxAhZIUVe2ceWCfl09rNFMpHDp8GIceewyLS0uYuXEDp8+cwdlz57Bzxw5MTEwIJ8M0TeSyWTEgppOkaaf3AyFivkIy7ZdKp+E4DsrLyygODVH1xYEz8KnDdV249Tr9XhizviWFLNG22xi4Jw2IRqOBWZYF8D0Po6OjePa55zA1NdWy5hzHEZ1H7e/HW+nkxKbUaZ3FhGD6xg3s2LFjS5wWjr+256/iG9P/BUvOEggIJEj43Qu/j2fHn4EstdoHvnbu9+jibuhkx7aSLTB0HWEUwfd9KLKM9957D2tra3j22WexnWVfuQy82s1uYJ0bxv4HY+PjGBsfh+u6uMkDips3USwUsHvXLhSHhsS+M1QsIlxeRhBFfRORBfGbvS//zAabTxGGIW7fuoVdu3cjZCPbPys8UM6AbdtAYt4AgHUSXFu/aN+bXWKj9oMAV69exbXpafieh7HxcTz3/POYnJzseDzHcRADQtSjHZ2IMS03HUsLXp+exrbt27eklNixba6HI8D/3n5e94pemYF7qf3RQ9JZDlEc48LFi5i5cQO7du3CE08+SVPxrGuCO4DqJkZ8w/nIMiYmJzExOQnHtjE7O4ubN2/ixuwsCrkcDh44gO07diDP1AkDVgPcSncB0BrdaaqKmJUMlhYXkU6nUeiiBDnA/QEhBI1qlZbQEu25qqq2tBLz9dGX7WjbmFbKZVy8cAHLS0vQDAO7du7E7j17OkZvYRTBZ5oT3dZ8klgnYaPdAIDFpSU0m0082ydxsB26ouOXDv8ifuP0bwpJ8xv1G3jj9pv48o7X2j4usx332xnoYjekTiJvW8gY8DbDpm3jg/ffh+u6+NJLL2F4eLilWyEIgt4bKif2tb2vaZp47NAhPHbwIJaWlzEzM4NPzp6FoiiYnJzE448/DtM0USgUUK5UYFkWHWXc5+Ytt70nJyM3LQvVchmjY2NwHGdTpcf7iQfGGYjjGM1aDXKCZKHrumhnEQu6j9YxAfaaIAwxPT2Na9euIYpj7Nq1C3u6LGSOMAgQ+D5ASFdmJxfkaBmakXx7ScLy0hJq9TpO9NFO2HLsDouiHwITcJ/5Ar3SfZ2evsXDq6qKSxcv4vadOzh86BAeO3RIlF74e3KRpF6EwPbsQDtS6TQOHzmCw4cOYfbmTczMzOCDDz/E9Rs3aH03n0d5ba2vRZ10Ojpt8rqmwVdV1JiRaOdEDHB/YVkWFSgDhF0Qazbx/fB22K04ZmuVCi5cvIjlpSXk8nk88+yzmNq2recac1kQoXcJIgAAbDOMO60vVkKYnp5GcWhoy5r1yYzdV3Z8Gf/x6h/hev2G+Pu/ufQHeGXbS1Dl9XOL77PtSAqydTxHbLQVm/GhWp4rSbBsGx99+CEkWcbLL7+MXC63oezSV3QtSd3fW5YxzjqVLMvCtWvXcGtuDnfu3MG+fftw8OBBmLoOh83L2az1swXtWVWJCq75YYjl5WXkcrlH0xloNpsAk+fknl1Laxyr9RBsHiEDAAiVvrxx/TquXL2KkKXpDx48CE3XN01J2SzNx+cBdAL3ormRaa/TSwBu37qFQj6/oZ1w089wF5HkliKffo/JT6fD36QtePItx2Sv8X1fpPcef/xxbN+2reP78Hnf9yVlxmqExaEhNJtNXL1yBW/+8IcYGxvD1NQUNMPYdFELrgDfXNpETLgmuVuroVarYWhoaOAMfEqI4xjNeh0qywDGrG2w073Sd/RLqK7+pYsXMb+wgFw2i+dZBnEzsnBLabHHd94icNYBrutiZXl5QxCx1eyfIiv4O0f+Nv5v7/1P4rF5ax5/PvstfG3vXxeP3W/icS+7wR9v/+SbWZLktZq/cwcffvQRMtksjhw5gkyXwC4Igs3LQpsEEhyGYWDvnj3YuWMHFhYWcH16GjMzM9izezdyhQJsx0Fuk3bipKNG2L/kNdI0DYauw6rXUa/XMTIy8plJmz8QzkAURbDqdWiEUN15oDUrAKynkJhiVi+CXBxFmJmdxeXLl+F5Hnbv2oXHDh8Wi7M9JdSOIDFvvJeIkEjztfMGGMIwxK3bt3Hw4MENizcpwsHTm0mWcadNtl1joB3xfSYP8vNjJ9zx75syg9tufP7/tm3jnXfeged5eOGFF2Awj9js4CTxQU79LurNporx8x0fG8O2yUnMLy7i4oUL+OTjj1EslTAxNYVcj9n2gjzI/nVSQ9Q1DYZhoF6rYW1trUUadYD7Bx5EyABCHkQk1yxfl12yd+1o1Ou4eOkSbt++jXQ6jWeeeQbbt2+HLG0uOQyADtgBDWSUHs4rJx93O96tW7cAWd7QTrihzs6OkXy8/YgvTr6Aw0OHcLlyWTz276787/iRXT8CUzE+FeJxPwJCvZ7TklkgrRLG169fx9mzZ7Ft2zY8dugQoihC0IWo23fdXepjbgHLHmiahiNHjmDfvn24evUqrt+4AVlRMMF0TiYSyojt4E4XL4HKHd7TNE1UKhXYbILtZzXN8IFwBur1OiSm6sajwI4LWpJEX24nw0oA3Lp5E+cvXoRjWdi5axcOHTqEbJ9Tpjhs1xVZgc1abWR2Tp1uooWFBURhiB07dnR9PS818J/icWmjCmI7EbId93PQSMfz7PI4N0jiJ9skuy2raqWCd999F4qq4tVXX0U2k0Gt0QBhQiLti7evMgE/nwRjuxtET7UsA5KEqclJTE1M4PadOzh/4QIuX7iApcVFPH3iREdxFZ6dihPfSydDkslkUC6XYQ0NodFoIL/JhMgBtoYoimA1GjQrIMtAHG/MCiQ3yYQ2RDtc18WF8+cxc/MmUqaJEydOYOeuXVC2sDkGbEw56VFaFKfFz6nL5jN36xamJiY2vefb7QaPNEX5gW1yf+/o38H/8Nb/KJ635pbxzek/xtcf+9lPhXjcq4zW8rxEmSTuZDeS14cQnD13DtevX8eBAwfw+OOPw/d9WKyDpJMzEPh+35H1ZnYjZhs4zywZhoFjx47hwIEDuHTpEm7duoWFxUXs27cPjx082NGx4lwotDk7SagSlVFeK5eRzmQeHWcgiiI4lgU9jiGxG19n2v8C7Re1Q/Ro2zbOnD6NpaUlTG7bhpe+9KXu2tE9vFLP9xEGAe0d7yO1K6Q3Oxxv7vZtDLEpfHeDpPfMnSBeXkim4UTv/aeRGWCZGLS/Jz0ZIS/K37GbY8SxsLCADz/8EMViES+88IKIvnVNo0pcHQg/LnPOjD5T7T2HGCWMTcs9JEnYvn07xsbHcenSJczdvo3vfOc7ePzxx7F3375WZyjRQdDynm167oosQ9N1rK2uYqhUGjgD9xnNZhNSFEFNdpJ0u0ckqaMjTQDcmpvDJ598AkgSnnjiCezevbujNPBmq8pmcrJmKrWpQ843lE6p6XqjgUqlgsdYe9xWIIKLxGeN4xhPjj6Jp0afwkfLH4nH/8OVP8Rf3fNXkJLoNbvfxGPe19/NGoi+f2xuN6IowocffojFxUU8+eST2MNaLTVNoyTjOO4o1OO4LkZGRvo6Z0mWIXVY2y2fCRuvk8mcx8nJSVybnsalS5ewvLiIp556akPNP0arHHMn3hkkCZlUCstrayg2m7As6673kK3gc3cGPM+DzKQrOQGuZ32V3TzJNPvs7CzOnT0LVVVx8ktf6pmmAXp4gISIlqB0nwNsZEUB2HRBJDYx1/OwOD+P408+uekxuiLhPUptWYHk7ZjUAm+JUpPEmET5gbT9a/lb27EFG5v/QwfiT58fZ3p6GufOncO2bdvwzDPPtFxfjamKhUEA0iYk4tg2TMPoO+PBo6FOizr5WCenSdc07Nq1C8ViEbfn5/HxJ5/gzp07ePrpp8WCJJK00dnokI6GJNHRxo0G1SHfInltgN7wPA8yywqQdq5ApyxaoqwDUCfzzJkzmJ+fx86dO3Hs+HEYd1mf9dm9iz6DCDFat4MzMDc3B01VMT4xcVfn0gkSgF8++ndxeuW0eMyKLPyna3+Ev3XgF+h1YdcRaCv/JYOS5Abfds8TbqcA4Rj3Kgck/9ZrVQg10nodJ0+eFLNL+DE0XUfsefCDAKl2Z8C2+9MOYWhn+SdBeGagyxoeHR1FTAiGR0YwOzuL737vezhy+DD2HziwPqyuw/fdyVYpqgpNVdFsNB4tZyC5OXNBia7gm5wktWQDdu3ahWPHj/eVSu4G1/cRhSFkWe6b8KWwc2nPDNy+cwdEkrB927a7Pp92sslm4Bt7y5xySWpdaDxqSN7QPeqpm6X7NjzaaSERgk/OnsWNGzdw8OBBHD26URJVZRMQwzhGEIYtglL2XQzu6LaohfpXj005l83Ctm1s37ED2yYncfHiRZEl2LNvX8eJbkCH7EBM57XzQUYDAaL7hzAMEfo+DNCNhwCt17ZTFoA5ApIsY45lA2RZxsmTJzHZ78bbaXMjRBCOU/0GEew5MWklHxNQvsD27dvvS89/0gE9OHQAr0y9jDfnfyj+/l+mv4m/uv2vwJQMYcs42jNnQGK9J0uX/Ckd1luvTT6Z4exm31rUSF95BcViccNzdE2Dz0o0SUfMDwIEbMha39gkkCDonnlVFAXZbBYxIXj82DGsLi3h3PnzWFhYwFNPPYVMNts9+8HKXMnz0DUNtmXBsqz+z/8e8NkoTHQBIYQ6A4SI1KuxiaxjTF+IxcVF/OV3voNavY4Xv/QlPPX00/fMuuTp6E5a+d0gMcelfYOYm5vD+Pj4/dOm34SQEyfqUJ9Ga2HP7oYef4uiCO++9x5mZmZw4sknOzoCHLqmQZIkwRHgsC1rSxoN/Jw68ko6ZT/awBe1IklQdR1ffv117Ny1C2c+/hhvfP/7XRdne/aGsGOpivKZLupHAb7vQ2KRGgG99km1wW7rJQgCnProI3zw4YcYHx/HV7/6VUxOTt7TuQRBgIh1QnUbDtYOWZZpWlqSWtLG5XIZzWazJ89oM0hdfgeAv3Pkl0AHCVN4sYdvXP3P9LmfhuBQv3a0w2OrKyt44403oGkaXn/ttY6OAEC5RDLL1nHOGbAu/LSVzADQfbOP+7CF2WwWCvte9+zbh1dffRWu6+Ivv/MdXLlypWv5stOVN3QdruPAtu1NSdH3A5+rMxAEAeIggEyIqImLDb3Lgq5Vq/jo9Glcu3YNkxMT+OpXv7qeNtpkw9zsXPiC3soGrrDIO5kZaDKN6XtZ0ECrZ75ZK2QypXe/UtG8RrYZujGZXdfFm2++idXVVZw8eRK7N5FU1Zgz4Pt+y/W0t5jq4+i0qEkbCagb+KImhMDxPDzxxBN48Utfgm3b+M53voPZ2dmOr9sQWUkSNObh22y89AD3Ds/zIGP9HtWT48y78AMuXb6MTz75BGvlMl54/nk8++yzW3bWO60s1/MA0MzEVhxxJZEd4Lg1N4dUKtV3nXsztK/fHbkd+LFdP9Ly2Bu3f4AVZ/X+tiT3kf5Pnl/7ec7NzeGtt9/G8PAwXnnlFZi9ggG2xiRJEhNZAVoikEA1RraE9mwqP8dNMgNgf8vncpBA94F8Po/Xv/xl7N69G+fOn8cP3nxTcEs6vW/izahyIig3xuc6Gp8iPldngNf8eKSmKMq6ke6woC3Lwtlz58Rsgju3b+OtH/4QFy5cQLlc7mtgEND5BvX4gmazpvuF3CEzcOvWLSiKgql7jDg4OpFW2lm3nfqPW/6e+MmzCP26Tu11sg3kubbzAmh67wc/+AFc18Urr7zSUufrBkVRoLKIKZkdsB1n6wu6C0RmYBOHqX1R+76P0ZERfPUrX8GOHTtw+swZXDh/vvO1aFvUuqbB+Qw9/IcdPKMosxQ7SGKceacgghBMX7uGWrUKAur4nzl9Gu+//z5mZme7G+dOaLtveFsbIaTvrIA4lCzTQILZjogQ3Lp9Gzt27tzScXqh0xr/W4d+AbqsJ55D8H/M/NmGEkAyGBA/E9d2M/uxwW5s8neOS5cu4dSpU9i1axdOnjzZV2ugrqrCbvBztB0HErDl7wXoHCzwLqnNbIcYrEcIGs0mJEnCsWPH8Oorr8C2bfzgjTdQq1Y3vE5usxuyLEOVZTQZ5+jTxufKGQhYVoDXuo3kggZaFl61UsHb77wDWZJw/Phx6LoOWZKwuLSE2ZkZXLp0CaZhYGx8HOPsX8+bIJHSjeIYvufd1YKW27x7AuDmzZvYtm3bPY+gFIsnsQDj5A2Z2NAjVjdt71vt5BAkORq9FrQYptH+XMaR4G18aHMUVlZW8N577yGTyeDFkyd7e/Vt0HQdAe8b1nV4bJznlssE7LzadQc4Z6Cf7EkqnUaDeeWWbSOfy0FRVZw4cQLZXA7nz52D7Th46qmnWr7r5BAjEbUQgka9jiAIBryBe0QURTSjGEWQFQUy2tpO24zq2bNnMT09jalt2zAyMgKTCUstLi7i1EcfQZYkFIpFjI+PY2JiAqVSqXv01+ZoeJ4nZhBsdb23ZwaWFhfheR523mNGsQVsOI8g/AEYSY3ga3u/hm9MfwMAIEPGR8uncLMxh4PGAfq6DjakXSwn+bcNb8tsU3t2MakAuYGfFMc4dfo0bt261TJsqB9wzlEQRYJz5Ng2tT13kSmVsJFozu3IZllFWZKQy+VQXltDs9lENpOBLMsolUp4/fXX8fY77+AHb76J5194AeNtZHfOV+ABi6ZpcG0btm1/6i2Gn6szQBhXIIoiKLLcqj2f+AIXFxbw/gcfoJDP48RTT6HCvKod27djx86diOMYlUoF8wsLWF5cxO3btwEAQ0NDYoEPDQ2Jm699A/MYV0BrFzrqAzLrVed959VqFY1mE0888cTWLwhaFwsAJNn/nc59/Wn3ny/QqzSR7OZI9tzPzs7i448/xujoKJ5//vkWHgcBOo49TkLXdTiOgyCKEMUxnUuPu0j18fOkH0S8Z8ycpn7IWZIkIZ1Ow/d92I4jFrUEYP/+/UiZJj46dQqu6+KFF14Qn5UbQP4pOaGzOeAM3BcQQiARgjAMYSgKtRsdiH28HW3+zh08+eSTyLCBVOlMBpNTUzh06BA8z8PS0hIWFhYwOzODq1evQtM0EVC0BxUtpN44ps4AIXelMMnvC54ZuHX7NvLF4pZbUJObdbvtiNGZ2Pf1Az+LP5/9FuzQggwZBAT/7sq/xz8d+Z+2/Dk6n1Tn+nqnTAEBtcHvvvceymtrePaZZ7Bjxw7anZA4Xs9MhCRBZ2TdIAgo+e4uy4v8eMkW5WTmt5/W7VQqRTvk4hiWbYs2d8M08crLL+P999/HO2+/jaeeegq7du1qeV/eMQfQbKltWS1ciE8Ln283ASN8SBIdLiInSwQMMzdu4OOPP8bk1BSeeeYZxHGMarUqVOno0yWUSiXqOR05Asd1sbS8jMXFRUxPT+Py5cvQdR0TExMYZ1OpxEQ8lnK8m6wAf28efcZRhLlbt2AaBkZHR7u+hm+gnaLT9uFH/LmbQXit94kvgMT7bnZMniE4f/EiLl+8iN179uDJJ5/sysrlbUzARgdBkiSomoaYzYbgKdytdhMkTo5+P+w8+JTBzZwmXk5JpVKo1+tUA8H3KVuZLdht27fDNE28+957eOONN/Cll15COpWiymIJQ8Lfy3Mc0T47wD2CULlxA2it+7P7yPc8vPPuu6jWanjh5ElMTU5itVwGJGm9t5+VcHbs2IEd27cjJgSVahWLi4tYXlzEKR5UFIsYn5jAxMQEikND4q28IEDE2qLvZpx6MqsYhCHmb9/GoSNHen9s9Gc7+HO7rdyCkcfP7P8p/MHlfwu+5X6w8hHOl8/j8eHHt/pRNp5nn5wBSZLQbDTw1jvvwHUcvMyGDfFMxgbrkcgqtNsWTdfheh7CIEBMCCzHuXtngJ87CyR4abWlU6sD+PdDCEEmnUZQq8FJOAMgBIqq4uSLL+LM6dP46NQpOLZNZ7Jw/hnWnU6ZzbD4LMjHn68zQAjCIBBjPltuXkJw4eJFXL58Gfv378exY8douxiPSOOYksF4RJAgD6VME7t37sTunTsREYJKuYzFpSUsLi1hbm4OEkDTghMTKA0NQWIjT++2G4F7ilEc487t29i2fXtL5Nyp53krm3Y//elCffB+OgPs56bvHUX46KOP6CzxY8dwcP/+7tE/vy49au26riMIAgRBQElAknRPqXVxjxAiNoJumgXJxQxQg51Kp9G0LFi2vaGHfHhkBK++8greeecd/OCNN/DiyZMoJGaf8/eXZBme523olBjg7kDCECSKRCBBAHHNLcvC22+/Dd/38crLL6PENnBVUagNYYFE8jWQJMiShOFSCcNDQzh6+DBc18Xi8jKWlpZagoqR0VFMTEzQbIAk3fXcCZ5VjKMIi4uLCKNoQytyJ5nzfm3HZkHET+//Sfzx9T+BFHBbFeN3Lvw+/teXf+Oeg4p+bUelUsFbb70FRVHw2muv9RweRw+8Xqrg/88nICqsLT1mWSPHtjGccN62jEQgEbG9ppfWieBjMfBAIoxjuK4L0zRbrstTTz2FTCaDC5cvw7JtnHjqKcjsPuQ2n2cwG43G3X+OPvG5OgNxGCIKQ+oMJIcHSRKuXL2Ky5cv4ziTe+QQc8AlCUEY0g28/YZLOAgKgJGREYyMjODxo0dhuy6WFhawsLiIK5cvI2Da1ePj41SBbmxsy06BrChAEKBSrcKybUxMTLR6tPewsPrJCiSf96kwgnucf+D7ePe997C6uopnn3/+7kiTbTVNVVEgSXT+vGXblC9wL8ZJoh0WIY/KE4usBbzO2XbNM+m0mD4Y8nsugVw+j9deew3vvPsu3nr7bbz+5S+vZzLYsZSBM3BfESXmVUjSugiUHwR46623AIBuLgmxFllRaHmBEZC7gtkPMxFUxIRgjQUV8/PzmLt5EzEhyOfz2LF9OyYnJ5Hf4qhqhW1iESGYX1hAvlCAmUrdF9vRz6tSago//9jX8Z/OfwOE/Xdh7QLeX/oQL0w8d1fvy9FPZmD+zh189OGHyOZyeD5RZtsSktlHQhn4ISsV2LZ9z8RjHkjwMkG38mK7IwDQFH8qlYLlOLAchyqotgWujx06hHQ6jVOnT0NVVVpe5nywRAbTsay+gsJ7wefqDISMwa9pGp0pzR5fmJ/HhfPncfjQoRZHgENmm0UURd1voC4XLW2a2LNnD3bv2QPbdTE3N4dyuYxatYo7d+7Q6GBkRHANcrlcxy+gk5Ld4tISFFne2hjLzSD11yr4aZQJNmvVtJpNvPPOO/A9D68wQZD7wZbnLNpIllGrVpFmBp1/sv7co1aI2iwhHRd0y6yBNmiaBl3T4DEiYaFQ2PAcwzTxpZMn8b033sC7776L1159FbKitDCQCUv33a+2sUcVcRQhCgJIaC0REELwwfvvI/B9vPb66xtmkvBupbsp1ciSJIKKw0eOYGVlBfPz86hWq7h67RouXroE0zSp3Rgfx+jYWNe2Re748nsijiIsLCxg9+7d92/9divRteHHdvwovnvt+1j1VsVjv3/x9/Hc+DOQpbsPLHplBgghQo10+/btOHHiRN9Bz2bgSqa1Wg0EoPa77Zy2BJa6j+IYMTY6A+2ZxHZkMhnYjgPXdRGHIeQOnLQdO3ciDEN8cvYsCoUCdu3ezd5aEtkjz/M6zm25n/hcnYEoDEFAI0G+QOqNBj786CNMbduGw4cPd3wd/0KCMMSmCboOxCIO3/MwNDSEyfFxZLJZWM0mFpeWsLS0hEsXL+L8+fNIp1KiXjgyMrKekkzUuTmLeGVpCWPj41smIfZCv+2S7fXp+4FeC7pSLuOdd9+Fput47fXXkclk1iPv+wBV0xBEEeqNBrbv2NFaP7wLg8lbuDql+iK2YfdCJpMRRMJ8NksVw9qgmyZOvvAC3nzzTXx06hSee/bZDce1ByTCe0boeYhZrT5ZIjh79ixWVlbw0ksvdRxOxsVgoijqmH5vQRsRL4k4iiBLEqampnDk8GFIkoTVchlLS0tYXFzEzZs3W4KK8fFx5PL5dQ5NwnaoqopqtQrPdTFxH+WH+4Uqqfjre/4qfvfy74vHbtRn8MbtH+DLO16/+wN3IRCSOMbZs2dx/cYNPHbwII4cPQrC0vr3A7wUxNPq+VyuZaMWdfnNvv8EZHbPgBBhO/h+tZl91lkJPPZ9WI6zYVYBx569e1Gr1XDm44+Ry+UwVCqJ7IAERnK/Tw5TN3xuzgAhdFxx8uvwfR/vvvsuHR369NNdvWRFUYBk2ncz8OMkLmYcxwh8HyBEDMDJZLPYl81i3759iMIQq6urWFhcxOLCAm5cvw5JljE6OiqyBry+pSgKwjBEpVrFiU2EdbYCfuP2cwv0S/bbErqk+u7cvo1TH32E4tAQHTbE6vn382ZVVRVBGMJzXRTaF1DyfSSpP89fWp94qSgKXchShxkDXcAnWIZRBNt1uxKTCsUinnn6abz/wQe4nM/jscceox0MjLjouW5f7zdADxAq38ujfFmWMTMzg+npaZx48smu5F0eVYVRtDWHsi2gaGknZMccGxvD2NgYjh07JoKKxcVFXLhwAefOnkUqnRZ2Y3R0VJyLrCgor61B0/X73jrWT1qZEIJnxp7Bn9/6NqpWVTz+by79W7w89RI05e54VJ3sURiGYtjQiRMnxLAhzue5p1IghyRBU1XYlgXDMIRtSp5XkoTZj31Nbvh8lPVWMqDZTAaB78NxHGRYR1InPPHEE2g0m3jvvffw2uuvI2WaIosVxzECz7tnld1e+Nycgcj3haceRxFiQvD+Bx8g8H289OUv90yHJMsEW0LCKXBdF2Dko07vJSsKxli67/ixY2haFhYXF7G4tITzbIFnslnh+VcqFcSE9OwiuBv06wj0S9jZCuK2BU0IFW85d/48dmzfjqeffrolyu7aPXAXUBWFzoaXJGR6kYraMgYy1ic8tiNmbaySLPeVDUhClmWk02k0Gg3KY+hRi5zctg2HDh/GxUuXkM/nKTtaliErCrytCNwM0BGR70NRFOqchSHqjQY++fhj7Nu7F3v37u36OhHVdZlw1xOJOq7Luo86kVoJIUhnMtizZw/27NmDKIqwurqKxcVFLC0uYnZmBpKiYGRkBBPj4xgaGkK5XMbI8PD9lRFHf7YgJgSKrOBnDvwU/tnH/1w8vmAv4Fs3v42v7f3rd/Xe7ZwB13Hwzrvvotls4sWTJ1uHMDEO2P2CqqqwLKvn6PqkTguvzXezBnEc07/z52+xFGqyeRVRFMH1vK6aKZIs4/nnnsP3v/99vPvOO3jllVdEwKsoCpqWhfRmBMt7wOfmDASJBR0Tgk/OnMHq6ipefvllZDYhffDILrxbMpZEZStjQpBOLGjuLcbtG4UkIZvNYv/+/di/fz/CMMTKygoWFxcxPz+PG9evi3LH/Pw8tm3bdt+mTPXlufKxm8xYcScpWctK/s6lLQPWvpds6+NLkpOyeDqVxDE++eQT3JiZEem9dmNzX6ktkgTHtiFvha1N1mWtk0NQgPXuk1jqLDXaD7KZDJrNJp1b7/s9pWwPPfYY6rUaPvzgA7zw4otQFAWKLA8kie8DoiAQ2gLNRgPvvvMOSqUSjh0/3vN1srQ+xCsIgq2LgrHXkTiGJMvQk0FEcqNIrAtFUUTAgCeeQLPZpI4BCyriMEQYx1BkGYuLixgdGbkvZcZ+3VwSx4jjGCdGT+BI8QiuVK9AYv/94eX/hNemXoMhU3J30m74vr/eAcTWVNJ2JDlM9VoN77zzDgiAV195hXbbtJzE/U1/a5oGy3EwVCyK76oX2oMY8f/se4xYsNqpnbEfiECCSZL3ElDTDQMvvvgi3njjDXx46hSOHj4MQgh1BhoNjPWh5Hq3+PwyA4w8qBsGmpaF6ZkZPHHsGEaGhzd9bbeBNv0iZCOHZVmGoetiAfcigiShqiomJyfpgBNCUGs08N3vfAeapuHC+fM4f/48crkcJiYmMDE+juHh4b7H77aDb+6EELHpR3xjY4+FYYimZYkWts3AtdRd14XVI+3kuS78IIDjOPhoehrlchlHjx7Fzh07qBwsez9uZO+30K5t28hkMndFSkwyjCFJdDRyHEPhpJy7gKIoME0TDmMH99S1lyQ8/fTT+O53v4vLly7hyNGjUBQFfhAg9H2o92uA1SMGTrjjAcHVa9dAADz/wgt9CUmpqgo+/+JuWgI95jybbBaCsBl889gkwm0PKs5fuICrV6+i2Wzi7bffhqIoGBsbwwTTQ9m01a4LOOlN2I2EvUg+Ztk2gjBEEAT4m7t+Dr9V/X+JY8R+jD+78l/xY7t+FECr3dgsXd1sNgHQ1sHz588jlUrh6aeegm4YcF1XDGqScX/boQG6ebuOg+z27VSNcItrLUn65RoQEutUuFukmZqp5/sIWQdbN+TyeTx54gQ++vBDTE1MwEynIUnSp6418Pk5A4wwYug6Lpw/j0w6jd09UnxJGIYBmS3oLaf7QCNjAupUiPoR/2MX4ktXSBJtkYwiHDt2DMWhITSbTSwtLuLWrVu4du0aVFXFGOtNHh8f79juEjMPPQpDRCyNGTDW9GYkFb5Z8kWVjPBFTZ11JUhYr52qikKjkET2IJk6I6AZnEvT03A9D8ePH8fw8DA1iB0QRREV3FEUyLIsMj/KXaYBG40GstksIu68beV7bovUojgWyoP30qKTyWTgOg5cx0Gcy/V0LBRVxZEjR/DRqVOoVqu0JkwI7UgYOAN3hSgMqVOnKLAsC7dv38ax48c3nXbKoes6ZMcRs0i2AkKImEOgt89CuIv7SVVV+J6HAjP+AFBeXcXi0hLOnj2LmBDkcjnRoTAyMtJxDURRRP8l7EcQBH2VUUU6X5bx2NBBHBp6DBcrlwHWavitW3+B13a8ioyegcrem5dWkw63KFUmsnMrq6uYm53FUKmEo0eP0jJZh+vOAxxZlqFwu8F+3s06rdfrIOzahUGwNWeA2w0A4DMjeKr+HpwBTdNgmCY814VlWR07kpLYsX07pq9dw1XGgwEA91POKn5uzgCvhVjNJlZWVjZN8SUhy7IgmLmet2lZoR2e7yOOY+rdkjat7Lb0cj9YXFqCpmnIM7GZ7du3Y/v27SCEoFarYXFhAYtLSzjz8ceI4xiFfB4jo6MYGRlBLp8XXns7YraBSVhvM+FpzuTPMAwhyzJ0TevKVk2Cp/tS6fS6MlYHLC0u4vKlS4Ak4eUvfQnZXE7MX+fpRR5l8HON4rh1LjeDymrmfJHzCK0rCEG9VsNO1m4VhiH0fpyBpGEC1lN9zPlUNY3KhLLOgq3CNAwqbBKGcHsQCTmGR0eRy+cxMzODUqlEyUcDFcK7RsDuXUWWcWNmBqlUCpNbYOHzQMK9C2fAZ4qDEpNOJ+x77DWMpxdIHGNxcZGKlMky0qaJ0sGDOHDwIIIgwPLyMpaYvPr09DQURRF2Y7hUgqbr6yXC9mOznxILAmSWwZPYhpt8LIpjZDMZ6LqOrz/xc/jv3vhH4jiVsII/W/iv+OWjf1esoVQq1TNjEUcRZm7cwOzsLHbv2oVjx44J0h3htiNpQwDRUdDeU8BtXtJJUBmBvBvq9TokUMc9DMP+nDV2DdvtMOeXENANvd/scSdkUil4rgvH89DbFaDnsW//fnz44YdYW1vD6NjYpz7k7HNxBgghiMMQEoDLV66gkM9jdGQErm33rUCl6zocz4O3BWeAgJYIeHlBZ3XHdkKIYKcnb6IeN9Ti4iLGxsfpgBp2w/NFWCgUkM1msWvPHji2jeXlZayWy5i7dQvT169DU1WUSiUMDw9jeGQE6VQKMpveBy592UdmgKfd7heWl5bw/gcfIJVK4fnnnkN+E0+WzxIPggAhW+Qxi1IIgLCDk6Awp05lymHJKNtxXQRhiEKhAIk5PO3M4Jb332SRhmGIGCxNDOZc8drmFpwCQgh0w0DI5Il7OQNRFCEMAuzdswcfffQRVldWMD4x0Xe76AAbwXlCtUYDy0tLOHzkCN1ENkm9AnT9G7ouygT91JPFawmBxzKKhqZ15fJs6GzpYTfKa2vwfR9jY2Mirc+haRptZx4dxcFDh1CtVLCysoJyuYzzbFpmLpvFcKmE0sgISkNDYh0prFW737ta9LMDOFg8gFemXsGb82+Kv3/z+h/jb+z7cSjY3BmPowgfnTqF27dvC+XYfhRMfd9HGEVUQyKOaV9/4l/SSZBAo3SVBRXtzkGtVhOTA4MgQNitP59nRLGR68HBWx7VhON0N0RpiXGfOPHdZ/MTusH3fRSLRQwPD+P69esYGRl5OJ0Bvhmvrq5ibW0NJ198kab9g2DTRc2/Al3XoQB9pfuSJDrP80QXgdSDQQr08PgTC9zzPKyVy3jqmWfoTRJFYtZBwMoHSWXFsfFxjE9MQJFlNJtNlFdXsbyygkuXLkGSpPXhSuPjNNNANu9l7VcHvF/Mzs7izJkzGB4ZwZHDh/ubC8A8dyJJUJPny84/jiLhJIhSSBwj8n1RduAZH1VRUKlUQAihQkZsEhnanDOS/NkDcRTR7gFAGA7C05nMadvK4k6ZJmzb7lou4eD3wejoKEaGh3Hjxg2MjY0NMgP3AG6cr129ikKhgJ07dsD1PDg9ergFWN2Xp5+dPjI7/L6IGYGupUTQA8kyXbc7a3FpCbquY7hUgmXb8BmpOmDOTdL4pzMZ7MpksGfvXpA4xtraGsrlMtU1mJuDrmkYY3ZjbHwceo+sQcvnE6e5bj3+zpFfwlvzbyNmMnBe7OHfX/7f8Uu7f7Hnsbga6draGh4/ehQTExN9Zd/4PJL2EgjnS/G5LyGP0nkWIQwBZv+TjkGtVkOxUIDKBhe17ClJB6CNJN4JIQtaeYlAlmXBxeAdBv2CTyGMfB+e53V1BiLmHBFC8PiRI3jjhz/EwsICiu3Ey/uMz8UZCMMQhBBhHCcnJmA7Dhz2r+eiZpGyoetda1Ac/GtKfmG85mdssV+zm2OwtLiImG1almWJiDZpMOREC2PSGOXzeUxNTQGgZL3FpSUsLy3hxvXruHz5MmUij41hlPUwd9PnFy2A95gZIITg4oULuHL1Kvbs2YO9e/e2Zkd6v5ieA9ocJxaBy7LccrPxBR2xRc0dBd/34YM6ivx6uWwDCMIQGqtVbsUvFws6UYNMLmTOGen3mIZhrHv4XboKwoRBT6dSePzxx/HDt97C/MLCXacZB6CBRKVcxtraGr700ktIpVIIfJ8y3HtFW4lrbhgGXGaQuzkDYrNgrwuCQGTg+MaSnGrXC8nVk/zmFxcWMDY+Dt/30Wg26abXdm/waa58o+P8qKGhIezbtw+EEFQqFSyxDoVTp0+DECqTPM5ao4eKxY7clmQ2LWnftme34b/Z9SP4rze/JR7789lv4UfHv9r1MybVSF88eRK6YfSfdWl7fw4+d6IdnCMRhiHNJsQxwigSMtO1eh3b2eCpmBAEQUDnAtxFij+MIppR5I5KgpfFj9ePU8D/bhoGPHbvdSvRegkHJzcygqmJCczOzmLfvn1bOvet4nPLDDQbDTSbTUGcSTFyRRCGfS1qndX++AbSbpCThBaOiN0wSRlTCWxK1BbOX2LposD3cXt+HmlWmxLENEKnoWl88++DeGKYJnbt2oVdu3YhZp7//Pw8FhcXMXvzpsgaTDA1xEJCB12oD94DKzeOIpw6dQq3bt/Gsccfx/4DB9Co17su1A4XRVybfhYc95LF2F9CqGPAFnmtXkc2l4PPSkGchZvN5cTsgn4hUn2J76H9PEWEJMtCqbDTOfPvWGcT0jzP6+gM8Jq0rmlQZBnFQgFDpRIWFxdb0sED9A8eKS4tLaFQKGBsdJSmX1MpWGzmu8aU/ja8NvE7lz/vxBtIOohJBMkSQYJjtGW3jjnBzWYTa5UKJiYn4TPbQQgVU9J1XTjCm3W+SNL6xNbDR47Ac13MLy5iaWEB09PTuHjxInRdF4JHyaCivZ0uiV849PP4zq3vwY9p9itChP8480c4iI3y8O1qpLquw7LtvstvW92geSmErzveURVGEZrNJkLfF4qhlmUJJ44HkP0iZo4GCBFOmGinTDhRpMPv3T6jaZqoNxotzmUSIoggBBnDgEQI9uzdi4V336VTNz9FfG6ZgbW1NciKgmHWSihJEh3qsMmi5pDZZuIFQYtB7raYAUoAIqAksqTXKvfp4YfMAeDlDACoVqsYYvW6bDYLzXWh6jqymUz/G2n7Z5NlDA8Po1gs4ujRo2haFpYWF7G4uIirV6/i4sWLQgd9fGJCaBrcLUPe9zy89957qFYqeP6557Bt+3YAWyw/3GO0y1OFqqaBxDGqlQq2bdsGTdOog+j7cD2PciNADTqPmDb73Bu8e3S/VmISZieuRlt0yZ2U9jyWHwRiDgI3vDEhGC6VcP36dfh3QV4bAIIMtra21qLjb5gmXNdFFMfwPK9zy2Di+zRZ1NqeVexWdiKg44pBSEtLXb93PC8Z+iyDEROC1ZUVAECxWKTnw6LYVCq1HqjcxXo2TBO7du7Ezh07EMexEDxaXFrCrVu3AAClUgnjTAkxSUpOYjQ1ih/f+zX80fQ3xGNvLb+NElpbvzupkfL7u1+7ca/lTVmWoes6dEKwsrKCII4xOjIiyJJxFMFmZRiZTafVVXVTx4CT3NU2PpMsSR1Lt4SQjsFE0mnUWDkkCsP1keiJ17tM3dLQNPGeqXQahmFgZXn57i5Qn/jcCITltTWMlEotvcGGYcBxXcRxDMuykMlkejJ1NV2H7LpwPQ+5XG7TGrKo+bVnHXosOkII/CCgc7Lb9LNJHMNuNnH40CEU8vl1D5V5diJ9JEmQEufV7yLnz0unUti9ezd2796NKI6x1qaDDkZUnJyYwLZt25DfxJFKwmo28fY77yDwfbz88ssYSug88PPdSl/+3RiwZEujJElosgmBY+PjSKVSouvDY0InBHTD9dmwGk3Xu3r9vMbIywTiPLGJJ59QHePnGJP1zhPTMFAHvaeSHj7vcSa8lMWzN4RgqFRCdO0a5ufnses+ylY/KuDdOb7vUxEfBgk04rJsG47jdB5HnvieeVYxYNPtNmOJh6ydkWezxPsyp7Hr65hz4ntey+YhAWhaFkzTxMT4uGD1O66LMAxbI/e2KHQrkCWJEpOHh3H06FE4rkvtxsICrrGgQtd1jIyMYMeOHRgbG2uxjT934GfxX2e/BTtc72//SD6F/xN+BoR0VyO923HqWybmJbO/7L3Kq6vIZbOi1MyvNT+TOIrgRRE80BZoQ9OgMVJpO6IOGUV+zK6nxO6Tls/SFliYug6bccuSzoDruiKIaM82loaGsLK6ik8Tn1tmoFqt4uiRI61/kCRkMpn/P3t/GiNJmp4Hgs9nt/ntcZ8Zkfd9VFVWZl1dR1MckZTIUZMaAdrmSuCuVsQIoLAgJUor/SAoQT1CEwKlWY0IAQSWOxIlcJbTHHUPm1J3s7uK3V135X1E3kdkZpwe4bfdZvvjO8Lc3dzDIyurK6sq3kIhMyPc3Q637/3e43mfB/VaDa7nQbLtVramtgdF1zRI2ABq9XqQArZRE/a+lsOiM9DgWYbTtpBVRRHiE8vLywAhQoWOj83xcmZLxE2IYLASQUFb4NLPiJLM9BGGh4dx5MgRNBoN3L13D6urq7jOZJ/NVAqjIyOiLNgNkFkpl3Hp0iVomobXX3+9hfa3pVLSz6Lmr++1mKMIEVsYHWhnssGNUCqVELFMGqCLkUtVcwVDz/PgsyzLdV24rguFfTfxagEP4JJmlokkifGwdmsv/7WbqqpQGNiLU4yGYYimZQk+A03XN0aWwhBpFuHfv38fL778cvf7tG2JFkURFhcXIRGCgTZyMs0wRPbdaDREOynJOIaHB/lCKK2LuQktAmEJFSTX8yhhVyx5kAiBqmmifXixVqO8ASyIFLoJsffEfQe/fvE7QKyl9nMSAWzbdZiGgdmZGczOzCAIQywvLeHhw4cora3h/ffeA2HBA28p5HI5/A97fgn/37n/VXzGA/IAnu/h/LlzXdlIt5L0RF0y6NjFbARc/M/2a479fXV1VVSbATbfr2l0dNM0KesqT9iCABajCFY1jWbjsWcmPoEUt75ontuSibgZhoFmG9cFlzfnGCOJyVvz6y0ODODRw4eo1Wp9jY8/jn0qwcCjR48QhWEHjz/P3tLpNOqNhmCqMmJONW5arNzn+35P8iG+oPkUQTfzPA8O21xEZkwIDCZ6Ea9klEol6LreAkLiCFYvQfceQMdDHB9jjJflORXwZo9dOp3G5OQkJiYmkE6lsL6+LuhO7969C0mSMBSTZI6Pbp49exYDAwN48cUXoSZgLhLPuYuJ0KE9uo9F7eLf6B1dl0olZHO5lvsns9JaGATQdJ0uUNOk7GmOIxa47/u076rr0FSVZnXoXNAADcb6sW4LW9N1+LFyX7PZpJkB6Cx2C3CMvXdwcBDz9+/3ddxta7UoirC8tISBtooiQJ+nVCq1wchZryObzVKSqYTP0nUdTdumLJebTBS4TNCsfY3QA9NvOYwiuI4D23FaRwQVBbphQIsFqAFrdRyIqbLGRZSSesn0UG3BLDt+PAMl7FykWNUiaf3KkoSBgQEYpon9iiLokJeWlzE3N4fLly/DNE3sHt6JolrAulcGAGSQxqWLF1EuV/Dss89ilsntthi//j6TiHgFpIXIiF9z7GeiZ59gjuuiUq1i9549G9fJ9gTf9wHuF3QdURjS6iJL9lxWwVEVBaquQyZETCAl7SubgUfjlMbtI4E86+f4KD7lFoYhDObbBKiZnUOxWEQE4PatWzjOSIietH0qwcD8/Dx0TetUowMDlmkazDCEZVloNpuQJAlqgjNXGTiLEIIGl5btYq7nodtYEG8FWJbVooSoKAoNApIyAgBra2sYHBxs+Z2iKCI42YolLfSIEJFBB2yTYS/eeA0gZuVlJq40MjICAGg0GlSSmaunXbyIVColgqHhoSE61pkw0iP0Gdoyn6j1hQDQqeUQDwAeo21QKpVaonuAjfawWeT4N6gqClRFobPKjDM9jKgQlW3bcBynqxgVZ2TcLCTgOgftZUxD1+mIoW2jqapilCvN6EPj9y5k5cPh4WFcuXKFcpRvkSzri24+UxLdu2NH4u8JIcik06jVaghYq7EbYlvXdcgAmpsIR4kRv7YWAbfQ98VYoMiI2efrup5YnaiWy/B9X1S+gOSqYr/WkpWzzZ+fS7Txi85zj224ZiolxJXiWIOl5WX8Zeen8a70PiRZwhHnCGqVaqfYUOw4YrqJ/TuiJ9lRCeXnwN8XxX0N2bqGyPraGkgUtfgOzl/CeQsEEFCSqKqhpsFnFSXf92lywUbCA7Y5J/l+iRD0NSDM28TY2NhlWYbG8G51pr8Ssr0pDmwHmN8A9TW5bBY3P2/BwPr6OqaKxURNeO5wDcNAFIawHQfNeh3pTKbFoUegD5KZSsHxPDQbja7BQISN8lt7UOE6DpqWJWbRCWjkxiO0bhZGEUqlEg4cONDyc/75olf9mKC+9kXT8il8gwFaIul4xSMCzZR2MSU3jsK+cvky1tbXEYYhlpaX8eO338b42BjGxscpRkMcgi5cifRgZGTXJqGNuesxrxmg0X21WsXeva2oZV7m70axKskyDFmGruuiuuOx0pvrebSKZBidGWWf4FH+GkKIICjhJCKWbUNlI6PpVEo48jAMwY/Gn4WBYhFRRIFOMzMzW7w7X2yrVCoIg6ArARYHcGUyGdTqdfi+j0a9jlQb9igEU5JTFHiOQyWpu+gUeKyypLYBVSPWEnJilQBZkmAYBqU87rEG1tbXQSQJxWKx5eebVRX7srZNX5akRLKaCBtYnXZiMyJJGB4ZwfDwMI4Rglq9jpN3TuLGjRuwAwdu6OOjM2cwNj6OcTa+yFuiBGjJ9kVQ0oXUJx6Mf1wg4erqKjRd7xCJ4xLzQUL1OD7VFDIiMZeBxDlmgLeFW3x5n1VF7i/akwnDMGA7DmrVKnKspWUwrEj8++ABmyRJKBSLtDX9CdmnBiCU+oj8DNMUPNt1JkmpKIoIBAAIWVnLsjbKY20WMBQyIUSM+Xmeh2azubG5SBJMVaVOoo/NrFqp0Oi+PYNlm1bIZmEfV9yiBRjTLTMHOjaybkQaURji7p07+EH9LZzRzsHwDfztib+FyI5w4eJFnL9wARkmyTw2Oop8odACnotbO1I2jGXBSRn0VmyN4QXae8I8wwqCoCdzHB/70zQNdUD0bT3fh1+vQ2e/21LmhY373s67ELJMznEcDA0ObmQeLBPi7+HBgCRJPUFn29bdRGaVlERg47mUeKuRYY8iJngFbGyChLUfPc+jAUOXYECMpcZGYC1WdeLrkj9TvRjl4rZWKqGYz3c8g+pjVhXjJvwG0PKcdVT0eFCLLr16/n4AzUYDd+7cQSabheN5OHbsGNVfWVjAndu3IfNWJBt7DvnzjlbfEa9aiKQj/ufHSCIAWlEcGBzs2Fe4T26vKrabJMtimsN1XfigyVDTtiG7LgxdF0FaB0iwi8WTpHi7UVFVuLaNgF2z2eX5421HwqY+Pkn71IKBnojMaIPON51KoV6rwWMzpIZp0tFAdhM1VorzmHJfUnUgHt0Hvo+mZbUoHhqGQb+M2ALZzEprayCSlMgKpSoKwijqiyJVXC/QsnjDKKKbCfu/2yPXz/ifbVl4++23sdBYwIfkDMIoRJVU8UP7h/jaK/+CSjIvL2ORAYpu3boFWZZRLBYxPDKCmenpFnGlpPn8eIWC/5y0/a6fKkmpVIJhmh0ldB7IcYIRdZOFEUWU+9wwDOiaJkhJbBb5a7ouqGk3s6gtIOOf32w2hcPjeguxE25to8Sug79/27Zmm9Gxxp2zoig0IKjXxcRHvEUGAOlUCs1Go2ergPd0ZUmCbduwbFv4CFmWkWK0t1uhil0tlVqmIbgpj1NVbNv4W4DUSYEAey39ddTy7yTjbKRjo6PYt28fvvvnf47BwUFKgHPsGGr1uphsunjxIi5cuIBUKoWBwUFMTUxgdHS0pQ3ZEZzEfVssaI6/vp/7EAQB1tbXcTCGw+Ams6pOP8JN/LN4QqGxEeIgDNGwLChM7ZJznWy6jtvWPqdXdh1H+JWOqkPMuO+Q21oNn4R9asFAfLOIWzzCB2hElMnlUGfyj41aDXoqJTZvAJu2CnxOC8xGibjpug7TMMTDupUbvb62hkIulwgu4UjlrhF+fEFEMZWsWCbZAm7r0m8Tn4HuG22lXMbb77wDAJg4Mglc2Pjdg+ZDcb7jExMYn5gAogjVahUPHjzA4vIy5q5cwdUrV5DLZkXkPzgw0JqZJ1Uj4ucbO/94gJB0zqVSCQMDA4nPhiLL8FmEv1kZlWuQA/R7NgiVvLZtG0FE53ldFu1zLvdu1h4g8tHXIIogMfKTjmuJB0yxFsO2Pb7x/mm/GaSqaUhnMmg0GvBcF7UgQDqdFtVBwzRFq8C27Q5+Ak6F63seGgwcCtCSrWmarYygCQFjktm2jXqjgUNsAiluvL/td6kqticNHUBddKnidTmvlt5+u0URLjN55Z07d+L48eOoVKutryEE2WwW2WxWSDKvLC9jfn4eK8vLeDA/LySZecWxRbG13afxIKXtZ+17RZLvKJfLCIIAQ20VRaD/qiI3oV2j6wIz5jDadD8IUG80oClKV0bYjVPvDBZc14Vl20I9Vmpr47R/X2HsmePX/knZTzwYiGeJ3Zxj0k3MsL6fbdtwLAtBEFCgliRt2ipoWhbq9TrSqRQUSYKqqkiZZgczYBx4s5mtlEoYZUC9douPCbU8uNHmOgNbNn4/Ex7wpcVFvP/++8hkMnjxpZdwsXxx888jBLl8Hjt1HROTk5BYz3BxYQH3790TksyjIyMYZZLMmy0KAGKEKF4WJG19xSAIsLa2hkOHDyd+xlYifK5uF4+6VUZSxEe/wihC07bptIhh9FWG8zyPjg+y+17I5bDCxFBarjdW/YovaP737crA45nUg32SI+njv1cVBelMBs1GA77vo1arIZ1O09nyWKugVq93BAMeCwKEwikhSLEgoAPw22frp7S2BkRRC3gwboosi4kIuS2jFr7kCT877b4jDAJ8dOYMHszP48jRo9i7Z09fARhPKsx0GvvYOS4vLWFpaQnnz53DOaAjqeg8meTj9AzWQZMIWZKQT6jU8qpiEEWbVhWjMKSV5GiDYEqSJJgMC8JHRl3OlBsD/bVb3NdHEQU1c64bVVWRyWRgWZbAJiSeT9y/f8LJxKfXJuB95j6Ns3PJioJmvQ7PdVEPAqQzma6tgjCKUKvV0Gg0wCcJ0ul0z6yyn0VtOw7q9ToOJZSkgNYe1WYjj0nWrX+X5AS6leDv3LmDc+fOYWxsDM8//3xP1a5EY5uWquuYzOcxOTkJRBHK5bKYUDhz5gwAIJvNYowFBgMDA31lwEmB19raGoIgwPDQUGLlSJFlECQEWR2XRRnfQqCjj0sIoT1eHu2zEmC9Xt8gOGp9g7hPjuPAsm0AtG/NsxyOBuZtofazEnrokkSlk7EdDDyOhbEedzdrB7xGoPc9wwICl2EEdNOEaZpdWwWe76O0vg7XdWllibUSe2FV2gORJFsrlWCyYyeZoiiw2VRMe/m4r5ZW+797PGdJvoOzka6XyzgVYyPt1zgoEQDy+TwKhQL27d/fIsnMkwpZljE8PCyqBoZp9hdUtfuOiAJyiwMDXfFeiizD9zwEm1QVPUZkJstyBzZFZomnFgSwbRt+EAiiqMRkIlataTQaYqKB4xI8zxP7RPzaRHuRvR7YCII/d5UBXgrb7HX84uNlWk1VIbO2gR8EqNVqSKVSHa0Cj80ac9KgdCrVwuff1fqIvNdKJSCKMBCPbFmWG8b6iT6LMrcaDCS1BCSyMfcat45KQxTh0uXLuHH9Onbt2oVjx44JB9Z+7WGPeDuRRYwQFIpFFIpFHDhwAK7jYGlpCY8ePcLt27dxbW4OqqZhhCGRR0ZGoHcBxiTZ8tISdF1HLp/fYAjERpYtSRKILANs7KcbqQwPFiQkzwjze8EBQc1mEy5Dh6u+D0PXN8pyDBlt27YYT1VVlW4M7N7Isoworo7W9gzxZ11WFERMNfOTBgN9Ho1XVnpW12L3nn939McE6UyGMpZaFmw2QdTeKtAZXwRnHJUlCcVCoa8x0H4Ea0pray1+QwDtsIE9kUCDkceyLbQJ2ttX9Xod77z9NlzGRjrQpXrR8/AxjoGWCo2qYnJysiWpeLS4iMWFBZxlSUW+UBB+Y6C9FdnDgiDA8vIyxQuw3no7/otXFTfbd7w2wGiSKbKMTDpNJ90sS4CT48kE37tEa5KdS5qB4PkxIlatAFggFxshF35DpuLRQRAkc108IfuJBwMSY9BbXl6mJZuk+W/ENq6EjVGWZWSzWTSaTQQs0uevaTablM6WlYnDKEI2nd6Y/d7ERNbW47XlcpniDUxzAxATi4gBWp70fJ8qZvVRRo9bL2xAx89jzo6LDT148CCxvNc+v9FP1tBrskLTdUxPT2NyagpRRIlUlljV4N69ewAgxJVGR0fpKFWPz1tYWMBoTPZU4CGAlo03IASh7wPdggHW8+sFzOEmSxIy6TQaTJLYYyNFqVQKsiyLlgKXLeXlwrgpskzfl8DCGJewlmUZpVIJiqpifHy853ltW6cNDg7C9X2slUqYmpzs+VqRRLR9/6ZhQJZlNBmw0PM8Cs4iBJVqFYbjwA9DRGwmPWWa/a/fTRIJvkYOHjzY4jfi7xDsmazStNURw6SKWrdpgTj4eK1UwjvvvANN1/Ha66+3kJNt9fgA0HMbZ0lFvljEgf374bgubScsLuLOnTuYm5uDqqpUe4X93yupWF1dRRCGGGO8BwJ/FQsMeFLQsySf0CLoZRxvVGdiSE3LgsaqBEEYwrZtIXAlEYJUbOwY2BhD55t++z0LYsEAAJTX1/Hc/v2bntfj2qfSJpiensY7t2+jvL7ewULIjSMvuy0tSZKQzWQouYxlgYCWuBqWRZHEmQwMNu/rb2XEjxAQWe46VRBFEaq1GjKZTM/NVFVVwLbhsWzy44LHur6bnYPnefjwww9RLpdx+vRpTCQ4y/Zz6CUE3A/SWPyeXR/nQT906BAlPGICKTdu3sTVq1eh6/qG5vrICKXrZdZsNlGtVrE/6WGPlQUlSQJkuavyH4/GQ6BvR0oIFclSFIVyTkRUBhWsihWConlNFiC0G68GcMBo3CELsRPWPlhZWcHU1FSymM629TRVVVEYGuqp3sZxA1EUIWKUru3Gq4tNy6KBoyTR569ex+TEBK0amabIbvtVukvCLMStaVlCeXMz38Gld7cSDHSb0uoaDLA/Hy0s4KOPPsJAsZjIRroVC2PJyabGXqtrGqanpzEdF1diwcGDBw8A0KSCs6i2JxWLi4swDQOZBBI7HhhIkkQrDWGIIAgS1zHXOpEZI2M/Fq8SuAxk2GT7Eecw4QRU7feEVyuiKNqodMYrirxKIcuULdO2sfMT1DT5VIKBiYkJ2J6HlZWVrsEAokiwtvUywzCgahrqtRpCFtmtra9jcHAQpmnCXl8XyM1+LamfzR+qEBShP5CABo6bLMuQCUFECHzP29ICS3QTvPLQvqFHdMTt4oUL8H2/Z3lvKwFJv+OA3ZyabhiYmZ3FzOwswiAQNMkLi4uYv38fhFDpVb7A19bWAECwJ3YzmeEGwnjWF19ATJmS88/3a4S9PpNOo1KpoNlsIowiKIqCfC7XcwyRH4eXGOOvao/uS2treP3ZZ/s+r23bMFmWMTExgYW7d3uP7fbRV5VlGdlMhpLMMHIqy3FQq9UwNTEh+CmSKpddjbV/2tcEz/7L5TIACqLrZRzP8nH4BlqMbYJtJ4UoinD//n3cunUL09PTeO7ZZ7ck8Zto/Dj9bKYJ3xORJAwMDmKAJRWObQt69Zu3bmFubo5KMo+NiaRicWmppaKYZHGOjzCKICdUcbxYRbFf40B4k/HTrK+vi0mmdCqFTCbTtVUpsYpFGATwXBdKDEcSxFpcsixj5dEjKKr6+QsGNE1DrljECpPxTDLu0PtC37MHMJ/PU9KOKEKlVoPDFeVk+bEf8pa5f9aHqtXrfanOqaqKgIHZthRtJ11zF8Dl2toazpw9Cz1BbKjjI9rbBFvFDCR+aHJpNA52kWQZg0NDGBwawuEjR9BsNrHMZpOvXbuGK1eugJMFrayuYmR4uGvPLs7uFz8HHiB4LBjolwBGfASoM7BsG4RJovq+D43RDPcy3o4QJUh2TyJW6gVodF9lfBmf5IL+PJssy5icnMSNK1ewtr6OkYREIgI2nsk+fEfg+4K1LgIFB1frdaoeh60lEQDoJhhrDcXPoF6vi3JxL1MUhbYJGICsX3xJt6tN0uAIggDXrl3Do0ePsH/fPhw+fPiJoNX79hsJ7V/+87h1SyoWWVJB3xKhWCigUi5TvFGXY8uyDInTS3Njz0rIeEgibDEAZMe32KQAr+pofQL+OPDdCwIYsbYN9yUcjL6ysoLxyclPlML8UwkGZFnG+Pg4Hs7PJz7s4vb1AebjoiQAkMlmIUkS1isV1Gs1QWecSaf7mi+NGyGkpRTNHzA+atSPcpSqqrBdd8tgoKS+H9BZ7nvw4AE++PBD5HM5nDp1qmcgQN/fXzAQxz9sWk3o8v30WgipVAqzO3didudOBIxv/h3GhfDeu++CSBIGBwcxxsWVstkNzACXCuZCTm34gq30/Lj5vk8JZWIqYtlsFgSAxQiqoihCiqGd201m5T2fl/ticsb8XsiyjJXlZei6jh1duPW3rbdJ7LnwowhLi4vJwUAsaN/MGo2GQHRPjo9jeWUFVSaQJkTSHqOd0y2BqdVqyHShUo4bIZQiN2S0uP1iFrpxkXQAWj0P7733HpZXVnDw4MFEop7Htb4ril1+zv1G0vvbkwqr2cSFixfx8MEDPHr0CPPz8zAMQ4wuticVnDJZBAP8GITAZYq28haY/kImduSwyYIoDKEbBnK5HMUL+D6azSYM0+yanCiKAuI4Lb4CMVAhZ9wtlUp4+bXX+jqvx7VPJRhQFAWTk5O4c+0aSqVSR6ug3/EJl00P8M/MZDLQFAWO6wptaK5Otb6+Dt0wKOijV+TH+41A4kNZq9UAoO9ggACCRKSfqYJe7IwiGIgiXL9+HZcvX8bY+Dj279vXdda15f0dLYYuDjOGF9g0gOrCOd6vCe6AMMTrr7wCRVEE1uDq1au4dOkSUqmUKAsODQ/TRR0ECIOg5bt0GWiUswFGPdpMfPzQZYAxRJQDwtR1ClaKObVms0l57pm4UHvWw8liojCk/OespSAWNPvel5aWMLtr1+Pzzm8bFEXB4PAwFhYXceTo0VYymtjfN8vK6ky7AABS6TQ0VUXWthFh4zniztxjrHNaF9GaluOHYdeKZq1a7SmmFjdVUajc7haCga5XGzsXzkbaaDRw/PjxDjr1j2v9BgO9vp9+vYmZSsHzPAwND+OlF19EqVQSWIN7d+92JBUchMirPvFz5rwkuqZtmoSGYdiibBsEAUCImBSIIjoGzzFjlmUBUbJInqqqLdo5nE8iXlGs1etwPe8Tryh+apWBoaEhGKkUrs7NYWh4uIOrGtjoxyQ9NI7rwmo2AdAbyrnHdcOAzqRrgzCEmUpRIg/QEqBj25RZyjASGb7EJoBkkZ56rQZZlrtySbebwqiJPc/rb8Sw1yKSJIS+j3PnzuHe3bs4cOAAJqem+sJWAEmVgWQTpb7NPrBbJoKt4ROWlpZgGAayuRwIIdi1ezd27d6NIAiwurIi6E7v3L4NSZJQHBhAvlDAxPg4igwfEUWRcOKGpglQI5EkhEGwUUGIIiFdyqsLURSJ6ZD2543T2jaYjkWz0UAqne4ICBRZFlwDmqa1jAzJioL1chlLq6v4Sz/7s33fl23rNFmWsW/fPlw9cwZLi4sCQQ60JRE8w2x7fxRFqDcaogybiQmgZTMZNC0LlmUhnU4jBMQYdL3RgGTbMA0jEQwm2BF7WLVWw85uGKk24wDkzTg1+jJCGUDLMTbSl19+uSeB0+NanKXxsa0L8LPdAt/H6soKDh0+DEmWqbjSyAiOHj2KZqOBpaUlLCwuiqTCNE0UBgYwUCxiR8z/+54nvj9VVYXvaN93gjCEw4CCAPWTsiQJ8rs4qRjHERDQpNWybeFn4qYoCh0bj1WP4yBMWZZx9epVZLPZz28wQAjBkWPHcPvKFSwvLQmu7g46TXRuWr7vi0BA07SOPko2l4PNtK2Hh4epfkAYwmKRGiebUZk6oaqqiVlk0gNRq9X6qgpwa4nw+wkgeiwC3/PwzjvvYGVlBc8+9xxmZmZQZRShT3JJiwd6swXdBcewVVtYWMDY6Ggn2laWKcvh2BiOHjuGRr2ORcZrcOvmTVy/fh3pVApjo6MYHBoSm3Q88+btoYhH84x3go+P6ox/nGdzSfgArkbYaDYRhCEsViGIn68sywDDKwD0OeafpcgyLl66hGKhgOPHj3/s+/VFNlmWMTU1hUd37uDypUsUOIbkwFZK+HmTBQKEULnjeGWJJxK2baNpWRgaHESGTyyxUm6DERQZjMqcW/zJTZrtdx0HjuP07TtkWRbJyOOMGLbb0tIS3nvvPcFGKssyGo3GEw8G+OrZ7FN7VW26fZ/ttry8jCAIMJag85BKp7Fz1y7sZIqtq6urWFxYwMLiIh7Mz+PihQuU02BsDLlsFrquQ9V14c94YkgkCZ7vw3Ec2u6N6MiqrCgwdR0qK+PHR4jFdbApJUIIrVY7DsUjxb5LscfEvgcOglZkGeVyGQ8ePMAv/LW/9olXFD+VYID3bqamplBeWMClixcxkvCFAhBRLb/NnBceSA4EANAxMbaRNRoNyqUvy8iyioHF5j9dx4Fr21CYWqHKuKI3Dt25qKvVKnK5XN/XqmoajfD75MXutgiazSbefucd1Ot1vPzyyxhmqPu+RwDRWRkIN2kTbAVj8bjWqNdRr9cpgKmHEUKQyWaxJ5vF9I4dqFWrKFcqWF9fx6OFBdy+c0cgkSdYzzCVSlFJWMboFoFlcJIEXdNohhc/Ro/jy2yEqN5owGcqhS3BHdkgSAI2xLFkScLK6iqWl5fxMz/zM9tkQx/TRCJx9Cg+eucdzM/PY8f0dOLm0h7MO6yPC6AjEOCWzeVQq9dRazYxNDgoHLppGLBZ+zEIAjSbTVjNJjQmhNUOOmtvFdRqNUTor73ITVNVWAwU289G0M133LlzB2fOnMFojI2Ul8WfbCiwURnY1Hf02QruZUtLS0in05tipWRZFnwFO6tVVNn/qysruHzxIkJQ/onRsTGMj41haGgIMgsC3BjmK4wiqIoCnY0hcxNV7S7XxP2E47qwLQsKayvGLf5ej+EXFEXBR2fOIJvN4tmfwATSpxIM8PJHFEU4fPgwfvTDH+LB/Dwmp6eTX4+NB73RbIIzdXVDVnK2sfVKpYNmVFEUZDMZSiVpWdRBeB483xdZJZcjJYS0LOoooiI+8dLkZiZLktAU91gJuee9SSi9VyoVvP322yCShNdfew3ZeDASa2tsZhJpX6DJD2+/bYKPv5zpjDAhpPuIaYLxscHBwUHMzs7C930sLS6iVCqhvL6OCxcu4PyFC0in0xgYGMDA4CDy+TzUmERpN2fUK2PhHOVNy4LjulSkiLGIARClaYBpI0QRZE3D5cuXMTA4iD379vV/Y7Yt0XirrTg4iImJCVy5fBmTExOCE6Cb8SQAoL3mbrgh0zRFstK0rI3Nm1DGSkPTYDNa6oABTx3bhiTLQsqYK9qhLRggwJbIfFRVhc0z0n6s7dmNogiXr1zB9WvXsGv3bhw9ckRs0ltJIrZi/bYJehG79VUZiCIsLC5ifJORwnaTZRmpdBoDg4PYt38/atUqlpaXsb62hgUmySzJMgaKRQwMDmJwYAC6YUBTVWiMZKjbSGTUg91Q13UEbGKh0WwKrZ3259Bn0w6EEKytr2N5aQmnX3gBJmuDf5L2qQQDAKPr9X0Ui0WMT0zg8pUrGB8fTx4BZE6WizoQQpDa5OaYqRQUBiasNxrIxhZhFIaCec40DFE+DoJAqFNJbNRN0zSKYCeEloo8b0vRPUAj/CAIhLBFL2uXy11cWsL7772HbDaLl156SQBOxOvFLXqCmIGfYHQ/Pz+P4ZGRnvSf7SbLMp0XZv1Uz3WRTqdFadC2bayvrWG1VMIiY0NUWE9xbHQUo2NjVFegvSXQxz1UVRU6e054lM83KC45HTC6ZABYWVrCermM1159tSsf/bb1b6LPGwQ4fPgwvve97+HOnTvYtXt354tZVTFoqybqPdYgIVSMqNFsisQjvrFHgCCR4dgTl7FWNlmCISsKdE2DoqoCW1Kt1WgQsoXKkBhZjVNd97D4FFIQhvjoww/x4MEDHDt2DLt37+4QzgGefGWAr6i+RpI/hpVKJTSbTUxMTGzpfZIkiTHkKAwRhCEKhQJGR0exLwhQq9exurqKUqmE69euIYwiZDIZjLN25cDAQEdAwEHdvYwQSlpWr9cRspZ1yjRbfBCfTgDoc37lyhUUikVMT09vfcT1MexTCwZ0phPtxhb1rdu3sXfv3s4XEyLK+gAdTdt0UUURDNNEGIaoVKs0GOBZd1uvN2WaSJkmfN8XKNEwCGA7DmzHERWDSqUCRFEi01Uv0zRNzKFGptl7k409VLdv38b58+cxPj6OkydPCqRqYvbaz+Jqe0m3LLhvyd3N+n6bAJ8a9TpKa2s4efJk7+O0Gc/cIlB0dKVahed5gh5almWMjY2JRVStVinKeGkJZ8+eBQDk8vkOcaV+p1jao/xsJkOvl50TBxhJkoSrV69idGQEg0ND26yDT8BUVaVALd9HKp3GzMwMrly9iqmpqRZGS24EQJ0JlfWqJsbNYGXgMAxpIsE4CNpNU1XBQ8FbUa7rwufy5VFEAwNVRa1W21J7MX4MB/SZ2nRDYNm247p49513KBvpCy/QygkHR7eN4j5JzEDEpnLYBz/+B22C5geA+QcPYBgGBjchf2s3TlrmsZFAiymQcgBwOp1GsVDAwQMHAFBcwuLSEubn54Via0tSwUCC/VyvxALNZrNJnxdFaflOuVolP+76+jq+9MorPzG/8akGAwBFWhZzOezcuRMXL15EsVjEUPwLZiNfHDCoG0Zf/bMgDJE2Tcou5jh0LGyTzExhX44IDFjUHwYBmr6PldVVIcXreh5UziO+ickse4wAuL7fMzOhlxzh0qVLuHHjBnbv3k3FhmIzsWKhxBbMppF4wmu68gz085k9Jgm4bXZvHjx4AFmStsTTz7Mkx3FgWxaajYYghFIVRbR54scuFAooFAo4sH8/XNelC3xxEXfv3sX1a9egqKpY4IODg5suvniUHzFOcp5xBGEIMLzApYsX0Ww2cfqFF4Aogr5dGXgipus6LKb7cfDQITx48ADvvfeeQMgDEOvEYhU/qY9qYtxM04Tn+6hUq5vqmkiSJKoFYRgKWlqftR99z8Pa+jpGR0Zg27bwM/2YputwPA+u58HsEVzzwLter+Ptt9+G53l49dVXKXUvvx9J732CwUAcBf+kgYlxi8IQDx88wOTUVN/HicKQYn1cl27GrKQfBAEMw6CAQCZxHreJiQlRfShXKlhiY89nz55FBCCXywk8Qr5Q2NQPK4oCwzBgMS4LsSexKSeAcpucO3cOE+PjGG6jbf8k7VMLBlRVpRuk78P3fRw7dgzVSgXvvvsu3njjDTEqCFDgD0BHtPod6YvYXH86lULTtrG2tobUJuIm3Djph8r6wZxYwrYsqEx6kktdSrJMX8sWeLeHU9c0BJZFJVF7BAN+EODDDz7Aw4cPcezYMezZs6f7NW6xTN/eJugWfffVJugjet/M5ufnMTY+3tMx8miZ/x8xvQqemUdRBEPXkclk+oqgNU3D1NQUpqamBEXsIlNP++ijj+AHAYqFgiAuKXRZ4CLKZ/z2AcuKfM+DrOu4d+8eHj16hFOnTyPPMsLtysCTMcMwBBlUNpvFiy++iL/44Q9x/sIFnDhxQpT1IzYKJgF9l+j5uGmKBXsukyvvtzXIiYoMw6BtR6Zs12w2oWqawDBx+msewHYbO1aZpkXA1kGvRKhUKuGdd9+Frut4/Y03kG6rgrSAGmMb95OyftkHN/Nbm53R8soKbMfBdBeMGT+G7/siefBZezmIBQWmrkMzTRQLhb7uQyGfRyGfx/79++F6nmBRvXvvHq5duwZZllu0V7qtd03T4HNgMyO9CqMIjusi8H2cPXMGqVQKz508mTiO+EnZpwpt5hfp+z5ACE6/8AIkWRaRLQBxkwBsmtnHjY+PZXM5igz1PDGGtxUjbPyM84mnUynoTOI2Yv1h27ZRq9dRLpdRrdVgMUGSuKmMzMJjM61J5jgOfvjDH2JxcREvvPBCciCQ0PdjJ9rP1bT8q5sMVL/EIZsercf7q5UKqtUqptv00nlm1Ww2UatWUavVYDWbcF2Xcn6DBoUG44owWEb2OBstAWhJ8OBBvPHGG/grP/dzOHnyJNKZDG7fuoU333wTf/btb+PDDz/E/Py8KP9zUxRFVHz4OJDv+1heXsbNGzdw8NAhkVWomtYBqppimc2Xv/zlTc/10qVLItj8V//qX235Wj9Pxv0G14cfGhrCM888g9u3buH2rVvidTab7VZYqb4f47LHqqIgm81CliSsl8ubUlInGW9L8MpCLpsVOABOhtZkba71chn1RoOOMLYdS2e4JZ45JtmDBw/wwx/9CPlcDq+9+mpHINBuIovf8lX1+tA+dQk+ZhLxYH4e6VSKjoyLj4wEk2i9Xke1WkWTsUn6vi+qh7qmUalhRYGmaX2r2babpqqYmprCcydP4q/83M/hy1/+Mnbv3o1mo4EPP/oI3/6zP8MPfvADXLl6FWvr6x0kVAZLCD1WeQ6ZgNKlS5fgBwFeevFFygMBdCg2flJ+41OrDAB0UTfZRq0zYM/LL72EH/zgB/jg/ffx4gsvwIktaM4H0M+jFDDWv4yuI5/PY71cxnqlgkwm83jjXYTA9TykTFMsNB518lIgnxjgyGU+NSFLkpie4OWgdlaxWq2Gd95+G7bjtJb3Ok4jBmba4oImbdME3Qr9/UT4Hxc6OD8/D0VRUCwWhd536PsIeG8TEK0IRVEgs8qLwsCDtm2j3mgAhHx8jW92PMMwsGt2FjumpxFGEdbX1qhIyvIy7s/PgwAt4kqFQgGGrqPu+/DZs2DZNuauXsXE+Dj28ekBBkZtt9OnT+Mb3/gGzpw5sym+4td//dcRBAF2796NX/u1X/t41/sZN0mSKF0vA+4pioKds7Oo1Wo4d/48MtkshoeGRBJhGIbIvjZbK1xkRpFlFDIZuqF4HsqVCga6rMnNzHEcOkmQzSLL1E6DIBB+w2MVL45XIqBVuXh7MWAbRjsldhRFuHH9Oi5cvIjp6Wk88+yzXSsgLdf+CUwT9OU3+mgv9jqnwPfx6NEjzMzO0hYuI5cTwj4x3yhJElTuO2L6NJwRMIqSWQH7Ne6LCSEoFovI5XI4ePAgHMehUu5LS7jNxJV0TcPIyIjAKWmaBlVV4Xke9R1BgPn791Eul/HKK6+ISlbEsG9x+6T8xqceDABs444iSCx6Pn36NN5++21cuHRJ8LjzzK+fRR0wWlg+GpjLZtGo12G7LtaZouHjmGNZyMeiUb5Y49fRvsD9KILHvjDPdWFZFizbRi6bpe9XFJTX1/H+++/DME28/vrrLS2SJOOjN2JR8Yehx7gOf1/Hz9reK+4toex9HFjX8dD1Ed3z9waxyDdgNML35+cxNDQEO6YHgIiqQvKeanzzb7eA3V9OHPTY1tbuiFi/UwKEJPPhw4dhWZZY4Ndv3KCSzIaBsdFRFIpFqKqKer2Ou3fvIp1O4+Tzz4vnD0huEbzwwgv4xje+gUqlguvXryfLNwP41re+he9+97sAgK9//esfy4F9XswwDDQsC14MZX/kyBHUajW89+67eOGFF6CoKhRZFsGi1MdG5AcBwDYSEIJCoYDVUgmVSgXZTOaxiF84xwVPAHiLQFEUwDDA2SoFxsD3EbGJFMKqAU2miRIy/ntFlkEkCZcuXsS9e/dw4OBBHNi/v/8e+uNWBpgfaNcE4T6JECIAvgA62FH7Aepy8DEAISAUhiHCIMDi4iI8z0NxYEDgyOJgyLjv6CZOJxQpWZXmcS1+HcJnAkJ/ZMeOHR1JxfyHH4qkYmRkBNlcDh7TZ1laWsKJ48ep6izDyhF0+o5Pym98qsGAJEnQDINGd74PmS20sdFRHDt2DOfPnQMBMLtz58YiJKTnoubEMgDrebMvu1AoYHV1lU4W5HJbVrUD6KJuL9nEjQcH4O0PtvFxbQIAdKqAsSBKhGBpaQlX5+ZQyOdx7PhxRFGERrMJidFbxheXLEmtY4XxTToBVLiZRWibTIioelcUW/BJrFoALacSsHZMGFL2Pv539m9O+NMy0gSgVqmgUa9j7969kNg9kyWJ/p3rjvc8cQa2iaKPvaDb75f4pLYgwTRNzM7OYnZ2FmEYUh50Jq167949SkfKApcXTp2im0kU0eACQC4WRHJ74YUXxN8//PDDxEXteR7+wT/4BwCAV199Fb/4i7/4+Nf6OTJd11FnbTfuLCVCcOrUKfzgBz/A+x98gGeffRZDscB/s40oYONmYIkJQJns9FoNoW0LEOBWbTPRIwF+VRSYgAgOAtbzDoIAqqYJMS0iSbCCAJcuXsT6+joOHjyIiclJ6je4v5Ak+ndZpr1g7gt55gx04Ac2NZYwJE00RUCL7+hoNbJ1IJheo0hk89xfRLE/Hc9DxNqC8eM/XFiAmU5TaeCYz5D7VKb1XFfoqXzsimKb8YAoTkssEdKSVDi2jUWGNbhx8yZCtu9FUUQDiJkZ+j52LbIkdUyvfVJ+41MNBgC6qBts1IJzuhMAu3btwtraGq5fv44winD82DGxsXdb1DwQSOp5m6zXH4Qh1tbWEikse1kURbAdZ0uz4oosA7KM+CMnyzIsx4Eiy7h//z5u3LiB8fFx7N+/vwUfIRZufFNiC507qpABlBRFgeM4YsG1oHnjP4tIK4gw2uiR8rvpspK3zCoZ/Nq58+ALNGR9uIhHsGTjk0MAhFVFuC4AkSTBvHV3dRWqrmN2ZqY/3fM2c2MLeiv8BP1YPGPigKMkmuTh4WEMDw/j6NGjWFlZwXvvv48gDDE8PEw5DECdAr+vAwnVKD4u6vs+PvjgA3z1q1/teM2//bf/FtevXwchBL/7u7/7RK/1s2yqqoLIMiLWc5WZ7K+qKDh58iTe/vGP8dGHH+LlV15BkTt9Qroq+3HnnVTGLg4MwF1cRIP1oLeKT3HYeu93giAeHHBLpVJYr1QoNiUMcfajj2DZNk6cOIF8oUDX/8YHdAa5zG/wdWoxITeXHUP4DL6Oua9FLAGIleCjtvsVRZEYqQyCAJ7rtvwuvukHjI2V/563RcS9DwL4rB0ssSSIt1lLKyvYt3//lrle2MlSSuAnXE0UHy8Ok6xtwEv+MzMzmJmZQRiGOHv2LB4+egQQIjBiot1BCPIJ4MZPym88FcFATZLgs0yPX3YQBNizZw90XceNGzdgWZa4Cd0WtQD5dIl0C8UiRfc2m2ha1pYAiY7j0C/zYyLCdU2D67q4cvUqFh89EhKiIVtMLmOgimfY/O88mg6wsfhsx4Hs+zSSbL/ueAsAgNWwMYhBhOw/AoJypdJSWfB8HzYjTuHjSFwPXTzsaHUMEiurk7ZqBj9+HKMRseh+enLysQIBRBHtwbIFvdWJCmFdFnRLPxZ044+Dx9qPt7qygnffew+yLGNichLDsbFY/krDNDv6fgCtNhw7dgxnzpzBBx980PH7UqmEf/bP/hkA4G/9rb/1E6Ek/awYIQS6aVK6WM+DzDjiCSi46+Tzz+PipUt46623cOrUKQHkTHTS6MTAxJ8DTdOQSqcRNBoora3Ruf0tmMMCCEJI36Ji7cYnD+r1Oi5euABJlvHGG28gm8lQAR0WFAUx38E3YL7xhuyZj6JI0CoTAF5SQJ2wPrhUPP+TvmzjdY1mUygCuq7bim9ir48AgfvibTTuL6RYa9IAzYrF90UI5ufn4YdhzymCXsb5YzjzXz8y14nWxefwygB9SdRxDznoHKCJ1blz53D//n0MDg9jYGBAVL8lFvgQUKbNdvuk/ManHgxwEpEoNjrDkaGEEOzatQtDQ0N4//338RdvvYUXX3opUV0uCe3bvuQ0TUM6k0FQr2NtbQ3G+HjfYMJ4MCBJEl1Ij1OeJgTnL1zAWqmEZ06cwOzOneKLV1S1a4m8I7r2fTiSBC8IIEsSDZJYRCk2a/73+KKMIgRRQANPbPysJRvg4CU21iT6YW39wPgC7nbOvD3CbWV1FXaziam2KYJ+zXEcoS+gahrFZkRbV3UT15zw847XxZ61+IK+f/8+PvroIxSLRUxNTcHxffH7eEunkNAi4PbCCy/gzJkzOHfuXIfM9W/91m+hXC4jnU7ja1/72pau74tguq7DJgSe74OHWnyiQ9M0fOmVV3D27Fm88847OHb0KCU04+XqeLmcSdDyfwPowKkU8nk0Gw24rrtlsTLbcaAz7gvSpyJfkq2Xyzh75gzMVApfeuUV6LouytKaqiLqUnload8x7I7nefAJgcLok4E2n8FaXOwX9A+enMTbfnztEepNeAWQ+w4AHRXNeNLQbd2Klg17PwFdb4PF4pb4ImInKqonnA/isb6FLklE58tY9TahSuB6Ht59912UVlexb98+GpzEE5uYry4wVdZ2+yT8xqceDBBCYKbTsBjbX7u+s6oomJiYwOuvv463f/xjvPmDH+DFl15CoVAQi7q9tBcvP7VboVBAo9GA57qo1etiBnwz42V4Xl7a6qKOoghNy8KPf/xjNBoNPHPiBIbbNA56ZbkkthkDQMQWWxiGUFQVmT4WSJmUUUIJESKECBEhQj6fb1mQlmXRUSwm6dvNHmfUCqCsivl8HgNDQ0JVTkTRmxifG48ApBhxB19oWw0Gur066XPiAQG/7qtXrmDu2jVMT09j9549KFcqUFmPNmABGrdCD8DqCy+8gH/37/4dms0mLl++jGPHjgEArly5gn//7/89AOA3f/M3t0y7+kUwwzBQkWUEjCZcURTatwb9HjVNw+nTp3H58mVcuHgR9Xodx0+cEGqAAl/Ux7MjKwryhQLW19exxhztVhIJXhmSAARbeF752rh58ybOnTuHwcFBHDx4cEvtMYkQgOOZWFvPc10EzG/01b5ggQIB1Vdo9xvx1kE2l+t6b/r2GzFfSECrDstLS3jm2WdF66J9XK+XiSSCEGi6DsuyHsuHdUsigOSqE68s8iSh0Wjg7bffhm3bePa552AYBqq1GgiTyo7f03QP7pRPwm88FRJq6XQaEWsVcA14ru/MH9RCoYA3vvxlaJqGt958EwsLCxs96m4PRcKCkyQJ+XweMpOHjOtI9zLHcYBYm6AfVCzf6MIowtr6Or7//e/D93288sorKAwMwGNyuo9jpMvfexnNViPRJojYf3GLA1+6WfscdPeTbP0M27ax8OgRZnfubCmpiTYD0DPAcrj4DyECOMhLr33bY1Rz+ALlwdf777+Pubk5HD58GHv37hXgTplhIoJY1iFJ0qaVAW7xkt9v/MZvwPd9TE1NCSDQtrWaJElIZbOICBG9YM5PojKxIEIIjhw5gmefeQa3794VHCbx6kDcenFs5LJZmoGHIdbL5b7P07KsDeKYHpW0+DnwhCYIQ5w/fx7nzp3Dnt278ewzz2xghB7XElqsmxrL/ulfOzP6+Bp8IsqcbZ9/5/ZtKGy2H9jYlAn6EFRjY5sArQrIvAq01WCAkJ6+ttvzxH1UqVTCD958E0EY4qWXXkIul6PTIYy3Jo53A9AyudZun4TfeCqCAUVRoLPM1nGcjegeaFF1Mk0Tr772GoZHRujo4YULQmN6K5bLZgVYcXVtra/32LYNOQYCIuj+0PMAgM8sLyws4C/eegumaeL1117bELsABEiPfugWS91bejU/6/ZzbV0Qgoykx4Lu9yxJ2/dy9+5dEEkS46LiHLBxLaKP2F6uD0M4to0QG3PjnAJ4S/fhYwRfa+vr+AELRE+dPo3p6WmRhQr0tiSJvilANRC6scsBwN69e+koESgyGAC+/e1v47/+1/8KAPja177WF5/+F9XS6TQiQkQiwZMJJa4mCTqR9MrLL6NUKuHPv/99LK2sJH9gr+eD0FFDRZJQqVRgM2bUzcyx7RYWua7PbKxEH0YRPM/DB++/jxs3buDYsWM4dvw4TUYIEeOK4q19nQk2gpHHxdp0sagPv7EVi/uYIAxx9949zOzYkbiW+F4hIdk3Oa6LKAyp+FysFbvlO7DJPevV8pibm8Nf/MVfIJNO47XXXhP7mqIoQoWVECKeX4Bi3LrZJ+E3nopgAAAyuRwi9pDz6D6pfKUoCk6fPo3Dhw/jxs2b+O53v4ul5eWtHYwQDBSLUCSJMt3Vapu+xbHtxLHCOGCElx15X40Qgtu3b+Odd97B6OgoXn31VfEZuq4DhMCOBwNbWaCEPF503+X8uYnKwBNY1FHseGEU4fadO5iemtp0VpuXRuNny4lbFEY4A0D0KvutDDzuCKLneTh37hx+8IMfgAB4/fXXMTo2JhgJNVWlgSurDMTZJ3staG6nT58GQCN83/fxG7/xGwAoaviXf/mXH+ucvyimKAp05vQcpkPAf95uIyMj+PKXvwzTNPHWm2/iow8/7GCV5NbtSTFTKZimCVmWsbyysumzF7Feddx3xPkn2Ito8sCBf+xafvSjH3WwkSqqSltQUdR67lvwHfFg5GON5casn4riVqqg8Vc+fPgQjuNgdteuvt4jqgUMd+DYNlWbZEkEn6jYSkWxrzNPuL5SqYQ///M/x7W5OezduxevvPKKqADIskxbVrFggCcSkiRt6juetN94aoIBTdOgMJ157vi7ZcqSJGHfvn348k/9FDLpNH784x/jgw8+EKqGvUp93HTDEFTFq6WSCEC6me26gkKSmwCJgD7ocVBKFEW4cOECzp07h927d+PUqVMtUS2nR40Ycx3w+JFqv8tZSqwMdGbgwJNxEvFPWFxchGVZ2LnJgk78DIYVCNFKzckdT7/lvsdpySw8eoTvfu97uHP3Lo4eO4Y33ngDuXyeUt2CYlrE1ARb3PHnthsAKG685Hfx4kX863/9rzE3NwcA+N3f/d0n5qw/z2Yy3I/LMkBgI1Bst0wmg5dfeQXPPfccHj16hO9+5zt4cP/+hiPv4xkZGByExlQNV0ulnq/lPBvtjKMEENwcPi8Ps/Ot1Wp468030ajX8aUvfaml78uxECBkYwyZ/mLT836s1/ZpAmDb7bMZ5qBfi3/K7du3MTQ01CJDv+n5gFYpHFZBURjIUpwj9x19nlM/dyye/Liui7Nnz+LNN9+ELMt4/Y03cOjQoRZVU8MwKONqGG4o0rL35wqFTROyJ+03PnUAYdzMXA71lRW4DAzUCxwWAchmMnj55ZcxPz+PcxcuYPG//TccO34c423AvG5WyOepjKXjYHl1FeOjo92/gDBsIbWIf3Htm1EQBPjwww/x6NEjnDh+PFFrnTClM4cBJzMMELil7SrWw+vv5Z2vC2Ntgn76fo87ynf79m0Ui8We/fNu1rQscHax+Oz1Vp3aVl5tWRYuXLiABw8fYmR4GM986UsUxcwyMt/3BTuYZdsA6SSF0pmA0mbGF7Xruvgn/+SfAAD++l//63jllVe2cMZfXDNNEw1VRcCEXzQGQu7qSqMIs7OzGBsbw4ULF/D+Bx/g3v37eOaZZwBs/pxIkoTiwABWV1ZQbzSQMs2u3zPPAtvHa+O95Pi6XF1dxbsxsaGkUq+u63Q0kM30y0ljxb0s5rueVFiwaXuxTxS+eDn7s1KtolQq4dTzz2/5nIIggMsSS8M0EUaRGGUEHt+XdTPuvx8+eoRzZ8/C930cP34cO3fupCOTAOqMNVFjCokh0+Vpb390o6OP25P2G09VMGCk02iurSFiqoDtUrTc4shVQgh27NiBkdFRXDh/Hh9+8AGGh4exe8+ezfXDCWWHWlhchOs4PfnHwygSD3oYi3I5doBvpI7j4J133kG1UsELL7zQU55X1zQ4DAn9OFnrVhfyZq8X9xTdUfX98Lu3vAdAs9HA8tLSY83Je4zIJIwiZFi/FIQgahtZ7GlbcERRFOHOnTu4ePEiQAhOnjwphEH49fCMTNN1SLJMZ5eBDga0kT6JrU6fPi0CX8/zoOs6vv71r/d9edsGmPk86qurcF1XtJGSEon4OjMMA6dOncL09DTOnj2L73znO9izZw8mxsc3DbBN00Q2m0WlVkNpbQ26rie2v/g58PHpiCc49JctQOT5+XmcOXMGg4ODOH36dNd2msTGal3Xhe26SJtm1+mpRNvixtyPxcvbT8J4ln3n9m3ohrHlaZoIEAqRqqa1Tl/0W/2Mf1d9WLPZxNmzZ/FoYQGjo6N45sQJQUAG0E07iCURAANjs7YRP5YsyxjpI6F90n7jqQoGZFmGns3Ctm24joNUKiXkOzd7yAxdFwv7zJkzePfddzEzM4NDhw71JApSVBXFYhHra2sol8tImWbi6/kXFQ8EuPHNs1qt4u2330YQBPhSD7EhcWzGve/7PlzH2TLnfLeZ6G5GEnOljWsR0X0XwBtJAPZtekxCcOfOHSiqisktcgtEUURFRUAXT3yzJf3QFtMT6MvxRaCtjCtXrmB1dRU7duzAsePHOxyyzUaSJEkSpV8+EqSw8+ELerzP683n8zhw4ACuXr0KAPj7f//vY+fOnX29d9uoGZkMmuvrAHOMXQPahJbS+Pg4hoeGcOnyZVy/fh335+dx+NAhSm7TY20VCgVYtg3HcbBaKiVWJEW1jWN8YpuLaDOGIa5fu4bLV65gZmYGzz7zzKbPtq5pcB0HruPANIytZ/hsXTypNtRmrdmthh4EdLz83v372LN795aBiS4HokdRh+w9z9L5eXe9B30GAo7r4hYTJJJkGaeefx4TExMt5xwGASzbpiBGXQdhXDV8tFVmo4UAMDI21pcGxpP2G09VMAAA6UIBlZUVwcgniDpi1iuLHh8bw2uvv46rV69i/v593L9/HzMzMziwf39LlBa3TCYD27IQNJtYXlnB1ORkR/DRrorVbqXVVbz9zjswDANf+tKX+kZy6rou9LVVXd96uW8LkWvSYEyceoM7LvkJOQiALoK7d+9iZmamJ6o+ybgEbXzjFcb79Judax/jnw8fPsTc3Bwq5TKKhQJeeeUVDCdw0LuOI2RkTdMU5+DxvqSiiLHL0bGxLQV3IyMjuHr1KoaHh/FP/+k/7ft920ZNlmXomQxQqcBlBGGEECFmBbSW59tNUVUcZyIx165fxwcffIC5q1ex/+BBTE9PJ28YhGB4aAgLCwuwLQvlcrmjDSaIt7o8h2EY4uyZM7h77x4OHTqE/X2KDamqCllRELBEYiu8A9xnPMnaAH/uu+oDbHGMLwJwf34ege9jdosbXBiGYtLDNM2O/SM+0tytVdDP6Lhl27h58yZu3bqFCHRiZd/evYIMShwvitCwLAEa5Fw1nutu6EhIEsCSivHJyb6v9Un6jacuGJBlGVo6Ddu2NzaD9t7aJuM/uqZh186d2LFjB1ZXVnDj5k3cvnMHszMz2LdvXyJ72MDgIFzXheN5WC2VMDI8zA5FS+NhEHStTnAmusHBQZzqUd5LMk3T0LQsRGEIz3X75i/n19oNKNXl5R0WJVUGnlCpD2BIYNfd8oLm1ZIItN+32TUSVoZt/WH3qkAYRZifn8e1a9dQrVYxPDSEV155BUPDw4nsZAGTJwZoFUpl9LcBV1UDLUcGjAhpbAsL+oMPPsBbb70FAPjt3/5t5PP5vt+7bRuWLhax8ugR3QwcB1lV3SjLs8y810ZLCEGhWMQzJ07AcV3cuX0bH3zwAa5cuYL9+/ZhZna2wwcoqopCsUjJiNbXYZqmGCOMAMGkmnRc1/Pw3nvvYXVlBSdPnuwYud3MdF1H0/dhuy4yj6nR8cQqA5tMEzwOOPr27dsYHR/fkh4MALFOJVmG1p5EMOPPQ7cEpVc7tNFs4sb167hz5w4kWcaePXuwe/duGpBFnRwOtmXR/YMQSoHP7hHnTVFj7IOFwcG+E8kn7TeeumAAAHKDg6gyhL9l27QMFovUNmOc42qFiqJg/4ED2LNnD+7evYvr16/j3t27mJqexv79+1tuXhIoKJ1OtwiYtB8ziiLMzc3h6tWr2DEzgxMxdrN+jXPs8+CnH8BZ7AS2BKJLahPEeQY26/ttFdcQRRGu37yJkeHhLSOBOSiPA22SrD27iWM3ugUCAZNPvn7tGmr1OsZGR/Hss8+Kmd0wYTFHYbjRf1SUjYmGKKITLIRA43TQAAaHhrY04/ubv/mbAKgE79/9u3+37/dtW6vJsgwzm0WjUkGDrWHOdQ+gr6qbLEmICEEhn8cLL76ISqWCa9eu4eyZM7g6N4d9e/di586dLfwnWdbaDJtNrKyuYnxsTPgrUY1oW1PNZhM/fvtt2JbVEoRuxXRVRZONo3me13cSEp94ehL2xAmHQDU/KpUKjhw5sqX3cQn5pPZAkkXYOOd4MpHkVev1Oq5du4Z79++LvWX3rl1C/ZBPh8StpZqYSgndAYBx6jD/z1sEWwkIn7TfeCqDATOVgpFOw2400Gg0oGma4LIONwkEALqgJbDSVRRBVhTs3rMHO3fuxL1793Dt+nX8+fe+h/GJCezbtw+DAwMAITBNE5lsFtVqFaulEkWvswUWshIPt4ApTt2/dw8HDx7EgQMHhAPYqhiJYRgUSMi0zPutDmwJNIRuoMD439l4ULcFvUXnsbS8jEq5jJdffnlL73NsG6Hvg0jdZV8TTw8Q6mft5+p6Hu7fu4fr16+jaVmYnJzEqVOnOli+JADtLtmK4QTasxRejlTZgiYApmdn+z7n3//938ebb74JgCqNbbWVsm2tlhsaglWvw/d9NJtNZDKZDa79Pt4vcd/BnHM+n8epU6dQO3gQ169fx4WLF3Ht2jXsYUEBbwUNssqi7ThYXV3FEBOs4ptDPGNeL5fx9ttvQ5YkvPbaawLo3E9pOm5EkmDqOposkdhKRZK//0mMGcbB3E+q0nD12jUUCgWMbEEymmOMOKeA3MuPJkwUJN3/CEClXMa169fx4MED6LqOw4cPY+fOnR1+umOqrK2ayF8vEUIrir5P24uqCt/3kclmMRgTOutln4TfeCqDAQBIFQrwHUcs6nQ6TR+0PhYLIQSQJBBG4sH7WJIsY+euXZiZncUDViJ+8803kclkqJb0jh0oFgo0S7csLK2sYHx0lPJLB4EYa3M9D++9+y5WS6WO8p5ADm9hUUuSBE3XqWIgGzPckvW9AJNHNLmJvt8Tiu6vz82hUChgmLVc+rGWfp9h9NWyaL/TvGIQhCGWl5Zw7/59LDx6hDCimuHdWkWEEDr3GzPbtuExBHAq3n9k7SvHdRFGETRVhe95SOdyGOyhRdBsNvHo0SPUajV885vfxL/4F/8CAPCrv/qreO211za91m3rbWYqBc0wYDcacD0PjuvSHi0hQEyQqJt12yCz2Syee+45HDxwANdv3MCVK1dw5fJljI2PY8eOHRgfH8fAwAAWl5ZQbzRo+yCfFwp9/DMXFhfx/nvvIZfL4cUXX2wJdh+nj68bBiw2kbSVROJJ2mZ+Y6sViLW1NaysrODkc89t6X2241CmwSSMUZsRdHpD3joACyruz8/j/v37qFYqME0Tx48fx+zMTAcugrey41wRXauJ/Fx55VOWBZ4iPrXUbj8Jv/HUBgNmOg3bMOCyeVrXdekXTIjQsu9lEiFUsjPpd5KEHTMz2LFjB1ZWV3H//n1cu3YNV65cwcDAACYnJ6EycM7yygrGRkdFRSIuNPHKyy8nbnQEaHkw+jFD14WAUmAY/UV6W1xk0iaYgSdJOLS6ukqDpS3OB3NOAVmWRfmtq5FWSCS/5+X1ddxn4FHbcVDI5XDo0CFMTU937T+K7yx2T33fFxzwRlumQQgR4icSIVBkGZ7nYWx0tKdD/sM//MOOkt6pU6f61hzftt4myzK0TAYhG+OyLQuKLFMH3gcNr8SeqYj9vb3sm0qnceLECRw6eBDzDx7g/v37ePfdd6EwQbWhwUHIkoT1SoUSyYCNHxOCW7dv48L58xgbG8Pzzz/f8ZxwZsKttAskSYLOMkvLtrfUjntSMOGoRzDwOJXSubk5ZDMZTGwBdyMwRlGEFB9B3oIRQuA6Dh4tLOD+vXtYXFqCJMuYGBvD4cOHMToykpiYxPEo8WN2qybywMFmfkXVdQRBAMM0MdxjFPkn4Tee2mBA0zQQTYPEMi/bsqAqCi0Dk82V6uKvS1rU9EUEw8PDGB4exokTJ/CALe7z58+DgFLJFopFENaL9jwPb771FmRJwuuvv95VxpQQql63lUUty/IGCZFtI/04Mp2bWNI0AccMbNb322p0f+3aNeRyOYyPjfWd7biui8DzELGWzWZGALEAG40GHszP4979+6jXatB1HTtmZjA9Pb0psCaekcWJpCxOEKJpLUAkfhcd1wUIEbLbpmliaGSk53N55swZABT8NTs7i7/xN/4G/uE//IdbBkltW3czUin4zSZ8tjlYtk1VPft4hjk7XTwwTnr2NV3H7t27sXv3btSqVdy9exfzDx7g7p07MEwTxWIRjm0jn8kAhODGjRu4f/8+9uzZgyNHjnTNonnGupXVZpgmLNsW+gzKT7jVJFohCde01dZBpVLB4sICntlCVUBgjJDAKdDN2AYehiFWV1Zwf34eDx8+RBAEGBocxPMnT2JsfLxn66VlD4o9Iw6rJgJt1URAYMo4M6KuKHCDABNTUy36Fe32k/AbT20woCgKFMMAPI8iMWWZtgvY4trs8eIRvkDIt08ktBkhBNNTU5iemoJt23Rh372LW7du4c7t2yLCLRaLHeW9xM9DcmbRywzDoIAT14Vpmn2X6/tuEiReOz0/Hgy0AK5itpXofn19HUtLS3j++ef7nvMPggBNtvkajMxnM7MsCw8fPMCjhQWslUqQFQWTk5M4dvQohkdGNqRq+xgv3PgHBXw1mk2BE2n/rnm2x6sGqqrCdV1Mz872XNAA8Hu/93v4vd/7vU2vbdse3zRNA1FVKEwozGPMhFKsxdMtcxTEYluQ2k2n0zh8+DAOHT6M1dVV3L13Dw8fPMD8w4fQNQ1hEOD+/fs4duyY0BjoZVvFDnASopAlEv3ImccO9rEJiPrRJejXrs3NwUynMT011bfvtG2bgp8J6Q80GAQor6/j0cICFhYW4DgOctksDuzfj+npaQH+jYCW0dR2i4PF+Z+81QvQNme8mshbCZ7vb4C1ZRm6LKM4ONgz8PhJ+I2nNhgAgFQqharrQrLtFgEPlfcAezwsQpkqxqrXrZffTiRkGAb27tmDvXv2YGFxEbdu38b8/DwAoFwu44MPP8TIyAhGRkZQaNP1bj2JrS00hZXGXdeFbdtbQqT7vo+IiySFoeBF4P8jitBwmxjEIIAIPqgyZK1WBxwqrmPbtqD85YBNianxbaXsdu3aNaTTaUxOTvYldxyBtQeYDHCSIBQA+K6L5ZUVLK+sYGV5GbVaDSGAQi6H506exOTkZEdWxKsH/TrXMIpgNZsI2MxvyjTF98urTPx1nuuKn2VzOQwODW1n+E+BGYYBmZVfCVM1bTYaSGcym2JQJEkCiSKE2Aj6xGRA+4tZgsCNABgeGsLw0BCeOX4cV+fmcOv2bfhhCCmKcOPGDVSqVYyMjGB4aKhrQvE47QLDMChN9hbajHyzC4IAIQuc4j5EXDP7s1avA6Coej7STED72WEYiuRLIkTMzm8Ff1Sv1/Hg4UM6ldWm/tnNPM+Dw6oC6VQq+fuNItSqVSytrGBlaQkrKysUICrLmJqcxMzMDAqFQieGAADpUuFNCth834fVaACgdMPt1UT+ejs2KeW6Lnbt3YtMJvPEwJePa091MJBOp9FoNBD4PmT20FqWRXULNlvUMafNLWlj4NTG3b6G8bEx6LqOer0OPwgwNTmJcrmMK5cv4+LFi9A1DSOjoxhh7Yb4aODjVgc8z4PjOJR1r538KAjEbHuj2YTDRlcUWW6R5owzbPFMKARtFUSIQMCVu1jw4PuIggCRJLXKKoOi66Mogsw2a67OFz8mt1q1ikePHuGZZ54RJcLNNmI+h8s3X3HcIMDa2hqWl5exvLyM9bU1RFGEdDaLkeFh7N27F6l0GpqmId0jcCKAaPVwE6Cf2OuiKEKz2RS6Ayk2CsQtnvm4DKwESYKsKJiamUEmk3li4Mtte3wjhCCbzaLseXRtsw3OsiyqL8GC9KRWIwcfg22QYlNNCOx7rWtFUXDwwAFouo6zZ89iZnYWiiRhZWUFt2/fFm3IUZZUDA4OtmAI+DPbrwiXLMtQVRWe58F2nI71EEYRAt9HGIZwXRcNvuYQwzexP0UfPNqYtRdZMmI+hQUJPiNV8sMQYNwgBBt+Q2Jt03b/0X7vr1+/Ltp7UR8bYxiGaDabIISy+sXbA7ZlYXlpCcurq1heWoLN+D+GBgex/8ABpFIpGKaJbCbTO3CKog4flhgIBAGajQadDpBlyo3SxThAmkgSBoaHkcvntzZS/gnZUx0MiEXt+4gYW1MQBKjX67Rfzx/ghLIfp5wMgwC24+A3fv3XUalUMDwygt/5+tepk28LBBzPw//0ta/hxs2bUBUF/+gf/SMcPHAAA8UiUqaJerOJTDaLvXv3QlEUrJVKWF5extLKCh7Mz4uNamxkBEPDw/R9qVTr/PsmxjNzly1qg00Z+J4Hj2X/fLF5jLM/iiKhmEdYJi+YrWIRPFxgHesIESIAvW4zZSJrZNBsNmm5UVWh67qg8gyjiOoAsAXg+z7thzFHIEsSbemw/+euXYNhGH3Py7qeR9Xmogi6rqNSLmN1dRXLy8tYXV2F7/vQdR3DIyOYmZnByMiIqJhYlkUpPvvZgKNIfA8toB/xa1oR4IGAmU63OGcJre2Eer2OkAEHJyYnYRjGJ4Lz2LbHM9M0Udc0+GEIJQjoc8aY+rjqX7ftRmZ+JoqiVt8xPIyv/87vQJZlkTFz6+Y7RoaHIbN1NTE+jhMnTsCybSwvL2NleRl32aizJMsYGhzEyPAwhoaHUcjnRYm531TCMAx4rivA1mEYivXKn2uevXNWRD6OK8cqgdxviH4/T6xYpp5OpcTmxY8RRZHQSBBrLAzhB7QCGbIkBowDIC48JisKXNvGvXv3cPjwYciS1DHe224RKPkPQEvtURhi4dEjrLDEoVqrAVGEQrGIHdPTGB4dxeDAgNj4K5UKnRLqMxvn55zUbg6CAI1YIJDik2/M4kfwfF9MIBmGgfGJCaTT6aciiXiqgwGALep6HX4UQWPRuuf7qNfr9IGMlXDjX4AiywAhdH4zk8HP/8Iv4D/+h/+AleVl/PCHP8Trb7zRUsIOowj/7n/5X3Dj5k1IhOB//Ht/DwcPHBC/T6fTqNXrIACWl5cxPjaGoaEhDA0N4RDopsY3saWlJdy6dQsARYsW8nnkslnk8nnk83nkcrnkaJQFN4qioFqroV6rtTxYPAhQWHQdRRECRUE6naaR6CYZuBLKCBAgZP8BgKTQRSlJElRFgWkYLX1vsbjDEH4YikUdsLJiGEViQ29aFh48fIgDBw5s2lawbBvl9XWsLC+j3migXq+jXqsJFPfQ0BAOHDyIkZER5HK5jkUryFzQ//QDz4DaX83nkwU5SDrdoo7YDujyPI+yYxKCgYEBFAcHn4oy37ZtGCEEuVwOa74PPwyh6zqsZhPNRgMSQOXSu7TxeNbq+z4Mw9jwHSsr+NEPf4hXX3tNlMWB3r4jy31UGKLBRg6L+TxmduzAzI4diKIItXodK8vLWFpextzcHPxLlwAAmWwW+VwO2VwOhUIB+Xye0ut2ec64ambTsmDbdqdsMqFTOgoAU9chSRIK+XxPDEXL5zOfJcuyCJTFOGMC6Jf7Dt6GiPuPCHQOn8/a37h2DbKqUj2IHhaGIWq1GlZWVlAul1Gr19Go1QSbn5lOY3RkBAcOHMDwyEgiJfhWfQdh1xzFEgluPBAIwxByeyAQMbKp2DNWr9cBQiATgpmdO6Gq6lNRFQA+A8EArw6sr6/DD0Ok0mnUqlU4rgvC+Ae4g49/UbIsiyguCAL8pZ/6KfzZt7+NUqmEb37zm3jlS19q2RT+43/8j/jwo48AAF/96ldxum0kjmfLiqLA830sLi9jbGRELBCNRf4TTKXQsm2Uy2VUKxWUKxUsLS3hxo0b9FwJQSabRYEFB4V8HulsFogiOK6LgPX8A5aZZFiWqqqquC6Alu1c1l/s614mThPQB5UHRklBCiEERJbpTGysFMezAv7/ndu3oaoqRkZGUK1URNmuaVmoVSqoVKuoVCool8u0GgAa2GQzGQwNDWH37t3C6fWKlMX3zKpC/W7BXOcgXt6NIjqp4vk+IkKQSqU6AoG2m0F7p7IMVZIwu3s3FEXZEr5j234yZhgGLZ2HIUgUQU+lYDebqDUayLGAGkDHZqgoipCpBtDhO156+eWW57OX75BZoK1pGmRZRrlSgSxJyLFJJEIITRSyWezevRthFAmfUWH/L9+6JfrMuqYhz/wGTywMw4Dr+3QsOQjoJhtF0FnfWmVVO97yCoMALrs2QggtyT8miFDomXSbjmAVACgK+LbM9Rr8IIDveajX63j06BF2zM7Cdhw4ngeVjerWGw1xH8rlMmq1mvBZumGgkM9jZNcu5AsFFPL5vtZhC9PgVgL4tvskAgHmV9LtFYGE19cbDSCKMDY5iWw2i2w2+9QkEU99MABsVAe8MIQXBEhns6jX67BtewPt3ZbxEVbCdVmpStc0fOUrX8Hv//7vY2VlBW+++SbeeOMNAMCffvvb+G/f+Q4A4K/83M/hZ/7yX+44B1XT4Ps+hoeGsLy8DD8hIGg5Z8OAOTbWomTmBwHK5bJ4uCuVCh49ekRV1lhP39R16Cw7VxRFBCHpdBoS6dS9FteLPrgNEn8XCdwEsEXCoYiKSTUtC6VSCUtLSxgcHMS1q1dhM2RzvdEQEbWZTqNYKGD3rl0wTJPyuBsGstnslpDIHJXLAU79LiaeOcWpYm3LEo7RNIxOVjHEAgKWLVrNJoIwxMzu3VBV9ala0NvWarlcDqVSCY7vw5RlBIoCLwhQq1aRz+dbSKT4+uCZLg8GFEURvmN5eRl/8dZbeOPLX0YURfj2n/1ZT99BQGmDJRb01mo1lNbXEQHIJ4wmS4SgUCi0CB7x8cj1chmVchnVahULi4s0uQDdkPn4Kw+AVFWFbdsoFgowTTM5yP+Y95YfG+j0G7wq0G1dhEEA17Zh2TYuX7kCQghc28bFCxdgOQ5syxKKpbIkIZfPY3BgALMzM1A0DZl0GibzIf0ab5FsprDY+UYikg6+tQdxjIAkQWeU+RtviQUC7O+NRoP6OUXBzM6dtJLwFCURn4lgAKByoaurq/AAIAyRSqXQbDbRqNeFLGQ7MEhhvXff96FrGl599VX8n3/6p1h49Ajf/OY38eqrr+LDDz/Ef/rDPwQIwUsvvoi/+Tf/ZuLxNVWF5/si811eWaEBwdISxhhL4WamyDIGBwZQLBYFdanPRlGqlQqazSYdg3JdWJaFZqMBi81KSwAiQqUu+SJQGW+/ruvQWdlPliQK1kn43wndjnOqVCpAg2a7IYtceTUlYP1G/m/P82ifnv3vshEazucA1nc3UylkslkMsB6daZpIZTJQ2AgUJ+wB6Bxuv4FAC9MXtiCsFGuzABtl/3ggkOpSfo3/JIooKj0MQ+iGgUlGYrQ9QfD0mq7rAojsuC6MVAohmxapVKvI53Idz097VVGWZeE7Hjx4gG9+61t49bXX+vYdqqrCc12hf1Gr1bC2vo4oDGmZfhMjrARvGAZGhodh2zatIDL8VK1eh2PbVGjNcVApl9FoNgVzJkCfY03XaZJimpBkGYqqIp1Kievl7UJZUSgWiJE1cf/BZ/n55E/IWh+O40CWJKytr2+0EGNVwyAIaBux2RS+g1PFi3uuKGg0GjAMA4OpFLSREcgs0DaY5K+u63BdlwYZW6QqF5VjbOiP9MNu2k6BT0BbI81GAyFooGKmUi2AQgmxcWaeeIQh6o0GfN/Hrl27oCgKisXiU5VEfGaCAVVVUSwWsba2BtfzoMsyDF2H7TgUUEiIGDnkX7yiKCCEIGAOX5Ik/NIv/RL+zb/5N1hdXcUf/MEf4Mc//jEkScL+Awfwq3/373aNlnnvyWOAtlEWEHi+j4WlJYyOjLSUl7uZ53moM2cEACAE+VxOqCTGS9hBEKBaLsN2XciStLEZM7pkXh0JowhgFRA/CFpAhqIaEEXwiYdADhCGAWXAJMAPf/wjZEkusUzIgUUyQwKrmgaTEapMTEwIB1Wr1XDhwgW89PLLGG1j0eKOwGZlV8d10Ww0IMsysrlc/3zqCajeKEpGhLe8DQkZECGwms2WQEBVFIqG5i9J+JwoDCl+JQyxf88eqKraIVm7bU+f5XI5+uyFISzLQjqdRr1eRxAEqNVqtLLDe7s8kYhVFTn6/Zd+8Rfxb/7n/7nDdxzYxHeoui7wKAMDA5AkCZVqFeVKBRHjLtnMoigSWAD+3KuqivGxMUwpSsdkQ7PZhNVsUplcWd4I4m0bVrOJaq1GKx+8ZO/7VFsjIaON/z2MIrzz9ttiXSW1GAjoSJ4sy1BYcKHrOkzTRKFQoAFJKgXDMHDh/Hn4QYCf+qmfalnHXMLecV2hXspBfxrbC/rdSHkA0DJhhc0rAxxk3HJerCLAA4F0KrWRDKFNFjn29yZrRZrpNMbHx5HP57ckcf6TsM9MMADQHmA2m0WNscNl0mkKYHNdCijMZumGzAICWZZBokjM3BNCcPr0aczMzOD+/ftC6GF6ehq/8eu/DoUxySU9IqqqUgQ/4zrXNA0jw8MiIFjiAUGXzS1go4C+7yNgFLaarkPXNBGhts/ky7IMnTFYSZIkAgZudbbYTdOEwTS0eRmMg3aCIKD4A99H023i//Pu/4oIEiREQAS88MILGNQG4bkuNF1HNpsV1QVCyKajTWEU4fy5cxgeHu4IBAAWlKkqMmzsaX1tTYwNeY4Dh/VT+1rY7QELX9RdXt6NPMmyLPjMOadYWTWKfVa08QEtwUfTsii98eAghoaGMDAw8FRF9tuWbIQQFItFrLBKF9c6adTrG2DktlZPe1URQFff8eu//us9Kah1XW8Z1+UBZLVaRaVaRQRgoEtAEEURHMehMuegAanCJn6Er4k61fJMxjsgsVJ03HcEYYhqtQoAKLJzEb6DS3IznxGwgCgMAlQqFXz00Uc4ceIEcvk8ZEkS6qK5bBaaptFxY9Ifr8fDR4+wXi7jpZde6lhHBBDZv8FGu/mEByEETcuCaZqbsi22BwL8fvHJiiSLGPCv/Qo8z6OcCtgIBAibPGlJVnglMnYPqrUa/DDEjtlZZLPZp6o9wO3Tn2fYomWzWRipFIimibKSwiLjOlMr41+IJEmQFAVRrP9HAIEVAKgqWZzWsX3kjBvnyXdji5oHBJqiIAhDLC4tiQyAG4/oy9UqPM9DGFHa2nw+D6MPIR6T4SGCIKCI2Zi1P8z8AZcIoeIYuo5UKoVsJoNCoYDBwU5FrFw+h3QqRUv5pgmNgxSBvhb07du3UWs0cPTo0eQXxCoTjuNQjEA6jUw6DSLLcBwHNfa9JZkgTWr/OTapDCQ4JA74aQkE2PcqMh1sBBHt718vl0FkGVPT0xgcHNxWGPwMmSRJtG2l6wjYrD0HfLmeJ9o/3NqrigB9Nrr6DkK64nU0Ve3wC4VCQWyo1WoVpbW1jvf5vo9qrYamZYlSdS6XQy6bbUk6kmby+UZKQEdwW57lLudJQMf0NE2jo7KZDHK5HAaKRQwNDQkBrmKxiMGBATHdYLL2g8ruWT9QxDCKcOnSJYyMjHRNIuL3wQ9DmKkU8tksVE1DFEVoxO5NN0tK7nr5DQ4GbDfHttFk4D9FljcIjlgLIP5Z7T6LT7HkcjmMjY0JlcqnzT5zwQBAF5KeTiME0KjXkUql6GwqL+OyPjdAFaMINiRJFxYX8Y1vfEN8luM4iYIh7Y8Xzw7aF7WmaRgdHYXOssvFpSURMARhiBov5bOIPpfNUjU+DniMPTRJS1QsakJgsRJhh8U/o0emmggfjGUV8UUgiEV6mOf7mLt6FbMzM935/9nnNJpNodmdzWaRzeWQjlEuN9h92sp58407kTimDUzpMdRyGAQgkoRMJtNCUhIvHXK2y7hVqlVYloV8sYiZmZlNaYe37ekz3taRdB2ObSMIApEE2I4jgKERWDDAKmz8WVtYWNjUdyRttJyuut0K+TyKxSJkSUK9XsdqqSR+ZzsOzSbZ8VOmiVw2K47X8sx3Wae8186rC+IUY69pabslfkp3ixOaxX1HP9Wy27duodFHEsErqgSAoWl0PDubhaaqILIMn1V2RNuVv52eYOJH98IayW0VgYgB/+JS5ZkYk2UYUTK2dlySeH8YYnV1FbKiYHrHDoxsol3yadpnMhiQJAnFYhGKYSAIQ9RrNcHlz/8tyvGsVeD7PqrVKv7lv/yXqNVqYrbTtm1861vf6jhG+xem6Tok1mtuN0VRMMJnWqMIi2x2nve4IgCZTAaZdLolm+QkH5ttunxRI4oE73Xc+l7ECQ9hhGiDJzu+OPp4YOfm5uCHIQ4dOtT9RRGd4eeZfzp2D1RNQzaTgc4Wtuu6QhNgs7HBiAOQ2oIBEcjFfmbHonpZUZDJZARICthwHN0EsCzLwtrqqhCn2Uz4aNueXjNNE7mBARBFQdOyaEDAgGi24whq3RCMzIZVFauVCn7n61/vy3e0rx3TNGE1m4mBfC6XEziCRqOB5ZUVWg1g56EoCnK5HHRd7wgABDiw21ollKufgI4698qgeUVxK8Y34Paxws1ai67n4erVq5idne2eJUfULzUYBbKsKBvVW0lCKpVChk1YAXR+nydqm7Up+HRTy/UyPxJ/Fwdo8kqiYZpIpVKd/qZLAhEGAVZWV+F4HgoDA9i9e/dTQS7UzZ7eM9vEFEXByMQEFDZ612g2qTCELIuWgee64t+NRgO/8zu/g9WVFRiGgX/8j/8xnmPKWN/73vewvr7eeZBY6U9hc6S815Z4Piwg8FwXd+/dE+x42UwGWg+g3KYPCNkQ4LBtG0Ec1AO0BhM9FkHSYuc6BkArx8BmbqHRbOLmzZvYt3dvT1QvnxuOAKRNs7MKw9C4XHY0YJH+ZoyNIoNj5yxGBmOvEWhnHtUzZLm438wBcHRx+73jrISltTUEUYSJyUns3r17kzuzbU+7ZbNZ5IaGhNhUEATCyXP8EUIqPwuGAv/617+O5S36Dv40ZRmA0epS+cpmsxhk+JO19XUsrazAZ1WLTBd2Ol5ZJEk+IGaarotpAX78lspAH/ermyWNFfbzeXNzc4gAHDp4sOtrIlZNjMD687wVEzNFUZDNZAQ9vd1swrasTYORoP28WSUxfu6+79PJqiAAJAnpTEZUA1so3ru0HPi0Sq1Wg6ZpOHrsWFeV26fFPrPBAEAfhuGJCSi8h9RsQtd1aKxk32g24XseJFnGf/rP/xn35+cRRBH+/q/9GmZmZvBLv/RLIITA8zz8H3/yJ90PxBZ2vlDoGgwAdGPKxyLdarWKiDFTbWabReWarkNmPTk+f5vYVkgom4vfJbwj7JJh91rUEYALFy5A13Xs27u36+tc1xUOyIz155NM03XKE84qIPW2Hm678ayEdCnRteMDDIaJiBM2cdxBUsbEdQrqjQbsZhPZbBYnnnmmJ1Bs2z47li8WkSkWQUCfU9d1xZir7/uo1WpQVBVhFOEP/uAPcO3mTYCQLfkOPs2TZZWEXr4jxdD1YRDAsW00ms3N/UY72r+LiVaIbYtWXTfbSnCQyDGwiR+r1mq4xZKIboJkvDTPeQrS6XRXbBWRJGRSKcq2KElwmMhbN4vYeXNsQDvoD6D4gAYPCBVFkL5tXCKh+hWswtBunu+jUa+jWq2CEIKdu3ZhYmKi5315GuwzHQwANNsbGBmBxr6sBhtb41Fc07LwJ3/yJ7hx/ToMw8Df+Tt/B4ePHkUYRZiensbJkycBAG++9RaWl5e7HoeDd6q1WtfX2I4Dx3Eoi14uB1PXsV6pYGV1tS9tgk3BhGxRu67bgl1ofxy7ousTfiOqAu3CIT0qDA8fPsTCo0c4duxYi0Rn3HyG2gahrGn99NgVRq3Me3B13jJIMF6WUxRFIHm5teMD2qN6whc/ywbaF3TEKgqe76NWr8NMp3H0xImnFvizbY9n+eFhZAsFEEmCzyimOf4oCEPYloVvfetbuH79Okxdx//tV34FR1iPuy/fwZ6xDMtea12CAY514uPT2XSacu0vLgpZ725GCGMg7bFeFVWFqmmQJanj8+Lv6oWwTzLRJuizohgB+Oijj5DOZLCnRxLRjGE3egUCGwclMAwDKQbIdhjhWeI58MkyUN/RDhhuNJut+IBYW5P7CV4ZSPJNnuui0WjAYpiUkbExHDl27KluD3D7XKQ5Ri6HXBCgur4uOPINw0DKNPGnf/qnOMMewFOnT+OVl1/e4BQPQ/y1r3wFH374IcIwxP/+x3+M//Hv/b2ux8nlcnAY4YfeluXy+XkuQFEsFgXLIFfCG9pEs5pErSxX7cYJhvioUTdeA172vrh6CW8vvg3HdwBECKLOgOQP5/4TslIWAQkQqCGODB7Gz+zoZGCMX+f58+cxPjGBycnJxNfwXlvEpho21RjnozwRFVxKp9O0MsAyhEwm0+FkOL+5FK8MRBFs2xZkSDKjCZY48yALGsIwbHlP3PwggNVo0MpAvQ5dVbFz1y7MzMz0voZt+8yZJEnIDg5CiiJUazUETAXPNE04rovvfuc7uHTxIlRVxc///M/j9ddfb0GKf6Uf38HK+bl8nhJ8tRnPgj3WShsaGkIURVhdXYXDJLuLjKK757WwknW3zDxlmqgwAqAW3FHbe/odCwQ6y+2bgY5v3byJtfV1vPalL3WtenB8URiGHRirJIufr8bGqy3bhuM4ggY6bj5TahRiU/znvg+LKTkCtJIoEhj+nbfd4poXEwAANVJJREFUm3Zac4clg4goY2ShWMSRY8eeyjHCJPtcBAMAYOTziJgjtxg5x9kzZ/DtP/szGIaBw4cP4/SpU7BtWwCACICpqSk8++yzeP+DD/Duu+/ir/78z3cVy8jn8yCEoF6rQYvNmAdBQAE/UQSNEfPw12uahtVSCa7rYnFpqaeOOdB9rI2baZp0RDEMYTtOhwwvQB3DxbUr+Mfv/L8QJQQAcbuwehEGDDTZfz948AO4gYNfmP355NdfuIAwCHDixInE33P+bUIoWyKniu5pbYtMkmVkeEAQhrBtuyWgiMAwA7yvCwhCJt4v5ARJonfLAoD2kiCv2EQMnOk6DiRAOKTRiQns3b9/uz3wOTVZVWEUCogYzigIQzSaTZz56CN857vfhaaqeO655/Dyyy8jCEMBlosATExM4NnnnsOH/fiOXC4xGLBtWwQCmZic7ujoKEqlEprNJtYZ8djw4GD3DJNVCOKBbsuvJQkpw0CTZb7xa3kci1OY83PuFUg0mk1cunwZu3ftwuBQ54gzwDZxJjiUSqU2XXNJx9N1XSQFXO5ein1nURRRngCu0xCGVAaeB0iMP4AfO04g1H793IIgoCOOQQCJENQbDaRSKezcsydxbPJptae/dtGnSZIEI5+HweQ1b964gf/jv/wXGIaB3bt342d/9mcRhSHK6+sb8/osahf9P9/HH/3RH3WNbvlISbVWayld8YhSliSk2qhpTdPE2OgodIZrWFpaSnQKceMVguRfEhFpeowUJel8L65e2DQQAAAZdFEE2OglXipdTnzt4tIS5ufncfTYscSAhoP/wPpxQjv+MUySZXEvXUbbzEt6AeslirFENscbMZpSM5Wi94iQlqmDjrvE7hsfT3JZcCUrCkUADw5idteu7fbA59w004SezQrU/rVr1/BfvvlNyLKMnbt24af+0l+C4zgor6+L4JGD937xF38RAOD6Pv7of/vfuvqOXC630SZgm5gfBGLsuH3zI4QqdxYLBciSBMe2sbC0BK9ttFm8nv3ZazpJ03UoqgpCCGxGc570Of2sWHEfYu3FJL4DgG7CZz76CIau48jhw4mvaVoWXNsGoogqp/ZiJk3I0uNmGAa9TtYW4dNFhBAxKsoZXfm6B6iSZZbhA8KoVd4+6fp50MFbkhKrboIQjE9OYnZ29jPRHuD2uUp3ZFWFkcshKpfx/PPP48jRoxRJzh4E13XhBwEq5TLSTOhCkiRMTU3hP/6H/yAeLjGHitaxHT4ZEO/9OY4jym7dNj9VVTE2NobVUglWs4n1SgWu52GQjRR1GOsBdmsZKEyNzHFdOLadyI1/oHgg4Z0J9ywhGDgy2Llgfd/H2TNnMDw8nFgy5xsq36Q5oUvXcIQQka13M0VVoWsaHCaGlM3lWvTSOZ0sd35cqEXgABJQvi3nzMYe+Qy4JMtIGQaq1Sp0XcfE1NRnAvizbR/fjGwWoe8jRQieP3kSBw8eRMDoeX3Po4JcDNRnplKUOZQQTE9N4T/EfEcQUR0RDh7klsvlaAvKsmCmUiAAmo0GAsY/0o2aNpvLQdU0lEol+L6PRwsLGB4a6ll6lhjnStLaSqVSqFarQrkwMSDoo1UQxxoJ64KLunv3LlZWV/HSSy8lYoyazaZYgyYrz3cFOsbwPr0szdoiYRTBc12hicJ1E2xWzgcAwqjtVU1rwRQkJhDMPN5WYAGDytgXV0sljExMYHrHjs9Me4DbZyds6dMUXYeezYoMOpvNioiNaxe4TAyoxnWwYyYWQrRB6xvvE+bz+Q1UMAswABqN9upvEUIwPDSEfD4PmRA0m82OSL99frU9GImbGKMEEsEyzwwd7yMgIJDYI+CzYKCgF/DfTf93Ha+8eOkSXN/Hs88+2/E7n6FnCaGqinx8rydBUo/+ZtwMw4DMvhNO6eqzloDrui04A16tIEBHO6DdXM9DlUkpA5RUKstaE34YYnxqCtPT09vtgS+QGfk8JEWBrCgUAGwYlHGOja5xsa5mo9E5/sqeNf7shex/vgZ4dYn7Dp/RhBNCOqqJHedlGJTYjG1oyysrKFcqicff+Gfysy9JkkiCOPHS41g7eLBbVcCybVy8eBHT09MdJXOOl3BZm8Rs69N/HCO8SksIbLbGeV+ftx8jQinhM+k0xXKx5KEXYRHYlBGfduCJj6aqKJVKGBgawujo6GeqPcDtcxcMAICWSkHPZCjaXFWRZ+U/VVGgSBJV4/M8IUPJFzZfQJIktRB68GAgCEOkMxmUy2UgilrEPTj152YPcT6fx/DwMBRZhu95eLiwgEr7wuZGSNeWAZEkGHxkKKa9vvFWgl8+8Ms9z0VhVQFKsULP+xd3fQWG3Ir8X11dxZ07d3D40KGOaNfzPDqG0xYIdLUtlM0IISCSBI2RLnFZ5AqjdpbY1Eg6nRYZB4/quznDkOE74jrkmUwGqVQKtWoVrudhYnoaO3bs2G4PfMFMkiSYxSKILFNuj1QK2VxOPGeSosBxXZpteh6q1apg9mshAIoFvDyh0A0DkiyjUi4DoJNHURhCZzwAm5miKBgdHaUqg5KESqWCpeXlFmbBuPEpA5Lgj7g8OmFJSbt1m+DhFbeIEAq0I0TcKxJFHVl0BODs2bOQZRnHjx9v/R3bVHmbM51KdZ84ilf4+mk7sterqiomLWzbRq1WE4kTpxTm7K7cRDW2/TgR1cCp1mqw2Wi3zsahJUKwurqK/MAAxiYmsHPnzs9Ue4DbZ++M+zQ9k4HGpSVZlSCfzwvdaZcFA1wyOL6wAXTM3QP0QRkaGoLjulhbX4fNykQaEzHq9r52M00TY2NjMHUdMoAyW9guA8+0HpRsjA+1X6OqCrplPoYXRhGCKIIfhnhm8DgOFLsTeyisS+SDBhI5LYe/Mvuz9JgMpe8HAT46cwYDjEErbq7nodFoICJU5Y23BhKN/3wLEb9ACauqmP3mjGCSJCGXzYrFHKcTTjoCDwJqtRqtKIRUhjjHxK2q1Sos28bk1BR27NiBoS4gp237fJskSUixcUOAbsL5XI6OBxJKiuX7vvAf/JkKYskE5/qIP5PcdywuL1MFRcdBwIIBoL9ePccRDAwMiJ734uIi1svlrkQ7Qo2xzUzTpMJrvi+UT7nv4NNI/GctVQ62ufqsnC6zCmDEzz/mO+bn57G4uIgTJ060ailEVAqc68ik0umONkm7lkK/Ew6cAyCKBQS262KtXKYsjOza02zcU7yPH7f9A1kQUKvXKV217wOEIJNOI2WaiMIQy6USsvk8xicnhTzxZ9E+t8EAQPuASkxrWlEUDA8NwWRfIkDHzxzHgcPmQ/nCjlt8gxsaGoKqKFhcXITDMAiqpm2w2KH7JEDcFEXB6NgYim0Lu6P8F/vM9oCAsDJXxKoU9Xq9pTQJQvB/3f/V7ufQFgz84q6/BkMxN64hinD27FnYti1mqrm5bJSSEDo+mEoIBMRd6KPHxw7a+hmxheh5HkLQAEQzDKRSqRYHslkloFariTaDrChIZzJ0LpkQ1Op1NCwLEzt2YIrxh2/bF9ckRUGqWNyQpiUEmUwGA4ODUDUNnudRyWsGAHRdF7VqVcgL88CXk9pwGx8fx+rqKgW1MarhKLb5Av2B9zKZDMbHx2EaBiQmdLSwvNx1tj4pS5VZxS0MQ9SZvG7cd/T0YdEGhXlLVYMDCaMI9VoN586dw/T0NCZjuBveGuCaC7zE3vrx7B5uBXzMAq4oDIEwRMjGRDkeIWSjyKZpUpGhGC4L2DwI4JwlumEgx6TXA9/HaqmEdCqF8akp7Ny586mTJd6Kfa6DAQBI5XJQDEOUvmRFQbFYRIZRQyqyLHrNTctC07JQrVQ2wCFt0b5ECMbGxrCwsACAjvHFSSmiKNpg9evDstlsx8JeXFrqWNjx8wDQQiMcr3a4bWXDE0PHcWTgSOKx4+DBjJbFX935V1t+f/vOHTyYn8dzzz1HJylY1O8wDneAtmHa+brZzdj4s99qAKHofz7uU63V0GAEJIosQ1cUKIoCVZZbRIaSLCkIUFQVuVyuRfq0zgLAiakpTE5NfSZ7fdv25E1SFKQHBlqy0kw6LYTGItCKla7rQtOAJxMcy8KNr43xsTFEUSQIinipHojhDPr0HZz+fHBwEIosI2Ay6mtra4nJhCAmYhs51z1QWGWxwaZx4tZtK47zCyQxnvq+j3fefRemaeKZZ55pqZbWGw0h+ZvJZLrzrvSbQHCLtXIblkUrvUzCWVUUij1iVRKFqbJ2mzBKCgIM06SKuUwjIgxDlNbWYKRSmNixA7t27eo5Mv5ZsM99MAAAqUIBKouCo4iOrmiqSjcWtplxkiKeYVeqVZTLZSEYwo2wYGCdERwloWN5qToeHISxP+OARGBjYQ8MDEBRFPhdFjaf7Y04+Ij9PD7P32wHBRGCr+7/vyTel3hl4Cu7/hpMZQPItL6+jgvnz2PX7t2YmpriJ4AmU/AihNB+fVIgwI7bFcQXDxTa7hOXNG5alrhGQ9dpi0fXhQx0N60HznzYHgRks1lk2LQHf+itZhOVahUT09OYmJzcnhzYthaTFQWpwUGxlrlAjiTLkFm1QNd1pJjmRrPZpL6jUkGVgZPjrYIUCyaWl5fprHtSObndd/TwGwBl6BsfH0eakWvV63U8WlhAk/W1uXHfwZn9+Jo1WBISRVHHe7pl5oKGWJbpJhwPIlg10bIsvPDCC6Jkztt8XO63vUzP3yvAv0mBQJu/iP898H00mk1UeTAGWrVIp1LIZTIAwznIsgyZMQ+2fHQYwmW+pyUIMAzkczkYui4ozMMwRKlUgqrrGJucxM6dOz/zgQDwORst7GWpYhGN9XV4lkX7gqYpMulsPo+crsN1HMiKAs91BQGNbduCSMgwTciShLGxMQoaKZWwg2+UPUxE/+zfQtwCACQJEts00+k0dF2nZCOWhTrbFAcGBmCaJo3I2SKQyMbYXhRR1sPA9ykvdqOBbExm8/jQMRwbPIYLpQvinCRIgp7YVAz8/OxfEb9zXRfvvvsuCsUijh07Rs85DGmfjwMmTZOim0HHqTjwJu4+ovh4Ey+Fsj8lQtW+eETP77mQUwYdFdQ0TTirMAzpdAerFHALOfbD80T5EqBBgMFmqxExVULmWGv1uqgIjE9MbAQ827ZtMVNYhaDBAnNN02CwaoDrumKKxbZtKIoCl9EaO0wSWdd10dIihGB8bAy379zB7t27+yL9iY8o8t48YhVLgGboQ4ODMAwD6+vrCIIAKysrSKdSVLKZ0SvH12a80phOpVCt1wV+gG9sYpNvCwqCMIQKKt7W/jteTXz++eeFMI/jurAsC5yILMWYBfnmGjupjUCFtQzjrdc4OJgrm4aMUTFOz64wwCevOgRhiND34YchUvEkgrVXXc+jU108cJMkSqFuGILUjdOf+76PtbU1KKqK8akp7Nq16zM3QtjNvjDBAACki0XYsgy7Xqcz7EzX3Go2aZRvGNA0Da7rij8dJqtrWZaoIqTTaRSKRayVStixYweAzo0wyVpQqzEKz5D+hf6bELr52zZd2L6PxcVF6IaBQi4nnArQ2QtMpVKoscmIpmUhnU7zA+Or+7+KC29vBAPxqsB/v/sXkFbT4nzef/99hGGI06dPg89ZNyyLkgnJMlKpFKVCZhusRIioRsQ3/JCRAHGLoqiFujQMQ3ieB6c9CGCVG/5aXorks8e8ReAxgZmWSQpCoDEu9pYSJAN/BUGAtfV1RGGIyZkZjI6ObgcC29bTFE1DemgI1vo6fM9DitEVcz+hMllswzAEJS1PNLj/MHSd9vonJnD9xg3UajUUikUAEGC3zYwDEXlQ2xIksIRgdHQU5XIZDda2qDebyKRSyOVylCCIfxgH/kVU1jttmoKdUOFtuE0qA1w4jWfpLdXE6WlaSbRteI4jwHypGHpfTGrRiwC7GFG9aGm10DeI6w18H67jwI2tfUVRaPDfLioEOsoZsdeEQUADANdtqbzKsgyV7QvCP/NrBpMyX19HvlDA0Ogodu7cKdhsPw/2hQoGAKpjoGgaGuUyTMOA47piooBvtLquU3BNEAitA65J4LDxklwuh/v374tMdAtQl86FH1tQEiEICaEzt5qGtfV1Mc6ywHjTc7mc0EbgToH/mUqlaKnM8yBbllAGOzJwCMcHT+Ds6llEUQgZEkLQ0ud/v/MXxKnMXb2K5aUlvPzKKzBNE7ZtU/wC2SAT4qQm8TEqWZIE77e4rFggQBggiAcAnufBiy1kid/3eLATywzCMKSz2QzNXa1WW5yFrCjQNI1OdiRkXBHoGOTKygrS2SxGxscxMTGxDRbctr5MURSkBwdhV6twmVw6TxKUbBaIIsiMNZNThnMNEY8FBM1mE6qqQpZllEolSl0c66f3k1CAv4Zt7IIgjWOaJElUEldLJfiui0q1imq9jlw6jWw2K3RAgA0CL1XToAYBXMdBvdmkCqKst87HCcH+HjI20LgfcB0H7777LvLFIo4ePYowCOiEk+8jIgQmIwRD2+bPA5x20DY/Fq8KRoDYxF1Gx85NZZotIghgrUD+Ck4tHjLAZxDzO4QQkTgospw4feF5HspsGmF0YgJDjHjt89AaiNsXLhgAAMUwkB0eRrNcRsp1UW80hGRoHB0rKwoMBjD0fZ8CDBlJRso0EQYB7t69ix2MbSqpB7YZIrZ9fjbefyOyjHyhgFQ6jQoDNdq2DYuxDhbYHDwHzkjMGaRME02m0SBJEs2QCcFX9/9NnF05C4BAjhQAEZ4fPYmUkganSr5y9SoOHTqE4eFhMcYHQFRFes37KrLcgVfgDstnARfnYRf3mJXkOEOYQAXz/1kpz7Zt1FmQk2YcEpIkQWUBgMQcV9JoYQRgrVxGo1bD0OgohkZGMDMz87kp723bT8b42KHCBHFs24bH/EKaP0vs+dXYBpNOp+G6Lur1uihnZ3M5LC4sYHVqSlQU4twm/Rh/LZ8waucG0HUdo6OjaDYaqFYqlHm1VkOt0UAumxWTDPH+u6nr8D2P9t/rdQEaBiCwARzHQC+V/i4IArz3/vvwfR+nnn8ePuNv4fdDkPqwfydejyQJ3ydwFozoyfc8OGyUM379qqJA52RvLAAQbQXQ4IEnDk3LgqYoIhBQWPLAfSMHWLZzDNi2jdLaGmRFwY6dOzE6NoaJiYnPJI/AZvaFDAYAJoYzOAhZ0+A9fAibodfzudzGwoz19VVVRV5Vkc1kRH9Q03UsLS8jl8uhXC5TcRzDoABFhjrt1wRpiSQB7KEPWKatqSqGh4bgOg7K1Spsy4JtWVhsNhFFVNQDUQTC+nCapoleWIO1QBRZxsHCAYykRrDYWIQCFRIkfPXA3wQAVCoVvP/++xgdHcWevXtRq9fp4mdVCqMPCWJ6qzbKjwHvxzGiFvEaFo1rLEtqX8g8+/fYnwDVHwijCCrrB2qaJoIvCdjIXFpuKm1xrK6sICQEUzMzGB4ZwdTU1Gd2FnjbPn3TTBOKqiKKIqytrYl+eDuTIM/WDZYVe4zSuFAoYHV1FctsHJBIEgxdh2malFk0/mz2kVAALChgOCJOuSsxkGMqnUajXke1WkUQhihXKmK0UYm14iJQQCJ/XdOykDLNRD/GJc+jKMKlS5ewvLyMl19+GbIso9FogID62HQqRfEBm7RCJEIoByq7Bo8lDvHqIcA2cUWBEmsj8gpiwKqHPtNs4X1+i4HAVfY9aJomNBV4stIeBBAAtUYDa2tryBeLGB4dxfT0NAqFwqbfxWfVvvAe0cxmMTY7i4V79+DaNsqVCvL5fGukHt/ImBCOaZqYnZ3F3NWrCMMQsizTB5gRGCmyDN0wRLlfYiM8QO9yIAfWhVGMH5sdX9N1jAwP06CgUqElfFaKDMMQxWJR9NNTpklL6wxQmMlkIEsS/t+v/mv8i3f+J1RXa/ilfb+EgdQAGo0GfvTjH8M0TRw7doxqDLBjc+GOzYy/ngN6bMdpWcgEtLrAN3EOIgSYchjf/D2vAzHNcQuyqqKYy4mMXuI9x4S2C0C530tra8hksxgeG8Pk5OQ2mdC2PRGTFAWF8XFAUVBaWqKjtlFEyXy6PI+qqiKfz+PQwYNYePSI0tcODAj5XMuyKOOmotAAnAnuyLHsv9eGSghjAoyD7yLKT5LNZpHOZFCv1ej4o++jUq+jadsgsoy0aYLIMmXkZLTcnufBYkFO+5rkFdTr16/j5s2bOHr0KFLpNGwWGPFKYvzcep03Z2rkLKPt1UOexfPxZp48BL4PhyUN7SysADb4ATRNqD7GqdLjkxUABBFThSVdY5OToi3wWeYQ6Me+8MEAQAFrE7t24eHt23AZbWWaIV4FV3XMeLVg586duHPnDkpra3jmxAlYzSbFFzgOjVAbDTQaDTHCqGsaVF2HTMjGiEvSAmeb6sY/N34fgQUFIyOwHQdLi4uwLAv1RgOO48BIpZBmqn2pVAoNJoZSZxMGWTWLXz/w/8Sbf/EX2JPbBdu28cMf/QiKJOGZEyeE8IaiKHSMapNyWMBKcTyb51G2x85fVRTak2NSonwiIGBUzgHr5bXfXz4DraiqYBxUWRWEZwLt0Xw8CKjWavA8D4MjIxhhUf12W2DbnqRJkoSB0VEQRUHp4UM0mk26mWsapQLusgHqhoHZmRlcvnoV2VwOuqqiaVmwbJuyEzJsEqnVoHIsDFtDMvs/aXoHQIswWAvoDgCJIuRyOWSyWZTLZbjLywh9H+ulEqqqinQqhTSb/U8z3+E6DggAs23tKIqCW7du4fKlS9i3fz+GR0YERbGYNNqkosEzeJ/5EGAD6BevHvIWIE9ugiAQ/7cHKZIkCb8hSxLW19fFdAFPQjr8Bvu3zxhVq7UaVE3D1M6dGBsbo9Njn8O2QLttBwPMVFXF5K5deHDnDjyGDUgzpKjMe9nxB4ihd6enp3Hr1i0cOXQI6UwG6UxGqGLZlgXbceiGGYv8ZUmCIsuQZJnyHbByucx+BtaXS1pK8QVuGAaGhobQYP1IEEKP2WyiLMtIMcpMy7YpoKdeRyad3kD+RxF+9KMfIfR9PPPccwJBzMua7cajd07jnLQYuViRLMt0dIrQSQOr2aQUpl1oUzk5iCBCiQGW6iyg0WNVhc4bQ2DxOWPHAZFlTExPY2p6+guzmLft07Hi4CBtGSwsoN5oIEcIraaRDRrxuO+QJQlT09O4cesWrs3N4eTJk9B0HQVQsBrHBvFpGS6mJUsSFVJibUtVVWlwwHyKrCjdaYn5ORACmRAU8nkAEL39IAhQrdVQqVZhGAYyfGSSTUcI0CG7joWFBZw/fx47ZmboNE4UQVFVmKaZqLUQMo4DHgAkCSTJsiwqqDLDH7muK0YDk9a9SBwYb0z82JxZNgQNZrr5DR4E1Jj8uplKYcfOnZicnPxC6ZNsBwMxU1UVEzMzWJifh8sAeKZpbvACtC1uTVUxOzODu3fv4tqNGzh29CjtlTEQHy/Vu65LFzfbQMMggON5iBwHTfZ6vqglSaJqhBFF+vMMQ5JlARAUozmgm6im68jmcpAZ6Qgn7KlVq6hWq1B1HWBiKc1mU0Tfly9fhue6eOa555AyTUErDGBjpp+NAPLsP76gODZAkiRKxMLOLQgCOF300sGvlwcMPAiKTx7QGwxEkZhRjghBJpttDcjYayzLopWA2AjTwaNHMTU9/bkv7W3b02EDQ0OIAKwvLqJeryObzYp1HDFMTLzKmE6nsXN2Ftdv3sThw4eFVoDKkoNcLkerBGyKyfc8+GFIuUTCUBB/yXzttYGfue+QWHWTl8fjv5eZSFcum6WjiIy617FtOKx9oCoKJAA2IBReK5UKbt68ibGxMezZswecUElT1Y3KXxBQrQO2kbdv/hzTQJgvkFji4DhOi5Jr3AgggqG472gv83OrNxrwPQ+aqrYkN7wtwVuotXodAAVvD42O4sixY59rbEA32w4G2kzXdYxOTmL50SM4bGY/lU4LQCEvg3NMQS6Xw9TUFO7du4cDBw5Aj4kW8deZhiEexniJnI80hqxc7vi+IMUJWMmNE5OQWCAg88BAluH5PjxGQZxiKmuZXA42Y0NzPA8O40wv12owdB3VSgVRFMGybRw9cgQKA/h4vo9yudzJGRD/H2gJWjgAMApD+CwrCWIIZe6oFBbwtDslbvExRbDjAkCtXqeqb5pGRV14/5SNCdXqdREEEEIwMDSEEydPfq7mf7fts2EDg4MIowjVlRVUqlVkMhk66hpbO7zCqGoaZmZmcOv2bVy/fh0nmKqfABKDZbyZDNLYmKoJgoCuecavEfAAgWFtAkbnLfwFWGDA/s65ARRFgcMozx1dh65pFOTIGDybjQY816UgYBYEcEbFmzduoDAwgF27diEIAsq+2GigxqYNEFv/PJngyZTMxvcUvonHqo0ARLugpcIYSxjaW6YSu6diEoCZyyosQRShEJ+KYMeo1+uoNxr0PMMQqqpi39Gj2LNv3xN8Ij5bth0MJJhpmhgeH0dpeRl2rYZapYJ0DEhHAMGeJcsyZmdnce/ePdy4fh2HDx9uWdBx44tRkWXwfDWMKItWO4K+adsbozysvB62PfCcoMNzXciyvCFHGnudRIgAGvqeh5XlZayurIAQgsLAAGUdY2C/eEbOS5zxAKQ9gwc2+Mn5Ji9JEoIoAnRdZCXt9wCx44i+Z0IVwWKEUH4YYiCbRRRt0CFzURjCnEw6k8HU9DR279+/PSmwbZ+KEUIwODgIAKivraHRaMBT1Q0Rr9hGGYIKDk1PTeHe/fvYu3evGE9s9x+8ssABuEaMI4D323lAwFkEeeISRBEihuVpOVfQsbkwDOG4bgcbIiEEYDz/HmNVXGfyy4qqojhAgcfxAJ37DwI6Fs39h6ppomoYP74kSaJCwYN5mbUJ436G+4h4i1RMerG/x+8XQJVg/SBomeSwGC7DdV1xfaqqIj80hIOHD2PgCw4u3vaaXSyVSkGdnERpdRVNxjVumibVNY+DcgAMFIuYmpzE9evXMTo6iqGhoWTQISD0xeNzwhIDGHKQTxBFSLPSYMjme3l0zUF6IfvTZXPB9EM3GMr4cVRFgZxOQ1UU1Op11KtVWo6UJOisshDU61A1DQbLvk3TpOfDNto4oYnEy4+srMfBfCSG6vc8DxGnKo2jduM3JGEBi1+BVlBKa2tUbESSBBaAU5JG0QYbYnFgADt27sTQNoHQtn3KJkkShoaGYBgG1lZX4dZqqFaryDBAMgCxLmRZxq7duzF//z7OnD2LF0+fFuDAuLX4jNgmKEkSNEmCznwHAMHJwf1GEOMGCFklgZfyOYkXWLk+PoUgA5ANg1YQHAfNRgOOZUGTZeSyWUSsVeH6vijD842Xk36J1ghPKuIbP694iosklDKZ+w12rS2vif2sm0UAlSNnGC1VVbG4tATf80QwwgOrbCaDsYkJ7JidhfY5IxB6HCNRT63KbQvDkAqPrK/DrdehyDLMVIrqeGPjQW1YFt56801EAF55+WUxYhTv72/FAla2T3z4Yxusz8ZgEEWdfa4oEhzqlmXhwvnz8IMAe/bsQRhF0DVNKALyRcgBSJqqQjcMgcJVWK9uM4tYn/9xjGc6jm1jZXUVNdbzy+fzghREkmU6j22a0A0DxYEBTO/c2V39bNu27VMyx3EoD0GlAt9xkGLJRNwi0PG88+fP4+DBg9i7b99GsI2t+w2ATvIkAfQ2DkorE416nU4gxdqYvCro+z4cBn6+f/8+7t65g4GBAQwMDCCVTouKJgf7coIwSZaplouuU3C0pm3oiLCEods1eTw42YIJkqFoQ21wifE3cO4Gfjxd0+hYeCoFXdMwMT2NoW2VUmHbwUCf1mw2sba2BqdeR+S6MEyTklfEXrO4uIgf/uhHmJicxLGjRynxEBj3OMuouW22yHl27Pda1AAQRSiz8l2hUACRZQSeR0v/THxjvVzGxUuXYOo6jh0/TvuDjGqYZwcyY+dyHIf27RjIRjweDL+gsNEmhbU7VI7k5bgDBpDsZRwvIdoirrtR7gypDjmfwijkcjAYX0PKNKExZyorCqZmZzHAyrLbtm1Po4VhiHK5jHqlArtWg8qC2TjYL4wivPvOO3j46BFeePFFDA0NtQTeojrX5zGDMKSjvZu4di6mpBkG0gxtzwGEQRgCYYirc3NYWlrC7t27sWN6GpIsC4VGfixZlqkOg+NQmuDYJBA/f94eFSPDXI48NnLsdkt+YvfJi40juqx6yjEHPpuICH0fiqIgG/MdJmcqBJDN57erAQm2HQxswXzfx/r6Opr1OtxGAyQMhbIeX7yXLl/G1atXcfTYMYyNjsJMpTr75Cw4EOM+/NdtxwuCAAGLwHn03cKdzTbsWrWKwPeh6TrdkBnT2fyDB5i7ehVXrlzB+vo6PM9DLpvF8ePH8bd/5VcA0OzA830gDGnEzKiXbcvCH/3RH+Hq3Bz27d2Ln/mZn2k5JhBj+4tXKtrHDWP4BT4bjZjDILHPCcMQFtOBIBJVYhsYGmpRKOQgwfHp6e1qwLZ9ZqzRaKBcLsOp1+HbNuUPYNkzQDfmP//+9wFC8Nyzz9JphNiILQCxliQeGHSpOnLZY55ICN/B38PWp8eo2LkeC592ajabuHf3Lj788EPMP3iAWq0GgFYLDx45gv/H3/k78D0PdTaWKJQIJUmMVH/jG9/A3Nwc9uzZs+E70MoQGk80Ajax1AIQbN+awhAh2ZAgj5vnukJuXtV1TIyPt9Kng4LDx6amvvDYgG62jRnYgimKQuf6TRONVAp2vQ6HKX1xadPDhw+jVCphbm4O2UwGYRQhzR/KWKQshEJiD3wcgAO2gCVCQBRFkAHFI+dv/PEf49t/9mf4zd/8TRoB+z5l6QLwz//5P4fDSEz4guBZtei7A0hnMpSbwLYp+jYIkEqlkGFBw/d/8AOsr6/jb/3tvw0AG2AlBnQUBCCccIiNLXKLkypxhxQRspElsPlgDmiSGcNjLpsVEqj8nhWHhjA2OdlRat22bXvaLZ1OQ9M01DmZD1MVtBgVsabrOH3qFN586y3cvXsXs7OzSLNphLjxSmNc6VT8jrclmX9RZFkIAMXBdlEU4U++8Q1893vfw6/92q8hm82KtSnLMn7rt34LDptQ4u/LM14CMD+kqipy2SzqbNqnzojaeMvh6LFj+P73v4/S2hq++su/DIkQik9ivsLzPDEJ4fv+xhQCP0f2Z0ublRDI2OAV4CRMXLtAYtWGwcFBqqrK7pVhGBidmMDA8PCmREhfZNsOBrZohFC+73Q6DTuXQ6PRQKNSgWtZcGo1aIqCE8eP46233sLFixdx5MgRusEyUJ74nLY/hcUWAkDLcELxj2XdnuvC832EoNEuBxVJDM9Qr9fRYFE7IQSDQ0MYHx/H3Tt3AMSUztjvOb7Bsiy4nge/WoVpmjh69Ch0TYNj27h69SpOnDhB1RJjAB9OCeozPvQglo10s/hscBRFQnzJcRwaoKRSYjSQSBKKg4MYm5gQCozbtm2fRVNVFcViETnmN+q1GizGC2LbNlLpNPbv34+5uTlomoaJiQl4mtaR4QJd2ozxth426Is5Rz8fE/QZX4jMqoycM0VRFNy+fbslEBgcGsL4xAQe3L/fKjUMuo6z2SwajQb8IEC90aBcJakUbZOqKhzbFqOTBiAqE5xUzfE8hIyTgOOVuvkODkDkxsXjeCVTU1Vks1mojJjMMAyMjo+jODS0TTrWh20HA49pfBPlksL1eh3V9XX4bLb1+DPP4MK5c/joo49w4MABuJkMDNNEho8Z9TA+Thgwud+AiW74LAuPR/l+EFDmL4ZWvnr1Km4xrvAXX3wRx44dQy6Xw8rKCn77t39bsIDxTCAMQ0CSqPoXmxcOwhC1ep2WBQ8exLlz53DmzBkxC82DgJDPNIMqFoZdOAS6GZ9p5m0NSZZhaBoy2SzNPIrF7SBg2z53JssypQXOZGBZFmqVChq1GizHwcTEBOxmE7du3UKtWsWu3bthOw6ymUxfBFqcJdTjFOGM7jvwfQRRtKHOF0VwHIeKq5km6rUazp8/j3qjgRdfegmnT53Cnj17kM/n8fDhQ3zta1+Dx6ebsNHeI5JEq4ts3Nf1PLjlMkzTxIFDh1p8B6+Ihux/hCEUSUIkUXVCJDAXdrtGfjyHYRz4FJSZSsEwDIyMjW0HAVu07WDgCZimaRgYGEAul4NlWWjW69BMEyeffx7nz5/HxYsXsXv3buRyOVQqlRbJ3nhYIBYLJ+9g6P6QldAAtABxAKBeq9ExplIJ165fR+D7OHbsGL7yla+0jO94nkd7c7xtEOvlg0XkCov0OS+B63k4fvw45ubmcObMGfzKr/yKcAJhGFJ0PztGxCL7eAukmwV8LIlpODi2Dd0woKoqhpmWQH5gYJsvYNs+1yZJEtLpNFKpFJyBAUr2U6thz4EDMFIpXL16FbZtY+euXWgyjRM9BoQT1UWWXAQxuu+41DB/jcroz7kqYpNJnF+/fh2PHj7EwMAAvvxTP4U8p+BlQQP3HYIZMGrlOyEATLZ+rWZTyDqfOHECly5eFL4jiiURAIR/ijiGaLOxQXYulm1TUSPLAgiBmU4jk05jbGICgyMjgkZ+27Zm2972CZqiKMjyXvf4OFzXxeiOHXjre9/DzRs3MD0zg+GhIVgsqtV4UJDwWYKtS9NA2Ewyp/1tBw5duHAB9Xodg4ODeP7555FmlMLsg8DlhAF0SIImHdc0TaiaBqvZxD7mmHzPw9zcHPbu2SMWMdorHPy82jACwEawYNk2PMdBCMoSFoUh0tksBoeHMbtrl6BD3rZt+6IYIUT02gcGBhCGISZmZzEwMoK3f/QjXL92DbM7d8IwDLi1mlBE7Tbqy9lBhcIfYwAFf32sJP/Bhx9C13UcPHQIB/bv31jb9IMoBTkL/LvRBHNTZBmZTIZSiDeb2L9/v0gurl+7ht2Muri9MipwRfFEIpYo8daozYKAIAzhOg5VRsxmMbVjB0bHx7eTh49p23fvEzRN0zA6Po6//tWv4jv/9b/iwrlzWFlZwfT0NIaHh0XJTtN1Ic8JQFB2cuPaCNx818X8/Dzu3L0LAKjX6zh69ChGhodbSolxgh7ey+fUxYkWi84lxluuqirGxsbw8MEDnD9/HsPDw9B0nfIPxMp6QUJUzxez7/ti9IjzEERhiGyhgIGhIQyNjKBYLG6De7Zt28AqBpkMjp88iYmZGfz//vN/xpnz57FjagpTk5MwUykEQUBJh5h4FxDrqceCca4kyK1cLuPu7du4efMmAKBYKODYsWNIJ7Uv2ew+AIEz6GZxgjIuKCYrCiYmJnD/wQOcPXcOI6Oj1Heo6kZVoL3KEJ8mCEO4jE6djw56rgtVUTAyPo7C0BDGxsa2AcVPyLaDgZ+ASZKEn/m5n8OhI0fwzo9/jA/Pn0c+ncbMjh2YnJigfTbXpTLHut6xKCVC4LguKpUK7t+7h/n5eQSMSpMQgtdefRWpdFroHCAWWICQjQXNELzti5oHDUBr4BEBUDUNhw4exK1btzB39Sp++qd/Gp7jwHUcyKzsyBnM4tzhIeMS4LwFQRDAZVLEhcFBDA4NIZ3NIpPJbEsLb9u2dbHh4WH833/1V3H27Fm8/957uHP/PsZHRjA9PY3BwUHYti2CAi0O7sUGQLjZbGJpeRl3bt/G+vo6DNPEwOAgCCF45plnoKrqBvCXvZf7CJfhi2zHEcC/+Ghz3Lg2CT9uOp3GgYMHcfvOHVy7dg0//dM/DbvZhAU62RSnIZZiiYXP/CGnHPeCAL7nwTAMTOzYgcLgINVhyWa3qwFP0Lbv5E/QduzYgR07dmBtbQ3vvvsuLp4/j7nr15FJp2EaBkzG+Me5CSzbRr1Wo0qEzSbCKIJpmti3bx9mZ2fx7W9/Gx988AG48IjrunA9D4ZpimNGYQjbshBhAzcAdM7wtiOF43by5En873/8x7hx4wZsx0Eum4XreVSq2bapE2DYBs5M5jJRk4CNOHFQz8DQEFKZDDKZTKJM8rZt27a1mq7reOGFF3Dq1ClcvXoV77z9Nt776COYuo6UYSBlmjAMQzDsOY6DpmUJ3+EwefPR0VG8+OKLGBsdxZ/8yZ/g/9/e/fQ0sYVhAH86nT90ppTSQrHYsjEurLmLsrxiIhtJXMhXcO/ibq4bP4dLF/oR1ERjRHQhl7urGBOFuLgCgn9qS6l22g5t72LOGacEFIwIZZ5f0oQUQrvp22fOOfO+gHuhEVYUd+ndcWDo+rcgIC4uQuKskX/Fwf2hu16ERb8Af0iQtWNpaQm1Wg2x/n7vCr8haoW8AOmIA9P+XiWaOBydHBtDPJGAaZqw/K2d6ZdhGDgEiUQCly5dwuTkJF69eoVSqYRyuYxSqYQvHz6gbtvQFAUDsZjbPzudxoCYRpiIx7v39QRd02CHQt5ymtxPlF/aId8Kwfd4PQ58H/RMJoPhVAqfPn7Ei4UFTE1NwWy33Q5mopdBU3Qf0wwDeiSCSCyGiGnCElf+cv66ZVlsFkT0ExRFwdmzZ5HL5bC6uorl5WWUy2WUP3/GarGImpyyahiIicCdGhlBPBZDbHDQG4S0na7r3gAf/zajLaYayrkpeyGDhVwh9NeOly9fYmpqypufYNu2N55ZCYWgRiIwTRO6YcC0LK9vQVhcTJimybsDDhDDwCGKRCIYHx/veq7T6bhNSZpNd8Rxo+H2MBAH7zY2N6GKCYJtcZq/LToaqprmJu56HaZpelfugLvcv9cPtL+7mQwF+XweMzMzKDx/jomJCa+3QFhVkRgehmlZ0HxzDEzThGEYO046JKKfFwqFkM1mkc1mu57f2tpCtVp1JxE2GmjW6+7Dtt3tOsfxpo/6twZ1XYctphO2220oioKGWBVQFGXf4V0Rc1vkysF4Po+Zx4/xvFDAn+fOoSVeJxKNImlZ6DNNqJrmbjvqujch1t+PhA4ew8ARI5saSXLfvSEGDskv+1qlAnQ6sKJRVKtVd99PfPnLRhxyr15RFLeF57b+AP5uX/Igj5yQKPsctDsdtB0HZ3I5/Ds/j9WVFdiNBkbSaehiPoMhDhQahsEvfqJDoqoqBgcHAcDrI+CvHVvNJmpiol8bQL+41VnVNNTFl7+ztYVIXx/set27ZVDOKJEP2dXQO1vk/51Y4m/5JiSeyeXwz/w8/nv7FlAUpMbGYIhD04aYdMjVwsPHMHDEyeX1aDQKOcLYcRw0UilU79/HwuvXsBIJxFMptFotbFYqqNs2qrWaNzDIMk3YzSasaNTdI1RVbFQq3wagiNt6vDGj4bB7wEecCA6rKhLpNP6+fh2Neh0bX79ifGwMmkjzRHS0+G9XBNwLAMdx4KRSaDQa+PLwIRYWFxEdGkJ/Mom+ZhOVjQ1sOQ4q1So67TZUVYXTbuNrrYb+aNQ7m1QRtUOOMZdzVsKqirC4k0Dx1Y7h0VH8de0amo6Dj6US/hCHFnnVf7QwDPSQUCjkhQN5An9tbQ1Dw8NInzyJVquF1IkTKJfL3vaA3K/Hu3d4sbjoLjGePo3MqVNdYcD/kEuJ/seTJ0+wvr4OXddx/vx5Hv4j6iGKonird3LlcW1tDYlkEqOZDFqtFoZGRlAul9ESo4nl33U0DS+WlgDgu7VDbglurx2zs7P4VCxC13VMTEzsqZMi/X4MA8dAOBzuutfWP+BHsm0b79+/B+CeEk6n0/tK5nfv3gUATE5O7vj/iai3dDodqKrqBXvLspDcYSS4bdtYX18H4NaO0dHRfb0Oa0dv4AZvQO13ie7evXsAgMuXLx/E2yGiY4q1ozcwDNAPFQoFLC8vA+AHmoj2jrWjdzAM0A/duXMHgHt7YSaTOeR3Q0S9grWjd/DMwDH17Nkzr/84ABSLRe/nN2/e4NatW11/f+XKlV3/l9zzm56e/qXvkYiOHtaOYGIYOKZu3ryJ27dv7/i7ubk5zM3NdT232wd6ZWUFhUIBAJf5iIKAtSOYGAZ62IULFwAA8Xj8wF5DJvtsNot8Pn9gr0NEvw9rB20X6myfWEPkc/HiRTx69AhXr17FjRs3DvvtEFGPYO3oLTxASLva3NzE06dPAXCZj4j2jrWj9zAM0K4ePHgAx3EQi8W8ZUUioh9h7eg9PDNAu5qdncXAwACmp6fZQpSI9oy1o/fwzAAREVHAcZuAiIgo4BgGiIiIAo5hgIiIKOAYBoiIiAKOYYCIiCjgGAaIiIgCjmGAiIgo4BgGiIiIAo5hgIiIKOAYBoiIiAKOYYCIiCjgGAaIiIgCjmGAiIgo4BgGiIiIAo5hgIiIKOAYBoiIiAKOYYCIiCjg/gc9j1DX1NuZrgAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "cudaq.show(blochSphereList[:2], nrows=1, ncols=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can show them in a column too, if we want! Simply set the `nrows = 2` and `ncols = 1`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:23.967536Z",
+     "iopub.status.busy": "2024-10-01T18:34:23.967314Z",
+     "iopub.status.idle": "2024-10-01T18:34:24.278068Z",
+     "shell.execute_reply": "2024-10-01T18:34:24.277497Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "cudaq.show(blochSphereList[:2], nrows=2, ncols=1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Can we show the entire list of 4 Bloch spheres we created? Absolutely!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:24.280168Z",
+     "iopub.status.busy": "2024-10-01T18:34:24.279901Z",
+     "iopub.status.idle": "2024-10-01T18:34:24.879682Z",
+     "shell.execute_reply": "2024-10-01T18:34:24.879130Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 640x480 with 4 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "cudaq.show(blochSphereList[:], nrows=2, ncols=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "What if we had to add multiple vectors to a single Bloch sphere? CUDA-Q uses the [QuTiP](https://www.qutip.org) toolbox to construct Bloch spheres. We can then add multiple states to the same Bloch sphere by passing the sphere object as an argument to `cudaq.add_to_bloch_sphere()`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:24.881780Z",
+     "iopub.status.busy": "2024-10-01T18:34:24.881603Z",
+     "iopub.status.idle": "2024-10-01T18:34:25.097701Z",
+     "shell.execute_reply": "2024-10-01T18:34:25.096850Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import qutip\n",
+    "\n",
+    "rng = np.random.default_rng(seed=47)\n",
+    "blochSphere = qutip.Bloch()\n",
+    "for _ in range(10):\n",
+    "    angleList = rng.random(3) * 2 * np.pi\n",
+    "    sph = cudaq.add_to_bloch_sphere(cudaq.get_state(kernel, angleList), blochSphere)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This created a single Bloch sphere with 10 random vectors. Let us see how it looks."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:25.100430Z",
+     "iopub.status.busy": "2024-10-01T18:34:25.099842Z",
+     "iopub.status.idle": "2024-10-01T18:34:25.283830Z",
+     "shell.execute_reply": "2024-10-01T18:34:25.283200Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 500x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "blochSphere.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Unfortunately, there is no such handy visualization for multi-qubit states. In particular, a multi-qubit state cannot be visualized as multiple Bloch spheres due to the nature of entanglement that makes quantum computing so powerful. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Kernel Visualization\n",
+    "\n",
+    "A CUDA-Q kernel can be visualized using the `cudaq.draw` API which returns a string representing the drawing of the execution path, in the specified format. ASCII (default) and LaTeX formats are supported."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:25.286508Z",
+     "iopub.status.busy": "2024-10-01T18:34:25.285836Z",
+     "iopub.status.idle": "2024-10-01T18:34:25.298745Z",
+     "shell.execute_reply": "2024-10-01T18:34:25.298260Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel_to_draw():\n",
+    "    q = cudaq.qvector(4)\n",
+    "    h(q)\n",
+    "    x.ctrl(q[0], q[1])\n",
+    "    y.ctrl([q[0], q[1]], q[2])\n",
+    "    z(q[2])\n",
+    "    \n",
+    "    swap(q[0], q[1])\n",
+    "    swap(q[0], q[3])\n",
+    "    swap(q[1], q[2])\n",
+    "\n",
+    "    r1(3.14159, q[0])\n",
+    "    tdg(q[1])\n",
+    "    s(q[2])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:25.300533Z",
+     "iopub.status.busy": "2024-10-01T18:34:25.300318Z",
+     "iopub.status.idle": "2024-10-01T18:34:25.360087Z",
+     "shell.execute_reply": "2024-10-01T18:34:25.359322Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮                  ╭───────────╮       \n",
+      "q0 : ┤ h ├──●────●────╳───╳─┤ r1(3.142) ├───────\n",
+      "     ├───┤╭─┴─╮  │    │   │ ╰───────────╯╭─────╮\n",
+      "q1 : ┤ h ├┤ x ├──●────╳───┼───────╳──────┤ tdg ├\n",
+      "     ├───┤╰───╯╭─┴─╮╭───╮ │       │      ╰┬───┬╯\n",
+      "q2 : ┤ h ├─────┤ y ├┤ z ├─┼───────╳───────┤ s ├─\n",
+      "     ├───┤     ╰───╯╰───╯ │               ╰───╯ \n",
+      "q3 : ┤ h ├────────────────╳─────────────────────\n",
+      "     ╰───╯                                      \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.draw(kernel_to_draw))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-10-01T18:34:25.361621Z",
+     "iopub.status.busy": "2024-10-01T18:34:25.361412Z",
+     "iopub.status.idle": "2024-10-01T18:34:25.365260Z",
+     "shell.execute_reply": "2024-10-01T18:34:25.364626Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\\documentclass{minimal}\n",
+      "\\usepackage{quantikz}\n",
+      "\\begin{document}\n",
+      "\\begin{quantikz}\n",
+      "  \\lstick{$q_0$} & \\gate{H} & \\ctrl{1} & \\ctrl{2} & \\swap{1} & \\swap{3} & \\gate{R_1(3.142)} & \\qw & \\qw \\\\\n",
+      "  \\lstick{$q_1$} & \\gate{H} & \\gate{X} & \\ctrl{1} & \\targX{} & \\qw & \\swap{1} & \\gate{T^\\dag} & \\qw \\\\\n",
+      "  \\lstick{$q_2$} & \\gate{H} & \\qw & \\gate{Y} & \\gate{Z} & \\qw & \\targX{} & \\gate{S} & \\qw \\\\\n",
+      "  \\lstick{$q_3$} & \\gate{H} & \\qw & \\qw & \\qw & \\targX{} & \\qw & \\qw & \\qw \\\\\n",
+      "\\end{quantikz}\n",
+      "\\end{document}\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.draw('latex', kernel_to_draw))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Copy this output string into any LaTeX editor and export it to PDF.\n",
+    "\n",
+    "<img src=\"images/circuit_pdf.png\" alt=\"Circuit in PDF format\" width=\"500\" height=\"250\">"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/examples/python/tutorials/vqe.html b/pr-2241/examples/python/tutorials/vqe.html
new file mode 100644
index 0000000000..f6dfaf1d46
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/vqe.html
@@ -0,0 +1,805 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Variational Quantum Eigensolver &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Max-Cut with QAOA" href="qaoa.html" />
+    <link rel="prev" title="Cost Minimization" href="cost_minimization.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Variational Quantum Eigensolver</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/vqe.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cost_minimization.html" class="btn btn-neutral float-left" title="Cost Minimization" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="qaoa.html" class="btn btn-neutral float-right" title="Max-Cut with QAOA" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Variational-Quantum-Eigensolver">
+<h1>Variational Quantum Eigensolver<a class="headerlink" href="#Variational-Quantum-Eigensolver" title="Permalink to this heading">¶</a></h1>
+<p>A common application of the Variational Quantum Eigensolver (VQE) algorithm is to compute the ground state energy of a molecular system. The code below demonstrates how to perform classical preprocessing for a <span class="math notranslate nohighlight">\(H_2\)</span> molecule (i.e. obtain the integrals from a Hartree-Fock computation to build the molecular Hamiltonian), prepare the initial Hartree-Fock state on the quantum register, add the parameterized UCCSD ansatz to the kernel, and select the COBYLA optimizer. We are then ready to call
+<code class="docutils literal notranslate"><span class="pre">cudaq:vqe</span></code> to estimate the minimum energy of the system.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">openfermionpyscf</span><span class="o">==</span><span class="m">0</span>.5<span class="w"> </span><span class="nv">matplotlib</span><span class="o">==</span><span class="m">3</span>.8.4<span class="w"> </span><span class="nv">scipy</span><span class="o">==</span><span class="m">1</span>.13.0
+</pre></div>
+</div>
+</div>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+<span class="kn">from</span> <span class="nn">scipy.optimize</span> <span class="kn">import</span> <span class="n">minimize</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># Single precision</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+<span class="c1"># Double precision</span>
+<span class="c1">#cudaq.set_target(&quot;nvidia-fp64&quot;)</span>
+</pre></div>
+</div>
+</div>
+<p>The problem of interest here is a chain of hydrogen atoms seperated along the z-axis at a fixed interval called the bond distance.</p>
+<p>The interatomic electrostatic forces due to the electrons and protons and the shielding by the neutrons creates a chemical system whose energy can be minimised to find a stable configuration.</p>
+<p>Let us first begin by defining the molecule and other metadata about the problem.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Number of hydrogen atoms.</span>
+<span class="n">hydrogen_count</span> <span class="o">=</span> <span class="mi">2</span>
+
+<span class="c1"># Distance between the atoms in Angstroms.</span>
+<span class="n">bond_distance</span> <span class="o">=</span> <span class="mf">0.7474</span>
+
+<span class="c1"># Define a linear chain of Hydrogen atoms</span>
+<span class="n">geometry</span> <span class="o">=</span> <span class="p">[(</span><span class="s1">&#39;H&#39;</span><span class="p">,</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">i</span> <span class="o">*</span> <span class="n">bond_distance</span><span class="p">))</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">hydrogen_count</span><span class="p">)]</span>
+
+<span class="n">hamiltonian</span><span class="p">,</span> <span class="n">data</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">chemistry</span><span class="o">.</span><span class="n">create_molecular_hamiltonian</span><span class="p">(</span>
+    <span class="n">geometry</span><span class="p">,</span> <span class="s1">&#39;sto-3g&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
+
+<span class="n">electron_count</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">n_electrons</span>
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">data</span><span class="o">.</span><span class="n">n_orbitals</span>
+</pre></div>
+</div>
+</div>
+<p>We now generate a Unitary Coupled-Cluster Singles and Doubles (UCCSD) ansatz from the template provided by CUDA-Q.</p>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[4]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">thetas</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">electron_count</span><span class="p">):</span>
+        <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">kernels</span><span class="o">.</span><span class="n">uccsd</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="n">thetas</span><span class="p">,</span> <span class="n">electron_count</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">)</span>
+
+
+<span class="n">parameter_count</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">kernels</span><span class="o">.</span><span class="n">uccsd_num_parameters</span><span class="p">(</span><span class="n">electron_count</span><span class="p">,</span>
+                                                     <span class="n">qubit_count</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<section id="Using-CUDA-Q-Optimizers">
+<h2>Using CUDA-Q Optimizers<a class="headerlink" href="#Using-CUDA-Q-Optimizers" title="Permalink to this heading">¶</a></h2>
+<p>We use the builtin optimizers within CUDA-Q for the minimization procedure.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[5]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">COBYLA</span><span class="p">()</span>
+
+<span class="n">energy</span><span class="p">,</span> <span class="n">parameters</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">vqe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                               <span class="n">hamiltonian</span><span class="p">,</span>
+                               <span class="n">optimizer</span><span class="p">,</span>
+                               <span class="n">parameter_count</span><span class="o">=</span><span class="n">parameter_count</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="n">energy</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+-1.1371744305855906
+</pre></div></div>
+</div>
+</section>
+<section id="Integration-with-Third-Party-Optimizers">
+<h2>Integration with Third-Party Optimizers<a class="headerlink" href="#Integration-with-Third-Party-Optimizers" title="Permalink to this heading">¶</a></h2>
+<p>We can also integrate popular libraries like scipy with CUDA-Q.</p>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[6]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Define a function to minimize</span>
+<span class="k">def</span> <span class="nf">cost</span><span class="p">(</span><span class="n">theta</span><span class="p">):</span>
+
+    <span class="n">exp_val</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">theta</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+    <span class="k">return</span> <span class="n">exp_val</span>
+
+
+<span class="n">exp_vals</span> <span class="o">=</span> <span class="p">[]</span>
+
+
+<span class="k">def</span> <span class="nf">callback</span><span class="p">(</span><span class="n">xk</span><span class="p">):</span>
+    <span class="n">exp_vals</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cost</span><span class="p">(</span><span class="n">xk</span><span class="p">))</span>
+
+
+<span class="c1"># Initial variational parameters.</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">42</span><span class="p">)</span>
+<span class="n">x0</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">normal</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">parameter_count</span><span class="p">)</span>
+
+<span class="c1"># Use the scipy optimizer to minimize the function of interest</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">minimize</span><span class="p">(</span><span class="n">cost</span><span class="p">,</span>
+                  <span class="n">x0</span><span class="p">,</span>
+                  <span class="n">method</span><span class="o">=</span><span class="s1">&#39;COBYLA&#39;</span><span class="p">,</span>
+                  <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">,</span>
+                  <span class="n">options</span><span class="o">=</span><span class="p">{</span><span class="s1">&#39;maxiter&#39;</span><span class="p">:</span> <span class="mi">40</span><span class="p">})</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">exp_vals</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s1">&#39;Epochs&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s1">&#39;Energy&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">title</span><span class="p">(</span><span class="s1">&#39;VQE&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_vqe_11_0.png" src="../../../_images/examples_python_tutorials_vqe_11_0.png" />
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cost_minimization.html" class="btn btn-neutral float-left" title="Cost Minimization" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="qaoa.html" class="btn btn-neutral float-right" title="Max-Cut with QAOA" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/vqe.ipynb b/pr-2241/examples/python/tutorials/vqe.ipynb
new file mode 100644
index 0000000000..5b0198ff96
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/vqe.ipynb
@@ -0,0 +1,228 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Variational Quantum Eigensolver"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "A common application of the Variational Quantum Eigensolver (VQE) algorithm is to compute the ground state energy of a molecular system. The code below demonstrates how to perform classical preprocessing for a $H_2$ molecule (i.e. obtain the integrals from a Hartree-Fock computation to build the molecular Hamiltonian), prepare the initial Hartree-Fock state on the quantum register, add the parameterized UCCSD ansatz to the kernel, and select the COBYLA optimizer.  We are then ready to call `cudaq:vqe` to estimate the minimum energy of the system."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install openfermionpyscf==0.5 matplotlib==3.8.4 scipy==1.13.0"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "from scipy.optimize import minimize\n",
+    "import numpy as np\n",
+    "\n",
+    "# Single precision\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "# Double precision\n",
+    "#cudaq.set_target(\"nvidia-fp64\")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The problem of interest here is a chain of hydrogen atoms seperated along the z-axis at a fixed interval called the bond distance. \n",
+    "\n",
+    "The interatomic electrostatic forces due to the electrons and protons and the shielding by the neutrons creates a chemical system whose energy can be minimised to find a stable configuration. \n",
+    "\n",
+    "Let us first begin by defining the molecule and other metadata about the problem.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Number of hydrogen atoms.\n",
+    "hydrogen_count = 2\n",
+    "\n",
+    "# Distance between the atoms in Angstroms.\n",
+    "bond_distance = 0.7474\n",
+    "\n",
+    "# Define a linear chain of Hydrogen atoms\n",
+    "geometry = [('H', (0, 0, i * bond_distance)) for i in range(hydrogen_count)]\n",
+    "\n",
+    "hamiltonian, data = cudaq.chemistry.create_molecular_hamiltonian(\n",
+    "    geometry, 'sto-3g', 1, 0)\n",
+    "\n",
+    "electron_count = data.n_electrons\n",
+    "qubit_count = 2 * data.n_orbitals"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We now generate a Unitary Coupled-Cluster Singles and Doubles (UCCSD) ansatz from the template provided by CUDA-Q.  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel(thetas: list[float]):\n",
+    "\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    for i in range(electron_count):\n",
+    "        x(qubits[i])\n",
+    "\n",
+    "    cudaq.kernels.uccsd(qubits, thetas, electron_count, qubit_count)\n",
+    "\n",
+    "\n",
+    "parameter_count = cudaq.kernels.uccsd_num_parameters(electron_count,\n",
+    "                                                     qubit_count)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Using CUDA-Q Optimizers\n",
+    "\n",
+    "We use the builtin optimizers within CUDA-Q for the minimization procedure."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "-1.1371744305855906\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "energy, parameters = cudaq.vqe(kernel,\n",
+    "                               hamiltonian,\n",
+    "                               optimizer,\n",
+    "                               parameter_count=parameter_count)\n",
+    "\n",
+    "print(energy)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Integration with Third-Party Optimizers\n",
+    "\n",
+    "We can also integrate popular libraries like scipy with CUDA-Q. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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O3lU7fjPTpdLUtMoU9PflxMGmJqNsJhqPkrj/nvY7PeTL3ALoxdtDaKYp/xw6ijPiXWceHzjpB9OPM7J39vSdzb+3kZxp9Ta8Y1Ns2sjTh0VZOEcdoIQAHiJYRganhjpM7cSAfAcIQAAEMAIQgAAIGARhAAAQMAiCAEAgIBFEAIAAAGLIAQAAAIWQQgAAAQsghAAAAhYBCEAABCwCEIAACBgEYQAAEDAIggBAICARRACAAABiyAEAAAClt3qAvo60zQlSWVlZRZXAgAAOsr957b7z/HWEITaUV5eLklKTU21uBIAANBZ5eXlio6ObvVzw2wvKgU4l8ul/Px8RUZGyjAMr31vWVmZUlNTtX//fkVFRXnte/sSfz9Hfz8/yf/PkfPzff5+jpxf15mmqfLycqWkpMhma70TiBGhdthsNg0aNKjHvj8qKsov/+E+kb+fo7+fn+T/58j5+T5/P0fOr2vaGglyo1kaAAAELIIQAAAIWAQhizgcDj300ENyOBxWl9Jj/P0c/f38JP8/R87P9/n7OXJ+PY9maQAAELAYEQIAAAGLIAQAAAIWQQgAAAQsghAAAAhYBCGLPP3000pPT1doaKiysrK0du1aq0vyit/97ncyDKPZa+TIkVaX1S2ff/65LrnkEqWkpMgwDL377rvNPjdNUw8++KCSk5MVFhamGTNmaPv27dYU2wXtnd+8efNOuaYzZ860ptguWLhwoSZNmqTIyEglJCTo8ssvV15eXrNtampqdNttt2nAgAHq16+fZs+ercLCQosq7ryOnON55513ynW85ZZbLKq4c5555hmNHTvW89C9KVOm6KOPPvJ87uvXr73z8+Vr15KHH35YhmHozjvv9Lxn5TUkCFngH//4h371q1/poYce0tdff61x48bpoosuUlFRkdWlecVpp52mQ4cOeV5ffvml1SV1S2VlpcaNG6enn366xc8feeQRPfXUU3r22We1Zs0aRURE6KKLLlJNTU0vV9o17Z2fJM2cObPZNX3jjTd6scLuWbFihW677TatXr1aS5cuVX19vS688EJVVlZ6trnrrrv0wQcf6K233tKKFSuUn5+vK664wsKqO6cj5yhJN954Y7Pr+Mgjj1hUcecMGjRIDz/8sDZs2KD169fr/PPP12WXXabvvvtOku9fv/bOT/Lda3eydevW6bnnntPYsWObvW/pNTTR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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Define a function to minimize\n",
+    "def cost(theta):\n",
+    "\n",
+    "    exp_val = cudaq.observe(kernel, hamiltonian, theta).expectation()\n",
+    "\n",
+    "    return exp_val\n",
+    "\n",
+    "\n",
+    "exp_vals = []\n",
+    "\n",
+    "\n",
+    "def callback(xk):\n",
+    "    exp_vals.append(cost(xk))\n",
+    "\n",
+    "\n",
+    "# Initial variational parameters.\n",
+    "np.random.seed(42)\n",
+    "x0 = np.random.normal(0, np.pi, parameter_count)\n",
+    "\n",
+    "# Use the scipy optimizer to minimize the function of interest\n",
+    "result = minimize(cost,\n",
+    "                  x0,\n",
+    "                  method='COBYLA',\n",
+    "                  callback=callback,\n",
+    "                  options={'maxiter': 40})\n",
+    "\n",
+    "plt.plot(exp_vals)\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Energy')\n",
+    "plt.title('VQE')\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/examples/python/tutorials/vqe_water_active_space.html b/pr-2241/examples/python/tutorials/vqe_water_active_space.html
new file mode 100644
index 0000000000..2e83fd6a01
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/vqe_water_active_space.html
@@ -0,0 +1,854 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Water Molecule with Active Space (CPU vs. GPU) &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/nbsphinx-code-cells.css" type="text/css" />
+      <link rel="stylesheet" href="../../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
+        <script src="../../../_static/jquery.js"></script>
+        <script src="../../../_static/underscore.js"></script>
+        <script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../../_static/doctools.js"></script>
+        <script src="../../../_static/sphinx_highlight.js"></script>
+        <script src="../../../_static/tabs.js"></script>
+        <script src="../../../_static/clipboard.min.js"></script>
+        <script src="../../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../search.html" />
+    <link rel="next" title="Divisive Clustering With Coresets Using CUDA-Q" href="Divisive_clustering.html" />
+    <link rel="prev" title="Readout Error Mitigation" href="readout_error_mitigation.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../../using/tutorials.html">   Applications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../using/tutorials.html">CUDA-Q Tutorials</a></li>
+      <li class="breadcrumb-item active">Water Molecule with Active Space (CPU vs. GPU)</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../../_sources/examples/python/tutorials/vqe_water_active_space.ipynb.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="readout_error_mitigation.html" class="btn btn-neutral float-left" title="Readout Error Mitigation" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="Divisive_clustering.html" class="btn btn-neutral float-right" title="Divisive Clustering With Coresets Using CUDA-Q" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="Water-Molecule-with-Active-Space-(CPU-vs.-GPU)">
+<h1>Water Molecule with Active Space (CPU vs. GPU)<a class="headerlink" href="#Water-Molecule-with-Active-Space-(CPU-vs.-GPU)" title="Permalink to this heading">¶</a></h1>
+<section id="A--Classical-simulation-as-a-reference:-CCSD">
+<h2>A- Classical simulation as a reference: CCSD<a class="headerlink" href="#A--Classical-simulation-as-a-reference:-CCSD" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput nblast docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[ ]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="c1"># Install the relevant packages.</span>
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">pyscf</span><span class="o">==</span><span class="m">2</span>.6.2
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">openfermionpyscf</span><span class="o">==</span><span class="m">0</span>.5
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">matplotlib</span><span class="o">==</span><span class="m">3</span>.8.4
+<span class="o">!</span>pip<span class="w"> </span>install<span class="w"> </span><span class="nv">openfermion</span><span class="o">==</span><span class="m">1</span>.6.1
+</pre></div>
+</div>
+</div>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">pyscf</span> <span class="kn">import</span> <span class="n">gto</span><span class="p">,</span> <span class="n">scf</span><span class="p">,</span> <span class="n">mcscf</span><span class="p">,</span> <span class="n">cc</span>
+
+<span class="n">geometry</span> <span class="o">=</span><span class="s1">&#39;O 0.1173 0.0 0.0; H -0.4691 0.7570 0.0; H -0.4691 -0.7570 0.0&#39;</span>
+<span class="n">mol</span><span class="o">=</span><span class="n">gto</span><span class="o">.</span><span class="n">M</span><span class="p">(</span>
+    <span class="n">atom</span> <span class="o">=</span> <span class="n">geometry</span><span class="p">,</span>
+    <span class="n">spin</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+    <span class="n">charge</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+    <span class="n">basis</span> <span class="o">=</span> <span class="s1">&#39;631g&#39;</span><span class="p">,</span>
+<span class="p">)</span>
+
+<span class="n">myhf</span> <span class="o">=</span> <span class="n">scf</span><span class="o">.</span><span class="n">RHF</span><span class="p">(</span><span class="n">mol</span><span class="p">)</span>
+<span class="n">myhf</span><span class="o">.</span><span class="n">max_cycle</span><span class="o">=</span><span class="mi">100</span>
+<span class="n">myhf</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="n">nelec</span> <span class="o">=</span> <span class="n">mol</span><span class="o">.</span><span class="n">nelectron</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total number of electrons = &#39;</span><span class="p">,</span> <span class="n">nelec</span><span class="p">)</span>
+<span class="n">norb</span> <span class="o">=</span> <span class="n">myhf</span><span class="o">.</span><span class="n">mo_coeff</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total number of orbitals = &#39;</span><span class="p">,</span> <span class="n">norb</span><span class="p">)</span>
+
+<span class="n">norb_cas</span><span class="p">,</span> <span class="n">nele_cas</span> <span class="o">=</span> <span class="p">(</span><span class="mi">4</span><span class="p">,</span><span class="mi">4</span><span class="p">)</span>
+<span class="n">mycasci</span> <span class="o">=</span> <span class="n">mcscf</span><span class="o">.</span><span class="n">CASCI</span><span class="p">(</span><span class="n">myhf</span><span class="p">,</span> <span class="n">norb_cas</span><span class="p">,</span> <span class="n">nele_cas</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;ncore occupied orbitals = &#39;</span><span class="p">,</span> <span class="n">mycasci</span><span class="o">.</span><span class="n">ncore</span><span class="p">)</span>
+
+<span class="n">frozen</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="n">frozen</span> <span class="o">+=</span> <span class="p">[</span><span class="n">y</span> <span class="k">for</span> <span class="n">y</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="n">mycasci</span><span class="o">.</span><span class="n">ncore</span><span class="p">)]</span>
+<span class="n">frozen</span> <span class="o">+=</span> <span class="p">[</span><span class="n">y</span> <span class="k">for</span> <span class="n">y</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">mycasci</span><span class="o">.</span><span class="n">ncore</span><span class="o">+</span><span class="n">norb_cas</span><span class="p">,</span> <span class="nb">len</span><span class="p">(</span><span class="n">mycasci</span><span class="o">.</span><span class="n">mo_coeff</span><span class="p">))]</span>
+<span class="n">mycc</span> <span class="o">=</span> <span class="n">cc</span><span class="o">.</span><span class="n">CCSD</span><span class="p">(</span><span class="n">myhf</span><span class="p">,</span><span class="n">frozen</span><span class="o">=</span><span class="n">frozen</span><span class="p">)</span><span class="o">.</span><span class="n">run</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total CCSD energy for active space Hamiltonian = &#39;</span><span class="p">,</span> <span class="n">mycc</span><span class="o">.</span><span class="n">e_tot</span><span class="p">,</span> <span class="s1">&#39;</span><span class="se">\n</span><span class="s1">&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+converged SCF energy = -75.9839755372789
+Total number of electrons =  10
+Total number of orbitals =  13
+ncore occupied orbitals =  3
+E(CCSD) = -75.98508980454675  E_corr = -0.001114267267875617
+Total CCSD energy for active space Hamiltonian =  -75.98508980454675
+
+</pre></div></div>
+</div>
+</section>
+<section id="B--VQE-UCCSD:">
+<h2>B- VQE-UCCSD:<a class="headerlink" href="#B--VQE-UCCSD:" title="Permalink to this heading">¶</a></h2>
+<div class="nbinput docutils container">
+<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[3]:
+</pre></div>
+</div>
+<div class="input_area highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">openfermion</span>
+<span class="kn">import</span> <span class="nn">openfermionpyscf</span>
+<span class="kn">from</span> <span class="nn">openfermion.transforms</span> <span class="kn">import</span> <span class="n">jordan_wigner</span><span class="p">,</span> <span class="n">get_fermion_operator</span>
+
+<span class="kn">import</span> <span class="nn">timeit</span>
+
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+<span class="kn">from</span> <span class="nn">scipy.optimize</span> <span class="kn">import</span> <span class="n">minimize</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># GPU</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia-fp64&quot;</span><span class="p">)</span>
+<span class="c1"># CPU</span>
+<span class="c1">#cudaq.set_target(&quot;qpp-cpu&quot;)</span>
+
+<span class="c1"># 1- Classical pre-processing:</span>
+
+<span class="n">geometry</span> <span class="o">=</span> <span class="p">[(</span><span class="s1">&#39;O&#39;</span><span class="p">,</span> <span class="p">(</span><span class="mf">0.1173</span><span class="p">,</span><span class="mf">0.0</span><span class="p">,</span><span class="mf">0.0</span><span class="p">)),</span> <span class="p">(</span><span class="s1">&#39;H&#39;</span><span class="p">,</span> <span class="p">(</span><span class="o">-</span><span class="mf">0.4691</span><span class="p">,</span><span class="mf">0.7570</span><span class="p">,</span><span class="mf">0.0</span><span class="p">)),</span> <span class="p">(</span><span class="s1">&#39;H&#39;</span><span class="p">,</span> <span class="p">(</span><span class="o">-</span><span class="mf">0.4691</span><span class="p">,</span><span class="o">-</span><span class="mf">0.7570</span><span class="p">,</span><span class="mf">0.0</span><span class="p">))]</span>
+<span class="n">basis</span> <span class="o">=</span> <span class="s1">&#39;631g&#39;</span>
+<span class="n">multiplicity</span> <span class="o">=</span> <span class="mi">1</span>
+<span class="n">charge</span> <span class="o">=</span> <span class="mi">0</span>
+<span class="n">ncore</span> <span class="o">=</span> <span class="mi">3</span>
+<span class="n">norb_cas</span><span class="p">,</span> <span class="n">nele_cas</span> <span class="o">=</span> <span class="p">(</span><span class="mi">4</span><span class="p">,</span><span class="mi">4</span><span class="p">)</span>
+
+<span class="n">molecule</span> <span class="o">=</span> <span class="n">openfermionpyscf</span><span class="o">.</span><span class="n">run_pyscf</span><span class="p">(</span><span class="n">openfermion</span><span class="o">.</span><span class="n">MolecularData</span><span class="p">(</span><span class="n">geometry</span><span class="p">,</span> <span class="n">basis</span><span class="p">,</span> <span class="n">multiplicity</span><span class="p">,</span><span class="n">charge</span><span class="p">))</span>
+
+<span class="n">molecular_hamiltonian</span> <span class="o">=</span> <span class="n">molecule</span><span class="o">.</span><span class="n">get_molecular_hamiltonian</span><span class="p">(</span>
+        <span class="n">occupied_indices</span><span class="o">=</span><span class="nb">range</span><span class="p">(</span><span class="n">ncore</span><span class="p">),</span> <span class="n">active_indices</span><span class="o">=</span><span class="nb">range</span><span class="p">(</span><span class="n">ncore</span><span class="p">,</span> <span class="n">ncore</span> <span class="o">+</span> <span class="n">norb_cas</span><span class="p">))</span>
+
+<span class="n">fermion_hamiltonian</span> <span class="o">=</span> <span class="n">get_fermion_operator</span><span class="p">(</span><span class="n">molecular_hamiltonian</span><span class="p">)</span>
+<span class="n">qubit_hamiltonian</span> <span class="o">=</span> <span class="n">jordan_wigner</span><span class="p">(</span><span class="n">fermion_hamiltonian</span><span class="p">)</span>
+
+<span class="n">spin_ham</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="p">(</span><span class="n">qubit_hamiltonian</span><span class="p">)</span>
+
+<span class="c1"># 2- Quantum computing using UCCSD ansatz</span>
+
+<span class="n">electron_count</span> <span class="o">=</span> <span class="n">nele_cas</span>
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">2</span><span class="o">*</span><span class="n">norb_cas</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">qubit_num</span><span class="p">:</span><span class="nb">int</span><span class="p">,</span> <span class="n">electron_num</span><span class="p">:</span><span class="nb">int</span><span class="p">,</span> <span class="n">thetas</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+        <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_num</span><span class="p">)</span>
+
+        <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">electron_num</span><span class="p">):</span>
+                <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+        <span class="n">cudaq</span><span class="o">.</span><span class="n">kernels</span><span class="o">.</span><span class="n">uccsd</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="n">thetas</span><span class="p">,</span> <span class="n">electron_num</span><span class="p">,</span> <span class="n">qubit_num</span><span class="p">)</span>
+
+<span class="n">parameter_count</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">kernels</span><span class="o">.</span><span class="n">uccsd_num_parameters</span><span class="p">(</span><span class="n">electron_count</span><span class="p">,</span><span class="n">qubit_count</span><span class="p">)</span>
+
+<span class="c1"># Define a function to minimize</span>
+<span class="k">def</span> <span class="nf">cost</span><span class="p">(</span><span class="n">theta</span><span class="p">):</span>
+
+        <span class="n">exp_val</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">spin_ham</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">electron_count</span><span class="p">,</span> <span class="n">theta</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+        <span class="k">return</span> <span class="n">exp_val</span>
+
+
+<span class="n">exp_vals</span> <span class="o">=</span> <span class="p">[]</span>
+
+<span class="k">def</span> <span class="nf">callback</span><span class="p">(</span><span class="n">xk</span><span class="p">):</span>
+        <span class="n">exp_vals</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cost</span><span class="p">(</span><span class="n">xk</span><span class="p">))</span>
+
+<span class="c1"># Initial variational parameters.</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">42</span><span class="p">)</span>
+<span class="n">x0</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">normal</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="n">parameter_count</span><span class="p">)</span>
+
+<span class="c1"># Use the scipy optimizer to minimize the function of interest</span>
+<span class="n">start_time</span> <span class="o">=</span> <span class="n">timeit</span><span class="o">.</span><span class="n">default_timer</span><span class="p">()</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">minimize</span><span class="p">(</span><span class="n">cost</span><span class="p">,</span> <span class="n">x0</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s1">&#39;COBYLA&#39;</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="p">{</span><span class="s1">&#39;maxiter&#39;</span><span class="p">:</span> <span class="mi">300</span><span class="p">})</span>
+<span class="n">end_time</span> <span class="o">=</span> <span class="n">timeit</span><span class="o">.</span><span class="n">default_timer</span><span class="p">()</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;UCCSD-VQE energy =  &#39;</span><span class="p">,</span> <span class="n">result</span><span class="o">.</span><span class="n">fun</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Pyscf-CCSD energy = &#39;</span><span class="p">,</span> <span class="n">mycc</span><span class="o">.</span><span class="n">e_tot</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total number of qubits = &#39;</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total number of parameters = &#39;</span><span class="p">,</span> <span class="n">parameter_count</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total number of terms in the spin hamiltonian = &#39;</span><span class="p">,</span><span class="n">spin_ham</span><span class="o">.</span><span class="n">get_term_count</span><span class="p">())</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Total elapsed time (s) = &#39;</span><span class="p">,</span> <span class="n">end_time</span><span class="o">-</span><span class="n">start_time</span><span class="p">)</span>
+
+<span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">exp_vals</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">xlabel</span><span class="p">(</span><span class="s1">&#39;Epochs&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s1">&#39;Energy&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">title</span><span class="p">(</span><span class="s1">&#39;VQE&#39;</span><span class="p">)</span>
+<span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+[<span style="color: rgb(255,0,0)">warning</span>] Target <span style="color: rgb(0,0,255)">nvidia-fp64</span>: <span style="color: rgb(0,0,255)">This target is deprecating. Please use the &#39;nvidia&#39; target with option &#39;fp64&#39;.</span>
+</pre></div></div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area stderr docutils container">
+<div class="highlight"><pre>
+/tmp/ipykernel_23147/4290935201.py:35: ComplexWarning: Casting complex values to real discards the imaginary part
+  spin_ham = cudaq.SpinOperator(qubit_hamiltonian)
+</pre></div></div>
+</div>
+<div class="nboutput docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<div class="highlight"><pre>
+UCCSD-VQE energy =   -75.98415928173183
+Pyscf-CCSD energy =  -75.98508980454675
+Total number of qubits =  8
+Total number of parameters =  26
+Total number of terms in the spin hamiltonian =  105
+Total elapsed time (s) =  28.929891359000067
+</pre></div></div>
+</div>
+<div class="nboutput nblast docutils container">
+<div class="prompt empty docutils container">
+</div>
+<div class="output_area docutils container">
+<img alt="../../../_images/examples_python_tutorials_vqe_water_active_space_4_3.png" src="../../../_images/examples_python_tutorials_vqe_water_active_space_4_3.png" />
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="readout_error_mitigation.html" class="btn btn-neutral float-left" title="Readout Error Mitigation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="Divisive_clustering.html" class="btn btn-neutral float-right" title="Divisive Clustering With Coresets Using CUDA-Q" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/examples/python/tutorials/vqe_water_active_space.ipynb b/pr-2241/examples/python/tutorials/vqe_water_active_space.ipynb
new file mode 100644
index 0000000000..7b5d0306ee
--- /dev/null
+++ b/pr-2241/examples/python/tutorials/vqe_water_active_space.ipynb
@@ -0,0 +1,235 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Water Molecule with Active Space (CPU vs. GPU)\n",
+    "\n",
+    "#### A- Classical simulation as a reference: CCSD"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermionpyscf==0.5\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install openfermion==1.6.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "converged SCF energy = -75.9839755372789\n",
+      "Total number of electrons =  10\n",
+      "Total number of orbitals =  13\n",
+      "ncore occupied orbitals =  3\n",
+      "E(CCSD) = -75.98508980454675  E_corr = -0.001114267267875617\n",
+      "Total CCSD energy for active space Hamiltonian =  -75.98508980454675 \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from pyscf import gto, scf, mcscf, cc\n",
+    "\n",
+    "geometry ='O 0.1173 0.0 0.0; H -0.4691 0.7570 0.0; H -0.4691 -0.7570 0.0'\n",
+    "mol=gto.M(\n",
+    "    atom = geometry,\n",
+    "    spin = 0,\n",
+    "    charge = 0,\n",
+    "    basis = '631g',\n",
+    ")\n",
+    "\n",
+    "myhf = scf.RHF(mol)\n",
+    "myhf.max_cycle=100\n",
+    "myhf.kernel()\n",
+    "nelec = mol.nelectron\n",
+    "print('Total number of electrons = ', nelec)\n",
+    "norb = myhf.mo_coeff.shape[1]\n",
+    "print('Total number of orbitals = ', norb)\n",
+    "\n",
+    "norb_cas, nele_cas = (4,4)\n",
+    "mycasci = mcscf.CASCI(myhf, norb_cas, nele_cas)\n",
+    "print('ncore occupied orbitals = ', mycasci.ncore)\n",
+    "\n",
+    "frozen = []\n",
+    "frozen += [y for y in range(0,mycasci.ncore)]\n",
+    "frozen += [y for y in range(mycasci.ncore+norb_cas, len(mycasci.mo_coeff))]\n",
+    "mycc = cc.CCSD(myhf,frozen=frozen).run()\n",
+    "print('Total CCSD energy for active space Hamiltonian = ', mycc.e_tot, '\\n')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### B- VQE-UCCSD:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[\u001b[38;2;255;000;000mwarning\u001b[0m] Target \u001b[38;2;000;000;255mnvidia-fp64\u001b[0m: \u001b[38;2;000;000;255mThis target is deprecating. Please use the 'nvidia' target with option 'fp64'.\u001b[0m\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/tmp/ipykernel_23147/4290935201.py:35: ComplexWarning: Casting complex values to real discards the imaginary part\n",
+      "  spin_ham = cudaq.SpinOperator(qubit_hamiltonian)\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "UCCSD-VQE energy =   -75.98415928173183\n",
+      "Pyscf-CCSD energy =  -75.98508980454675\n",
+      "Total number of qubits =  8\n",
+      "Total number of parameters =  26\n",
+      "Total number of terms in the spin hamiltonian =  105\n",
+      "Total elapsed time (s) =  28.929891359000067\n"
+     ]
+    },
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import openfermion\n",
+    "import openfermionpyscf\n",
+    "from openfermion.transforms import jordan_wigner, get_fermion_operator\n",
+    "\n",
+    "import timeit\n",
+    "\n",
+    "\n",
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "from scipy.optimize import minimize\n",
+    "import numpy as np\n",
+    "\n",
+    "# GPU\n",
+    "cudaq.set_target(\"nvidia-fp64\")\n",
+    "# CPU\n",
+    "#cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "# 1- Classical pre-processing:\n",
+    "\n",
+    "geometry = [('O', (0.1173,0.0,0.0)), ('H', (-0.4691,0.7570,0.0)), ('H', (-0.4691,-0.7570,0.0))]\n",
+    "basis = '631g'\n",
+    "multiplicity = 1\n",
+    "charge = 0\n",
+    "ncore = 3\n",
+    "norb_cas, nele_cas = (4,4)\n",
+    "\n",
+    "molecule = openfermionpyscf.run_pyscf(openfermion.MolecularData(geometry, basis, multiplicity,charge))\n",
+    "\n",
+    "molecular_hamiltonian = molecule.get_molecular_hamiltonian(\n",
+    "        occupied_indices=range(ncore), active_indices=range(ncore, ncore + norb_cas))\n",
+    "\n",
+    "fermion_hamiltonian = get_fermion_operator(molecular_hamiltonian)\n",
+    "qubit_hamiltonian = jordan_wigner(fermion_hamiltonian)\n",
+    "\n",
+    "spin_ham = cudaq.SpinOperator(qubit_hamiltonian)\n",
+    "\n",
+    "# 2- Quantum computing using UCCSD ansatz\n",
+    "\n",
+    "electron_count = nele_cas\n",
+    "qubit_count = 2*norb_cas\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(qubit_num:int, electron_num:int, thetas: list[float]):\n",
+    "        qubits = cudaq.qvector(qubit_num)\n",
+    "\n",
+    "        for i in range(electron_num):\n",
+    "                x(qubits[i])\n",
+    "\n",
+    "        cudaq.kernels.uccsd(qubits, thetas, electron_num, qubit_num)\n",
+    "\n",
+    "parameter_count = cudaq.kernels.uccsd_num_parameters(electron_count,qubit_count)\n",
+    "\n",
+    "# Define a function to minimize\n",
+    "def cost(theta):\n",
+    "\n",
+    "        exp_val = cudaq.observe(kernel, spin_ham, qubit_count, electron_count, theta).expectation()\n",
+    "\n",
+    "        return exp_val\n",
+    "\n",
+    "\n",
+    "exp_vals = []\n",
+    "\n",
+    "def callback(xk):\n",
+    "        exp_vals.append(cost(xk))\n",
+    "\n",
+    "# Initial variational parameters.\n",
+    "np.random.seed(42)\n",
+    "x0 = np.random.normal(0, 1, parameter_count)\n",
+    "\n",
+    "# Use the scipy optimizer to minimize the function of interest\n",
+    "start_time = timeit.default_timer()\n",
+    "result = minimize(cost, x0, method='COBYLA', callback=callback, options={'maxiter': 300})\n",
+    "end_time = timeit.default_timer()\n",
+    "\n",
+    "print('UCCSD-VQE energy =  ', result.fun)\n",
+    "print('Pyscf-CCSD energy = ', mycc.e_tot)\n",
+    "print('Total number of qubits = ', qubit_count)\n",
+    "print('Total number of parameters = ', parameter_count)\n",
+    "print('Total number of terms in the spin hamiltonian = ',spin_ham.get_term_count())\n",
+    "print('Total elapsed time (s) = ', end_time-start_time)\n",
+    "\n",
+    "plt.plot(exp_vals)\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Energy')\n",
+    "plt.title('VQE')\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/genindex.html b/pr-2241/genindex.html
new file mode 100644
index 0000000000..4601934b91
--- /dev/null
+++ b/pr-2241/genindex.html
@@ -0,0 +1,2005 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Index &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/sphinx_highlight.js"></script>
+        <script src="_static/tabs.js"></script>
+        <script src="_static/clipboard.min.js"></script>
+        <script src="_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="#" />
+    <link rel="search" title="Search" href="search.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Index</li>
+      <li class="wy-breadcrumbs-aside">
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+
+<h1 id="index">Index</h1>
+
+<div class="genindex-jumpbox">
+ <a href="#_"><strong>_</strong></a>
+ | <a href="#A"><strong>A</strong></a>
+ | <a href="#B"><strong>B</strong></a>
+ | <a href="#C"><strong>C</strong></a>
+ | <a href="#D"><strong>D</strong></a>
+ | <a href="#E"><strong>E</strong></a>
+ | <a href="#F"><strong>F</strong></a>
+ | <a href="#G"><strong>G</strong></a>
+ | <a href="#H"><strong>H</strong></a>
+ | <a href="#I"><strong>I</strong></a>
+ | <a href="#K"><strong>K</strong></a>
+ | <a href="#L"><strong>L</strong></a>
+ | <a href="#M"><strong>M</strong></a>
+ | <a href="#N"><strong>N</strong></a>
+ | <a href="#O"><strong>O</strong></a>
+ | <a href="#P"><strong>P</strong></a>
+ | <a href="#Q"><strong>Q</strong></a>
+ | <a href="#R"><strong>R</strong></a>
+ | <a href="#S"><strong>S</strong></a>
+ | <a href="#T"><strong>T</strong></a>
+ | <a href="#U"><strong>U</strong></a>
+ | <a href="#V"><strong>V</strong></a>
+ 
+</div>
+<h2 id="_">_</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__add__">__add__() (cudaq.QuakeValue method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__add__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator.__call__">__call__() (cudaq.PyKernelDecorator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__eq__">__eq__() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.ComplexMatrix.__getitem__">__getitem__() (cudaq.ComplexMatrix method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.KrausChannel.__getitem__">(cudaq.KrausChannel method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__getitem__">(cudaq.QuakeValue method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.SampleResult.__getitem__">(cudaq.SampleResult method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.AmplitudeDampingChannel.__init__">__init__() (cudaq.AmplitudeDampingChannel method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.BitFlipChannel.__init__">(cudaq.BitFlipChannel method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.DepolarizationChannel.__init__">(cudaq.DepolarizationChannel method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.NoiseModel.__init__">(cudaq.NoiseModel method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.PhaseFlipChannel.__init__">(cudaq.PhaseFlipChannel method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.__iter__">__iter__() (cudaq.SampleResult method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__iter__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.__len__">__len__() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__mul__">__mul__() (cudaq.QuakeValue method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__mul__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__neg__">__neg__() (cudaq.QuakeValue method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__radd__">__radd__() (cudaq.QuakeValue method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__radd__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__rmul__">__rmul__() (cudaq.QuakeValue method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__rmul__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__rsub__">__rsub__() (cudaq.QuakeValue method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__rsub__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.ComplexMatrix.__str__">__str__() (cudaq.ComplexMatrix method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator.__str__">(cudaq.PyKernelDecorator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.__sub__">__sub__() (cudaq.QuakeValue method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.__sub__">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+</tr></table>
+
+<h2 id="A">A</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.NoiseModel.add_all_qubit_channel">add_all_qubit_channel() (cudaq.NoiseModel method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.NoiseModel.add_channel">add_channel() (cudaq.NoiseModel method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.all_gather">all_gather() (in module cudaq.mpi)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.amplitude">amplitude() (cudaq.State method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.AmplitudeDampingChannel">AmplitudeDampingChannel (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.amplitudes">amplitudes() (cudaq.State method)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.KrausChannel.append">append() (cudaq.KrausChannel method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernel.argument_count">argument_count (cudaq.PyKernel attribute)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernel.arguments">arguments (cudaq.PyKernel attribute)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.AsyncObserveResult">AsyncObserveResult (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.AsyncSampleResult">AsyncSampleResult (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.AsyncStateResult">AsyncStateResult (class in cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="B">B</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.BitFlipChannel">BitFlipChannel (class in cudaq)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.broadcast">broadcast() (in module cudaq.mpi)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="C">C</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.CentralDifference">CentralDifference (class in cudaq.gradients)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.clear">clear() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA">COBYLA (class in cudaq.optimizers)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.KrausOperator.col_count">col_count (cudaq.KrausOperator property)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator.compile">compile() (cudaq.PyKernelDecorator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.ComplexMatrix">ComplexMatrix (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.CentralDifference.compute">compute() (cudaq.gradients.CentralDifference method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.gradients.ForwardDifference.compute">(cudaq.gradients.ForwardDifference method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.gradients.ParameterShift.compute">(cudaq.gradients.ParameterShift method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.count">count() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.ObserveResult.counts">counts() (cudaq.ObserveResult method)</a>
+</li>
+      <li>
+    cudaq
+
+      <ul>
+        <li><a href="api/languages/python_api.html#module-cudaq">module</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/cpp_api.html#_CPPv45cudaq">cudaq (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq25amplitude_damping_channelE">cudaq::amplitude_damping_channel (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq12async_resultE">cudaq::async_result (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq12async_result3getEv">cudaq::async_result::get (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq20BaseNvcfSimulatorQPUE">cudaq::BaseNvcfSimulatorQPU (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq17BaseRemoteRESTQPUE">cudaq::BaseRemoteRESTQPU (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq22BaseRemoteSimulatorQPUE">cudaq::BaseRemoteSimulatorQPU (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16bit_flip_channelE">cudaq::bit_flip_channel (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7complexE">cudaq::complex (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrixE">cudaq::complex_matrix (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrix4colsEv">cudaq::complex_matrix::cols (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE">cudaq::complex_matrix::complex_matrix (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrix4dataEv">cudaq::complex_matrix::data (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrix4dumpERNSt7ostreamE">cudaq::complex_matrix::dump (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrix4dumpEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrix11eigenvaluesEv">cudaq::complex_matrix::eigenvalues (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrix12eigenvectorsEv">cudaq::complex_matrix::eigenvectors (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrix18minimal_eigenvalueEv">cudaq::complex_matrix::minimal_eigenvalue (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE">cudaq::complex_matrix::operator() (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrixmlER14complex_matrix">cudaq::complex_matrix::operator* (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrixmlERNSt6vectorI10value_typeEE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq14complex_matrix4rowsEv">cudaq::complex_matrix::rows (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrix8set_zeroEv">cudaq::complex_matrix::set_zero (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14complex_matrix10value_typeE">cudaq::complex_matrix::value_type (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq9CusvStateE">cudaq::CusvState (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq22depolarization_channelE">cudaq::depolarization_channel (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7detailsE">cudaq::details (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details6futureE">cudaq::details::future (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE">cudaq::details::future::future (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details6future6futureERR6future">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details6future6futureEv">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details19kernel_builder_baseE">cudaq::details::kernel_builder_base (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base">cudaq::details::kernel_builder_base::operator&lt;&lt; (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details17KernelBuilderTypeE">cudaq::details::KernelBuilderType (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details17KernelBuilderType6createEPN4mlir11MLIRContextE">cudaq::details::KernelBuilderType::create (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7details17KernelBuilderType17KernelBuilderTypeERRNSt8functionIFN4mlir4TypeEPN4mlir11MLIRContextEEEE">cudaq::details::KernelBuilderType::KernelBuilderType (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args">cudaq::draw (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3dynE">cudaq::dyn (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContextE">cudaq::ExecutionContext (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext13amplitudeMapsE">cudaq::ExecutionContext::amplitudeMaps (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext9asyncExecE">cudaq::ExecutionContext::asyncExec (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext14batchIterationE">cudaq::ExecutionContext::batchIteration (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext16canHandleObserveE">cudaq::ExecutionContext::canHandleObserve (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringE">cudaq::ExecutionContext::ExecutionContext (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext16expectationValueE">cudaq::ExecutionContext::expectationValue (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext12futureResultE">cudaq::ExecutionContext::futureResult (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext31hasConditionalsOnMeasureResultsE">cudaq::ExecutionContext::hasConditionalsOnMeasureResults (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext22invocationResultBufferE">cudaq::ExecutionContext::invocationResultBuffer (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext10kernelNameE">cudaq::ExecutionContext::kernelName (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext11kernelTraceE">cudaq::ExecutionContext::kernelTrace (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext4nameE">cudaq::ExecutionContext::name (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext10noiseModelE">cudaq::ExecutionContext::noiseModel (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext9optResultE">cudaq::ExecutionContext::optResult (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext20overlapComputeStatesE">cudaq::ExecutionContext::overlapComputeStates (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext13overlapResultE">cudaq::ExecutionContext::overlapResult (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext13registerNamesE">cudaq::ExecutionContext::registerNames (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext10reorderIdxE">cudaq::ExecutionContext::reorderIdx (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext6resultE">cudaq::ExecutionContext::result (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext5shotsE">cudaq::ExecutionContext::shots (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext15simulationStateE">cudaq::ExecutionContext::simulationState (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext4spinE">cudaq::ExecutionContext::spin (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16ExecutionContext15totalIterationsE">cudaq::ExecutionContext::totalIterations (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResultE">cudaq::ExecutionResult (C++ struct)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE">cudaq::ExecutionResult::appendResult (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult11deserializeERNSt6vectorINSt6size_tEEE">cudaq::ExecutionResult::deserialize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionary">cudaq::ExecutionResult::ExecutionResult (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultENSt6stringE">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult">[4]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultEd">[5]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult15ExecutionResultEv">[6]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResultaSERK15ExecutionResult">cudaq::ExecutionResult::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq15ExecutionResulteqERK15ExecutionResult">cudaq::ExecutionResult::operator== (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult12registerNameE">cudaq::ExecutionResult::registerName (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15ExecutionResult14sequentialDataE">cudaq::ExecutionResult::sequentialData (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq15ExecutionResult9serializeEv">cudaq::ExecutionResult::serialize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8gradientE">cudaq::gradient (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8gradient5cloneEv">cudaq::gradient::clone (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">cudaq::gradient::compute (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq8gradient8gradientER7KernelT">cudaq::gradient::gradient (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq8gradient8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq8gradient8gradientEv">[4]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args">cudaq::gradient::setArgs (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel">cudaq::gradient::setKernel (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18central_differenceE">cudaq::gradients::central_difference (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18central_difference5cloneEv">cudaq::gradients::central_difference::clone (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">cudaq::gradients::central_difference::compute (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT">cudaq::gradients::central_difference::gradient (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18central_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18central_difference8gradientEv">[4]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18forward_differenceE">cudaq::gradients::forward_difference (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18forward_difference5cloneEv">cudaq::gradients::forward_difference::clone (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">cudaq::gradients::forward_difference::compute (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT">cudaq::gradients::forward_difference::gradient (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18forward_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients18forward_difference8gradientEv">[4]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients15parameter_shiftE">cudaq::gradients::parameter_shift (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients15parameter_shift5cloneEv">cudaq::gradients::parameter_shift::clone (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd">cudaq::gradients::parameter_shift::compute (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT">cudaq::gradients::parameter_shift::gradient (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients15parameter_shift8gradientERRNSt8functionIFvNSt6vectorIdEEEEE">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq9gradients15parameter_shift8gradientEv">[4]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4IDpEN5cudaq14kernel_builderE">cudaq::kernel_builder (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder11constantValEd">cudaq::kernel_builder::constantVal (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder12getArgumentsEv">cudaq::kernel_builder::getArguments (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder12getNumParamsEv">cudaq::kernel_builder::getNumParams (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder11isArgStdVecENSt6size_tE">cudaq::kernel_builder::isArgStdVec (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder14kernel_builderERNSt6vectorIN7details17KernelBuilderTypeEEE">cudaq::kernel_builder::kernel_builder (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder4nameEv">cudaq::kernel_builder::name (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder6qallocE10QuakeValue">cudaq::kernel_builder::qalloc (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder6qallocEKNSt6size_tE">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder6qallocERNSt6vectorINSt7complexIdEEEE">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder6qallocEv">[3]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue">cudaq::kernel_builder::swap (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq19KernelExecutionTaskE">cudaq::KernelExecutionTask (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channelE">cudaq::kraus_channel (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13kraus_channel5emptyEv">cudaq::kraus_channel::empty (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channel7get_opsEv">cudaq::kraus_channel::get_ops (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE">cudaq::kraus_channel::kraus_channel (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channel13kraus_channelERNSt6vectorI8kraus_opEE">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channel13kraus_channelERRNSt6vectorI8kraus_opEE">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channel13kraus_channelEv">[4]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channelaSERK13kraus_channel">cudaq::kraus_channel::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channelixEKNSt6size_tE">cudaq::kraus_channel::operator[] (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13kraus_channel9push_backE8kraus_op">cudaq::kraus_channel::push_back (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13kraus_channel4sizeEv">cudaq::kraus_channel::size (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_opE">cudaq::kraus_op (C++ struct)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq8kraus_op7adjointEv">cudaq::kraus_op::adjoint (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_op4dataE">cudaq::kraus_op::data (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE">cudaq::kraus_op::kraus_op (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_op8kraus_opENSt6vectorIN5cudaq7complexEEE">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_op8kraus_opERK8kraus_op">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_op5nColsE">cudaq::kraus_op::nCols (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_op5nRowsE">cudaq::kraus_op::nRows (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8kraus_opaSERK8kraus_op">cudaq::kraus_op::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpiE">cudaq::mpi (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE">cudaq::mpi::all_gather (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction">cudaq::mpi::all_reduce (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi">cudaq::mpi::broadcast (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi8finalizeEv">cudaq::mpi::finalize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi10initializeEiPPc">cudaq::mpi::initialize (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi10initializeEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi14is_initializedEv">cudaq::mpi::is_initialized (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi9num_ranksEv">cudaq::mpi::num_ranks (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3mpi4rankEv">cudaq::mpi::rank (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq11noise_modelE">cudaq::noise_model (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli">cudaq::noise_model::add_all_qubit_channel (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy">cudaq::noise_model::add_channel (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel">[3]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq11noise_model5emptyEv">cudaq::noise_model::empty (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE">cudaq::noise_model::get_channels (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq11noise_model11noise_modelEv">cudaq::noise_model::noise_model (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq11noise_model15PredicateFuncTyE">cudaq::noise_model::PredicateFuncTy (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18num_available_gpusEv">cudaq::num_available_gpus (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_resultE">cudaq::observe_result (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType">cudaq::observe_result::counts (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_result4dumpEv">cudaq::observe_result::dump (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType">cudaq::observe_result::expectation (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_result11expectationEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_result14id_coefficientEv">cudaq::observe_result::id_coefficient (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op">cudaq::observe_result::observe_result (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_resultcvdEv">cudaq::observe_result::operator double (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq14observe_result8raw_dataEv">cudaq::observe_result::raw_data (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq20optimizable_functionE">cudaq::optimizable_function (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq19optimization_resultE">cudaq::optimization_result (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9optimizerE">cudaq::optimizer (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function">cudaq::optimizer::optimize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9optimizer17requiresGradientsEv">cudaq::optimizer::requiresGradients (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4orcaE">cudaq::orca (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi">cudaq::orca::sample (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18phase_flip_channelE">cudaq::phase_flip_channel (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPUE">cudaq::QPU (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU7enqueueER11QuantumTask">cudaq::QPU::enqueue (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU15getConnectivityEv">cudaq::QPU::getConnectivity (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq3QPU20getExecutionThreadIdEv">cudaq::QPU::getExecutionThreadId (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU12getNumQubitsEv">cudaq::QPU::getNumQubits (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq3QPU21getRemoteCapabilitiesEv">cudaq::QPU::getRemoteCapabilities (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU10isEmulatedEv">cudaq::QPU::isEmulated (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU11isSimulatorEv">cudaq::QPU::isSimulator (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE">cudaq::QPU::launchKernel (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE">cudaq::QPU::launchSerializedCodeExecution (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU15onRandomSeedSetENSt6size_tE">cudaq::QPU::onRandomSeedSet (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU3QPUENSt6size_tE">cudaq::QPU::QPU (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU3QPUERR3QPU">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU3QPUEv">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU21resetExecutionContextEv">cudaq::QPU::resetExecutionContext (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU19setExecutionContextEP16ExecutionContext">cudaq::QPU::setExecutionContext (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU5setIdENSt6size_tE">cudaq::QPU::setId (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU8setShotsEi">cudaq::QPU::setShots (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPU27supportsConditionalFeedbackEv">cudaq::QPU::supportsConditionalFeedback (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq3QPUD0Ev">cudaq::QPU::~QPU (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE">cudaq::qreg (C++ class)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg4backENSt6size_tE">cudaq::qreg::back (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg4backEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg5beginEv">cudaq::qreg::begin (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg5clearEv">cudaq::qreg::clear (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg5frontENSt6size_tE">cudaq::qreg::front (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg5frontEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qregixEKNSt6size_tE">cudaq::qreg::operator[] (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq4qreg4sizeEv">cudaq::qreg::size (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE">cudaq::qreg::slice (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4qreg10value_typeE">cudaq::qreg::value_type (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE">cudaq::qspan (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValueE">cudaq::QuakeValue (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue22canValidateNumElementsEv">cudaq::QuakeValue::canValidateNumElements (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue12constantSizeEv">cudaq::QuakeValue::constantSize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue4dumpERNSt7ostreamE">cudaq::QuakeValue::dump (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue4dumpEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue19getRequiredElementsEv">cudaq::QuakeValue::getRequiredElements (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq10QuakeValue8getValueEv">cudaq::QuakeValue::getValue (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq10QuakeValue7inverseEv">cudaq::QuakeValue::inverse (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue8isStdVecEv">cudaq::QuakeValue::isStdVec (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuemlE10QuakeValue">cudaq::QuakeValue::operator* (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuemlEKd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValueplE10QuakeValue">cudaq::QuakeValue::operator+ (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValueplEKd">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValueplEKi">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuemiE10QuakeValue">cudaq::QuakeValue::operator- (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuemiEKd">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuemiEKi">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq10QuakeValuemiEv">[3]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuedvE10QuakeValue">cudaq::QuakeValue::operator/ (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValuedvEKd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValueixEKNSt6size_tE">cudaq::QuakeValue::operator[] (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValueixERK10QuakeValue">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE">cudaq::QuakeValue::QuakeValue (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue4sizeEv">cudaq::QuakeValue::size (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE">cudaq::QuakeValue::slice (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platformE">cudaq::quantum_platform (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform11clear_shotsEv">cudaq::quantum_platform::clear_shots (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform12connectivityEv">cudaq::quantum_platform::connectivity (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask">cudaq::quantum_platform::enqueueAsyncTask (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform15get_current_qpuEv">cudaq::quantum_platform::get_current_qpu (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform12get_exec_ctxEv">cudaq::quantum_platform::get_exec_ctx (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform14get_num_qubitsENSt6size_tE">cudaq::quantum_platform::get_num_qubits (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform14get_num_qubitsEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform23get_remote_capabilitiesEKNSt6size_tE">cudaq::quantum_platform::get_remote_capabilities (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform9get_shotsEv">cudaq::quantum_platform::get_shots (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform12getLogStreamEv">cudaq::quantum_platform::getLogStream (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform11is_emulatedEKNSt6size_tE">cudaq::quantum_platform::is_emulated (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform9is_remoteEKNSt6size_tE">cudaq::quantum_platform::is_remote (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform12is_simulatorEKNSt6size_tE">cudaq::quantum_platform::is_simulator (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE">cudaq::quantum_platform::launchVQE (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform14list_platformsEv">cudaq::quantum_platform::list_platforms (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform4nameEv">cudaq::quantum_platform::name (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform8num_qpusEv">cudaq::quantum_platform::num_qpus (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform15onRandomSeedSetENSt6size_tE">cudaq::quantum_platform::onRandomSeedSet (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform14reset_exec_ctxENSt6size_tE">cudaq::quantum_platform::reset_exec_ctx (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform11reset_noiseEv">cudaq::quantum_platform::reset_noise (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform14resetLogStreamEv">cudaq::quantum_platform::resetLogStream (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform15set_current_qpuEKNSt6size_tE">cudaq::quantum_platform::set_current_qpu (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE">cudaq::quantum_platform::set_exec_ctx (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform9set_noiseEPK11noise_model">cudaq::quantum_platform::set_noise (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform9set_shotsEi">cudaq::quantum_platform::set_shots (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform12setLogStreamERNSt7ostreamE">cudaq::quantum_platform::setLogStream (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq16quantum_platform16setTargetBackendERKNSt6stringE">cudaq::quantum_platform::setTargetBackend (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform29supports_conditional_feedbackEKNSt6size_tE">cudaq::quantum_platform::supports_conditional_feedback (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq16quantum_platform26supports_task_distributionEv">cudaq::quantum_platform::supports_task_distribution (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq11QuantumTaskE">cudaq::QuantumTask (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5qubitE">cudaq::qubit (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq17QubitConnectivityE">cudaq::QubitConnectivity (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9QubitEdgeE">cudaq::QubitEdge (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I_NSt6size_tEEN5cudaq5quditE">cudaq::qudit (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5qudit5quditEv">cudaq::qudit::qudit (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I_NSt6size_tEEN5cudaq7qvectorE">cudaq::qvector (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector4backENSt6size_tE">cudaq::qvector::back (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector4backEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector5beginEv">cudaq::qvector::begin (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector5clearEv">cudaq::qvector::clear (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector3endEv">cudaq::qvector::end (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector5frontENSt6size_tE">cudaq::qvector::front (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector5frontEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvectoraSERK7qvector">cudaq::qvector::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvectorixEKNSt6size_tE">cudaq::qvector::operator[] (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector7qvectorENSt6size_tE">cudaq::qvector::qvector (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector7qvectorERK5state">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector7qvectorERK7qvector">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector7qvectorERR7qvector">[4]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7qvector4sizeEv">cudaq::qvector::size (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE">cudaq::qvector::slice (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7qvector10value_typeE">cudaq::qvector::value_type (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I_NSt6size_tEEN5cudaq5qviewE">cudaq::qview (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5qview10value_typeE">cudaq::qview::value_type (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType">cudaq::range (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq5rangeENSt6size_tE">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq4realE">cudaq::real (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq8registryE">cudaq::registry (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq8registry14RegisteredTypeE">cudaq::registry::RegisteredType (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18RemoteCapabilitiesE">cudaq::RemoteCapabilities (C++ struct)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18RemoteCapabilities17isRemoteSimulatorE">cudaq::RemoteCapabilities::isRemoteSimulator (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18RemoteCapabilities18RemoteCapabilitiesEb">cudaq::RemoteCapabilities::RemoteCapabilities (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18RemoteCapabilities18serializedCodeExecE">cudaq::RemoteCapabilities::serializedCodeExec (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18RemoteCapabilities12stateOverlapE">cudaq::RemoteCapabilities::stateOverlap (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq18RemoteCapabilities3vqeE">cudaq::RemoteCapabilities::vqe (C++ member)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq21RemoteSimulationStateE">cudaq::RemoteSimulationState (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9ResourcesE">cudaq::Resources (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_resultE">cudaq::sample_result (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result6appendER15ExecutionResult">cudaq::sample_result::append (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result5beginEv">cudaq::sample_result::begin (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result5beginEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result6cbeginEv">cudaq::sample_result::cbegin (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result4cendEv">cudaq::sample_result::cend (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result5clearEv">cudaq::sample_result::clear (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE">cudaq::sample_result::count (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result11deserializeERNSt6vectorINSt6size_tEEE">cudaq::sample_result::deserialize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result4dumpERNSt7ostreamE">cudaq::sample_result::dump (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result4dumpEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result3endEv">cudaq::sample_result::end (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result3endEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result9exp_val_zEKNSt11string_viewE">cudaq::sample_result::exp_val_z (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result11expectationEKNSt11string_viewE">cudaq::sample_result::expectation (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE">cudaq::sample_result::get_marginal (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result15has_even_parityENSt11string_viewE">cudaq::sample_result::has_even_parity (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result15has_expectationEKNSt11string_viewE">cudaq::sample_result::has_expectation (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13most_probableEKNSt11string_viewE">cudaq::sample_result::most_probable (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_resultpLERK13sample_result">cudaq::sample_result::operator+= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_resultaSER13sample_result">cudaq::sample_result::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_resulteqERK13sample_result">cudaq::sample_result::operator== (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE">cudaq::sample_result::probability (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result14register_namesEv">cudaq::sample_result::register_names (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE">cudaq::sample_result::reorder (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13sample_resultER15ExecutionResult">cudaq::sample_result::sample_result (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13sample_resultERK13sample_result">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13sample_resultERNSt6vectorI15ExecutionResultEE">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13sample_resultERR15ExecutionResult">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE">[4]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result13sample_resultEv">[5]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result9serializeEv">cudaq::sample_result::serialize (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_result4sizeEKNSt11string_viewE">cudaq::sample_result::size (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq13sample_result6to_mapEKNSt11string_viewE">cudaq::sample_result::to_map (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq13sample_resultD0Ev">cudaq::sample_result::~sample_result (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq30SerializedCodeExecutionContextE">cudaq::SerializedCodeExecutionContext (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq9set_noiseERKN5cudaq11noise_modelE">cudaq::set_noise (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15set_random_seedENSt6size_tE">cudaq::set_random_seed (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq20simulation_precisionE">cudaq::simulation_precision (C++ enum)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq20simulation_precision4fp32E">cudaq::simulation_precision::fp32 (C++ enumerator)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq20simulation_precision4fp64E">cudaq::simulation_precision::fp64 (C++ enumerator)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15SimulationStateE">cudaq::SimulationState (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15SimulationState9precisionE">cudaq::SimulationState::precision (C++ enum)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15SimulationState9precision4fp32E">cudaq::SimulationState::precision::fp32 (C++ enumerator)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15SimulationState9precision4fp64E">cudaq::SimulationState::precision::fp64 (C++ enumerator)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15SimulationState6TensorE">cudaq::SimulationState::Tensor (C++ struct)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opE">cudaq::spin_op (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op5beginEv">cudaq::spin_op::begin (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op5beginEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op12csr_spmatrixE">cudaq::spin_op::csr_spmatrix (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op16distribute_termsENSt6size_tE">cudaq::spin_op::distribute_terms (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op4dumpEv">cudaq::spin_op::dump (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op3endEv">cudaq::spin_op::end (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op3endEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op14for_each_pauliERRNSt8functionIFv5pauliNSt6size_tEEEE">cudaq::spin_op::for_each_pauli (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op13for_each_termERRNSt8functionIFvR7spin_opEEE">cudaq::spin_op::for_each_term (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op9from_wordERKNSt6stringE">cudaq::spin_op::from_word (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op15get_coefficientEv">cudaq::spin_op::get_coefficient (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op12get_raw_dataEv">cudaq::spin_op::get_raw_data (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op21getDataRepresentationEv">cudaq::spin_op::getDataRepresentation (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op12getDataTupleEv">cudaq::spin_op::getDataTuple (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op11is_identityEv">cudaq::spin_op::is_identity (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0EN5cudaq7spin_op8iteratorE">cudaq::spin_op::iterator (C++ struct)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op10num_qubitsEv">cudaq::spin_op::num_qubits (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op9num_termsEv">cudaq::spin_op::num_terms (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opmLEKNSt7complexIdEE">cudaq::spin_op::operator*= (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opmLEKd">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opmLERK7spin_op">[2]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_oppLERK7spin_op">cudaq::spin_op::operator+= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opmIERK7spin_op">cudaq::spin_op::operator-= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opaSERK7spin_op">cudaq::spin_op::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_opeqERK7spin_op">cudaq::spin_op::operator== (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj">cudaq::spin_op::random (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE">cudaq::spin_op::spin_op (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opENSt6size_tE">[1]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE">[2]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERK7spin_op">[3]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERKNSt13unordered_mapI12spin_op_termNSt7complexIdEEEE">[4]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERKNSt4pairIK12spin_op_termNSt7complexIdEEEE">[5]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE">[6]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE">[7]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opERNSt4pairIK12spin_op_termNSt7complexIdEEEE">[8]</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op7spin_opEv">[9]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_op12spin_op_termE">cudaq::spin_op::spin_op_term (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op9to_matrixEv">cudaq::spin_op::to_matrix (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op16to_sparse_matrixEv">cudaq::spin_op::to_sparse_matrix (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq7spin_op9to_stringEb">cudaq::spin_op::to_string (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq7spin_opD0Ev">cudaq::spin_op::~spin_op (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5stateE">cudaq::state (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5state9amplitudeERKNSt6vectorIiEE">cudaq::state::amplitude (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5state10amplitudesERKNSt6vectorINSt6vectorIiEEEE">cudaq::state::amplitudes (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state4dumpERNSt7ostreamE">cudaq::state::dump (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state4dumpEv">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5state9from_dataERK10state_data">cudaq::state::from_data (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state14get_num_qubitsEv">cudaq::state::get_num_qubits (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state15get_num_tensorsEv">cudaq::state::get_num_tensors (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state13get_precisionEv">cudaq::state::get_precision (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state10get_tensorENSt6size_tE">cudaq::state::get_tensor (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state11get_tensorsEv">cudaq::state::get_tensors (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5state9is_on_gpuEv">cudaq::state::is_on_gpu (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE">cudaq::state::operator() (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5stateclERKNSt16initializer_listINSt6size_tEEENSt6size_tE">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5stateaSERR5state">cudaq::state::operator= (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4NK5cudaq5stateixENSt6size_tE">cudaq::state::operator[] (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5state7overlapERK5state">cudaq::state::overlap (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5state5stateEP15SimulationState">cudaq::state::state (C++ function)</a>, <a href="api/languages/cpp_api.html#_CPPv4N5cudaq5state5stateERK5state">[1]</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE">cudaq::state::to_host (C++ function)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq10state_dataE">cudaq::state_data (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq6tensorE">cudaq::tensor (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq15TensorStateDataE">cudaq::TensorStateData (C++ type)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq5TraceE">cudaq::Trace (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5cudaq11unset_noiseEv">cudaq::unset_noise (C++ function)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="D">D</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.DepolarizationChannel">DepolarizationChannel (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Target.description">description (cudaq.Target property)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.deserialize">deserialize() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.distribute_terms">distribute_terms() (cudaq.SpinOperator method)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.draw">draw() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.ObserveResult.dump">dump() (cudaq.ObserveResult method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SampleResult.dump">(cudaq.SampleResult method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.dump">(cudaq.SpinOperator method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.State.dump">(cudaq.State method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+</tr></table>
+
+<h2 id="E">E</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.ObserveResult.expectation">expectation() (cudaq.ObserveResult method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SampleResult.expectation">(cudaq.SampleResult method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.ObserveResult.expectation_z">expectation_z() (cudaq.ObserveResult method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SampleResult.expectation_z">(cudaq.SampleResult method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+</tr></table>
+
+<h2 id="F">F</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.finalize">finalize() (in module cudaq.mpi)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.for_each_pauli">for_each_pauli() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.for_each_term">for_each_term() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.ForwardDifference">ForwardDifference (class in cudaq.gradients)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.from_data">from_data() (cudaq.State static method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.CentralDifference.from_json">from_json() (cudaq.gradients.CentralDifference static method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.gradients.ForwardDifference.from_json">(cudaq.gradients.ForwardDifference static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.gradients.ParameterShift.from_json">(cudaq.gradients.ParameterShift static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.from_json">(cudaq.optimizers.COBYLA static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.from_json">(cudaq.optimizers.GradientDescent static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.from_json">(cudaq.optimizers.LBFGS static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.from_json">(cudaq.optimizers.NelderMead static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator.from_json">(cudaq.PyKernelDecorator static method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.from_json">(cudaq.SpinOperator static method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.from_word">from_word() (cudaq.SpinOperator static method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="G">G</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.AsyncObserveResult.get">get() (cudaq.AsyncObserveResult method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.AsyncSampleResult.get">(cudaq.AsyncSampleResult method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.AsyncStateResult.get">(cudaq.AsyncStateResult method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.NoiseModel.get_channels">get_channels() (cudaq.NoiseModel method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.get_coefficient">get_coefficient() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.get_marginal_counts">get_marginal_counts() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Target.get_precision">get_precision() (cudaq.Target method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.get_qubit_count">get_qubit_count() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.get_raw_data">get_raw_data() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.get_register_counts">get_register_counts() (cudaq.SampleResult method)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.get_sequential_data">get_sequential_data() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.ObserveResult.get_spin">get_spin() (cudaq.ObserveResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.get_state">get_state() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.get_state_async">get_state_async() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.get_target">get_target() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.get_targets">get_targets() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.get_term_count">get_term_count() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.getTensor">getTensor() (cudaq.State method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.getTensors">getTensors() (cudaq.State method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.gradient">gradient (class in cudaq.gradients)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent">GradientDescent (class in cudaq.optimizers)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="H">H</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.has_target">has_target() (in module cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="I">I</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.initial_parameters">initial_parameters (cudaq.optimizers.COBYLA property)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.initial_parameters">(cudaq.optimizers.GradientDescent property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.initial_parameters">(cudaq.optimizers.LBFGS property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.initial_parameters">(cudaq.optimizers.NelderMead property)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.initialize">initialize() (in module cudaq.mpi)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.initialize_cudaq">initialize_cudaq() (in module cudaq)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.Target.is_emulated">is_emulated() (cudaq.Target method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.is_identity">is_identity() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.is_initialized">is_initialized() (in module cudaq.mpi)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.is_on_gpu">is_on_gpu() (cudaq.State method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Target.is_remote">is_remote() (cudaq.Target method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.items">items() (cudaq.SampleResult method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="K">K</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.Kernel">Kernel (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.kernel">kernel() (in module cudaq)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.KrausChannel">KrausChannel (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.KrausOperator">KrausOperator (class in cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="L">L</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS">LBFGS (class in cudaq.optimizers)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.lower_bounds">lower_bounds (cudaq.optimizers.COBYLA property)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.lower_bounds">(cudaq.optimizers.GradientDescent property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.lower_bounds">(cudaq.optimizers.LBFGS property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.lower_bounds">(cudaq.optimizers.NelderMead property)</a>
+</li>
+      </ul></li>
+  </ul></td>
+</tr></table>
+
+<h2 id="M">M</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.make_kernel">make_kernel() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.max_iterations">max_iterations (cudaq.optimizers.COBYLA property)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.max_iterations">(cudaq.optimizers.GradientDescent property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.max_iterations">(cudaq.optimizers.LBFGS property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.max_iterations">(cudaq.optimizers.NelderMead property)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.ComplexMatrix.minimal_eigenvalue">minimal_eigenvalue() (cudaq.ComplexMatrix method)</a>
+</li>
+      <li>
+    module
+
+      <ul>
+        <li><a href="api/languages/python_api.html#module-cudaq">cudaq</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.most_probable">most_probable() (cudaq.SampleResult method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="N">N</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernel.name">name (cudaq.PyKernel attribute)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SimulationPrecision.name">(cudaq.SimulationPrecision property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.Target.name">(cudaq.Target property)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead">NelderMead (class in cudaq.optimizers)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.NoiseModel">NoiseModel (class in cudaq)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.num_available_gpus">num_available_gpus() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Target.num_qpus">num_qpus() (cudaq.Target method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.num_qubits">num_qubits() (cudaq.State method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.num_ranks">num_ranks() (in module cudaq.mpi)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5nvqir18MPSSimulationStateE">nvqir::MPSSimulationState (C++ class)</a>
+</li>
+      <li><a href="api/languages/cpp_api.html#_CPPv4N5nvqir24TensorNetSimulationStateE">nvqir::TensorNetSimulationState (C++ class)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="O">O</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.observe">observe() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.observe_async">observe_async() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.ObserveResult">ObserveResult (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.OptimizationResult">OptimizationResult (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.optimize">optimize() (cudaq.optimizers.COBYLA method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.optimize">(cudaq.optimizers.GradientDescent method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.optimize">(cudaq.optimizers.LBFGS method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.optimize">(cudaq.optimizers.NelderMead method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.optimizer">optimizer (class in cudaq.optimizers)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State.overlap">overlap() (cudaq.State method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="P">P</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.ParameterShift">ParameterShift (class in cudaq.gradients)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PhaseFlipChannel">PhaseFlipChannel (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Target.platform">platform (cudaq.Target property)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.probability">probability() (cudaq.SampleResult method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernel">PyKernel (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator">PyKernelDecorator (class in cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="Q">Q</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.qreg">qreg (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue">QuakeValue (class in cudaq)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.qubit">qubit (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.qvector">qvector (class in cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="R">R</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.random">random() (cudaq.SpinOperator static method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.mpi.rank">rank() (in module cudaq.mpi)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.register_names">register_names (cudaq.SampleResult attribute)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.requires_gradients">requires_gradients() (cudaq.optimizers.COBYLA method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.requires_gradients">(cudaq.optimizers.GradientDescent method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.requires_gradients">(cudaq.optimizers.LBFGS method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.requires_gradients">(cudaq.optimizers.NelderMead method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.reset_target">reset_target() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.KrausOperator.row_count">row_count (cudaq.KrausOperator property)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="S">S</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.sample">sample() (in module cudaq)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.orca.sample">(in module cudaq.orca)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.sample_async">sample_async() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult">SampleResult (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.serialize">serialize() (cudaq.SampleResult method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.serialize">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+      <li><a href="api/languages/python_api.html#cudaq.set_noise">set_noise() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.set_random_seed">set_random_seed() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.set_target">set_target() (in module cudaq)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SimulationPrecision">SimulationPrecision (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Target.simulator">simulator (cudaq.Target property)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.QuakeValue.slice">slice() (cudaq.QuakeValue method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.spin.i">spin.i() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.spin.x">spin.x() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.spin.y">spin.y() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.spin.z">spin.z() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator">SpinOperator (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.State">State (class in cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="T">T</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.Target">Target (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.Tensor">Tensor (class in cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.gradients.CentralDifference.to_json">to_json() (cudaq.gradients.CentralDifference method)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.gradients.ForwardDifference.to_json">(cudaq.gradients.ForwardDifference method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.gradients.ParameterShift.to_json">(cudaq.gradients.ParameterShift method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.to_json">(cudaq.optimizers.COBYLA method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.to_json">(cudaq.optimizers.GradientDescent method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.to_json">(cudaq.optimizers.LBFGS method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.to_json">(cudaq.optimizers.NelderMead method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator.to_json">(cudaq.PyKernelDecorator method)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.SpinOperator.to_json">(cudaq.SpinOperator method)</a>
+</li>
+      </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.to_matrix">to_matrix() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.to_sparse_matrix">to_sparse_matrix() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.SpinOperator.to_string">to_string() (cudaq.SpinOperator method)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.translate">translate() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.PyKernelDecorator.type_to_str">type_to_str() (cudaq.PyKernelDecorator static method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+<h2 id="U">U</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.unset_noise">unset_noise() (in module cudaq)</a>
+</li>
+      <li><a href="api/languages/python_api.html#cudaq.optimizers.COBYLA.upper_bounds">upper_bounds (cudaq.optimizers.COBYLA property)</a>
+
+      <ul>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.GradientDescent.upper_bounds">(cudaq.optimizers.GradientDescent property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.LBFGS.upper_bounds">(cudaq.optimizers.LBFGS property)</a>
+</li>
+        <li><a href="api/languages/python_api.html#cudaq.optimizers.NelderMead.upper_bounds">(cudaq.optimizers.NelderMead property)</a>
+</li>
+      </ul></li>
+  </ul></td>
+</tr></table>
+
+<h2 id="V">V</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.SampleResult.values">values() (cudaq.SampleResult method)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api/languages/python_api.html#cudaq.vqe">vqe() (in module cudaq)</a>
+</li>
+  </ul></td>
+</tr></table>
+
+
+
+           </div>
+          </div>
+          <footer>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/index.html b/pr-2241/index.html
new file mode 100644
index 0000000000..e07aab6d74
--- /dev/null
+++ b/pr-2241/index.html
@@ -0,0 +1,745 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/sphinx_highlight.js"></script>
+        <script src="_static/tabs.js"></script>
+        <script src="_static/clipboard.min.js"></script>
+        <script src="_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="Quick Start" href="using/quick_start.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="#" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="#">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="#" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">CUDA-Q</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="using/quick_start.html" class="btn btn-neutral float-right" title="Quick Start" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q">
+<h1>CUDA-Q<a class="headerlink" href="#cuda-q" title="Permalink to this heading">¶</a></h1>
+<p>Welcome to the CUDA-Q documentation page!</p>
+<p>CUDA-Q streamlines hybrid application development and promotes productivity and scalability
+in quantum computing. It offers a unified programming model designed for a hybrid
+setting—that is, CPUs, GPUs, and QPUs working together. CUDA-Q contains support for
+programming in Python and in C++.</p>
+<p>You are browsing the documentation for amd64-pr-2241 version of CUDA-Q. You can find documentation for all released versions <a class="reference internal" href="versions.html"><span class="doc">here</span></a>.</p>
+<p><strong>CUDA-Q</strong> is a programming model and toolchain for using quantum acceleration in heterogeneous computing architectures available in C++ and Python.</p>
+<div class="toctree-wrapper compound">
+<p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/run_kernel.html">   Running your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/troubleshooting.html">   Troubleshooting</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/quantum_operations.html">   Quantum Operations</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/visualization.html">   Visualization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/expectation_values.html">   Computing Expectation Values</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/simulators.html">   Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/hardware.html">   Quantum Hardware</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/nvqc.html">   NVIDIA Quantum Cloud</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/platform.html">   Multi-Processor Platforms</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/install/local_installation.html">Local Installation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/install/data_center_install.html">Data Center Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/libraries.html">Integrating with Third-Party Libraries</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="specification/cudaq.html">   Language Specification</a></li>
+<li class="toctree-l2"><a class="reference internal" href="specification/quake-dialect.html">   Quake Specification</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/cpp_api.html">C++ API</a></li>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/python_api.html">Python API</a></li>
+<li class="toctree-l2"><a class="reference internal" href="api/default_ops.html">Quantum Operations</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="versions.html">   Other Versions</a></li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="using/quick_start.html" class="btn btn-neutral float-right" title="Quick Start" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/notebook_validation.py b/pr-2241/notebook_validation.py
new file mode 100644
index 0000000000..e0d464af93
--- /dev/null
+++ b/pr-2241/notebook_validation.py
@@ -0,0 +1,110 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+import os
+import re
+import sys
+from pathlib import Path
+import subprocess
+from shutil import which
+
+if which('jupyter') is None:
+    print("Please install jupyter, e.g. with `pip install notebook`.")
+    exit(1)
+
+
+def read_available_backends():
+    available_backends = sys.stdin.readlines()
+    available_backends = ' '.join(available_backends).split()
+    return [backend.strip() for backend in available_backends]
+
+
+def validate(notebook_filename, available_backends):
+    with open(notebook_filename) as f:
+        lines = f.readlines()
+    for notebook_content in lines:
+        match = re.search('set_target[\\\s\(]+"(.+)\\\\"[)]', notebook_content)
+        if match and (match.group(1) not in available_backends):
+            return False
+    for notebook_content in lines:
+        match = re.search('--target ([^ ]+)', notebook_content)
+        if match and (match.group(1) not in available_backends):
+            return False
+    return True
+
+
+def execute(notebook_filename):
+    notebook_filename_out = notebook_filename.replace('.ipynb',
+                                                      '.nbconvert.ipynb')
+    try:
+        subprocess.run([
+            "jupyter", "nbconvert", "--to", "notebook", "--execute",
+            notebook_filename
+        ],
+                       check=True)
+        os.remove(notebook_filename_out)
+        return True
+    except subprocess.CalledProcessError:
+        print('Error executing the notebook "%s".\n\n' % notebook_filename)
+        return False
+
+
+def print_results(success, failed, skipped=[]):
+    if success:
+        print("Success! The following notebook(s) executed successfully:\n" +
+              " ".join(success))
+
+    if failed:
+        print(
+            "::error::The following notebook(s) raised one or more errors:\n" +
+            " ".join(failed))
+
+    if skipped:
+        print("::warning::Skipped validation for the following notebook(s):\n" +
+              " ".join(skipped))
+
+    if not failed and not skipped:
+        print("Success! All the notebook(s) executed successfully.")
+    elif failed:
+        exit(1)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1:
+        notebook_filenames = sys.argv[1:]
+        notebooks_success, notebooks_failed = ([] for i in range(2))
+        for notebook_filename in notebook_filenames:
+            if (execute(notebook_filename)):
+                notebooks_success.append(notebook_filename)
+            else:
+                notebooks_failed.append(notebook_filename)
+        print_results(notebooks_success, notebooks_failed)
+    else:
+        available_backends = read_available_backends()
+        notebook_filenames = [
+            str(fn.relative_to(Path(__file__).parent))
+            for fn in Path(__file__).parent.rglob('*.ipynb')
+            if not fn.name.endswith('.nbconvert.ipynb')
+        ]
+
+        if not notebook_filenames:
+            print('Failed! No notebook(s) found.')
+            exit(10)
+
+        notebooks_success, notebooks_skipped, notebooks_failed = (
+            [] for i in range(3))
+        for notebook_filename in notebook_filenames:
+            if (validate(notebook_filename, available_backends)):
+                if (execute(notebook_filename)):
+                    notebooks_success.append(notebook_filename)
+                else:
+                    notebooks_failed.append(notebook_filename)
+            else:
+                notebooks_skipped.append(notebook_filename)
+
+        print_results(notebooks_success, notebooks_failed, notebooks_skipped)
diff --git a/pr-2241/objects.inv b/pr-2241/objects.inv
new file mode 100644
index 0000000000..017e639a30
Binary files /dev/null and b/pr-2241/objects.inv differ
diff --git a/pr-2241/openapi.html b/pr-2241/openapi.html
new file mode 100644
index 0000000000..757ce743f1
--- /dev/null
+++ b/pr-2241/openapi.html
@@ -0,0 +1,313 @@
+<!DOCTYPE html>
+<html>
+  <head />
+  <body>
+    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
+    <div id="redoc-container"></div>
+	<script type="application/json" id="openapi-spec">
+    {
+  "swagger": "2.0",
+  "info": {
+    "title": "CUDA-Q Remote Simulation Runtime REST API",
+    "version": "1.0.0"
+  },
+  "paths": {
+    "/job": {
+      "post": {
+        "summary": "Create a quantum simulation job",
+        "description": "Requests execution (simulation) of quantun kernels on the server. The server employs long polling, hence it will keep the request open until the simulation completed.\n",
+        "parameters": [
+          {
+            "name": "job request",
+            "in": "body",
+            "schema": {
+              "$ref": "#/definitions/RestRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Execution results.",
+            "schema": {
+              "type": "object",
+              "required": [
+                "executionContext"
+              ],
+              "properties": {
+                "executionContext": {
+                  "$ref": "#/definitions/ResultExecutionContext"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "RestRequest": {
+      "type": "object",
+      "required": [
+        "version",
+        "entryPoint",
+        "code",
+        "format",
+        "executionContext"
+      ],
+      "properties": {
+        "version": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Version number of the payload. Each REST server version only supports a specific payload version.",
+          "example": 1
+        },
+        "clientVersion": {
+          "type": "string",
+          "description": "Version description of the CUDA-Q client generating the request.",
+          "example": "CUDA-Q Version 0.7.0 (https://github.com/NVIDIA/cuda-quantum 8650fb9d79e7e780ea95d9506a513162daf84b80)"
+        },
+        "entryPoint": {
+          "type": "string",
+          "description": "Entry point kernel identifier as a fully-qualified name.",
+          "example": "ns::ghz"
+        },
+        "simulator": {
+          "type": "string",
+          "description": "Name of the backend simulator to be used.",
+          "example": "nvidia-mgpu"
+        },
+        "executionContext": {
+          "type": "object",
+          "description": "Context to indicate how the CUDA-Q kernel should be executed.",
+          "$ref": "#/definitions/RequestExecutionContext"
+        },
+        "code": {
+          "type": "string",
+          "format": "binary",
+          "description": "Base64 encoded CUDA-Q kernel IR (Intermediate Representation)."
+        },
+        "args": {
+          "type": "string",
+          "format": "binary",
+          "description": "Base64 encoded kernel arguments."
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "MLIR",
+            "LLVM"
+          ],
+          "description": "Format of the code IR."
+        },
+        "seed": {
+          "type": "integer",
+          "format": "int64",
+          "example": 123,
+          "description": "Random seed value for the simulation."
+        },
+        "passes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "example": [
+            "inline",
+            "canonicalize",
+            "quake-to-qir"
+          ],
+          "description": "List of IR passes to be applied on the server."
+        }
+      }
+    },
+    "RequestExecutionContext": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "enum": [
+            "sample",
+            "observe",
+            "extract-state"
+          ],
+          "description": "Name of the execution context."
+        },
+        "shots": {
+          "type": "integer",
+          "description": "Number of measurement shots.",
+          "example": 1000
+        },
+        "hasConditionalsOnMeasureResults": {
+          "type": "boolean",
+          "description": "Flag to indicate that the kernel being executed in this context has conditional statements on measure results.",
+          "example": "false"
+        },
+        "registerNames": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "For mid-circuit measurements in library mode keep track of the register names."
+        },
+        "spin": {
+          "type": "object",
+          "description": "Optional spin operator. Required for \"observe\" execution context.",
+          "$ref": "#/definitions/spin_op"
+        }
+      }
+    },
+    "ResultExecutionContext": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "enum": [
+            "sample",
+            "observe",
+            "extract-state"
+          ],
+          "description": "Name of the execution context."
+        },
+        "shots": {
+          "type": "integer",
+          "description": "Number of measurement shots.",
+          "example": 1000
+        },
+        "hasConditionalsOnMeasureResults": {
+          "type": "boolean",
+          "description": "Flag to indicate that the kernel being executed in this context has conditional statements on measure results.",
+          "example": "false"
+        },
+        "registerNames": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "For mid-circuit measurements in library mode keep track of the register names."
+        },
+        "spin": {
+          "type": "object",
+          "description": "Optional spin operator. Required for \"observe\" execution context.",
+          "$ref": "#/definitions/spin_op"
+        },
+        "result": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/ExecutionResult"
+          },
+          "description": "Execution result being populated by the server after execution."
+        },
+        "expectationValue": {
+          "type": "number",
+          "format": "double",
+          "example": 0.1234,
+          "description": "Optional computed expectation value."
+        },
+        "simulationData": {
+          "type": "object",
+          "description": "Underlying simulation data when using \"extract-state\" execution context.",
+          "properties": {
+            "dim": {
+              "type": "array",
+              "items": {
+                "type": "integer",
+                "example": 8
+              },
+              "description": "Dimensions of the state representation (flattened multi-dimensional arrays)."
+            },
+            "data": {
+              "type": "array",
+              "items": {
+                "type": "array",
+                "example": [
+                  0.5,
+                  0.5
+                ],
+                "items": {
+                  "type": "number",
+                  "format": "double"
+                }
+              },
+              "description": "State data as a vector of complex numbers. Each complex number is represented as an array of size 2 for the real and imaginary parts."
+            }
+          }
+        }
+      }
+    },
+    "spin_op": {
+      "type": "object",
+      "required": [
+        "num_qubits",
+        "data"
+      ],
+      "properties": {
+        "num_qubits": {
+          "type": "integer",
+          "description": "Number of qubits (spins) represented.",
+          "example": 4
+        },
+        "data": {
+          "type": "array",
+          "items": {
+            "type": "number",
+            "format": "double"
+          },
+          "description": "Serialized representation of this spin_op (as an array of floating point numbers)"
+        }
+      }
+    },
+    "ExecutionResult": {
+      "type": "object",
+      "properties": {
+        "counts": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer"
+          },
+          "description": "Measurements and times observed",
+          "example": {
+            "00": 500,
+            "11": 500
+          }
+        },
+        "registerName": {
+          "type": "string",
+          "description": "Register name for the classical bits.",
+          "example": "res0"
+        },
+        "sequentialData": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Sequential bit strings observed (not collated into a map)",
+          "example": [
+            "00",
+            "10"
+          ]
+        },
+        "expectationValue": {
+          "type": "number",
+          "format": "double",
+          "description": "Optional <Z...Z> expected value",
+          "example": 1.234
+        }
+      }
+    }
+  }
+}
+	</script>
+  <script>
+    var spec = JSON.parse(document.getElementById("openapi-spec").innerHTML);
+    Redoc.init(spec, {
+      "expandResponses": "200"
+    }, document.getElementById('redoc-container'))
+  </script>
+  </body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/py-modindex.html b/pr-2241/py-modindex.html
new file mode 100644
index 0000000000..b9afa235d8
--- /dev/null
+++ b/pr-2241/py-modindex.html
@@ -0,0 +1,665 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Python Module Index &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/sphinx_highlight.js"></script>
+        <script src="_static/tabs.js"></script>
+        <script src="_static/clipboard.min.js"></script>
+        <script src="_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+ 
+
+    <script>
+      DOCUMENTATION_OPTIONS.COLLAPSE_INDEX = true;
+    </script>
+
+
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Python Module Index</li>
+      <li class="wy-breadcrumbs-aside">
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+
+   <h1>Python Module Index</h1>
+
+   <div class="modindex-jumpbox">
+   <a href="#cap-c"><strong>c</strong></a>
+   </div>
+
+   <table class="indextable modindextable">
+     <tr class="pcap"><td></td><td>&#160;</td><td></td></tr>
+     <tr class="cap" id="cap-c"><td></td><td>
+       <strong>c</strong></td><td></td></tr>
+     <tr>
+       <td></td>
+       <td>
+       <a href="api/languages/python_api.html#module-cudaq"><code class="xref">cudaq</code></a></td><td>
+       <em></em></td></tr>
+   </table>
+
+
+           </div>
+          </div>
+          <footer>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/releases.html b/pr-2241/releases.html
new file mode 100644
index 0000000000..847fe98a59
--- /dev/null
+++ b/pr-2241/releases.html
@@ -0,0 +1,754 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Releases &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/sphinx_highlight.js"></script>
+        <script src="_static/tabs.js"></script>
+        <script src="_static/clipboard.min.js"></script>
+        <script src="_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">CUDA-Q Releases</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="_sources/releases.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-releases">
+<h1>CUDA-Q Releases<a class="headerlink" href="#cuda-q-releases" title="Permalink to this heading">¶</a></h1>
+<p><strong>latest</strong></p>
+<p>The latest version of CUDA-Q is on the main branch of our <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a> and is also available as a Docker image. More information about installing the nightly builds can be found <a class="reference internal" href="using/install/install.html"><span class="doc">here</span></a></p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum">Docker image (nightly builds)</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/latest">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/main/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p><strong>0.8.0</strong></p>
+<p>The 0.8.0 release adds a range of changes to improve the ease of use and performance with CUDA-Q.
+The changes listed below highlight some of what we think will be the most useful features and changes
+to know about. While the listed changes do not capture all of the great contributions, we would like
+to extend many thanks for every contribution, in particular those from external contributors.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.8.0">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.8.0">C++ installer</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.8.0">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.8.0/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.8.0">here</a>.</p>
+<p><strong>0.7.1</strong></p>
+<p>The 0.7.1 release adds simulator optimizations with significant performance improvements and
+extends their functionalities. The <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> backend now supports user customization of the
+gate fusion level as controlled by the <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MGPU_FUSE</span></code> environment variable documented
+<a class="reference external" href="https://nvidia.github.io/cuda-quantum/latest/using/backends/simulators.html">here</a>.
+It furthermore adds a range of bug fixes and changes the Python wheel installation instructions.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.7.1">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.7.1">C++ installer</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.7.1">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.7.1/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.7.1">here</a>.</p>
+<p><strong>0.7.0</strong></p>
+<p>The 0.7.0 release adds support for using <a class="reference internal" href="using/backends/nvqc.html"><span class="doc">NVIDIA Quantum Cloud</span></a>,
+giving you access to our most powerful GPU-accelerated simulators even if you don’t have an NVIDIA GPU.
+With 0.7.0, we have furthermore greatly increased expressiveness of the Python and C++ language frontends.
+Check out our <a class="reference external" href="https://nvidia.github.io/cuda-quantum/latest/using/quick_start.html">documentation</a>
+to get started with the new Python syntax support we have added, and <a class="reference external" href="https://developer.nvidia.com/cuda-q">follow our blog</a>
+to learn more about the new setup and its performance benefits.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.7.0">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.7.0">C++ installer</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.7.0">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.7.0/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.7.0">here</a>.</p>
+<p><strong>0.6.0</strong></p>
+<p>The 0.6.0 release contains improved support for various HPC scenarios. We have added a
+<a class="reference internal" href="using/install/local_installation.html#distributed-computing-with-mpi"><span class="std std-ref">plugin infrastructure</span></a> for connecting CUDA-Q
+with an existing MPI installation, and we’ve added a <a class="reference internal" href="using/backends/platform.html#id1"><span class="std std-ref">new platform target</span></a> that distributes workloads across multiple virtual QPUs,
+each simulated by one or more GPUs.</p>
+<p>Starting with 0.6.0, we are now also distributing
+<a class="reference internal" href="using/install/local_installation.html#install-prebuilt-binaries"><span class="std std-ref">pre-built binaries</span></a> for using CUDA-Q with C++.
+The binaries are built against the <a class="reference external" href="https://www.gnu.org/software/libc/">GNU C library</a>
+version 2.28.
+We’ve added a detailed <a class="reference internal" href="using/install/data_center_install.html"><span class="doc">Building from Source</span></a> guide to build these binaries for older <code class="code docutils literal notranslate"><span class="pre">glibc</span></code> versions.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.6.0">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.6.0">C++ installer</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.6.0">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.6.0/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.6.0">here</a>.</p>
+<p><strong>0.5.0</strong></p>
+<p>With 0.5.0 we have added support for quantum kernel execution on OQC and IQM backends. For more information, see <a class="reference internal" href="using/backends/hardware.html"><span class="doc">CUDA-Q Hardware Backends</span></a>.
+CUDA-Q now allows to executing adaptive quantum kernels on quantum hardware backends that support it.
+The 0.5.0 release furthermore improves the tensor network simulation tools and adds a matrix product state simulator, see <a class="reference internal" href="using/backends/simulators.html"><span class="doc">CUDA-Q Simulation Backends</span></a>.</p>
+<p>Additionally, we are now publishing images for experimental features, which currently includes improved Python language support.
+Please take a look at <a class="reference internal" href="using/install/install.html"><span class="doc">Installation Guide</span></a> for more information about how to obtain them.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.5.0">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.5.0">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.5.0/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.5.0">here</a>.</p>
+<p><strong>0.4.1</strong></p>
+<p>The 0.4.1 release adds support for ARM processors in the form of multi-platform Docker images and <code class="code docutils literal notranslate"><span class="pre">aarch64</span></code> Python wheels. Additionally, all GPU-based backends are now included in the Python wheels as well as in the Docker image.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.4.1">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.4.1">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.4.1/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/0.4.1">here</a>.</p>
+<p><strong>0.4.0</strong></p>
+<p>CUDA-Q is now available on PyPI!
+The 0.4.0 release adds support for quantum kernel execution on Quantinuum and IonQ backends. For more information, see <a class="reference internal" href="using/backends/hardware.html"><span class="doc">CUDA-Q Hardware Backends</span></a>.</p>
+<p>The 0.4.0 PyPI release does not yet include all of the GPU-based backends.
+The fully featured version is available as a Docker image for <code class="code docutils literal notranslate"><span class="pre">linux/amd64</span></code> platforms.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://pypi.org/project/cuda-quantum/0.4.0">Python wheel</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.4.0">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/0.4.0/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+<p>The full change log can be found <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases/tag/0.4.0">here</a>.</p>
+<p><strong>0.3.0</strong></p>
+<p>The 0.3.0 release of CUDA-Q is available as a Docker image for <code class="code docutils literal notranslate"><span class="pre">linux/amd64</span></code> platforms.</p>
+<ul class="simple">
+<li><p><a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">Docker image</a></p></li>
+<li><p><a class="reference external" href="https://nvidia.github.io/cuda-quantum/0.3.0">Documentation</a></p></li>
+<li><p><a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/0.3.0/docs/sphinx/examples">Examples</a></p></li>
+</ul>
+</section>
+
+
+           </div>
+          </div>
+          <footer>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/search.html b/pr-2241/search.html
new file mode 100644
index 0000000000..4d1bdeb8b2
--- /dev/null
+++ b/pr-2241/search.html
@@ -0,0 +1,662 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Search &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="_static/_static/cudaq_override.css" type="text/css" />
+    
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
+        <script src="_static/jquery.js"></script>
+        <script src="_static/underscore.js"></script>
+        <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="_static/doctools.js"></script>
+        <script src="_static/sphinx_highlight.js"></script>
+        <script src="_static/tabs.js"></script>
+        <script src="_static/clipboard.min.js"></script>
+        <script src="_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="_static/js/theme.js"></script>
+    <script src="_static/searchtools.js"></script>
+    <script src="_static/language_data.js"></script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="#" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="#" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Search</li>
+      <li class="wy-breadcrumbs-aside">
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <noscript>
+  <div id="fallback" class="admonition warning">
+    <p class="last">
+      Please activate JavaScript to enable the search functionality.
+    </p>
+  </div>
+  </noscript>
+
+  
+  <div id="search-results">
+  
+  </div>
+
+           </div>
+          </div>
+          <footer>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>
+  <script>
+    jQuery(function() { Search.loadIndex("searchindex.js"); });
+  </script>
+  
+  <script id="searchindexloader"></script>
+    
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/searchindex.js b/pr-2241/searchindex.js
new file mode 100644
index 0000000000..ac8755e6f9
--- /dev/null
+++ b/pr-2241/searchindex.js
@@ -0,0 +1 @@
+Search.setIndex({"docnames": ["api/api", "api/default_ops", "api/languages/cpp_api", "api/languages/python_api", "examples/python/tutorials/Divisive_clustering", "examples/python/tutorials/H2-MRQKS", "examples/python/tutorials/Shors", "examples/python/tutorials/afqmc", "examples/python/tutorials/cost_minimization", "examples/python/tutorials/deutschs_algorithm", "examples/python/tutorials/hadamard_test", "examples/python/tutorials/hybrid_qnns", "examples/python/tutorials/maximum_vertex_weight_clique", "examples/python/tutorials/noisy_simulations", "examples/python/tutorials/qaoa", "examples/python/tutorials/quantum_fourier_transform", "examples/python/tutorials/readout_error_mitigation", "examples/python/tutorials/unitary_compilation", "examples/python/tutorials/visualization", "examples/python/tutorials/vqe", "examples/python/tutorials/vqe_water_active_space", "index", "releases", "specification/cudaq", "specification/cudaq/algorithmic_primitives", "specification/cudaq/control_flow", "specification/cudaq/dynamic_kernels", "specification/cudaq/examples", "specification/cudaq/kernels", "specification/cudaq/machine_model", "specification/cudaq/namespace", "specification/cudaq/operations", "specification/cudaq/operators", "specification/cudaq/patterns", "specification/cudaq/platform", "specification/cudaq/synthesis", "specification/cudaq/types", "specification/index", "specification/quake-dialect", "using/backends/backends", "using/backends/hardware", "using/backends/nvqc", "using/backends/platform", "using/backends/simulators", "using/basics/basics", "using/basics/build_kernel", "using/basics/kernel_intro", "using/basics/run_kernel", "using/basics/troubleshooting", "using/examples/bernstein_vazirani", "using/examples/cuquantum", "using/examples/examples", "using/examples/expectation_values", "using/examples/hardware_providers", "using/examples/introduction", "using/examples/multi_control", "using/examples/multi_gpu_workflows", "using/examples/noisy_simulation", "using/examples/qaoa", "using/examples/quantum_operations", "using/examples/vqe", "using/extending/cudaq_ir", "using/extending/extending", "using/extending/mlir_pass", "using/extending/nvqir_simulator", "using/install/data_center_install", "using/install/install", "using/install/local_installation", "using/integration/cmake_app", "using/integration/cuda_gpu", "using/integration/integration", "using/integration/libraries", "using/quick_start", "using/tutorials", "versions"], "filenames": ["api/api.rst", "api/default_ops.rst", "api/languages/cpp_api.rst", "api/languages/python_api.rst", "examples/python/tutorials/Divisive_clustering.ipynb", "examples/python/tutorials/H2-MRQKS.ipynb", "examples/python/tutorials/Shors.ipynb", "examples/python/tutorials/afqmc.ipynb", "examples/python/tutorials/cost_minimization.ipynb", "examples/python/tutorials/deutschs_algorithm.ipynb", "examples/python/tutorials/hadamard_test.ipynb", "examples/python/tutorials/hybrid_qnns.ipynb", "examples/python/tutorials/maximum_vertex_weight_clique.ipynb", "examples/python/tutorials/noisy_simulations.ipynb", "examples/python/tutorials/qaoa.ipynb", "examples/python/tutorials/quantum_fourier_transform.ipynb", "examples/python/tutorials/readout_error_mitigation.ipynb", "examples/python/tutorials/unitary_compilation.ipynb", "examples/python/tutorials/visualization.ipynb", "examples/python/tutorials/vqe.ipynb", "examples/python/tutorials/vqe_water_active_space.ipynb", "index.rst", "releases.rst", "specification/cudaq.rst", "specification/cudaq/algorithmic_primitives.rst", "specification/cudaq/control_flow.rst", "specification/cudaq/dynamic_kernels.rst", "specification/cudaq/examples.rst", "specification/cudaq/kernels.rst", "specification/cudaq/machine_model.rst", "specification/cudaq/namespace.rst", "specification/cudaq/operations.rst", "specification/cudaq/operators.rst", "specification/cudaq/patterns.rst", "specification/cudaq/platform.rst", "specification/cudaq/synthesis.rst", "specification/cudaq/types.rst", "specification/index.rst", "specification/quake-dialect.md", "using/backends/backends.rst", "using/backends/hardware.rst", "using/backends/nvqc.rst", "using/backends/platform.rst", "using/backends/simulators.rst", "using/basics/basics.rst", "using/basics/build_kernel.rst", "using/basics/kernel_intro.rst", "using/basics/run_kernel.rst", "using/basics/troubleshooting.rst", "using/examples/bernstein_vazirani.rst", "using/examples/cuquantum.rst", "using/examples/examples.rst", "using/examples/expectation_values.rst", "using/examples/hardware_providers.rst", "using/examples/introduction.rst", "using/examples/multi_control.rst", "using/examples/multi_gpu_workflows.rst", "using/examples/noisy_simulation.rst", "using/examples/qaoa.rst", "using/examples/quantum_operations.rst", "using/examples/vqe.rst", "using/extending/cudaq_ir.rst", "using/extending/extending.rst", "using/extending/mlir_pass.rst", "using/extending/nvqir_simulator.rst", "using/install/data_center_install.rst", "using/install/install.rst", "using/install/local_installation.rst", "using/integration/cmake_app.rst", "using/integration/cuda_gpu.rst", "using/integration/integration.rst", "using/integration/libraries.rst", "using/quick_start.rst", "using/tutorials.rst", "versions.rst"], "titles": ["Code documentation", "Quantum Operations", "CUDA-Q C++ API", "CUDA-Q Python API", "Divisive Clustering With Coresets Using CUDA-Q", "Multi-Reference Quantum Krylov Algorithm (H2 Example)", "Factoring Integers With Shor\u2019s Algorithm", "Quantum Enhanced Auxiliary Field Quantum Monte Carlo", "Cost Minimization", "Deutsch\u2019s Algorithm", "Hadamard Test and Application", "Hybrid Quantum Neural Networks", "Molecular docking via DC-QAOA", "Noisy Simulation", "Max-Cut with QAOA", "Quantum Fourier Transform", "Readout Error Mitigation", "Compiling Unitaries Using Diffusion Models", "Visualization", "Variational Quantum Eigensolver", "Water Molecule with Active Space (CPU vs. GPU)", "CUDA-Q", "CUDA-Q Releases", "Language Specification", "<span class=\"section-number\">12. </span>Quantum Algorithmic Primitives", "<span class=\"section-number\">8. </span>Control Flow", "<span class=\"section-number\">9. </span>Just-in-Time Kernel Creation", "<span class=\"section-number\">13. </span>Example Programs", "<span class=\"section-number\">6. </span>Quantum Kernels", "<span class=\"section-number\">1. </span>Machine Model", "<span class=\"section-number\">2. </span>Namespace and Standard", "<span class=\"section-number\">5. </span>Quantum Intrinsic Operations", "<span class=\"section-number\">4. </span>Quantum Operators", "<span class=\"section-number\">10. </span>Common Quantum Programming Patterns", "<span class=\"section-number\">11. </span>Quantum Platform", "<span class=\"section-number\">7. </span>Sub-circuit Synthesis", "<span class=\"section-number\">3. </span>Quantum Types", "Specifications", "Quake Dialect", "CUDA-Q Backends", "CUDA-Q Hardware Backends", "NVIDIA Quantum Cloud", "Multi-Processor Platforms", "CUDA-Q Simulation Backends", "CUDA-Q Basics", "Building your first CUDA-Q Program", "What is a CUDA-Q kernel?", "Running your first CUDA-Q Program", "Troubleshooting", "Bernstein-Vazirani", "Simulations with cuQuantum", "CUDA-Q by Example", "Computing Expectation Values", "Using Quantum Hardware Providers", "Introduction", "Multi-control Synthesis", "Multi-GPU Workflows", "Noisy Simulation", "Quantum Approximate Optimization Algorithm", "Quantum Computing 101", "Variational Quantum Eigensolver", "Working with the CUDA-Q IR", "Extending CUDA-Q", "Create your own CUDA-Q Compiler Pass", "Extending CUDA-Q with a new Simulator", "Installation from Source", "Installation Guide", "Local Installation", "CUDA-Q and CMake", "Using CUDA and CUDA-Q in a Project", "Integration with other Software Tools", "Integrating with Third-Party Libraries", "Quick Start", "CUDA-Q Tutorials", "CUDA-Q Versions"], "terms": {"c": [0, 1, 4, 5, 7, 14, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36, 41, 42, 43, 45, 47, 48, 49, 50, 51, 52, 53, 54, 55, 57, 58, 59, 60, 61, 67, 68, 69, 72, 74], "python": [0, 1, 2, 4, 18, 21, 22, 23, 24, 25, 26, 27, 28, 29, 31, 32, 33, 35, 36, 41, 42, 43, 45, 47, 48, 49, 50, 51, 52, 53, 54, 55, 57, 58, 60, 64, 71, 72, 73, 74], "quantum": [0, 3, 10, 13, 14, 16, 17, 18, 20, 21, 22, 23, 25, 26, 29, 35, 37, 38, 39, 40, 43, 45, 46, 47, 50, 51, 52, 54, 56, 57, 61, 64, 65, 67, 68, 69, 71, 72, 74], "oper": [0, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 17, 18, 21, 23, 24, 26, 27, 28, 29, 33, 35, 36, 37, 38, 40, 41, 43, 45, 47, 50, 51, 52, 53, 54, 55, 57, 58, 59, 60, 61, 63, 64, 65, 67, 72], "cuda": [1, 8, 9, 11, 12, 13, 14, 15, 18, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 41, 42, 48, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 70], "q": [1, 8, 9, 10, 11, 13, 14, 15, 18, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 41, 42, 48, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 70], "provid": [1, 2, 3, 4, 6, 7, 13, 15, 16, 17, 19, 21, 23, 24, 26, 29, 31, 32, 34, 35, 36, 38, 40, 41, 42, 43, 46, 50, 51, 52, 54, 55, 57, 60, 61, 63, 64, 65, 67, 68, 71], "default": [1, 2, 3, 12, 18, 24, 28, 31, 36, 40, 41, 42, 47, 50, 53, 54, 60, 61, 64, 65, 67, 69, 71, 72], "set": [1, 2, 3, 4, 7, 8, 9, 11, 14, 16, 17, 18, 21, 24, 26, 28, 31, 38, 41, 42, 43, 45, 47, 49, 50, 53, 57, 58, 60, 65, 67, 71, 72], "These": [1, 2, 6, 13, 14, 17, 23, 28, 31, 35, 36, 38, 39, 41, 42, 43, 61, 65, 67], "can": [1, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 35, 36, 38, 39, 40, 41, 42, 43, 45, 46, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 69, 70, 71, 72, 74], "us": [1, 2, 3, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 16, 18, 20, 21, 22, 24, 25, 26, 27, 28, 31, 32, 34, 35, 38, 40, 41, 42, 43, 45, 46, 47, 49, 51, 52, 54, 56, 58, 59, 60, 61, 63, 64, 65, 68, 71, 72, 74], "kernel": [1, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 27, 29, 31, 32, 33, 34, 35, 36, 37, 40, 41, 43, 44, 45, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 69, 71, 72, 74], "librari": [1, 2, 6, 11, 12, 18, 19, 21, 22, 23, 28, 30, 35, 36, 43, 52, 61, 63, 64, 67, 69, 70, 74], "sinc": [1, 2, 6, 7, 9, 14, 15, 16, 17, 36, 39, 42, 43, 46, 52, 53, 56, 60, 61, 67, 68, 71], "intrins": [1, 28, 35, 36, 38], "nativ": [1, 23, 29, 31, 32, 68], "support": [1, 2, 3, 7, 16, 18, 21, 22, 23, 28, 29, 31, 33, 36, 40, 46, 47, 50, 53, 54, 57, 58, 59, 60, 63, 71, 72, 74], "specif": [1, 2, 3, 4, 17, 21, 24, 28, 30, 31, 32, 33, 36, 38, 40, 41, 42, 43, 46, 47, 54, 59, 61, 64, 65, 67, 69, 71], "target": [1, 2, 3, 4, 9, 10, 11, 13, 14, 18, 20, 22, 24, 31, 34, 38, 40, 41, 42, 43, 47, 49, 50, 52, 53, 55, 57, 59, 61, 63, 64, 65, 67, 72, 74], "depend": [1, 3, 4, 6, 9, 14, 17, 24, 29, 38, 41, 42, 43, 49, 60, 71, 72], "backend": [1, 2, 4, 8, 21, 22, 24, 42, 47, 49, 50, 53, 56, 57, 61, 64, 65, 67, 71, 72, 74], "architectur": [1, 2, 11, 21, 23, 29, 38, 40, 42, 53, 56, 59, 64, 65, 67, 72], "nvq": [1, 24, 27, 40, 41, 42, 43, 47, 50, 52, 53, 54, 55, 57, 60, 61, 64, 67, 68, 69, 71, 72], "compil": [1, 2, 3, 4, 21, 23, 24, 27, 28, 29, 33, 35, 36, 40, 41, 42, 43, 47, 50, 52, 53, 54, 55, 57, 60, 61, 64, 65, 67, 68, 69, 72], "automat": [1, 29, 40, 42, 43, 53, 60, 65, 67, 71], "decompos": [1, 7, 17], "appropri": [1, 2, 4, 9, 15, 23, 31, 42, 65, 67], "The": [1, 2, 3, 4, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23, 24, 26, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 47, 49, 50, 52, 53, 54, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 69, 71, 72, 74], "section": [1, 6, 9, 15, 17, 26, 42, 43, 65, 67, 71, 72], "list": [1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 14, 15, 16, 18, 19, 20, 22, 24, 28, 39, 40, 41, 43, 49, 53, 56, 58, 59, 60, 65, 67, 71, 72, 74], "implement": [1, 2, 3, 6, 7, 9, 13, 14, 15, 17, 23, 24, 29, 30, 31, 33, 35, 36, 38, 40, 43, 53, 54, 58, 61, 63, 64, 65, 67, 71], "transform": [1, 7, 9, 11, 17, 20, 21, 23, 27, 61, 63], "state": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 13, 14, 15, 16, 17, 18, 19, 22, 24, 28, 29, 31, 36, 38, 41, 45, 47, 49, 50, 52, 53, 54, 56, 57, 58, 60, 64, 65, 71, 72, 74], "ar": [1, 2, 3, 4, 6, 7, 9, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 24, 25, 26, 28, 29, 31, 33, 35, 36, 37, 38, 40, 41, 42, 43, 46, 47, 51, 52, 53, 54, 56, 59, 60, 61, 64, 65, 67, 69, 71, 72, 74], "templat": [1, 2, 19, 24, 26, 27, 28, 31, 35, 36, 53, 54, 61, 63, 64, 69, 71], "argument": [1, 2, 3, 4, 9, 14, 16, 18, 24, 26, 28, 35, 36, 40, 45, 47, 52, 55, 56, 60, 61, 64, 67, 71], "allow": [1, 2, 3, 4, 7, 8, 9, 11, 17, 22, 24, 26, 28, 29, 43, 45, 46, 47, 55, 56, 57, 59, 60, 61, 63, 67, 68, 74], "invok": [1, 2, 3, 24, 26, 28, 33, 40, 43, 54, 61, 71], "version": [1, 3, 6, 7, 11, 14, 15, 17, 21, 22, 24, 33, 39, 40, 41, 42, 43, 47, 61, 64, 65, 67, 68, 71, 72], "see": [1, 2, 3, 4, 6, 8, 9, 15, 17, 18, 22, 24, 26, 28, 36, 38, 39, 40, 41, 42, 43, 45, 47, 49, 54, 56, 57, 58, 59, 61, 63, 65, 67, 68, 69, 71, 72, 74], "addition": [1, 6, 22, 67, 74], "overload": [1, 3, 24, 31, 32, 36, 38], "broadcast": [1, 2, 3, 14, 31], "singl": [1, 2, 3, 4, 5, 7, 15, 18, 19, 24, 27, 28, 29, 31, 36, 40, 41, 42, 47, 52, 53, 54, 56, 57, 59, 60, 61, 71], "across": [1, 2, 3, 9, 17, 22, 31, 41, 42, 43, 53, 65, 67, 74], "vector": [1, 2, 3, 4, 5, 7, 8, 11, 17, 18, 24, 26, 27, 28, 31, 34, 36, 38, 41, 42, 49, 50, 53, 54, 55, 56, 58, 60, 64, 65], "For": [1, 2, 3, 4, 6, 7, 9, 14, 15, 16, 17, 18, 22, 24, 26, 31, 38, 40, 41, 42, 43, 45, 46, 47, 48, 49, 53, 55, 56, 58, 59, 60, 64, 65, 67, 69, 71, 72, 74], "exampl": [1, 3, 4, 6, 7, 8, 9, 11, 13, 14, 15, 17, 18, 21, 22, 23, 24, 26, 31, 37, 38, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 56, 57, 59, 60, 63, 64, 65, 67, 68, 69, 71, 72, 74], "cudaq": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 25, 26, 27, 28, 30, 33, 34, 35, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 71, 72], "qvector": [1, 2, 3, 4, 5, 6, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 24, 27, 28, 31, 35, 41, 42, 45, 47, 49, 50, 52, 53, 55, 56, 58, 59, 60, 61, 71, 72], "flip": [1, 2, 3, 8, 13, 16, 57, 59], "each": [1, 2, 3, 4, 9, 10, 14, 15, 16, 17, 18, 22, 24, 26, 29, 34, 38, 40, 41, 42, 43, 47, 53, 56, 57, 58, 59, 60, 61, 65, 67, 71, 72, 74], "thi": [1, 2, 3, 4, 6, 7, 9, 10, 12, 13, 14, 15, 16, 17, 18, 20, 23, 24, 26, 27, 28, 29, 30, 31, 33, 36, 38, 40, 41, 42, 43, 45, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 65, 67, 68, 69, 71, 72], "pauli": [1, 2, 3, 4, 5, 10, 12, 14, 24, 32, 47, 59, 60], "matrix": [1, 2, 3, 5, 7, 10, 13, 14, 17, 18, 22, 39, 41, 57, 59, 64, 74], "It": [1, 2, 4, 9, 15, 16, 17, 18, 21, 22, 24, 31, 36, 38, 42, 47, 57, 59, 61, 64, 67, 69, 72, 74], "i": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 26, 27, 28, 29, 30, 31, 32, 33, 36, 38, 39, 40, 41, 42, 43, 44, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 69, 71, 72, 74], "also": [1, 2, 3, 4, 6, 9, 13, 15, 16, 17, 18, 19, 22, 24, 28, 32, 40, 41, 42, 43, 45, 46, 47, 53, 56, 59, 60, 61, 63, 64, 65, 67, 69, 72, 74], "known": [1, 2, 6, 17, 28, 54, 61], "NOT": [1, 24, 31, 59], "gate": [1, 2, 3, 4, 6, 8, 9, 11, 13, 14, 15, 16, 17, 18, 22, 31, 35, 36, 38, 40, 43, 45, 49, 54, 55, 57, 60, 64, 74], "appli": [1, 2, 3, 6, 9, 11, 13, 14, 15, 16, 17, 24, 27, 28, 31, 35, 38, 41, 42, 45, 49, 54, 55, 57, 59, 60, 61, 64], "0": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 26, 27, 28, 31, 32, 33, 34, 36, 38, 39, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 64, 65, 67, 69, 71, 72, 74], "1": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 38, 40, 41, 42, 43, 45, 47, 48, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 64, 65, 67, 71, 72, 74], "rotat": [1, 3, 4, 6, 13, 14, 15, 16, 18, 31, 32, 45, 52, 57, 60, 64], "\u03c0": [1, 57], "about": [1, 2, 4, 6, 9, 16, 17, 18, 19, 22, 24, 38, 41, 42, 43, 46, 47, 53, 56, 57, 65, 67, 69, 70, 71, 72, 74], "axi": [1, 11, 17, 18, 19, 57], "enabl": [1, 2, 3, 4, 15, 23, 24, 26, 28, 29, 31, 33, 34, 35, 36, 39, 42, 43, 46, 47, 52, 53, 56, 61, 64, 65, 67, 71, 72], "one": [1, 2, 3, 4, 6, 7, 8, 9, 14, 15, 17, 18, 22, 24, 26, 27, 29, 31, 34, 38, 40, 41, 42, 43, 48, 52, 53, 55, 56, 59, 60, 61, 63, 64, 65, 67, 71, 72, 74], "creat": [1, 2, 3, 4, 6, 13, 14, 15, 16, 17, 18, 19, 21, 24, 26, 32, 35, 40, 41, 42, 46, 47, 53, 54, 56, 57, 58, 60, 61, 62, 64, 65, 67, 68, 69, 71, 72], "superposit": [1, 9, 14, 18, 24, 27, 36, 42, 45, 47, 49, 57, 58, 59], "comput": [1, 2, 3, 4, 5, 6, 7, 9, 11, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 26, 27, 28, 34, 36, 38, 41, 42, 43, 46, 47, 51, 56, 58, 60, 64, 65, 69, 71, 72], "basi": [1, 2, 3, 5, 7, 13, 15, 16, 17, 20, 36, 41, 42, 57, 59, 60], "sqrt": [1, 3, 5, 9, 10, 13, 15, 16, 18, 27, 57, 59, 72], "2": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 38, 40, 41, 42, 43, 47, 49, 52, 53, 55, 56, 57, 58, 59, 60, 61, 65, 67, 69, 71, 72, 74], "an": [1, 2, 3, 4, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21, 22, 24, 26, 28, 29, 31, 32, 34, 35, 36, 38, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 55, 56, 57, 59, 60, 61, 62, 63, 64, 65, 67, 69, 72, 73, 74], "arbitrari": [1, 2, 3, 17, 40, 55, 71], "\u03bb": 1, "exp": [1, 2, 5, 6, 27, 32], "i\u03bb": 1, "math": [1, 6, 7, 9, 41], "pi": [1, 4, 6, 10, 11, 12, 14, 15, 18, 19, 27, 28, 33, 35, 40, 41, 53, 58], "std": [1, 2, 3, 24, 26, 27, 28, 31, 32, 34, 35, 36, 41, 42, 47, 49, 53, 54, 56, 58, 60, 63, 64, 69, 71], "number": [1, 2, 3, 4, 6, 7, 9, 10, 11, 12, 14, 15, 16, 17, 18, 19, 20, 24, 27, 32, 34, 36, 38, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 55, 56, 59, 60, 61, 64, 67, 72], "\u03b8": 1, "co": [1, 15, 18], "isin": 1, "sin": [1, 15, 18], "its": [1, 2, 3, 4, 7, 8, 9, 12, 13, 14, 15, 16, 22, 23, 24, 34, 36, 38, 41, 42, 43, 47, 49, 54, 58, 59, 60, 61, 64, 65, 67, 71, 72, 73, 74], "4": [1, 3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 26, 27, 28, 29, 31, 32, 33, 34, 35, 36, 40, 41, 42, 43, 53, 56, 58, 60, 61, 65, 67, 71, 74], "i\u03c0": 1, "two": [1, 2, 3, 4, 6, 7, 9, 10, 12, 13, 14, 16, 17, 18, 29, 38, 40, 42, 47, 52, 53, 55, 57, 59, 67, 71], "qubit_1": [1, 9, 14], "qubit_2": 1, "univers": [1, 4, 17, 41, 59], "three": [1, 6, 16, 17, 29, 40, 41, 52], "paramet": [1, 2, 3, 4, 5, 6, 8, 11, 12, 14, 17, 19, 20, 24, 28, 31, 36, 40, 41, 45, 50, 52, 53, 54, 56, 58, 60, 64, 65], "euler": 1, "angl": [1, 2, 3, 6, 8, 10, 15, 16, 18, 27, 28, 31, 42, 45, 52, 53, 60], "theta": [1, 4, 10, 11, 12, 13, 14, 15, 18, 19, 20, 24, 26, 27, 41, 42, 52, 58, 60], "phi": [1, 7, 10, 24, 26, 61], "\u03c6": 1, "lambda": [1, 2, 4, 5, 6, 12, 14, 16, 24, 27, 28, 33, 55, 56, 60, 61], "i\u03c6": 1, "np": [1, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 27, 28, 33, 35, 40, 42, 43, 53, 56, 57, 58, 65], "m_pi": [1, 27, 35, 53, 58], "m_pi_2": [1, 27, 28, 41], "adj": [1, 31], "method": [1, 2, 3, 4, 6, 7, 9, 11, 16, 17, 19, 20, 24, 26, 31, 36, 42, 43, 47, 54], "ani": [1, 2, 3, 4, 6, 13, 14, 17, 18, 24, 28, 30, 31, 33, 35, 36, 40, 41, 43, 45, 47, 48, 53, 54, 55, 57, 64, 65, 67, 71, 72], "alloc": [1, 2, 3, 8, 14, 17, 24, 26, 27, 28, 29, 36, 42, 43, 45, 47, 49, 54, 55, 57, 60, 64], "now": [1, 4, 6, 7, 9, 10, 14, 15, 17, 19, 22, 38, 47, 53, 54, 55, 56, 57, 58, 67, 72, 74], "again": [1, 24, 38, 57, 67, 69], "initi": [1, 2, 3, 4, 5, 6, 7, 8, 12, 14, 15, 19, 20, 24, 40, 42, 53, 56, 57, 58, 59, 60, 65, 67], "ctrl": [1, 2, 6, 9, 14, 18, 24, 26, 27, 31, 41, 42, 45, 49, 50, 52, 53, 54, 55, 58, 59, 60, 61, 67, 72], "condit": [1, 2, 13, 15, 17, 24, 25, 26, 28, 29, 43, 46, 59, 61], "more": [1, 2, 3, 4, 6, 7, 12, 14, 15, 16, 17, 18, 22, 26, 29, 31, 32, 38, 40, 41, 42, 43, 46, 47, 53, 56, 58, 59, 60, 65, 67, 69, 71, 72, 74], "wikipedia": 1, "entri": [1, 24, 28, 42, 53, 61, 67, 71], "ctrl_1": 1, "ctrl_2": 1, "00": [1, 4, 7, 13, 18, 47, 56, 59, 71, 72], "11": [1, 3, 4, 5, 7, 13, 16, 18, 24, 41, 47, 56, 59, 61, 65, 67, 71, 72], "onli": [1, 2, 3, 4, 6, 16, 17, 18, 24, 28, 29, 33, 36, 38, 40, 41, 42, 46, 49, 50, 53, 59, 61, 63, 65, 67, 71, 72], "both": [1, 3, 6, 7, 9, 11, 29, 38, 40, 42, 43, 59, 60, 65, 67, 69], "000": [1, 6, 15, 16, 41, 47], "111": [1, 4, 6, 15, 16], "follow": [1, 2, 3, 4, 6, 7, 9, 10, 14, 15, 16, 17, 18, 22, 24, 26, 28, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 45, 47, 48, 52, 53, 54, 57, 61, 63, 64, 65, 67, 68, 69, 71, 72, 74], "common": [1, 4, 6, 16, 17, 19, 24, 28, 31, 32, 61, 65], "convent": [1, 11, 14], "all": [1, 2, 3, 4, 6, 10, 16, 17, 18, 21, 22, 23, 24, 25, 26, 28, 29, 30, 31, 33, 34, 36, 38, 40, 41, 42, 43, 47, 49, 52, 53, 56, 57, 58, 59, 60, 61, 65, 67, 68, 69, 71, 72, 74], "howev": [1, 4, 7, 15, 16, 17, 38, 40, 42, 71, 72], "behavior": [1, 2, 4], "chang": [1, 2, 4, 6, 15, 22, 24, 28, 47, 67, 72, 74], "instead": [1, 2, 4, 13, 17, 18, 30, 33, 42, 43, 47, 65, 67, 71], "when": [1, 2, 3, 4, 6, 14, 16, 17, 24, 29, 36, 38, 41, 42, 43, 47, 52, 53, 54, 57, 61, 64, 65, 67, 71, 72], "negat": [1, 2, 3, 31, 35, 36], "polar": [1, 31, 35, 43], "syntax": [1, 4, 22, 23, 28, 29, 31, 33, 40, 53, 69, 74], "preced": [1, 31, 40], "01": [1, 7, 9, 13, 17, 59], "10": [1, 4, 5, 7, 10, 11, 12, 13, 14, 16, 17, 18, 20, 24, 27, 28, 47, 54, 56, 59, 60, 61, 69, 72], "notat": [1, 59], "context": [1, 2, 11, 29, 42, 43, 64], "valid": [1, 2, 3, 21, 28, 40, 43, 53, 65, 67, 71], "either": [1, 6, 9, 11, 14, 29, 40, 42, 43, 53, 59, 60, 65, 67, 72], "similarli": [1, 9, 10, 42, 48, 59], "condition": 1, "respect": [1, 2, 3, 6, 7, 14, 24, 40, 42, 47, 52, 56, 59, 65, 67, 72], "e": [1, 2, 3, 4, 5, 6, 7, 9, 14, 15, 16, 17, 18, 19, 20, 23, 24, 25, 27, 28, 29, 30, 31, 32, 38, 40, 41, 42, 43, 50, 53, 61, 64, 65, 67, 71, 72], "project": [1, 43, 64, 65, 67, 68, 71], "onto": [1, 59], "eigenvector": [1, 2, 5], "non": [1, 2, 3, 6, 12, 16, 24, 28, 29, 36, 42, 43, 47, 52, 54], "linear": [1, 4, 11, 13, 15, 19, 41, 47, 53, 59], "avail": [1, 2, 3, 4, 12, 17, 21, 22, 23, 24, 28, 29, 31, 34, 35, 36, 37, 39, 40, 41, 42, 43, 46, 47, 49, 51, 52, 61, 65, 67, 72, 74], "first": [1, 2, 3, 4, 6, 8, 9, 10, 13, 14, 15, 16, 17, 18, 19, 21, 24, 36, 40, 41, 42, 43, 44, 52, 53, 54, 55, 57, 60, 61, 67, 72], "api": [1, 18, 21, 24, 26, 30, 31, 34, 36, 40, 41, 42, 43, 47, 54, 64, 65, 67, 69, 71], "regist": [1, 2, 3, 6, 15, 19, 24, 27, 29, 36, 40, 42, 49, 54, 55, 57, 61, 64], "outsid": [1, 4, 67, 71], "Then": [1, 16, 17, 49, 53, 57, 63, 64], "within": [1, 2, 3, 19, 24, 28, 30, 32, 36, 40, 42, 43, 46, 47, 53, 54, 57, 59, 63, 65, 67, 68, 69, 71, 72], "like": [1, 2, 3, 4, 6, 7, 9, 14, 15, 17, 19, 22, 24, 28, 36, 40, 42, 47, 53, 54, 56, 59, 60, 61, 65, 67, 68, 71, 72, 74], "built": [1, 2, 4, 7, 8, 15, 22, 40, 43, 46, 47, 50, 57, 60, 65, 71, 72, 74], "abov": [1, 4, 6, 9, 14, 15, 17, 24, 26, 31, 41, 42, 43, 47, 52, 53, 55, 59, 61, 64, 65, 67, 69, 71, 72], "level": [1, 2, 22, 23, 24, 29, 31, 41, 42, 43, 61, 64, 68, 74], "register_oper": 1, "accept": [1, 2, 3, 45, 65, 67, 72], "identifi": [1, 2, 6, 7, 14, 17, 49, 65, 67], "string": [1, 2, 3, 6, 18, 24, 26, 27, 34, 43, 47, 54, 61, 67, 71], "numpi": [1, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 27, 53, 56, 57, 58, 65], "arrai": [1, 2, 3, 7, 9, 10, 13, 15, 16, 17, 36, 38, 42, 54, 56, 57, 61], "complex": [1, 2, 3, 5, 7, 12, 13, 20, 32, 38, 42, 47, 56, 57, 59, 60, 71], "A": [1, 2, 3, 4, 6, 7, 9, 14, 16, 18, 19, 24, 27, 28, 31, 38, 40, 47, 53, 55, 56, 59, 63, 64, 65, 67], "1d": [1, 2, 3], "interpret": [1, 46, 65], "row": [1, 2, 3, 18], "major": [1, 65], "import": [1, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 27, 32, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 56, 57, 58, 59, 60, 61, 65, 71, 72], "custom_h": 1, "custom_x": 1, "def": [1, 3, 4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 24, 27, 28, 33, 35, 41, 42, 45, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 67, 72], "bell": [1, 24, 71], "sampl": [1, 2, 3, 4, 6, 9, 12, 13, 14, 16, 17, 26, 40, 41, 42, 43, 44, 46, 49, 50, 53, 54, 55, 56, 57, 58, 59, 64, 67, 71, 72], "dump": [1, 2, 3, 13, 24, 27, 41, 42, 47, 49, 50, 53, 54, 56, 57, 58, 71, 72], "macro": [1, 64], "cudaq_register_oper": 1, "uniqu": [1, 2, 3, 4, 14, 16, 17, 24, 29, 31, 36, 42, 69], "name": [1, 2, 3, 4, 6, 14, 24, 26, 31, 34, 39, 41, 42, 43, 52, 56, 59, 61, 64, 65, 67, 68, 71, 72], "represent": [1, 2, 3, 15, 17, 18, 24, 28, 38, 43, 61, 63, 64], "includ": [1, 2, 3, 7, 14, 22, 24, 27, 36, 41, 45, 46, 47, 49, 50, 52, 53, 54, 55, 57, 58, 60, 61, 63, 64, 65, 67, 69, 71, 72, 74], "m_sqrt1_2": 1, "__qpu__": [1, 2, 24, 27, 28, 35, 41, 42, 45, 47, 49, 50, 52, 53, 54, 55, 57, 58, 60, 61, 71, 72], "void": [1, 2, 3, 24, 26, 27, 28, 31, 32, 34, 35, 36, 45, 47, 49, 53, 55, 58, 60, 61, 63, 64, 69, 71, 72], "bell_pair": [1, 2, 3], "r": [1, 6, 7, 16, 31, 36, 40, 41, 42, 43, 52, 53, 60, 61, 67], "int": [1, 2, 3, 4, 5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 20, 24, 27, 28, 35, 36, 41, 42, 45, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 60, 61, 64, 65, 69, 71, 72], "main": [1, 4, 6, 7, 17, 22, 24, 27, 38, 41, 47, 49, 50, 52, 53, 54, 55, 57, 58, 60, 61, 65, 67, 69, 71, 72, 74], "auto": [1, 2, 24, 26, 27, 28, 32, 35, 36, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 55, 57, 58, 60, 61, 63, 71, 72], "count": [1, 2, 3, 4, 5, 6, 12, 14, 16, 24, 26, 27, 36, 40, 41, 42, 43, 47, 50, 53, 54, 55, 56, 57, 58, 60, 61, 64], "bit": [1, 2, 3, 6, 7, 9, 13, 16, 24, 27, 29, 36, 38, 42, 43, 49, 50, 54, 55, 57, 59, 64], "printf": [1, 24, 27, 36, 42, 50, 52, 54, 55, 58, 60, 65], "n": [1, 2, 4, 5, 7, 10, 14, 15, 16, 17, 20, 24, 26, 27, 28, 31, 32, 35, 41, 42, 47, 49, 50, 52, 53, 54, 55, 56, 58, 59, 60, 61, 65, 69, 72], "data": [1, 2, 5, 11, 12, 14, 15, 19, 21, 24, 28, 30, 32, 38, 42, 43, 50, 52, 54, 55, 61, 64, 66, 67, 69, 71], "multi": [1, 7, 15, 18, 21, 22, 23, 26, 29, 31, 35, 39, 40, 41, 47, 51, 52, 59, 64, 65, 71, 72, 74], "msb": 1, "order": [1, 2, 4, 7, 14, 18, 24, 32, 40, 43, 47, 52, 57], "big": [1, 12], "endian": 1, "show": [1, 4, 11, 12, 14, 15, 16, 17, 18, 19, 20, 42, 52, 53, 57, 65, 67], "differ": [1, 2, 3, 4, 6, 9, 10, 11, 15, 16, 18, 38, 40, 41, 42, 46, 47, 53, 56, 57, 65, 67, 69], "test": [1, 4, 6, 11, 16, 21, 26, 56, 65, 67], "cnot": [1, 4, 31, 45, 59, 71], "my_cnot": 1, "print": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 24, 27, 36, 41, 42, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 65, 71, 72], "500": [1, 59, 72], "exact": [1, 4, 17, 43], "random": [1, 2, 3, 4, 6, 7, 10, 12, 14, 16, 17, 18, 19, 20, 42, 43, 49, 56, 58, 60], "construct": [1, 2, 4, 16, 18, 24, 25, 26, 28, 36, 38, 42, 45, 46, 47, 54, 57, 61], "second": [1, 2, 3, 4, 7, 9, 14, 16, 36, 41, 43, 47, 60], "1j": [1, 5], "xy": [1, 18], "kron": [1, 16], "my_xi": 1, "custom_xy_test": 1, "undo": 1, "prior": [1, 43, 59, 65, 67], "1000": [1, 3, 4, 11, 13, 16, 17, 24, 40, 47, 54, 56, 59, 72], "mycnot": 1, "myxi": 1, "current": [1, 2, 3, 4, 18, 22, 24, 34, 40, 42, 43, 49, 64, 67, 71, 74], "simul": [1, 2, 5, 6, 7, 8, 12, 16, 18, 21, 22, 23, 24, 39, 40, 44, 46, 47, 49, 51, 53, 54, 56, 61, 62, 65, 72, 74], "attempt": [1, 2, 6, 71], "hardwar": [1, 4, 6, 15, 17, 21, 22, 39, 43, 47, 51, 71, 74], "result": [1, 2, 3, 4, 5, 7, 8, 9, 11, 12, 13, 15, 16, 17, 18, 19, 20, 24, 25, 26, 27, 29, 38, 40, 41, 42, 43, 47, 49, 50, 52, 53, 54, 55, 56, 57, 59, 61, 64, 67, 71, 72], "runtim": [1, 2, 4, 12, 23, 24, 26, 29, 40, 41, 42, 43, 50, 52, 61, 64, 67, 69], "error": [1, 2, 4, 13, 18, 21, 31, 38, 40, 41, 43, 46, 53, 57, 65, 67, 71], "which": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 17, 18, 22, 24, 26, 29, 32, 36, 38, 40, 42, 43, 52, 53, 54, 56, 59, 60, 61, 64, 65, 67, 68, 71, 74], "doe": [1, 2, 3, 4, 9, 15, 17, 18, 22, 24, 28, 36, 41, 42, 65, 67, 69, 71, 72, 74], "place": [1, 14, 42, 45, 47, 49, 57], "holder": 1, "updat": [1, 2, 4, 24, 40, 53, 65, 72], "later": [1, 2, 4, 9, 24, 28, 42, 53, 65, 67], "3": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 25, 26, 27, 28, 29, 31, 32, 33, 34, 35, 36, 40, 41, 42, 43, 47, 53, 55, 56, 57, 58, 60, 61, 64, 65, 67, 68, 72, 74], "17": [1, 4, 11, 16, 17, 61, 69], "_": [1, 6, 7, 9, 11, 16, 17, 18, 49], "rang": [1, 2, 4, 5, 6, 7, 8, 11, 12, 14, 15, 16, 17, 18, 19, 20, 22, 27, 28, 35, 36, 41, 42, 45, 49, 50, 56, 58, 67, 72, 74], "34": [1, 4, 16, 17], "return": [1, 2, 3, 4, 5, 6, 8, 9, 11, 12, 14, 16, 17, 18, 19, 20, 24, 26, 27, 28, 31, 36, 38, 41, 42, 47, 49, 50, 52, 53, 54, 56, 57, 58, 60, 61, 63, 64, 65, 69, 71], "input": [1, 2, 3, 4, 7, 9, 11, 12, 15, 17, 24, 26, 27, 28, 35, 36, 42, 47, 52, 53, 56, 60], "qutrit": 1, "class": [2, 3, 4, 7, 11, 17, 24, 26, 28, 32, 34, 36, 42, 43, 60, 63, 64], "spin_op": [2, 3, 24, 27, 31, 41, 42, 47, 52, 58, 60], "repres": [2, 3, 4, 7, 9, 13, 14, 15, 17, 18, 24, 38, 40, 43, 53, 59, 60, 61], "gener": [2, 3, 4, 5, 6, 7, 10, 12, 14, 15, 16, 18, 19, 24, 26, 27, 28, 29, 31, 32, 35, 37, 40, 41, 46, 49, 50, 52, 53, 54, 55, 59, 61, 63, 67, 71], "sum": [2, 3, 7, 11, 14, 16, 17, 32, 36, 53, 59], "tensor": [2, 3, 11, 16, 22, 32, 41, 42, 50, 64, 74], "product": [2, 3, 16, 21, 22, 32, 41, 49, 72, 74], "expos": [2, 3, 4, 24, 26, 32, 34, 38, 42, 64], "typic": [2, 17, 24, 36, 41, 45, 46, 52, 61, 68, 69], "algebra": [2, 32, 52, 59], "programm": [2, 3, 24, 25, 26, 28, 29, 31, 33, 34, 36, 40, 42, 54], "defin": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 23, 24, 25, 26, 27, 28, 32, 33, 34, 35, 36, 41, 42, 43, 45, 46, 47, 49, 50, 52, 53, 54, 55, 57, 58, 59, 60, 61, 64, 65, 67, 69, 71], "primit": [2, 14, 23, 26, 29, 32, 36, 37, 42, 46, 71], "them": [2, 4, 5, 10, 12, 16, 17, 18, 22, 38, 45, 59, 61, 65, 67, 69, 71, 72, 74], "compos": [2, 3, 11, 14, 17, 28, 29, 40, 53, 61], "larger": [2, 3, 4, 14, 17, 41, 49, 50], "thereof": [2, 29, 32], "public": [2, 4, 24, 26, 32, 34, 36, 42, 49, 60, 63, 64, 67], "type": [2, 4, 7, 8, 9, 14, 15, 16, 23, 24, 26, 28, 29, 31, 32, 37, 40, 42, 43, 45, 49, 52, 54, 57, 58, 59, 60, 61, 64, 67, 71], "spin_op_term": 2, "bool": [2, 3, 24, 28, 31, 32, 34, 42, 64, 71], "we": [2, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 24, 27, 31, 33, 38, 40, 42, 43, 45, 46, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 68, 69, 71, 72, 74], "term": [2, 3, 5, 6, 7, 12, 14, 20, 24, 31, 40, 42, 47, 52, 67], "binari": [2, 3, 4, 6, 11, 14, 15, 22, 40, 49, 65, 69, 74], "symplect": 2, "form": [2, 3, 4, 17, 18, 22, 24, 31, 36, 38, 43, 61, 74], "size": [2, 3, 4, 6, 11, 16, 24, 26, 27, 28, 29, 36, 41, 42, 43, 49, 50, 53, 54, 56, 67, 71], "nqubit": [2, 26, 27, 60, 64], "where": [2, 3, 4, 6, 7, 9, 10, 11, 14, 15, 16, 17, 18, 23, 29, 31, 32, 36, 38, 40, 43, 47, 53, 56, 57, 59, 64, 65, 67, 69], "element": [2, 3, 6, 7, 10, 15, 16, 17, 24, 36, 42, 59], "x": [2, 3, 4, 5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 24, 26, 27, 28, 31, 32, 33, 35, 40, 41, 42, 43, 45, 47, 49, 50, 52, 53, 54, 55, 57, 58, 59, 60, 61, 65, 67, 69, 72], "next": [2, 4, 6, 7, 17, 18, 38, 53, 54, 60, 61, 65], "z": [2, 3, 4, 5, 8, 11, 12, 13, 14, 17, 18, 19, 24, 27, 31, 32, 41, 42, 47, 49, 52, 54, 56, 57, 58, 60, 65], "y": [2, 3, 4, 5, 6, 9, 10, 11, 15, 16, 18, 20, 24, 27, 31, 32, 41, 42, 47, 52, 54, 57, 60, 65, 67, 69, 72], "site": [2, 72], "csr_spmatrix": 2, "tupl": [2, 3, 4, 24, 28, 60], "doubl": [2, 3, 19, 24, 26, 27, 28, 31, 32, 35, 41, 42, 43, 47, 52, 53, 58, 60, 64, 65, 67], "size_t": [2, 24, 26, 28, 32, 34, 36, 42, 53, 54, 64, 69, 71], "typedef": 2, "zero": [2, 3, 5, 6, 8, 11, 16, 17, 29, 42, 47, 59], "spars": [2, 3], "function": [2, 3, 6, 8, 9, 11, 12, 13, 14, 16, 18, 19, 20, 22, 26, 27, 28, 30, 31, 32, 33, 34, 35, 36, 40, 41, 42, 43, 45, 46, 47, 49, 52, 53, 54, 56, 57, 58, 60, 61, 64, 69, 71, 74], "pair": [2, 3, 14, 28, 34, 38, 67], "const": [2, 24, 26, 27, 28, 31, 32, 34, 36, 41, 50, 53, 58, 60, 63, 64, 69, 71], "termdata": 2, "constructor": [2, 3], "take": [2, 3, 4, 7, 9, 14, 15, 16, 22, 24, 26, 27, 28, 31, 32, 33, 34, 35, 36, 38, 40, 43, 46, 47, 50, 52, 53, 54, 55, 56, 57, 60, 61, 65, 67, 72, 74], "coeffici": [2, 3, 5, 12, 59], "constant": [2, 9, 36, 38, 61], "id": [2, 24, 34, 36, 40, 42, 65, 67], "coeff": 2, "qubit": [2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 13, 14, 15, 17, 19, 20, 24, 26, 27, 28, 29, 32, 34, 35, 38, 40, 41, 42, 43, 45, 46, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 64, 67, 72], "unordered_map": [2, 24], "_term": 2, "full": [2, 3, 6, 7, 22, 41, 42, 56, 59, 61, 63, 65, 67, 68, 74], "composit": 2, "spin": [2, 3, 4, 5, 7, 8, 10, 11, 12, 13, 14, 20, 24, 27, 32, 38, 41, 42, 47, 52, 56, 58, 60, 61], "op": [2, 3, 5, 38, 52, 60, 61], "map": [2, 3, 4, 13, 16, 17, 24, 36, 61, 67], "individu": [2, 3, 29, 36, 42], "bsf": 2, "from": [2, 3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 17, 18, 19, 20, 22, 24, 25, 27, 28, 29, 32, 36, 38, 41, 42, 43, 46, 47, 49, 52, 53, 56, 57, 58, 60, 61, 64, 67, 68, 69, 72, 74], "ident": [2, 3, 5, 6, 14, 16, 17, 38, 52], "numqubit": [2, 3, 27], "given": [2, 3, 4, 6, 7, 9, 12, 14, 16, 17, 24, 36, 40, 42, 43, 47, 49, 52, 60, 64], "o": [2, 4, 10, 15, 20, 27, 40, 41, 42, 43, 50, 52, 53, 54, 55, 57, 60, 61, 65, 67, 69, 71, 72], "copi": [2, 17, 18, 36, 38, 65, 67], "data_rep": 2, "serial": [2, 3], "encod": [2, 3, 4, 6, 14, 17, 24, 32, 42, 49, 54, 59, 64], "via": [2, 3, 7, 9, 11, 13, 17, 21, 23, 24, 26, 29, 31, 33, 35, 36, 38, 40, 42, 43, 50, 52, 53, 54, 55, 56, 57, 59, 61, 63, 64, 65], "real": [2, 3, 5, 12, 15, 17, 18, 20, 46], "imaginari": [2, 3, 5, 7, 10, 20], "part": [2, 3, 6, 7, 10, 20, 24, 36, 61, 63, 65, 67], "append": [2, 3, 5, 6, 8, 11, 12, 16, 17, 18, 19, 20, 28, 40, 42, 49, 56], "larg": [2, 3, 5, 7, 16, 31, 42, 43, 46, 50, 59], "end": [2, 3, 7, 9, 13, 15, 16, 17, 18, 24, 36, 40, 42, 47, 53, 57, 59, 65, 67], "total": [2, 3, 4, 7, 11, 12, 15, 17, 20, 41, 42, 43, 47, 53, 56, 67], "destructor": 2, "iter": [2, 3, 4, 6, 7, 17, 24, 36, 53, 60], "begin": [2, 3, 4, 6, 7, 9, 13, 15, 16, 17, 18, 19, 24, 36, 45, 53, 54, 57, 59, 60], "start": [2, 3, 6, 7, 8, 15, 17, 21, 22, 31, 36, 40, 42, 47, 61, 63, 69, 74], "equal": [2, 3, 17, 18, 38, 42, 43, 47, 59], "v": [2, 3, 6, 7, 12, 14, 21, 24, 27, 28, 33, 38, 41, 56, 61, 65], "noexcept": [2, 31], "add": [2, 3, 4, 5, 13, 14, 18, 19, 22, 33, 43, 53, 54, 57, 61, 63, 64, 65, 67, 74], "subtract": [2, 3], "multipli": [2, 3, 6], "true": [2, 3, 4, 5, 6, 7, 11, 16, 17, 24, 28, 40, 56, 65, 67, 72], "here": [2, 3, 4, 6, 7, 9, 13, 15, 16, 17, 19, 21, 22, 24, 26, 27, 28, 31, 33, 41, 42, 49, 50, 52, 54, 55, 57, 58, 60, 61, 63, 65, 67, 71, 72, 74], "consid": [2, 3, 4, 6, 7, 9, 10, 16, 17, 27, 29, 38, 41, 42, 61, 67], "valu": [2, 3, 4, 6, 7, 8, 9, 11, 12, 14, 16, 17, 18, 20, 21, 24, 26, 28, 32, 36, 38, 41, 42, 43, 47, 49, 51, 56, 58, 59, 60, 61, 65, 71, 72], "num_qubit": [2, 3, 10, 32, 41, 60], "num_term": [2, 32], "get_coeffici": [2, 3, 5, 12, 32], "get": [2, 3, 5, 6, 10, 13, 15, 16, 17, 18, 22, 24, 26, 27, 36, 40, 41, 42, 47, 52, 53, 56, 64, 65, 69, 72, 74], "throw": [2, 18], "except": [2, 3, 4, 17, 18, 71], "get_raw_data": [2, 3], "is_ident": [2, 3, 32], "standard": [2, 3, 17, 23, 24, 25, 26, 28, 31, 37, 42, 45, 46, 50, 61, 63, 65, 67, 69, 71], "out": [2, 3, 4, 6, 9, 11, 13, 14, 15, 17, 22, 24, 29, 36, 38, 42, 43, 47, 48, 52, 53, 57, 60, 64, 67, 68, 71, 74], "to_str": [2, 3, 5, 12, 47], "printcoeffici": 2, "getdatarepresent": 2, "getdatatupl": 2, "fulli": [2, 3, 4, 11, 17, 22, 23, 42, 54, 61, 65, 67, 71, 74], "distribute_term": [2, 3], "numchunk": 2, "distribut": [2, 3, 13, 16, 17, 22, 29, 41, 43, 47, 52, 54, 65, 71, 74], "chunk": [2, 3, 29], "for_each_term": [2, 3, 5, 12, 32], "give": [2, 10, 14, 15, 16, 22, 24, 42, 43, 57, 65, 67, 73, 74], "functor": 2, "reduct": 2, "captur": [2, 6, 14, 18, 22, 28, 74], "variabl": [2, 4, 6, 14, 22, 28, 29, 40, 41, 42, 48, 50, 53, 56, 57, 65, 67, 72, 74], "for_each_pauli": [2, 3, 32], "thrown": [2, 3, 71], "than": [2, 3, 6, 14, 15, 18, 31, 38, 41, 43, 47, 59, 65, 67, 71], "user": [2, 3, 4, 16, 17, 18, 22, 24, 26, 27, 29, 30, 33, 36, 40, 41, 42, 43, 53, 56, 57, 61, 64, 65, 67, 74], "should": [2, 3, 6, 15, 23, 24, 29, 31, 32, 34, 36, 40, 42, 43, 47, 49, 57, 64, 65, 67, 71, 72], "pass": [2, 3, 4, 5, 11, 12, 18, 21, 24, 28, 29, 32, 36, 40, 42, 50, 53, 55, 57, 60, 61, 62, 67, 71], "index": [2, 3, 4, 5, 32, 34, 36, 38, 42, 49, 64], "complex_matrix": 2, "to_matrix": [2, 3, 5, 10], "dens": 2, "to_sparse_matrix": [2, 3], "col": 2, "static": [2, 3, 24, 31, 36, 61, 65, 71], "nterm": 2, "unsign": 2, "seed": [2, 3, 4, 7, 12, 14, 16, 17, 18, 19, 20, 43, 56, 58], "random_devic": 2, "act": [2, 4, 8, 9, 14, 38, 59], "specifi": [2, 3, 4, 11, 12, 14, 15, 16, 17, 18, 24, 27, 28, 29, 31, 32, 33, 34, 36, 40, 41, 42, 43, 47, 49, 53, 54, 56, 57, 58, 61, 64, 65, 67], "overrid": [2, 24, 43, 63, 65], "repeat": [2, 6, 16, 24, 58, 60], "from_word": [2, 3], "pauliword": 2, "word": [2, 3, 5, 6, 12, 57], "g": [2, 3, 4, 6, 14, 17, 23, 24, 25, 28, 29, 30, 31, 32, 38, 40, 41, 42, 43, 53, 61, 64, 65, 67, 68, 71, 72], "xyx": [2, 3], "3rd": 2, "typenam": [2, 24, 26, 27, 28, 31, 35, 36, 53, 69, 71], "qualifiedspinop": 2, "struct": [2, 24, 26, 27, 28, 31, 35, 41, 42, 50, 52, 53, 54, 55, 58, 60, 61, 63, 71], "constexpr": [2, 26, 36, 41], "dyn": [2, 36, 50, 57], "qudit": [2, 25, 29, 31], "d": [2, 3, 4, 27, 28, 29, 36, 40, 53, 57, 60, 67], "system": [2, 3, 4, 7, 17, 18, 19, 24, 29, 34, 36, 38, 42, 43, 46, 47, 52, 53, 56, 57, 59, 60, 63, 65, 68, 69, 71, 72], "inlin": [2, 24, 61], "new": [2, 3, 4, 15, 17, 18, 21, 22, 24, 26, 38, 46, 61, 62, 65, 67, 71, 72, 74], "enable_if_t": 2, "qreg": [2, 3, 5, 14, 41], "contain": [2, 3, 4, 7, 14, 16, 17, 21, 22, 24, 29, 31, 34, 38, 41, 43, 46, 47, 52, 53, 58, 60, 61, 64, 65, 71, 72, 74], "dynam": [2, 3, 26, 28, 29, 36, 45, 46, 50, 61, 71], "time": [2, 3, 4, 6, 7, 13, 14, 15, 16, 18, 20, 23, 24, 27, 29, 36, 37, 40, 41, 42, 43, 47, 50, 53, 54, 56, 59, 61, 65, 67, 72], "By": [2, 4, 24, 31, 40, 41, 42, 43, 47, 53, 69], "value_typ": 2, "indic": [2, 3, 7, 17, 28, 31, 32, 36, 57, 64], "underli": [2, 3, 4, 24, 34, 36, 40, 42, 64], "interfac": [2, 36, 43, 64, 65, 67, 69], "idx": [2, 3, 6, 11, 17, 36, 42], "qspan": 2, "front": [2, 27, 35, 36, 55], "back": [2, 17, 27, 36, 38, 42, 53, 54, 57, 67], "last": [2, 6, 16, 17, 27, 36, 42, 52, 60], "slice": [2, 3, 36, 60], "clear": [2, 3, 24, 36, 64], "destroi": [2, 36], "postcondit": [2, 36], "own": [2, 3, 4, 13, 16, 29, 34, 36, 43, 60, 61, 64, 65, 67, 71], "semant": [2, 3, 23, 28, 29, 30, 33, 35, 36, 38, 61], "held": 2, "explicit": [2, 24, 35, 43, 53, 71], "determin": [2, 4, 7, 9, 47], "If": [2, 3, 4, 6, 9, 11, 12, 15, 16, 18, 24, 38, 41, 43, 47, 49, 53, 56, 59, 60, 65, 67, 71, 72], "check": [2, 4, 6, 17, 22, 40, 41, 53, 59, 65, 67, 74], "norm": [2, 16], "pre": [2, 3, 17, 20, 22, 24, 40, 43, 52, 53, 55, 65, 71, 74], "exist": [2, 3, 17, 18, 22, 23, 24, 29, 30, 47, 63, 65, 67, 71, 72, 74], "could": [2, 4, 6, 18, 41, 45, 59, 60, 65], "from_data": [2, 3], "retriev": [2, 3, 24, 42, 53], "get_stat": [2, 3, 10, 15, 17, 18, 42], "delet": [2, 36, 67, 71], "cannot": [2, 15, 18, 27, 28, 36, 38, 59, 67], "move": [2, 11, 36, 63, 65, 67, 72], "assign": [2, 4, 14, 34, 42, 43, 65], "qview": [2, 5, 6, 10, 15, 27, 28, 35, 49], "observe_result": [2, 3, 5, 24, 52], "encapsul": [2, 11, 24, 36, 42, 71], "observ": [2, 3, 4, 5, 7, 8, 11, 12, 13, 14, 16, 19, 20, 27, 40, 42, 43, 44, 46, 50, 52, 54, 55, 56, 58, 59, 60, 64, 72], "call": [2, 3, 4, 6, 7, 8, 9, 11, 13, 14, 15, 17, 18, 19, 26, 27, 28, 31, 35, 42, 43, 46, 47, 53, 54, 55, 56, 58, 59, 60, 61, 64, 65, 67, 69], "measur": [2, 3, 4, 9, 10, 11, 13, 15, 16, 24, 25, 27, 28, 29, 31, 38, 40, 42, 43, 45, 46, 47, 49, 53, 54, 57, 60, 61, 64, 72], "execut": [2, 4, 7, 15, 17, 18, 22, 23, 24, 26, 28, 29, 34, 35, 40, 42, 43, 46, 47, 48, 49, 50, 52, 53, 54, 56, 61, 64, 67, 68, 69, 71, 72, 74], "ansatz": [2, 4, 7, 8, 14, 19, 20, 24, 27, 41, 42, 52, 58, 60], "circuit": [2, 3, 4, 6, 9, 10, 11, 14, 15, 16, 23, 24, 28, 29, 32, 33, 37, 38, 40, 41, 42, 43, 46, 47, 52, 53, 58, 60, 61, 63], "global": [2, 3, 4, 14, 17, 24, 28, 41, 47, 65], "expect": [2, 3, 4, 5, 7, 8, 11, 12, 13, 14, 16, 17, 19, 20, 21, 24, 41, 42, 43, 47, 51, 56, 57, 58, 60, 65, 67, 71, 72], "h": [2, 3, 4, 5, 6, 7, 9, 10, 12, 14, 15, 16, 17, 18, 19, 20, 24, 26, 27, 31, 32, 33, 35, 36, 38, 40, 41, 42, 45, 47, 49, 50, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 63, 64, 65, 67, 69, 71, 72], "precomput": 2, "psi": [2, 8, 9, 10, 18, 24, 27, 47, 59], "sample_result": [2, 3, 6, 24, 53, 71], "wa": [2, 3, 4, 7, 9, 17, 24, 42, 54, 61, 65, 68, 72], "shot": [2, 3, 4, 6, 10, 12, 16, 24, 27, 40, 47, 54, 59, 64], "base": [2, 3, 4, 6, 11, 15, 16, 17, 22, 23, 24, 26, 30, 31, 36, 41, 42, 43, 47, 49, 56, 60, 61, 64, 65, 67, 69, 74], "raw_data": [2, 4, 24], "raw": [2, 3, 4], "convers": [2, 24], "simpli": [2, 18, 59, 67, 72], "ignor": [2, 4, 6, 43], "fine": [2, 24, 50, 54, 55, 59], "grain": [2, 24, 50, 54, 55], "explicitli": [2, 4, 38, 40, 43, 61, 69, 71], "request": [2, 24, 41, 42, 43, 53, 67], "oppos": [2, 71], "observe_data": 2, "spinoptyp": [2, 24], "sub": [2, 3, 23, 24, 27, 28, 36, 37, 67], "id_coeffici": [2, 24], "executioncontext": 2, "abstract": [2, 23, 24, 26, 31, 32, 34, 36, 42, 46], "how": [2, 4, 6, 8, 14, 15, 16, 17, 18, 19, 22, 24, 26, 31, 41, 42, 43, 46, 47, 51, 53, 54, 55, 56, 57, 58, 60, 61, 64, 65, 67, 68, 71, 72, 74], "shots_": 2, "member": [2, 3, 14, 28, 60], "basic": [2, 8, 21, 41, 67, 72], "option": [2, 3, 4, 5, 7, 9, 16, 19, 20, 24, 26, 31, 34, 40, 41, 42, 47, 52, 53, 55, 56, 60, 64, 65, 67], "invoc": [2, 3, 26, 28, 34, 36, 42, 43, 64], "expectationvalu": 2, "nullopt": 2, "optimization_result": [2, 24], "optresult": 2, "optim": [2, 4, 6, 7, 8, 11, 12, 14, 16, 20, 21, 22, 23, 33, 36, 38, 41, 43, 51, 60, 61, 63, 65, 67, 74], "hasconditionalsonmeasureresult": 2, "fals": [2, 3, 4, 5, 6, 7, 12, 17, 65, 67], "being": [2, 3, 8, 13, 23, 24, 38, 43, 53, 57, 71], "ha": [2, 3, 4, 6, 7, 9, 13, 14, 16, 17, 24, 31, 38, 40, 41, 43, 46, 47, 49, 53, 56, 57, 59, 60, 65, 67, 71], "statement": [2, 9, 24, 25, 46], "noise_model": [2, 3, 13, 16, 57], "noisemodel": [2, 3, 13, 16, 57], "nullptr": 2, "canhandleobserv": 2, "flag": [2, 28, 40, 42, 43, 50, 53, 61, 63, 67, 71], "handl": [2, 3, 4, 40, 41, 42, 43, 49, 50, 53, 64, 67, 71], "task": [2, 4, 17, 18, 24, 32, 42, 43, 47, 61, 64], "under": [2, 16, 17, 40, 63, 64, 65, 67, 71], "asyncexec": 2, "occur": [2, 3, 4, 16, 24, 29, 53, 57, 59, 67], "asynchron": [2, 3, 24, 34, 42, 47, 53, 56], "detail": [2, 7, 14, 22, 23, 29, 40, 41, 64, 65, 67, 72, 74], "futur": [2, 3, 24, 39, 40, 42, 43, 53, 57, 65, 67], "futureresult": 2, "store": [2, 3, 7, 29, 36, 42, 47, 53, 56, 59, 61], "unique_ptr": 2, "simulationst": 2, "pointer": [2, 3, 71], "amplitudemap": 2, "amplitud": [2, 3, 15, 17, 42, 56, 57, 59], "overlapcomputest": 2, "overlap": [2, 3, 5, 42], "overlapresult": 2, "trace": [2, 3, 13, 17, 41], "kerneltrac": 2, "run": [2, 3, 4, 9, 11, 16, 17, 18, 20, 21, 23, 24, 27, 40, 41, 42, 43, 44, 46, 50, 52, 53, 54, 55, 56, 57, 60, 61, 64, 65, 67, 68, 71, 72], "tracer": 2, "persist": [2, 24, 29, 41, 67], "resourc": [2, 6, 7, 34, 41, 42, 43, 47, 60, 65, 67], "kernelnam": [2, 3], "batchiter": 2, "batch": [2, 29], "observe_n": 2, "sample_n": 2, "totaliter": 2, "registernam": [2, 24], "mid": [2, 3, 43], "mode": [2, 3, 4, 29, 40, 53, 61, 65], "keep": [2, 16, 24, 43, 60], "track": [2, 24, 59, 60], "reorderidx": 2, "inform": [2, 3, 4, 6, 9, 17, 22, 24, 29, 31, 34, 36, 40, 41, 42, 43, 47, 53, 56, 59, 61, 65, 67, 69, 70, 72, 74], "reorder": 2, "after": [2, 3, 4, 7, 9, 18, 24, 47, 53, 57, 61, 65, 67], "empti": [2, 3, 26, 32, 43, 53, 57, 67], "mean": [2, 15, 17, 31, 38, 43, 53, 56, 67, 72], "char": [2, 27, 42, 47, 65, 71, 72], "invocationresultbuff": 2, "buffer": [2, 42, 71], "note": [2, 3, 4, 6, 14, 16, 17, 18, 27, 29, 38, 41, 42, 47, 49, 53, 57, 59, 60, 61, 65, 67, 71], "need": [2, 4, 6, 7, 13, 14, 15, 16, 18, 38, 40, 41, 42, 43, 47, 52, 53, 56, 60, 64, 65, 67, 68, 71], "abl": [2, 4, 24, 40, 41, 42, 47, 49, 67, 71, 72], "job": [2, 14, 24, 41, 42, 53, 67], "qpu": [2, 3, 10, 21, 22, 23, 24, 29, 34, 40, 42, 43, 46, 47, 52, 53, 56, 64, 71, 72, 74], "extra": [2, 31, 38, 40, 49, 57, 60], "configur": [2, 4, 19, 34, 40, 41, 42, 43, 53, 56, 61, 64, 65, 67, 68, 71, 72], "server": [2, 40, 42, 53, 67], "file": [2, 4, 7, 24, 31, 40, 41, 42, 47, 48, 53, 56, 60, 61, 63, 64, 65, 67, 68, 69, 71, 72], "read": [2, 3, 6, 14, 53, 60], "wrap": [2, 24, 26, 38], "t": [2, 3, 7, 9, 10, 15, 17, 18, 22, 24, 27, 28, 31, 32, 41, 43, 53, 54, 59, 65, 67, 74], "case": [2, 3, 4, 9, 13, 14, 15, 16, 24, 38, 45, 52, 57, 65, 69, 71], "must": [2, 3, 6, 16, 23, 24, 28, 30, 33, 36, 38, 40, 43, 53, 57, 59, 60, 63, 64, 65, 67, 71, 72], "some": [2, 4, 6, 7, 11, 15, 22, 24, 38, 41, 42, 43, 59, 61, 63, 64, 65, 67, 68, 71, 72, 74], "point": [2, 3, 4, 15, 18, 24, 28, 31, 42, 43, 61, 64, 65, 67], "same": [2, 3, 4, 9, 14, 15, 16, 17, 18, 24, 38, 40, 42, 47, 53, 55, 56, 57, 61, 64, 65, 67, 71], "_job": 2, "qpunamein": 2, "config": [2, 7, 17, 64, 65, 67, 72], "info": [2, 17, 41, 48, 61], "requir": [2, 3, 4, 6, 7, 9, 11, 15, 17, 18, 24, 28, 30, 31, 33, 35, 36, 38, 40, 41, 42, 43, 49, 53, 56, 59, 65, 68, 72], "date": 2, "even": [2, 4, 6, 9, 14, 22, 43, 60, 65, 67, 71, 74], "async_result": [2, 10, 53], "face": [2, 17, 30], "itself": [2, 35, 38, 42, 65, 67], "collect": [2, 3, 5, 7, 12, 18, 47], "pertin": [2, 24, 30, 35, 36], "remot": [2, 3, 24, 29, 39, 41, 48, 56], "rest": [2, 3, 23, 40, 42, 49, 53, 65, 67, 71], "wait": [2, 3, 4, 41, 42, 47, 53], "until": [2, 3, 4, 17, 47, 53], "readi": [2, 6, 19, 53, 57, 67], "executionresult": 2, "correspond": [2, 3, 4, 5, 7, 8, 14, 17, 24, 40, 49, 53, 54, 58, 65, 67, 69], "well": [2, 3, 6, 16, 22, 24, 27, 29, 43, 49, 64, 67, 68, 71, 74], "integ": [2, 3, 14, 21, 28, 34, 42, 43, 47, 56], "1st": [2, 13], "bitstr": [2, 3, 4, 14, 24, 49], "m": [2, 4, 5, 7, 16, 18, 20, 27, 32, 42, 43, 56, 61, 65, 67, 71, 72], "tripl": [2, 61], "long": [2, 24, 27, 47, 50, 65, 67, 71, 72], "length": [2, 16, 49, 53, 60], "deseri": [2, 3], "discuss": [2, 4, 63], "brief": [2, 57, 64], "countsdictionari": [2, 24], "assum": [2, 3, 4, 6, 14, 16, 29, 31, 36, 42, 43, 47, 53, 64, 65, 67, 69], "expval": [2, 24], "other": [2, 3, 4, 6, 7, 14, 15, 16, 18, 19, 21, 23, 26, 28, 31, 36, 38, 40, 41, 42, 43, 45, 46, 47, 53, 57, 65, 67, 71, 72], "appendresult": 2, "globalregisternam": [2, 24], "classic": [2, 4, 5, 7, 9, 11, 14, 15, 19, 23, 25, 28, 29, 31, 32, 36, 38, 42, 46, 47, 53, 59, 60, 61, 64, 65, 68, 71], "sequentialdata": 2, "sequenti": [2, 3, 24, 41, 47], "collat": [2, 3], "": [2, 3, 4, 5, 7, 10, 13, 14, 15, 16, 17, 18, 20, 21, 24, 31, 34, 38, 40, 41, 42, 45, 46, 47, 50, 52, 53, 54, 55, 56, 57, 58, 60, 61, 63, 65, 67, 68, 69, 72], "holist": 2, "nullari": 2, "precomputedexp": 2, "__global__": [2, 3, 24, 41, 69], "has_expect": 2, "string_view": [2, 24, 64], "anoth": [2, 4, 6, 27, 28, 38, 43, 49, 53, 55, 57, 65], "register_nam": [2, 3, 24], "tandem": [2, 56], "to_map": [2, 24], "regnam": 2, "merg": [2, 61], "necessari": [2, 6, 40, 42, 43, 53, 57, 61, 65, 67, 71], "document": [2, 3, 18, 21, 22, 23, 31, 39, 40, 41, 63, 64, 65, 67, 71, 74], "exp_val_z": 2, "deprec": [2, 3, 20, 39, 42, 43], "probabl": [2, 3, 6, 10, 13, 16, 24, 47, 49, 57, 59, 71], "most_prob": [2, 3, 6, 12, 27, 47, 49, 59], "most": [2, 3, 4, 6, 14, 22, 24, 38, 41, 47, 49, 53, 61, 65, 67, 68, 71, 74], "ostream": [2, 71], "output": [2, 3, 6, 7, 9, 11, 17, 18, 28, 40, 44, 47, 61, 67, 71, 72], "stream": [2, 4, 29], "extract": [2, 3, 4, 6, 7, 9, 24, 26, 27, 36, 38, 47, 60, 61, 65, 67], "unord": 2, "get_margin": [2, 24], "marginalindic": [2, 24], "margin": [2, 16], "those": [2, 6, 22, 24, 28, 38, 42, 43, 61, 74], "subset": [2, 3, 4, 11, 17, 24, 28, 36, 38], "rvalu": 2, "refer": [2, 6, 14, 21, 24, 28, 29, 36, 38, 40, 41, 42, 53, 58, 65, 67], "newbitstr": 2, "oldbitstr": 2, "process": [2, 3, 4, 15, 17, 20, 23, 24, 29, 34, 40, 41, 42, 43, 46, 53, 56, 59, 61, 65, 71], "const_iter": 2, "cbegin": 2, "cend": 2, "has_even_par": 2, "pariti": 2, "extens": [2, 18, 23, 24, 30, 36, 39, 64, 67, 69, 72], "concret": [2, 3, 14, 24, 47, 52], "describ": [2, 3, 6, 13, 16, 34, 36, 40, 55, 59, 64, 65, 67, 71], "effici": [2, 4, 6, 17, 43], "manner": [2, 24, 42, 64], "client": [2, 24, 41, 65], "remain": [2, 3, 7, 35, 53, 57, 65], "gpu": [2, 3, 4, 5, 7, 8, 9, 11, 12, 15, 17, 21, 22, 23, 29, 42, 44, 46, 49, 50, 51, 64, 65, 69, 71, 72, 74], "devic": [2, 3, 4, 11, 13, 16, 17, 24, 27, 28, 31, 35, 40, 41, 42, 43, 47, 53, 60, 61, 64, 67], "cpu": [2, 4, 7, 11, 12, 13, 14, 15, 16, 17, 18, 21, 39, 41, 42, 46, 47, 49, 50, 56, 57, 61, 65, 67, 71, 72], "memori": [2, 4, 11, 17, 25, 28, 29, 36, 38, 41, 42, 43, 46, 49, 56, 61, 67], "primari": [2, 3, 24, 36, 64], "goal": [2, 4, 6, 14], "minim": [2, 4, 14, 16, 17, 18, 19, 20, 21, 52, 60, 65, 67, 72], "transfer": [2, 42, 43], "subclass": [2, 24, 64], "cusvstat": 2, "scalartyp": [2, 71], "remotesimulationst": 2, "nvqir": [2, 21, 61, 62, 64], "mpssimulationst": 2, "tensornetsimulationst": 2, "made": [2, 6, 14, 47, 57, 67], "up": [2, 3, 4, 9, 14, 15, 17, 18, 26, 32, 43, 46, 52, 56, 57, 58, 60, 61, 64, 67], "extent": [2, 3, 43], "enum": [2, 7], "precis": [2, 3, 15, 19, 41, 43, 59], "enumer": [2, 3, 10, 16, 17, 27, 49], "fp32": [2, 3, 41, 42, 43], "fp64": [2, 3, 5, 19, 20, 39, 41, 42, 43], "simulation_precis": 2, "possibl": [2, 4, 9, 16, 17, 18, 23, 38, 59, 67, 69, 71], "float": [2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 14, 16, 19, 20, 24, 27, 28, 31, 35, 41, 42, 43, 52, 58, 60, 64], "tensorstatedata": 2, "dimens": [2, 3, 4, 5, 8, 12, 14, 17, 24, 58, 60], "state_data": 2, "variant": [2, 31], "custatevec": [2, 41, 42, 43, 64], "care": [2, 24, 71], "taken": [2, 4, 12], "ensur": [2, 61, 63, 65, 67, 71], "comparison": [2, 9], "compat": [2, 3, 30, 43, 65], "registeredtyp": 2, "declar": [2, 24, 28, 29, 31, 61, 64, 69, 71], "themselv": [2, 40, 45], "plugin": [2, 22, 63, 65, 67, 74], "myinterfac": 2, "column": [2, 3, 18], "upon": [2, 8, 38, 47, 53, 59, 67], "destruct": 2, "rawdata": 2, "intern": [2, 3, 42], "modifi": [2, 27, 28, 31, 35, 38, 43, 60, 67], "correct": [2, 15, 16, 17, 27, 46, 53, 65, 67], "j": [2, 3, 4, 5, 6, 10, 12, 14, 15, 16, 17, 27, 28, 32, 56, 58, 65], "minimal_eigenvalu": [2, 3], "eigenvalu": [2, 3, 5, 14, 43, 60], "thei": [2, 3, 4, 6, 7, 8, 14, 28, 36, 38, 46, 59, 60, 65, 67], "set_zero": 2, "seen": [2, 6, 9, 17], "manag": [2, 17, 18, 41, 42, 65, 67], "instruct": [2, 6, 17, 22, 29, 31, 33, 38, 40, 41, 43, 53, 54, 60, 61, 65, 67, 71, 72, 74], "control": [2, 3, 5, 6, 10, 14, 15, 21, 22, 23, 26, 27, 28, 29, 31, 33, 35, 36, 37, 38, 40, 42, 45, 46, 49, 51, 53, 54, 57, 59, 60, 61, 64, 67, 74], "flow": [2, 11, 23, 24, 28, 37, 46, 61], "path": [2, 3, 18, 40, 61, 64, 65, 67], "thu": [2, 41, 42, 43, 59, 61], "might": [2, 4, 7, 17, 26, 31, 38, 39, 41, 42, 55], "produc": [2, 3, 4, 6, 7, 14, 24, 27, 32, 33, 38, 45, 47, 54, 61, 64, 71], "elementtyp": 2, "is_integral_v": 2, "is_signed_v": 2, "increment": [2, 56], "exclus": [2, 9], "stop": [2, 47, 67], "step": [2, 4, 6, 7, 9, 11, 15, 17, 27, 61, 65, 69, 72], "reach": [2, 17, 56], "quantumkernel": [2, 24, 35], "arg": [2, 3, 4, 11, 15, 16, 24, 26, 31, 35, 42, 47, 61, 67], "is_invocable_v": 2, "draw": [2, 3, 4, 6, 8, 9, 10, 13, 15, 16, 17, 18, 47, 49], "utf": [2, 3], "8": [2, 3, 4, 5, 6, 7, 10, 11, 12, 14, 15, 16, 17, 18, 19, 20, 22, 24, 27, 28, 29, 39, 40, 41, 42, 43, 53, 56, 57, 58, 60, 61, 65, 67, 72, 74], "usag": [2, 42, 56], "iostream": [2, 41, 45, 47, 49, 71], "mz": [2, 3, 6, 9, 16, 24, 26, 27, 38, 40, 41, 42, 45, 47, 49, 50, 53, 54, 55, 56, 57, 59, 61, 71, 72], "cout": [2, 41, 47, 49, 71], "q0": [2, 3, 4, 6, 8, 9, 10, 13, 15, 17, 18, 38], "q1": [2, 3, 4, 6, 8, 9, 10, 13, 15, 17, 18, 38], "ry": [2, 3, 4, 8, 10, 11, 12, 24, 27, 28, 31, 33, 41, 42, 52, 60], "59": [2, 3, 14, 24, 27, 42, 52], "callabl": [2, 3, 23, 24, 26, 27, 28, 45, 52, 54], "trivial": [2, 4, 6, 24, 42, 50, 52, 68], "signatur": [2, 3, 24, 26, 28, 55, 61], "evalu": [2, 3, 4, 10, 24, 41, 42, 43, 52], "without": [2, 3, 17, 24, 28, 35, 40, 43, 49, 53, 57, 65, 67, 71, 72], "regard": 2, "depth": [2, 4, 73], "etc": [2, 28, 29, 42, 46, 60, 64, 65, 67, 72], "kraus_op": 2, "krau": [2, 3, 13, 57], "initializer_list": 2, "initlist": 2, "adjoint": [2, 6, 15, 26, 27, 31, 35, 38, 61], "flatten": [2, 17, 71], "nrow": [2, 11, 18], "ncol": [2, 18], "kraus_channel": [2, 57], "channel": [2, 3, 13, 16, 57, 67], "action": [2, 24, 27, 28, 67], "matric": [2, 3, 7, 43], "amplitude_damping_channel": [2, 57], "bit_flip_channel": [2, 57], "depolarization_channel": [2, 13, 57], "phase_flip_channel": [2, 57], "inputlist": 2, "lvalu": 2, "make": [2, 3, 9, 15, 18, 24, 42, 43, 57, 58, 60, 61, 64, 65, 67, 69, 72], "get_op": 2, "push_back": [2, 28, 49], "autom": [2, 64], "creation": [2, 4, 7, 23, 37, 60, 64], "damp": [2, 57], "phase": [2, 3, 15, 17, 31, 53, 57], "depolar": [2, 3, 13, 57], "densiti": [2, 3, 13, 16, 18, 39, 41, 43, 57], "predicatefuncti": 2, "callback": [2, 3, 19, 20], "operand": [2, 3, 31, 42], "add_channel": [2, 3, 13, 16, 57], "quantumop": 2, "pred": [2, 61], "add_all_qubit_channel": [2, 3], "numcontrol": 2, "get_channel": [2, 3], "targetqubit": 2, "controlqubit": 2, "param": [2, 7, 14, 27, 28, 31, 41, 56, 58, 60], "relev": [2, 4, 7, 8, 11, 16, 20, 34, 43], "kernel_build": [2, 26], "kernel_builder_bas": 2, "kernelbuildertyp": 2, "mlir": [2, 3, 21, 42, 61, 62, 63, 65], "getargu": [2, 26, 63], "quakevalu": [2, 3, 26], "isargstdvec": 2, "otherwis": [2, 3, 6, 9, 43, 47], "getnumparam": [2, 26], "qalloc": [2, 3, 26, 40, 41, 42, 56], "qvec": [2, 38, 40], "veq": [2, 3, 38, 61], "blockargu": 2, "object": [2, 3, 4, 7, 12, 14, 16, 18, 24, 28, 38, 42, 47, 58, 60, 61], "simplic": [2, 7], "impli": [2, 3, 43], "goe": [2, 29, 49], "scope": [2, 28, 29, 36, 61, 63], "befor": [2, 14, 18, 40, 48, 53, 57, 60, 65, 67], "mai": [2, 3, 4, 5, 9, 14, 16, 24, 26, 28, 29, 31, 35, 36, 40, 41, 42, 43, 46, 47, 48, 50, 53, 55, 60, 65, 67, 69, 71, 72], "garbag": 2, "constantv": 2, "val": [2, 16, 53], "swap": [2, 6, 7, 17, 18, 27, 53], "mod": [2, 6, 31], "is_same_v": 2, "perform": [2, 3, 4, 7, 9, 11, 15, 16, 17, 19, 22, 24, 27, 40, 42, 43, 47, 49, 53, 55, 56, 59, 63, 64, 65, 67, 71, 72, 74], "fredkin": 2, "between": [2, 3, 4, 6, 10, 14, 16, 17, 18, 19, 28, 38, 41, 45, 46, 47, 53, 56, 57, 67, 69], "meant": [2, 23, 50], "thin": [2, 3], "wrapper": [2, 3, 42], "around": [2, 3, 7, 9, 16, 24, 49, 57, 72], "instanc": [2, 3, 4, 17, 24, 26, 31, 36, 41, 42, 43, 46, 67], "quak": [2, 3, 14, 21, 37, 61, 63], "dialect": [2, 3, 61, 63], "arithmet": [2, 28, 29, 60], "getvalu": 2, "actual": [2, 16, 17, 24, 47, 64], "implicitlocopbuild": 2, "arith": [2, 38, 61], "constantfloatop": 2, "canvalidatenumel": 2, "stdvectyp": 2, "do": [2, 4, 6, 15, 16, 17, 22, 31, 33, 36, 38, 41, 42, 43, 45, 46, 54, 59, 61, 65, 67, 68, 69, 72, 74], "loop": [2, 3, 4, 7, 14, 25, 36, 45, 53, 56, 58, 60, 61], "know": [2, 6, 18, 22, 38, 74], "bound": [2, 3, 16, 60], "startidx": [2, 3], "subscript": [2, 3, 40, 41], "stdvec": [2, 38, 61], "constants": 2, "isstdvec": 2, "getrequiredel": 2, "veqtyp": 2, "divid": [2, 6, 14], "invers": [2, 15, 17, 27], "so": [2, 4, 5, 6, 10, 12, 14, 16, 17, 18, 24, 40, 42, 43, 49, 54, 59, 60, 61, 63, 64, 65, 67, 71, 72], "friend": 2, "write": [2, 3, 48, 53, 59, 60, 63, 67, 69], "u": [2, 4, 5, 6, 8, 9, 12, 14, 15, 17, 18, 19, 27, 28, 32, 33, 45, 46, 47, 55, 56, 57, 59, 60, 61], "wai": [2, 3, 6, 9, 24, 35, 38, 47, 65], "code": [2, 3, 4, 6, 9, 14, 15, 18, 19, 23, 24, 26, 27, 28, 29, 32, 33, 35, 36, 38, 40, 41, 42, 43, 47, 52, 53, 54, 56, 57, 59, 60, 61, 63, 64, 65, 68, 69, 71, 72], "mlircontext": 2, "ctx": [2, 11, 63], "f": [2, 4, 6, 9, 10, 16, 17, 27, 28, 49, 52, 60, 65, 72], "high": [2, 16, 56, 61, 71], "serv": [2, 3, 4, 28, 36, 41, 63, 65], "work": [2, 4, 6, 7, 15, 16, 17, 21, 24, 41, 42, 56, 60, 62, 65, 67, 68, 71, 72], "subtyp": 2, "possibli": [2, 28], "deleg": [2, 41, 64, 67], "third": [2, 3, 21, 60, 70], "parti": [2, 21, 60, 70], "immut": 2, "mutabl": [2, 24], "gradient": [2, 8, 11, 41, 58, 60], "df": [2, 16], "dx_i": 2, "scalar": [2, 24], "queri": [2, 9, 24, 34, 42, 49, 52], "whether": [2, 3, 6, 17, 65, 67], "strategi": [2, 24, 29, 35, 60, 64], "parameter": [2, 3, 4, 14, 19, 24, 26, 28, 31, 41, 46, 52, 54, 56, 60], "left": [2, 7, 9, 10, 14, 15, 53, 64, 67], "thing": [2, 55, 60], "max": [2, 4, 12, 17, 21, 41, 43, 53, 58], "cobyla": [2, 3, 4, 8, 12, 19, 20, 24, 58, 60], "opt": [2, 28, 61, 63, 65, 67], "assert": [2, 6, 17, 27, 28], "requiresgradi": [2, 24], "algo": 2, "opt_val": [2, 41, 58, 60], "opt_param": [2, 24, 41, 58, 60], "dx": [2, 24], "virtual": [2, 17, 18, 22, 24, 41, 42, 47, 52, 56, 64, 65, 74], "achiev": [2, 6, 7, 14, 15, 24, 40, 41, 55, 60], "dim": [2, 17, 41], "optimizable_funct": [2, 24], "opt_funct": [2, 24, 41], "variat": [2, 4, 7, 8, 11, 14, 20, 21, 24, 51], "custom": [2, 3, 13, 22, 24, 28, 42, 43, 54, 57, 60, 63, 65, 67, 70, 71, 74], "ptrtoown": 2, "conveni": [2, 15, 32, 38, 60, 65, 67], "jdx": 2, "tensoridx": 2, "get_tensor": 2, "just": [2, 4, 6, 9, 10, 14, 23, 37, 42, 47, 48, 49, 54, 59, 61, 67], "rank": [2, 3, 42, 50, 54, 56], "get_num_tensor": 2, "get_num_qubit": [2, 34], "get_precis": [2, 3], "is_on_gpu": [2, 3], "to_host": 2, "hostptr": 2, "numel": 2, "pure": [2, 13, 27, 28, 35, 60], "basisst": 2, "host": [2, 25, 27, 28, 29, 32, 36, 41, 42, 43, 52, 71, 72], "leverag": [2, 3, 4, 17, 24, 26, 28, 31, 35, 36, 43, 54, 58, 60, 61, 64, 68], "separ": [2, 4, 17, 43, 65, 67], "mapper": 2, "inherit": [2, 25, 29, 42], "protect": [2, 36, 64], "getexpectedvalu": 2, "central_differ": [2, 24, 60], "forward_differ": 2, "parameter_shift": 2, "prescrib": 2, "kernelt": 2, "argsmapp": [2, 24], "setarg": 2, "save": [2, 11, 41, 42, 47, 56, 61, 67, 69], "nvqc": [2, 39, 41], "setkernel": 2, "been": [2, 3, 6, 17, 18, 40, 41, 46, 47, 53, 65, 67], "have": [2, 3, 4, 6, 9, 10, 14, 15, 16, 17, 18, 22, 24, 38, 41, 42, 43, 47, 49, 53, 56, 57, 59, 63, 65, 67, 68, 69, 71, 72, 74], "funcatx": [2, 3], "func": [2, 24, 38, 61, 63], "clone": [2, 11, 36, 63, 65], "deriv": [2, 4, 6, 9, 24, 59], "exp_h": [2, 24], "forward": [2, 11], "approxim": [2, 4, 14, 21, 43, 47, 51], "registri": [2, 67], "unit": [2, 3, 18, 23, 28, 29, 31, 34, 36, 40, 46, 59], "express": [2, 17, 22, 24, 25, 26, 27, 29, 32, 42, 46, 54, 55, 61, 71, 74], "certain": [2, 17, 36, 41, 42, 43, 64, 67], "logic": [2, 9, 34, 36, 42], "connect": [2, 4, 11, 14, 22, 29, 34, 36, 38, 53, 65, 74], "queue": [2, 24, 41, 53], "enqueu": 2, "relat": [2, 4, 6, 14, 17, 61], "quantum_platform": [2, 3, 34, 42, 52, 61], "baseremoterestqpu": 2, "baseremotesimulatorqpu": 2, "_qpuid": 2, "setid": 2, "thread": [2, 3, 29, 42, 43, 52, 56, 64], "getexecutionthreadid": 2, "getnumqubit": 2, "getconnect": 2, "issimul": 2, "supportsconditionalfeedback": 2, "feedback": [2, 29, 46, 67], "remotecap": 2, "getremotecap": 2, "capabl": [2, 6, 17, 41, 43, 56, 65, 67], "setshot": 2, "_nshot": 2, "noth": 2, "wish": [2, 4, 41, 42, 52, 67], "isemul": 2, "local": [2, 3, 7, 18, 21, 40, 41, 42, 47, 50, 53, 61, 65, 66, 68], "emul": [2, 3, 40, 53], "quantumtask": 2, "setexecutioncontext": 2, "resetexecutioncontext": 2, "reset": [2, 3, 24, 27, 29, 43, 64], "launchkernel": 2, "kernelfunc": 2, "uint64_t": 2, "rawarg": 2, "launch": [2, 24, 42, 43, 67, 72], "pack": [2, 71], "launchserializedcodeexecut": 2, "serializedcodeexecutioncontext": 2, "serializecodeexecutionobject": 2, "onrandomseedset": 2, "notifi": 2, "let": [2, 6, 9, 10, 13, 14, 15, 16, 17, 18, 19, 31, 38, 45, 46, 47, 50, 52, 54, 55, 56, 57, 58, 59, 60, 61, 67, 68, 69, 72], "basenvcfsimulatorqpu": 2, "submit": [2, 40, 41, 53, 67], "nvcf": 2, "realiz": [2, 7, 17, 59], "intend": [2, 23, 24, 26, 65, 69], "popul": [2, 49], "platformqpu": 2, "qubitconnect": [2, 34], "fetch": [2, 4], "supports_task_distribut": 2, "multipl": [2, 4, 6, 16, 18, 20, 22, 31, 40, 42, 43, 46, 47, 53, 55, 59, 74], "parallel": [2, 23, 29, 43, 47, 67, 72], "qpu_id": [2, 3, 5, 10, 24, 34, 41, 42, 47, 56], "get_shot": 2, "getter": 2, "onc": [2, 4, 7, 15, 16, 17, 26, 40, 41, 43, 46, 47, 53, 65, 67, 69, 72], "set_shot": 2, "clear_shot": 2, "remov": [2, 4, 17, 38, 39, 41, 42, 43, 67], "numshot": 2, "setter": 2, "set_exec_ctx": 2, "get_exec_ctx": 2, "reset_exec_ctx": 2, "num_qpu": [2, 3, 10, 34, 41, 42, 52], "is_simul": [2, 34], "supports_conditional_feedback": 2, "get_current_qpu": [2, 34], "set_current_qpu": [2, 34], "device_id": [2, 34], "is_remot": [2, 3, 34], "qpuid": [2, 34, 42], "is_emul": [2, 3, 34], "set_nois": [2, 3, 57], "get_remote_cap": 2, "applic": [2, 4, 6, 7, 9, 14, 15, 16, 17, 19, 21, 24, 31, 35, 40, 43, 46, 47, 51, 67, 68, 71, 72, 73], "reset_nois": 2, "turn": [2, 11, 15, 41, 48, 64], "off": [2, 3, 4, 6, 11, 15, 41, 42, 65], "enqueueasynctask": 2, "kernelexecutiontask": 2, "launchvq": 2, "kernelarg": 2, "n_param": [2, 58, 60], "vqe": [2, 3, 4, 14, 19, 41, 58, 60], "settargetbackend": 2, "resetlogstream": 2, "log": [2, 3, 22, 41, 65, 67, 74], "getlogstream": 2, "setlogstream": 2, "logstream": 2, "list_platform": 2, "structur": [2, 3, 4, 7, 11, 14, 17, 24, 26, 30, 32, 34, 36, 42, 43, 61, 63, 64, 69], "boolean": [2, 6, 26], "field": [2, 14, 21, 42], "initvalu": 2, "stateoverlap": 2, "serializedcodeexec": 2, "command": [2, 4, 41, 42, 43, 47, 49, 50, 52, 53, 56, 64, 65, 67, 68, 69, 71, 72], "entir": [2, 18, 38, 54, 60, 64], "forth": [2, 42], "commun": [2, 24, 40, 42, 43, 65], "isremotesimul": 2, "ir": [2, 21, 26, 48, 62, 63, 64], "synthesi": [2, 17, 21, 23, 26, 32, 36, 37, 51, 61], "ultim": [2, 61, 64], "what": [2, 3, 4, 6, 14, 16, 18, 21, 22, 44, 56, 64, 71, 74], "ad": [2, 7, 16, 22, 24, 40, 41, 54, 57, 61, 65, 67, 69, 72, 74], "promis": 2, "qubitedg": [2, 34], "num_available_gpu": [2, 3, 47, 56], "set_random_se": [2, 3, 6, 11, 12, 14, 16, 43, 58, 60], "caller": [2, 28], "unset_nois": [2, 3, 57], "dealloc": [2, 29, 36, 64], "mpi": [2, 22, 42, 43, 50, 54, 56, 72, 74], "against": [2, 22, 40, 65, 69, 74], "argc": [2, 27, 47, 65, 72], "argv": [2, 27, 47, 65, 72], "program": [2, 21, 23, 26, 28, 31, 36, 37, 40, 41, 42, 43, 44, 46, 53, 54, 56, 57, 61, 65, 67, 69, 72], "is_initi": [2, 3, 50, 54], "alreadi": [2, 3, 6, 18, 65, 67, 72], "final": [2, 3, 4, 7, 8, 42, 52, 54, 56, 60, 61, 64, 65], "num_rank": [2, 3, 56], "all_gath": [2, 3], "gather": [2, 3, 27, 47, 59], "fit": [2, 65], "come": [2, 7, 29, 41, 53, 71], "all_reduc": 2, "binaryfunct": 2, "localvalu": 2, "reduc": [2, 6, 10, 16, 43], "rootrank": [2, 3], "orca": [2, 39], "input_st": [2, 3, 15, 17, 40, 53], "loop_length": [2, 3, 40, 53], "bs_angl": [2, 3, 40, 53], "n_sampl": [2, 3, 53], "10000": [2, 3, 6, 14, 40, 47, 53, 56], "ps_angl": [2, 3, 53], "make_kernel": [3, 26, 40, 41, 42, 56], "els": [3, 4, 5, 6, 11, 17, 18, 26, 42, 43, 47, 65, 69, 72], "int_valu": 3, "float_valu": 3, "pykernel": 3, "argtypelist": 3, "programmat": 3, "str": [3, 4, 5, 6, 12, 16, 40, 42, 47, 49, 53, 59, 71], "argument_count": 3, "alia": [3, 36], "pykerneldecor": 3, "verbos": [3, 7, 44, 61, 65, 68], "modul": [3, 7, 11, 43, 47, 60, 61, 65], "none": [3, 6, 11, 17, 27, 28, 43], "funcsrc": 3, "locat": [3, 40, 42, 65, 67, 71], "overrideglobalscopedvar": 3, "decor": [3, 4, 28, 45], "lower": [3, 61, 64], "ast": 3, "jit": [3, 4], "executionengin": 3, "__call__": 3, "__str__": 3, "from_json": 3, "jstr": 3, "overridedict": 3, "convert": [3, 4, 6, 7, 24, 52, 61], "json": [3, 40, 42, 53, 67], "to_json": 3, "self": [3, 4, 11, 14, 28, 65, 67], "reconstruct": 3, "elsewher": [3, 17], "type_to_str": 3, "clean": [3, 7, 17], "kwarg": [3, 4], "languag": [3, 17, 21, 22, 25, 28, 29, 30, 31, 36, 37, 42, 46, 54, 59, 61, 64, 68, 74], "attribut": [3, 28, 54, 61], "coprocessor": [3, 24, 28], "shots_count": [3, 4, 6, 9, 10, 12, 13, 16, 40, 47, 50, 54, 56], "over": [3, 13, 24, 36, 47, 53, 57, 58, 60, 64, 67], "ndarrai": [3, 11, 13, 18], "leav": [3, 13, 40, 53, 67], "doesn": 3, "firstfloat": 3, "secondfloat": 3, "kei": [3, 6, 12, 14, 15, 16, 17, 33, 40, 41, 64, 67, 72], "nois": [3, 4, 13, 17, 24, 34, 40, 53, 57], "model": [3, 4, 13, 21, 23, 24, 26, 28, 31, 36, 37, 38, 40, 42, 53, 57, 61, 64, 67, 72], "dictionari": [3, 16, 24, 47, 54, 60], "sampleresult": [3, 4, 47, 54, 64], "sample_async": [3, 24, 42, 47, 53], "_mlir_lib": 3, "_quakedialect": 3, "cudaq_runtim": 3, "asyncsampleresult": [3, 53], "platform": [3, 21, 22, 23, 31, 37, 39, 40, 41, 43, 47, 52, 56, 61, 64, 65, 67, 72, 74], "Will": [3, 33, 47], "whose": [3, 6, 7, 11, 14, 19, 24, 29, 41, 42, 52, 59], "identif": 3, "spin_oper": [3, 14, 47, 52, 60], "spinoper": [3, 4, 5, 11, 12, 14, 20, 47, 52, 56, 60], "everi": [3, 14, 16, 22, 41, 42, 46, 47, 53, 54, 65, 72, 74], "nest": [3, 42], "hermitian": [3, 5], "calcul": [3, 4, 6, 8, 9, 10, 11, 17, 41, 42, 47, 53, 56, 60], "observeresult": [3, 47, 60], "observe_async": [3, 5, 10, 24, 41, 56], "asyncobserveresult": 3, "arg0": [3, 61], "prepar": [3, 4, 10, 11, 15, 16, 19, 49, 52, 54, 56, 58], "select": [3, 4, 6, 11, 17, 19, 43, 47, 50, 52, 67, 71], "get_state_async": [3, 42], "asyncstateresult": 3, "parameter_count": [3, 4, 12, 14, 19, 20, 56, 58, 60], "argument_mapp": [3, 14], "gradient_strategi": [3, 60], "arg1": 3, "format": [3, 6, 11, 17, 18, 24, 27, 36, 65], "ascii": [3, 18], "latex": [3, 18], "cx": [3, 4, 16, 17, 26, 40, 41, 49, 56, 72], "translat": [3, 6, 17, 24, 59, 61], "qir": [3, 61, 64], "adapt": [3, 14, 17, 22, 74], "openqasm2": 3, "openqasm": 3, "moduleid": [3, 61], "llvmdialectmodul": [3, 61], "source_filenam": [3, 61], "opaqu": [3, 36, 61], "__nvqpp__mlirgen__function_variable_qreg": 3, "_z13variable_qregv": 3, "local_unnamed_addr": [3, 61], "tail": [3, 61], "__quantum__rt__qubit_allocate_arrai": [3, 61], "i64": [3, 61], "__quantum__qis__mz": [3, 61], "9": [3, 4, 5, 7, 10, 11, 12, 16, 18, 24, 28, 29, 61, 65, 67], "7": [3, 4, 5, 6, 7, 8, 10, 11, 12, 14, 15, 16, 17, 18, 22, 24, 28, 29, 31, 36, 42, 56, 61, 65, 67, 74], "__quantum__rt__qubit_release_arrai": [3, 61], "ret": [3, 61], "has_target": 3, "get_target": [3, 10, 41, 42, 52, 72], "rais": [3, 5], "set_target": [3, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 40, 41, 42, 43, 47, 49, 50, 52, 53, 56, 57, 64], "reset_target": 3, "initialize_cudaq": 3, "environ": [3, 4, 13, 17, 18, 22, 40, 41, 42, 48, 50, 53, 63, 65, 67, 72, 74], "detect": [3, 47, 56, 65, 67, 71], "simulationprecis": 3, "underyl": 3, "properti": [3, 4, 6, 7, 9, 38], "noindex": 3, "infrastructur": [3, 22, 42, 63, 65, 74], "descript": [3, 17, 41, 43, 64, 65, 67], "featur": [3, 4, 7, 15, 22, 28, 65, 67, 71, 72, 74], "activ": [3, 7, 11, 21, 42, 43, 65, 67, 72], "consist": [3, 4, 6, 7, 17, 47], "physic": [3, 7, 14, 17, 23, 29, 36, 38, 40, 42, 43, 53, 59], "0101": [3, 58], "1010": [3, 58], "consol": [3, 41, 48, 65], "cupi": [3, 67], "gettensor": 3, "compris": 3, "tensori": 3, "mlirvalu": 3, "As": [3, 14, 17, 23, 29, 30, 36, 42, 43, 45, 59, 60, 63], "hold": [3, 60], "__add__": 3, "runtimeerror": [3, 4], "new_valu": 3, "5": [3, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 26, 27, 28, 29, 31, 32, 35, 36, 41, 42, 43, 49, 50, 52, 53, 56, 57, 58, 60, 61, 65, 67, 69, 74], "__radd__": 3, "__sub__": 3, "__rsub__": 3, "__neg__": 3, "__mul__": 3, "__rmul__": 3, "__getitem__": 3, "you": [3, 4, 6, 7, 9, 15, 16, 18, 21, 22, 24, 40, 41, 43, 47, 49, 53, 54, 56, 57, 60, 61, 63, 64, 65, 67, 68, 69, 71, 72, 74], "complexmatrix": 3, "lowest": [3, 7, 17], "__eq__": 3, "togeth": [3, 16, 21, 43, 61, 72], "__iter__": 3, "through": [3, 4, 6, 9, 11, 13, 24, 40, 45, 48, 50, 54, 57, 60, 64, 65, 67, 72], "chunk_count": 3, "d1": 3, "d2": [3, 52], "d3": 3, "receiv": [3, 24], "while": [3, 6, 7, 17, 22, 28, 46, 47, 53, 61, 65, 67, 71, 74], "0j": [3, 5, 10, 12, 14, 47], "get_qubit_count": 3, "get_term_count": [3, 20], "qubit_count": [3, 6, 9, 11, 13, 14, 15, 19, 20, 42, 45, 47, 49, 50, 56, 58, 72], "term_count": [3, 56], "2475644365": 3, "ith": 3, "scipi": [3, 5, 16, 18, 19, 20, 60], "csr_arrai": 3, "print_coeffici": 3, "termin": [3, 56, 67], "At": [3, 7, 65, 67], "directli": [3, 23, 24, 29, 36, 38, 61, 67, 71, 72], "c_if": [3, 26], "dure": [3, 7, 8, 13, 17, 24, 40, 43, 65, 67, 71], "__len__": 3, "equival": [3, 14, 42, 43, 47], "metadata": [3, 19, 61], "experi": [3, 4, 16, 40, 53, 65, 67], "adher": [3, 11, 28, 30, 36, 59, 64], "implicit": [3, 24, 36, 38], "expectation_z": 3, "get_marginal_count": [3, 16], "marginal_indic": 3, "get_register_count": 3, "get_sequential_data": 3, "item": [3, 6, 7, 11, 16, 71], "frequent": 3, "proport": 3, "kick": [3, 42], "pattern": [3, 4, 17, 23, 24, 28, 37, 61, 63], "sub_term": 3, "favor": 3, "get_spin": 3, "accessor": [3, 42], "optimizationresult": 3, "gradientdesc": 3, "initial_paramet": [3, 4, 8, 12, 14, 58, 60], "lower_bound": 3, "max_iter": [3, 4, 60], "maximum": [3, 4, 17, 43], "requires_gradi": 3, "upper_bound": 3, "upper": 3, "neldermead": [3, 12, 14], "lbfg": [3, 24, 41, 60], "centraldiffer": [3, 60], "parameter_vector": [3, 4, 14, 41, 60], "loss": 3, "forwarddiffer": 3, "parametershift": 3, "krauschannel": [3, 13, 57], "__init__": [3, 4, 11, 28], "num_control": 3, "bitflipchannel": [3, 16, 57], "decoher": [3, 13, 57], "Its": [3, 36, 43, 59, 61], "vice": 3, "versa": 3, "180": [3, 57], "therebi": [3, 24, 42, 61], "k_0": [3, 13], "k_1": [3, 13], "therefor": [3, 6, 7, 14, 15, 17, 36, 61, 63], "phaseflipchannel": [3, 57], "untouch": 3, "depolarizationchannel": [3, 13, 57], "mixtur": 3, "k_2": 3, "k_3": 3, "2x2": [3, 43], "decai": [3, 13, 57], "And": [3, 14, 38], "behav": 3, "free": [3, 4, 8, 14, 17, 24, 26, 27, 28, 29, 31, 33, 35, 40, 41, 45, 54, 58, 60, 61, 64, 67], "75": [3, 4, 15, 20], "uniform": [3, 4, 12, 14, 16, 24, 27, 47, 56, 58], "amplitudedampingchannel": [3, 57], "dissip": [3, 57], "energi": [3, 4, 5, 7, 19, 20, 24, 41, 52, 57, 60], "due": [3, 4, 13, 18, 19, 24, 43, 47, 57, 71], "interact": [3, 7, 34, 57, 67], "ii": [3, 14], "ground": [3, 4, 5, 7, 19, 41, 57, 59, 60], "krausoper": [3, 57], "ki": 3, "dag": [3, 18, 33], "col_count": 3, "row_count": 3, "scatter": [3, 4], "concaten": 3, "arg2": 3, "bin": [3, 17, 40, 42, 53, 65, 67], "interferomet": [3, 40, 53], "tbi": [3, 7, 40, 53], "boson": [3, 40, 53], "tutori": [4, 7, 14, 16, 17, 67], "explor": [4, 6, 56, 59, 67], "recent": [4, 6, 7, 17], "research": [4, 41], "arxiv": [4, 6], "paper": [4, 6, 12, 58], "http": [4, 6, 7, 11, 14, 15, 17, 18, 40, 42, 53, 65, 67], "org": [4, 6, 65, 67], "pdf": [4, 6, 18], "2402": 4, "01529": 4, "team": [4, 7], "edinburgh": 4, "jointli": [4, 17], "develop": [4, 17, 21, 28, 29, 40, 41, 43, 51, 59, 63, 64, 65, 68, 72], "nvidia": [4, 5, 7, 8, 9, 10, 11, 12, 14, 15, 17, 19, 20, 21, 22, 23, 29, 39, 43, 47, 49, 50, 52, 56, 64, 65, 67, 69, 72, 74], "author": 4, "better": [4, 14, 16, 17, 41, 43, 65], "understand": [4, 16, 23, 67], "barrier": 4, "mit": 4, "licens": [4, 65, 67], "found": [4, 6, 7, 18, 22, 24, 27, 31, 40, 47, 64, 65, 67, 69, 70, 72, 74], "github": [4, 7, 11, 14, 15, 17, 22, 40, 43, 65, 67, 72, 74], "com": [4, 7, 11, 14, 15, 17, 40, 53, 65, 67], "boniface316": 4, "bigdata_vqa": 4, "unsupervis": 4, "learn": [4, 6, 11, 14, 17, 18, 22, 41, 46, 47, 71, 72, 74], "techniqu": [4, 6, 43, 47], "aim": [4, 6, 9, 14, 49], "group": [4, 36, 43], "similar": [4, 24, 42, 47, 65], "characterist": 4, "enhanc": [4, 21], "find": [4, 5, 9, 14, 16, 17, 19, 21, 40, 41, 42, 59, 60, 61, 65, 67], "reliabl": [4, 71], "analysi": [4, 7, 38, 61], "todai": 4, "sever": [4, 7, 54, 57], "limit": [4, 42, 43, 47, 56, 71], "practic": [4, 9, 16, 17, 57], "would": [4, 6, 7, 9, 14, 15, 22, 38, 56, 59, 65, 67, 69, 71, 74], "far": 4, "too": [4, 18, 50, 59], "mani": [4, 6, 15, 17, 22, 31, 34, 42, 43, 47, 56, 72, 74], "extend": [4, 15, 21, 22, 23, 70, 74], "harrow": 4, "fewer": [4, 6, 7, 43], "walk": [4, 7, 64, 65, 67], "approach": [4, 6, 15, 16, 24, 28, 61], "emphas": 4, "util": [4, 11, 13, 17, 24, 36, 41, 42, 43, 56, 61, 64], "bipartit": 4, "branch": [4, 22, 26, 65, 67, 74], "directori": [4, 63, 65, 67, 71], "tree": 4, "uncom": [4, 14, 65, 67], "line": [4, 6, 14, 18, 40, 42, 43, 49, 53, 61, 64, 65, 67], "insid": [4, 42, 67], "skip": [4, 18, 65], "mkdir": [4, 64, 65, 68], "divisive_clustering_src": 4, "wget": [4, 65, 67], "p": [4, 7, 10, 12, 13, 16, 57, 58, 65, 67], "githubusercont": 4, "doc": [4, 42], "sphinx": 4, "divisive_clust": 4, "py": [4, 20, 42, 43, 47, 48, 56, 60, 67, 72], "main_divisive_clust": 4, "instal": [4, 5, 6, 7, 8, 11, 16, 17, 18, 19, 20, 21, 22, 40, 43, 61, 63, 64, 68, 69, 71, 74], "packag": [4, 5, 7, 8, 9, 11, 16, 17, 18, 20, 65, 67, 71, 72], "pip": [4, 5, 6, 7, 8, 11, 16, 17, 18, 19, 20, 42, 43, 65, 67, 72], "mpi4pi": [4, 43, 72], "6": [4, 5, 6, 7, 8, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22, 24, 27, 28, 29, 31, 32, 36, 40, 41, 42, 43, 52, 53, 60, 61, 67, 74], "networkx": 4, "panda": [4, 16], "scikit": [4, 11], "tqdm": [4, 17], "66": [4, 12], "auxillari": [4, 49], "nx": 4, "pd": [4, 16], "matplotlib": [4, 6, 7, 8, 11, 12, 16, 18, 19, 20], "pyplot": [4, 6, 7, 8, 11, 12, 16, 18, 19, 20], "plt": [4, 6, 7, 8, 11, 12, 16, 17, 18, 19, 20], "warn": [4, 17, 18, 20, 40], "divisiveclust": 4, "dendrogram": 4, "voironi_tessal": 4, "filterwarn": 4, "below": [4, 6, 7, 8, 9, 11, 14, 15, 17, 18, 19, 22, 24, 40, 41, 42, 43, 47, 53, 56, 58, 60, 61, 65, 67, 71, 72, 74], "toggl": 4, "circuit_depth": 4, "max_shot": 4, "x_1": 4, "x_2": 4, "cdot": [4, 6], "x_n": 4, "weight": [4, 7, 12, 17], "much": [4, 60, 64], "smaller": [4, 7, 43], "w": [4, 33, 43, 53], "enough": 4, "reason": [4, 38], "conclus": 4, "There": [4, 24, 26, 40, 41, 42, 56, 67], "variou": [4, 22, 42, 45, 54, 57, 61, 64, 74], "build": [4, 7, 8, 14, 16, 18, 19, 21, 22, 26, 31, 32, 44, 46, 47, 52, 58, 59, 60, 63, 64, 67, 68, 69, 71, 74], "machin": [4, 14, 17, 23, 37, 40, 42, 53, 67], "1703": 4, "06476": 4, "algorithm": [4, 7, 8, 14, 15, 19, 21, 23, 26, 28, 37, 38, 41, 42, 43, 47, 49, 51, 52, 55, 60, 67], "essenti": 4, "boil": 4, "down": [4, 42], "toler": 4, "constraint": [4, 16, 17, 28, 29, 30, 43, 47, 53, 59], "priori": 4, "load": [4, 11, 24, 29, 40, 41, 53, 61, 63], "frame": 4, "imag": [4, 5, 6, 11, 14, 17, 18, 22, 53, 65, 72, 74], "black": [4, 9], "star": 4, "create_dataset": 4, "number_of_sampling_for_centroid": 4, "coreset_s": 4, "number_of_coresets_to_evalu": 4, "coreset_method": 4, "bfl2": 4, "coreset_vector": 4, "coreset_weight": 4, "get_best_coreset": 4, "coreset_df": 4, "datafram": [4, 16], "chr": 4, "65": [4, 6, 14, 16], "028364": 4, "669787": 4, "234": [4, 16], "230716": 4, "167441": 4, "354792": 4, "101": [4, 6, 15, 16, 27], "319288": 4, "b": [4, 24, 53], "022889": 4, "921443": 4, "125": [4, 24, 27, 32, 41, 42, 52, 60], "158339": 4, "706134": 4, "636852": 4, "13": [4, 6, 11, 12, 14, 16, 19, 20, 56, 58, 60, 61, 67], "650774": 4, "998497": 4, "455847": 4, "116": 4, "758239": 4, "507918": 4, "630311": 4, "120": [4, 6, 67], "727176": 4, "102508": 4, "297727": 4, "53": [4, 16], "294127": 4, "722463": 4, "400433": 4, "77": [4, 16], "415840": 4, "425868": 4, "341136": 4, "42": [4, 6, 11, 16, 19, 20], "847985": 4, "985373": 4, "063209": 4, "240": 4, "116237": 4, "label": [4, 7, 11, 16, 17, 61, 65, 72], "7eba00": 4, "color": [4, 14], "marker": 4, "xlabel": [4, 7, 8, 11, 12, 17, 19, 20], "ylabel": [4, 7, 8, 11, 12, 17, 19, 20], "titl": [4, 17, 19, 20, 40, 60, 67, 72], "best": [4, 7, 15, 17, 65, 67], "legend": [4, 7, 11], "In": [4, 6, 7, 9, 13, 14, 16, 17, 18, 24, 28, 38, 40, 42, 43, 45, 47, 49, 52, 53, 54, 57, 60, 63, 64, 65, 71], "cast": [4, 20], "problem": [4, 5, 14, 15, 19, 38, 46, 58], "routin": [4, 14, 24, 60], "graph": [4, 12, 14, 58], "edg": [4, 12, 14], "e_": 4, "ij": [4, 17], "w_iw_jd_": 4, "d_": 4, "euclidean": 4, "distanc": [4, 16, 19], "coreset_to_graph": 4, "vqa": 4, "hamiltonian": [4, 5, 8, 10, 11, 12, 13, 14, 19, 20, 27, 41, 42, 43, 47, 52, 58, 60], "src": [4, 40, 65], "motiv": [4, 37, 65], "cut": [4, 21, 58], "get_k2_hamiltonian": 4, "k2": 4, "layer": [4, 11, 14, 28, 58, 60], "r_z": 4, "r_y": 4, "cascad": 4, "benefit": [4, 22, 47, 72, 74], "get_vqe_circuit": 4, "number_of_qubit": 4, "theta_posit": 4, "rz": [4, 14, 18, 27, 31, 58], "visual": [4, 14, 21, 38, 51], "rand": [4, 10, 49], "8904": 4, "7335": 4, "4343": 4, "2236": 4, "7937": 4, "9981": 4, "3945": 4, "q2": [4, 6, 8, 15, 17, 18], "696": 4, "3352": 4, "q3": [4, 6, 18], "6658": 4, "05277": 4, "q4": [4, 6], "791": 4, "003569": 4, "4119": 4, "3205": 4, "3504": 4, "3913": 4, "7392": 4, "3171": 4, "0008056": 4, "proper": 4, "get_optim": 4, "addit": [4, 6, 9, 15, 24, 41, 45, 46, 49, 56, 65, 71, 72], "initial_param": 4, "divisiveclusteringvqa": 4, "procedur": [4, 8, 17, 19], "top": [4, 6, 9, 16, 42, 64, 68], "pleas": [4, 18, 20, 22, 41, 42, 43, 53, 56, 63, 65, 67, 72, 74], "run_divisive_clust": 4, "get_counts_from_simul": 4, "cost": [4, 11, 12, 14, 19, 20, 21, 24, 41, 60], "our": [4, 6, 8, 9, 13, 14, 17, 18, 22, 38, 40, 45, 47, 49, 53, 54, 55, 56, 57, 60, 61, 65, 67, 68, 69, 72, 74], "obtain": [4, 7, 10, 16, 18, 19, 22, 41, 65, 74], "acceler": [4, 11, 21, 22, 41, 43, 47, 49, 50, 56, 64, 65, 67, 72, 74], "associ": [4, 14, 29, 42, 59], "super": [4, 11], "coreset_vectors_df_for_iter": 4, "coreset_vectors_for_iteration_np": 4, "coreset_weights_for_iteration_np": 4, "_get_iteration_coreset_vectors_and_weight": 4, "metric": 4, "coreset_to_graph_metr": 4, "_get_best_bitstr": 4, "len": [4, 5, 6, 7, 8, 11, 12, 14, 15, 16, 17, 20, 27, 36, 42, 47, 49, 53, 56, 72], "node": [4, 5, 12, 14, 23, 42, 56, 65], "create_hamiltonian": 4, "optimizer_funct": 4, "create_circuit": 4, "objective_funct": [4, 60], "get_result": [4, 60], "optimal_paramet": [4, 12, 14, 41, 58], "mostli": 4, "previous": [4, 40, 67], "threshold_for_max_cut": 4, "percent": 4, "advanc": [4, 6, 60], "normal": [4, 11, 19, 20, 59], "get_divisive_sequ": 4, "analyz": [4, 17, 63], "postprocess": 4, "sourc": [4, 13, 14, 16, 22, 38, 43, 49, 57, 61, 64, 67, 68, 69, 72, 74], "12": [4, 5, 7, 11, 16, 17, 18, 24, 41, 61, 65, 67], "normalize_vector": 4, "sort_by_descend": 4, "dist": [4, 16, 18, 71], "hierarchial_clustering_sequ": 4, "100": [4, 6, 7, 11, 13, 16, 20, 27, 50], "129": [4, 6], "lt": [4, 7], "12075": 4, "19it": 4, "35025": 4, "50it": 4, "18": [4, 7, 16, 61], "44254": 4, "09it": 4, "15827": 4, "56it": 4, "13617": 4, "87it": 4, "nice": 4, "earli": [4, 41, 67], "split": [4, 56], "mark": [4, 71], "least": [4, 6, 14, 17, 42, 65], "dendo": 4, "plot_dendrogram": 4, "plot_titl": 4, "plot": [4, 7, 8, 11, 12, 16, 17, 19, 20], "notic": [4, 6, 14, 17, 38, 49, 50, 56, 61, 68], "complic": [4, 32], "becom": [4, 7, 16, 43, 52, 67, 68], "occasion": 4, "especi": 4, "partit": [4, 12, 14, 41, 42, 67], "puzzl": 4, "glanc": 4, "seem": [4, 50, 59, 67, 72], "natur": [4, 18, 43, 59], "strai": 4, "belong": 4, "wrong": 4, "explan": 4, "stochast": [4, 24], "few": [4, 6, 14, 17], "were": [4, 6, 18, 49, 60, 67], "rememb": [4, 9], "pai": [4, 15], "penalti": [4, 12], "exclud": [4, 41, 47, 49, 65], "proxim": 4, "small": [4, 6, 16, 43, 71], "less": [4, 6, 7, 57, 65], "impact": [4, 13, 57], "usual": [4, 65, 67, 71], "look": [4, 18, 22, 38, 40, 42, 46, 47, 50, 52, 53, 54, 55, 56, 57, 60, 61, 65, 67, 74], "unusu": 4, "go": [4, 9, 17, 18, 36, 42, 54, 65, 67], "origin": [4, 13, 38, 49, 60, 61], "14": [4, 6, 16, 17, 41, 53, 61], "plot_hierarchial_split": 4, "hierarch": 4, "flat": [4, 42], "perpendicular": 4, "intersect": 4, "threshold": [4, 5, 6, 43], "height": 4, "want": [4, 6, 10, 14, 16, 17, 18, 38, 41, 42, 61, 64, 65, 67, 69, 72], "get_clusters_using_k": 4, "desir": [4, 6, 17, 34, 42, 47, 64, 65, 67, 69], "figur": [4, 6, 9, 11, 15, 17, 61], "15": [4, 16, 56, 60, 61, 65, 67], "threshold_height": 4, "get_clusters_using_height": 4, "red": [4, 16], "blue": 4, "green": [4, 14], "purpl": 4, "orang": 4, "yellow": 4, "color_threshold": 4, "plot_clust": 4, "16": [4, 6, 7, 16, 18, 41, 60, 61], "show_annot": 4, "get_voronoi_tessal": 4, "region": 4, "accord": 4, "centroid": 4, "tesslation_by_clust": 4, "complet": [4, 13, 24, 40, 65, 67, 71, 72], "plot_voironi": 4, "overlai": 4, "vt": 4, "voironi": 4, "tessal": 4, "design": [4, 14, 21, 23, 42, 72], "flexibl": [4, 45, 65], "tool": [4, 16, 18, 22, 38, 61, 63, 65, 69, 71, 74], "done": [4, 6, 7, 18, 36, 48, 57, 65, 67], "get_qaoa_circuit": 4, "rx": [4, 8, 10, 11, 12, 14, 16, 18, 31, 35, 56, 58], "3527": 4, "19": [4, 6, 16, 18, 41, 61], "20": [4, 5, 6, 16, 30, 36, 60, 61, 69, 72], "484": 4, "12163": 4, "89it": 4, "52703": 4, "30it": 4, "48": 4, "31987": 4, "07it": 4, "36393": 4, "37957": 4, "42473": 4, "96it": 4, "quickli": [4, 24, 67], "encount": [4, 41, 43, 53, 65, 67, 72], "challeng": [4, 6], "port": [4, 42, 67], "hpc": [4, 22, 67, 74], "becam": 4, "massiv": 4, "25": [4, 6, 7, 11, 15, 16, 17, 27, 41, 42, 43, 47, 56, 67], "present": [4, 14, 16, 17, 47, 50, 65, 68], "compar": [4, 46, 47, 49, 50, 67, 72], "your": [4, 18, 21, 24, 40, 41, 42, 43, 44, 49, 52, 53, 56, 57, 60, 64, 65, 67, 71], "100000": [4, 10, 56], "try": [4, 6, 15, 17, 18, 56, 67], "slightli": [4, 60], "qpp": [4, 11, 12, 14, 15, 17, 20, 39, 41, 43, 47, 56, 61, 64, 67, 72], "python3": [4, 18, 42, 43, 47, 48, 56, 65, 67, 72], "751": 4, "3460": 4, "26it": 4, "42771": 4, "74it": 4, "4064": 4, "6862": 4, "37it": 4, "56871": 4, "92it": 4, "44979": 4, "13it": 4, "128": [4, 11, 17, 61], "19366": 4, "94it": 4, "53773": 4, "54648": 4, "91it": 4, "51941": 4, "85it": 4, "56111": 4, "461": 4, "866833317": 4, "spent": 4, "452308367999706": 4, "oner": 4, "feel": 4, "interrupt": 4, "patienc": 4, "worn": 4, "still": [4, 28, 38, 47, 53, 57, 59, 67, 71], "easili": [4, 14, 47, 49, 50, 60, 65, 67, 71], "27": [4, 6, 16, 17, 47], "7352": 4, "03": [4, 7, 41], "2063": 4, "82it": 4, "16492": 4, "4739": 4, "44it": 4, "256": [4, 11], "15185": 4, "58it": 4, "64": [4, 11, 42, 43, 61, 65, 67], "23728": 4, "05it": 4, "15437": 4, "97it": 4, "50840": 4, "32": [4, 11, 16, 17, 40, 43, 61, 67], "33562": 4, "54120": 4, "54560": 4, "55924": 4, "42717": 4, "29it": 4, "55007": 4, "27it": 4, "53601": 4, "33it": 4, "47127": 4, "01it": 4, "67": 4, "61674502899999": 4, "21": [4, 16, 61], "439895901": 4, "push": [4, 71], "a100": 4, "yourself": [4, 65], "28": [4, 11, 16, 17, 18, 20, 22, 42, 50, 65, 67, 72, 74], "nlopt": [4, 61], "failur": [4, 71], "To": [4, 6, 13, 14, 15, 16, 17, 24, 28, 31, 36, 40, 41, 42, 43, 46, 47, 50, 52, 53, 54, 57, 61, 63, 64, 65, 67, 68, 69, 71, 72], "pool": [4, 41, 56], "finish": [4, 47, 61], "fail": [4, 43, 63, 67, 71], "immedi": [4, 42, 64], "issu": [4, 24, 43, 65, 67, 71], "30": [4, 11, 16, 17, 42, 49, 56], "mgpu": [4, 15, 22, 39, 41, 42, 43, 56, 74], "gpu_count": 4, "smi": [4, 65, 67], "l": [4, 6, 7, 24, 61, 69, 71], "wc": 4, "mpirun": [4, 42, 43, 56], "Not": [4, 28, 41, 67], "pyscf": [5, 7, 20], "openfermionpyscf": [5, 19, 20], "openfermion": [5, 7, 20], "multi_gpu": 5, "mqpu": [5, 10, 39, 43, 47, 52, 56], "molecul": [5, 7, 19, 21], "geometri": [5, 19, 20], "7474": [5, 19], "chemistri": [5, 19], "create_molecular_hamiltonian": [5, 19], "sto": [5, 19], "3g": [5, 19], "electron_count": [5, 19, 20], "n_electron": [5, 19], "qubits_num": 5, "n_orbit": [5, 19], "spin_ham_matrix": 5, "linalg": [5, 16], "eig": 5, "min": [5, 6, 11, 53], "argmin": [5, 17], "min_indic": 5, "eigen": [5, 27, 64], "vec": 5, "1371757102406843": 5, "termcoeffici": 5, "ham": [5, 10, 12], "termword": 5, "pauli_str": 5, "u_psi": [5, 10], "dt": 5, "pauli_word": [5, 12, 42], "u_m": 5, "exp_pauli": [5, 12], "u_phi": [5, 10], "u_n": 5, "apply_pauli": [5, 10], "qfd_kernel": 5, "dt_alpha": 5, "dt_beta": 5, "word_list": 5, "ancilla": [5, 24, 26], "my_list": 5, "compon": [5, 6, 14, 17, 65, 67, 71, 72], "x_0": [5, 10], "y_0": [5, 10], "space": [5, 7, 18, 21, 29, 36, 42, 53], "m_qfd": 5, "observe_op": 5, "identity_word": 5, "pauli_list": 5, "wf_overlap": 5, "dtype": [5, 13, 16, 17, 57], "dt_m": 5, "dt_n": 5, "temp": [5, 61], "conj": [5, 10, 17], "collect_overlap_r": 5, "collect_overlap_img": 5, "count_id": 5, "tot_dim": 5, "real_val": 5, "img_val": 5, "ham_matrx": 5, "tot_": 5, "coef": [5, 12], "zip": [5, 12, 65], "ham_matrix_r": 5, "ham_matrix_imag": 5, "diagon": [5, 43], "solver": 5, "hc": 5, "sce": 5, "1e": [5, 7, 43], "s_diag": 5, "s_prime": 5, "sii": 5, "valueerror": 5, "eval": [5, 11], "x_prime": 5, "h_prime": 5, "conjug": 5, "transpos": [5, 7], "dot": [5, 14, 16], "e_prim": 5, "c_prime": 5, "eigen_valu": 5, "eigen_vect": 5, "qfd": 5, "1367554712424826": 5, "373828079812224e": 5, "20j": 5, "famou": 6, "particularli": [6, 17, 43, 46], "signific": [6, 22, 74], "becaus": [6, 9, 16, 17, 38, 43, 49, 53, 65, 67, 72], "potenti": [6, 24, 47], "break": 6, "modern": 6, "asymmetr": 6, "encrypt": [6, 67], "scheme": 6, "rsa": [6, 67], "li": [6, 15, 61], "introduc": [6, 14, 24], "preliminari": [6, 7], "proce": [6, 67, 72], "explain": [6, 17, 42, 59], "contfrac": 6, "156": 6, "gcd": 6, "log2": 6, "ceil": 6, "fraction": [6, 43], "a_1": [6, 16], "a_2": 6, "interest": [6, 15, 17, 19, 20, 52, 54], "prime": [6, 15], "solut": [6, 14], "satisfi": [6, 13, 18, 36, 53, 65], "neq": [6, 9], "idea": [6, 15], "share": [6, 43, 64, 67, 71], "greatest": 6, "divisor": 6, "smallest": 6, "posit": [6, 13, 14, 16, 17, 31, 43], "equiv": [6, 59], "combin": [6, 7, 10, 16, 21, 46, 47, 59, 70, 71], "rule": [6, 9], "easi": [6, 14, 57, 69], "re": [6, 10, 16, 24, 38, 54, 56, 57, 65, 67], "frac": [6, 7, 9, 10, 14, 15, 16, 18], "shors_algorithm": 6, "outlin": [6, 71], "purpos": [6, 29, 38, 67], "demonstr": [6, 8, 9, 15, 17, 19, 23, 24, 26, 42, 47, 50, 55, 61], "investig": 6, "terminologi": 6, "literatur": 6, "period": 6, "recast": 6, "choic": [6, 16, 43], "a1": 6, "a2": 6, "divisor1": 6, "divisor2": 6, "happen": [6, 38, 67], "chanc": [6, 71], "find_order_quantum": 6, "find_order_class": 6, "test_ord": 6, "retri": [6, 18], "establish": 6, "rewritten": [6, 18], "tag": [6, 7, 9, 15, 65, 67], "rewrit": [6, 63], "equat": [6, 7, 14, 15, 17], "peter": 6, "greater": [6, 38, 41, 43, 59], "50": [6, 47, 57, 59, 71], "randomli": 6, "block": [6, 7, 14, 33, 60], "search": [6, 17, 65, 67], "157": [6, 16], "possible_factor": 6, "test_factor": 6, "did": [6, 65, 67], "No": [6, 17, 53, 56, 67], "straightforward": 6, "notabl": 6, "ineffici": 6, "158": 6, "naiv": [6, 38], "interv": [6, 19], "often": [6, 24, 38, 65, 67], "guess": [6, 7], "159": [6, 16], "my_integ": 6, "123": 6, "edit": [6, 67], "choos": [6, 7, 13, 47, 67], "initial_value_to_start": 6, "41": [6, 14], "central": 6, "lceil": 6, "rceil": 6, "involv": [6, 8, 43, 56, 61, 71], "diagram": [6, 9, 14, 15, 40, 53], "nbsphinx": [6, 7], "rangl": [6, 7, 15, 16, 17, 24, 72], "modulo": [6, 9], "accuraci": [6, 11, 17, 43], "estim": [6, 7, 16, 19, 47], "phase_kernel": 6, "ll": [6, 14, 15, 54, 60, 61, 64, 68], "ai": 6, "repeatedli": [6, 47], "carri": 6, "exponent": 6, "160": [6, 16], "quantum_fourier_transform": [6, 15], "hadamard": [6, 15, 21, 26, 31, 36, 38, 49, 54, 57, 59, 63], "cr1": [6, 15, 27], "inverse_qft": [6, 15], "provabl": 6, "faster": [6, 15, 17, 43], "hefti": 6, "scale": [6, 7, 16, 17, 31, 43, 56, 59], "5l": 6, "continu": [6, 15, 17, 47, 53, 61], "algoirthm": 6, "72l": 6, "exponentiaion": 6, "beckman": 6, "chari": 6, "devabhaktuni": 6, "preskil": 6, "1996": 6, "beyond": [6, 41, 43, 56, 63], "focu": [6, 7, 17], "difficulti": [6, 49], "depict": [6, 14, 18], "report": 6, "161": [6, 16], "modular_mult_5_21": 6, "physlab": 6, "wp": 6, "content": [6, 24, 40, 53, 60, 64, 67], "upload": 6, "2023": 6, "05": [6, 41], "shor_s_algorithm_23100113_fin": 6, "modif": [6, 43, 47, 54], "modular_exp_5_21": 6, "expon": 6, "control_s": 6, "ctrl_qubit": [6, 35], "verifi": [6, 15, 59], "fact": [6, 10, 15, 38, 71], "198": 6, "5y": 6, "demonstrate_mod_exponenti": 6, "init": 6, "200": [6, 24], "revers": [6, 15, 35], "integer_result": 6, "10100": [6, 14], "previou": [6, 30, 36, 60, 67], "199": 6, "modular_exp_4_21": 6, "ab": [6, 17], "2103": 6, "13855": 6, "account": [6, 40, 41, 53, 67], "drawn": [6, 16], "control_register_s": 6, "work_register_s": 6, "control_regist": 6, "work_regist": 6, "201": 6, "values_for_a": 6, "15000": 6, "q5": 6, "q6": 6, "q7": 6, "r1": [6, 15, 18, 27, 31, 38], "7854": [6, 15], "571": [6, 15], "2843": 6, "010": [6, 15, 16], "913": 6, "1850": 6, "001": [6, 11, 15, 16, 67], "1935": 6, "011": [6, 16, 27], "1830": 6, "2846": 6, "1861": 6, "110": [6, 16], "922": 6, "ax": [6, 16], "outcom": [6, 14], "top_result": 6, "202": 6, "dict": [6, 16, 17], "results_dictionari": 6, "k": [6, 12, 15, 28, 60], "pop": [6, 67, 71], "sorted_result": 6, "sort": [6, 68], "top_kei": 6, "max_valu": 6, "top_results_dictionari": 6, "One": [6, 15, 17, 24, 38, 42, 43, 48, 52], "203": 6, "750": 6, "39": [6, 8, 12, 16, 17, 18, 20], "lectur": 6, "scott": 6, "aaronson": 6, "204": 6, "get_order_from_phas": 6, "phase_nbit": 6, "eigenphas": 6, "from_float": 6, "limit_denomin": 6, "numer": [6, 7], "denomin": 6, "coefficients_continued_fract": 6, "continued_fract": 6, "convergents_continued_fract": 6, "converg": [6, 20], "sequenc": [6, 9, 14, 17, 38, 46], "algoithm": 6, "205": 6, "zero_result": 6, "join": [6, 16, 49], "elem": 6, "most_probable_bitpattern": 6, "reverse_result": 6, "nonzero": 6, "bitpattern": 6, "206": 6, "replac": [6, 14, 40, 41, 60, 61, 63, 65, 67], "11010": [6, 14], "452": 6, "11001": [6, 14], "92": 6, "11101": [6, 14], "47": [6, 14, 16, 18], "00000": [6, 14], "2485": 6, "01001": [6, 14], "96": 6, "00100": [6, 14], "131": [6, 16], "01011": [6, 14], "1747": 6, "00101": [6, 14], "1654": 6, "10101": [6, 14], "1736": 6, "00110": [6, 14], "475": [6, 56], "11111": [6, 14], "23": [6, 16], "01000": [6, 14], "01101": [6, 14], "38": [6, 16, 17, 65, 67], "01110": [6, 14], "35": [6, 15, 16, 17, 20], "01010": [6, 14], "420": 6, "11110": [6, 14], "22": [6, 11, 16, 18, 47, 61, 65, 67], "01111": [6, 14], "26": [6, 16, 17, 18, 20, 41], "00011": [6, 14], "01100": [6, 14, 42], "10011": [6, 14, 42], "00010": [6, 14], "00001": 6, "11011": [6, 14], "1710": 6, "00111": [6, 14], "79": [6, 16, 41], "11100": [6, 14], "113": 6, "10001": [6, 14], "10010": [6, 14], "29": [6, 16, 17, 42], "10110": [6, 14], "467": 6, "2536": 6, "10111": [6, 14], "81": 6, "11000": [6, 14], "61": [6, 16], "8125": 6, "8421052631578947": 6, "od": 6, "regev": 6, "improv": [6, 22, 43, 56, 67, 74], "collabor": 7, "basf": 7, "hybrid": [7, 8, 21, 60, 68, 72], "workflow": [7, 8, 11, 21, 24, 51, 61, 65, 68], "strongli": [7, 65], "eigensolv": [7, 21, 51], "preserv": [7, 13], "propos": [7, 17, 60], "anselmetti": 7, "et": [7, 14, 17], "al": [7, 14, 17], "2021": 7, "psi_t": 7, "evolut": [7, 18, 27, 29, 38, 64], "ipi": 7, "gto": [7, 20], "scf": [7, 20], "ao2mo": 7, "mcscf": [7, 20], "afqmc_src": 7, "vqe_cudaq_qnp": 7, "get_cudaq_hamiltonian": 7, "utils_ipi": 7, "get_coeff_wf": 7, "gen_ipie_input_from_pyscf_chk": 7, "hamgener": 7, "qmc": 7, "trial_wavefunct": 7, "particle_hol": 7, "particlehol": 7, "extract_observ": 7, "tricki": 7, "manual": [7, 42, 50, 57, 65, 67], "streamlin": [7, 21, 72], "update_opt": 7, "use_gpu": 7, "hartre": [7, 19], "fock": [7, 19], "chelat": 7, "agent": [7, 65], "substanc": 7, "industri": 7, "Their": [7, 65], "among": [7, 14, 42], "water": [7, 21], "soften": 7, "redox": 7, "behaviour": [7, 17, 18], "oxid": 7, "bleach": 7, "suppress": 7, "soil": 7, "remedi": 7, "ligand": 7, "catalyst": 7, "particular": [7, 14, 18, 22, 40, 67, 71, 74], "fe": 7, "iii": 7, "nta": 7, "fenta": 7, "atom": [7, 19, 20, 59, 60], "geo_fenta": 7, "xyz": 7, "cc": [7, 20, 38, 61, 65], "pvtz": 7, "num_active_orbit": 7, "num_active_electron": 7, "o3": 7, "geo_o3": 7, "help": [7, 16, 18, 48, 67], "restric": 7, "open": [7, 42, 53, 61, 65, 67], "shell": [7, 18, 65, 67, 72], "hf": 7, "hartee_fock": 7, "rohf": 7, "chkfile": 7, "chk": 7, "224": [7, 16], "34048064812262": 7, "600": [7, 67], "orbit": [7, 20], "1200": 7, "143": 7, "electron": [7, 19, 20], "imposs": 7, "statevector": [7, 8, 15, 56, 59, 72], "contribut": [7, 22, 67, 74], "whole": 7, "post": [7, 17, 24, 40, 67], "casci": [7, 20], "bodi": [7, 28], "t_": 7, "pq": 7, "v_": 7, "prq": 7, "integr": [7, 21, 23, 29, 36, 40, 42, 67, 68], "sum_": [7, 13, 14, 15, 32, 59], "hat": 7, "dagger": [7, 10, 13, 17, 33, 59], "pqr": 7, "a_": 7, "jordan_wign": [7, 20], "generate_hamiltonian": 7, "fix_spin_": 7, "ss": 7, "h1": [7, 40, 53], "shown": [7, 9, 42, 43], "energy_cor": 7, "get_h1eff": 7, "h2": [7, 21], "get_h2eff": 7, "h2_no_symmetri": 7, "restor": 7, "v_pqr": 7, "asarrai": 7, "mol_ham": 7, "jw_hamiltonian": 7, "constant_term": 7, "n_vqe_lay": 7, "maxit": [7, 16, 19, 20], "return_final_state_vec": 7, "n_qubit": [7, 16, 27, 58, 60], "optimized_energi": 7, "energy_optim": 7, "final_state_vector": 7, "state_vec": 7, "vqe_energi": 7, "callback_energi": 7, "num": 7, "n_layer": [7, 58, 60], "3901690611431": 7, "drive": [7, 29], "accur": [7, 16], "wide": [7, 14, 17, 38, 61, 71], "solid": 7, "summar": [7, 15, 67], "introduct": [7, 21, 37, 51, 69, 72], "quantiz": [7, 15], "_1": [7, 16], "_2": 7, "h_": 7, "_r": 7, "fermion": 7, "annihil": 7, "h_1": 7, "h_2": [7, 19], "omit": [7, 65], "propag": 7, "chosen": [7, 43, 56, 65], "slater": 7, "ket": [7, 8, 9, 10, 15, 18, 47, 59], "psi_": [7, 9], "toward": 7, "psi_0": [7, 9], "sim": 7, "lim_": 7, "infti": 7, "delta": 7, "tau": 7, "right": [7, 10, 14, 15], "reli": [7, 17, 31, 61, 67, 69, 71], "squar": [7, 16, 36, 59], "gamma": 7, "v_0": [7, 14], "n_": 7, "choleski": 7, "decomposit": [7, 43], "pr": [7, 21], "evolv": [7, 29, 59], "ensembl": [7, 47], "walker": 7, "access": [7, 9, 15, 22, 24, 29, 40, 41, 50, 54, 55, 56, 59, 64, 74], "mathcal": 7, "text": [7, 8, 9, 15, 16, 17, 18], "loc": 7, "bra": [7, 8, 10, 47], "mathrm": 7, "braket": [7, 10], "mix": [7, 13, 53, 57], "wavefunct": [7, 59], "checkpoint": 7, "ipie_hamiltonian": 7, "chol_cut": 7, "h1e": 7, "cholesky_vector": 7, "e0": 7, "num_basi": 7, "shape": [7, 11, 17, 20, 56], "num_chol": 7, "nelec": [7, 20], "afqmc_hamiltonian": 7, "reshap": [7, 11], "n_active_elec": 7, "num_dets_for_prop": 7, "compute_trial_energi": 7, "half_rot": 7, "timestep": 7, "num_walk": 7, "num_block": 7, "afqmc_msd": 7, "num_steps_per_block": 7, "005": 7, "stabilize_freq": 7, "96264512": 7, "pop_control_freq": 7, "estimator_filenam": 7, "h5": 7, "finalis": 7, "qmc_data": 7, "filenam": [7, 56], "weightfactor": 7, "hybridenergi": 7, "edenom": 7, "etot": 7, "e1bodi": 7, "e2bodi": 7, "0000000000000000e": 7, "02": [7, 65, 67], "2440857214519274e": 7, "04": [7, 65, 67], "2440857214519275e": 7, "7639365236571126e": 7, "5198508022051851e": 7, "2236163323978462e": 7, "4108003803708052e": 7, "1705550836048852e": 7, "2476129978632798e": 7, "9999999999999986e": 7, "2476129978632804e": 7, "7647651634374250e": 7, "5171521655741444e": 7, "0031021642240592e": 7, "8270298551287897e": 7, "1736348706942081e": 7, "2491539833590265e": 7, "0000000000000001e": 7, "2491539833590261e": 7, "7652287235836400e": 7, "5160747402246139e": 7, "9896411716010476e": 7, "0006803820092617e": 7, "1729991834244650e": 7, "2498086858011950e": 7, "2498086858011945e": 7, "7661217900078998e": 7, "5163131042067059e": 7, "0008819642734720e": 7, "0003952238189274e": 7, "1741988525943451e": 7, "2497768126542338e": 7, "2497768126542334e": 7, "7677859321228260e": 7, "5180091194685932e": 7, "9996395539611001e": 7, "0010162124437146e": 7, "1745900551679516e": 7, "2504859704025963e": 7, "0000000000000003e": 7, "2504859704025955e": 7, "7665382466690920e": 7, "5160522762664974e": 7, "0011117020963695e": 7, "0017267435124782e": 7, "1762740654751367e": 7, "2514761055266557e": 7, "2514761055266558e": 7, "7663824192346226e": 7, "5149063137079673e": 7, "9926957189505018e": 7, "9904869631265882e": 7, "1757145502349162e": 7, "2517665690169804e": 7, "7662872023157632e": 7, "5145206332987829e": 7, "9902183781120897e": 7, "9910184942535295e": 7, "1753639400107765e": 7, "2518490004346189e": 7, "2518490004346194e": 7, "7677944704924283e": 7, "5159454700578092e": 7, "0011182782239581e": 7, "0010647250586344e": 7, "1771801521929217e": 7, "2513893408438777e": 7, "2513893408438773e": 7, "7679469177919265e": 7, "5165575769480495e": 7, "9639946364053955e": 7, "9242085331654422e": 7, "1742082647888712e": 7, "2519016506034994e": 7, "2519016506034987e": 7, "7690149012513956e": 7, "5171132506478972e": 7, "vqe_i": 7, "vqe_x": 7, "afqmc_i": 7, "afqmc_x": 7, "0x7ab848ece110": 7, "gt": [7, 17, 18], "__version__": [7, 11, 14, 15, 17], "proto": 7, "57e1893b9a5b57ef1a1c2662bcf4527f87b9ef89": 7, "bloch": [8, 18], "intial": 8, "cost_valu": [8, 12], "expectation_valu": [8, 52], "initial_cost_valu": 8, "suit": [8, 17, 60, 67], "alogrithm": 8, "decreas": [8, 49], "x_valu": [8, 12], "y_valu": [8, 12], "epoch": [8, 11, 12, 19, 20], "longrightarrow": 9, "balanc": 9, "regardless": [9, 71], "ouput": 9, "question": 9, "answer": [9, 15], "solv": [9, 10, 14, 15, 46], "treat": [9, 42], "snippet": [9, 41, 42, 52, 61, 67], "box": [9, 13, 71], "don": [9, 15, 22, 24, 41, 74], "elif": 9, "That": [9, 24, 72], "twice": 9, "claim": 9, "evalul": 9, "advantag": [9, 17, 67], "symbol": [9, 65, 71], "OR": [9, 53], "oplus5": 9, "8_": 9, "oplus4": 9, "9_": 9, "quick": [9, 21, 40, 69], "suppos": [9, 68], "yield": [9, 59, 72], "u_f": 9, "align": [9, 15, 61, 71], "remark": [9, 17], "overlin": 9, "bar": [9, 14, 15, 16, 18], "denot": [9, 15, 28, 30], "prove": [9, 59], "shall": [9, 10, 59], "tfrac": [9, 59], "summari": 9, "unchang": [9, 13, 61], "simultan": [9, 41], "mechan": [9, 24, 26, 32, 36, 38, 42, 48, 59, 63], "exploit": [9, 43], "abil": [9, 17, 29, 50, 61], "psi_1": 9, "h_1h_0": 9, "psi_2": 9, "drop": 9, "further": [9, 31, 38, 45, 47, 61, 64, 72], "pm": 9, "fx": 9, "qubit_0": [9, 14], "quantiti": 10, "u_": [10, 17], "qquad": 10, "x_1x_2": 10, "simpl": [10, 13, 26, 29, 41, 42, 45, 47, 52, 53, 54, 57, 60, 61, 63, 67, 68, 72], "operatornam": 10, "im": 10, "functool": [10, 16], "psi_stat": 10, "phi_stat": 10, "ham_matrix": 10, "ev_numer": 10, "70710677": 10, "7071067690849304": 10, "ev": 10, "std_err": 10, "qc": [10, 40], "3f": 10, "705": 10, "007i": 10, "002": 10, "003i": 10, "ham_circuit": 10, "angle0": 10, "angle1": 10, "th": [10, 17, 32], "56322878": 10, "09176639": 10, "04025496": 10, "59986135": 10, "87024074": 10, "93078226": 10, "44015281": 10, "05675948": 10, "92402471": 10, "12981374": 10, "49704605": 10, "6020906": 10, "50280746": 10, "78988978": 10, "006956": 10, "7581442": 10, "00524035": 10, "10937881": 10, "13405202": 10, "33235091": 10, "7042075991630554": 10, "006743329111486673": 10, "36111390590667725": 10, "45839524269104004": 10, "7175908088684082": 10, "23948131501674652": 10, "765204668045044": 10, "865047037601471": 10, "9975475072860718": 10, "6179792881011963": 10, "highlight": [11, 22, 74], "pytorch": 11, "maximis": 11, "classif": 11, "mnist": 11, "dataset": 11, "classifi": [11, 17], "hand": [11, 41, 42, 43, 67, 71], "written": [11, 16, 18, 24, 59, 60, 65, 69], "digit": 11, "torch": [11, 17], "torchvis": 11, "autograd": 11, "nn": 11, "sklearn": 11, "model_select": 11, "train_test_split": 11, "manual_se": [11, 17], "44": [11, 16], "prepare_data": 11, "target_digit": 11, "sample_count": [11, 56], "test_siz": 11, "percentag": 11, "remaind": [11, 14], "train": [11, 17], "totensor": 11, "1307": 11, "3081": 11, "download": [11, 17, 18, 65, 67, 72], "filter": 11, "datapoint": 11, "subset_indic": 11, "randperm": 11, "unsqueez": 11, "relabel": 11, "x_train": 11, "x_test": 11, "y_train": 11, "y_test": 11, "shuffl": 11, "random_st": 11, "classification_threshold": 11, "boundari": 11, "parmet": 11, "shift": [11, 41, 67], "magnitud": [11, 17], "visualis": 11, "sample_to_plot": 11, "grid_img": 11, "make_grid": 11, "pad": 11, "imshow": 11, "permut": 11, "quantumfunct": 11, "finit": 11, "theta_v": 11, "excetut": 11, "live": 11, "tolist": 11, "exp_val": [11, 19, 20, 42, 52], "staticmethod": 11, "quantum_circuit": 11, "backward": [11, 30], "save_for_backward": 11, "grad_output": 11, "saved_tensor": 11, "thetas_plu": 11, "exp_vals_plu": 11, "thetas_minu": 11, "exp_vals_minu": 11, "mul": 11, "quantumlay": 11, "hybrid_qnn": 11, "fc1": 11, "fc2": 11, "dropout": 11, "fc3": 11, "fc4": 11, "fc5": 11, "feed": [11, 14], "view": [11, 29, 67, 73], "relu": 11, "fed": 11, "sigmoid": 11, "accuracy_scor": 11, "y_hat": 11, "hybrid_model": 11, "adadelta": 11, "lr": [11, 61], "weight_decai": 11, "loss_funct": 11, "bceloss": 11, "training_cost": 11, "testing_cost": 11, "training_accuraci": 11, "testing_accuraci": 11, "zero_grad": 11, "y_hat_train": 11, "train_cost": 11, "no_grad": 11, "y_hat_test": 11, "test_cost": 11, "figsiz": [11, 16, 17], "subplot": [11, 16], "tight_layout": 11, "latest": [11, 14, 15, 17, 22, 42, 65, 67, 74], "a726804916fd397408cbf595ce6fe5f33dcd8b4c": [11, 14, 15], "cliqu": 12, "qubit_num": [12, 20], "non_edg": 12, "6686": 12, "1453": 12, "num_lay": 12, "expens": 12, "6886": 12, "1091": 12, "0770": 12, "ham_cliqu": 12, "spin_ham": [12, 20], "wt": 12, "term_coeffici": 12, "term_word": 12, "dc_qaoa": 12, "iiziiz": 12, "ziizii": 12, "1657": 12, "iziiii": 12, "iziizi": 12, "42735": 12, "iiizii": 12, "2791499999999996": 12, "iiiiii": 12, "iiziii": 12, "iiiiiz": 12, "ziiiii": 12, "iiiizi": 12, "21810696323572243": [12, 14], "20613464375211488": [12, 14], "2546877639814583": [12, 14], "3657985647468064": [12, 14], "37118004688049144": 12, "03656087558321203": 12, "08564174998504231": 12, "21639801853794682": 12, "11122286088634259": 12, "1743727097033635": 12, "36518146001762486": 12, "15829741539542244": 12, "3467434780387345": 12, "28043500852894776": 12, "09986021299050934": 12, "14125225086023052": 12, "19141728018199775": 12, "11970943368650361": 12, "3853063093646483": 12, "1112643868789806": 12, "3527177454825464": 12, "22156160012057186": 12, "1418496891385843": 12, "32811766468303116": 12, "367642000671186": 12, "34158180583996006": 12, "10196745745501312": 12, "29359239180502594": 12, "3858537615546677": 12, "19366130907065582": 12, "24570488114056754": 12, "3332307385378807": 12, "12287973244618389": 12, "007274514934614895": 12, "015799547372526146": 12, "3578070967202224": 12, "39268963055535144": 12, "19872246354138554": 12, "16668715544467982": 12, "13777293592446055": 12, "17514665212709513": 12, "15350249947988204": 12, "32872977428061945": 12, "20068831419712105": 12, "032919322131134854": 12, "19399909325771983": 12, "09477141125241506": 12, "08210460401106645": 12, "21392577760158515": 12, "3393568044538389": 12, "14615087942938465": 12, "03790339186006314": 12, "2843250892879255": 12, "3151384847055956": 12, "19983741137121905": 12, "27348611567665115": 12, "33457528180906904": 12, "14145414847455462": 12, "20604220093940323": 12, "05410235084309195": 12, "04447870918600966": 12, "3355714098595045": 12, "266806440171265": 12, "07436189654442632": 12, "2789176729721685": 12, "2427508182662484": 12, "optimal_expect": [12, 14, 58], "0057970170760537": 12, "0617900450255213": 12, "008832997414504553": 12, "5446745231437978": 12, "9170743966952536": 12, "5684145055308018": 12, "45653992738579674": 12, "48765328828009236": 12, "08690545932812363": 12, "4396413285058074": 12, "18459993158979182": 12, "309747594917737": 12, "2588385005776594": 12, "834255663515425": 12, "674712608431175": 12, "40174553656823186": 12, "1936475123928361": 12, "11292461472367524": 12, "40520422214477836": 12, "5249647407525035": 12, "8276837818165452": 12, "2945660883282474": 12, "8060498989662159": 12, "08051672267342141": 12, "016438756265571293": 12, "5245041151262497": 12, "4087477995498743": 12, "24688680789607903": 12, "1121838066265077": 12, "1445970943333728": 12, "22281558391261153": 12, "29034932090910637": 12, "0492037973620043": 12, "2734013684834806": 12, "5265417924961102": 12, "5099056677967553": 12, "8636684922225737": 12, "6164906874232119": 12, "42851259141848624": 12, "09675272347583658": 12, "05697275350531247": 12, "7102412317670379": 12, "11174687408874051": 12, "32505750242276577": 12, "4397450017834574": 12, "023604090020531092": 12, "072436348972407": 12, "38357054930488194": 12, "13613334013073858": 12, "10505045798768743": 12, "0359359294549595": 12, "24377425227508304": 12, "10609870738840588": 12, "2073332743736556": 12, "07232539343493427": 12, "6190529241716675": 12, "03799182564866846": 12, "17548654124993912": 12, "5257077568577536": 12, "23376653076971432": 12, "3391308272563698": 12, "4193139961661264": 12, "02390444901420668": 12, "2521154835623746": 12, "1843328649807838": 12, "6609672889772077": 12, "2612231428844001": 12, "200000": 12, "mvwcp": 12, "altern": [12, 14, 40, 50, 53, 55, 58, 60, 65, 67, 72], "111000": 12, "character": [13, 16], "coher": [13, 28], "incoher": 13, "aris": [13, 17], "commonli": [13, 17, 65, 67], "systemat": 13, "miscalibr": 13, "epsilon": 13, "entangl": [13, 18, 29, 41, 45, 53, 60], "lead": [13, 14], "emploi": [13, 17], "formal": 13, "k_i": 13, "mathbb": [13, 14, 59], "pmatrix": 13, "ideal": [13, 41, 53], "noiseless": 13, "ideal_count": 13, "error_prob": 13, "kraus_0": [13, 57], "complex128": [13, 17, 57], "kraus_1": [13, 57], "bitflip_channel": 13, "0th": 13, "bitflip": [13, 16], "longer": [13, 50, 65], "uniformli": 13, "noisy_count": [13, 57], "850": 13, "88": 13, "56": 13, "noisy_result": [13, 57], "8666666666666666": 13, "farhi": 14, "dive": [14, 18, 67], "maxim": [14, 41, 43, 45, 53, 56], "although": [14, 59], "rel": [14, 43], "vertic": 14, "hard": 14, "statist": [14, 24, 27, 47, 59], "furthermor": [14, 22, 74], "wider": [14, 42], "portfolio": 14, "shop": 14, "schedul": [14, 17, 47], "vertex": 14, "subseteq": 14, "interchang": [14, 43], "undirect": 14, "v_1": 14, "exactli": [14, 17], "bigcup": 14, "bigcap": 14, "emptyset": 14, "illustr": [14, 17, 24, 40, 42, 51, 53, 54, 57, 58], "disjoint": 14, "grai": 14, "distinct": [14, 17, 18, 38], "substack": 14, "sometim": 14, "v1": [14, 40, 58], "v2": [14, 58], "v0": [14, 58], "v3": [14, 58, 65, 67], "v4": [14, 67], "edges_src": 14, "edges_tgt": 14, "algortihm": 14, "hamilitonian": 14, "distinguish": [14, 38], "mixer": [14, 58], "deeper": [14, 18], "layer_count": [14, 58], "qaoaproblem": 14, "alpha": [14, 59], "subcircuit": [14, 46], "kernel_qaoa": [14, 58], "restrict": [14, 17, 42], "plaehold": 14, "qubitu": 14, "qubitv": 14, "mention": [14, 17], "earlier": [14, 17, 47], "z_v": 14, "vale": 14, "arbirtrari": 14, "formula": 14, "z_uz_v": 14, "minimum": [14, 19, 41], "refram": 14, "promot": [14, 21, 72], "reformul": 14, "hamiltonian_max_cut": 14, "inititi": 14, "comment": [14, 49], "iiziz": 14, "izzii": 14, "iiiii": 14, "zziii": 14, "iiizz": 14, "iizzi": 14, "ziizi": 14, "495973826282007": 14, "51349181993727": 14, "21299416361632417": 14, "3250526425808945": 14, "886630847343767": 14, "max_cut": 14, "148": 14, "54": [14, 16, 18], "165": 14, "154": 14, "144": [14, 16], "40": [14, 16, 17, 19, 56], "aid": [15, 23], "area": [15, 42], "signal": [15, 29], "compress": 15, "qft": 15, "ingredi": 15, "shor": [15, 21], "exponenti": [15, 16, 32, 56], "factor": [15, 16, 21], "plai": 15, "vital": 15, "role": 15, "frequenc": 15, "domain": 15, "easier": [15, 24, 61, 64], "analogi": 15, "ixi": 15, "5i": 15, "0i": 15, "25i": 15, "35i": 15, "r_k": 15, "bmatrix": [15, 16, 59], "ciruit": 15, "zeroth": 15, "decim": 15, "round": [15, 17, 27, 60], "25j": 15, "35j": 15, "seri": [15, 40, 53], "henc": [15, 38, 42, 47, 56, 59, 65, 67, 71], "fast": [15, 17, 29, 43, 46], "n2": 15, "why": 15, "life": [15, 41], "invert": [15, 17], "quantum_fourier_transform2": 15, "attent": 15, "definit": [15, 17, 24, 26, 28, 57, 64], "unitari": [15, 19, 21, 27, 31, 38, 55, 58, 59], "verification_exampl": 15, "caus": 16, "imperfect": 16, "properli": [16, 47, 65, 71], "tell": [16, 59], "independ": [16, 24, 29, 42, 43, 65], "pseudoinvers": 16, "noisi": [16, 17, 21, 51], "p_": 16, "adjust": [16, 43, 65, 71], "quasi": 16, "correl": 16, "affect": [16, 43, 57, 64], "impract": 16, "seaborn": 16, "sn": 16, "itertool": 16, "union": 16, "set_styl": 16, "dark": 16, "prob": 16, "principl": 16, "yet": [16, 22, 42, 67, 74], "get_nois": 16, "isinst": 16, "bit_flip": [16, 57], "state_label": 16, "ghz": [16, 41, 42, 45, 47, 50, 53, 54, 56, 61, 68], "ghz_kernel": 16, "plot_cmat": 16, "mat": 16, "fig": 16, "im2": 16, "matshow": 16, "cmap": 16, "cm": 16, "vmin": 16, "vmax": 16, "set_ytick": 16, "arang": 16, "set_xtick": 16, "set_yticklabel": 16, "set_xticklabel": 16, "set_titl": 16, "fontsiz": [16, 17], "set_xlabel": 16, "xaxi": 16, "set_label_posit": 16, "set_ylabel": 16, "colorbar": 16, "closest": 16, "min_": 16, "rm": [16, 65, 67], "find_closest_distribut": 16, "empirical_dist": 16, "empir": 16, "l1": 16, "ord": 16, "con": 16, "ineq": 16, "fun": [16, 20], "eq": [16, 61], "bnd": 16, "initial_valu": 16, "slsqp": 16, "get_counts_from_distribut": 16, "return_count": 16, "1024": [16, 50], "noise_1": 16, "ghz_result": 16, "noisy_dict_1": 16, "noisy_res_1": 16, "352": 16, "43": 16, "367": 16, "low": [16, 31, 56], "noise_2": 16, "noisy_dict_2": 16, "noisy_res_2": 16, "149816047538945": 16, "3802857225639665": 16, "292797576724562": 16, "212": 16, "122": 16, "189": 16, "87": 16, "78": 16, "94": 16, "otim": 16, "single_qubit_label": 16, "single_qubit_st": 16, "924": 16, "104": 16, "920": 16, "true_stat": 16, "observed_st": 16, "90234375": 16, "1015625": 16, "09765625": 16, "8984375": 16, "joint": [16, 53], "a_pinv": 16, "pinv": 16, "positive_dist": 16, "ncorrect": [16, 27], "neg": [16, 18, 31, 43], "476": 16, "501": [16, 24], "mitigated_sg": 16, "kind": [16, 47], "bar_label": 16, "assumpt": 16, "special": [16, 28, 33, 61, 69], "a_n": 16, "local_label": 16, "local_st": 16, "388": 16, "235": 16, "174": 16, "58": 16, "370": 16, "60": [16, 67], "107": 16, "162": 16, "marginalized_count": 16, "total_shot": 16, "marginal_ct": 16, "85546875": 16, "15722656": 16, "14453125": 16, "84277344": 16, "6328125": 16, "38476562": 16, "3671875": 16, "61523438": 16, "70800781": 16, "32226562": 16, "29199219": 16, "67773438": 16, "pinv_confusion_matric": 16, "a_joint": 16, "559": 16, "510": [16, 56], "521": 16, "446": 16, "mitigated_k_loc": 16, "248": 16, "83": 16, "68": 16, "93": 16, "46": 16, "363": 16, "253": 16, "76": 16, "378": 16, "150": [16, 59], "36": [16, 17, 56, 60], "74": 16, "106": 16, "145": 16, "251": 16, "386": 16, "99": 16, "229": 16, "247": 16, "70": 16, "163": 16, "371": 16, "95": 16, "233": 16, "85": [16, 56], "396": 16, "31": [16, 17, 41, 56], "393": 16, "a_ful": 16, "24": [16, 17, 18, 64, 68], "09734490298929": 16, "714": 16, "211": 16, "152": 16, "49": 16, "63": 16, "422": 16, "683": 16, "302": 16, "mitigated_ful": 16, "notebook": [17, 18], "florian": 17, "f\u00fcrrutter": 17, "gorka": 17, "mu\u00f1oz": 17, "gil": 17, "han": 17, "briegel": 17, "nat": 17, "mach": 17, "intel": [17, 72], "515": 17, "524": 17, "2024": [17, 41], "viabl": 17, "power": [17, 18, 22, 41, 43, 56, 74], "synthes": [17, 31, 35, 61], "effect": [17, 38, 43, 47, 56, 57, 59, 72], "dm": [17, 41], "deliv": [17, 41], "protein": 17, "fold": 17, "prompt": [17, 67], "thoroughli": 17, "ref": [17, 38, 61], "overview": 17, "neural": [17, 21], "network": [17, 21, 22, 40, 41, 42, 50, 53, 64, 67, 74], "discret": [17, 36], "dimension": [17, 18, 36], "crucial": 17, "de": 17, "recommend": [17, 18, 24, 65, 67, 72], "genqc": 17, "root": [17, 18, 65, 67], "broken": [17, 18], "permiss": [17, 18, 65, 67], "conflict": [17, 18, 65], "pypa": [17, 18], "io": [17, 18, 67], "venv": [17, 18], "diffusion_pipelin": 17, "diffusionpipelin": 17, "infer": [17, 59], "export_cudaq": 17, "genqc_to_cudaq": 17, "infer_compil": 17, "infer_comp": 17, "fix": [17, 19, 22, 43, 74], "reproduc": 17, "infer_torch_devic": 17, "memoryclean": 17, "purge_mem": 17, "tf32": 17, "matmul": 17, "from_pretrain": 17, "floki00": 17, "qc_unitary_3qubit": 17, "hug": 17, "set_timestep": 17, "unet_qc": 17, "qc_compilation_unet": 17, "instanti": [17, 18, 24, 29, 35, 36, 41, 42, 58, 71], "frozen_open_clip": 17, "cachedfrozenopenclipembedd": 17, "save_path": 17, "vocab": 17, "gate_pool": 17, "gateset": 17, "decod": 17, "num_of_qubit": 17, "max_gat": 17, "infinit": [17, 29, 36, 47], "nonetheless": 17, "stai": 17, "tune": [17, 43, 60], "bigger": 17, "70710678": 17, "inde": [17, 65], "allclos": 17, "ccx": 17, "scenario": [17, 22, 55, 67, 74], "miss": [17, 38, 43, 65], "veri": [17, 42, 54, 63, 71], "u_r": 17, "u_i": 17, "u_tensor": 17, "stack": [17, 28], "out_tensor": 17, "generate_comp_tensor": 17, "system_s": 17, "guidanc": [17, 67], "cfg": [17, 61], "33": [17, 42, 67], "kernel_list": 17, "valid_tensor": 17, "invalid_tensor": 17, "out_tensors_i": 17, "catch": [17, 71], "invalid": [17, 43], "37": [17, 42], "rapidli": 17, "successfulli": [17, 18, 57], "transit": 17, "langl": [17, 24], "got_unitari": 17, "basis_state_j": 17, "set_printopt": 17, "linewidth": 17, "7071": 17, "infidel": 17, "ones": [17, 24], "want_unitari": 17, "histogram": 17, "hist": 17, "almost": [17, 65], "close": [17, 47, 53], "min_index": 17, "4e": 17, "09": 17, "valuabl": 17, "deal": [17, 36], "avoid": [17, 57, 65, 71, 72], "fewest": 17, "toffoli": [17, 35, 43], "token": [17, 40, 67], "duplic": 17, "pick": [17, 60, 64, 65], "idx_uniqu": 17, "return_index": 17, "unique_tensor": 17, "unique_infidel": 17, "unique_kernel": 17, "idx_correct": 17, "argwher": 17, "correct_tensor": 17, "num_ccx": 17, "appear": [17, 24, 67], "studi": 17, "correct_kernel": 17, "correct_kernels_ccx1": 17, "a1ee37087fbd5c14a31d5de3441f92432d0dca68": 17, "cue": 18, "sens": [18, 61], "2d": 18, "plane": 18, "3d": 18, "varphi": 18, "minu": 18, "direct": [18, 61, 71], "spheric": 18, "coordin": 18, "sphere": 18, "showcas": 18, "render": 18, "qutip": 18, "sure": [18, 42, 65, 67, 69, 72], "restart": 18, "jupyt": [18, 67], "menu": 18, "vscode": [18, 67], "click": [18, 67], "button": 18, "toolbar": 18, "misunderstand": 18, "qualifi": 18, "bash": [18, 41, 65, 67, 72], "pipe": [18, 61], "sy": [18, 47, 72], "importerror": 18, "nnew": 18, "cp310": 18, "manylinux_2_17_x86_64": 18, "manylinux2014_x86_64": 18, "whl": [18, 65], "mb": 18, "eta": 18, "usr": [18, 61, 65, 67, 71], "lib": [18, 61, 63, 64, 65, 67, 68, 71, 72], "contourpi": 18, "dateutil": 18, "post0": 18, "fonttool": 18, "cycler": 18, "pypars": 18, "kiwisolv": 18, "pillow": 18, "six": 18, "subsequ": [18, 24, 29, 32, 34, 65, 67], "cell": 18, "add_to_bloch_spher": 18, "rng": 18, "default_rng": [18, 56], "blochspherelist": 18, "anglelist": 18, "sph": 18, "displai": [18, 23], "side": [18, 38, 67], "accordingli": [18, 43, 71], "absolut": [18, 36, 61], "had": 18, "toolbox": 18, "blochspher": 18, "unfortun": 18, "handi": 18, "kernel_to_draw": 18, "14159": 18, "tdg": [18, 31], "142": 18, "documentclass": 18, "usepackag": 18, "quantikz": 18, "lstick": 18, "q_0": 18, "amp": 18, "r_1": 18, "qw": 18, "q_1": 18, "targx": 18, "q_2": 18, "q_3": 18, "editor": 18, "export": [18, 40, 41, 42, 64, 65, 72], "molecular": [19, 21], "preprocess": 19, "uccsd": 19, "chain": [19, 38], "hydrogen": [19, 60], "seper": 19, "along": [19, 24, 40, 41, 43, 47, 71], "bond": 19, "interatom": 19, "electrostat": 19, "forc": [19, 42, 71], "proton": 19, "shield": 19, "neutron": 19, "chemic": 19, "minimis": 19, "stabl": [19, 67], "hydrogen_count": 19, "angstrom": 19, "bond_dist": 19, "coupl": [19, 29, 43, 53, 67], "cluster": [19, 21, 42, 43], "uccsd_num_paramet": [19, 20], "builtin": [19, 61], "1371744305855906": 19, "popular": [19, 67], "xk": [19, 20], "x0": [19, 20, 24], "1173": 20, "4691": 20, "7570": 20, "mol": 20, "charg": 20, "631g": 20, "myhf": 20, "rhf": 20, "max_cycl": 20, "nelectron": 20, "norb": 20, "mo_coeff": 20, "norb_ca": 20, "nele_ca": 20, "mycasci": 20, "ncore": 20, "occupi": [20, 42], "frozen": 20, "mycc": 20, "e_tot": 20, "9839755372789": 20, "98508980454675": 20, "e_corr": 20, "001114267267875617": 20, "get_fermion_oper": 20, "timeit": [20, 47, 56], "run_pyscf": 20, "moleculardata": 20, "molecular_hamiltonian": 20, "get_molecular_hamiltonian": 20, "occupied_indic": 20, "active_indic": 20, "fermion_hamiltonian": 20, "qubit_hamiltonian": 20, "electron_num": 20, "start_tim": 20, "default_tim": 20, "300": 20, "end_tim": 20, "elaps": 20, "tmp": [20, 65], "ipykernel_23147": 20, "4290935201": 20, "complexwarn": 20, "discard": [20, 24], "98415928173183": 20, "105": 20, "929891359000067": 20, "welcom": [21, 41, 54, 67], "page": [21, 47, 52, 54, 65, 67, 72], "scalabl": [21, 41, 72], "offer": [21, 41, 72], "unifi": [21, 39, 72], "brows": 21, "amd64": [21, 22, 74], "2241": 21, "releas": [21, 39, 42, 43, 61, 67, 72, 74], "toolchain": [21, 37, 40, 47, 61, 67, 68, 69, 70, 72], "heterogen": [21, 23, 46, 65], "troubleshoot": [21, 44], "bernstein": [21, 51, 67], "vazirani": [21, 51, 67], "cuquantum": [21, 43, 51, 56, 64, 65], "auxiliari": 21, "mont": 21, "carlo": 21, "deutsch": 21, "fourier": [21, 27], "qaoa": [21, 58], "dock": 21, "dc": 21, "readout": 21, "mitig": 21, "divis": 21, "With": [21, 22, 42, 47, 57, 61, 68, 74], "coreset": 21, "krylov": 21, "diffus": 21, "cloud": [21, 22, 39, 40, 53, 74], "processor": [21, 22, 24, 29, 39, 47, 67, 71, 72, 74], "center": [21, 66, 67], "downstream": [21, 64, 68, 70], "cmake": [21, 63, 64, 70], "repositori": [22, 63, 64, 65, 67, 74], "docker": [22, 65, 72, 74], "nightli": [22, 67, 74], "eas": [22, 74], "think": [22, 42, 59, 74], "great": [22, 74], "thank": [22, 43, 74], "extern": [22, 43, 61, 63, 65, 71, 74], "contributor": [22, 74], "wheel": [22, 42, 43, 65, 74], "fusion": [22, 43, 74], "cudaq_mgpu_fus": [22, 43, 74], "bug": [22, 74], "greatli": [22, 74], "increas": [22, 43, 47, 56, 67, 72, 74], "frontend": [22, 74], "blog": [22, 74], "setup": [22, 43, 53, 67, 74], "ve": [22, 54, 69, 74], "workload": [22, 42, 67, 74], "gnu": [22, 61, 65, 67, 71, 74], "guid": [22, 40, 65, 67, 69, 72, 74], "older": [22, 65, 67, 74], "glibc": [22, 65, 67, 74], "oqc": [22, 39, 74], "iqm": [22, 39, 74], "publish": [22, 67, 74], "experiment": [22, 67, 74], "arm": [22, 65, 67, 72, 74], "aarch64": [22, 72, 74], "pypi": [22, 65, 72, 74], "quantinuum": [22, 39, 74], "ionq": [22, 39, 74], "linux": [22, 61, 65, 67, 74], "concept": [23, 24, 28, 30], "bind": [23, 26, 28, 31, 65], "coprocess": 23, "annot": [23, 28, 45, 54], "aspect": [23, 24, 43, 71], "core": [23, 24, 43, 56, 61], "higher": 23, "namespac": [23, 24, 26, 27, 28, 31, 32, 34, 36, 37, 41, 42, 47, 52, 58, 63, 64, 69, 71], "philosophi": 24, "stand": 24, "alon": 24, "adaptor": 24, "returntyp": 24, "hasvoidreturntyp": 24, "is_void_v": 24, "sample_opt": 24, "bel": 24, "lu": [24, 27, 36, 50, 54, 55], "sequential_data": 24, "reg1": 24, "499": 24, "alwai": [24, 43, 67], "middl": 24, "implicitli": [24, 29, 38], "difficult": 24, "discern": 24, "silent": 24, "ancillari": [24, 49], "varieti": [24, 47], "enforc": 24, "sample_async_result": 24, "async_sample_result": [24, 42], "\ud835\udeb9": 24, "observe_opt": 24, "retain": [24, 30], "measurecount": 24, "spinop": 24, "x0x1exp": 24, "x0x1data": 24, "qarrai": [24, 27, 28, 35, 54, 61], "907": [24, 27, 32, 41, 42, 52, 60], "1433": [24, 27, 32, 41, 42, 52, 60], "21829": [24, 27, 32, 41, 42, 52, 60], "lf": [24, 27, 42, 52], "analyt": 24, "async_observe_result": 24, "broader": [24, 42], "extrem": 24, "dictat": 24, "safe": 24, "moreov": [24, 29, 42, 46, 64], "providesgradi": 24, "_providesgradi": 24, "someth": [24, 36, 65, 67, 71], "max_ev": [24, 60], "opt_energi": 24, "grad_vec": 24, "\ud835\udeb9_i": 24, "variad": 24, "address": [24, 42, 65], "overal": [24, 61, 64], "deuteron_n3_ansatz": 24, "x1": 24, "vctrl": 24, "h3": 24, "625": 24, "913119": 24, "make_tupl": 24, "bfg": 24, "min_val": 24, "permit": 25, "facilit": [26, 67], "privat": [26, 36], "thenfunctor": 26, "predefin": 26, "otherkernelbuild": 26, "kerneltocal": 26, "kerneltocontrol": 26, "kerneltoadjoint": 26, "argsarrai": 26, "decltyp": 26, "tuple_s": 26, "integral_const": 26, "sizeof": [26, 69], "tuple_el": 26, "conditional_t": [26, 36], "factori": 26, "xprep": 26, "qubitin": 26, "hadamardtest": 26, "num_it": 27, "c_str": [27, 71], "phase_estim": 27, "cpp": [27, 40, 41, 42, 43, 47, 50, 52, 53, 54, 55, 57, 60, 61, 63, 64, 65, 67, 68, 69, 71, 72], "qpe": 27, "stdio": [27, 65], "cmath": 27, "iqft": 27, "denom": 27, "1ul": 27, "eigenst": 27, "stateprep": [27, 28], "ncountingqubit": 27, "state_prep": 27, "oracl": [27, 49], "counting_qubit": 27, "state_regist": 27, "put": [27, 36, 57, 59], "r1pigat": 27, "mostprob": 27, "to_integ": 27, "piestim": 27, "tgate": 27, "xgate": [27, 57], "nc": 27, "nq": 27, "countingqubit": 27, "stateregist": 27, "deuteron_n2_ansatz": 27, "param_spac": 27, "linspac": [27, 53], "energy_at_param": 27, "energyatparam": 27, "reflect_about_uniform": 27, "ctrlqubit": 27, "lastqubit": 27, "compute_act": [27, 33], "run_grov": 27, "callablekernel": 27, "n_iter": 27, "target_st": 27, "target_bit_set": 27, "secret": [27, 67], "strtol": 27, "null": [27, 67], "0b1011": 27, "compute_oracl": 27, "reflect": [27, 43], "iterative_qp": 27, "iqp": 27, "cr0": 27, "cr2": 27, "m_pi_4": 27, "differenti": 28, "former": 28, "latter": [28, 61], "my_first_entry_point_kernel": 28, "my_second_entry_point_kernel": 28, "my_first_pure_device_kernel": 28, "parent": 28, "boolexprfromqubitmeasur": 28, "another_qubit": 28, "uncomput": [28, 29], "is_arithmetic_v": 28, "span": [28, 36], "recurs": 28, "mycustomsimplestruct": 28, "recursivevec": 28, "var": [28, 72], "kernelthatreturn": 28, "mysimplestruct": 28, "recursivelist": 28, "fill": [28, 53, 64], "1415926": 28, "kernellambda": 28, "synchron": [28, 42, 53], "mystateprep": 28, "prep": 28, "mygenericalgorithm": 28, "placehold": 28, "mygenericalgorithm2": 28, "callkernel": 28, "anothervers": 28, "constrain": [28, 55], "is_convertible_v": 28, "takes_qubit": [28, 55], "mygenericalgorithmonqarrai": 28, "mygenericalgorithmonqubit": 28, "presum": 29, "graphic": 29, "fpga": 29, "concurr": [29, 41], "messag": [29, 41, 65, 67], "inter": [29, 43], "fabric": [29, 60], "hidden": [29, 49], "novel": 29, "placement": 29, "copyabl": [29, 36], "flavor": 29, "tightli": 29, "modal": 29, "influenc": 29, "sfina": 30, "foundat": 31, "inst_nam": 31, "header": [31, 65, 67, 69, 71], "qubitarg": 31, "qr": [31, 43], "scalarangl": 31, "rotation_nam": 31, "measure_op": 31, "convei": 31, "offici": [31, 65, 67], "p_i": 32, "prod_": 32, "sigma_j": 32, "trotter": 32, "intent": 33, "u_cod": 33, "v_code": 33, "computef": 33, "actionf": 33, "computel": 33, "segment": [33, 72], "effort": 34, "get_platform": [34, 42, 52], "quantumregist": 35, "x_gate": 35, "ctrl_bit": 35, "rx_and_h_gat": 35, "kerneltestcontrol": 35, "kerneltestadjoint": 35, "aggreg": 35, "qubit0": [35, 43], "qubit1": [35, 43], "kernel_arg": 35, "fundament": [36, 59, 67, 72], "hilbert": 36, "theorem": 36, "movabl": 36, "never": 36, "n_level": 36, "adl": 36, "familiar": 36, "inner": [36, 42, 49], "stride": 36, "first_5": 36, "qb": 36, "knowledg": 36, "ahead": 36, "storag": [36, 59], "fivecompiletimequbit": 36, "formul": 38, "short": 38, "particl": 38, "conceptu": 38, "sai": 38, "embodi": 38, "behind": 38, "dataflow": 38, "contrast": 38, "consum": [38, 71], "truli": 38, "ssa": 38, "clarifi": 38, "toi": 38, "foo": 38, "boilerpl": [38, 64], "c0": 38, "c1": 38, "extract_ref": [38, 61], "bunch": 38, "decid": 38, "i1": [38, 61], "imagin": 38, "adjac": [38, 40], "awai": 38, "Such": [38, 47], "Of": 38, "cours": 38, "correctli": [38, 65, 69, 71], "quit": [38, 47], "prone": 38, "analys": 38, "q0_1": 38, "q0_0": 38, "wire": 38, "q0_z": 38, "elimin": [38, 42], "r0": 38, "qref": 38, "unwrap": 38, "misc": 38, "q0_m": 38, "q0_l": 38, "q1_x": 38, "q0_p": 38, "q0_y": 38, "straightforwardli": 38, "cancel": [38, 57, 67, 72], "mmeori": 38, "comprehens": [39, 40], "stim": [39, 43], "tensornet": [39, 41, 42, 43], "mp": [39, 41, 43], "ionq_api_kei": 40, "ionq_generated_api_kei": 40, "authent": [40, 42, 67], "aria": [40, 53], "login": [40, 67], "emit": [40, 61], "diagnost": 40, "inject": [40, 53, 61, 67], "cortex": 40, "cli": [40, 67], "cach": 40, "iqm_tokens_fil": 40, "mandatori": 40, "match": [40, 65, 67, 71], "coco": [40, 53], "adoni": [40, 53], "iqm_server_url": 40, "demo": 40, "fi": [40, 65], "apollo": 40, "url": [40, 42, 53, 65, 67], "oxford": 40, "ring": 40, "topologi": 40, "luci": 40, "kagom": 40, "lattic": 40, "toshiko": 40, "registr": [40, 63, 64], "contact": [40, 53], "oqc_qcaas_support": [40, 53], "oxfordquantumcircuit": [40, 53], "email": [40, 41], "password": [40, 67], "oqc_url": [40, 53], "oqc_email": [40, 53], "oqc_password": [40, 53], "suppli": 40, "qcaa": 40, "servic": [40, 41, 42, 53, 67], "assembli": 40, "qat": 40, "pt": [40, 53, 67], "photon": [40, 53, 59], "interf": [40, 53], "beam": [40, 53], "splitter": [40, 53], "detector": [40, 53], "delai": [40, 53], "sent": [40, 42, 53], "orca_access_url": [40, 53], "orca_url": [40, 53], "getenv": [40, 53], "localhost": [40, 42, 53, 67], "apt": [40, 67], "curl": [40, 65], "jq": 40, "your_alia": 40, "your_password": 40, "qapi": 40, "home": [40, 41, 67], "id_token": 40, "cat": [40, 67], "refresh_token": 40, "refresh": 40, "echo": [40, 41, 65, 67, 71], "quantinuum_config": 40, "cudaq_quantinuum_credenti": 40, "checker": [40, 53], "mere": [40, 65], "2e": [40, 53], "sc": 40, "1sc": 40, "navig": [40, 67], "tab": [40, 67], "tabl": [40, 41, 42, 64, 67], "world": [41, 46, 54], "visit": [41, 47], "link": [41, 61, 65, 67, 68, 69, 71], "approv": 41, "nvqc_api_kei": 41, "session": [41, 42, 67], "bashrc": [41, 67], "rather": [41, 43, 47, 59, 71], "438": 41, "3600": 41, "h100": 41, "80gb": 41, "hbm3": 41, "driver": [41, 65, 67], "gb": [41, 43, 56], "clock": 41, "rate": 41, "mhz": 41, "2619": 41, "1980": 41, "1111111111111111111111111": [41, 56], "486": 41, "0000000000000000000000000": [41, 56], "514": 41, "nvqc_intro": 41, "545": 41, "487": 41, "513": 41, "nvqc_sampl": 41, "grow": [41, 64], "ngpu": 41, "unabl": [41, 67], "deploy": 41, "ye": [41, 67], "cutensornet": [41, 43], "contract": [41, 43], "wherebi": [41, 42, 43], "worker": 41, "nqpu": 41, "opt_gradi": 41, "submiss": [41, 48, 53], "energy_futur": 41, "plus_futur": 41, "minus_futur": 41, "optimal_valu": 41, "grad": 41, "paramshift": 41, "74886": 41, "nvqc_vqe": 41, "incom": [41, 55], "attain": 41, "speedup": [41, 56], "On": [41, 42, 43, 50, 54, 67, 72], "busi": 41, "substanti": 41, "my": [41, 64, 67], "nvqc_log_level": 41, "disabl": [41, 43, 65], "credenti": [41, 53], "lieu": 41, "api_kei": 41, "nvqc_config": 41, "elucid": 42, "unlik": [42, 47], "opportun": 42, "qpu_count": 42, "count_futur": 42, "kerneltobesampl": 42, "runtimeparam": 42, "singleton": [42, 52], "zu": [42, 52], "countfutur": 42, "emplace_back": 42, "four": [42, 52, 59], "gpuemulatedqpu": 42, "cudaq_mqpu_ngpu": 42, "bellow": 42, "state_futur": 42, "kerneltorun": 42, "async_state_result": 42, "statefutur": 42, "suffici": [42, 65, 67, 72], "mpiexec": [42, 43, 65], "script": [42, 47, 65, 67], "srun": 42, "controls_count": 42, "auto_launch": 42, "isdigit": 42, "nrcontrol": 42, "tidx": 42, "background": 42, "daemon": 42, "qpud": 42, "shut": 42, "cudaq_loc": 42, "grep": [42, 65], "qpud_pi": 42, "cuda_visible_devic": [42, 43], "tcp": [42, 67], "ip": 42, "ld_library_path": [42, 65, 72], "launcher": 42, "app": 42, "firewal": 42, "secur": [42, 67], "port1": 42, "port2": 42, "port3": 42, "port4": 42, "per": [42, 43, 56, 60], "resolv": 42, "contigu": 42, "byte": [42, 56, 71], "memcpi": 42, "ixiz": 42, "charact": 42, "incur": 42, "overhead": 42, "0000": 42, "1111": 42, "demand": 42, "defer": 42, "rtti": 42, "standalon": [42, 64], "accommod": 43, "switch": [43, 56], "cudaq_fusion_max_qubit": 43, "cudaq_fusion_diagonal_gate_max_qubit": 43, "cudaq_fusion_num_host_thread": 43, "cudaq_max_cpu_memory_gb": 43, "migrat": [43, 65], "unlimit": 43, "cudaq_max_gpu_memory_gb": 43, "exce": 43, "cudaq_mgpu_lib_mpi": 43, "libmpi": [43, 67], "cudaq_mgpu_comm_plugin_typ": 43, "openmpi": [43, 65, 67, 72], "mpich": [43, 65], "commplugin": 43, "cudaq_mgpu_nqubits_thresh": 43, "cudaq_mgpu_p2p_device_bit": 43, "gpudirect": 43, "p2p": 43, "cudaq_gpu_fabr": 43, "mnnvl": 43, "nvl": 43, "nvlink": 43, "cudaq_global_index_bit": 43, "comma": 43, "slower": 43, "cudaq_host_device_migration_level": 43, "fuse": 43, "4x4": 43, "bandwidth": 43, "significantli": 43, "suitabl": [43, 65, 67, 71], "despit": [43, 53], "poor": 43, "visibl": [43, 67], "cutensornet_comm_lib": 43, "newli": [43, 67], "libcutensornet_distributed_interface_mpi": 43, "dedic": 43, "dgx": 43, "omp_plac": 43, "omp_num_thread": 43, "number_of_cores_per_nod": 43, "number_of_gpus_per_nod": 43, "wave": 43, "sparsiti": 43, "svd": 43, "singular": [43, 65], "truncat": 43, "tractabl": 43, "footprint": 43, "cudaq_mps_max_bond": 43, "cudaq_mps_abs_cutoff": 43, "cutoff": 43, "largest": 43, "trim": 43, "cudaq_mps_relative_cutoff": 43, "cudaq_mps_svd_algo": 43, "gesvd": 43, "gesvdj": 43, "jacobi": 43, "gesvdp": 43, "gesvdr": 43, "medium": 43, "overridden": [43, 64], "cudaq_default_simul": [43, 50], "debug": [44, 61, 65, 67], "amongst": 45, "subroutin": 46, "closer": [46, 54, 61], "collaps": [47, 59, 64], "roughli": [47, 56, 57, 59], "505": 47, "495": 47, "result_0": 47, "5005": 47, "4995": 47, "result_1": 47, "subtl": 47, "rebuilt": 47, "most_probable_result": 47, "intens": 47, "respons": 47, "event": [47, 65], "kernel2": 47, "num_gpu": [47, 56], "result_2": 47, "confirm": [47, 53, 57, 65, 67, 72], "determinist": 47, "025": 47, "million": 47, "35x": 47, "code_to_tim": 47, "1000000": 47, "57462": 47, "stmt": 47, "773286": 47, "isol": 47, "atoi": [47, 72], "chrono": 47, "high_resolution_clock": 47, "durat": 47, "took": 47, "8337": 47, "18988": 47, "cudaq_log_level": 48, "prepend": 48, "cudaq_dump_jit_ir": 48, "output_filenam": 48, "highest": 49, "random_bit": 49, "bitset": 49, "randint": 49, "un": 49, "verif": 49, "hidden_bit": 49, "auxillary_qubit": 49, "bernstein_vazirani": [49, 67], "success": [49, 63], "random_bitstr": 49, "vector_of_bit": 49, "hidden_bitstr": 49, "recov": 49, "cuquantum_backend": 50, "hang": [50, 67, 72], "observe_mqpu": 52, "redefin": 53, "flight": 53, "async_count": 53, "txt": [53, 63, 64, 67, 68], "same_fil": 53, "retrieved_async_result": 53, "mimic": 53, "dashboard": 53, "fstream": 53, "meantim": [53, 67], "ofstream": 53, "savem": 53, "readin": 53, "ifstream": 53, "proceed": [53, 65], "qb1": 53, "qb2": 53, "qb3": 53, "qb4": 53, "qb5": 53, "adonis_ghz": 53, "transpar": 53, "worri": 53, "schemat": 53, "optic": 53, "reconfigur": 53, "shifter": 53, "enter": [53, 67], "indistinguish": 53, "vacuum": 53, "interfer": [53, 57, 65, 67], "exit": [53, 56, 67], "half": 53, "n_beam_splitt": 53, "helper": [53, 60], "linear_spaced_vector": 53, "static_cast": [53, 69], "sum_loop_length": 53, "accumul": 53, "n_loop": 53, "n_mode": 53, "endpoint": 53, "syntax_check": 53, "gotten": 54, "hello": [54, 67], "static_kernel": 54, "x_kernel": 55, "control_vector": 55, "multi_controlled_oper": 55, "ccnot": 55, "applyx": 55, "ccnot_test": 55, "apply_x": 55, "counts2": 55, "seamless": [56, 67], "multithread": 56, "ghz_state": 56, "sample_ghz_st": 56, "cpu_result": 56, "525": [56, 67], "2500x": 56, "gpu_result": 56, "490": 56, "8700": 56, "freeli": [56, 65, 67], "qubits_list": 56, "990": 56, "dev": [56, 65, 67], "xi": 56, "2500": 56, "4x": 56, "asyncresult": 56, "conclud": 57, "examin": 57, "scrambl": 57, "bring": 57, "noise_depolar": 57, "noiseless_count": 57, "environment": 57, "amplitude_damp": 57, "keyword": 57, "noiseless_result": 57, "noise_amplitude_damp": 57, "wherein": 57, "undergo": 57, "degre": 57, "noise_bit_flip": 57, "bf": 57, "phase_flip": 57, "presenc": 57, "noise_phase_flip": 57, "pf": 57, "kraus_oper": 57, "nielsen": 57, "chuang": 57, "chapter": 57, "depol": 57, "99498743710662": 57, "05773502691896258": 57, "unset": 57, "good": 57, "rectangular": 58, "hp": 58, "random_vector": [58, 60], "mt19937": [58, 60], "default_se": [58, 60], "16lf": [58, 60], "transmiss": 59, "analog": 59, "counterpart": 59, "transistor": 59, "alter": 59, "superconduct": 59, "materi": 59, "ion": 59, "trap": 59, "concern": [59, 65], "ourselv": 59, "obei": 59, "law": 59, "mathemat": 59, "physicist": 59, "theori": 59, "linearli": 59, "logarithm": 59, "dirac": 59, "beta": [59, 61], "correspondingli": [59, 71], "approx": 59, "feasibl": 59, "art": [59, 71], "manipul": 59, "offload": 59, "lvert": 59, "rvert": 59, "502": 59, "498": 59, "modulu": 59, "conserv": 59, "uphold": 59, "excit": 59, "probabilist": 59, "devis": 59, "phenomena": 59, "predict": 59, "postul": 59, "alpha_": 59, "simple_vq": 60, "nminim": 60, "vqe_h2": 60, "builder": [60, 61], "arrang": 60, "so4": 60, "so4_fabr": 60, "block_siz": 60, "counter": 60, "subq": 60, "so4_param": 60, "slice_vector": 60, "odd": 60, "h2_data": 60, "10647701149499994": 60, "0454063328691": 60, "170280101353": 60, "120200490713": 60, "168335986252": 60, "165606823582": 60, "22004130022499996": 60, "174072892497": 60, "17028010135300004": 60, "22004130022499999": 60, "p_counter": 60, "n_blocks_per_lay": 60, "init_param": 60, "max_line_search_tri": 60, "gradient_vector": 60, "adam": 60, "llvm": [61, 63, 64, 65, 69], "qke": [61, 63], "pipelin": 61, "canonic": 61, "lift": 61, "indirect": 61, "loader": 61, "expand": 61, "cse": 61, "lpsxpu": 61, "p3de4l": 61, "fixup": 61, "linkag": 61, "pl": [61, 65], "llc": [61, 65], "reloc": 61, "pic": 61, "filetyp": 61, "obj": 61, "o2": 61, "clang": [61, 65, 71], "gcc": [61, 65, 67, 71], "x86_64": [61, 65, 67, 72], "lib64": [61, 67, 69], "stub": 61, "wl": [61, 65, 71], "rpath": [61, 71], "llib": 61, "lcudaq": 61, "ensmallen": 61, "em": 61, "lnvqir": 61, "orchestr": 61, "qtx": 61, "mangled_name_map": 61, "__nvqpp__mlirgen__ghz": 61, "_zn3ghzclei": 61, "i32": 61, "entrypoint": 61, "alloca": 61, "memref": 61, "extsi": 61, "c0_i32": 61, "c0_i32_0": 61, "alloca_1": 61, "c1_i32": 61, "subi": 61, "cmpi": 61, "slt": 61, "addi": 61, "unoptim": 61, "mangl": 61, "introspect": 61, "overwrit": 61, "libcudaq": 61, "libnvqir": [61, 64], "robust": 61, "intermedi": 61, "depart": 61, "recal": 61, "datalayout": 61, "p270": 61, "p271": 61, "p272": 61, "f80": 61, "n8": 61, "s128": 61, "unknown": [61, 67], "invokewithcontrolqubit": 61, "__quantum__qis__x__ctl": 61, "__quantum__rt__array_get_size_1d": 61, "__quantum__qis__h": 61, "i8": 61, "__quantum__rt__array_get_element_ptr_1d": 61, "sext": 61, "bitcast": 61, "icmp": 61, "sgt": 61, "br": 61, "ph": 61, "prehead": 61, "_crit_edg": 61, "trip": 61, "zext": 61, "indvar": 61, "iv": 61, "nuw": 61, "nsw": 61, "nonnul": 61, "exitcond": 61, "ph3": 61, "_crit_edge4": 61, "exitcond5": 61, "mycustomplugin": 63, "cmakelist": [63, 64, 68], "add_llvm_pass_plugin": 63, "operationpass": 63, "quakedialect": 63, "quakeop": 63, "frozenrewritepatternset": 63, "dialectconvers": 63, "replaceh": 63, "oprewritepattern": 63, "hop": 63, "logicalresult": 63, "matchandrewrit": 63, "patternrewrit": 63, "replaceopwithnewop": 63, "sop": 63, "isadj": 63, "getparamet": 63, "getcontrol": 63, "gettarget": 63, "custompassplugin": 63, "passwrapp": 63, "funcop": 63, "mlir_define_explicit_internal_inline_type_id": 63, "stringref": 63, "runonoper": 63, "getoper": 63, "getcontext": 63, "rewritepatternset": 63, "insert": 63, "conversiontarget": 63, "addlegaldialect": 63, "addillegalop": 63, "applypartialconvers": 63, "emitoperror": 63, "signalpassfailur": 63, "cudaq_register_mlir_pass": 63, "add_subdirectori": 63, "circuitsimulatorbas": 64, "lot": 64, "qppcircuitsimul": 64, "custateveccircuitsimul": 64, "openmp": [64, 65, 72], "addqubittost": 64, "addqubitstost": 64, "resetqubit": 64, "qubitidx": 64, "resetqubitstateimpl": 64, "applyg": 64, "gateapplicationtask": 64, "measurequbit": 64, "floattyp": 64, "mysimul": 64, "nvqir_register_simul": 64, "mysimulatorclassnam": 64, "dylib": 64, "nvqir_simulation_backend": 64, "cuda_quantum_path": [64, 65, 67, 68], "find_packag": [64, 68], "nvqir_add_backend": 64, "folder": [64, 65, 67, 68], "cmake_minimum_requir": [64, 68], "fatal_error": [64, 68], "democreatenvqirbackend": 64, "cxx": [64, 65, 68, 72], "measuredbit": 64, "cuda_quantum": [64, 65], "cd": [64, 65, 67, 68], "ninja": [64, 68], "dnvqir_dir": 64, "softwar": [65, 67], "rootless": 65, "admin": [65, 67], "meet": 65, "carefulli": 65, "though": 65, "piec": 65, "requisit": 65, "almalinux": 65, "manylinux_2_28": 65, "cento": [65, 67], "debian": [65, 67], "fedora": [65, 67], "opensus": [65, 67], "sled": [65, 67], "sle": [65, 67], "rhel": [65, 67], "rocki": [65, 67], "ubuntu": [65, 67], "newer": [65, 67, 72], "x86": [65, 67], "arm64": [65, 67, 72], "v8": [65, 67], "volta": [65, 67], "ture": [65, 67], "amper": [65, 67], "ada": [65, 67], "hopper": [65, 67], "470": [65, 67], "57": [65, 67], "git": 65, "unzip": 65, "web": [65, 67], "cudaq_install_prefix": 65, "cuquantum_install_prefix": 65, "cutensor_install_prefix": 65, "cutensor": 65, "llvm_install_prefix": 65, "blas_install_prefix": 65, "bla": 65, "zlib_install_prefix": 65, "zlib": 65, "openssl_install_prefix": 65, "openssl": 65, "curl_install_prefix": 65, "protocol": 65, "deviat": 65, "toolkit": [65, 67, 69, 72], "onlin": [65, 67], "cuda_vers": [65, 67], "cuda_download_url": [65, 67], "repo": [65, 67], "subfold": [65, 67], "rhel8": [65, 67], "cuda_arch_fold": [65, 67], "dnf": [65, 67], "nobest": [65, 67], "setopt": [65, 67], "install_weak_dep": [65, 67], "tr": [65, 67], "gcc_version": 65, "toolset": [65, 71], "assembl": 65, "enable_script": 65, "gcc_toolchain": 65, "rh": 65, "cudacxx": 65, "nvcc": [65, 67, 69], "cudahostcxx": 65, "commit": 65, "checkout": 65, "archiv": [65, 67, 71], "subsect": 65, "devel": [65, 67], "suffix": 65, "conda": [65, 72], "auditwheel": 65, "patchelf": 65, "llvm_project": 65, "flang": 65, "lld": 65, "install_prerequisit": [65, 67], "sh": [65, 67, 72], "fc": 65, "histori": 65, "setuptools_scm_pretend_vers": 65, "cudaq_wheel": 65, "manylinux_platform": 65, "linux_": 65, "sed": [65, 67], "manylinux_2_28_": 65, "pwd": [65, 71], "_skbuild": 65, "repair": 65, "plat": 65, "libcubla": [65, 67], "libcublaslt": 65, "libcusolv": [65, 67], "libcutensor": 65, "libcutensornet": 65, "libcustatevec": 65, "libcudart": 65, "libnvtoolsext": 65, "libnvidia": 65, "ml": 65, "wheelhous": 65, "cudaq_enable_static_link": 65, "cudaq_require_openmp": 65, "cudaq_werror": 65, "cudaq_python_support": 65, "build_cudaq": 65, "primarili": 65, "linker": [65, 71], "makeself": 65, "cuda_quantum_asset": 65, "mv": 65, "ld": 65, "build_config": 65, "xml": 65, "gzip": [65, 67], "sha256": 65, "install_cuda_quantum": [65, 67, 72], "unam": [65, 67, 72], "migrate_asset": 65, "libc6": [65, 67], "sudo": [65, 67, 72], "set_env": [65, 67], "asset": [65, 67, 72], "highli": [65, 67], "profil": [65, 67, 72], "prefer": [65, 67], "version_suffix": [65, 67], "nvtx": [65, 67], "cudart": [65, 67], "awar": 65, "autoconf": 65, "libtool": 65, "flex": 65, "openmpi_vers": 65, "openmpi_download_url": 65, "ompi": 65, "tar": [65, 67], "gz": [65, 67], "xf": 65, "strip": 65, "rf": [65, 67], "autogen": 65, "ldflag": 65, "prefix": [65, 67], "getpwuid": 65, "mem": 65, "memcheck": 65, "verb": 65, "nproc": 65, "mpic": 65, "mpi_cuda_check": 65, "__has_includ": 65, "ext": 65, "endif": 65, "mpi_init": 65, "exit_cod": 65, "mpix_query_cuda_support": 65, "mpi_fin": 65, "mca": 65, "plm_rsh_agent": 65, "ssh": 65, "rsh": 65, "unless": [65, 67], "slurm": 65, "mpi_path": [65, 67, 72], "distributed_interfac": [65, 67, 72], "activate_custom_mpi": [65, 67, 72], "bundl": 67, "deploi": 67, "unsur": 67, "engin": 67, "desktop": 67, "administr": 67, "ngc": 67, "whenev": 67, "pull": 67, "nvcr": 67, "prototyp": 67, "tri": 67, "readm": 67, "appreci": 67, "insuffici": 67, "hover": 67, "id_rsa": 67, "pub": 67, "itd": 67, "2222": 67, "exec": 67, "openssh": 67, "usepam": 67, "sshd_config": 67, "cp": 67, "authorized_kei": 67, "sbin": 67, "sshd": 67, "stricthostkeycheck": 67, "userknownhostsfil": 67, "globalknownhostsfil": 67, "relocat": 67, "wsl": 67, "prerequisit": 67, "sylab": 67, "ce": 67, "xzf": 67, "mconfig": 67, "suid": 67, "builddir": 67, "bootstrap": 67, "runscript": 67, "mount": 67, "devpt": 67, "fakeroot": 67, "sif": 67, "writabl": 67, "nv": 67, "conf": 67, "ldd": [67, 71], "privileg": 67, "revis": 67, "upvot": 67, "posix": 67, "browser": 67, "palett": 67, "attach": 67, "window": 67, "reload": 67, "microsoft": 67, "sandbox": 67, "portmap": 67, "sshd_output": 67, "listen": 67, "1025": 67, "65535": 67, "ui": 67, "ask": 67, "aren": 67, "icon": 67, "sidebar": 67, "workspac": 67, "remotecommand": 67, "requesttti": 67, "hostnam": 67, "enableremotecommand": 67, "uselocalserv": 67, "remoteserverlistenonsocket": 67, "connecttimeout": 67, "serverinstallpath": 67, "sign": 67, "upgrad": 67, "ac": 67, "ace_nam": 67, "instance_nam": 67, "commandlin": 67, "job_id": 67, "8888": 67, "lab": 67, "portal": 67, "minut": 67, "404": 67, "patient": 67, "happi": 67, "cuda11x": 67, "ship": 67, "vendor": 67, "prebuilt": 67, "guarante": 67, "libcudaq_distributed_interface_mpi": 67, "cudaq_mpi_comm_lib": 67, "uninstal": 67, "dsize": 67, "fairli": 67, "succe": 67, "imper": 68, "mycudaqapp": 68, "add_execut": 68, "ghz_ex": 68, "dcudaq_dir": 68, "cu": 69, "my_proj": 69, "conform": 69, "my_proj_quantum": 69, "libc": 69, "cudadatatyp": [69, 71], "cudasetfirstnel": 69, "sv": 69, "__restrict__": 69, "sv2": 69, "int64_t": 69, "blockidx": 69, "blockdim": 69, "threadidx": 69, "setfirstnel": 69, "uint32_t": [69, 71], "n_block": [69, 71], "int32_t": [69, 71], "threads_per_block": [69, 71], "newdevicestatevector": 69, "devicestatevector": [69, 71], "previousstatedimens": 69, "reinterpret_cast": [69, 71], "cufloatcomplex": [69, 71], "cudoublecomplex": [69, 71], "cucomplex": 69, "cuda_runtim": 69, "device_launch_paramet": 69, "my_kernel": 69, "cudamalloc": 69, "xcompil": 69, "fpic": [69, 71], "cuda_hom": 69, "lcudart": 69, "my_execut": 69, "hood": 71, "quantum_kernel": 71, "sstream": 71, "bell_distribut": 71, "stringbuf": 71, "ptr": 71, "strcpy": 71, "libstdc": 71, "libquantum_kernel": 71, "bell_dist": 71, "endl": 71, "lquantum_kernel": 71, "abi": 71, "incompat": 71, "watch": 71, "surround": 71, "wherea": 71, "third_party_librari": 71, "libexternal_librari": 71, "my_cod": 71, "bstatic": 71, "lexternal_librari": 71, "bdynam": 71, "undefin": 71, "crut": 71, "libexternal_library_complet": 71, "naddlib": 71, "nsave": 71, "nend": 71, "lexternal_library_complet": 71, "shim": 71, "pragma": 71, "is_integr": 71, "initializedevicestatevector": 71, "statedimens": 71, "cudainitializedevicestatevector": 71, "cumbersom": 71, "necessarili": 71, "recogn": 71, "forg": 72, "env": 72, "conda_prefix": 72, "ompi_mca_opal_cuda_support": 72, "ompi_mca_btl": 72, "openib": 72, "fault": 72, "bash_profil": 72, "bash_login": 72, "amd": 72, "averag": 72}, "objects": {"": [[2, 0, 1, "_CPPv45cudaq", "cudaq"], [2, 1, 1, "_CPPv4N5cudaq20BaseNvcfSimulatorQPUE", "cudaq::BaseNvcfSimulatorQPU"], [2, 1, 1, "_CPPv4N5cudaq17BaseRemoteRESTQPUE", "cudaq::BaseRemoteRESTQPU"], [2, 1, 1, "_CPPv4N5cudaq22BaseRemoteSimulatorQPUE", "cudaq::BaseRemoteSimulatorQPU"], [2, 1, 1, "_CPPv4I0EN5cudaq9CusvStateE", "cudaq::CusvState"], [2, 2, 1, "_CPPv4I0EN5cudaq9CusvStateE", "cudaq::CusvState::ScalarType"], [2, 1, 1, "_CPPv4N5cudaq16ExecutionContextE", "cudaq::ExecutionContext"], [2, 3, 1, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringE", "cudaq::ExecutionContext::ExecutionContext"], [2, 3, 1, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE", "cudaq::ExecutionContext::ExecutionContext"], [2, 4, 1, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringE", "cudaq::ExecutionContext::ExecutionContext::n"], [2, 4, 1, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE", "cudaq::ExecutionContext::ExecutionContext::n"], [2, 4, 1, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE", "cudaq::ExecutionContext::ExecutionContext::shots_"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext13amplitudeMapsE", "cudaq::ExecutionContext::amplitudeMaps"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext9asyncExecE", "cudaq::ExecutionContext::asyncExec"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext14batchIterationE", "cudaq::ExecutionContext::batchIteration"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext16canHandleObserveE", "cudaq::ExecutionContext::canHandleObserve"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext16expectationValueE", "cudaq::ExecutionContext::expectationValue"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext12futureResultE", "cudaq::ExecutionContext::futureResult"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext31hasConditionalsOnMeasureResultsE", "cudaq::ExecutionContext::hasConditionalsOnMeasureResults"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext22invocationResultBufferE", "cudaq::ExecutionContext::invocationResultBuffer"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext10kernelNameE", "cudaq::ExecutionContext::kernelName"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext11kernelTraceE", "cudaq::ExecutionContext::kernelTrace"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext4nameE", "cudaq::ExecutionContext::name"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext10noiseModelE", "cudaq::ExecutionContext::noiseModel"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext9optResultE", "cudaq::ExecutionContext::optResult"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext20overlapComputeStatesE", "cudaq::ExecutionContext::overlapComputeStates"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext13overlapResultE", "cudaq::ExecutionContext::overlapResult"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext13registerNamesE", "cudaq::ExecutionContext::registerNames"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext10reorderIdxE", "cudaq::ExecutionContext::reorderIdx"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext6resultE", "cudaq::ExecutionContext::result"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext5shotsE", "cudaq::ExecutionContext::shots"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext15simulationStateE", "cudaq::ExecutionContext::simulationState"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext4spinE", "cudaq::ExecutionContext::spin"], [2, 5, 1, "_CPPv4N5cudaq16ExecutionContext15totalIterationsE", "cudaq::ExecutionContext::totalIterations"], [2, 1, 1, "_CPPv4N5cudaq15ExecutionResultE", "cudaq::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionary", "cudaq::ExecutionResult::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE", "cudaq::ExecutionResult::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd", "cudaq::ExecutionResult::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultENSt6stringE", "cudaq::ExecutionResult::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult", "cudaq::ExecutionResult::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultEd", "cudaq::ExecutionResult::ExecutionResult"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultEv", "cudaq::ExecutionResult::ExecutionResult"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionary", "cudaq::ExecutionResult::ExecutionResult::c"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE", "cudaq::ExecutionResult::ExecutionResult::c"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd", "cudaq::ExecutionResult::ExecutionResult::c"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd", "cudaq::ExecutionResult::ExecutionResult::e"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultEd", "cudaq::ExecutionResult::ExecutionResult::expVal"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE", "cudaq::ExecutionResult::ExecutionResult::name"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultENSt6stringE", "cudaq::ExecutionResult::ExecutionResult::name"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult", "cudaq::ExecutionResult::ExecutionResult::other"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE", "cudaq::ExecutionResult::appendResult"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE", "cudaq::ExecutionResult::appendResult::bitString"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE", "cudaq::ExecutionResult::appendResult::count"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResult11deserializeERNSt6vectorINSt6size_tEEE", "cudaq::ExecutionResult::deserialize"], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResult11deserializeERNSt6vectorINSt6size_tEEE", "cudaq::ExecutionResult::deserialize::data"], [2, 3, 1, "_CPPv4N5cudaq15ExecutionResultaSERK15ExecutionResult", "cudaq::ExecutionResult::operator="], [2, 4, 1, "_CPPv4N5cudaq15ExecutionResultaSERK15ExecutionResult", "cudaq::ExecutionResult::operator=::other"], [2, 3, 1, "_CPPv4NK5cudaq15ExecutionResulteqERK15ExecutionResult", "cudaq::ExecutionResult::operator=="], [2, 4, 1, "_CPPv4NK5cudaq15ExecutionResulteqERK15ExecutionResult", "cudaq::ExecutionResult::operator==::result"], [2, 5, 1, "_CPPv4N5cudaq15ExecutionResult12registerNameE", "cudaq::ExecutionResult::registerName"], [2, 5, 1, "_CPPv4N5cudaq15ExecutionResult14sequentialDataE", "cudaq::ExecutionResult::sequentialData"], [2, 3, 1, "_CPPv4NK5cudaq15ExecutionResult9serializeEv", "cudaq::ExecutionResult::serialize"], [2, 0, 1, "_CPPv4N5cudaq19KernelExecutionTaskE", "cudaq::KernelExecutionTask"], [2, 1, 1, "_CPPv4N5cudaq3QPUE", "cudaq::QPU"], [2, 3, 1, "_CPPv4N5cudaq3QPU3QPUENSt6size_tE", "cudaq::QPU::QPU"], [2, 3, 1, "_CPPv4N5cudaq3QPU3QPUERR3QPU", "cudaq::QPU::QPU"], [2, 3, 1, "_CPPv4N5cudaq3QPU3QPUEv", "cudaq::QPU::QPU"], [2, 4, 1, "_CPPv4N5cudaq3QPU3QPUENSt6size_tE", "cudaq::QPU::QPU::_qpuId"], [2, 3, 1, "_CPPv4N5cudaq3QPU7enqueueER11QuantumTask", "cudaq::QPU::enqueue"], [2, 4, 1, "_CPPv4N5cudaq3QPU7enqueueER11QuantumTask", "cudaq::QPU::enqueue::task"], [2, 3, 1, "_CPPv4N5cudaq3QPU15getConnectivityEv", "cudaq::QPU::getConnectivity"], [2, 3, 1, "_CPPv4NK5cudaq3QPU20getExecutionThreadIdEv", "cudaq::QPU::getExecutionThreadId"], [2, 3, 1, "_CPPv4N5cudaq3QPU12getNumQubitsEv", "cudaq::QPU::getNumQubits"], [2, 3, 1, "_CPPv4NK5cudaq3QPU21getRemoteCapabilitiesEv", "cudaq::QPU::getRemoteCapabilities"], [2, 3, 1, "_CPPv4N5cudaq3QPU10isEmulatedEv", "cudaq::QPU::isEmulated"], [2, 3, 1, "_CPPv4N5cudaq3QPU11isSimulatorEv", "cudaq::QPU::isSimulator"], [2, 3, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel"], [2, 3, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel"], [2, 4, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel::args"], [2, 4, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel::kernelFunc"], [2, 4, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel::name"], [2, 4, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel::name"], [2, 4, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel::rawArgs"], [2, 4, 1, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE", "cudaq::QPU::launchKernel::rawArgs"], [2, 3, 1, "_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE", "cudaq::QPU::launchSerializedCodeExecution"], [2, 4, 1, "_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE", "cudaq::QPU::launchSerializedCodeExecution::name"], [2, 4, 1, "_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE", "cudaq::QPU::launchSerializedCodeExecution::serializeCodeExecutionObject"], [2, 3, 1, "_CPPv4N5cudaq3QPU15onRandomSeedSetENSt6size_tE", "cudaq::QPU::onRandomSeedSet"], [2, 4, 1, "_CPPv4N5cudaq3QPU15onRandomSeedSetENSt6size_tE", "cudaq::QPU::onRandomSeedSet::seed"], [2, 3, 1, "_CPPv4N5cudaq3QPU21resetExecutionContextEv", "cudaq::QPU::resetExecutionContext"], [2, 3, 1, "_CPPv4N5cudaq3QPU19setExecutionContextEP16ExecutionContext", "cudaq::QPU::setExecutionContext"], [2, 4, 1, "_CPPv4N5cudaq3QPU19setExecutionContextEP16ExecutionContext", "cudaq::QPU::setExecutionContext::context"], [2, 3, 1, "_CPPv4N5cudaq3QPU5setIdENSt6size_tE", "cudaq::QPU::setId"], [2, 4, 1, "_CPPv4N5cudaq3QPU5setIdENSt6size_tE", "cudaq::QPU::setId::_qpuId"], [2, 3, 1, "_CPPv4N5cudaq3QPU8setShotsEi", "cudaq::QPU::setShots"], [2, 4, 1, "_CPPv4N5cudaq3QPU8setShotsEi", "cudaq::QPU::setShots::_nShots"], [2, 3, 1, "_CPPv4N5cudaq3QPU27supportsConditionalFeedbackEv", "cudaq::QPU::supportsConditionalFeedback"], [2, 3, 1, "_CPPv4N5cudaq3QPUD0Ev", "cudaq::QPU::~QPU"], [2, 1, 1, "_CPPv4N5cudaq10QuakeValueE", "cudaq::QuakeValue"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE", "cudaq::QuakeValue::QuakeValue"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd", "cudaq::QuakeValue::QuakeValue"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE", "cudaq::QuakeValue::QuakeValue::builder"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd", "cudaq::QuakeValue::QuakeValue::builder"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE", "cudaq::QuakeValue::QuakeValue::v"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd", "cudaq::QuakeValue::QuakeValue::v"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue22canValidateNumElementsEv", "cudaq::QuakeValue::canValidateNumElements"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue12constantSizeEv", "cudaq::QuakeValue::constantSize"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue4dumpERNSt7ostreamE", "cudaq::QuakeValue::dump"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue4dumpEv", "cudaq::QuakeValue::dump"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue19getRequiredElementsEv", "cudaq::QuakeValue::getRequiredElements"], [2, 3, 1, "_CPPv4NK5cudaq10QuakeValue8getValueEv", "cudaq::QuakeValue::getValue"], [2, 3, 1, "_CPPv4NK5cudaq10QuakeValue7inverseEv", "cudaq::QuakeValue::inverse"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue8isStdVecEv", "cudaq::QuakeValue::isStdVec"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuemlE10QuakeValue", "cudaq::QuakeValue::operator*"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuemlEKd", "cudaq::QuakeValue::operator*"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValuemlE10QuakeValue", "cudaq::QuakeValue::operator*::other"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValueplE10QuakeValue", "cudaq::QuakeValue::operator+"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValueplEKd", "cudaq::QuakeValue::operator+"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValueplEKi", "cudaq::QuakeValue::operator+"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValueplE10QuakeValue", "cudaq::QuakeValue::operator+::other"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuemiE10QuakeValue", "cudaq::QuakeValue::operator-"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuemiEKd", "cudaq::QuakeValue::operator-"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuemiEKi", "cudaq::QuakeValue::operator-"], [2, 3, 1, "_CPPv4NK5cudaq10QuakeValuemiEv", "cudaq::QuakeValue::operator-"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValuemiE10QuakeValue", "cudaq::QuakeValue::operator-::other"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuedvE10QuakeValue", "cudaq::QuakeValue::operator/"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValuedvEKd", "cudaq::QuakeValue::operator/"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValuedvE10QuakeValue", "cudaq::QuakeValue::operator/::other"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValueixEKNSt6size_tE", "cudaq::QuakeValue::operator[]"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValueixERK10QuakeValue", "cudaq::QuakeValue::operator[]"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValueixEKNSt6size_tE", "cudaq::QuakeValue::operator[]::idx"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValueixERK10QuakeValue", "cudaq::QuakeValue::operator[]::idx"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue4sizeEv", "cudaq::QuakeValue::size"], [2, 3, 1, "_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE", "cudaq::QuakeValue::slice"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE", "cudaq::QuakeValue::slice::count"], [2, 4, 1, "_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE", "cudaq::QuakeValue::slice::startIdx"], [2, 0, 1, "_CPPv4N5cudaq11QuantumTaskE", "cudaq::QuantumTask"], [2, 0, 1, "_CPPv4N5cudaq17QubitConnectivityE", "cudaq::QubitConnectivity"], [2, 0, 1, "_CPPv4N5cudaq9QubitEdgeE", "cudaq::QubitEdge"], [2, 1, 1, "_CPPv4N5cudaq18RemoteCapabilitiesE", "cudaq::RemoteCapabilities"], [2, 3, 1, "_CPPv4N5cudaq18RemoteCapabilities18RemoteCapabilitiesEb", "cudaq::RemoteCapabilities::RemoteCapabilities"], [2, 4, 1, "_CPPv4N5cudaq18RemoteCapabilities18RemoteCapabilitiesEb", "cudaq::RemoteCapabilities::RemoteCapabilities::initValue"], [2, 5, 1, "_CPPv4N5cudaq18RemoteCapabilities17isRemoteSimulatorE", "cudaq::RemoteCapabilities::isRemoteSimulator"], [2, 5, 1, "_CPPv4N5cudaq18RemoteCapabilities18serializedCodeExecE", "cudaq::RemoteCapabilities::serializedCodeExec"], [2, 5, 1, "_CPPv4N5cudaq18RemoteCapabilities12stateOverlapE", "cudaq::RemoteCapabilities::stateOverlap"], [2, 5, 1, "_CPPv4N5cudaq18RemoteCapabilities3vqeE", "cudaq::RemoteCapabilities::vqe"], [2, 1, 1, "_CPPv4N5cudaq21RemoteSimulationStateE", "cudaq::RemoteSimulationState"], [2, 1, 1, "_CPPv4N5cudaq9ResourcesE", "cudaq::Resources"], [2, 1, 1, "_CPPv4N5cudaq30SerializedCodeExecutionContextE", "cudaq::SerializedCodeExecutionContext"], [2, 1, 1, "_CPPv4N5cudaq15SimulationStateE", "cudaq::SimulationState"], [2, 1, 1, "_CPPv4N5cudaq15SimulationState6TensorE", "cudaq::SimulationState::Tensor"], [2, 6, 1, "_CPPv4N5cudaq15SimulationState9precisionE", "cudaq::SimulationState::precision"], [2, 7, 1, "_CPPv4N5cudaq15SimulationState9precision4fp32E", "cudaq::SimulationState::precision::fp32"], [2, 7, 1, "_CPPv4N5cudaq15SimulationState9precision4fp64E", "cudaq::SimulationState::precision::fp64"], [2, 0, 1, "_CPPv4N5cudaq15TensorStateDataE", "cudaq::TensorStateData"], [2, 1, 1, "_CPPv4N5cudaq5TraceE", "cudaq::Trace"], [2, 1, 1, "_CPPv4N5cudaq25amplitude_damping_channelE", "cudaq::amplitude_damping_channel"], [2, 1, 1, "_CPPv4I0EN5cudaq12async_resultE", "cudaq::async_result"], [2, 2, 1, "_CPPv4I0EN5cudaq12async_resultE", "cudaq::async_result::T"], [2, 3, 1, "_CPPv4N5cudaq12async_result3getEv", "cudaq::async_result::get"], [2, 1, 1, "_CPPv4N5cudaq16bit_flip_channelE", "cudaq::bit_flip_channel"], [2, 0, 1, "_CPPv4N5cudaq7complexE", "cudaq::complex"], [2, 1, 1, "_CPPv4N5cudaq14complex_matrixE", "cudaq::complex_matrix"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrix4colsEv", "cudaq::complex_matrix::cols"], [2, 3, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix"], [2, 3, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix"], [2, 4, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix::cols"], [2, 4, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix::cols"], [2, 4, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix::rawData"], [2, 4, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix::rows"], [2, 4, 1, "_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE", "cudaq::complex_matrix::complex_matrix::rows"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrix4dataEv", "cudaq::complex_matrix::data"], [2, 3, 1, "_CPPv4N5cudaq14complex_matrix4dumpERNSt7ostreamE", "cudaq::complex_matrix::dump"], [2, 3, 1, "_CPPv4N5cudaq14complex_matrix4dumpEv", "cudaq::complex_matrix::dump"], [2, 4, 1, "_CPPv4N5cudaq14complex_matrix4dumpERNSt7ostreamE", "cudaq::complex_matrix::dump::os"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrix11eigenvaluesEv", "cudaq::complex_matrix::eigenvalues"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrix12eigenvectorsEv", "cudaq::complex_matrix::eigenvectors"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrix18minimal_eigenvalueEv", "cudaq::complex_matrix::minimal_eigenvalue"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE", "cudaq::complex_matrix::operator()"], [2, 4, 1, "_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE", "cudaq::complex_matrix::operator()::i"], [2, 4, 1, "_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE", "cudaq::complex_matrix::operator()::j"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrixmlER14complex_matrix", "cudaq::complex_matrix::operator*"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrixmlERNSt6vectorI10value_typeEE", "cudaq::complex_matrix::operator*"], [2, 4, 1, "_CPPv4NK5cudaq14complex_matrixmlER14complex_matrix", "cudaq::complex_matrix::operator*::other"], [2, 4, 1, "_CPPv4NK5cudaq14complex_matrixmlERNSt6vectorI10value_typeEE", "cudaq::complex_matrix::operator*::other"], [2, 3, 1, "_CPPv4NK5cudaq14complex_matrix4rowsEv", "cudaq::complex_matrix::rows"], [2, 3, 1, "_CPPv4N5cudaq14complex_matrix8set_zeroEv", "cudaq::complex_matrix::set_zero"], [2, 0, 1, "_CPPv4N5cudaq14complex_matrix10value_typeE", "cudaq::complex_matrix::value_type"], [2, 1, 1, "_CPPv4N5cudaq22depolarization_channelE", "cudaq::depolarization_channel"], [2, 0, 1, "_CPPv4N5cudaq7detailsE", "cudaq::details"], [2, 1, 1, "_CPPv4N5cudaq7details17KernelBuilderTypeE", "cudaq::details::KernelBuilderType"], [2, 3, 1, "_CPPv4N5cudaq7details17KernelBuilderType17KernelBuilderTypeERRNSt8functionIFN4mlir4TypeEPN4mlir11MLIRContextEEEE", "cudaq::details::KernelBuilderType::KernelBuilderType"], [2, 4, 1, "_CPPv4N5cudaq7details17KernelBuilderType17KernelBuilderTypeERRNSt8functionIFN4mlir4TypeEPN4mlir11MLIRContextEEEE", "cudaq::details::KernelBuilderType::KernelBuilderType::f"], [2, 3, 1, "_CPPv4N5cudaq7details17KernelBuilderType6createEPN4mlir11MLIRContextE", "cudaq::details::KernelBuilderType::create"], [2, 4, 1, "_CPPv4N5cudaq7details17KernelBuilderType6createEPN4mlir11MLIRContextE", "cudaq::details::KernelBuilderType::create::ctx"], [2, 1, 1, "_CPPv4N5cudaq7details6futureE", "cudaq::details::future"], [2, 3, 1, "_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE", "cudaq::details::future::future"], [2, 3, 1, "_CPPv4N5cudaq7details6future6futureERR6future", "cudaq::details::future::future"], [2, 3, 1, "_CPPv4N5cudaq7details6future6futureEv", "cudaq::details::future::future"], [2, 4, 1, "_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE", "cudaq::details::future::future::_jobs"], [2, 4, 1, "_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE", "cudaq::details::future::future::config"], [2, 4, 1, "_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE", "cudaq::details::future::future::qpuNameIn"], [2, 1, 1, "_CPPv4N5cudaq7details19kernel_builder_baseE", "cudaq::details::kernel_builder_base"], [2, 3, 1, "_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base", "cudaq::details::kernel_builder_base::operator&lt;&lt;"], [2, 4, 1, "_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base", "cudaq::details::kernel_builder_base::operator&lt;&lt;::builder"], [2, 4, 1, "_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base", "cudaq::details::kernel_builder_base::operator&lt;&lt;::stream"], [2, 3, 1, "_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args", "cudaq::draw"], [2, 2, 1, "_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args", "cudaq::draw::Args"], [2, 2, 1, "_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args", "cudaq::draw::QuantumKernel"], [2, 4, 1, "_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args", "cudaq::draw::args"], [2, 4, 1, "_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args", "cudaq::draw::kernel"], [2, 5, 1, "_CPPv4N5cudaq3dynE", "cudaq::dyn"], [2, 1, 1, "_CPPv4N5cudaq8gradientE", "cudaq::gradient"], [2, 3, 1, "_CPPv4N5cudaq8gradient5cloneEv", "cudaq::gradient::clone"], [2, 3, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradient::compute"], [2, 3, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradient::compute"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradient::compute::dx"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradient::compute::func"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradient::compute::funcAtX"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradient::compute::funcAtX"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradient::compute::h"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradient::compute::x"], [2, 4, 1, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradient::compute::x"], [2, 3, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelT", "cudaq::gradient::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper", "cudaq::gradient::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradient::gradient"], [2, 3, 1, "_CPPv4N5cudaq8gradient8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradient::gradient"], [2, 3, 1, "_CPPv4N5cudaq8gradient8gradientEv", "cudaq::gradient::gradient"], [2, 2, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper", "cudaq::gradient::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradient::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelT", "cudaq::gradient::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper", "cudaq::gradient::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradient::gradient::QuantumKernel"], [2, 4, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper", "cudaq::gradient::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradient::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelT", "cudaq::gradient::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper", "cudaq::gradient::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradient::gradient::kernel"], [2, 4, 1, "_CPPv4N5cudaq8gradient8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradient::gradient::kernel"], [2, 3, 1, "_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args", "cudaq::gradient::setArgs"], [2, 2, 1, "_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args", "cudaq::gradient::setArgs::Args"], [2, 2, 1, "_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args", "cudaq::gradient::setArgs::QuantumKernel"], [2, 4, 1, "_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args", "cudaq::gradient::setArgs::args"], [2, 4, 1, "_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args", "cudaq::gradient::setArgs::kernel"], [2, 3, 1, "_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel", "cudaq::gradient::setKernel"], [2, 2, 1, "_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel", "cudaq::gradient::setKernel::QuantumKernel"], [2, 4, 1, "_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel", "cudaq::gradient::setKernel::kernel"], [2, 1, 1, "_CPPv4N5cudaq9gradients18central_differenceE", "cudaq::gradients::central_difference"], [2, 3, 1, "_CPPv4N5cudaq9gradients18central_difference5cloneEv", "cudaq::gradients::central_difference::clone"], [2, 3, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::central_difference::compute"], [2, 3, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::central_difference::compute"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::central_difference::compute::dx"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::central_difference::compute::exp_h"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::central_difference::compute::func"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::central_difference::compute::funcAtX"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::central_difference::compute::h"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::central_difference::compute::x"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::central_difference::compute::x"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT", "cudaq::gradients::central_difference::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::central_difference::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::central_difference::gradient"], [2, 3, 1, "_CPPv4N5cudaq9gradients18central_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradients::central_difference::gradient"], [2, 3, 1, "_CPPv4N5cudaq9gradients18central_difference8gradientEv", "cudaq::gradients::central_difference::gradient"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT", "cudaq::gradients::central_difference::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::QuantumKernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT", "cudaq::gradients::central_difference::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::central_difference::gradient::kernel"], [2, 4, 1, "_CPPv4N5cudaq9gradients18central_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradients::central_difference::gradient::kernel"], [2, 1, 1, "_CPPv4N5cudaq9gradients18forward_differenceE", "cudaq::gradients::forward_difference"], [2, 3, 1, "_CPPv4N5cudaq9gradients18forward_difference5cloneEv", "cudaq::gradients::forward_difference::clone"], [2, 3, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::forward_difference::compute"], [2, 3, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::forward_difference::compute"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::forward_difference::compute::dx"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::forward_difference::compute::func"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::forward_difference::compute::funcAtX"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::forward_difference::compute::funcAtX"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::forward_difference::compute::h"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::forward_difference::compute::x"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::forward_difference::compute::x"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT", "cudaq::gradients::forward_difference::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient"], [2, 3, 1, "_CPPv4N5cudaq9gradients18forward_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradients::forward_difference::gradient"], [2, 3, 1, "_CPPv4N5cudaq9gradients18forward_difference8gradientEv", "cudaq::gradients::forward_difference::gradient"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT", "cudaq::gradients::forward_difference::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::QuantumKernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT", "cudaq::gradients::forward_difference::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::forward_difference::gradient::kernel"], [2, 4, 1, "_CPPv4N5cudaq9gradients18forward_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradients::forward_difference::gradient::kernel"], [2, 1, 1, "_CPPv4N5cudaq9gradients15parameter_shiftE", "cudaq::gradients::parameter_shift"], [2, 3, 1, "_CPPv4N5cudaq9gradients15parameter_shift5cloneEv", "cudaq::gradients::parameter_shift::clone"], [2, 3, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::parameter_shift::compute"], [2, 3, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::parameter_shift::compute"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::parameter_shift::compute::dx"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::parameter_shift::compute::exp_h"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::parameter_shift::compute::func"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::parameter_shift::compute::funcAtX"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::parameter_shift::compute::h"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd", "cudaq::gradients::parameter_shift::compute::x"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd", "cudaq::gradients::parameter_shift::compute::x"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT", "cudaq::gradients::parameter_shift::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient"], [2, 3, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient"], [2, 3, 1, "_CPPv4N5cudaq9gradients15parameter_shift8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradients::parameter_shift::gradient"], [2, 3, 1, "_CPPv4N5cudaq9gradients15parameter_shift8gradientEv", "cudaq::gradients::parameter_shift::gradient"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::ArgsMapper"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT", "cudaq::gradients::parameter_shift::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::KernelT"], [2, 2, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::QuantumKernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::argsMapper"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT", "cudaq::gradients::parameter_shift::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::kernel"], [2, 4, 1, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper", "cudaq::gradients::parameter_shift::gradient::kernel"], [2, 4, 1, "_CPPv4N5cudaq9gradients15parameter_shift8gradientERRNSt8functionIFvNSt6vectorIdEEEEE", "cudaq::gradients::parameter_shift::gradient::kernel"], [2, 1, 1, "_CPPv4IDpEN5cudaq14kernel_builderE", "cudaq::kernel_builder"], [2, 2, 1, "_CPPv4IDpEN5cudaq14kernel_builderE", "cudaq::kernel_builder::Args"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder11constantValEd", "cudaq::kernel_builder::constantVal"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder11constantValEd", "cudaq::kernel_builder::constantVal::val"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder12getArgumentsEv", "cudaq::kernel_builder::getArguments"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder12getNumParamsEv", "cudaq::kernel_builder::getNumParams"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder11isArgStdVecENSt6size_tE", "cudaq::kernel_builder::isArgStdVec"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder11isArgStdVecENSt6size_tE", "cudaq::kernel_builder::isArgStdVec::idx"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder14kernel_builderERNSt6vectorIN7details17KernelBuilderTypeEEE", "cudaq::kernel_builder::kernel_builder"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder14kernel_builderERNSt6vectorIN7details17KernelBuilderTypeEEE", "cudaq::kernel_builder::kernel_builder::types"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder4nameEv", "cudaq::kernel_builder::name"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder6qallocE10QuakeValue", "cudaq::kernel_builder::qalloc"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder6qallocEKNSt6size_tE", "cudaq::kernel_builder::qalloc"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder6qallocERNSt6vectorINSt7complexIdEEEE", "cudaq::kernel_builder::qalloc"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder6qallocEv", "cudaq::kernel_builder::qalloc"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder6qallocEKNSt6size_tE", "cudaq::kernel_builder::qalloc::nQubits"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder6qallocE10QuakeValue", "cudaq::kernel_builder::qalloc::size"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder6qallocERNSt6vectorINSt7complexIdEEEE", "cudaq::kernel_builder::qalloc::state"], [2, 3, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap"], [2, 3, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap"], [2, 3, 1, "_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap"], [2, 4, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::control"], [2, 4, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::controls"], [2, 4, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::first"], [2, 4, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::first"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::first"], [2, 2, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::mod"], [2, 2, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::mod"], [2, 4, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::second"], [2, 4, 1, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::second"], [2, 4, 1, "_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue", "cudaq::kernel_builder::swap::second"], [2, 1, 1, "_CPPv4N5cudaq13kraus_channelE", "cudaq::kraus_channel"], [2, 3, 1, "_CPPv4NK5cudaq13kraus_channel5emptyEv", "cudaq::kraus_channel::empty"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channel7get_opsEv", "cudaq::kraus_channel::get_ops"], [2, 3, 1, "_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE", "cudaq::kraus_channel::kraus_channel"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel", "cudaq::kraus_channel::kraus_channel"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelERNSt6vectorI8kraus_opEE", "cudaq::kraus_channel::kraus_channel"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelERRNSt6vectorI8kraus_opEE", "cudaq::kraus_channel::kraus_channel"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelEv", "cudaq::kraus_channel::kraus_channel"], [2, 2, 1, "_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE", "cudaq::kraus_channel::kraus_channel::T"], [2, 4, 1, "_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE", "cudaq::kraus_channel::kraus_channel::inputLists"], [2, 4, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelERNSt6vectorI8kraus_opEE", "cudaq::kraus_channel::kraus_channel::ops"], [2, 4, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelERRNSt6vectorI8kraus_opEE", "cudaq::kraus_channel::kraus_channel::ops"], [2, 4, 1, "_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel", "cudaq::kraus_channel::kraus_channel::other"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channelaSERK13kraus_channel", "cudaq::kraus_channel::operator="], [2, 4, 1, "_CPPv4N5cudaq13kraus_channelaSERK13kraus_channel", "cudaq::kraus_channel::operator=::other"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channelixEKNSt6size_tE", "cudaq::kraus_channel::operator[]"], [2, 4, 1, "_CPPv4N5cudaq13kraus_channelixEKNSt6size_tE", "cudaq::kraus_channel::operator[]::idx"], [2, 3, 1, "_CPPv4N5cudaq13kraus_channel9push_backE8kraus_op", "cudaq::kraus_channel::push_back"], [2, 4, 1, "_CPPv4N5cudaq13kraus_channel9push_backE8kraus_op", "cudaq::kraus_channel::push_back::op"], [2, 3, 1, "_CPPv4NK5cudaq13kraus_channel4sizeEv", "cudaq::kraus_channel::size"], [2, 1, 1, "_CPPv4N5cudaq8kraus_opE", "cudaq::kraus_op"], [2, 3, 1, "_CPPv4NK5cudaq8kraus_op7adjointEv", "cudaq::kraus_op::adjoint"], [2, 5, 1, "_CPPv4N5cudaq8kraus_op4dataE", "cudaq::kraus_op::data"], [2, 3, 1, "_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE", "cudaq::kraus_op::kraus_op"], [2, 3, 1, "_CPPv4N5cudaq8kraus_op8kraus_opENSt6vectorIN5cudaq7complexEEE", "cudaq::kraus_op::kraus_op"], [2, 3, 1, "_CPPv4N5cudaq8kraus_op8kraus_opERK8kraus_op", "cudaq::kraus_op::kraus_op"], [2, 2, 1, "_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE", "cudaq::kraus_op::kraus_op::T"], [2, 4, 1, "_CPPv4N5cudaq8kraus_op8kraus_opENSt6vectorIN5cudaq7complexEEE", "cudaq::kraus_op::kraus_op::d"], [2, 4, 1, "_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE", "cudaq::kraus_op::kraus_op::initList"], [2, 5, 1, "_CPPv4N5cudaq8kraus_op5nColsE", "cudaq::kraus_op::nCols"], [2, 5, 1, "_CPPv4N5cudaq8kraus_op5nRowsE", "cudaq::kraus_op::nRows"], [2, 3, 1, "_CPPv4N5cudaq8kraus_opaSERK8kraus_op", "cudaq::kraus_op::operator="], [2, 4, 1, "_CPPv4N5cudaq8kraus_opaSERK8kraus_op", "cudaq::kraus_op::operator=::other"], [2, 0, 1, "_CPPv4N5cudaq3mpiE", "cudaq::mpi"], [2, 3, 1, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE", "cudaq::mpi::all_gather"], [2, 3, 1, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE", "cudaq::mpi::all_gather"], [2, 4, 1, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE", "cudaq::mpi::all_gather::global"], [2, 4, 1, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE", "cudaq::mpi::all_gather::global"], [2, 4, 1, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE", "cudaq::mpi::all_gather::local"], [2, 4, 1, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE", "cudaq::mpi::all_gather::local"], [2, 3, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction", "cudaq::mpi::all_reduce"], [2, 3, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func", "cudaq::mpi::all_reduce"], [2, 2, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction", "cudaq::mpi::all_reduce::BinaryFunction"], [2, 2, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func", "cudaq::mpi::all_reduce::Func"], [2, 2, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction", "cudaq::mpi::all_reduce::T"], [2, 2, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func", "cudaq::mpi::all_reduce::T"], [2, 4, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction", "cudaq::mpi::all_reduce::function"], [2, 4, 1, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction", "cudaq::mpi::all_reduce::localValue"], [2, 3, 1, "_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi", "cudaq::mpi::broadcast"], [2, 3, 1, "_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi", "cudaq::mpi::broadcast"], [2, 4, 1, "_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi", "cudaq::mpi::broadcast::data"], [2, 4, 1, "_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi", "cudaq::mpi::broadcast::data"], [2, 4, 1, "_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi", "cudaq::mpi::broadcast::rootRank"], [2, 4, 1, "_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi", "cudaq::mpi::broadcast::rootRank"], [2, 3, 1, "_CPPv4N5cudaq3mpi8finalizeEv", "cudaq::mpi::finalize"], [2, 3, 1, "_CPPv4N5cudaq3mpi10initializeEiPPc", "cudaq::mpi::initialize"], [2, 3, 1, "_CPPv4N5cudaq3mpi10initializeEv", "cudaq::mpi::initialize"], [2, 4, 1, "_CPPv4N5cudaq3mpi10initializeEiPPc", "cudaq::mpi::initialize::argc"], [2, 4, 1, "_CPPv4N5cudaq3mpi10initializeEiPPc", "cudaq::mpi::initialize::argv"], [2, 3, 1, "_CPPv4N5cudaq3mpi14is_initializedEv", "cudaq::mpi::is_initialized"], [2, 3, 1, "_CPPv4N5cudaq3mpi9num_ranksEv", "cudaq::mpi::num_ranks"], [2, 3, 1, "_CPPv4N5cudaq3mpi4rankEv", "cudaq::mpi::rank"], [2, 1, 1, "_CPPv4N5cudaq11noise_modelE", "cudaq::noise_model"], [2, 0, 1, "_CPPv4N5cudaq11noise_model15PredicateFuncTyE", "cudaq::noise_model::PredicateFuncTy"], [2, 3, 1, "_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel"], [2, 3, 1, "_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel"], [2, 2, 1, "_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel::QuantumOp"], [2, 4, 1, "_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel::channel"], [2, 4, 1, "_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel::channel"], [2, 4, 1, "_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel::numControls"], [2, 4, 1, "_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel::numControls"], [2, 4, 1, "_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli", "cudaq::noise_model::add_all_qubit_channel::quantumOp"], [2, 3, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy", "cudaq::noise_model::add_channel"], [2, 3, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel"], [2, 3, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy", "cudaq::noise_model::add_channel"], [2, 3, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel"], [2, 2, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy", "cudaq::noise_model::add_channel::QuantumOp"], [2, 2, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel::QuantumOp"], [2, 4, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel::channel"], [2, 4, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel::channel"], [2, 4, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy", "cudaq::noise_model::add_channel::pred"], [2, 4, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy", "cudaq::noise_model::add_channel::pred"], [2, 4, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy", "cudaq::noise_model::add_channel::quantumOp"], [2, 4, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel::quantumOp"], [2, 4, 1, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel::qubits"], [2, 4, 1, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel", "cudaq::noise_model::add_channel::qubits"], [2, 3, 1, "_CPPv4NK5cudaq11noise_model5emptyEv", "cudaq::noise_model::empty"], [2, 3, 1, "_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels"], [2, 3, 1, "_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels"], [2, 2, 1, "_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::QuantumOp"], [2, 4, 1, "_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::controlQubits"], [2, 4, 1, "_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::controlQubits"], [2, 4, 1, "_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::params"], [2, 4, 1, "_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::params"], [2, 4, 1, "_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::quantumOp"], [2, 4, 1, "_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::targetQubits"], [2, 4, 1, "_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE", "cudaq::noise_model::get_channels::targetQubits"], [2, 3, 1, "_CPPv4N5cudaq11noise_model11noise_modelEv", "cudaq::noise_model::noise_model"], [2, 3, 1, "_CPPv4N5cudaq18num_available_gpusEv", "cudaq::num_available_gpus"], [2, 1, 1, "_CPPv4N5cudaq14observe_resultE", "cudaq::observe_result"], [2, 3, 1, "_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType", "cudaq::observe_result::counts"], [2, 2, 1, "_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType", "cudaq::observe_result::counts::SpinOpType"], [2, 4, 1, "_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType", "cudaq::observe_result::counts::term"], [2, 3, 1, "_CPPv4N5cudaq14observe_result4dumpEv", "cudaq::observe_result::dump"], [2, 3, 1, "_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType", "cudaq::observe_result::expectation"], [2, 3, 1, "_CPPv4N5cudaq14observe_result11expectationEv", "cudaq::observe_result::expectation"], [2, 2, 1, "_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType", "cudaq::observe_result::expectation::SpinOpType"], [2, 4, 1, "_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType", "cudaq::observe_result::expectation::term"], [2, 3, 1, "_CPPv4N5cudaq14observe_result14id_coefficientEv", "cudaq::observe_result::id_coefficient"], [2, 3, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op", "cudaq::observe_result::observe_result"], [2, 3, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result", "cudaq::observe_result::observe_result"], [2, 4, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op", "cudaq::observe_result::observe_result::H"], [2, 4, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result", "cudaq::observe_result::observe_result::H"], [2, 4, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result", "cudaq::observe_result::observe_result::counts"], [2, 4, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op", "cudaq::observe_result::observe_result::e"], [2, 4, 1, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result", "cudaq::observe_result::observe_result::e"], [2, 3, 1, "_CPPv4N5cudaq14observe_resultcvdEv", "cudaq::observe_result::operator double"], [2, 3, 1, "_CPPv4N5cudaq14observe_result8raw_dataEv", "cudaq::observe_result::raw_data"], [2, 1, 1, "_CPPv4N5cudaq20optimizable_functionE", "cudaq::optimizable_function"], [2, 0, 1, "_CPPv4N5cudaq19optimization_resultE", "cudaq::optimization_result"], [2, 1, 1, "_CPPv4N5cudaq9optimizerE", "cudaq::optimizer"], [2, 3, 1, "_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function", "cudaq::optimizer::optimize"], [2, 4, 1, "_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function", "cudaq::optimizer::optimize::dim"], [2, 4, 1, "_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function", "cudaq::optimizer::optimize::opt_function"], [2, 3, 1, "_CPPv4N5cudaq9optimizer17requiresGradientsEv", "cudaq::optimizer::requiresGradients"], [2, 0, 1, "_CPPv4N5cudaq4orcaE", "cudaq::orca"], [2, 3, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi", "cudaq::orca::sample"], [2, 3, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi", "cudaq::orca::sample"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi", "cudaq::orca::sample::bs_angles"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi", "cudaq::orca::sample::bs_angles"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi", "cudaq::orca::sample::input_state"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi", "cudaq::orca::sample::input_state"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi", "cudaq::orca::sample::loop_lengths"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi", "cudaq::orca::sample::loop_lengths"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi", "cudaq::orca::sample::n_samples"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi", "cudaq::orca::sample::n_samples"], [2, 4, 1, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi", "cudaq::orca::sample::ps_angles"], [2, 1, 1, "_CPPv4N5cudaq18phase_flip_channelE", "cudaq::phase_flip_channel"], [2, 1, 1, "_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE", "cudaq::qreg"], [2, 2, 1, "_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE", "cudaq::qreg::Levels"], [2, 2, 1, "_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE", "cudaq::qreg::N"], [2, 3, 1, "_CPPv4N5cudaq4qreg4backENSt6size_tE", "cudaq::qreg::back"], [2, 3, 1, "_CPPv4N5cudaq4qreg4backEv", "cudaq::qreg::back"], [2, 4, 1, "_CPPv4N5cudaq4qreg4backENSt6size_tE", "cudaq::qreg::back::count"], [2, 3, 1, "_CPPv4N5cudaq4qreg5beginEv", "cudaq::qreg::begin"], [2, 3, 1, "_CPPv4N5cudaq4qreg5clearEv", "cudaq::qreg::clear"], [2, 3, 1, "_CPPv4N5cudaq4qreg5frontENSt6size_tE", "cudaq::qreg::front"], [2, 3, 1, "_CPPv4N5cudaq4qreg5frontEv", "cudaq::qreg::front"], [2, 4, 1, "_CPPv4N5cudaq4qreg5frontENSt6size_tE", "cudaq::qreg::front::count"], [2, 3, 1, "_CPPv4N5cudaq4qregixEKNSt6size_tE", "cudaq::qreg::operator[]"], [2, 4, 1, "_CPPv4N5cudaq4qregixEKNSt6size_tE", "cudaq::qreg::operator[]::idx"], [2, 3, 1, "_CPPv4NK5cudaq4qreg4sizeEv", "cudaq::qreg::size"], [2, 3, 1, "_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE", "cudaq::qreg::slice"], [2, 4, 1, "_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE", "cudaq::qreg::slice::size"], [2, 4, 1, "_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE", "cudaq::qreg::slice::start"], [2, 0, 1, "_CPPv4N5cudaq4qreg10value_typeE", "cudaq::qreg::value_type"], [2, 1, 1, "_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE", "cudaq::qspan"], [2, 2, 1, "_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE", "cudaq::qspan::Levels"], [2, 2, 1, "_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE", "cudaq::qspan::N"], [2, 1, 1, "_CPPv4N5cudaq16quantum_platformE", "cudaq::quantum_platform"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform11clear_shotsEv", "cudaq::quantum_platform::clear_shots"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform12connectivityEv", "cudaq::quantum_platform::connectivity"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask", "cudaq::quantum_platform::enqueueAsyncTask"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE", "cudaq::quantum_platform::enqueueAsyncTask"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE", "cudaq::quantum_platform::enqueueAsyncTask::f"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask", "cudaq::quantum_platform::enqueueAsyncTask::qpu_id"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE", "cudaq::quantum_platform::enqueueAsyncTask::qpu_id"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask", "cudaq::quantum_platform::enqueueAsyncTask::t"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform12getLogStreamEv", "cudaq::quantum_platform::getLogStream"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform15get_current_qpuEv", "cudaq::quantum_platform::get_current_qpu"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform12get_exec_ctxEv", "cudaq::quantum_platform::get_exec_ctx"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform14get_num_qubitsENSt6size_tE", "cudaq::quantum_platform::get_num_qubits"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform14get_num_qubitsEv", "cudaq::quantum_platform::get_num_qubits"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform14get_num_qubitsENSt6size_tE", "cudaq::quantum_platform::get_num_qubits::qpu_id"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform23get_remote_capabilitiesEKNSt6size_tE", "cudaq::quantum_platform::get_remote_capabilities"], [2, 4, 1, "_CPPv4NK5cudaq16quantum_platform23get_remote_capabilitiesEKNSt6size_tE", "cudaq::quantum_platform::get_remote_capabilities::qpuId"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform9get_shotsEv", "cudaq::quantum_platform::get_shots"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform11is_emulatedEKNSt6size_tE", "cudaq::quantum_platform::is_emulated"], [2, 4, 1, "_CPPv4NK5cudaq16quantum_platform11is_emulatedEKNSt6size_tE", "cudaq::quantum_platform::is_emulated::qpuId"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform9is_remoteEKNSt6size_tE", "cudaq::quantum_platform::is_remote"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9is_remoteEKNSt6size_tE", "cudaq::quantum_platform::is_remote::qpuId"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform12is_simulatorEKNSt6size_tE", "cudaq::quantum_platform::is_simulator"], [2, 4, 1, "_CPPv4NK5cudaq16quantum_platform12is_simulatorEKNSt6size_tE", "cudaq::quantum_platform::is_simulator::qpu_id"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::H"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::gradient"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::kernelArgs"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::kernelName"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::n_params"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::optimizer"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE", "cudaq::quantum_platform::launchVQE::shots"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform14list_platformsEv", "cudaq::quantum_platform::list_platforms"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform4nameEv", "cudaq::quantum_platform::name"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform8num_qpusEv", "cudaq::quantum_platform::num_qpus"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform15onRandomSeedSetENSt6size_tE", "cudaq::quantum_platform::onRandomSeedSet"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform15onRandomSeedSetENSt6size_tE", "cudaq::quantum_platform::onRandomSeedSet::seed"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform14resetLogStreamEv", "cudaq::quantum_platform::resetLogStream"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform14reset_exec_ctxENSt6size_tE", "cudaq::quantum_platform::reset_exec_ctx"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform14reset_exec_ctxENSt6size_tE", "cudaq::quantum_platform::reset_exec_ctx::qpu_id"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform11reset_noiseEv", "cudaq::quantum_platform::reset_noise"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform12setLogStreamERNSt7ostreamE", "cudaq::quantum_platform::setLogStream"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform12setLogStreamERNSt7ostreamE", "cudaq::quantum_platform::setLogStream::logStream"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform16setTargetBackendERKNSt6stringE", "cudaq::quantum_platform::setTargetBackend"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform16setTargetBackendERKNSt6stringE", "cudaq::quantum_platform::setTargetBackend::name"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform15set_current_qpuEKNSt6size_tE", "cudaq::quantum_platform::set_current_qpu"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform15set_current_qpuEKNSt6size_tE", "cudaq::quantum_platform::set_current_qpu::device_id"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE", "cudaq::quantum_platform::set_exec_ctx"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE", "cudaq::quantum_platform::set_exec_ctx::ctx"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE", "cudaq::quantum_platform::set_exec_ctx::qpu_id"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform9set_noiseEPK11noise_model", "cudaq::quantum_platform::set_noise"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9set_noiseEPK11noise_model", "cudaq::quantum_platform::set_noise::model"], [2, 3, 1, "_CPPv4N5cudaq16quantum_platform9set_shotsEi", "cudaq::quantum_platform::set_shots"], [2, 4, 1, "_CPPv4N5cudaq16quantum_platform9set_shotsEi", "cudaq::quantum_platform::set_shots::numShots"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform29supports_conditional_feedbackEKNSt6size_tE", "cudaq::quantum_platform::supports_conditional_feedback"], [2, 4, 1, "_CPPv4NK5cudaq16quantum_platform29supports_conditional_feedbackEKNSt6size_tE", "cudaq::quantum_platform::supports_conditional_feedback::qpu_id"], [2, 3, 1, "_CPPv4NK5cudaq16quantum_platform26supports_task_distributionEv", "cudaq::quantum_platform::supports_task_distribution"], [2, 0, 1, "_CPPv4N5cudaq5qubitE", "cudaq::qubit"], [2, 1, 1, "_CPPv4I_NSt6size_tEEN5cudaq5quditE", "cudaq::qudit"], [2, 2, 1, "_CPPv4I_NSt6size_tEEN5cudaq5quditE", "cudaq::qudit::Levels"], [2, 3, 1, "_CPPv4N5cudaq5qudit5quditEv", "cudaq::qudit::qudit"], [2, 1, 1, "_CPPv4I_NSt6size_tEEN5cudaq7qvectorE", "cudaq::qvector"], [2, 2, 1, "_CPPv4I_NSt6size_tEEN5cudaq7qvectorE", "cudaq::qvector::Levels"], [2, 3, 1, "_CPPv4N5cudaq7qvector4backENSt6size_tE", "cudaq::qvector::back"], [2, 3, 1, "_CPPv4N5cudaq7qvector4backEv", "cudaq::qvector::back"], [2, 4, 1, "_CPPv4N5cudaq7qvector4backENSt6size_tE", "cudaq::qvector::back::count"], [2, 3, 1, "_CPPv4N5cudaq7qvector5beginEv", "cudaq::qvector::begin"], [2, 3, 1, "_CPPv4N5cudaq7qvector5clearEv", "cudaq::qvector::clear"], [2, 3, 1, "_CPPv4N5cudaq7qvector3endEv", "cudaq::qvector::end"], [2, 3, 1, "_CPPv4N5cudaq7qvector5frontENSt6size_tE", "cudaq::qvector::front"], [2, 3, 1, "_CPPv4N5cudaq7qvector5frontEv", "cudaq::qvector::front"], [2, 4, 1, "_CPPv4N5cudaq7qvector5frontENSt6size_tE", "cudaq::qvector::front::count"], [2, 3, 1, "_CPPv4N5cudaq7qvectoraSERK7qvector", "cudaq::qvector::operator="], [2, 3, 1, "_CPPv4N5cudaq7qvectorixEKNSt6size_tE", "cudaq::qvector::operator[]"], [2, 4, 1, "_CPPv4N5cudaq7qvectorixEKNSt6size_tE", "cudaq::qvector::operator[]::idx"], [2, 3, 1, "_CPPv4N5cudaq7qvector7qvectorENSt6size_tE", "cudaq::qvector::qvector"], [2, 3, 1, "_CPPv4N5cudaq7qvector7qvectorERK5state", "cudaq::qvector::qvector"], [2, 3, 1, "_CPPv4N5cudaq7qvector7qvectorERK7qvector", "cudaq::qvector::qvector"], [2, 3, 1, "_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb", "cudaq::qvector::qvector"], [2, 3, 1, "_CPPv4N5cudaq7qvector7qvectorERR7qvector", "cudaq::qvector::qvector"], [2, 4, 1, "_CPPv4N5cudaq7qvector7qvectorENSt6size_tE", "cudaq::qvector::qvector::size"], [2, 4, 1, "_CPPv4N5cudaq7qvector7qvectorERK5state", "cudaq::qvector::qvector::state"], [2, 4, 1, "_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb", "cudaq::qvector::qvector::validate"], [2, 4, 1, "_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb", "cudaq::qvector::qvector::vector"], [2, 3, 1, "_CPPv4NK5cudaq7qvector4sizeEv", "cudaq::qvector::size"], [2, 3, 1, "_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE", "cudaq::qvector::slice"], [2, 4, 1, "_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE", "cudaq::qvector::slice::size"], [2, 4, 1, "_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE", "cudaq::qvector::slice::start"], [2, 0, 1, "_CPPv4N5cudaq7qvector10value_typeE", "cudaq::qvector::value_type"], [2, 1, 1, "_CPPv4I_NSt6size_tEEN5cudaq5qviewE", "cudaq::qview"], [2, 2, 1, "_CPPv4I_NSt6size_tEEN5cudaq5qviewE", "cudaq::qview::Levels"], [2, 0, 1, "_CPPv4N5cudaq5qview10value_typeE", "cudaq::qview::value_type"], [2, 3, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType", "cudaq::range"], [2, 3, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType", "cudaq::range"], [2, 3, 1, "_CPPv4N5cudaq5rangeENSt6size_tE", "cudaq::range"], [2, 2, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType", "cudaq::range::ElementType"], [2, 2, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType", "cudaq::range::ElementType"], [2, 4, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType", "cudaq::range::N"], [2, 4, 1, "_CPPv4N5cudaq5rangeENSt6size_tE", "cudaq::range::N"], [2, 4, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType", "cudaq::range::start"], [2, 4, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType", "cudaq::range::step"], [2, 4, 1, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType", "cudaq::range::stop"], [2, 0, 1, "_CPPv4N5cudaq4realE", "cudaq::real"], [2, 0, 1, "_CPPv4N5cudaq8registryE", "cudaq::registry"], [2, 1, 1, "_CPPv4I0EN5cudaq8registry14RegisteredTypeE", "cudaq::registry::RegisteredType"], [2, 2, 1, "_CPPv4I0EN5cudaq8registry14RegisteredTypeE", "cudaq::registry::RegisteredType::T"], [2, 1, 1, "_CPPv4N5cudaq13sample_resultE", "cudaq::sample_result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result6appendER15ExecutionResult", "cudaq::sample_result::append"], [2, 4, 1, "_CPPv4N5cudaq13sample_result6appendER15ExecutionResult", "cudaq::sample_result::append::result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result5beginEv", "cudaq::sample_result::begin"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result5beginEv", "cudaq::sample_result::begin"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result6cbeginEv", "cudaq::sample_result::cbegin"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result4cendEv", "cudaq::sample_result::cend"], [2, 3, 1, "_CPPv4N5cudaq13sample_result5clearEv", "cudaq::sample_result::clear"], [2, 3, 1, "_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE", "cudaq::sample_result::count"], [2, 4, 1, "_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE", "cudaq::sample_result::count::bitString"], [2, 4, 1, "_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE", "cudaq::sample_result::count::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_result11deserializeERNSt6vectorINSt6size_tEEE", "cudaq::sample_result::deserialize"], [2, 4, 1, "_CPPv4N5cudaq13sample_result11deserializeERNSt6vectorINSt6size_tEEE", "cudaq::sample_result::deserialize::data"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result4dumpERNSt7ostreamE", "cudaq::sample_result::dump"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result4dumpEv", "cudaq::sample_result::dump"], [2, 4, 1, "_CPPv4NK5cudaq13sample_result4dumpERNSt7ostreamE", "cudaq::sample_result::dump::os"], [2, 3, 1, "_CPPv4N5cudaq13sample_result3endEv", "cudaq::sample_result::end"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result3endEv", "cudaq::sample_result::end"], [2, 3, 1, "_CPPv4N5cudaq13sample_result9exp_val_zEKNSt11string_viewE", "cudaq::sample_result::exp_val_z"], [2, 4, 1, "_CPPv4N5cudaq13sample_result9exp_val_zEKNSt11string_viewE", "cudaq::sample_result::exp_val_z::registerName"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result11expectationEKNSt11string_viewE", "cudaq::sample_result::expectation"], [2, 4, 1, "_CPPv4NK5cudaq13sample_result11expectationEKNSt11string_viewE", "cudaq::sample_result::expectation::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::get_marginal"], [2, 3, 1, "_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::get_marginal"], [2, 4, 1, "_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::get_marginal::marginalIndices"], [2, 4, 1, "_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::get_marginal::marginalIndices"], [2, 4, 1, "_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::get_marginal::registerName"], [2, 4, 1, "_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::get_marginal::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_result15has_even_parityENSt11string_viewE", "cudaq::sample_result::has_even_parity"], [2, 4, 1, "_CPPv4N5cudaq13sample_result15has_even_parityENSt11string_viewE", "cudaq::sample_result::has_even_parity::bitString"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result15has_expectationEKNSt11string_viewE", "cudaq::sample_result::has_expectation"], [2, 4, 1, "_CPPv4NK5cudaq13sample_result15has_expectationEKNSt11string_viewE", "cudaq::sample_result::has_expectation::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13most_probableEKNSt11string_viewE", "cudaq::sample_result::most_probable"], [2, 4, 1, "_CPPv4N5cudaq13sample_result13most_probableEKNSt11string_viewE", "cudaq::sample_result::most_probable::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_resultpLERK13sample_result", "cudaq::sample_result::operator+="], [2, 4, 1, "_CPPv4N5cudaq13sample_resultpLERK13sample_result", "cudaq::sample_result::operator+=::other"], [2, 3, 1, "_CPPv4N5cudaq13sample_resultaSER13sample_result", "cudaq::sample_result::operator="], [2, 4, 1, "_CPPv4N5cudaq13sample_resultaSER13sample_result", "cudaq::sample_result::operator=::counts"], [2, 3, 1, "_CPPv4NK5cudaq13sample_resulteqERK13sample_result", "cudaq::sample_result::operator=="], [2, 4, 1, "_CPPv4NK5cudaq13sample_resulteqERK13sample_result", "cudaq::sample_result::operator==::counts"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE", "cudaq::sample_result::probability"], [2, 4, 1, "_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE", "cudaq::sample_result::probability::bitString"], [2, 4, 1, "_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE", "cudaq::sample_result::probability::registerName"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result14register_namesEv", "cudaq::sample_result::register_names"], [2, 3, 1, "_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::reorder"], [2, 4, 1, "_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::reorder::index"], [2, 4, 1, "_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE", "cudaq::sample_result::reorder::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13sample_resultER15ExecutionResult", "cudaq::sample_result::sample_result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13sample_resultERK13sample_result", "cudaq::sample_result::sample_result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13sample_resultERNSt6vectorI15ExecutionResultEE", "cudaq::sample_result::sample_result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13sample_resultERR15ExecutionResult", "cudaq::sample_result::sample_result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE", "cudaq::sample_result::sample_result"], [2, 3, 1, "_CPPv4N5cudaq13sample_result13sample_resultEv", "cudaq::sample_result::sample_result"], [2, 4, 1, "_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE", "cudaq::sample_result::sample_result::preComputedExp"], [2, 4, 1, "_CPPv4N5cudaq13sample_result13sample_resultER15ExecutionResult", "cudaq::sample_result::sample_result::result"], [2, 4, 1, "_CPPv4N5cudaq13sample_result13sample_resultERR15ExecutionResult", "cudaq::sample_result::sample_result::result"], [2, 4, 1, "_CPPv4N5cudaq13sample_result13sample_resultERNSt6vectorI15ExecutionResultEE", "cudaq::sample_result::sample_result::results"], [2, 4, 1, "_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE", "cudaq::sample_result::sample_result::results"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result9serializeEv", "cudaq::sample_result::serialize"], [2, 3, 1, "_CPPv4N5cudaq13sample_result4sizeEKNSt11string_viewE", "cudaq::sample_result::size"], [2, 4, 1, "_CPPv4N5cudaq13sample_result4sizeEKNSt11string_viewE", "cudaq::sample_result::size::registerName"], [2, 3, 1, "_CPPv4NK5cudaq13sample_result6to_mapEKNSt11string_viewE", "cudaq::sample_result::to_map"], [2, 4, 1, "_CPPv4NK5cudaq13sample_result6to_mapEKNSt11string_viewE", "cudaq::sample_result::to_map::registerName"], [2, 3, 1, "_CPPv4N5cudaq13sample_resultD0Ev", "cudaq::sample_result::~sample_result"], [2, 3, 1, "_CPPv4N5cudaq9set_noiseERKN5cudaq11noise_modelE", "cudaq::set_noise"], [2, 4, 1, "_CPPv4N5cudaq9set_noiseERKN5cudaq11noise_modelE", "cudaq::set_noise::model"], [2, 3, 1, "_CPPv4N5cudaq15set_random_seedENSt6size_tE", "cudaq::set_random_seed"], [2, 4, 1, "_CPPv4N5cudaq15set_random_seedENSt6size_tE", "cudaq::set_random_seed::seed"], [2, 6, 1, "_CPPv4N5cudaq20simulation_precisionE", "cudaq::simulation_precision"], [2, 7, 1, "_CPPv4N5cudaq20simulation_precision4fp32E", "cudaq::simulation_precision::fp32"], [2, 7, 1, "_CPPv4N5cudaq20simulation_precision4fp64E", "cudaq::simulation_precision::fp64"], [2, 1, 1, "_CPPv4N5cudaq7spin_opE", "cudaq::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op5beginEv", "cudaq::spin_op::begin"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op5beginEv", "cudaq::spin_op::begin"], [2, 0, 1, "_CPPv4N5cudaq7spin_op12csr_spmatrixE", "cudaq::spin_op::csr_spmatrix"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op16distribute_termsENSt6size_tE", "cudaq::spin_op::distribute_terms"], [2, 4, 1, "_CPPv4NK5cudaq7spin_op16distribute_termsENSt6size_tE", "cudaq::spin_op::distribute_terms::numChunks"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op4dumpEv", "cudaq::spin_op::dump"], [2, 3, 1, "_CPPv4N5cudaq7spin_op3endEv", "cudaq::spin_op::end"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op3endEv", "cudaq::spin_op::end"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op14for_each_pauliERRNSt8functionIFv5pauliNSt6size_tEEEE", "cudaq::spin_op::for_each_pauli"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op13for_each_termERRNSt8functionIFvR7spin_opEEE", "cudaq::spin_op::for_each_term"], [2, 3, 1, "_CPPv4N5cudaq7spin_op9from_wordERKNSt6stringE", "cudaq::spin_op::from_word"], [2, 4, 1, "_CPPv4N5cudaq7spin_op9from_wordERKNSt6stringE", "cudaq::spin_op::from_word::pauliWord"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op21getDataRepresentationEv", "cudaq::spin_op::getDataRepresentation"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op12getDataTupleEv", "cudaq::spin_op::getDataTuple"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op15get_coefficientEv", "cudaq::spin_op::get_coefficient"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op12get_raw_dataEv", "cudaq::spin_op::get_raw_data"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op11is_identityEv", "cudaq::spin_op::is_identity"], [2, 1, 1, "_CPPv4I0EN5cudaq7spin_op8iteratorE", "cudaq::spin_op::iterator"], [2, 2, 1, "_CPPv4I0EN5cudaq7spin_op8iteratorE", "cudaq::spin_op::iterator::QualifiedSpinOp"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op10num_qubitsEv", "cudaq::spin_op::num_qubits"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op9num_termsEv", "cudaq::spin_op::num_terms"], [2, 3, 1, "_CPPv4N5cudaq7spin_opmLEKNSt7complexIdEE", "cudaq::spin_op::operator*="], [2, 3, 1, "_CPPv4N5cudaq7spin_opmLEKd", "cudaq::spin_op::operator*="], [2, 3, 1, "_CPPv4N5cudaq7spin_opmLERK7spin_op", "cudaq::spin_op::operator*="], [2, 4, 1, "_CPPv4N5cudaq7spin_opmLEKNSt7complexIdEE", "cudaq::spin_op::operator*=::v"], [2, 4, 1, "_CPPv4N5cudaq7spin_opmLEKd", "cudaq::spin_op::operator*=::v"], [2, 4, 1, "_CPPv4N5cudaq7spin_opmLERK7spin_op", "cudaq::spin_op::operator*=::v"], [2, 3, 1, "_CPPv4N5cudaq7spin_oppLERK7spin_op", "cudaq::spin_op::operator+="], [2, 4, 1, "_CPPv4N5cudaq7spin_oppLERK7spin_op", "cudaq::spin_op::operator+=::v"], [2, 3, 1, "_CPPv4N5cudaq7spin_opmIERK7spin_op", "cudaq::spin_op::operator-="], [2, 4, 1, "_CPPv4N5cudaq7spin_opmIERK7spin_op", "cudaq::spin_op::operator-=::v"], [2, 3, 1, "_CPPv4N5cudaq7spin_opaSERK7spin_op", "cudaq::spin_op::operator="], [2, 3, 1, "_CPPv4NK5cudaq7spin_opeqERK7spin_op", "cudaq::spin_op::operator=="], [2, 4, 1, "_CPPv4NK5cudaq7spin_opeqERK7spin_op", "cudaq::spin_op::operator==::v"], [2, 3, 1, "_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj", "cudaq::spin_op::random"], [2, 4, 1, "_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj", "cudaq::spin_op::random::nQubits"], [2, 4, 1, "_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj", "cudaq::spin_op::random::nTerms"], [2, 4, 1, "_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj", "cudaq::spin_op::random::seed"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opENSt6size_tE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERK7spin_op", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt13unordered_mapI12spin_op_termNSt7complexIdEEEE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt4pairIK12spin_op_termNSt7complexIdEEEE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opERNSt4pairIK12spin_op_termNSt7complexIdEEEE", "cudaq::spin_op::spin_op"], [2, 3, 1, "_CPPv4N5cudaq7spin_op7spin_opEv", "cudaq::spin_op::spin_op"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt13unordered_mapI12spin_op_termNSt7complexIdEEEE", "cudaq::spin_op::spin_op::_terms"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE", "cudaq::spin_op::spin_op::bsf"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE", "cudaq::spin_op::spin_op::coeff"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE", "cudaq::spin_op::spin_op::coeff"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE", "cudaq::spin_op::spin_op::coeffs"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE", "cudaq::spin_op::spin_op::data_rep"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE", "cudaq::spin_op::spin_op::id"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE", "cudaq::spin_op::spin_op::nQubits"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opENSt6size_tE", "cudaq::spin_op::spin_op::numQubits"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERK7spin_op", "cudaq::spin_op::spin_op::o"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE", "cudaq::spin_op::spin_op::term"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERKNSt4pairIK12spin_op_termNSt7complexIdEEEE", "cudaq::spin_op::spin_op::termData"], [2, 4, 1, "_CPPv4N5cudaq7spin_op7spin_opERNSt4pairIK12spin_op_termNSt7complexIdEEEE", "cudaq::spin_op::spin_op::termData"], [2, 0, 1, "_CPPv4N5cudaq7spin_op12spin_op_termE", "cudaq::spin_op::spin_op_term"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op9to_matrixEv", "cudaq::spin_op::to_matrix"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op16to_sparse_matrixEv", "cudaq::spin_op::to_sparse_matrix"], [2, 3, 1, "_CPPv4NK5cudaq7spin_op9to_stringEb", "cudaq::spin_op::to_string"], [2, 4, 1, "_CPPv4NK5cudaq7spin_op9to_stringEb", "cudaq::spin_op::to_string::printCoefficients"], [2, 3, 1, "_CPPv4N5cudaq7spin_opD0Ev", "cudaq::spin_op::~spin_op"], [2, 1, 1, "_CPPv4N5cudaq5stateE", "cudaq::state"], [2, 3, 1, "_CPPv4N5cudaq5state9amplitudeERKNSt6vectorIiEE", "cudaq::state::amplitude"], [2, 4, 1, "_CPPv4N5cudaq5state9amplitudeERKNSt6vectorIiEE", "cudaq::state::amplitude::basisState"], [2, 3, 1, "_CPPv4N5cudaq5state10amplitudesERKNSt6vectorINSt6vectorIiEEEE", "cudaq::state::amplitudes"], [2, 4, 1, "_CPPv4N5cudaq5state10amplitudesERKNSt6vectorINSt6vectorIiEEEE", "cudaq::state::amplitudes::basisStates"], [2, 3, 1, "_CPPv4NK5cudaq5state4dumpERNSt7ostreamE", "cudaq::state::dump"], [2, 3, 1, "_CPPv4NK5cudaq5state4dumpEv", "cudaq::state::dump"], [2, 4, 1, "_CPPv4NK5cudaq5state4dumpERNSt7ostreamE", "cudaq::state::dump::os"], [2, 3, 1, "_CPPv4N5cudaq5state9from_dataERK10state_data", "cudaq::state::from_data"], [2, 4, 1, "_CPPv4N5cudaq5state9from_dataERK10state_data", "cudaq::state::from_data::data"], [2, 3, 1, "_CPPv4NK5cudaq5state14get_num_qubitsEv", "cudaq::state::get_num_qubits"], [2, 3, 1, "_CPPv4NK5cudaq5state15get_num_tensorsEv", "cudaq::state::get_num_tensors"], [2, 3, 1, "_CPPv4NK5cudaq5state13get_precisionEv", "cudaq::state::get_precision"], [2, 3, 1, "_CPPv4NK5cudaq5state10get_tensorENSt6size_tE", "cudaq::state::get_tensor"], [2, 4, 1, "_CPPv4NK5cudaq5state10get_tensorENSt6size_tE", "cudaq::state::get_tensor::tensorIdx"], [2, 3, 1, "_CPPv4NK5cudaq5state11get_tensorsEv", "cudaq::state::get_tensors"], [2, 3, 1, "_CPPv4NK5cudaq5state9is_on_gpuEv", "cudaq::state::is_on_gpu"], [2, 3, 1, "_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE", "cudaq::state::operator()"], [2, 3, 1, "_CPPv4NK5cudaq5stateclERKNSt16initializer_listINSt6size_tEEENSt6size_tE", "cudaq::state::operator()"], [2, 4, 1, "_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE", "cudaq::state::operator()::idx"], [2, 4, 1, "_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE", "cudaq::state::operator()::jdx"], [2, 4, 1, "_CPPv4NK5cudaq5stateclERKNSt16initializer_listINSt6size_tEEENSt6size_tE", "cudaq::state::operator()::tensorIdx"], [2, 3, 1, "_CPPv4N5cudaq5stateaSERR5state", "cudaq::state::operator="], [2, 4, 1, "_CPPv4N5cudaq5stateaSERR5state", "cudaq::state::operator=::other"], [2, 3, 1, "_CPPv4NK5cudaq5stateixENSt6size_tE", "cudaq::state::operator[]"], [2, 4, 1, "_CPPv4NK5cudaq5stateixENSt6size_tE", "cudaq::state::operator[]::idx"], [2, 3, 1, "_CPPv4N5cudaq5state7overlapERK5state", "cudaq::state::overlap"], [2, 4, 1, "_CPPv4N5cudaq5state7overlapERK5state", "cudaq::state::overlap::other"], [2, 3, 1, "_CPPv4N5cudaq5state5stateEP15SimulationState", "cudaq::state::state"], [2, 3, 1, "_CPPv4N5cudaq5state5stateERK5state", "cudaq::state::state"], [2, 4, 1, "_CPPv4N5cudaq5state5stateERK5state", "cudaq::state::state::other"], [2, 4, 1, "_CPPv4N5cudaq5state5stateEP15SimulationState", "cudaq::state::state::ptrToOwn"], [2, 3, 1, "_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE", "cudaq::state::to_host"], [2, 2, 1, "_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE", "cudaq::state::to_host::ScalarType"], [2, 4, 1, "_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE", "cudaq::state::to_host::hostPtr"], [2, 4, 1, "_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE", "cudaq::state::to_host::numElements"], [2, 0, 1, "_CPPv4N5cudaq10state_dataE", "cudaq::state_data"], [2, 0, 1, "_CPPv4N5cudaq6tensorE", "cudaq::tensor"], [2, 3, 1, "_CPPv4N5cudaq11unset_noiseEv", "cudaq::unset_noise"], [2, 1, 1, "_CPPv4N5nvqir18MPSSimulationStateE", "nvqir::MPSSimulationState"], [2, 1, 1, "_CPPv4N5nvqir24TensorNetSimulationStateE", "nvqir::TensorNetSimulationState"], [3, 8, 0, "-", "cudaq"]], "cudaq": [[3, 9, 1, "", "AmplitudeDampingChannel"], [3, 9, 1, "", "AsyncObserveResult"], [3, 9, 1, "", "AsyncSampleResult"], [3, 9, 1, "", "AsyncStateResult"], [3, 9, 1, "", "BitFlipChannel"], [3, 9, 1, "", "ComplexMatrix"], [3, 9, 1, "", "DepolarizationChannel"], [3, 11, 1, "", "Kernel"], [3, 9, 1, "", "KrausChannel"], [3, 9, 1, "", "KrausOperator"], [3, 9, 1, "", "NoiseModel"], [3, 9, 1, "", "ObserveResult"], [3, 9, 1, "", "OptimizationResult"], [3, 9, 1, "", "PhaseFlipChannel"], [3, 9, 1, "", "PyKernel"], [3, 9, 1, "", "PyKernelDecorator"], [3, 9, 1, "", "QuakeValue"], [3, 9, 1, "", "SampleResult"], [3, 9, 1, "", "SimulationPrecision"], [3, 9, 1, "", "SpinOperator"], [3, 9, 1, "", "State"], [3, 9, 1, "", "Target"], [3, 9, 1, "", "Tensor"], [3, 13, 1, "", "draw"], [3, 13, 1, "", "get_state"], [3, 13, 1, "", "get_state_async"], [3, 13, 1, "", "get_target"], [3, 13, 1, "", "get_targets"], [3, 13, 1, "", "has_target"], [3, 10, 1, "", "initialize_cudaq"], [3, 13, 1, "", "kernel"], [3, 13, 1, "", "make_kernel"], [3, 10, 1, "", "num_available_gpus"], [3, 13, 1, "", "observe"], [3, 13, 1, "", "observe_async"], [3, 11, 1, "", "qreg"], [3, 9, 1, "", "qubit"], [3, 9, 1, "", "qvector"], [3, 13, 1, "", "reset_target"], [3, 13, 1, "", "sample"], [3, 13, 1, "", "sample_async"], [3, 13, 1, "", "set_noise"], [3, 10, 1, "", "set_random_seed"], [3, 13, 1, "", "set_target"], [3, 13, 1, "", "translate"], [3, 13, 1, "", "unset_noise"], [3, 13, 1, "", "vqe"]], "cudaq.AmplitudeDampingChannel": [[3, 10, 1, "", "__init__"]], "cudaq.AsyncObserveResult": [[3, 10, 1, "", "get"]], "cudaq.AsyncSampleResult": [[3, 10, 1, "", "get"]], "cudaq.AsyncStateResult": [[3, 10, 1, "", "get"]], "cudaq.BitFlipChannel": [[3, 10, 1, "", "__init__"]], "cudaq.ComplexMatrix": [[3, 10, 1, "", "__getitem__"], [3, 10, 1, "", "__str__"], [3, 10, 1, "", "minimal_eigenvalue"]], "cudaq.DepolarizationChannel": [[3, 10, 1, "", "__init__"]], "cudaq.KrausChannel": [[3, 10, 1, "", "__getitem__"], [3, 10, 1, "", "append"]], "cudaq.KrausOperator": [[3, 12, 1, "", "col_count"], [3, 12, 1, "", "row_count"]], "cudaq.NoiseModel": [[3, 10, 1, "", "__init__"], [3, 10, 1, "", "add_all_qubit_channel"], [3, 10, 1, "", "add_channel"], [3, 10, 1, "", "get_channels"]], "cudaq.ObserveResult": [[3, 10, 1, "", "counts"], [3, 10, 1, "", "dump"], [3, 10, 1, "", "expectation"], [3, 10, 1, "", "expectation_z"], [3, 10, 1, "", "get_spin"]], "cudaq.PhaseFlipChannel": [[3, 10, 1, "", "__init__"]], "cudaq.PyKernel": [[3, 11, 1, "", "argument_count"], [3, 11, 1, "", "arguments"], [3, 11, 1, "", "name"]], "cudaq.PyKernelDecorator": [[3, 10, 1, "", "__call__"], [3, 10, 1, "", "__str__"], [3, 10, 1, "", "compile"], [3, 10, 1, "", "from_json"], [3, 10, 1, "", "to_json"], [3, 10, 1, "", "type_to_str"]], "cudaq.QuakeValue": [[3, 10, 1, "", "__add__"], [3, 10, 1, "", "__getitem__"], [3, 10, 1, "", "__mul__"], [3, 10, 1, "", "__neg__"], [3, 10, 1, "", "__radd__"], [3, 10, 1, "", "__rmul__"], [3, 10, 1, "", "__rsub__"], [3, 10, 1, "", "__sub__"], [3, 10, 1, "", "slice"]], "cudaq.SampleResult": [[3, 10, 1, "", "__getitem__"], [3, 10, 1, "", "__iter__"], [3, 10, 1, "", "__len__"], [3, 10, 1, "", "clear"], [3, 10, 1, "", "count"], [3, 10, 1, "", "deserialize"], [3, 10, 1, "", "dump"], [3, 10, 1, "", "expectation"], [3, 10, 1, "", "expectation_z"], [3, 10, 1, "", "get_marginal_counts"], [3, 10, 1, "", "get_register_counts"], [3, 10, 1, "", "get_sequential_data"], [3, 10, 1, "", "items"], [3, 10, 1, "", "most_probable"], [3, 10, 1, "", "probability"], [3, 11, 1, "", "register_names"], [3, 10, 1, "", "serialize"], [3, 10, 1, "", "values"]], "cudaq.SimulationPrecision": [[3, 12, 1, "", "name"]], "cudaq.SpinOperator": [[3, 10, 1, "", "__add__"], [3, 10, 1, "", "__eq__"], [3, 10, 1, "", "__iter__"], [3, 10, 1, "", "__mul__"], [3, 10, 1, "", "__radd__"], [3, 10, 1, "", "__rmul__"], [3, 10, 1, "", "__rsub__"], [3, 10, 1, "", "__sub__"], [3, 10, 1, "", "distribute_terms"], [3, 10, 1, "", "dump"], [3, 10, 1, "", "for_each_pauli"], [3, 10, 1, "", "for_each_term"], [3, 10, 1, "", "from_json"], [3, 10, 1, "", "from_word"], [3, 10, 1, "", "get_coefficient"], [3, 10, 1, "", "get_qubit_count"], [3, 10, 1, "", "get_raw_data"], [3, 10, 1, "", "get_term_count"], [3, 10, 1, "", "is_identity"], [3, 10, 1, "", "random"], [3, 10, 1, "", "serialize"], [3, 10, 1, "", "to_json"], [3, 10, 1, "", "to_matrix"], [3, 10, 1, "", "to_sparse_matrix"], [3, 10, 1, "", "to_string"]], "cudaq.State": [[3, 10, 1, "", "amplitude"], [3, 10, 1, "", "amplitudes"], [3, 10, 1, "", "dump"], [3, 10, 1, "", "from_data"], [3, 10, 1, "", "getTensor"], [3, 10, 1, "", "getTensors"], [3, 10, 1, "", "is_on_gpu"], [3, 10, 1, "", "num_qubits"], [3, 10, 1, "", "overlap"]], "cudaq.Target": [[3, 12, 1, "", "description"], [3, 10, 1, "", "get_precision"], [3, 10, 1, "", "is_emulated"], [3, 10, 1, "", "is_remote"], [3, 12, 1, "", "name"], [3, 10, 1, "", "num_qpus"], [3, 12, 1, "", "platform"], [3, 12, 1, "", "simulator"]], "cudaq.gradients": [[3, 9, 1, "", "CentralDifference"], [3, 9, 1, "", "ForwardDifference"], [3, 9, 1, "", "ParameterShift"], [3, 9, 1, "", "gradient"]], "cudaq.gradients.CentralDifference": [[3, 10, 1, "", "compute"], [3, 10, 1, "", "from_json"], [3, 10, 1, "", "to_json"]], "cudaq.gradients.ForwardDifference": [[3, 10, 1, "", "compute"], [3, 10, 1, "", "from_json"], [3, 10, 1, "", "to_json"]], "cudaq.gradients.ParameterShift": [[3, 10, 1, "", "compute"], [3, 10, 1, "", "from_json"], [3, 10, 1, "", "to_json"]], "cudaq.mpi": [[3, 10, 1, "", "all_gather"], [3, 10, 1, "", "broadcast"], [3, 10, 1, "", "finalize"], [3, 10, 1, "", "initialize"], [3, 10, 1, "", "is_initialized"], [3, 10, 1, "", "num_ranks"], [3, 10, 1, "", "rank"]], "cudaq.optimizers": [[3, 9, 1, "", "COBYLA"], [3, 9, 1, "", "GradientDescent"], [3, 9, 1, "", "LBFGS"], [3, 9, 1, "", "NelderMead"], [3, 9, 1, "", "optimizer"]], "cudaq.optimizers.COBYLA": [[3, 10, 1, "", "from_json"], [3, 12, 1, "", "initial_parameters"], [3, 12, 1, "", "lower_bounds"], [3, 12, 1, "", "max_iterations"], [3, 10, 1, "", "optimize"], [3, 10, 1, "", "requires_gradients"], [3, 10, 1, "", "to_json"], [3, 12, 1, "", "upper_bounds"]], "cudaq.optimizers.GradientDescent": [[3, 10, 1, "", "from_json"], [3, 12, 1, "", "initial_parameters"], [3, 12, 1, "", "lower_bounds"], [3, 12, 1, "", "max_iterations"], [3, 10, 1, "", "optimize"], [3, 10, 1, "", "requires_gradients"], [3, 10, 1, "", "to_json"], [3, 12, 1, "", "upper_bounds"]], "cudaq.optimizers.LBFGS": [[3, 10, 1, "", "from_json"], [3, 12, 1, "", "initial_parameters"], [3, 12, 1, "", "lower_bounds"], [3, 12, 1, "", "max_iterations"], [3, 10, 1, "", "optimize"], [3, 10, 1, "", "requires_gradients"], [3, 10, 1, "", "to_json"], [3, 12, 1, "", "upper_bounds"]], "cudaq.optimizers.NelderMead": [[3, 10, 1, "", "from_json"], [3, 12, 1, "", "initial_parameters"], [3, 12, 1, "", "lower_bounds"], [3, 12, 1, "", "max_iterations"], [3, 10, 1, "", "optimize"], [3, 10, 1, "", "requires_gradients"], [3, 10, 1, "", "to_json"], [3, 12, 1, "", "upper_bounds"]], "cudaq.orca": [[3, 10, 1, "", "sample"]], "cudaq.spin": [[3, 13, 1, "", "i"], [3, 13, 1, "", "x"], [3, 13, 1, "", "y"], [3, 13, 1, "", "z"]]}, "objtypes": {"0": "cpp:type", "1": "cpp:class", "2": "cpp:templateParam", "3": "cpp:function", "4": "cpp:functionParam", "5": "cpp:member", "6": "cpp:enum", "7": "cpp:enumerator", "8": "py:module", "9": "py:class", "10": "py:method", "11": "py:attribute", "12": "py:property", "13": "py:function"}, "objnames": {"0": ["cpp", "type", "C++ type"], "1": ["cpp", "class", "C++ class"], "2": ["cpp", "templateParam", "C++ template parameter"], "3": ["cpp", "function", "C++ function"], "4": ["cpp", "functionParam", "C++ function parameter"], "5": ["cpp", "member", "C++ member"], "6": ["cpp", "enum", "C++ enum"], "7": ["cpp", "enumerator", "C++ enumerator"], "8": ["py", "module", "Python module"], "9": ["py", "class", "Python class"], "10": ["py", "method", "Python method"], "11": ["py", "attribute", "Python attribute"], "12": ["py", "property", "Python property"], "13": ["py", "function", "Python function"]}, "titleterms": {"code": [0, 67], "document": 0, "cuda": [0, 2, 3, 4, 7, 17, 19, 21, 22, 23, 24, 39, 40, 43, 44, 45, 46, 47, 51, 61, 62, 63, 64, 65, 67, 68, 69, 71, 72, 73, 74], "q": [0, 2, 3, 4, 7, 17, 19, 21, 22, 23, 24, 39, 40, 43, 44, 45, 46, 47, 51, 61, 62, 63, 64, 65, 67, 68, 69, 71, 72, 73, 74], "api": [0, 2, 3], "quantum": [1, 2, 4, 5, 6, 7, 9, 11, 15, 19, 24, 27, 28, 31, 32, 33, 34, 36, 41, 42, 53, 58, 59, 60], "oper": [1, 2, 31, 32], "unitari": [1, 17], "qubit": [1, 10, 16, 18, 31, 36], "x": 1, "y": 1, "z": 1, "h": 1, "r1": 1, "rx": 1, "ry": 1, "rz": 1, "": [1, 6, 9, 27, 64], "t": 1, "swap": 1, "u3": 1, "adjoint": 1, "control": [1, 25, 55], "measur": [1, 6, 59], "mz": 1, "mx": 1, "my": 1, "user": 1, "defin": 1, "custom": 1, "photon": 1, "qudit": [1, 36], "plu": 1, "phase_shift": 1, "beam_splitt": 1, "c": [2, 40, 65, 71], "common": [2, 33], "nois": [2, 16], "model": [2, 16, 17, 29], "kernel": [2, 3, 6, 17, 18, 26, 28, 42, 46], "builder": 2, "algorithm": [2, 5, 6, 9, 10, 24, 27, 58], "platform": [2, 34, 42], "util": 2, "namespac": [2, 30], "python": [3, 40, 65, 67], "program": [3, 27, 33, 45, 47], "construct": 3, "execut": [3, 41], "backend": [3, 39, 40, 41, 43], "configur": 3, "data": [3, 4], "type": [3, 36], "optim": [3, 19, 24, 58], "gradient": [3, 24], "noisi": [3, 13, 57], "simul": [3, 4, 13, 17, 20, 41, 42, 43, 48, 50, 57, 64, 67], "mpi": [3, 65, 67], "submodul": 3, "orca": [3, 40, 53], "divis": 4, "cluster": 4, "With": [4, 6], "coreset": 4, "us": [4, 10, 17, 19, 36, 53, 67, 69], "preprocess": 4, "function": [4, 7, 24], "qaoa": [4, 12, 14], "implement": 4, "scale": 4, "multi": [5, 10, 42, 43, 55, 56], "refer": [5, 10, 20], "krylov": 5, "h2": 5, "exampl": [5, 27, 51], "factor": 6, "integ": 6, "shor": 6, "solv": 6, "order": 6, "find": 6, "problem": 6, "classic": [6, 20], "invers": [6, 16], "fourier": [6, 15], "transform": [6, 15], "modular": 6, "exponenti": 6, "The": 6, "case": 6, "n": [6, 36], "21": 6, "5": 6, "4": 6, "determin": 6, "from": [6, 16, 40, 65, 71], "result": [6, 10], "phase": [6, 9, 27], "postscript": 6, "enhanc": 7, "auxiliari": 7, "field": 7, "mont": 7, "carlo": 7, "hamiltonian": [7, 56], "prepar": [7, 27], "vqe": [7, 20], "run": [7, 47], "afqmc": 7, "molecular": [7, 12], "trial": 7, "wave": 7, "setup": [7, 17], "paramet": [7, 27], "cost": 8, "minim": 8, "deutsch": 9, "xor": 9, "oplu": 9, "oracl": 9, "parallel": [9, 10, 42, 52, 56], "hadamard": 10, "test": 10, "applic": 10, "numer": 10, "observ": [10, 24, 47], "primit": [10, 24], "comput": [10, 33, 40, 52, 53, 59, 67], "expect": [10, 52], "valu": [10, 52], "ancilla": 10, "gpu": [10, 20, 41, 43, 47, 56, 67], "multipl": [10, 41, 52, 56], "hybrid": 11, "neural": 11, "network": [11, 43], "dock": 12, "via": [12, 67], "dc": 12, "max": 14, "cut": 14, "revisit": 15, "readout": 16, "error": 16, "mitig": 16, "confus": 16, "matrix": [16, 43], "singl": [16, 43], "k": 16, "local": [16, 67], "matric": 16, "full": 16, "compil": [17, 63, 71], "diffus": 17, "pipelin": 17, "load": 17, "convert": 17, "tensor": [17, 43], "evalu": 17, "gener": [17, 38], "circuit": [17, 35, 56, 64], "compar": 17, "choos": 17, "you": 17, "need": 17, "visual": 18, "variat": [19, 60], "eigensolv": [19, 60], "integr": [19, 70, 71], "third": [19, 71], "parti": [19, 71], "water": 20, "molecul": 20, "activ": 20, "space": 20, "cpu": [20, 43], "v": [20, 67], "A": 20, "ccsd": 20, "b": 20, "uccsd": 20, "content": [21, 44, 66], "releas": 22, "languag": 23, "specif": [23, 37], "cudaq": [24, 31, 32, 36], "sampl": [24, 27, 47], "deprec": [24, 36], "move": 24, "librari": [24, 65, 71], "flow": 25, "just": 26, "time": 26, "creation": 26, "hello": 27, "world": 27, "simpl": 27, "bell": 27, "state": [27, 42, 43, 59], "ghz": 27, "estim": 27, "deuteron": 27, "bind": 27, "energi": 27, "sweep": 27, "grover": 27, "iter": 27, "machin": 29, "standard": 30, "intrins": 31, "spin_op": 32, "pattern": 33, "action": [33, 64], "uncomput": 33, "sub": 35, "synthesi": [35, 55], "level": 36, "contain": [36, 67], "qview": 36, "2": 36, "qvector": 36, "qarrai": 36, "qspan": 36, "instead": 36, "qreg": 36, "quak": 38, "dialect": 38, "introduct": [38, 54, 67], "motiv": 38, "target": [39, 56], "hardwar": [40, 53], "ionq": [40, 53], "set": 40, "credenti": 40, "submiss": 40, "iqm": [40, 53], "oqc": [40, 53], "quantinuum": [40, 53], "nvidia": [41, 42], "cloud": [41, 67], "quick": [41, 72], "start": [41, 67, 72], "select": 41, "qpu": 41, "asynchron": 41, "faq": 41, "processor": [42, 52, 56], "mqpu": 42, "distribut": [42, 67], "mode": [42, 43], "remot": [42, 67], "support": [42, 43, 65, 67], "argument": 42, "serial": 42, "access": [42, 67], "vector": 43, "featur": 43, "environ": 43, "variabl": 43, "option": 43, "node": 43, "addit": [43, 67], "openmp": 43, "onli": 43, "clifford": 43, "product": 43, "default": 43, "basic": 44, "build": [45, 65], "your": [45, 47, 63, 72], "first": [45, 47], "what": 46, "i": 46, "troubleshoot": 48, "debug": 48, "verbos": 48, "output": 48, "bernstein": 49, "vazirani": 49, "cuquantum": 50, "across": [52, 56], "provid": 53, "workflow": 56, "avail": 56, "batch": 56, "term": 56, "approxim": 58, "101": 59, "gate": 59, "work": 61, "ir": 61, "extend": [62, 64], "creat": 63, "own": 63, "pass": 63, "new": 64, "circuitsimul": 64, "requir": [64, 67], "subtyp": 64, "method": 64, "overrid": 64, "let": 64, "see": 64, "thi": 64, "instal": [65, 66, 67, 72], "sourc": 65, "prerequisit": 65, "depend": [65, 67], "toolchain": [65, 71], "host": [65, 67], "runtim": 65, "guid": 66, "docker": 67, "singular": 67, "wheel": 67, "pre": 67, "built": 67, "binari": [67, 71], "develop": 67, "connect": 67, "tunnel": 67, "ssh": 67, "dgx": 67, "get": 67, "jupyterlab": 67, "tool": [67, 70], "pypi": 67, "In": 67, "imag": 67, "updat": 67, "compat": 67, "system": 67, "next": 67, "step": 67, "cmake": 68, "project": 69, "other": 70, "softwar": 70, "call": 71, "an": 71, "interfac": 71, "between": 71, "differ": 71, "valid": 72, "tutori": 73, "version": 74}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.intersphinx": 1, "nbsphinx": 4, "sphinx": 57}, "alltitles": {"Common Quantum Programming Patterns": [[33, "common-quantum-programming-patterns"]], "Compute-Action-Uncompute": [[33, "compute-action-uncompute"]], "Example Programs": [[27, "example-programs"]], "Hello World - Simple Bell State": [[27, "hello-world-simple-bell-state"]], "GHZ State Preparation and Sampling": [[27, "ghz-state-preparation-and-sampling"]], "Quantum Phase Estimation": [[27, "quantum-phase-estimation"]], "Deuteron Binding Energy Parameter Sweep": [[27, "deuteron-binding-energy-parameter-sweep"]], "Grover\u2019s Algorithm": [[27, "grover-s-algorithm"]], "Iterative Phase Estimation": [[27, "iterative-phase-estimation"]], "Machine Model": [[29, "machine-model"]], "Quantum Operators": [[32, "quantum-operators"]], "cudaq::spin_op": [[32, "cudaq-spin-op"]], "Namespace and Standard": [[30, "namespace-and-standard"]], "Sub-circuit Synthesis": [[35, "sub-circuit-synthesis"]], "Quantum Kernels": [[28, "quantum-kernels"]], "Quantum Platform": [[34, "quantum-platform"]], "Quantum Intrinsic Operations": [[31, "quantum-intrinsic-operations"]], "Operations on cudaq::qubit": [[31, "operations-on-cudaq-qubit"]], "Using Quantum Hardware Providers": [[53, "using-quantum-hardware-providers"]], "IonQ": [[53, "ionq"], [40, "ionq"]], "IQM": [[53, "iqm"], [40, "iqm"]], "OQC": [[53, "oqc"], [40, "oqc"]], "ORCA Computing": [[53, "orca-computing"], [40, "orca-computing"]], "Quantinuum": [[53, "quantinuum"], [40, "quantinuum"]], "Bernstein-Vazirani": [[49, "bernstein-vazirani"]], "Building your first CUDA-Q Program": [[45, "building-your-first-cuda-q-program"]], "Running your first CUDA-Q Program": [[47, "running-your-first-cuda-q-program"]], "Sample": [[47, "sample"]], "Observe": [[47, "observe"]], "Running on a GPU": [[47, "running-on-a-gpu"]], "Simulations with cuQuantum": [[50, "simulations-with-cuquantum"]], "What is a CUDA-Q kernel?": [[46, "what-is-a-cuda-q-kernel"]], "Troubleshooting": [[48, "troubleshooting"]], "Debugging and Verbose Simulation Output": [[48, "debugging-and-verbose-simulation-output"]], "CUDA-Q by Example": [[51, "cuda-q-by-example"]], "Computing Expectation Values": [[52, "computing-expectation-values"]], "Parallelizing across Multiple Processors": [[52, "parallelizing-across-multiple-processors"]], "Working with the CUDA-Q IR": [[61, "working-with-the-cuda-q-ir"]], "Noisy Simulation": [[57, "noisy-simulation"], [13, "Noisy-Simulation"], [3, "noisy-simulation"]], "Variational Quantum Eigensolver": [[60, "variational-quantum-eigensolver"], [19, "Variational-Quantum-Eigensolver"]], "Multi-control Synthesis": [[55, "multi-control-synthesis"]], "Introduction": [[54, "introduction"], [67, "introduction"]], "Multi-GPU Workflows": [[56, "multi-gpu-workflows"]], "Available Targets": [[56, "available-targets"]], "Parallelization across Multiple Processors": [[56, "parallelization-across-multiple-processors"]], "Batching Hamiltonian Terms": [[56, "batching-hamiltonian-terms"]], "Circuit Batching": [[56, "circuit-batching"]], "Quantum Computing 101": [[59, "quantum-computing-101"]], "Quantum States": [[59, "quantum-states"]], "Quantum Gates": [[59, "quantum-gates"]], "Measurements": [[59, "measurements"]], "Extending CUDA-Q": [[62, "extending-cuda-q"]], "Quantum Approximate Optimization Algorithm": [[58, "quantum-approximate-optimization-algorithm"]], "Integrating with Third-Party Libraries": [[71, "integrating-with-third-party-libraries"]], "Calling a CUDA-Q library from C++": [[71, "calling-a-cuda-q-library-from-c"]], "Calling an C++ library from CUDA-Q": [[71, "calling-an-c-library-from-cuda-q"]], "Interfacing between binaries compiled with a different toolchains": [[71, "interfacing-between-binaries-compiled-with-a-different-toolchains"]], "Local Installation": [[67, "local-installation"]], "Docker": [[67, "docker"]], "Singularity": [[67, "singularity"]], "Python wheels": [[67, "python-wheels"]], "Pre-built binaries": [[67, "pre-built-binaries"]], "Development with VS Code": [[67, "development-with-vs-code"]], "Using a Docker container": [[67, "using-a-docker-container"]], "Using a Singularity container": [[67, "using-a-singularity-container"]], "Connecting to a Remote Host": [[67, "connecting-to-a-remote-host"]], "Developing with Remote Tunnels": [[67, "developing-with-remote-tunnels"]], "Remote Access via SSH": [[67, "remote-access-via-ssh"]], "DGX Cloud": [[67, "dgx-cloud"]], "Get Started": [[67, "get-started"]], "Use JupyterLab": [[67, "use-jupyterlab"]], "Use VS Code": [[67, "use-vs-code"]], "Additional CUDA Tools": [[67, "additional-cuda-tools"]], "Installation via PyPI": [[67, "installation-via-pypi"]], "Installation In Container Images": [[67, "installation-in-container-images"]], "Installing Pre-built Binaries": [[67, "installing-pre-built-binaries"]], "Distributed Computing with MPI": [[67, "distributed-computing-with-mpi"]], "Updating CUDA-Q": [[67, "updating-cuda-q"]], "Dependencies and Compatibility": [[67, "dependencies-and-compatibility"]], "Supported Systems": [[67, "id10"]], "Requirements for GPU Simulation": [[67, "id11"]], "Next Steps": [[67, "next-steps"]], "Create your own CUDA-Q Compiler Pass": [[63, "create-your-own-cuda-q-compiler-pass"]], "CUDA-Q and CMake": [[68, "cuda-q-and-cmake"]], "Installation from Source": [[65, "installation-from-source"]], "Prerequisites": [[65, "prerequisites"]], "Build Dependencies": [[65, "build-dependencies"]], "CUDA": [[65, "cuda"]], "Toolchain": [[65, "toolchain"]], "Building CUDA-Q": [[65, "building-cuda-q"]], "Python Support": [[65, "python-support"]], "C++ Support": [[65, "c-support"]], "Installation on the Host": [[65, "installation-on-the-host"]], "CUDA Runtime Libraries": [[65, "cuda-runtime-libraries"]], "MPI": [[65, "mpi"]], "Installation Guide": [[66, "installation-guide"]], "Contents": [[66, null], [44, null], [21, null]], "Integration with other Software Tools": [[70, "integration-with-other-software-tools"]], "Extending CUDA-Q with a new Simulator": [[64, "extending-cuda-q-with-a-new-simulator"]], "CircuitSimulator": [[64, "circuitsimulator"]], "Required Circuit Simulator Subtype Method Overrides": [[64, "id1"]], "Let\u2019s see this in action": [[64, "let-s-see-this-in-action"]], "Using CUDA and CUDA-Q in a Project": [[69, "using-cuda-and-cuda-q-in-a-project"]], "CUDA-Q Versions": [[74, "cuda-q-versions"]], "CUDA-Q Tutorials": [[73, "cuda-q-tutorials"]], "Quick Start": [[72, "quick-start"], [41, "quick-start"]], "Install CUDA-Q": [[72, "install-cuda-q"]], "Validate your Installation": [[72, "validate-your-installation"]], "CUDA-Q Hardware Backends": [[40, "cuda-q-hardware-backends"]], "Setting Credentials": [[40, "setting-credentials"], [40, "id1"], [40, "id4"], [40, "id7"], [40, "quantinuum-backend"]], "Submission from C++": [[40, "submission-from-c"], [40, "id2"], [40, "id5"], [40, "id8"], [40, "id11"]], "Submission from Python": [[40, "submission-from-python"], [40, "id3"], [40, "id6"], [40, "id9"], [40, "id12"]], "CUDA-Q Simulation Backends": [[43, "cuda-q-simulation-backends"]], "State Vector Simulators": [[43, "state-vector-simulators"]], "Features": [[43, "features"]], "Single-GPU": [[43, "single-gpu"]], "Environment variable options supported in single-GPU mode": [[43, "id4"]], "Multi-node multi-GPU": [[43, "multi-node-multi-gpu"], [43, "id2"]], "Additional environment variable options for multi-node multi-GPU mode": [[43, "id5"]], "OpenMP CPU-only": [[43, "openmp-cpu-only"]], "Clifford-Only Simulation (CPU)": [[43, "clifford-only-simulation-cpu"]], "Tensor Network Simulators": [[43, "tensor-network-simulators"]], "Matrix product state": [[43, "matrix-product-state"]], "Default Simulator": [[43, "default-simulator"]], "Multi-Processor Platforms": [[42, "multi-processor-platforms"]], "NVIDIA MQPU Platform": [[42, "nvidia-mqpu-platform"]], "Parallel distribution mode": [[42, "parallel-distribution-mode"]], "Remote MQPU Platform": [[42, "remote-mqpu-platform"]], "Supported Kernel Arguments": [[42, "supported-kernel-arguments"]], "Kernel argument serialization": [[42, "id4"]], "Accessing Simulated Quantum State": [[42, "accessing-simulated-quantum-state"]], "Specifications": [[37, "specifications"]], "NVIDIA Quantum Cloud": [[41, "nvidia-quantum-cloud"]], "Simulator Backend Selection": [[41, "simulator-backend-selection"]], "Multiple GPUs": [[41, "multiple-gpus"]], "Simulator Backends": [[41, "id1"]], "Multiple QPUs Asynchronous Execution": [[41, "multiple-qpus-asynchronous-execution"]], "FAQ": [[41, "faq"]], "Quake Dialect": [[38, "quake-dialect"]], "General Introduction": [[38, "general-introduction"]], "Motivation": [[38, "motivation"]], "CUDA-Q Basics": [[44, "cuda-q-basics"]], "Quantum Types": [[36, "quantum-types"]], "cudaq::qudit<Levels>": [[36, "cudaq-qudit-levels"]], "cudaq::qubit": [[36, "cudaq-qubit"]], "Quantum Containers": [[36, "quantum-containers"]], "cudaq::qview<Levels = 2>": [[36, "cudaq-qview-levels-2"]], "cudaq::qvector<Levels = 2>": [[36, "cudaq-qvector-levels-2"]], "cudaq::qarray<N, Levels = 2>": [[36, "cudaq-qarray-n-levels-2"]], "cudaq::qspan<N, Levels> (Deprecated. Use cudaq::qview<Levels> instead.)": [[36, "cudaq-qspan-n-levels-deprecated-use-cudaq-qview-levels-instead"]], "cudaq::qreg<N, Levels> (Deprecated. Use cudaq::qvector<Levels> instead.)": [[36, "cudaq-qreg-n-levels-deprecated-use-cudaq-qvector-levels-instead"]], "CUDA-Q Backends": [[39, "cuda-q-backends"]], "Backend Targets": [[39, null]], "Compiling Unitaries Using Diffusion Models": [[17, "Compiling-Unitaries-Using-Diffusion-Models"]], "Diffusion model pipeline": [[17, "Diffusion-model-pipeline"]], "Setup and compilation": [[17, "Setup-and-compilation"]], "Load model": [[17, "Load-model"]], "Unitary compilation": [[17, "Unitary-compilation"]], "Convert tensors to CUDA-Q": [[17, "Convert-tensors-to-CUDA-Q"]], "Evaluate generated circuits": [[17, "Evaluate-generated-circuits"]], "Simulate kernels": [[17, "Simulate-kernels"]], "Compare unitaries": [[17, "Compare-unitaries"]], "Choosing the circuit you need": [[17, "Choosing-the-circuit-you-need"]], "Hybrid Quantum Neural Networks": [[11, "Hybrid-Quantum-Neural-Networks"]], "Molecular docking via DC-QAOA": [[12, "Molecular-docking-via-DC-QAOA"]], "Hadamard Test and Application": [[10, "Hadamard-Test-and-Application"]], "Numerical result as a reference:": [[10, "Numerical-result-as-a-reference:"]], "Using observe algorithmic primitive to compute the expectation value for ancilla qubits.": [[10, "Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits."]], "Use multi-GPUs to compute multiple Hadamard test in parallel": [[10, "Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel"]], "Max-Cut with QAOA": [[14, "Max-Cut-with-QAOA"]], "Deutsch\u2019s Algorithm": [[9, "Deutsch's-Algorithm"]], "XOR \\oplus": [[9, "XOR-\\oplus"]], "Quantum oracles": [[9, "Quantum-oracles"]], "Phase oracle": [[9, "Phase-oracle"]], "Quantum parallelism": [[9, "Quantum-parallelism"]], "Deutschs\u2019 Algorithm:": [[9, "Deutschs'-Algorithm:"]], "Readout Error Mitigation": [[16, "Readout-Error-Mitigation"]], "Inverse confusion matrix from single-qubit noise model": [[16, "Inverse-confusion-matrix-from-single-qubit-noise-model"]], "Inverse confusion matrix from k local confusion matrices": [[16, "Inverse-confusion-matrix-from-k-local-confusion-matrices"]], "Inverse of full confusion matrix": [[16, "Inverse-of-full-confusion-matrix"]], "Quantum Fourier Transform": [[15, "Quantum-Fourier-Transform"]], "Quantum Fourier Transform revisited": [[15, "Quantum-Fourier-Transform-revisited"]], "Using CUDA-Q Optimizers": [[19, "Using-CUDA-Q-Optimizers"]], "Integration with Third-Party Optimizers": [[19, "Integration-with-Third-Party-Optimizers"]], "Visualization": [[18, "Visualization"]], "Qubit Visualization": [[18, "Qubit-Visualization"]], "Kernel Visualization": [[18, "Kernel-Visualization"]], "CUDA-Q Releases": [[22, "cuda-q-releases"]], "Water Molecule with Active Space (CPU vs. GPU)": [[20, "Water-Molecule-with-Active-Space-(CPU-vs.-GPU)"]], "A- Classical simulation as a reference: CCSD": [[20, "A--Classical-simulation-as-a-reference:-CCSD"]], "B- VQE-UCCSD:": [[20, "B--VQE-UCCSD:"]], "Language Specification": [[23, "language-specification"]], "CUDA-Q": [[23, null], [21, "cuda-q"]], "Quantum Algorithmic Primitives": [[24, "quantum-algorithmic-primitives"]], "cudaq::sample": [[24, "cudaq-sample"]], "cudaq::observe": [[24, "cudaq-observe"]], "cudaq::optimizer (deprecated, functionality moved to CUDA-Q libraries)": [[24, "cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries"]], "cudaq::gradient (deprecated, functionality moved to CUDA-Q libraries)": [[24, "cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries"]], "Just-in-Time Kernel Creation": [[26, "just-in-time-kernel-creation"]], "Control Flow": [[25, "control-flow"]], "CUDA-Q C++ API": [[2, "cuda-q-c-api"]], "Operators": [[2, "operators"]], "Quantum": [[2, "quantum"]], "Common": [[2, "common"]], "Noise Modeling": [[2, "noise-modeling"]], "Kernel Builder": [[2, "kernel-builder"]], "Algorithms": [[2, "algorithms"]], "Platform": [[2, "platform"]], "Utilities": [[2, "utilities"]], "Namespaces": [[2, "namespaces"]], "Factoring Integers With Shor\u2019s Algorithm": [[6, "Factoring-Integers-With-Shor's-Algorithm"]], "Shor\u2019s algorithm": [[6, "Shor's-algorithm"]], "Solving the order-finding problem classically": [[6, "Solving-the-order-finding-problem-classically"]], "Solving the order-finding problem with a quantum algorithm": [[6, "Solving-the-order-finding-problem-with-a-quantum-algorithm"]], "Inverse quantum Fourier transform": [[6, "Inverse-quantum-Fourier-transform"]], "Quantum kernels for modular exponentiation": [[6, "Quantum-kernels-for-modular-exponentiation"]], "The case N = 21 and a = 5:": [[6, "The-case-N-=-21-and-a-=-5:"]], "The case N = 21 and a = 4:": [[6, "The-case-N-=-21-and-a-=-4:"]], "Determining the order from the measurement results of the phase kernel": [[6, "Determining-the-order-from-the-measurement-results-of-the-phase-kernel"]], "Postscript": [[6, "Postscript"]], "Quantum Operations": [[1, "quantum-operations"]], "Unitary Operations on Qubits": [[1, "unitary-operations-on-qubits"]], "x": [[1, "x"]], "y": [[1, "y"]], "z": [[1, "z"]], "h": [[1, "h"]], "r1": [[1, "r1"]], "rx": [[1, "rx"]], "ry": [[1, "ry"]], "rz": [[1, "rz"]], "s": [[1, "s"]], "t": [[1, "t"]], "swap": [[1, "swap"]], "u3": [[1, "u3"]], "Adjoint and Controlled Operations": [[1, "adjoint-and-controlled-operations"]], "Measurements on Qubits": [[1, "measurements-on-qubits"]], "mz": [[1, "mz"], [1, "id1"]], "mx": [[1, "mx"]], "my": [[1, "my"]], "User-Defined Custom Operations": [[1, "user-defined-custom-operations"]], "Photonic Operations on Qudits": [[1, "photonic-operations-on-qudits"]], "plus": [[1, "plus"]], "phase_shift": [[1, "phase-shift"]], "beam_splitter": [[1, "beam-splitter"]], "CUDA-Q Python API": [[3, "module-cudaq"]], "Program Construction": [[3, "program-construction"]], "Kernel Execution": [[3, "kernel-execution"]], "Backend Configuration": [[3, "backend-configuration"]], "Data Types": [[3, "data-types"]], "Optimizers": [[3, "optimizers"]], "Gradients": [[3, "gradients"]], "MPI Submodule": [[3, "mpi-submodule"]], "ORCA Submodule": [[3, "orca-submodule"]], "Divisive Clustering With Coresets Using CUDA-Q": [[4, "Divisive-Clustering-With-Coresets-Using-CUDA-Q"]], "Data preprocessing": [[4, "Data-preprocessing"]], "Quantum functions": [[4, "Quantum-functions"]], "Divisive Clustering Function": [[4, "Divisive-Clustering-Function"]], "QAOA Implementation": [[4, "QAOA-Implementation"]], "Scaling simulations with CUDA-Q": [[4, "Scaling-simulations-with-CUDA-Q"]], "Multi-Reference Quantum Krylov Algorithm (H2 Example)": [[5, "Multi-Reference-Quantum-Krylov-Algorithm-(H2-Example)"]], "Code documentation": [[0, "code-documentation"]], "CUDA-Q API": [[0, null]], "Quantum Enhanced Auxiliary Field Quantum Monte Carlo": [[7, "Quantum-Enhanced-Auxiliary-Field-Quantum-Monte-Carlo"]], "Hamiltonian preparation for VQE": [[7, "Hamiltonian-preparation-for-VQE"]], "Run VQE with CUDA-Q": [[7, "Run-VQE-with-CUDA-Q"]], "Auxiliary Field Quantum Monte Carlo (AFQMC)": [[7, "Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)"]], "Preparation of the molecular Hamiltonian": [[7, "Preparation-of-the-molecular-Hamiltonian"]], "Preparation of the trial wave function": [[7, "Preparation-of-the-trial-wave-function"]], "Setup of the AFQMC parameters": [[7, "Setup-of-the-AFQMC-parameters"]], "Cost Minimization": [[8, "Cost-Minimization"]]}, "indexentries": {"cudaq (c++ type)": [[2, "_CPPv45cudaq"]], "cudaq::basenvcfsimulatorqpu (c++ class)": [[2, "_CPPv4N5cudaq20BaseNvcfSimulatorQPUE"]], "cudaq::baseremoterestqpu (c++ class)": [[2, "_CPPv4N5cudaq17BaseRemoteRESTQPUE"]], "cudaq::baseremotesimulatorqpu (c++ class)": [[2, "_CPPv4N5cudaq22BaseRemoteSimulatorQPUE"]], "cudaq::cusvstate (c++ class)": [[2, "_CPPv4I0EN5cudaq9CusvStateE"]], "cudaq::executioncontext (c++ class)": [[2, "_CPPv4N5cudaq16ExecutionContextE"]], "cudaq::executioncontext::executioncontext (c++ function)": [[2, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringE"], [2, "_CPPv4N5cudaq16ExecutionContext16ExecutionContextEKNSt6stringENSt6size_tE"]], "cudaq::executioncontext::amplitudemaps (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext13amplitudeMapsE"]], "cudaq::executioncontext::asyncexec (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext9asyncExecE"]], "cudaq::executioncontext::batchiteration (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext14batchIterationE"]], "cudaq::executioncontext::canhandleobserve (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext16canHandleObserveE"]], "cudaq::executioncontext::expectationvalue (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext16expectationValueE"]], "cudaq::executioncontext::futureresult (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext12futureResultE"]], "cudaq::executioncontext::hasconditionalsonmeasureresults (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext31hasConditionalsOnMeasureResultsE"]], "cudaq::executioncontext::invocationresultbuffer (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext22invocationResultBufferE"]], "cudaq::executioncontext::kernelname (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext10kernelNameE"]], "cudaq::executioncontext::kerneltrace (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext11kernelTraceE"]], "cudaq::executioncontext::name (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext4nameE"]], "cudaq::executioncontext::noisemodel (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext10noiseModelE"]], "cudaq::executioncontext::optresult (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext9optResultE"]], "cudaq::executioncontext::overlapcomputestates (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext20overlapComputeStatesE"]], "cudaq::executioncontext::overlapresult (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext13overlapResultE"]], "cudaq::executioncontext::registernames (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext13registerNamesE"]], "cudaq::executioncontext::reorderidx (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext10reorderIdxE"]], "cudaq::executioncontext::result (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext6resultE"]], "cudaq::executioncontext::shots (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext5shotsE"]], "cudaq::executioncontext::simulationstate (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext15simulationStateE"]], "cudaq::executioncontext::spin (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext4spinE"]], "cudaq::executioncontext::totaliterations (c++ member)": [[2, "_CPPv4N5cudaq16ExecutionContext15totalIterationsE"]], "cudaq::executionresult (c++ struct)": [[2, "_CPPv4N5cudaq15ExecutionResultE"]], "cudaq::executionresult::executionresult (c++ function)": [[2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionary"], [2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryNSt6stringE"], [2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultE16CountsDictionaryd"], [2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultENSt6stringE"], [2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultERK15ExecutionResult"], [2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultEd"], [2, "_CPPv4N5cudaq15ExecutionResult15ExecutionResultEv"]], "cudaq::executionresult::appendresult (c++ function)": [[2, "_CPPv4N5cudaq15ExecutionResult12appendResultENSt6stringENSt6size_tE"]], "cudaq::executionresult::deserialize (c++ function)": [[2, "_CPPv4N5cudaq15ExecutionResult11deserializeERNSt6vectorINSt6size_tEEE"]], "cudaq::executionresult::operator= (c++ function)": [[2, "_CPPv4N5cudaq15ExecutionResultaSERK15ExecutionResult"]], "cudaq::executionresult::operator== (c++ function)": [[2, "_CPPv4NK5cudaq15ExecutionResulteqERK15ExecutionResult"]], "cudaq::executionresult::registername (c++ member)": [[2, "_CPPv4N5cudaq15ExecutionResult12registerNameE"]], "cudaq::executionresult::sequentialdata (c++ member)": [[2, "_CPPv4N5cudaq15ExecutionResult14sequentialDataE"]], "cudaq::executionresult::serialize (c++ function)": [[2, "_CPPv4NK5cudaq15ExecutionResult9serializeEv"]], "cudaq::kernelexecutiontask (c++ type)": [[2, "_CPPv4N5cudaq19KernelExecutionTaskE"]], "cudaq::qpu (c++ class)": [[2, "_CPPv4N5cudaq3QPUE"]], "cudaq::qpu::qpu (c++ function)": [[2, "_CPPv4N5cudaq3QPU3QPUENSt6size_tE"], [2, "_CPPv4N5cudaq3QPU3QPUERR3QPU"], [2, "_CPPv4N5cudaq3QPU3QPUEv"]], "cudaq::qpu::enqueue (c++ function)": [[2, "_CPPv4N5cudaq3QPU7enqueueER11QuantumTask"]], "cudaq::qpu::getconnectivity (c++ function)": [[2, "_CPPv4N5cudaq3QPU15getConnectivityEv"]], "cudaq::qpu::getexecutionthreadid (c++ function)": [[2, "_CPPv4NK5cudaq3QPU20getExecutionThreadIdEv"]], "cudaq::qpu::getnumqubits (c++ function)": [[2, "_CPPv4N5cudaq3QPU12getNumQubitsEv"]], "cudaq::qpu::getremotecapabilities (c++ function)": [[2, "_CPPv4NK5cudaq3QPU21getRemoteCapabilitiesEv"]], "cudaq::qpu::isemulated (c++ function)": [[2, "_CPPv4N5cudaq3QPU10isEmulatedEv"]], "cudaq::qpu::issimulator (c++ function)": [[2, "_CPPv4N5cudaq3QPU11isSimulatorEv"]], "cudaq::qpu::launchkernel (c++ function)": [[2, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringEPFvPvEPvNSt8uint64_tENSt8uint64_tERKNSt6vectorIPvEE"], [2, "_CPPv4N5cudaq3QPU12launchKernelERKNSt6stringERKNSt6vectorIPvEE"]], "cudaq::qpu::launchserializedcodeexecution (c++ function)": [[2, "_CPPv4N5cudaq3QPU29launchSerializedCodeExecutionERKNSt6stringERN5cudaq30SerializedCodeExecutionContextE"]], "cudaq::qpu::onrandomseedset (c++ function)": [[2, "_CPPv4N5cudaq3QPU15onRandomSeedSetENSt6size_tE"]], "cudaq::qpu::resetexecutioncontext (c++ function)": [[2, "_CPPv4N5cudaq3QPU21resetExecutionContextEv"]], "cudaq::qpu::setexecutioncontext (c++ function)": [[2, "_CPPv4N5cudaq3QPU19setExecutionContextEP16ExecutionContext"]], "cudaq::qpu::setid (c++ function)": [[2, "_CPPv4N5cudaq3QPU5setIdENSt6size_tE"]], "cudaq::qpu::setshots (c++ function)": [[2, "_CPPv4N5cudaq3QPU8setShotsEi"]], "cudaq::qpu::supportsconditionalfeedback (c++ function)": [[2, "_CPPv4N5cudaq3QPU27supportsConditionalFeedbackEv"]], "cudaq::qpu::~qpu (c++ function)": [[2, "_CPPv4N5cudaq3QPUD0Ev"]], "cudaq::quakevalue (c++ class)": [[2, "_CPPv4N5cudaq10QuakeValueE"]], "cudaq::quakevalue::quakevalue (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEN4mlir5ValueE"], [2, "_CPPv4N5cudaq10QuakeValue10QuakeValueERN4mlir20ImplicitLocOpBuilderEd"]], "cudaq::quakevalue::canvalidatenumelements (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue22canValidateNumElementsEv"]], "cudaq::quakevalue::constantsize (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue12constantSizeEv"]], "cudaq::quakevalue::dump (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue4dumpERNSt7ostreamE"], [2, "_CPPv4N5cudaq10QuakeValue4dumpEv"]], "cudaq::quakevalue::getrequiredelements (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue19getRequiredElementsEv"]], "cudaq::quakevalue::getvalue (c++ function)": [[2, "_CPPv4NK5cudaq10QuakeValue8getValueEv"]], "cudaq::quakevalue::inverse (c++ function)": [[2, "_CPPv4NK5cudaq10QuakeValue7inverseEv"]], "cudaq::quakevalue::isstdvec (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue8isStdVecEv"]], "cudaq::quakevalue::operator* (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValuemlE10QuakeValue"], [2, "_CPPv4N5cudaq10QuakeValuemlEKd"]], "cudaq::quakevalue::operator+ (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValueplE10QuakeValue"], [2, "_CPPv4N5cudaq10QuakeValueplEKd"], [2, "_CPPv4N5cudaq10QuakeValueplEKi"]], "cudaq::quakevalue::operator- (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValuemiE10QuakeValue"], [2, "_CPPv4N5cudaq10QuakeValuemiEKd"], [2, "_CPPv4N5cudaq10QuakeValuemiEKi"], [2, "_CPPv4NK5cudaq10QuakeValuemiEv"]], "cudaq::quakevalue::operator/ (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValuedvE10QuakeValue"], [2, "_CPPv4N5cudaq10QuakeValuedvEKd"]], "cudaq::quakevalue::operator[] (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValueixEKNSt6size_tE"], [2, "_CPPv4N5cudaq10QuakeValueixERK10QuakeValue"]], "cudaq::quakevalue::size (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue4sizeEv"]], "cudaq::quakevalue::slice (c++ function)": [[2, "_CPPv4N5cudaq10QuakeValue5sliceEKNSt6size_tEKNSt6size_tE"]], "cudaq::quantumtask (c++ type)": [[2, "_CPPv4N5cudaq11QuantumTaskE"]], "cudaq::qubitconnectivity (c++ type)": [[2, "_CPPv4N5cudaq17QubitConnectivityE"]], "cudaq::qubitedge (c++ type)": [[2, "_CPPv4N5cudaq9QubitEdgeE"]], "cudaq::remotecapabilities (c++ struct)": [[2, "_CPPv4N5cudaq18RemoteCapabilitiesE"]], "cudaq::remotecapabilities::remotecapabilities (c++ function)": [[2, "_CPPv4N5cudaq18RemoteCapabilities18RemoteCapabilitiesEb"]], "cudaq::remotecapabilities::isremotesimulator (c++ member)": [[2, "_CPPv4N5cudaq18RemoteCapabilities17isRemoteSimulatorE"]], "cudaq::remotecapabilities::serializedcodeexec (c++ member)": [[2, "_CPPv4N5cudaq18RemoteCapabilities18serializedCodeExecE"]], "cudaq::remotecapabilities::stateoverlap (c++ member)": [[2, "_CPPv4N5cudaq18RemoteCapabilities12stateOverlapE"]], "cudaq::remotecapabilities::vqe (c++ member)": [[2, "_CPPv4N5cudaq18RemoteCapabilities3vqeE"]], "cudaq::remotesimulationstate (c++ class)": [[2, "_CPPv4N5cudaq21RemoteSimulationStateE"]], "cudaq::resources (c++ class)": [[2, "_CPPv4N5cudaq9ResourcesE"]], "cudaq::serializedcodeexecutioncontext (c++ class)": [[2, "_CPPv4N5cudaq30SerializedCodeExecutionContextE"]], "cudaq::simulationstate (c++ class)": [[2, "_CPPv4N5cudaq15SimulationStateE"]], "cudaq::simulationstate::tensor (c++ struct)": [[2, "_CPPv4N5cudaq15SimulationState6TensorE"]], "cudaq::simulationstate::precision (c++ enum)": [[2, "_CPPv4N5cudaq15SimulationState9precisionE"]], "cudaq::simulationstate::precision::fp32 (c++ enumerator)": [[2, "_CPPv4N5cudaq15SimulationState9precision4fp32E"]], "cudaq::simulationstate::precision::fp64 (c++ enumerator)": [[2, "_CPPv4N5cudaq15SimulationState9precision4fp64E"]], "cudaq::tensorstatedata (c++ type)": [[2, "_CPPv4N5cudaq15TensorStateDataE"]], "cudaq::trace (c++ class)": [[2, "_CPPv4N5cudaq5TraceE"]], "cudaq::amplitude_damping_channel (c++ class)": [[2, "_CPPv4N5cudaq25amplitude_damping_channelE"]], "cudaq::async_result (c++ class)": [[2, "_CPPv4I0EN5cudaq12async_resultE"]], "cudaq::async_result::get (c++ function)": [[2, "_CPPv4N5cudaq12async_result3getEv"]], "cudaq::bit_flip_channel (c++ class)": [[2, "_CPPv4N5cudaq16bit_flip_channelE"]], "cudaq::complex (c++ type)": [[2, "_CPPv4N5cudaq7complexE"]], "cudaq::complex_matrix (c++ class)": [[2, "_CPPv4N5cudaq14complex_matrixE"]], "cudaq::complex_matrix::cols (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrix4colsEv"]], "cudaq::complex_matrix::complex_matrix (c++ function)": [[2, "_CPPv4N5cudaq14complex_matrix14complex_matrixEKNSt6size_tEKNSt6size_tE"], [2, "_CPPv4N5cudaq14complex_matrix14complex_matrixEP10value_typeKNSt6size_tEKNSt6size_tE"]], "cudaq::complex_matrix::data (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrix4dataEv"]], "cudaq::complex_matrix::dump (c++ function)": [[2, "_CPPv4N5cudaq14complex_matrix4dumpERNSt7ostreamE"], [2, "_CPPv4N5cudaq14complex_matrix4dumpEv"]], "cudaq::complex_matrix::eigenvalues (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrix11eigenvaluesEv"]], "cudaq::complex_matrix::eigenvectors (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrix12eigenvectorsEv"]], "cudaq::complex_matrix::minimal_eigenvalue (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrix18minimal_eigenvalueEv"]], "cudaq::complex_matrix::operator() (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrixclENSt6size_tENSt6size_tE"]], "cudaq::complex_matrix::operator* (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrixmlER14complex_matrix"], [2, "_CPPv4NK5cudaq14complex_matrixmlERNSt6vectorI10value_typeEE"]], "cudaq::complex_matrix::rows (c++ function)": [[2, "_CPPv4NK5cudaq14complex_matrix4rowsEv"]], "cudaq::complex_matrix::set_zero (c++ function)": [[2, "_CPPv4N5cudaq14complex_matrix8set_zeroEv"]], "cudaq::complex_matrix::value_type (c++ type)": [[2, "_CPPv4N5cudaq14complex_matrix10value_typeE"]], "cudaq::depolarization_channel (c++ class)": [[2, "_CPPv4N5cudaq22depolarization_channelE"]], "cudaq::details (c++ type)": [[2, "_CPPv4N5cudaq7detailsE"]], "cudaq::details::kernelbuildertype (c++ class)": [[2, "_CPPv4N5cudaq7details17KernelBuilderTypeE"]], "cudaq::details::kernelbuildertype::kernelbuildertype (c++ function)": [[2, "_CPPv4N5cudaq7details17KernelBuilderType17KernelBuilderTypeERRNSt8functionIFN4mlir4TypeEPN4mlir11MLIRContextEEEE"]], "cudaq::details::kernelbuildertype::create (c++ function)": [[2, "_CPPv4N5cudaq7details17KernelBuilderType6createEPN4mlir11MLIRContextE"]], "cudaq::details::future (c++ class)": [[2, "_CPPv4N5cudaq7details6futureE"]], "cudaq::details::future::future (c++ function)": [[2, "_CPPv4N5cudaq7details6future6futureERNSt6vectorI3JobEERNSt6stringERNSt3mapINSt6stringENSt6stringEEE"], [2, "_CPPv4N5cudaq7details6future6futureERR6future"], [2, "_CPPv4N5cudaq7details6future6futureEv"]], "cudaq::details::kernel_builder_base (c++ class)": [[2, "_CPPv4N5cudaq7details19kernel_builder_baseE"]], "cudaq::details::kernel_builder_base::operator<< (c++ function)": [[2, "_CPPv4N5cudaq7details19kernel_builder_baselsERNSt7ostreamERK19kernel_builder_base"]], "cudaq::draw (c++ function)": [[2, "_CPPv4I0Dp0EN5cudaq4drawENSt6stringERR13QuantumKernelDpRR4Args"]], "cudaq::dyn (c++ member)": [[2, "_CPPv4N5cudaq3dynE"]], "cudaq::gradient (c++ class)": [[2, "_CPPv4N5cudaq8gradientE"]], "cudaq::gradient::clone (c++ function)": [[2, "_CPPv4N5cudaq8gradient5cloneEv"]], "cudaq::gradient::compute (c++ function)": [[2, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd"], [2, "_CPPv4N5cudaq8gradient7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd"]], "cudaq::gradient::gradient (c++ function)": [[2, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelT"], [2, "_CPPv4I00EN5cudaq8gradient8gradientER7KernelTRR10ArgsMapper"], [2, "_CPPv4I00EN5cudaq8gradient8gradientERR13QuantumKernelRR10ArgsMapper"], [2, "_CPPv4N5cudaq8gradient8gradientERRNSt8functionIFvNSt6vectorIdEEEEE"], [2, "_CPPv4N5cudaq8gradient8gradientEv"]], "cudaq::gradient::setargs (c++ function)": [[2, "_CPPv4I0DpEN5cudaq8gradient7setArgsEvR13QuantumKernelDpRR4Args"]], "cudaq::gradient::setkernel (c++ function)": [[2, "_CPPv4I0EN5cudaq8gradient9setKernelEvR13QuantumKernel"]], "cudaq::gradients::central_difference (c++ class)": [[2, "_CPPv4N5cudaq9gradients18central_differenceE"]], "cudaq::gradients::central_difference::clone (c++ function)": [[2, "_CPPv4N5cudaq9gradients18central_difference5cloneEv"]], "cudaq::gradients::central_difference::compute (c++ function)": [[2, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd"], [2, "_CPPv4N5cudaq9gradients18central_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd"]], "cudaq::gradients::central_difference::gradient (c++ function)": [[2, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelT"], [2, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientER7KernelTRR10ArgsMapper"], [2, "_CPPv4I00EN5cudaq9gradients18central_difference8gradientERR13QuantumKernelRR10ArgsMapper"], [2, "_CPPv4N5cudaq9gradients18central_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE"], [2, "_CPPv4N5cudaq9gradients18central_difference8gradientEv"]], "cudaq::gradients::forward_difference (c++ class)": [[2, "_CPPv4N5cudaq9gradients18forward_differenceE"]], "cudaq::gradients::forward_difference::clone (c++ function)": [[2, "_CPPv4N5cudaq9gradients18forward_difference5cloneEv"]], "cudaq::gradients::forward_difference::compute (c++ function)": [[2, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd"], [2, "_CPPv4N5cudaq9gradients18forward_difference7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd"]], "cudaq::gradients::forward_difference::gradient (c++ function)": [[2, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelT"], [2, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientER7KernelTRR10ArgsMapper"], [2, "_CPPv4I00EN5cudaq9gradients18forward_difference8gradientERR13QuantumKernelRR10ArgsMapper"], [2, "_CPPv4N5cudaq9gradients18forward_difference8gradientERRNSt8functionIFvNSt6vectorIdEEEEE"], [2, "_CPPv4N5cudaq9gradients18forward_difference8gradientEv"]], "cudaq::gradients::parameter_shift (c++ class)": [[2, "_CPPv4N5cudaq9gradients15parameter_shiftE"]], "cudaq::gradients::parameter_shift::clone (c++ function)": [[2, "_CPPv4N5cudaq9gradients15parameter_shift5cloneEv"]], "cudaq::gradients::parameter_shift::compute (c++ function)": [[2, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERKNSt8functionIFdNSt6vectorIdEEEEEd"], [2, "_CPPv4N5cudaq9gradients15parameter_shift7computeERKNSt6vectorIdEERNSt6vectorIdEERK7spin_opd"]], "cudaq::gradients::parameter_shift::gradient (c++ function)": [[2, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelT"], [2, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientER7KernelTRR10ArgsMapper"], [2, "_CPPv4I00EN5cudaq9gradients15parameter_shift8gradientERR13QuantumKernelRR10ArgsMapper"], [2, "_CPPv4N5cudaq9gradients15parameter_shift8gradientERRNSt8functionIFvNSt6vectorIdEEEEE"], [2, "_CPPv4N5cudaq9gradients15parameter_shift8gradientEv"]], "cudaq::kernel_builder (c++ class)": [[2, "_CPPv4IDpEN5cudaq14kernel_builderE"]], "cudaq::kernel_builder::constantval (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder11constantValEd"]], "cudaq::kernel_builder::getarguments (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder12getArgumentsEv"]], "cudaq::kernel_builder::getnumparams (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder12getNumParamsEv"]], "cudaq::kernel_builder::isargstdvec (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder11isArgStdVecENSt6size_tE"]], "cudaq::kernel_builder::kernel_builder (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder14kernel_builderERNSt6vectorIN7details17KernelBuilderTypeEEE"]], "cudaq::kernel_builder::name (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder4nameEv"]], "cudaq::kernel_builder::qalloc (c++ function)": [[2, "_CPPv4N5cudaq14kernel_builder6qallocE10QuakeValue"], [2, "_CPPv4N5cudaq14kernel_builder6qallocEKNSt6size_tE"], [2, "_CPPv4N5cudaq14kernel_builder6qallocERNSt6vectorINSt7complexIdEEEE"], [2, "_CPPv4N5cudaq14kernel_builder6qallocEv"]], "cudaq::kernel_builder::swap (c++ function)": [[2, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRK10QuakeValueRK10QuakeValueRK10QuakeValue"], [2, "_CPPv4I00EN5cudaq14kernel_builder4swapEvRKNSt6vectorI10QuakeValueEERK10QuakeValueRK10QuakeValue"], [2, "_CPPv4N5cudaq14kernel_builder4swapERK10QuakeValueRK10QuakeValue"]], "cudaq::kraus_channel (c++ class)": [[2, "_CPPv4N5cudaq13kraus_channelE"]], "cudaq::kraus_channel::empty (c++ function)": [[2, "_CPPv4NK5cudaq13kraus_channel5emptyEv"]], "cudaq::kraus_channel::get_ops (c++ function)": [[2, "_CPPv4N5cudaq13kraus_channel7get_opsEv"]], "cudaq::kraus_channel::kraus_channel (c++ function)": [[2, "_CPPv4IDpEN5cudaq13kraus_channel13kraus_channelEDpRRNSt16initializer_listI1TEE"], [2, "_CPPv4N5cudaq13kraus_channel13kraus_channelERK13kraus_channel"], [2, "_CPPv4N5cudaq13kraus_channel13kraus_channelERNSt6vectorI8kraus_opEE"], [2, "_CPPv4N5cudaq13kraus_channel13kraus_channelERRNSt6vectorI8kraus_opEE"], [2, "_CPPv4N5cudaq13kraus_channel13kraus_channelEv"]], "cudaq::kraus_channel::operator= (c++ function)": [[2, "_CPPv4N5cudaq13kraus_channelaSERK13kraus_channel"]], "cudaq::kraus_channel::operator[] (c++ function)": [[2, "_CPPv4N5cudaq13kraus_channelixEKNSt6size_tE"]], "cudaq::kraus_channel::push_back (c++ function)": [[2, "_CPPv4N5cudaq13kraus_channel9push_backE8kraus_op"]], "cudaq::kraus_channel::size (c++ function)": [[2, "_CPPv4NK5cudaq13kraus_channel4sizeEv"]], "cudaq::kraus_op (c++ struct)": [[2, "_CPPv4N5cudaq8kraus_opE"]], "cudaq::kraus_op::adjoint (c++ function)": [[2, "_CPPv4NK5cudaq8kraus_op7adjointEv"]], "cudaq::kraus_op::data (c++ member)": [[2, "_CPPv4N5cudaq8kraus_op4dataE"]], "cudaq::kraus_op::kraus_op (c++ function)": [[2, "_CPPv4I0EN5cudaq8kraus_op8kraus_opERRNSt16initializer_listI1TEE"], [2, "_CPPv4N5cudaq8kraus_op8kraus_opENSt6vectorIN5cudaq7complexEEE"], [2, "_CPPv4N5cudaq8kraus_op8kraus_opERK8kraus_op"]], "cudaq::kraus_op::ncols (c++ member)": [[2, "_CPPv4N5cudaq8kraus_op5nColsE"]], "cudaq::kraus_op::nrows (c++ member)": [[2, "_CPPv4N5cudaq8kraus_op5nRowsE"]], "cudaq::kraus_op::operator= (c++ function)": [[2, "_CPPv4N5cudaq8kraus_opaSERK8kraus_op"]], "cudaq::mpi (c++ type)": [[2, "_CPPv4N5cudaq3mpiE"]], "cudaq::mpi::all_gather (c++ function)": [[2, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIdEERKNSt6vectorIdEE"], [2, "_CPPv4N5cudaq3mpi10all_gatherERNSt6vectorIiEERKNSt6vectorIiEE"]], "cudaq::mpi::all_reduce (c++ function)": [[2, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK14BinaryFunction"], [2, "_CPPv4I00EN5cudaq3mpi10all_reduceE1TRK1TRK4Func"]], "cudaq::mpi::broadcast (c++ function)": [[2, "_CPPv4N5cudaq3mpi9broadcastERNSt6stringEi"], [2, "_CPPv4N5cudaq3mpi9broadcastERNSt6vectorIdEEi"]], "cudaq::mpi::finalize (c++ function)": [[2, "_CPPv4N5cudaq3mpi8finalizeEv"]], "cudaq::mpi::initialize (c++ function)": [[2, "_CPPv4N5cudaq3mpi10initializeEiPPc"], [2, "_CPPv4N5cudaq3mpi10initializeEv"]], "cudaq::mpi::is_initialized (c++ function)": [[2, "_CPPv4N5cudaq3mpi14is_initializedEv"]], "cudaq::mpi::num_ranks (c++ function)": [[2, "_CPPv4N5cudaq3mpi9num_ranksEv"]], "cudaq::mpi::rank (c++ function)": [[2, "_CPPv4N5cudaq3mpi4rankEv"]], "cudaq::noise_model (c++ class)": [[2, "_CPPv4N5cudaq11noise_modelE"]], "cudaq::noise_model::predicatefuncty (c++ type)": [[2, "_CPPv4N5cudaq11noise_model15PredicateFuncTyE"]], "cudaq::noise_model::add_all_qubit_channel (c++ function)": [[2, "_CPPv4IDpEN5cudaq11noise_model21add_all_qubit_channelEvRK13kraus_channeli"], [2, "_CPPv4N5cudaq11noise_model21add_all_qubit_channelERKNSt6stringERK13kraus_channeli"]], "cudaq::noise_model::add_channel (c++ function)": [[2, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRK15PredicateFuncTy"], [2, "_CPPv4IDpEN5cudaq11noise_model11add_channelEvRKNSt6vectorINSt6size_tEEERK13kraus_channel"], [2, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERK15PredicateFuncTy"], [2, "_CPPv4N5cudaq11noise_model11add_channelERKNSt6stringERKNSt6vectorINSt6size_tEEERK13kraus_channel"]], "cudaq::noise_model::empty (c++ function)": [[2, "_CPPv4NK5cudaq11noise_model5emptyEv"]], "cudaq::noise_model::get_channels (c++ function)": [[2, "_CPPv4I0ENK5cudaq11noise_model12get_channelsENSt6vectorI13kraus_channelEERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE"], [2, "_CPPv4NK5cudaq11noise_model12get_channelsERKNSt6stringERKNSt6vectorINSt6size_tEEERKNSt6vectorINSt6size_tEEERKNSt6vectorIdEE"]], "cudaq::noise_model::noise_model (c++ function)": [[2, "_CPPv4N5cudaq11noise_model11noise_modelEv"]], "cudaq::num_available_gpus (c++ function)": [[2, "_CPPv4N5cudaq18num_available_gpusEv"]], "cudaq::observe_result (c++ class)": [[2, "_CPPv4N5cudaq14observe_resultE"]], "cudaq::observe_result::counts (c++ function)": [[2, "_CPPv4I0EN5cudaq14observe_result6countsE13sample_result10SpinOpType"]], "cudaq::observe_result::dump (c++ function)": [[2, "_CPPv4N5cudaq14observe_result4dumpEv"]], "cudaq::observe_result::expectation (c++ function)": [[2, "_CPPv4I0EN5cudaq14observe_result11expectationEd10SpinOpType"], [2, "_CPPv4N5cudaq14observe_result11expectationEv"]], "cudaq::observe_result::id_coefficient (c++ function)": [[2, "_CPPv4N5cudaq14observe_result14id_coefficientEv"]], "cudaq::observe_result::observe_result (c++ function)": [[2, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op"], [2, "_CPPv4N5cudaq14observe_result14observe_resultEdRK7spin_op13sample_result"]], "cudaq::observe_result::operator double (c++ function)": [[2, "_CPPv4N5cudaq14observe_resultcvdEv"]], "cudaq::observe_result::raw_data (c++ function)": [[2, "_CPPv4N5cudaq14observe_result8raw_dataEv"]], "cudaq::optimizable_function (c++ class)": [[2, "_CPPv4N5cudaq20optimizable_functionE"]], "cudaq::optimization_result (c++ type)": [[2, "_CPPv4N5cudaq19optimization_resultE"]], "cudaq::optimizer (c++ class)": [[2, "_CPPv4N5cudaq9optimizerE"]], "cudaq::optimizer::optimize (c++ function)": [[2, "_CPPv4N5cudaq9optimizer8optimizeEKiRR20optimizable_function"]], "cudaq::optimizer::requiresgradients (c++ function)": [[2, "_CPPv4N5cudaq9optimizer17requiresGradientsEv"]], "cudaq::orca (c++ type)": [[2, "_CPPv4N5cudaq4orcaE"]], "cudaq::orca::sample (c++ function)": [[2, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEERNSt6vectorIdEEi"], [2, "_CPPv4N5cudaq4orca6sampleERNSt6vectorINSt6size_tEEERNSt6vectorINSt6size_tEEERNSt6vectorIdEEi"]], "cudaq::phase_flip_channel (c++ class)": [[2, "_CPPv4N5cudaq18phase_flip_channelE"]], "cudaq::qreg (c++ class)": [[2, "_CPPv4I_NSt6size_tE_NSt6size_tE0EN5cudaq4qregE"]], "cudaq::qreg::back (c++ function)": [[2, "_CPPv4N5cudaq4qreg4backENSt6size_tE"], [2, "_CPPv4N5cudaq4qreg4backEv"]], "cudaq::qreg::begin (c++ function)": [[2, "_CPPv4N5cudaq4qreg5beginEv"]], "cudaq::qreg::clear (c++ function)": [[2, "_CPPv4N5cudaq4qreg5clearEv"]], "cudaq::qreg::front (c++ function)": [[2, "_CPPv4N5cudaq4qreg5frontENSt6size_tE"], [2, "_CPPv4N5cudaq4qreg5frontEv"]], "cudaq::qreg::operator[] (c++ function)": [[2, "_CPPv4N5cudaq4qregixEKNSt6size_tE"]], "cudaq::qreg::size (c++ function)": [[2, "_CPPv4NK5cudaq4qreg4sizeEv"]], "cudaq::qreg::slice (c++ function)": [[2, "_CPPv4N5cudaq4qreg5sliceENSt6size_tENSt6size_tE"]], "cudaq::qreg::value_type (c++ type)": [[2, "_CPPv4N5cudaq4qreg10value_typeE"]], "cudaq::qspan (c++ class)": [[2, "_CPPv4I_NSt6size_tE_NSt6size_tEEN5cudaq5qspanE"]], "cudaq::quantum_platform (c++ class)": [[2, "_CPPv4N5cudaq16quantum_platformE"]], "cudaq::quantum_platform::clear_shots (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform11clear_shotsEv"]], "cudaq::quantum_platform::connectivity (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform12connectivityEv"]], "cudaq::quantum_platform::enqueueasynctask (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tER19KernelExecutionTask"], [2, "_CPPv4N5cudaq16quantum_platform16enqueueAsyncTaskEKNSt6size_tERNSt8functionIFvvEEE"]], "cudaq::quantum_platform::getlogstream (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform12getLogStreamEv"]], "cudaq::quantum_platform::get_current_qpu (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform15get_current_qpuEv"]], "cudaq::quantum_platform::get_exec_ctx (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform12get_exec_ctxEv"]], "cudaq::quantum_platform::get_num_qubits (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform14get_num_qubitsENSt6size_tE"], [2, "_CPPv4N5cudaq16quantum_platform14get_num_qubitsEv"]], "cudaq::quantum_platform::get_remote_capabilities (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform23get_remote_capabilitiesEKNSt6size_tE"]], "cudaq::quantum_platform::get_shots (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform9get_shotsEv"]], "cudaq::quantum_platform::is_emulated (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform11is_emulatedEKNSt6size_tE"]], "cudaq::quantum_platform::is_remote (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform9is_remoteEKNSt6size_tE"]], "cudaq::quantum_platform::is_simulator (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform12is_simulatorEKNSt6size_tE"]], "cudaq::quantum_platform::launchvqe (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform9launchVQEEKNSt6stringEPKvPN5cudaq8gradientEN5cudaq7spin_opERN5cudaq9optimizerEKiKNSt6size_tE"]], "cudaq::quantum_platform::list_platforms (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform14list_platformsEv"]], "cudaq::quantum_platform::name (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform4nameEv"]], "cudaq::quantum_platform::num_qpus (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform8num_qpusEv"]], "cudaq::quantum_platform::onrandomseedset (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform15onRandomSeedSetENSt6size_tE"]], "cudaq::quantum_platform::resetlogstream (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform14resetLogStreamEv"]], "cudaq::quantum_platform::reset_exec_ctx (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform14reset_exec_ctxENSt6size_tE"]], "cudaq::quantum_platform::reset_noise (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform11reset_noiseEv"]], "cudaq::quantum_platform::setlogstream (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform12setLogStreamERNSt7ostreamE"]], "cudaq::quantum_platform::settargetbackend (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform16setTargetBackendERKNSt6stringE"]], "cudaq::quantum_platform::set_current_qpu (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform15set_current_qpuEKNSt6size_tE"]], "cudaq::quantum_platform::set_exec_ctx (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform12set_exec_ctxEPN5cudaq16ExecutionContextENSt6size_tE"]], "cudaq::quantum_platform::set_noise (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform9set_noiseEPK11noise_model"]], "cudaq::quantum_platform::set_shots (c++ function)": [[2, "_CPPv4N5cudaq16quantum_platform9set_shotsEi"]], "cudaq::quantum_platform::supports_conditional_feedback (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform29supports_conditional_feedbackEKNSt6size_tE"]], "cudaq::quantum_platform::supports_task_distribution (c++ function)": [[2, "_CPPv4NK5cudaq16quantum_platform26supports_task_distributionEv"]], "cudaq::qubit (c++ type)": [[2, "_CPPv4N5cudaq5qubitE"]], "cudaq::qudit (c++ class)": [[2, "_CPPv4I_NSt6size_tEEN5cudaq5quditE"]], "cudaq::qudit::qudit (c++ function)": [[2, "_CPPv4N5cudaq5qudit5quditEv"]], "cudaq::qvector (c++ class)": [[2, "_CPPv4I_NSt6size_tEEN5cudaq7qvectorE"]], "cudaq::qvector::back (c++ function)": [[2, "_CPPv4N5cudaq7qvector4backENSt6size_tE"], [2, "_CPPv4N5cudaq7qvector4backEv"]], "cudaq::qvector::begin (c++ function)": [[2, "_CPPv4N5cudaq7qvector5beginEv"]], "cudaq::qvector::clear (c++ function)": [[2, "_CPPv4N5cudaq7qvector5clearEv"]], "cudaq::qvector::end (c++ function)": [[2, "_CPPv4N5cudaq7qvector3endEv"]], "cudaq::qvector::front (c++ function)": [[2, "_CPPv4N5cudaq7qvector5frontENSt6size_tE"], [2, "_CPPv4N5cudaq7qvector5frontEv"]], "cudaq::qvector::operator= (c++ function)": [[2, "_CPPv4N5cudaq7qvectoraSERK7qvector"]], "cudaq::qvector::operator[] (c++ function)": [[2, "_CPPv4N5cudaq7qvectorixEKNSt6size_tE"]], "cudaq::qvector::qvector (c++ function)": [[2, "_CPPv4N5cudaq7qvector7qvectorENSt6size_tE"], [2, "_CPPv4N5cudaq7qvector7qvectorERK5state"], [2, "_CPPv4N5cudaq7qvector7qvectorERK7qvector"], [2, "_CPPv4N5cudaq7qvector7qvectorERKNSt6vectorI7complexEEb"], [2, "_CPPv4N5cudaq7qvector7qvectorERR7qvector"]], "cudaq::qvector::size (c++ function)": [[2, "_CPPv4NK5cudaq7qvector4sizeEv"]], "cudaq::qvector::slice (c++ function)": [[2, "_CPPv4N5cudaq7qvector5sliceENSt6size_tENSt6size_tE"]], "cudaq::qvector::value_type (c++ type)": [[2, "_CPPv4N5cudaq7qvector10value_typeE"]], "cudaq::qview (c++ class)": [[2, "_CPPv4I_NSt6size_tEEN5cudaq5qviewE"]], "cudaq::qview::value_type (c++ type)": [[2, "_CPPv4N5cudaq5qview10value_typeE"]], "cudaq::range (c++ function)": [[2, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType"], [2, "_CPPv4I00EN5cudaq5rangeENSt6vectorI11ElementTypeEE11ElementType11ElementType11ElementType"], [2, "_CPPv4N5cudaq5rangeENSt6size_tE"]], "cudaq::real (c++ type)": [[2, "_CPPv4N5cudaq4realE"]], "cudaq::registry (c++ type)": [[2, "_CPPv4N5cudaq8registryE"]], "cudaq::registry::registeredtype (c++ class)": [[2, "_CPPv4I0EN5cudaq8registry14RegisteredTypeE"]], "cudaq::sample_result (c++ class)": [[2, "_CPPv4N5cudaq13sample_resultE"]], "cudaq::sample_result::append (c++ function)": [[2, "_CPPv4N5cudaq13sample_result6appendER15ExecutionResult"]], "cudaq::sample_result::begin (c++ function)": [[2, "_CPPv4N5cudaq13sample_result5beginEv"], [2, "_CPPv4NK5cudaq13sample_result5beginEv"]], "cudaq::sample_result::cbegin (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result6cbeginEv"]], "cudaq::sample_result::cend (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result4cendEv"]], "cudaq::sample_result::clear (c++ function)": [[2, "_CPPv4N5cudaq13sample_result5clearEv"]], "cudaq::sample_result::count (c++ function)": [[2, "_CPPv4N5cudaq13sample_result5countENSt11string_viewEKNSt11string_viewE"]], "cudaq::sample_result::deserialize (c++ function)": [[2, "_CPPv4N5cudaq13sample_result11deserializeERNSt6vectorINSt6size_tEEE"]], "cudaq::sample_result::dump (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result4dumpERNSt7ostreamE"], [2, "_CPPv4NK5cudaq13sample_result4dumpEv"]], "cudaq::sample_result::end (c++ function)": [[2, "_CPPv4N5cudaq13sample_result3endEv"], [2, "_CPPv4NK5cudaq13sample_result3endEv"]], "cudaq::sample_result::exp_val_z (c++ function)": [[2, "_CPPv4N5cudaq13sample_result9exp_val_zEKNSt11string_viewE"]], "cudaq::sample_result::expectation (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result11expectationEKNSt11string_viewE"]], "cudaq::sample_result::get_marginal (c++ function)": [[2, "_CPPv4N5cudaq13sample_result12get_marginalERKNSt6vectorINSt6size_tEEEKNSt11string_viewE"], [2, "_CPPv4N5cudaq13sample_result12get_marginalERRKNSt6vectorINSt6size_tEEEKNSt11string_viewE"]], "cudaq::sample_result::has_even_parity (c++ function)": [[2, "_CPPv4N5cudaq13sample_result15has_even_parityENSt11string_viewE"]], "cudaq::sample_result::has_expectation (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result15has_expectationEKNSt11string_viewE"]], "cudaq::sample_result::most_probable (c++ function)": [[2, "_CPPv4N5cudaq13sample_result13most_probableEKNSt11string_viewE"]], "cudaq::sample_result::operator+= (c++ function)": [[2, "_CPPv4N5cudaq13sample_resultpLERK13sample_result"]], "cudaq::sample_result::operator= (c++ function)": [[2, "_CPPv4N5cudaq13sample_resultaSER13sample_result"]], "cudaq::sample_result::operator== (c++ function)": [[2, "_CPPv4NK5cudaq13sample_resulteqERK13sample_result"]], "cudaq::sample_result::probability (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result11probabilityENSt11string_viewEKNSt11string_viewE"]], "cudaq::sample_result::register_names (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result14register_namesEv"]], "cudaq::sample_result::reorder (c++ function)": [[2, "_CPPv4N5cudaq13sample_result7reorderERKNSt6vectorINSt6size_tEEEKNSt11string_viewE"]], "cudaq::sample_result::sample_result (c++ function)": [[2, "_CPPv4N5cudaq13sample_result13sample_resultER15ExecutionResult"], [2, "_CPPv4N5cudaq13sample_result13sample_resultERK13sample_result"], [2, "_CPPv4N5cudaq13sample_result13sample_resultERNSt6vectorI15ExecutionResultEE"], [2, "_CPPv4N5cudaq13sample_result13sample_resultERR15ExecutionResult"], [2, "_CPPv4N5cudaq13sample_result13sample_resultEdRNSt6vectorI15ExecutionResultEE"], [2, "_CPPv4N5cudaq13sample_result13sample_resultEv"]], "cudaq::sample_result::serialize (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result9serializeEv"]], "cudaq::sample_result::size (c++ function)": [[2, "_CPPv4N5cudaq13sample_result4sizeEKNSt11string_viewE"]], "cudaq::sample_result::to_map (c++ function)": [[2, "_CPPv4NK5cudaq13sample_result6to_mapEKNSt11string_viewE"]], "cudaq::sample_result::~sample_result (c++ function)": [[2, "_CPPv4N5cudaq13sample_resultD0Ev"]], "cudaq::set_noise (c++ function)": [[2, "_CPPv4N5cudaq9set_noiseERKN5cudaq11noise_modelE"]], "cudaq::set_random_seed (c++ function)": [[2, "_CPPv4N5cudaq15set_random_seedENSt6size_tE"]], "cudaq::simulation_precision (c++ enum)": [[2, "_CPPv4N5cudaq20simulation_precisionE"]], "cudaq::simulation_precision::fp32 (c++ enumerator)": [[2, "_CPPv4N5cudaq20simulation_precision4fp32E"]], "cudaq::simulation_precision::fp64 (c++ enumerator)": [[2, "_CPPv4N5cudaq20simulation_precision4fp64E"]], "cudaq::spin_op (c++ class)": [[2, "_CPPv4N5cudaq7spin_opE"]], "cudaq::spin_op::begin (c++ function)": [[2, "_CPPv4N5cudaq7spin_op5beginEv"], [2, "_CPPv4NK5cudaq7spin_op5beginEv"]], "cudaq::spin_op::csr_spmatrix (c++ type)": [[2, "_CPPv4N5cudaq7spin_op12csr_spmatrixE"]], "cudaq::spin_op::distribute_terms (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op16distribute_termsENSt6size_tE"]], "cudaq::spin_op::dump (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op4dumpEv"]], "cudaq::spin_op::end (c++ function)": [[2, "_CPPv4N5cudaq7spin_op3endEv"], [2, "_CPPv4NK5cudaq7spin_op3endEv"]], "cudaq::spin_op::for_each_pauli (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op14for_each_pauliERRNSt8functionIFv5pauliNSt6size_tEEEE"]], "cudaq::spin_op::for_each_term (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op13for_each_termERRNSt8functionIFvR7spin_opEEE"]], "cudaq::spin_op::from_word (c++ function)": [[2, "_CPPv4N5cudaq7spin_op9from_wordERKNSt6stringE"]], "cudaq::spin_op::getdatarepresentation (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op21getDataRepresentationEv"]], "cudaq::spin_op::getdatatuple (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op12getDataTupleEv"]], "cudaq::spin_op::get_coefficient (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op15get_coefficientEv"]], "cudaq::spin_op::get_raw_data (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op12get_raw_dataEv"]], "cudaq::spin_op::is_identity (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op11is_identityEv"]], "cudaq::spin_op::iterator (c++ struct)": [[2, "_CPPv4I0EN5cudaq7spin_op8iteratorE"]], "cudaq::spin_op::num_qubits (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op10num_qubitsEv"]], "cudaq::spin_op::num_terms (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op9num_termsEv"]], "cudaq::spin_op::operator*= (c++ function)": [[2, "_CPPv4N5cudaq7spin_opmLEKNSt7complexIdEE"], [2, "_CPPv4N5cudaq7spin_opmLEKd"], [2, "_CPPv4N5cudaq7spin_opmLERK7spin_op"]], "cudaq::spin_op::operator+= (c++ function)": [[2, "_CPPv4N5cudaq7spin_oppLERK7spin_op"]], "cudaq::spin_op::operator-= (c++ function)": [[2, "_CPPv4N5cudaq7spin_opmIERK7spin_op"]], "cudaq::spin_op::operator= (c++ function)": [[2, "_CPPv4N5cudaq7spin_opaSERK7spin_op"]], "cudaq::spin_op::operator== (c++ function)": [[2, "_CPPv4NK5cudaq7spin_opeqERK7spin_op"]], "cudaq::spin_op::random (c++ function)": [[2, "_CPPv4N5cudaq7spin_op6randomENSt6size_tENSt6size_tEj"]], "cudaq::spin_op::spin_op (c++ function)": [[2, "_CPPv4N5cudaq7spin_op7spin_opE5pauliKNSt6size_tENSt7complexIdEE"], [2, "_CPPv4N5cudaq7spin_op7spin_opENSt6size_tE"], [2, "_CPPv4N5cudaq7spin_op7spin_opERK12spin_op_termRKNSt7complexIdEE"], [2, "_CPPv4N5cudaq7spin_op7spin_opERK7spin_op"], [2, "_CPPv4N5cudaq7spin_op7spin_opERKNSt13unordered_mapI12spin_op_termNSt7complexIdEEEE"], [2, "_CPPv4N5cudaq7spin_op7spin_opERKNSt4pairIK12spin_op_termNSt7complexIdEEEE"], [2, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorI12spin_op_termEERKNSt6vectorINSt7complexIdEEEE"], [2, "_CPPv4N5cudaq7spin_op7spin_opERKNSt6vectorIdEENSt6size_tE"], [2, "_CPPv4N5cudaq7spin_op7spin_opERNSt4pairIK12spin_op_termNSt7complexIdEEEE"], [2, "_CPPv4N5cudaq7spin_op7spin_opEv"]], "cudaq::spin_op::spin_op_term (c++ type)": [[2, "_CPPv4N5cudaq7spin_op12spin_op_termE"]], "cudaq::spin_op::to_matrix (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op9to_matrixEv"]], "cudaq::spin_op::to_sparse_matrix (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op16to_sparse_matrixEv"]], "cudaq::spin_op::to_string (c++ function)": [[2, "_CPPv4NK5cudaq7spin_op9to_stringEb"]], "cudaq::spin_op::~spin_op (c++ function)": [[2, "_CPPv4N5cudaq7spin_opD0Ev"]], "cudaq::state (c++ class)": [[2, "_CPPv4N5cudaq5stateE"]], "cudaq::state::amplitude (c++ function)": [[2, "_CPPv4N5cudaq5state9amplitudeERKNSt6vectorIiEE"]], "cudaq::state::amplitudes (c++ function)": [[2, "_CPPv4N5cudaq5state10amplitudesERKNSt6vectorINSt6vectorIiEEEE"]], "cudaq::state::dump (c++ function)": [[2, "_CPPv4NK5cudaq5state4dumpERNSt7ostreamE"], [2, "_CPPv4NK5cudaq5state4dumpEv"]], "cudaq::state::from_data (c++ function)": [[2, "_CPPv4N5cudaq5state9from_dataERK10state_data"]], "cudaq::state::get_num_qubits (c++ function)": [[2, "_CPPv4NK5cudaq5state14get_num_qubitsEv"]], "cudaq::state::get_num_tensors (c++ function)": [[2, "_CPPv4NK5cudaq5state15get_num_tensorsEv"]], "cudaq::state::get_precision (c++ function)": [[2, "_CPPv4NK5cudaq5state13get_precisionEv"]], "cudaq::state::get_tensor (c++ function)": [[2, "_CPPv4NK5cudaq5state10get_tensorENSt6size_tE"]], "cudaq::state::get_tensors (c++ function)": [[2, "_CPPv4NK5cudaq5state11get_tensorsEv"]], "cudaq::state::is_on_gpu (c++ function)": [[2, "_CPPv4NK5cudaq5state9is_on_gpuEv"]], "cudaq::state::operator() (c++ function)": [[2, "_CPPv4NK5cudaq5stateclENSt6size_tENSt6size_tE"], [2, "_CPPv4NK5cudaq5stateclERKNSt16initializer_listINSt6size_tEEENSt6size_tE"]], "cudaq::state::operator= (c++ function)": [[2, "_CPPv4N5cudaq5stateaSERR5state"]], "cudaq::state::operator[] (c++ function)": [[2, "_CPPv4NK5cudaq5stateixENSt6size_tE"]], "cudaq::state::overlap (c++ function)": [[2, "_CPPv4N5cudaq5state7overlapERK5state"]], "cudaq::state::state (c++ function)": [[2, "_CPPv4N5cudaq5state5stateEP15SimulationState"], [2, "_CPPv4N5cudaq5state5stateERK5state"]], "cudaq::state::to_host (c++ function)": [[2, "_CPPv4I0ENK5cudaq5state7to_hostEvPNSt7complexI10ScalarTypeEENSt6size_tE"]], "cudaq::state_data (c++ type)": [[2, "_CPPv4N5cudaq10state_dataE"]], "cudaq::tensor (c++ type)": [[2, "_CPPv4N5cudaq6tensorE"]], "cudaq::unset_noise (c++ function)": [[2, "_CPPv4N5cudaq11unset_noiseEv"]], "nvqir::mpssimulationstate (c++ class)": [[2, "_CPPv4N5nvqir18MPSSimulationStateE"]], "nvqir::tensornetsimulationstate (c++ class)": [[2, "_CPPv4N5nvqir24TensorNetSimulationStateE"]], "amplitudedampingchannel (class in cudaq)": [[3, "cudaq.AmplitudeDampingChannel"]], "asyncobserveresult (class in cudaq)": [[3, "cudaq.AsyncObserveResult"]], "asyncsampleresult (class in cudaq)": [[3, "cudaq.AsyncSampleResult"]], "asyncstateresult (class in cudaq)": [[3, "cudaq.AsyncStateResult"]], "bitflipchannel (class in cudaq)": [[3, "cudaq.BitFlipChannel"]], "cobyla (class in cudaq.optimizers)": [[3, "cudaq.optimizers.COBYLA"]], "centraldifference (class in cudaq.gradients)": [[3, "cudaq.gradients.CentralDifference"]], "complexmatrix (class in cudaq)": [[3, "cudaq.ComplexMatrix"]], "depolarizationchannel (class in cudaq)": [[3, "cudaq.DepolarizationChannel"]], "forwarddifference (class in cudaq.gradients)": [[3, "cudaq.gradients.ForwardDifference"]], "gradientdescent (class in cudaq.optimizers)": [[3, "cudaq.optimizers.GradientDescent"]], "kernel (in module cudaq)": [[3, "cudaq.Kernel"]], "krauschannel (class in cudaq)": [[3, "cudaq.KrausChannel"]], "krausoperator (class in cudaq)": [[3, "cudaq.KrausOperator"]], "lbfgs (class in cudaq.optimizers)": [[3, "cudaq.optimizers.LBFGS"]], "neldermead (class in cudaq.optimizers)": [[3, "cudaq.optimizers.NelderMead"]], "noisemodel (class in cudaq)": [[3, "cudaq.NoiseModel"]], "observeresult (class in cudaq)": [[3, "cudaq.ObserveResult"]], "optimizationresult (class in cudaq)": [[3, "cudaq.OptimizationResult"]], "parametershift (class in cudaq.gradients)": [[3, "cudaq.gradients.ParameterShift"]], "phaseflipchannel (class in cudaq)": [[3, "cudaq.PhaseFlipChannel"]], "pykernel (class in cudaq)": [[3, "cudaq.PyKernel"]], "pykerneldecorator (class in cudaq)": [[3, "cudaq.PyKernelDecorator"]], "quakevalue (class in cudaq)": [[3, "cudaq.QuakeValue"]], "sampleresult (class in cudaq)": [[3, "cudaq.SampleResult"]], "simulationprecision (class in cudaq)": [[3, "cudaq.SimulationPrecision"]], "spinoperator (class in cudaq)": [[3, "cudaq.SpinOperator"]], "state (class in cudaq)": [[3, "cudaq.State"]], "target (class in cudaq)": [[3, "cudaq.Target"]], "tensor (class in cudaq)": [[3, "cudaq.Tensor"]], "__add__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__add__"]], "__add__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__add__"]], "__call__() (cudaq.pykerneldecorator method)": [[3, "cudaq.PyKernelDecorator.__call__"]], "__eq__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__eq__"]], "__getitem__() (cudaq.complexmatrix method)": [[3, "cudaq.ComplexMatrix.__getitem__"]], "__getitem__() (cudaq.krauschannel method)": [[3, "cudaq.KrausChannel.__getitem__"]], "__getitem__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__getitem__"]], "__getitem__() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.__getitem__"]], "__init__() (cudaq.amplitudedampingchannel method)": [[3, "cudaq.AmplitudeDampingChannel.__init__"]], "__init__() (cudaq.bitflipchannel method)": [[3, "cudaq.BitFlipChannel.__init__"]], "__init__() (cudaq.depolarizationchannel method)": [[3, "cudaq.DepolarizationChannel.__init__"]], "__init__() (cudaq.noisemodel method)": [[3, "cudaq.NoiseModel.__init__"]], "__init__() (cudaq.phaseflipchannel method)": [[3, "cudaq.PhaseFlipChannel.__init__"]], "__iter__() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.__iter__"]], "__iter__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__iter__"]], "__len__() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.__len__"]], "__mul__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__mul__"]], "__mul__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__mul__"]], "__neg__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__neg__"]], "__radd__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__radd__"]], "__radd__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__radd__"]], "__rmul__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__rmul__"]], "__rmul__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__rmul__"]], "__rsub__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__rsub__"]], "__rsub__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__rsub__"]], "__str__() (cudaq.complexmatrix method)": [[3, "cudaq.ComplexMatrix.__str__"]], "__str__() (cudaq.pykerneldecorator method)": [[3, "cudaq.PyKernelDecorator.__str__"]], "__sub__() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.__sub__"]], "__sub__() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.__sub__"]], "add_all_qubit_channel() (cudaq.noisemodel method)": [[3, "cudaq.NoiseModel.add_all_qubit_channel"]], "add_channel() (cudaq.noisemodel method)": [[3, "cudaq.NoiseModel.add_channel"]], "all_gather() (in module cudaq.mpi)": [[3, "cudaq.mpi.all_gather"]], "amplitude() (cudaq.state method)": [[3, "cudaq.State.amplitude"]], "amplitudes() (cudaq.state method)": [[3, "cudaq.State.amplitudes"]], "append() (cudaq.krauschannel method)": [[3, "cudaq.KrausChannel.append"]], "argument_count (cudaq.pykernel attribute)": [[3, "cudaq.PyKernel.argument_count"]], "arguments (cudaq.pykernel attribute)": [[3, "cudaq.PyKernel.arguments"]], "broadcast() (in module cudaq.mpi)": [[3, "cudaq.mpi.broadcast"]], "clear() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.clear"]], "col_count (cudaq.krausoperator property)": [[3, "cudaq.KrausOperator.col_count"]], "compile() (cudaq.pykerneldecorator method)": [[3, "cudaq.PyKernelDecorator.compile"]], "compute() (cudaq.gradients.centraldifference method)": [[3, "cudaq.gradients.CentralDifference.compute"]], "compute() (cudaq.gradients.forwarddifference method)": [[3, "cudaq.gradients.ForwardDifference.compute"]], "compute() (cudaq.gradients.parametershift method)": [[3, "cudaq.gradients.ParameterShift.compute"]], "count() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.count"]], "counts() (cudaq.observeresult method)": [[3, "cudaq.ObserveResult.counts"]], "cudaq": [[3, "module-cudaq"]], "description (cudaq.target property)": [[3, "cudaq.Target.description"]], "deserialize() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.deserialize"]], "distribute_terms() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.distribute_terms"]], "draw() (in module cudaq)": [[3, "cudaq.draw"]], "dump() (cudaq.observeresult method)": [[3, "cudaq.ObserveResult.dump"]], "dump() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.dump"]], "dump() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.dump"]], "dump() (cudaq.state method)": [[3, "cudaq.State.dump"]], "expectation() (cudaq.observeresult method)": [[3, "cudaq.ObserveResult.expectation"]], "expectation() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.expectation"]], "expectation_z() (cudaq.observeresult method)": [[3, "cudaq.ObserveResult.expectation_z"]], "expectation_z() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.expectation_z"]], "finalize() (in module cudaq.mpi)": [[3, "cudaq.mpi.finalize"]], "for_each_pauli() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.for_each_pauli"]], "for_each_term() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.for_each_term"]], "from_data() (cudaq.state static method)": [[3, "cudaq.State.from_data"]], "from_json() (cudaq.pykerneldecorator static method)": [[3, "cudaq.PyKernelDecorator.from_json"]], "from_json() (cudaq.spinoperator static method)": [[3, "cudaq.SpinOperator.from_json"]], "from_json() (cudaq.gradients.centraldifference static method)": [[3, "cudaq.gradients.CentralDifference.from_json"]], "from_json() (cudaq.gradients.forwarddifference static method)": [[3, "cudaq.gradients.ForwardDifference.from_json"]], "from_json() (cudaq.gradients.parametershift static method)": [[3, "cudaq.gradients.ParameterShift.from_json"]], "from_json() (cudaq.optimizers.cobyla static method)": [[3, "cudaq.optimizers.COBYLA.from_json"]], "from_json() (cudaq.optimizers.gradientdescent static method)": [[3, "cudaq.optimizers.GradientDescent.from_json"]], "from_json() (cudaq.optimizers.lbfgs static method)": [[3, "cudaq.optimizers.LBFGS.from_json"]], "from_json() (cudaq.optimizers.neldermead static method)": [[3, "cudaq.optimizers.NelderMead.from_json"]], "from_word() (cudaq.spinoperator static method)": [[3, "cudaq.SpinOperator.from_word"]], "get() (cudaq.asyncobserveresult method)": [[3, "cudaq.AsyncObserveResult.get"]], "get() (cudaq.asyncsampleresult method)": [[3, "cudaq.AsyncSampleResult.get"]], "get() (cudaq.asyncstateresult method)": [[3, "cudaq.AsyncStateResult.get"]], "gettensor() (cudaq.state method)": [[3, "cudaq.State.getTensor"]], "gettensors() (cudaq.state method)": [[3, "cudaq.State.getTensors"]], "get_channels() (cudaq.noisemodel method)": [[3, "cudaq.NoiseModel.get_channels"]], "get_coefficient() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.get_coefficient"]], "get_marginal_counts() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.get_marginal_counts"]], "get_precision() (cudaq.target method)": [[3, "cudaq.Target.get_precision"]], "get_qubit_count() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.get_qubit_count"]], "get_raw_data() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.get_raw_data"]], "get_register_counts() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.get_register_counts"]], "get_sequential_data() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.get_sequential_data"]], "get_spin() (cudaq.observeresult method)": [[3, "cudaq.ObserveResult.get_spin"]], "get_state() (in module cudaq)": [[3, "cudaq.get_state"]], "get_state_async() (in module cudaq)": [[3, "cudaq.get_state_async"]], "get_target() (in module cudaq)": [[3, "cudaq.get_target"]], "get_targets() (in module cudaq)": [[3, "cudaq.get_targets"]], "get_term_count() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.get_term_count"]], "gradient (class in cudaq.gradients)": [[3, "cudaq.gradients.gradient"]], "has_target() (in module cudaq)": [[3, "cudaq.has_target"]], "initial_parameters (cudaq.optimizers.cobyla property)": [[3, "cudaq.optimizers.COBYLA.initial_parameters"]], "initial_parameters (cudaq.optimizers.gradientdescent property)": [[3, "cudaq.optimizers.GradientDescent.initial_parameters"]], "initial_parameters (cudaq.optimizers.lbfgs property)": [[3, "cudaq.optimizers.LBFGS.initial_parameters"]], "initial_parameters (cudaq.optimizers.neldermead property)": [[3, "cudaq.optimizers.NelderMead.initial_parameters"]], "initialize() (in module cudaq.mpi)": [[3, "cudaq.mpi.initialize"]], "initialize_cudaq() (in module cudaq)": [[3, "cudaq.initialize_cudaq"]], "is_emulated() (cudaq.target method)": [[3, "cudaq.Target.is_emulated"]], "is_identity() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.is_identity"]], "is_initialized() (in module cudaq.mpi)": [[3, "cudaq.mpi.is_initialized"]], "is_on_gpu() (cudaq.state method)": [[3, "cudaq.State.is_on_gpu"]], "is_remote() (cudaq.target method)": [[3, "cudaq.Target.is_remote"]], "items() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.items"]], "kernel() (in module cudaq)": [[3, "cudaq.kernel"]], "lower_bounds (cudaq.optimizers.cobyla property)": [[3, "cudaq.optimizers.COBYLA.lower_bounds"]], "lower_bounds (cudaq.optimizers.gradientdescent property)": [[3, "cudaq.optimizers.GradientDescent.lower_bounds"]], "lower_bounds (cudaq.optimizers.lbfgs property)": [[3, "cudaq.optimizers.LBFGS.lower_bounds"]], "lower_bounds (cudaq.optimizers.neldermead property)": [[3, "cudaq.optimizers.NelderMead.lower_bounds"]], "make_kernel() (in module cudaq)": [[3, "cudaq.make_kernel"]], "max_iterations (cudaq.optimizers.cobyla property)": [[3, "cudaq.optimizers.COBYLA.max_iterations"]], "max_iterations (cudaq.optimizers.gradientdescent property)": [[3, "cudaq.optimizers.GradientDescent.max_iterations"]], "max_iterations (cudaq.optimizers.lbfgs property)": [[3, "cudaq.optimizers.LBFGS.max_iterations"]], "max_iterations (cudaq.optimizers.neldermead property)": [[3, "cudaq.optimizers.NelderMead.max_iterations"]], "minimal_eigenvalue() (cudaq.complexmatrix method)": [[3, "cudaq.ComplexMatrix.minimal_eigenvalue"]], "module": [[3, "module-cudaq"]], "most_probable() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.most_probable"]], "name (cudaq.pykernel attribute)": [[3, "cudaq.PyKernel.name"]], "name (cudaq.simulationprecision property)": [[3, "cudaq.SimulationPrecision.name"]], "name (cudaq.target property)": [[3, "cudaq.Target.name"]], "num_available_gpus() (in module cudaq)": [[3, "cudaq.num_available_gpus"]], "num_qpus() (cudaq.target method)": [[3, "cudaq.Target.num_qpus"]], "num_qubits() (cudaq.state method)": [[3, "cudaq.State.num_qubits"]], "num_ranks() (in module cudaq.mpi)": [[3, "cudaq.mpi.num_ranks"]], "observe() (in module cudaq)": [[3, "cudaq.observe"]], "observe_async() (in module cudaq)": [[3, "cudaq.observe_async"]], "optimize() (cudaq.optimizers.cobyla method)": [[3, "cudaq.optimizers.COBYLA.optimize"]], "optimize() (cudaq.optimizers.gradientdescent method)": [[3, "cudaq.optimizers.GradientDescent.optimize"]], "optimize() (cudaq.optimizers.lbfgs method)": [[3, "cudaq.optimizers.LBFGS.optimize"]], "optimize() (cudaq.optimizers.neldermead method)": [[3, "cudaq.optimizers.NelderMead.optimize"]], "optimizer (class in cudaq.optimizers)": [[3, "cudaq.optimizers.optimizer"]], "overlap() (cudaq.state method)": [[3, "cudaq.State.overlap"]], "platform (cudaq.target property)": [[3, "cudaq.Target.platform"]], "probability() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.probability"]], "qreg (in module cudaq)": [[3, "cudaq.qreg"]], "qubit (class in cudaq)": [[3, "cudaq.qubit"]], "qvector (class in cudaq)": [[3, "cudaq.qvector"]], "random() (cudaq.spinoperator static method)": [[3, "cudaq.SpinOperator.random"]], "rank() (in module cudaq.mpi)": [[3, "cudaq.mpi.rank"]], "register_names (cudaq.sampleresult attribute)": [[3, "cudaq.SampleResult.register_names"]], "requires_gradients() (cudaq.optimizers.cobyla method)": [[3, "cudaq.optimizers.COBYLA.requires_gradients"]], "requires_gradients() (cudaq.optimizers.gradientdescent method)": [[3, "cudaq.optimizers.GradientDescent.requires_gradients"]], "requires_gradients() (cudaq.optimizers.lbfgs method)": [[3, "cudaq.optimizers.LBFGS.requires_gradients"]], "requires_gradients() (cudaq.optimizers.neldermead method)": [[3, "cudaq.optimizers.NelderMead.requires_gradients"]], "reset_target() (in module cudaq)": [[3, "cudaq.reset_target"]], "row_count (cudaq.krausoperator property)": [[3, "cudaq.KrausOperator.row_count"]], "sample() (in module cudaq)": [[3, "cudaq.sample"]], "sample() (in module cudaq.orca)": [[3, "cudaq.orca.sample"]], "sample_async() (in module cudaq)": [[3, "cudaq.sample_async"]], "serialize() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.serialize"]], "serialize() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.serialize"]], "set_noise() (in module cudaq)": [[3, "cudaq.set_noise"]], "set_random_seed() (in module cudaq)": [[3, "cudaq.set_random_seed"]], "set_target() (in module cudaq)": [[3, "cudaq.set_target"]], "simulator (cudaq.target property)": [[3, "cudaq.Target.simulator"]], "slice() (cudaq.quakevalue method)": [[3, "cudaq.QuakeValue.slice"]], "spin.i() (in module cudaq)": [[3, "cudaq.spin.i"]], "spin.x() (in module cudaq)": [[3, "cudaq.spin.x"]], "spin.y() (in module cudaq)": [[3, "cudaq.spin.y"]], "spin.z() (in module cudaq)": [[3, "cudaq.spin.z"]], "to_json() (cudaq.pykerneldecorator method)": [[3, "cudaq.PyKernelDecorator.to_json"]], "to_json() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.to_json"]], "to_json() (cudaq.gradients.centraldifference method)": [[3, "cudaq.gradients.CentralDifference.to_json"]], "to_json() (cudaq.gradients.forwarddifference method)": [[3, "cudaq.gradients.ForwardDifference.to_json"]], "to_json() (cudaq.gradients.parametershift method)": [[3, "cudaq.gradients.ParameterShift.to_json"]], "to_json() (cudaq.optimizers.cobyla method)": [[3, "cudaq.optimizers.COBYLA.to_json"]], "to_json() (cudaq.optimizers.gradientdescent method)": [[3, "cudaq.optimizers.GradientDescent.to_json"]], "to_json() (cudaq.optimizers.lbfgs method)": [[3, "cudaq.optimizers.LBFGS.to_json"]], "to_json() (cudaq.optimizers.neldermead method)": [[3, "cudaq.optimizers.NelderMead.to_json"]], "to_matrix() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.to_matrix"]], "to_sparse_matrix() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.to_sparse_matrix"]], "to_string() (cudaq.spinoperator method)": [[3, "cudaq.SpinOperator.to_string"]], "translate() (in module cudaq)": [[3, "cudaq.translate"]], "type_to_str() (cudaq.pykerneldecorator static method)": [[3, "cudaq.PyKernelDecorator.type_to_str"]], "unset_noise() (in module cudaq)": [[3, "cudaq.unset_noise"]], "upper_bounds (cudaq.optimizers.cobyla property)": [[3, "cudaq.optimizers.COBYLA.upper_bounds"]], "upper_bounds (cudaq.optimizers.gradientdescent property)": [[3, "cudaq.optimizers.GradientDescent.upper_bounds"]], "upper_bounds (cudaq.optimizers.lbfgs property)": [[3, "cudaq.optimizers.LBFGS.upper_bounds"]], "upper_bounds (cudaq.optimizers.neldermead property)": [[3, "cudaq.optimizers.NelderMead.upper_bounds"]], "values() (cudaq.sampleresult method)": [[3, "cudaq.SampleResult.values"]], "vqe() (in module cudaq)": [[3, "cudaq.vqe"]]}})
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq.html b/pr-2241/specification/cudaq.html
new file mode 100644
index 0000000000..6800e10b85
--- /dev/null
+++ b/pr-2241/specification/cudaq.html
@@ -0,0 +1,690 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Language Specification &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="1. Machine Model" href="cudaq/machine_model.html" />
+    <link rel="prev" title="Specifications" href="index.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="index.html">Specifications</a></li>
+      <li class="breadcrumb-item active">Language Specification</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/specification/cudaq.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="index.html" class="btn btn-neutral float-left" title="Specifications" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cudaq/machine_model.html" class="btn btn-neutral float-right" title="1. Machine Model" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="language-specification">
+<h1>Language Specification<a class="headerlink" href="#language-specification" title="Permalink to this heading">¶</a></h1>
+<p>NVIDIA CUDA-Q is a programming model in C++ for heterogeneous
+quantum-classical computing. As such, the model provides primitive types, concepts, syntax, and
+semantics that enable the integration of quantum processing units (QPUs) with
+existing NVIDIA multi-node, multi-GPU parallel programming models and architectures.
+The language is designed for C++. Extensions to other languages is fully supported
+via appropriate bindings.</p>
+<p>CUDA-Q implementations are intended to be enabled via library-based language
+extensions that define quantum code as callables in the classical language being extended.
+These callables are meant to be compiled with standard compilers and runtimes
+and run via quantum computer simulators or available physical quantum architectures. The
+language callables intended for quantum coprocessing must be annotated for
+compilers and runtimes to process. These annotations should directly enable quantum-specific
+optimization and transformation for optimal execution on simulators and QPUs.</p>
+<p>The rest of this document will detail all aspects of the language specification - its machine model,
+primitive types and operations, core concepts and abstractions, and algorithmic primitives. All code
+specification and demonstrative examples are provided in C++ (the native CUDA-Q classical language).
+Where possible, bindings for higher-level languages (e.g. Python) will be displayed to aid in understanding.</p>
+<div class="toctree-wrapper compound">
+<p class="caption" role="heading"><span class="caption-text">CUDA-Q</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/types.html">3. Quantum Types</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/operators.html">4. Quantum Operators</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/operations.html">5. Quantum Operations</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/patterns.html">10. Quantum Patterns</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq/examples.html">13. Example Programs</a></li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="index.html" class="btn btn-neutral float-left" title="Specifications" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cudaq/machine_model.html" class="btn btn-neutral float-right" title="1. Machine Model" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/algorithmic_primitives.html b/pr-2241/specification/cudaq/algorithmic_primitives.html
new file mode 100644
index 0000000000..e313cfeb54
--- /dev/null
+++ b/pr-2241/specification/cudaq/algorithmic_primitives.html
@@ -0,0 +1,1245 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>12. Quantum Algorithmic Primitives &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="13. Example Programs" href="examples.html" />
+    <link rel="prev" title="11. Quantum Platform" href="platform.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">12. </span>Quantum Algorithmic Primitives</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/algorithmic_primitives.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="platform.html" class="btn btn-neutral float-left" title="11. Quantum Platform" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="examples.html" class="btn btn-neutral float-right" title="13. Example Programs" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-algorithmic-primitives">
+<h1><span class="section-number">12. </span>Quantum Algorithmic Primitives<a class="headerlink" href="#quantum-algorithmic-primitives" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> The general philosophy of the CUDA-Q specification is that quantum
+device code should be encapsulated as stand-alone callable instances of generic
+signature, and that operations or primitive algorithms targeting a quantum
+coprocessor be implemented as adaptors on those callable instances. Adaptors, by
+definition, are generic functions that take any quantum kernel as input along with
+the runtime arguments for that kernel. Runtime arguments passed to adaptor functions
+flow through the adaptor to the provided kernel. This pattern allows general pre-
+and post-processing around concrete kernel execution.</p>
+<section id="cudaq-sample">
+<span id="cudaq-sample-spec"></span><h2><span class="section-number">12.1. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code><a class="headerlink" href="#cudaq-sample" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> A common task for near-term quantum execution is to sample the state
+of a given quantum circuit for a specified number of shots (circuit
+executions). The result of this task is typically a mapping of observed
+measurement bit strings to the number of times each was observed. This
+is typically termed the counts dictionary in the community.</p>
+<p><strong>[2]</strong> The CUDA-Q model enables this functionality via template functions within the
+<code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> namespace with the following structure:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">ReturnType</span><span class="o">&gt;</span>
+<span class="k">concept</span><span class="w"> </span><span class="nc">HasVoidReturnType</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">is_void_v</span><span class="o">&lt;</span><span class="n">ReturnType</span><span class="o">&gt;</span><span class="p">;</span>
+
+<span class="c1">// Kernel only</span>
+<span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">requires</span><span class="w"> </span><span class="n">HasVoidReturnType</span><span class="o">&lt;</span><span class="n">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;</span>
+<span class="n">sample_result</span><span class="w"> </span><span class="n">sample</span><span class="p">(</span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="c1">// Specify shots</span>
+<span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">requires</span><span class="w"> </span><span class="n">HasVoidReturnType</span><span class="o">&lt;</span><span class="n">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;</span>
+<span class="n">sample_result</span><span class="w"> </span><span class="n">sample</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">shots</span><span class="p">,</span><span class="w"> </span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="c1">// Specify sample options (including shots and noise model)</span>
+<span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">requires</span><span class="w"> </span><span class="n">HasVoidReturnType</span><span class="o">&lt;</span><span class="n">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;</span>
+<span class="n">sample_result</span><span class="w"> </span><span class="n">sample</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">sample_options</span><span class="w"> </span><span class="o">&amp;</span><span class="n">options</span><span class="p">,</span>
+<span class="w">                     </span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+</pre></div>
+</div>
+<p><strong>[3]</strong> This function takes as input a quantum kernel instance followed by the
+concrete arguments at which the kernel should be invoked. CUDA-Q kernels
+passed to this function must be entry-point kernels and return <code class="code docutils literal notranslate"><span class="pre">void</span></code>.</p>
+<p><strong>[4]</strong> Overloaded functions exist for specifying the number of shots to sample and the
+noise model to apply.</p>
+<p><strong>[5]</strong> The function returns an instance of the <code class="code docutils literal notranslate"><span class="pre">cudaq::sample_result</span></code> type which encapsulates
+the counts dictionary produced by the sampling task. Programmers can
+extract the result information in the following manner:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">bell</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">};</span>
+
+<span class="c1">// Sample the state generated by bel</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">bell</span><span class="p">)</span>
+
+<span class="c1">// Print to standard out</span>
+<span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="c1">// Fine-grained access to the bits and counts</span>
+<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="o">&amp;</span><span class="w"> </span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Observed: %s, %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">bell</span><span class="p">():</span>
+   <span class="o">...</span>
+
+<span class="c1"># Sample the state generated by bell</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">bell</span><span class="p">)</span>
+
+<span class="c1"># Print to standard out</span>
+<span class="n">counts</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+
+<span class="c1"># Fine-grained access to the bits and counts</span>
+<span class="k">for</span> <span class="n">bits</span><span class="p">,</span> <span class="n">count</span> <span class="ow">in</span> <span class="n">counts</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Observed: </span><span class="si">{}</span><span class="s1">, </span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">bits</span><span class="p">,</span> <span class="n">count</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[6]</strong> CUDA-Q specifies the following structure for <code class="code docutils literal notranslate"><span class="pre">cudaq::sample_result</span></code>:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="n">CountsDictionary</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">unordered_map</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="p">;</span>
+<span class="w">  </span><span class="kr">inline</span><span class="w"> </span><span class="k">static</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;__global__&quot;</span><span class="p">;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">sample_result</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="n">sample_result</span><span class="p">()</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">default</span><span class="p">;</span>
+<span class="w">      </span><span class="n">sample_result</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">sample_result</span><span class="w"> </span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="o">~</span><span class="n">sample_result</span><span class="p">();</span>
+
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="o">&gt;</span><span class="w"> </span><span class="n">register_names</span><span class="p">();</span>
+
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">count</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">bitString</span><span class="p">,</span>
+<span class="w">                  </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">sequential_data</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+
+<span class="w">      </span><span class="n">CountsDictionary</span>
+<span class="w">      </span><span class="nf">to_map</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+
+<span class="w">      </span><span class="n">sample_result</span>
+<span class="w">      </span><span class="nf">get_marginal</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">marginalIndices</span><span class="p">,</span>
+<span class="w">             </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+
+<span class="w">      </span><span class="kt">double</span><span class="w"> </span><span class="nf">expectation</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+<span class="w">      </span><span class="kt">double</span><span class="w"> </span><span class="nf">probability</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">bitString</span><span class="p">,</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">size</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="n">registerName</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GlobalRegisterName</span><span class="p">);</span>
+
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">dump</span><span class="p">();</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">clear</span><span class="p">();</span>
+
+<span class="w">      </span><span class="n">CountsDictionary</span><span class="o">::</span><span class="n">iterator</span><span class="w"> </span><span class="nf">begin</span><span class="p">();</span>
+<span class="w">      </span><span class="n">CountsDictionary</span><span class="o">::</span><span class="n">iterator</span><span class="w"> </span><span class="nf">end</span><span class="p">();</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p><strong>[7]</strong> The <code class="code docutils literal notranslate"><span class="pre">sample_result</span></code> type enables one to encode measurement results from a
+quantum circuit sampling task. It keeps track of a list of sample results, each
+one corresponding to a measurement action during the sampling process and represented
+by a unique register name. It also tracks a unique global register, the implicit sampling
+of the state at the end of circuit execution. The API gives fine-grain access
+to the measurement results for each register. To illustrate this, observe</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">reg1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">reset</span><span class="w"> </span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="p">};</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">).</span><span class="n">dump</span><span class="p">();</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+   <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+   <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+   <span class="n">reg1</span> <span class="o">=</span> <span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+   <span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+   <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>should produce</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="o">{</span>
+<span class="w">  </span>__global__<span class="w"> </span>:<span class="w"> </span><span class="o">{</span><span class="w"> </span><span class="m">1</span>:1000<span class="w"> </span><span class="o">}</span>
+<span class="w">  </span>reg1<span class="w"> </span>:<span class="w"> </span><span class="o">{</span><span class="w"> </span><span class="m">0</span>:501<span class="w"> </span><span class="m">1</span>:499<span class="w"> </span><span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+</div>
+<p>Here we see that we have measured a qubit in a uniform superposition to a
+register named <code class="code docutils literal notranslate"><span class="pre">reg1</span></code>, and followed it with a reset and the application
+of an NOT operation. The <code class="code docutils literal notranslate"><span class="pre">sample_result</span></code> returned for this sampling
+tasks contains the default <code class="code docutils literal notranslate"><span class="pre">__global__</span></code> register as well as the user
+specified <code class="code docutils literal notranslate"><span class="pre">reg1</span></code> register.</p>
+<p>The contents of the <code class="code docutils literal notranslate"><span class="pre">__global__</span></code> register will depend on how your kernel
+is written:</p>
+<ol class="arabic simple">
+<li><p>If no measurements appear in the kernel, then the <code class="code docutils literal notranslate"><span class="pre">__global__</span></code>
+register is formed with implicit measurements being added for <em>all</em> the
+qubits defined in the kernel, and the measurements all occur at the end of
+the kernel. The order of the bits in the bitstring corresponds to the qubit
+allocation order specified in the kernel.  That is - the <code class="code docutils literal notranslate"><span class="pre">[0]</span></code> element
+in the <code class="code docutils literal notranslate"><span class="pre">__global__</span></code> bitstring corresponds with the first declared qubit
+in the kernel. For example,</p></li>
+</ol>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">a</span><span class="p">,</span><span class="w"> </span><span class="n">b</span><span class="p">;</span>
+<span class="w">  </span><span class="n">x</span><span class="p">(</span><span class="n">a</span><span class="p">);</span>
+<span class="p">};</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">).</span><span class="n">dump</span><span class="p">();</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">a</span><span class="p">,</span> <span class="n">b</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">a</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>should produce</p>
+<blockquote>
+<div><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="o">{</span>
+<span class="w">  </span>__global__<span class="w"> </span>:<span class="w"> </span><span class="o">{</span><span class="w"> </span><span class="m">10</span>:1000<span class="w"> </span><span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+</div>
+</div></blockquote>
+<ol class="arabic simple" start="2">
+<li><p>Conversely, if any measurements appear in the kernel, then only the measured
+qubits will appear in the <code class="code docutils literal notranslate"><span class="pre">__global__</span></code> register. Similar to #1, the
+bitstring corresponds to the qubit allocation order specified in the kernel.
+Also (again, similar to #1), the values of the sampled qubits always
+correspond to the values <em>at the end of the kernel execution</em>. That is - if a
+qubit is measured in the middle of a kernel and subsequent operations change
+the state of the qubit, the qubit will be implicitly re-measured at the end
+of the kernel, and that re-measured value is the value that will appear in
+the <code class="code docutils literal notranslate"><span class="pre">__global__</span></code> register. For example,</p></li>
+</ol>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">a</span><span class="p">,</span><span class="w"> </span><span class="n">b</span><span class="p">;</span>
+<span class="w">  </span><span class="n">x</span><span class="p">(</span><span class="n">a</span><span class="p">);</span>
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">b</span><span class="p">);</span>
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">a</span><span class="p">);</span>
+<span class="p">};</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">).</span><span class="n">dump</span><span class="p">();</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">a</span><span class="p">,</span> <span class="n">b</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">a</span><span class="p">)</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">b</span><span class="p">)</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">a</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>should produce</p>
+<blockquote>
+<div><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="o">{</span>
+<span class="w">  </span>__global__<span class="w"> </span>:<span class="w"> </span><span class="o">{</span><span class="w"> </span><span class="m">10</span>:1000<span class="w"> </span><span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+</div>
+</div></blockquote>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you don’t specify any measurements in your kernel and allow the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code>
+compiler to perform passes that introduce ancilla qubits into your kernel, it
+may be difficult to discern which qubits are the ancilla qubits vs which ones
+are your qubits. In this case, it is recommended that you provide explicit
+measurements in your kernel in order to only receive measurements from your
+qubits and silently discard the measurements from the ancillary qubits.</p>
+</div>
+<p><strong>[8]</strong> The API exposed by the <code class="code docutils literal notranslate"><span class="pre">sample_result</span></code> data type allows one to extract
+the information contained at a variety of levels and for each available
+register name. One can get the number of times a bit string was observed via
+<code class="code docutils literal notranslate"><span class="pre">sample_result::count</span></code>, extract a <code class="code docutils literal notranslate"><span class="pre">std::unordered_map</span></code> representation via
+<code class="code docutils literal notranslate"><span class="pre">sample_result::to_map</span></code>, get a new <code class="code docutils literal notranslate"><span class="pre">sample_result</span></code> instance over a subset of
+measured qubits via <code class="code docutils literal notranslate"><span class="pre">sample_result::get_marginal</span></code>, and extract the
+measurement data as it was produced sequentially (a vector of bit string observations
+for each shot in the sampling process). One can also compute probabilities and expectation
+values.</p>
+<p><strong>[9]</strong> There are specific requirements on input quantum kernels for the use of the
+sample function which must be enforced by compiler implementations. The kernel
+must be an entry-point kernel that returns <code class="code docutils literal notranslate"><span class="pre">void</span></code>.</p>
+<p><strong>[10]</strong> CUDA-Q also provides an asynchronous version of this function
+(<code class="code docutils literal notranslate"><span class="pre">cudaq::sample_async</span></code>) which returns a <code class="code docutils literal notranslate"><span class="pre">sample_async_result</span></code>.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="n">async_sample_result</span><span class="w"> </span><span class="n">sample_async</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qpu_id</span><span class="p">,</span><span class="w"> </span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Programmers can asynchronously launch sampling tasks on any <code class="code docutils literal notranslate"><span class="pre">qpu_id</span></code>.</p>
+<p><strong>[11]</strong> The <code class="code docutils literal notranslate"><span class="pre">async_sample_result</span></code> wraps a <code class="code docutils literal notranslate"><span class="pre">std::future&lt;sample_result&gt;</span></code> and exposes the same
+<code class="code docutils literal notranslate"><span class="pre">get()</span></code> functionality to extract the results after asynchronous execution.</p>
+<p><strong>[12]</strong> For remote QPU systems with long queue times, the <code class="code docutils literal notranslate"><span class="pre">async_sample_result</span></code> type encodes job ID
+information and can be persisted to file and loaded from file at a later time. After loading from file,
+and when remote queue jobs are completed, one can invoke <code class="code docutils literal notranslate"><span class="pre">get()</span></code> and the results will
+be retrieved and returned.</p>
+</section>
+<section id="cudaq-observe">
+<h2><span class="section-number">12.2. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code><a class="headerlink" href="#cudaq-observe" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> A common task in variational algorithms is the computation of the expected
+value of a given observable with respect to a parameterized quantum circuit
+(<span class="math notranslate nohighlight">\(\langle H \rangle(𝚹) = \langle \psi(𝚹)|H|\psi(𝚹) \rangle\)</span>).</p>
+<p><strong>[2]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> function is provided to enable one to quickly compute
+this expectation value via execution of the parameterized quantum circuit
+with repeated measurements in the bases of the provided <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> terms. The
+function has the following signature:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Kernel only</span>
+<span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="n">observe_result</span><span class="w"> </span><span class="n">observe</span><span class="p">(</span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="c1">// Specify shots</span>
+<span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="n">observe_result</span><span class="w"> </span><span class="n">observe</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">shots</span><span class="p">,</span><span class="w"> </span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="c1">// Specify sample options (including shots and noise model)</span>
+<span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="n">observe_result</span><span class="w"> </span><span class="n">observe</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe_options</span><span class="w"> </span><span class="o">&amp;</span><span class="n">options</span><span class="p">,</span>
+<span class="w">                      </span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+</pre></div>
+</div>
+<p><strong>[3]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> takes as input an instantiated quantum kernel, the
+<code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code> whose expectation is requested, and the concrete
+arguments used as input to the parameterized quantum kernel.</p>
+<p><strong>[4]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> returns an instance of the <code class="code docutils literal notranslate"><span class="pre">observe_result</span></code> type which can be implicitly
+converted to a <code class="code docutils literal notranslate"><span class="pre">double</span></code> expectation value, but also retains all data directly
+generated and used as part of that expectation value computation. The
+<code class="code docutils literal notranslate"><span class="pre">observe_result</span></code> takes on the following form:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">class</span><span class="w"> </span><span class="nc">observe_result</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">public</span><span class="o">:</span>
+<span class="w">    </span><span class="n">observe_result</span><span class="p">(</span><span class="kt">double</span><span class="w"> </span><span class="o">&amp;</span><span class="n">e</span><span class="p">,</span><span class="w"> </span><span class="n">spin_op</span><span class="w"> </span><span class="o">&amp;</span><span class="n">H</span><span class="p">);</span>
+<span class="w">    </span><span class="n">observe_result</span><span class="p">(</span><span class="kt">double</span><span class="w"> </span><span class="o">&amp;</span><span class="n">e</span><span class="p">,</span><span class="w"> </span><span class="n">spin_op</span><span class="w"> </span><span class="o">&amp;</span><span class="n">H</span><span class="p">,</span><span class="w"> </span><span class="n">MeasureCounts</span><span class="w"> </span><span class="n">counts</span><span class="p">);</span>
+
+<span class="w">    </span><span class="n">sample_results</span><span class="w"> </span><span class="nf">raw_data</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">data</span><span class="p">;</span><span class="w"> </span><span class="p">};</span>
+<span class="w">    </span><span class="k">operator</span><span class="w"> </span><span class="kt">double</span><span class="p">();</span>
+<span class="w">    </span><span class="kt">double</span><span class="w"> </span><span class="nf">expectation</span><span class="p">();</span>
+
+<span class="w">    </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">SpinOpType</span><span class="o">&gt;</span>
+<span class="w">    </span><span class="kt">double</span><span class="w"> </span><span class="n">expectation</span><span class="p">(</span><span class="n">SpinOpType</span><span class="w"> </span><span class="n">term</span><span class="p">);</span>
+
+<span class="w">    </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">SpinOpType</span><span class="o">&gt;</span>
+<span class="w">    </span><span class="n">sample_result</span><span class="w"> </span><span class="n">counts</span><span class="p">(</span><span class="n">SpinOpType</span><span class="w"> </span><span class="n">term</span><span class="p">);</span>
+<span class="w">    </span><span class="kt">double</span><span class="w"> </span><span class="nf">id_coefficient</span><span class="p">()</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">dump</span><span class="p">();</span>
+<span class="p">};</span>
+</pre></div>
+</div>
+<p><strong>[5]</strong> The public API for <code class="code docutils literal notranslate"><span class="pre">observe_result</span></code> enables one to extract the
+<code class="code docutils literal notranslate"><span class="pre">sample_result</span></code> data for each term in the provided <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code>.
+This return type can be used in the following way.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// I only care about the expected value, discard</span>
+<span class="c1">// the fine-grain data produced</span>
+<span class="kt">double</span><span class="w"> </span><span class="n">expVal</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">spinOp</span><span class="p">,</span><span class="w"> </span><span class="n">args</span><span class="p">...);</span>
+
+<span class="c1">// I require the result with all generated data</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">spinOp</span><span class="p">,</span><span class="w"> </span><span class="n">args</span><span class="p">...);</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">expVal</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span><span class="p">.</span><span class="n">expectation</span><span class="p">();</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">X0X1Exp</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span><span class="p">.</span><span class="n">expectation</span><span class="p">(</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="o">*</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">));</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">X0X1Data</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">result</span><span class="p">.</span><span class="n">counts</span><span class="p">(</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="o">*</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">));</span>
+<span class="n">result</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># I require the result with all generated data</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="p">::</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">spinOp</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">)</span>
+<span class="n">expVal</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="n">X0X1Exp</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">(</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="o">*</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">))</span>
+<span class="n">X0X1Data</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">counts</span><span class="p">(</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="o">*</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">))</span>
+<span class="n">result</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Here is an example of the utility of the <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> function:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--5-input--1" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">ansatz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()(</span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span><span class="w"> </span><span class="c1">// make it easier to use pauli X,Y,Z below</span>
+
+<span class="w">  </span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">              </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">  </span><span class="kt">double</span><span class="w"> </span><span class="n">energy</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">{},</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="mf">.59</span><span class="p">);</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Energy is %lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">energy</span><span class="p">);</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--5-input--2" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">ansatz</span><span class="p">(</span><span class="n">theta</span> <span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+   <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+   <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+   <span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+   <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+<span class="n">h</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span>
+                <span class="mf">.21829</span> <span class="o">*</span> <span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+<span class="n">energy</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">,</span> <span class="n">h</span><span class="p">,</span> <span class="mf">.59</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Energy is </span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">energy</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[5]</strong> There are specific requirements on input quantum kernels for the use of the
+observe function which must be enforced by compiler implementations. The
+kernel must be an entry-point kernel that does not contain any conditional
+or measurement statements.</p>
+<p><strong>[6]</strong> By default on simulation backends, <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> computes the true
+analytic expectation value (i.e. without stochastic noise due to shots-based sampling).
+If a specific shot count is provided then the returned expectation value will contain some
+level of statistical noise. Overloaded <code class="code docutils literal notranslate"><span class="pre">observe</span></code> functions are provided to
+specify the number of shots and/or specify the noise model to apply.</p>
+<p><strong>[7]</strong> CUDA-Q also provides an asynchronous version of this function
+(<code class="code docutils literal notranslate"><span class="pre">cudaq::observe_async</span></code>) which returns a <code class="code docutils literal notranslate"><span class="pre">async_observe_result</span></code>.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="n">async_observe_result</span><span class="w"> </span><span class="n">observe_async</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qpu_id</span><span class="p">,</span><span class="w"> </span><span class="n">QuantumKernel</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="o">&amp;&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Programmers can asynchronously launch sampling tasks on any <code class="code docutils literal notranslate"><span class="pre">qpu_id</span></code>.</p>
+<p><strong>[8]</strong> For remote QPU systems with long queue times, the <code class="code docutils literal notranslate"><span class="pre">async_observe_result</span></code> type encodes job ID
+information for each execution and can be persisted to file and loaded from file at a later time. After loading from file,
+and when remote queue jobs are completed, one can invoke <code class="code docutils literal notranslate"><span class="pre">get()</span></code> and the results will
+be retrieved and returned.</p>
+</section>
+<section id="cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">
+<h2><span class="section-number">12.3. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)<a class="headerlink" href="#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries" title="Permalink to this heading">¶</a></h2>
+<p>The primary use case for <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> is to leverage it as
+the core of a broader objective function optimization workflow.
+<code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> produces the expected value of a specified
+<code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> with respect to a given parameterized ansatz at a concrete
+set of parameters, and often programmers will require an extremal value of that expected value
+at a specific set of concrete parameters. This will directly require
+abstractions for gradient-based and gradient-free optimization strategies.</p>
+<p>The CUDA-Q model provides a <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> data type that exposes
+an <code class="code docutils literal notranslate"><span class="pre">optimize()</span></code> method that takes as input an
+<code class="code docutils literal notranslate"><span class="pre">optimizable_function</span></code> to optimize and the number of independent
+function dimensions. Implementations are free to implement this abstraction
+in any way that is pertinent, but it is expected that most approaches will
+enable optimization strategy extensibility. For example, programmers should
+be able to instantiate a specific <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> sub-type, thereby
+dictating the underlying optimization algorithm in a type-safe manner.
+Moreover, the optimizer should expose a public API of pertinent optimizer-specific
+options that the programmer can customize.</p>
+<p>CUDA-Q models the <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> as follows:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Encode the optimal value and optimal parameters</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="n">optimization_result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">tuple</span><span class="o">&lt;</span><span class="kt">double</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&gt;</span><span class="p">;</span>
+<span class="w">  </span><span class="c1">// Initialized with user specified callable of a specific signature</span>
+<span class="w">  </span><span class="c1">// Clients can query if the function computes gradients or not</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">optimizable_function</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">Callable</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">optimizable_function</span><span class="p">(</span><span class="n">Callable</span><span class="o">&amp;&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="kt">bool</span><span class="w"> </span><span class="nf">providesGradients</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">_providesGradients</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
+<span class="w">      </span><span class="kt">double</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">dx</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">optimizer</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="k">virtual</span><span class="w"> </span><span class="kt">bool</span><span class="w"> </span><span class="n">requiresGradients</span><span class="p">()</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">      </span><span class="k">virtual</span><span class="w"> </span><span class="n">optimization_result</span><span class="w"> </span><span class="nf">optimize</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">dimensions</span><span class="p">,</span>
+<span class="w">                                          </span><span class="n">optimizable_function</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">opt_function</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Here, <code class="code docutils literal notranslate"><span class="pre">optimization_result</span></code> should encode the optimal value and optimal
+parameters achieved during the optimization workflow
+(i.e. a <code class="code docutils literal notranslate"><span class="pre">tuple&lt;double,</span> <span class="pre">std::vector&lt;double&gt;&gt;</span></code>). The optimize method takes
+as input the number of parameters (or dimensions of the objective function),
+and a function-like object (i.e. <code class="code docutils literal notranslate"><span class="pre">std::function</span></code> or a lambda, something
+<code class="code docutils literal notranslate"><span class="pre">optimizable_function</span></code> can be constructed from) that takes a
+<code class="code docutils literal notranslate"><span class="pre">const</span> <span class="pre">std::vector&lt;double&gt;&amp;</span></code> and <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;double&gt;&amp;</span></code> for the
+function input parameters and gradient vector, respectively. The objective
+function must return a double representing the scalar cost for the
+objective function (e.g. the expected value from <code class="code docutils literal notranslate"><span class="pre">cudaq::observe()</span></code>).</p>
+<p>Here is an example of how the <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> is intended to be used:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">ansatz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="n">phi</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{...};</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">H</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">;</span>
+
+<span class="n">cudaq</span><span class="o">::</span><span class="n">optimizers</span><span class="o">::</span><span class="n">cobyla</span><span class="w"> </span><span class="n">optimizer</span><span class="p">;</span>
+<span class="n">optimizer</span><span class="p">.</span><span class="n">max_eval</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">200</span><span class="p">;</span>
+
+<span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">opt_energy</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">optimizer</span><span class="p">.</span><span class="n">optimize</span><span class="p">(</span>
+<span class="w">      </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="p">[</span><span class="o">&amp;</span><span class="p">](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">grad_vec</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="k">return</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">H</span><span class="p">,</span><span class="w"> </span><span class="n">x</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">x</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">      </span><span class="p">});</span>
+</pre></div>
+</div>
+</section>
+<section id="cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">
+<h2><span class="section-number">12.4. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)<a class="headerlink" href="#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries" title="Permalink to this heading">¶</a></h2>
+<p>Typical optimization use cases will require the computation of gradients for the specified
+objective function. The gradient is a vector over all ansatz circuit
+parameters <span class="math notranslate nohighlight">\(∂H(𝚹) / ∂𝚹_i\)</span>. There are a number of potential strategies for
+computing this gradient vector, but most require additional evaluations
+of the ansatz circuit on the quantum processor.</p>
+<p>To enable true extensibility in gradient strategies, CUDA-Q programmers can
+instantiate custom sub-types of the <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> type. The <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code>
+type defines a <code class="code docutils literal notranslate"><span class="pre">compute(...)</span></code> method that takes a mutable reference to the
+current gradient vector and is free to update that vector in a strategy-specific way.
+The method also takes the current evaluation parameter vector, the <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code> used
+in the current variational task, and the computed expected value at the given parameters.
+The gradient strategy type takes the following form:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">gradient</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="n">gradient</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">function</span><span class="o">&lt;</span><span class="kt">void</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="p">)</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">kernel</span><span class="p">);</span>
+
+<span class="w">      </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="w"> </span><span class="nc">ArgsMapper</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">gradient</span><span class="p">(</span><span class="n">QuantumKernel</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">ArgsMapper</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">argsMapper</span><span class="p">);</span>
+
+<span class="w">      </span><span class="k">virtual</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="nf">compute</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">dx</span><span class="p">,</span>
+<span class="w">                        </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="n">exp_h</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+
+<span class="w">      </span><span class="k">virtual</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">compute</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">x</span><span class="p">,</span>
+<span class="w">              </span><span class="n">std</span><span class="o">::</span><span class="n">function</span><span class="o">&lt;</span><span class="kt">double</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="p">)</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">func</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// gradient is intended for subclassing</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">central_difference</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="k">public</span><span class="w"> </span><span class="n">gradient</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="n">compute</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">dx</span><span class="p">,</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="n">h</span><span class="p">,</span>
+<span class="w">              </span><span class="kt">double</span><span class="w"> </span><span class="n">exp_h</span><span class="p">)</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The <code class="code docutils literal notranslate"><span class="pre">compute</span></code> function can make use of the quantum kernel parameterized ansatz, the
+<code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> for which the expected value is being computed, the
+pre-computed expected value at the current iteration’s parameter, and the
+concrete arguments for the given quantum kernel at this iteration.</p>
+<p>A non-trivial aspect of the computation of gradients (in an extensible manner)
+is that we model the gradient as a derivative over concrete parameters for the
+circuit ansatz represented as a <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;double&gt;</span></code> when the actual
+quantum kernel may be defined with general variadic <code class="code docutils literal notranslate"><span class="pre">Args...</span></code> types.
+To address this issue, programmers can provide a default translation
+mechanism for mapping common quantum kernel ansatz functional expressions to a <code class="code docutils literal notranslate"><span class="pre">vector&lt;double&gt;</span></code> representation - the
+<code class="code docutils literal notranslate"><span class="pre">ArgsMapper</span></code> callable template type. This type must implement the
+<code class="code docutils literal notranslate"><span class="pre">std::tuple&lt;Args...&gt;(std::vector&lt;double&gt;&amp;)</span></code> callable concept.</p>
+<p>The overall CUDA-Q workflow for leveraging the <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code>
+will work as follows (here we demonstrate with an ansatz without the
+default <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;double&gt;</span></code> signature):</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">deuteron_n3_ansatz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">double</span><span class="w"> </span><span class="n">x0</span><span class="p">,</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="n">x1</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">3</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">  </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">x0</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">x1</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">vctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="o">-</span><span class="n">x0</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="p">};</span>
+
+<span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">          </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">9.625</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">9.625</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">3.913119</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="o">-</span>
+<span class="w">            </span><span class="mf">3.913119</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+
+<span class="c1">// The above ansatz takes 2 doubles, not a single std::vector&lt;double&gt;, which</span>
+<span class="c1">// the gradient type is expecting. So we must provide an ArgsMapper callable type</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">argsMapper</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="k">return</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">make_tuple</span><span class="p">(</span><span class="n">x</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="n">x</span><span class="p">[</span><span class="mi">1</span><span class="p">]);};</span>
+
+<span class="c1">// Create the gradient strategy</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">gradients</span><span class="o">::</span><span class="n">central_difference</span><span class="w"> </span><span class="nf">gradient</span><span class="p">(</span><span class="n">deuteron_n3_ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">argsMapper</span><span class="p">);</span>
+
+<span class="c1">// Create the L-BFGS optimizer, requires gradients</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">optimizers</span><span class="o">::</span><span class="n">lbfgs</span><span class="w"> </span><span class="n">optimizer</span><span class="p">;</span>
+
+<span class="c1">// Run the optimization routine.</span>
+<span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">min_val</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">optimizer</span><span class="p">.</span><span class="n">optimize</span><span class="p">(</span>
+<span class="w">    </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="p">[</span><span class="o">&amp;</span><span class="p">](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">grad_vec</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="c1">// Compute the cost, here its an energy</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">cost</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">deuteron_n3_ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">h3</span><span class="p">,</span><span class="w"> </span><span class="n">x</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Compute the gradient, results written to the grad_vec reference</span>
+<span class="w">      </span><span class="n">gradient</span><span class="p">.</span><span class="n">compute</span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">grad_vec</span><span class="p">,</span><span class="w"> </span><span class="n">h3</span><span class="p">,</span><span class="w"> </span><span class="n">cost</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Return the cost to the optimizer</span>
+<span class="w">      </span><span class="k">return</span><span class="w"> </span><span class="n">cost</span><span class="p">;</span>
+<span class="w">    </span><span class="p">});</span>
+
+<span class="c1">// Print the results</span>
+<span class="n">printf</span><span class="p">(</span><span class="s">&quot;Optimizer found %lf at [%lf,%lf]</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">min_val</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">opt_params</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+</pre></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="platform.html" class="btn btn-neutral float-left" title="11. Quantum Platform" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="examples.html" class="btn btn-neutral float-right" title="13. Example Programs" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/control_flow.html b/pr-2241/specification/cudaq/control_flow.html
new file mode 100644
index 0000000000..4433185856
--- /dev/null
+++ b/pr-2241/specification/cudaq/control_flow.html
@@ -0,0 +1,662 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>8. Control Flow &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="9. Just-in-Time Kernel Creation" href="dynamic_kernels.html" />
+    <link rel="prev" title="7. Sub-circuit Synthesis" href="synthesis.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">8. </span>Control Flow</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/control_flow.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="synthesis.html" class="btn btn-neutral float-left" title="7. Sub-circuit Synthesis" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="dynamic_kernels.html" class="btn btn-neutral float-right" title="9. Just-in-Time Kernel Creation" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="control-flow">
+<h1><span class="section-number">8. </span>Control Flow<a class="headerlink" href="#control-flow" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> All classical control flow expressions are inherited from the host language
+(e.g. C++, Python).</p>
+<p><strong>[2]</strong> Programmers can define quantum kernels using standard loop
+constructs and conditional statements.</p>
+<p><strong>[3]</strong> Conditional statements on quantum memory and measured <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>
+results are permitted.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="synthesis.html" class="btn btn-neutral float-left" title="7. Sub-circuit Synthesis" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="dynamic_kernels.html" class="btn btn-neutral float-right" title="9. Just-in-Time Kernel Creation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/dynamic_kernels.html b/pr-2241/specification/cudaq/dynamic_kernels.html
new file mode 100644
index 0000000000..16abfe1ee7
--- /dev/null
+++ b/pr-2241/specification/cudaq/dynamic_kernels.html
@@ -0,0 +1,808 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>9. Just-in-Time Kernel Creation &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="10. Common Quantum Programming Patterns" href="patterns.html" />
+    <link rel="prev" title="8. Control Flow" href="control_flow.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">9. </span>Just-in-Time Kernel Creation</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/dynamic_kernels.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="control_flow.html" class="btn btn-neutral float-left" title="8. Control Flow" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="patterns.html" class="btn btn-neutral float-right" title="10. Common Quantum Programming Patterns" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="just-in-time-kernel-creation">
+<h1><span class="section-number">9. </span>Just-in-Time Kernel Creation<a class="headerlink" href="#just-in-time-kernel-creation" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> CUDA-Q provides a set of programming abstractions for dynamically constructing
+quantum kernel code at runtime.</p>
+<p><strong>[2]</strong> The callable <code class="code docutils literal notranslate"><span class="pre">cudaq::kernel_builder</span></code> abstraction
+facilitates the dynamic definition of quantum kernels that can optionally
+be parameterized by user-defined input arguments.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">kernel_builder</span></code> takes the following structure</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Type wrapping a value in the kernel IR</span>
+<span class="w">  </span><span class="k">struct</span><span class="w"> </span><span class="nc">Value</span><span class="p">;</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">kernel_builder</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">private</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">Value</span><span class="o">&gt;</span><span class="w"> </span><span class="n">arguments</span><span class="p">;</span>
+
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">Value</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">getArguments</span><span class="p">();</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="w"> </span><span class="nf">name</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">getNumParams</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+
+<span class="w">      </span><span class="n">Value</span><span class="w"> </span><span class="nf">qalloc</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">nQubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
+<span class="w">      </span><span class="n">Value</span><span class="w"> </span><span class="nf">qalloc</span><span class="p">(</span><span class="n">Value</span><span class="w"> </span><span class="n">size</span><span class="p">);</span>
+
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">h</span><span class="p">(</span><span class="n">Value</span><span class="o">&amp;</span><span class="w"> </span><span class="n">qubit</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">//... all other quantum operations ...</span>
+
+<span class="w">      </span><span class="c1">// if (mz(q)) thenFunctor()</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">c_if</span><span class="p">(</span><span class="n">Value</span><span class="o">&amp;</span><span class="w"> </span><span class="n">result</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">function</span><span class="o">&lt;</span><span class="kt">void</span><span class="p">()</span><span class="o">&gt;&amp;&amp;</span><span class="w"> </span><span class="n">thenFunctor</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Invoke a predefined kernel</span>
+<span class="w">      </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">OtherKernelBuilder</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Values</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="n">call</span><span class="p">(</span><span class="n">OtherKernelBuilder</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernelToCall</span><span class="p">,</span><span class="w"> </span><span class="n">Values</span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// General multi-control on a predefined kernel</span>
+<span class="w">      </span><span class="c1">// models cudaq::control(...)</span>
+<span class="w">      </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">OtherKernelBuilder</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Values</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="n">control</span><span class="p">(</span><span class="n">OtherKernelBuilder</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernelToControl</span><span class="p">,</span><span class="w"> </span><span class="n">Value</span><span class="o">&amp;</span><span class="w"> </span><span class="n">ctrl</span><span class="p">,</span><span class="w"> </span><span class="n">Values</span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">values</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// General adjoint on a predefined kernel</span>
+<span class="w">      </span><span class="c1">// models cudaq::adjoint(...)</span>
+<span class="w">      </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">OtherKernelBuilder</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Values</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="n">adjoint</span><span class="p">(</span><span class="n">OtherKernelBuilder</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">kernelToAdjoint</span><span class="p">,</span><span class="w"> </span><span class="n">Values</span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">values</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// The constructed kernel is callable</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">Args</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="kt">void</span><span class="o">**</span><span class="w"> </span><span class="n">argsArray</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Enable structured bindings</span>
+<span class="w">      </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">N</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="k">decltype</span><span class="p">(</span><span class="k">auto</span><span class="p">)</span><span class="w"> </span><span class="n">get</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="k">if</span><span class="w"> </span><span class="k">constexpr</span><span class="w"> </span><span class="p">(</span><span class="n">N</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span>
+<span class="w">          </span><span class="k">return</span><span class="w"> </span><span class="o">*</span><span class="k">this</span><span class="p">;</span>
+<span class="w">        </span><span class="k">else</span>
+<span class="w">          </span><span class="k">return</span><span class="w"> </span><span class="n">arguments</span><span class="p">[</span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">];</span>
+<span class="w">      </span><span class="p">}</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+
+<span class="c1">/// Enable structured bindings on the kernel_builder type.</span>
+<span class="c1">/// auto [kernel, theta, phi] = std::make_kernel&lt;double,double&gt;();</span>
+<span class="k">namespace</span><span class="w"> </span><span class="nn">std</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">struct</span><span class="w"> </span><span class="nc">tuple_size</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">kernel_builder</span><span class="o">&lt;</span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;&gt;</span>
+<span class="w">    </span><span class="o">:</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">integral_constant</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="p">,</span><span class="w"> </span><span class="k">sizeof</span><span class="p">...(</span><span class="n">Args</span><span class="p">)</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="o">&gt;</span><span class="w"> </span><span class="p">{};</span>
+
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">N</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">struct</span><span class="w"> </span><span class="nc">tuple_element</span><span class="o">&lt;</span><span class="n">N</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">kernel_builder</span><span class="o">&lt;</span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">using</span><span class="w"> </span><span class="n">type</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">conditional_t</span><span class="o">&lt;</span><span class="n">N</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">kernel_builder</span><span class="o">&lt;</span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;</span><span class="p">,</span>
+<span class="w">                              </span><span class="n">cudaq</span><span class="o">::</span><span class="n">QuakeValue</span><span class="o">&gt;</span><span class="p">;</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span><span class="w"> </span><span class="c1">// namespace std</span>
+
+<span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">kernel_builder</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="n">make_kernel</span><span class="p">();</span>
+<span class="w">  </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="n">kernel_builder</span><span class="o">&lt;</span><span class="n">Args</span><span class="p">...</span><span class="o">&gt;</span><span class="w"> </span><span class="n">make_kernel</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p><strong>[3]</strong> The structure above allows one to leverage the provided factory functions (<code class="code docutils literal notranslate"><span class="pre">make_kernel</span></code>)
+to construct an empty CUDA-Q kernel with defined argument signature.</p>
+<p><strong>[4]</strong> For each type in the signature, the programmer is returned a new <code class="code docutils literal notranslate"><span class="pre">Value</span></code> instance which
+can be leveraged in the construction of the kernel. The intended mechanism for
+kernel creation and argument value extraction is via standard C++
+<a class="reference external" href="https://en.cppreference.com/w/cpp/language/structured_binding">structured bindings</a>.</p>
+<p><strong>[5]</strong> Once the kernel is created, the programmer is free to build up the kernel expression
+using the exposed API. There are methods for qubit allocation, quantum operation
+invocation, control and adjoint synthesis, and conditional branching based on
+<code class="code docutils literal notranslate"><span class="pre">boolean</span></code> values.</p>
+<p>Here is a simple example how one might build a CUDA-Q kernel dynamically.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">make_kernel</span><span class="p">();</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">qubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">kernel</span><span class="p">.</span><span class="n">qalloc</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="n">kernel</span><span class="p">.</span><span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="n">kernel</span><span class="p">.</span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="n">kernel</span><span class="p">.</span><span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">);</span>
+
+<span class="c1">// See algorithmic primitives section for more on sample</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">kernel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+<span class="n">qubits</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Here is an example demonstrating how one may build a dynamic set of
+CUDA-Q kernels for executing the standard Hadamard test.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">xPrep</span><span class="p">,</span><span class="w"> </span><span class="n">qubitIn</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">make_kernel</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="o">&gt;</span><span class="p">();</span>
+<span class="n">xPrep</span><span class="p">.</span><span class="n">x</span><span class="p">(</span><span class="n">qubitIn</span><span class="p">);</span>
+
+<span class="c1">// Compute &lt;1|X|1&gt; = 0</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">hadamardTest</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">make_kernel</span><span class="p">();</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">q</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">hadamardTest</span><span class="p">.</span><span class="n">qalloc</span><span class="p">();</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">ancilla</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">hadamardTest</span><span class="p">.</span><span class="n">qalloc</span><span class="p">();</span>
+<span class="n">hadamardTest</span><span class="p">.</span><span class="n">call</span><span class="p">(</span><span class="n">xPrep</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="n">hadamardTest</span><span class="p">.</span><span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">);</span>
+<span class="n">hadamardTest</span><span class="p">.</span><span class="n">control</span><span class="p">(</span><span class="n">xPrep</span><span class="p">,</span><span class="w"> </span><span class="n">ancilla</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="n">hadamardTest</span><span class="p">.</span><span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">);</span>
+<span class="n">hadamardTest</span><span class="p">.</span><span class="n">mz</span><span class="p">(</span><span class="n">ancilla</span><span class="p">);</span>
+
+<span class="c1">// See algorithmic primitives section for more on sample</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">hadamardTest</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">xPrep</span><span class="p">,</span> <span class="n">qubitIn</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">)</span>
+
+<span class="c1"># Compute &lt;1|X|1&gt; = 0</span>
+<span class="n">hadamardTest</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+<span class="n">q</span> <span class="o">=</span> <span class="n">hadamardTest</span><span class="o">.</span><span class="n">qalloc</span><span class="p">()</span>
+<span class="n">hadamardTest</span><span class="o">.</span><span class="n">call</span><span class="p">(</span><span class="n">xPrep</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+<span class="n">hadamardTest</span><span class="o">.</span><span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+<span class="n">hadamardTest</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">xPrep</span><span class="p">,</span> <span class="n">ancilla</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+<span class="n">hadamardTest</span><span class="o">.</span><span class="n">h</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+<span class="n">hadamardTest</span><span class="o">.</span><span class="n">mz</span><span class="p">(</span><span class="n">ancilla</span><span class="p">)</span>
+
+<span class="c1"># See algorithmic primitives section for more on sample</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">hadamardTest</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="control_flow.html" class="btn btn-neutral float-left" title="8. Control Flow" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="patterns.html" class="btn btn-neutral float-right" title="10. Common Quantum Programming Patterns" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/examples.html b/pr-2241/specification/cudaq/examples.html
new file mode 100644
index 0000000000..1ad62cce2e
--- /dev/null
+++ b/pr-2241/specification/cudaq/examples.html
@@ -0,0 +1,1138 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>13. Example Programs &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Quake Dialect" href="../quake-dialect.html" />
+    <link rel="prev" title="12. Quantum Algorithmic Primitives" href="algorithmic_primitives.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">13. </span>Example Programs</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/examples.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="algorithmic_primitives.html" class="btn btn-neutral float-left" title="12. Quantum Algorithmic Primitives" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../quake-dialect.html" class="btn btn-neutral float-right" title="Quake Dialect" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="example-programs">
+<h1><span class="section-number">13. </span>Example Programs<a class="headerlink" href="#example-programs" title="Permalink to this heading">¶</a></h1>
+<section id="hello-world-simple-bell-state">
+<h2><span class="section-number">13.1. </span>Hello World - Simple Bell State<a class="headerlink" href="#hello-world-simple-bell-state" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">bell</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="kt">int</span><span class="w"> </span><span class="n">num_iters</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="kt">int</span><span class="w"> </span><span class="n">nCorrect</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">num_iters</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">results</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">      </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">results</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+<span class="w">        </span><span class="n">nCorrect</span><span class="o">++</span><span class="p">;</span>
+
+<span class="w">      </span><span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">      </span><span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="n">nCorrect</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;N Correct = %d</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bell</span><span class="p">{}(</span><span class="mi">100</span><span class="p">));</span><span class="w"> </span><span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">bell</span><span class="p">(</span><span class="n">num_iters</span> <span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">nCorrect</span> <span class="o">=</span> <span class="mi">0</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">num_iters</span><span class="p">):</span>
+        <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+        <span class="n">results</span> <span class="o">=</span> <span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">results</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="n">results</span><span class="p">[</span><span class="mi">1</span><span class="p">]:</span>
+           <span class="n">nCorrect</span> <span class="o">=</span> <span class="n">nCorrect</span> <span class="o">+</span> <span class="mi">1</span>
+
+        <span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">nCorrect</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">bell</span><span class="p">(</span><span class="mi">100</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;N Correct = </span><span class="si">{</span><span class="n">counts</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
+<span class="k">assert</span> <span class="n">counts</span> <span class="o">==</span> <span class="mi">100</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="ghz-state-preparation-and-sampling">
+<h2><span class="section-number">13.2. </span>GHZ State Preparation and Sampling<a class="headerlink" href="#ghz-state-preparation-and-sampling" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="nf">ghz</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_qubits</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span>
+<span class="w">    </span><span class="c1">// note use of ctrl modifier</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="o">+</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Sample the state produced by the ghz kernel</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">);</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Observed %s %lu times.</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">.</span><span class="n">c_str</span><span class="p">(),</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">ghz</span><span class="p">(</span><span class="n">numQubits</span><span class="p">:</span><span class="nb">int</span><span class="p">):</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">numQubits</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="o">.</span><span class="n">front</span><span class="p">())</span>
+    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">qubits</span><span class="o">.</span><span class="n">front</span><span class="p">(</span><span class="n">numQubits</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)):</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubit</span><span class="p">,</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz</span><span class="p">,</span> <span class="mi">10</span><span class="p">)</span>
+<span class="k">for</span> <span class="n">bits</span><span class="p">,</span> <span class="n">count</span> <span class="p">:</span> <span class="n">counts</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Observed </span><span class="si">{}</span><span class="s1"> </span><span class="si">{}</span><span class="s1"> times.&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">bits</span><span class="p">,</span> <span class="n">count</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="quantum-phase-estimation">
+<h2><span class="section-number">13.3. </span>Quantum Phase Estimation<a class="headerlink" href="#quantum-phase-estimation" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ phase_estimation.cpp -o qpe.x &amp;&amp; ./qpe.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;stdio.h&gt;</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cmath&gt;</span>
+
+<span class="c1">// A pure device quantum kernel defined as a free function</span>
+<span class="c1">// (cannot be called from host code).</span>
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">iqft</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qview</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">N</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">size</span><span class="p">();</span>
+<span class="w">  </span><span class="c1">// Swap qubits</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">N</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">swap</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">]);</span>
+<span class="w">    </span><span class="kt">int</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">i</span><span class="p">;</span><span class="w"> </span><span class="n">y</span><span class="w"> </span><span class="o">&gt;=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="o">--</span><span class="n">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="kt">double</span><span class="w"> </span><span class="n">denom</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="mi">1UL</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="p">(</span><span class="n">j</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">y</span><span class="p">));</span>
+<span class="w">      </span><span class="k">const</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">-</span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="n">denom</span><span class="p">;</span>
+<span class="w">      </span><span class="n">r1</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">j</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">y</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="p">}</span>
+
+<span class="c1">// CUDA-Q kernel call operators can be templated on</span>
+<span class="c1">// input CUDA-Q kernel expressions. Here we define a general</span>
+<span class="c1">// Phase Estimation algorithm that is generic on the eigenstate</span>
+<span class="c1">// preparation and unitary evolution steps.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">qpe</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// Define the CUDA-Q call expression to take user-specified eigenstate</span>
+<span class="w">  </span><span class="c1">// and unitary evolution kernels, as well as the number of qubits in the</span>
+<span class="w">  </span><span class="c1">// counting register and in the eigenstate register.</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">StatePrep</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="w"> </span><span class="nc">Unitary</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="k">operator</span><span class="p">()(</span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">nCountingQubits</span><span class="p">,</span><span class="w"> </span><span class="n">StatePrep</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">state_prep</span><span class="p">,</span>
+<span class="w">                  </span><span class="n">Unitary</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">oracle</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="c1">// Allocate a register of qubits</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">nCountingQubits</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">    </span><span class="c1">// Extract sub-registers, one for the counting qubits</span>
+<span class="w">    </span><span class="c1">// another for the eigenstate register</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">counting_qubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="n">nCountingQubits</span><span class="p">);</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">state_register</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">back</span><span class="p">();</span>
+
+<span class="w">    </span><span class="c1">// Prepare the eigenstate</span>
+<span class="w">    </span><span class="n">state_prep</span><span class="p">(</span><span class="n">state_register</span><span class="p">);</span>
+
+<span class="w">    </span><span class="c1">// Put the counting register into uniform superposition</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">counting_qubits</span><span class="p">);</span>
+
+<span class="w">    </span><span class="c1">// Perform `ctrl-U^j`</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">nCountingQubits</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">i</span><span class="p">);</span><span class="w"> </span><span class="o">++</span><span class="n">j</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">cudaq</span><span class="o">::</span><span class="n">control</span><span class="p">(</span><span class="n">oracle</span><span class="p">,</span><span class="w"> </span><span class="n">counting_qubits</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">state_register</span><span class="p">);</span>
+<span class="w">      </span><span class="p">}</span>
+<span class="w">    </span><span class="p">}</span>
+
+<span class="w">    </span><span class="c1">// Apply inverse quantum Fourier transform</span>
+<span class="w">    </span><span class="n">iqft</span><span class="p">(</span><span class="n">counting_qubits</span><span class="p">);</span>
+
+<span class="w">    </span><span class="c1">// Measure to gather sampling statistics</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">counting_qubits</span><span class="p">);</span>
+
+<span class="w">    </span><span class="k">return</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">r1PiGate</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">r1</span><span class="p">(</span><span class="mf">1.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="n">nQubits</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="p">{</span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w"> </span><span class="mi">6</span><span class="p">,</span><span class="w"> </span><span class="mi">8</span><span class="p">})</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span>
+<span class="w">        </span><span class="n">qpe</span><span class="p">{},</span><span class="w"> </span><span class="n">nQubits</span><span class="p">,</span><span class="w"> </span><span class="p">[](</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="n">r1PiGate</span><span class="p">{});</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">mostProbable</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">counts</span><span class="p">.</span><span class="n">most_probable</span><span class="p">();</span>
+<span class="w">    </span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">to_integer</span><span class="p">(</span><span class="n">mostProbable</span><span class="p">)</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="p">(</span><span class="kt">double</span><span class="p">)(</span><span class="mi">1UL</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">nQubits</span><span class="p">);</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">piEstimate</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1.</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">theta</span><span class="p">);</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Pi Estimate(nQubits == %d) = %lf </span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">nQubits</span><span class="p">,</span><span class="w"> </span><span class="n">piEstimate</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span><span class="o">,</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># Compute phase for U |psi&gt; = exp(-2 pi phase) |psi&gt;</span>
+<span class="c1"># This example will consider U = T, and |psi&gt; = |1&gt;</span>
+<span class="c1"># Define a Inverse Quantum Fourier Transform kernel</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">iqft</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">N</span> <span class="o">=</span> <span class="n">qubits</span><span class="o">.</span><span class="n">size</span><span class="p">()</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">N</span> <span class="o">//</span> <span class="mi">2</span><span class="p">):</span>
+        <span class="n">swap</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">N</span> <span class="o">-</span> <span class="n">i</span> <span class="o">-</span> <span class="mi">1</span><span class="p">])</span>
+
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">N</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+        <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+        <span class="n">j</span> <span class="o">=</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span>
+        <span class="k">for</span> <span class="n">y</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="o">-</span><span class="mi">1</span><span class="p">):</span>
+            <span class="n">r1</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">2</span><span class="o">**</span><span class="p">(</span><span class="n">j</span> <span class="o">-</span> <span class="n">y</span><span class="p">),</span> <span class="n">qubits</span><span class="p">[</span><span class="n">j</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">y</span><span class="p">])</span>
+
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">N</span> <span class="o">-</span> <span class="mi">1</span><span class="p">])</span>
+
+
+<span class="c1"># Define the U kernel</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">tGate</span><span class="p">(</span><span class="n">qubit</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">):</span>
+    <span class="n">t</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Define the state preparation |psi&gt; kernel</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">xGate</span><span class="p">(</span><span class="n">qubit</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">):</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+<span class="c1"># General Phase Estimation kernel for single qubit</span>
+<span class="c1"># eigen states.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">qpe</span><span class="p">(</span><span class="n">nC</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">nQ</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">statePrep</span><span class="p">:</span> <span class="n">Callable</span><span class="p">[[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">],</span> <span class="kc">None</span><span class="p">],</span>
+        <span class="n">oracle</span><span class="p">:</span> <span class="n">Callable</span><span class="p">[[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">],</span> <span class="kc">None</span><span class="p">]):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">nC</span> <span class="o">+</span> <span class="n">nQ</span><span class="p">)</span>
+    <span class="n">countingQubits</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">front</span><span class="p">(</span><span class="n">nC</span><span class="p">)</span>
+    <span class="n">stateRegister</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">back</span><span class="p">()</span>
+    <span class="n">statePrep</span><span class="p">(</span><span class="n">stateRegister</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">countingQubits</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">nC</span><span class="p">):</span>
+        <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="o">**</span><span class="n">i</span><span class="p">):</span>
+            <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">oracle</span><span class="p">,</span> <span class="p">[</span><span class="n">countingQubits</span><span class="p">[</span><span class="n">i</span><span class="p">]],</span> <span class="n">stateRegister</span><span class="p">)</span>
+    <span class="n">iqft</span><span class="p">(</span><span class="n">countingQubits</span><span class="p">)</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">countingQubits</span><span class="p">)</span>
+
+<span class="c1"># Sample the state to get the phase.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">qpe</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="n">xGate</span><span class="p">,</span> <span class="n">tGate</span><span class="p">)</span>
+<span class="k">assert</span> <span class="nb">len</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span> <span class="o">==</span> <span class="mi">1</span>
+<span class="k">assert</span> <span class="s1">&#39;100&#39;</span> <span class="ow">in</span> <span class="n">counts</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="deuteron-binding-energy-parameter-sweep">
+<h2><span class="section-number">13.4. </span>Deuteron Binding Energy Parameter Sweep<a class="headerlink" href="#deuteron-binding-energy-parameter-sweep" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">deuteron_n2_ansatz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">              </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Perform parameter sweep for deuteron N=2 Hamiltonian</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="k">auto</span><span class="w"> </span><span class="n">param_space</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">linspace</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI</span><span class="p">,</span><span class="w"> </span><span class="n">M_PI</span><span class="p">,</span><span class="w"> </span><span class="mi">25</span><span class="p">);</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="k">auto</span><span class="o">&amp;</span><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">param_space</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="c1">// KERNEL::observe(...) &lt;==&gt;</span>
+<span class="w">    </span><span class="c1">// E(params...) = &lt;psi(params...) | H | psi(params...)&gt;</span>
+<span class="w">    </span><span class="kt">double</span><span class="w"> </span><span class="n">energy_at_param</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">deuteron_n2_ansatz</span><span class="p">{},</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="n">param</span><span class="p">);</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;&lt;H&gt;(%lf) = %lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">param</span><span class="p">,</span><span class="w"> </span><span class="n">energy_at_param</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">ansatz</span><span class="p">(</span><span class="n">angle</span><span class="p">:</span><span class="nb">float</span><span class="p">):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span>
+    <span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+
+<span class="c1"># Perform parameter sweep for deuteron N=2 Hamiltonian</span>
+<span class="k">for</span> <span class="n">angle</span> <span class="ow">in</span> <span class="n">np</span><span class="o">.</span><span class="n">linspace</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="mi">25</span><span class="p">):</span>
+     <span class="c1"># KERNEL::observe(...) &lt;==&gt;</span>
+     <span class="c1"># E(params...) = &lt;psi(params...) | H | psi(params...)&gt;</span>
+     <span class="n">energyAtParam</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="mf">.59</span><span class="p">)</span>
+     <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;&lt;H&gt;(</span><span class="si">{}</span><span class="s1">) = </span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="n">energyAtParam</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="grover-s-algorithm">
+<h2><span class="section-number">13.5. </span>Grover’s Algorithm<a class="headerlink" href="#grover-s-algorithm" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ grover.cpp -o grover.x &amp;&amp; ./grover.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cmath&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;numbers&gt;</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">reflect_about_uniform</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">qs</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">ctrlQubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">qs</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="n">qs</span><span class="p">.</span><span class="n">size</span><span class="p">()</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">lastQubit</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">qs</span><span class="p">.</span><span class="n">back</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Compute (U) Action (V) produces</span>
+<span class="w">  </span><span class="c1">// U V U::Adjoint</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">compute_action</span><span class="p">(</span>
+<span class="w">      </span><span class="p">[</span><span class="o">&amp;</span><span class="p">]()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">h</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">        </span><span class="n">x</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">      </span><span class="p">},</span>
+<span class="w">      </span><span class="p">[</span><span class="o">&amp;</span><span class="p">]()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">z</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ctrlQubits</span><span class="p">,</span><span class="w"> </span><span class="n">lastQubit</span><span class="p">);</span><span class="w"> </span><span class="p">});</span>
+<span class="p">}</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">run_grover</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">CallableKernel</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="n">__qpu__</span><span class="w"> </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()(</span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span><span class="w"> </span><span class="n">CallableKernel</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">oracle</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="kt">int</span><span class="w"> </span><span class="n">n_iterations</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">round</span><span class="p">(</span><span class="mf">0.25</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">numbers</span><span class="o">::</span><span class="n">pi</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">sqrt</span><span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="o">^</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">));</span>
+
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">qs</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_iterations</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">oracle</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">      </span><span class="n">reflect_about_uniform</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">oracle</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="kt">long</span><span class="w"> </span><span class="n">target_state</span><span class="p">;</span>
+
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">qs</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">compute_action</span><span class="p">(</span>
+<span class="w">        </span><span class="p">[</span><span class="o">&amp;</span><span class="p">]()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">          </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;=</span><span class="w"> </span><span class="n">qs</span><span class="p">.</span><span class="n">size</span><span class="p">();</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">            </span><span class="k">auto</span><span class="w"> </span><span class="n">target_bit_set</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="p">(</span><span class="n">qs</span><span class="p">.</span><span class="n">size</span><span class="p">()</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">i</span><span class="p">))</span><span class="w"> </span><span class="o">&amp;</span><span class="w"> </span><span class="n">target_state</span><span class="p">;</span>
+<span class="w">            </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">target_bit_set</span><span class="p">)</span>
+<span class="w">              </span><span class="n">x</span><span class="p">(</span><span class="n">qs</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">          </span><span class="p">}</span>
+<span class="w">        </span><span class="p">},</span>
+<span class="w">        </span><span class="p">[</span><span class="o">&amp;</span><span class="p">]()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">          </span><span class="k">auto</span><span class="w"> </span><span class="n">ctrlQubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">qs</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="n">qs</span><span class="p">.</span><span class="n">size</span><span class="p">()</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
+<span class="w">          </span><span class="n">z</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ctrlQubits</span><span class="p">,</span><span class="w"> </span><span class="n">qs</span><span class="p">.</span><span class="n">back</span><span class="p">());</span>
+<span class="w">        </span><span class="p">});</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">argc</span><span class="p">,</span><span class="w"> </span><span class="kt">char</span><span class="w"> </span><span class="o">*</span><span class="n">argv</span><span class="p">[])</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">secret</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">argc</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="n">strtol</span><span class="p">(</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="nb">NULL</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="mb">0b1011</span><span class="p">;</span>
+<span class="w">  </span><span class="n">oracle</span><span class="w"> </span><span class="n">compute_oracle</span><span class="p">{.</span><span class="n">target_state</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">secret</span><span class="p">};</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">run_grover</span><span class="p">{},</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w"> </span><span class="n">compute_oracle</span><span class="p">);</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Found string %s</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">counts</span><span class="p">.</span><span class="n">most_probable</span><span class="p">().</span><span class="n">c_str</span><span class="p">());</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">reflect</span><span class="p">(</span><span class="n">qubits</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">ctrls</span> <span class="o">=</span> <span class="n">qubits</span><span class="o">.</span><span class="n">front</span><span class="p">(</span><span class="n">qubits</span><span class="o">.</span><span class="n">size</span><span class="p">()</span> <span class="o">-</span> <span class="mi">1</span><span class="p">)</span>
+    <span class="n">last</span> <span class="o">=</span> <span class="n">qubits</span><span class="o">.</span><span class="n">back</span><span class="p">()</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">compute_action</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="p">(</span><span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">),</span> <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">)),</span>
+                          <span class="k">lambda</span><span class="p">:</span> <span class="n">z</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">ctrls</span><span class="p">,</span> <span class="n">last</span><span class="p">))</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">oracle</span><span class="p">(</span><span class="n">q</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="n">z</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="n">z</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">grover</span><span class="p">(</span><span class="n">N</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">M</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">oracle</span><span class="p">:</span> <span class="n">Callable</span><span class="p">[[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">],</span> <span class="kc">None</span><span class="p">]):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">N</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">M</span><span class="p">):</span>
+        <span class="n">oracle</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+        <span class="n">reflect</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">grover</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="n">oracle</span><span class="p">)</span>
+<span class="k">assert</span> <span class="nb">len</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span> <span class="o">==</span> <span class="mi">2</span>
+<span class="k">assert</span> <span class="s1">&#39;101&#39;</span> <span class="ow">in</span> <span class="n">counts</span>
+<span class="k">assert</span> <span class="s1">&#39;011&#39;</span> <span class="ow">in</span> <span class="n">counts</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="iterative-phase-estimation">
+<h2><span class="section-number">13.6. </span>Iterative Phase Estimation<a class="headerlink" href="#iterative-phase-estimation" title="Permalink to this heading">¶</a></h2>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ iterative_qpe.cpp -o qpe.x &amp;&amp; ./qpe.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">iqpe</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">8</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span>
+<span class="w">      </span><span class="n">r1</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="mi">-5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">cr0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">4</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span>
+<span class="w">      </span><span class="n">r1</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="mi">-5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cr0</span><span class="p">)</span>
+<span class="w">      </span><span class="n">rz</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">2.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">cr1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span>
+<span class="w">      </span><span class="n">r1</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="mi">-5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cr0</span><span class="p">)</span>
+<span class="w">      </span><span class="n">rz</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">4.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cr1</span><span class="p">)</span>
+<span class="w">      </span><span class="n">rz</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">2.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">cr2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">reset</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">r1</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="mi">-5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cr0</span><span class="p">)</span>
+<span class="w">      </span><span class="n">rz</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cr1</span><span class="p">)</span>
+<span class="w">      </span><span class="n">rz</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI_4</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cr2</span><span class="p">)</span>
+<span class="w">      </span><span class="n">rz</span><span class="p">(</span><span class="o">-</span><span class="n">M_PI_2</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="cm">/*shots*/</span><span class="w"> </span><span class="mi">10</span><span class="p">,</span><span class="w"> </span><span class="n">iqpe</span><span class="p">{});</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="algorithmic_primitives.html" class="btn btn-neutral float-left" title="12. Quantum Algorithmic Primitives" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../quake-dialect.html" class="btn btn-neutral float-right" title="Quake Dialect" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/kernels.html b/pr-2241/specification/cudaq/kernels.html
new file mode 100644
index 0000000000..7fd014aed1
--- /dev/null
+++ b/pr-2241/specification/cudaq/kernels.html
@@ -0,0 +1,1005 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>6. Quantum Kernels &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="7. Sub-circuit Synthesis" href="synthesis.html" />
+    <link rel="prev" title="5. Quantum Intrinsic Operations" href="operations.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">6. </span>Quantum Kernels</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/kernels.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="operations.html" class="btn btn-neutral float-left" title="5. Quantum Intrinsic Operations" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="synthesis.html" class="btn btn-neutral float-right" title="7. Sub-circuit Synthesis" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-kernels">
+<h1><span class="section-number">6. </span>Quantum Kernels<a class="headerlink" href="#quantum-kernels" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> To differentiate between host and quantum device code, the CUDA-Q programming
+model defines the concept of a <strong>quantum kernel</strong>. A quantum kernel is any callable
+in C++ annotated to indicate compilation and execution on an available quantum coprocessor.</p>
+<p><strong>[2]</strong> All quantum kernels must be annotated to indicate they are to be compiled for, and executed
+on, a specified quantum coprocessor. CUDA-Q requires the <code class="code docutils literal notranslate"><span class="pre">__qpu__</span></code> function
+attribute for quantum kernel declarations. Other language bindings may opt to use other language
+features to enable function annotation or decoration (e.g. a <code class="code docutils literal notranslate"><span class="pre">&#64;cudaq.kernel()</span></code> function
+decorator in Python).</p>
+<p><strong>[3]</strong> CUDA-Q specifically differentiates between kernels invoked from host code and those invoked
+from within another quantum kernel. The former are denoted <strong>entry-point</strong>
+quantum kernels, the latter are <strong>pure device</strong> quantum kernels. Entry point kernels can
+only take classical types as input and return classical output. Pure-device kernels
+can take quantum types as input.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Entry point lambda kernel</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">my_first_entry_point_kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">double</span><span class="w"> </span><span class="n">x</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="n">quantum</span><span class="w"> </span><span class="n">code</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">};</span>
+
+<span class="c1">// Entry point typed callable kernel</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">my_second_entry_point_kernel</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="kt">double</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">params</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="p">...</span><span class="w"> </span><span class="n">quantum</span><span class="w"> </span><span class="n">code</span><span class="w"> </span><span class="p">...</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="c1">// Pure device free function kernel</span>
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">my_first_pure_device_kernel</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qview</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="n">qubits</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">   </span><span class="p">...</span><span class="w"> </span><span class="n">quantum</span><span class="w"> </span><span class="n">code</span><span class="w"> </span><span class="p">...</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">my_first_entry_point_kernel</span><span class="p">(</span><span class="n">x</span> <span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+   <span class="o">...</span> <span class="n">quantum</span> <span class="n">code</span> <span class="o">...</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">my_second_entry_point_kernel</span><span class="p">(</span><span class="n">x</span> <span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">params</span> <span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+   <span class="o">...</span> <span class="n">quantum</span> <span class="n">code</span> <span class="o">...</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">my_first_pure_device_kernel</span><span class="p">(</span><span class="n">qubits</span> <span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+   <span class="o">...</span> <span class="n">quantum</span> <span class="n">code</span> <span class="o">...</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[4]</strong> Quantum kernel function bodies are programmed in a subset of the parent classical language.
+Kernels can be composed of the following:</p>
+<blockquote>
+<div><ul class="simple">
+<li><p>Quantum intrinsic operations and measurements</p></li>
+<li><p>In-scope kernel calls with or without any kernel modifiers (e.g. <code class="code docutils literal notranslate"><span class="pre">cudaq::control</span></code>)</p></li>
+<li><p>Classical control flow constructs from the classical language (<code class="code docutils literal notranslate"><span class="pre">if</span></code>, <code class="code docutils literal notranslate"><span class="pre">for</span></code>, <code class="code docutils literal notranslate"><span class="pre">while</span></code>, etc.)</p></li>
+<li><p>Stack variable declarations for supported types.</p></li>
+<li><p>Arithmetic operations on integer and floating point stack variables</p></li>
+<li><p>Coherent conditional execution - <code class="code docutils literal notranslate"><span class="pre">if</span> <span class="pre">(</span> <span class="pre">boolExprFromQubitMeasurement</span> <span class="pre">)</span> <span class="pre">{</span> <span class="pre">x</span> <span class="pre">(another_qubit);</span> <span class="pre">}</span></code></p></li>
+<li><p>Syntax for common quantum programming patterns (e.g. compute-action-uncompute).</p></li>
+</ul>
+</div></blockquote>
+<p><strong>[5]</strong> CUDA-Q defines a set of allowed types that can be leveraged in quantum kernel
+function signatures (input and return types), in-function variable declaration or construction,
+and in variable capture from parent scope.</p>
+<p>The allowed types are as follows:</p>
+<blockquote>
+<div><ul class="simple">
+<li><p><code class="code docutils literal notranslate"><span class="pre">T</span></code> such that <code class="code docutils literal notranslate"><span class="pre">std::is_arithmetic_v&lt;T&gt;</span> <span class="pre">==</span> <span class="pre">true</span></code></p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">std::vector&lt;T&gt;</span></code> such that <code class="code docutils literal notranslate"><span class="pre">std::is_arithmetic_v&lt;T&gt;</span> <span class="pre">==</span> <span class="pre">true</span></code></p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">std::span&lt;T&gt;</span></code> such that <code class="code docutils literal notranslate"><span class="pre">std::is_arithmetic_v&lt;T&gt;</span> <span class="pre">==</span> <span class="pre">true</span></code></p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">std::vector&lt;V&gt;</span></code> such that type <code class="code docutils literal notranslate"><span class="pre">V</span></code> is a valid <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;T&gt;</span></code> (possibly recursively)</p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">struct</span></code> types composed of any valid CUDA-Q type.</p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">std::tuple&lt;Ts...&gt;</span></code> such that T is any allowed type.</p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">std::pair&lt;T,U&gt;</span></code> such that T is any allowed type.</p></li>
+</ul>
+</div></blockquote>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">MyCustomSimpleStruct</span><span class="w"> </span><span class="p">{</span>
+<span class="w">   </span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">   </span><span class="kt">int</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">   </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">angles</span><span class="p">;</span>
+<span class="p">};</span>
+
+<span class="c1">// Valid CUDA-Q Types used in Kernels</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">int</span><span class="w"> </span><span class="n">N</span><span class="p">,</span><span class="w"> </span><span class="kt">bool</span><span class="w"> </span><span class="n">flag</span><span class="p">,</span><span class="w"> </span><span class="kt">float</span><span class="w"> </span><span class="n">angle</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="w"> </span><span class="n">layers</span><span class="p">,</span>
+<span class="w">         </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">parameters</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">float</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">recursiveVec</span><span class="p">,</span>
+<span class="w">         </span><span class="n">MyCustomSimpleStruct</span><span class="w"> </span><span class="n">var</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="n">kernelThatReturns</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">   </span><span class="p">...</span>
+<span class="w">   </span><span class="k">return</span><span class="w"> </span><span class="n">M_PI_2</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">class</span> <span class="nc">MySimpleStruct</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
+    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">i</span> <span class="o">=</span> <span class="mi">0</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">j</span> <span class="o">=</span> <span class="mi">0</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">N</span> <span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">flag</span> <span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">angle</span> <span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">layers</span> <span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+            <span class="n">parameters</span> <span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span> <span class="n">recursiveList</span> <span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">]],</span>
+            <span class="n">var</span> <span class="p">:</span> <span class="n">MySimpleStruct</span><span class="p">):</span> <span class="o">...</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernelThatReturns</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">float</span><span class="p">:</span>
+    <span class="o">...</span>
+    <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">2.0</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[6]</strong> Any variable with an allowed CUDA-Q type can be allocated on the stack within
+CUDA-Q kernels. Variables of type <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;T&gt;</span></code> for any allowed type
+<code class="code docutils literal notranslate"><span class="pre">T</span></code> can only be constructed with known size. Vector-like variables cannot be
+default constructed and later filled with type <code class="code docutils literal notranslate"><span class="pre">T</span></code> data (i.e. no dynamic memory allocation).</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Valid CUDA-Q Types used in Kernels</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// Not Allowed.</span>
+<span class="w">  </span><span class="c1">// std::vector&lt;int&gt; i;</span>
+<span class="w">  </span><span class="c1">// i.push_back(1);</span>
+
+<span class="w">  </span><span class="c1">// Valid variable declarations</span>
+
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="n">i</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+<span class="w">  </span><span class="n">i</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">3</span><span class="p">;</span>
+
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">float</span><span class="o">&gt;</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="p">{</span><span class="mf">1.0</span><span class="p">,</span><span class="w"> </span><span class="mf">2.0</span><span class="p">,</span><span class="w"> </span><span class="mf">3.0</span><span class="p">};</span>
+
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+
+<span class="w">  </span><span class="kt">double</span><span class="w"> </span><span class="n">pi</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">3.1415926</span>
+<span class="p">};</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+   <span class="c1"># Not Allowed</span>
+   <span class="c1"># i = []</span>
+   <span class="c1"># i.append(1)</span>
+
+   <span class="n">i</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span> <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">5</span><span class="p">)]</span>
+   <span class="n">i</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span> <span class="o">=</span> <span class="mi">3</span>
+
+   <span class="n">f</span> <span class="o">=</span> <span class="p">[</span><span class="mf">1.</span><span class="p">,</span> <span class="mf">2.</span><span class="p">,</span> <span class="mf">3.</span><span class="p">]</span>
+
+   <span class="n">k</span> <span class="o">=</span> <span class="mi">0</span>
+
+   <span class="n">pi</span> <span class="o">=</span> <span class="mf">3.1415926</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[7]</strong> All entry-point kernel arguments adhere to pass-by-value semantics.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">v</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">   </span><span class="c1">// i == 2, allocate 2 qubits</span>
+<span class="w">   </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">i</span><span class="p">);</span>
+<span class="w">   </span><span class="c1">// v[1] == 2.0, angle here is 2.0</span>
+<span class="w">   </span><span class="n">ry</span><span class="p">(</span><span class="n">v</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">   </span><span class="c1">// Change the variables, caller does not see this</span>
+<span class="w">   </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">5</span><span class="p">;</span>
+<span class="w">   </span><span class="n">v</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">3.0</span><span class="p">;</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">d</span><span class="w"> </span><span class="p">{</span><span class="mf">1.0</span><span class="p">,</span><span class="w"> </span><span class="mf">2.0</span><span class="p">};</span>
+
+<span class="n">kernel</span><span class="p">(</span><span class="n">k</span><span class="p">,</span><span class="w"> </span><span class="n">d</span><span class="p">);</span>
+
+<span class="c1">// k is still 2, pass by value</span>
+<span class="c1">// d is still {1.0, 2.0}, pass by value</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">i</span> <span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">v</span> <span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+    <span class="c1"># i = 2, allocate 2 qubits</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">i</span><span class="p">)</span>
+    <span class="c1"># v[1] == 2.0, angle here is 2.0</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">v</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+    <span class="c1"># Change the variables, caller does not see this</span>
+    <span class="n">i</span> <span class="o">=</span> <span class="mi">5</span>
+    <span class="n">v</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">=</span> <span class="mf">3.0</span>
+
+<span class="n">k</span><span class="p">,</span> <span class="n">d</span> <span class="o">=</span> <span class="mi">2</span><span class="p">,</span> <span class="p">[</span><span class="mf">1.</span><span class="p">,</span> <span class="mf">2.</span><span class="p">]</span>
+<span class="n">kernel</span><span class="p">(</span><span class="n">i</span><span class="p">,</span> <span class="n">d</span><span class="p">)</span>
+
+<span class="c1"># k is still 2, pass by value</span>
+<span class="c1"># d is still {1.0, 2.0}, pass by value</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[8]</strong> CUDA-Q kernel lambdas in C++ can capture variables of allowed type
+by value. CUDA-Q kernels defined as custom callable types can define non-reference type
+class members of any allowed type. These member variables can be set with
+pass-by-value semantics at kernel construction.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-C++ notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">kernel</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="p">;</span>
+<span class="w">  </span><span class="kt">float</span><span class="w"> </span><span class="n">f</span><span class="p">;</span>
+
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">     </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="n">i</span><span class="p">);</span>
+<span class="w">     </span><span class="n">ry</span><span class="p">(</span><span class="n">f</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="n">kernel</span><span class="p">{</span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mf">2.2</span><span class="p">}();</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="kt">double</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">2.2</span><span class="p">;</span>
+
+<span class="k">auto</span><span class="w"> </span><span class="n">kernelLambda</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Use captured variables</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">i</span><span class="p">);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">f</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">5</span><span class="p">;</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="n">i</span><span class="p">;</span>
+<span class="p">};</span>
+
+<span class="k">auto</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">kernelLambda</span><span class="p">();</span>
+
+<span class="c1">// Pass by value semantics</span>
+<span class="n">assert</span><span class="p">(</span><span class="n">k</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="n">i</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">i</span> <span class="o">=</span> <span class="mi">2</span>
+<span class="n">f</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">2.</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+   <span class="c1"># Use captured variables</span>
+   <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">i</span><span class="p">)</span>
+   <span class="n">ry</span><span class="p">(</span><span class="n">f</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+   <span class="n">i</span> <span class="o">=</span> <span class="mi">5</span>
+   <span class="k">return</span> <span class="n">i</span>
+
+<span class="n">k</span> <span class="o">=</span> <span class="n">kernel</span><span class="p">()</span>
+
+<span class="c1"># Pass by value semantics</span>
+<span class="k">assert</span> <span class="n">k</span> <span class="o">!=</span> <span class="n">i</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[9]</strong> All quantum kernel invocations are synchronous calls by default.</p>
+<p><strong>[10]</strong> CUDA-Q kernels can serve as input to other quantum kernels and invoked by kernel
+function body code. To support CUDA-Q kernel parameterization on callable quantum kernel
+code, programmers can leverage standard C++ template definitions or dynamic typing in language bindings such as Python:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--5-input--1" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">MyStatePrep</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qview</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="n">qubits</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="p">...</span><span class="w"> </span><span class="n">apply</span><span class="w"> </span><span class="n">state</span><span class="w"> </span><span class="n">prep</span><span class="w"> </span><span class="n">operations</span><span class="w"> </span><span class="n">on</span><span class="w"> </span><span class="n">qubits</span><span class="w"> </span><span class="p">...</span>
+<span class="p">}</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">MyGenericAlgorithm</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">StatePrep</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="k">operator</span><span class="p">()(</span><span class="k">const</span><span class="w"> </span><span class="n">StatePrep</span><span class="o">&amp;</span><span class="w"> </span><span class="n">statePrep</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">10</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">statePrep</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="p">...</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="c1">// -or- with placeholder type specifiers</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">MyGenericAlgorithm2</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="k">const</span><span class="w"> </span><span class="k">auto</span><span class="o">&amp;</span><span class="w"> </span><span class="n">statePrep</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">10</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">statePrep</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="p">...</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">void</span><span class="w"> </span><span class="nf">callKernels</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="n">MyGenericAlgorithm</span><span class="w"> </span><span class="n">algorithm</span><span class="p">;</span>
+<span class="w">  </span><span class="n">algorithm</span><span class="p">(</span><span class="n">MyStatePrep</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">MyGenericAlgorithm2</span><span class="w"> </span><span class="n">anotherVersion</span><span class="p">;</span>
+<span class="w">  </span><span class="n">anotherVersion</span><span class="p">(</span><span class="n">MyStatePrep</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--5-input--2" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">MyStatePrep</span><span class="p">(</span><span class="n">qubits</span> <span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">):</span>
+    <span class="o">...</span> <span class="n">apply</span> <span class="n">state</span> <span class="n">prep</span> <span class="n">operations</span> <span class="n">on</span> <span class="n">qubits</span> <span class="o">...</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">MyGenericAlgorithm</span><span class="p">(</span><span class="n">statePrep</span> <span class="p">:</span> <span class="n">typing</span><span class="o">.</span><span class="n">Callable</span><span class="p">[[</span><span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">],</span> <span class="kc">None</span><span class="p">]):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span>
+    <span class="n">statePrep</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+    <span class="o">...</span>
+
+<span class="n">MyGenericAlgorithm</span><span class="p">(</span><span class="n">MyStatePrep</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>CUDA-Q kernel inputs can also be <a class="reference external" href="https://en.cppreference.com/w/cpp/language/constraints">constrained</a>.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// Generic constraint on Kernel Function Signatures</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">Kernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="w"> </span><span class="nc">Signature</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">concept</span><span class="w"> </span><span class="nc">signature</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">is_convertible_v</span><span class="o">&lt;</span><span class="n">Kernel</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">function</span><span class="o">&lt;</span><span class="n">Signature</span><span class="o">&gt;&gt;</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Specialized for taking a single qubit</span>
+<span class="w">  </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">Kernel</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">concept</span><span class="w"> </span><span class="nc">takes_qubit</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">signature</span><span class="o">&lt;</span><span class="n">Kernel</span><span class="p">,</span><span class="w"> </span><span class="kt">void</span><span class="p">(</span><span class="n">qubit</span><span class="o">&amp;</span><span class="p">)</span><span class="o">&gt;</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">MyGenericAlgorithmOnQarray</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">signature</span><span class="o">&lt;</span><span class="kt">void</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&amp;</span><span class="p">)</span><span class="o">&gt;</span><span class="w"> </span><span class="k">auto</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">statePrep</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">10</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">statePrep</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="p">...</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">MyGenericAlgorithmOnQubit</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">takes_qubit</span><span class="w"> </span><span class="k">auto</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">statePrep</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">10</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">statePrep</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">...</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+</pre></div>
+</div>
+<p>This approach enables the development of generic libraries of quantum
+algorithms that are parameterized on sub-units of the global circuit representation.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="operations.html" class="btn btn-neutral float-left" title="5. Quantum Intrinsic Operations" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="synthesis.html" class="btn btn-neutral float-right" title="7. Sub-circuit Synthesis" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/machine_model.html b/pr-2241/specification/cudaq/machine_model.html
new file mode 100644
index 0000000000..f44e63071c
--- /dev/null
+++ b/pr-2241/specification/cudaq/machine_model.html
@@ -0,0 +1,701 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>1. Machine Model &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="2. Namespace and Standard" href="namespace.html" />
+    <link rel="prev" title="Language Specification" href="../cudaq.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3 current"><a class="current reference internal" href="#">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">1. </span>Machine Model</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/machine_model.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../cudaq.html" class="btn btn-neutral float-left" title="Language Specification" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="namespace.html" class="btn btn-neutral float-right" title="2. Namespace and Standard" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="machine-model">
+<h1><span class="section-number">1. </span>Machine Model<a class="headerlink" href="#machine-model" title="Permalink to this heading">¶</a></h1>
+<p><span class="raw-html"><a name="mm1"></a></span></p>
+<p><strong>[1]</strong> CUDA-Q presumes the existence of one or more classical host processors,
+zero or more NVIDIA graphics processing units (GPUs), and zero or more quantum processing units (QPUs).</p>
+<p><strong>[2]</strong> Each QPU is composed of a classical quantum control system (distributed FPGAs, GPUs, etc.)
+and a register of quantum bits (qubits) whose state evolves via signals from the classical control system.</p>
+<p><strong>[3]</strong> The machine model allows for three modes of quantum process parallelism: concurrent execution
+of quantum circuits on independent QPUs, dependent quantum parallelism via
+quantum message passing and inter-QPU entanglement, and QPU thread-level
+parallelism or the ability for concurrent execution of independent quantum
+circuits on a single QPU qubit connectivity fabric.</p>
+<p><strong>[4]</strong> The model assumes a
+classical memory space for the host processor which inherits the native language memory
+model semantics (e.g. C++ or Python).</p>
+<p><strong>[5]</strong> The model assumes a classical memory space for each control
+system driving the evolution of the multi-qubit state. This control system
+memory space should enable primitive arithmetic variable declarations,
+stores, and loads, as well as qubit measurement persistence and loading
+for fast-feedback and conditional circuit execution.</p>
+<p><strong>[6]</strong> The quantum memory
+space on an individual QPU is modeled as an infinite register of
+qubits and physical connectivity constraints are hidden from the
+programmer. Note that compiler implementations of the CUDA-Q model
+are free to enable developer access to the details of the QPU
+qubit connectivity for the purpose of developing novel placement strategies.</p>
+<p><strong>[7]</strong> CUDA-Q considers general <span class="math notranslate nohighlight">\(D\)</span>-level quantum information systems, e.g. qudits. Qudits
+are non-copyable, and can be allocated in chunks, via instantiation of
+user-level quantum container types. Quantum containers come in two flavors -
+quantum memory owning and non-owning (views). Moreover, the size of a quantum container
+can be specified at either compile-time or dynamically at runtime.
+As all qudits are non-copyable, qudits and containers
+thereof can only be passed by reference.</p>
+<p><strong>[8]</strong> Each allocated qudit is unique and if
+deallocated, is available for subsequent allocation. Deallocation occurs implicitly
+when the qudit goes out of scope. Uncomputation of qudit state should occur
+automatically via compiler implementations of the CUDA-Q model.</p>
+<p><strong>[9]</strong> The CUDA-Q model considers both remotely hosted QPU execution models as well as
+tightly-coupled quantum-classical architectures. Remotely hosted models
+support batch circuit execution where each circuit may contain simple
+quantum-classical operation integration. Tightly-coupled execution models provide
+streaming instruction execution, measure-reset, and fast-feedback of
+qubit measurement results. This multi-modal execution model directly
+influences the syntax and semantics of quantum kernel expressions
+and their associated host-code context.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../cudaq.html" class="btn btn-neutral float-left" title="Language Specification" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="namespace.html" class="btn btn-neutral float-right" title="2. Namespace and Standard" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/namespace.html b/pr-2241/specification/cudaq/namespace.html
new file mode 100644
index 0000000000..8e542cd057
--- /dev/null
+++ b/pr-2241/specification/cudaq/namespace.html
@@ -0,0 +1,663 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>2. Namespace and Standard &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="3. Quantum Types" href="types.html" />
+    <link rel="prev" title="1. Machine Model" href="machine_model.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">2. </span>Namespace and Standard</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/namespace.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="machine_model.html" class="btn btn-neutral float-left" title="1. Machine Model" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="types.html" class="btn btn-neutral float-right" title="3. Quantum Types" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="namespace-and-standard">
+<h1><span class="section-number">2. </span>Namespace and Standard<a class="headerlink" href="#namespace-and-standard" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> The CUDA-Q language is a library-based extension for C++. As such, all
+pertinent data structures and library functions exist within the CUDA-Q
+namespace. This namespace is denoted <code class="code docutils literal notranslate"><span class="pre">::cudaq</span></code>.</p>
+<p><strong>[2]</strong> CUDA-Q is a C++ library-based language extension adherent to the <a class="reference external" href="https://en.cppreference.com/w/cpp/20">C++20</a>
+language specification. Any implementations that require backwards compatibility to previous
+standards must retain the semantics of the user-facing API (e.g. <a class="reference external" href="https://en.cppreference.com/w/cpp/language/sfinae">SFINAE</a>
+instead of <a class="reference external" href="https://en.cppreference.com/w/cpp/language/constraints">concepts and constraints</a>).</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="machine_model.html" class="btn btn-neutral float-left" title="1. Machine Model" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="types.html" class="btn btn-neutral float-right" title="3. Quantum Types" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/operations.html b/pr-2241/specification/cudaq/operations.html
new file mode 100644
index 0000000000..bc7099ccbb
--- /dev/null
+++ b/pr-2241/specification/cudaq/operations.html
@@ -0,0 +1,768 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>5. Quantum Intrinsic Operations &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="6. Quantum Kernels" href="kernels.html" />
+    <link rel="prev" title="4. Quantum Operators" href="operators.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">5. </span>Quantum Intrinsic Operations</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/operations.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="operators.html" class="btn btn-neutral float-left" title="4. Quantum Operators" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="kernels.html" class="btn btn-neutral float-right" title="6. Quantum Kernels" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-intrinsic-operations">
+<h1><span class="section-number">5. </span>Quantum Intrinsic Operations<a class="headerlink" href="#quantum-intrinsic-operations" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> To support low-level quantum programming and build foundational
+quantum kernels for large-scale applications, CUDA-Q specifies the <em>quantum
+intrinsic operation</em> abstraction for device-specific single-qudit unitary operations.</p>
+<p><strong>[2]</strong> A quantum intrinsic operation is modeled via a standard free function in the native classical language. It
+has a unique instruction name and general specified function operands.</p>
+<p><strong>[3]</strong> These operands can model classical rotation parameters or units of quantum information (e.g. the <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>).
+The syntax for these operations is</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">INST_NAME</span><span class="p">(</span><span class="w"> </span><span class="n">PARAM</span><span class="p">...</span><span class="o">?</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">N</span><span class="o">&gt;&amp;</span><span class="p">...);</span>
+</pre></div>
+</div>
+<p>where <code class="code docutils literal notranslate"><span class="pre">INST_NAME</span></code> is the name of the instruction, <code class="code docutils literal notranslate"><span class="pre">qudit&lt;N&gt;&amp;...</span></code> indicates one many
+<code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances, and <code class="code docutils literal notranslate"><span class="pre">PARAM...?</span></code> indicates optional parameters of
+floating point type (e.g. <code class="code docutils literal notranslate"><span class="pre">double</span></code>, <code class="code docutils literal notranslate"><span class="pre">float</span></code>). Quantum intrinsic operations return <code class="code docutils literal notranslate"><span class="pre">void</span></code>.</p>
+<p><strong>[4]</strong> All intrinsic operations should start with a base declaration targeting a single <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>, and overloads
+should be provided that take more than one <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances to model the application
+of that instruction on all provided <code class="code docutils literal notranslate"><span class="pre">cudaq::qudits</span></code>, e.g. <code class="code docutils literal notranslate"><span class="pre">void</span> <span class="pre">x(cudaq::qubit&amp;)</span></code> and
+<code class="code docutils literal notranslate"><span class="pre">x(cudaq::qubit&amp;,</span> <span class="pre">cudaq::qubit&amp;,</span> <span class="pre">cudaq::qubit&amp;)</span></code>, modeling the NOT operation on a single
+<code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code> or on multiple <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code>.</p>
+<p><strong>[5]</strong> The specific set of quantum intrinsic operations available to the programmer can
+be platform specific and provided via platform specific header files.</p>
+<p><strong>[6]</strong> Implementations should provide overloads to support broadcasting of single-qubit
+intrinsic operations across containers of <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>. For example,
+<code class="code docutils literal notranslate"><span class="pre">x(cudaq::qvector&lt;&gt;&amp;)</span></code> should apply a NOT operation on all
+<code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code> in the provided <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code>.</p>
+<p><strong>[7]</strong> Programmers can further modify quantum intrinsic operations via
+an extra specified template parameter, and CUDA-Q leverages this syntax
+for synthesizing control and adjoint variants of the operation. Specifically CUDA-Q
+provides the <code class="code docutils literal notranslate"><span class="pre">cudaq::ctrl</span></code>, and <code class="code docutils literal notranslate"><span class="pre">cudaq::adj</span></code> type modifiers for synthesizing control and
+adjoint forms of the operation. For language bindings that do not support template
+parameterization, implementations may rely on static method calls (e.g. <code class="code docutils literal notranslate"><span class="pre">x.ctrl(q,</span> <span class="pre">r)</span></code>)</p>
+<p>Here is an example of how one might modify an intrinsic operation for multi-control and adjoint operations.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">,</span><span class="w"> </span><span class="n">s</span><span class="p">;</span>
+<span class="c1">// Apply T operation</span>
+<span class="n">t</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="c1">// Apply Tdg operation</span>
+<span class="n">t</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">adj</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="c1">// Apply control Hadamard operation</span>
+<span class="n">h</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="n">r</span><span class="p">,</span><span class="n">s</span><span class="p">);</span>
+<span class="c1">// Error, ctrl requires &gt; 1 qubit operands</span>
+<span class="c1">// h&lt;cudaq::ctrl&gt;(r);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">q</span><span class="p">,</span> <span class="n">r</span><span class="p">,</span> <span class="n">s</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">(),</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="c1"># Apply T operation</span>
+<span class="n">t</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+<span class="c1"># Apply Tdg operation</span>
+<span class="n">t</span><span class="o">.</span><span class="n">adj</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+<span class="c1"># Apply control Hadamard operation</span>
+<span class="n">h</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="n">r</span><span class="p">,</span><span class="n">s</span><span class="p">)</span>
+<span class="c1"># Error, ctrl requires &gt; 1 qubit operands</span>
+<span class="c1"># h.ctrl(r);</span>
+</pre></div>
+</div>
+</div>
+</div>
+<section id="operations-on-cudaq-qubit">
+<h2><span class="section-number">5.1. </span>Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code><a class="headerlink" href="#operations-on-cudaq-qubit" title="Permalink to this heading">¶</a></h2>
+<p>The default set of quantum intrinsic operations for the cudaq::qubit type is as follows:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">struct</span><span class="w"> </span><span class="nc">base</span><span class="p">;</span>
+<span class="w">    </span><span class="k">struct</span><span class="w"> </span><span class="nc">ctrl</span><span class="p">;</span>
+<span class="w">    </span><span class="k">struct</span><span class="w"> </span><span class="nc">adj</span><span class="p">;</span>
+
+<span class="w">    </span><span class="c1">// Single qubit operations, ctrl / adj variants, and broadcasting</span>
+<span class="w">    </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">mod</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">base</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">QubitArgs</span><span class="o">&gt;</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">NAME</span><span class="p">(</span><span class="n">QubitArgs</span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">mod</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">base</span><span class="o">&gt;</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">NAME</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">qvector</span><span class="o">&amp;</span><span class="w"> </span><span class="n">qr</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="k">template</span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">mod</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ctrl</span><span class="o">&gt;</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">NAME</span><span class="p">(</span><span class="n">qvector</span><span class="o">&amp;</span><span class="w"> </span><span class="n">ctrls</span><span class="p">,</span><span class="w"> </span><span class="n">qubit</span><span class="o">&amp;</span><span class="w"> </span><span class="n">target</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="c1">// Single qubit rotation operations and ctrl / adj variants</span>
+<span class="w">    </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">mod</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">base</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="w"> </span><span class="nc">ScalarAngle</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">QubitArgs</span><span class="o">&gt;</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">ROTATION_NAME</span><span class="p">(</span><span class="n">ScalarAngle</span><span class="w"> </span><span class="n">angle</span><span class="p">,</span><span class="w"> </span><span class="n">QubitArgs</span><span class="w"> </span><span class="o">&amp;</span><span class="p">...</span><span class="n">args</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="kt">bool</span><span class="w"> </span><span class="n">MEASURE_OP</span><span class="p">(</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="p">;</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">bool</span><span class="o">&gt;</span><span class="w"> </span><span class="n">MEASURE_OP</span><span class="p">(</span><span class="n">qvector</span><span class="w"> </span><span class="o">&amp;</span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="p">;</span>
+<span class="w">    </span><span class="kt">double</span><span class="w"> </span><span class="nf">measure</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="o">&amp;</span><span class="w"> </span><span class="n">term</span><span class="p">)</span><span class="w"> </span><span class="k">noexcept</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p><strong>[1]</strong> For the default implementation of the <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code> intrinsic operations, we let
+NAME be any operation name in the set <code class="code docutils literal notranslate"><span class="pre">{h,</span> <span class="pre">x,</span> <span class="pre">y,</span> <span class="pre">z,</span> <span class="pre">t,</span> <span class="pre">s}</span></code> and <code class="code docutils literal notranslate"><span class="pre">ROTATION_NAME</span></code> be any
+operation in <code class="code docutils literal notranslate"><span class="pre">{rx,</span> <span class="pre">ry,</span> <span class="pre">rz,</span> <span class="pre">r1</span> <span class="pre">(phase)}</span></code>. Implementations may provide appropriate
+function implementations using the above foundational functions to enable other
+common operations (e.g. <code class="code docutils literal notranslate"><span class="pre">cnot</span> <span class="pre">-&gt;</span> <span class="pre">x&lt;cudaq::ctrl&gt;</span></code>).</p>
+<p><strong>[2]</strong> Control qubits can be specified with positive or negative polarity.
+By this we mean that a control qubit can specify that a target operation is
+applied if the control qubit state is a <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> (positive polarity) or <code class="code docutils literal notranslate"><span class="pre">|1&gt;</span></code> (negative polarity).
+By default all control qubits are assumed to convey positive polarity. The
+syntax for negating the polarity is the not operator preceding the control
+qubit</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="o">!</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="o">~</span><span class="n">q</span><span class="p">,</span> <span class="n">r</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The set of gates that the official CUDA-Q implementation supports can be found in the <a class="reference internal" href="../../api/api.html"><span class="doc">API documentation</span></a>.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="operators.html" class="btn btn-neutral float-left" title="4. Quantum Operators" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="kernels.html" class="btn btn-neutral float-right" title="6. Quantum Kernels" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/operators.html b/pr-2241/specification/cudaq/operators.html
new file mode 100644
index 0000000000..2f8e05ad8b
--- /dev/null
+++ b/pr-2241/specification/cudaq/operators.html
@@ -0,0 +1,725 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>4. Quantum Operators &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="5. Quantum Intrinsic Operations" href="operations.html" />
+    <link rel="prev" title="3. Quantum Types" href="types.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">4. </span>Quantum Operators</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/operators.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="types.html" class="btn btn-neutral float-left" title="3. Quantum Types" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="operations.html" class="btn btn-neutral float-right" title="5. Quantum Intrinsic Operations" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-operators">
+<h1><span class="section-number">4. </span>Quantum Operators<a class="headerlink" href="#quantum-operators" title="Permalink to this heading">¶</a></h1>
+<section id="cudaq-spin-op">
+<h2><span class="section-number">4.1. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code><a class="headerlink" href="#cudaq-spin-op" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> CUDA-Q provides a native <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> data type in the <code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> namespace for the
+expression of quantum mechanical spin operators.</p>
+<p><strong>[2]</strong> The <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> provides an abstraction for a general tensor product of Pauli
+spin operators, and sums thereof:</p>
+<div class="math notranslate nohighlight">
+\[H = \sum_{i=0}^M P_i, P_i = \prod_{j=0}^N \sigma_j^a\]</div>
+<p>for <span class="math notranslate nohighlight">\(a = {x,y,z}\)</span>, <span class="math notranslate nohighlight">\(j\)</span> the qubit index, and <span class="math notranslate nohighlight">\(N\)</span> the number of qubits.</p>
+<p><strong>[3]</strong> The <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> exposes common C++ operator overloads for algebraic expressions.</p>
+<p><strong>[4]</strong> CUDA-Q defines convenience functions in <code class="code docutils literal notranslate"><span class="pre">cudaq::spin</span></code> namespace that produce
+the primitive X, Y, and Z Pauli operators on specified qubit indices
+which can subsequently be used in algebraic expressions to build up
+more complicated Pauli tensor products and their sums.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span><span class="w"> </span>\
+<span class="w">         </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+<span class="n">h</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> \
+         <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[5]</strong> The <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> also provides a mechanism for the expression of circuit
+synthesis tasks within quantum kernel code. Specifically, operations
+that encode <span class="math notranslate nohighlight">\(N\)</span><sup>th</sup>order trotterization of exponentiated <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code>
+rotations, e.g. <span class="math notranslate nohighlight">\(U = \exp(-i H t)\)</span>, where <span class="math notranslate nohighlight">\(H\)</span> is the provided <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code>.</p>
+<p><strong>[6]</strong> The <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> can be created within classical host code and quantum kernel
+code, and can also be passed by value to quantum kernel code from host code.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> should take on the following structure:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">spin_op</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="p">();</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="kt">bool</span><span class="w"> </span><span class="nf">empty</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">num_qubits</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">num_terms</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">complex</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">get_coefficient</span><span class="p">();</span>
+<span class="w">      </span><span class="kt">bool</span><span class="w"> </span><span class="nf">is_identity</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">for_each_term</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">function</span><span class="o">&lt;</span><span class="kt">void</span><span class="p">(</span><span class="n">spin_op</span><span class="w"> </span><span class="o">&amp;</span><span class="p">)</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="p">)</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">for_each_pauli</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">function</span><span class="o">&lt;</span><span class="kt">void</span><span class="p">(</span><span class="n">pauli</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="p">)</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="p">)</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">+=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">-=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">*=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="kt">bool</span><span class="w"> </span><span class="k">operator</span><span class="o">==</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="p">);</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">*=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="kt">double</span><span class="p">);</span>
+<span class="w">      </span><span class="n">spin_op</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">*=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">complex</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="p">)</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="k">namespace</span><span class="w"> </span><span class="nn">spin</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">spin_op</span><span class="w"> </span><span class="nf">x</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="p">);</span>
+<span class="w">    </span><span class="n">spin_op</span><span class="w"> </span><span class="nf">y</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="p">);</span>
+<span class="w">    </span><span class="n">spin_op</span><span class="w"> </span><span class="nf">z</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="types.html" class="btn btn-neutral float-left" title="3. Quantum Types" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="operations.html" class="btn btn-neutral float-right" title="5. Quantum Intrinsic Operations" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/patterns.html b/pr-2241/specification/cudaq/patterns.html
new file mode 100644
index 0000000000..972ae90e57
--- /dev/null
+++ b/pr-2241/specification/cudaq/patterns.html
@@ -0,0 +1,701 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>10. Common Quantum Programming Patterns &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="11. Quantum Platform" href="platform.html" />
+    <link rel="prev" title="9. Just-in-Time Kernel Creation" href="dynamic_kernels.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">10. </span>Common Quantum Programming Patterns</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/patterns.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="dynamic_kernels.html" class="btn btn-neutral float-left" title="9. Just-in-Time Kernel Creation" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="platform.html" class="btn btn-neutral float-right" title="11. Quantum Platform" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="common-quantum-programming-patterns">
+<h1><span class="section-number">10. </span>Common Quantum Programming Patterns<a class="headerlink" href="#common-quantum-programming-patterns" title="Permalink to this heading">¶</a></h1>
+<section id="compute-action-uncompute">
+<h2><span class="section-number">10.1. </span>Compute-Action-Uncompute<a class="headerlink" href="#compute-action-uncompute" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> CUDA-Q specifies syntax and semantics to support the compute-action-uncompute
+pattern, <span class="math notranslate nohighlight">\(W = U V U \dagger\)</span> (here <span class="math notranslate nohighlight">\(U\)</span> is the compute block, and <span class="math notranslate nohighlight">\(V\)</span> is the action block).</p>
+<p><strong>[2]</strong> Via special syntax for this pattern CUDA-Q enables compiler implementations to
+key on circuit optimizations via programmer intent. Specifically, controlled versions of <span class="math notranslate nohighlight">\(W\)</span> do not produce controlled
+operations of all instructions in <span class="math notranslate nohighlight">\(U\)</span>, <span class="math notranslate nohighlight">\(V\)</span>, and <span class="math notranslate nohighlight">\(U \dagger\)</span>, but instead we are free to only
+control <span class="math notranslate nohighlight">\(V\)</span>.</p>
+<p><strong>[3]</strong> The CUDA-Q specification requires the following syntax for this pattern:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Will invoke U V U^dag</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">compute_action</span><span class="w"> </span><span class="p">(</span>
+<span class="w">    </span><span class="p">[</span><span class="o">&amp;</span><span class="p">](){</span>
+<span class="w">      </span><span class="cm">/*U_code*/</span>
+<span class="w">    </span><span class="p">},</span>
+<span class="w">    </span><span class="p">[</span><span class="o">&amp;</span><span class="p">]()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="cm">/*V_code*/</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">computeF</span><span class="p">():</span>
+   <span class="o">...</span>
+
+<span class="k">def</span> <span class="nf">actionF</span><span class="p">():</span>
+   <span class="o">...</span>
+
+<span class="c1"># Can take user-defined functions</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">compute_action</span><span class="p">(</span><span class="n">computeF</span><span class="p">,</span> <span class="n">actionF</span><span class="p">)</span>
+
+<span class="c1"># Can take Pythonic CUDA-Q lambda kernels</span>
+<span class="n">computeL</span> <span class="o">=</span> <span class="k">lambda</span> <span class="p">:</span> <span class="p">(</span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">),</span> <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">),</span> <span class="n">ry</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]))</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">compute_action</span><span class="p">(</span><span class="n">computeL</span><span class="p">,</span> <span class="n">actionF</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[4]</strong> Compiler implementations must add the uncompute segment
+and optimize on any controlled versions of this block of code.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="dynamic_kernels.html" class="btn btn-neutral float-left" title="9. Just-in-Time Kernel Creation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="platform.html" class="btn btn-neutral float-right" title="11. Quantum Platform" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/platform.html b/pr-2241/specification/cudaq/platform.html
new file mode 100644
index 0000000000..210c3679a5
--- /dev/null
+++ b/pr-2241/specification/cudaq/platform.html
@@ -0,0 +1,698 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>11. Quantum Platform &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="12. Quantum Algorithmic Primitives" href="algorithmic_primitives.html" />
+    <link rel="prev" title="10. Common Quantum Programming Patterns" href="patterns.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">11. </span>Quantum Platform</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/platform.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="patterns.html" class="btn btn-neutral float-left" title="10. Common Quantum Programming Patterns" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="algorithmic_primitives.html" class="btn btn-neutral float-right" title="12. Quantum Algorithmic Primitives" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-platform">
+<h1><span class="section-number">11. </span>Quantum Platform<a class="headerlink" href="#quantum-platform" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> CUDA-Q provides an abstraction describing the underlying quantum computing resource(s).
+The underlying quantum platform can contain one or many quantum processing units (QPUs) each with
+its own qubit connectivity and noise configuration.</p>
+<p><strong>[2]</strong> CUDA-Q defines a <code class="code docutils literal notranslate"><span class="pre">cudaq::quantum_platform</span></code> in an effort to expose relevant system
+information and enable asynchronous quantum kernel invocations.</p>
+<p><strong>[3]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::quantum_platform</span></code> provides an API for querying the number of available
+quantum processing units (QPUs), with each QPU assigned a logical integer index (<code class="code docutils literal notranslate"><span class="pre">{0,1,2,...}</span></code>).</p>
+<p><strong>[4]</strong> Programmers can specify the ID of the desired QPU and all subsequent CUDA-Q
+kernel executions will target that QPU.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::quantum_platform</span></code>  should take the following structure</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">quantum_platform</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">public</span><span class="o">:</span>
+<span class="w">    </span><span class="n">quantum_platform</span><span class="p">();</span>
+<span class="w">    </span><span class="o">~</span><span class="n">quantum_platform</span><span class="p">();</span>
+
+<span class="w">    </span><span class="k">using</span><span class="w"> </span><span class="n">QubitEdge</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">pair</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="p">;</span>
+<span class="w">    </span><span class="k">using</span><span class="w"> </span><span class="n">QubitConnectivity</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">QubitEdge</span><span class="o">&gt;</span><span class="p">;</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">optional</span><span class="o">&lt;</span><span class="n">QubitConnectivity</span><span class="o">&gt;</span><span class="w"> </span><span class="n">connectivity</span><span class="p">();</span>
+
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">num_qpus</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">get_num_qubits</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qpu_id</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+
+<span class="w">    </span><span class="kt">bool</span><span class="w"> </span><span class="nf">is_simulator</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qpu_id</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">    </span><span class="kt">bool</span><span class="w"> </span><span class="nf">is_remote</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qpuId</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">);</span>
+<span class="w">    </span><span class="kt">bool</span><span class="w"> </span><span class="nf">is_emulated</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qpuId</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">string</span><span class="w"> </span><span class="nf">name</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">get_current_qpu</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="p">;</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="nf">set_current_qpu</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">device_id</span><span class="p">);</span>
+
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>CUDA-Q provides the following public functions to interact with the current
+<code class="code docutils literal notranslate"><span class="pre">cudaq::quantum_platform</span></code></p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">quantum_platform</span><span class="w"> </span><span class="o">&amp;</span><span class="nf">get_platform</span><span class="p">()</span><span class="w"> </span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="patterns.html" class="btn btn-neutral float-left" title="10. Common Quantum Programming Patterns" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="algorithmic_primitives.html" class="btn btn-neutral float-right" title="12. Quantum Algorithmic Primitives" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/synthesis.html b/pr-2241/specification/cudaq/synthesis.html
new file mode 100644
index 0000000000..7e1c0c2f4d
--- /dev/null
+++ b/pr-2241/specification/cudaq/synthesis.html
@@ -0,0 +1,753 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>7. Sub-circuit Synthesis &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="8. Control Flow" href="control_flow.html" />
+    <link rel="prev" title="6. Quantum Kernels" href="kernels.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">7. </span>Sub-circuit Synthesis</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/synthesis.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="kernels.html" class="btn btn-neutral float-left" title="6. Quantum Kernels" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="control_flow.html" class="btn btn-neutral float-right" title="8. Control Flow" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="sub-circuit-synthesis">
+<h1><span class="section-number">7. </span>Sub-circuit Synthesis<a class="headerlink" href="#sub-circuit-synthesis" title="Permalink to this heading">¶</a></h1>
+<p><strong>[1]</strong> Execution of pure device quantum kernels can be modified via explicit intrinsic
+library calls that provide multi-qubit controlled application and adjoint,
+or circuit reversal, semantics.</p>
+<p><strong>[2]</strong> CUDA-Q defines the following library functions
+for enabling multi-controlled and adjoint operations on a general pure
+device kernel:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="kt">void</span><span class="w"> </span><span class="n">control</span><span class="p">(</span><span class="n">QuantumKernel</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">kernel</span><span class="p">,</span>
+<span class="w">             </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="o">&amp;</span><span class="w"> </span><span class="n">ctrl_qubit</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="w"> </span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumRegister</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">requires</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">ranges</span><span class="o">::</span><span class="n">range</span><span class="o">&lt;</span><span class="n">QuantumRegister</span><span class="o">&gt;</span><span class="p">)</span>
+<span class="kt">void</span><span class="w"> </span><span class="n">control</span><span class="p">(</span><span class="n">QuantumKernel</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">kernel</span><span class="p">,</span>
+<span class="w">             </span><span class="n">QuantumRegister</span><span class="o">&amp;</span><span class="w"> </span><span class="n">ctrl_qubits</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="w"> </span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+
+<span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">QuantumKernel</span><span class="p">,</span><span class="w"> </span><span class="k">typename</span><span class="p">...</span><span class="w"> </span><span class="n">Args</span><span class="o">&gt;</span>
+<span class="kt">void</span><span class="w"> </span><span class="n">adjoint</span><span class="p">(</span><span class="n">QuantumKernel</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">Args</span><span class="w"> </span><span class="o">&amp;</span><span class="p">...</span><span class="w"> </span><span class="n">args</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>These functions can be leveraged in quantum kernel code in the following way</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">x_gate</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="o">&amp;</span><span class="w"> </span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="p">}</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">kernel</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()</span><span class="w"> </span><span class="p">()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">3</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="p">...</span>
+<span class="w">    </span><span class="c1">// Create Toffoli gate</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">ctrl_bits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">control</span><span class="p">(</span><span class="n">x_gate</span><span class="p">,</span><span class="w"> </span><span class="n">ctrl_bits</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">...</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">void</span><span class="w"> </span><span class="nf">rx_and_h_gate</span><span class="p">(</span><span class="kt">double</span><span class="w"> </span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="o">&amp;</span><span class="w"> </span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">rx</span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="p">}</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="nf">kernel</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">N</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="n">N</span><span class="p">);</span>
+<span class="w">  </span><span class="p">...</span>
+<span class="w">  </span><span class="c1">// apply h(q[2]); rx(-pi, q[2]);</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">adjoint</span><span class="p">(</span><span class="n">rx_and_h_gate</span><span class="p">{},</span><span class="w"> </span><span class="n">M_PI</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">...</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">x_gate</span><span class="p">(</span><span class="n">q</span> <span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">):</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">kernelTestControl</span><span class="p">():</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span>
+    <span class="o">...</span>
+    <span class="n">ctrl_bits</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">front</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">x_gate</span><span class="p">,</span> <span class="n">ctrl_bits</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="o">...</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">rx_and_h_gate</span><span class="p">(</span><span class="n">x</span> <span class="p">:</span> <span class="nb">float</span><span class="p">,</span> <span class="n">q</span> <span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">):</span>
+    <span class="n">rx</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">q</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span><span class="p">()</span>
+<span class="k">def</span> <span class="nf">kernelTestAdjoint</span><span class="p">(</span><span class="n">N</span> <span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">N</span><span class="p">)</span>
+    <span class="o">...</span>
+    <span class="c1"># apply h(q[2]); rx(-pi, q[2])</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">adjoint</span><span class="p">(</span><span class="n">rx_and_h_gate</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span> <span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="o">...</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[3]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::control(...)</span></code> function takes as input an instantiated pure
+device quantum kernel, a std::range of control qubits (<code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code>
+or <code class="code docutils literal notranslate"><span class="pre">cudaq::qview</span></code>), and the remaining arguments for the kernel itself.</p>
+<p><strong>[4]</strong> Compiler implementations are free to synthesize multi-controlled operations
+using any pertinent synthesis strategy available. Qubits may be aggregated into
+a range of control qubits with or without the use of the <code class="code docutils literal notranslate"><span class="pre">operator!</span></code>
+<a class="reference internal" href="operations.html"><span class="doc">negated polarity operator</span></a>.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">::</span><span class="n">control</span><span class="p">(</span><span class="n">kernel</span><span class="p">{},</span><span class="w"> </span><span class="p">{</span><span class="n">qubit0</span><span class="p">,</span><span class="w"> </span><span class="o">!</span><span class="n">qubit1</span><span class="p">},</span><span class="w"> </span><span class="n">kernel_arg</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="p">[</span><span class="n">qubit0</span><span class="p">,</span> <span class="o">~</span><span class="n">qubit1</span><span class="p">],</span> <span class="n">kernel_arg</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p><strong>[5]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::adjoint(...)</span></code> function takes as input an
+pure device quantum kernel and the remaining arguments for the kernel.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="kernels.html" class="btn btn-neutral float-left" title="6. Quantum Kernels" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="control_flow.html" class="btn btn-neutral float-right" title="8. Control Flow" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/cudaq/types.html b/pr-2241/specification/cudaq/types.html
new file mode 100644
index 0000000000..4285a49dd2
--- /dev/null
+++ b/pr-2241/specification/cudaq/types.html
@@ -0,0 +1,1074 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>3. Quantum Types &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="4. Quantum Operators" href="operators.html" />
+    <link rel="prev" title="2. Namespace and Standard" href="namespace.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="../index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2 current"><a class="reference internal" href="../cudaq.html">   Language Specification</a><ul class="current">
+<li class="toctree-l3"><a class="reference internal" href="machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3 current"><a class="current reference internal" href="#">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../index.html">Specifications</a></li>
+          <li class="breadcrumb-item"><a href="../cudaq.html">Language Specification</a></li>
+      <li class="breadcrumb-item active"><span class="section-number">3. </span>Quantum Types</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/specification/cudaq/types.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="namespace.html" class="btn btn-neutral float-left" title="2. Namespace and Standard" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="operators.html" class="btn btn-neutral float-right" title="4. Quantum Operators" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-types">
+<h1><span class="section-number">3. </span>Quantum Types<a class="headerlink" href="#quantum-types" title="Permalink to this heading">¶</a></h1>
+<p>The CUDA-Q language extension provides certain fundamental types that are pertinent
+to quantum-classical computing. These types are provided via defined classical library
+types in C++ in the <code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> namespace.</p>
+<section id="cudaq-qudit-levels">
+<h2><span class="section-number">3.1. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code><a class="headerlink" href="#cudaq-qudit-levels" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> models a <span class="math notranslate nohighlight">\(D\)</span>-level unit of quantum information. The state of
+this system (for <span class="math notranslate nohighlight">\(N\)</span> qudits) can be described by a <span class="math notranslate nohighlight">\(D\)</span><sup>N</sup>-dimensional vector in
+Hilbert space with the absolute square of all elements summing to 1.</p>
+<p><strong>[2]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> encapsulates a unique <code class="code docutils literal notranslate"><span class="pre">std::size_t</span></code> modeling the index of the
+qudit in the underlying quantum memory space (assuming an infinite register
+of available qudits).</p>
+<p><strong>[4]</strong> To adhere to the no-cloning theorem of quantum mechanics,
+the <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> is non-copyable and non-movable. Therefore, all <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>
+instances must be passed by reference, and the no-cloning theorem is satisfied
+at compile-time.</p>
+<p><strong>[5]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances can only be allocated within CUDA-Q quantum
+kernel code and can never be allocated from classical host code.</p>
+<p><strong>[6]</strong> All instantiated <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances start in the <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> computational basis
+state and serve as the primary input argument for quantum intrinsic operations
+modeling typical logical quantum gate operations.</p>
+<p><strong>[7]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances can be negated when leveraged as controls in
+quantum operation invocations. The mechanism for negation should be via overloading of <code class="code docutils literal notranslate"><span class="pre">qudit&lt;N&gt;::operator!()</span></code>.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> takes on the following structure</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="k">class</span><span class="w"> </span><span class="nc">qudit</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">protected</span><span class="o">:</span>
+<span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">idx</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">  </span><span class="k">public</span><span class="o">:</span>
+<span class="w">    </span><span class="n">qudit</span><span class="p">();</span>
+<span class="w">    </span><span class="n">qudit</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">qudit</span><span class="o">&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+<span class="w">    </span><span class="n">qudit</span><span class="p">(</span><span class="n">qudit</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">id</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">    </span><span class="k">static</span><span class="w"> </span><span class="k">constexpr</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">n_levels</span><span class="p">();</span>
+<span class="w">    </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="k">operator</span><span class="o">!</span><span class="p">();</span>
+<span class="p">};</span>
+</pre></div>
+</div>
+</section>
+<section id="cudaq-qubit">
+<h2><span class="section-number">3.2. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code><a class="headerlink" href="#cudaq-qubit" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> The specification provides a primitive <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code> type which models a
+single quantum bit (<span class="math notranslate nohighlight">\(2\)</span>-level) in the discrete quantum memory space.
+<code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code> is an alias for <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;2&gt;</span></code></p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="n">qubit</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">qudit</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Allocate a qubit in the |0&gt; state</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">  </span><span class="c1">// Put the qubit in a superposition of |0&gt; and |1&gt;</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="c1">// cudaq::h == hadamard, ADL leveraged</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;ID = %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">id</span><span class="p">());</span><span class="w"> </span><span class="c1">// prints 0</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">r</span><span class="p">;</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;ID = %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">.</span><span class="n">id</span><span class="p">());</span><span class="w"> </span><span class="c1">// prints 1</span>
+<span class="w">  </span><span class="c1">// qubit out of scope, implicit deallocation</span>
+<span class="p">}</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="n">printf</span><span class="p">(</span><span class="s">&quot;ID = %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">id</span><span class="p">());</span><span class="w"> </span><span class="c1">// prints 0 (previous deallocated)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Allocate a qubit in the |0&gt; state</span>
+<span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="c1"># Put the qubit in a superposition of |0&gt; and |1&gt;</span>
+<span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;ID = </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">q</span><span class="o">.</span><span class="n">id</span><span class="p">()))</span> <span class="c1"># prints 0</span>
+
+<span class="n">r</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;ID = </span><span class="si">{}</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">r</span><span class="o">.</span><span class="n">id</span><span class="p">())</span> <span class="c1"># prints 1</span>
+<span class="c1"># qubits go out of scope, implicit deallocation</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="quantum-containers">
+<h2><span class="section-number">3.3. </span>Quantum Containers<a class="headerlink" href="#quantum-containers" title="Permalink to this heading">¶</a></h2>
+<p><strong>[1]</strong> CUDA-Q specifies abstractions for dealing with groups of <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances in the
+form of familiar C++ containers.</p>
+<p><strong>[2]</strong> The underlying connectivity of the <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code> instances stored in these containers is opaque to
+the programmer and any logical-to-physical program connectivity mapping should be done by compiler implementations.</p>
+<section id="cudaq-qview-levels-2">
+<h3><span class="section-number">3.3.1. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qview&lt;Levels</span> <span class="pre">=</span> <span class="pre">2&gt;</span></code><a class="headerlink" href="#cudaq-qview-levels-2" title="Permalink to this heading">¶</a></h3>
+<p><strong>[1]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qview&lt;N&gt;</span></code> is a non-owning reference to a subset of the discrete quantum memory space,
+and as such, it is a <code class="code docutils literal notranslate"><span class="pre">std::span</span></code>-like C++ range of <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>.</p>
+<p><strong>[2]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qview</span></code> does not own its elements and can therefore be passed by value or reference.</p>
+<p><strong>[3]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qview</span></code> is templated on the dimensionality of the contained quantum information unit,
+and defaults to <span class="math notranslate nohighlight">\(2\)</span> for qubit systems.</p>
+<p><strong>[4]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qview</span></code> provides an API for individual qubit extraction and sub-register slicing.
+Programmers can extract the front <span class="math notranslate nohighlight">\(N\)</span> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>, the back <span class="math notranslate nohighlight">\(N\)</span> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>, and the
+inner slice starting at a given index and including user-specified <code class="code docutils literal notranslate"><span class="pre">count</span></code> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::qview</span></code> should take on the following structure:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">Levels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">qview</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">private</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">span</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">qudits</span><span class="p">;</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="c1">// Construct a span that refers to the qudits in `other`.</span>
+<span class="w">      </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">R</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="k">requires</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">ranges</span><span class="o">::</span><span class="n">range</span><span class="o">&lt;</span><span class="n">R</span><span class="o">&gt;</span><span class="p">)</span>
+<span class="w">      </span><span class="n">qview</span><span class="p">(</span><span class="n">R</span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="n">other</span><span class="p">);</span>
+<span class="w">      </span><span class="n">qview</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">qview</span><span class="o">&amp;</span><span class="w"> </span><span class="n">other</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Iterator interface.</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">begin</span><span class="p">();</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">end</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the qudit at `idx`.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="k">operator</span><span class="p">[](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">idx</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[0, count)` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">front</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the first qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">front</span><span class="p">();</span>
+<span class="w">      </span><span class="c1">// Returns the `[count, size())` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">back</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the last qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">back</span><span class="p">();</span>
+
+
+<span class="w">      </span><span class="c1">// Returns the `[start, start+count)` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the number of contained qudits.</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">size</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="cudaq-qvector-levels-2">
+<h3><span class="section-number">3.3.2. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qvector&lt;Levels</span> <span class="pre">=</span> <span class="pre">2&gt;</span></code><a class="headerlink" href="#cudaq-qvector-levels-2" title="Permalink to this heading">¶</a></h3>
+<p><strong>[1]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector&lt;Levels&gt;</span></code> is a container of elements from the discrete quantum memory space - a C++ container of <code class="code docutils literal notranslate"><span class="pre">cuda::qudit</span></code>.</p>
+<p><strong>[2]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code> is a dynamically constructed owning container for <code class="code docutils literal notranslate"><span class="pre">cuda::qudit</span></code> (<code class="code docutils literal notranslate"><span class="pre">std::vector</span></code>-like),
+and since it owns the quantum memory, it cannot be copied or moved.</p>
+<p><strong>[3]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code> is templated on the dimensionality of the contained
+quantum information unit, and defaults to <span class="math notranslate nohighlight">\(2\)</span> for qubit systems.</p>
+<p><strong>[4]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code> can only be instantiated within CUDA-Q kernels</p>
+<p><strong>[5]</strong> All qudits in the <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code> start in the <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> computational basis state.</p>
+<p><strong>[6]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector</span></code> provides an API for individual qubit extraction and sub-register slicing.
+Programmers can extract the front <span class="math notranslate nohighlight">\(N\)</span> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>, the back <span class="math notranslate nohighlight">\(N\)</span> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>, and the
+inner slice starting at a given index and including user-specified <code class="code docutils literal notranslate"><span class="pre">count</span></code> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::qview</span></code> should take on the following structure:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">Levels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">qvector</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">private</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">qudits</span><span class="p">;</span>
+
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="c1">// Construct a qreg with `size` qudits in the |0&gt; state.</span>
+<span class="w">      </span><span class="n">qvector</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">size</span><span class="p">);</span>
+<span class="w">      </span><span class="n">qvector</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">qvector</span><span class="o">&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+
+<span class="w">      </span><span class="c1">// Iterator interface.</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">begin</span><span class="p">();</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">end</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the qudit at `idx`.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="k">operator</span><span class="p">[](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">idx</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[0, count)` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">front</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the first qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">front</span><span class="p">();</span>
+<span class="w">      </span><span class="c1">// Returns the `[count, size())` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">back</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the last qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">back</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[start, start+count)` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `{start, start + stride, ...}` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">stride</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">end</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the number of contained qudits.</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">size</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+
+<span class="w">      </span><span class="c1">// Destroys all contained qudits. Postcondition: `size() == 0`.</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">clear</span><span class="p">();</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Allocate 20 qubits, std::vector-like semantics</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">20</span><span class="p">);</span>
+<span class="c1">// Get first qubit</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">first</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">front</span><span class="p">();</span>
+<span class="c1">// Get first 5 qubits</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">first_5</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+<span class="c1">// Get last qubit</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">last</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">back</span><span class="p">();</span>
+<span class="c1">// Can loop over qubits with size() method</span>
+<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">size</span><span class="p">();</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="p">...</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="n">something</span><span class="w"> </span><span class="n">with</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="w"> </span><span class="p">...</span>
+<span class="p">}</span>
+<span class="c1">// Range based for loop supported</span>
+<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="w"> </span><span class="n">qb</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="p">...</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="n">something</span><span class="w"> </span><span class="n">with</span><span class="w"> </span><span class="n">qb</span><span class="w"> </span><span class="p">...</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Allocate 20 qubits, vector-like semantics</span>
+<span class="n">q</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">20</span><span class="p">)</span>
+<span class="c1"># Get the first qubit</span>
+<span class="n">first</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">front</span><span class="p">()</span>
+<span class="c1"># Get the first 5 qubits</span>
+<span class="n">first_5</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">front</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span>
+<span class="c1"># Get the last qubit</span>
+<span class="n">last</span> <span class="o">=</span> <span class="n">q</span><span class="o">.</span><span class="n">back</span><span class="p">()</span>
+<span class="c1"># Can loop over qubits with size or len function</span>
+<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">q</span><span class="p">)):</span>
+  <span class="o">..</span> <span class="n">do</span> <span class="n">something</span> <span class="k">with</span> <span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">..</span>
+<span class="c1"># Range based for loop</span>
+<span class="k">for</span> <span class="n">qb</span> <span class="ow">in</span> <span class="n">q</span><span class="p">:</span>
+  <span class="o">..</span> <span class="n">do</span> <span class="n">something</span> <span class="k">with</span> <span class="n">qb</span> <span class="o">..</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="cudaq-qarray-n-levels-2">
+<h3><span class="section-number">3.3.3. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qarray&lt;N,</span> <span class="pre">Levels</span> <span class="pre">=</span> <span class="pre">2&gt;</span></code><a class="headerlink" href="#cudaq-qarray-n-levels-2" title="Permalink to this heading">¶</a></h3>
+<p><strong>[1]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qarray&lt;N,</span> <span class="pre">Levels&gt;</span></code> (where <code class="code docutils literal notranslate"><span class="pre">N</span></code> is an integral constant) is a statically
+allocated container (<code class="code docutils literal notranslate"><span class="pre">std::array</span></code>-like). The utility of this type is in the compile-time
+knowledge of allocated containers of qudits that may directly enable ahead-of-time quantum
+optimization and synthesis.</p>
+<p><strong>[2]</strong> The second template parameter defaults to <span class="math notranslate nohighlight">\(2\)</span>-level <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>.</p>
+<p><strong>[3]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qarray</span></code> owns the quantum memory it contains, and therefore cannot be copied or moved.</p>
+<p><strong>[4]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qarray</span></code> can only be instantiated within CUDA-Q kernels</p>
+<p><strong>[5]</strong> All qudits in the <code class="code docutils literal notranslate"><span class="pre">cudaq::qarray</span></code> start in the <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> computational basis state.</p>
+<p><strong>[6]</strong> The <code class="code docutils literal notranslate"><span class="pre">cudaq::qarray</span></code> provides an API for individual qubit extraction and sub-register slicing.
+Programmers can extract the front <span class="math notranslate nohighlight">\(N\)</span> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>, the back <span class="math notranslate nohighlight">\(N\)</span> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>, and the
+inner slice starting at a given index and including user-specified <code class="code docutils literal notranslate"><span class="pre">count</span></code> <code class="code docutils literal notranslate"><span class="pre">qudits</span></code>.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::qarray</span></code> should take on the following structure:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">N</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">Levels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">qarray</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">private</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">array</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="p">,</span><span class="w"> </span><span class="n">N</span><span class="o">&gt;</span><span class="w"> </span><span class="n">qudits</span><span class="p">;</span>
+
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="c1">// Construct a qreg with `size` qudits in the |0&gt; state.</span>
+<span class="w">      </span><span class="n">qarray</span><span class="p">();</span>
+<span class="w">      </span><span class="n">qarray</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">qvector</span><span class="o">&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+<span class="w">      </span><span class="n">qarray</span><span class="p">(</span><span class="n">qarray</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+
+<span class="w">      </span><span class="n">qarray</span><span class="o">&amp;</span><span class="w"> </span><span class="k">operator</span><span class="o">=</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">qarray</span><span class="w"> </span><span class="o">&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+
+<span class="w">      </span><span class="c1">// Iterator interface.</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">begin</span><span class="p">();</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">end</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the qudit at `idx`.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="k">operator</span><span class="p">[](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">idx</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[0, count)` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">front</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the first qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">front</span><span class="p">();</span>
+<span class="w">      </span><span class="c1">// Returns the `[count, size())` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">back</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the last qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">back</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[start, start+count)` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `{start, start + stride, ...}` qudits.</span>
+<span class="w">      </span><span class="n">qview</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">stride</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">end</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the number of contained qudits.</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">size</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+
+<span class="w">      </span><span class="c1">// Destroys all contained qudits. Postcondition: `size() == 0`.</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">clear</span><span class="p">();</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="cudaq-qspan-n-levels-deprecated-use-cudaq-qview-levels-instead">
+<h3><span class="section-number">3.3.4. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qspan&lt;N,</span> <span class="pre">Levels&gt;</span></code> (Deprecated. Use <code class="code docutils literal notranslate"><span class="pre">cudaq::qview&lt;Levels&gt;</span></code> instead.)<a class="headerlink" href="#cudaq-qspan-n-levels-deprecated-use-cudaq-qview-levels-instead" title="Permalink to this heading">¶</a></h3>
+<p><strong>[1]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qspan</span></code> is a non-owning reference to a part of the discrete quantum
+memory space, a <code class="code docutils literal notranslate"><span class="pre">std::span</span></code>-like C++ range of <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>
+(see C++ <a class="reference external" href="https://en.cppreference.com/w/cpp/container/span">span</a>). It does not
+own its elements. It takes a single template parameter indicating the levels for
+the underlying qudits that it stores. This parameter defaults to 2 for qubits.
+It takes on the following structure:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">Levels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">qspan</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">private</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">span</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">qubits</span><span class="p">;</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="c1">// Construct a span that refers to the qudits in `other`.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">ranges</span><span class="o">::</span><span class="n">range</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="k">auto</span><span class="o">&amp;</span><span class="w"> </span><span class="n">other</span><span class="p">);</span>
+<span class="w">      </span><span class="n">qspan</span><span class="p">(</span><span class="n">qspan</span><span class="w"> </span><span class="k">const</span><span class="o">&amp;</span><span class="w"> </span><span class="n">other</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Iterator interface.</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">begin</span><span class="p">();</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">end</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the qudit at `idx`.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="k">operator</span><span class="p">[](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">idx</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[0, count)` qudits.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">front</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the first qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">front</span><span class="p">();</span>
+<span class="w">      </span><span class="c1">// Returns the `[count, size())` qudits.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">back</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the last qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">back</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[start, start+count)` qudits.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the number of contained qudits.</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">size</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</section>
+<section id="cudaq-qreg-n-levels-deprecated-use-cudaq-qvector-levels-instead">
+<h3><span class="section-number">3.3.5. </span><code class="code docutils literal notranslate"><span class="pre">cudaq::qreg&lt;N,</span> <span class="pre">Levels&gt;</span></code> (Deprecated. Use <code class="code docutils literal notranslate"><span class="pre">cudaq::qvector&lt;Levels&gt;</span></code> instead.)<a class="headerlink" href="#cudaq-qreg-n-levels-deprecated-use-cudaq-qvector-levels-instead" title="Permalink to this heading">¶</a></h3>
+<p><strong>[1]</strong> <code class="code docutils literal notranslate"><span class="pre">cudaq::qreg&lt;N,</span> <span class="pre">Levels&gt;</span></code> models a register of the discrete quantum memory space - a
+C++ container of <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit</span></code>.  As a container, it owns its elements and
+their storage. <code class="code docutils literal notranslate"><span class="pre">qreg&lt;dyn,</span> <span class="pre">Levels&gt;</span></code> is a dynamically allocated container
+(<code class="code docutils literal notranslate"><span class="pre">std::vector</span></code>-like, see C++ <a class="reference external" href="https://en.cppreference.com/w/cpp/container/vector">vector</a>).
+<code class="code docutils literal notranslate"><span class="pre">cudaq::qreg&lt;N,</span> <span class="pre">Levels&gt;</span></code> (where N is an integral
+constant) is a statically allocated container (<code class="code docutils literal notranslate"><span class="pre">std::array</span></code>-like,
+see <a class="reference external" href="https://en.cppreference.com/w/cpp/container/array">array</a>).
+Its template parameters default to dynamic allocation and <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;2&gt;</span></code>.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">N</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">dyn</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">Levels</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="o">&gt;</span>
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">qreg</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">private</span><span class="o">:</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="n">conditional_t</span><span class="o">&lt;</span>
+<span class="w">        </span><span class="n">N</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">dyn</span><span class="p">,</span>
+<span class="w">        </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&gt;</span><span class="p">,</span>
+<span class="w">        </span><span class="n">std</span><span class="o">::</span><span class="n">array</span><span class="o">&lt;</span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;</span><span class="p">,</span><span class="w"> </span><span class="n">N</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="o">&gt;</span><span class="w"> </span><span class="n">qudits</span><span class="p">;</span>
+<span class="w">    </span><span class="k">public</span><span class="o">:</span>
+<span class="w">      </span><span class="c1">// Construct a qreg with `size` qudits in the |0&gt; state.</span>
+<span class="w">      </span><span class="n">qreg</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">size</span><span class="p">)</span><span class="w"> </span><span class="k">requires</span><span class="w"> </span><span class="p">(</span><span class="n">N</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">dyn</span><span class="p">);</span>
+<span class="w">      </span><span class="n">qreg</span><span class="p">(</span><span class="n">qreg</span><span class="w"> </span><span class="k">const</span><span class="o">&amp;</span><span class="p">)</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">delete</span><span class="p">;</span>
+
+<span class="w">      </span><span class="c1">// Iterator interface.</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">begin</span><span class="p">();</span>
+<span class="w">      </span><span class="k">auto</span><span class="w"> </span><span class="n">end</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the qudit at `idx`.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="k">operator</span><span class="p">[](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">idx</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[0, count)` qudits.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="o">&lt;</span><span class="n">dyn</span><span class="p">,</span><span class="w"> </span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">front</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the first qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">front</span><span class="p">();</span>
+<span class="w">      </span><span class="c1">// Returns the `[count, size())` qudits.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="o">&lt;</span><span class="n">dyn</span><span class="p">,</span><span class="w"> </span><span class="n">Levels</span><span class="o">&gt;</span><span class="w"> </span><span class="n">back</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">      </span><span class="c1">// Returns the last qudit.</span>
+<span class="w">      </span><span class="n">qudit</span><span class="o">&lt;</span><span class="n">Levels</span><span class="o">&gt;&amp;</span><span class="w"> </span><span class="n">back</span><span class="p">();</span>
+
+<span class="w">      </span><span class="c1">// Returns the `[start, start+count)` qudits.</span>
+<span class="w">      </span><span class="n">qspan</span><span class="o">&lt;</span><span class="n">dyn</span><span class="p">,</span><span class="w"> </span><span class="n">Levels</span><span class="o">&gt;</span>
+<span class="w">      </span><span class="n">slice</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">start</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+
+<span class="w">      </span><span class="c1">// Returns the number of contained qudits.</span>
+<span class="w">      </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="nf">size</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="p">;</span>
+
+<span class="w">      </span><span class="c1">// Destroys all contained qudits. Postcondition: `size() == 0`.</span>
+<span class="w">      </span><span class="kt">void</span><span class="w"> </span><span class="nf">clear</span><span class="p">();</span>
+<span class="w">  </span><span class="p">};</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p><code class="code docutils literal notranslate"><span class="pre">qreg</span></code> instances can only be instantiated from within quantum kernels,
+they cannot be instantiated in host code. All qubits in the <code class="code docutils literal notranslate"><span class="pre">qreg</span></code>
+start in the <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code> computational basis state.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Allocate 20 qubits, std::vector-like semantics</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">qreg</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">20</span><span class="p">);</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">first</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">front</span><span class="p">();</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">first_5</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">last</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">back</span><span class="p">();</span>
+<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">size</span><span class="p">();</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="p">...</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="n">something</span><span class="w"> </span><span class="n">with</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="w"> </span><span class="p">...</span>
+<span class="p">}</span>
+<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="w"> </span><span class="n">qb</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="p">...</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="n">something</span><span class="w"> </span><span class="n">with</span><span class="w"> </span><span class="n">qb</span><span class="w"> </span><span class="p">...</span>
+<span class="p">}</span>
+
+<span class="c1">// std::array-like semantics</span>
+<span class="n">cudaq</span><span class="o">::</span><span class="n">qreg</span><span class="o">&lt;</span><span class="mi">5</span><span class="o">&gt;</span><span class="w"> </span><span class="n">fiveCompileTimeQubits</span><span class="p">;</span>
+</pre></div>
+</div>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="namespace.html" class="btn btn-neutral float-left" title="2. Namespace and Standard" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="operators.html" class="btn btn-neutral float-right" title="4. Quantum Operators" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/index.html b/pr-2241/specification/index.html
new file mode 100644
index 0000000000..d0c4dc7e29
--- /dev/null
+++ b/pr-2241/specification/index.html
@@ -0,0 +1,680 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Specifications &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="Language Specification" href="cudaq.html" />
+    <link rel="prev" title="Create your own CUDA-Q Compiler Pass" href="../using/extending/mlir_pass.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Specifications</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/specification/index.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../using/extending/mlir_pass.html" class="btn btn-neutral float-left" title="Create your own CUDA-Q Compiler Pass" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cudaq.html" class="btn btn-neutral float-right" title="Language Specification" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="specifications">
+<h1>Specifications<a class="headerlink" href="#specifications" title="Permalink to this heading">¶</a></h1>
+<p>The following specifications for the CUDA-Q programming model and toolchain are available:</p>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/types.html">3. Quantum Types</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/operators.html">4. Quantum Operators</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/operations.html">5. Quantum Operations</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/patterns.html">10. Quantum Patterns</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq/examples.html">13. Example Programs</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../using/extending/mlir_pass.html" class="btn btn-neutral float-left" title="Create your own CUDA-Q Compiler Pass" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cudaq.html" class="btn btn-neutral float-right" title="Language Specification" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/specification/quake-dialect.html b/pr-2241/specification/quake-dialect.html
new file mode 100644
index 0000000000..51d7bc6f9a
--- /dev/null
+++ b/pr-2241/specification/quake-dialect.html
@@ -0,0 +1,785 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quake Dialect &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="Code documentation" href="../api/api.html" />
+    <link rel="prev" title="13. Example Programs" href="cudaq/examples.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../using/quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../using/install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../using/extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../using/extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../using/extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="index.html">   Specifications</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="index.html">Specifications</a></li>
+      <li class="breadcrumb-item active">Quake Dialect</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/specification/quake-dialect.md.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cudaq/examples.html" class="btn btn-neutral float-left" title="13. Example Programs" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../api/api.html" class="btn btn-neutral float-right" title="Code documentation" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quake-dialect">
+<h1>Quake Dialect<a class="headerlink" href="#quake-dialect" title="Permalink to this heading">¶</a></h1>
+<section id="general-introduction">
+<h2>General Introduction<a class="headerlink" href="#general-introduction" title="Permalink to this heading">¶</a></h2>
+<p>The quantum circuit model is the most widely used model of quantum
+computation.  It provides a convenient tool for formulating quantum
+algorithms and an architecture for the physical construction of quantum
+computers.</p>
+<p>A <em>quantum circuit</em> represents a computation as a sequence of quantum
+operators applied to quantum data.  In our case, the quantum data is a set
+of quantum bits, or qubits for short.  Physically, a qubit is an object with
+only two distinguishable states, i.e., it is a two-state quantum mechanical
+system such as a spin-1/2 particle.</p>
+<p>Conceptually, a <em>quantum operator</em> is an effect that might modify the state
+of a subset of qubits. Most often, this effect is unitary evolution—in
+this case, we say that the operator is a <em>unitary</em>.  The number of target
+qubits an operator acts upon is an intrinsic property.</p>
+<p>A <em>quantum instruction</em> is the embodiment of a quantum operator when applied
+to a specific subset of qubits.  The number of qubits must be equal to (or
+greater than) the number of target qubits intrinsic to the operator.  If
+greater, the extra qubits are considered controls.</p>
+</section>
+<section id="motivation">
+<h2>Motivation<a class="headerlink" href="#motivation" title="Permalink to this heading">¶</a></h2>
+<p>The main motivation behind Quake’s value model is to directly expose
+quantum and classical data dependencies for optimization purposes,
+i.e., to represent the dataflow in quantum computations.  In contrast
+to Quake’s memory model, which uses memory semantics (quantum
+operators act as side-effects on qubit references), the value model
+uses value semantics, that is quantum operators consume and produce
+values. These values are not truly SSA values, however, as operations
+still have side-effects on the value itself and the value cannot be
+copied.</p>
+<p>Let’s see an example to clarify the distinction between the models.  Take the
+following Quake implementation of some toy quantum computation:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">func</span><span class="p">.</span><span class="n">func</span><span class="w"> </span><span class="n">foo</span><span class="p">(</span><span class="o">%</span><span class="n">veq</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">veq</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="c1">// Boilerplate to extract each qubit from the vector</span>
+<span class="w">    </span><span class="o">%</span><span class="n">c0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">arith</span><span class="p">.</span><span class="n">constant</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">index</span>
+<span class="w">    </span><span class="o">%</span><span class="n">c1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">arith</span><span class="p">.</span><span class="n">constant</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">index</span>
+<span class="w">    </span><span class="o">%</span><span class="n">q0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">quake</span><span class="p">.</span><span class="n">extract_ref</span><span class="w"> </span><span class="o">%</span><span class="n">veq</span><span class="p">[</span><span class="o">%</span><span class="n">c0</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">veq</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="p">,</span><span class="w"> </span><span class="n">index</span><span class="p">)</span><span class="w"> </span><span class="o">-&gt;</span><span class="w"> </span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">ref</span>
+<span class="w">    </span><span class="o">%</span><span class="n">q1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">quake</span><span class="p">.</span><span class="n">extract_ref</span><span class="w"> </span><span class="o">%</span><span class="n">veq</span><span class="p">[</span><span class="o">%</span><span class="n">c1</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">veq</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="p">,</span><span class="w"> </span><span class="n">index</span><span class="p">)</span><span class="w"> </span><span class="o">-&gt;</span><span class="w"> </span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">ref</span>
+
+<span class="w">    </span><span class="c1">// We apply some operators to those extracted qubits</span>
+<span class="w">    </span><span class="c1">// ... bunch of operators using %q0 and %q1 ...</span>
+<span class="w">    </span><span class="n">quake</span><span class="p">.</span><span class="n">h</span><span class="w"> </span><span class="o">%</span><span class="n">q0</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">ref</span><span class="p">)</span><span class="w"> </span><span class="o">-&gt;</span><span class="w"> </span><span class="p">()</span>
+
+<span class="w">    </span><span class="c1">// We decide to measure the vector</span>
+<span class="w">    </span><span class="o">%</span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">quake</span><span class="p">.</span><span class="n">mz</span><span class="w"> </span><span class="o">%</span><span class="n">veq</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">veq</span><span class="o">&lt;</span><span class="mi">2</span><span class="o">&gt;</span><span class="p">)</span><span class="w"> </span><span class="o">-&gt;</span><span class="w"> </span><span class="n">cc</span><span class="p">.</span><span class="n">stdvec</span><span class="o">&lt;</span><span class="n">i1</span><span class="o">&gt;</span>
+
+<span class="w">    </span><span class="c1">// And then apply another Hadamard to %q0</span>
+<span class="w">    </span><span class="n">quake</span><span class="p">.</span><span class="n">h</span><span class="w"> </span><span class="o">%</span><span class="n">q0</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">quake</span><span class="p">.</span><span class="n">ref</span><span class="p">)</span><span class="w"> </span><span class="o">-&gt;</span><span class="w"> </span><span class="p">()</span>
+<span class="w">    </span><span class="c1">// ...</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Now imagine we want to optimize this code by removing pair of adjacent
+adjoint operators, e.g., if we have a pair Hadamard operations next to each
+other on the same qubit—visually:</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>    ┌───┐ ┌───┐         ┌───┐
+   ─┤ H ├─┤ H ├─  =  ───┤ I ├───  =  ─────────────
+    └───┘ └───┘         └───┘
+</pre></div>
+</div>
+<p>Where <code class="docutils literal notranslate"><span class="pre">I</span></code> is the identity operator. Now note that a naive implementation of
+this optimization for Quake would optimize away both <code class="docutils literal notranslate"><span class="pre">quake.h</span></code> operators
+being applied to <code class="docutils literal notranslate"><span class="pre">%q0</span></code>.  Such an implementation would have missed the fact
+that a measurement is being applied to the vector, <code class="docutils literal notranslate"><span class="pre">%veq</span></code>, which contains
+<code class="docutils literal notranslate"><span class="pre">%q0</span></code>.</p>
+<p>Of course it is possible to correctly implement this optimization for Quake.
+However such an implementation would be quite error-prone and require
+complex analyses.  For this reason, Quake has overloaded gates.</p>
+<p>In the value model operators consume values and return new values:</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>  %q0_1 = quake.op %q0_0 : (!quake.wire) -&gt; !quake.wire
+</pre></div>
+</div>
+<p>We can visualize the difference between memory and value representation as:</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>            Memory                                   Value
+
+        ┌──┐ ┌──┐     ┌──┐                  ┌──┐ %q0_1 ┌──┐     ┌──┐
+   %q0 ─┤  ├─┤  ├─···─┤  ├─ %q0  vs  %q0_0 ─┤  ├───────┤  ├─···─┤  ├─ %q0_Z
+        └──┘ └──┘     └──┘                  └──┘       └──┘     └──┘
+</pre></div>
+</div>
+<p>If we look at the implementation again, we notice that the problem
+with the naive optimization happens because the Hadamard operators are
+implicitly connected by the same value <code class="docutils literal notranslate"><span class="pre">%q0</span></code>. In value form, all the gates
+are explicitly connected by distinct values, which eliminates the need
+to do further analysis via implicit side-effects.
+The following is the implementation in value form.</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>func.func @foo(%array : !quake.qvec&lt;2&gt;) {
+    // Boilerplate to extract each qubit
+    %c0 = arith.constant 0 : index
+    %c1 = arith.constant 1 : index
+    %r0 = quake.extract_ref %array[%c0] : (!quake.qvec&lt;2&gt;, index) -&gt; !quake.qref
+    %r1 = quake.extract_ref %array[%c1] : (!quake.qvec&lt;2&gt;, index) -&gt; !quake.qref
+
+    // Unwrap the quantum references to expose the wires.
+    %q0 = quake.unwrap %r0 : (!quake.qref) -&gt; !quake.wire
+    %q1 = quake.unwrap %r1 : (!quake.qref) -&gt; !quake.wire
+
+    // Misc. operators applied
+    %q0_M = quake.h %q0_L : (!quake.wire) -&gt; !quake.wire
+
+    // Re-wrap the wire to its original source
+    quake.wrap %q0_M to %r0 : !quake.wire, !quake.qref
+    quake.wrap %q1_X to %r1 : !quake.wire, !quake.qref
+
+    // Measure the entire vector of quantum references
+    %result = quake.mz %array : (!quake.qvec&lt;2&gt;) -&gt; !cc.stdvec&lt;i1&gt;
+
+    // Unwrap the wire for qubit 0 again
+    %q0_P = quake.unwrap %r0 : (!quake.qref) -&gt; !quake.wire
+    ...
+    %q0_Z = quake.h %q0_Y : (!quake.wire) -&gt; !quake.wire
+    // Re-wrap the wire back to the original reference
+    quake.wrap %q0_Z to %r0 : !quake.wire, !quake.qref
+    return
+}
+</pre></div>
+</div>
+<p>In this code we can more straightforwardly see that the Hadamard
+operators cannot cancel each other.  One way of reasoning about this
+is as follows: In value form we need to follow a chain of values to
+know the qubit operators are being applied to, in this example:</p>
+<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>Mmeory                          Value
+    %q0         [%q0_0, %q0_1 ... %q0_L, %q0_M; %q0_P ... %q0_Y, %q0_Z]
+</pre></div>
+</div>
+<p>We know that one Hadamard is applied to <code class="docutils literal notranslate"><span class="pre">%q0_L</span></code> and generates <code class="docutils literal notranslate"><span class="pre">%q0_M</span></code>, and
+the other is applied <code class="docutils literal notranslate"><span class="pre">%q0_Y</span></code> and generates <code class="docutils literal notranslate"><span class="pre">%q0_Z</span></code>.  Hence, there is no
+connection between them—which means they cannot cancel each other out.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cudaq/examples.html" class="btn btn-neutral float-left" title="13. Example Programs" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../api/api.html" class="btn btn-neutral float-right" title="Code documentation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/_static/attachToDevContainer.png b/pr-2241/sphinx/_static/attachToDevContainer.png
new file mode 100644
index 0000000000..a841832ef8
Binary files /dev/null and b/pr-2241/sphinx/_static/attachToDevContainer.png differ
diff --git a/pr-2241/sphinx/_static/cuda_quantum_icon.svg b/pr-2241/sphinx/_static/cuda_quantum_icon.svg
new file mode 100644
index 0000000000..e7f2901fec
--- /dev/null
+++ b/pr-2241/sphinx/_static/cuda_quantum_icon.svg
@@ -0,0 +1,553 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 300 300">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: none;
+      }
+
+      .cls-2 {
+        opacity: 0.1;
+      }
+
+      .cls-3 {
+        fill: url(#New_Gradient_Swatch_4);
+      }
+
+      .cls-4 {
+        fill: url(#linear-gradient);
+      }
+
+      .cls-5 {
+        fill: url(#linear-gradient-2);
+      }
+
+      .cls-6 {
+        fill: url(#linear-gradient-3);
+      }
+
+      .cls-7 {
+        opacity: 0.15;
+      }
+
+      .cls-8 {
+        isolation: isolate;
+      }
+
+      .cls-9 {
+        fill: #649d00;
+      }
+
+      .cls-10 {
+        clip-path: url(#clip-path);
+      }
+
+      .cls-11 {
+        fill: #649c00;
+      }
+
+      .cls-12 {
+        fill: #639b00;
+      }
+
+      .cls-13 {
+        clip-path: url(#clip-path-2);
+      }
+
+      .cls-14 {
+        clip-path: url(#clip-path-3);
+      }
+
+      .cls-15 {
+        fill: #75b700;
+      }
+
+      .cls-16 {
+        clip-path: url(#clip-path-4);
+      }
+
+      .cls-17 {
+        clip-path: url(#clip-path-5);
+      }
+
+      .cls-18 {
+        clip-path: url(#clip-path-6);
+      }
+
+      .cls-19 {
+        clip-path: url(#clip-path-7);
+      }
+
+      .cls-20 {
+        clip-path: url(#clip-path-8);
+      }
+
+      .cls-21 {
+        clip-path: url(#clip-path-9);
+      }
+
+      .cls-22 {
+        clip-path: url(#clip-path-10);
+      }
+
+      .cls-23 {
+        clip-path: url(#clip-path-11);
+      }
+
+      .cls-24 {
+        clip-path: url(#clip-path-12);
+      }
+
+      .cls-25 {
+        clip-path: url(#clip-path-13);
+      }
+
+      .cls-26 {
+        clip-path: url(#clip-path-14);
+      }
+
+      .cls-27 {
+        clip-path: url(#clip-path-15);
+      }
+
+      .cls-28 {
+        clip-path: url(#clip-path-16);
+      }
+
+      .cls-29 {
+        clip-path: url(#clip-path-17);
+      }
+
+      .cls-30 {
+        clip-path: url(#clip-path-18);
+      }
+
+      .cls-31 {
+        clip-path: url(#clip-path-19);
+      }
+
+      .cls-32 {
+        clip-path: url(#clip-path-20);
+      }
+
+      .cls-33 {
+        clip-path: url(#clip-path-21);
+      }
+
+      .cls-34 {
+        clip-path: url(#clip-path-22);
+      }
+
+      .cls-35 {
+        clip-path: url(#clip-path-23);
+      }
+
+      .cls-36 {
+        clip-path: url(#clip-path-24);
+      }
+
+      .cls-37 {
+        clip-path: url(#clip-path-25);
+      }
+
+      .cls-38 {
+        clip-path: url(#clip-path-26);
+      }
+
+      .cls-39 {
+        clip-path: url(#clip-path-27);
+      }
+
+      .cls-40 {
+        clip-path: url(#clip-path-28);
+      }
+
+      .cls-41 {
+        fill: #629a00;
+      }
+
+      .cls-42 {
+        fill: url(#linear-gradient-4);
+      }
+
+      .cls-43 {
+        fill: url(#linear-gradient-5);
+      }
+
+      .cls-44 {
+        fill: url(#linear-gradient-6);
+      }
+    </style>
+    <linearGradient id="New_Gradient_Swatch_4" data-name="New Gradient Swatch 4" x1="19.41202" y1="176.86035" x2="273.0417" y2="176.86035" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fafafa"/>
+      <stop offset="1" stop-color="#f5f5f5"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient" x1="19.41517" y1="222.20019" x2="146.22726" y2="222.20019" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#e8e8e8"/>
+      <stop offset="1" stop-color="#fafafa"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient-2" x1="146.22521" y1="222.18105" x2="273.0417" y2="222.18105" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#e8e8e8"/>
+      <stop offset="1" stop-color="#bfbfbf"/>
+    </linearGradient>
+    <linearGradient id="linear-gradient-3" x1="82.8193" y1="251.37619" x2="82.8193" y2="175.56131" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fff" stop-opacity="0"/>
+      <stop offset="0.07729" stop-color="#fff" stop-opacity="0.20984"/>
+      <stop offset="0.18847" stop-color="#fff" stop-opacity="0.48739"/>
+      <stop offset="0.28866" stop-color="#fff" stop-opacity="0.70783"/>
+      <stop offset="0.37409" stop-color="#fff" stop-opacity="0.86665"/>
+      <stop offset="0.44148" stop-color="#fff" stop-opacity="0.96412"/>
+      <stop offset="0.4824" stop-color="#fff"/>
+      <stop offset="1" stop-color="#fff" stop-opacity="0"/>
+    </linearGradient>
+    <clipPath id="clip-path">
+      <path class="cls-1" d="M96.69992,77.63435l3.59062-2.08664c1.60132,25.22727,15.69236,53.68711,34.90423,72.61731l-3.59062,2.08664C112.39228,131.32146,98.30124,102.86162,96.69992,77.63435Z"/>
+    </clipPath>
+    <clipPath id="clip-path-2">
+      <path class="cls-1" d="M96.55979,71.76781l3.59061-2.08664A11.16815,11.16815,0,0,0,102.14,72.56481l-3.59062,2.08664A11.16776,11.16776,0,0,1,96.55979,71.76781Z"/>
+    </clipPath>
+    <clipPath id="clip-path-3">
+      <path class="cls-1" d="M96.83933,66.65908l3.59061-2.08664c-.16039,1.64238-.25083,3.35-.27954,5.10873l-3.59061,2.08664C96.58849,70.00911,96.67894,68.30146,96.83933,66.65908Z"/>
+    </clipPath>
+    <clipPath id="clip-path-4">
+      <path class="cls-1" d="M102.81149,79.02226l3.59061-2.08664q2.06991,1.9307,4.65942,4.05782l-3.59062,2.08664Q104.88684,80.95361,102.81149,79.02226Z"/>
+    </clipPath>
+    <clipPath id="clip-path-5">
+      <path class="cls-1" d="M96.99076,65.26633l3.59061-2.08664a23.07238,23.07238,0,0,1,4.4.61222l-3.59062,2.08664A23.0724,23.0724,0,0,0,96.99076,65.26633Z"/>
+    </clipPath>
+    <clipPath id="clip-path-6">
+      <path class="cls-1" d="M112.2852,86.90162l3.59062-2.08664q2.30167,1.77063,4.867,3.61985l-3.59062,2.08664Q114.58688,88.66975,112.2852,86.90162Z"/>
+    </clipPath>
+    <clipPath id="clip-path-7">
+      <path class="cls-1" d="M122.06632,93.99382l3.59062-2.08664q2.3802,1.64565,4.93945,3.34223l-3.59062,2.08664Q124.45141,95.64414,122.06632,93.99382Z"/>
+    </clipPath>
+    <clipPath id="clip-path-8">
+      <path class="cls-1" d="M106.43072,67.29752l3.59062-2.08664q2.33222.75875,5.04263,1.812l-3.59062,2.08664Q108.76566,68.0572,106.43072,67.29752Z"/>
+    </clipPath>
+    <clipPath id="clip-path-9">
+      <path class="cls-1" d="M131.964,100.56432l3.59061-2.08663c1.60869,1.03734,3.26084,2.07357,4.95527,3.12423l-3.59062,2.08664C135.22485,102.6379,133.5727,101.60167,131.964,100.56432Z"/>
+    </clipPath>
+    <clipPath id="clip-path-10">
+      <path class="cls-1" d="M116.51742,71.18059,120.108,69.094q2.41285,1.04488,5.04352,2.25672l-3.59062,2.08664Q118.93355,72.22176,116.51742,71.18059Z"/>
+    </clipPath>
+    <clipPath id="clip-path-11">
+      <path class="cls-1" d="M126.60839,75.84606l3.59062-2.08664q2.44175,1.20009,5.03625,2.53082l-3.59061,2.08664Q129.055,77.05208,126.60839,75.84606Z"/>
+    </clipPath>
+    <clipPath id="clip-path-12">
+      <path class="cls-1" d="M111.96537,38.87726l3.59062-2.08664c-7.99738,4.64757-13.43786,13.69991-14.97462,26.38907l-3.59061,2.08664C98.52751,52.57717,103.968,43.52483,111.96537,38.87726Z"/>
+    </clipPath>
+    <clipPath id="clip-path-13">
+      <path class="cls-1" d="M190.30956,165.42376l-3.59062,2.08664c-9.6048,5.5817-22.89778,4.80935-37.54727-3.64854a83.82263,83.82263,0,0,1-13.1804-9.52838l3.59062-2.08663a83.8232,83.8232,0,0,0,13.1804,9.52837C167.41178,170.23311,180.70476,171.00546,190.30956,165.42376Z"/>
+    </clipPath>
+    <clipPath id="clip-path-14">
+      <path class="cls-1" d="M154.1471,113.86216l3.59061-2.08663c1.62321.90595,3.21277,1.78874,4.76989,2.63533L158.917,116.4975C157.35986,115.65091,155.7703,114.76812,154.1471,113.86216Z"/>
+    </clipPath>
+    <clipPath id="clip-path-15">
+      <path class="cls-1" d="M136.69573,81.02981l3.59062-2.08664q2.46587,1.3151,5.04541,2.74326l-3.59062,2.08664Q139.16484,82.34741,136.69573,81.02981Z"/>
+    </clipPath>
+    <clipPath id="clip-path-16">
+      <path class="cls-1" d="M163.67515,119.04372l3.59062-2.08664q2.435,1.28981,4.753,2.45962l-3.59062,2.08665Q166.115,120.3307,163.67515,119.04372Z"/>
+    </clipPath>
+    <clipPath id="clip-path-17">
+      <path class="cls-1" d="M173.16845,123.84832l3.59062-2.08664q2.445,1.17952,4.72542,2.22282l-3.59062,2.08664Q175.6162,125.02755,173.16845,123.84832Z"/>
+    </clipPath>
+    <clipPath id="clip-path-18">
+      <path class="cls-1" d="M158.85887,93.70217l3.59062-2.08664q2.47023,1.50292,4.8297,2.98435l-3.59062,2.08664Q161.3291,95.20821,158.85887,93.70217Z"/>
+    </clipPath>
+    <clipPath id="clip-path-19">
+      <path class="cls-1" d="M182.59148,128.14812l3.59062-2.08664q2.46012,1.03287,4.66779,1.87008l-3.59062,2.08665Q185.056,129.17852,182.59148,128.14812Z"/>
+    </clipPath>
+    <clipPath id="clip-path-20">
+      <path class="cls-1" d="M168.51911,99.7587l3.59062-2.08664q2.49436,1.61046,4.84106,3.19308l-3.59062,2.08664Q171.014,101.3651,168.51911,99.7587Z"/>
+    </clipPath>
+    <clipPath id="clip-path-21">
+      <path class="cls-1" d="M191.85718,131.62956l3.59062-2.08664a45.07824,45.07824,0,0,0,4.44484,1.21475l-3.59062,2.08664A45.079,45.079,0,0,1,191.85718,131.62956Z"/>
+    </clipPath>
+    <clipPath id="clip-path-22">
+      <path class="cls-1" d="M178.17813,106.24382l3.59062-2.08664c1.67894,1.16525,3.29057,2.31786,4.83167,3.43972l-3.59062,2.08664C181.4687,108.56168,179.85707,107.40907,178.17813,106.24382Z"/>
+    </clipPath>
+    <clipPath id="clip-path-23">
+      <path class="cls-1" d="M187.83228,113.3039l3.59062-2.08664q2.58446,2.00315,4.81852,3.86016l-3.59062,2.08664Q190.41619,115.30112,187.83228,113.3039Z"/>
+    </clipPath>
+    <clipPath id="clip-path-24">
+      <path class="cls-1" d="M205.43783,130.869l-3.59062,2.08664a3.38107,3.38107,0,0,1-1.50944.34489l3.59061-2.08663A3.38123,3.38123,0,0,0,205.43783,130.869Z"/>
+    </clipPath>
+    <clipPath id="clip-path-25">
+      <path class="cls-1" d="M197.47138,121.39217l3.59062-2.08663c1.64683,1.53505,3.07936,2.99377,4.26983,4.34711l-3.59062,2.08664C200.55074,124.386,199.11822,122.92722,197.47138,121.39217Z"/>
+    </clipPath>
+    <clipPath id="clip-path-26">
+      <path class="cls-1" d="M108.75261,33.28549l3.59062-2.08664c10.43768-6.06572,24.87246-5.21767,40.778,3.96539a88.32433,88.32433,0,0,1,11.55207,8.01468l-3.59062,2.08664a88.32433,88.32433,0,0,0-11.55207-8.01468C133.62507,28.06781,119.19029,27.21977,108.75261,33.28549Z"/>
+    </clipPath>
+    <clipPath id="clip-path-27">
+      <path class="cls-1" d="M193.56562,171.01716l-3.59062,2.08665c10.3077-5.99018,16.70763-18.71246,16.75884-36.77653.00075-.26266-.00572-.52949-.01081-1.279l3.59062-2.08664c.00509.74955.01156,1.01638.01081,1.279C210.27325,152.30471,203.87332,165.027,193.56562,171.01716Z"/>
+    </clipPath>
+    <clipPath id="clip-path-28">
+      <path class="cls-1" d="M165.53648,49.11093l3.59061-2.08663c23.51675,21.46183,40.78294,56.23333,41.18656,85.9373l-3.59062,2.08664C206.31941,105.34427,189.05322,70.57277,165.53648,49.11093Z"/>
+    </clipPath>
+    <linearGradient id="linear-gradient-4" x1="146.73062" y1="31.35912" x2="188.91213" y2="31.35912" xlink:href="#linear-gradient-3"/>
+    <linearGradient id="linear-gradient-5" x1="109.56421" y1="36.98419" x2="160.96562" y2="36.98419" xlink:href="#linear-gradient-3"/>
+    <linearGradient id="linear-gradient-6" x1="2068.6157" y1="-2541.90253" x2="2152.48665" y2="-2541.90253" gradientTransform="translate(-3117.78829 126.29245) rotate(49.6)" xlink:href="#linear-gradient-3"/>
+  </defs>
+  <g id="OBJ">
+    <g>
+      <g class="cls-2">
+        <image width="327" height="219" transform="translate(-16.9622 103.99442)" xlink:href="data:image/png;base64,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"/>
+      </g>
+      <g>
+        <polygon class="cls-3" points="146.227 250.077 19.412 176.86 146.226 103.644 273.042 176.861 146.227 250.077"/>
+        <polygon class="cls-4" points="146.226 267.538 19.415 194.323 19.417 176.863 146.227 250.077 146.226 267.538"/>
+        <polygon class="cls-5" points="273.04 194.285 146.225 267.502 146.227 250.077 273.042 176.861 273.04 194.285"/>
+      </g>
+      <path class="cls-6" d="M19.41183,176.86039c5.59668,2.50928,11.10205,5.17676,16.60937,7.84009l15.84473,9.165,31.70361,18.3042,31.70362,18.30419,15.85205,9.1521c5.05566,3.44556,10.11865,6.87964,15.10156,10.45118-5.58447-2.52979-11.08984-5.19727-16.60156-7.853l-15.85205-9.1521-31.70362-18.3042-31.70361-18.3042L34.50655,187.3245C29.446,183.88627,24.38351,180.45243,19.41183,176.86039Z"/>
+      <g class="cls-7">
+        <image width="188" height="136" transform="translate(36.0378 115.99442)" xlink:href="data:image/png;base64,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BtytgvkpC2U4nxK4u6piAFZrDaUUjcdjarfbV44b+asR4T2nIP4nDW6n05lEUTSerfphGNa01o+YuW6tXdda1zDdrhBlnzkiog4R9YjoYjKZJGEY2g8fPiy3vEOaVmEOeYO7t7dHvV5PvXv3LtjZ2QmMMSVrbTlN08tNZURUgRtJVogoAqCMMalS6lwp1SO3s7IHYLC3txf/9NNPS91nIxVeuMJNVX9ra2swHo9DACVmLmmtI2NMlKZpCECFYWittbG19iIMw2GpVBqNRqP07du3S21YAanwwoLMVv04jlW329WVSkWPRiMNIAjDUCdJQgAQx7GJoiipVqvJcDhM3rx5Y16/fr3U6g5IhRcWZE7Vpzdv3qQvXrygVqtFv//+u2o2m9Tv9wkA6vU6A7DD4dACsK9fv156dQekwgtfSPYLgIODgysTmFevXjHdkz00OSK84BUKguARIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BUivOAVIrzgFSK84BX/DyPCZGaV2fWkAAAAAElFTkSuQmCC"/>
+      </g>
+      <g class="cls-8">
+        <polygon class="cls-9" points="134.76 158.718 138.35 156.632 131.312 181.7 127.721 183.787 134.76 158.718"/>
+        <g class="cls-8">
+          <g class="cls-10">
+            <g class="cls-8">
+              <path class="cls-11" d="M96.69992,77.63435l3.59062-2.08664q.21131,3.32889.70756,6.72414l-3.59062,2.08664q-.49376-3.39091-.70756-6.72414"/>
+              <path class="cls-12" d="M97.40748,84.35849l3.59062-2.08664c3.41259,23.43664,16.67488,48.62828,34.19667,65.89317l-3.59062,2.08664c-17.52179-17.2649-30.78408-42.45653-34.19667-65.89317"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-11" points="98.549 74.651 102.14 72.565 100.291 75.548 96.7 77.634 98.549 74.651"/>
+        <g class="cls-8">
+          <g class="cls-13">
+            <g class="cls-8">
+              <path class="cls-12" d="M96.55979,71.76781l3.59061-2.08664A11.16815,11.16815,0,0,0,102.14,72.56481l-3.59062,2.08664a11.16776,11.16776,0,0,1-1.98954-2.88364"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-14">
+            <g class="cls-8">
+              <path class="cls-11" d="M96.83933,66.65908l3.59061-2.08664c-.16039,1.64238-.25083,3.35-.27954,5.10873l-3.59061,2.08664c.0287-1.7587.11915-3.46635.27954-5.10873"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M102.81149,79.02226q2.06989,1.93069,4.65941,4.05782l-.97852,4.60512q-2.79207-2.30833-5.03532-4.3884Z"/>
+        <g class="cls-8">
+          <g class="cls-16">
+            <g class="cls-8">
+              <path class="cls-12" d="M102.81149,79.02226l3.59062-2.08664q2.0699,1.9307,4.65941,4.05782l-3.59062,2.08664q-2.58407-2.12647-4.65941-4.05782"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="107.471 83.08 111.062 80.993 110.083 85.599 106.492 87.685 107.471 83.08"/>
+        <g class="cls-8">
+          <g class="cls-17">
+            <g class="cls-8">
+              <path class="cls-12" d="M96.99076,65.26633l3.59061-2.08664a23.07238,23.07238,0,0,1,4.4.61222l-3.59062,2.08663a23.07309,23.07309,0,0,0-4.4-.61221"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="101.391 65.879 104.981 63.792 106.321 69.612 102.731 71.698 101.391 65.879"/>
+        <g class="cls-8">
+          <g class="cls-18">
+            <g class="cls-8">
+              <path class="cls-12" d="M112.2852,86.90162l3.59062-2.08664q2.30167,1.77063,4.867,3.61985l-3.59062,2.08663q-2.56532-1.8517-4.867-3.61984"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="117.152 90.521 120.743 88.435 120.154 93.339 116.564 95.425 117.152 90.521"/>
+        <polygon class="cls-9" points="127.006 97.336 130.596 95.249 130.237 100.315 126.646 102.402 127.006 97.336"/>
+        <g class="cls-8">
+          <g class="cls-19">
+            <g class="cls-8">
+              <path class="cls-12" d="M122.06632,93.99382l3.59062-2.08664q2.3802,1.64565,4.93945,3.34223l-3.59062,2.08664q-2.55437-1.69191-4.93945-3.34223"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="111.473 69.109 115.064 67.023 115.798 72.659 112.208 74.746 111.473 69.109"/>
+        <g class="cls-8">
+          <g class="cls-20">
+            <g class="cls-8">
+              <path class="cls-12" d="M106.43072,67.29752l3.59062-2.08664q2.33222.75875,5.04263,1.812l-3.59062,2.08664q-2.70769-1.05228-5.04263-1.812"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M111.47335,69.10948l.73445,5.63653q-2.58076-.99583-4.80936-1.72969l-.96772-5.7188Q108.76294,68.05627,111.47335,69.10948Z"/>
+        <g class="cls-8">
+          <g class="cls-21">
+            <g class="cls-8">
+              <path class="cls-12" d="M131.964,100.56432l3.59061-2.08663c1.60869,1.03734,3.26084,2.07357,4.95527,3.12423l-3.59061,2.08664c-1.69444-1.05066-3.34659-2.08689-4.95527-3.12424"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="136.919 103.689 140.51 101.602 140.325 106.78 136.734 108.867 136.919 103.689"/>
+        <polygon class="cls-9" points="121.561 73.437 125.152 71.351 125.586 76.865 121.995 78.952 121.561 73.437"/>
+        <path class="cls-15" d="M121.56094,73.43731l.434,5.51423q-2.56068-1.192-4.91337-2.20156l-.56413-5.56939Q118.93028,72.22547,121.56094,73.43731Z"/>
+        <g class="cls-8">
+          <g class="cls-22">
+            <g class="cls-8">
+              <path class="cls-12" d="M116.51742,71.18059,120.108,69.094q2.41285,1.04488,5.04352,2.25672l-3.59062,2.08664q-2.62739-1.21555-5.04352-2.25672"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-23">
+            <g class="cls-8">
+              <path class="cls-12" d="M126.60839,75.84606l3.59062-2.08664q2.44175,1.20009,5.03625,2.53082l-3.59061,2.08664q-2.58966-1.3248-5.03626-2.53082"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="131.645 78.377 135.235 76.29 135.485 81.708 131.894 83.795 131.645 78.377"/>
+        <path class="cls-15" d="M131.64465,78.37688l.24963,5.41777q-2.549-1.30131-4.95929-2.48638l-.3266-5.46221Q129.05014,77.04615,131.64465,78.37688Z"/>
+        <g class="cls-8">
+          <g class="cls-24">
+            <g class="cls-8">
+              <path class="cls-11" d="M111.96537,38.87726l3.59062-2.08664c-7.99738,4.64757-13.43786,13.69991-14.97462,26.38907l-3.59061,2.08664c1.53675-12.68916,6.97723-21.7415,14.97461-26.38907"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-25">
+            <g class="cls-8">
+              <path class="cls-12" d="M135.99127,154.33348l3.59062-2.08664a83.82263,83.82263,0,0,0,13.1804,9.52838c14.64949,8.45789,27.94247,9.23024,37.54727,3.64854l-3.59062,2.08664c-9.6048,5.5817-22.89778,4.80935-37.54727-3.64854a83.82263,83.82263,0,0,1-13.1804-9.52838"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M158.917,116.4975l.11516,5.35137q-2.36334-1.28772-4.82409-2.66664l-.06095-5.32007C155.7703,114.76812,157.35986,115.65091,158.917,116.4975Z"/>
+        <polygon class="cls-9" points="158.917 116.498 162.508 114.411 162.623 119.762 159.032 121.849 158.917 116.498"/>
+        <g class="cls-8">
+          <g class="cls-26">
+            <g class="cls-8">
+              <path class="cls-12" d="M154.1471,113.86216l3.59062-2.08664c1.6232.906,3.21276,1.78875,4.76988,2.63534L158.917,116.4975c-1.55712-.84659-3.14668-1.72938-4.76988-2.63534"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M141.74114,83.77306l.08372,5.332q-2.53566-1.40218-4.96844-2.69881l-.16069-5.37641Q139.1616,82.34491,141.74114,83.77306Z"/>
+        <g class="cls-8">
+          <g class="cls-27">
+            <g class="cls-8">
+              <path class="cls-12" d="M136.69573,81.02981l3.59062-2.08664q2.46587,1.3151,5.04541,2.74326l-3.59062,2.08663q-2.5763-1.42564-5.04541-2.74325"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="141.741 83.773 145.332 81.686 145.415 87.018 141.825 89.105 141.741 83.773"/>
+        <g class="cls-8">
+          <g class="cls-28">
+            <g class="cls-8">
+              <path class="cls-12" d="M163.67515,119.04372l3.59062-2.08664q2.435,1.28981,4.753,2.45962l-3.59062,2.08664q-2.31315-1.17264-4.753-2.45962"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="168.428 121.503 172.019 119.417 172.282 124.844 168.692 126.93 168.428 121.503"/>
+        <polygon class="cls-9" points="177.894 126.071 181.484 123.984 181.949 129.506 178.358 131.593 177.894 126.071"/>
+        <g class="cls-8">
+          <g class="cls-29">
+            <g class="cls-8">
+              <path class="cls-12" d="M173.16845,123.84832l3.59062-2.08664q2.445,1.17952,4.72542,2.22282l-3.59062,2.08664q-2.27767-1.04359-4.72542-2.22282"/>
+            </g>
+          </g>
+        </g>
+        <path class="cls-15" d="M158.85887,93.70217q2.47023,1.50293,4.8297,2.98434l-.21119,5.1617q-2.327-1.45951-4.75923-2.94366Z"/>
+        <g class="cls-8">
+          <g class="cls-30">
+            <g class="cls-8">
+              <path class="cls-12" d="M158.85887,93.70217l3.59062-2.08664q2.47023,1.50292,4.8297,2.98435l-3.59062,2.08663q-2.35947-1.4783-4.8297-2.98434"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="163.689 96.687 167.279 94.6 167.068 99.762 163.477 101.848 163.689 96.687"/>
+        <g class="cls-8">
+          <g class="cls-31">
+            <g class="cls-8">
+              <path class="cls-12" d="M182.59148,128.14812l3.59062-2.08664q2.46012,1.03287,4.66779,1.87008l-3.59062,2.08664q-2.2033-.83967-4.66779-1.87008"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="187.259 130.018 190.85 127.932 191.61 133.582 188.02 135.669 187.259 130.018"/>
+        <path class="cls-15" d="M187.25927,130.0182l.76048,5.65032c-1.51769-.57674-3.12642-1.22726-4.81964-1.93654l-.60863-5.58386Q185.0516,129.181,187.25927,130.0182Z"/>
+        <path class="cls-15" d="M168.51911,99.7587q2.49436,1.61046,4.84106,3.19307l-.40089,5.03221q-2.29253-1.54073-4.72831-3.11674Z"/>
+        <g class="cls-8">
+          <g class="cls-32">
+            <g class="cls-8">
+              <path class="cls-12" d="M168.51911,99.7587l3.59062-2.08664q2.49436,1.61046,4.84106,3.19308l-3.59062,2.08663q-2.34617-1.58667-4.84106-3.19307"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="173.36 102.952 176.951 100.865 176.55 105.897 172.959 107.984 173.36 102.952"/>
+        <g class="cls-8">
+          <g class="cls-33">
+            <g class="cls-8">
+              <path class="cls-12" d="M191.85718,131.62956l3.59062-2.08664a45.07824,45.07824,0,0,0,4.44484,1.21475l-3.59062,2.08664a45.079,45.079,0,0,1-4.44484-1.21475"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="196.302 132.844 199.893 130.758 201.264 136.586 197.673 138.673 196.302 132.844"/>
+        <polygon class="cls-9" points="183.01 109.684 186.6 107.597 185.981 112.483 182.39 114.569 183.01 109.684"/>
+        <g class="cls-8">
+          <g class="cls-34">
+            <g class="cls-8">
+              <path class="cls-12" d="M178.17813,106.24382l3.59062-2.08664c1.67894,1.16525,3.29057,2.31786,4.83167,3.43972l-3.59062,2.08664c-1.5411-1.12186-3.15273-2.27447-4.83167-3.43972"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="192.651 117.164 196.241 115.077 195.231 119.656 191.641 121.742 192.651 117.164"/>
+        <g class="cls-8">
+          <g class="cls-35">
+            <g class="cls-8">
+              <path class="cls-12" d="M187.83228,113.3039l3.59062-2.08664q2.58446,2.00315,4.81852,3.86016l-3.59062,2.08664q-2.23461-1.86294-4.81852-3.86016"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-36">
+            <g class="cls-8">
+              <path class="cls-12" d="M200.33777,133.30052l3.59062-2.08664a3.38111,3.38111,0,0,0,1.50944-.34489l-3.59062,2.08664a3.38107,3.38107,0,0,1-1.50944.34489"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-11" points="201.866 127.097 205.457 125.011 203.749 127.741 200.159 129.828 201.866 127.097"/>
+        <g class="cls-8">
+          <g class="cls-37">
+            <g class="cls-8">
+              <path class="cls-12" d="M197.47138,121.39217l3.59062-2.08664c1.64683,1.53506,3.07936,2.99378,4.26983,4.34712l-3.59062,2.08664c-1.19047-1.35334-2.623-2.81207-4.26983-4.34712"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="164.306 53.496 167.897 51.41 139.582 152.247 135.991 154.333 164.306 53.496"/>
+        <g class="cls-8">
+          <g class="cls-38">
+            <g class="cls-8">
+              <path class="cls-12" d="M108.75261,33.28549l3.59062-2.08664c10.43768-6.06572,24.87246-5.21767,40.778,3.96539a88.32433,88.32433,0,0,1,11.55207,8.01468l-3.59062,2.08664a88.32433,88.32433,0,0,0-11.55207-8.01468c-15.90554-9.18307-30.34032-10.03111-40.778-3.96539"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="173.07 22.277 176.661 20.19 169.127 47.024 165.536 49.111 173.07 22.277"/>
+        <path class="cls-15" d="M206.723,135.04824c.00509.74955.01156,1.01638.01081,1.279-.10309,36.36319-25.93258,51.08027-57.57713,32.81028a91.12,91.12,0,0,1-14.39692-10.41916L127.721,183.78653l-4.42255-3.953,7.07218-25.18636c-22.415-21.91959-38.49669-55.78677-38.415-84.58722.00064-.2248.00642-.44544.00809-.66965.22341-16.21607,5.58029-28.03748,14.28042-34.45712,10.56644-7.79674,26.06432-7.6256,43.28656,2.31766a88.32433,88.32433,0,0,1,11.55207,8.01468l7.55143-26.89114L145.09,20.3972l1.69877-6.23289,26.37793-2.26507,15.112,39.02308-1.70084,6.23644L173.07021,22.27713l-7.53373,26.8338C189.05322,70.57277,206.31941,105.34427,206.723,135.04824Zm-4.721,2.73761-1.66425-4.48533c1.39046-.073,1.72785-.48616,1.79623-.59719-.01951-1.84816-.10909-3.72018-.26773-5.606l-1.70739,2.7307a50.84393,50.84393,0,0,0-4.06093-4.18266l1.37343-4.25319c1.64684,1.53505,3.07936,2.99378,4.26983,4.34712-2.60151-25.66963-17.59608-54.1048-37.43519-72.24285l-28.31475,100.837a83.82263,83.82263,0,0,0,13.1804,9.52838c27.89041,16.10254,50.86395,4.34778,52.83035-26.076m-70.39787,12.46581,28.24495-100.587a81.006,81.006,0,0,0-10.33344-7.13926c-26.84634-15.49974-49.14232-5.1895-52.5249,22.74093a23.07309,23.07309,0,0,1,4.4.61221l1.33972,5.81963a18.04675,18.04675,0,0,0-4.25794-.53255l-1.63325-4.50654c-.16039,1.64238-.25084,3.35-.27954,5.10873a11.16776,11.16776,0,0,0,1.98954,2.88364l-1.84941,2.9829c1.60132,25.22727,15.69236,53.68711,34.90423,72.61731"/>
+        <path class="cls-15" d="M112.2852,86.90162q2.30169,1.77063,4.867,3.61984l-.5884,4.904q-2.65959-1.923-5.04687-3.7549Z"/>
+        <path class="cls-15" d="M122.06632,93.99382q2.38022,1.64565,4.93945,3.34223l-.35972,5.066q-2.60964-1.7388-5.04242-3.41166Z"/>
+        <path class="cls-15" d="M131.964,100.56432c1.60868,1.03735,3.26083,2.07358,4.95527,3.12424l-.18517,5.178q-2.58886-1.60324-5.04959-3.18867Z"/>
+        <path class="cls-15" d="M168.42815,121.50334l.26372,5.42716q-2.3554-1.19892-4.83-2.49535l-.18672-5.39143Q166.11015,120.33353,168.42815,121.50334Z"/>
+        <path class="cls-15" d="M177.89387,126.07114l.46436,5.52178q-2.33136-1.05963-4.83279-2.27483l-.357-5.46977Q175.61348,125.02785,177.89387,126.07114Z"/>
+        <path class="cls-15" d="M196.302,132.84431l1.37142,5.82833c-1.42941-.30364-3.04742-.74363-4.83552-1.31551l-.98074-5.72757A45.079,45.079,0,0,0,196.302,132.84431Z"/>
+        <path class="cls-15" d="M178.17813,106.24382c1.67894,1.16525,3.29057,2.31786,4.83167,3.43972l-.61984,4.88583q-2.245-1.64618-4.69726-3.35214Z"/>
+        <path class="cls-15" d="M187.83228,113.3039q2.58446,2.00315,4.81852,3.86016l-1.00993,4.57825c-1.41823-1.18071-2.95252-2.4122-4.59531-3.68013Z"/>
+        <g class="cls-8">
+          <g class="cls-39">
+            <g class="cls-8">
+              <path class="cls-11" d="M206.723,135.04824l3.59062-2.08664c.00509.74955.01156,1.01638.01081,1.279-.05121,18.06407-6.45114,30.78635-16.75884,36.77652L189.975,173.1038c10.3077-5.99017,16.70763-18.71245,16.75884-36.77652.00075-.26266-.00572-.52949-.01081-1.279"/>
+            </g>
+          </g>
+        </g>
+        <g class="cls-8">
+          <g class="cls-40">
+            <g class="cls-8">
+              <path class="cls-12" d="M165.53648,49.11093l3.59061-2.08664c20.56879,18.77148,36.35589,47.72488,40.26074,74.56393l-3.59062,2.08664c-3.90485-26.839-19.69194-55.79245-40.26073-74.56393"/>
+              <path class="cls-11" d="M205.79721,123.67486l3.59062-2.08664a87.34653,87.34653,0,0,1,.92582,11.37338l-3.59062,2.08664a87.34653,87.34653,0,0,0-.92582-11.37338"/>
+            </g>
+          </g>
+        </g>
+        <polygon class="cls-9" points="188.279 50.922 191.869 48.836 190.168 55.072 186.578 57.159 188.279 50.922"/>
+        <polygon class="cls-11" points="173.167 11.899 176.757 9.813 191.869 48.836 188.279 50.922 173.167 11.899"/>
+        <polygon class="cls-41" points="146.789 14.164 150.379 12.078 176.757 9.813 173.167 11.899 146.789 14.164"/>
+      </g>
+      <path class="cls-42" d="M188.21537,50.94685c-1.542-3.14246-2.98231-6.32431-4.38758-9.51971l-1.05166-2.39744c-.35142-.79882-.68413-1.60487-1.02712-2.40694-.67666-1.60777-1.37439-3.20738-2.02555-4.825L177.74119,26.956l-1.9209-4.86553-.96-2.433-.92973-2.44466-1.85822-4.8898,1.1947.74542-6.60513.44188q-3.30536.18876-6.61234.35819c-2.20673.08941-4.41176.19788-6.62143.25259l-1.65651.04981-1.65814.0306c-1.10485.02722-2.21236.02342-3.319.03045l-.01161-.13536,26.37343-2.31735.08984-.00789.03275.08439c1.26166,3.251,2.541,6.49519,3.78746,9.75211l3.75856,9.7633,7.51707,19.5266Z"/>
+      <path class="cls-43" d="M160.10027,45.53611a75.99753,75.99753,0,0,0-20.526-12.51332,44.77388,44.77388,0,0,0-15.69825-3.22987,32.15388,32.15388,0,0,0-10.05162,1.41858,18.10493,18.10493,0,0,0-3.55093,1.49014l-.70929-1.15871c.21194-.12985,5.29853-3.17978,14.22246-3.10947a46.02237,46.02237,0,0,1,16.20754,3.295,77.25956,77.25956,0,0,1,20.97141,12.76018Z"/>
+      <path class="cls-44" d="M205.12005,123.72819a88.449,88.449,0,0,0-7.71363-28.97294,130.39944,130.39944,0,0,0-13.83506-23.57532,147.06,147.06,0,0,0-19.1583-21.63625l.89586-1.02123a148.42919,148.42919,0,0,1,19.34039,21.83012,131.78833,131.78833,0,0,1,13.98995,23.8317,89.80922,89.80922,0,0,1,7.835,29.43729Z"/>
+    </g>
+  </g>
+</svg>
diff --git a/pr-2241/sphinx/_static/cudaq_override.css b/pr-2241/sphinx/_static/cudaq_override.css
new file mode 100644
index 0000000000..4ab0ac179a
--- /dev/null
+++ b/pr-2241/sphinx/_static/cudaq_override.css
@@ -0,0 +1,27 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ *                                                                             *
+ * File: cudaq_override.css                                                    *
+ * Created Date: 16 Feb 2023                                                   *
+ * Last Modified: 16 Feb 2023                                                  *
+ ******************************************************************************/
+
+.wy-nav-content {
+max-width: 1240px !important;
+}
+
+.wy-menu-vertical a {
+	font-size: 92%;
+}
+
+.wy-menu-vertical li code, .wy-menu-vertical li .rst-content tt, .rst-content .wy-menu-vertical li tt {
+    font-size: 100%;
+}
+
+code.code span.pre, code.cpp span.pre, code.docutils span.pre{
+    color: darkgreen;
+}
diff --git a/pr-2241/sphinx/_static/devContainersExtension.png b/pr-2241/sphinx/_static/devContainersExtension.png
new file mode 100644
index 0000000000..f863a09331
Binary files /dev/null and b/pr-2241/sphinx/_static/devContainersExtension.png differ
diff --git a/pr-2241/sphinx/_static/dialects.png b/pr-2241/sphinx/_static/dialects.png
new file mode 100644
index 0000000000..9890d3d6dd
Binary files /dev/null and b/pr-2241/sphinx/_static/dialects.png differ
diff --git a/pr-2241/sphinx/_static/getToWork.png b/pr-2241/sphinx/_static/getToWork.png
new file mode 100644
index 0000000000..06eee986fb
Binary files /dev/null and b/pr-2241/sphinx/_static/getToWork.png differ
diff --git a/pr-2241/sphinx/_static/nvqpp_workflow.png b/pr-2241/sphinx/_static/nvqpp_workflow.png
new file mode 100644
index 0000000000..2880e61675
Binary files /dev/null and b/pr-2241/sphinx/_static/nvqpp_workflow.png differ
diff --git a/pr-2241/sphinx/_static/openTerminal.png b/pr-2241/sphinx/_static/openTerminal.png
new file mode 100644
index 0000000000..58e71b0689
Binary files /dev/null and b/pr-2241/sphinx/_static/openTerminal.png differ
diff --git a/pr-2241/sphinx/_static/qpud_fig.png b/pr-2241/sphinx/_static/qpud_fig.png
new file mode 100644
index 0000000000..66080b1ff5
Binary files /dev/null and b/pr-2241/sphinx/_static/qpud_fig.png differ
diff --git a/pr-2241/sphinx/_static/startVscode.png b/pr-2241/sphinx/_static/startVscode.png
new file mode 100644
index 0000000000..f7f78a1209
Binary files /dev/null and b/pr-2241/sphinx/_static/startVscode.png differ
diff --git a/pr-2241/sphinx/_templates/autosummary/class.rst b/pr-2241/sphinx/_templates/autosummary/class.rst
new file mode 100644
index 0000000000..b45a3fd5b5
--- /dev/null
+++ b/pr-2241/sphinx/_templates/autosummary/class.rst
@@ -0,0 +1,26 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+
+   {% block methods %}
+   {% if methods %}
+   .. rubric:: {{ _('Methods') }}
+
+   {% for item in methods %}
+   .. automethod:: {{ item }}
+   {%- endfor %}
+
+   {% endif %}
+   {% endblock %}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Attributes') }}
+
+   {% for item in attributes %}
+   .. autoattribute:: {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
diff --git a/pr-2241/sphinx/_templates/autosummary/dataclass.rst b/pr-2241/sphinx/_templates/autosummary/dataclass.rst
new file mode 100644
index 0000000000..b8c35324ed
--- /dev/null
+++ b/pr-2241/sphinx/_templates/autosummary/dataclass.rst
@@ -0,0 +1,10 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+
+   {% block methods %}
+   .. automethod:: __init__
+   {% endblock %}
+
diff --git a/pr-2241/sphinx/_templates/layout.html b/pr-2241/sphinx/_templates/layout.html
new file mode 100644
index 0000000000..c0f02f29ab
--- /dev/null
+++ b/pr-2241/sphinx/_templates/layout.html
@@ -0,0 +1,62 @@
+{% extends "!layout.html" %}
+  {% block sidebartitle %} {{ super() }}
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  {% endblock %}
+
+  {% block footer %} {{ super() }}
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  {% endblock %}
diff --git a/pr-2241/sphinx/_templates/openapi.html b/pr-2241/sphinx/_templates/openapi.html
new file mode 100644
index 0000000000..d50627fd0a
--- /dev/null
+++ b/pr-2241/sphinx/_templates/openapi.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+  <head />
+  <body>
+    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
+    <div id="redoc-container"></div>
+	<script type="application/json" id="openapi-spec">
+    ##SPEC_JSON##
+	</script>
+  <script>
+    var spec = JSON.parse(document.getElementById("openapi-spec").innerHTML);
+    Redoc.init(spec, {
+      "expandResponses": "200"
+    }, document.getElementById('redoc-container'))
+  </script>
+  </body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/api/api.rst b/pr-2241/sphinx/api/api.rst
new file mode 100644
index 0000000000..9a4cc41308
--- /dev/null
+++ b/pr-2241/sphinx/api/api.rst
@@ -0,0 +1,10 @@
+Code documentation
+******************
+
+.. toctree::
+  :caption: CUDA-Q API
+  :maxdepth: 1
+
+  C++ API <languages/cpp_api.rst>
+  Python API <languages/python_api.rst>
+  Quantum Operations <default_ops.rst>
\ No newline at end of file
diff --git a/pr-2241/sphinx/api/default_ops.rst b/pr-2241/sphinx/api/default_ops.rst
new file mode 100644
index 0000000000..bbd2b37fa0
--- /dev/null
+++ b/pr-2241/sphinx/api/default_ops.rst
@@ -0,0 +1,718 @@
+Quantum Operations
+******************************
+
+CUDA-Q provides a default set of quantum operations on qubits. 
+These operations can be used to define custom kernels and libraries.
+Since the set of quantum intrinsic operations natively supported on a specific target 
+depends on the backends architecture, the :code:`nvq++` compiler automatically
+decomposes the default operations into the appropriate set of intrinsic operations 
+for that target.
+
+The sections `Unitary Operations on Qubits`_ and `Measurements on Qubits`_ list the default set of quantum operations on qubits.
+
+Operations that implement unitary transformations of the quantum state are templated.
+The template argument allows to invoke the adjoint and controlled version of the quantum transformation, see the section on `Adjoint and Controlled Operations`_.
+
+CUDA-Q additionally provides overloads to support broadcasting of
+single-qubit operations across a vector of qubits.  For example,
+:code:`x(cudaq::qvector<>&)` flips the state of each qubit in the provided
+:code:`cudaq::qvector`. 
+
+
+Unitary Operations on Qubits
+=============================
+
+:code:`x`
+---------------------
+
+This operation implements the transformation defined by the Pauli-X matrix. It is also known as the quantum version of a `NOT`-gate.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # X = | 0  1 |
+        #     | 1  0 |
+        x(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // X = | 0  1 |
+        //     | 1  0 |
+        x(qubit);
+
+:code:`y`
+---------------------
+
+This operation implements the transformation defined by the Pauli-Y matrix.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Y = | 0  -i |
+        #     | i   0 |
+        y(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Y = | 0  -i |
+        //     | i   0 |
+        y(qubit);
+
+:code:`z`
+---------------------
+
+This operation implements the transformation defined by the Pauli-Z matrix.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Z = | 1   0 |
+        #     | 0  -1 |
+        z(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Z = | 1   0 |
+        //     | 0  -1 |
+        z(qubit);
+
+:code:`h`
+---------------------
+
+This operation is a rotation by π about the X+Z axis, and 
+enables one to create a superposition of computational basis states.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # H = (1 / sqrt(2)) * | 1   1 |
+        #                     | 1  -1 |
+        h(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // H = (1 / sqrt(2)) * | 1   1 |
+        //                     | 1  -1 |
+        h(qubit);
+
+:code:`r1`
+---------------------
+
+This operation is an arbitrary rotation about the :code:`|1>` state.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # R1(λ) = | 1     0    |
+        #         | 0  exp(iλ) |
+        r1(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // R1(λ) = | 1     0    |
+        //         | 0  exp(iλ) |
+        r1(std::numbers::pi, qubit);
+
+:code:`rx`
+---------------------
+
+This operation is an arbitrary rotation about the X axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Rx(θ) = |  cos(θ/2)  -isin(θ/2) |
+        #         | -isin(θ/2)  cos(θ/2)  |
+        rx(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Rx(θ) = |  cos(θ/2)  -isin(θ/2) |
+        //         | -isin(θ/2)  cos(θ/2)  |
+        rx(std::numbers::pi, qubit);
+
+:code:`ry`
+---------------------
+
+This operation is an arbitrary rotation about the Y axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Ry(θ) = | cos(θ/2)  -sin(θ/2) |
+        #         | sin(θ/2)   cos(θ/2) |
+        ry(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Ry(θ) = | cos(θ/2)  -sin(θ/2) |
+        //         | sin(θ/2)   cos(θ/2) |
+        ry(std::numbers::pi, qubit);
+
+:code:`rz`
+---------------------
+
+This operation is an arbitrary rotation about the Z axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Rz(λ) = | exp(-iλ/2)      0     |
+        #         |     0       exp(iλ/2) |
+        rz(math.pi, qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // Rz(λ) = | exp(-iλ/2)      0     |
+        //         |     0       exp(iλ/2) |
+        rz(std::numbers::pi, qubit);
+
+:code:`s`
+---------------------
+
+This operation applies to its target a rotation by π/2 about the Z axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # S = | 1   0 |
+        #     | 0   i |
+        s(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // S = | 1   0 |
+        //     | 0   i |
+        s(qubit);
+
+:code:`t`
+---------------------
+
+This operation applies to its target a π/4 rotation about the Z axis.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # T = | 1      0     |
+        #     | 0  exp(iπ/4) |
+        t(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // T = | 1      0     |
+        //     | 0  exp(iπ/4) |
+        t(qubit);
+
+:code:`swap`
+---------------------
+
+This operation swaps the states of two qubits.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit_1, qubit_2 = cudaq.qubit(), cudaq.qubit()
+
+        # Apply the unitary transformation
+        # Swap = | 1 0 0 0 |
+        #        | 0 0 1 0 |
+        #        | 0 1 0 0 |
+        #        | 0 0 0 1 |
+        swap(qubit_1, qubit_2)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit_1, qubit_2;
+
+        // Apply the unitary transformation
+        // Swap = | 1 0 0 0 |
+        //        | 0 0 1 0 |
+        //        | 0 1 0 0 |
+        //        | 0 0 0 1 |
+        swap(qubit_1, qubit_2);
+
+:code:`u3`
+---------------------
+
+This operation applies the universal three-parameters operator to target qubit. The three parameters are Euler angles - theta (θ), phi (φ), and lambda (λ).
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation
+        # U3(θ,φ,λ) = | cos(θ/2)            -exp(iλ) * sin(θ/2)       |
+        #             | exp(iφ) * sin(θ/2)   exp(i(λ + φ)) * cos(θ/2) |
+        u3(np.pi, np.pi, np.pi / 2, q)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation
+        // U3(θ,φ,λ) = | cos(θ/2)            -exp(iλ) * sin(θ/2)       |
+        //             | exp(iφ) * sin(θ/2)   exp(i(λ + φ)) * cos(θ/2) |
+        u3(M_PI, M_PI, M_PI_2, q);
+
+
+Adjoint and Controlled Operations
+==================================
+
+.. tab:: Python
+
+    The :code:`adj` method of any gate can be used to invoke the 
+    `adjoint <https://en.wikipedia.org/wiki/Conjugate_transpose>`__ transformation:
+
+    .. code-block:: python
+
+        # Create a kernel and allocate a qubit in a |0> state.
+        qubit = cudaq.qubit()
+
+        # Apply the unitary transformation defined by the matrix
+        # T = | 1      0     |
+        #     | 0  exp(iπ/4) |
+        # to the state of the qubit `q`:
+        t(qubit)
+
+        # Apply its adjoint transformation defined by the matrix
+        # T† = | 1      0     |
+        #      | 0  exp(-iπ/4) |
+        t.adj(qubit)
+        # `qubit` is now again in the initial state |0>.
+
+    The :code:`ctrl` method of any gate can be used to apply the transformation
+    conditional on the state of one or more control qubits, see also this 
+    `Wikipedia entry <https://en.wikipedia.org/wiki/Quantum_logic_gate#Controlled_gates>`__.
+
+    .. code-block:: python
+
+        # Create a kernel and allocate qubits in a |0> state.
+        ctrl_1, ctrl_2, target = cudaq.qubit(), cudaq.qubit(), cudaq.qubit()
+        # Create a superposition.
+        h(ctrl_1)
+        # `ctrl_1` is now in a state (|0> + |1>) / √2.
+
+        # Apply the unitary transformation
+        # | 1  0  0  0 |
+        # | 0  1  0  0 |
+        # | 0  0  0  1 |
+        # | 0  0  1  0 |
+        x.ctrl(ctrl_1, ctrl_2)
+        # `ctrl_1` and `ctrl_2` are in a state (|00> + |11>) / √2.
+
+        # Set the state of `target` to |1>:
+        x(target)
+        # Apply the transformation T only if both 
+        # control qubits are in a |1> state:
+        t.ctrl([ctrl_1, ctrl_2], target)
+        # The qubits ctrl_1, ctrl_2, and target are now in a state
+        # (|000> + exp(iπ/4)|111>) / √2.
+
+.. tab:: C++
+
+    The template argument :code:`cudaq::adj` can be used to invoke the 
+    `adjoint <https://en.wikipedia.org/wiki/Conjugate_transpose>`__ transformation:
+
+    .. code-block:: cpp
+
+        // Allocate a qubit in a |0> state.
+        cudaq::qubit qubit;
+
+        // Apply the unitary transformation defined by the matrix
+        // T = | 1      0     |
+        //     | 0  exp(iπ/4) |
+        // to the state of the qubit `q`:
+        t(qubit);
+
+        // Apply its adjoint transformation defined by the matrix
+        // T† = | 1      0     |
+        //      | 0  exp(-iπ/4) |
+        t<cudaq::adj>(qubit);
+        // Qubit `q` is now again in the initial state |0>.
+
+    The template argument :code:`cudaq::ctrl` can be used to apply the transformation
+    conditional on the state of one or more control qubits, see also this 
+    `Wikipedia entry <https://en.wikipedia.org/wiki/Quantum_logic_gate#Controlled_gates>`__.
+
+    .. code-block:: cpp
+
+        // Allocate qubits in a |0> state.
+        cudaq::qubit ctrl_1, ctrl_2, target;
+        // Create a superposition.
+        h(ctrl_1);
+        // Qubit ctrl_1 is now in a state (|0> + |1>) / √2.
+
+        // Apply the unitary transformation
+        // | 1  0  0  0 |
+        // | 0  1  0  0 |
+        // | 0  0  0  1 |
+        // | 0  0  1  0 |
+        x<cudaq::ctrl>(ctrl_1, ctrl_2);
+        // The qubits ctrl_1 and ctrl_2 are in a state (|00> + |11>) / √2.
+
+        // Set the state of `target` to |1>:
+        x(target);
+        // Apply the transformation T only if both 
+        // control qubits are in a |1> state:
+        t<cudaq::ctrl>(ctrl_1, ctrl_2, target);
+        // The qubits ctrl_1, ctrl_2, and target are now in a state
+        // (|000> + exp(iπ/4)|111>) / √2.
+
+
+Following common convention, by default the transformation is applied to the target qubit(s)
+if all control qubits are in a :code:`|1>` state. 
+However, that behavior can be changed to instead apply the transformation when a control qubit is in 
+a :code:`|0>` state by negating the polarity of the control qubit.
+The syntax for negating the polarity is the not-operator preceding the
+control qubit: 
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit c, q;
+        h(c);
+        x<cudaq::ctrl>(!c, q);
+        // The qubits c and q are in a state (|01> + |10>) / √2.
+
+This notation is only supported in the context of applying a controlled operation and is only valid for control qubits. For example, negating either of the target qubits in the
+:code:`swap` operation is not allowed.
+Negating the polarity of control qubits is similarly supported when using :code:`cudaq::control` to conditionally apply a custom quantum kernel.
+
+
+Measurements on Qubits
+=============================
+
+:code:`mz`
+---------------------
+
+This operation measures a qubit with respect to the computational basis, 
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-Z matrix.
+This is a non-linear transformation, and no template overloads are available.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+        mz(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+        mz(qubit);
+
+:code:`mx`
+---------------------
+
+This operation measures a qubit with respect to the Pauli-X basis, 
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-X matrix.
+This is a non-linear transformation, and no template overloads are available.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+        mx(qubit)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+        mx(qubit);
+
+:code:`my`
+---------------------
+
+This operation measures a qubit with respect to the Pauli-Y basis, 
+i.e., it projects the state of that qubit onto the eigenvectors of the Pauli-Y matrix.
+This is a non-linear transformation, and no template overloads are available.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qubit = cudaq.qubit()
+        kernel.my(qubit)
+        
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qubit qubit;
+        my(qubit);
+
+
+User-Defined Custom Operations
+==============================
+
+Users can define a custom quantum operation by its unitary matrix. First use 
+the API to register a custom operation, outside of a CUDA-Q kernel. Then the 
+operation can be used within a CUDA-Q kernel like any of the built-in operations
+defined above.
+Custom operations are supported on qubits only (`qudit` with `level = 2`).
+
+.. tab:: Python
+
+    The :code:`cudaq.register_operation` API accepts an identifier string for 
+    the custom operation and its unitary matrix. The matrix can be a `list` or
+    `numpy` array of complex numbers. A 1D matrix is interpreted as row-major.
+    
+
+    .. code-block:: python
+
+        import cudaq
+        import numpy as np
+
+        cudaq.register_operation("custom_h", 1. / np.sqrt(2.) * np.array([1, 1, 1, -1]))
+
+        cudaq.register_operation("custom_x", np.array([0, 1, 1, 0]))
+
+        @cudaq.kernel
+        def bell():
+            qubits = cudaq.qvector(2)
+            custom_h(qubits[0])
+            custom_x.ctrl(qubits[0], qubits[1])
+
+        cudaq.sample(bell).dump()
+
+        
+.. tab:: C++
+
+    The macro :code:`CUDAQ_REGISTER_OPERATION` accepts a unique name for the 
+    operation, the number of target qubits, the number of rotation parameters 
+    (can be 0), and the unitary matrix as a 1D row-major `std::vector<complex>` 
+    representation.
+    
+    .. code-block:: cpp
+
+        #include <cudaq.h>
+
+        CUDAQ_REGISTER_OPERATION(custom_h, 1, 0,
+                                {M_SQRT1_2, M_SQRT1_2, M_SQRT1_2, -M_SQRT1_2})
+
+        CUDAQ_REGISTER_OPERATION(custom_x, 1, 0, {0, 1, 1, 0})
+
+        __qpu__ void bell_pair() {
+            cudaq::qubit q, r;
+            custom_h(q);
+            custom_x<cudaq::ctrl>(q, r);
+        }
+
+        int main() {
+            auto counts = cudaq::sample(bell_pair);
+            for (auto &[bits, count] : counts) {
+                printf("%s\n", bits.data());
+            }
+        }
+
+
+For multi-qubit operations, the matrix is interpreted with MSB qubit ordering,
+i.e. big-endian convention. The following example shows two different custom
+operations, each operating on 2 qubits.
+
+
+.. tab:: Python
+
+    .. literalinclude:: ../snippets/python/using/examples/two_qubit_custom_op.py
+      :language: python
+      :start-after: [Begin Docs]
+      :end-before: [End Docs]
+
+
+.. tab:: C++
+
+    .. literalinclude:: ../snippets/cpp/using/two_qubit_custom_op.cpp
+      :language: cpp
+      :start-after: [Begin Docs]
+      :end-before: [End Docs]
+
+
+.. note:: 
+
+  Custom operations are currently supported only on :doc:`../using/backends/simulators`.
+  Attempt to use with a hardware backend will result in runtime error.
+
+
+Photonic Operations on Qudits
+=============================
+
+These operations are valid only on the `photonics` target which does not support the quantum operations above.
+
+:code:`plus`
+---------------------
+
+This is a place-holder, to be updated later.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        q = qudit(3)
+        plus(q)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<3> q(1);
+        plus(q[0]);
+
+:code:`phase_shift`
+---------------------
+
+This is a place-holder, to be updated later.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        q = qudit(4)
+        phase_shift(q, 0.17)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<4> q(1);
+        phase_shift(q[0], 0.17);
+
+:code:`beam_splitter`
+---------------------
+
+This is a place-holder, to be updated later.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        q = [qudit(3) for _ in range(2)]
+        beam_splitter(q[0], q[1], 0.34)
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<3> q(2);
+        beam_splitter(q[0], q[1], 0.34);
+
+:code:`mz`
+---------------------
+
+This operation returns the measurement results of the input qudit(s).
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        qutrits = [qudit(3) for _ in range(2)]
+        mz(qutrits)
+
+
+.. tab:: C++
+
+    .. code-block:: cpp
+
+        cudaq::qvector<3> qutrits(2);
+        mz(qutrits);
diff --git a/pr-2241/sphinx/api/languages/cpp_api.rst b/pr-2241/sphinx/api/languages/cpp_api.rst
new file mode 100644
index 0000000000..99e0b2eb07
--- /dev/null
+++ b/pr-2241/sphinx/api/languages/cpp_api.rst
@@ -0,0 +1,233 @@
+CUDA-Q C++ API
+******************************
+
+Operators 
+=============
+
+.. doxygenclass:: cudaq::spin_op
+    :members:
+
+Quantum
+=========
+
+.. doxygenvariable:: cudaq::dyn
+
+.. doxygenclass:: cudaq::qudit
+    :members:
+
+.. doxygenclass:: cudaq::qreg
+    :members:
+
+.. doxygenclass:: cudaq::qvector
+    :members:
+
+.. doxygenclass:: cudaq::qspan
+    :members:
+
+.. doxygenclass:: cudaq::qview
+    :members:
+
+.. doxygentypedef:: cudaq::qubit
+    
+Common
+=========
+
+.. doxygenclass:: cudaq::observe_result
+    :members:
+
+.. doxygenclass:: cudaq::ExecutionContext
+    :members:
+
+.. doxygenclass:: cudaq::details::future
+    :members:
+
+.. doxygenclass:: cudaq::async_result
+    :members:
+
+
+.. doxygenstruct:: cudaq::ExecutionResult
+    :members:
+
+.. doxygenclass:: cudaq::sample_result
+    :members:
+
+.. doxygenclass:: cudaq::SimulationState
+
+.. doxygenstruct:: cudaq::SimulationState::Tensor
+    :members:
+
+.. doxygenenum:: cudaq::SimulationState::precision
+
+.. doxygenenum:: cudaq::simulation_precision
+
+.. doxygentypedef:: cudaq::tensor
+
+.. doxygentypedef:: cudaq::TensorStateData
+
+.. doxygentypedef:: cudaq::state_data
+
+.. doxygenclass:: cudaq::CusvState
+
+.. doxygenclass:: nvqir::MPSSimulationState
+
+.. doxygenclass:: nvqir::TensorNetSimulationState
+
+.. doxygenclass:: cudaq::RemoteSimulationState
+
+.. doxygenclass:: cudaq::registry::RegisteredType
+    :members:
+
+.. doxygenclass:: cudaq::complex_matrix
+    :members:
+
+.. doxygenclass:: cudaq::Trace
+
+.. doxygenfunction:: cudaq::range(ElementType total)
+.. doxygenfunction:: cudaq::range(ElementType begin, ElementType end, ElementType step)
+
+.. doxygenfunction:: cudaq::draw(QuantumKernel &&kernel, Args&&... args)
+
+.. doxygenclass:: cudaq::Resources
+
+.. doxygentypedef:: cudaq::complex_matrix::value_type
+
+Noise Modeling 
+================
+
+.. doxygenstruct:: cudaq::kraus_op
+    :members:
+
+.. doxygenclass:: cudaq::kraus_channel
+    :members:
+
+.. doxygenclass:: cudaq::amplitude_damping_channel
+    :members:
+
+.. doxygenclass:: cudaq::bit_flip_channel
+    :members:
+
+.. doxygenclass:: cudaq::phase_flip_channel
+    :members:
+
+.. doxygenclass:: cudaq::depolarization_channel
+    :members:
+
+.. doxygenclass:: cudaq::noise_model
+    :members:
+
+Kernel Builder
+===============
+
+.. doxygenclass:: cudaq::kernel_builder
+    :members:
+
+.. doxygenclass:: cudaq::QuakeValue
+    :members:
+
+.. doxygenclass:: cudaq::details::kernel_builder_base
+    :members:
+
+.. doxygenclass:: cudaq::details::KernelBuilderType
+    :members:
+
+Algorithms
+===========
+
+.. doxygenclass:: cudaq::optimizer
+    :members:
+
+.. doxygenclass:: cudaq::optimizable_function
+    :members:
+
+.. doxygentypedef:: cudaq::optimization_result
+
+.. doxygenclass:: cudaq::state
+    :members:
+
+.. doxygenclass:: cudaq::gradient
+    :members:
+
+.. doxygenclass:: cudaq::gradients::central_difference
+    :members:
+
+.. doxygenclass:: cudaq::gradients::parameter_shift
+    :members:
+
+.. doxygenclass:: cudaq::gradients::forward_difference
+    :members:
+
+Platform
+=========
+
+.. doxygenclass:: cudaq::QPU
+    :members:
+
+.. doxygenclass:: cudaq::BaseRemoteRESTQPU
+
+.. doxygenclass:: cudaq::BaseRemoteSimulatorQPU
+
+.. doxygenclass:: cudaq::BaseNvcfSimulatorQPU    
+
+.. doxygenclass:: cudaq::quantum_platform
+    :members:
+
+.. doxygenstruct:: cudaq::RemoteCapabilities
+    :members:
+
+.. doxygenclass:: cudaq::SerializedCodeExecutionContext
+
+.. doxygentypedef:: cudaq::QuantumTask
+
+.. doxygentypedef:: cudaq::QubitConnectivity
+
+.. doxygentypedef:: cudaq::QubitEdge
+
+.. doxygentypedef:: cudaq::KernelExecutionTask
+
+Utilities
+=========
+
+.. doxygentypedef:: cudaq::complex
+
+.. doxygentypedef:: cudaq::real 
+
+.. doxygenfunction:: cudaq::range(std::size_t)
+    
+Namespaces 
+===========
+
+.. doxygennamespace:: cudaq
+    :desc-only:
+
+.. doxygenfunction:: cudaq::num_available_gpus
+.. doxygenfunction:: cudaq::set_random_seed
+.. doxygenfunction:: cudaq::set_noise
+.. doxygenfunction:: cudaq::unset_noise
+
+.. doxygennamespace:: cudaq::details
+    :desc-only:
+
+.. doxygennamespace:: cudaq::registry
+    :desc-only:
+
+.. doxygennamespace:: cudaq::mpi
+    :desc-only:
+
+.. doxygenfunction:: cudaq::mpi::initialize()
+.. doxygenfunction:: cudaq::mpi::initialize(int argc, char **argv)
+.. doxygenfunction:: cudaq::mpi::is_initialized
+.. doxygenfunction:: cudaq::mpi::finalize
+.. doxygenfunction:: cudaq::mpi::rank
+.. doxygenfunction:: cudaq::mpi::num_ranks
+.. doxygenfunction:: cudaq::mpi::all_gather(std::vector<double> &global, const std::vector<double> &local)
+.. doxygenfunction:: cudaq::mpi::all_gather(std::vector<int> &global, const std::vector<int> &local)
+.. doxygenfunction:: cudaq::mpi::all_reduce(const T&, const Func&)
+.. doxygenfunction:: cudaq::mpi::all_reduce(const T &localValue, const BinaryFunction &function)
+.. doxygenfunction:: cudaq::mpi::broadcast(std::vector<double> &data, int rootRank)
+.. doxygenfunction:: cudaq::mpi::broadcast(std::string &data, int rootRank)
+
+.. doxygennamespace:: cudaq::orca
+    :desc-only:
+
+.. doxygenfunction:: cudaq::orca::sample(std::vector<std::size_t> &input_state, std::vector<std::size_t> &loop_lengths, std::vector<double> &bs_angles, int n_samples = 10000)
+.. doxygenfunction:: cudaq::orca::sample(std::vector<std::size_t> &input_state, std::vector<std::size_t> &loop_lengths, std::vector<double> &bs_angles, std::vector<double> &ps_angles, int n_samples = 10000)
diff --git a/pr-2241/sphinx/api/languages/python_api.rst b/pr-2241/sphinx/api/languages/python_api.rst
new file mode 100644
index 0000000000..1bd8884539
--- /dev/null
+++ b/pr-2241/sphinx/api/languages/python_api.rst
@@ -0,0 +1,235 @@
+CUDA-Q Python API
+******************************
+
+.. automodule:: cudaq
+
+Program Construction
+=============================
+
+.. autofunction:: cudaq::make_kernel
+.. [SKIP_TEST]: Reason - AttributeError: module 'cudaq' has no attribute 'from_state'
+.. .. autofunction:: cudaq::from_state
+
+.. autoclass:: cudaq::PyKernel
+.. autoclass:: cudaq::Kernel
+
+    .. automethod:: qalloc
+    .. automethod:: __str__
+    .. automethod:: __call__
+
+    .. automethod:: x
+    .. automethod:: cx
+    .. automethod:: y
+    .. automethod:: cy
+    .. automethod:: z
+    .. automethod:: cz
+    .. automethod:: h
+    .. automethod:: ch
+    .. automethod:: s
+    .. automethod:: sdg
+    .. automethod:: cs
+    .. automethod:: t
+    .. automethod:: tdg
+    .. automethod:: ct
+    .. automethod:: rx
+    .. automethod:: crx
+    .. automethod:: ry
+    .. automethod:: cry
+    .. automethod:: rz
+    .. automethod:: crz
+    .. automethod:: r1
+    .. automethod:: cr1
+    .. automethod:: swap
+    .. automethod:: cswap
+    .. automethod:: exp_pauli
+    .. automethod:: mx
+    .. automethod:: my
+    .. automethod:: mz
+    .. automethod:: c_if
+    .. automethod:: for_loop
+    .. automethod:: adjoint
+    .. automethod:: control
+    .. automethod:: apply_call
+    .. automethod:: u3
+
+.. autoclass:: cudaq::PyKernelDecorator
+    :members:
+    :special-members: __str__, __call__
+
+.. autofunction:: kernel
+    
+Kernel Execution
+=============================
+
+.. autofunction:: cudaq::sample
+.. autofunction:: cudaq::sample_async
+.. autofunction:: cudaq::observe
+.. autofunction:: cudaq::observe_async
+.. autofunction:: cudaq::get_state
+.. autofunction:: cudaq::get_state_async
+.. autofunction:: cudaq::vqe
+.. autofunction:: cudaq::draw
+.. autofunction:: cudaq::translate
+
+Backend Configuration
+=============================
+
+.. autofunction:: cudaq::has_target
+.. autofunction:: cudaq::get_target
+.. autofunction:: cudaq::get_targets
+.. autofunction:: cudaq::set_target
+.. autofunction:: cudaq::reset_target
+.. autofunction:: cudaq::set_noise
+.. autofunction:: cudaq::unset_noise
+.. automethod:: cudaq::initialize_cudaq
+.. automethod:: cudaq::num_available_gpus
+.. automethod:: cudaq::set_random_seed
+
+Data Types
+=============================
+
+.. autoclass:: cudaq::SimulationPrecision
+    :members:
+    
+.. autoclass:: cudaq::Target
+    :members:
+
+.. autoclass:: cudaq::State
+    :members:
+
+.. autoclass:: cudaq::Tensor
+
+.. autoclass:: cudaq::QuakeValue
+
+    .. automethod:: __add__
+    .. automethod:: __radd__
+    .. automethod:: __sub__
+    .. automethod:: __rsub__
+    .. automethod:: __neg__
+    .. automethod:: __mul__
+    .. automethod:: __rmul__
+    .. automethod:: __getitem__
+    .. automethod:: slice
+
+.. autoclass:: cudaq::qubit
+.. autoclass:: cudaq::qreg
+.. autoclass:: cudaq::qvector
+
+.. autoclass:: cudaq::ComplexMatrix
+    :members:
+    :special-members: __getitem__, __str__
+
+.. autoclass:: cudaq::SpinOperator
+    :members:
+
+    .. automethod:: __eq__
+    .. automethod:: __add__
+    .. automethod:: __radd__
+    .. automethod:: __sub__
+    .. automethod:: __rsub__
+    .. automethod:: __mul__
+    .. automethod:: __rmul__
+    .. automethod:: __iter__
+        
+.. autofunction:: cudaq::spin.i
+.. autofunction:: cudaq::spin.x
+.. autofunction:: cudaq::spin.y
+.. autofunction:: cudaq::spin.z
+
+.. autoclass:: cudaq::SampleResult
+    :members:
+    :special-members: __getitem__, __len__, __iter__
+
+.. autoclass:: cudaq::AsyncSampleResult
+    :members:
+
+.. autoclass:: cudaq::ObserveResult
+    :members:
+
+.. autoclass:: cudaq::AsyncObserveResult
+    :members:
+
+.. autoclass:: cudaq::AsyncStateResult
+    :members:
+
+.. autoclass:: cudaq::OptimizationResult
+    :members:
+
+
+Optimizers
+-----------------
+
+.. autoclass:: cudaq.optimizers::optimizer
+
+.. autoclass:: cudaq.optimizers::GradientDescent
+    :members:
+
+.. autoclass:: cudaq.optimizers::COBYLA
+    :members:
+
+.. autoclass:: cudaq.optimizers::NelderMead
+    :members:
+
+.. autoclass:: cudaq.optimizers::LBFGS
+    :members:
+
+Gradients
+-----------------
+
+.. autoclass:: cudaq.gradients::gradient
+    :members:
+
+.. autoclass:: cudaq.gradients::CentralDifference
+    :members:
+
+.. autoclass:: cudaq.gradients::ForwardDifference
+    :members:
+
+.. autoclass:: cudaq.gradients::ParameterShift
+    :members:
+
+Noisy Simulation
+-----------------
+
+.. autoclass:: cudaq::NoiseModel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::BitFlipChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::PhaseFlipChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::DepolarizationChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::AmplitudeDampingChannel
+    :members:
+    :special-members: __init__
+
+.. autoclass:: cudaq::KrausChannel
+    :members:
+    :special-members: __getitem__
+
+.. autoclass:: cudaq::KrausOperator
+    :members:
+
+MPI Submodule
+=============================
+
+.. automethod:: cudaq.mpi::initialize
+.. automethod:: cudaq.mpi::rank
+.. automethod:: cudaq.mpi::num_ranks
+.. automethod:: cudaq.mpi::all_gather
+.. automethod:: cudaq.mpi::broadcast
+.. automethod:: cudaq.mpi::is_initialized
+.. automethod:: cudaq.mpi::finalize
+
+ORCA Submodule
+=============================
+
+.. automethod:: cudaq.orca::sample
diff --git a/pr-2241/sphinx/conf.py b/pr-2241/sphinx/conf.py
new file mode 100644
index 0000000000..560ee193d6
--- /dev/null
+++ b/pr-2241/sphinx/conf.py
@@ -0,0 +1,212 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+
+import os
+import sphinx_rtd_theme
+
+# -- Project information -----------------------------------------------------
+
+project = 'NVIDIA CUDA-Q'
+copyright = '2024, NVIDIA Corporation & Affiliates'
+author = 'NVIDIA Corporation & Affiliates'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| used in various places throughout the docs.
+
+# The short X.Y version.
+version = os.getenv("CUDA_QUANTUM_VERSION", "latest")
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    # 'sphinx.ext.imgmath',
+    'sphinx.ext.ifconfig',
+    'sphinx.ext.autodoc',  # to get documentation from python doc comments
+    'sphinx.ext.autosummary',
+    'sphinx.ext.autosectionlabel',
+    'sphinx.ext.doctest',  # test example codes in docs
+    'sphinx.ext.extlinks',
+    'sphinx.ext.intersphinx',
+    'sphinx.ext.mathjax',
+    'sphinx.ext.napoleon',  # support google/numpy style docstrings
+    #'sphinx.ext.linkcode',
+    'sphinx_reredirects',
+    'breathe',
+    'enum_tools.autoenum',  # for pretty-print Python enums
+    'myst_parser',  # for including markdown files
+    'sphinx_inline_tabs',  # showing code blocks in multiple languages
+    'nbsphinx',  # for supporting jupyter notebooks
+    'sphinx_copybutton',  # allows for copy/paste of code cells
+    "sphinx_gallery.load_style",
+    "IPython.sphinxext.ipython_console_highlighting",
+]
+
+nbsphinx_allow_errors = False
+nbsphinx_thumbnails = {
+    # Default thumbnail if the notebook does not define a cell tag to specify the thumbnail.
+    # See also: https://nbsphinx.readthedocs.io/en/latest/subdir/gallery.html
+    '**': '_static/cuda_quantum_icon.svg',
+    'examples/python/tutorials/hybrid_qnns': '_images/hybrid.png',
+    'examples/python/tutorials/multi_gpu_workflows': '_images/circsplit.png',
+}
+
+imgmath_latex_preamble = r'\usepackage{braket}'
+
+imgmath_image_format = 'svg'
+imgmath_font_size = 14
+#imgmath_dvipng_args = ['-gamma', '1.5', '-D', '110', '-bg', 'Transparent']
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+
+# The master toctree document.
+master_doc = 'index'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ['**/_*', '.DS_Store']
+
+# Generate OpenAPI spec for the REST API
+import ruamel.yaml
+import json
+
+current_path = os.path.dirname(os.path.realpath(__file__))
+# YAML file defines the spec
+yaml_file = current_path + '/api/rest/.openapi.yaml'
+yaml = ruamel.yaml.YAML(typ='safe')
+with open(yaml_file) as fpi:
+    data = yaml.load(fpi)
+json_spec = json.dumps(data, indent=2)
+
+# Auto-generate the HTML file with the embedded OpenAPI spec.
+html_template_file = current_path + '/_templates/openapi.html'
+with open(html_template_file, 'r') as file:
+    filedata = file.read()
+# Replace the placeholder with the spec
+filedata = filedata.replace("##SPEC_JSON##", json_spec)
+html_output_file = current_path + '/Output/openapi.html'
+os.makedirs(os.path.dirname(html_output_file), exist_ok=True)
+# Write the file out again
+with open(html_output_file, 'w') as file:
+    file.write(filedata)
+# Add this to `html_extra_path` so that it is copied to the deployed docs.
+html_extra_path = ['Output/openapi.html']
+
+# The reST default role (used for this markup: `text`) to use for all documents.
+default_role = 'code'  # NOTE: the following may be a better choice to error on the side of flagging anything that is referenced but but not declared
+#default_role = 'cpp:any' # see https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#cross-referencing
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'lightbulb'
+
+# autosummary is buggy: this must be py instead of cpp so that the domain setting
+# can be propagated to the autogen'd rst files.
+# primary_domain = 'py'
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'sphinx_rtd_theme'
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {
+    "collapse_navigation": False,
+    "sticky_navigation": False,
+    "prev_next_buttons_location": "both",
+    "style_nav_header_background":
+        "#76b900"  # Set upper left search bar to NVIDIA green
+}
+
+html_css_files = ['_static/cudaq_override.css']
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'cudaqDoc'
+
+
+def setup(app):
+    app.add_css_file('cudaq_override.css')
+
+
+# -- Options for BREATHE -------------------------------------------------
+
+breathe_projects = {"cudaq": "_doxygen/xml"}
+
+breathe_default_project = "cudaq"
+
+breathe_show_enumvalue_initializer = True
+
+# -- Other options -------------------------------------------------
+
+autosummary_generate = True
+
+intersphinx_mapping = {
+    'python': ('https://docs.python.org/3/', None),
+    'numpy': ('https://numpy.org/doc/stable/', None),
+}
+
+redirects = {"versions": "../latest/releases.html"}
+
+nitpick_ignore = [
+    ('cpp:identifier', 'GlobalRegisterName'),
+    ('cpp:identifier', 'CountsDictionary::iterator'),
+    ('cpp:identifier', 'CountsDictionary::const_iterator'),
+    ('cpp:identifier', 'State'),
+    ('cpp:identifier', 'pauli'),
+    ('cpp:identifier', 'Job'),
+    ('cpp:identifier', 'mlir'),
+    ('cpp:identifier', 'mlir::Value'),
+    ('cpp:identifier', 'mlir::Type'),
+    ('cpp:identifier', 'mlir::MLIRContext'),
+    ('cpp:identifier', 'mlir::ImplicitLocOpBuilder'),
+    ('cpp:identifier', 'BinarySymplecticForm'),
+    ('cpp:identifier', 'CountsDictionary'),
+    ('cpp:identifier', 'QuakeValueOrNumericType'),
+    ('cpp:identifier', 'cudaq::ctrl'),
+    ('py:class', 'function'),
+    ('py:class', 'type'),
+    ('py:class', 'cudaq::spin_op'),
+]
+
+napoleon_google_docstring = True
+napoleon_numpy_docstring = False
+autosectionlabel_prefix_document = True
+autosectionlabel_maxdepth = 2
+copybutton_copy_empty_lines = False
diff --git a/pr-2241/sphinx/examples/cpp/algorithms/amplitude_estimation.cpp b/pr-2241/sphinx/examples/cpp/algorithms/amplitude_estimation.cpp
new file mode 100644
index 0000000000..8cb4a1de92
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/algorithms/amplitude_estimation.cpp
@@ -0,0 +1,168 @@
+// Compile and run with:
+// ```
+// nvq++ amplitude_estimation.cpp -o mlae.x && ./mlae.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/optimizers.h>
+
+// This file implements Quantum Monte Carlo integration using Amplitude
+// Estimation. To compute a definite integral of the form sin^2(x) from
+// `0` to `bmax`, we use the maximum likelihood estimation method [1].
+// The kernels have been given similar names as their corresponding
+// unitary operators from equation (1) in [1].
+//
+// [1] Amplitude estimation without phase estimation by Suzuki et al.
+// (https://arxiv.org/pdf/1904.10246.pdf)
+
+namespace mlae {
+
+double loglikelihood(std::vector<int> &h, std::vector<int> &mk, int N_shots,
+                     double theta_val) {
+
+  double sum = 0;
+  for (int i = 0; i < h.size(); i++) {
+
+    double arg = (2 * mk[i] + 1) * theta_val;
+    sum += 2 * h[i] * log(fabs(sin(arg))) +
+           2 * (N_shots - h[i]) * log(fabs(cos(arg)));
+  }
+
+  return -sum;
+}
+
+double discretized_integral(const int n_qubits, double bmax) {
+
+  int N = pow(2, n_qubits) - 1;
+  double sum = 0.0;
+  double denom = pow(2, n_qubits);
+
+  for (int i = 0; i <= N; i++) {
+
+    sum += pow(sin((i + 0.5) * bmax / denom), 2);
+  }
+
+  return sum / denom;
+}
+
+int num_oracles(std::vector<int> &vec, const int N_shots) {
+
+  int total_oracles = 0;
+  for (int i = 0; i < vec.size(); i++) {
+    total_oracles += N_shots * (2 * vec[i] + 1);
+  }
+
+  return total_oracles;
+}
+} // namespace mlae
+
+struct statePrep_A {
+  void operator()(cudaq::qvector<> &q, const double bmax) __qpu__ {
+
+    int n = q.size();
+    // all qubits sans auxiliary
+    auto qubit_subset = q.front(n - 1);
+
+    h(qubit_subset);
+
+    ry(bmax / pow(2.0, n - 1), q[n - 1]);
+
+    for (int i = 1; i < n; i++) {
+      ry<cudaq::ctrl>(bmax / pow(2.0, n - i - 1), q[i - 1], q[n - 1]);
+    }
+  }
+};
+
+struct S_0 {
+  void operator()(cudaq::qvector<> &q) __qpu__ {
+
+    auto ctrl_qubits = q.front(q.size() - 1);
+    auto &last_qubit = q.back();
+
+    x(q);
+    h(last_qubit);
+    x<cudaq::ctrl>(ctrl_qubits, last_qubit);
+    h(last_qubit);
+    x(q);
+  }
+};
+
+struct run_circuit {
+
+  auto operator()(const int n_qubits, const int n_itrs,
+                  const double bmax) __qpu__ {
+
+    cudaq::qvector q(n_qubits + 1); // last is auxiliary
+    auto &last_qubit = q.back();
+
+    // State preparation
+    statePrep_A{}(q, bmax);
+
+    // Amplification Q^m_k as per evaluation schedule {m_0,m_1,..,m_k,..}
+    for (int i = 0; i < n_itrs; ++i) {
+
+      z(last_qubit);
+      cudaq::adjoint(statePrep_A{}, q, bmax);
+      S_0{}(q);
+      statePrep_A{}(q, bmax);
+    }
+    // Measure the last auxiliary qubit
+    mz(last_qubit);
+  }
+};
+
+int main() {
+
+  const int n = 10; // number of qubits (not including the auxiliary qubit)
+  const double bmax = M_PI * 0.25; // upper bound of the integral
+
+  // Specify your evaluation schedule
+  std::vector<int> schedule{0, 1, 2, 4};
+  std::vector<int> hits(schedule.size(),
+                        0); // #hits, input for post-processing
+
+  for (size_t i = 0; i < schedule.size(); i++) {
+    auto counts = cudaq::sample(run_circuit{}, n, schedule[i], bmax);
+    hits[i] = counts.count("1");
+  }
+
+  // Print the number of hits for the good state for each circuit
+  for (size_t i = 0; i < hits.size(); ++i)
+    printf("%d ", hits[i]);
+
+  printf("\n");
+
+  // Optimization (Replace with brute force)
+  cudaq::optimizers::cobyla optimizer;
+
+  // Specify initial value of optimization parameters
+  std::vector<double> theta{0.8}; // COBYLA is very sensitive to the start
+  optimizer.initial_parameters = theta;
+
+  // Specify bounds for theta
+  optimizer.lower_bounds = {0.0};
+  optimizer.upper_bounds = {M_PI / 2.0};
+
+  // Using 1000 shots in log-likelihood, which is the default #shots
+  auto [opt_val, opt_params] =
+      optimizer.optimize(1, [&](const std::vector<double> &theta) {
+        auto f = mlae::loglikelihood(hits, schedule, 1000, theta[0]);
+        printf("theta = %18.16e\n", theta[0]);
+        return f;
+      });
+
+  printf("opt val = %f, theta = %f\n", opt_val, opt_params[0]);
+
+  double a_estimated = sin(opt_params[0]) * sin(opt_params[0]);
+  printf("Estimated a is: %f\n", a_estimated);
+
+  // The integral is discretized using 2^n intervals
+  double a_discretized = mlae::discretized_integral(n, bmax);
+  printf("Discretized a is: %f\n", a_discretized);
+
+  printf("Relative error w.r.t. discretized version is: %3.2f %% \n",
+         100 * fabs((a_discretized - a_estimated) / a_estimated));
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/algorithms/bernstein_vazirani.cpp b/pr-2241/sphinx/examples/cpp/algorithms/bernstein_vazirani.cpp
new file mode 100644
index 0000000000..5371d0d576
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/algorithms/bernstein_vazirani.cpp
@@ -0,0 +1,95 @@
+// Compile and run with:
+// ```
+// nvq++ bernstein_vazirani.cpp -o bv.x --target nvidia --target-option mgpu
+// mpirun -np 4 ./bv.x
+// ```
+
+// This example is meant to demonstrate the cuQuantum GPU-accelerated multi-GPU
+// backend. A state vector simulation for up to 32 qubits can be run on a single
+// GPU (if the GPU memory is large enough). Larger state vectors can be
+// simulated using the multi-GPU backend. The amount of resources required for
+// the simulation doubles with with each additional qubit.
+
+#include <cudaq.h>
+#include <iostream>
+#include <random>
+#include <vector>
+
+#ifndef SIZE
+#define SIZE 5
+#endif
+
+template <int nrOfBits>
+std::vector<bool> random_bits(int seed) {
+
+  std::vector<bool> randomBits(nrOfBits);
+  std::default_random_engine generator(seed);
+  std::uniform_real_distribution<float> distribution(0.0, 1.0);
+
+  for (size_t i = 0; i < nrOfBits; i++) {
+    randomBits[i] = distribution(generator) >= 0.5;
+  }
+  return randomBits;
+}
+
+template <int nrOfBits>
+struct oracle {
+  auto operator()(std::vector<bool> bitvector, cudaq::qview<> qs,
+                  cudaq::qubit &aux) __qpu__ {
+
+    for (size_t i = 0; i < nrOfBits; i++) {
+      if (bitvector[i] & 1) {
+        x<cudaq::ctrl>(qs[nrOfBits - i - 1], aux);
+      }
+    }
+  }
+};
+
+template <int nrOfBits>
+struct bernstein_vazirani {
+  auto operator()(std::vector<bool> bitvector) __qpu__ {
+
+    cudaq::qarray<nrOfBits> qs;
+    cudaq::qubit aux;
+    h(aux);
+    z(aux);
+    h(qs);
+
+    oracle<nrOfBits>{}(bitvector, qs, aux);
+    h(qs);
+    mz(qs);
+  }
+};
+
+// Construct the bit vector such that the last bit has highest significance.
+std::string asString(const std::vector<bool> &bitvector) {
+  char *buffer = static_cast<char *>(alloca(bitvector.size() + 1));
+  std::size_t N = bitvector.size();
+  buffer[N] = '\0';
+  for (std::size_t i = 0; i < N; ++i)
+    buffer[N - 1 - i] = '0' + bitvector[i];
+  return {buffer, N};
+}
+
+int main(int argc, char *argv[]) {
+  auto seed = 1 < argc ? atoi(argv[1]) : time(NULL);
+
+  // The number of qubits can be >32 when targeting the `nvidia-mgpu` backend.
+  const int nr_qubits = SIZE;
+  const int nr_shots = 100;
+  auto bitvector = random_bits<nr_qubits>(seed);
+  auto kernel = bernstein_vazirani<nr_qubits>{};
+  auto counts = cudaq::sample(nr_shots, kernel, bitvector);
+
+  if (!cudaq::mpi::is_initialized() || cudaq::mpi::rank() == 0) {
+    printf("Encoded bitstring:  %s\n", asString(bitvector).c_str());
+    printf("Measured bitstring: %s\n\n", counts.most_probable().c_str());
+
+    for (auto &[bits, count] : counts) {
+      printf("observed %s with %.0f%% probability\n", bits.data(),
+             100.0 * count / nr_shots);
+    }
+  }
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/algorithms/grover.cpp b/pr-2241/sphinx/examples/cpp/algorithms/grover.cpp
new file mode 100644
index 0000000000..2dac99fbdb
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/algorithms/grover.cpp
@@ -0,0 +1,63 @@
+// Compile and run with:
+// ```
+// nvq++ grover.cpp -o grover.x && ./grover.x
+// ```
+
+#include <cmath>
+#include <cudaq.h>
+#include <numbers>
+
+__qpu__ void reflect_about_uniform(cudaq::qvector<> &qs) {
+  auto ctrlQubits = qs.front(qs.size() - 1);
+  auto &lastQubit = qs.back();
+
+  // Compute (U) Action (V) produces
+  // U V U::Adjoint
+  cudaq::compute_action(
+      [&]() {
+        h(qs);
+        x(qs);
+      },
+      [&]() { z<cudaq::ctrl>(ctrlQubits, lastQubit); });
+}
+
+struct run_grover {
+  template <typename CallableKernel>
+  __qpu__ auto operator()(const int n_qubits, CallableKernel &&oracle) {
+    int n_iterations = round(0.25 * std::numbers::pi * sqrt(2 ^ n_qubits));
+
+    cudaq::qvector qs(n_qubits);
+    h(qs);
+    for (int i = 0; i < n_iterations; i++) {
+      oracle(qs);
+      reflect_about_uniform(qs);
+    }
+    mz(qs);
+  }
+};
+
+struct oracle {
+  const long target_state;
+
+  void operator()(cudaq::qvector<> &qs) __qpu__ {
+    cudaq::compute_action(
+        [&]() {
+          for (int i = 1; i <= qs.size(); ++i) {
+            auto target_bit_set = (1 << (qs.size() - i)) & target_state;
+            if (!target_bit_set)
+              x(qs[i - 1]);
+          }
+        },
+        [&]() {
+          auto ctrlQubits = qs.front(qs.size() - 1);
+          z<cudaq::ctrl>(ctrlQubits, qs.back());
+        });
+  }
+};
+
+int main(int argc, char *argv[]) {
+  auto secret = 1 < argc ? strtol(argv[1], NULL, 2) : 0b1011;
+  oracle compute_oracle{.target_state = secret};
+  auto counts = cudaq::sample(run_grover{}, 4, compute_oracle);
+  printf("Found string %s\n", counts.most_probable().c_str());
+}
diff --git a/pr-2241/sphinx/examples/cpp/algorithms/phase_estimation.cpp b/pr-2241/sphinx/examples/cpp/algorithms/phase_estimation.cpp
new file mode 100644
index 0000000000..2ff5ea0588
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/algorithms/phase_estimation.cpp
@@ -0,0 +1,91 @@
+// Compile and run with:
+// ```
+// nvq++ phase_estimation.cpp -o qpe.x && ./qpe.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <stdio.h>
+
+#include <cmath>
+
+// A pure device quantum kernel defined as a free function
+// (cannot be called from host code).
+__qpu__ void iqft(cudaq::qview<> q) {
+  int N = q.size();
+  // Swap qubits
+  for (int i = 0; i < N / 2; ++i) {
+    swap(q[i], q[N - i - 1]);
+  }
+
+  for (int i = 0; i < N - 1; ++i) {
+    h(q[i]);
+    int j = i + 1;
+    for (int y = i; y >= 0; --y) {
+      double denom = (1UL << (j - y));
+      const double theta = -M_PI / denom;
+      r1<cudaq::ctrl>(theta, q[j], q[y]);
+    }
+  }
+
+  h(q[N - 1]);
+}
+
+// CUDA-Q kernel call operators can be templated on
+// input CUDA-Q kernel expressions. Here we define a general
+// Phase Estimation algorithm that is generic on the eigenstate
+// preparation and unitary evolution steps.
+struct qpe {
+
+  // Define the CUDA-Q call expression to take user-specified eigenstate
+  // and unitary evolution kernels, as well as the number of qubits in the
+  // counting register and in the eigenstate register.
+  template <typename StatePrep, typename Unitary>
+  void operator()(const int nCountingQubits, StatePrep &&state_prep,
+                  Unitary &&oracle) __qpu__ {
+    // Allocate a register of qubits
+    cudaq::qvector q(nCountingQubits + 1);
+
+    // Extract sub-registers, one for the counting qubits
+    // another for the eigenstate register
+    auto counting_qubits = q.front(nCountingQubits);
+    auto &state_register = q.back();
+
+    // Prepare the eigenstate
+    state_prep(state_register);
+
+    // Put the counting register into uniform superposition
+    h(counting_qubits);
+
+    // Perform `ctrl-U^j`
+    for (int i = 0; i < nCountingQubits; ++i) {
+      for (int j = 0; j < (1 << i); ++j) {
+        cudaq::control(oracle, counting_qubits[i], state_register);
+      }
+    }
+
+    // Apply inverse quantum Fourier transform
+    iqft(counting_qubits);
+
+    // Measure to gather sampling statistics
+    mz(counting_qubits);
+
+    return;
+  }
+};
+
+struct r1PiGate {
+  void operator()(cudaq::qubit &q) __qpu__ { r1(1., q); }
+};
+
+int main() {
+
+  for (auto nQubits : std::vector<int>{2, 4, 6, 8}) {
+    auto counts = cudaq::sample(
+        qpe{}, nQubits, [](cudaq::qubit &q) __qpu__ { x(q); }, r1PiGate{});
+    auto mostProbable = counts.most_probable();
+    double theta = cudaq::to_integer(mostProbable) / (double)(1UL << nQubits);
+    auto piEstimate = 1. / (2 * theta);
+    printf("Pi Estimate(nQubits == %d) = %lf \n", nQubits, piEstimate);
+  }
+}
diff --git a/pr-2241/sphinx/examples/cpp/algorithms/qaoa_maxcut.cpp b/pr-2241/sphinx/examples/cpp/algorithms/qaoa_maxcut.cpp
new file mode 100644
index 0000000000..0c14b578c6
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/algorithms/qaoa_maxcut.cpp
@@ -0,0 +1,91 @@
+// Compile and run with:
+// ```
+// nvq++ qaoa_maxcut.cpp -o qaoa.x && ./qaoa.x
+// ```
+
+// [Begin Documentation]
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+#include <cudaq/spin_op.h>
+
+// Here we build up a CUDA-Q kernel for QAOA with p layers, with each
+// layer containing the alternating set of unitaries corresponding to the
+// problem and the mixer Hamiltonians. The algorithm leverages the CUDA-Q
+// VQE support to compute the Max-Cut of a rectangular graph illustrated below.
+//
+//        v0  0---------------------0 v1
+//            |                     |
+//            |                     |
+//            |                     |
+//            |                     |
+//        v3  0---------------------0 v2
+// The Max-Cut for this problem is 0101 or 1010.
+
+struct ansatz {
+  void operator()(std::vector<double> theta, const int n_qubits,
+                  const int n_layers) __qpu__ {
+    cudaq::qvector q(n_qubits);
+
+    // Prepare the initial state by superposition
+    h(q);
+
+    // Loop over all the layers
+    for (int i = 0; i < n_layers; ++i) {
+      // Problem Hamiltonian
+      for (int j = 0; j < n_qubits; ++j) {
+
+        x<cudaq::ctrl>(q[j], q[(j + 1) % n_qubits]);
+        rz(2.0 * theta[i], q[(j + 1) % n_qubits]);
+        x<cudaq::ctrl>(q[j], q[(j + 1) % n_qubits]);
+      }
+
+      for (int j = 0; j < n_qubits; ++j) {
+        // Mixer Hamiltonian
+        rx(2.0 * theta[i + n_layers], q[j]);
+      }
+    }
+  }
+};
+
+int main() {
+
+  using namespace cudaq::spin;
+
+  cudaq::set_random_seed(13); // set for repeatability
+
+  // Problem Hamiltonian
+  const cudaq::spin_op Hp = 0.5 * z(0) * z(1) + 0.5 * z(1) * z(2) +
+                            0.5 * z(0) * z(3) + 0.5 * z(2) * z(3);
+
+  // Problem parameters
+  const int n_qubits = 4;
+  const int n_layers = 2;
+  const int n_params = 2 * n_layers;
+
+  // Instantiate the optimizer
+  cudaq::optimizers::cobyla optimizer; // gradient-free COBYLA
+
+  // Set initial values for the optimization parameters
+  optimizer.initial_parameters = cudaq::random_vector(
+      -M_PI / 8.0, M_PI / 8.0, n_params, std::mt19937::default_seed);
+
+  // Call the optimizer
+  auto [opt_val, opt_params] =
+      cudaq::vqe(ansatz{}, Hp, optimizer, n_params, n_qubits, n_layers);
+
+  // Print the optimized value and the parameters
+  printf("Optimal value = %.16lf\n", opt_val);
+  printf("Optimal params = (%.16lf, %.16lf, %.16lf, %.16lf) \n", opt_params[0],
+         opt_params[1], opt_params[2], opt_params[3]);
+
+  // Sample the circuit using optimized parameters
+  auto counts = cudaq::sample(ansatz{}, opt_params, n_qubits, n_layers);
+
+  // Dump the states and the counts
+  counts.dump();
+
+  return 0;
+}
+// [End Documentation]
\ No newline at end of file
diff --git a/pr-2241/sphinx/examples/cpp/algorithms/vqe_h2.cpp b/pr-2241/sphinx/examples/cpp/algorithms/vqe_h2.cpp
new file mode 100644
index 0000000000..50c65da2d6
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/algorithms/vqe_h2.cpp
@@ -0,0 +1,117 @@
+// Compile and run with:
+// ```
+// nvq++ vqe_h2.cpp -o vqe.x && ./vqe.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/builder.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+
+// Here we build up a CUDA-Q kernel with N layers and each
+// layer containing an arrangement of random SO(4) rotations. The algorithm
+// leverages the CUDA-Q VQE support to compute the ground state of the
+// Hydrogen atom.
+
+// The SO4 random entangler written as a CUDA-Q kernel free function
+// since this is a pure-device quantum kernel
+__qpu__ void so4(cudaq::qubit &q, cudaq::qubit &r,
+                 const std::vector<double> &thetas) {
+  ry(thetas[0], q);
+  ry(thetas[1], r);
+
+  h(r);
+  x<cudaq::ctrl>(q, r);
+  h(r);
+
+  ry(thetas[2], q);
+  ry(thetas[3], r);
+
+  h(r);
+  x<cudaq::ctrl>(q, r);
+  h(r);
+
+  ry(thetas[4], q);
+  ry(thetas[5], r);
+
+  h(r);
+  x<cudaq::ctrl>(q, r);
+  h(r);
+}
+
+// The SO4 fabric CUDA-Q kernel. Keeps track of simple
+// arithmetic class members controlling the number of qubits and
+// entangling layers.
+struct so4_fabric {
+  void operator()(std::vector<double> params, int n_qubits,
+                  int n_layers) __qpu__ {
+    cudaq::qvector q(n_qubits);
+
+    x(q[0]);
+    x(q[2]);
+
+    const int block_size = 2;
+    int counter = 0;
+    for (int i = 0; i < n_layers; i++) {
+      // first layer of so4 blocks (even)
+      for (int k = 0; k < n_qubits; k += 2) {
+        auto subq = q.slice(k, block_size);
+        auto so4_params = cudaq::slice_vector(params, counter, 6);
+        so4(subq[0], subq[1], so4_params);
+        counter += 6;
+      }
+
+      // second layer of so4 blocks (odd)
+      for (int k = 1; k + block_size < n_qubits; k += 2) {
+        auto subq = q.slice(k, block_size);
+        auto so4_params = cudaq::slice_vector(params, counter, 6);
+        so4(subq[0], subq[1], so4_params);
+        counter += 6;
+      }
+    }
+  }
+};
+
+int main() {
+  // Read in the spin op from file
+  std::vector<double> h2_data{0, 0, 0, 0, -0.10647701149499994, 0.0,
+                              1, 1, 1, 1, 0.0454063328691,      0.0,
+                              1, 1, 3, 3, 0.0454063328691,      0.0,
+                              3, 3, 1, 1, 0.0454063328691,      0.0,
+                              3, 3, 3, 3, 0.0454063328691,      0.0,
+                              2, 0, 0, 0, 0.170280101353,       0.0,
+                              2, 2, 0, 0, 0.120200490713,       0.0,
+                              2, 0, 2, 0, 0.168335986252,       0.0,
+                              2, 0, 0, 2, 0.165606823582,       0.0,
+                              0, 2, 0, 0, -0.22004130022499996, 0.0,
+                              0, 2, 2, 0, 0.165606823582,       0.0,
+                              0, 2, 0, 2, 0.174072892497,       0.0,
+                              0, 0, 2, 0, 0.17028010135300004,  0.0,
+                              0, 0, 2, 2, 0.120200490713,       0.0,
+                              0, 0, 0, 2, -0.22004130022499999, 0.0,
+                              15};
+  cudaq::spin_op H(h2_data, /*nQubits*/ 4);
+  // For 8 qubits, 36 parameters per layer
+  int n_layers = 2, n_qubits = H.num_qubits(), block_size = 2, p_counter = 0;
+  int n_blocks_per_layer = 2 * (n_qubits / block_size) - 1;
+  int n_params = n_layers * 6 * n_blocks_per_layer;
+  printf("%d qubit Hamiltonian -> %d parameters\n", n_qubits, n_params);
+
+  // Define the initial parameters and ansatz.
+  auto init_params =
+      cudaq::random_vector(-1, 1, n_params, std::mt19937::default_seed);
+
+  so4_fabric ansatz;
+
+  // Run VQE.
+  cudaq::optimizers::lbfgs optimizer;
+  optimizer.initial_parameters = init_params;
+  optimizer.max_eval = 20;
+  optimizer.max_line_search_trials = 10;
+  cudaq::gradients::central_difference gradient;
+  auto [opt_val, opt_params] =
+      cudaq::vqe(ansatz, gradient, H, optimizer, n_params, n_qubits, n_layers);
+
+  printf("Optimal value = %.16lf\n", opt_val);
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/bernstein_vazirani.cpp b/pr-2241/sphinx/examples/cpp/basics/bernstein_vazirani.cpp
new file mode 100644
index 0000000000..a27a270b70
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/bernstein_vazirani.cpp
@@ -0,0 +1,79 @@
+#include <cudaq.h>
+#include <iostream>
+
+// If you have a NVIDIA GPU you can use this example to see
+// that the GPU-accelerated backends can easily handle a
+// larger number of qubits compared the CPU-only backend.
+
+// Depending on the available memory on your GPU, you can
+// set the number of qubits to around 30 qubits, and set the
+// `--target=nvidia` from the command line.
+
+// Note: Without setting the target to the `nvidia` backend,
+// there will be a noticeable decrease in simulation performance.
+// This is because the CPU-only backend has difficulty handling
+// 30+ qubit simulations.
+
+std::vector<int> random_bitstring(int qubit_count) {
+  std::vector<int> vector_of_bits;
+  for (auto i = 0; i < qubit_count; i++) {
+    // Populate our vector of bits with random binary
+    // values (base 2).
+    vector_of_bits.push_back(rand() % 2);
+  }
+  return vector_of_bits;
+}
+
+__qpu__ void oracle(cudaq::qview<> qvector, cudaq::qubit &auxillary_qubit,
+                    std::vector<int> &hidden_bitstring) {
+  for (auto i = 0; i < hidden_bitstring.size(); i++) {
+    if (hidden_bitstring[i] == 1)
+      // Apply a `cx` gate with the current qubit as
+      // the control and the auxillary qubit as the target.
+      x<cudaq::ctrl>(qvector[i], auxillary_qubit);
+  }
+}
+
+__qpu__ void bernstein_vazirani(std::vector<int> &hidden_bitstring) {
+  // Allocate the specified number of qubits - this
+  // corresponds to the length of the hidden bitstring.
+  cudaq::qvector qvector(hidden_bitstring.size());
+  // Allocate an extra auxillary qubit.
+  cudaq::qubit auxillary_qubit;
+
+  // Prepare the auxillary qubit.
+  h(auxillary_qubit);
+  z(auxillary_qubit);
+
+  // Place the rest of the qubits in a superposition state.
+  h(qvector);
+
+  // Query the oracle.
+  oracle(qvector, auxillary_qubit, hidden_bitstring);
+
+  // Apply another set of Hadamards to the qubits.
+  h(qvector);
+
+  // Apply measurement gates to just the `qubits`
+  // (excludes the auxillary qubit).
+  mz(qvector);
+}
+
+int main() {
+  // Note: this algorithm will require an additional ancillary qubit.
+  auto qubit_count = 5; // set to around 30 qubits for `nvidia` target
+
+  // Generate a bitstring to encode and recover with our algorithm.
+  auto hidden_bitstring = random_bitstring(5);
+
+  auto result = cudaq::sample(bernstein_vazirani, hidden_bitstring);
+  result.dump();
+
+  std::cout << "Encoded bitstring = ";
+  for (auto bit : hidden_bitstring)
+    std::cout << bit;
+  std::cout << "\n";
+  std::cout << "Measured bitstring = " << result.most_probable() << "\n";
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/cuquantum_backends.cpp b/pr-2241/sphinx/examples/cpp/basics/cuquantum_backends.cpp
new file mode 100644
index 0000000000..4d0c87ca49
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/cuquantum_backends.cpp
@@ -0,0 +1,43 @@
+// Compile and run with:
+// ```
+// nvq++ cuquantum_backends.cpp -o dyn.x --target nvidia && ./dyn.x
+// ```
+
+// This example is meant to demonstrate the cuQuantum
+// GPU-accelerated backends and their ability to easily handle
+// a larger number of qubits compared the CPU-only backend.
+
+// On CPU-only backends, this seems to hang, i.e., it takes a long
+// time to handle this number of qubits.
+
+#include <cudaq.h>
+
+// Define a quantum kernel with a runtime parameter
+struct ghz {
+  auto operator()(const int N) __qpu__ {
+
+    // Dynamically sized vector of qubits
+    cudaq::qvector q(N);
+    h(q[0]);
+    for (int i = 0; i < N - 1; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    mz(q);
+  }
+};
+
+int main() {
+  auto shots_count = 1024 * 1024;
+  auto counts = cudaq::sample(shots_count, ghz{}, 28);
+
+  if (!cudaq::mpi::is_initialized() || cudaq::mpi::rank() == 0) {
+    counts.dump();
+
+    // Fine grain access to the bits and counts
+    for (auto &[bits, count] : counts) {
+      printf("Observed: %s, %lu\n", bits.data(), count);
+    }
+  }
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/cutensornet_backends.cpp b/pr-2241/sphinx/examples/cpp/basics/cutensornet_backends.cpp
new file mode 100644
index 0000000000..9c3add9a72
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/cutensornet_backends.cpp
@@ -0,0 +1,54 @@
+// Compile with:
+// ```
+// nvq++ cutensornet_backends.cpp -o dyn.x --target tensornet
+// ```
+//
+// This example is meant to demonstrate the `cuTensorNet`
+// multi-node/multi-GPU backend.
+// On a multi-GPU system, we can enable distributed parallelization across MPI
+// processes by initializing MPI (see code) and launch the compiled executable
+// with MPI.
+// ```
+// mpirun -np <N> ./dyn.x
+// ```
+
+#include <cudaq.h>
+
+// Define a quantum kernel with a runtime parameter
+struct ghz {
+  auto operator()(const int N) __qpu__ {
+
+    // Dynamically sized vector of qubits
+    cudaq::qvector q(N);
+    h(q[0]);
+    for (int i = 0; i < N - 1; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    mz(q);
+  }
+};
+
+int main() {
+  // Initialize MPI to enable `cuTensorNet` distributed parallelization (see
+  // Simulation Backends/Tensor Network Simulators section of the documentation
+  // for more info)
+  // ```
+  // cudaq::mpi::initialize();
+  // if (cudaq::mpi::rank() == 0)
+  //   printf("Number of MPI processes: %d\n", cudaq::mpi::num_ranks());
+  // ```
+
+  auto counts = cudaq::sample(100, ghz{}, 28);
+  counts.dump();
+
+  // Fine grain access to the bits and counts
+  for (auto &[bits, count] : counts) {
+    printf("Observed: %s, %lu\n", bits.data(), count);
+  }
+
+  // Finalize MPI if initialized
+  // ```
+  // cudaq::mpi::finalize();
+  // ```
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/expectation_values.cpp b/pr-2241/sphinx/examples/cpp/basics/expectation_values.cpp
new file mode 100644
index 0000000000..41eea1f156
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/expectation_values.cpp
@@ -0,0 +1,33 @@
+// Compile and run with:
+// ```
+// nvq++ expectation_values.cpp -o d2.x && ./d2.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+
+// The example here shows a simple use case for the `cudaq::observe`
+// function in computing expected values of provided spin_ops.
+
+struct ansatz {
+  auto operator()(double theta) __qpu__ {
+    cudaq::qvector q(2);
+    x(q[0]);
+    ry(theta, q[1]);
+    x<cudaq::ctrl>(q[1], q[0]);
+  }
+};
+
+int main() {
+
+  // Build up your spin op algebraically
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+
+  // Observe takes the kernel, the spin_op, and the concrete
+  // parameters for the kernel
+  double energy = cudaq::observe(ansatz{}, h, .59);
+  printf("Energy is %lf\n", energy);
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/mid_circuit_measurement.cpp b/pr-2241/sphinx/examples/cpp/basics/mid_circuit_measurement.cpp
new file mode 100644
index 0000000000..7224fadccd
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/mid_circuit_measurement.cpp
@@ -0,0 +1,49 @@
+// Compile and run with:
+// ```
+// nvq++ mid_circuit_measurement.cpp -o teleport.x && ./teleport.x
+// ```
+
+#include <cudaq.h>
+
+struct kernel {
+  void operator()() __qpu__ {
+    cudaq::qarray<3> q;
+    // Initial state preparation
+    x(q[0]);
+
+    // Create Bell pair
+    h(q[1]);
+    x<cudaq::ctrl>(q[1], q[2]);
+
+    x<cudaq::ctrl>(q[0], q[1]);
+    h(q[0]);
+
+    auto b0 = mz(q[0]);
+    auto b1 = mz(q[1]);
+
+    if (b1)
+      x(q[2]);
+    if (b0)
+      z(q[2]);
+
+    mz(q[2]);
+  }
+};
+
+int main() {
+
+  int nShots = 100;
+  // Sample
+  auto counts = cudaq::sample(/*shots*/ nShots, kernel{});
+  counts.dump();
+
+  // Get the marginal counts on the second qubit
+  auto resultsOnZero = counts.get_marginal({0});
+  resultsOnZero.dump();
+
+  // Count the "1"
+  auto nOnes = resultsOnZero.count("1");
+
+  // Will fail if not equal to number of shots
+  assert(nOnes == nShots && "Failure to teleport qubit in |1> state.");
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/multi_controlled_operations.cpp b/pr-2241/sphinx/examples/cpp/basics/multi_controlled_operations.cpp
new file mode 100644
index 0000000000..6e820659eb
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/multi_controlled_operations.cpp
@@ -0,0 +1,58 @@
+// Compile and run with:
+// ```
+// nvq++ multi_controlled_operations.cpp -o ccnot.x && ./ccnot.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+
+// Here we demonstrate how one might apply multi-controlled
+// operations on a general CUDA-Q kernel.
+struct ApplyX {
+  void operator()(cudaq::qubit &q) __qpu__ { x(q); }
+};
+
+struct ccnot_test {
+  // constrain the signature of the incoming kernel
+  void operator()(cudaq::takes_qubit auto &&apply_x) __qpu__ {
+    cudaq::qvector qs(3);
+
+    x(qs);
+    x(qs[1]);
+
+    // Control U (apply_x) on the first two qubits of
+    // the allocated register.
+    cudaq::control(apply_x, qs.front(2), qs[2]);
+
+    mz(qs);
+  }
+};
+
+int main() {
+  // We can achieve the same thing as above via
+  // a lambda expression.
+  auto ccnot = []() __qpu__ {
+    cudaq::qvector q(3);
+
+    x(q);
+    x(q[1]);
+
+    x<cudaq::ctrl>(q[0], q[1], q[2]);
+
+    mz(q);
+  };
+
+  auto counts = cudaq::sample(ccnot);
+
+  // Fine grain access to the bits and counts
+  for (auto &[bits, count] : counts) {
+    printf("Observed: %s, %lu\n", bits.data(), count);
+  }
+
+  auto counts2 = cudaq::sample(ccnot_test{}, ApplyX{});
+
+  // Fine grain access to the bits and counts
+  for (auto &[bits, count] : counts2) {
+    printf("Observed: %s, %lu\n", bits.data(), count);
+  }
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/noise_amplitude_damping.cpp b/pr-2241/sphinx/examples/cpp/basics/noise_amplitude_damping.cpp
new file mode 100644
index 0000000000..35c2bfffaf
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/noise_amplitude_damping.cpp
@@ -0,0 +1,54 @@
+// Compile and run with:
+// ```
+// nvq++ noise_amplitude_damping.cpp --target density-matrix-cpu -o dyn.x
+// && ./dyn.x
+// ```
+//
+// Note: You must set the target to a density matrix backend for the noise
+// to successfully impact the system.
+
+#include <cudaq.h>
+
+// CUDA-Q supports several different models of noise. In this case,
+// we will examine the modeling of energy dissipation within our system
+// via environmental interactions. The result of this "amplitude damping"
+// is to return the qubit to the |0> state with a user-specified probability.
+
+int main() {
+
+  // We will begin by defining an empty noise model that we will add
+  // our damping channel to.
+  cudaq::noise_model noise;
+
+  // We define an amplitude damping channel setting the probability of
+  // the qubit decaying to the ground state to `1.0`.
+  cudaq::amplitude_damping_channel ad(1.);
+
+  // We will apply this channel to any Hadamard gate on the qubit.
+  // In other words, after each Hadamard on the qubit, there will be a
+  // probability of `1.0` that the qubit decays back to ground.
+  noise.add_channel<cudaq::types::h>({0}, ad);
+
+  // The Hadamard gate here will bring the qubit to `1/sqrt(2) (|0> + |1>)`,
+  // where it will remain with a probability of `1 - p = 0.0`.
+  auto kernel = []() __qpu__ {
+    cudaq::qubit q;
+    h(q);
+    mz(q);
+  };
+
+  // Now let's set the noise and we're ready to run the simulation!
+  cudaq::set_noise(noise);
+
+  // Our results should show all measurements in the |0> state, indicating
+  // that the noise has successfully impacted the system.
+  auto noisy_counts = cudaq::sample(kernel);
+  noisy_counts.dump();
+
+  // To confirm this, we can run the simulation again without noise.
+  // The qubit will now have a 50/50 mix of measurements between
+  // |0> and |1>.
+  cudaq::unset_noise();
+  auto noiseless_counts = cudaq::sample(kernel);
+  noiseless_counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/noise_bit_flip.cpp b/pr-2241/sphinx/examples/cpp/basics/noise_bit_flip.cpp
new file mode 100644
index 0000000000..aa598b09f5
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/noise_bit_flip.cpp
@@ -0,0 +1,51 @@
+// Compile and run with:
+// ```
+// nvq++ noise_bit_flip.cpp --target density-matrix-cpu -o dyn.x
+// && ./dyn.x
+// ```
+//
+// Note: You must set the target to a density matrix backend for the noise
+// to successfully impact the system.
+
+#include <cudaq.h>
+
+// CUDA-Q supports several different models of noise. In this case,
+// we will examine the modeling of decoherence of the qubit state. This
+// will occur from "bit flip" errors, wherein the qubit has a user-specified
+// probability of undergoing an X-180 rotation.
+
+int main() {
+
+  // We will begin by defining an empty noise model that we will add
+  // these decoherence channels to.
+  cudaq::noise_model noise;
+
+  // We define a bit-flip channel setting the probability of the
+  // qubit flipping 180 degrees about the X axis to `1.0`.
+  cudaq::bit_flip_channel bf(1.);
+  // We will apply this channel to any X gate on the qubit, giving each X-gate
+  // a probability of `1.0` of undergoing an extra X-gate.
+  noise.add_channel<cudaq::types::x>({0}, bf);
+
+  // After the X-gate, the qubit will remain in the |1> state with a probability
+  // of `1 - p = 0.0`.
+  auto kernel = []() __qpu__ {
+    cudaq::qubit q;
+    x(q);
+    mz(q);
+  };
+
+  // Now let's set the noise and we're ready to run the simulation!
+  cudaq::set_noise(noise);
+
+  // Our results should show all measurements in the |0> state, indicating
+  // that the noise has successfully impacted the system.
+  auto noisy_counts = cudaq::sample(kernel);
+  noisy_counts.dump();
+
+  // To confirm this, we can run the simulation again without noise.
+  // We should now see the qubit in the |1> state.
+  cudaq::unset_noise();
+  auto noiseless_counts = cudaq::sample(kernel);
+  noiseless_counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/noise_callback.cpp b/pr-2241/sphinx/examples/cpp/basics/noise_callback.cpp
new file mode 100644
index 0000000000..9c8a9724dd
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/noise_callback.cpp
@@ -0,0 +1,67 @@
+// Compile and run with:
+// ```
+// nvq++ noise_callback.cpp --target density-matrix-cpu -o dyn.x
+// && ./dyn.x
+// ```
+//
+// Note: You must set the target to a density matrix backend for the noise
+// to successfully impact the system.
+
+#include <cudaq.h>
+#include <iostream>
+
+// CUDA-Q supports several different models of noise. In this
+// case, we will examine the dynamic noise channel specified as a callback
+// function.
+
+int main() {
+
+  // We will begin by defining an empty noise model that we will add
+  // our channel to.
+  cudaq::noise_model noise;
+  //  Noise model callback function
+  const auto rx_noise = [](const auto &qubits,
+                           const auto &params) -> cudaq::kraus_channel {
+    // Model a pulse-length based rotation gate:
+    // the bigger the angle, the longer the pulse, i.e., more amplitude damping.
+    auto angle = params[0];
+    // Normalize the angle into the [0, 2*pi] range
+    while (angle > 2. * M_PI)
+      angle -= 2. * M_PI;
+
+    while (angle < 0)
+      angle += 2. * M_PI;
+    // Damping rate is linearly proportional to the angle
+    const auto damping_rate = angle / (2. * M_PI);
+    std::cout << "Angle = " << params[0]
+              << ", amplitude damping rate = " << damping_rate << "\n";
+    return cudaq::amplitude_damping_channel(damping_rate);
+  };
+
+  // Bind the noise model callback function to the `rx` gate
+  noise.add_channel<cudaq::types::rx>(rx_noise);
+
+  auto kernel = [](double angle) __qpu__ {
+    cudaq::qubit q;
+    rx(angle, q);
+    mz(q);
+  };
+
+  // Now let's set the noise and we're ready to run the simulation!
+  cudaq::set_noise(noise);
+
+  // Our results should show measurements in both the |0> and |1> states,
+  // indicating that the noise has successfully impacted the system. Note: a
+  // `rx(pi)` is equivalent to a Pauli X gate, and thus, it should be in the |1>
+  // state if no noise is present.
+  auto noisy_counts = cudaq::sample(kernel, M_PI);
+  std::cout << "Noisy result:\n";
+  noisy_counts.dump();
+
+  // To confirm this, we can run the simulation again without noise.
+  cudaq::unset_noise();
+  auto noiseless_counts = cudaq::sample(kernel, M_PI);
+  std::cout << "Noiseless result:\n";
+  noiseless_counts.dump();
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/noise_depolarization.cpp b/pr-2241/sphinx/examples/cpp/basics/noise_depolarization.cpp
new file mode 100644
index 0000000000..a6471c6d2e
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/noise_depolarization.cpp
@@ -0,0 +1,53 @@
+// Compile and run with:
+// ```
+// nvq++ noise_depolarization.cpp --target density-matrix-cpu -o dyn.x
+// && ./dyn.x
+// ```
+//
+// Note: You must set the target to a density matrix backend for the noise
+// to successfully impact the system.
+
+#include <cudaq.h>
+
+// CUDA-Q supports several different models of noise. In this
+// case, we will examine the modeling of depolarization noise. This
+// depolarization will result in the qubit state decaying into a mix
+// of the basis states, |0> and |1>, with a user-provided probability.
+
+int main() {
+
+  // We will begin by defining an empty noise model that we will add
+  // our depolarization channel to.
+  cudaq::noise_model noise;
+
+  // We define a depolarization channel setting the probability of the
+  // qubit state being scrambled to `1.0`.
+  cudaq::depolarization_channel depolarization(1.);
+  // We will apply the channel to any Y-gate on qubit 0. In other words,
+  // for each Y-gate on our qubit, the qubit will have a `1.0`
+  // probability of decaying into a mixed state.
+  noise.add_channel<cudaq::types::y>({0}, depolarization);
+
+  // Our kernel will apply a Y-gate to qubit 0.
+  // This will bring the qubit to the |1> state, where it will remain
+  // with a probability of `1 - p = 0.0`.
+  auto kernel = []() __qpu__ {
+    cudaq::qubit q;
+    y(q);
+    mz(q);
+  };
+
+  // Now let's set the noise and we're ready to run the simulation!
+  cudaq::set_noise(noise);
+
+  // With noise, the measurements should be a roughly 50/50
+  // mix between the |0> and |1> states.
+  auto noisy_counts = cudaq::sample(kernel);
+  noisy_counts.dump();
+
+  // To confirm this, we can run the simulation again without noise.
+  // Without noise, the qubit should still be in the |1> state.
+  cudaq::unset_noise();
+  auto noiseless_counts = cudaq::sample(kernel);
+  noiseless_counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/noise_modeling.cpp b/pr-2241/sphinx/examples/cpp/basics/noise_modeling.cpp
new file mode 100644
index 0000000000..eb61cb9512
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/noise_modeling.cpp
@@ -0,0 +1,56 @@
+// Compile and run with:
+// ```
+// nvq++ noise_modeling.cpp --target density-matrix-cpu -o noise.x && ./noise.x
+// ```
+
+#include "cudaq.h"
+
+int main() {
+  // Define a  kernel
+  auto xgate = []() __qpu__ {
+    cudaq::qubit q;
+    x(q);
+    mz(q);
+  };
+
+  // Run noise-less simulation
+  auto counts = cudaq::sample(xgate);
+  counts.dump();
+
+  // Create a depolarizing Kraus channel made up of two Kraus operators.
+  cudaq::kraus_channel depol({cudaq::complex{0.99498743710662, 0.0},
+                              {0.0, 0.0},
+                              {0.0, 0.0},
+                              {0.99498743710662, 0.0}},
+
+                             {cudaq::complex{0.0, 0.0},
+                              {0.05773502691896258, 0.0},
+                              {0.05773502691896258, 0.0},
+                              {0.0, 0.0}},
+
+                             {cudaq::complex{0.0, 0.0},
+                              {0.0, -0.05773502691896258},
+                              {0.0, 0.05773502691896258},
+                              {0.0, 0.0}},
+
+                             {cudaq::complex{0.05773502691896258, 0.0},
+                              {0.0, 0.0},
+                              {0.0, 0.0},
+                              {-0.05773502691896258, 0.0}});
+
+  // Create the noise model
+  cudaq::noise_model noise;
+  // Add the Kraus channel to the x operation on qubit 0.
+  noise.add_channel<cudaq::types::x>({0}, depol);
+
+  // Set the noise model
+  cudaq::set_noise(noise);
+
+  // Run the noisy simulation
+  counts = cudaq::sample(xgate);
+  counts.dump();
+
+  // Unset the noise model when done. This is not necessary in this case, but it
+  // is good practice in order to avoid interference with future simulations.
+  cudaq::unset_noise();
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/noise_phase_flip.cpp b/pr-2241/sphinx/examples/cpp/basics/noise_phase_flip.cpp
new file mode 100644
index 0000000000..3926644d4e
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/noise_phase_flip.cpp
@@ -0,0 +1,58 @@
+// Compile and run with:
+// ```
+// nvq++ noise_phase_flip.cpp --target density-matrix-cpu -o dyn.x
+// && ./dyn.x
+// ```
+//
+// Note: You must set the target to a density matrix backend for the noise
+// to successfully impact the system.
+
+#include <cudaq.h>
+
+// CUDA-Q supports several different models of noise. In this
+// case, we will examine the modeling of decoherence of the qubit phase.
+// This will occur from "phase flip" errors, wherein the qubit has a
+// user-specified probability of undergoing a Z-180 rotation.
+
+int main() {
+
+  // We will begin by defining an empty noise model that we will add
+  // our phase flip channel to.
+  cudaq::noise_model noise;
+
+  // We define a phase-flip channel setting the probability of the
+  // qubit undergoing a phase rotation of 180 degrees (π) to `1.0`.
+  cudaq::phase_flip_channel pf(1.);
+  // We will apply this channel to any Z gate on the qubit.
+  // In other words, after each Z gate on qubit 0, there will be a
+  // probability of `1.0` that the qubit undergoes an extra
+  // Z rotation.
+  noise.add_channel<cudaq::types::z>({0}, pf);
+
+  auto kernel = []() __qpu__ {
+    cudaq::qubit q;
+    // Place qubit in superposition state.
+    h(q);
+    // Rotate on Z by 180 degrees.
+    z(q);
+    // Apply another Hadamard.
+    h(q);
+    mz(q);
+  };
+
+  // Now let's set the noise and we're ready to run the simulation!
+  cudaq::set_noise(noise);
+
+  // With noise, our Z-gate will effectively cancel out due
+  // to the presence of a phase-flip error on the gate with a
+  // probability of `1.0`. This will put us back in the |0> state.
+  auto noisy_counts = cudaq::sample(kernel);
+  noisy_counts.dump();
+
+  // To confirm this, we can run the simulation again without noise.
+  // Without noise, we'd expect the qubit to end in the |1> state due
+  // to the phase rotation between the two Hadamard gates.
+  cudaq::unset_noise();
+  auto noiseless_counts = cudaq::sample(kernel);
+  noiseless_counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/basics/static_kernel.cpp b/pr-2241/sphinx/examples/cpp/basics/static_kernel.cpp
new file mode 100644
index 0000000000..c8743414e6
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/basics/static_kernel.cpp
@@ -0,0 +1,40 @@
+
+// Compile and run with:
+// ```
+// nvq++ static_kernel.cpp -o ghz.x && ./ghz.x
+// ```
+
+#include <cudaq.h>
+
+// Define a CUDA-Q kernel that is fully specified
+// at compile time via templates.
+template <std::size_t N>
+struct ghz {
+  auto operator()() __qpu__ {
+
+    // Compile-time sized array like std::array
+    cudaq::qarray<N> q;
+    h(q[0]);
+    for (int i = 0; i < N - 1; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    mz(q);
+  }
+};
+
+int main() {
+
+  auto kernel = ghz<10>{};
+  auto counts = cudaq::sample(kernel);
+
+  if (!cudaq::mpi::is_initialized() || cudaq::mpi::rank() == 0) {
+    counts.dump();
+
+    // Fine grain access to the bits and counts
+    for (auto &[bits, count] : counts) {
+      printf("Observed: %s, %lu\n", bits.data(), count);
+    }
+  }
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/builder/builder.cpp b/pr-2241/sphinx/examples/cpp/other/builder/builder.cpp
new file mode 100644
index 0000000000..bdcb3c4c21
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/builder/builder.cpp
@@ -0,0 +1,175 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ builder.cpp -o builder.x && ./builder.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/builder.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+
+static bool results_are_close(const cudaq::sample_result &f1,
+                              const cudaq::sample_result &f2) {
+  // Stub for a fancy comparison.
+  f1.dump();
+  f2.dump();
+  return true;
+}
+
+// This example demonstrates various uses for the `cudaq::builder`
+// type. This type enables one to dynamically construct callable
+// CUDA-Q kernels via just-in-time compilation. The typical workflow
+// starts by creating a `cudaq::builder` and any CUDA-Q kernel runtime
+// arguments via the `cudaq::make_kernel<ParameterTypes...>()` function.
+// Programmers get reference to the builder and the concrete runtime
+// parameters for the kernel function, and can then begin building up
+// the CUDA-Q kernel. Once done adding gates, the builder itself is
+// callable, and can be used just like any other CUDA-Q kernel.
+
+int main() {
+  {
+
+    // Create a Hamiltonian as a `cudaq::spin_op`.
+    using namespace cudaq::spin;
+    cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                       .21829 * z(0) - 6.125 * z(1);
+
+    // Build a quantum kernel dynamically
+    // Start by creating the Builder, the kernel argument types
+    // should be provided here as template parameters.
+    auto [ansatz, theta] = cudaq::make_kernel<double>();
+
+    // Allocate some qubits
+    auto q = ansatz.qalloc(2);
+
+    // Build up the circuit, use the acquired parameter
+    ansatz.x(q[0]);
+    ansatz.ry(theta, q[1]);
+    ansatz.x<cudaq::ctrl>(q[1], q[0]); // Need to get rid of ::
+
+    // The buildable kernel can be passed to CUDA-Q functions
+    // just like a declared kernel type.
+    ansatz(.59);
+    double exp = cudaq::observe(ansatz, h, .59);
+    printf("<H2> = %lf\n", exp);
+  }
+
+  {
+    // Build up a 2 parameter circuit using a vector<double> parameter
+    // Run the CUDA-Q optimizer to find optimal value.
+    using namespace cudaq::spin;
+    cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                       .21829 * z(0) - 6.125 * z(1);
+    cudaq::spin_op h3 = h + 9.625 - 9.625 * z(2) - 3.913119 * x(1) * x(2) -
+                        3.913119 * y(1) * y(2);
+
+    // Create the kernel with signature void(std::vector<double>)
+    auto [ansatz, thetas] = cudaq::make_kernel<std::vector<double>>();
+
+    // Allocate some qubits
+    auto q = ansatz.qalloc(3);
+
+    // Build the kernel
+    ansatz.x(q[0]);
+    ansatz.ry(thetas[0], q[1]);
+    ansatz.ry(thetas[1], q[2]);
+    ansatz.x<cudaq::ctrl>(q[2], q[0]);
+    ansatz.x<cudaq::ctrl>(q[0], q[1]);
+    // Can do fancy arithmetic with Parameter types.
+    ansatz.ry(-thetas[0], q[1]);
+    // -or- `ansatz_builder.ry(-1.0 * thetas[0], q[1]);`
+    // -or- `ansatz_builder.ry(thetas[0] * -1.0, q[1]);`
+    // -or- `ansatz_builder.ry(-1 * thetas[0], q[1]);`
+    ansatz.x<cudaq::ctrl>(q[0], q[1]);
+    ansatz.x<cudaq::ctrl>(q[1], q[0]);
+
+    // You now have a callable kernel, use it with the VQE algorithm
+    cudaq::gradients::central_difference gradient(ansatz);
+    cudaq::optimizers::lbfgs optimizer;
+    auto [opt_val_0, optpp] = cudaq::vqe(ansatz, gradient, h3, optimizer, 2);
+    printf("<H3> = %lf\n", opt_val_0);
+  }
+
+  {
+    // Make a kernel for sampling, here the GHZ state on 8 qubits
+    int n_qubits = 8;
+    auto ghz_builder = cudaq::make_kernel();
+
+    // Allocate the qubits
+    auto q = ghz_builder.qalloc(n_qubits);
+
+    // Build the GHZ state
+    ghz_builder.h(q[0]);
+    for (int i = 0; i < n_qubits - 1; i++) {
+      ghz_builder.x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    ghz_builder.mz(q);
+
+    // You can get the MLIR representation
+    auto mlir_code = ghz_builder.to_quake();
+
+    // Sample and get the counts
+    auto counts = cudaq::sample(ghz_builder);
+    counts.dump();
+  }
+
+  {
+    // In a simulated environment, it is sometimes useful to be able to
+    // specify an initial state vector. The initial state vector is 2 to the
+    // power `n` where `n` is the number of qubits.
+
+    // In this example, we create a kernel template `sim_kernel` that captures
+    // the variable `init_state` by reference.
+    auto sim_builder = cudaq::make_kernel();
+    std::vector<cudaq::complex> init_state;
+    auto qubits = sim_builder.qalloc(init_state);
+    // Build the quantum circuit template here.
+    sim_builder.mz(qubits);
+
+    // Now we are ready to instantiate the kernel and invoke it. So we can set
+    // the `init_state` to a vector with 2 complex values (1 qubit) and
+    // get the results.
+    init_state = {{0.0, 1.0}, {1.0, 0.0}};
+    auto counts0 = cudaq::sample(sim_builder);
+
+    // Now suppose we have a different initial state with 4 complex values (2
+    // qubits). Let's rerun the kernel with the new `init_state`.
+    init_state = {{1.0, 0.0}, {0.0, 1.0}, {0.0, 1.0}, {1.0, 0.0}};
+    auto counts1 = cudaq::sample(sim_builder);
+
+    // Finally in this wholly contrived example, we test the results to make
+    // sure they are "close".
+    if (results_are_close(counts0, counts1)) {
+      printf("The two initial states generated results that are \"close\".\n");
+    }
+  }
+
+  {
+
+    // Let's do a final sampling task. Let's
+    // build up an element of the Toffoli truth table.
+    auto ccnot_builder = cudaq::make_kernel();
+    auto q = ccnot_builder.qalloc(3);
+    ccnot_builder.x(q);
+    ccnot_builder.x(q[1]);
+    ccnot_builder.x<cudaq::ctrl>(q[0], q[1], q[2]);
+    ccnot_builder.mz(q);
+
+    auto mlir_code = ccnot_builder.to_quake();
+    printf("%s\n", mlir_code.c_str());
+
+    auto counts = cudaq::sample(ccnot_builder);
+    counts.dump();
+  }
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/builder/qaoa_maxcut_builder.cpp b/pr-2241/sphinx/examples/cpp/other/builder/qaoa_maxcut_builder.cpp
new file mode 100644
index 0000000000..3815310d2f
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/builder/qaoa_maxcut_builder.cpp
@@ -0,0 +1,97 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ qaoa_maxcut_builder.cpp -o builder.x && ./builder.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+#include <cudaq/spin_op.h>
+
+// This example demonstrates the same code as in `qaoa_maxcut.cpp`,
+// but with the use of dynamic kernels. Here we have QAOA with `p` layers,
+// with each layer containing the alternating set of unitaries corresponding
+// to the problem and the mixer Hamiltonians. The algorithm leverages the
+// CUDA-Q VQE support to compute the Max-Cut of a rectangular graph
+// illustrated below.
+//
+//        v0  0---------------------0 v1
+//            |                     |
+//            |                     |
+//            |                     |
+//            |                     |
+//        v3  0---------------------0 v2
+// The Max-Cut for this problem is 0101 or 1010.
+
+int main() {
+
+  using namespace cudaq::spin;
+
+  cudaq::set_random_seed(13); // set for repeatability
+
+  // Problem Hamiltonian
+  const cudaq::spin_op Hp = 0.5 * z(0) * z(1) + 0.5 * z(1) * z(2) +
+                            0.5 * z(0) * z(3) + 0.5 * z(2) * z(3);
+
+  // Specify problem parameters
+  const int n_qubits = 4;
+  const int n_layers = 2;
+  const int n_params = 2 * n_layers;
+
+  auto [kernel, theta] = cudaq::make_kernel<std::vector<double>>();
+
+  auto q = kernel.qalloc(n_qubits);
+
+  // Prepare the initial state by superposition
+  kernel.h(q);
+
+  // Loop over all the layers
+  for (int i = 0; i < n_layers; ++i) {
+    // Problem Hamiltonian
+    for (int j = 0; j < n_qubits; ++j) {
+
+      kernel.x<cudaq::ctrl>(q[j], q[(j + 1) % n_qubits]);
+      kernel.rz(2.0 * theta[i], q[(j + 1) % n_qubits]);
+      kernel.x<cudaq::ctrl>(q[j], q[(j + 1) % n_qubits]);
+    }
+
+    for (int j = 0; j < n_qubits; ++j) {
+      // Mixer Hamiltonian
+      kernel.rx(2.0 * theta[i + n_layers], q[j]);
+    }
+  }
+
+  // Instantiate the optimizer
+  cudaq::optimizers::lbfgs optimizer;                    // gradient-based
+  cudaq::gradients::central_difference gradient(kernel); // grad vector
+
+  // Set initial values for the optimization parameters
+  optimizer.initial_parameters = cudaq::random_vector(
+      -M_PI / 8.0, M_PI / 8.0, n_params, std::mt19937::default_seed);
+
+  // Optimization using gradient-based L-BFGS
+  auto [opt_val, opt_params] =
+      cudaq::vqe(kernel, gradient, Hp, optimizer, n_params);
+
+  // Print the optimized value and the parameters
+  printf("Optimal value = %.16lf\n", opt_val);
+  printf("Optimal params = %.16lf %.16lf %.16lf %.16lf\n", opt_params[0],
+         opt_params[1], opt_params[2], opt_params[3]);
+
+  // Sample the circuit using optimized parameters
+  auto counts = cudaq::sample(kernel, opt_params);
+
+  // Dump the states and the counts
+  counts.dump();
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/builder/vqe_h2_builder.cpp b/pr-2241/sphinx/examples/cpp/other/builder/vqe_h2_builder.cpp
new file mode 100644
index 0000000000..94a0459c44
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/builder/vqe_h2_builder.cpp
@@ -0,0 +1,124 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ vqe_h2_builder.cpp -o builder.x && ./builder.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+
+// This example demonstrates the utility of the builder pattern
+// for a common chemistry example. Here we build up a CUDA-Q kernel
+// with N layers and each layer containing an arrangement of
+// random SO(4) rotations. The algorithm leverages the CUDA-Q
+// VQE support to compute the ground state of the Hydrogen atom.
+
+namespace cudaq {
+
+// Define a function that applies a general SO(4) rotation to
+// the builder on the provided qubits with the provided parameters.
+// Note we keep this qubit and parameter arguments as auto as these
+// will default to taking the qubits and variational parameters (`QuakeValue`s)
+void so4(cudaq::kernel_builder<std::vector<double>> &builder, QuakeValue &&q,
+         QuakeValue &&r, QuakeValue &parameters) {
+  builder.ry(parameters[0], q);
+  builder.ry(parameters[1], r);
+
+  builder.h(r);
+  builder.x<cudaq::ctrl>(q, r);
+  builder.h(r);
+
+  builder.ry(parameters[2], q);
+  builder.ry(parameters[3], r);
+
+  builder.h(r);
+  builder.x<cudaq::ctrl>(q, r);
+  builder.h(r);
+
+  builder.ry(parameters[4], q);
+  builder.ry(parameters[5], r);
+
+  builder.h(r);
+  builder.x<cudaq::ctrl>(q, r);
+  builder.h(r);
+}
+
+} // namespace cudaq
+
+int main() {
+
+  // Read in the spin op from file
+  std::vector<double> h2_data{0, 0, 0, 0, -0.10647701149499994, 0.0,
+                              1, 1, 1, 1, 0.0454063328691,      0.0,
+                              1, 1, 3, 3, 0.0454063328691,      0.0,
+                              3, 3, 1, 1, 0.0454063328691,      0.0,
+                              3, 3, 3, 3, 0.0454063328691,      0.0,
+                              2, 0, 0, 0, 0.170280101353,       0.0,
+                              2, 2, 0, 0, 0.120200490713,       0.0,
+                              2, 0, 2, 0, 0.168335986252,       0.0,
+                              2, 0, 0, 2, 0.165606823582,       0.0,
+                              0, 2, 0, 0, -0.22004130022499996, 0.0,
+                              0, 2, 2, 0, 0.165606823582,       0.0,
+                              0, 2, 0, 2, 0.174072892497,       0.0,
+                              0, 0, 2, 0, 0.17028010135300004,  0.0,
+                              0, 0, 2, 2, 0.120200490713,       0.0,
+                              0, 0, 0, 2, -0.22004130022499999, 0.0,
+                              15};
+  cudaq::spin_op H(h2_data, /*nQubits*/ 4);
+
+  int layers = 2, n_qubits = H.num_qubits(), block_size = 2, p_counter = 0;
+  int n_blocks_per_layer = 2 * (n_qubits / block_size) - 1;
+  int n_params = layers * 6 * n_blocks_per_layer;
+  printf("%d qubit Hamiltonian -> %d parameters\n", n_qubits, n_params);
+
+  // Create the builder with signature void(std::vector<double>)
+  auto [kernel, params] = cudaq::make_kernel<std::vector<double>>();
+
+  // Allocate the qubits, initialize the HF product state
+  auto q = kernel.qalloc(n_qubits);
+  kernel.x(q[0]);
+  kernel.x(q[2]);
+
+  // Loop over adding layers of SO4 entanglers
+  int counter = 0;
+  for (int i = 0; i < layers; i++) {
+    // first layer of so4 blocks (even)
+    for (int k = 0; k < n_qubits; k += block_size) {
+      auto subq = q.slice(k, block_size);
+      auto sub_p = params.slice(p_counter, 6);
+      cudaq::so4(kernel, subq[0], subq[1], sub_p);
+      p_counter += 6;
+    }
+
+    // second layer of so4 blocks (odd)
+    for (int k = 1; k + block_size < n_qubits; k += block_size) {
+      auto subq = q.slice(k, block_size);
+      auto sub_p = params.slice(p_counter, 6);
+      cudaq::so4(kernel, subq[0], subq[1], sub_p);
+      p_counter += 6;
+    }
+  }
+
+  // Run the VQE algorithm from specific initial parameters.
+  auto init_params =
+      cudaq::random_vector(-1, 1, n_params, std::mt19937::default_seed);
+
+  // Run VQE
+  cudaq::optimizers::lbfgs optimizer;
+  cudaq::gradients::central_difference gradient(kernel);
+  optimizer.initial_parameters = init_params;
+  optimizer.max_eval = 20;
+  optimizer.max_line_search_trials = 10;
+  auto [opt_val, opt_params] =
+      cudaq::vqe(kernel, gradient, H, optimizer, n_params);
+  printf("Optimal value = %.16lf\n", opt_val);
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/compute_actions.cpp b/pr-2241/sphinx/examples/cpp/other/compute_actions.cpp
new file mode 100644
index 0000000000..1ad73d8bfc
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/compute_actions.cpp
@@ -0,0 +1,103 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ compute_actions.cpp -o gs.x && ./gs.x
+// ```
+
+// The algorithm leverages the VQE support to compute ground
+// state of the Hydrogen atom.
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+
+#include <map>
+#include <vector>
+
+struct ansatz_handcoded {
+  void operator()(double theta) __qpu__ {
+    cudaq::qvector q(4);
+    x(q[0]);
+    x(q[2]);
+    rx(M_PI_2, q[0]);
+    h(q[1]);
+    h(q[2]);
+    h(q[3]);
+    x<cudaq::ctrl>(q[0], q[1]);
+    x<cudaq::ctrl>(q[1], q[2]);
+    x<cudaq::ctrl>(q[2], q[3]);
+    rz(theta, q[3]);
+    x<cudaq::ctrl>(q[2], q[3]);
+    x<cudaq::ctrl>(q[1], q[2]);
+    x<cudaq::ctrl>(q[0], q[1]);
+    h(q[3]);
+    h(q[2]);
+    h(q[1]);
+    rx(-M_PI_2, q[0]);
+  }
+};
+
+// The kernel defined by `ansatz_compute_action` is
+// equivalent to the one defined in `ansatz_handcoded`.
+struct ansatz_compute_action {
+  void operator()(std::vector<double> theta) __qpu__ {
+    cudaq::qvector q(4);
+    x(q[0]);
+    x(q[2]);
+
+    cudaq::compute_action(
+        [&]() {
+          rx(M_PI_2, q[0]);
+          h(q[1]);
+          h(q[2]);
+          h(q[3]);
+          x<cudaq::ctrl>(q[0], q[1]);
+          x<cudaq::ctrl>(q[1], q[2]);
+          x<cudaq::ctrl>(q[2], q[3]);
+        },
+        [&]() { rz(theta[0], q[3]); });
+  }
+};
+
+int main(int argc, char **argv) {
+
+  std::vector<double> h2_data{0, 0, 0, 0, -0.10647701149499994, 0.0,
+                              1, 1, 1, 1, 0.0454063328691,      0.0,
+                              1, 1, 3, 3, 0.0454063328691,      0.0,
+                              3, 3, 1, 1, 0.0454063328691,      0.0,
+                              3, 3, 3, 3, 0.0454063328691,      0.0,
+                              2, 0, 0, 0, 0.170280101353,       0.0,
+                              2, 2, 0, 0, 0.120200490713,       0.0,
+                              2, 0, 2, 0, 0.168335986252,       0.0,
+                              2, 0, 0, 2, 0.165606823582,       0.0,
+                              0, 2, 0, 0, -0.22004130022499996, 0.0,
+                              0, 2, 2, 0, 0.165606823582,       0.0,
+                              0, 2, 0, 2, 0.174072892497,       0.0,
+                              0, 0, 2, 0, 0.17028010135300004,  0.0,
+                              0, 0, 2, 2, 0.120200490713,       0.0,
+                              0, 0, 0, 2, -0.22004130022499999, 0.0,
+                              15};
+  cudaq::spin_op H(h2_data, /*nQubits*/ 4);
+
+  const auto param_space = cudaq::linspace(-M_PI, M_PI, 10);
+  printf("Using the hand-coded kernel\n");
+  for (const auto &param : param_space) {
+    // `E(params...) = <psi(params...) | H | psi(params...)>`
+    double energy_at_param = cudaq::observe(ansatz_handcoded{}, H, param);
+    printf("<H>(%lf) = %lf\n", param, energy_at_param);
+  }
+
+  printf("Using the kernel written with cudaq::compute_action\n");
+  for (const auto &param : param_space) {
+    // `E(params...) = <psi(params...) | H | psi(params...)>`
+    double energy_at_param =
+        cudaq::observe(ansatz_compute_action{}, H, std::vector<double>{param});
+    printf("<H>(%lf) = %lf\n", param, energy_at_param);
+  }
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/distributed/mpi.cpp b/pr-2241/sphinx/examples/cpp/other/distributed/mpi.cpp
new file mode 100644
index 0000000000..d786fd9d2b
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/distributed/mpi.cpp
@@ -0,0 +1,68 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ mpi.cpp -DCUDAQ_ENABLE_MPI_EXAMPLE=1 -o mpi.x && mpiexec -np 4 ./mpi.x
+// ```
+
+// This example demonstrates CUDA-Q MPI support.
+
+#ifndef CUDAQ_ENABLE_MPI_EXAMPLE
+#define CUDAQ_ENABLE_MPI_EXAMPLE 0
+#endif
+
+#include <cudaq.h>
+
+int main(int argc, char **argv) {
+#if CUDAQ_ENABLE_MPI_EXAMPLE == 0
+  return 0;
+#else
+  // Initialize MPI
+  cudaq::mpi::initialize();
+
+  if (cudaq::mpi::rank() == 0)
+    printf("Running MPI example with %d processes.\n", cudaq::mpi::num_ranks());
+
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+  auto ansatz = [](double theta) __qpu__ {
+    cudaq::qubit q, r;
+    x(q);
+    ry(theta, r);
+    x<cudaq::ctrl>(r, q);
+  };
+
+  // In addition to the built-in `MQPU` platform, users can construct MPI
+  // application directly using CUDA-Q MPI support.
+  const auto allParams =
+      cudaq::random_vector(-M_PI, M_PI, cudaq::mpi::num_ranks());
+
+  // For example, each MPI process can run `cudaq::observe` for a different
+  // parameter.
+  const double rankParam = allParams[cudaq::mpi::rank()];
+  const double rankResult = cudaq::observe(ansatz, h, rankParam);
+  printf("[Process %d]: Energy(%lf) = %lf.\n", cudaq::mpi::rank(), rankParam,
+         rankResult);
+  // Then, using `cudaq::mpi::all_gather` to collect all the results.
+  std::vector<double> gatherData(cudaq::mpi::num_ranks());
+  cudaq::mpi::all_gather(gatherData, {rankResult});
+  if (cudaq::mpi::rank() == 0) {
+    printf("Gathered data from all ranks: \n");
+    for (const auto &x : gatherData)
+      printf("%lf\n", x);
+  }
+
+  // Verify that the data has been assembled as expected.
+  if (std::abs(gatherData[cudaq::mpi::rank()] - rankResult) > 1e-12)
+    return -1;
+  cudaq::mpi::finalize();
+  return 0;
+#endif
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/gradients.cpp b/pr-2241/sphinx/examples/cpp/other/gradients.cpp
new file mode 100644
index 0000000000..ad910ec6a8
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/gradients.cpp
@@ -0,0 +1,86 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ gradients.cpp -o gs.x && ./gs.x
+// ```
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+
+struct deuteron_n3_ansatz {
+  void operator()(double x0, double x1) __qpu__ {
+    cudaq::qvector q(3);
+    x(q[0]);
+    ry(x0, q[1]);
+    ry(x1, q[2]);
+    x<cudaq::ctrl>(q[2], q[0]);
+    x<cudaq::ctrl>(q[0], q[1]);
+    ry(-x0, q[1]);
+    x<cudaq::ctrl>(q[0], q[1]);
+    x<cudaq::ctrl>(q[1], q[0]);
+  }
+};
+
+int main() {
+  using namespace cudaq::spin;
+
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+  cudaq::spin_op h3 = h + 9.625 - 9.625 * z(2) - 3.913119 * x(1) * x(2) -
+                      3.913119 * y(1) * y(2);
+
+  // Default here is COBYLA
+  // Should see many more iterations
+  printf("Optimize with no gradients.\n");
+  cudaq::optimizers::cobyla optimizer;
+  auto [opt_val, opt_params] = optimizer.optimize(
+      2, [&](const std::vector<double> &x, std::vector<double> &grad_vec) {
+        double e = cudaq::observe(deuteron_n3_ansatz{}, h3, x[0], x[1]);
+        printf("<H>(%lf, %lf) = %lf\n", x[0], x[1], e);
+        return e;
+      });
+
+  auto argMapper = [](std::vector<double> x) {
+    return std::make_tuple(x[0], x[1]);
+  };
+
+  // Change the default to L-BFGS which requires gradient calculation
+  // Should see fewer iterations
+  printf("\nOptimize with gradients.\n");
+  cudaq::gradients::parameter_shift gradient(deuteron_n3_ansatz{}, argMapper);
+  gradient.shiftScalar = 1e-1;
+  cudaq::optimizers::lbfgs optimizer_lbfgs;
+  optimizer_lbfgs.max_line_search_trials = 10;
+  auto [opt_val2, opt_params2] = optimizer_lbfgs.optimize(
+      2, [&](const std::vector<double> &x, std::vector<double> &grad_vec) {
+        double e = cudaq::observe(deuteron_n3_ansatz{}, h3, x[0], x[1]);
+        gradient.compute(x, grad_vec, h3, e);
+        printf("<H>(%lf, %lf) = %lf\n", x[0], x[1], e);
+        return e;
+      });
+
+  printf("\nOptimize with gradients, change a few options.\n");
+  cudaq::gradients::central_difference gradient2(deuteron_n3_ansatz{},
+                                                 argMapper);
+  optimizer_lbfgs.initial_parameters = std::vector<double>{.1, .1};
+  optimizer_lbfgs.max_eval = 10;
+  auto [opt_val3, optp3] = optimizer_lbfgs.optimize(
+      2, [&](const std::vector<double> &x, std::vector<double> &grad_vec) {
+        double e = cudaq::observe(deuteron_n3_ansatz{}, h3, x[0], x[1]);
+        gradient2.compute(x, grad_vec, h3, e);
+        printf("<H>(%lf, %lf) = %lf\n", x[0], x[1], e);
+        return e;
+      });
+
+  printf("Opt loop found %lf at [%lf, %lf]\n", opt_val3, optp3[0], optp3[1]);
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/iterative_qpe.cpp b/pr-2241/sphinx/examples/cpp/other/iterative_qpe.cpp
new file mode 100644
index 0000000000..86653b3514
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/iterative_qpe.cpp
@@ -0,0 +1,76 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// [Begin Documentation]
+// Compile and run with:
+// ```
+// nvq++ iterative_qpe.cpp -o qpe.x && ./qpe.x
+// ```
+
+#include <cudaq.h>
+
+struct iqpe {
+  void operator()() __qpu__ {
+    cudaq::qarray<2> q;
+    h(q[0]);
+    x(q[1]);
+    for (int i = 0; i < 8; i++)
+      r1<cudaq::ctrl>(-5 * M_PI / 8., q[0], q[1]);
+
+    h(q[0]);
+    auto cr0 = mz(q[0]);
+    reset(q[0]);
+
+    h(q[0]);
+    for (int i = 0; i < 4; i++)
+      r1<cudaq::ctrl>(-5 * M_PI / 8., q[0], q[1]);
+
+    if (cr0)
+      rz(-M_PI / 2., q[0]);
+
+    h(q[0]);
+    auto cr1 = mz(q[0]);
+    reset(q[0]);
+
+    h(q[0]);
+    for (int i = 0; i < 2; i++)
+      r1<cudaq::ctrl>(-5 * M_PI / 8., q[0], q[1]);
+
+    if (cr0)
+      rz(-M_PI / 4., q[0]);
+
+    if (cr1)
+      rz(-M_PI / 2., q[0]);
+
+    h(q[0]);
+    auto cr2 = mz(q[0]);
+    reset(q[0]);
+    h(q[0]);
+    r1<cudaq::ctrl>(-5 * M_PI / 8., q[0], q[1]);
+
+    if (cr0)
+      rz(-M_PI / 8., q[0]);
+
+    if (cr1)
+      rz(-M_PI_4, q[0]);
+
+    if (cr2)
+      rz(-M_PI_2, q[0]);
+
+    h(q[0]);
+    mz(q[0]);
+  }
+};
+
+int main() {
+  auto counts = cudaq::sample(/*shots*/ 10, iqpe{});
+  counts.dump();
+
+  return 0;
+}
+// [End Documentation]
diff --git a/pr-2241/sphinx/examples/cpp/other/random_walk_qpe.cpp b/pr-2241/sphinx/examples/cpp/other/random_walk_qpe.cpp
new file mode 100644
index 0000000000..f3d1d26ebb
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/random_walk_qpe.cpp
@@ -0,0 +1,61 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ random_walk_qpe.cpp -o qpe.x && ./qpe.x
+// ```
+
+#include <cudaq.h>
+
+// Here we demonstrate an algorithm expressed as a CUDA-Q kernel
+// that incorporates non-trivial control flow and conditional
+// quantum instruction invocation.
+
+struct rwpe {
+  double operator()(const int n_iter, double mu, double sigma) __qpu__ {
+    int iteration = 0;
+
+    // Allocate the qubits
+    cudaq::qvector q(2);
+
+    // Alias them
+    auto &aux = q.front();
+    auto &target = q.back();
+
+    x(q[1]);
+
+    while (iteration < n_iter) {
+      h(aux);
+      rz(1.0 - (mu / sigma), aux);
+      rz(.25 / sigma, target);
+      x<cudaq::ctrl>(aux, target);
+      rz(-.25 / sigma, target);
+      x<cudaq::ctrl>(aux, target);
+      h(aux);
+      if (mz(aux)) {
+        x(aux);
+        mu += sigma * .6065;
+      } else {
+        mu -= sigma * .6065;
+      }
+
+      sigma *= .7951;
+      iteration += 1;
+    }
+
+    return 2. * mu;
+  }
+};
+
+int main() {
+  int n_iterations = 24;
+  double mu = 0.7951, sigma = 0.6065;
+  auto phase = rwpe{}(n_iterations, mu, sigma);
+  printf("Phase = %lf\n", phase);
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/remote_sim/simple.cpp b/pr-2241/sphinx/examples/cpp/other/remote_sim/simple.cpp
new file mode 100644
index 0000000000..30492c7d50
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/remote_sim/simple.cpp
@@ -0,0 +1,45 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// clang-format off
+// ```
+//  nvq++ --target remote-mqpu --remote-mqpu-auto-launch 1 simple.cpp -o simple.x &&
+// ./simple.x
+// ```
+// clang-format on
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+
+// The example here shows a simple use case for the remote simulator platform
+// (`remote-mqpu`). Please refer to the documentation for more information about
+// its features and command line options.
+
+int main() {
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+
+  auto [ansatz, theta] = cudaq::make_kernel<double>();
+  // Allocate some qubits
+  auto q = ansatz.qalloc(2);
+  // Build up the circuit, use the acquired parameter
+  ansatz.x(q[0]);
+  ansatz.ry(theta, q[1]);
+  ansatz.x<cudaq::ctrl>(q[1], q[0]);
+
+  // Observe takes the kernel, the spin_op, and the concrete
+  // parameters for the kernel.
+  // This will be delegated to the remote simulator via HTTP requests.
+  // Use `export CUDAQ_LOG_LEVEL=info` to inspect the server-client
+  // communication.
+  double energy = cudaq::observe(ansatz, h, .59);
+  printf("Energy is %lf\n", energy);
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/other/trotter_kernel_mode.cpp b/pr-2241/sphinx/examples/cpp/other/trotter_kernel_mode.cpp
new file mode 100644
index 0000000000..8edda798e1
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/other/trotter_kernel_mode.cpp
@@ -0,0 +1,162 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ --enable-mlir -v trotter_kernel_mode.cpp -o trotter.x && ./trotter.x
+// ```
+
+#include <complex>
+#include <cudaq.h>
+#include <iostream>
+#include <string>
+
+// Compute magnetization using Suzuki-Trotter approximation.
+// This example demonstrates usage of quantum states in kernel mode.
+//
+// Details
+// https://pubs.aip.org/aip/jmp/article-abstract/32/2/400/229229/General-theory-of-fractal-path-integrals-with
+//
+// Hamiltonian used
+// https://en.m.wikipedia.org/wiki/Quantum_Heisenberg_model
+
+// If you have a NVIDIA GPU you can use this example to see
+// that the GPU-accelerated backends can easily handle a
+// larger number of qubits compared the CPU-only backend.
+//
+// Depending on the available memory on your GPU, you can
+// set the number of qubits to around 30 qubits, and run
+// the execution command with `-target nvidia` option.
+//
+// Note: Without setting the target to the `nvidia` backend,
+// there will be a noticeable decrease in simulation performance.
+// This is because the CPU-only backend has difficulty handling
+// 30+ qubit simulations.
+
+int SPINS = 11; // set to around 25 qubits for `nvidia` target
+int STEPS = 10; // set to around 100 for `nvidia` target
+
+// Compile and run with:
+// clang-format off
+// ```
+// nvq++ --enable-mlir -v trotter_kernel_mode.cpp -o trotter.x --target nvidia && ./trotter.x
+// ```
+// clang-format off
+
+// Alternating up/down spins
+struct initState {
+  void operator()(int num_spins) __qpu__ {
+    cudaq::qvector q(num_spins);
+    for (int qId = 0; qId < num_spins; qId += 2)
+      x(q[qId]);
+  }
+};
+
+std::vector<double> term_coefficients(cudaq::spin_op op) {
+  std::vector<double> result{};
+  op.for_each_term([&](cudaq::spin_op &term) {
+    const auto coeff = term.get_coefficient().real();
+    result.push_back(coeff);
+  });
+  return result;
+}
+
+std::vector<cudaq::pauli_word> term_words(cudaq::spin_op op) {
+  std::vector<cudaq::pauli_word> result{};
+  op.for_each_term(
+      [&](cudaq::spin_op &term) { result.push_back(term.to_string(false)); });
+  return result;
+}
+
+struct trotter {
+  // Note: This performs a single-step Trotter on top of an initial state, e.g.,
+  // result state of the previous Trotter step.
+  void operator()(cudaq::state *initial_state,
+                  std::vector<double> &coefficients,
+                  std::vector<cudaq::pauli_word> &words, double dt) __qpu__ {
+    cudaq::qvector q(initial_state);
+    for (std::size_t i = 0; i < coefficients.size(); ++i) {
+      cudaq::exp_pauli(coefficients[i] * dt, q, words[i]);
+    }
+  }
+};
+
+int run_steps(int steps, int spins) {
+  const double g = 1.0;
+  const double Jx = 1.0;
+  const double Jy = 1.0;
+  const double Jz = g;
+  const double dt = 0.05;
+  const int n_steps = steps;
+  const int n_spins = spins;
+  const double omega = 2 * M_PI;
+  const auto heisenbergModelHam = [&](double t) -> cudaq::spin_op {
+    cudaq::spin_op tdOp(n_spins);
+    for (int i = 0; i < n_spins - 1; ++i) {
+      tdOp += (Jx * cudaq::spin::x(i) * cudaq::spin::x(i + 1));
+      tdOp += (Jy * cudaq::spin::y(i) * cudaq::spin::y(i + 1));
+      tdOp += (Jz * cudaq::spin::z(i) * cudaq::spin::z(i + 1));
+    }
+    for (int i = 0; i < n_spins; ++i)
+      tdOp += (std::cos(omega * t) * cudaq::spin::x(i));
+    return tdOp;
+  };
+  // Observe the average magnetization of all spins (<Z>)
+  cudaq::spin_op average_magnetization(n_spins);
+  for (int i = 0; i < n_spins; ++i)
+    average_magnetization += ((1.0 / n_spins) * cudaq::spin::z(i));
+  average_magnetization -= 1.0;
+
+  // Run loop
+  auto state = cudaq::get_state(initState{}, n_spins);
+  std::vector<double> expResults;
+  std::vector<double> runtimeMs;
+  for (int i = 0; i < n_steps; ++i) {
+    const auto start = std::chrono::high_resolution_clock::now();
+    auto ham = heisenbergModelHam(i * dt);
+    auto coefficients = term_coefficients(ham);
+    auto words = term_words(ham);
+    auto magnetization_exp_val = cudaq::observe(
+        trotter{}, average_magnetization, &state, coefficients, words, dt);
+    auto result = magnetization_exp_val.expectation();
+    expResults.emplace_back(result);
+    state = cudaq::get_state(trotter{}, &state, coefficients, words, dt);
+    const auto stop = std::chrono::high_resolution_clock::now();
+    auto duration =
+        std::chrono::duration_cast<std::chrono::microseconds>(stop - start);
+    auto timeInSeconds = duration.count() / 1000.0 / 1000.0;
+    runtimeMs.emplace_back(timeInSeconds);
+    std::cout << "Step " << i << ": time [s]: " << timeInSeconds
+              << ", result: " << result << std::endl;
+  }
+  std::cout << std::endl;
+
+  // Print runtimes and results (useful for plotting).
+  std::cout << "Step times [s]: [";
+  for (const auto &x : runtimeMs)
+    std::cout << x << ", ";
+  std::cout << "]" << std::endl;
+
+  std::cout << "Results: [";
+  for (const auto &x : expResults)
+    std::cout << x << ", ";
+  std::cout << "]" << std::endl;
+
+  std::cout << std::endl;
+  return 0;
+}
+
+int main() {
+  const auto start = std::chrono::high_resolution_clock::now();
+  run_steps(STEPS, SPINS);
+  const auto stop = std::chrono::high_resolution_clock::now();
+  auto duration =
+      std::chrono::duration_cast<std::chrono::microseconds>(stop - start);
+  std::cout << "Total running time: " << duration.count() / 1000.0 / 1000.0
+            << "s" << std::endl;
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/ionq.cpp b/pr-2241/sphinx/examples/cpp/providers/ionq.cpp
new file mode 100644
index 0000000000..193daba796
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/ionq.cpp
@@ -0,0 +1,60 @@
+// Compile and run with:
+// ```
+// nvq++ --target ionq ionq.cpp -o out.x && ./out.x
+// ```
+// This will submit the job to the IonQ ideal simulator target (default).
+// Alternatively, we can enable hardware noise model simulation by specifying
+// the `--ionq-noise-model`, e.g.,
+// ```
+// nvq++ --target ionq --ionq-machine simulator --ionq-noise-model aria-1
+// ionq.cpp -o out.x && ./out.x
+// ```
+// where we set the noise model to mimic the 'aria-1' hardware device.
+// Please refer to your IonQ Cloud dashboard for the list of simulator noise
+// models.
+// Note: `--ionq-machine simulator` is  optional since 'simulator' is the
+// default configuration if not provided. Assumes a valid set of credentials
+// have been stored.
+
+#include <cudaq.h>
+#include <fstream>
+
+// Define a simple quantum kernel to execute on IonQ.
+struct ghz {
+  // Maximally entangled state between 5 qubits.
+  auto operator()() __qpu__ {
+    cudaq::qvector q(5);
+    h(q[0]);
+    for (int i = 0; i < 4; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    auto result = mz(q);
+  }
+};
+
+int main() {
+  // Submit to IonQ asynchronously (e.g., continue executing
+  // code in the file until the job has been returned).
+  auto future = cudaq::sample_async(ghz{});
+  // ... classical code to execute in the meantime ...
+
+  // Can write the future to file:
+  {
+    std::ofstream out("saveMe.json");
+    out << future;
+  }
+
+  // Then come back and read it in later.
+  cudaq::async_result<cudaq::sample_result> readIn;
+  std::ifstream in("saveMe.json");
+  in >> readIn;
+
+  // Get the results of the read in future.
+  auto async_counts = readIn.get();
+  async_counts.dump();
+
+  // OR: Submit to IonQ synchronously (e.g., wait for the job
+  // result to be returned before proceeding).
+  auto counts = cudaq::sample(ghz{});
+  counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/iqm.cpp b/pr-2241/sphinx/examples/cpp/providers/iqm.cpp
new file mode 100644
index 0000000000..3414bc9260
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/iqm.cpp
@@ -0,0 +1,63 @@
+// Compile and run with:
+// ```
+// nvq++ --target iqm iqm.cpp --iqm-machine Adonis -o out.x && ./out.x
+// ```
+// Assumes a valid set of credentials have been stored.
+
+#include <cudaq.h>
+#include <fstream>
+
+// Define a simple quantum kernel to execute on IQM Server.
+struct adonis_ghz {
+  // Maximally entangled state between 5 qubits on Adonis QPU.
+  //       QB1
+  //        |
+  // QB2 - QB3 - QB4
+  //        |
+  //       QB5
+
+  void operator()() __qpu__ {
+    cudaq::qvector q(5);
+    h(q[0]);
+
+    // Note that the CUDA-Q compiler will automatically generate the
+    // necessary instructions to swap qubits to satisfy the required
+    // connectivity constraints for the Adonis QPU. In this program, that means
+    // that despite QB1 not being physically connected to QB2, the user can
+    // still perform joint operations q[0] and q[1] because the compiler will
+    // automatically (and transparently) inject the necessary swap instructions
+    // to execute the user's program without the user having to worry about the
+    // physical constraints.
+    for (int i = 0; i < 4; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    auto result = mz(q);
+  }
+};
+
+int main() {
+  // Submit to IQM Server asynchronously. E.g, continue executing
+  // code in the file until the job has been returned.
+  auto future = cudaq::sample_async(adonis_ghz{});
+  // ... classical code to execute in the meantime ...
+
+  // Can write the future to file:
+  {
+    std::ofstream out("saveMe.json");
+    out << future;
+  }
+
+  // Then come back and read it in later.
+  cudaq::async_result<cudaq::sample_result> readIn;
+  std::ifstream in("saveMe.json");
+  in >> readIn;
+
+  // Get the results of the read in future.
+  auto async_counts = readIn.get();
+  async_counts.dump();
+
+  // OR: Submit to IQM Server synchronously. E.g, wait for the job
+  // result to be returned before proceeding.
+  auto counts = cudaq::sample(adonis_ghz{});
+  counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/nvqc_qml.cpp b/pr-2241/sphinx/examples/cpp/providers/nvqc_qml.cpp
new file mode 100644
index 0000000000..c6a12d958b
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/nvqc_qml.cpp
@@ -0,0 +1,96 @@
+// Compile and run with:
+// ```
+// nvq++ --target nvqc nvqc_qml.cpp -o out.x
+// ./out.x
+// ```
+// Assumes a valid NVQC API key has been set in the `NVQC_API_KEY` environment
+// variable. Please refer to the documentations for information about how to
+// attain NVQC API key.
+
+// This example demonstrates the simulation of large parameterized quantum
+// circuits with NVQC. These parameterized circuits can be applied to quantum
+// machine learning to classify data points, e.g. see
+// https://arxiv.org/pdf/1906.07682.pdf.
+
+#include <ctime>
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/optimizers.h>
+#include <random>
+
+struct kernel {
+
+  auto operator()(const int n_qubits,
+                  const std::vector<double> parameters) __qpu__ {
+
+    cudaq::qvector qubits(n_qubits);
+    h(qubits);
+
+    for (size_t i = 0; i < n_qubits; i++) {
+      rx(parameters[i], qubits[i]);
+    }
+
+    for (size_t i = 0; i < n_qubits; i++) {
+      ry(parameters[i + n_qubits], qubits[i]);
+    }
+
+    h(qubits);
+
+    for (size_t i = 0; i < n_qubits; i++) {
+      rz(parameters[i + n_qubits * 2], qubits[i]);
+    }
+
+    for (size_t i = 0; i < n_qubits; i += 2) {
+      cx(qubits[i], qubits[i + 1]);
+    }
+
+    for (size_t i = 0; i < n_qubits; i++) {
+      rz(parameters[i + n_qubits * 2], qubits[i]);
+    }
+
+    for (size_t i = 0; i < n_qubits; i += 2) {
+      cy(qubits[i], qubits[i + 1]);
+    }
+
+    for (size_t i = 0; i < n_qubits; i++) {
+      ry(parameters[i + n_qubits], qubits[i]);
+    }
+
+    for (size_t i = 0; i < n_qubits; i += 2) {
+      cz(qubits[i], qubits[i + 1]);
+    }
+
+    x(qubits);
+    y(qubits);
+    h(qubits);
+  }
+};
+
+std::vector<double> initial_parameters(int n_parameters, int seed) {
+
+  std::default_random_engine generator(seed);
+  std::uniform_real_distribution<float> distribution(0.0, 1.0);
+  std::vector<double> parameters(n_parameters);
+
+  for (size_t i = 0; i < n_parameters; i++) {
+    parameters[i] = distribution(generator);
+  }
+  return parameters;
+}
+
+int main() {
+
+  const int n_qubits = 26;
+  const int n_parameters = 3 * n_qubits;
+  std::vector<double> parameters = initial_parameters(n_parameters, 13);
+  auto h = cudaq::spin::z(0);
+
+  auto start = clock();
+  auto exp_val = cudaq::observe(kernel{}, h, n_qubits, parameters);
+  auto end = clock();
+
+  printf("Expectation Value: %f \n", exp_val.expectation());
+  printf("Runtime: %fs \n", float(end - start) / float(CLOCKS_PER_SEC));
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/nvqc_sample.cpp b/pr-2241/sphinx/examples/cpp/providers/nvqc_sample.cpp
new file mode 100644
index 0000000000..4e2aa69b36
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/nvqc_sample.cpp
@@ -0,0 +1,42 @@
+// Compile and run with:
+// ```
+// nvq++ --target nvqc nvqc_sample.cpp -o out.x
+// ./out.x
+// ```
+// Assumes a valid NVQC API key has been set in the `NVQC_API_KEY` environment
+// variable. Please refer to the documentations for information about how to
+// attain NVQC API key.
+
+#include <cudaq.h>
+#include <iostream>
+
+// Define a simple quantum kernel to execute on NVQC.
+struct ghz {
+  // Maximally entangled state between 25 qubits.
+  auto operator()() __qpu__ {
+    constexpr int NUM_QUBITS = 25;
+    cudaq::qvector q(NUM_QUBITS);
+    h(q[0]);
+    for (int i = 0; i < NUM_QUBITS - 1; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    auto result = mz(q);
+  }
+};
+
+int main() {
+  // Submit to NVQC asynchronously (e.g., continue executing
+  // code in the file until the job has been returned).
+  auto async_counts_handle = cudaq::sample_async(ghz{});
+  // ... classical code to execute in the meantime ...
+  std::cout << "Waiting for NVQC result...\n";
+
+  // Calling .get() on the handle to synchronize the result.
+  auto async_counts = async_counts_handle.get();
+  async_counts.dump();
+
+  // OR: Submit to NVQC synchronously (e.g., wait for the job
+  // result to be returned before proceeding).
+  auto counts = cudaq::sample(ghz{});
+  counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/nvqc_state.cpp b/pr-2241/sphinx/examples/cpp/providers/nvqc_state.cpp
new file mode 100644
index 0000000000..d7cb6317f8
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/nvqc_state.cpp
@@ -0,0 +1,25 @@
+// Compile and run with:
+// ```
+// nvq++ --target nvqc --nvqc-backend tensornet nvqc_state.cpp -o out.x
+// ./out.x
+// ```
+// Assumes a valid NVQC API key has been set in the `NVQC_API_KEY` environment
+// variable. Please refer to the documentations for information about how to
+// attain NVQC API key.
+
+#include "cudaq/algorithms/get_state.h"
+#include <cudaq.h>
+#include <iostream>
+
+int main() {
+  auto kernel = cudaq::make_kernel();
+  const std::size_t NUM_QUBITS = 20;
+  auto q = kernel.qalloc(NUM_QUBITS);
+  kernel.h(q[0]);
+  for (std::size_t qId = 0; qId < NUM_QUBITS - 1; ++qId)
+    kernel.x<cudaq::ctrl>(q[qId], q[qId + 1]);
+  auto state = cudaq::get_state(kernel);
+  std::cout << "Amplitude(00..00) = " << state[0] << "\n";
+  std::cout << "Amplitude(11..11) = " << state[(1ULL << NUM_QUBITS) - 1]
+            << "\n";
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/nvqc_vqe.cpp b/pr-2241/sphinx/examples/cpp/providers/nvqc_vqe.cpp
new file mode 100644
index 0000000000..88c32c5051
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/nvqc_vqe.cpp
@@ -0,0 +1,54 @@
+// Compile and run with:
+// ```
+// nvq++ --target nvqc --nvqc-nqpus 3 nvqc_vqe.cpp -o out.x
+// ./out.x
+// ```
+// Note: we set `nqpus` to 3 to establish 3 concurrent NVQC job submission
+// pipes.
+// Assumes a valid NVQC API key has been set in the `NVQC_API_KEY` environment
+// variable. Please refer to the documentations for information about how to
+// attain NVQC API key.
+
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+#include <iostream>
+
+int main() {
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+
+  auto [ansatz, theta] = cudaq::make_kernel<double>();
+  auto q = ansatz.qalloc();
+  auto r = ansatz.qalloc();
+  ansatz.x(q);
+  ansatz.ry(theta, r);
+  ansatz.x<cudaq::ctrl>(r, q);
+
+  // Run VQE with a gradient-based optimizer.
+  // Delegate cost function and gradient computation across different NVQC-based
+  // QPUs. Note: depending on the user's account, there might be different
+  // number of NVQC worker instances available. Hence, although we're making
+  // concurrent job submissions across multiple QPUs, the speedup would be
+  // determined by the number of NVQC worker instances.
+  cudaq::optimizers::lbfgs optimizer;
+  auto [opt_val, opt_params] = optimizer.optimize(
+      /*dim=*/1, /*opt_function*/ [&](const std::vector<double> &params,
+                                      std::vector<double> &grads) {
+        // Queue asynchronous jobs to do energy evaluations across multiple QPUs
+        auto energy_future =
+            cudaq::observe_async(/*qpu_id=*/0, ansatz, h, params[0]);
+        const double paramShift = M_PI_2;
+        auto plus_future = cudaq::observe_async(/*qpu_id=*/1, ansatz, h,
+                                                params[0] + paramShift);
+        auto minus_future = cudaq::observe_async(/*qpu_id=*/2, ansatz, h,
+                                                 params[0] - paramShift);
+        grads[0] = (plus_future.get().expectation() -
+                    minus_future.get().expectation()) /
+                   2.0;
+        return energy_future.get().expectation();
+      });
+  std::cout << "Minimum energy = " << opt_val << " (expected -1.74886).\n";
+}
diff --git a/pr-2241/sphinx/examples/cpp/providers/orca.cpp b/pr-2241/sphinx/examples/cpp/providers/orca.cpp
new file mode 100644
index 0000000000..a23f7aa49e
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/orca.cpp
@@ -0,0 +1,80 @@
+// Compile and run with:
+// ```
+// nvq++ --target orca --orca-url $ORCA_ACCESS_URL orca.cpp -o out.x && ./out.x
+// ```
+// To use the ORCA Computing target you will need to set the ORCA_ACCESS_URL
+// environment variable or pass the URL to the `--orca-url` flag.
+
+#include "cudaq/orca.h"
+#include "cudaq.h"
+
+// define helper function to generate linear spaced vectors
+template <typename T>
+void linear_spaced_vector(std::vector<T> &xs, T min, T max, std::size_t N) {
+  T h = (max - min) / static_cast<T>(N - 1);
+  typename std::vector<T>::iterator x;
+  T val;
+  for (x = xs.begin(), val = min; x != xs.end(); ++x, val += h) {
+    *x = val;
+  }
+}
+
+int main() {
+
+  // A time-bin boson sampling experiment: An input state of 4 indistinguishable
+  // photons mixed with 4 vacuum states across 8 time bins (modes) enter the
+  // time bin interferometer (TBI). The interferometer is composed of two loops
+  // each with a beam splitter (and optionally with a corresponding phase
+  // shifter). Each photon can either be stored in a loop to interfere with the
+  // next photon or exit the loop to be measured. Since there are 8 time bins
+  // and 2 loops, there is a total of 14 beam splitters (and optionally 14 phase
+  // shifters) in the interferometer, which is the number of controllable
+  // parameters.
+
+  // half of 8 time bins is filled with a single photon and the other half is
+  // filled with the vacuum state (empty)
+  std::vector<std::size_t> input_state{1, 0, 1, 0, 1, 0, 1, 0};
+
+  // The time bin interferometer in this example has two loops, each of length 1
+  std::vector<std::size_t> loop_lengths{1, 1};
+
+  // helper variables to calculate the number of beam splitters and phase
+  // shifters needed in the TBI
+  std::size_t sum_loop_lengths{std::accumulate(
+      loop_lengths.begin(), loop_lengths.end(), static_cast<std::size_t>(0))};
+  const std::size_t n_loops = loop_lengths.size();
+  const std::size_t n_modes = input_state.size();
+  const std::size_t n_beam_splitters = n_loops * n_modes - sum_loop_lengths;
+
+  // beam splitter angles (created as a linear spaced vector of angles)
+  std::vector<double> bs_angles(n_beam_splitters);
+  linear_spaced_vector(bs_angles, M_PI / 8, M_PI / 3, n_beam_splitters);
+
+  // Optionally, we can also specify the phase shifter angles (created as a
+  // linear spaced vector of angles), if the system includes phase shifters
+  // ```
+  // std::vector<double> ps_angles(n_beam_splitters);
+  // linear_spaced_vector(ps_angles, M_PI / 6, M_PI / 3, n_beam_splitters);
+  // ```
+
+  // we can also set number of requested samples
+  int n_samples{10000};
+
+  // Submit to ORCA synchronously (e.g., wait for the job result to be returned
+  // before proceeding with the rest of the execution).
+  auto counts =
+      cudaq::orca::sample(input_state, loop_lengths, bs_angles, n_samples);
+
+  // If the system includes phase shifters, the phase shifter angles can be
+  // included in the call
+
+  // ```
+  // auto counts = cudaq::orca::sample(input_state, loop_lengths, bs_angles,
+  //                                   ps_angles, n_samples);
+  // ```
+
+  // Print the results
+  counts.dump();
+
+  return 0;
+}
\ No newline at end of file
diff --git a/pr-2241/sphinx/examples/cpp/providers/photonics.cpp b/pr-2241/sphinx/examples/cpp/providers/photonics.cpp
new file mode 100644
index 0000000000..a25756c7f8
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/photonics.cpp
@@ -0,0 +1,29 @@
+// Compile and run with:
+// ```
+// nvq++ --target photonics photonics.cpp
+// ./a.out
+// ```
+
+#include "cudaq/photonics.h"
+#include "cudaq.h"
+
+struct photonicsKernel {
+  void operator()() __qpu__ {
+    cudaq::qvector<3> qutrits(2);
+    plus(qutrits[0]);
+    plus(qutrits[1]);
+    plus(qutrits[1]);
+    mz(qutrits);
+  }
+};
+
+int main() {
+
+  auto counts = cudaq::sample(photonicsKernel{});
+  for (auto &[k, v] : counts) {
+    printf("Result : Count = %s : %lu\n", k.c_str(), v);
+  }
+
+  auto state = cudaq::get_state(photonicsKernel{});
+  state.dump();
+}
\ No newline at end of file
diff --git a/pr-2241/sphinx/examples/cpp/providers/photonics_tbi.cpp b/pr-2241/sphinx/examples/cpp/providers/photonics_tbi.cpp
new file mode 100644
index 0000000000..1c62cb9cf0
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/photonics_tbi.cpp
@@ -0,0 +1,84 @@
+// Compile and run with:
+// ```
+// nvq++ --target photonics photonics_tbi.cpp -o tbi.x
+// ./tbi.x
+// ```
+
+#include "cudaq.h"
+#include "cudaq/photonics.h"
+
+#include <iostream>
+
+// Global variables
+static const std::size_t one{1};
+
+static constexpr std::size_t n_modes{4};
+static constexpr std::array<std::size_t, n_modes> input_state{2, 1, 3, 1};
+
+static constexpr std::size_t d{
+    std::accumulate(input_state.begin(), input_state.end(), one)};
+
+struct TBI {
+  auto operator()(std::vector<double> const &bs_angles,
+                  std::vector<double> const &ps_angles,
+                  std::vector<std::size_t> const &input_state,
+                  std::vector<std::size_t> const &loop_lengths) __qpu__ {
+    auto n_modes = ::n_modes;
+    const auto d = ::d;
+
+    cudaq::qvector<d> quds(n_modes); // |00...00> d-dimensions
+    for (std::size_t i = 0; i < n_modes; i++) {
+      for (std::size_t j = 0; j < input_state[i]; j++) {
+        plus(quds[i]); // setting to |input_state>
+      }
+    }
+
+    std::size_t c = 0;
+    for (std::size_t ll : loop_lengths) {
+      for (std::size_t i = 0; i < (n_modes - ll); i++) {
+        beam_splitter(quds[i], quds[i + ll], bs_angles[c]);
+        phase_shift(quds[i], ps_angles[c]);
+        c++;
+      }
+    }
+    mz(quds);
+  }
+};
+
+template <typename T>
+void LinearSpacedArray(std::vector<T> &xs, T min, T max, std::size_t N) {
+  T h = (max - min) / static_cast<T>(N - 1);
+  typename std::vector<T>::iterator x;
+  T val;
+  for (x = xs.begin(), val = min; x != xs.end(); ++x, val += h) {
+    *x = val;
+  }
+}
+
+int main() {
+  std::size_t n_loops{2};
+  std::vector<std::size_t> loop_lengths{1, 2};
+  std::vector<std::size_t> input_state(std::begin(::input_state),
+                                       std::end(::input_state));
+
+  const std::size_t zero{0};
+  std::size_t sum_loop_lenghts{
+      std::accumulate(loop_lengths.begin(), loop_lengths.end(), zero)};
+
+  std::size_t n_beam_splitters = n_loops * ::n_modes - sum_loop_lenghts;
+
+  std::vector<double> bs_angles(n_beam_splitters);
+  std::vector<double> ps_angles(n_beam_splitters);
+
+  LinearSpacedArray(bs_angles, M_PI / 3, M_PI / 6, n_beam_splitters);
+  LinearSpacedArray(ps_angles, M_PI / 3, M_PI / 5, n_beam_splitters);
+
+  auto counts = cudaq::sample(1000000, TBI{}, bs_angles, ps_angles, input_state,
+                              loop_lengths);
+
+  for (auto &[k, v] : counts) {
+    std::cout << k << ":" << v << " ";
+  }
+  std::cout << std::endl;
+  return 0;
+}
\ No newline at end of file
diff --git a/pr-2241/sphinx/examples/cpp/providers/quantinuum.cpp b/pr-2241/sphinx/examples/cpp/providers/quantinuum.cpp
new file mode 100644
index 0000000000..63b3eaf905
--- /dev/null
+++ b/pr-2241/sphinx/examples/cpp/providers/quantinuum.cpp
@@ -0,0 +1,51 @@
+// Compile and run with:
+// ```
+// nvq++ --target quantinuum --quantinuum-machine H1-2E quantinuum.cpp -o out.x
+// ./out.x
+// ```
+// Assumes a valid set of credentials have been stored.
+// To first confirm the correctness of the program locally,
+// Add a --emulate to the `nvq++` command above.
+
+#include <cudaq.h>
+#include <fstream>
+
+// Define a simple quantum kernel to execute on Quantinuum.
+struct ghz {
+  // Maximally entangled state between 5 qubits.
+  auto operator()() __qpu__ {
+    cudaq::qvector q(5);
+    h(q[0]);
+    for (int i = 0; i < 4; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    mz(q);
+  }
+};
+
+int main() {
+  // Submit to Quantinuum asynchronously (e.g., continue executing
+  // code in the file until the job has been returned).
+  auto future = cudaq::sample_async(ghz{});
+  // ... classical code to execute in the meantime ...
+
+  // Can write the future to file:
+  {
+    std::ofstream out("saveMe.json");
+    out << future;
+  }
+
+  // Then come back and read it in later.
+  cudaq::async_result<cudaq::sample_result> readIn;
+  std::ifstream in("saveMe.json");
+  in >> readIn;
+
+  // Get the results of the read in future.
+  auto async_counts = readIn.get();
+  async_counts.dump();
+
+  // OR: Submit to Quantinuum synchronously (e.g., wait for the job
+  // result to be returned before proceeding).
+  auto counts = cudaq::sample(ghz{});
+  counts.dump();
+}
diff --git a/pr-2241/sphinx/examples/python/advanced_vqe.py b/pr-2241/sphinx/examples/python/advanced_vqe.py
new file mode 100644
index 0000000000..c76fc7beb7
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/advanced_vqe.py
@@ -0,0 +1,72 @@
+import cudaq
+from cudaq import spin
+
+from typing import List, Tuple
+
+# We will be optimizing over a custom objective function that takes a vector
+# of parameters as input and returns either the cost as a single float,
+# or a tuple of (cost, gradient_vector) depending on the optimizer used.
+
+# In this example, we will use the spin Hamiltonian and ansatz from `simple_vqe.py`
+# and find the `angles` that minimize the expectation value of the system.
+hamiltonian = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+    0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+
+@cudaq.kernel
+def kernel(angles: List[float]):
+    qvector = cudaq.qvector(2)
+    x(qvector[0])
+    ry(angles[0], qvector[1])
+    x.ctrl(qvector[1], qvector[0])
+
+
+# Define the optimizer that we'd like to use.
+optimizer = cudaq.optimizers.Adam()
+
+# Since we'll be using a gradient-based optimizer, we can leverage the
+# CUDA-Q gradient helper class to automatically compute the gradient
+# vector for us. The use of this class for gradient calculations is
+# purely optional and can be replaced with your own custom gradient
+# routine.
+gradient = cudaq.gradients.CentralDifference()
+
+
+def objective_function(parameter_vector: List[float],
+                       hamiltonian=hamiltonian,
+                       gradient_strategy=gradient,
+                       kernel=kernel) -> Tuple[float, List[float]]:
+    """
+    Note: the objective function may also take extra arguments, provided they
+    are passed into the function as default arguments in python.
+    """
+
+    # Call `cudaq.observe` on the spin operator and ansatz at the
+    # optimizer provided parameters. This will allow us to easily
+    # extract the expectation value of the entire system in the
+    # z-basis.
+
+    # We define the call to `cudaq.observe` here as a lambda to
+    # allow it to be passed into the gradient strategy as a
+    # function. If you were using a gradient-free optimizer,
+    # you could purely define `cost = cudaq.observe().expectation()`.
+    get_result = lambda parameter_vector: cudaq.observe(
+        kernel, hamiltonian, parameter_vector).expectation()
+    # `cudaq.observe` returns a `cudaq.ObserveResult` that holds the
+    # counts dictionary and the `expectation`.
+    cost = get_result(parameter_vector)
+    print(f"<H> = {cost}")
+    # Compute the gradient vector using `cudaq.gradients.STRATEGY.compute()`.
+    gradient_vector = gradient_strategy.compute(parameter_vector, get_result,
+                                                cost)
+
+    # Return the (cost, gradient_vector) tuple.
+    return cost, gradient_vector
+
+
+cudaq.set_random_seed(13)  # make repeatable
+energy, parameter = optimizer.optimize(dimensions=1,
+                                       function=objective_function)
+
+print(f"\nminimized <H> = {round(energy,16)}")
+print(f"optimal theta = {round(parameter[0],16)}")
diff --git a/pr-2241/sphinx/examples/python/bernstein_vazirani.py b/pr-2241/sphinx/examples/python/bernstein_vazirani.py
new file mode 100644
index 0000000000..fe82ef4dac
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/bernstein_vazirani.py
@@ -0,0 +1,81 @@
+import cudaq
+import random
+
+from typing import List
+
+
+def random_bits(length: int):
+    bitset = []
+    for _ in range(length):
+        bitset.append(random.randint(0, 1))
+    return bitset
+
+
+# If you have a NVIDIA GPU you can use this example to see
+# that the GPU-accelerated backends can easily handle a
+# larger number of qubits compared the CPU-only backend.
+
+# Depending on the available memory on your GPU, you can
+# set the number of qubits to around 30 qubits, and un-comment
+# the `cudaq.set_target(nvidia)` line.
+
+# Note: Without setting the target to the `nvidia` backend,
+# there will be a noticeable decrease in simulation performance.
+# This is because the CPU-only backend has difficulty handling
+# 30+ qubit simulations.
+
+qubit_count = 5  # set to around 30 qubits for `nvidia` target
+# ```
+# cudaq.set_target("nvidia")
+# ```
+
+# Generate a random, hidden bitstring for the oracle
+# to encode. Note: we define the bitstring here so
+# as to be able to return it for verification.
+hidden_bits = random_bits(qubit_count)
+
+
+@cudaq.kernel
+def oracle(register: cudaq.qview, auxillary_qubit: cudaq.qubit,
+           hidden_bits: List[int]):
+    for index, bit in enumerate(hidden_bits):
+        if bit == 1:
+            # apply a `cx` gate with the current qubit as
+            # the control and the auxillary qubit as the target.
+            x.ctrl(register[index], auxillary_qubit)
+
+
+@cudaq.kernel
+def bernstein_vazirani(hidden_bits: List[int]):
+    # Allocate the specified number of qubits - this
+    # corresponds to the length of the hidden bitstring.
+    qubits = cudaq.qvector(len(hidden_bits))
+    # Allocate an extra auxillary qubit.
+    auxillary_qubit = cudaq.qubit()
+
+    # Prepare the auxillary qubit.
+    h(auxillary_qubit)
+    z(auxillary_qubit)
+
+    # Place the rest of the register in a superposition state.
+    h(qubits)
+
+    # Query the oracle.
+    oracle(qubits, auxillary_qubit, hidden_bits)
+
+    # Apply another set of Hadamards to the register.
+    h(qubits)
+
+    # Apply measurement gates to just the `qubits`
+    # (excludes the auxillary qubit).
+    mz(qubits)
+
+
+print(cudaq.draw(bernstein_vazirani, hidden_bits))
+result = cudaq.sample(bernstein_vazirani, hidden_bits)
+
+print(f"encoded bitstring = {hidden_bits}")
+print(f"measured state = {result.most_probable()}")
+print(
+    f"Were we successful? {''.join([str(i) for i in hidden_bits]) == result.most_probable()}"
+)
diff --git a/pr-2241/sphinx/examples/python/cuquantum_backends.py b/pr-2241/sphinx/examples/python/cuquantum_backends.py
new file mode 100644
index 0000000000..ee678ea1a1
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/cuquantum_backends.py
@@ -0,0 +1,27 @@
+# This example is meant to demonstrate the cuQuantum
+# GPU-accelerated backends and their ability to easily handle
+# a larger number of qubits compared the CPU-only backend.
+#
+# This will take a noticeably longer time to execute on
+# CPU-only backends.
+
+import cudaq
+
+qubit_count = 5
+# We can set a larger `qubit_count` if running on a GPU backend.
+# qubit_count = 28
+
+
+@cudaq.kernel
+def kernel(qubit_count: int):
+    qvector = cudaq.qvector(qubit_count)
+    h(qvector)
+    for qubit in range(qubit_count - 1):
+        x.ctrl(qvector[qubit], qvector[qubit + 1])
+    mz(qvector)
+
+
+result = cudaq.sample(kernel, qubit_count, shots_count=100)
+
+if (not cudaq.mpi.is_initialized()) or (cudaq.mpi.rank() == 0):
+    print(result)
diff --git a/pr-2241/sphinx/examples/python/expectation_values.py b/pr-2241/sphinx/examples/python/expectation_values.py
new file mode 100644
index 0000000000..69ca023b54
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/expectation_values.py
@@ -0,0 +1,23 @@
+# The example here shows a simple use case for the `cudaq::observe``
+# function in computing expected values of provided spin operators.
+
+import cudaq
+from cudaq import spin
+
+
+@cudaq.kernel
+def kernel(theta: float):
+    qvector = cudaq.qvector(2)
+    x(qvector[0])
+    ry(theta, qvector[1])
+    x.ctrl(qvector[1], qvector[0])
+
+
+spin_operator = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+    0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+# Pre-computed angle that minimizes the energy expectation of the `spin_operator`.
+angle = 0.59
+
+energy = cudaq.observe(kernel, spin_operator, angle).expectation()
+print(f"Energy is {energy}")
diff --git a/pr-2241/sphinx/examples/python/intro.py b/pr-2241/sphinx/examples/python/intro.py
new file mode 100644
index 0000000000..68b4b901ab
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/intro.py
@@ -0,0 +1,36 @@
+import cudaq
+
+
+# We begin by defining the `Kernel` that we will construct our
+# program with.
+@cudaq.kernel
+def kernel():
+    '''
+    This is our first CUDA-Q kernel.
+    '''
+    # Next, we can allocate a single qubit to the kernel via `qubit()`.
+    qubit = cudaq.qubit()
+
+    # Now we can begin adding instructions to apply to this qubit!
+    # Here we'll just add every non-parameterized
+    # single qubit gate that is supported by CUDA-Q.
+    h(qubit)
+    x(qubit)
+    y(qubit)
+    z(qubit)
+    t(qubit)
+    s(qubit)
+
+    # Next, we add a measurement to the kernel so that we can sample
+    # the measurement results on our simulator!
+    mz(qubit)
+
+
+# Finally, we can execute this kernel on the state vector simulator
+# by calling `cudaq.sample`. This will execute the provided kernel
+# `shots_count` number of times and return the sampled distribution
+# as a `cudaq.SampleResult` dictionary.
+result = cudaq.sample(kernel)
+
+# Now let's take a look at the `SampleResult` we've gotten back!
+print(result)
diff --git a/pr-2241/sphinx/examples/python/multi_controlled_operations.py b/pr-2241/sphinx/examples/python/multi_controlled_operations.py
new file mode 100644
index 0000000000..053ab2a08a
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/multi_controlled_operations.py
@@ -0,0 +1,42 @@
+import cudaq
+
+# Here we demonstrate how one might apply multi-controlled
+# operations on a general CUDA-Q kernel.
+
+
+# [Begin OptionA]
+# A kernel that performs an X-gate on a provided qubit.
+@cudaq.kernel
+def x_kernel(qubit: cudaq.qubit):
+    x(qubit)
+
+
+# A kernel that will call `x_kernel` as a controlled operation.
+@cudaq.kernel
+def kernel():
+    control_vector = cudaq.qvector(2)
+    target = cudaq.qubit()
+    x(control_vector)
+    x(target)
+    x(control_vector[1])
+    cudaq.control(x_kernel, control_vector, target)
+
+
+results = cudaq.sample(kernel)
+print(results)
+# [End OptionA]
+
+
+# [Begin OptionB]
+@cudaq.kernel
+def kernel():
+    qvector = cudaq.qvector(3)
+    x(qvector)
+    x(qvector[1])
+    x.ctrl([qvector[0], qvector[1]], qvector[2])
+    mz(qvector)
+
+
+results = cudaq.sample(kernel)
+print(results)
+# [End OptionB]
diff --git a/pr-2241/sphinx/examples/python/noise_amplitude_damping.py b/pr-2241/sphinx/examples/python/noise_amplitude_damping.py
new file mode 100644
index 0000000000..f86d7f68ce
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/noise_amplitude_damping.py
@@ -0,0 +1,50 @@
+import cudaq
+
+# Set the target to our density matrix simulator.
+cudaq.set_target('density-matrix-cpu')
+
+# CUDA-Q supports several different models of noise. In this case,
+# we will examine the modeling of energy dissipation within our system
+# via environmental interactions. The result of this "amplitude damping"
+# is to return the qubit to the |0> state with a user-specified probability.
+
+# We will begin by defining an empty noise model that we will add
+# our damping channel to.
+noise = cudaq.NoiseModel()
+
+# We define an amplitude damping channel setting to `1.0` the
+# probability of the qubit
+# decaying to the ground state.
+amplitude_damping = cudaq.AmplitudeDampingChannel(1.0)
+
+# We will apply this channel to any Hadamard gate on the qubit.
+# In other words, after each Hadamard on the qubit, there will be a
+# probability of `1.0` that the qubit decays back to the ground state.
+noise.add_channel('h', [0], amplitude_damping)
+
+
+# Now we define our simple kernel function and allocate a qubit.
+@cudaq.kernel
+def kernel():
+    qubit = cudaq.qubit()
+    # Then we apply a Hadamard gate to the qubit.
+    # This will bring it to `1/sqrt(2) (|0> + |1>)`, where it will remain
+    # with a probability of `1 - p = 0.0`.
+    h(qubit)
+    # Measure.
+    mz(qubit)
+
+
+# Now we're ready to run the noisy simulation of our kernel.
+# Note: We must pass the noise model to sample via keyword.
+noisy_result = cudaq.sample(kernel, noise_model=noise)
+print(noisy_result)
+
+# Our results should show all measurements in the |0> state, indicating
+# that the noise has successfully impacted the system.
+
+# To confirm this, we can run the simulation again without noise.
+# The qubit will now have a 50/50 mix of measurements between
+# |0> and |1>.
+noiseless_result = cudaq.sample(kernel)
+print(noiseless_result)
diff --git a/pr-2241/sphinx/examples/python/noise_bit_flip.py b/pr-2241/sphinx/examples/python/noise_bit_flip.py
new file mode 100644
index 0000000000..556e80f5b1
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/noise_bit_flip.py
@@ -0,0 +1,46 @@
+import cudaq
+
+# Set the target to our density matrix simulator.
+cudaq.set_target('density-matrix-cpu')
+
+# CUDA-Q supports several different models of noise. In this case,
+# we will examine the modeling of decoherence of the qubit state. This
+# will occur from "bit flip" errors, wherein the qubit has a user-specified
+# probability of undergoing an X-180 rotation.
+
+# We will begin by defining an empty noise model that we will add
+# these decoherence channels to.
+noise = cudaq.NoiseModel()
+
+# We define a bit-flip channel setting to `1.0` probability of the
+# qubit flipping 180 degrees about the X axis.
+bit_flip = cudaq.BitFlipChannel(1.0)
+# We will apply this channel to any X gate on the qubit, giving each X-gate
+# a probability of `1.0` of undergoing an extra X-gate.
+noise.add_channel('x', [0], bit_flip)
+
+
+# Now we define our simple kernel function and allocate a register
+# of qubits to it.
+@cudaq.kernel
+def kernel():
+    qubit = cudaq.qubit()
+    # Apply an X-gate to the qubit.
+    # It will remain in the |1> state with a probability of `1 - p = 0.0`.
+    x(qubit)
+    # Measure.
+    mz(qubit)
+
+
+# Now we're ready to run the noisy simulation of our kernel.
+# Note: We must pass the noise model to sample via keyword.
+noisy_result = cudaq.sample(kernel, noise_model=noise)
+print(noisy_result)
+
+# Our results should show all measurements in the |0> state, indicating
+# that the noise has successfully impacted the system.
+
+# To confirm this, we can run the simulation again without noise.
+# We should now see the qubit in the |1> state.
+noiseless_result = cudaq.sample(kernel)
+print(noiseless_result)
diff --git a/pr-2241/sphinx/examples/python/noise_callback.py b/pr-2241/sphinx/examples/python/noise_callback.py
new file mode 100644
index 0000000000..8eba41deeb
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/noise_callback.py
@@ -0,0 +1,45 @@
+import cudaq
+import numpy as np
+
+# Set the target to our density matrix simulator.
+cudaq.set_target('density-matrix-cpu')
+
+noise = cudaq.NoiseModel()
+
+
+# Noise model callback function
+def rx_noise(qubits, params):
+    # Model a pulse-length based rotation gate:
+    # the bigger the angle, the longer the pulse, i.e., more amplitude damping.
+    angle = params[0]
+    angle = angle % (2 * np.pi)
+    # Damping rate is linearly proportional to the angle
+    damping_rate = np.abs(angle / (2 * np.pi))
+    print(f"Angle = {angle}, amplitude damping rate = {damping_rate}.")
+    return cudaq.AmplitudeDampingChannel(damping_rate)
+
+
+# Bind the noise model callback function to the `rx` gate
+noise.add_channel('rx', rx_noise)
+
+
+@cudaq.kernel
+def kernel(angle: float):
+    qubit = cudaq.qubit()
+    rx(angle, qubit)
+    mz(qubit)
+
+
+# Now we're ready to run the noisy simulation of our kernel.
+# Note: We must pass the noise model to sample via keyword.
+noisy_result = cudaq.sample(kernel, np.pi, noise_model=noise)
+print(noisy_result)
+
+# Our results should show measurements in both the |0> and |1> states, indicating
+# that the noise has successfully impacted the system.
+# Note: a `rx(pi)` is equivalent to a Pauli X gate, and thus, it should be
+# in the |1> state if no noise is present.
+
+# To confirm this, we can run the simulation again without noise.
+noiseless_result = cudaq.sample(kernel, np.pi)
+print(noiseless_result)
diff --git a/pr-2241/sphinx/examples/python/noise_depolarization.py b/pr-2241/sphinx/examples/python/noise_depolarization.py
new file mode 100644
index 0000000000..6a9466abfe
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/noise_depolarization.py
@@ -0,0 +1,44 @@
+import cudaq
+
+# Set the target to our density matrix simulator.
+cudaq.set_target('density-matrix-cpu')
+
+# CUDA-Q supports several different models of noise. In this
+# case, we will examine the modeling of depolarization noise. This
+# depolarization will result in the qubit state decaying into a mix
+# of the basis states, |0> and |1>, with a user provided probability.
+
+# We will begin by defining an empty noise model that we will add
+# our depolarization channel to.
+noise = cudaq.NoiseModel()
+
+# We define a depolarization channel setting the probability
+# of the qubit state being scrambled to `1.0`.
+depolarization = cudaq.DepolarizationChannel(1.0)
+
+# We will apply the channel to any Y-gate on qubit 0. In other words,
+# for each Y-gate on our qubit, the qubit will have a `1.0`
+# probability of decaying into a mixed state.
+noise.add_channel('y', [0], depolarization)
+
+
+# Now we define our simple kernel function and allocate
+# a qubit to it.
+@cudaq.kernel
+def kernel():
+    qubit = cudaq.qubit()
+    # First we apply a Y-gate to the qubit.
+    # This will bring it to the |1> state, where it will remain
+    # with a probability of `1 - p = 0.0`.
+    y(qubit)
+    mz(qubit)
+
+
+# Without noise, the qubit should still be in the |1> state.
+counts = cudaq.sample(kernel)
+counts.dump()
+
+# With noise, the measurements should be a roughly 50/50
+# mix between the |0> and |1> states.
+noisy_counts = cudaq.sample(kernel, noise_model=noise)
+noisy_counts.dump()
diff --git a/pr-2241/sphinx/examples/python/noise_kraus_operator.py b/pr-2241/sphinx/examples/python/noise_kraus_operator.py
new file mode 100644
index 0000000000..af4b64e9b8
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/noise_kraus_operator.py
@@ -0,0 +1,62 @@
+import cudaq
+import numpy as np
+
+# Set the target to our density matrix simulator.
+cudaq.set_target('density-matrix-cpu')
+
+# CUDA-Q supports custom noise models through the definition of
+# `KrausChannel`'s. In this case, we will define a set of `KrausOperator`'s
+# that  affect the same noise as the `AmplitudeDampingChannel`. This
+# channel will model the energy dissipation within our system via
+# environmental interactions. With a variable probability, it will
+# return the qubit to the |0> state.
+
+# We will begin by defining an empty noise model that we will add
+# our Kraus Channel to.
+noise = cudaq.NoiseModel()
+
+
+# We will define our Kraus Operators within functions, as to
+# allow for easy control over the noise probability.
+def kraus_operators(probability):
+    """See Nielsen, Chuang Chapter 8.3.5 for definition source."""
+    kraus_0 = np.array([[1, 0], [0, np.sqrt(1 - probability)]],
+                       dtype=np.complex128)
+    kraus_1 = np.array([[0, np.sqrt(probability)], [0, 0]], dtype=np.complex128)
+    return [kraus_0, kraus_1]
+
+
+# We manually define an amplitude damping channel setting to `1.0`
+# the probability of the qubit decaying to the ground state.
+amplitude_damping = cudaq.KrausChannel(kraus_operators(1.0))
+
+# We will apply this channel to any Hadamard gate on the qubit.
+# In other words, after each Hadamard on the qubit, there will be a
+# probability of `1.0` that the qubit decays back to ground.
+noise.add_channel('h', [0], amplitude_damping)
+
+
+@cudaq.kernel
+def kernel():
+    qubit = cudaq.qubit()
+    # Then we apply a Hadamard gate to the qubit.
+    # This will bring it to `1/sqrt(2) (|0> + |1>)`, where it will remain
+    # with a probability of `1 - p = 0.0`.
+    h(qubit)
+    # Measure.
+    mz(qubit)
+
+
+# Now we're ready to run the noisy simulation of our kernel.
+# Note: We must pass the noise model to sample via keyword.
+noisy_result = cudaq.sample(kernel, noise_model=noise)
+print(noisy_result)
+
+# Our results should show all measurements in the |0> state, indicating
+# that the noise has successfully impacted the system.
+
+# To confirm this, we can run the simulation again without noise.
+# The qubit will now have a 50/50 mix of measurements between
+# |0> and |1>.
+noiseless_result = cudaq.sample(kernel)
+print(noiseless_result)
diff --git a/pr-2241/sphinx/examples/python/noise_phase_flip.py b/pr-2241/sphinx/examples/python/noise_phase_flip.py
new file mode 100644
index 0000000000..bac1de3be2
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/noise_phase_flip.py
@@ -0,0 +1,48 @@
+import cudaq
+
+# Set the target to our density matrix simulator.
+cudaq.set_target('density-matrix-cpu')
+
+# CUDA-Q supports several different models of noise. In this
+# case, we will examine the modeling of decoherence of the qubit phase.
+# This will occur from "phase flip" errors, wherein the qubit has a
+# user-specified probability of undergoing a Z-180 rotation.
+
+# We will begin by defining an empty noise model that we will add
+# our phase flip channel to.
+noise = cudaq.NoiseModel()
+
+# We define a phase-flip channel setting to `1.0` the probability of the qubit
+# undergoing a phase rotation of 180 degrees (π).
+phase_flip = cudaq.PhaseFlipChannel(1.0)
+# We will apply this channel to any Z gate on the qubit.
+# In other words, after each Z gate on qubit 0, there will be a
+# probability of `1.0` that the qubit undergoes an extra
+# Z rotation.
+noise.add_channel('z', [0], phase_flip)
+
+
+@cudaq.kernel
+def kernel():
+    # Single qubit initialized to the |0> state.
+    qubit = cudaq.qubit()
+    # Place qubit in superposition state.
+    h(qubit)
+    # Rotate the phase around Z by 180 degrees (π).
+    z(qubit)
+    # Apply another Hadamard and measure.
+    h(qubit)
+    mz(qubit)
+
+
+# Without noise, we'd expect the qubit to end in the |1>
+# state due to the phase rotation between the two Hadamard
+# gates.
+noiseless_result = cudaq.sample(kernel)
+print(noiseless_result)
+
+# With noise, our Z-gate will effectively cancel out due
+# to the presence of a phase flip error on the gate with a
+# probability of `1.0`. This will put us back in the |0> state.
+noisy_result = cudaq.sample(kernel, noise_model=noise)
+print(noisy_result)
diff --git a/pr-2241/sphinx/examples/python/providers/ionq.py b/pr-2241/sphinx/examples/python/providers/ionq.py
new file mode 100644
index 0000000000..ded91bc060
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/ionq.py
@@ -0,0 +1,55 @@
+import cudaq
+
+# You only have to set the target once! No need to redefine it
+# for every execution call on your kernel.
+# To use different targets in the same file, you must update
+# it via another call to `cudaq.set_target()`
+cudaq.set_target("ionq")
+
+
+# Create the kernel we'd like to execute on IonQ.
+@cudaq.kernel
+def kernel():
+    qvector = cudaq.qvector(2)
+    h(qvector[0])
+    x.ctrl(qvector[0], qvector[1])
+
+
+# Note: All qubits will be measured at the end upon performing
+# the sampling. You may encounter a pre-flight error on IonQ
+# backends if you include explicit measurements.
+
+# Execute on IonQ and print out the results.
+
+# Option A:
+# By using the asynchronous `cudaq.sample_async`, the remaining
+# classical code will be executed while the job is being handled
+# by IonQ. This is ideal when submitting via a queue over
+# the cloud.
+async_results = cudaq.sample_async(kernel)
+# ... more classical code to run ...
+
+# We can either retrieve the results later in the program with
+# ```
+# async_counts = async_results.get()
+# ```
+# or we can also write the job reference (`async_results`) to
+# a file and load it later or from a different process.
+file = open("future.txt", "w")
+file.write(str(async_results))
+file.close()
+
+# We can later read the file content and retrieve the job
+# information and results.
+same_file = open("future.txt", "r")
+retrieved_async_results = cudaq.AsyncSampleResult(str(same_file.read()))
+
+counts = retrieved_async_results.get()
+print(counts)
+
+# Option B:
+# By using the synchronous `cudaq.sample`, the execution of
+# any remaining classical code in the file will occur only
+# after the job has been returned from IonQ.
+counts = cudaq.sample(kernel)
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/providers/iqm.py b/pr-2241/sphinx/examples/python/providers/iqm.py
new file mode 100644
index 0000000000..fdf4dadd8f
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/iqm.py
@@ -0,0 +1,61 @@
+import cudaq
+
+# You only have to set the target once! No need to redefine it
+# for every execution call on your kernel.
+# To use different targets in the same file, you must update
+# it via another call to `cudaq.set_target()`
+cudaq.set_target("iqm",
+                 url="http://localhost/cocos",
+                 **{"qpu-architecture": "Adonis"})
+
+# Adonis QPU architecture:
+#       QB1
+#        |
+# QB2 - QB3 - QB4
+#        |
+#       QB5
+
+
+# Create the kernel we'd like to execute on IQM.
+@cudaq.kernel
+def kernel():
+    qvector = cudaq.qvector(5)
+    h(qvector[2])  # QB3
+    x.ctrl(qvector[2], qvector[0])
+    mz(qvector)
+
+
+# Execute on IQM Server and print out the results.
+
+# Option A:
+# By using the asynchronous `cudaq.sample_async`, the remaining
+# classical code will be executed while the job is being handled
+# by IQM Server. This is ideal when submitting via a queue over
+# the cloud.
+async_results = cudaq.sample_async(kernel)
+# ... more classical code to run ...
+
+# We can either retrieve the results later in the program with
+# ```
+# async_counts = async_results.get()
+# ```
+# or we can also write the job reference (`async_results`) to
+# a file and load it later or from a different process.
+file = open("future.txt", "w")
+file.write(str(async_results))
+file.close()
+
+# We can later read the file content and retrieve the job
+# information and results.
+same_file = open("future.txt", "r")
+retrieved_async_results = cudaq.AsyncSampleResult(str(same_file.read()))
+
+counts = retrieved_async_results.get()
+print(counts)
+
+# Option B:
+# By using the synchronous `cudaq.sample`, the execution of
+# any remaining classical code in the file will occur only
+# after the job has been returned from IQM Server.
+counts = cudaq.sample(kernel)
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/providers/nvqc_mgpu.py b/pr-2241/sphinx/examples/python/providers/nvqc_mgpu.py
new file mode 100644
index 0000000000..00b7d806e5
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/nvqc_mgpu.py
@@ -0,0 +1,114 @@
+import argparse
+import cudaq
+import random
+
+# This example assumes the NVQC API key has been set in the `NVQC_API_KEY` environment variable.
+# If not, you can set the API Key environment variable in the Python script with:
+# ```
+# os.environ["NVQC_API_KEY"] = "<YOUR NVQC API KEY>"`
+# ```
+
+
+def random_bitstring(length: int):
+    bitstring = ""
+    for bit in range(length):
+        bitstring += str(random.randint(0, 1))
+    return bitstring
+
+
+def oracle(kernel: cudaq.Kernel, register: cudaq.QuakeValue,
+           auxillary_qubit: cudaq.QuakeValue, hidden_bitstring: str):
+    """
+    The inner-product oracle for the Bernstein-Vazirani algorithm.
+    """
+    for index, bit in enumerate(hidden_bitstring):
+        if bit == "0":
+            # Apply identity operation to the qubit if it's
+            # in the 0-state.
+            # In this case, we do nothing.
+            pass
+        else:
+            # Otherwise, apply a `cx` gate with the current qubit as
+            # the control and the auxillary qubit as the target.
+            kernel.cx(control=register[index], target=auxillary_qubit)
+
+
+def bernstein_vazirani(qubit_count: int):
+    """
+    Returns a kernel implementing the Bernstein-Vazirani algorithm
+    for a random, hidden bitstring.
+    """
+    kernel = cudaq.make_kernel()
+    # Allocate the specified number of qubits - this
+    # corresponds to the length of the hidden bitstring.
+    qubits = kernel.qalloc(qubit_count)
+    # Allocate an extra auxillary qubit.
+    auxillary_qubit = kernel.qalloc()
+
+    # Prepare the auxillary qubit.
+    kernel.h(auxillary_qubit)
+    kernel.z(auxillary_qubit)
+
+    # Place the rest of the register in a superposition state.
+    kernel.h(qubits)
+
+    # Generate a random, hidden bitstring for the oracle
+    # to encode. Note: we define the bitstring here so
+    # as to be able to return it for verification.
+    hidden_bitstring = random_bitstring(qubit_count)
+
+    # Query the oracle.
+    oracle(kernel, qubits, auxillary_qubit, hidden_bitstring)
+
+    # Apply another set of Hadamards to the register.
+    kernel.h(qubits)
+
+    # Apply measurement gates to just the `qubits`
+    # (excludes the auxillary qubit).
+    kernel.mz(qubits)
+    return kernel, hidden_bitstring
+
+
+# This example demonstrated GPU-accelerated simulator backends on NVQC can easily handle a large number of qubits.
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        prog='python',
+        description='Run a Bernstein-Vazirani algorithm using NVQC.',
+        epilog=
+        'For more information about CUDA-Q, see https://nvidia.github.io/cuda-quantum'
+    )
+    parser.add_argument('--size',
+                        type=int,
+                        required=False,
+                        default=30,
+                        help='The number of bits in the secret string.')
+    parser.add_argument('--ngpus',
+                        type=int,
+                        required=False,
+                        default=1,
+                        help='The number of NVQC GPUs to run the simulation.')
+    parser.add_argument('--seed',
+                        type=int,
+                        required=False,
+                        default=0,
+                        help='The random seed to generate the secret string.')
+    args = parser.parse_args()
+
+    # Depending on the number of GPUs requested, you can
+    # set the size of the secret string to around 31-34 (total qubit count = string length + 1) when
+    # you pass the `--ngpus` as a command line argument.
+    qubit_count = args.size
+    if args.seed != 0:
+        random.seed(args.seed)
+
+    cudaq.set_target("nvqc", backend="nvidia-mgpu", ngpus=args.ngpus)
+
+    print(
+        f"Running on NVQC using 'nvidia-mgpu' simulator backend with {args.ngpus} GPU(s) ..."
+    )
+    kernel, hidden_bitstring = bernstein_vazirani(qubit_count)
+    result = cudaq.sample(kernel)
+
+    print(f"encoded bitstring = {hidden_bitstring}")
+    print(f"measured state = {result.most_probable()}")
+    print(f"Were we successful? {hidden_bitstring == result.most_probable()}")
diff --git a/pr-2241/sphinx/examples/python/providers/nvqc_sample.py b/pr-2241/sphinx/examples/python/providers/nvqc_sample.py
new file mode 100644
index 0000000000..55c11b4f1f
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/nvqc_sample.py
@@ -0,0 +1,26 @@
+import cudaq
+
+# This example assumes the NVQC API key has been set in the `NVQC_API_KEY` environment variable.
+# If not, you can set the API Key environment variable in the Python script with:
+# ```
+# os.environ["NVQC_API_KEY"] = "<YOUR NVQC API KEY>"`
+# ```
+cudaq.set_target("nvqc", backend="tensornet")
+
+# Note: The `tensornet` simulator is capable of distributing tensor contraction operations across multiple GPUs.
+# User can use the `ngpus` option to target a multi-GPU NVQC endpoint.
+# For example, to use the `tensornet` simulator with 8 GPUs, we can do
+# `cudaq.set_target("nvqc", backend="tensornet", ngpus=8)`
+# Please refer to your NVQC dashboard for the list of available multi-GPU configurations.
+num_qubits = 50
+kernel = cudaq.make_kernel()
+qubits = kernel.qalloc(num_qubits)
+# Place qubits in superposition state.
+kernel.h(qubits[0])
+for i in range(num_qubits - 1):
+    kernel.cx(qubits[i], qubits[i + 1])
+# Measure.
+kernel.mz(qubits)
+
+counts = cudaq.sample(kernel, shots_count=100)
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/providers/nvqc_state.py b/pr-2241/sphinx/examples/python/providers/nvqc_state.py
new file mode 100644
index 0000000000..eae5c42339
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/nvqc_state.py
@@ -0,0 +1,21 @@
+import cudaq
+
+# This example assumes the NVQC API key has been set in the `NVQC_API_KEY` environment variable.
+# If not, you can set the API Key environment variable in the Python script with:
+# ```
+# os.environ["NVQC_API_KEY"] = "<YOUR NVQC API KEY>"`
+# ```
+
+cudaq.set_target("nvqc")
+
+num_qubits = 20
+kernel = cudaq.make_kernel()
+qubits = kernel.qalloc(num_qubits)
+# Place qubits in GHZ state.
+kernel.h(qubits[0])
+for i in range(num_qubits - 1):
+    kernel.cx(qubits[i], qubits[i + 1])
+
+state = cudaq.get_state(kernel)
+print("Amplitude(00..00) =", state[0])
+print("Amplitude(11..11) =", state[2**num_qubits - 1])
diff --git a/pr-2241/sphinx/examples/python/providers/nvqc_vqe.py b/pr-2241/sphinx/examples/python/providers/nvqc_vqe.py
new file mode 100644
index 0000000000..da90150a6e
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/nvqc_vqe.py
@@ -0,0 +1,59 @@
+import cudaq
+from cudaq import spin
+import math
+
+# This example assumes the NVQC API key has been set in the `NVQC_API_KEY` environment variable.
+# If not, you can set the API Key environment variable in the Python script with:
+# ```
+# os.environ["NVQC_API_KEY"] = "<YOUR NVQC API KEY>"`
+# ```
+
+cudaq.set_target("nvqc", nqpus=3)
+
+print("Number of QPUs:", cudaq.get_target().num_qpus())
+
+
+# Note: depending on the user's account, there might be different
+# number of NVQC worker instances available. Hence, although we're making
+# concurrent job submissions across multiple QPUs, the speedup would be
+# determined by the number of NVQC worker instances.
+# Create the parameterized ansatz
+@cudaq.kernel
+def ansatz(theta: float):
+    qvector = cudaq.qvector(2)
+    x(qvector[0])
+    ry(theta, qvector[1])
+    x.ctrl(qvector[1], qvector[0])
+
+
+# Define its spin Hamiltonian.
+hamiltonian = (5.907 - 2.1433 * spin.x(0) * spin.x(1) -
+               2.1433 * spin.y(0) * spin.y(1) + 0.21829 * spin.z(0) -
+               6.125 * spin.z(1))
+
+
+def opt_gradient(parameter_vector):
+    # Evaluate energy and gradient on different remote QPUs
+    # (i.e., concurrent job submissions to NVQC)
+    energy_future = cudaq.observe_async(ansatz,
+                                        hamiltonian,
+                                        parameter_vector[0],
+                                        qpu_id=0)
+    plus_future = cudaq.observe_async(ansatz,
+                                      hamiltonian,
+                                      parameter_vector[0] + 0.5 * math.pi,
+                                      qpu_id=1)
+    minus_future = cudaq.observe_async(ansatz,
+                                       hamiltonian,
+                                       parameter_vector[0] - 0.5 * math.pi,
+                                       qpu_id=2)
+    return (energy_future.get().expectation(), [
+        (plus_future.get().expectation() - minus_future.get().expectation()) /
+        2.0
+    ])
+
+
+optimizer = cudaq.optimizers.LBFGS()
+optimal_value, optimal_parameters = optimizer.optimize(1, opt_gradient)
+print("Ground state energy =", optimal_value)
+print("Optimal parameters =", optimal_parameters)
diff --git a/pr-2241/sphinx/examples/python/providers/oqc.py b/pr-2241/sphinx/examples/python/providers/oqc.py
new file mode 100644
index 0000000000..d333746b05
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/oqc.py
@@ -0,0 +1,57 @@
+import cudaq
+
+# You only have to set the target once! No need to redefine it
+# for every execution call on your kernel.
+# To use different targets in the same file, you must update
+# it via another call to `cudaq.set_target()`
+
+# To use the OQC target you will need to set the following environment variables
+# OQC_URL
+# OQC_EMAIL
+# OQC_PASSWORD
+# To setup an account, contact oqc_qcaas_support@oxfordquantumcircuits.com
+
+cudaq.set_target("oqc")
+
+
+# Create the kernel we'd like to execute on OQC.
+@cudaq.kernel
+def kernel():
+    qvector = cudaq.qvector(2)
+    h(qvector[0])
+    x.ctrl[qvector[1], qvector[1]]
+    mz(qvector)
+
+
+# Option A:
+# By using the asynchronous `cudaq.sample_async`, the remaining
+# classical code will be executed while the job is being handled
+# by OQC. This is ideal when submitting via a queue over
+# the cloud.
+async_results = cudaq.sample_async(kernel)
+# ... more classical code to run ...
+
+# We can either retrieve the results later in the program with
+# ```
+# async_counts = async_results.get()
+# ```
+# or we can also write the job reference (`async_results`) to
+# a file and load it later or from a different process.
+file = open("future.txt", "w")
+file.write(str(async_results))
+file.close()
+
+# We can later read the file content and retrieve the job
+# information and results.
+same_file = open("future.txt", "r")
+retrieved_async_results = cudaq.AsyncSampleResult(str(same_file.read()))
+
+counts = retrieved_async_results.get()
+print(counts)
+
+# Option B:
+# By using the synchronous `cudaq.sample`, the execution of
+# any remaining classical code in the file will occur only
+# after the job has been returned from OQC.
+counts = cudaq.sample(kernel)
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/providers/orca.py b/pr-2241/sphinx/examples/python/providers/orca.py
new file mode 100644
index 0000000000..5f91aad305
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/orca.py
@@ -0,0 +1,61 @@
+import cudaq
+
+import numpy as np
+import os
+# You only have to set the target once! No need to redefine it
+# for every execution call on your kernel.
+# To use different targets in the same file, you must update
+# it via another call to `cudaq.set_target()`
+
+# To use the ORCA Computing target you will need to set the ORCA_ACCESS_URL
+# environment variable or pass a URL.
+orca_url = os.getenv("ORCA_ACCESS_URL", "http://localhost/sample")
+
+cudaq.set_target("orca", url=orca_url)
+
+# A time-bin boson sampling experiment: An input state of 4 indistinguishable
+# photons mixed with 4 vacuum states across 8 time bins (modes) enter the
+# time bin interferometer (TBI). The interferometer is composed of two loops
+# each with a beam splitter (and optionally with a corresponding phase
+# shifter). Each photon can either be stored in a loop to interfere with the
+# next photon or exit the loop to be measured. Since there are 8 time bins
+# and 2 loops, there is a total of 14 beam splitters (and optionally 14 phase
+# shifters) in the interferometer, which is the number of controllable
+# parameters.
+
+# half of 8 time bins is filled with a single photon and the other half is
+# filled with the vacuum state (empty)
+input_state = [1, 0, 1, 0, 1, 0, 1, 0]
+
+# The time bin interferometer in this example has two loops, each of length 1
+loop_lengths = [1, 1]
+
+# Calculate the number of beam splitters and phase shifters
+n_beam_splitters = len(loop_lengths) * len(input_state) - sum(loop_lengths)
+
+# beam splitter angles
+bs_angles = np.linspace(np.pi / 8, np.pi / 3, n_beam_splitters)
+
+# Optionally, we can also specify the phase shifter angles, if the system
+# includes phase shifters
+# ```
+# ps_angles = np.linspace(np.pi / 6, np.pi / 3, n_beam_splitters)
+# ```
+
+# we can also set number of requested samples
+n_samples = 10000
+
+# By using the synchronous `cudaq.orca.sample`, the execution of
+# any remaining classical code in the file will occur only
+# after the job has been returned from ORCA Server.
+counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles, n_samples)
+
+# If the system includes phase shifters, the phase shifter angles can be
+# included in the call
+# ```
+# counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles, ps_angles,
+#                            n_samples)
+# ```
+
+# Print the results
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/providers/photonics.py b/pr-2241/sphinx/examples/python/providers/photonics.py
new file mode 100644
index 0000000000..0bc171cb21
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/photonics.py
@@ -0,0 +1,19 @@
+import cudaq
+
+cudaq.set_target("photonics")
+
+
+@cudaq.kernel
+def photonicsKernel():
+    qutrits = [qudit(3) for _ in range(2)]
+    plus(qutrits[0])
+    plus(qutrits[1])
+    plus(qutrits[1])
+    mz(qutrits)
+
+
+counts = cudaq.sample(photonicsKernel)
+print(counts)
+
+state = cudaq.get_state(photonicsKernel)
+print(state)
diff --git a/pr-2241/sphinx/examples/python/providers/photonics_tbi.py b/pr-2241/sphinx/examples/python/providers/photonics_tbi.py
new file mode 100644
index 0000000000..0f31de03f5
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/photonics_tbi.py
@@ -0,0 +1,48 @@
+import cudaq
+import numpy as np
+
+cudaq.set_target("photonics")
+
+
+@cudaq.kernel
+def TBI(
+    bs_angles: list[float],
+    ps_angles: list[float],
+    input_state: list[int],
+    loop_lengths: list[int],
+):
+    n_modes = len(input_state)
+    level = sum(input_state) + 1  # qudit level
+
+    quds = [qudit(level) for _ in range(n_modes)]
+
+    for i in range(n_modes):
+        for _ in range(input_state[i]):
+            plus(quds[i])
+
+    counter = 0
+    for j in loop_lengths:
+        for i in range(n_modes - j):
+            beam_splitter(quds[i], quds[i + j], bs_angles[counter])
+            phase_shift(quds[i], ps_angles[counter])
+            counter += 1
+
+    mz(quds)
+
+
+input_state = [2, 1, 3, 1]
+loop_lengths = [1, 2]
+n_beam_splitters = len(loop_lengths) * len(input_state) - sum(loop_lengths)
+bs_angles = np.linspace(np.pi / 3, np.pi / 6, n_beam_splitters)
+ps_angles = np.linspace(np.pi / 3, np.pi / 5, n_beam_splitters)
+
+counts = cudaq.sample(TBI,
+                      bs_angles,
+                      ps_angles,
+                      input_state,
+                      loop_lengths,
+                      shots_count=1000000)
+counts.dump()
+
+state = cudaq.get_state(TBI, bs_angles, ps_angles, input_state, loop_lengths)
+state.dump()
diff --git a/pr-2241/sphinx/examples/python/providers/quantinuum.py b/pr-2241/sphinx/examples/python/providers/quantinuum.py
new file mode 100644
index 0000000000..9db699f301
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/providers/quantinuum.py
@@ -0,0 +1,59 @@
+import cudaq
+
+# You only have to set the target once! No need to redefine it
+# for every execution call on your kernel.
+# By default, we will submit to the Quantinuum syntax checker.
+cudaq.set_target("quantinuum")
+
+
+# Create the kernel we'd like to execute on Quantinuum.
+@cudaq.kernel
+def kernel():
+    qvector = cudaq.qvector(2)
+    h(qvector[0])
+    x.ctrl(qvector[0], qvector[1])
+    mz(qvector[0])
+    mz(qvector[1])
+
+
+# Submit to Quantinuum's endpoint and confirm the program is valid.
+
+# Option A:
+# By using the synchronous `cudaq.sample`, the execution of
+# any remaining classical code in the file will occur only
+# after the job has been executed by the Quantinuum service.
+# We will use the synchronous call to submit to the syntax
+# checker to confirm the validity of the program.
+syntax_check = cudaq.sample(kernel)
+if (syntax_check):
+    print("Syntax check passed! Kernel is ready for submission.")
+
+# Now we can update the target to the Quantinuum emulator and
+# execute our program.
+cudaq.set_target("quantinuum", machine="H1-2E")
+
+# Option B:
+# By using the asynchronous `cudaq.sample_async`, the remaining
+# classical code will be executed while the job is being handled
+# by Quantinuum. This is ideal when submitting via a queue over
+# the cloud.
+async_results = cudaq.sample_async(kernel)
+# ... more classical code to run ...
+
+# We can either retrieve the results later in the program with
+# ```
+# async_counts = async_results.get()
+# ```
+# or we can also write the job reference (`async_results`) to
+# a file and load it later or from a different process.
+file = open("future.txt", "w")
+file.write(str(async_results))
+file.close()
+
+# We can later read the file content and retrieve the job
+# information and results.
+same_file = open("future.txt", "r")
+retrieved_async_results = cudaq.AsyncSampleResult(str(same_file.read()))
+
+counts = retrieved_async_results.get()
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/qaoa_maxcut.py b/pr-2241/sphinx/examples/python/qaoa_maxcut.py
new file mode 100644
index 0000000000..f48fe816f4
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/qaoa_maxcut.py
@@ -0,0 +1,78 @@
+import cudaq
+from cudaq import spin
+
+from typing import List
+
+import numpy as np
+
+# Here we build up a kernel for QAOA with `p` layers, with each layer
+# containing the alternating set of unitaries corresponding to the problem
+# and the mixer Hamiltonians. The algorithm leverages the VQE algorithm
+# to compute the Max-Cut of a rectangular graph illustrated below.
+
+#       v0  0---------------------0 v1
+#           |                     |
+#           |                     |
+#           |                     |
+#           |                     |
+#       v3  0---------------------0 v2
+# The Max-Cut for this problem is 0101 or 1010.
+
+# The problem Hamiltonian
+hamiltonian = 0.5 * spin.z(0) * spin.z(1) + 0.5 * spin.z(1) * spin.z(2) \
+       + 0.5 * spin.z(0) * spin.z(3) + 0.5 * spin.z(2) * spin.z(3)
+
+# Problem parameters.
+qubit_count: int = 4
+layer_count: int = 2
+parameter_count: int = 2 * layer_count
+
+
+@cudaq.kernel
+def kernel_qaoa(qubit_count: int, layer_count: int, thetas: List[float]):
+    """QAOA ansatz for Max-Cut"""
+    qvector = cudaq.qvector(qubit_count)
+
+    # Create superposition
+    h(qvector)
+
+    # Loop over the layers
+    for layer in range(layer_count):
+        # Loop over the qubits
+        # Problem unitary
+        for qubit in range(qubit_count):
+            x.ctrl(qvector[qubit], qvector[(qubit + 1) % qubit_count])
+            rz(2.0 * thetas[layer], qvector[(qubit + 1) % qubit_count])
+            x.ctrl(qvector[qubit], qvector[(qubit + 1) % qubit_count])
+
+        # Mixer unitary
+        for qubit in range(qubit_count):
+            rx(2.0 * thetas[layer + layer_count], qvector[qubit])
+
+
+# Specify the optimizer and its initial parameters. Make it repeatable.
+cudaq.set_random_seed(13)
+optimizer = cudaq.optimizers.COBYLA()
+np.random.seed(13)
+optimizer.initial_parameters = np.random.uniform(-np.pi / 8.0, np.pi / 8.0,
+                                                 parameter_count)
+print("Initial parameters = ", optimizer.initial_parameters)
+
+
+# Define the objective, return `<state(params) | H | state(params)>`
+def objective(parameters):
+    return cudaq.observe(kernel_qaoa, hamiltonian, qubit_count, layer_count,
+                         parameters).expectation()
+
+
+# Optimize!
+optimal_expectation, optimal_parameters = optimizer.optimize(
+    dimensions=parameter_count, function=objective)
+
+# Print the optimized value and its parameters
+print("Optimal value = ", optimal_expectation)
+print("Optimal parameters = ", optimal_parameters)
+
+# Sample the circuit using the optimized parameters
+counts = cudaq.sample(kernel_qaoa, qubit_count, layer_count, optimal_parameters)
+print(counts)
diff --git a/pr-2241/sphinx/examples/python/simple_vqe.py b/pr-2241/sphinx/examples/python/simple_vqe.py
new file mode 100644
index 0000000000..f4675a9a97
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/simple_vqe.py
@@ -0,0 +1,47 @@
+import cudaq
+from cudaq import spin
+
+from typing import List
+
+# We begin by defining the spin Hamiltonian for the system that we are working
+# with. This is achieved through the use of `cudaq.SpinOperator`'s, which allow
+# for the convenient creation of complex Hamiltonians out of Pauli spin operators.
+hamiltonian = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+    0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+
+# Next, using the `cudaq.Kernel`, we define the variational quantum circuit
+# that we'd like to use as an ansatz.
+# Create a kernel that takes a list of floats as a function argument.
+@cudaq.kernel
+def kernel(angles: List[float]):
+    # Allocate 2 qubits.
+    qubits = cudaq.qvector(2)
+    x(qubits[0])
+    # Apply an `ry` gate that is parameterized by the first value
+    # of our `angles`.
+    ry(angles[0], qubits[1])
+    x.ctrl(qubits[1], qubits[0])
+    # Note: the kernel must not contain measurement instructions.
+
+
+# The last thing we need is to pick an optimizer from the suite of `cudaq.optimizers`.
+# We can optionally tune this optimizer through its initial parameters, iterations,
+# optimization bounds, etc. before passing it to `cudaq.vqe`.
+optimizer = cudaq.optimizers.COBYLA()
+# optimizer.max_iterations = ...
+# optimizer...
+
+# Finally, we pass all of that into `cudaq.vqe`, and it will automatically run our
+# optimization loop, returning a tuple of the minimized eigenvalue of our `spin_operator`
+# and the list of optimal variational parameters.
+
+energy, parameter = cudaq.vqe(
+    kernel=kernel,
+    spin_operator=hamiltonian,
+    optimizer=optimizer,
+    # list of parameters has length of 1:
+    parameter_count=1)
+
+print(f"\nminimized <H> = {round(energy,16)}")
+print(f"optimal theta = {round(parameter[0],16)}")
diff --git a/pr-2241/sphinx/examples/python/trotter_kernel_mode.py b/pr-2241/sphinx/examples/python/trotter_kernel_mode.py
new file mode 100644
index 0000000000..e2e286fbb0
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/trotter_kernel_mode.py
@@ -0,0 +1,128 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+import cudaq
+import time
+import numpy as np
+from typing import List
+
+# Compute magnetization using Suzuki-Trotter approximation.
+# This example demonstrates usage of quantum states in kernel mode.
+#
+# Details
+# https://pubs.aip.org/aip/jmp/article-abstract/32/2/400/229229/General-theory-of-fractal-path-integrals-with
+#
+# Hamiltonian used
+# https://en.m.wikipedia.org/wiki/Quantum_Heisenberg_model
+
+# If you have a NVIDIA GPU you can use this example to see
+# that the GPU-accelerated backends can easily handle a
+# larger number of qubits compared the CPU-only backend.
+
+# Depending on the available memory on your GPU, you can
+# set the number of qubits to around 30 qubits, and un-comment
+# the `cudaq.set_target(nvidia)` line.
+
+# Note: Without setting the target to the `nvidia` backend,
+# there will be a noticeable decrease in simulation performance.
+# This is because the CPU-only backend has difficulty handling
+# 30+ qubit simulations.
+
+spins = 11  # set to around 25 qubits for `nvidia` target
+steps = 10  # set to around 100 for `nvidia` target
+# ```
+# cudaq.set_target("nvidia")
+# ```
+
+
+# Alternating up/down spins
+@cudaq.kernel
+def getInitState(numSpins: int):
+    q = cudaq.qvector(numSpins)
+    for qId in range(0, numSpins, 2):
+        x(q[qId])
+
+
+# This performs a single-step Trotter on top of an initial state, e.g.,
+# result state of the previous Trotter step.
+@cudaq.kernel
+def trotter(state: cudaq.State, coefficients: List[complex],
+            words: List[cudaq.pauli_word], dt: float):
+    q = cudaq.qvector(state)
+    for i in range(len(coefficients)):
+        exp_pauli(coefficients[i].real * dt, q, words[i])
+
+
+def run_steps(steps: int, spins: int):
+    g = 1.0
+    Jx = 1.0
+    Jy = 1.0
+    Jz = g
+    dt = 0.05
+    n_steps = steps
+    n_spins = spins
+    omega = 2 * np.pi
+
+    def heisenbergModelHam(t: float) -> cudaq.SpinOperator:
+        tdOp = cudaq.SpinOperator(num_qubits=n_spins)
+        for i in range(0, n_spins - 1):
+            tdOp += (Jx * cudaq.spin.x(i) * cudaq.spin.x(i + 1))
+            tdOp += (Jy * cudaq.spin.y(i) * cudaq.spin.y(i + 1))
+            tdOp += (Jz * cudaq.spin.z(i) * cudaq.spin.z(i + 1))
+        for i in range(0, n_spins):
+            tdOp += (np.cos(omega * t) * cudaq.spin.x(i))
+        return tdOp
+
+    # Collect coefficients from a spin operator so we can pass them to a kernel
+    def termCoefficients(op: cudaq.SpinOperator) -> List[complex]:
+        result = []
+        ham.for_each_term(lambda term: result.append(term.get_coefficient()))
+        return result
+
+    # Collect Pauli words from a spin operator so we can pass them to a kernel
+    def termWords(op: cudaq.SpinOperator) -> List[str]:
+        result = []
+        ham.for_each_term(lambda term: result.append(term.to_string(False)))
+        return result
+
+    # Observe the average magnetization of all spins (<Z>)
+    average_magnetization = cudaq.SpinOperator(num_qubits=n_spins)
+    for i in range(0, n_spins):
+        average_magnetization += ((1.0 / n_spins) * cudaq.spin.z(i))
+    average_magnetization -= 1.0
+
+    # Run loop
+    state = cudaq.get_state(getInitState, n_spins)
+
+    results = []
+    times = []
+    for i in range(0, n_steps):
+        start_time = time.time()
+        ham = heisenbergModelHam(i * dt)
+        coefficients = termCoefficients(ham)
+        words = termWords(ham)
+        magnetization_exp_val = cudaq.observe(trotter, average_magnetization,
+                                              state, coefficients, words, dt)
+        result = magnetization_exp_val.expectation()
+        results.append(result)
+        state = cudaq.get_state(trotter, state, coefficients, words, dt)
+        stepTime = time.time() - start_time
+        times.append(stepTime)
+        print(f"Step {i}: time [s]: {stepTime}, result: {result}")
+
+    print("")
+    # Print all the times and results (useful for plotting).
+    print(f"Step times: {times}")
+    print(f"Results: {results}")
+
+    print("")
+
+
+start_time = time.time()
+run_steps(steps, spins)
+print(f"Total time: {time.time() - start_time}s")
diff --git a/pr-2241/sphinx/examples/python/tutorials/Divisive_clustering.ipynb b/pr-2241/sphinx/examples/python/tutorials/Divisive_clustering.ipynb
new file mode 100644
index 0000000000..bfb75e8bf4
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/Divisive_clustering.ipynb
@@ -0,0 +1,1089 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Divisive Clustering With Coresets Using CUDA-Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This tutorial will explore a CUDA-Q implementation of recent research (ArXiv Paper: https://arxiv.org/pdf/2402.01529.pdf) performed by a team from the University of Edinburgh. This tutorial was jointly developed by NVIDIA and the authors so users can better understand their method and explore how CUDA-Q removed barriers to scaling. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The code for this tutorial is based off the MIT licensed code found here: https://github.com/Boniface316/bigdata_vqa"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Clustering is a common unsupervised learning technique aimed at grouping data with similar characteristics. The unique properties of quantum computers could allow for enhanced pattern finding in clustering applications and enable more reliable data analysis. However, quantum computers today are severely limited by qubit count and noise.  Performing practical clustering applications would require far too many qubits.  The Edinburgh team developed a new method (extending the work of Harrow) to leverage coresets for clustering applications on quantum computers and use far fewer qubits.  This tutorial will walk through an example using this approach for divisive clustering and emphasize the utility of CUDA-Q for scaling quantum simulations.\n",
+    "\n",
+    "The goal of divisive clustering is to begin with all data points as one set, and iteratively bipartition the data until each point is its own cluster.  The branching behavior of this process can be used to understand similarities in the data points.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# If you are running outside of a CUDA-Q container or CUDA-Q directory tree, you may need to uncomment these lines to fetch the files.\n",
+    "# If you are running inside a CUDA-Q tree, then this step can be skipped.\n",
+    "# !mkdir divisive_clustering_src\n",
+    "# !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py\n",
+    "# !wget -P divisive_clustering_src https://raw.githubusercontent.com/NVIDIA/cuda-quantum/main/docs/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "!pip install mpi4py==3.1.6\n",
+    "!pip install networkx==2.8.8\n",
+    "!pip install pandas==2.2.2\n",
+    "!pip install scikit-learn==1.4.2\n",
+    "!pip install tqdm==4.66.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "\n",
+    "# Auxillary Imports\n",
+    "import os\n",
+    "import numpy as np\n",
+    "import networkx as nx\n",
+    "import pandas as pd\n",
+    "import matplotlib.pyplot as plt\n",
+    "import warnings\n",
+    "from typing import Tuple\n",
+    "from divisive_clustering_src.divisive_clustering import Coreset, DivisiveClustering, Dendrogram, Voironi_Tessalation\n",
+    "\n",
+    "warnings.filterwarnings(\"ignore\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The settings below are global parameters for the quantum simulation and can be toggled by the user.  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "circuit_depth = 1\n",
+    "max_iterations = 75\n",
+    "max_shots = 1000\n",
+    "np.random.seed(10)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "\n",
+    "Given a data set $X = (x_1, x_2, \\cdots, x_N)$, a coreset is weighted data set of much smaller size ($X', w$) that represents $X$ enough such that analysis of ($X', w$) can allow us to draw reasonable approximate conclusions about $X$. There are various approaches to build coresets. They can be found in Practical Coreset Construction for Machine Learning (https://arxiv.org/pdf/1703.06476.pdf) and New Streaming Algorithms for Coresets in Machine Learning (https://arxiv.org/pdf/1703.06476.pdf).\n",
+    "\n",
+    "\n",
+    "Essentially, coreset construction boils down to finding the optimal coreset size and weights given some error tolerance.  Given the constraints of a quantum computer, in this work, a coreset size is selected $a$ $priori$, and the error is determined for each model.\n",
+    "\n",
+    "\n",
+    "The following is an example $M=10$ coreset constructed from a 1000-point data set and loaded into a pandas data frame. See the image below where the coreset is represented by the black stars, the size of which corresponds to the weights.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "          X         Y     weights Name\n",
+      "0  7.028364  1.669787  234.230716    A\n",
+      "1  7.167441  0.354792  101.319288    B\n",
+      "2  1.022889 -0.921443  125.158339    C\n",
+      "3  2.706134 -2.636852   13.650774    D\n",
+      "4  6.998497  0.455847  116.758239    E\n",
+      "5  7.507918  0.630311  120.727176    F\n",
+      "6 -2.102508  2.297727   53.294127    G\n",
+      "7  5.722463  1.400433   77.415840    H\n",
+      "8 -1.425868  2.341136   42.847985    I\n",
+      "9  7.985373 -0.063209  240.116237    J\n"
+     ]
+    }
+   ],
+   "source": [
+    "raw_data = Coreset.create_dataset(1000)\n",
+    "coreset = Coreset(\n",
+    "    raw_data=raw_data,\n",
+    "    number_of_sampling_for_centroids=10,\n",
+    "    coreset_size=10,\n",
+    "    number_of_coresets_to_evaluate=4,\n",
+    "    coreset_method=\"BFL2\",\n",
+    ")\n",
+    "\n",
+    "\n",
+    "coreset_vectors, coreset_weights = coreset.get_best_coresets()\n",
+    "\n",
+    "coreset_df = pd.DataFrame(\n",
+    "    {\"X\": coreset_vectors[:, 0], \"Y\": coreset_vectors[:, 1], \"weights\": coreset_weights}\n",
+    ")\n",
+    "coreset_df[\"Name\"] = [chr(i + 65) for i in coreset_df.index]\n",
+    "print(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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3nzzTbRo0QK//fYbxo4dq7MdbD788EMUFxfj9u3bWLRoEQDA29sbAPDtt9/inXfewdChQzFp0iQ8evQI586dw7FjxzB69Gi9x547dy4EAgGmT5+O/Px8LF68GD179sTZs2fh4eEBAPj777/Rt29fJCQkYNasWRAKhVi9ejWeeeYZpKeno1OnTgCAN998E5s3b8bEiRMRHx+PwsJCHDp0CJcuXUKHDh10/hymOnPmDLy8vDT+JpVtO3PmDLp27cr6/nPnziExMRGurq54/fXXERkZievXr+OPP/7A3LlzAQAXL15EYmIiJBIJ3n//fbi6umLlypVISkrCgQMH8OSTT6odc/z48QgMDMTMmTNRXl4OAPj5558xduxY9O7dG59//jkqKiqwfPlydO3aFWfOnFEFeUOGDMHFixfx9ttvIzIyEvn5+di7dy9u3bql2ofLsfRdN6aYPXs25s2bh9deew2dOnVCSUkJTp48idOnT+PZZ5/V+d5Dhw4hNTUV48ePh4+PD7766isMGTIEt27dQkBAAADF/7M+ffogNDQUc+bMgUwmwyeffILAwECD2nn//n0Aimv3xo0bmD59OgICAvD8889r7FtaWqraX8nf318jSDFUWVkZysrK0LBhQ5OO41QY4lRWr17NAGD++usvpqCggMnJyWE2b97MBAYGMmKxmMnJyVHtW1NTw0ilUrX3P3jwgAkODmZeeeUV1bZNmzYxAJiMjAyGYRhm27ZtjFgsZgYMGMCMGDFCtV+bNm2YF154QWf7Fi9ezABgNm7cqNpWXl7ONG3alAHA7N+/X7W9oqJC4/3z5s1jBAIBk52drdo2YcIEhu1Pvf4xqqqqmFatWjHPPPOMznYacv6xY8cyAJhPPvlEbd/27dszCQkJqu9///13BgAzf/581baamhomMTGRAcCsXr1aZ3v279+v8Tvq168fExERobHvwIEDmZYtW+r5CdnP0bhxY6akpES1fePGjQwAZsmSJQzDMIxcLmdiY2OZ3r17M3K5XLVfRUUFExUVxTz77LOqbb6+vsyECRN0npft5+BC13v79evHREdHa2wvLy9nADAzZszQeexu3boxPj4+av+/GYZR+5kHDRrEuLm5MdevX1dtu3PnDuPj48N069ZNtU15bXbt2pWpqalRbS8tLWUaNGjAjBs3Tu0c9+7dY3x9fVXbHzx4wABg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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.scatter(raw_data[:, 0], raw_data[:, 1], label=\"Raw Data\", c=\"#7eba00\")\n",
+    "plt.scatter(\n",
+    "    coreset_df[\"X\"],\n",
+    "    coreset_df[\"Y\"],\n",
+    "    s=coreset_df[\"weights\"],\n",
+    "    label=\"Coreset\",\n",
+    "    color=\"black\",\n",
+    "    marker=\"*\",\n",
+    ")\n",
+    "plt.xlabel(\"X\")\n",
+    "plt.ylabel(\"Y\")\n",
+    "plt.title(\"Raw data and its best 10 coreset using BFL2\")\n",
+    "plt.legend()\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Data preprocessing"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In order to cluster data on a quantum computer, the task needs to be cast into the form of a binary optimization problem.  Each qubit represents a coreset point, and the quantum algorithm determines how to bipartition the coreset points at each iteration of the divisive clustering routine. \n",
+    "\n",
+    "The first step is to convert coreset points into a fully connected graph. The edge weight is calculated by:\n",
+    "\n",
+    "$e_{ij} = w_iw_jd_{ij}$ where $d_{ij}$ is the Euclidean distance between points $i$ and $j$. \n",
+    "\n",
+    "This process is handled by `Coreset.coreset_to_graph()`. The function returns a fully connected graph $G$ with edge weights."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum functions"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The divisive clustering problem will be implemented on a quantum computer using a variational quantum algorithm (VQA) approach.  A VQA takes a Hamiltonian (encoded with the optimization problem) and a parameterized ansatz and evaluates expectation values (quantum computer) that inform updates to the ansatz parameters (classical computer).  The graph $G$ (Code in the \"src\" file) is used to construct the Hamiltonian, derived specifically for the divisive clustering problem, and motivated by a max-cut Hamiltonian.  The `spin.z(i)` method in CUDA-Q adds a Pauli Z operation that acts on qubit $i$ to the Hamiltonian."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_K2_Hamiltonian(G: nx.Graph) -> cudaq.SpinOperator:\n",
+    "    \"\"\"Returns the K2 Hamiltonian for the given graph G\n",
+    "\n",
+    "    Args:\n",
+    "        G (nx.Graph): Weighted graph\n",
+    "    \"\"\"\n",
+    "    H = 0\n",
+    "\n",
+    "    for i, j in G.edges():\n",
+    "        weight = G[i][j][\"weight\"]\n",
+    "        H += weight * (spin.z(i) * spin.z(j))\n",
+    "\n",
+    "    return H"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The code below constructs a quantum kernel, defining the circuit which will serve as an ansatz.  The structure of the circuit is a hardware efficient ansatz consisting of layers of parameterized $R_Z$ and $R_Y$ gate acting on each qubit, followed by a linear cascade of CNOT gates, and two more rotation gates.\n",
+    "\n",
+    "The `@cudaq.kernel` decorator allows us to define a quantum circuit in the new kernel mode syntax which provides performance benefits to JIT compilation."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_VQE_circuit(number_of_qubits: int, circuit_depth: int) -> cudaq.Kernel:\n",
+    "    \"\"\"Returns the VQE circuit for the given number of qubits and circuit depth\n",
+    "\n",
+    "    Args:\n",
+    "        number_of_qubits (int): Number of qubits\n",
+    "        circuit_depth (int): Circuit depth\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq.Kernel: VQE Circuit\n",
+    "    \"\"\"\n",
+    "\n",
+    "    @cudaq.kernel\n",
+    "    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):\n",
+    "        \"\"\"VQE Circuit\n",
+    "\n",
+    "        Args:\n",
+    "            thetas (list[float]): List of parameters\n",
+    "            number_of_qubits (int): Number of qubits\n",
+    "            circuit_depth (int): Circuit depth\n",
+    "        \"\"\"\n",
+    "        qubits = cudaq.qvector(number_of_qubits)\n",
+    "\n",
+    "        theta_position = 0\n",
+    "\n",
+    "        for i in range(circuit_depth):\n",
+    "            for j in range(number_of_qubits):\n",
+    "                ry(thetas[theta_position], qubits[j])\n",
+    "                rz(thetas[theta_position + 1], qubits[j])\n",
+    "\n",
+    "                theta_position += 2\n",
+    "\n",
+    "            for j in range(number_of_qubits - 1):\n",
+    "                cx(qubits[j], qubits[j + 1])\n",
+    "\n",
+    "            for j in range(number_of_qubits):\n",
+    "                ry(thetas[theta_position], qubits[j])\n",
+    "                rz(thetas[theta_position + 1], qubits[j])\n",
+    "\n",
+    "                theta_position += 2\n",
+    "\n",
+    "    return kernel"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can visualize the circuit using the `cudaq.draw()` method. Below, we are drawing the circuit for 5 qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭────────────╮ ╭────────────╮      ╭────────────╮╭────────────╮»\n",
+      "q0 : ┤ ry(0.8904) ├─┤ rz(0.7335) ├───●──┤ ry(0.4343) ├┤ rz(0.2236) ├»\n",
+      "     ├────────────┤ ├────────────┤ ╭─┴─╮╰────────────╯├────────────┤»\n",
+      "q1 : ┤ ry(0.7937) ├─┤ rz(0.9981) ├─┤ x ├──────●───────┤ ry(0.3945) ├»\n",
+      "     ├───────────┬╯ ├────────────┤ ╰───╯    ╭─┴─╮     ╰────────────╯»\n",
+      "q2 : ┤ ry(0.696) ├──┤ rz(0.3352) ├──────────┤ x ├───────────●───────»\n",
+      "     ├───────────┴╮╭┴────────────┤          ╰───╯         ╭─┴─╮     »\n",
+      "q3 : ┤ ry(0.6658) ├┤ rz(0.05277) ├────────────────────────┤ x ├─────»\n",
+      "     ├───────────┬╯├─────────────┴╮                       ╰───╯     »\n",
+      "q4 : ┤ ry(0.791) ├─┤ rz(0.003569) ├─────────────────────────────────»\n",
+      "     ╰───────────╯ ╰──────────────╯                                 »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                                             \n",
+      "─────────────────────────────────────────────\n",
+      "╭────────────╮                               \n",
+      "┤ rz(0.4119) ├───────────────────────────────\n",
+      "├────────────┤╭────────────╮                 \n",
+      "┤ ry(0.3205) ├┤ rz(0.3504) ├─────────────────\n",
+      "╰────────────╯├────────────┤ ╭────────────╮  \n",
+      "──────●───────┤ ry(0.3913) ├─┤ rz(0.7392) ├──\n",
+      "    ╭─┴─╮     ├────────────┤╭┴────────────┴─╮\n",
+      "────┤ x ├─────┤ ry(0.3171) ├┤ rz(0.0008056) ├\n",
+      "    ╰───╯     ╰────────────╯╰───────────────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "parameter_count = 4 * circuit_depth * 5\n",
+    "parameters = np.random.rand(parameter_count)\n",
+    "\n",
+    "circuit = get_VQE_circuit(5, circuit_depth)\n",
+    "print(cudaq.draw(circuit, parameters, 5, circuit_depth))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The next step is to select a classical optimizer. There are multiple [optimizers](https://nvidia.github.io/cuda-quantum/latest/api/languages/python_api.html#optimizers) built-in to CUDA-Q that can be selected. The code below returns the optimizer with the proper number of initial parameters. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_optimizer(\n",
+    "    optimizer: cudaq.optimizers.optimizer, max_iterations, **kwargs\n",
+    ") -> Tuple[cudaq.optimizers.optimizer, int]:\n",
+    "    \"\"\"Returns the optimizer with the given parameters\n",
+    "\n",
+    "    Args:\n",
+    "        optimizer (cudaq.optimizers.optimizer): Optimizer\n",
+    "        max_iterations (int): Maximum number of iterations\n",
+    "        **kwargs: Additional arguments\n",
+    "\n",
+    "    Returns:\n",
+    "        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count\n",
+    "    \"\"\"\n",
+    "    parameter_count = 4 * kwargs[\"circuit_depth\"] * kwargs[\"qubits\"]\n",
+    "    initial_params = np.random.uniform(-np.pi / 8.0, np.pi / 8.0, parameter_count)\n",
+    "    optimizer.initial_parameters = initial_params\n",
+    "\n",
+    "    optimizer.max_iterations = max_iterations\n",
+    "    return optimizer, parameter_count"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Divisive Clustering Function"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The `DivisiveClusteringVQA` class enables the procedure to iteratively bipartition the coreset points until each is its own cluster. If you wish to develop on top of this or see how the underlying code works, please see the `divisive_clustering.py` file in the src directory. \n",
+    "\n",
+    "`run_divisive_clustering`, takes the current iteration's coreset points that will be bipartitioned as inputs, extracts the appropriate weights, and builds a graph $G$. The graph is then an input into the `get_counts_from_simulation` function. \n",
+    "\n",
+    "\n",
+    "`get_counts_from_simulation` handles preparation and execution of the quantum simulation. First, it takes $G$ and from it builds a spin Hamiltonian. Second, it defines a cost function, which in this case is a lambda function that returns the expectation value of our parameterized quantum circuit and the Hamiltonian. This value is obtained using the CUDA-Q `observe` command, accelerated by GPUs.  After the expectation value is minimized, the quantum circuit corresponding to the optimal parameters is sampled using the CUDA-Q `sample` function. The bitstrings and their associated counts are returned by `get_counts_from_simulation`.\n",
+    "\n",
+    "A subset of these counts is evaluated to compute their exact cost. The best bitstring is returned and later used to assign the coreset points to one of two clusters.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class DivisiveClusteringVQA(DivisiveClustering):\n",
+    "    def __init__(\n",
+    "        self,\n",
+    "        **kwargs,\n",
+    "    ):\n",
+    "        super().__init__(**kwargs)\n",
+    "\n",
+    "    def run_divisive_clustering(\n",
+    "        self,\n",
+    "        coreset_vectors_df_for_iteration: pd.DataFrame,\n",
+    "    ):\n",
+    "        \"\"\"Runs the Divisive Clustering algorithm\n",
+    "\n",
+    "        Args:\n",
+    "            coreset_vectors_df_for_iteration (pd.DataFrame): Coreset vectors for the iteration\n",
+    "\n",
+    "        Returns:\n",
+    "            str: Best bitstring\n",
+    "\n",
+    "        \"\"\"\n",
+    "        coreset_vectors_for_iteration_np, coreset_weights_for_iteration_np = (\n",
+    "            self._get_iteration_coreset_vectors_and_weights(coreset_vectors_df_for_iteration)\n",
+    "        )\n",
+    "\n",
+    "        G = Coreset.coreset_to_graph(\n",
+    "            coreset_vectors_for_iteration_np,\n",
+    "            coreset_weights_for_iteration_np,\n",
+    "            metric=self.coreset_to_graph_metric,\n",
+    "        )\n",
+    "\n",
+    "        counts = self.get_counts_from_simulation(\n",
+    "            G,\n",
+    "            self.circuit_depth,\n",
+    "            self.max_iterations,\n",
+    "            self.max_shots,\n",
+    "        )\n",
+    "\n",
+    "        return self._get_best_bitstring(counts, G)\n",
+    "\n",
+    "    def get_counts_from_simulation(\n",
+    "        self, G: nx.graph, circuit_depth: int, max_iterations: int, max_shots: int\n",
+    "    ) -> cudaq.SampleResult:\n",
+    "        \"\"\"\n",
+    "        Runs the VQA simulation\n",
+    "\n",
+    "        Args:\n",
+    "            G (nx.graph): Graph\n",
+    "            circuit_depth (int): Circuit depth\n",
+    "            max_iterations (int): Maximum number of iterations\n",
+    "            max_shots (int): Maximum number of shots\n",
+    "\n",
+    "        Returns:\n",
+    "            cudaq.SampleResult: Measurement from the experiment\n",
+    "        \"\"\"\n",
+    "\n",
+    "        qubits = len(G.nodes)\n",
+    "        Hamiltonian = self.create_Hamiltonian(G)\n",
+    "        optimizer, parameter_count = self.optimizer_function(\n",
+    "            self.optimizer, max_iterations, qubits=qubits, circuit_depth=circuit_depth\n",
+    "        )\n",
+    "\n",
+    "        kernel = self.create_circuit(qubits, circuit_depth)\n",
+    "\n",
+    "        def objective_function(\n",
+    "            parameter_vector: list[float],\n",
+    "            hamiltonian: cudaq.SpinOperator = Hamiltonian,\n",
+    "            kernel: cudaq.Kernel = kernel,\n",
+    "        ) -> float:\n",
+    "            \"\"\"\n",
+    "\n",
+    "            Objective function that returns the cost of the simulation\n",
+    "\n",
+    "            Args:\n",
+    "                parameter_vector (List[float]):\n",
+    "                hamiltonian (cudaq.SpinOperator): Circuit parameter values as a vector\n",
+    "                kernel (cudaq.Kernel) : Circuit configuration\n",
+    "\n",
+    "            Returns:\n",
+    "                float: Expectation value of the circuit\n",
+    "\n",
+    "            \"\"\"\n",
+    "\n",
+    "            get_result = lambda parameter_vector: cudaq.observe(\n",
+    "                kernel, hamiltonian, parameter_vector, qubits, circuit_depth\n",
+    "            ).expectation()\n",
+    "\n",
+    "            cost = get_result(parameter_vector)\n",
+    "\n",
+    "            return cost\n",
+    "\n",
+    "        energy, optimal_parameters = optimizer.optimize(\n",
+    "            dimensions=parameter_count, function=objective_function\n",
+    "        )\n",
+    "\n",
+    "        counts = cudaq.sample(\n",
+    "            kernel, optimal_parameters, qubits, circuit_depth, shots_count=max_shots\n",
+    "        )\n",
+    "\n",
+    "        return counts"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "An instance of the `DivisiveClusteringVQA` class is mostly constructed from variables previously discussed like the functions for building the Hamiltonians and quantum circuits. Parameters related to the quantum simulation can also be specified here such as `circuit_depth` and `max_shots`.  The ` threshold_for_max_cut` parameter specifies what percent of the sample results from the quantum computer are checked for the best bitstring value.\n",
+    "\n",
+    "The other options specify advanced features like if the data is normalized and how the graph weights are computed.\n",
+    "\n",
+    "\n",
+    "Finally, the `get_divisive_sequence` method performs the iterations and produces the clustering data which we will analyze below. Note that this postprocessing code is not exposed in this tutorial but can be found in the source code. \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 129/129 [00:00<00:00, 12075.19it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00<00:00, 35025.50it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 18/18 [00:00<00:00, 44254.09it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 15827.56it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 13617.87it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "divisive_clustering = DivisiveClusteringVQA(\n",
+    "    circuit_depth=circuit_depth,\n",
+    "    max_iterations=max_iterations,\n",
+    "    max_shots=max_shots,\n",
+    "    threshold_for_max_cut=0.75,\n",
+    "    create_Hamiltonian=get_K2_Hamiltonian,\n",
+    "    optimizer=optimizer,\n",
+    "    optimizer_function=get_optimizer,\n",
+    "    create_circuit=get_VQE_circuit,\n",
+    "    normalize_vectors=True,\n",
+    "    sort_by_descending=True,\n",
+    "    coreset_to_graph_metric=\"dist\",\n",
+    ")\n",
+    "\n",
+    "hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The data can be nicely visualized with a Dendrogram which maps where the bipartitionings occurred. Early splits generally mark divisions between the least similar data."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAy0AAANICAYAAADKKQDvAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9MElEQVR4nO3deXzU9Z348Xc4EsItCFUEOcQbRSueaAFLtQhatIpFLIqVWkUrtehP2vVAu6Xq6oquUnVV3AqLYLXrsWhVFrteVUHXo2qBB1i0CooSrhCOfH9/uJklJCABwnwgz+fjMQ+Yme985z1DSPLK90hBlmVZAAAAJKpevgcAAADYFNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAtQJnTp1inPPPTffY+zQnnrqqTjkkEOiUaNGUVBQEEuWLMn3SHVWQUFBXHvttfkeA2C7ES3ANjFhwoQoKCjIXRo1ahTt2rWLE088MW677bZYtmxZvkdkKyxevDgGDRoUxcXFcccdd8Tvfve7aNKkySYfM3fu3LjggguiS5cu0ahRo2jevHn07Nkzxo0bF6Wlpdtp8tqxcuXKuPbaa2PGjBn5HmW7ueWWW6KgoCCeffbZjS5zzz33REFBQTz22GO527Isi9/97nfxrW99K1q2bBmNGzeOgw46KH71q1/FypUrq6yjd+/elT6XrH/Zb7/9auW1AelrkO8BgJ3LddddF507d441a9bEp59+GjNmzIiRI0fGLbfcEo899lgcfPDB+R6RLfDaa6/FsmXL4vrrr4++fft+7fJPPvlknHHGGVFUVBRDhw6Nbt26xerVq+OFF16Iyy+/PN599924++67t8PktWPlypUxZsyYiPjqm+ztrbS0NBo02L5fwn/wgx/E5ZdfHpMmTdrox8CkSZOidevW0a9fv4iIWLduXZx11lkxZcqUOO644+Laa6+Nxo0bx3//93/HNddcE1OmTIlnn3022rZtW2k97du3j7Fjx1ZZf4sWLbb9CwN2CKIF2Kb69esXPXr0yF0fPXp0TJ8+PQYMGBCnnHJKvPfee1FcXJzHCTduxYoVX7v1YFtZtWpVFBYWRr16O8YG70WLFkVERMuWLb922Xnz5sUPfvCD6NixY0yfPj1233333H0jRoyIOXPmxJNPPrnVM2VZFqtWrUr246k2NWrUaLs/Z7t27aJPnz7xyCOPxPjx46OoqKjS/R9//HH86U9/ih//+MfRsGHDiIi48cYbY8qUKTFq1Ki46aabcsv++Mc/jkGDBsXAgQNj2LBhVT4eWrRoEWeffXbtvyhgh7FjfLUEdmjHH398XHXVVfHhhx/Ggw8+WOm+999/P04//fRo1apVNGrUKHr06FFp15KI/9v17MUXX4zLLrss2rRpE02aNIlTTz01Pvvss0rLZlkWv/rVr6J9+/bRuHHj6NOnT7z77rtVZqpY5/PPPx8XXXRRtG3bNtq3b5+7/84774wDDzwwioqKol27djFixIhqj+G44447okuXLlFcXBxHHHFE/Pd//3f07t270k/fZ8yYEQUFBTF58uT4h3/4h9hjjz2icePGsXTp0vjiiy9i1KhRcdBBB0XTpk2jefPm0a9fv/if//mfSs9TsY4pU6bEmDFjYo899ohmzZrF6aefHiUlJVFWVhYjR46Mtm3bRtOmTWPYsGFRVla2Wf8+U6dOjcMOOyyKi4tj1113jbPPPjs+/vjj3P29e/eOc845JyIiDj/88CgoKNjk8UE33nhjLF++PO69995KwVKha9eucemll+aur127Nq6//vrYa6+9oqioKDp16hS/+MUvqszfqVOnGDBgQDz99NPRo0ePKC4ujrvuuisiIpYsWRIjR46MDh06RFFRUXTt2jVuuOGGKC8vr7SOyZMnx2GHHRbNmjWL5s2bx0EHHRTjxo2rtMzXrWv+/PnRpk2biIgYM2ZMbtelTR1jcu2110ZBQUGV2ys+DufPn5+77fXXX48TTzwxdt111yguLo7OnTvHeeedV+lxGz5fxfrnzJkT5557brRs2TJatGgRw4YNq7ILVmlpafz0pz+NXXfdNZo1axannHJKfPzxx5t1nMzZZ58dJSUl1Ubn5MmTo7y8PIYMGZJ7nptuuin22WefareanHzyyXHOOefEf/7nf8arr766yecFsKUF2C5++MMfxi9+8Yv44x//GMOHD4+IiHfffTd69uwZe+yxR1x55ZXRpEmTmDJlSgwcODB+//vfx6mnnlppHZdccknssssucc0118T8+fPj1ltvjYsvvjgeeuih3DJXX311/OpXv4qTTjopTjrppJg1a1accMIJsXr16mrnuuiii6JNmzZx9dVXx4oVKyLiq28Ax4wZE3379o0L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mDHxz//8z9G7d+8YOHBgnHXWWVUOfK/Opv6PNG/ePPd+b/g+bvj+b0q/fv2iVatWMWnSpNyxTf/+7/8e3bt3jwMPPDC33MaCZH0V92149rAmTZps1lnqgLpDtADbxUcffRQlJSW5b44qDmoeNWpUlZ+cV9jwG6n1t4isL8uyLZ5re555qrrn+vWvfx1XXXVVnHfeeXH99ddHq1atol69ejFy5MgqB5FHbPw9qI33Zks0b9482rVrF++8806NHlfdQerVqe49LC8vj+985ztxxRVXVPuYffbZJyK++sb4zTffjKeffjqmTZsW06ZNi/vvvz+GDh0aDzzwQI3WVVMbe33rR2rFcg8//HC88sor8fjjj8fTTz8d5513Xtx8883xyiuvRNOmTTf5PNvj46Bhw4YxaNCguOeee2LhwoXxt7/9LWbPnh033nhjpeUOOOCAiIh46623YuDAgdWu66233oqIiC5dumyz+YCdk2gBtovf/e53ERG5QKn4JqVhw4bb7CeqHTt2jIivflq+/jdBn332WW5rzOau44MPPqi0jtWrV8e8efNys1YsN2fOnOjTp09uubVr18b8+fM3+6Dshx9+OPr06RP33ntvpduXLFkSu+6662atY0ut/1qPP/74Svd98MEHuftrasCAAXH33XfHyy+/HEcfffTXzlBeXh6zZ8+O/fffP3f7woULY8mSJZs1w1577RXLly/frI+jwsLCOPnkk+Pkk0+O8vLyuOiii+Kuu+6Kq666Krp27brZ69rcyKpQscVjyZIllU4bveGWpApHHXVUHHXUUfGP//iPMWnSpBgyZEhMnjw5zj///Bo974Yq3u958+ZV2iI5Z86cGq1nyJAh8dvf/jYeeuihmDdvXhQUFMTgwYMrLdOzZ89o2bJlTJo0KX75y19WG1T/9m//FhERZ5xxxha8GqAucUwLUOumT58e119/fXTu3Dm3z3vbtm2jd+/ecdddd8Unn3xS5TEbnsp4c/Tt2zcaNmwYt99+e6WfLFecPWpz11FYWBi33XZbpXXce++9UVJSkjvLUo8ePaJ169Zxzz33VDpuZOLEiZsdSBFf/WR8w5+CT506tcrxPLWhR48e0bZt2/jtb39b6fTC06ZNi/fee2+zzyi1oSuuuCKaNGkS559/fixcuLDK/XPnzs2dZvikk06KiKr/RrfccktExGbNMGjQoHj55Zfj6aefrnLfkiVLcv8+ixcvrnRfvXr1cnFZ8fo3d12NGzfO3bY5Ks62tv4xMStWrMht4anw5ZdfVvl4OOSQQyrNuDUqfmhw5513Vrr99ttvr9F6evbsGZ06dYoHH3wwHnrooejVq1eVM+Y1btw4rrjiivjggw/il7/8ZZV1PPnkkzFhwoQ4+eST46CDDqrhKwHqGltagG1q2rRp8f7778fatWtj4cKFMX369HjmmWeiY8eO8dhjj1U64PuOO+6IY489Ng466KAYPnx4dOnSJRYuXBgvv/xyfPTRR1V+V8nXadOmTYwaNSrGjh0bAwYMiJNOOineeOONmDZt2mZvtWjTpk2MHj06xowZE9/97nfjlFNOiQ8++CDuvPPOOPzww3O/8K6wsDCuvfbauOSSS+L444+PQYMGxfz582PChAmx1157bfZP4gcMGBDXXXddDBs2LI455ph4++23Y+LEidtld5mGDRvGDTfcEMOGDYtevXrF4MGDc6c87tSpU/zsZz/bovXutddeMWnSpDjzzDNj//33j6FDh0a3bt1i9erV8dJLL8XUqVNzx0J07949zjnnnLj77rtjyZIl0atXr3j11VfjgQceiIEDB1bairUxl19+eTz22GMxYMCAOPfcc+Owww6LFStWxNtvvx0PP/xwzJ8/P3bdddc4//zz44svvojjjz8+2rdvHx9++GHcfvvtccghh+S28mzuuoqLi+OAAw6Ihx56KPbZZ59o1apVdOvWLbp161btjCeccELsueee8aMf/Sguv/zyqF+/ftx3333Rpk2b+Nvf/pZb7oEHHog777wzTj311Nhrr71i2bJlcc8990Tz5s1zgbc1DjvssPj+978ft956ayxevDh3yuO//vWvEbH5W5AKCgrirLPOil//+tcREXHddddVu9wVV1wRb775Ztxwww3x8ssvx/e///0oLi6OF154IR588ME48MADY8KECVUeV1JSUuV3OlXwSyehjsrbecuAnUrFqVsrLoWFhdluu+2Wfec738nGjRuXLV26tNrHzZ07Nxs6dGi22267ZQ0bNsz22GOPbMCAAdnDDz9cZd0bnga24jTA//Vf/5W7bd26ddmYMWOy3XffPSsuLs569+6dvfPOO1nHjh2rPeXxxk4t+y//8i/ZfvvtlzVs2DD7xje+kV144YXZl19+WWW52267LevYsWNWVFSUHXHEEdmLL76YHXbYYdl3v/vdKnNOnTq1yuNXrVqV/fznP8/N27Nnz+zll1/OevXqVe1pkzdcx8ZeR8UpcD/77LNqX9/6HnrooezQQw/NioqKslatWmVDhgzJPvroo816nk3561//mg0fPjzr1KlTVlhYmDVr1izr2bNndvvtt1c6zfWaNWuyMWPGZJ07d84aNmyYdejQIRs9enSlZbLsq1Me9+/fv9rnWrZsWTZ69Oisa9euWWFhYbbrrrtmxxxzTPZP//RPuVNEP/zww9kJJ5yQtW3bNissLMz23HPP7IILLsg++eSTGq8ry7LspZdeyg477LCssLBws04XPHPmzOzII4/MPfctt9xS5ZTHs2bNygYPHpztueeeWVFRUda2bdtswIAB2euvv15pXRs+38b+vTdcf5Zl2YoVK7IRI0ZkrVq1ypo2bZoNHDgw++CDD7KIyH7zm99s8jWs7913380iIisqKqr2/0aF8vLybMKECVnPnj2zZs2a5T5H9O3bNysrK6uy/KZOeezbFqi7CrJsOx+lCbATKy8vjzZt2sRpp50W99xzT77Hgc3y5ptvxqGHHhoPPvhgpdMW14Y1a9bEySefHM8991w8/vjjlc7eBrAxjmkB2EKrVq2qcvzBv/3bv8UXX3wRvXv3zs9Q8DVKS0ur3HbrrbdGvXr14lvf+latP3/Dhg3j97//fRxyyCFxxhlnVPv7iAA2ZEsLwBaaMWNG/OxnP4szzjgjWrduHbNmzYp777039t9//5g5c2YUFhbme0SoYsyYMTFz5szo06dPNGjQIHf65x//+Mdx11135Xs8gGqJFoAtNH/+/PjpT38ar776anzxxRfRqlWrOOmkk+I3v/lNlV+WB6l45plnYsyYMfGXv/wlli9fHnvuuWf88Ic/jF/+8pfRoIHz8wBpEi0AAEDSHNMCAAAkTbQAAABJ2+47r5aXl8ff//73aNas2Wb/EisAAGDnk2VZLFu2LNq1axf16m18e8p2j5a///3v0aFDh+39tAAAQKIWLFgQ7du33+j92z1amjVrFhFfDda8efPt/fQAAEAili5dGh06dMg1wsZs92ip2CWsefPmogUAAPjaw0YciA8AACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQtAb5HgDyKcuyKF2zLt9jAMB2U9ywfhQUFOR7DKgR0UKdlWVZnP7bl2Pmh1/mexQA2G56dNwlpv7kaOHCDsXuYdRZpWvWCRYA6pzXP/zSXgbscGxpgYh4/R/6RuPC+vkeAwBqzcrV66LHr57N9xiwRUQLRETjwvrRuNB/BwCAFNk9DAAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJJWo2i59tpro6CgoNJlv/32q63ZAAAAokFNH3DggQfGs88++38raFDjVQAAAGy2GhdHgwYNYrfddquNWQAAAKqo8TEts2fPjnbt2kWXLl1iyJAh8be//a025gIAAIiIGm5pOfLII2PChAmx7777xieffBJjxoyJ4447Lt55551o1qxZtY8pKyuLsrKy3PWlS5du3cQAAECdUqNo6devX+7vBx98cBx55JHRsWPHmDJlSvzoRz+q9jFjx46NMWPGbN2UAABAnbVVpzxu2bJl7LPPPjFnzpyNLjN69OgoKSnJXRYsWLA1TwkAANQxWxUty5cvj7lz58buu+++0WWKioqiefPmlS4AAACbq0bRMmrUqHj++edj/vz58dJLL8Wpp54a9evXj8GDB9fWfAAAQB1Xo2NaPvrooxg8eHAsXrw42rRpE8cee2y88sor0aZNm9qaDwAAqONqFC2TJ0+urTkAAACqtVXHtAAAANQ20QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkLQG+R6Ar5dlWZSuWZfvMXY6K1evrfbvbDvFDetHQUFBvscAAHZwoiVxWZbF6b99OWZ++GW+R9mp9fjVc/keYafUo+MuMfUnRwsXAGCr2D0scaVr1gkWdlivf/ilrYQAwFazpWUH8vo/9I3GhfXzPQZ8rZWr10WPXz2b7zEAgJ2EaNmBNC6sH40L/ZMBAFC32D0MAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACStlXR8pvf/CYKCgpi5MiR22gcAACAyrY4Wl577bW466674uCDD96W8wAAAFSyRdGyfPnyGDJkSNxzzz2xyy67bOuZAAAAcrYoWkaMGBH9+/ePvn37but5AAAAKmlQ0wdMnjw5Zs2aFa+99tpmLV9WVhZlZWW560uXLq3pUwIAAHVYjba0LFiwIC699NKYOHFiNGrUaLMeM3bs2GjRokXu0qFDhy0aFAAAqJtqFC0zZ86MRYsWxTe/+c1o0KBBNGjQIJ5//vm47bbbokGDBrFu3boqjxk9enSUlJTkLgsWLNhmwwMAADu/Gu0e9u1vfzvefvvtSrcNGzYs9ttvv/h//+//Rf369as8pqioKIqKirZuSgAAoM6qUbQ0a9YsunXrVum2Jk2aROvWravcDgAAsC1s1S+XBAAAqG01PnvYhmbMmLENxgAAAKieLS0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJq1G0jB8/Pg4++OBo3rx5NG/ePI4++uiYNm1abc0GAABQs2hp3759/OY3v4mZM2fG66+/Hscff3x873vfi3fffbe25gMAAOq4BjVZ+OSTT650/R//8R9j/Pjx8corr8SBBx64TQcDAACIqGG0rG/dunUxderUWLFiRRx99NHbciYAAICcGkfL22+/HUcffXSsWrUqmjZtGo8++mgccMABG12+rKwsysrKcteXLl26ZZMCAAB1Uo3PHrbvvvvGm2++GX/+85/jwgsvjHPOOSf+8pe/bHT5sWPHRosWLXKXDh06bNXAAABA3VLjaCksLIyuXbvGYYcdFmPHjo3u3bvHuHHjNrr86NGjo6SkJHdZsGDBVg0MAADULVt8TEuF8vLySrt/baioqCiKioq29mkAAIA6qkbRMnr06OjXr1/sueeesWzZspg0aVLMmDEjnn766dqaDwAAqONqFC2LFi2KoUOHxieffBItWrSIgw8+OJ5++un4zne+U1vzAQAAdVyNouXee++trTkAAACqVeMD8QEAALYn0QIAACRtq88eBtRMlmVRurY032PUqpVr1q3399KIgvp5nGb7KG5QHAUFBfkeAwB2SqIFtqMsy2LotKHx5mdv5nuUWpWVN4yI6yMioveUXlFQb01+B9oODm17aDzw3QeECwDUAtEC21Hp2tKdPlgiIgrqrYlm+1+Z7zG2qzcWvRGla0ujccPG+R4FAHY6ogXyZMagGVHcoDjfY7CVSteWRu8pvfM9BgDs1EQL5Elxg2I/lQcA2AzOHgYAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASatRtIwdOzYOP/zwaNasWbRt2zYGDhwYH3zwQW3NBgAAULNoef7552PEiBHxyiuvxDPPPBNr1qyJE044IVasWFFb8wEAAHVcg5os/NRTT1W6PmHChGjbtm3MnDkzvvWtb23TwQAAACJqGC0bKikpiYiIVq1abXSZsrKyKCsry11funTp1jwlAABQx2zxgfjl5eUxcuTI6NmzZ3Tr1m2jy40dOzZatGiRu3To0GFLnxIAAKiDtjhaRowYEe+8805Mnjx5k8uNHj06SkpKcpcFCxZs6VMCAAB10BbtHnbxxRfHE088EX/605+iffv2m1y2qKgoioqKtmg4AACAGkVLlmVxySWXxKOPPhozZsyIzp0719ZcAAAAEVHDaBkxYkRMmjQp/uM//iOaNWsWn376aUREtGjRIoqLi2tlQAAAoG6r0TEt48ePj5KSkujdu3fsvvvuuctDDz1UW/MBAAB1XI13DwPIhyzLonRtab7HqGL9mVKcr7hBcRQUFOR7DADYKlv1e1oAtocsy2LotKHx5mdv5nuUTeo9pXe+R6ji0LaHxgPffUC4ALBD2+JTHgNsL6VrS5MPllS9seiNJLcAAUBN2NIC7FBmDJoRxQ2c+OPrlK4tTXLLDwBsCdEC7FCKGxRH44aN8z0GALAd2T0MAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACS1iDfAyQjyyLWrMz3FFWtXrfe31dGRP28jbJRDRtHFBTkewoAAHZSoiXiq2C578SIBX/O9yRVZUURcf9Xf7+pa0RBWV7HqVaHoyLOe0q4AABQK0RLxFdbWFIMlohoXFAW8xudle8xNm3BK1+9h4VN8j0JAAA7IdGyoVFzIgob53uKHcPqlRH/1DXfUwAAsJMTLRsqbGyLAQAAJMTZwwAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABImmgBAACSJloAAICkiRYAACBpogUAAEiaaAEAAJImWgAAgKSJFgAAIGmiBQAASJpoAQAAkiZaAACApIkWAAAgaaIFAABIWoN8DwAAsL4syyIrLc33GDud8tXr/u/vK0ujfG39PE6zcyooLo6CgoJ8j7FTEi0AQDKyLIsPzxoSpW+8ke9Rdjqr6hdGnPzriIiY3fPYaLRudZ4n2vkUf/Ob0XHig8KlFogWACAZWWmpYKkljdatjml/GJXvMXZqpbNmRVZaGgWNG+d7lJ2OaAEAkrT3iy9EveLifI8BX6u8tDRm9zw232Ps1EQLAJCkesXFUc9PrIFw9jAAACBxNY6WP/3pT3HyySdHu3btoqCgIP7whz/UwlgAAABfqXG0rFixIrp37x533HFHbcwDAABQSY2PaenXr1/069evNmYBAACootYPxC8rK4uysrLc9aVLl9b2UwIAADuRWj8Qf+zYsdGiRYvcpUOHDrX9lAAAwE6k1qNl9OjRUVJSkrssWLCgtp8SAADYidT67mFFRUVRVFRU208DAADspPyeFgAAIGk13tKyfPnymDNnTu76vHnz4s0334xWrVrFnnvuuU2HAwAAqHG0vP7669GnT5/c9csuuywiIs4555yYMGHCNhsMAAAgYguipXfv3pFlWW3MAgAAUIVjWgAAgKTV+tnDAABgW8iyLLLS0nyPUUX5ejOVJzhfRERBcXEUFBTke4wtJloAAEhelmXx4VlDovSNN/I9yibN7nlsvkeoVvE3vxkdJz64w4aL3cMAAEheVlqafLCkrHTWrCS3Um0uW1oAANih7P3iC1GvuDjfY+wQyktLk936UxOiBQCAHUq94uKo17hxvsdgO7J7GAAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJEy0AAEDSRAsAAJA00QIAACRNtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASWuQ7wEAgM2TZVlkpaX5HqNWla/3+sp38tcaEVFQXBwFBQX5HgOSJ1oAYAeQZVl8eNaQKH3jjXyPst3M7nlsvkeodcXf/GZ0nPigcIGvYfcwANgBZKWldSpY6orSWbN2+q1nsC3Y0gIAO5i9X3wh6hUX53sMtkJ5aWmd2JIE24poAYAdTL3i4qjXuHG+xwDYbuweBgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJc8pjAFhPlmVJ/rK/8vVmKk9wvoLiYr/VHag1ogUA/leWZfHhWUOS/83zKf5SwuJvfjM6TnxQuAC1wu5hAPC/stLS5IMlVaWzZiW5hQrYOdjSAgDV2PvFF6JecXG+x0heeWlpklt+gJ3LFkXLHXfcETfddFN8+umn0b1797j99tvjiCOO2NazAUDe1CsujnqNG+d7DABiC3YPe+ihh+Kyyy6La665JmbNmhXdu3ePE088MRYtWlQb8wEAAHVcjaPllltuieHDh8ewYcPigAMOiN/+9rfRuHHjuO+++2pjPgAAoI6r0e5hq1evjpkzZ8bo0aNzt9WrVy/69u0bL7/8crWPKSsri7Kystz1kpKSiIhYunTplsxbO1aviCjLvvr70qURhevyO8+OwvtWYyvXrIx1pV+9T0uXLo21DdfmeaIdg/et5rxnW6Z85cpYvu7/3rd6a71vX8d7tmW8bzXnPdsyqb9vFU2QZdmmF8xq4OOPP84iInvppZcq3X755ZdnRxxxRLWPueaaa7KIcHFxcXFxcXFxcXFxqfayYMGCTXZIrZ89bPTo0XHZZZflrpeXl8cXX3wRrVu3di53AACow7Isi2XLlkW7du02uVyNomXXXXeN+vXrx8KFCyvdvnDhwthtt92qfUxRUVEUFRVVuq1ly5Y1eVoAAGAn1aJFi69dpkYH4hcWFsZhhx0Wzz33XO628vLyeO655+Loo4+u+YQAAABfo8a7h1122WVxzjnnRI8ePeKII46IW2+9NVasWBHDhg2rjfkAAIA6rsbRcuaZZ8Znn30WV199dXz66adxyCGHxFNPPRXf+MY3amM+AACgjivIvvb8YgAAAPlT418uCQAAsD2JFgAAIGmiBQAASJpoAQAAkiZa/tedd94ZBQUFceSRR+Z7lORNmDAhCgoKKl3atm0bffr0iWnTpuV7vKTNnTs3LrjggujSpUs0atQomjdvHj179oxx48ZFaWlpvsdLSsXH2euvv17t/b17945u3bpt56l2PF/3PvJ/qvvcVnG58sor8z1e0nyc1cy8efPi4osvjn322ScaN24cjRs3jgMOOCBGjBgRb731Vr7HS86G/zcbNWoU7dq1ixNPPDFuu+22WLZsWb5HTNKmPqcVFBTEK6+8ku8Ra6TGpzzeWU2cODE6deoUr776asyZMye6du2a75GSd91110Xnzp0jy7JYuHBhTJgwIU466aR4/PHHY8CAAfkeLzlPPvlknHHGGVFUVBRDhw6Nbt26xerVq+OFF16Iyy+/PN599924++678z0m1HkVn9vWJ5DZVp544ok488wzo0GDBjFkyJDo3r171KtXL95///145JFHYvz48TFv3rzo2LFjvkdNTsX/zTVr1sSnn34aM2bMiJEjR8Ytt9wSjz32WBx88MH5HjFJ1X1Oi4gd7ntd0RJf/cTjpZdeikceeSQuuOCCmDhxYlxzzTX5Hit5/fr1ix49euSu/+hHP4pvfOMb8e///u+iZQPz5s2LH/zgB9GxY8eYPn167L777rn7RowYEXPmzIknn3wyjxMCFTb83Abbyty5c3NfC5577rlKXwsiIm644Ya48847o149O8JUZ8P/m6NHj47p06fHgAED4pRTTon33nsviouL8zhhmnaWz2n+V8RXW1l22WWX6N+/f5x++ukxceLEfI+0Q2rZsmUUFxdHgwZaeEM33nhjLF++PO69994qX6Qivvppx6WXXpqHyQDYXm688cZYsWJF3H///dV+LWjQoEH89Kc/jQ4dOuRhuh3T8ccfH1dddVV8+OGH8eCDD+Z7HGqRaImvouW0006LwsLCGDx4cMyePTtee+21fI+VvJKSkvj888/js88+i3fffTcuvPDCWL58eZx99tn5Hi05jz/+eHTp0iWOOeaYfI+yw6n4ONvwsmbNmnyPxk6quo852BaeeOKJ6Nq1q+Nnt7Ef/vCHERHxxz/+Mc+TpKm6z2mLFy/O91g1Vud/JD5z5sx4//334/bbb4+IiGOPPTbat28fEydOjMMPPzzP06Wtb9++la4XFRXFfffdF9/5znfyNFGali5dGh9//HF873vfy/coO6QNP87Wd+CBB27HSagrqvuYy7IsD5OwM1m6dGn8/e9/j4EDB1a5b8mSJbF27drc9SZNmtjNqQbat28fLVq0iLlz5+Z7lCRV9zmtqKgoVq1alYdptlydj5aJEyfGN77xjejTp09ERBQUFMSZZ54ZDz74YNx8881Rv379PE+YrjvuuCP22WefiIhYuHBhPPjgg3H++edHs2bN4rTTTsvzdOlYunRpREQ0a9Ysz5PsmNb/OFvfz3/+81i3bl0eJmJnt7GPOdgaFV8LmjZtWuW+3r17x//8z//krt90000xatSo7TbbzqBp06bOIrYR1X1O2xG/v63T0bJu3bqYPHly9OnTJ+bNm5e7/cgjj4ybb745nnvuuTjhhBPyOGHajjjiiEoHdg0ePDgOPfTQuPjii2PAgAFRWFiYx+nS0bx584gIn0y30IYfZxV22WUXu+1QKzb2MQdbo+IHV8uXL69y31133RXLli2LhQsX2sV6Cy1fvjzatm2b7zGStLN8TqvT0TJ9+vT45JNPYvLkyTF58uQq90+cOFG01EC9evWiT58+MW7cuJg9e7Zdd/5X8+bNo127dvHOO+/kexQA8qRFixax++67V/u1oOIYl/nz52/nqXYOH330UZSUlOxwp/ClZur0gfgTJ06Mtm3bxtSpU6tcBg8eHI8++qhf+FdDFfvkVveTpLpswIABMXfu3Hj55ZfzPQoAedK/f/+YM2dOvPrqq/keZafyu9/9LiIiTjzxxDxPQm2qs9FSWloajzzySAwYMCBOP/30KpeLL744li1bFo899li+R91hrFmzJv74xz9GYWFh7L///vkeJylXXHFFNGnSJM4///xYuHBhlfvnzp0b48aNy8NkAGwvV1xxRTRu3DjOO++8ar8WOOFDzU2fPj2uv/766Ny5cwwZMiTf41CL6uzuYY899lgsW7YsTjnllGrvP+qoo6JNmzYxceLEOPPMM7fzdDuGadOmxfvvvx8REYsWLYpJkybF7Nmz48orr8wdx8FX9tprr5g0aVKceeaZsf/++8fQoUOjW7dusXr16njppZdi6tSpce655+Z7TABq0d577x2TJk2KwYMHx7777htDhgyJ7t27R5ZlMW/evJg0aVLUq1cv2rdvn+9Rk1TxfcfatWtj4cKFMX369HjmmWeiY8eO8dhjj0WjRo3yPWKS1v9+bX3HHHNMdOnSJQ8TbZk6Gy0TJ06MRo0abfT0vPXq1Yv+/fvHxIkTY/HixdG6devtPGH6rr766tzfGzVqFPvtt1+MHz8+LrjggjxOla5TTjkl3nrrrbjpppviP/7jP2L8+PFRVFQUBx98cNx8880xfPjwfI8IsEUqthDsiGck2t6+973vxdtvvx0333xz/PGPf4z77rsvCgoKomPHjtG/f//4yU9+Et27d8/3mEmq+L6jsLAwWrVqFQcddFDceuutMWzYMGfo3IT1v19b3/33379DRUtBZlskALAVbrvttrj00ktjzpw5sddee+V7HGAnVGePaQEAto3XXnstmjRpEh07dsz3KMBOqs7uHgYAbJ3f//73MWPGjJg4cWKcf/750aCBbyuA2mH3MABgi3Tu3DmWLVsWp556atx6663RpEmTfI8E7KRECwAAkDTHtAAAAEkTLQAAQNJECwAAkDTRAgAAJE20AAAASRMtAABA0kQLAACQNNECAAAkTbQAAABJ+/9NVsdwRnDnBwAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 1000x1000 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "dendo = Dendrogram(coreset_df, hierarchial_clustering_sequence)\n",
+    "dendo.plot_dendrogram(plot_title=\"Dendrogram of Coreset using VQE\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Each branch point in the dendrogram aboves corresponds to one of the plots below. Notice the first iterations are the most complicated, and the final iterations become trivial bipartitioning of two points. Occasionally, especially in the first iteration, the partitioning might be puzzling at first glance. The data might seem to naturally cluster into two groups. However, there are cases where a stray point seems to belong in the wrong cluster.  There are two explanations for this.  1) The quantum sampling is approximate and stochastic. It is possible that too few shots were taken to sample the ground state of the problem. 2) It is important to remember that we are clustering coresets and not data points. There can be cases where it is optimal to pay a penalty by excluding a point based on proximity if the weights are small enough that the penalty has less impact. Usually, if a point looks unusually clustered and you go look at the original coresets plotted above, that point will have a small weight."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAABKUAAASmCAYAAAD/KRjlAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAEAAElEQVR4nOzdeVwV9f7H8fcAcsAFXNkUFbXct1wIbdEi0cwr1TX12nVJ7Wbq1Uub9CuXLM1WM00zt7pm2mplXdQw9Zq4R2qppbnLwRUQVEDO/P7geurEIhqcA4fX8/GYh57vfGfOZ0aZL/OZ7/c7hmmapgAAAAAAAAAn8nB1AAAAAAAAACh/SEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISgEAAAAAAMDpSEoBAAAAAADA6UhKAQAAAAAAwOlISqFY1a9fX4MHD3Z1GNdl0aJFMgxDhw4dcnUoxWbw4MGqX7++q8O4Jl26dFGXLl1cHQaAYkb7ULrQPgAoLWgfShfaBzgbSSkUyYEDB/SPf/xDDRo0kI+Pj/z8/NS5c2e98cYbunjxolNiuHDhgiZOnKi1a9c65ftKo40bN2rixIlKSUm5ru1Lyzn86aefNHHixFLXgNtsNr300ksKCwuTj4+PWrVqpQ8++MDVYQGlGu1D6UD7ULJeeOEF/eUvf1FgYKAMw9DEiRNdHRJQ6tE+lA60DyVn7969evLJJ9WmTRtVqVJFwcHB6tmzp7Zt2+bq0MoWE7iKFStWmL6+vmbVqlXNf/7zn+bcuXPNmTNnmv369TMrVKhgDh8+3F63Xr165qBBg0okjlOnTpmSzAkTJpTI/i9fvmxevHjRtNlsJbL/4vDyyy+bksyDBw8WqX5WVpZ56dIl++eSPodF9dFHH5mSzG+//TbPuszMTDMzM9P5QZmmOW7cOFOSOXz4cHPu3Llmz549TUnmBx984JJ4gNKO9qH0oH0oWZLMoKAgMyoqqlScJ6C0o30oPWgfSs5jjz1mVq1a1Rw6dKj59ttvmy+99JLZsGFD09PT01y9erXT4ymrvJyfBkNZcvDgQfXr10/16tXTmjVrFBwcbF83cuRI7d+/X1999ZULI/zzMjIyVKlSJXl6esrT09PV4RSrChUqOOV7rpzD4uDt7V0s+7lWx48f16uvvqqRI0dq5syZkqRhw4bp9ttv1xNPPKE+ffq43f8P4M+gfSjbaB+uzcGDB1W/fn2dPn1atWrVclkcQFlA+1C20T4UXf/+/TVx4kRVrlzZXvbQQw+padOmmjhxoiIjI10SV5nj6qwYSrdHHnnElGR+9913Rar/xycdEyZMMPP7b7Zw4cI8GfutW7ea3bp1M2vUqGH6+PiY9evXN4cMGWKapmkePHjQlJRn+X3Gfs+ePeb9999vVqtWzbRYLGa7du3Mzz//PN/vXbt2rTlixAizVq1aZtWqVQuMqV69embPnj3N//73v2aHDh1Mi8VihoWFme+++26eY/rhhx/M2267zfTx8TFr165tTp482VywYEGRnkz88MMP5qBBg8ywsDDTYrGYgYGB5pAhQ8zTp0/nOZd/XArb96BBg8x69eo57RweOnTIHDFihHnjjTeaPj4+ZvXq1c2//vWvDjFe2f6Py5WnHrfffrt5++23O3xncnKy+dBDD5kBAQGmxWIxW7VqZS5atMihzpXje/nll823337bbNCggent7W22b9/e3LJlS6Hn3zRNc9asWaYk88cff3QoX7JkiSnJ/O9//3vVfQDlCe0D7UN5aR9+r7T0GABKM9oH2ofy2D783n333WdWr179urcvb+gphUJ9+eWXatCggTp16lSi33Py5El169ZNtWrV0rhx41S1alUdOnRIn376qSSpVq1amj17tkaMGKF7771X9913nySpVatWkqQff/xRnTt3Vu3atTVu3DhVqlRJH374oaKjo/XJJ5/o3nvvdfi+Rx99VLVq1dL48eOVkZFRaGz79+/XX//6Vw0dOlSDBg3SggULNHjwYLVr107NmzeXlNvLpmvXrjIMQ7GxsapUqZLmzZsni8VSpONfvXq1fv31Vw0ZMkRBQUH68ccfNXfuXP3444/atGmTDMPQfffdp59//lkffPCBXn/9ddWsWdN+borCGedw69at2rhxo/r166c6dero0KFDmj17trp06aKffvpJFStW1G233aZ//vOfmjFjhp5++mk1bdpUkux//tHFixfVpUsX7d+/X6NGjVJYWJg++ugjDR48WCkpKRozZoxD/SVLluj8+fP6xz/+IcMw9NJLL+m+++7Tr7/+WuiTn++//16VKlXKE0fHjh3t62+55ZYinWugPKB9oH0oL+0DgGtD+0D7UN7bB6vVaj/XKAJXZ8VQeqWmppqSzN69exd5m+t90vHZZ5+ZksytW7cWuO/Cnk7eeeedZsuWLR3GP9tsNrNTp07mDTfckOd7b7nlFvPy5cuFxnTleCSZ69evt5edPHnStFgs5mOPPWYvGz16tGkYhvn999/by86cOWNWr169SE86Lly4kKfsgw8+yPPd1zom/PdPOkyz5M9hfseRkJBgSjLfe+89e1lhY8L/+KRj+vTppiRz8eLF9rKsrCwzIiLCrFy5spmWlmaa5m9POmrUqGGePXvWXvfzzz83JZlffvll3hP0Oz179jQbNGiQpzwjI8OUZI4bN67Q7YHyhPaB9qE8tQ+/R08poHC0D7QP5bV9uGL9+vWmYRjms88+e83blle8fQ8FSktLkyRVqVKlxL+ratWqkqQVK1YoOzv7mrY9e/as1qxZowceeEDnz5/X6dOndfr0aZ05c0ZRUVH65ZdfdPz4cYdthg8fXuTx382aNdOtt95q/1yrVi01btxYv/76q70sLi5OERERatOmjb2sevXqGjBgQJG+w9fX1/73S5cu6fTp07r55pslSTt27CjSPv6M4jqHvz+O7OxsnTlzRo0aNVLVqlWv+zi+/vprBQUFqX///vayChUq6J///KfS09O1bt06h/p9+/ZVtWrV7J+v/Nv9/t8rPxcvXsz3yZSPj499PYBctA+5aB/KR/sAoOhoH3LRPpTP9uHkyZP629/+prCwMD355JPXFXt5RFIKBfLz85MknT9/vsS/6/bbb9f999+vSZMmqWbNmurdu7cWLlyozMzMq267f/9+maapZ599VrVq1XJYJkyYICn3AvF7YWFhRY6tbt26ecqqVaumc+fO2T8fPnxYjRo1ylMvv7L8nD17VmPGjFFgYKB8fX1Vq1Yte4ypqalFjvV6Fdc5vHjxosaPH6/Q0FBZLBbVrFlTtWrVUkpKynUfx+HDh3XDDTfIw8PxcnWlu+7hw4cdyv/473Wlgfn9v1d+fH198/3/dunSJft6ALloH3LRPpSP9gFA0dE+5KJ9KH/tQ0ZGhu655x6dP39en3/+ucPk5ygcc0qhQH5+fgoJCdHu3buvex+GYeRbnpOTk6fexx9/rE2bNunLL7/UypUr9dBDD+nVV1/Vpk2bCv2httlskqTHH39cUVFR+db548X9WhIMBT0RMU2zyPu4mgceeEAbN27UE088oTZt2qhy5cqy2Wzq3r27/fhKUnGdw9GjR2vhwoUaO3asIiIi5O/vL8Mw1K9fP6cch3T9/17BwcH69ttvZZqmw//bpKQkSVJISEjxBQmUcbQPuWgfcrl7+wCg6GgfctE+5Cov7UNWVpbuu+8+7dy5UytXrlSLFi2KMzy3R1IKhbrnnns0d+5cJSQkKCIi4pq3v5JlTklJsXexlfJmp6+4+eabdfPNN+uFF17QkiVLNGDAAC1dulTDhg0rsIFq0KCBpNwuma567Wa9evW0f//+POX5lf3RuXPnFB8fr0mTJmn8+PH28l9++SVP3YLOQVGV9Dn8+OOPNWjQIL366qv2skuXLiklJaVIceSnXr162rlzp2w2m8PTjr1799rXF4c2bdpo3rx52rNnj5o1a2Yv37x5s309gN/QPhQN7UOustw+ALg2tA9FQ/uQq6y3DzabTQMHDlR8fLw+/PBD3X777cW27/KC4Xso1JNPPqlKlSpp2LBhSk5OzrP+wIEDeuONNwrcvmHDhpKk9evX28syMjL07rvvOtQ7d+5cnkz0lSTAlS64FStWlKQ8F6iAgAB16dJFb7/9tr1Xy++dOnWqwPiKS1RUlBISEpSYmGgvO3v2rN5///2rbnslM//H458+fXqeupUqVZKU9xwUVUmfQ09PzzzH8eabb+Z5snUtx3H33XfLarVq2bJl9rLLly/rzTffVOXKlYvtwt+7d29VqFBBb731lr3MNE3NmTNHtWvXLvE3yABlDe1D0dA+5CrL7QOAa0P7UDS0D7nKevswevRoLVu2TG+99Zb97YS4NvSUQqEaNmyoJUuWqG/fvmratKkGDhyoFi1aKCsrSxs3brS/WrMg3bp1U926dTV06FA98cQT8vT01IIFC1SrVi0dOXLEXu/dd9/VW2+9pXvvvVcNGzbU+fPn9c4778jPz0933323pNzuns2aNdOyZct04403qnr16mrRooVatGihWbNm6ZZbblHLli01fPhwNWjQQMnJyUpISNCxY8f0ww8/lOh5evLJJ7V48WLdddddGj16tP2VrnXr1tXZs2cLzez7+fnptttu00svvaTs7GzVrl1bq1at0sGDB/PUbdeunSTp//7v/9SvXz9VqFBBvXr1sl+kr6akz+E999yjf//73/L391ezZs2UkJCgb775RjVq1HCo16ZNG3l6emratGlKTU2VxWLRHXfc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vSw8PFyLFi1SXFycZs+erYMHD+rWW2/V+fPn891HZmam0tLSHJayzrzwkSTPAtdnZplKOrhIVqvVvpw+fdp5AQIoM9wqKTV79my1atVKfn5+9okJ//Of/xS6zUcffaQmTZrIx8dHLVu21Ndff+2kaIHSy3roZJ6yEzqk6gqQl1FBknT+XIYuZVySJN1///3atm2bdu7c6dQ4AXdgPXhSnhUcf7H/48+baTN16mjufB38vAGAcyxZskSTJk3Shx9+qICAAHt5jx491KdPH7Vq1UpRUVH6+uuvlZKSog8//DDf/UydOlX+/v72JTQ01FmHUHJyjkrKKXD1ym8vqHbL7xQcHGxfbrnlFufFB6DMcKukVJ06dfTiiy9q+/bt2rZtm+644w717t1bP/74Y771N27cqP79+2vo0KH6/vvvFR0drejoaO3evdvJkQOlS5VqlR3mtpGkNkZntTV++2XCy9tL3r7ekqSOHTvKNE21atXKqXEC7qBK9cqy5dgcyv7483alnsTPGwA4w9KlSzVs2DB9+OGHioyMLLRu1apVdeONN2r//v35ro+NjVVqaqp9OXr0aEmE7FweVVVQT6mFbwQpJ+kG5Vg7yDRN+7J3716nhgigbHCrpFSvXr10991364YbbtCNN96oF154QZUrV9amTZvyrf/GG2+oe/fueuKJJ9S0aVNNnjxZN910k2bOnOnkyIHSpWv/W5RzueCnXx5eHurar7M8PQvutg2gaG79682Frjc8DDXu0EhB9QMKrQcAKB4ffPCBhgwZog8++EA9e/a8av309HQdOHBAwcHB+a63WCz2kRxXlrLO8LlHhfWUkjwl32gnRQOgLHOrpNTv5eTkaOnSpcrIyFBERES+dRISEvI8+YiKilJCQkKh+3bHceHA7zXv1Fjto9rkmVdKkjw8PFTBu4L6PhXt/MCAfJTE0G3TNDV+/HgFBwfL19dXkZGR+uWXX0ok/poh1RU9uof+0DkxlyHJlB56oX+JfDcAuLv09HQlJiYqMTFRknTw4EElJibaJyaPjY3VwIED7fWXLFmigQMH6tVXX1V4eLh9PqTU1FR7nccff1zr1q3ToUOHtHHjRt17773y9PRU//7l6FptuV2q0Fr595bylIxKMioNdnJQAMoit0tK7dq1S5UrV5bFYtEjjzyizz77TM2aNcu3rtVqVWBgoENZYGCg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Zw4LANwKPaUAAG4lNTVVklS9evUib3PhwgVlZ2fn2Wbt2rUKCAhQ48aNNWLECJ05c6bAfWRmZiotLc1hAQCULRERERo4cKDatGmj22+/XZ9++qlq1aqlt99++7r3OXXqVPn7+9uX0NDQYowYAMo2klIAALdhs9k0duxYde7cWS1atCjydk899ZRCQkIchmN0795d7733nuLj4zVt2jStW7dOPXr0UE5OTr774KYDAEqXmjVrytPTU8nJyQ7lycnJRe4FW6FCBbVt21b79++XJPt217LP2NhYpaam2pejR49e66EAgNsiKQUAcBsjR47U7t27tXTp0iJv8+KLL2rp0qX67LPPHF773a9fP/3lL39Ry5YtFR0drRUrVmjr1q1au3ZtvvvhpgMAShdvb2+1a9dO8fHx9jKbzab4+HhFREQUaR85OTnatWuXgoODJUlhYWEKCgpy2GdaWpo2b95c4D4tFov8/PwcFgBALrdKSq1fv169evVSSEiIDMO46hsw1q5dm+fNSoZhFDgeHABQeo0aNUorVqzQt99+qzp16hRpm1deeUUvvviiVq1apVatWhVat0GDBqpZs6b9afkfcdMBAKVPTEyM3nnnHb377rvas2ePRowYoYyMDA0ZMkSSNHDgQMXGxtrrP/fcc1q1apV+/fVX7dixQw8++KAOHz6sYcOGScp9M9/YsWP1/PPP64svvtCuXbs0cOBAhYSEKDo62hWHCABlmltNdJ6RkaHWrVvroYce0n333Vfk7fbt2+dw8xAQEFAS4QEASoBpmho9erQ+++wzrV27VmFhYUXa7qWXXtILL7yglStXqn379letf+zYMZ05c8b+tBwAUPr17dtXp06d0vjx42W1WtWmTRvFxcXZJyo/cuSIPDx+e05/7tw5DR8+XFarVdWqVVO7du20ceNGNWvWzF7nySefVEZGhh5++GGlpKTolltuUVxcnENvWwBA0RimaZquDqIkGIahzz77rNAnFmvXrlXXrl117tw5Va1a9bq/Ky0tTf7+/kpNTeXJOIAyp6xfwx599FEtWbJEn3/+uRo3bmwv9/f3l6+vr6TcJ+G1a9fW1KlTJUnTpk3T+PHjtWTJEnXu3Nm+TeXKlVW5cmWlp6dr0qRJuv/++xUUFKQDBw7oySef1Pnz57Vr1y5ZLJarxlXWzysAcB0rGZxXAGVdcV7H3Gr4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iRO213/++afq16+fq19ebXk5fvy4RowYoZCQEJUvX15BQUG2GNPS0god69Uqrn14+vRpjRkzRuHh4bJarapataqCgoKUmpp61eP4888/1aBBA3l42B+uLp6u++eff9q1X/5+XUwwl75fBalVq5aioqLUr18/ffrpp6pbt66ioqIoTAGXID9cQH4oG/nhrbfe0tGjR21PnwKQP/LDBeSHspEf8hIYGKhBgwZp+/btOnDgQJGXL4u4pxTy5efnp7CwMG3ZsuWq12GxWPJsz87OztVv7ty5Wrt2rb755hstWbJEgwcP1htvvKG1a9eqUqVK+W7j4iNLn3jiCUVHR+fZ5/KDe1HuD5TfLyLGmEKv40ruvfderVmzRk8++aRatmypSpUqKScnR927d7d7JKujFNc+HD58uGbOnKmRI0cqIiJC/v7+slgs6tu3r1PGIRX/+3X33Xdr2rRpWrVqVb77BihryA8XkB8uKM35IS0tTS+++KIeffRRpaen284CycjIkDFGe/fuVYUKFRQcHOyQmAF3Q364gPxwQWnODwUJDw+XdKFwWKNGjauOq6ygKIUC3X777Zo6daoSExMVERFR5OUvVplTU1Ntp9hKuavTF91444268cYb9dJLLykhIUH9+/fX7Nmz9eCDD+aboOrWrSvpwimZUVFRRY6xONSqVUs7d+7M1Z5X2+VOnDihZcuWafz48RozZoytfceOHbn65rcPCsvR+3Du3LkaOHCg3njjDVvbmTNnlJqaWqg48lKrVi398ssvysnJsfu14/fff7fNd6SLZ0g54xcnwJ2QHwqH/HCBu+aHEydOKCMjQ6+99ppee+21XPPr1KmjO+64Q/Pnz7/mbQGlBfmhcMgPF7hrfijIxcv+CntD+bKOy/dQoKeeekoVK1bUgw8+qJSUlFzzd+3apbfffjvf5evVqydJWrVqla0tMzNTH330kV2/EydO5KpEX7y++uIpuBUqVJCkXAeo4OBgRUZG6oMPPtDhw4dzxfDXX3/lG19xiY6OVmJiopKSkmxtx48f16effnrFZS9W5i8f/8SJE3P1rVixoqTc+6CwHL0PPT09c43j3XffzfXLVlHGcdtttyk5OVmff/65re38+fN69913ValSJXXp0qVQsV1JfmOcPn26LBaLbrjhhmLZDlBakB8Kh/xwgbvmh+DgYM2bNy/X1LVrV/n4+GjevHkaPXr0NW8HKE3ID4VDfrjAXfODlPcYDx48qBkzZqh58+aqVq1asWyntONMKRSoXr16SkhIUJ8+fdS4cWMNGDBATZs21dmzZ7VmzRrbozXz061bN9WsWVNDhgzRk08+KU9PT82YMUNBQUHat2+frd9HH32k999/X71791a9evV08uRJTZs2TX5+frrtttskXTjds0mTJvr888913XXXKTAwUE2bNlXTpk01adIk3XTTTWrWrJmGDh2qunXrKiUlRYmJiTpw4IB+/vlnh+6np556Sp988oluvfVWDR8+3PZI15o1a+r48eMFVvb9/PzUuXNnvfbaazp37pyqV6+u7777Tnv27MnVt3Xr1pKkZ599Vn379lW5cuXUq1cv20H6Shy9D2+//Xb9+9//lr+/v5o0aaLExER9//33qlKlil2/li1bytPTU6+++qrS0tJktVp1880353n5w0MPPaQPPvhAsbGx2rRpk2rXrq25c+dq9erVmjhxYrHdSPOll17S6tWr1b17d9v79uWXX2rDhg0aPnx4oa/vB8oK8kPhkB8ucNf8UKFCBcXExORqnz9/vtavX5/nPKCsIz8UDvnhAnfND9KF93DXrl265ZZbFBYWpr179+qDDz5QZmZmgYVXXMaZj/qD+/rjjz/M0KFDTe3atY23t7fx9fU1HTt2NO+++67dI0Avf6SrMcZs2rTJtG/f3nh7e5uaNWuaN998M9fjU3/66SfTr18/U7NmTWO1Wk1wcLC5/fbbzcaNG+3WtWbNGtO6dWvj7e2d69Gku3btMgMGDDChoaGmXLlypnr16ub22283c+fOtfW5uN28Hh2b3yNde/bsmavv5Y8dNcaYzZs3m06dOhmr1Wpq1Khh4uPjzTvvvGMkmeTk5AL374EDB0zv3r1NQECA8ff3N/fcc485dOhQno9ffeGFF0z16tWNh4fHFR/vevkjXY1x7D48ceKEGTRokKlataqpVKmSiY6ONr///nue/y6mTZtm6tatazw9Pe0e75rXvk1JSbGt19vb2zRr1szMnDnTrs/FR7q+/vrrueLKaz9e7rvvvjO33367CQsLM+XKlbP9G585c6bJyckpcFmgLCM/2CM/lL78kJeBAweaihUrFnk5oCwhP9gjP5S+/JCQkGA6d+5sgoKCjJeXl6latarp3bu32bRpU4HLwZ7FmGK82xoA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tmypjz/+WLfccou2bNmiBg0aODzu4nK17/0//vEPdejQQXfccYejQ3Soqx3/pY4ePaoXXnhBDz30kCNCLDZHjx5VdnZ2nt+7fv/99zyXKZbvaUU/oQslwb59+0xwcLD5+eefbW1XuhSuQYMGJjw83Jw/f97W9sYbb5jQ0FBHhmpzNTH/8MMPJiQkxEybNs388ssv5quvvjLh4eHmX//6lxMitnfixAnj5+dnPvzwwzznlytXziQkJNi1TZo0yQQHBzsjvDxdKeZLxcfHm8qVK9u9P85WULzp6emmdu3aZtGiRbY2V18ecqX96+rP3OWuFG9J+rzhgnLlypmIiAi7tuHDh5sbb7wx32W2bt1qqlWrZl577TXz888/m8WLF5tmzZqZwYMHOzrcIuvWrZu5/fbbC+xTEo+tBSnMmC5VEo69V3KlMZXE4/OVFOZ9KmnH8CspzJg4zuNy//znP42kAqfffvvNvPTSS+a6667LtXxQUJB5//33813/sGHDTLt27cz3339vkpKSzLhx44y/v7/55ZdfHDmsQnHk2FevXm0kmdGjR9u1N2vWzDz99NMOGU9ROXL8CxYsMPXr1zcnT560tamEXb7n6H/7F6WlpZl27dqZ7t27l/jLwQ8ePGgkmTVr1ti1P/nkk6Zdu3Z5LlMc39M4U8pNbdq0SUeOHNENN9xga8vOztaqVav03nvvKSsrS56ennbLVKtWTeXKlbNrb9y4sZKTk3X27Fl5e3uXuJiff/55PfDAA3rwwQclSc2aNVNmZqYeeughPfvss069UWBAQICuu+467dy5M8/5oaGhSklJsWtLSUlx6emqV4r5ogkTJuiVV17R999/f8WbzztSQfHu2rVLe/fuVa9evWxtOTk5ki78WrF9+3bVq1fPabFKV96/rv7MXe5K8ZakzxsuqFatmpo0aWLX1rhx4wKfXBQfH6+OHTvqySeflCQ1b95cFStWVKdOnfTiiy+qWrVqDo25sP788099//33V7z5ekk8tuansGO6qKQcewtSmDGVxONzQQr7PpW0Y3hBCjsmjvO43OOPP37FMzvr1q2r0NBQHTlyxK79/PnzOn78eL7H4127dum9997Tli1bdP3110uSWrRoof/7v//TpEmTNGXKlGIZw9Vy5Ngv5tq8cnhRbq3hSI4c//Lly7Vr165cD4a466671KlTJ61YseIa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/LKzQgZchvzg3sgPRVPY/PC3v/1Nqamp8vX11YQJE5SUlOS8IN2Rq6tiKNkefvhhI8msXr26UP0v//Vj7NixJq9/ZjNnzsxVMd6wYYPp1q2bqVKlivHx8TG1a9c2gwYNMsYYs2fPHiMp13Rpdfq3334zd911l6lcubKxWq2mdevWZsGCBXlud8WKFeaRRx4xQUFBJiAgIN+YatWqZXr27Gn+7//+z7Rt29ZYrVZTp04d89FHH+Ua088//2w6d+5sfHx8TPXq1c0LL7xgZsyYUajK+M8//2wGDhxo6tSpY6xWqwkJCTGDBg2y+6X14r68fCpo3QMHDjS1atVy2j7cu3eveeSRR8x1111nfHx8TGBgoLn77rvtYry4/OXTxV9CunTpYrp06WK3zZSUFDN48GATHBxsrFarad68uZk1a5Zdn4vje/31180HH3xg6tata7y9vU2bNm3M+vXrC9z/xhjzn//8x0gyixYtMsYYk5mZac6fP3/F5YCygFxALigrueBSVzpjoG3btqZt27a52rt162bq1atXpG0B7or8QH4gPxSsqGevlUWcKYUCffPNN6pbt646dOjg0O0cOXJE3bp1U1BQkJ5++mkFBARo7969+uqrryRJQUFBmjx5sh555BH17t1bd955pySpefPmkqStW7eqY8eOql69up5++mlVrFhRX3zxhWJiYvTll1+qd+/edtt79NFHFRQUpDFjxigzM7PA2Hbu3Km7775bQ4YM0cCBAzVjxgzFxsaqdevWuv766yVduKdE165dZbFYNHr0aFWsWFEffvihrFZroca/dOlS7d69W4MGDVJoaKi2bt2qqVOnauvWrVq7dq0sFovuvPNO/fHHH/rss8/01ltvqWrVqrZ9UxjO2IcbNmzQmjVr1LdvX9WoUUN79+7V5MmTFRkZqW3btqlChQrq3LmzHnvsMb3zzjt65pln1LhxY0my/fdyp0+fVmRkpHbu3Klhw4apTp06mjNnjmJjY5WamqoRI0bY9U9ISNDJkyf197//XRaLRa+99pruvPNO7d69u8Bfg77//ntJktVqVZs2bbRp0yZ5e3urd+/eev/99xUYGFio/QyURuQCckFZyQWFlZOTo19++UWDBw/ONa9du3b67rvvdPLkSfn6+l7ztoCSjPxAfiA/4Jq5uiqGkistLc1IMnfccUehl7naXz/mzZtnJJkNGzbku+6CKtK33HKLadasmd010Tk5OaZDhw6mQYMGubZ700035ToLJr9fPySZVatW2dqOHDlirFarefzxx21tw4cPNxaLxWzevNnWduzYMRMYGFioyvipU6dytX322We5tl3USvulv34Y4/h9mNc4EhMTjSTz8ccf29oKuk788l8/Jk6caCSZTz75xNZ29uxZExERYSpVqmTS09ONMf/79aNKlSrm+PHjtr4LFiwwksw333yTewdd4m9/+5tt+f79+5u5c+ea559/3nh5eZkOHTqU6PsHAI5ELiAXlKVccKmC9tPFef/6179yzZs0aZKRZH7//fdCbwtwR+QH8gP5YewV+3Km1JXx9D3kKz09XZKc8itfQECAJGnhwoU6d+5ckZY9fvy4li9frnvvvVcnT57U0aNHdfToUR07dkzR0dHasWOHDh48aLfM0KFDC31NeJMmTdSpUyfb66CgIDVs2NDu6TqLFy9WRESEWrZsaWsLDAxU//79C7WNS+9fdObMGR09elQ33nijJOmnn34q1DquRXHtw0vHce7cOR07dkz169dXQEDAVY9j0aJFCg0NVb9+/Wxt5cqV02OPPaaMjAytXLnSrn+fPn1UuXJl2+uL792VnoaUkZEhSWrbtq0++eQT3XXXXfrXv/6lF154QWvWrNGyZcuuKn7A3ZELLiAXlI1cUFgXnyaW11kOPj4+dn2A0or8cAH5gfyAa0NRCvny8/OTJJ08edLh2+rSpYvuuusujR8/XlWrVtUdd9yhmTNnKisr64rL7ty5U8YYPf/88woKCrKbxo4dK+nCKb+XqlOnTqFjq1mzZq62ypUr68SJE7bXf/75p+rXr5+rX15teTl+/LhGjBihkJAQlS9fXkFBQbYY09LSCh3r1SqufXj69GmNGTNG4eHhslqtqlq1qoKCgpSamnrV4/jzzz/VoEEDeXjYH64unsL7559/2rVf/n5dTDqXvl95uZgkL01oknTfffdJuvCIXaAsIhdcQC4oG7mgsC7mjLz+bZ45c8auD1BakR8uID+QH3BtuKcU8uXn56ewsDBt2bLlqtdhsVjybM/Ozs7Vb+7cuVq7dq2++eYbLVmyRIMHD9Ybb7yhtWvXqlKlSvluIycnR5L0xBNPKDo6Os8+lx/wi/JFMb9fSYwxhV7Hldx7771as2aNnnzySbVs2VKVKlVSTk6OunfvbhufIxXXPhw+fLhmzpypkSNHKiIiQv7+/rJYLOrbt69TxiFd/fsVFhYmSQoJCbFrDw4OlkSiQtlFLriAXHBBac8FhRUYGCir1arDhw/nmnex7WJeAUor8sMF5IcLyA+4WhSlUKDbb79dU6dOVWJioiIiIoq8/MXKc2pqqu20Wyl3xfqiG2+8UTfeeKNeeuklJSQkqH///po9e7YefPDBfJNW3bp1JV04TTMqKqrIMRaHWrVqaefOnbna82q73IkTJ7Rs2TKNHz9eY8aMsbXv2LEjV9/89kFhOXofzp07VwMHDtQbb7xhaztz5oxSU1MLFUdeatWqpV9++UU5OTl2v4D8/vvvtvnFoXXr1po2bVquU48PHTokqfA3iQRKI3JB4ZALLnDnXFBYHh4eatasmTZu3Jhr3rp161S3bl1uco4ygfxQOOSHC8pCfkDRcfkeCvTUU0+pYsWKevDBB5WSkpJr/q5du/T222/nu3y9evUkSatWrbK1ZWZm6qOPPrLrd+LEiVzV6YvXXF88LbdChQqSlOugFRwcrMjISH3wwQd5/mL5119/5RtfcYmOjlZiYqKSkpJsbcePH9enn356xWUvVusvH//EiRNz9a1YsaKk3PugsBy9Dz09PXON49133831a1dRxnHbbbcpOTlZn3/+ua3t/Pnzevfdd1WpUiV16dKlULFdyR133CGr1aqZM2fa/VLz4YcfSpJuvfXWYtkO4I7IBYVDLrjAnXNBUdx9993asGGDXWFq+/btWr58ue655x6nxwO4AvmhcMgPF5SV/ICi4UwpFKhevXpKSEhQnz591LhxYw0YMEBNmzbV2bNntWbNGtvjNvPTrVs31axZU0OGDNGTTz4pT09PzZgxQ0FBQdq3b5+t30cffaT3339fvXv3Vr169XTy5ElNmzZNfn5+uu222yRdOAW0SZMm+vzzz3XdddcpMDBQTZs2VdOmTTVp0iTddNNNatasmYYOHaq6desqJSVFiYmJOnDggH7++WeH7qennnpKn3zyiW699VYNHz7c9pjXmjVr6vjx4wVW+/38/NS5c2e99tprOnfunKpXr67vvvtOe/bsydW3devWkqRnn31Wffv2Vbly5dSrVy/bgftKHL0Pb7/9dv373/+Wv7+/mjRposTERH3//feqUqWKXb+WLVvK09NTr776qtLS0mS1WnXzzTfbLpW71EMPPaQPPvhAsbGx2rRpk2rXrq25c+dq9erVmjhxYrH9Eh0aGqpnn31WY8aMUffu3RUTE6Off/5Z06ZNU79+/dS2bdti2Q7gjsgFhUMuuMCdc4Ek/fvf/9aff/6pU6dOSbrwx/KLL74oSXrggQdsv7o/+uijmjZtmnr27KknnnhC5cqV05tvvqmQkBA9/vjjxRYPUJKRHwqH/HBBWckPaWlpevfddyVJq1evliS99957CggIUEBAgIYNG1ZsMZUKTn3WH9zWH3/8YYYOHWpq165tvL29ja+vr+nYsaN599137R4LevljXo0xZtOmTaZ9+/bG29vb1KxZ07z55pu5Hqn6008/mX79+pmaNWsaq9VqgoODze233242btxot641a9aY1q1bG29v71yP4dy1a5cZMGCACQ0NNeXKlTPVq1c3t99+u5k7d66tz8Xt5vU42fwe89qzZ89cfS9/FKkxxmzevNl06tTJWK1WU6NGDRMfH2/eeecdI8kkJycXuH8PHDhgevfubQICAoy/v7+55557zKFDh/J81OgLL7xgqlevbjw8PK74eNHLH/NqjGP34YkTJ8ygQYNM1apVTaVKlUx0dLT5/fff8/x3MW3aNFO3bl3j6elp98jXvPZtSkqKbb3e3t6mWbNmZubMmXZ9Lj7m9fXXX88VV177MS85OTnm3XffNdddd50pV66cCQ8PN88995w5e/bsFZcFygJygT1yQenMBV26dDGS8pwufzz5/v37zd133238/PxMpUqVzO2332527NhxxW0ApQ35wR75oWznh4vbymu6fH/DGIsx3NELcJSRI0fqgw8+UEZGRqEfKwsAKF3IBQCAvJAfAO4pBRSb06dP270+duyY/v3vf+umm24iyQBAGUEuAADkhfwA5I17SgHFJCIiQpGRkWrcuLFSUlI0ffp0paen6/nnn3d1aAAAJyEXAADyQn4A8kZRCigmt912m+bOnaupU6fKYrHohhtu0PTp09W5c2dXhwYAcBJyAQAgL+QHIG/cUwoAAAAAAABOxz2lAAAAAAAA4HQUpQAAAAAAAOB03FOqGOTk5OjQoUPy9fWVxWJxdTgAUCTGGJ08eVJhYWHy8OC3iuJCbgDg7sgPjkF+AODuijM/UJQqBocOHVJ4eLirwwCAa7J//37VqFHD1WGUGuQGAKUF+aF4kR8AlBbFkR8o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L72kO++8U71791ZAgOsQe/bsadIEAQCtD8cbAGgZ2J8DAOrTqKKUJH311Vd666231LFjR91xxx01DioAADSFpjzebN++XfPnz1dBQYGKioq0YcMGjRo1qt4+DodDc+fO1WuvvSabzabOnTsrIyND99577yXnAQCtEX8/AADq0qgjwrJlyzRjxgwlJCRo//79CgsLc1deAIBWrKmPN+Xl5YqOjta9996rO++8s0F9fvWrX6m4uFjLly9Xjx49VFRUpOrq6svKAwBaG/5+AADUp8FFqaSkJOXn5+ull15ScnKyO3Oq15IlSzR//nzZbDZFR0dr8eLFGjRoUK2xy5Yt06uvvqp9+/ZJkmJjY/XMM8+4xE+YMEGrV6926ZeYmKjs7Gz3TQIAUCd3HG+GDx+u4cOHNzg+OztbH3zwgb788kuFhoZKkrp27dokuQBAa9Fc/n4AADRfDS5KVVVV6dNPP9VPfvITd+ZTr9dff11paWnKyspSXFycXnzxRSUmJurQoUMKDw+vEb9t2zbdfffduvHGGxUUFKTnnntOw4YN0/79+3XVVVc545KSkrRy5Urna7PZ7JH5AABqag7Hm02bNmngwIF6/vnn9f/+3//TFVdcof/6r//SvHnz1LZt21r7OBwOORwO52u73e6pdAGgWWoO+3MAQPPW4KJUTk6OO/NokIULFyolJUUTJ06UJGVlZelvf/ubVqxYoVmzZtWIX7NmjcvrP/3pT/rLX/6i3Nxcl29rzGazrFare5MHADRIczjefPnll/rwww8VFBSkDRs26PTp03rggQd05swZly8xfigzM1NPPvmkhzMFgOarOezPAQDNm5+3E2ioCxcuqKCgQAkJCc42Pz8/JSQkKC8vr0FjnD9/XhUVFc5LMb63bds2hYeHq2fPnrr//vt15syZesdxOByy2+0uCwCg5aiurpbJZNKaNWs0aNAgjRgxQgsXLtTq1av173//u9Y+6enpKi0tdS7Hjx/3cNYAAACAb/GZotTp06dVVVWliIgIl/aIiAjZbLYGjTFz5kxFRka6FLaSkpL06quvKjc3V88995w++OADDR8+XFVVVXWOk5mZqeDgYOcSFRV1aZMCADRLnTt31lVXXaXg4GBnW+/evWUYhr7++uta+5jNZlksFpcFAAAAQN1azfNYn332Wa1bt07btm1TUFCQs33s2LHOf/fr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",
+      "text/plain": [
+       "<Figure size 1200x1200 with 9 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "Dendrogram.plot_hierarchial_split(hierarchial_clustering_sequence, coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The hierarchical clustering can be converted to flat clustering by drawing a line perpendicular to the branches. Any data point that intersects the line is considered to be in the same cluster. The function below performs this task at threshold height of 1.5. If you want to use the number of clusters instead of height, you can use `dendo.get_clusters_using_k()` method. You pass the number of desired clusters as an argument. The figure below shows the clusters that are formed at threshold height of 1.5."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAy0AAANICAYAAADKKQDvAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/NK7nSAAAACXBIWXMAAA9hAAAPYQGoP6dpAAA+1UlEQVR4nO3deZhcZYH3729n6c5CFgKJGAghgIDsDrsRA4hg2AQFFFE2QQaQETH4En1ZAjpRdHhBBEQGiCNk2JQZwAFEERyBsA6joALhl2hETFg7G1lIzu+PtjvpdCekk3TqSXLf13UuuqqeOvV0pbroT5+l6qqqqgIAAFCoLrWeAAAAwLKIFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRZgnbDZZpvlhBNOqPU01mj33ntvdt555/To0SN1dXV56623aj2ldVZdXV0uvPDCWk8DYLURLcAqMW7cuNTV1bUsPXr0yODBg3PggQfme9/7XmbMmFHrKbISXn/99Rx99NHp2bNnrrzyyvz4xz9O7969l3mfl156Kaeeemo233zz9OjRI3379s3w4cNz+eWX5+23315NM+8cs2fPzoUXXpgHH3yw1lNZbS699NLU1dXlF7/4xVLHXHvttamrq8udd97Zcl1VVfnxj3+cD3/4w+nfv3969eqVHXbYId/4xjcye/bsNuvYZ599Wr2XLL5ss802nfK9AeXrVusJAGuXiy66KMOGDcv8+fPzt7/9LQ8++GDOOuusXHrppbnzzjuz44471nqKrIAnnngiM2bMyMUXX5z999//Xcf/7Gc/y1FHHZWGhoYcd9xx2X777TNv3rz85je/yTnnnJPnnnsuP/zhD1fDzDvH7NmzM2bMmCRNv2Svbm+//Xa6dVu9/wv/9Kc/nXPOOSfjx49f6mtg/Pjx2WCDDTJy5MgkyYIFC/KZz3wmt956a/bee+9ceOGF6dWrV/77v/87F1xwQW699db84he/yKBBg1qtZ5NNNsnYsWPbrL9fv36r/hsD1giiBVilRo4cmV133bXl8ujRo/PAAw/kkEMOyWGHHZY//OEP6dmzZw1nuHSzZs16160Hq8qcOXNSX1+fLl3WjA3e06ZNS5L079//XcdOmjQpn/70pzN06NA88MADee9739ty2xlnnJGJEyfmZz/72UrPqaqqzJkzp9jXU2fq0aPHan/MwYMHZ999981Pf/rTXH311WloaGh1+8svv5xf//rX+cIXvpDu3bsnSS655JLceuutGTVqVL7zne+0jP3CF76Qo48+OocffnhOPPHENq+Hfv365bOf/Wznf1PAGmPN+L8lsEbbb7/9ct555+VPf/pTbrzxxla3/fGPf8yRRx6ZAQMGpEePHtl1111b7VqSLNr17OGHH87ZZ5+dgQMHpnfv3jniiCPy6quvthpbVVW+8Y1vZJNNNkmvXr2y77775rnnnmszp+Z1PvTQQzn99NMzaNCgbLLJJi23X3XVVdluu+3S0NCQwYMH54wzzmj3GI4rr7wym2++eXr27Jndd989//3f/5199tmn1V/fH3zwwdTV1eXmm2/O//2//zcbb7xxevXqlenTp+eNN97IqFGjssMOO2S99dZL3759M3LkyPzv//5vq8dpXsett96aMWPGZOONN06fPn1y5JFHprGxMXPnzs1ZZ52VQYMGZb311suJJ56YuXPnLte/z2233ZZddtklPXv2zIYbbpjPfvazefnll1tu32effXL88ccnSXbbbbfU1dUt8/igSy65JDNnzsx1113XKliabbnllvnSl77Ucvmdd97JxRdfnC222CINDQ3ZbLPN8rWvfa3N/DfbbLMccsghue+++7LrrrumZ8+eueaaa5Ikb731Vs4666wMGTIkDQ0N2XLLLfPtb387CxcubLWOm2++Obvsskv69OmTvn37Zocddsjll1/easy7rWvy5MkZOHBgkmTMmDEtuy4t6xiTCy+8MHV1dW2ub34dTp48ueW6J598MgceeGA23HDD9OzZM8OGDctJJ53U6n5LPl7z+idOnJgTTjgh/fv3T79+/XLiiSe22QXr7bffzj/90z9lww03TJ8+fXLYYYfl5ZdfXq7jZD772c+msbGx3ei8+eabs3Dhwhx77LEtj/Od73wnW221VbtbTQ499NAcf/zx+a//+q88/vjjy3xcAFtagNXic5/7XL72ta/l5z//eU455ZQkyXPPPZfhw4dn4403zrnnnpvevXvn1ltvzeGHH56f/OQnOeKII1qt48wzz8z666+fCy64IJMnT85ll12WL37xi7nllltaxpx//vn5xje+kYMOOigHHXRQnn766RxwwAGZN29eu/M6/fTTM3DgwJx//vmZNWtWkqZfAMeMGZP9998/p512Wp5//vlcffXVeeKJJ/Lwww+3/BX56quvzhe/+MXsvffe+fKXv5zJkyfn8MMPz/rrr98qgJpdfPHFqa+vz6hRozJ37tzU19fn97//ff7jP/4jRx11VIYNG5apU6fmmmuuyYgRI/L73/8+gwcPbrWOsWPHpmfPnjn33HMzceLEXHHFFenevXu6dOmSN998MxdeeGEmTJiQcePGZdiwYTn//POX+e8ybty4nHjiidltt90yduzYTJ06NZdffnkefvjh/M///E/69++fr3/969l6663zwx/+sGX3vy222GKp67zrrruy+eab54Mf/OAyH7vZySefnB/96Ec58sgj85WvfCWPPfZYxo4dmz/84Q+54447Wo19/vnnc8wxx+TUU0/NKaeckq233jqzZ8/OiBEj8vLLL+fUU0/NpptumkceeSSjR4/OK6+8kssuuyxJcv/99+eYY47JRz7ykXz7299OkvzhD3/Iww8/3BJRy7OugQMH5uqrr85pp52WI444Ip/4xCeSZJXs+jht2rQccMABGThwYM4999z0798/kydPzk9/+tPluv/RRx+dYcOGZezYsXn66afzr//6rxk0aFDL95skJ5xwQm699dZ87nOfy5577pmHHnooBx988HKt/xOf+EROO+20jB8/vuX7bjZ+/PgMHTo0w4cPT5L85je/yZtvvpkvfelLS92V7bjjjssNN9yQu+66K7vvvnvL9QsWLMhrr73WZnzPnj1X29ZQoDAVwCpwww03VEmqJ554Yqlj+vXrV33gAx9oufyRj3yk2mGHHao5c+a0XLdw4cLqgx/8YPW+972vzbr333//auHChS3Xf/nLX666du1avfXWW1VVVdW0adOq+vr66uCDD2417mtf+1qVpDr++OPbrPNDH/pQ9c4777Rc37yOAw44oFqwYEHL9d///verJNX1119fVVVVzZ07t9pggw2q3XbbrZo/f37LuHHjxlVJqhEjRrRc96tf/apKUm2++ebV7NmzWz0nc+bMafU4VVVVkyZNqhoaGqqLLrqozTq23377at68eS3XH3PMMVVdXV01cuTIVuvYa6+9qqFDh1bLMm/evGrQoEHV9ttvX7399tst1999991Vkur8889v83wt69+3qqqqsbGxSlJ9/OMfX+a4Zs8880yVpDr55JNbXT9q1KgqSfXAAw+0XDd06NAqSXXvvfe2GnvxxRdXvXv3rl544YVW15977rlV165dqz//+c9VVVXVl770papv376t/r2XtLzrevXVV6sk1QUXXLBc3+cFF1xQtfe/3ObnddKkSVVVVdUdd9yxXM/zko/dvP6TTjqp1bgjjjii2mCDDVouP/XUU1WS6qyzzmo17oQTTlju7+eoo46qevToUTU2NrZc98c//rFKUo0ePbrlussuu6xKUt1xxx1LXdcbb7xRJak+8YlPtFw3YsSIKkm7y6mnnvqu8wPWTnYPA1ab9dZbr+UsYm+88UYeeOCBHH300ZkxY0Zee+21vPbaa3n99ddz4IEH5sUXX2y1i1LStB/84rvY7L333lmwYEH+9Kc/JUl+8YtfZN68eTnzzDNbjTvrrLOWOqdTTjklXbt2bbncvI6zzjqr1fEmp5xySvr27duyW8yTTz6Z119/PaecckqrvyIfe+yxWX/99dt9rOOPP77N8RcNDQ0tj7NgwYK8/vrrWW+99bL11lvn6aefbrOO4447rmVLT5Lsscceqaqqze5De+yxR6ZMmZJ33nlnqd/7k08+mWnTpuX0009vdYzEwQcfnG222WaFjjuZPn16kqRPnz7LNf6//uu/kiRnn312q+u/8pWvJEmbOQwbNiwHHnhgq+tuu+227L333ll//fVbXkevvfZa9t9//yxYsCC//vWvkzQdjzNr1qzcf//9S53P8q6rszQfM3T33Xdn/vz5Hb7/P/7jP7a6vPfee+f1119v+Xe59957kzRtYVzcmWeeudyP8dnPfjZz5sxptfVn/PjxSdKya1iSlp/1Zb0Wmm9b8uyCm222We6///42y7J+loG1m93DgNVm5syZLWcJmjhxYqqqynnnnZfzzjuv3fHTpk3Lxhtv3HJ50003bXV7cxy8+eabSdISL+973/tajRs4cOBSQ2LYsGGtLjevY+utt251fX19fTbffPOW25v/u+WWW7Ya161bt2y22WbL9VhJsnDhwlx++eW56qqrMmnSpCxYsKDltg022KDN+CWfg+azKQ0ZMqTN9QsXLkxjY2O761n8e1jye02SbbbZJr/5zW/avd+y9O3bN0nbX0KX5k9/+lO6dOnS5nncaKON0r9//5Y5NmvvOXzxxRfz29/+tuU4kyU1n0Tg9NNPz6233pqRI0dm4403zgEHHJCjjz46H/vYxzq8rs4yYsSIfPKTn8yYMWPy//7f/8s+++yTww8/PJ/5zGfaHPjenmX9jPTt27fl+V7yeVzy+V+WkSNHZsCAARk/fnzLsU3//u//np122inbbbddy7ilBcnimm9b8uxhvXv3Xq6z1AHrDtECrBZ/+ctf0tjY2PLLUfNBzaNGjWrzl/NmS/4itfgWkcVVVbXC81qdZ55q77H++Z//Oeedd15OOumkXHzxxRkwYEC6dOmSs846q81B5MnSn4POeG5WRN++fTN48OA8++yzHbpfewept6e953DhwoX56Ec/mq9+9avt3merrbZK0vSL8TPPPJP77rsv99xzT+65557ccMMNOe644/KjH/2oQ+vqqKV9f4tHavO422+/PRMmTMhdd92V++67LyeddFL+5V/+JRMmTMh66623zMdZHa+D7t275+ijj861116bqVOn5s9//nNefPHFXHLJJa3GbbvttkmS3/72tzn88MPbXddvf/vbJMnmm2++yuYHrJ1EC7Ba/PjHP06SlkBp/iWle/fuq+wvqkOHDk3S9NfyxX8JevXVV1u2xizvOp5//vlW65g3b14mTZrUMtfmcRMnTsy+++7bMu6dd97J5MmTl/ug7Ntvvz377rtvrrvuulbXv/XWW9lwww2Xax0ravHvdb/99mt12/PPP99ye0cdcsgh+eEPf5hHH300e+2117vOYeHChXnxxRfz/ve/v+X6qVOn5q233lquOWyxxRaZOXPmcr2O6uvrc+ihh+bQQw/NwoULc/rpp+eaa67Jeeedly233HK517W8kdWseYvHW2+91eq00UtuSWq25557Zs8998w3v/nNjB8/Pscee2xuvvnmnHzyyR163CU1P9+TJk1qtUVy4sSJHVrPsccemx/84Ae55ZZbMmnSpNTV1eWYY45pNWb48OHp379/xo8fn69//evtBtW//du/JUmOOuqoFfhugHWJY1qATvfAAw/k4osvzrBhw1r2eR80aFD22WefXHPNNXnllVfa3GfJUxkvj/333z/du3fPFVdc0eovy81nj1reddTX1+d73/teq3Vcd911aWxsbDnL0q677poNNtgg1157bavjRm666ablDqSk6S/jS/4V/LbbbmtzPE9n2HXXXTNo0KD84Ac/aHV64XvuuSd/+MMflvuMUkv66le/mt69e+fkk0/O1KlT29z+0ksvtZxm+KCDDkrS9t/o0ksvTZLlmsPRRx+dRx99NPfdd1+b2956662Wf5/XX3+91W1dunRpicvm739519WrV6+W65ZH89nWFj8mZtasWS1beJq9+eabbV4PO++8c6s5rozmPxpcddVVra6/4oorOrSe4cOHZ7PNNsuNN96YW265JSNGjGhzxrxevXrlq1/9ap5//vl8/etfb7OOn/3sZxk3blwOPfTQ7LDDDh38ToB1jS0twCp1zz335I9//GPeeeedTJ06NQ888EDuv//+DB06NHfeeWerA76vvPLKfOhDH8oOO+yQU045JZtvvnmmTp2aRx99NH/5y1/afFbJuxk4cGBGjRqVsWPH5pBDDslBBx2U//mf/8k999yz3FstBg4cmNGjR2fMmDH52Mc+lsMOOyzPP/98rrrqquy2224tH3hXX1+fCy+8MGeeeWb222+/HH300Zk8eXLGjRuXLbbYYrn/En/IIYfkoosuyoknnpgPfvCD+d3vfpebbrpptewu071793z729/OiSeemBEjRuSYY45pOeXxZpttli9/+csrtN4tttgi48ePz6c+9am8//3vz3HHHZftt98+8+bNyyOPPJLbbrut5ViInXbaKccff3x++MMf5q233sqIESPy+OOP50c/+lEOP/zwVluxluacc87JnXfemUMOOSQnnHBCdtlll8yaNSu/+93vcvvtt2fy5MnZcMMNc/LJJ+eNN97Ifvvtl0022SR/+tOfcsUVV2TnnXdu2cqzvOvq2bNntt1229xyyy3ZaqutMmDAgGy//fbZfvvt253jAQcckE033TSf//znc84556Rr1665/vrrM3DgwPz5z39uGfejH/0oV111VY444ohsscUWmTFjRq699tr07du3JfBWxi677JJPfvKTueyyy/L666+3nPL4hRdeSLL8W5Dq6urymc98Jv/8z/+cJLnooovaHffVr341zzzzTL797W/n0UcfzSc/+cn07Nkzv/nNb3LjjTdmu+22y7hx49rcr7Gxsc1nOjXzoZOwjqrZecuAtUrzqVubl/r6+mqjjTaqPvrRj1aXX355NX369Hbv99JLL1XHHXdctdFGG1Xdu3evNt544+qQQw6pbr/99jbrXvI0sM2nAf7Vr37Vct2CBQuqMWPGVO9973urnj17Vvvss0/17LPPVkOHDm33lMdLO7Xs97///WqbbbapunfvXr3n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M2fmpZdeynvf+96ljmloaEjfvn1bLQAAAMurQ9EyatSoPPTQQ5k8eXIeeeSRHHHEEenatWuOOeaYzpofAACwjuvQMS1/+ctfcswxx+T111/PwIED86EPfSgTJkzIwIEDO2t+AADAOq5D0XLzzTd31jwAAADatVLHtAAAAHQ20QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAULRutZ4Ay6Gqkvmzaz2Ltc+82e1/zarTvVdSV1frWQAAazjRUrqqSq4/MJnyWK1nsnb77pa1nsHaacieyUn3ChcAYKXYPax082cLFtZcUybYSggArDRbWtYkoyYm9b1qPQt4d/Nm23oFAKwyomVNUt8rqe9d61kAAMBqZfcwAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAo2kpFy7e+9a3U1dXlrLPOWkXTAQAAaG2Fo+WJJ57INddckx133HFVzgcAAKCVFYqWmTNn5thjj821116b9ddff1XPCQAAoMUKRcsZZ5yRgw8+OPvvv/+qng8AAEAr3Tp6h5tvvjlPP/10nnjiieUaP3fu3MydO7fl8vTp0zv6kAAAwDqsQ1tapkyZki996Uu56aab0qNHj+W6z9ixY9OvX7+WZciQISs0UQAAYN3UoWh56qmnMm3atPzDP/xDunXrlm7duuWhhx7K9773vXTr1i0LFixoc5/Ro0ensbGxZZkyZcoqmzwAALD269DuYR/5yEfyu9/9rtV1J554YrbZZpv8n//zf9K1a9c292loaEhDQ8PKzRIAAFhndSha+vTpk+23377Vdb17984GG2zQ5noAAIBVYaU+XBIAAKCzdfjsYUt68MEHV8E0AAAA2mdLCwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNE6FC1XX311dtxxx/Tt2zd9+/bNXnvtlXvuuaez5gYAANCxaNlkk03yrW99K0899VSefPLJ7Lfffvn4xz+e5557rrPmBwAArOO6dWTwoYce2uryN7/5zVx99dWZMGFCtttuu1U6MQAAgKSD0bK4BQsW5LbbbsusWbOy1157rco5AQAAtOhwtPzud7/LXnvtlTlz5mS99dbLHXfckW233Xap4+fOnZu5c+e2XJ4+ffqKzRQAAFgndfjsYVtvvXWeeeaZPPbYYznttNNy/PHH5/e///1Sx48dOzb9+vVrWYYMGbJSEwYAANYtHY6W+vr6bLnlltlll10yduzY7LTTTrn88suXOn706NFpbGxsWaZMmbJSEwYAANYtK3xMS7OFCxe22v1rSQ0NDWloaFjZhwEAANZRHYqW0aNHZ+TIkdl0000zY8aMjB8/Pg8++GDuu+++zpofAACwjutQtEybNi3HHXdcXnnllfTr1y877rhj7rvvvnz0ox/trPkBAADruA5Fy3XXXddZ8wAAAGhXhw/EBwAAWJ1ECwAAULSVPnsY0EFVlcyfXetZdK55s9v/em3WvVdSV1frWQDAWkm0wOpUVcn1ByZTHqv1TFaf725Z6xmsHkP2TE66V7gAQCewexisTvNnr1vBsi6ZMmHt34IGADViSwvUyqiJSX2vWs+ClTVv9rqzNQkAakS0QK3U90rqe9d6FgAAxbN7GAAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUrUPRMnbs2Oy2227p06dPBg0alMMPPzzPP/98Z80NAACgY9Hy0EMP5YwzzsiECRNy//33Z/78+TnggAMya9aszpofAACwjuvWkcH33ntvq8vjxo3LoEGD8tRTT+XDH/7wKp0YAABA0sFoWVJjY2OSZMCAAUsdM3fu3MydO7fl8vTp01fmIQEAgHXMCh+Iv3Dhwpx11lkZPnx4tt9++6WOGzt2bPr169eyDBkyZEUfEgAAWAetcLScccYZefbZZ3PzzTcvc9zo0aPT2NjYskyZMmVFHxIAAFgHrdDuYV/84hdz991359e//nU22WSTZY5taGhIQ0PDCk0OAACgQ9FSVVXOPPPM3HHHHXnwwQczbNiwzpoXAABAkg5GyxlnnJHx48fnP//zP9OnT5/87W9/S5L069cvPXv27JQJAgAA67YOHdNy9dVXp7GxMfvss0/e+973tiy33HJLZ80PAABYx3V49zCAmqiqZP7sWs+irXmz2/+6FN17JXV1tZ4FAKyUlfqcFoDVoqqS6w9MpjxW65ks23e3rPUM2hqyZ3LSvcIFgDXaCp/yGGC1mT+7/GAp1ZQJZW6hAoAOsKUFWLOMmpjU96r1LMo3b3aZW34AYAWIFmDNUt8rqe9d61kAAKuR3cMAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBo3Wo9gWJUVTJ/dq1n0da82e1/XZLuvZK6ulrPAgCAtZRoSZqC5foDkymP1Xomy/bdLWs9g/YN2TM56V7hAgBAp7B7WNK0haX0YCnZlAllbqUCAGCtYEvLkkZNTOp71XoWa4Z5s8vd+gMAwFpDtCypvldS37vWswAAAP7O7mEAAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFE20AAAARRMtAABA0UQLAABQNNECAAAUTbQAAABFEy0AAEDRRAsAAFA00QIAABRNtAAAAEUTLQAAQNFECwAAUDTRAgAAFK1brScAANBKVSXzZ9d6FmufebPb/5pVp3uvpK6u1rNYK4kWAKAcVZVcf2Ay5bFaz2Tt9t0taz2DtdOQPZOT7hUuncDuYQBAOebPFiysuaZMsJWwk9jSAgCUadTEpL5XrWcB727ebFuvOploAQDKVN8rqe9d61kABbB7GAAAULQOR8uvf/3rHHrooRk8eHDq6uryH//xH50wLQAAgCYdjpZZs2Zlp512ypVXXtkZ8wEAAGilw8e0jBw5MiNHjlz5R541K+nate31XbsmPXq0Hrc0XbokPXuu2NjZs5tOq5gk82Yl86pF63inLunVq/2xS6pbYuzbbycLFy59Hr17r9jYOXOSBQtWzdhei51DfO7c5J13Vmzsks9bt55Nz3OSzJuXzJ+/9PX27MDYHj0WvVY6Mnb+/KbxS9PQkHTr1vGx77zT9FwsTX190r17+2OXfM7qFhu7YEHTv93SdO/etO6Ojl24sOm1tirGduvW9FwkTT8Ts5dxhpSOjH23n/vFn7c5c1rv47463iOWtOTPfYnvEUu+1upr8B6xpI783K+r7xHLGruuvEcs+dqdn479blCL3yOWtCa8R6zMWO8RTdq8Ryzxul3aWO8RTV83/9wv6+ducdVKSFLdcccdyxwzZ86cqrGxsWWZMmVKlaRqbJpq2+Wgg1qvoFev9sclVTViROuxG2649LG77tp67NChSx+77batx2677dLHDh3aeuyuuy597IYbth47YsTSx/bq1XrsQQctfeyS/4xHHrnssTNnLhp7/PHLHjtt2qKxp5++7LGTJi0aO2rUssc+++yisRdcsOyxjz++aOwllyx77K9+tWjs97+/7LF3371o7A03LHvsrbcuGnvrrcsee8MNi8beffeyx37/+4vG/upXyx57ySWLxj7++LLHXnDBorHPPrvssaNGLRo7adKyx55++qKx06Yte+zxxy8aO3PmssceeWTVyrLGfuzA1mO9RzTxHtHEe0STdfk9wu8RTYv3iEXL6niPuPYHyx7rPaJpaec9ojGpklSNjY3VsnT6gfhjx45Nv379WpYhQ4Z09kMCAABrkbqqqqoVvnNdXe64444cfvjhSx0zd+7czF1ss9b06dMzZMiQNP71r+nbt2/bO9Rq97Dv/P3c2udMTBrWs1l3ecYu+bz123AN36y7mnYPW/w5W2/9NX+z7qoYuzy7hzU/b+dOSvpusPSxi1uXd/1Y8rW2/qClj12SXT+a2D2s42NX1e5hi79263vbPWxxa9PvEUtak98jZr2VfHPTpq+bX7dLG+s9ounrv//cT58+Pf0GD05jY2P7bdB816WvddVoaGhIQ/PkFte7d+sfkKVZnjErMnbxN4juSerrFq1jyQ+y6rXE5WVZ/A1tVY5d/A14VY5taFj04uno2CWfty6Lbbirr1/0An43nTW2e/dFP8ircmy3boveeDo6dsnnbPHH7Np1+V/DHRnbpUvnjK2r65yxSduxiz9vS76+V8d7xKocu7reI5Z8rS1r7LKszHvEsniP6PjYdeU9os3/k9tZR2f93K9L7xGraqz3iEVj3+1128x7RJPmn/tlBfLiq16+tQIAANRGh7e0zJw5MxMnTmy5PGnSpDzzzDMZMGBANt1001U6OQAAgA5Hy5NPPpl999235fLZZ5+dJDn++OMzbty4VTYxAACAZAWiZZ999slKHLsPAADQIY5pAQAAitbpZw8DAIBVoqqS+cs4lXatzJvd/tcl6b7Y6afXQKIFAIDyVVVy/YHJlMdqPZNl++6WtZ5B+4bsmZx07xobLnYPAwCgfPNnlx8sJZsyocytVMvJlhYAANYsoya2/TBw2jdvdrlbfzpAtAAAsGap77XsT51nrWP3MAAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAiiZaAACAookWAACgaKIFAAAommgBAACKJloAAICiiRYAAKBoogUAACiaaAEAAIomWgAAgKKJFgAAoGiiBQAAKJpoAQAAitat1hMA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",
+      "text/plain": [
+       "<Figure size 1000x1000 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "threshold_height = 1\n",
+    "clusters = dendo.get_clusters_using_height(threshold_height)\n",
+    "colors = [\"red\", \"blue\", \"green\", \"black\", \"purple\", \"orange\", \"yellow\"]\n",
+    "dendo.plot_dendrogram(\n",
+    "    plot_title=\"Dendrogram of Coreset using VQE\",\n",
+    "    colors=colors,\n",
+    "    clusters=clusters,\n",
+    "    color_threshold=threshold_height,\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "You can visualize the flat clusters using `dendo.plot_clusters()` method. The function takes the clusters and colors as arguments. The clusters are represented by different colors."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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Z87YP7+SfE8lPZezWCwWJk2axMqVKwkODubee+/l73//e4mX96pdu7bD64JAWxCkCz7P+vXrO/SrVKnSNadUFLjtttvo1q0by5Yt49dffwXypzxUqlSJxx9/3N6vIPRe6+/C6dOnCQoKKtR+77330qVLF4etbdu2JapRRKS0NOdXbnl+fn7UqlWL77///rrPYRhGke02m61QvyVLlrBt2zb+85//sGrVKv7v//6PKVOmsG3btqvOj83LywPgpZdeolu3bkX2uTKoeHt7F+rz+OOP07FjR5YtW8bq1auZPHkykyZNIiEhgQcffPCq77OsNWrUiG+//ZZDhw5htVrL9NwWiwUPD8d/n+fl5REUFMSHH35Y5DGBgYFAyb6nkp6rtEr6dwlg2LBhdO/eneXLl7Nq1SrGjBlDfHw869ato2XLlle9zpW/EShgmmbpi76Kvn37smLFClasWMGjjz7K0qVL7fOpCzRo0IBKlSrx3XffFXue3Nxc9u7dS+vWrcu0PhGR0tLIr1QIjzzyCPv372fr1q3XdXzBqNmpU6cc2q8cjSxwzz33MHHiRL755hs+/PBDdu3axUcffQQUH34KphtUrly50ChXwVbSKQQhISG88MILLF++nAMHDnDbbbcxceLEYvsHBgZStWpV9u7dW2jfnj178PDwuK7w2r17dwA++OCDa/atU6cOQJE17N27177/aurVq8f//vc/2rdvX+Tn16JFC4f+V/ueSnOu4r7TopT271K9evUYOXIkq1ev5vvvv+f8+fNMmTKlxNcrTsHnmZaW5tB+8eJF0tPTS3yeRx99FF9fXxYuXMjKlSs5efKkw5QHgKpVq3L//fezadOmYt/n4sWLyc3N5bHHHivdGxERKWMKv1IhvPzyy/j4+PDss89y7NixQvv379/PtGnTij2+Xr16AGzatMnedvbsWRYsWODQ7+TJk4VG1u68804A+6/UC1YluDL8BAUF0blzZ+bMmUNmZmahGgrW170am81GdnZ2ofPWqlXrqlMvPD09eeCBB/j0008dgs+xY8dYuHAhHTp0sE8fKY3evXvTrFkzJk6cWOQ/PE6fPm1fIaFVq1YEBQUxe/Zsh1pXrlxJamoqDz/88DWv9/jjj2Oz2Rg/fnyhfRcvXrR/5iX5nkp6LgAfH59C32dx6tSpg6enp8PfJch/UMblzp07Z59KUKBe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DRtGrVq19N3ITUPhtwK7/fbb8fT05NixYw7tx44do2bNmi6qSq40ePBgVqxYwaZNmwgLC3N1OQLs2LGDn376ibvuusveZrPZ2LRpE2+//Ta5ubl4enq6sEL3FhISQuPGjR3aIiMjWbp0qYsqkgJ/+tOfGDVqFL///e8BaNasGQcPHiQ+Pl7hV24amvNbgXl5eREVFcXatWvtbXl5eaxdu5a2bdu6sDIBME2TwYMHs2zZMtatW0d4eLirS5JL7r//fnbu3ElKSop9a9WqFX369CElJUXB18Xat29faFnAH374gTp16rioIilw7tw5PDwco4Wnpyd5eXkuqkikMI38VnAjRoygf//+tGrVitatWzN16lTOnj3L008/7erS3F5cXBwLFy7k008/xdfXl6ysLAD8/f3x9vZ2cXXuzdfXt9Dcax8fH2677TbNyb4JDB8+nHbt2vH666/z+OOPs337dubOncvcuXNdXZrb6969OxMnTqR27do0adKEb7/9ln/84x/83//9n6tLE7HTUmdu4O2332by5MlkZWVx55138tZbb9GmTRtXl+X2DMMosv29995jwIAB5VuMXFPnzp211NlNZMWKFYwePZp9+/YRHh7OiBEjGDhwoKvLcnunT59mzJgxLFu2jJ9++olatWrx5JNP8sorr+Dl5eXq8kQAhV8RERERcSOa8ysiIiIibkPhV0RERETchsKviIiIiLgNhV8RERERcRsKvyIiIiLiNhR+RURERMRtKPyKiIiIiNtQ+BURERERt6HwKyIiIiJuQ+FXRERERNyGwq+IiIiIuI3/D41GRMsQk+8TAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "dendo.plot_clusters(\n",
+    "    clusters, colors, plot_title=\"Clusters of Coreset using VQE\", show_annotation=True\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The function below uses the `dendo.get_voronoi_tessalation()` method to convert the clusters into regions. `coreset_df`, `clusters` and `colors` need to be passed as the arguments to create the regions. This function creates a region for each coreset point separately and then colors them according to the clusters with colors passed as arguments. Another option is to create regions using the centroids of the clusters. You need to pass `tesslation_by_cluster=True` to the function to perform this task.\n",
+    "\n",
+    "Once the region creation is complete, you can use `plot_voironi()` method to plot the regions. The function takes the clusters and colors as arguments. \n",
+    "\n",
+    "Remembering that these regions were based on coresets, they can overlay the original data set and be used to cluster the data based on the coreset analysis."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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3r17m02nfPTRR/jnP/+JG2+8ER6PB4899hguvvhi7N69G9nZ2XF7TKLRKC644AJ89NFHuO666zBgwABs3rwZjzzyCLZt29Y4l//ll1/ivPPOw5AhQ/DHP/4RDocD3377LT7++OPG2/rLX/6COXPm4JJLLsHNN98Mv9+Pzz//HJ9++imuuOIKAPXTDZ988gkuv/xylJSUYOfOnViwYAHOPPNMfPXVV3C73a3W+sorr8Dr9eKGG25AdnY21qxZg8cffxx79uzBK6+8AgD45S9/iX379mHp0qVYvHhxu7//l19+idNPPx1paWn4zW9+A5vNhmeeeQZnnnkmPvjgA4wePbrJ9W+66SZkZmbizjvvxM6dO/Hoo49i9uzZeOmll9q8n2XLlmHatGno2bMn7rrrLvh8Pjz++OMYN24cNmzYgO7du+OXv/wliouLcd9992HOnDkYOXIk8vPzW73Nf/3rX3C5XLjkkkva/T0B4K677sLdd9+NyZMn44YbbsDWrVuxYMECrF27Fh9//HGTKYqjR49i2rRpuPzyy3HVVVchPz8/rs+Vjt7W4sWL8fOf/xyjRo3CddddBwDo1atXh37ftgSDQUydOhWBQAA33XQTCgoKsHfvXrz11luoqqpCenp6mz/fkefBvHnz8OCDD+L888/H1KlTsWnTJkydOhV+v7/d+s444wyUlJRgyZIlmDt3bpPvLVmyBG63GxdddBEA4JtvvsHWrVsxc+ZMpKWltXh7V199Ne6880787//+L37yk580+d6RI0eaXd9ut7d6WxQj2amItCccDovCwkIxZsyYJpc//fTTAoB45513hBBC3HLLLQKA+PDDDxuvU1tbK3r06CG6d+8uIpGIEKL1kRIA4vbbb29yH2+88YYAIO65554ml19yySVCURTx7bffNl4GQNjt9iaXbdq0SQAQjz/+eONl8RgpWbx4sVBVtcnvevxj8vHHHwshhHjkkUcEAHH48OFWb/vCCy8UgwYNavP+jx/VaLBq1SoBQPztb39rvKylT7Yt/ez8+fOFoihi165djZe1NX2DE0ZKLrroImG328V3333XeNm+ffuEx+MRZ5xxRuNlDY/15MmTm4xs3XrrrcJisTT5dN2SYcOGiby8PHH06NHGyzZt2iRUVRVXX311s9+7I9M3mZmZYujQoe1eTwghDh06JOx2u5gyZUrj81cIIZ544gkBQPz1r39tvGz8+PECgHj66aeb3EY8nysdvS0hOjd909GRks8++6xDj3NrIyXtPQ8OHDggrFaruOiii5rc3l133dXuaE+D2267TQAQW7dubbysurpaOJ1OMX369MbLGo4tjzzySJu3l5aWJk455ZTG/7c2qgig1Wluih1331AzFosFl19+OVatWtVkt8mSJUuQn5+PSZMmAajfvTFq1CicdtppjddJTU3Fddddh507d+Krr75q975uuOGGJv//97//DYvFgjlz5jS5/Fe/+hWEEPjPf/7T5PLJkyc3+UQ4ZMgQpKWlYfv27R3+fTvilVdewYABA9C/f38cOXKk8WvixIkAgBUrVgAAMjIyAABvvvkmotFoi7eVkZGBPXv2YO3ata3en8vlavx3KBTC0aNH0bt3b2RkZGDDhg1t1nr8z9bV1eHIkSMYO3YshBD47LPPOvT7Hi8SieDdd9/FRRddhJ49ezZeXlhYiCuuuAIfffQRampqmvzMdddd12RR8emnn45IJIJdu3a1ej/79+/Hxo0bMXPmTGRlZTVePmTIEJx11ln497//3enaAaCmpgYej6dD1122bBmCwSBuueUWqOoPh8df/OIXSEtLw//93/81ub7D4cA111zT5LJ4Plc6eluJ0jAS8s4778Dr9Xb659t7HixfvhzhcBg33nhjk5+76aabOnwfV111FYD641OD1157DX6/H1deeWXjZQ07Ctt7Lng8nma7D51OJ5YuXdrs6/777+9wndQxDCXUooYXc8MLfc+ePfjwww9x+eWXN+6g2bVrF/r169fsZwcMGND4/bZYrVaUlJQ0uWzXrl0oKipqduBo7TZLS0ub3W5mZiYqKyvbvO/O+uabb/Dll18iNze3yVffvn0BAIcOHQIAXHbZZRg3bhx+/vOfIz8/H5dffjlefvnlJm86v/3tb5GamopRo0ahT58+mDVrVpMhewDw+Xy444470K1bNzgcDuTk5CA3NxdVVVWorq5us9bdu3c3vrGnpqYiNzcX48ePB4B2f7Ylhw8fhtfrbfVvHY1GUV5e3uTyE/8umZmZANDm36Xhb9va/Rw5cgR1dXWdrj8tLa3NLe4dqcFut6Nnz57Nnn/FxcWw2+1NLovnc6Wjt5UoPXr0wNy5c/E///M/yMnJwdSpU/Hkk092+HnU3vOg4fHs3bt3k+tlZWU1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20VRUZGYPn262LZtW+PtPPPMM+KMM84Q2dnZwuFwiF69eonbbrutSUOnyspKcc0114icnByRmpoqpk6dKrZs2dLsd2tpS/BXX30lJk+eLFJTU0VOTo74xS9+0bhV+vi/QTgcFjfddJPIzc0ViqJ0qHna1KlTRWpqqnC73WLChAnik08+aXKdhsd67dq1TS7vTOfZZcuWiXHjxgmXyyXS0tLE+eef36R52vG315EtwQ327dsnbr311saGdG63WwwfPlzce++9zZppPfHEE6J///7CZrOJ/Px8ccMNN7TaPK0l8XqudPS2hBBiy5Yt4owzzhAul6tD22m/++47MXnyZOFwOER+fr743e9+J5YuXdrk77R9+3bxs5/9TPTq1auxid+ECRPEsmXLmtxWa6+5jjwPwuGw+MMf/iAKCgqEy+USEydOFF9//bXIzs4W119/fZu/w/EqKiqEw+EQAJo9X070r3/9S0yePFlkZGQ0bu8dNGhQi03V2toS3NnjCrWP574hIiJNqaqqQmZmJu65555WRz3i6ec//zmee+65Dp9LiRKH0zdERCSNz+drtovp0UcfBYBOn2QyVs888wwOHjyIG264AUVFRTGvX6Ku40gJERFJs3DhQixcuBDnnHMOUlNT8dFHH+GFF17AlClT8M4778guj5KMIyVERCTNkCFDYLVa8eCDD6KmpqZx8WtXtxuTPnGkhIiIiDSBfUqIiIhIExhKiIiISBNMtaYkGo1i37598Hg8nWrKQ0RERLERQqC2thZFRUXtN9WU2COlS+bPny8AiJtvvrnDP1NeXt5mExx+8Ytf/OIXv/iVmK/y8vJ236d1OVKydu1aPPPMMxgyZEinfq6hhXd5+f1IS3MmojSiH2x1A594ZVdBZHj/HGxDtSUkuwxqhb/Oj9vPvb3FkyCeSHeh5NixY7jyyivxl7/8pdNbxhqmbNLSnEhLa37KcaK46m4HPhOyqyAytIiqIJQu4NLf25npdGTZhO4Wus6aNQvnnntuh04hHggEUFNT0+SLKGky+cmNKNGqU61g9DcOXUXLF198ERs2bMDatWs7dP358+fj7rvvTnBVRK2wRoFcG3CY4YQoUSo8VgB8jRmFbkZKysvLcfPNN+Mf//gHnM6OrQeZN28eqqurG7/Ky8sTXCXRCYp1lfuJdKeSM/GGopsj5vr163Ho0CGccsop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KiZPnoxVq1ZJrMy4qqurAQBZWVmSKzGmWbNm4dxzz23ynKb4+Ne//oURI0bg0ksvRV5eHk4++WT85S9/kV2W4YwdOxbLly/Htm3bAACbNm3CRx99hGnTpkmurONMdUI+ip8jR44gEokgPz+/yeX5+fnYsmWLpKqMKxqN4pZbbsG4ceNw0kknyS7HcF588UVs2LABa9eulV2KIW3fvh0LFizA3Llz8bvf/Q5r167FnDlzYLfbMWPGDNnlGcbtt9+Ompoa9O/fHxaLBZFIBPfeey+uvPJK2aV1GEMJkQ7MmjULX3zxBT766CPZpRhOeXk5br75ZixduhROp1N2OYYUjUYxYsQI3HfffQCAk08+GV988QWefvpphpI4evnll/GPf/wDS5YswaBBg7Bx40bccsstKCoq0s3jzFBCMcnJyYHFYsHBgwebXH7w4EEUFBRIqsqYZs+ejbfeegsrV65ESUmJ7HIMZ/369Th06BBOOeWUxssikQhWrlyJJ554AoFAABaLRWKF+ldYWIiBAwc2uWzAgAF47bXXJFVkTLfddhtuv/12XH755QCAwYMHY9euXZg/f75uQgnXlFBM7HY7hg8fjuXLlzdeFo1GsXz5cowZM0ZiZcYhhMDs2bPx+uuv47333kOPHj1kl2RIkyZNwubNm7Fx48bGrxEjRuDKK6/Exo0bGUjiYNy4cc22s2/btg1lZWWSKjImr9cLVW36tm6xWBCNRiVV1HkcKaGYzZ07FzNmzMCIESMwatQoPProo6irq8M111wjuzRDmDVrFpYsWYI333wTHo8HBw4cAACkp6fD5XJJrs44PB5Ps3U6KSkpyM7O5vqdOLn11lsxduxY3HffffjJT36CNWvW4Nlnn8Wzzz4ruzRDOf/883HvvfeitLQUgwYNwmeffYaHH34YP/vZz2SX1nGCqAsef/xxUVpaKux2uxg1apRYvXq17JIMA0CLX88//7zs0gxv/Pjx4uabb5ZdhqH87//+rzjppJOEw+EQ/fv3F88++6zskgynpqZG3HzzzaK0tFQ4nU7Rs2dP8fvf/14EAgHZpXUY+5QQERGRJnBNCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJERERaQJDCREREWkCQwkRERFpAkMJEWnW4cOHUVBQgPvuu6/xsk8++QR2ux3Lly+XWBkRJQJPyEdEmvbvf/8bF110ET755BP069cPw4YNw4UXXoiHH35YdmlEFGcMJUSkebNmzcKyZcswYsQIbN68GWvXroXD4ZBdFhHFGUMJEWmez+fDSSedhPLycqxfvx6DBw+WXRIRJQDXlBCR5n333XfYt28fotEodu7cKbscIkoQjpQQkaYFg0GMGjUKw4YNQ79+/fDoo49i8+bNyMvLk10aEcUZQwkRadptt92GV199FZs2bUJqairGjx+P9PR0vPXWW7JLI6I44/QNEWnW+++/j0cffRSLFy9GWloaVFXF4sWL8eGHH2LBggWyyyOiOONICREREWkCR0qIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBMYSoiIiEgTGEqIiIhIExhKiIiISBP+P47pALgePnBfAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 800x800 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "vt = Voironi_Tessalation(coreset_df, clusters, colors, tesslation_by_cluster=False)\n",
+    "vt.plot_voironi(plot_title=\"Voironi Tessalation of Coreset using VQE\", show_annotation=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## QAOA Implementation\n",
+    "\n",
+    "CUDA-Q is designed to be a flexible tool for developers so they can test different implementations of the same code. For example, one can perform the same analysis, instead using a QAOA approach. Only the kernel needs to be changed as is done below."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "                                                                             »\n",
+      "q0 : ──●──────────────────●──────────────────────────────────────────────────»\n",
+      "     ╭─┴─╮╭────────────╮╭─┴─╮                                                »\n",
+      "q1 : ┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──────────────────────────»\n",
+      "     ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮                        »\n",
+      "q2 : ────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──»\n",
+      "                             ╰───╯╰────────────╯╰───╯╭─┴─╮╭────────────╮╭─┴─╮»\n",
+      "q3 : ────────────────────────────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├»\n",
+      "                                                     ╰───╯╰────────────╯╰───╯»\n",
+      "q4 : ────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                             »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                        ╭───╮╭────────────╮╭───╮╭───────────╮\n",
+      "────────────────────────┤ x ├┤ rz(0.3527) ├┤ x ├┤ rx(1.111) ├\n",
+      "                        ╰─┬─╯╰────────────╯╰─┬─╯├───────────┤\n",
+      "──────────────────────────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "                          │                  │  ├───────────┤\n",
+      "──────────────────────────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "                          │                  │  ├───────────┤\n",
+      "──●──────────────────●────┼──────────────────┼──┤ rx(1.111) ├\n",
+      "╭─┴─╮╭────────────╮╭─┴─╮  │                  │  ├───────────┤\n",
+      "┤ x ├┤ rz(0.3527) ├┤ x ├──●──────────────────●──┤ rx(1.111) ├\n",
+      "╰───╯╰────────────╯╰───╯                        ╰───────────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "def get_QAOA_circuit(number_of_qubits, circuit_depth) -> cudaq.Kernel:\n",
+    "    \"\"\"Returns the QAOA circuit for the given number of qubits and circuit depth\n",
+    "\n",
+    "\n",
+    "    Args:\n",
+    "        number_of_qubits (int): Number of qubits\n",
+    "        circuit_depth (int): Circuit depth\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq.Kernel: QAOA Circuit\n",
+    "    \"\"\"\n",
+    "\n",
+    "    @cudaq.kernel\n",
+    "    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):\n",
+    "        qubits = cudaq.qvector(number_of_qubits)\n",
+    "\n",
+    "        layers = circuit_depth\n",
+    "\n",
+    "        for layer in range(layers):\n",
+    "            for qubit in range(number_of_qubits):\n",
+    "                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])\n",
+    "                rz(2.0 * thetas[layer], qubits[(qubit + 1) % number_of_qubits])\n",
+    "                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])\n",
+    "\n",
+    "            rx(2.0 * thetas[layer + layers], qubits)\n",
+    "\n",
+    "    return kernel\n",
+    "\n",
+    "\n",
+    "circuit = get_QAOA_circuit(5, circuit_depth)\n",
+    "\n",
+    "print(cudaq.draw(circuit, np.random.rand(2 * circuit_depth), 5, circuit_depth))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_optimizer(\n",
+    "    optimizer: cudaq.optimizers.optimizer, max_iterations, **kwargs\n",
+    ") -> Tuple[cudaq.optimizers.optimizer, int]:\n",
+    "    \"\"\"\n",
+    "    Returns the optimizer with the given parameters\n",
+    "\n",
+    "    Args:\n",
+    "        optimizer (cudaq.optimizers.optimizer): Optimizer\n",
+    "        max_iterations (int): Maximum number of iterations\n",
+    "        **kwargs: Additional arguments\n",
+    "\n",
+    "    Returns:\n",
+    "        tuple(cudaq.optimizers.optimizer, int): Optimizer and parameter count\n",
+    "    \"\"\"\n",
+    "\n",
+    "    parameter_count = 2 * kwargs[\"circuit_depth\"]\n",
+    "    optimizer.initial_parameters = np.random.uniform(-np.pi / 8.0, np.pi / 8.0, parameter_count)\n",
+    "    optimizer.max_iterations = max_iterations\n",
+    "    return optimizer, parameter_count"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 484/484 [00:00<00:00, 12163.89it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12/12 [00:00<00:00, 52703.30it/s]\n",
+      "100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 48/48 [00:00<00:00, 31987.07it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 36393.09it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 37957.50it/s]\n",
+      "100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 4/4 [00:00<00:00, 42473.96it/s]\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "divisive_clustering = DivisiveClusteringVQA(\n",
+    "    circuit_depth=circuit_depth,\n",
+    "    max_iterations=max_iterations,\n",
+    "    max_shots=max_shots,\n",
+    "    threshold_for_max_cut=0.75,\n",
+    "    create_Hamiltonian=get_K2_Hamiltonian,\n",
+    "    optimizer=optimizer,\n",
+    "    optimizer_function=get_optimizer,\n",
+    "    create_circuit=get_QAOA_circuit,\n",
+    "    normalize_vectors=True,\n",
+    "    sort_by_descending=True,\n",
+    "    coreset_to_graph_metric=\"dist\",\n",
+    ")\n",
+    "\n",
+    "hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(coreset_df)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Scaling simulations with CUDA-Q\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The University of Edinburgh team quickly encountered scaling challenges when they were developing this method. By developing with CUDA-Q they were able to port their code to an HPC environment once GPUs became available. GPUs massively accelerated their development and testing and allowed them to produce the 25 qubit experiments presented in their publication. If you have a GPU available, run the following code examples and see how the times compare on your device. Each call executes the divisive clustering procedure using the QAOA method, 100000 simulated shots for each VQE loop, and maximum 75 VQE iterations."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "First, try a slightly larger N=18 problem using the CPU (`qpp-cpu`) backend."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Uncomment the following line if you want to explicitly execute this step on your system.\n",
+    "# !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 18"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now try the N=18 example on the GPU backend (`nvidia`)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "100%|███████████████████████████████████████| 751/751 [00:00<00:00, 3460.26it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 42771.74it/s]\n",
+      "100%|█████████████████████████████████████| 4064/4064 [00:00<00:00, 6862.37it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 56871.92it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 44979.13it/s]\n",
+      "100%|██████████████████████████████████████| 128/128 [00:00<00:00, 19366.94it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 53773.13it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 54648.91it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 51941.85it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 56111.09it/s]\n",
+      "Total time for the execution: 461.866833317\n",
+      "Total time spent on CUDA-Q: 10.452308367999706\n"
+     ]
+    }
+   ],
+   "source": [
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 18"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Scaling up to N=25, the task becomes even more onerous on a CPU. Depending on your device, the simulation may not even run. Try it and feel free to interrupt after your patience has worn out."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# target = 'qpp-cpu'\n",
+    "# Uncomment the following line if you want to explicitly execute this step on your system.\n",
+    "# !python3 divisive_clustering_src/main_divisive_clustering.py --target qpp-cpu --M 25"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "N=25 can still easily be completed by a single GPU."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "100%|█████████████████████████████████████| 7352/7352 [00:03<00:00, 2063.82it/s]\n",
+      "100%|███████████████████████████████████| 16492/16492 [00:03<00:00, 4739.44it/s]\n",
+      "100%|██████████████████████████████████████| 256/256 [00:00<00:00, 15185.58it/s]\n",
+      "100%|████████████████████████████████████████| 64/64 [00:00<00:00, 23728.05it/s]\n",
+      "100%|██████████████████████████████████████| 256/256 [00:00<00:00, 15437.97it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 50840.05it/s]\n",
+      "100%|████████████████████████████████████████| 32/32 [00:00<00:00, 33562.82it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 54120.05it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 54560.05it/s]\n",
+      "100%|██████████████████████████████████████████| 8/8 [00:00<00:00, 55924.05it/s]\n",
+      "100%|████████████████████████████████████████| 16/16 [00:00<00:00, 42717.29it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 55007.27it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 53601.33it/s]\n",
+      "100%|██████████████████████████████████████████| 4/4 [00:00<00:00, 47127.01it/s]\n",
+      "Total time for the execution: 67.61674502899999\n",
+      "Total time spent on CUDA-Q: 21.439895901\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia'\n",
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 25"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If we want to push the simulation to an $N=34$ coreset, a single GPU (assuming A100) will run out of memory.  Run the code below to see for yourself. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "RuntimeError: NLOpt runtime error: nlopt failure\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia'\n",
+    "!python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia --M 34"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To compute a problem with 34 qubits, we need to pool the memory of multiple GPUs.  If you have multiple GPUs available, try the code below to run the same computation on 4 GPUs. You do not need to wait for the code to finish, just note how it does not fail immediately due to memory issues."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "Using BFL2 method to generate coresets\n",
+      "^C\n"
+     ]
+    }
+   ],
+   "source": [
+    "# target = 'nvidia-mgpu'\n",
+    "gpu_count = !nvidia-smi -L | wc -l\n",
+    "try:\n",
+    "    gpu_count = int(gpu_count[0])\n",
+    "except:\n",
+    "    gpu_count = 0    \n",
+    "if gpu_count >= 4:\n",
+    "    !mpirun -np 4 python3 divisive_clustering_src/main_divisive_clustering.py --target nvidia-mgpu --M 34\n",
+    "else:\n",
+    "    print(f'Not enough GPUs found on this system ({gpu_count}) to run this step')"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/H2-MRQKS.ipynb b/pr-2241/sphinx/examples/python/tutorials/H2-MRQKS.ipynb
new file mode 100644
index 0000000000..f919d08673
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/H2-MRQKS.ipynb
@@ -0,0 +1,458 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Multi-Reference Quantum Krylov Algorithm (H2 Example)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Package installs\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermionpyscf==0.5\n",
+    "!pip install openfermion==1.6.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "import scipy\n",
+    "\n",
+    "# Single-node, single gpu\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "multi_gpu = False\n",
+    "\n",
+    "# Single-node, multi-GPU\n",
+    "#cudaq.set_target(\"nvidia\", option='mqpu,fp64')\n",
+    "#multi_gpu = True\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Ground state energy (classical simulation)=  (-1.1371757102406843+0j) , index=  3\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Define H2 molecule\n",
+    "geometry = [('H', (0.0, 0.0, 0.0)), ('H', (0.0, 0.0, 0.7474))]\n",
+    "\n",
+    "hamiltonian, data = cudaq.chemistry.create_molecular_hamiltonian(\n",
+    "    geometry, 'sto-3g', 1, 0)\n",
+    "\n",
+    "electron_count = data.n_electrons\n",
+    "qubits_num = 2 * data.n_orbitals\n",
+    "\n",
+    "spin_ham_matrix = hamiltonian.to_matrix()\n",
+    "e, c = np.linalg.eig(spin_ham_matrix)\n",
+    "\n",
+    "# Find the ground state energy and the corresponding eigenvector\n",
+    "print('Ground state energy (classical simulation)= ', np.min(e), ', index= ',\n",
+    "      np.argmin(e))\n",
+    "min_indices = np.argmin(e)\n",
+    "\n",
+    "# Eigen vector can be used to initialize the qubits\n",
+    "vec = c[:, min_indices]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Collect coefficients from a spin operator so we can pass them to a kernel\n",
+    "def termCoefficients(ham: cudaq.SpinOperator) -> list[complex]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.get_coefficient()))\n",
+    "    return result\n",
+    "\n",
+    "\n",
+    "# Collect Pauli words from a spin operator so we can pass them to a kernel\n",
+    "def termWords(ham: cudaq.SpinOperator) -> list[str]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.to_string(False)))\n",
+    "    return result\n",
+    "\n",
+    "\n",
+    "coefficient = termCoefficients(hamiltonian)\n",
+    "pauli_string = termWords(hamiltonian)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def U_psi(qubits: cudaq.qview, dt: float, coefficients: list[complex],\n",
+    "          words: list[cudaq.pauli_word]):\n",
+    "    # Compute U_m = exp(-i m dt H)\n",
+    "    for i in range(len(coefficients)):\n",
+    "        exp_pauli(dt * coefficients[i].real, qubits, words[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def U_phi(qubits: cudaq.qview, dt: float, coefficients: list[complex],\n",
+    "          words: list[cudaq.pauli_word]):\n",
+    "    # Compute U_n = exp(-i n dt H)\n",
+    "    for i in range(len(coefficients)):\n",
+    "        exp_pauli(dt * coefficients[i].real, qubits, words[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def apply_pauli(qubits: cudaq.qview, word: list[int]):\n",
+    "\n",
+    "    # Add H (Hamiltonian operator)\n",
+    "    for i in range(len(word)):\n",
+    "        if word[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "        if word[i] == 2:\n",
+    "            y(qubits[i])\n",
+    "        if word[i] == 3:\n",
+    "            z(qubits[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def qfd_kernel(dt_alpha: float, dt_beta: float, coefficients: list[complex],\n",
+    "               words: list[cudaq.pauli_word], word_list: list[int],\n",
+    "               vec: list[complex]):\n",
+    "\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    qreg = cudaq.qvector(vec)\n",
+    "\n",
+    "    h(ancilla)\n",
+    "\n",
+    "    x(ancilla)\n",
+    "    cudaq.control(U_psi, ancilla, qreg, dt_alpha, coefficients, words)\n",
+    "    x(ancilla)\n",
+    "\n",
+    "    cudaq.control(apply_pauli, ancilla, qreg, word_list)\n",
+    "    cudaq.control(U_phi, ancilla, qreg, dt_beta, coefficients, words)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def pauli_str(pauli_word, qubits_num):\n",
+    "\n",
+    "    my_list = []\n",
+    "    for i in range(qubits_num):\n",
+    "        if str(pauli_word[i]) == 'I':\n",
+    "            my_list.append(0)\n",
+    "        if str(pauli_word[i]) == 'X':\n",
+    "            my_list.append(1)\n",
+    "        if str(pauli_word[i]) == 'Y':\n",
+    "            my_list.append(2)\n",
+    "        if str(pauli_word[i]) == 'Z':\n",
+    "            my_list.append(3)\n",
+    "    return my_list"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define the spin-op x for real component and y for the imaginary component.\n",
+    "\n",
+    "x_0 = cudaq.spin.x(0)\n",
+    "y_0 = cudaq.spin.y(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#Define parameters for the quantum Krylov space\n",
+    "\n",
+    "dt = 0.5\n",
+    "\n",
+    "# Dimension of the Krylov space\n",
+    "m_qfd = 4"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Compute the basis overlap matrix\n",
+    "\n",
+    "\n",
+    "## Single GPU:\n",
+    "if not multi_gpu:\n",
+    "\n",
+    "    # Add identity operator to compute overlap of basis\n",
+    "\n",
+    "    observe_op = 1.0\n",
+    "    for m in range(qubits_num):\n",
+    "        observe_op *= cudaq.spin.i(m)\n",
+    "\n",
+    "    identity_word = observe_op.to_string(False)\n",
+    "\n",
+    "    pauli_list = pauli_str(identity_word, qubits_num)\n",
+    "    #print(pauli_list)\n",
+    "\n",
+    "    wf_overlap = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "            results = cudaq.observe(qfd_kernel, [x_0, y_0], dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec)\n",
+    "            temp = [result.expectation() for result in results]\n",
+    "            wf_overlap[m, n] = temp[0] + temp[1] * 1j\n",
+    "            if n != m:\n",
+    "                wf_overlap[n, m] = np.conj(wf_overlap[m, n])\n",
+    "\n",
+    "else:\n",
+    "\n",
+    "    ## Multi-GPU\n",
+    "\n",
+    "    # Compute the basis overlap matrix\n",
+    "\n",
+    "    # Add identity operator to compute overlap of basis\n",
+    "\n",
+    "    observe_op = 1.0\n",
+    "    for m in range(qubits_num):\n",
+    "        observe_op *= cudaq.spin.i(m)\n",
+    "\n",
+    "    identity_word = observe_op.to_string(False)\n",
+    "\n",
+    "    pauli_list = pauli_str(identity_word, qubits_num)\n",
+    "    #print(pauli_list)\n",
+    "\n",
+    "    wf_overlap = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    collect_overlap_real = []\n",
+    "    collect_overlap_img = []\n",
+    "\n",
+    "    count=0\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "            \n",
+    "            count_id=count%2\n",
+    "            #print(count_id)\n",
+    "            collect_overlap_real.append(cudaq.observe_async(qfd_kernel, x_0, dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec, qpu_id=count_id))\n",
+    "            \n",
+    "            collect_overlap_img.append(cudaq.observe_async(qfd_kernel, y_0, dt_m, dt_n,\n",
+    "                                    coefficient, pauli_string, pauli_list, vec, qpu_id=count_id+2))\n",
+    "            count += 1\n",
+    "\n",
+    "    tot_dim = 0\n",
+    "\n",
+    "    for n in range(m_qfd):\n",
+    "        for m in range(n,m_qfd):\n",
+    "            observe_result = collect_overlap_real[tot_dim].get()\n",
+    "            real_val = observe_result.expectation()  \n",
+    "        \n",
+    "            observe_result=collect_overlap_img[tot_dim].get()\n",
+    "            img_val=observe_result.expectation() \n",
+    "        \n",
+    "            wf_overlap[m, n] = real_val + img_val * 1j\n",
+    "            if n != m:\n",
+    "                wf_overlap[n, m] = np.conj(wf_overlap[m, n])\n",
+    "            \n",
+    "            tot_dim += 1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Compute the matrix Hamiltonian\n",
+    "\n",
+    "\n",
+    "## Single GPU:\n",
+    "if not multi_gpu:\n",
+    "    ham_matrx = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "\n",
+    "            tot_e = np.zeros(2)\n",
+    "            for coef, word in zip(coefficient, pauli_string):\n",
+    "                #print(coef,word)\n",
+    "\n",
+    "                pauli_list = pauli_str(word, qubits_num)\n",
+    "                #print(pauli_list)\n",
+    "\n",
+    "                results = cudaq.observe(qfd_kernel, [x_0, y_0], dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec)\n",
+    "\n",
+    "                temp = [result.expectation() for result in results]\n",
+    "                #print(temp)\n",
+    "                temp[0] = coef.real * temp[0]\n",
+    "                temp[1] = coef.imag * temp[1]\n",
+    "\n",
+    "                tot_e[0] += temp[0]\n",
+    "                tot_e[1] += temp[1]\n",
+    "\n",
+    "            ham_matrx[m, n] = tot_e[0] + tot_e[1] * 1j\n",
+    "            if n != m:\n",
+    "                ham_matrx[n, m] = np.conj(ham_matrx[m, n])\n",
+    "else:\n",
+    "    ## Multi-GPU\n",
+    "\n",
+    "    ham_matrx = np.zeros((m_qfd, m_qfd), dtype=complex)\n",
+    "\n",
+    "\n",
+    "    for m in range(m_qfd):\n",
+    "        dt_m = dt * m\n",
+    "        for n in range(m, m_qfd):\n",
+    "            dt_n = dt * n\n",
+    "\n",
+    "            ham_matrix_real = []\n",
+    "            ham_matrix_imag = []\n",
+    "            \n",
+    "            count=0\n",
+    "            tot_e = np.zeros(2)\n",
+    "            for coef, word in zip(coefficient, pauli_string):\n",
+    "                count_id=count%2\n",
+    "                #print(coef,word)\n",
+    "\n",
+    "                pauli_list = pauli_str(word, qubits_num)\n",
+    "                #print(pauli_list)\n",
+    "\n",
+    "                ham_matrix_real.append(cudaq.observe_async(qfd_kernel, x_0, dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec, qpu_id=count_id))\n",
+    "                ham_matrix_imag.append(cudaq.observe_async(qfd_kernel, y_0, dt_m, dt_n,\n",
+    "                                        coefficient, pauli_string, pauli_list, vec, qpu_id=count_id+2))\n",
+    "\n",
+    "                count += 1\n",
+    "            \n",
+    "            i = 0\n",
+    "            for coef in coefficient:\n",
+    "                \n",
+    "                observe_result = ham_matrix_real[i].get()\n",
+    "                real_val = observe_result.expectation()  \n",
+    "        \n",
+    "                observe_result=ham_matrix_imag[i].get()\n",
+    "                img_val=observe_result.expectation() \n",
+    "                \n",
+    "                tot_e[0] += real_val * coef.real \n",
+    "                tot_e[1] += img_val * coef.imag\n",
+    "                \n",
+    "                i+=1\n",
+    "            \n",
+    "            ham_matrx[m, n] = tot_e[0] + tot_e[1] * 1j\n",
+    "            if n != m:\n",
+    "                ham_matrx[n, m] = np.conj(ham_matrx[m, n])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Diagonalize the matrix\n",
+    "\n",
+    "\n",
+    "def eig(H, s):\n",
+    "    #Solver for generalized eigenvalue problem\n",
+    "\n",
+    "    # HC = SCE\n",
+    "\n",
+    "    THRESHOLD = 1e-20\n",
+    "    s_diag, u = scipy.linalg.eig(s)\n",
+    "    s_prime = []\n",
+    "    for sii in s_diag:\n",
+    "        if np.imag(sii) > 1e-7:\n",
+    "            raise ValueError(\n",
+    "                \"S may not be hermitian, large imag. eval component.\")\n",
+    "        if np.real(sii) > THRESHOLD:\n",
+    "            s_prime.append(np.real(sii))\n",
+    "\n",
+    "    X_prime = np.zeros((len(s_diag), len(s_prime)), dtype=complex)\n",
+    "\n",
+    "    for i in range(len(s_diag)):\n",
+    "        for j in range(len(s_prime)):\n",
+    "            X_prime[i][j] = u[i][j] / np.sqrt(s_prime[j])\n",
+    "\n",
+    "    H_prime = (((X_prime.conjugate()).transpose()).dot(H)).dot(X_prime)\n",
+    "    e_prime, C_prime = scipy.linalg.eig(H_prime)\n",
+    "    C = X_prime.dot(C_prime)\n",
+    "\n",
+    "    return e_prime, C"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Energy from QFD:\n",
+      "(-1.1367554712424826+3.373828079812224e-20j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "eigen_value, eigen_vect = eig(ham_matrx[0:m_qfd, 0:m_qfd], wf_overlap[0:m_qfd,\n",
+    "                                                                      0:m_qfd])\n",
+    "print('Energy from QFD:')\n",
+    "print(np.min(eigen_value))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/Shors.ipynb b/pr-2241/sphinx/examples/python/tutorials/Shors.ipynb
new file mode 100644
index 0000000000..dbfff32498
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/Shors.ipynb
@@ -0,0 +1,987 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "628c747b-084c-4fb6-843e-7c7f4cbf07a1",
+   "metadata": {},
+   "source": [
+    "# Factoring Integers With Shor's Algorithm"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6d0627c4-95bd-47b9-9ab5-e8374d25508e",
+   "metadata": {},
+   "source": [
+    "The most famous application of quantum computers is factoring integers using Shor's algorithm. This algorithm is particularly significant because an efficient factorization algorithm could potentially break modern asymmetric encryption schemes, such as RSA.\n",
+    "\n",
+    "For small integers, this quantum algorithm can be simulated on classical computers. The main challenge in classical implementation lies in the order-finding algorithm. We will first introduce the classical implementation of this algorithm as a preliminary step, and then proceed to explain the quantum order-finding algorithm.\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "148568d8",
+   "metadata": {},
+   "source": [
+    "First let's install some libraries."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "486fb3d4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install contfrac"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 156,
+   "id": "88619b35-624e-4853-8d2e-6d9952390e5e",
+   "metadata": {
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "from math import gcd, log2, ceil\n",
+    "import numpy as np\n",
+    "import random\n",
+    "import cudaq\n",
+    "from cudaq import *\n",
+    "import fractions\n",
+    "import matplotlib.pyplot as plt\n",
+    "import contfrac\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c8523c6f-d729-4d5e-8df9-1780c343a58e",
+   "metadata": {},
+   "source": [
+    "## Shor's algorithm\n",
+    "The factoring problem for an integer $N$ aims to find integers $a_1$, $a_2$ which are factors of $N$.  This problem is interesting when $N$ is not prime and the solutions $a_1$ and $a_2$ are non-trivial.  In other words, we will attempt to find integers $a_1$ and $a_2$ satisfying $N=a_1\\cdot a_2$ with $a_1\\neq 1$ and $a_2\\neq 1$.\n",
+    "\n",
+    "The algorithm consists of two ideas:\n",
+    "\n",
+    "* Reduce the problem of factoring the integer $N$ to the order-finding problem.\n",
+    "* Solve the order-finding problem: \n",
+    "Given integers $a$ and $N$ so that $a$ and $N$ share no common factors (i.e., the greatest common divisor of $a$ and $N$ is 1), find the smallest positive integer which satisfies $a^r \\equiv 1 \\mod N$.  This value $r$ is refered to as the *order of* $a \\mod N$.\n",
+    "\n",
+    "These two ideas are combined in the following steps in Shor's algorithm:\n",
+    "\n",
+    "0. Rule out the easy case that $N$ is even\n",
+    "1. Select a random integer $a$ between $2$ and $N-1$\n",
+    "2. Check to see if $a$ is a factor of $N$ (if so we're done!)\n",
+    "3. Find the order of $a \\mod N$, (i.e., find $r$ so that $a^r\\equiv 1 \\mod N$)\n",
+    "4. Check to see if $a^{\\frac{r}{2}}-1$ or $a^{\\frac{r}{2}}+1$ are integers and share common, non-trivial, divisors with $N$ (if so we're done!)\n",
+    "5. If no factor is found, repeat steps 1 through 4 above.\n",
+    "\n",
+    "The function `shors_algorithm` below outlines these steps for both the classical and the quantum implementation of Shor's algorithm. For the purposes of demonstration, we will also control the initial random integer selected in step 1 so that we can investigate cases in which the selected integer produces common divisors of $N$ in step 4 and others in which step 4 produces no common factors.\n",
+    "\n",
+    "\n",
+    "**Note about terminology:** Some literature refers to the \"period-finding problem\" in Shor's algorithm.  The order-finding problem, as we have described above, can be recast as finding the period of the function $f(x) = a^x\\mod N$, by noticing that the period of $f(x)$ is one more than the order of $a\\mod N$. The period finding problem is more general than the order-finding problem since it aims to find the period of any periodic function, not just modular exponentiation.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "7dd05729",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def shors_algorithm(N, initial, quantum):\n",
+    "    \"\"\" Factor N using Shor's algorithm with initial starting value and choice of \n",
+    "    using either classical or quantum approach for the period finding step\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    N: int \n",
+    "        Integer to be factored (assumed to be non-prime and >1)\n",
+    "    initial: int \n",
+    "        Initial choice of the random integer between 2 and N-1\n",
+    "    quantum: boolean\n",
+    "        True if we will call the quantum order-finding algorithm, and false if we call the classical one for step 3.   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    a1, a2: int\n",
+    "        Non-trivial factors of N\n",
+    "    \"\"\"\n",
+    "\n",
+    "    # 0. Check to see if N is even.\n",
+    "    if N % 2 == 0:\n",
+    "        divisor1 = 2\n",
+    "        divisor2 = N // 2\n",
+    "        print(\"Found factors:\", divisor1, divisor2)\n",
+    "        return (divisor1, divisor2)\n",
+    "\n",
+    "    attempts = [initial]\n",
+    "    while (True):\n",
+    "        # 1. Select a random integer between 2 and N-1\n",
+    "        if len(attempts) == 1:\n",
+    "            a = initial\n",
+    "        else:\n",
+    "            a = random.choice(\n",
+    "                [n for n in range(N - 1) if n not in attempts and n != 1])\n",
+    "\n",
+    "        # 2. See if the integer selected in step 1 happens to factor N\n",
+    "        print(\"Trying a =\", a)\n",
+    "        divisor1 = gcd(a, N)\n",
+    "        if divisor1 != 1:\n",
+    "            divisor2 = N // divisor1\n",
+    "            print(\"Found factors of N={} by chance: {} and {}\".format(N, divisor1, divisor2))\n",
+    "            return (divisor1, divisor2)\n",
+    "\n",
+    "        # 3. Find the order of a mod N (i.e., r, where a^r = 1 (mod N))\n",
+    "        if quantum == True:\n",
+    "            r = find_order_quantum(a, N)\n",
+    "        else:\n",
+    "            r = find_order_classical(a, N)\n",
+    "        print(\"The order of a = {} is {}\".format(a,r))\n",
+    "\n",
+    "        # 4. If the order of a is found and it is\n",
+    "        # * even and\n",
+    "        # * not a^(r/2) = -1 (mod N),\n",
+    "        # then test a^(r/2)-1 and a^(r/2)+1 to see if they share factors with N.\n",
+    "        # We also want to rule out the case of finding the trivial factors: 1 and N.\n",
+    "        divisor1, divisor2 = test_order(a, r, N)\n",
+    "        if (divisor1 != 0):  # test_order will return a 0 if no factor is found\n",
+    "            print(\"Found factors of N = {}: {} and {}\".format(N,divisor1, divisor2))\n",
+    "            return divisor1, divisor2\n",
+    "\n",
+    "        # 5. Repeat\n",
+    "        print(\"retrying...\")\n",
+    "        attempts.append(a)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ed682e81",
+   "metadata": {},
+   "source": [
+    "Let's first explore the idea of reducing the factoring problem into the order-finding problem. This gets captured in step 4 described above.  In this step, we have already established that $a$ and $N$ share no factors other than $1$ (i.e., $\\gcd(a,N)=1$) and we have found $r$, the order of $a\\mod N.$  With this information we know that $a^r \\equiv 1 \\mod N.$  Rewritten in another way:\n",
+    "$$\n",
+    "a^r -1 \\equiv 0\\mod N\n",
+    "\\tag{1}.\n",
+    "$$ \n",
+    " \n",
+    " If $r$ is even, we can rewrite $a^r$ as $x^2$ where $x=a^\\frac{r}{2}$. Next, we can factor equation $(1)$ using the identity $x^2-1 = (x-1)(x+1)$:\n",
+    " $$ \n",
+    " (a^{\\frac{r}{2}} - 1)(a^{\\frac{r}{2}} + 1) \\equiv 0\\mod N\n",
+    "\\tag{2}.\n",
+    "$$  \n",
+    "\n",
+    "If, in addition, the equation\n",
+    "$$\n",
+    "a^{\\frac{r}{2}}  \\not\\equiv -1\\mod N\n",
+    "\\tag{3}\n",
+    "$$\n",
+    "is satisfied, then  at least one of the terms $a^{\\frac{r}{2}} - 1$ or $a^{\\frac{r}{2}} + 1$ must share a common factor with $N$. [Peter Shor](https://arxiv.org/abs/quant-ph/9508027) demonstrated that there is greater than a $50\\%$ chance of randomly selecting a value for $a$ satisfying these properties.\n",
+    "\n",
+    "The code block below defines a function that tests whether $r$ is even and whether equation $(3)$ is satisfied and searches for a non-trivial factor of $N$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 157,
+   "id": "6c8eed12",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def test_order(a, r, N):\n",
+    "    \"\"\"Checks whether or not a^(r/2)+1 or a^(r/2)-1 share a non-trivial common factor with N\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "    r: int\n",
+    "    N: int\n",
+    "    \n",
+    "    Returns\n",
+    "    -------\n",
+    "    int, int factors of N, if found; 0,0 otherwise  \n",
+    "    \"\"\"\n",
+    "\n",
+    "    if r != None and (r % 2 == 0) and a**r % N == 1:\n",
+    "        if (a**(int(r / 2))) % N != -1:\n",
+    "            possible_factors = [gcd(r - 1, N), gcd(r + 1, N)]\n",
+    "            for test_factor in possible_factors:\n",
+    "                if test_factor != 1 and test_factor != N:\n",
+    "                    return test_factor, N // test_factor\n",
+    "    # period did not produce a factor\n",
+    "    else:\n",
+    "        print('No non-trivial factor found')\n",
+    "        return 0, 0\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a43af433-905c-4070-94b3-0f6be6f67f6b",
+   "metadata": {},
+   "source": [
+    "### Solving the order-finding problem classically\n",
+    "\n",
+    "The key component of Shor's algorithm is an efficient quantum algorithm to find the order $r$ of $a \\mod N$. While a straightforward classical algorithm can solve this problem, it is notably inefficient:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 158,
+   "id": "14f4b0d8",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_order_classical(a, N):\n",
+    "    \"\"\"A naive classical method to find the order r of a (mod N).\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "        an integer in the interval [2,N-1]\n",
+    "    N: int\n",
+    "    \n",
+    "    Returns\n",
+    "    -------\n",
+    "    r: int \n",
+    "        Period of a^x (mod N)\n",
+    "    \"\"\"\n",
+    "    assert 1 < a and a < N\n",
+    "    r = 1\n",
+    "    y = a\n",
+    "    while y != 1:\n",
+    "        y = y * a % N\n",
+    "        r += 1\n",
+    "    return r"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "aae6b36d",
+   "metadata": {},
+   "source": [
+    "Let's see how Shor's algorithm works on a few examples using the classical order-finding problem.  Notice how often our choice of value for the initial guess for $a$ produces factors of $N$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 159,
+   "id": "3f75b314-9f0c-40c5-a7bc-58ae235fc183",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Trying a = 42\n",
+      "Found factors of N=123 by chance: 3 and 41\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "(3, 41)"
+      ]
+     },
+     "execution_count": 159,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "my_integer = 123  #edit this value to try out a few examples\n",
+    "# Edit the value in the line below to try out different initial guesses for a.\n",
+    "# What happens when you choose a = 42 for the integer 123?\n",
+    "# What happens when you choose a = 100 for the integer 123?\n",
+    "initial_value_to_start = 42  # edit this value; it should be less than my_integer\n",
+    "\n",
+    "shors_algorithm(my_integer, initial_value_to_start, False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "275efced-b10e-4438-9b5e-f3534079304b",
+   "metadata": {},
+   "source": [
+    "### Solving the order-finding problem with a quantum algorithm\n",
+    "\n",
+    "\n",
+    "The Fourier transform is a classical computation that provides a more efficient algorithm than the one encoded in `find_order_classical` for identifying the period of $f(x) = a^x\\mod N$. The quantum version of the Fourier transform is the central idea of Shor's Algorithm. This efficient quantum solution derives the period from a measurement of $n = \\lceil log2(N) \\rceil$ qubits. \n",
+    "\n",
+    "The image below outlines the quantum kernel used to find the order of $a$. Notice the last step involves applying the Inverse Quantum Fourier Transform."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "aba9fbd7",
+   "metadata": {},
+   "source": [
+    "![](images/shor_circuit.png)\n",
+    "\n",
+    "Figure. Circuit diagram for finding the phase of the modular multiplication gate $U|x\\rangle = |a^x\\mod N\\rangle $, which will be used to compute the order of $a$ modulo $N$.  The number of qubits in the control register determines the accuracy of estimating the phase of $U$. The size of the work register depends on $N$. The goal of this section is to code the  diagram as a kernel named `phase_kernel`. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d7eff3b6",
+   "metadata": {},
+   "source": [
+    "We will need to create a quantum kernel for the Inverse Quantum Fourier Transform.  Additionally we'll need to create a kernel for modular multiplication: $g(y) = ay \\mod N$, which can be repeatedly applied $x$-times to $y=1$ to carry our modular exponentation $f(x)=a^x\\mod N$."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "567e104e",
+   "metadata": {},
+   "source": [
+    "#### Inverse quantum Fourier transform\n",
+    "In the code block below we define a kernel for the quantum Fourier transform and then use `cudaq.adjoint` to create a kernel for the inverse quantum Fourier transform used in the quantum order-finding algorithm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 160,
+   "id": "0e04a0a4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define kernels for the quantum Fourier transform and the inverse quantum Fourier transform\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform(qubits: cudaq.qview):\n",
+    "    qubit_count = len(qubits)\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def inverse_qft(qubits: cudaq.qview):\n",
+    "    cudaq.adjoint(quantum_fourier_transform, qubits)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "39db9e6a",
+   "metadata": {},
+   "source": [
+    "#### Quantum kernels for modular exponentiation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1b8b8884",
+   "metadata": {},
+   "source": [
+    "\n",
+    "While Shor's algorithm provably can factor numbers faster than known classical techniques, the resources required for implementing Shor's algorithm are hefty. A full-scale implementation to factor an $L$-bit number could require a quantum kernel with $5L+1$ qubits to achieve accuracy for the continued fractions part of the algoirthm and as many as $72L^3$ quantum gates for the modular exponentiaion [(Beckman, Chari, Devabhaktuni, & Preskill, 1996)](https://arxiv.org/pdf/quant-ph/9602016).  Both of these are well beyond the capabilities of modern quantum hardware for numbers of interest. Advancements to reduce the number of gates and qubits required focus on optimizing the kernel for $f(x) = a\\cdot x \\mod N$ for properties of the number to be factored. The difficulty is to create efficient quantum kernels (in terms of qubit and gate count) that compute $a\\cdot x \\mod{N}$.  \n",
+    "\n",
+    "For the purposes of this demonstration, we will consider only the order-finding problem for the values of $a$ to be either $4$ or $5$ with $N=21$. We'll be using the quantum circuits depicted in [this paper](https://arxiv.org/abs/2103.13855) and [this report](https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf), respectively. \n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a48d6fa1",
+   "metadata": {},
+   "source": [
+    "##### The case N = 21 and a = 5:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 161,
+   "id": "c4b8e2e4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def modular_mult_5_21(work: cudaq.qview):\n",
+    "    \"\"\"\"Kernel for multiplying by 5 mod 21\n",
+    "    based off of the circuit diagram in \n",
+    "    https://physlab.org/wp-content/uploads/2023/05/Shor_s_Algorithm_23100113_Fin.pdf\n",
+    "    Modifications were made to change the ordering of the qubits\"\"\"\n",
+    "    x(work[0])\n",
+    "    x(work[2])\n",
+    "    x(work[4])\n",
+    "    \n",
+    "    swap(work[0], work[4])\n",
+    "    swap(work[0], work[2])\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def modular_exp_5_21(exponent: cudaq.qview, work: cudaq.qview,\n",
+    "                     control_size: int):\n",
+    "    \"\"\" Controlled modular exponentiation kernel used in Shor's algorithm\n",
+    "    |x> U^x |y> = |x> |(5^x)y mod 21>\n",
+    "    \"\"\"\n",
+    "    x(work[0])\n",
+    "    for exp in range(control_size):\n",
+    "        ctrl_qubit = exponent[exp]\n",
+    "        for _ in range(2**(exp)):\n",
+    "            cudaq.control(modular_mult_5_21, ctrl_qubit, work)\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0c644786",
+   "metadata": {},
+   "source": [
+    "Verify in the code block below that the kernels defined above do in fact carry out multiplication and exponentiation with $a=5$ and $N=21$ by changing the `iterations` variable below. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 198,
+   "id": "e93fcf39",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮      \n",
+      "q0 : ┤ x ├┤ x ├─╳──╳─\n",
+      "     ╰───╯╰───╯ │  │ \n",
+      "q1 : ───────────┼──┼─\n",
+      "     ╭───╮      │  │ \n",
+      "q2 : ┤ x ├──────┼──╳─\n",
+      "     ╰───╯      │    \n",
+      "q3 : ───────────┼────\n",
+      "     ╭───╮      │    \n",
+      "q4 : ┤ x ├──────╳────\n",
+      "     ╰───╯           \n",
+      "\n",
+      "Measurement results from sampling: { 10100:200 }\n",
+      "\n",
+      "For x = 1, 5^x mod 21 = 5\n",
+      "For x = 1, the computed result of the circuit is 5\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Demonstrate iterated application of 5y mod 21 where y = 1\n",
+    "@cudaq.kernel\n",
+    "def demonstrate_mod_exponentiation(iterations: int):\n",
+    "    qubits = cudaq.qvector(5)\n",
+    "    x(qubits[0]) # initalizes the qubits in the state for y = 1 which is |10000>\n",
+    "    for _ in range(iterations):\n",
+    "        modular_mult_5_21(qubits)\n",
+    "\n",
+    "\n",
+    "shots = 200\n",
+    "\n",
+    "# The iterations variable determines the exponent in 5^x mod 21. \n",
+    "# Change this value to verify that the demonstrate_mod_exponentiation\n",
+    "# kernel carries out the desired calculation.\n",
+    "iterations = 1  \n",
+    "\n",
+    "print(cudaq.draw(demonstrate_mod_exponentiation, iterations))\n",
+    "\n",
+    "results = cudaq.sample(demonstrate_mod_exponentiation,\n",
+    "                       iterations,\n",
+    "                       shots_count=shots)\n",
+    "\n",
+    "print(\"Measurement results from sampling:\", results)\n",
+    "\n",
+    "# Reverse the order of the most probable measured bit string\n",
+    "# and convert the binary string to an integer\n",
+    "integer_result = int(results.most_probable()[::-1],2)\n",
+    "\n",
+    "print(\"For x = {}, 5^x mod 21 = {}\".format(iterations, (5**iterations) % 21))\n",
+    "print(\"For x = {}, the computed result of the circuit is {}\".format(\n",
+    "    iterations, integer_result))\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ff07579c",
+   "metadata": {},
+   "source": [
+    "##### The case N = 21 and a = 4:\n",
+    "\n",
+    "The example below is one where the work register has been optimized to use fewer gates and qubits than would have been necessary through a straightforward implementation of modular multiplication as seen in the previous case."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 199,
+   "id": "69963075",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def modular_exp_4_21(exponent: cudaq.qview, work: cudaq.qview):\n",
+    "    \"\"\" Controlled modular exponentiation kernel used in Shor's algorithm\n",
+    "     |x> U^x |y> = |x> |(4^x)y mod 21>\n",
+    "     based off of the circuit diagram in https://arxiv.org/abs/2103.13855\n",
+    "     Modifications were made to account for qubit ordering differences\"\"\"\n",
+    "    swap(exponent[0], exponent[2])\n",
+    "    # x = 1\n",
+    "    x.ctrl(exponent[2], work[1])\n",
+    "\n",
+    "    # x = 2\n",
+    "    x.ctrl(exponent[1], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    x.ctrl([exponent[1], work[0]], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "\n",
+    "    # x = 4\n",
+    "    x(work[1])\n",
+    "    x.ctrl([exponent[0], work[1]], work[0])\n",
+    "    x(work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    x.ctrl([exponent[0], work[0]], work[1])\n",
+    "    x.ctrl(work[1], work[0])\n",
+    "    swap(exponent[0], exponent[2])\n",
+    "    "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "84a197e2",
+   "metadata": {},
+   "source": [
+    "Now we are ready to define the `phase_kernel` to carry out the instructions in the circuit diagram drawn at the beginning of this section."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 200,
+   "id": "206bcac3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def phase_kernel(control_register_size: int, work_register_size: int, a: int,\n",
+    "                 N: int):\n",
+    "    \"\"\" \n",
+    "    Kernel to estimate the phase of the modular multiplication gate |x> U |y> = |x> |a*y mod 21> for a = 4 or 5\n",
+    "    \"\"\"\n",
+    "\n",
+    "    qubits = cudaq.qvector(control_register_size + work_register_size)\n",
+    "    control_register = qubits[0:control_register_size]\n",
+    "    work_register = qubits[control_register_size:control_register_size +\n",
+    "                           work_register_size]\n",
+    "\n",
+    "    h(control_register)\n",
+    "\n",
+    "    if a == 4 and N == 21:\n",
+    "        modular_exp_4_21(control_register, work_register)\n",
+    "    if a == 5 and N == 21:\n",
+    "        modular_exp_5_21(control_register, work_register, control_register_size)\n",
+    "\n",
+    "    inverse_qft(control_register)\n",
+    "\n",
+    "    # Measure only the control_register and not the work_register\n",
+    "    mz(control_register)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 201,
+   "id": "ca9b570a",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮                                                                    »\n",
+      "q0 : ┤ h ├──●────●────●───●──●────────────────────────────────────────────────»\n",
+      "     ├───┤  │    │    │   │  │                                                »\n",
+      "q1 : ┤ h ├──┼────┼────┼───┼──┼───●────●────●───●──●───●────●────●───●──●──────»\n",
+      "     ├───┤  │    │    │   │  │   │    │    │   │  │   │    │    │   │  │      »\n",
+      "q2 : ┤ h ├──┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───┼────┼────┼───┼──┼───●──»\n",
+      "     ├───┤╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮»\n",
+      "q3 : ┤ x ├┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├»\n",
+      "     ╰───╯╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯»\n",
+      "q4 : ────────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼──────»\n",
+      "               ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      »\n",
+      "q5 : ──────────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────»\n",
+      "               ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         »\n",
+      "q6 : ─────────────────┼───┼────────────────┼───┼────────────────┼───┼─────────»\n",
+      "                    ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │         »\n",
+      "q7 : ───────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─────────»\n",
+      "                    ╰───╯                ╰───╯                ╰───╯           »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                                                                            »\n",
+      "────────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                            »\n",
+      "────────────────────────────────────────────────────────────────────────────»\n",
+      "                                                                            »\n",
+      "──●────●───●──●───●────●────●───●──●───●────●────●───●──●───●────●────●───●─»\n",
+      "  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │  │ ╭─┴─╮  │    │   │ »\n",
+      "──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳──╳─┤ x ├──┼────┼───╳─»\n",
+      "  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │  │ ╰───╯  │    │   │ »\n",
+      "──┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼──┼────────┼────┼───┼─»\n",
+      "╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │  │      ╭─┴─╮  │   │ »\n",
+      "┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼──╳──────┤ x ├──┼───┼─»\n",
+      "╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │         ╰───╯  │   │ »\n",
+      "───────┼───┼────────────────┼───┼────────────────┼───┼────────────────┼───┼─»\n",
+      "     ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │              ╭─┴─╮ │ »\n",
+      "─────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳──────────────┤ x ├─╳─»\n",
+      "     ╰───╯                ╰───╯                ╰───╯                ╰───╯   »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "                           ╭─────────────╮╭────────────╮╭───╮\n",
+      "───────────────────────────┤ r1(-0.7854) ├┤ r1(-1.571) ├┤ h ├\n",
+      "        ╭────────────╮╭───╮╰──────┬──────╯╰─────┬──────╯╰───╯\n",
+      "────────┤ r1(-1.571) ├┤ h ├───────┼─────────────●────────────\n",
+      "   ╭───╮╰─────┬──────╯╰───╯       │                          \n",
+      "─●─┤ h ├──────●───────────────────●──────────────────────────\n",
+      " │ ╰───╯                                                     \n",
+      "─╳───────────────────────────────────────────────────────────\n",
+      " │                                                           \n",
+      "─┼───────────────────────────────────────────────────────────\n",
+      " │                                                           \n",
+      "─╳───────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "─────────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "─────────────────────────────────────────────────────────────\n",
+      "                                                             \n",
+      "\n",
+      "Measurement results for a=5 and N=21 with 3 qubits in the control register \n",
+      "{ 000:2843 010:913 111:1850 001:1935 011:1830 100:2846 101:1861 110:922 }\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "control_register_size = 3\n",
+    "work_register_size = 5\n",
+    "values_for_a = [4, 5]\n",
+    "idx = 1  # change to 1 to select 5\n",
+    "N = 21\n",
+    "shots = 15000\n",
+    "\n",
+    "print(\n",
+    "    cudaq.draw(phase_kernel, control_register_size, work_register_size,\n",
+    "               values_for_a[idx], N))\n",
+    "\n",
+    "results = cudaq.sample(phase_kernel,\n",
+    "                       control_register_size,\n",
+    "                       work_register_size,\n",
+    "                       values_for_a[idx],\n",
+    "                       N,\n",
+    "                       shots_count=shots)\n",
+    "print(\n",
+    "    \"Measurement results for a={} and N={} with {} qubits in the control register \"\n",
+    "    .format(values_for_a[idx], N, control_register_size))\n",
+    "print(results)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4718d04f",
+   "metadata": {},
+   "source": [
+    "### Determining the order from the measurement results of the phase kernel\n",
+    "\n",
+    "The measurement results from sampling the `phase_kernel` can be used to estimate the phase of the operator $U|x\\rangle = ax\\mod N$. We will only be interested in the most probable non-zero outcomes of the sampling.  Therefore, we'll create a function `top_results` to extract those values."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 202,
+   "id": "9e96846f",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def top_results(sample_results, zeros, threshold):\n",
+    "    \"\"\"Function to output the non-zero results whose counts are above the given threshold\n",
+    "    Returns\n",
+    "    -------\n",
+    "        dict[str, int]: keys are bit-strings and values are the respective counts  \n",
+    "    \"\"\"\n",
+    "    results_dictionary = {k: v for k, v in sample_results.items()}\n",
+    "    if zeros in results_dictionary.keys():\n",
+    "        results_dictionary.pop(zeros)\n",
+    "    sorted_results = {\n",
+    "        k: v for k, v in sorted(\n",
+    "            results_dictionary.items(), key=lambda item: item[1], reverse=True)\n",
+    "    }\n",
+    "    top_key = next(iter(sorted_results))\n",
+    "    max_value = sorted_results[top_key]\n",
+    "    top_results_dictionary = {top_key: max_value}\n",
+    "\n",
+    "    for key in sorted_results:\n",
+    "        if results_dictionary[key] > min(threshold, max_value):\n",
+    "            top_results_dictionary[key] = results_dictionary[key]\n",
+    "    return top_results_dictionary"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b55ab5a",
+   "metadata": {},
+   "source": [
+    "Let's see how the `top_results` extracts the top results from the measurement results for a=4 and N=21 with 3 qubits in the control register that we computed above.  One of these top result is likely to be an estimate for the phase of $U$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 203,
+   "id": "cb717231",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'100': 2846,\n",
+       " '001': 1935,\n",
+       " '101': 1861,\n",
+       " '111': 1850,\n",
+       " '011': 1830,\n",
+       " '110': 922,\n",
+       " '010': 913}"
+      ]
+     },
+     "execution_count": 203,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Example\n",
+    "top_results(results, '000', 750)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "cda8137a",
+   "metadata": {},
+   "source": [
+    "The algorithm for translating the phase estimate of the operator $U|x\\rangle = ax\\mod N$ into the order of $a \\mod N$ involves continued fractions. The function `find_order_quantum` below carries out this computation.  To learn more about how the phase of $U$ relates to the period of $a \\mod N$, check out these three lectures by Scott Aaronson: lecture [19](https://www.scottaaronson.com/qclec/19.pdf), [20](https://www.scottaaronson.com/qclec/20.pdf), [21](https://www.scottaaronson.com/qclec/21.pdf)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 204,
+   "id": "a562fde9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_order_from_phase(phase, phase_nbits, a, N):\n",
+    "    \"\"\"Uses continued fractions to find the order of a mod N  \n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    phase: int\n",
+    "        Integer result from the phase estimate of U|x> = ax mod N\n",
+    "    phase_nbits: int\n",
+    "        Number of qubits used to estimate the phase\n",
+    "    a: int\n",
+    "        For this demonstration a is either 4 or 5\n",
+    "    N: int\n",
+    "        For this demonstration N = 21\n",
+    "    Returns\n",
+    "    -------\n",
+    "    int: period of a mod N if found, otherwise returns None\n",
+    "    \"\"\"\n",
+    "\n",
+    "    assert phase_nbits > 0\n",
+    "    assert a > 0\n",
+    "    assert N > 0\n",
+    "\n",
+    "    eigenphase = float(phase) / 2**(phase_nbits)\n",
+    "\n",
+    "    f = fractions.Fraction.from_float(eigenphase).limit_denominator(N)\n",
+    "\n",
+    "    if f.numerator == 1:\n",
+    "        return None\n",
+    "    eigenphase = float(f.numerator / f.denominator)\n",
+    "    print('eigenphase is ', eigenphase)\n",
+    "    coefficients_continued_fraction = list(\n",
+    "        contfrac.continued_fraction(eigenphase))\n",
+    "    \n",
+    "    convergents_continued_fraction = list(contfrac.convergents(eigenphase))\n",
+    "    print('convergent sequence of fractions for this eigenphase is', convergents_continued_fraction)\n",
+    "    for r in convergents_continued_fraction:\n",
+    "        print('using the denominators of the fractions in the convergent sequence, testing order =', r[1])\n",
+    "        if a**r[1] % N == 1:\n",
+    "            print('Found order:', r[1])\n",
+    "            return (r[1])\n",
+    "    return None\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "47511fbe",
+   "metadata": {},
+   "source": [
+    "We are now ready to combine all the elements above into a function to find the order of $a$ $\\mod N$ and test it in the factoring algoithm."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 205,
+   "id": "7ad0abcf",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_order_quantum(a, N):\n",
+    "    \"\"\"The quantum algorithm to find the order of a mod N, when x = 4 or x =5 and N = 21\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    a: int\n",
+    "        For this demonstration a will be either 4 or 5\n",
+    "    N: int\n",
+    "        For this demonstration N will be 21\n",
+    "    Returns\n",
+    "    r: int the period if it is found, or None if no period is found\n",
+    "    -------\n",
+    "    \n",
+    "    \"\"\"\n",
+    "\n",
+    "    if (a == 4 and N == 21) or (a == 5 and N == 21):\n",
+    "        shots = 15000\n",
+    "        if a == 4 and N == 21:\n",
+    "            control_register_size = 3\n",
+    "            work_register_size = 2\n",
+    "        if a == 5 and N == 21:\n",
+    "            control_register_size = 5\n",
+    "            work_register_size = 5\n",
+    "\n",
+    "        #cudaq.set_random_seed(123)\n",
+    "        results = cudaq.sample(phase_kernel,\n",
+    "                               control_register_size,\n",
+    "                               work_register_size,\n",
+    "                               a,\n",
+    "                               N,\n",
+    "                               shots_count=shots)\n",
+    "        print(\"Measurement results:\")\n",
+    "        print(results)\n",
+    "\n",
+    "        # We will want to ignore the all zero result\n",
+    "        zero_result = ''.join(\n",
+    "            [str(elem) for elem in [0] * control_register_size])\n",
+    "        # We'll only consider the top results from the sampling\n",
+    "        threshold = shots * (.1)\n",
+    "        most_probable_bitpatterns = top_results(results, zero_result, threshold)\n",
+    "\n",
+    "        for key in most_probable_bitpatterns:\n",
+    "            # Convert the key bit string into an integer \n",
+    "            # This integer divided by 8 is an estimate for the phase\n",
+    "            reverse_result = key[::-1]\n",
+    "            phase = int(reverse_result, 2)\n",
+    "            \n",
+    "            print(\"Trying nonzero bitpattern from the phase estimation:\", key,\n",
+    "                  \"=\", phase)\n",
+    "            r = get_order_from_phase(phase, control_register_size, a, N)\n",
+    "            if r == None:\n",
+    "                print('No period found.')\n",
+    "\n",
+    "                continue\n",
+    "\n",
+    "            return r\n",
+    "            break\n",
+    "    else:\n",
+    "        print(\n",
+    "            \"A different quantum kernel is required for this choice of a and N.\"\n",
+    "        )"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 206,
+   "id": "79927898",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Trying a = 5\n",
+      "Measurement results:\n",
+      "{ 11010:452 11001:92 11101:47 00000:2485 01001:96 00100:131 01011:1747 00101:1654 10101:1736 00110:475 11111:23 01000:50 01101:38 01110:35 01010:420 11110:22 01111:26 00011:50 01100:120 10011:35 00010:25 00001:22 11011:1710 00111:79 11100:113 10001:14 10010:29 10100:129 10110:467 10000:2536 10111:81 11000:61 }\n",
+      "\n",
+      "Trying nonzero bitpattern from the phase estimation: 10000 = 1\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 01011 = 26\n",
+      "eigenphase is  0.8125\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (4, 5), (13, 16)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 5\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 16\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 10101 = 21\n",
+      "eigenphase is  0.65\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (1, 2), (2, 3), (13, 20)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 2\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 3\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 20\n",
+      "No period found.\n",
+      "Trying nonzero bitpattern from the phase estimation: 11011 = 27\n",
+      "eigenphase is  0.8421052631578947\n",
+      "convergent sequence of fractions for this eigenphase is [(0, 1), (1, 1), (5, 6), (16, 19)]\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 1\n",
+      "using the denominators of the fractions in the convergent sequence, testing order = 6\n",
+      "Found order: 6\n",
+      "The order of a =5 is 6\n",
+      "Found factors of N = 21: 7 and 3\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "(7, 3)"
+      ]
+     },
+     "execution_count": 206,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "my_integer = 21\n",
+    "initial_value_to_start = 5  # Try replacing 5 with 4\n",
+    "quantum = True\n",
+    "shors_algorithm(my_integer, initial_value_to_start, quantum)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c243a5ee",
+   "metadata": {},
+   "source": [
+    "### Postscript\n",
+    "Recent [work of Oded Regev](https://arxiv.org/abs/2308.06572) improves Shor's Algorithm by reducing the number of gates needed.  You can read more about it [here](https://www.quantamagazine.org/thirty-years-later-a-speed-boost-for-quantum-factoring-20231017/)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "db11e690",
+   "metadata": {},
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/afqmc.ipynb b/pr-2241/sphinx/examples/python/tutorials/afqmc.ipynb
new file mode 100644
index 0000000000..76d62e3014
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/afqmc.ipynb
@@ -0,0 +1,531 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Quantum Enhanced Auxiliary Field Quantum Monte Carlo\n",
+    "\n",
+    "This work was done in collaboration with the Next Generation Computing team at [BASF](https://www.basf.com/global/en.html).\n",
+    "\n",
+    "In this tutorial we implement a quantum-classical hybrid workflow for computing the ground state energies of a strongly interacting molecular system. The algorithm consists of two parts:\n",
+    "\n",
+    "\n",
+    "1. A variational quantum eigensolver that uses the quantum-number-preserving ansatz proposed by [Anselmetti et al. (2021)](https://doi.org/10.1088/1367-2630/ac2cb3) to generate a quantum trial wave function $|\\Psi_T\\rangle$ using CUDA Quantum.\n",
+    "\n",
+    "2. An Auxiliary-Field Quantum Monte Carlo simulation that realizes a classical imaginary time evolution and collects the ground state energy estimates.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Package installs\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermion==1.6.1\n",
+    "!pip install ipie==0.7.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Relevant imports\n",
+    "\n",
+    "import cudaq\n",
+    "\n",
+    "import numpy as np\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "from pyscf import gto, scf, ao2mo, mcscf\n",
+    "\n",
+    "from afqmc_src.vqe_cudaq_qnp import VQE, get_cudaq_hamiltonian\n",
+    "from afqmc_src.utils_ipie import get_coeff_wf, gen_ipie_input_from_pyscf_chk\n",
+    "\n",
+    "from ipie.hamiltonians.generic import Generic as HamGeneric\n",
+    "from ipie.qmc.afqmc import AFQMC\n",
+    "from ipie.systems.generic import Generic\n",
+    "from ipie.trial_wavefunction.particle_hole import ParticleHole\n",
+    "from ipie.analysis.extraction import extract_observable\n",
+    "\n",
+    "from ipie.config import config\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "\n",
+    "# Ipie has recently added GPU support however this remains a bit tricky to use as it requires manual installation of several packages.\n",
+    "# Once this is streamlined, we can set the GPU option to True in the tutorial.\n",
+    "config.update_option(\"use_gpu\", False)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We start by defining the structure of the molecule, the basis set, and its spin. We build the molecule object with PySCF and run a preliminary Hartree-Fock computation. Here we choose as an example a [chelating agent](https://doi.org/10.1021/acs.jctc.3c01375) representing a relevant class of substances industrially produced at large scales. Their use ranges, among the others, from water softeners in cleaning applications, modulators of redox behaviour in oxidative bleaching, scale suppressants, soil remediation and ligands for catalysts. In particular we focus here in a Fe(III)-NTA complex whose structure is given in the file imported below.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define the molecular structure and the basis set for the Fenta molecule.\n",
+    "\n",
+    "atom = \"afqmc_src/geo_fenta.xyz\"\n",
+    "basis = \"cc-pVTZ\"\n",
+    "spin = 1\n",
+    "num_active_orbitals = 5\n",
+    "num_active_electrons = 5\n",
+    "\n",
+    "# You can swap to O3 which is a smaller system and takes less computational resources and time to run.\n",
+    "\n",
+    "atom = \"afqmc_src/geo_o3.xyz\"\n",
+    "basis = \"cc-pVTZ\"\n",
+    "spin = 0\n",
+    "num_active_orbitals = 9\n",
+    "num_active_electrons = 12\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "-224.34048064812262"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# PYSCF helps to build the molecule and run Hartree-Fock.\n",
+    "\n",
+    "# Define the molecule.\n",
+    "molecule = gto.M(atom=atom, spin=spin, basis=basis, verbose=0)\n",
+    "\n",
+    "# Restriced open shell HF.\n",
+    "hartee_fock = scf.ROHF(molecule)\n",
+    "hartee_fock.chkfile = \"afqmc_src/output.chk\"\n",
+    "\n",
+    "# Run Hartree-Fock.\n",
+    "hartee_fock.kernel()\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Hamiltonian preparation for VQE\n",
+    "\n",
+    "Since this molecule contains of around 600 orbitals (which would correspond to 1200 qubits) and 143 total electrons, it is impossible to perform a full VQE with full statevector simulation. Therefore, we need to identify an active space with fewer orbitals and electrons that contribute to the strongly interacting part of the whole molecule. We then run a post Hartree-Fock computation with the PySCF's built-in CASCI method in order to obtain the one-body ($t_{pq}$) and two-body \n",
+    "($V_{prqs}$) integrals that define the molecular Hamiltonian in the active space:\n",
+    "\n",
+    "$$ H= \\sum_{pq}t_{pq}\\hat{a}_{p}^\\dagger \\hat {a}_{q}+\\sum_{pqrs}  V_{prqs}\\hat a_{p}^\\dagger \\hat a_{q}^\\dagger \\hat a_{s}\\hat a_{r} \\tag{1}$$\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from openfermion.transforms import jordan_wigner\n",
+    "from openfermion import generate_hamiltonian\n",
+    "\n",
+    "# Run a CASCI simulation for computing the Hamiltonian in the active space.\n",
+    "casci = mcscf.CASCI(hartee_fock, num_active_orbitals, num_active_electrons)\n",
+    "casci.fix_spin_(ss=(molecule.spin / 2 * (molecule.spin / 2 + 1)))\n",
+    "\n",
+    "\n",
+    "# Executes the kernel to compute the hamiltonian in the active space.\n",
+    "casci.kernel()\n",
+    "\n",
+    "# Compute the one-body (h1) and two-body integrals (tbi) as shown in equation 1.\n",
+    "h1, energy_core = casci.get_h1eff()\n",
+    "\n",
+    "h2 = casci.get_h2eff()\n",
+    "h2_no_symmetry = ao2mo.restore('1', h2, num_active_orbitals)\n",
+    "\n",
+    "# V_pqrs terms in H.\n",
+    "tbi = np.asarray(h2_no_symmetry.transpose(0, 2, 3, 1), order='C')\n",
+    "\n",
+    "# Compute the hamiltonian and convert it to a CUDA-Q operator.\n",
+    "mol_ham = generate_hamiltonian(h1, tbi, energy_core.item())\n",
+    "jw_hamiltonian = jordan_wigner(mol_ham)\n",
+    "hamiltonian, constant_term = get_cudaq_hamiltonian(jw_hamiltonian)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Run VQE with CUDA-Q\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can now execute the VQE algorithm using the quantum number preserving ansatz. At the end of the VQE, we store the final statevector that will be used in the classical AFQMC computation as an initial guess.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Using cudaq optimizer\n",
+      "# Num Params: 16\n",
+      "# Qubits: 18\n",
+      "# N_layers: 1\n",
+      "# Energy after the VQE: -224.3901690611431\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Define some options for the VQE.\n",
+    "options = {\n",
+    " 'n_vqe_layers': 1,\n",
+    " 'maxiter': 100,\n",
+    " 'energy_core': constant_term,\n",
+    " 'return_final_state_vec': True\n",
+    "}\n",
+    "\n",
+    "n_qubits = 2 * num_active_orbitals\n",
+    "\n",
+    "vqe = VQE(n_qubits=n_qubits,\n",
+    " num_active_electrons=num_active_electrons,\n",
+    " spin=spin,\n",
+    " options=options\n",
+    ")\n",
+    "\n",
+    "results = vqe.execute(hamiltonian)\n",
+    "\n",
+    "# Best energy from VQE.\n",
+    "optimized_energy = results['energy_optimized']\n",
+    "\n",
+    "# Final state vector.\n",
+    "final_state_vector = results[\"state_vec\"]\n",
+    "\n",
+    "# Energies during the optimization loop.\n",
+    "vqe_energies = results[\"callback_energies\"]\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Auxiliary Field Quantum Monte Carlo (AFQMC)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "AFQMC is a numerical method for computing relevant properties of strongly interacting molecules. AFQMC is a type of Quantum Monte Carlo method that combines the use of random walks with an auxiliary field to simulate the imaginary-time evolution of a quantum system and drive it to the lowest energy state. This method can provide accurate results for ground-state properties of a wide range of physical systems, including atoms, molecules, and solids. Here we summarize the main features of AFQMC while a detailed introduction to can be found [here](https://www.cond-mat.de/events/correl13/manuscripts/zhang.pdf).\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We consider the electronic Hamiltonian in the second quantization\n",
+    "\\begin{equation}\n",
+    "H = {H}_1 + {H}_2 \n",
+    "=\\sum_{pq} h_{pq} {a}_{p}^{\\dagger} {a}_{q} + \\frac{1}{2} \\sum_{pqrs} v_{pqrs}{a}_{p}^{\\dagger} {a}_r {a}^{\\dagger}_{q} {a}_s \\tag{2}\n",
+    "\\end{equation}\n",
+    "where ${a}_{p}^{\\dagger}$ and ${a}_{q}$ are fermionic creation and annihilation operators of orbitals $p$ and $q$, respectively. The terms $h_{pq} $ and \n",
+    "$v_{pqrs}$ are the matrix elements of the one-body, $H_1$, and two-body, $H_2$, interactions of $H$, respectively. Here, we omit the spin indices for simplicity.\n",
+    "\n",
+    "AFQMC realizes an imaginary time propagation of an initial state (chosen as a Slater determinant) $\\ket{\\Psi_{I}}$ towards the ground state $\\ket{\\Psi_0}$ of a given hamiltonian, $H$, with\n",
+    "\\begin{equation}\n",
+    "\\ket{\\Psi_0} \\sim\\lim_{n \\to \\infty} \\left[ e^{-\\Delta\\tau H  }  \\right]^{n} \\ket{\\Psi_{I}}\n",
+    "\\tag{3}\n",
+    "\\end{equation} \n",
+    "where $\\Delta\\tau$ is the imaginary time step.\n",
+    "\n",
+    "AFQMC relies on decomposing the two-body interactions $H_2$ in terms of sum of squares of one-body operators ${v}_\\gamma$ such that the Hamiltonian ${H}$ becomes\n",
+    "\\begin{equation}\n",
+    "H = v_0 - \\frac{1}{2}\\sum_{\\gamma=1}^{N_\\gamma} {v}_\\gamma^2\n",
+    "\\tag{4}\n",
+    "\\end{equation}\n",
+    "with ${v}_0 = {H}_1 $ and $\n",
+    "{v}_\\gamma = i \\sum_{pq} L^{\\gamma}_{pq} {a}_{p}^{\\dagger}{a}_{q}.\n",
+    "$\n",
+    "The $N_\\gamma$ matrices $L^{\\gamma}_{pq}$ are called Cholesky vectors as they are  obtained via a Cholesky decomposition of the two-body matrix elements \n",
+    "$v_{pqrs}$ via $v_{pqrs} = \\sum_{\\gamma=1}^{N_\\gamma} L^{\\gamma}_{pr} L^{\\gamma}_{qs}$.\n",
+    "\n",
+    "The imaginary time propagation evolves an ensemble of walkers $\\{\\phi^{(n)}\\}$ (that are Slater determinants) and allows one to access observables of the system. For example, the local energy\n",
+    "\\begin{equation}\n",
+    "\\mathcal{E}_{\\text{loc}}(\\phi^{(n)}) = \\frac{\\bra{\\Psi_\\mathrm{T}}H\\ket{\\phi^{(n)}}}{\\braket{\\Psi_\\mathrm{T}| \\phi^{(n)}}}\n",
+    "\\tag{5}\n",
+    "\\end{equation}\n",
+    "defined as the mixed expectation value of the Hamiltonian with the trial wave function $\\ket{\\Psi_\\mathrm{T}}$.\n",
+    "\n",
+    "\n",
+    "The trial wavefunction can be in general a single or a multi-Slater determinant coming from VQE for example. This might help in achieving more accurate ground state energy estimates.\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "The implementation of AFQMC we use here is from [ipie](https://github.com/JoonhoLee-Group/ipie) that supports both CPUs and GPUs and requires the following steps:\n",
+    "\n",
+    "\n",
+    "1. Preparation of the molecular Hamiltonian by performing the Cholesky decomposition\n",
+    "\n",
+    "2. Preparation of the trial state from the VQE wavefunction\n",
+    "\n",
+    "3. Executing AFQMC\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Preparation of the molecular Hamiltonian\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# Number of electrons in simulation: (12, 12)\n"
+     ]
+    }
+   ],
+   "source": [
+    "# AFQMC.\n",
+    "\n",
+    "# Generate the input Hamiltonian for ipie from the checkpoint file from pyscf.\n",
+    "ipie_hamiltonian = gen_ipie_input_from_pyscf_chk(hartee_fock.chkfile,\n",
+    "            mcscf=True,\n",
+    "            chol_cut=1e-5)\n",
+    "\n",
+    "\n",
+    "h1e, cholesky_vectors, e0 = ipie_hamiltonian\n",
+    "\n",
+    "\n",
+    "num_basis = cholesky_vectors.shape[1]\n",
+    "num_chol = cholesky_vectors.shape[0]\n",
+    "\n",
+    "\n",
+    "system = Generic(nelec=molecule.nelec)\n",
+    "\n",
+    "\n",
+    "afqmc_hamiltonian = HamGeneric(\n",
+    " np.array([h1e, h1e]),\n",
+    " cholesky_vectors.transpose((1, 2, 0)).reshape((num_basis * num_basis, num_chol)),\n",
+    " e0\n",
+    ")\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Preparation of the trial wave function\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Build the trial wavefunction from the state vector computed via VQE.\n",
+    "wavefunction = get_coeff_wf(final_state_vector,\n",
+    " n_active_elec=num_active_electrons,\n",
+    " spin=spin\n",
+    ")\n",
+    "\n",
+    "\n",
+    "trial = ParticleHole(wavefunction,\n",
+    " molecule.nelec,\n",
+    " num_basis,\n",
+    " num_dets_for_props=len(wavefunction[0]),\n",
+    " verbose=False\n",
+    ")\n",
+    "\n",
+    "\n",
+    "trial.compute_trial_energy = True\n",
+    "trial.build()\n",
+    "trial.half_rotate(afqmc_hamiltonian)\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Setup of the AFQMC parameters\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Here we can choose the input options like the timestep $\\Delta\\tau$, the total number of walkers `num_walkers` and the total number of AFQMC iterations `num_blocks`.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "# random seed is 96264512\n",
+      "            Block                   Weight            WeightFactor            HybridEnergy                  ENumer                  EDenom                  ETotal                  E1Body                  E2Body\n",
+      "                0   1.0000000000000000e+02  1.0000000000000000e+02  0.0000000000000000e+00 -2.2440857214519274e+04  1.0000000000000000e+02 -2.2440857214519275e+02 -3.7639365236571126e+02  1.5198508022051851e+02\n",
+      "                1   4.2236163323978462e+02  1.4108003803708052e+03 -1.1705550836048852e+02 -2.2476129978632798e+04  9.9999999999999986e+01 -2.2476129978632804e+02 -3.7647651634374250e+02  1.5171521655741444e+02\n",
+      "                2   1.0031021642240592e+02  3.8270298551287897e+02 -1.1736348706942081e+02 -2.2491539833590265e+04  1.0000000000000001e+02 -2.2491539833590261e+02 -3.7652287235836400e+02  1.5160747402246139e+02\n",
+      "                3   9.9896411716010476e+01  1.0006803820092617e+02 -1.1729991834244650e+02 -2.2498086858011950e+04  1.0000000000000001e+02 -2.2498086858011945e+02 -3.7661217900078998e+02  1.5163131042067059e+02\n",
+      "                4   1.0008819642734720e+02  1.0003952238189274e+02 -1.1741988525943451e+02 -2.2497768126542338e+04  1.0000000000000001e+02 -2.2497768126542334e+02 -3.7677859321228260e+02  1.5180091194685932e+02\n",
+      "                5   9.9996395539611001e+01  1.0010162124437146e+02 -1.1745900551679516e+02 -2.2504859704025963e+04  1.0000000000000003e+02 -2.2504859704025955e+02 -3.7665382466690920e+02  1.5160522762664974e+02\n",
+      "                6   1.0011117020963695e+02  1.0017267435124782e+02 -1.1762740654751367e+02 -2.2514761055266557e+04  1.0000000000000000e+02 -2.2514761055266558e+02 -3.7663824192346226e+02  1.5149063137079673e+02\n",
+      "                7   9.9926957189505018e+01  9.9904869631265882e+01 -1.1757145502349162e+02 -2.2517665690169804e+04  1.0000000000000000e+02 -2.2517665690169804e+02 -3.7662872023157632e+02  1.5145206332987829e+02\n",
+      "                8   9.9902183781120897e+01  9.9910184942535295e+01 -1.1753639400107765e+02 -2.2518490004346189e+04  9.9999999999999986e+01 -2.2518490004346194e+02 -3.7677944704924283e+02  1.5159454700578092e+02\n",
+      "                9   1.0011182782239581e+02  1.0010647250586344e+02 -1.1771801521929217e+02 -2.2513893408438777e+04  1.0000000000000001e+02 -2.2513893408438773e+02 -3.7679469177919265e+02  1.5165575769480495e+02\n",
+      "               10   9.9639946364053955e+01  9.9242085331654422e+01 -1.1742082647888712e+02 -2.2519016506034994e+04  1.0000000000000003e+02 -2.2519016506034987e+02 -3.7690149012513956e+02  1.5171132506478972e+02\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Setup the AFQMC parameters.\n",
+    "afqmc_msd = AFQMC.build(molecule.nelec,\n",
+    " afqmc_hamiltonian,\n",
+    " trial,\n",
+    " num_walkers=100,\n",
+    " num_steps_per_block=25,\n",
+    " num_blocks=10,\n",
+    " timestep=0.005,\n",
+    " stabilize_freq=5,\n",
+    " seed=96264512,\n",
+    " pop_control_freq=5,\n",
+    " verbose=False\n",
+    ")\n",
+    "\n",
+    "\n",
+    "# Run the AFQMC.\n",
+    "afqmc_msd.run(estimator_filename = 'afqmc_src/estimates.0.h5')\n",
+    "afqmc_msd.finalise(verbose=False)\n",
+    "\n",
+    "\n",
+    "# Extract the energies.\n",
+    "qmc_data = extract_observable(afqmc_msd.estimators.filename, \"energy\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "<matplotlib.legend.Legend at 0x7ab848ece110>"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "data": {
+      "image/png": "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H4+8PN0L3KtXr6bpGRERERkfHz9jEIMDVZ8+fSAIAkRRlLaFhoYCgLRdEASoVKqm7yUREREZB+dQGcTgQHXjxo3m7AcRERGZImnIj4GqNgYHKj8/v+bsBxEREZkiDvkZxKBJ6efOnYNarTb4oBcvXkRZWVmDO0VEREQmgkN+BjEoUPXt2xdZWVkGHzQkJATJyckN7hQRERGZCIW95icDVa0MGvITRRH//ve/YWtra9BBS0pKGtUpIiIiMhEKVqgMYVCgevzxx5GQkGDwQUNCQnSe8UdERERminOoDGJQoIqNjW3mbhAREZFJsuTCnobgSulERERUM2nIjxWq2jBQERERUc045GcQBioiIiKqGYf8DMJARURERDWTVkpnhao29Q5U+fm8bZKIiKjN4LIJBql3oPLw8MC0adNw5MiR5ugPERERmRLtwp6lBUA9nprS1tQ7UH3xxRe4d+8e/vKXv6Br165YtmwZUlNTm6NvREREZGzaR89ABMoKjdoVU1bvQDV27Fjs2rULKSkpmDVrFr788kv4+fkhNDQUO3fu5DP8iIiIWhPLSk9J4TyqGjV4UrqbmxvmzZuHc+fOYeXKlfj111/x97//Hd7e3njrrbdQUMCLTkREZPZksopQVcp5VDUxaKV0fTIyMrBlyxZER0fj5s2b+Pvf/46IiAjcvn0by5cvx/Hjx7F3796m7CsREREZg6WtZg4VJ6bXqN6BaufOndi8eTN++eUXdO/eHS+99BImTZoEZ2dnqc2AAQMQHBzclP0kIiIiY1HYAQV3OeRXi3oHqqlTp+K5557D77//joceekhvG29vb7z55puN7hwRERGZAAUX96xLvQNVWloabG1ta21jY2ODJUuWNLhTREREZEL4+Jk61TtQlZWVQalUVtsuCAKsrKygUCiapGNERERkIiy5uGdd6h2onJ2dIQhCjft9fHwwZcoULFmyBDIZn2xDRERk9qQhPwaqmtQ7UEVHR+PNN9/ElClT8PDDDwMATpw4gS1btmDx4sXIzMxEVFQUrKys8K9//avJO0xEREQtjEN+dap3oNqyZQtWrFiBZ599Vto2ZswYPPDAA1i3bh3279+Pjh074t1332WgIiIiag045Feneo/JHT16FH379q22vW/fvjh27BgA4LHHHkNycnLje0dERETGp32eHwNVjeodqHx9fbFx48Zq2zdu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+9HEGKiIiIio5bh10/zMTDBuP5oYAxURERG1nPblgYoVKiIiIqIGcuuq+ZmV2Kru9GOgIiIiopbj5AtYWAOqEuB+krF702QYqIiIiKjlyOQVj6BpRcN+DFRERETUsrTDfq1oYjoDFREREbWsVjgxnYGKiIiIWlYrXIuKgYqIiIhalrQW1RVAFI3blybCQEVEREQty7ULIMiA4hwgL8PYvWkSDFRERETUsiysgHadNL+3konpDFRERETU8tqX3+nXSuZRMVARERFRy2OgIiIiImqkVvaQZAYqIiIianmtbC0qBioiIiJqedq1qHLTgCKlcfvSBBioiIiIqOXZOAP2Hprf7141aleaAgMVERERGYc0Md3851ExUBEREZFxtKKJ6QxUREREZBxShYpDfkREREQN05AhP7UKOLYGyLjYPH1qIAYqIiIiMg7tkN+9G0BZiWGfOfMF8MsiYOeLzdevBmCgIiIiIuNw8AIUDoCoAu5dM+wzF77W/Mw4D9xParau1RcDFRERERmHIABu5cN+t/6ou31uBpB0pOJ9wk/N068GYKAiIiIi4wkeo/n52wqgtKj2tpd2A6IagKB5H/9Ds3atPhioiIiIyHgefhFw8AZykoG4z2tve+Gb8s/M0Py8eRQovN+8/TMQAxUREREZj8IWGLpI8/vhKKAwW3+7nNvAreMABOCxVwH37pq5V1f3tVRPa8VARURERMbV+3nALUhTbTqySn+bi99qfvoNABy9gW6jNO9NZNiPgYqIiIiMS24BDPuP5vc/PtNUo6rSDvf1+JvmpzZQJf4KlBU3exfrwkBFRERExtd1BNBxAFBWBByM1N2XdQ1IPQMIMqD7WM02776AvSdQkgckHW7x7lbFQEVERETGJwjAk0s1v//5JXD114p92uE+/8GAvZvmd5kM6DZS83v8jy3XzxowUBEREZFp8H0I6B6mWRohZhywdSyQcgq4sFOzv+c43fbaYb+EnwBRbNGuVmVh1LMTERERVfbUasDeAzi5Gbh+UPMCAJklEByq29b/ccDSDshN1QwJdniw5ftbjhUqIiIiMh3WTsCoD4CXTwF9JmrmTQFAlycAm3a6bS2tNdsBo6+abhaBKikpCREREfD394eNjQ0CAgKwZMkSlJRUPEgxNjYWYWFh8PLygp2dHfr06YOYmBid40RHR0MQBJ2XtbV1refeuXMn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OXOm6OzsLKanpxu7aybtH//4h+jk5CTGxsaKaWlp0qugoEBqM2vWLLFjx47igQMHxJMnT4ohISFiSEiIEXttHirf5SeKvI6GOnHihGhhYSG+++674tWrV8WYmBjR1tZW/OKLL6Q2y5YtE52dncXdu3eL586dE8PCwkR/f3+xsLDQiD03PS+88ILYoUMHcc+ePeKNGzfEnTt3iu3btxdff/11qQ2vpX65ubnimTNnxDNnzogAxJUrV4pnzpwRb968KYqiYddtxIgRYt++fcU//vhDPHLkiBgYGChOmDDBWF+pxTFQmbHVq1eLHTt2FBUKhfjwww+Lx48fN3aXTB4Ava/NmzdLbQoLC8WXXnpJbNeunWhrayv+7W9/E9PS0ozXaTNRNVDxOhru+++/F3v27ClaWVmJQUFB4vr163X2q9Vq8d///rfo4eEhWllZiU888YSYkJBgpN6aLqVSKc6ZM0fs2LGjaG1tLXbu3Fl88803xeLiYqkNr6V+Bw8e1Pu/jS+88IIoioZdt6ysLHHChAmivb296OjoKE6dOlXMzc01wrcxDkEUKy0hS0RERET1xjlURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURGQW/vOf/6BPnz6NOkZSUhIEQcDZs2ebpE81GTJkCObOndus5yAi08JARURN4tatW5g2bRq8vb2hUCjg5+eHOXPmICsrq97HEgQBu3bt0tn22muv6TyctSF8fX2RlpaGnj17Nuo4WrGxsRAEAdnZ2Trbd+7ciXfeeadJztEQLRUciagCAxURNdr169fRv39/XL16FV999RUSExPx2WefYf/+/QgJCcG9e/cafQ57e3u4uro26hhyuRyenp6wsLBodH9q4+LiAgcHh2Y9BxGZFgYqImq02bNnQ6FQYO/evRg8eDA6duyIkSNH4tdff0VKSgrefPNNqW2nTp3wzjvvYMKECbCzs0OHDh3w6aef6uwHgL/97W8QBEF6X3XIb8qUKRg7dizee+89eHh4wNnZGUuXLkVZWRkWLFgAFxcX+Pj4YPPmzdJnqlZupkyZAkEQqr1iY2MBAP/3f/+H/v37w8HBAZ6ennj++edx584d6VhDhw4FALRr1w6CIGDKlCkAqg/53b9/H+Hh4WjXrh1sbW0xcuRIXL16VdofHR0NZ2dn/PLLLwgODoa9vT1GjBiBtLS0Gq/5/fv3MXHiRLi5ucHGxgaBgYHSd/X39wcA9O3bF4IgYMiQIdLnPv/8cwQHB8Pa2hpBQUFYs2ZNteuzbds2DBgwANbW1ujZsycOHTpk0HmJ2jRjP52ZiMxbVlaWKAiC+N577+ndP2PGDLFdu3aiWq0WRVEU/fz8RAcHBzEyMlJMSEgQP/74Y1Eul4t79+4VRVEU79y5IwIQN2/eLKalpYl37twRRVEUlyxZIvbu3Vs67gsvvCA6ODiIs2fPFuPj48WNGzeKAMThw4eL7777rnjlyhXxnXfeES0tLcVbt26JoiiKN27cEAGIZ86cEUVRFLOzs8W0tDTpNWfOHNHd3V1MS0sTRVEUN27cKP7444/itWvXxGPHjokhISHiyJEjRVEUxbKyMvGbb74RAYgJCQliWlqamJ2dLYqiKA4ePFicM2eO1NennnpKDA4OFn/77Tfx7Nmz4vDhw8UuXbqIJSUloiiK4ubNm0VLS0tx2LBhYlxcnHjq1CkxODhYfP7552u87rNnzxb79OkjxsXFiTdu3BD37dsnfvfdd6IoiuKJEydEAOKvv/4qpqWliVlZWaIoiuIXX3whenl5id988414/fp18ZtvvhFdXFzE6Ohonevj4+Mjfv311+KlS5fE6dOniw4ODuLdu3frPC9RW8ZARUSNcvz4cRGA+O233+rdv3LlShGAmJGRIYqiJlCNGDFCp8348eOloCKKot7j6QtUfn5+okqlkrZ169ZNHDRokPS+rKxMtLOzE7/66itRFKsHqsq++eYb0draWjxy5EiN3zUuLk4EIObm5oqiKIoHDx4UAYj379/XaVc5UF25ckUEIP7+++/S/rt374o2Njbi9u3bRVHUBCoAYmJiotTm008/FT08PGrsy5gxY8SpU6fq3VfT9wwICBC//PJLnW3vvPOOGBISovO5ZcuWSftLS0tFHx8fcfny5XWel6gt45AfETUJURQNbhsSElLt/eXLl+t9zh49ekAmq/ifMQ8PDzzwwAPSe7lcDldXV2mYriZnzpzB5MmT8cknn2DgwIHS9lOnTmHMmDHo2LEjHBwcMHjwYABAcnKywX28fPkyLCws8Mgjj0jbXF1d0a1bN53vbGtri4CAAOm9l5dXrf3+xz/+gW3btqFPnz54/fXXcfTo0Vr7kZ+fj2vXriEiIgL29vbS67///S+uXbum07byv4+FhQX69+8v9bW+5yVqKxioiKhRunTpAkEQagxEly9fRrt27eDm5tbk57a0tNR5LwiC3m1qtbrGY6Snp+Opp57C9OnTERERIW3Pz8/H8OHD4ejoiJiYGMTFxeHbb78FAJSUlDTht9DQ1+/aQurIkSNx8+ZNvPrqq0hNTcUTTzyB1157rcb2eXl5AIANGzbg7Nmz0uvChQs4fvy4wf2s73mJ2goGKiJqFFdXVzz55JNYs2YNCgsLdfalp6cjJiYG48ePhyAI0vaqf8CPHz+O4OBg6b2lpSVUKlXzdhxAUVERwsLCEBQUhJUrV+rsi4+PR1ZWFpYtW4ZBgwYhKCioWsVIoVAAQK19DQ4ORllZGf744w9pW1ZWFhISEtC9e/dG9d/NzQ0vvPACvvjiC3z44YdYv359jf3y8PCAt7c3rl+/ji5duui8tJPYtSr/+5SVleHUqVM6/z41nZeoLWvee4eJqE345JNPMGDAAAwfPhz//e9/4e/vj4sXL2LBggXo0KED3n33XZ32v//+O95//32MHTsW+/btw44dO/DDDz9I+zt16oT9+/dj4MCBsLKyQrt27Zql3y+++CJu3bqF/fv3IzMzU9ru4uKCjh07QqFQYPXq1Zg1axYuXLhQbW0pPz8/CIKAPXv2YNSoUbCxsYG9vb1Om8DAQISFhWHGjBlYt24dHBwcsHDhQnTo0AFhYWEN7vtbb72Ffv36oUePHiguLsaePXuk0OPu7g4bGxv8/PPP8PHxgbW1NZycnPD222/jlVdegZOTE0aMGIHi4mKcPHkS9+/fx7x586Rjf/rppwgMDERwcDBWrVqF+/fvY9q0aXWel6gtY4WKiBotMDAQJ0+eROfOnfHss88iICAAM2fOxNChQ3Hs2DG4uLjotJ8/fz5OnjyJvn374r///S9WrlyJ4cOHS/tXrFiBffv2wdfXF3379m22fh86dAhpaWno3r07vLy8pNfRo0fh5uaG6Oho7NixA927d8eyZcsQFRWl8/kOHTrg7bffxsKFC+Hh4YF//vOfes+zefNm9OvXD6GhoQgJCYEoivjxxx+rDfPVh0KhwKJFi9CrVy88/vjjkMvl2LZtGwDNvKePP/4Y69atg7e3txTcpk+fjs8//xybN2/GAw88gMGDByM6OrpahWrZsmVYtmwZevfujSNHjuC7775D+/bt6zwvUVsmiPWZSUpE1EidOnXC3Llz+WgWE5SUlAR/f3+cOXOm0Y/5IWprWKEiIiIiaiQGKiIiIqJG4pAfERERUSOxQkVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI3EQEVERETUSAxURERERI30/37JpS6VqvQSAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plot the energies.\n",
+    "\n",
+    "vqe_y = vqe_energies\n",
+    "vqe_x = list(range(len(vqe_y)))\n",
+    "plt.plot(vqe_x, vqe_y, label=\"VQE\")\n",
+    "\n",
+    "afqmc_y = list(qmc_data[\"ETotal\"])\n",
+    "afqmc_x = [i + vqe_x[-1] for i in list(range(len(afqmc_y)))]\n",
+    "plt.plot(afqmc_x, afqmc_y, label=\"AFQMC\")\n",
+    "\n",
+    "plt.xlabel(\"Optimization steps\")\n",
+    "plt.ylabel(\"Energy [Ha]\")\n",
+    "plt.legend()\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version proto-0.8.0 (https://github.com/NVIDIA/cuda-quantum 57e1893b9a5b57ef1a1c2662bcf4527f87b9ef89)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/afqmc_src/geo_fenta.xyz b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/geo_fenta.xyz
new file mode 100644
index 0000000000..a8ef211dfc
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/geo_fenta.xyz
@@ -0,0 +1,28 @@
+26
+Energy = -2155.935897674
+C    -1.0290441   -0.9471117   -1.9865887 
+C    -2.2505436   -0.7922495    0.1582250 
+C    -0.2593185   -2.2544373    0.0162178 
+O    -1.3454085    0.8783278   -3.5342318 
+O    -1.1347371    1.1483476    1.0151618 
+O     0.8453748   -2.7999130    2.0922098 
+O    -0.2780587    1.3040005   -1.6070564 
+O    -3.2498211    0.8000765    1.6534429 
+C    -0.9188318    0.5115628   -2.4417824 
+C    -2.2565356    0.4618854    1.0159078 
+C     0.5342286   -1.9274094    1.2848894 
+N    -0.9221422   -1.0235290   -0.5013883 
+Fe    0.2526900    0.4497192    0.0039380 
+O     1.8221685   -0.2815654   -1.0936915 
+H    -1.9555949   -1.4065777   -2.3473606 
+H    -0.1824638   -1.4867161   -2.4264081 
+H    -2.5130292   -1.6526686    0.7833244 
+H    -3.0320380   -0.6959329   -0.6040366 
+H     0.4617231   -2.6044401   -0.7316186 
+H    -0.9840969   -3.0551564    0.1969690 
+H     2.1227503    0.3853924   -1.7373941 
+H     2.5891208   -0.4447721   -0.5150575 
+O     0.9052095   -0.6681693    1.3941789 
+O     1.4573655    1.9796179    0.5273073 
+H     1.0868407    2.8424014    0.2685815 
+H     1.5840897    2.0352695    1.4913642 
\ No newline at end of file
diff --git a/pr-2241/sphinx/examples/python/tutorials/afqmc_src/geo_o3.xyz b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/geo_o3.xyz
new file mode 100644
index 0000000000..a0c771460c
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/geo_o3.xyz
@@ -0,0 +1,5 @@
+3
+Energy
+O     0.0000000    0.0000000    0.0000000
+O     0.0000000    0.0000000    1.2717000
+O     1.1383850    0.0000000    1.8385340
diff --git a/pr-2241/sphinx/examples/python/tutorials/afqmc_src/utils_ipie.py b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/utils_ipie.py
new file mode 100644
index 0000000000..ef11a13371
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/utils_ipie.py
@@ -0,0 +1,120 @@
+import numpy as np
+
+from ipie.utils.from_pyscf import (load_from_pyscf_chkfile,
+                                   generate_hamiltonian, copy_LPX_to_LXmn,
+                                   generate_wavefunction_from_mo_coeff)
+
+
+def signature_permutation(orbital_list):
+    """
+    Returns the signature of the permutation in orbital_list
+    """
+    if len(orbital_list) == 1:
+        return 1
+
+    transposition_count = 0
+    for index, element in enumerate(orbital_list):
+        for next_element in orbital_list[index + 1:]:
+            if element > next_element:
+                transposition_count += 1
+
+    return (-1)**transposition_count
+
+
+def get_coeff_wf(final_state_vector, n_active_elec, spin=0, thres=1e-6):
+    """
+    :`param` `final_state_vector`: State vector from a VQE simulation
+    :`param` `n_active_elec`: Number of total electrons in active space
+    :`param` `spin`: spin
+    :`param` `thres`: Threshold for coefficients to keep from VQE wavefunction
+    :returns: Input for `ipie` trial: coefficients, list of occupied alpha, list of occupied bets
+    """
+    n_qubits = int(np.log2(final_state_vector.size))
+    n_elec = [(n_active_elec + spin) // 2, (n_active_elec - spin) // 2]
+
+    coeff = []
+    occas = []
+    occbs = []
+    for j, val in enumerate(final_state_vector):
+        if abs(val) > thres:
+            ket = np.binary_repr(j, width=n_qubits)
+            alpha_ket = ket[::2]
+            beta_ket = ket[1::2]
+            occ_alpha = np.where([int(_) for _ in alpha_ket])[0]
+            occ_beta = np.where([int(_) for _ in beta_ket])[0]
+            occ_orbitals = np.append(2 * occ_alpha, 2 * occ_beta + 1)
+
+            if (len(occ_alpha) == n_elec[0]) and (len(occ_beta) == n_elec[1]):
+                coeff.append(signature_permutation(occ_orbitals) * val)
+                occas.append(occ_alpha)
+                occbs.append(occ_beta)
+
+    coeff = np.array(coeff, dtype=complex)
+    ixs = np.argsort(np.abs(coeff))[::-1]
+    coeff = coeff[ixs]
+    occas = np.array(occas)[ixs]
+    occbs = np.array(occbs)[ixs]
+
+    return coeff, occas, occbs
+
+
+def gen_ipie_input_from_pyscf_chk(pyscf_chkfile: str,
+                                  verbose: bool = True,
+                                  chol_cut: float = 1e-5,
+                                  ortho_ao: bool = False,
+                                  mcscf: bool = False,
+                                  linear_dep_thresh: float = 1e-8,
+                                  num_frozen_core: int = 0):
+    """Generate AFQMC data from PYSCF (molecular) simulation.
+        Adapted from `ipie`.`utils`.from_`pyscf`: returns Hamiltonian and wavefunction instead of writing on files
+    """
+    if mcscf:
+        scf_data = load_from_pyscf_chkfile(pyscf_chkfile, base="mcscf")
+    else:
+        scf_data = load_from_pyscf_chkfile(pyscf_chkfile)
+    mol = scf_data["mol"]
+    hcore = scf_data["hcore"]
+    ortho_ao_mat = scf_data["X"]
+    mo_coeffs = scf_data["mo_coeff"]
+    mo_occ = scf_data["mo_occ"]
+    if ortho_ao:
+        basis_change_matrix = ortho_ao_mat
+    else:
+        basis_change_matrix = mo_coeffs
+
+        if isinstance(mo_coeffs, list) or len(mo_coeffs.shape) == 3:
+            if verbose:
+                print("# UHF mo coefficients found and ortho-ao == False. Using"
+                      " alpha mo coefficients for basis transformation.")
+            basis_change_matrix = mo_coeffs[0]
+    ham = generate_hamiltonian(
+        mol,
+        mo_coeffs,
+        hcore,
+        basis_change_matrix,
+        chol_cut=chol_cut,
+        num_frozen_core=num_frozen_core,
+        verbose=False,
+    )
+    # write_Hamiltonian(ham.H1[0], copy_`LPX`_to_`LXmn`(ham.`chol`), ham.`ecore`, filename=Hamiltonian_file)
+    ipie_ham = (ham.H1[0], copy_LPX_to_LXmn(ham.chol), ham.ecore)
+    nelec = (mol.nelec[0] - num_frozen_core, mol.nelec[1] - num_frozen_core)
+    if verbose:
+        print(f"# Number of electrons in simulation: {nelec}")
+    if mcscf:
+        # `ci`_`coeffs` = `scf`_data["`ci_coeffs`"]
+        # `occa` = `scf`_data["`occa`"]
+        # `occb` = `scf`_data["`occb`"]
+        # write_wavefunction((`ci_coeffs`, `occa`, `occb`), wavefunction_file)
+        return ipie_ham
+    else:
+        wavefunction = generate_wavefunction_from_mo_coeff(
+            mo_coeffs,
+            mo_occ,
+            basis_change_matrix,
+            nelec,
+            ortho_ao=ortho_ao,
+            num_frozen_core=num_frozen_core,
+        )
+        # write_wavefunction(wavefunction, wavefunction_file)
+        return ipie_ham, wavefunction
diff --git a/pr-2241/sphinx/examples/python/tutorials/afqmc_src/vqe_cudaq_qnp.py b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/vqe_cudaq_qnp.py
new file mode 100644
index 0000000000..cec53d07df
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/afqmc_src/vqe_cudaq_qnp.py
@@ -0,0 +1,293 @@
+"""
+    Contains the class with the VQE using the quantum-number-preserving ansatz
+"""
+import numpy as np
+import cudaq
+from cudaq import spin as spin_op
+
+
+class VQE(object):
+    """
+        Implements the quantum-number-preserving ansatz from Anselmetti et al. NJP 23 (2021)
+    """
+
+    def __init__(self, n_qubits, num_active_electrons, spin, options):
+        self.n_qubits = n_qubits
+        self.n_layers = options.get('n_vqe_layers', 1)
+        self.number_of_Q_blocks = n_qubits // 2 - 1
+        self.num_params = 2 * self.number_of_Q_blocks * self.n_layers
+        self.options = options
+        num_active_orbitals = n_qubits // 2
+
+        # number of alpha and beta electrons in the active space
+        num_active_electrons_alpha = (num_active_electrons + spin) // 2
+        num_active_electrons_beta = (num_active_electrons - spin) // 2
+
+        # Define the initial state for the VQE as a list
+        # [n_1, n_2, ....]
+        # where n_j=(0,1,2) is the occupation of j-`th` the orbital
+
+        n_alpha_vec = [1] * num_active_electrons_alpha + [0] * (
+            num_active_orbitals - num_active_electrons_alpha)
+        n_beta_vec = [1] * num_active_electrons_beta + [0] * (
+            num_active_orbitals - num_active_electrons_beta)
+        init_mo_occ = [n_a + n_b for n_a, n_b in zip(n_alpha_vec, n_beta_vec)]
+
+        self.init_mo_occ = init_mo_occ
+        self.final_state_vector_best = None
+        self.best_vqe_params = None
+        self.best_vqe_energy = None
+        self.target = "nvidia"
+        self.initial_x_gates_pos = self.prepare_initial_circuit()
+
+    def prepare_initial_circuit(self):
+        """
+        Creates a list with the position of the X gates that should be applied to the initial |00...0>
+        state to set the number of electrons and the spin correctly
+        """
+        x_gates_pos_list = []
+        if self.init_mo_occ is not None:
+            for idx_occ, occ in enumerate(self.init_mo_occ):
+                if int(occ) == 2:
+                    x_gates_pos_list.extend([2 * idx_occ, 2 * idx_occ + 1])
+                elif int(occ) == 1:
+                    x_gates_pos_list.append(2 * idx_occ)
+
+        return x_gates_pos_list
+
+    def layers(self):
+        """
+            Generates the QNP ansatz circuit and returns the  kernel and the optimization parameters thetas
+
+            `params`: list/`np`.array
+            [theta_0, ..., theta_{M-1}, phi_0, ..., phi_{M-1}]
+            where M is the total number of blocks = layer * (n_qubits/2 - 1)
+
+            returns: kernel
+                     thetas
+        """
+        n_qubits = self.n_qubits
+        n_layers = self.n_layers
+        number_of_blocks = self.number_of_Q_blocks
+
+        # changed self.target to `nvidia`` to pass CI job, as it expects a string
+        # literal
+        # cudaq.set_target("`nvidia`")  # `nvidia` or `nvidia-mgpu`
+
+        kernel, thetas = cudaq.make_kernel(list)
+        # Allocate n qubits.
+        qubits = kernel.qalloc(n_qubits)
+
+        for init_gate_position in self.initial_x_gates_pos:
+            kernel.x(qubits[init_gate_position])
+
+        count_params = 0
+        for idx_layer in range(n_layers):
+            for starting_block_num in [0, 1]:
+                for idx_block in range(starting_block_num, number_of_blocks, 2):
+                    qubit_list = [qubits[2 * idx_block + j] for j in range(4)]
+
+                    # PX gates decomposed in terms of standard gates
+                    # and NO controlled Y rotations.
+                    # See Appendix E1 of Anselmetti et al New J. Phys. 23 (2021) 113010
+
+                    a, b, c, d = qubit_list
+                    kernel.cx(d, b)
+                    kernel.cx(d, a)
+                    kernel.rz(parameter=-np.pi / 2, target=a)
+                    kernel.s(b)
+                    kernel.h(d)
+                    kernel.cx(d, c)
+                    kernel.cx(b, a)
+                    kernel.ry(parameter=(1 / 8) * thetas[count_params],
+                              target=c)
+                    kernel.ry(parameter=(-1 / 8) * thetas[count_params],
+                              target=d)
+                    kernel.rz(parameter=+np.pi / 2, target=a)
+                    kernel.cz(a, d)
+                    kernel.cx(a, c)
+                    kernel.ry(parameter=(-1 / 8) * thetas[count_params],
+                              target=d)
+                    kernel.ry(parameter=(+1 / 8) * thetas[count_params],
+                              target=c)
+                    kernel.cx(b, c)
+                    kernel.cx(b, d)
+                    kernel.rz(parameter=+np.pi / 2, target=b)
+                    kernel.ry(parameter=(-1 / 8) * thetas[count_params],
+                              target=c)
+                    kernel.ry(parameter=(+1 / 8) * thetas[count_params],
+                              target=d)
+                    kernel.cx(a, c)
+                    kernel.cz(a, d)
+                    kernel.ry(parameter=(-1 / 8) * thetas[count_params],
+                              target=c)
+                    kernel.ry(parameter=(1 / 8) * thetas[count_params],
+                              target=d)
+                    kernel.cx(d, c)
+                    kernel.h(d)
+                    kernel.cx(d, b)
+                    kernel.s(d)
+                    kernel.rz(parameter=-np.pi / 2, target=b)
+                    kernel.cx(b, a)
+                    count_params += 1
+
+                    # Orbital rotation
+                    kernel.fermionic_swap(np.pi, b, c)
+                    kernel.givens_rotation((-1 / 2) * thetas[count_params], a,
+                                           b)
+                    kernel.givens_rotation((-1 / 2) * thetas[count_params], c,
+                                           d)
+                    kernel.fermionic_swap(np.pi, b, c)
+                    count_params += 1
+
+        return kernel, thetas
+
+    def get_state_vector(self, param_list):
+        """
+        Returns the state vector generated by the ansatz with parameters given by `param`_list
+        """
+        kernel, thetas = self.layers()
+        state = convert_state_big_endian(
+            np.array(cudaq.get_state(kernel, param_list), dtype=complex))
+        return state
+
+    def execute(self, hamiltonian):
+        """
+        Run VQE
+        """
+        options = self.options
+        mpi_support = options.get("mpi_support", False)
+        return_final_state_vec = options.get("return_final_state_vec", False)
+
+        if mpi_support:
+            cudaq.mpi.initialize()
+            print('# mpi is initialized? ', cudaq.mpi.is_initialized())
+            num_ranks = cudaq.mpi.num_ranks()
+            rank = cudaq.mpi.rank()
+            print('# rank', rank, 'num_ranks', num_ranks)
+
+        optimizer = cudaq.optimizers.COBYLA()
+        initial_parameters = options.get('initial_parameters')
+        if initial_parameters:
+            optimizer.initial_parameters = initial_parameters
+        else:
+            optimizer.initial_parameters = np.random.rand(self.num_params)
+
+        kernel, thetas = self.layers()
+        maxiter = options.get('maxiter', 100)
+        optimizer.max_iterations = options.get('maxiter', maxiter)
+        optimizer_type = "cudaq"
+        callback_energies = []
+
+        def eval(theta):
+            """
+            Compute the energy by cudaq.observe
+            """
+            exp_val = cudaq.observe(kernel, hamiltonian, theta).expectation()
+
+            callback_energies.append(exp_val)
+            return exp_val
+
+        if optimizer_type == "cudaq":
+            print("# Using cudaq optimizer")
+            energy_optimized, best_parameters = optimizer.optimize(
+                self.num_params, eval)
+
+            # We add here the energy core
+            energy_core = options.get('energy_core', 0.)
+            total_opt_energy = energy_optimized + energy_core
+            callback_energies = [en + energy_core for en in callback_energies]
+
+            print("# Num Params:", self.num_params)
+            print("# Qubits:", self.n_qubits)
+            print("# N_layers:", self.n_layers)
+            print("# Energy after the VQE:", total_opt_energy)
+
+            result = {
+                "energy_optimized": total_opt_energy,
+                "best_parameters": best_parameters,
+                "callback_energies": callback_energies
+            }
+
+            if return_final_state_vec:
+                result["state_vec"] = self.get_state_vector(best_parameters)
+            return result
+
+        else:
+            print(f"# Optimizer {optimizer_type} not implemented")
+            exit()
+
+
+def convert_state_big_endian(state_little_endian):
+
+    state_big_endian = 0. * state_little_endian
+
+    n_qubits = int(np.log2(state_big_endian.size))
+    for j, val in enumerate(state_little_endian):
+        little_endian_pos = np.binary_repr(j, n_qubits)
+        big_endian_pos = little_endian_pos[::-1]
+        int_big_endian_pos = int(big_endian_pos, 2)
+        state_big_endian[int_big_endian_pos] = state_little_endian[j]
+
+    return state_big_endian
+
+
+def from_string_to_cudaq_spin(pauli_string, qubit):
+    if pauli_string.lower() in ('id', 'i'):
+        return 1
+    elif pauli_string.lower() == 'x':
+        return spin_op.x(qubit)
+    elif pauli_string.lower() == 'y':
+        return spin_op.y(qubit)
+    elif pauli_string.lower() == 'z':
+        return spin_op.z(qubit)
+
+
+def get_cudaq_hamiltonian(jw_hamiltonian):
+    """ Converts an `openfermion` QubitOperator Hamiltonian into a `cudaq.SpinOperator` Hamiltonian
+
+    """
+
+    hamiltonian_cudaq = 0.0
+    energy_core = 0.0
+    for ham_term in jw_hamiltonian:
+        [(operators, ham_coeff)] = ham_term.terms.items()
+        if len(operators):
+            cuda_operator = 1.0
+            for qubit_index, pauli_op in operators:
+                cuda_operator *= from_string_to_cudaq_spin(
+                    pauli_op, qubit_index)
+        else:
+            cuda_operator = 0.0  #from_string_to_cudaq_spin('id', 0)
+            energy_core = ham_coeff
+        cuda_operator = ham_coeff * cuda_operator
+        hamiltonian_cudaq += cuda_operator
+
+    return hamiltonian_cudaq, energy_core
+
+
+def get_cudaq_operator(jw_hamiltonian):
+    """ Converts an `openfermion` QubitOperator Hamiltonian into a `cudaq.SpinOperator` Hamiltonian
+
+    """
+
+    hamiltonian_cudaq = 0.0
+    for ham_term in jw_hamiltonian:
+        [(operators, ham_coeff)] = ham_term.terms.items()
+        if len(operators):
+            cuda_operator = 1.0
+            for qubit_index, pauli_op in operators:
+                cuda_operator *= from_string_to_cudaq_spin(
+                    pauli_op, qubit_index)
+        else:
+            cuda_operator = from_string_to_cudaq_spin('id', 0)
+        if abs(ham_coeff.imag) < 1e-8:
+            cuda_operator = ham_coeff.real * cuda_operator
+        else:
+            print(
+                "In function get_cudaq_operator can convert only real operator to cuda_operator"
+            )
+            exit()
+        hamiltonian_cudaq += cuda_operator
+
+    return hamiltonian_cudaq
diff --git a/pr-2241/sphinx/examples/python/tutorials/cost_minimization.ipynb b/pr-2241/sphinx/examples/python/tutorials/cost_minimization.ipynb
new file mode 100644
index 0000000000..9bef09f466
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/cost_minimization.ipynb
@@ -0,0 +1,220 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Cost Minimization\n",
+    "\n",
+    "Below we start with a basic example of a hybrid variational algorithm which involves flipping the Bloch vector of a qubit from the $\\ket{0}$ to the $\\ket{1}$ state. First we import the relevant packages and set our backend to simulate our workflow on NVIDIA GPUs. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from typing import List\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "                       \n",
+      "q0 : ──────────────────\n",
+      "                       \n",
+      "q1 : ──────────────────\n",
+      "     ╭───────╮╭───────╮\n",
+      "q2 : ┤ rx(0) ├┤ ry(0) ├\n",
+      "     ╰───────╯╰───────╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Initialize a kernel/ ansatz and variational parameters.\n",
+    "@cudaq.kernel\n",
+    "def kernel(angles: List[float]):\n",
+    "    # Allocate a qubit that is initialized to the |0> state.\n",
+    "    qubit = cudaq.qubit()\n",
+    "    # Define gates and the qubits they act upon.\n",
+    "    rx(angles[0], qubit)\n",
+    "    ry(angles[1], qubit)\n",
+    "\n",
+    "\n",
+    "# Our Hamiltonian will be the Z expectation value of our qubit.\n",
+    "hamiltonian = cudaq.spin.z(0)\n",
+    "\n",
+    "# Initial gate parameters which intialize the qubit in the zero state\n",
+    "initial_parameters = [0, 0]\n",
+    "\n",
+    "print(cudaq.draw(kernel, initial_parameters))"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We build our cost function such that its minimal value corresponds to the qubit being in the $\\ket{1}$ state. The observe call below allows us to simulate our statevector $\\ket{\\psi}$, and calculate $\\bra{\\psi}Z\\ket{\\psi}$.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cost_values = []\n",
+    "\n",
+    "\n",
+    "def cost(parameters):\n",
+    "    \"\"\"Returns the expectation value as our cost.\"\"\"\n",
+    "    expectation_value = cudaq.observe(kernel, hamiltonian,\n",
+    "                                      parameters).expectation()\n",
+    "    cost_values.append(expectation_value)\n",
+    "    return expectation_value"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "1.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "# We see that the initial value of our cost function is one, demonstrating that our qubit is in the zero state\n",
+    "initial_cost_value = cost(initial_parameters)\n",
+    "print(initial_cost_value)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below we use our built-in optimization suite to minimize the cost function. We will be using the gradient-free COBYLA alogrithm. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define a CUDA-Q optimizer.\n",
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "optimizer.initial_parameters = initial_parameters\n",
+    "\n",
+    "result = optimizer.optimize(dimensions=2, function=cost)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# %pip install matplotlib"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {
+    "tags": [
+     "nbsphinx-thumbnail"
+    ]
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "Text(0, 0.5, 'Cost Value')"
+      ]
+     },
+     "execution_count": 7,
+     "metadata": {},
+     "output_type": "execute_result"
+    },
+    {
+     "data": {
+      "image/png": "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d96JN99802pbQECA9HNUVJTVvqioKBw6dAgAkJmZif79+8PLy0vaP2zYMJjNZpw4cQKCICA7OxvR0dE2a+jXr5/0s5eXF3x8fJCXlwcAmD59OsaMGYODBw8iNjYWCQkJGDp0aIveKxG1LYYlImoXvLy86lwWsxcPD48mHefq6mr1uyAIMJvNAICRI0fi999/x5dffont27cjOjoaM2bMwCuvvGL3eonIvjhmiYicwr59++r83qdPHwBAnz59cPjwYZSWlkr79+7dC5VKhV69esHb2xthYWFIS0u7rhqCgoIwYcIEvPfee1ixYgVWr159XecjorbBzhIRtQsVFRUwGAxW21xcXKRB1Fu2bMHgwYMxfPhwbNy4EQcOHMDatWsBAOPGjUNKSgomTJiAZ555BhcvXsSsWbPwyCOPQKfTAQCeeeYZTJs2DVqtFiNHjkRxcTH27t2LWbNmNam+RYsWYdCgQbjxxhtRUVGBzz//XAprRKRsDEtE1C6kpqYiODjYaluvXr1w/PhxADV3qm3evBmPPfYYgoOD8f777yMiIgIA4Onpif/97394/PHHccstt8DT0xNjxozB8uXLpXNNmDAB5eXlePXVV/Hkk08iMDAQf/7zn5tcn5ubG5KTk3H27Fl4eHjgtttuw+bNm+3wzomotQmiKIpyF0FE1JoEQcC2bduQkJAgdylE5IA4ZomIiIjIBoYlIiIiIhs4ZomI2j2ONiCi68HOEhEREZENDEtERERENjAsEREREdnAsERERERkA8MSERERkQ0MS0REREQ2MCwRERER2cCwRERERGTD/wNOOWlAeHvZ8QAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plotting how the value of the cost function decreases during the minimization procedure.\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "x_values = list(range(len(cost_values)))\n",
+    "y_values = cost_values\n",
+    "\n",
+    "plt.plot(x_values, y_values)\n",
+    "\n",
+    "plt.xlabel(\"Epochs\")\n",
+    "plt.ylabel(\"Cost Value\")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We see that the final value or our cost function, $\\bra{\\psi}Z\\ket{\\psi} = -1$ demonstrating that the qubit is in the $\\ket{1}$ state."
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12 (main, Nov 20 2023, 15:14:05) [GCC 11.4.0]"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/deutschs_algorithm.ipynb b/pr-2241/sphinx/examples/python/tutorials/deutschs_algorithm.ipynb
new file mode 100644
index 0000000000..ad86630b41
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/deutschs_algorithm.ipynb
@@ -0,0 +1,414 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Deutsch's Algorithm "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We have a function which takes in a bit and outputs a bit. This can be represented as $f: \\{0,1\\} \\longrightarrow \\{0,1\\}$. \n",
+    "\n",
+    "The function $f$ has a property; either it is constant or balanced. \n",
+    "\n",
+    "If constant, the outputs are the same regardless of the inputs, i.e., $f(0) = f(1) = 0$ or $f(0) = f(1) = 1$.\n",
+    "\n",
+    "If balanced, the ouputs are balanced across their possibilities, i.e,  if $f(0) = 0$ then $f(1) = 1$ or if $f(0) = 1$ then $f(1) = 0$.\n",
+    "\n",
+    "The question we would like to answer is if the function is constant or balanced. \n",
+    " \n",
+    "Classically, if we are given a function $f$, we can solve to find its property via the code below: \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Treat the code snippet below like a black box, i.e., you don't have access to the value of the property argument and can just query f with different inputs.\n",
+    "\n",
+    "\n",
+    "def f(x, property='constant'):\n",
+    "\n",
+    "    if property == 'constant':\n",
+    "\n",
+    "        # The output is a 1 regardless of the input; we can also make the output to be 0.\n",
+    "\n",
+    "        if x == 0:\n",
+    "            return 1\n",
+    "        elif x == 1:\n",
+    "            return 1\n",
+    "\n",
+    "    if property == 'balanced':\n",
+    "\n",
+    "        # The output depends on the input.\n",
+    "\n",
+    "        if x == 0:\n",
+    "            return 1\n",
+    "        elif x == 1:\n",
+    "            return 0"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let us now classically find out if the function we defined above is constant or balanced. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The function is constant\n"
+     ]
+    }
+   ],
+   "source": [
+    "if f(0) == 0:\n",
+    "    if f(1) == 0:\n",
+    "        print('The function is constant')\n",
+    "    elif f(1) == 1:\n",
+    "        print('The function is balanced')\n",
+    "\n",
+    "elif f(0) == 1:\n",
+    "    if f(1) == 1:\n",
+    "        print('The function is constant')\n",
+    "    elif f(1) == 0:\n",
+    "        print('The function is balanced')"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "If you step through the `if` statements above, one can see that we require 2 calls to the function to determine its property. That is, we have to query $f$ twice.\n",
+    "\n",
+    "The claim is that Deutsch's algorithm can solve for this property with 1 function evalulation, demonstrating quantum advantage. \n",
+    "\n",
+    "Below we first go through the math and then the implementation in CUDA Quantum. \n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## XOR $\\oplus$\n",
+    "\n",
+    "You may have seen the $\\oplus$ symbol floating around. This is the exclusive OR or the XOR operation. It follows the rules of addition modulo 2. For example, \n",
+    "\n",
+    "\n",
+    "1. $3\\oplus5 = (3+5)_{\\%2} = 8_{\\%2} = 0$\n",
+    "\n",
+    "2. $5\\oplus4 = (5+4)_{\\%2} = 9_{\\%2} = 1$\n",
+    "\n",
+    "A quick way to perform the $\\oplus$ calculation is if the result of the addition is an even number, the result is 0 otherwise 1. "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum oracles\n",
+    "\n",
+    "<img src=\"images/oracle.png\"  width=\"300\" height=\"150\">\n",
+    "\n",
+    "Suppose we have $f(x): \\{0,1\\} \\longrightarrow \\{0,1\\}$. 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 logic gates. \n",
+    "\n",
+    "Above you see an oracle represented as $U_f$ which allows us to transform the state $\\ket{x}\\ket{y}$ into: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{x}\\ket{y}  =  \\ket{x}\\ket{y \\oplus f(x)}\n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "If $y = 0$, then $U_f\\ket{x}\\ket{y} = U_f\\ket{x}\\ket{0}  =   \\ket{x}\\ket{0 \\oplus f(x)} =  \\ket{x}\\ket{f(x)}$ since $f(x)$ can either be $0/1$ and $0 \\oplus 0 = 0$ and $0 \\oplus 1 = 1$.\n",
+    "\n",
+    "This is remarkable because by setting $\\ket{y} = \\ket{0}$, we can extract the value of $f(x)$ by measuring the value of the second qubit. \n",
+    " \n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Phase oracle\n",
+    "\n",
+    "\n",
+    "Since $f(x)$ can be either $0$ or $1$, we have that $0 \\oplus f(x) = 0 \\oplus 0 =  0 = f(x)$ or $0 \\oplus f(x) = 0 \\oplus 1 =  1 = f(x)$. \n",
+    "\n",
+    "Similarly, $1 \\oplus f(x) = 1 \\oplus 0 =  1 = \\overline{f(x)}$ or $1 \\oplus f(x) = 1 \\oplus 1 =  0 = \\overline{f(x)}$ where the bar on top of $f(x)$ denotes 'not $f(x)$'. \n",
+    "\n",
+    "\n",
+    "Let us now prove a result which we shall use later: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{x}\\ket{-}  &=   U_f \\ket{x} \\tfrac{1}{\\sqrt{2}}(\\ket{0} - \\ket{1}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (U_f\\ket{x}\\ket{0} - U_f\\ket{x}\\ket{1}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{0 \\oplus f(x)} - \\ket{x}\\ket{1 \\oplus f(x)}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{f(x)} - \\ket{x}\\ket{\\overline{f(x)}}) \\\\\n",
+    "&= \n",
+    "\\begin{cases}\n",
+    "      \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{0} - \\ket{x}\\ket{1}) = \\ket{x}\\ket{-} &   f(x) = 0 \\\\\n",
+    "      \\tfrac{1}{\\sqrt{2}}  (\\ket{x}\\ket{1} - \\ket{x}\\ket{0}) = -\\ket{x}\\ket{-} &   f(x) = 1 \\\\\n",
+    "\\end{cases} \\\\\n",
+    "&= (-1)^{f(x)}\\ket{x}\\ket{-}    \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "In summary, $U_f\\ket{x}\\ket{-} = (-1)^{f(x)}\\ket{x}\\ket{-}$ where the $\\ket{-}$ qubit was left unchanged and a phase was applied to $\\ket{x}$. \n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "## Quantum parallelism\n",
+    "\n",
+    "Consider: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "U_f\\ket{+}\\ket{0} &= U_f \\tfrac{1}{\\sqrt{2}}(\\ket{0}+\\ket{1}) \\ket{0} \\\\\n",
+    "&= U_f \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{0}+\\ket{1}\\ket{0}) \\\\\n",
+    "&= \\tfrac{1}{\\sqrt{2}}(U_f \\ket{0}\\ket{0} + U_f \\ket{1}\\ket{0})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(U_f \\ket{0}\\ket{0} + U_f \\ket{1}\\ket{0})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{0 \\oplus f(0)} + \\ket{1}\\ket{0 \\oplus f(1)})  \\\\   \n",
+    "&= \\tfrac{1}{\\sqrt{2}}(\\ket{0}\\ket{f(0)} + \\ket{1}\\ket{f(1)})  \\\\   \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We have calculated information about both $f(0)$ and $f(1)$ simultaneously. Quantum mechanics allows for parallelism by exploiting the ability of superposition states.  "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Deutschs' Algorithm: \n",
+    "\n",
+    "Our aim is to find out if $f: \\{0,1\\} \\longrightarrow \\{0,1\\}$ is a constant or a balanced function? If constant, $f(0) = f(1)$, and if balanced, $f(0) \\neq f(1)$.\n",
+    "\n",
+    "We step through the circuit diagram below and follow the math after the application of each gate.\n",
+    "\n",
+    "<img src=\"images/deutsch.png\"  width=\"500\" height=\"210\">\n",
+    "\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\ket{\\psi_0}  =  \\ket{01}\n",
+    "\\tag{1}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\\ket{\\psi_1}  =   H_1H_0\\ket{\\psi_0} = H_1H_0\\ket{01} = \\ket{+-} = \\frac{1}{\\sqrt{2}} (\\ket{0}+\\ket{1})\\ket{-}\n",
+    "\\tag{2}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\ket{\\psi_2}  =   U_f\\ket{\\psi_1} = \\frac{1}{\\sqrt{2}} (U_f\\ket{0}\\ket{-} + U_f\\ket{1}\\ket{-})\n",
+    "\\tag{3}\n",
+    "$$\n",
+    "\n",
+    "using $U_f\\ket{x}\\ket{-} = (-1)^{f(x)}\\ket{x}\\ket{-}$ which we proved in the phase oracle section above: \n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_2}  =  \\frac{1}{\\sqrt{2}} ((-1)^{f(0)}\\ket{0}\\ket{-} + (-1)^{f(1)}\\ket{1}\\ket{-}) \\\\\n",
+    "= \\frac{1}{\\sqrt{2}} ((-1)^{f(0)}\\ket{0} + (-1)^{f(1)}\\ket{1}) \\ket{-} \\\\\n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We now drop the second, qubit in the $\\ket{-}$ state from our derivations as the figure above has no further gate operations acting on it. Remember our aim is to find out if $f(x)$ is a constant or a balanced function. We have the following options: \n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned}\n",
+    "\\ket{\\psi_{2}}=\n",
+    "\\begin{cases}\n",
+    "      \\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1})  &   f(0) = 0, f(1) = 0, f(x)  \\text{ is constant} \\\\\n",
+    "      -\\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1})  &   f(0) = 1, f(1) = 1, f(x)  \\text{ is constant} \\\\\n",
+    "      \\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})  &   f(0) = 0, f(1) = 1, f(x)  \\text{ is balanced} \\\\\n",
+    "      -\\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})  &   f(0) = 1, f(1) = 0, f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_{2}} =\n",
+    "\\begin{cases}\n",
+    "      \\pm \\tfrac{1}{\\sqrt{2}} (\\ket{0} + \\ket{1}) = \\pm \\ket{+}  &    f(x)  \\text{ is constant} \\\\\n",
+    "      \\pm \\tfrac{1}{\\sqrt{2}} (\\ket{0} - \\ket{1})= \\pm \\ket{-}  &    f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{aligned} \n",
+    "\\ket{\\psi_{3}}= H\\ket{\\psi_{2}}\n",
+    "\\begin{cases}\n",
+    "      \\pm H\\ket{+} =  \\pm \\ket{0} &    f(x)  \\text{ is constant} \\\\\n",
+    "      \\pm H\\ket{-}  = \\pm \\ket{1}  &   f(x)  \\text{ is balanced} \\\\\n",
+    "\\end{cases} \n",
+    "\\end{aligned}\n",
+    "$$\n",
+    "\n",
+    "We can now measure the first qubit to yield either a $0$ or a $1$ to determine if $f(x)$ is constant or balanced. \n",
+    "\n",
+    "Deutsch's algorithm may not be practically useful but does demonstrate quantum advantage since it uses one function call to determine the property of $f$ in comparison to two for classical methods. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Import the CUDA-Q package and set the target to run on NVIDIA GPUs.\n",
+    "\n",
+    "import cudaq\n",
+    "import numpy as np\n",
+    "\n",
+    "from typing import List\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Here we input the values of [f(0), f(1)] which allows us to represent constant or balanced functions.\n",
+    "\n",
+    "fx = [0, 1]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮          ╭───╮\n",
+      "q0 : ┤ h ├───────●──┤ h ├\n",
+      "     ├───┤╭───╮╭─┴─╮╰───╯\n",
+      "q1 : ┤ x ├┤ h ├┤ x ├─────\n",
+      "     ╰───╯╰───╯╰───╯     \n",
+      "\n",
+      "f(x) is a balanced function\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Let us now code up the circuit shown above following the state Psi after each step.\n",
+    "\n",
+    "qubit_count = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(fx: List[int]):\n",
+    "    qubit_0 = cudaq.qubit()\n",
+    "    qubit_1 = cudaq.qubit()\n",
+    "\n",
+    "    # Psi 0\n",
+    "    x(qubit_1)\n",
+    "\n",
+    "    # Psi 1\n",
+    "    h(qubit_0)\n",
+    "    h(qubit_1)\n",
+    "\n",
+    "    # Psi 2 - oracle\n",
+    "    if fx[0] == 1:\n",
+    "        x.ctrl(qubit_0, qubit_1)\n",
+    "        x(qubit_1)\n",
+    "\n",
+    "    if fx[1] == 1:\n",
+    "        x.ctrl(qubit_0, qubit_1)\n",
+    "\n",
+    "    # Psi 3\n",
+    "    h(qubit_0)\n",
+    "\n",
+    "    # Measure the qubit to yield if the function is constant or balanced.\n",
+    "    mz(qubit_0)\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(kernel, fx))\n",
+    "\n",
+    "result = cudaq.sample(kernel, fx, shots_count=1)\n",
+    "\n",
+    "if np.array(result)[0] == '0':\n",
+    "    print('f(x) is a constant function')\n",
+    "elif np.array(result)[0] == '1':\n",
+    "    print('f(x) is a balanced function')"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "916dbcbb3f70747c44a77c7bcd40155683ae19c65e1c03b4aa3499c5328201f1"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py b/pr-2241/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py
new file mode 100644
index 0000000000..ba588126ad
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/divisive_clustering_src/divisive_clustering.py
@@ -0,0 +1,1273 @@
+from abc import ABC, abstractmethod
+from typing import Callable, Dict, List, Optional, Tuple, Union
+
+import cudaq
+import networkx as nx
+import numpy as np
+import pandas as pd
+from matplotlib import pyplot as plt
+from scipy.cluster.hierarchy import dendrogram, fcluster
+from scipy.spatial import Voronoi
+from scipy.stats import multivariate_normal
+from sklearn.cluster import KMeans
+from tqdm import tqdm
+
+np.random.seed(10)
+
+
+class Coreset:
+
+    def __init__(
+        self,
+        raw_data: np.ndarray,
+        number_of_sampling_for_centroids: int,
+        coreset_size: int,
+        number_of_coresets_to_evaluate: Optional[int] = 10,
+        coreset_method: Optional[str] = "BFL2",
+        k_value_for_BLK2: Optional[int] = 2,
+    ) -> None:
+        self._raw_data = raw_data
+        self._coreset_size = coreset_size
+        self._number_of_coresets_to_evaluate = number_of_coresets_to_evaluate
+        self._number_of_sampling_for_centroids = number_of_sampling_for_centroids
+        self._k_value_for_BLK2 = k_value_for_BLK2
+
+        if coreset_method not in ["BFL2", "BLK2"]:
+            raise ValueError("Coreset method must be either BFL2 or BLK2.")
+        else:
+            self._coreset_method = coreset_method
+
+    @property
+    def raw_data(self) -> np.ndarray:
+        return self._raw_data
+
+    @property
+    def coreset_size(self) -> int:
+        return self._coreset_size
+
+    @property
+    def number_of_coresets_to_evaluate(self) -> int:
+        return self._number_of_coresets_to_evaluate
+
+    @property
+    def number_of_sampling_for_centroids(self) -> int:
+        return self._number_of_sampling_for_centroids
+
+    @property
+    def coreset_method(self) -> str:
+        return self._coreset_method
+
+    @property
+    def k_value_for_BLK2(self) -> int:
+        return self._k_value_for_BLK2
+
+    @raw_data.setter
+    def raw_data(self, raw_data: np.ndarray) -> None:
+        self._raw_data = raw_data
+
+    @coreset_size.setter
+    def coreset_size(self, coreset_size: int) -> None:
+        self._coreset_size = coreset_size
+
+    @number_of_coresets_to_evaluate.setter
+    def number_of_coresets_to_evaluate(
+            self, number_of_coresets_to_evaluate: int) -> None:
+        self._number_of_coresets_to_evaluate = number_of_coresets_to_evaluate
+
+    @number_of_sampling_for_centroids.setter
+    def number_of_sampling_for_centroids(
+            self, number_of_sampling_for_centroids: int) -> None:
+        self._number_of_sampling_for_centroids = number_of_sampling_for_centroids
+
+    @coreset_method.setter
+    def coreset_method(self, coreset_method: str) -> None:
+        self._coreset_method = coreset_method
+
+    @k_value_for_BLK2.setter
+    def k_value_for_BLK2(self, k_value_for_BLK2: int) -> None:
+        self._k_value_for_BLK2 = k_value_for_BLK2
+
+    def get_best_coresets(self) -> Tuple[np.ndarray, np.ndarray]:
+        """
+        Get the best coreset vectors and weights for a given data.
+
+        Returns:
+            `Tuple[np.ndarray, np.ndarray]`: The coreset vectors and weights.
+        """
+
+        centroids = self.get_best_centroids()
+
+        if self._coreset_method == "BFL2":
+            print("Using BFL2 method to generate coresets")
+            coreset_vectors, coreset_weights = self.get_coresets_using_BFL2(
+                centroids)
+
+        elif self._coreset_method == "BLK2":
+            print("Using BLK2 method to generate coresets")
+            coreset_vectors, coreset_weights = self.get_coresets_using_BLK2(
+                centroids)
+        else:
+            raise ValueError("Coreset method must be either BFL2 or BLK2.")
+
+        coreset_vectors, coreset_weights = self.best_coreset_using_kmeans_cost(
+            coreset_vectors, coreset_weights)
+
+        self.coreset_vectors = coreset_vectors
+        self.coreset_weights = coreset_weights
+
+        return (np.array(coreset_vectors), np.array(coreset_weights))
+
+    def get_coresets_using_BFL2(
+        self, centroids: List[np.ndarray]
+    ) -> Tuple[List[np.ndarray], List[np.ndarray]]:
+        """
+        Generates coreset vectors and weights using the BFL2 algorithm.
+
+        Args:
+            `centroids (List[np.ndarray])`: The centroids to use for the coreset generation.
+
+        Returns:
+            `Tuple[List[np.ndarray], List[np.ndarray]]`: List of coreset vectors and weights.
+        """
+
+        coreset_vectors_list = []
+        coreset_weights_list = []
+        for i in range(self.number_of_coresets_to_evaluate):
+            coreset_vectors, coreset_weights = self.BFL2(centroids=centroids)
+            coreset_vectors_list.append(coreset_vectors)
+            coreset_weights_list.append(coreset_weights)
+
+        return (coreset_vectors_list, coreset_weights_list)
+
+    def get_best_centroids(self) -> List[np.ndarray]:
+        """
+        Get the best centroids using the D2 sampling algorithm.
+
+        Returns:
+            List[np.ndarray]: The best centroids.
+
+        """
+
+        best_centroid_coordinates, best_centroid_cost = None, np.inf
+
+        for _ in range(self.number_of_sampling_for_centroids):
+            centroids = self.D2_sampling()
+            cost = self.get_cost(centroids)
+            if cost < best_centroid_cost:
+                best_centroid_coordinates, best_centroid_cost = centroids, cost
+
+        return best_centroid_coordinates
+
+    def D2_sampling(self) -> List[np.ndarray]:
+        """
+        Selects the centroids from the data points using the D2 sampling algorithm.
+
+        Returns:
+            List[np.ndarray]: The selected centroids as a list.
+        """
+
+        centroids = []
+        data_vectors = self.raw_data
+
+        centroids.append(data_vectors[np.random.choice(len(data_vectors))])
+
+        for _ in range(self.coreset_size - 1):
+            p = np.zeros(len(data_vectors))
+            for i, x in enumerate(data_vectors):
+                p[i] = self.distance_to_centroids(x, centroids)[0]**2
+            p = p / sum(p)
+            centroids.append(data_vectors[np.random.choice(len(data_vectors),
+                                                           p=p)])
+
+        return centroids
+
+    def get_cost(self, centroids: Union[List[np.ndarray], np.ndarray]) -> float:
+        """
+        Computes the sum of between each data points and each centroids.
+
+        Args:
+            `centroids (Union[List[np.ndarray], np.ndarray])`: The centroids to evaluate.
+
+        Returns:
+            float: The cost of the centroids.
+
+        """
+
+        cost = 0.0
+        for x in self.raw_data:
+            cost += self.distance_to_centroids(x, centroids)[0]**2
+        return cost
+
+    def distance_to_centroids(
+            self, data_instance: np.ndarray,
+            centroids: Union[List[np.ndarray],
+                             np.ndarray]) -> Tuple[float, int]:
+        """
+        Compute the distance between a data instance and the centroids.
+
+        Args:
+            `data_instance (np.ndarray)`: The data instance.
+            `centroids (Union[List[np.ndarray], np.ndarray])`: The centroids as a list or `numpy` array.
+
+        Returns:
+            Tuple[float, int]: The minimum distance and the index of the closest centroid.
+        """
+
+        minimum_distance = np.inf
+        closest_index = -1
+        for i, centroid in enumerate(centroids):
+            distance_between_data_instance_and_centroid = np.linalg.norm(
+                data_instance - centroid)
+            if distance_between_data_instance_and_centroid < minimum_distance:
+                minimum_distance = distance_between_data_instance_and_centroid
+                closest_index = i
+
+        return (minimum_distance, closest_index)
+
+    def BFL2(
+        self, centroids: Union[List[np.ndarray], np.ndarray]
+    ) -> Tuple[List[np.ndarray], List[float]]:
+        """
+        Performs Algorithm 2 from https://arxiv.org/pdf/1612.00889.pdf BFL2. This will pick the coreset vectors and its corresponding weights.
+
+        Args:
+            centroids (List): The centroids to use for the coreset generation.
+
+        Returns:
+            Tuple[List, List]: The coreset vectors and coreset weights.
+        """
+
+        number_of_data_points_close_to_a_cluster = {
+            i: 0 for i in range(len(centroids))
+        }
+        sum_distance_to_closest_cluster = 0.0
+        for data_instance in self.raw_data:
+            min_dist, closest_index = self.distance_to_centroids(
+                data_instance, centroids)
+            number_of_data_points_close_to_a_cluster[closest_index] += 1
+            sum_distance_to_closest_cluster += min_dist**2
+
+        Prob = np.zeros(len(self._raw_data))
+        for i, p in enumerate(self._raw_data):
+            min_dist, closest_index = self.distance_to_centroids(p, centroids)
+            Prob[i] += min_dist**2 / (2 * sum_distance_to_closest_cluster)
+            Prob[i] += 1 / (
+                2 * len(centroids) *
+                number_of_data_points_close_to_a_cluster[closest_index])
+
+        if not (0.999 <= sum(Prob) <= 1.001):
+            raise ValueError(
+                "sum(Prob) = %s; the algorithm should automatically "
+                "normalize Prob by construction" % sum(Prob))
+        chosen_indices = np.random.choice(len(self._raw_data),
+                                          size=self._coreset_size,
+                                          p=Prob)
+        weights = [1 / (self._coreset_size * Prob[i]) for i in chosen_indices]
+
+        return ([self._raw_data[i] for i in chosen_indices], weights)
+
+    def kmeans_cost(self,
+                    coreset_vectors: np.ndarray,
+                    sample_weight: Optional[np.ndarray] = None) -> float:
+        """
+        Compute the cost of coreset vectors using k-means clustering.
+
+        Args:
+            `coreset_vectors (np.ndarray)`: The coreset vectors.
+            `sample_weight (np.ndarray)`: The sample weights.
+
+        Returns:
+            float: The cost of the k-means clustering.
+
+        """
+
+        kmeans = KMeans(n_clusters=2).fit(coreset_vectors,
+                                          sample_weight=sample_weight)
+        return self.get_cost(kmeans.cluster_centers_)
+
+    def best_coreset_using_kmeans_cost(
+            self, coreset_vectors: List[np.ndarray],
+            coreset_weights: List[np.ndarray]) -> Tuple[np.ndarray, np.ndarray]:
+        """
+        Get the best coreset using k-means cost.
+
+        Args:
+            `coreset_vectors (List[np.ndarray])`: The coreset vectors.
+            `coreset_weights (List[np.ndarray])`: The coreset weights.
+
+        Returns:
+            Tuple: The best coreset vectors and coreset weights.
+        """
+
+        cost_coreset = [
+            self.kmeans_cost(
+                coreset_vectors=coreset_vectors[i],
+                sample_weight=coreset_weights[i],
+            ) for i in range(self._number_of_coresets_to_evaluate)
+        ]
+
+        best_index = cost_coreset.index(np.min(cost_coreset))
+        return (coreset_vectors[best_index], coreset_weights[best_index])
+
+    def get_coresets_using_BLK2(
+        self, centroids: Union[List[np.ndarray], np.ndarray]
+    ) -> Tuple[List[List[np.ndarray]], List[List[float]]]:
+        """
+        Generates coreset vectors and weights using Algorithm 2.
+
+        Args:
+            `centroids (List[np.ndarray])`: The centroids to use for the coreset generation.
+
+        Returns:
+            `Tuple[List[List[np.ndarray]], List[List[float]]]`: The coreset vectors and coreset weights.
+        """
+
+        coreset_vectors_list = []
+        coreset_weights_list = []
+        for i in range(self.number_of_coresets_to_evaluate):
+            coreset_vectors, coreset_weights = self.BLK2(centroids=centroids)
+            coreset_vectors_list.append(coreset_vectors)
+            coreset_weights_list.append(coreset_weights)
+
+        return (coreset_vectors_list, coreset_weights_list)
+
+    def BLK2(
+        self,
+        centroids: Union[List[np.ndarray], np.ndarray],
+    ) -> Tuple[List[np.ndarray], List[float]]:
+        """
+        Performs Algorithm 2 from  https://arxiv.org/pdf/1703.06476.pdf.
+
+        Args:
+            `centroids (List[np.ndarray])`: The centroids to use for the coreset generation.
+
+        Returns:
+            `Tuple[List, List]`: The coreset vectors and coreset weights.
+        """
+
+        alpha = 16 * (np.log2(self._k_value_for_BLK2) + 2)
+
+        B_i_totals = [0] * len(centroids)
+        B_i = [np.empty_like(self._raw_data) for _ in range(len(centroids))]
+        for data_instance in self._raw_data:
+            _, closest_index = self.distance_to_centroids(
+                data_instance, centroids)
+            B_i[closest_index][B_i_totals[closest_index]] = data_instance
+            B_i_totals[closest_index] += 1
+
+        c_phi = sum([
+            self.distance_to_centroids(data_instance, centroids)[0]**2
+            for data_instance in self._raw_data
+        ]) / len(self._raw_data)
+
+        p = np.zeros(len(self._raw_data))
+
+        sum_dist = {i: 0.0 for i in range(len(centroids))}
+        for i, data_instance in enumerate(self._raw_data):
+            dist, closest_index = self.distance_to_centroids(
+                data_instance, centroids)
+            sum_dist[closest_index] += dist**2
+
+        for i, data_instance in enumerate(self._raw_data):
+            p[i] = 2 * alpha * self.distance_to_centroids(
+                data_instance, centroids)[0]**2 / c_phi
+
+            closest_index = self.distance_to_centroids(data_instance,
+                                                       centroids)[1]
+            p[i] += 4 * alpha * sum_dist[closest_index] / (
+                B_i_totals[closest_index] * c_phi)
+
+            p[i] += 4 * len(self._raw_data) / B_i_totals[closest_index]
+        p = p / sum(p)
+
+        chosen_indices = np.random.choice(len(self._raw_data),
+                                          size=self._coreset_size,
+                                          p=p)
+        weights = [1 / (self._coreset_size * p[i]) for i in chosen_indices]
+
+        return [self._raw_data[i] for i in chosen_indices], weights
+
+    @staticmethod
+    def coreset_to_graph(
+        coreset_vectors: np.ndarray,
+        coreset_weights: np.ndarray,
+        metric: Optional[str] = "dot",
+        number_of_qubits_representing_data: Optional[int] = 1,
+    ) -> nx.Graph:
+        """
+        Convert coreset vectors to a graph.
+
+        Args:
+            `coreset_vectors (np.ndarray)`: The coreset vectors.
+            `coreset_weights (np.ndarray)`: The coreset weights.
+            `metric (str, optional)`: The metric to use. Defaults to "dot".
+            `number_of_qubits_representing_data (int, optional)`: The number of qubits representing the data. Defaults to 1.
+
+        Returns:
+            `nx.Graph`: The graph.
+        """
+
+        coreset = [(w, v) for w, v in zip(coreset_weights, coreset_vectors)]
+
+        vertices = len(coreset)
+        vertex_labels = [
+            number_of_qubits_representing_data * int(i) for i in range(vertices)
+        ]
+        G = nx.Graph()
+        G.add_nodes_from(vertex_labels)
+        edges = [(
+            number_of_qubits_representing_data * i,
+            number_of_qubits_representing_data * j,
+        ) for i in range(vertices) for j in range(i + 1, vertices)]
+
+        G.add_edges_from(edges)
+
+        for edge in G.edges():
+            v_i = edge[0] // number_of_qubits_representing_data
+            v_j = edge[1] // number_of_qubits_representing_data
+            w_i = coreset[v_i][0]
+            w_j = coreset[v_j][0]
+            if metric == "dot":
+                mval = np.dot(
+                    coreset[v_i][1],
+                    coreset[v_j][1],
+                )
+            elif metric == "dist":
+                mval = np.linalg.norm(coreset[v_i][1] - coreset[v_j][1])
+            else:
+                raise Exception("Unknown metric: {}".format(metric))
+
+            G[edge[0]][edge[1]]["weight"] = w_i * w_j * mval
+
+        return G
+
+    @staticmethod
+    def normalize_array(vectors: np.ndarray,
+                        centralize: bool = False) -> np.ndarray:
+        """
+        Normalize and centralize the array
+
+        Args:
+            `vectors (np.ndarray)`: The vectors to normalize
+            `centralize (bool, optional)`: Centralize the array. Defaults to False.
+
+        Returns:
+            `np.ndarray`: The normalized array
+        """
+
+        if centralize:
+            vectors = vectors - np.mean(vectors, axis=0)
+
+        max_abs = np.max(np.abs(vectors), axis=0)
+        vectors_norm = vectors / max_abs
+
+        return vectors_norm
+
+    @staticmethod
+    def create_dataset(
+        n_samples: float,
+        covariance_values: List[float] = [-0.8, -0.8],
+        n_features: Optional[int] = 2,
+        number_of_samples_from_distribution: Optional[int] = 500,
+        mean_array: Optional[np.ndarray] = np.array([[0, 0], [7, 1]]),
+        random_seed: Optional[int] = 10,
+    ) -> np.ndarray:
+        """
+        Create a data set with the given parameters.
+
+        Args:
+            `n_samples (float)`: The number of samples.
+            `covariance_values (List[float], optional)`: The covariance values. Defaults to [-0.8, -0.8].
+            `n_features (int, optional)`: The number of features. Defaults to 2.
+            `number_of_samples_from_distribution (int, optional)`: The number of samples from the distribution. Defaults to 500.
+            `mean_array (np.ndarray, optional)`: The mean array. Defaults to `np.array([[0, 0], [7, 1]])`.
+            `random_seed (int, optional)`: The random seed. Defaults to 10.
+
+        Returns:
+            `np.ndarray`: The data set created
+        """
+
+        random_seed = random_seed
+
+        X = np.zeros((n_samples, n_features))
+
+        for idx, val in enumerate(covariance_values):
+            covariance_matrix = np.array([[1, val], [val, 1]])
+
+            distr = multivariate_normal(cov=covariance_matrix,
+                                        mean=mean_array[idx],
+                                        seed=random_seed)
+
+            data = distr.rvs(size=number_of_samples_from_distribution)
+
+            X[number_of_samples_from_distribution *
+              idx:number_of_samples_from_distribution * (idx + 1)][:] = data
+
+        return X
+
+
+class DivisiveClustering(ABC):
+
+    def __init__(
+        self,
+        circuit_depth: int,
+        max_iterations: int,
+        max_shots: int,
+        threshold_for_max_cut: float,
+        create_Hamiltonian: Callable,
+        optimizer: cudaq.optimizers.optimizer,
+        optimizer_function: Callable,
+        create_circuit: Callable,
+        normalize_vectors: Optional[bool] = True,
+        sort_by_descending: Optional[bool] = True,
+        coreset_to_graph_metric: Optional[str] = "dot",
+    ) -> None:
+        self.circuit_depth = circuit_depth
+        self.max_iterations = max_iterations
+        self.max_shots = max_shots
+        self.threshold_for_maxcut = threshold_for_max_cut
+        self.normalize_vectors = normalize_vectors
+        self.sort_by_descending = sort_by_descending
+        self.coreset_to_graph_metric = coreset_to_graph_metric
+        self.create_Hamiltonian = create_Hamiltonian
+        self.create_circuit = create_circuit
+        self.optimizer = optimizer
+        self.optimizer_function = optimizer_function
+
+    @abstractmethod
+    def run_divisive_clustering(
+        self, coreset_vectors_df_for_iteration: pd.DataFrame
+    ) -> Union[List[str], List[int]]:
+        """
+        Run the divisive clustering algorithm.
+
+        Args:
+            `coreset_vectors_df_for_iteration (pd.DataFrame)`: The coreset vectors for the iteration.
+
+        Returns:
+            `Union[List[str], List[int]]`: The bitstring or the cluster. The return will depend on the name of the data point given.
+        """
+
+        pass
+
+    def get_hierarchical_clustering_sequence(
+        self,
+        coreset_vectors_df_for_iteration: np.ndarray,
+        hierarchial_sequence: List,
+    ) -> List:
+        """
+        Get the hierarchical clustering sequence.
+
+        Args:
+            `coreset_vectors_df_for_iteration (np.ndarray)`: The coreset vectors for the iteration.
+            `hierarchial_sequence (List)`: The hierarchical sequence.
+
+        """
+
+        bitstring = self.run_divisive_clustering(
+            coreset_vectors_df_for_iteration)
+        return self._add_children_to_hierarchial_clustering(
+            coreset_vectors_df_for_iteration, hierarchial_sequence, bitstring)
+
+    def _get_iteration_coreset_vectors_and_weights(
+        self, coreset_vectors_df_for_iteration: pd.DataFrame
+    ) -> Tuple[np.ndarray, np.ndarray]:
+        """
+        Gets the iteration coreset vectors and weights.
+
+        Args:
+            `coreset_vectors_df_for_iteration (pd.DataFrame)`: The coreset vectors for the iteration.
+
+        Returns:
+            `Tuple[np.ndarray, np.ndarray]`: The coreset vectors and weights.
+
+        """
+
+        coreset_vectors_for_iteration = coreset_vectors_df_for_iteration[[
+            "X", "Y"
+        ]].to_numpy()
+
+        coreset_weights_for_iteration = coreset_vectors_df_for_iteration[
+            "weights"].to_numpy()
+
+        if self.normalize_vectors:
+            coreset_vectors_for_iteration = Coreset.normalize_array(
+                coreset_vectors_for_iteration, True)
+            coreset_weights_for_iteration = Coreset.normalize_array(
+                coreset_weights_for_iteration)
+
+        return (coreset_vectors_for_iteration, coreset_weights_for_iteration)
+
+    def brute_force_cost_maxcut(self, bitstrings: list[Union[str, int]],
+                                G: nx.graph) -> Dict[str, float]:
+        """
+        Cost function for brute force method
+
+        Args:
+            bitstrings: list of bit strings
+            G: The graph of the problem
+
+        Returns:
+            Dict: Dictionary with bitstring and cost value
+        """
+
+        cost_value = {}
+        for bitstring in tqdm(bitstrings):
+            c = 0
+            for i, j in G.edges():
+                edge_weight = G[i][j]["weight"]
+                c += self._get_edge_cost(bitstring, i, j, edge_weight)
+
+            cost_value.update({bitstring: c})
+
+        return cost_value
+
+    def _get_edge_cost(self, bitstring: str, i: int, j: int,
+                       edge_weight: float) -> float:
+        """
+        Get the edge cost using MaxCut cost function.
+
+        Args:
+            bitstring: The bitstring
+            i: The first node
+            j: The second node
+            edge_weight: The edge weight
+
+        Returns:
+            float: The edge cost
+        """
+
+        ai = int(bitstring[i])
+        aj = int(bitstring[j])
+
+        return -1 * edge_weight * (1 - ((-1)**ai) * ((-1)**aj))
+
+    def _add_children_to_hierarchial_clustering(
+        self,
+        iteration_dataframe: pd.DataFrame,
+        hierarchial_sequence: list,
+        bitstring: str,
+    ) -> List[Union[str, int]]:
+        """
+        Add children to the hierarchical clustering sequence.
+
+        Args:
+            `iteration_dataframe (pd.DataFrame)`: The iteration data frame.
+            `hierarchial_sequence (list)`: The hierarchical sequence.
+            `bitstring (str)`: The bitstring.
+
+        Returns:
+            list: The hierarchical sequence.
+        """
+
+        iteration_dataframe["cluster"] = [int(bit) for bit in bitstring]
+
+        for j in range(2):
+            idx = list(
+                iteration_dataframe[iteration_dataframe["cluster"] == j].index)
+            if len(idx) > 0:
+                hierarchial_sequence.append(idx)
+
+        return hierarchial_sequence
+
+    @staticmethod
+    def get_divisive_cluster_cost(hierarchical_clustering_sequence: List[Union[
+        str, int]], coreset_data: pd.DataFrame) -> List[float]:
+        """
+        Get the cost of the divisive clustering at each iteration.
+
+        Args:
+            `hierarchical_clustering_sequence (List)`: The hierarchical clustering sequence.
+            `coreset_data (pd.DataFrame)`: The coreset data.
+
+        Returns:
+            List[float]: The cost of the divisive clustering sequence.
+        """
+
+        coreset_data = coreset_data.drop(["Name", "weights"], axis=1)
+        cost_at_each_iteration = []
+        for parent in hierarchical_clustering_sequence:
+            children_lst = Dendrogram.find_children(
+                parent, hierarchical_clustering_sequence)
+
+            if not children_lst:
+                continue
+            else:
+                children_1, children_2 = children_lst
+
+                parent_data_frame = coreset_data.iloc[parent]
+
+                parent_data_frame["cluster"] = 0
+
+                parent_data_frame.loc[children_2, "cluster"] = 1
+
+                cost = 0
+
+                centroid_coords = parent_data_frame.groupby("cluster").mean()[[
+                    "X", "Y"
+                ]]
+                centroid_coords = centroid_coords.to_numpy()
+
+                for idx, row in parent_data_frame.iterrows():
+                    if row.cluster == 0:
+                        cost += np.linalg.norm(row[["X", "Y"]] -
+                                               centroid_coords[0])**2
+                    else:
+                        cost += np.linalg.norm(row[["X", "Y"]] -
+                                               centroid_coords[1])**2
+
+                cost_at_each_iteration.append(cost)
+
+        return cost_at_each_iteration
+
+    def _get_best_bitstring(self, counts: cudaq.SampleResult,
+                            G: nx.Graph) -> str:
+        """
+        From the simulator output, extract the best bitstring.
+
+        Args:
+            `counts (cudaq.SampleResult)`: The counts.
+            `G (nx.Graph)`: The graph.
+
+        Returns:
+            `str`: The best bitstring.
+        """
+
+        counts_pd = pd.DataFrame(counts.items(),
+                                 columns=["bitstring", "counts"])
+        counts_pd[
+            "probability"] = counts_pd["counts"] / counts_pd["counts"].sum()
+        bitstring_probability_df = counts_pd.drop(columns=["counts"])
+        bitstring_probability_df = bitstring_probability_df.sort_values(
+            "probability", ascending=self.sort_by_descending)
+
+        unacceptable_bitstrings = [
+            "".join("1" for _ in range(10)),
+            "".join("0" for _ in range(10)),
+        ]
+
+        bitstring_probability_df = bitstring_probability_df[
+            ~bitstring_probability_df["bitstring"].isin(unacceptable_bitstrings
+                                                       )]
+
+        if len(bitstring_probability_df) > 10:
+            selected_rows = int(
+                len(bitstring_probability_df) * self.threshold_for_maxcut)
+        else:
+            selected_rows = int(len(bitstring_probability_df) / 2)
+
+        bitstring_probability_df = bitstring_probability_df.head(selected_rows)
+
+        bitstrings = bitstring_probability_df["bitstring"].tolist()
+
+        brute_force_cost_of_bitstrings = self.brute_force_cost_maxcut(
+            bitstrings, G)
+
+        return min(brute_force_cost_of_bitstrings,
+                   key=brute_force_cost_of_bitstrings.get)
+
+    def get_divisive_sequence(
+            self, full_coreset_df: pd.DataFrame) -> List[Union[str, int]]:
+        """
+        Perform divisive clustering on the coreset data.
+
+        Args:
+            `full_coreset_df (pd.DataFrame)`: The full coreset data.
+
+        Returns:
+            `List[Union[str, int]]`: The hierarchical clustering sequence.
+        """
+
+        index_iteration_counter = 0
+        single_clusters = 0
+
+        index_values = list(range(len(full_coreset_df)))
+        hierarchical_clustering_sequence = [index_values]
+
+        while single_clusters < len(index_values):
+            index_values_to_evaluate = hierarchical_clustering_sequence[
+                index_iteration_counter]
+            if len(index_values_to_evaluate) == 1:
+                single_clusters += 1
+
+            elif len(index_values_to_evaluate) == 2:
+                hierarchical_clustering_sequence.append(
+                    [index_values_to_evaluate[0]])
+                hierarchical_clustering_sequence.append(
+                    [index_values_to_evaluate[1]])
+
+            else:
+                coreset_vectors_df_for_iteration = full_coreset_df.iloc[
+                    index_values_to_evaluate]
+
+                hierarchical_clustering_sequence = self.get_hierarchical_clustering_sequence(
+                    coreset_vectors_df_for_iteration,
+                    hierarchical_clustering_sequence,
+                )
+
+            index_iteration_counter += 1
+
+        return hierarchical_clustering_sequence
+
+
+class Dendrogram:
+
+    def __init__(
+            self, coreset_data: pd.DataFrame,
+            hierarchical_clustering_sequence: List[Union[str, int]]) -> None:
+        self._coreset_data = self.__create_coreset_data(coreset_data)
+        self._hierarchial_clustering_sequence = self.__convert_numbers_to_name(
+            hierarchical_clustering_sequence, coreset_data)
+        self.linkage_matrix = []
+
+    @property
+    def coreset_data(self) -> pd.DataFrame:
+        return self._coreset_data
+
+    @coreset_data.setter
+    def coreset_data(self, coreset_data: pd.DataFrame) -> None:
+        self.linkage_matrix = []
+        self._coreset_data = coreset_data
+
+    @property
+    def hierarchical_clustering_sequence(self) -> List[Union[str, int]]:
+        return self._hierarchial_clustering_sequence
+
+    @hierarchical_clustering_sequence.setter
+    def hierarchical_clustering_sequence(
+            self, hierarchical_clustering_sequence: List[Union[str,
+                                                               int]]) -> None:
+        self.linkage_matrix = []
+        self._hierarchial_clustering_sequence = hierarchical_clustering_sequence
+
+    def __call__(self) -> List:
+        if not self.linkage_matrix:
+            self.get_linkage_matrix(self._hierarchial_clustering_sequence[0])
+
+        return self.linkage_matrix
+
+    def __create_coreset_data(self, coreset_data: pd.DataFrame) -> pd.DataFrame:
+        """
+        Creates coreset data that can be used for plotting.
+
+        Args:
+            `coreset_data (pd.DataFrame)`: The coreset data.
+
+        Returns:
+            `pd.DataFrame`: The coreset data.
+        """
+
+        _coreset_data = coreset_data.copy()
+        _coreset_data.index = _coreset_data.Name
+
+        return _coreset_data.drop(columns=["Name", "weights"])
+
+    def __convert_numbers_to_name(self,
+                                  hierarchical_clustering_sequence: List[int],
+                                  coreset_data: pd.DataFrame) -> List[str]:
+        """
+        Converts the int in the hierarchical sequence into the instance name. This would be used to plot the leaves of the dendrogram.
+
+        Args:
+            `hierarchical_clustering_sequence (List[int])`: The hierarchical clustering sequence.
+            `coreset_data (pd.DataFrame)`: The coreset data.
+
+        Returns:
+            List[str]: The converted hierarchical clustering sequence.
+        """
+
+        converted_hc = []
+        for hc in hierarchical_clustering_sequence:
+            converted_hc.append([coreset_data.Name[num] for num in hc])
+
+        return converted_hc
+
+    def plot_dendrogram(
+        self,
+        plot_title: Optional[str] = "DIANA",
+        orientation: Optional[str] = "top",
+        color_threshold: Optional[int] = None,
+        colors: Optional[List] = None,
+        clusters: Optional[np.ndarray] = None,
+        link_color_func: Optional[Callable] = None,
+    ):
+        """
+        Plots the dendrogram.
+
+        Args:
+            `plot_title (str, optional)`: The plot title. Defaults to "DIANA".
+            `orientation (str, optional)`: The orientation of the dendrogram. Defaults to "top".
+            `color_threshold (int, optional)`: The color threshold to convert hierarchical clustering into flat clustering. Defaults to None.
+            `colors (List, optional)`: The colors for the leaves. Defaults to None.
+            `clusters (np.ndarray, optional)`: Flat clustering results from applying threshold. Defaults to None.
+            `link_color_func (Callable, optional)`: Function to color the branches. Defaults to None.
+        """
+
+        if not self.linkage_matrix:
+            self.get_linkage_matrix(self._hierarchial_clustering_sequence[0])
+
+        if clusters is None:
+            clusters = np.array([0] * len(self._coreset_data))
+
+        fig = plt.figure(figsize=(10, 10), dpi=100)
+        plt.title(plot_title)
+        dn = dendrogram(
+            self.linkage_matrix,
+            labels=self._coreset_data.index,
+            orientation=orientation,
+            color_threshold=color_threshold * 100 if colors else None,
+        )
+
+        if color_threshold is not None:
+            plt.axhline(y=color_threshold, color="r", linestyle="--")
+
+        if colors is not None:
+            if len(colors) < len(set(clusters)):
+                raise ValueError(
+                    "Number of colors should be equal to number of clusters")
+            else:
+                colors_dict = {
+                    self._coreset_data.index[i]: colors[j]
+                    for i, j in enumerate(clusters)
+                }
+
+                ax = plt.gca()
+                xlbls = ax.get_xmajorticklabels()
+                for lbl in xlbls:
+                    lbl.set_color(colors_dict[lbl.get_text()])
+
+        plt.show()
+
+    def get_clusters_using_height(self, threshold: float) -> np.ndarray:
+        """
+        Get flat clusters from the hierarchical clustering using a threshold.
+
+        Args:
+            threshold (float): The height threshold to convert.
+
+        Returns:
+            `np.ndarray`: The flat cluster labels.
+        """
+
+        if not self.linkage_matrix:
+            self.get_linkage_matrix(self._hierarchial_clustering_sequence[0])
+
+        clusters = fcluster(self.linkage_matrix,
+                            threshold,
+                            criterion="distance")
+
+        return np.array(clusters) - 1
+
+    def get_clusters_using_k(self, k: int) -> np.ndarray:
+        """
+        Get flat clusters from the hierarchical cluster by defining the number of clusters.
+
+        Args:
+            k (int): The number of clusters.
+
+        Returns:
+            `np.ndarray`: The flat cluster labels.
+
+        """
+        if not self.linkage_matrix:
+            self.get_linkage_matrix(self._hierarchial_clustering_sequence[0])
+
+        clusters = fcluster(self.linkage_matrix, k, criterion="maxclust")
+
+        return np.array(clusters) - 1
+
+    def plot_clusters(
+        self,
+        clusters: np.ndarray,
+        colors: List[str],
+        plot_title: str,
+        show_annotation: Optional[bool] = False,
+    ):
+        """
+        Plot the flat clusters.
+
+        Args:
+            `clusters (np.ndarray)`: The flat clusters.
+            `colors (List[str])`: The colors for the clusters.
+            `plot_title (str)`: The plot title.
+            `show_annotation (bool, optional)`: Show annotation. Defaults to False.
+
+        """
+        if len(colors) < len(set(clusters)):
+            raise ValueError(
+                "Number of colors should be equal to number of clusters")
+        coreset_data = self._coreset_data.copy()
+        coreset_data["clusters"] = clusters
+        for i in range(coreset_data.clusters.nunique()):
+            data = coreset_data[coreset_data.clusters == i]
+            plt.scatter(data.X, data.Y, c=colors[i], label=f"Cluster {i}")
+        if show_annotation:
+            for _, row in coreset_data.iterrows():
+                plt.annotate(row.name, (row.X, row.Y))
+        plt.legend(bbox_to_anchor=(1.05, 1), loc="upper left")
+        plt.title(plot_title)
+        plt.show()
+
+    def get_linkage_matrix(self, parent: List[str]) -> int:
+        """
+        Create the linkage matrix for the dendrogram and returns the index of the new branch.
+
+        Args:
+            parent (`List[str]`): The parent cluster.
+
+        Returns:
+            List: The linkage matrix.
+        """
+
+        if len(parent) < 2:
+            index_of_parent = np.argwhere(self._coreset_data.index == parent[0])
+            return index_of_parent[0][0]
+        children_1, children_2 = self.find_children(
+            parent, self._hierarchial_clustering_sequence)
+
+        index1 = self.get_linkage_matrix(children_1)
+        index2 = self.get_linkage_matrix(children_2)
+        self.linkage_matrix.append([
+            index1,
+            index2,
+            self.distance(index1) + self.distance(index2),
+            self.cluster_len(index1) + self.cluster_len(index2),
+        ])
+
+        return len(self.linkage_matrix) - 1 + len(self.coreset_data)
+
+    def distance(self, i: int) -> float:
+        """
+        Get the distance between two clusters.
+
+        Args:
+            i (int): The index of the cluster.
+
+        Returns:
+            float: The distance of the cluster.
+        """
+
+        if i >= len(self._coreset_data):
+            distance = self.linkage_matrix[i - len(self._coreset_data)][2]
+        else:
+            distance = sum(
+                self._coreset_data.iloc[i]) / (len(self.coreset_data) - 1)
+
+        return abs(distance)
+
+    def cluster_len(self, i: int):
+        """
+        Get the length of the cluster.
+
+        Args:
+            i (int): The index of the cluster.
+
+        Returns:
+            int: The length of the cluster.
+        """
+
+        if i >= len(self._coreset_data):
+            return self.linkage_matrix[i - len(self._coreset_data)][3]
+        else:
+            return 1
+
+    @staticmethod
+    def find_children(
+            parent: List[Union[str, int]],
+            hierarchical_clustering_sequence: List[Union[str, int]]) -> List:
+        """
+        Find the children of a given parent cluster.
+
+        Args:
+            parent (List): The parent cluster.
+            hierarchical_clustering_sequence (List): The hierarchical clustering sequence.
+
+        Returns:
+            List: The children of the parent cluster.
+        """
+
+        parent_position = hierarchical_clustering_sequence.index(parent)
+
+        found = 0
+        children = []
+        for i in range(parent_position + 1,
+                       len(hierarchical_clustering_sequence)):
+            if any(item in hierarchical_clustering_sequence[i]
+                   for item in parent):
+                children.append(hierarchical_clustering_sequence[i])
+                found += 1
+                if found == 2:
+                    break
+
+        return children
+
+    @staticmethod
+    def plot_hierarchial_split(
+            hierarchical_clustering_sequence: List[Union[str, int]],
+            full_coreset_df: pd.DataFrame):
+        """
+        Plots the flat clusters at each iteration of the hierarchical clustering.
+
+        Args:
+            hierarchical_clustering_sequence (List): The hierarchical clustering sequence.
+            `full_coreset_df` (`pd.DataFrame`): The full coreset data.
+        """
+        parent_clusters = [
+            parent_cluster
+            for parent_cluster in hierarchical_clustering_sequence
+            if len(parent_cluster) > 1
+        ]
+        x_grid = int(np.sqrt(len(parent_clusters)))
+        y_grid = int(np.ceil(len(parent_clusters) / x_grid))
+
+        fig, axs = plt.subplots(x_grid, y_grid, figsize=(12, 12))
+
+        for i, parent_cluster in enumerate(parent_clusters):
+            parent_position = hierarchical_clustering_sequence.index(
+                parent_cluster)
+            children = Dendrogram.find_children(
+                parent_cluster, hierarchical_clustering_sequence)
+            coreset_for_parent_cluster = full_coreset_df.loc[parent_cluster]
+            coreset_for_parent_cluster["cluster"] = 1
+            coreset_for_parent_cluster.loc[children[0], "cluster"] = 0
+
+            ax = axs[i // 3, i % 3]
+            ax.scatter(
+                coreset_for_parent_cluster["X"],
+                coreset_for_parent_cluster["Y"],
+                c=coreset_for_parent_cluster["cluster"],
+            )
+            for _, row in coreset_for_parent_cluster.iterrows():
+                ax.annotate(row["Name"], (row["X"], row["Y"]))
+
+            ax.set_xlabel("X")
+            ax.set_ylabel("Y")
+            ax.set_title(f"Clustering at iteration {parent_position}")
+
+        plt.tight_layout()
+        plt.show()
+
+
+class Voironi_Tessalation:
+
+    def __init__(
+        self,
+        coreset_df: pd.DataFrame,
+        clusters: np.ndarray,
+        colors: List[str],
+        tesslation_by_cluster: Optional[bool] = False,
+    ) -> None:
+        coreset_df["cluster"] = clusters
+
+        if tesslation_by_cluster:
+            cluster_means = coreset_df.groupby("cluster")[["X", "Y"]].mean()
+            coreset_df = cluster_means.reset_index()
+            coreset_df["cluster"] = [i for i in range(len(coreset_df))]
+
+        coreset_df["color"] = [colors[i] for i in coreset_df.cluster]
+
+        points = coreset_df[["X", "Y"]].to_numpy()
+
+        self.coreset_df = coreset_df
+
+        self.voronoi = Voronoi(points)
+
+    def voronoi_finite_polygons_2d(self,
+                                   radius: Optional[float] = None
+                                  ) -> Tuple[List, np.ndarray]:
+        """
+        Creates the Voronoi regions and vertices for 2D data.
+
+        Args:
+            radius (Optional[None]): The radius from the data points to create the Voronoi regions. Defaults to None.
+
+        Returns:
+            Tuple: The regions and vertices.
+        """
+
+        if self.voronoi.points.shape[1] != 2:
+            raise ValueError("Requires 2D input")
+
+        new_regions = []
+        new_vertices = self.voronoi.vertices.tolist()
+
+        center = self.voronoi.points.mean(axis=0)
+        if radius is None:
+            radius = self.voronoi.points.ptp().max()
+
+        all_ridges = {}
+        for (p1, p2), (v1, v2) in zip(self.voronoi.ridge_points,
+                                      self.voronoi.ridge_vertices):
+            all_ridges.setdefault(p1, []).append((p2, v1, v2))
+            all_ridges.setdefault(p2, []).append((p1, v1, v2))
+
+        for p1, region in enumerate(self.voronoi.point_region):
+            vertices = self.voronoi.regions[region]
+
+            if all(v >= 0 for v in vertices):
+                new_regions.append(vertices)
+                continue
+
+            ridges = all_ridges[p1]
+            new_region = [v for v in vertices if v >= 0]
+
+            for p2, v1, v2 in ridges:
+                if v2 < 0:
+                    v1, v2 = v2, v1
+                if v1 >= 0:
+                    continue
+
+                t = self.voronoi.points[p2] - self.voronoi.points[p1]
+                t /= np.linalg.norm(t)
+                n = np.array([-t[1], t[0]])
+
+                midpoint = self.voronoi.points[[p1, p2]].mean(axis=0)
+                direction = np.sign(np.dot(midpoint - center, n)) * n
+
+                far_point = self.voronoi.vertices[v2] + direction * radius
+
+                new_region.append(len(new_vertices))
+                new_vertices.append(far_point.tolist())
+
+            vs = np.asarray([new_vertices[v] for v in new_region])
+            c = vs.mean(axis=0)
+
+            angles = np.arctan2(vs[:, 1] - c[1], vs[:, 0] - c[0])
+            new_region = np.array(new_region)[np.argsort(angles)]
+
+            new_regions.append(new_region.tolist())
+
+        return new_regions, np.asarray(new_vertices)
+
+    def plot_voironi(
+        self,
+        plot_title: Optional[str] = "Voronoi Tessalation",
+        show_annotation: bool = False,
+        show_scatters: bool = False,
+    ):
+        regions, vertices = self.voronoi_finite_polygons_2d()
+        fig, ax = plt.subplots(figsize=(8, 8))
+        fig.tight_layout(pad=10)
+
+        for j, region in enumerate(regions):
+            polygon = vertices[region]
+            color = self.coreset_df.color[j]
+            # Uncomment this line for debugging
+            # `breakpoint()`
+            plt.fill(*zip(*polygon), alpha=0.4, color=color, linewidth=0)
+            if show_annotation:
+                plt.annotate(
+                    self.coreset_df.Name[j],
+                    (self.coreset_df.X[j] + 0.2, self.coreset_df.Y[j]),
+                    fontsize=10,
+                )
+
+        if show_scatters:
+            plt.plot(self.coreset_df.X, self.coreset_df.Y, "ko")
+
+        plt.xlim(min(self.coreset_df.X) - 1, max(self.coreset_df.X) + 1)
+        plt.ylim(min(self.coreset_df.Y) - 1, max(self.coreset_df.Y) + 1)
+        plt.xlabel("x")
+        plt.ylabel("y")
+        plt.title(plot_title)
+        plt.show()
diff --git a/pr-2241/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py b/pr-2241/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py
new file mode 100644
index 0000000000..6ada0c0cde
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/divisive_clustering_src/main_divisive_clustering.py
@@ -0,0 +1,261 @@
+import argparse
+import os
+import sys
+import time
+import warnings
+from typing import Callable
+
+import cudaq
+import networkx as nx
+import numpy as np
+import pandas as pd
+from cudaq import spin
+from mpi4py import MPI
+
+np.random.seed(10)
+
+sys.path.append(os.path.join(os.path.dirname(__file__), ".."))
+
+from divisive_clustering import Coreset, DivisiveClustering
+
+warnings.filterwarnings("ignore")
+
+argparser = argparse.ArgumentParser()
+argparser.add_argument(
+    "-t",
+    "--target",
+    type=str,
+    choices=["qpp-cpu", "nvidia", "nvidia-mgpu"],
+    help=
+    "Quantum simulator backend. Default is qpp-cpu. See https://nvidia.github.io/cuda-quantum/0.6.0/using/simulators.html for more options.",
+)
+argparser.add_argument(
+    "-d",
+    "--depth",
+    type=int,
+    default=1,
+    help="Depth of the QAOA circuit. Default is 1.",
+)
+argparser.add_argument("-i",
+                       "--max_iterations",
+                       type=int,
+                       default=75,
+                       help="Max iterations for the optimizer.")
+argparser.add_argument("-s",
+                       "--max_shots",
+                       type=int,
+                       default=100000,
+                       help="Max shots for the simulation.")
+argparser.add_argument("-m",
+                       "--M",
+                       type=int,
+                       default=10,
+                       help="Size of the coreset.")
+
+args = argparser.parse_args()
+
+target = args.target
+coreset_size = args.M
+circuit_depth = args.depth
+max_iterations = args.max_iterations
+max_shots = args.max_shots
+
+
+class DivisiveClusteringVQA(DivisiveClustering):
+
+    def __init__(
+        self,
+        circuit_depth: int,
+        max_iterations: int,
+        max_shots: int,
+        threshold_for_max_cut: float,
+        create_Hamiltonian: Callable,
+        optimizer: cudaq.optimizers.optimizer,
+        optimizer_function: Callable,
+        create_circuit: Callable,
+        normalize_vectors: bool = True,
+        sort_by_descending: bool = True,
+        coreset_to_graph_metric: str = "dist",
+    ) -> None:
+        self.circuit_depth = circuit_depth
+        self.max_iterations = max_iterations
+        self.max_shots = max_shots
+        self.threshold_for_maxcut = threshold_for_max_cut
+        self.normalize_vectors = normalize_vectors
+        self.sort_by_descending = sort_by_descending
+        self.coreset_to_graph_metric = coreset_to_graph_metric
+        self.create_Hamiltonian = create_Hamiltonian
+        self.create_circuit = create_circuit
+        self.optimizer = optimizer
+        self.optimizer_function = optimizer_function
+        self.time_consumed = 0
+
+    def run_divisive_clustering(
+        self,
+        coreset_vectors_df_for_iteration: pd.DataFrame,
+    ):
+        coreset_vectors_for_iteration_np, coreset_weights_for_iteration_np = (
+            self._get_iteration_coreset_vectors_and_weights(
+                coreset_vectors_df_for_iteration))
+
+        G = Coreset.coreset_to_graph(
+            coreset_vectors_for_iteration_np,
+            coreset_weights_for_iteration_np,
+            metric=self.coreset_to_graph_metric,
+        )
+
+        counts = self.get_counts_from_simulation(
+            G,
+            self.circuit_depth,
+            self.max_iterations,
+            self.max_shots,
+        )
+
+        return self._get_best_bitstring(counts, G)
+
+    def get_counts_from_simulation(self, G, circuit_depth, max_iterations,
+                                   max_shots):
+        qubits = len(G.nodes)
+        Hamiltonian = self.create_Hamiltonian(G)
+        optimizer, parameter_count, initial_params = self.optimizer_function(
+            self.optimizer,
+            max_iterations,
+            qubits=qubits,
+            circuit_depth=circuit_depth)
+
+        kernel = self.create_circuit(qubits, circuit_depth)
+
+        def objective_function(parameter_vector: list[float],
+                               hamiltonian=Hamiltonian,
+                               kernel=kernel) -> tuple[float, list[float]]:
+            get_result = lambda parameter_vector: cudaq.observe(
+                kernel, hamiltonian, parameter_vector, qubits, circuit_depth
+            ).expectation()
+
+            cost = get_result(parameter_vector)
+
+            return cost
+
+        t0 = time.process_time()
+
+        energy, optimal_parameters = optimizer.optimize(
+            dimensions=parameter_count, function=objective_function)
+
+        counts = cudaq.sample(
+            kernel,
+            optimal_parameters,
+            qubits,
+            circuit_depth,
+            shots_count=max_shots,
+        )
+
+        tf = time.process_time()
+        self.time_consumed += tf - t0
+
+        return counts
+
+
+def get_K2_Hamiltonian(G: nx.Graph) -> cudaq.SpinOperator:
+    H = 0
+
+    for i, j in G.edges():
+        weight = G[i][j]["weight"]
+        H += weight * (spin.z(i) * spin.z(j))
+
+    return H
+
+
+def get_QAOA_circuit(number_of_qubits, circuit_depth):
+
+    @cudaq.kernel
+    def kernel(thetas: list[float], number_of_qubits: int, circuit_depth: int):
+        qubits = cudaq.qvector(number_of_qubits)
+
+        layers = circuit_depth
+
+        for layer in range(layers):
+            for qubit in range(number_of_qubits):
+                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])
+                rz(2.0 * thetas[layer], qubits[(qubit + 1) % number_of_qubits])
+                cx(qubits[qubit], qubits[(qubit + 1) % number_of_qubits])
+
+            rx(2.0 * thetas[layer + layers], qubits)
+
+    return kernel
+
+
+def get_optimizer(optimizer: cudaq.optimizers.optimizer, max_iterations,
+                  **kwargs):
+    parameter_count = 4 * kwargs["circuit_depth"] * kwargs["qubits"]
+    initial_params = np.random.uniform(-np.pi / 8.0, np.pi / 8.0,
+                                       parameter_count)
+    optimizer.initial_parameters = initial_params
+
+    optimizer.max_iterations = max_iterations
+    return optimizer, parameter_count, initial_params
+
+
+def create_coreset_df(
+    raw_data_size: int = 1000,
+    number_of_sampling_for_centroids: int = 10,
+    coreset_size: int = 10,
+    number_of_coresets_to_evaluate: int = 4,
+    coreset_method: str = "BFL2",
+):
+    raw_data = Coreset.create_dataset(raw_data_size)
+    coreset = Coreset(
+        raw_data=raw_data,
+        number_of_sampling_for_centroids=number_of_sampling_for_centroids,
+        coreset_size=coreset_size,
+        number_of_coresets_to_evaluate=number_of_coresets_to_evaluate,
+        coreset_method=coreset_method,
+    )
+
+    coreset_vectors, coreset_weights = coreset.get_best_coresets()
+
+    coreset_df = pd.DataFrame({
+        "X": coreset_vectors[:, 0],
+        "Y": coreset_vectors[:, 1],
+        "weights": coreset_weights,
+    })
+    coreset_df["Name"] = [chr(i + 65) for i in coreset_df.index]
+
+    return coreset_df
+
+
+if __name__ == "__main__":
+    cudaq.set_target(target)
+
+    coreset_df = create_coreset_df(
+        raw_data_size=1000,
+        number_of_sampling_for_centroids=10,
+        coreset_size=coreset_size,
+        number_of_coresets_to_evaluate=4,
+        coreset_method="BFL2",
+    )
+
+    optimizer = cudaq.optimizers.COBYLA()
+
+    divisive_clustering = DivisiveClusteringVQA(
+        circuit_depth=circuit_depth,
+        max_iterations=max_iterations,
+        max_shots=max_shots,
+        threshold_for_max_cut=0.5,
+        create_Hamiltonian=get_K2_Hamiltonian,
+        optimizer=optimizer,
+        optimizer_function=get_optimizer,
+        create_circuit=get_QAOA_circuit,
+        normalize_vectors=True,
+        sort_by_descending=True,
+        coreset_to_graph_metric="dist",
+    )
+
+    t0 = time.process_time()
+
+    hierarchial_clustering_sequence = divisive_clustering.get_divisive_sequence(
+        coreset_df)
+    tf = time.process_time()
+
+    print(f"Total time for the execution: {tf - t0}")
+
+    print(f"Total time spent on CUDA-Q: {divisive_clustering.time_consumed}")
diff --git a/pr-2241/sphinx/examples/python/tutorials/hadamard_test.ipynb b/pr-2241/sphinx/examples/python/tutorials/hadamard_test.ipynb
new file mode 100644
index 0000000000..104d99ddb5
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/hadamard_test.ipynb
@@ -0,0 +1,310 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hadamard Test and Application\n",
+    "\n",
+    "Consider the observable $O$ and two generic quantum states $\\ket{\\psi}$ and $\\ket{\\phi}$. We want to calculate the quantity\n",
+    "$$\n",
+    "\\braket{\\psi | O | \\psi}.\n",
+    "$$\n",
+    "where $O$ is a Pauli operator.\n",
+    "\n",
+    "First of all we shall prepare the states $\\ket{\\psi}$ and $\\ket{\\phi}$ using a quantum circuit for each of them. So we  have\n",
+    "$$\n",
+    "\\ket{\\psi} = U_{\\psi}\\ket{0} \\qquad \\ket{\\phi} = U_{\\phi}\\ket{0}\n",
+    "$$\n",
+    "\n",
+    "Let's define an observable we want to use:\n",
+    "$$\n",
+    "O = X_1X_2\n",
+    "$$\n",
+    "\n",
+    "Now we can evaluate the matrix element using the following fact:\n",
+    "$$\n",
+    "\\bra{\\psi}O\\ket{\\phi} = \\bra{0}U_\\psi^\\dagger O U_\\phi\\ket{0}\n",
+    "$$\n",
+    "This is just an expectation value which can be solved with a simple Hadamard test. The probability to measure $0$ or $1$ in the ancilla qubit is\n",
+    "\n",
+    "$$\n",
+    "P(0) = \\frac{1}{2} \\left[ I + \\operatorname{Re} \\bra{\\psi} O \\ket{\\phi} \\right]\n",
+    "$$\n",
+    "\n",
+    "$$\n",
+    "P(1) = \\frac{1}{2} \\left[ I - \\operatorname{Re} \\bra{\\psi} O \\ket{\\phi} \\right]\n",
+    "$$\n",
+    "\n",
+    "The difference between the probability of $0$ and $1$ gives \n",
+    "\n",
+    "$$\n",
+    "\\braket{X} = P(0)-P(1) = \\operatorname{Re} \\braket{\\psi | O | \n",
+    "\\phi}.\n",
+    "$$\n",
+    "\n",
+    "Similarly, the imaginary part can be obtained from Y measurement\n",
+    "$$\n",
+    "\\braket{Y} = \\operatorname{Im} \\braket{\\psi | O | \\phi}.\n",
+    "$$\n",
+    "\n",
+    "Combining these results, the quantity $\\braket{\\psi | O | \\psi}$ is obtained."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Numerical result as a reference: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Psi state:  [0.70710677+0.j 0.        +0.j 0.70710677+0.j 0.        +0.j]\n",
+      "          \n",
+      "q0 : ─────\n",
+      "     ╭───╮\n",
+      "q1 : ┤ h ├\n",
+      "     ╰───╯\n",
+      "\n",
+      "Phi state:  [0.+0.j 1.+0.j 0.+0.j 0.+0.j]\n",
+      "     ╭───╮\n",
+      "q0 : ┤ x ├\n",
+      "     ╰───╯\n",
+      "\n",
+      "hamiltonian:  [[0.+0.j 0.+0.j 0.+0.j 1.+0.j]\n",
+      " [0.+0.j 0.+0.j 1.+0.j 0.+0.j]\n",
+      " [0.+0.j 1.+0.j 0.+0.j 0.+0.j]\n",
+      " [1.+0.j 0.+0.j 0.+0.j 0.+0.j]] \n",
+      "\n",
+      "Numerical expectation value:  (0.7071067690849304+0j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "from functools import reduce\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "import cudaq\n",
+    "\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "\n",
+    "num_qubits = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def psi(num_qubits: int):\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    h(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def phi(num_qubits: int):\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    x(q[0])\n",
+    "\n",
+    "\n",
+    "psi_state = cudaq.get_state(psi, num_qubits)\n",
+    "print(\"Psi state: \", np.array(psi_state))\n",
+    "print(cudaq.draw(psi, 2))\n",
+    "\n",
+    "phi_state = cudaq.get_state(phi, num_qubits)\n",
+    "print(\"Phi state: \", np.array(phi_state))\n",
+    "print(cudaq.draw(phi, 2))\n",
+    "\n",
+    "ham = cudaq.spin.x(0) * cudaq.spin.x(1)\n",
+    "ham_matrix = ham.to_matrix()\n",
+    "print(\"hamiltonian: \", np.array(ham_matrix), \"\\n\")\n",
+    "\n",
+    "ev_numerical = np.array(psi_state).conj() @ ham_matrix @ np.array(phi_state).T\n",
+    "\n",
+    "print(\"Numerical expectation value: \", ev_numerical)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Using ``observe`` algorithmic primitive to compute the expectation value for ancilla qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "QC result: 0.705+-0.007i ± 0.002+0.003i\n",
+      "Numerical result (0.7071067690849304+0j)\n"
+     ]
+    }
+   ],
+   "source": [
+    "@cudaq.kernel\n",
+    "def u_psi(q: cudaq.qview):\n",
+    "    h(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_phi(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def apply_pauli(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "    x(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(num_qubits: int):\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    q = cudaq.qvector(num_qubits)\n",
+    "    h(ancilla)\n",
+    "    cudaq.control(u_phi, ancilla, q)\n",
+    "    cudaq.control(apply_pauli, ancilla, q)\n",
+    "    cudaq.control(u_psi, ancilla, q)\n",
+    "\n",
+    "\n",
+    "num_qubits = 2\n",
+    "shots = 100000\n",
+    "x_0 = cudaq.spin.x(0)\n",
+    "y_0 = cudaq.spin.y(0)\n",
+    "results = cudaq.observe(kernel, [x_0, y_0], num_qubits, shots_count=shots)\n",
+    "evs = np.array([result.expectation() for result in results])\n",
+    "std_errs = np.sqrt((1 - evs**2) / shots)\n",
+    "\n",
+    "print(f\"QC result: {evs[0]:.3f}+{evs[1]:.3f}i ± {std_errs[0]:.3f}+{std_errs[1]:.3f}i\")\n",
+    "print(\"Numerical result\", ev_numerical)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Use multi-GPUs to compute multiple Hadamard test in parallel"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Number of QPUs: 5\n",
+      "angles=array([[1.56322878, 3.09176639],\n",
+      "       [0.04025496, 5.59986135],\n",
+      "       [1.87024074, 0.93078226],\n",
+      "       [4.44015281, 5.05675948],\n",
+      "       [1.92402471, 2.12981374],\n",
+      "       [0.49704605, 3.6020906 ],\n",
+      "       [4.50280746, 2.78988978],\n",
+      "       [4.006956  , 3.7581442 ],\n",
+      "       [3.00524035, 3.10937881],\n",
+      "       [3.13405202, 1.33235091]])\n",
+      "0-th ev=-0.7042075991630554\n",
+      "1-th ev=-0.006743329111486673\n",
+      "2-th ev=-0.36111390590667725\n",
+      "3-th ev=-0.45839524269104004\n",
+      "4-th ev=-0.7175908088684082\n",
+      "5-th ev=-0.23948131501674652\n",
+      "6-th ev=-0.765204668045044\n",
+      "7-th ev=-0.865047037601471\n",
+      "8-th ev=-0.9975475072860718\n",
+      "9-th ev=-0.6179792881011963\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Use multi-QPUs\n",
+    "cudaq.set_target(\"nvidia-mqpu\")\n",
+    "\n",
+    "target = cudaq.get_target()\n",
+    "num_qpus = target.num_qpus()\n",
+    "print(\"Number of QPUs:\", num_qpus)\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_psi(q: cudaq.qview, theta: float):\n",
+    "    ry(theta, q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def u_phi(q: cudaq.qview, theta: float):\n",
+    "    s(q[0])\n",
+    "    rx(theta, q[0])\n",
+    "    s(q[0])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def ham_circuit(q: cudaq.qview):\n",
+    "    x(q[0])\n",
+    "    x(q[1])\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(angle0: float, angle1: float):\n",
+    "    ancilla = cudaq.qubit()\n",
+    "    q = cudaq.qvector(2)\n",
+    "    h(ancilla)\n",
+    "    cudaq.control(u_phi, ancilla, q, angle0)\n",
+    "    cudaq.control(ham_circuit, ancilla, q)\n",
+    "    cudaq.control(u_psi, ancilla, q, angle1)\n",
+    "\n",
+    "\n",
+    "angles = 2 * np.pi * np.random.rand(10, 2)\n",
+    "print(f\"{angles=}\")\n",
+    "\n",
+    "async_results = [\n",
+    "    cudaq.observe_async(\n",
+    "        kernel,\n",
+    "        x_0,\n",
+    "        float(angle[0]),\n",
+    "        float(angle[1]),\n",
+    "        qpu_id=i % num_qpus,\n",
+    "    )\n",
+    "    for i, angle in enumerate(angles)\n",
+    "]\n",
+    "\n",
+    "for i, async_result in enumerate(async_results):\n",
+    "    ev = async_result.get().expectation()\n",
+    "    print(f\"{i}-th {ev=}\")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/hybrid_qnns.ipynb b/pr-2241/sphinx/examples/python/tutorials/hybrid_qnns.ipynb
new file mode 100644
index 0000000000..20181d85ae
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/hybrid_qnns.ipynb
@@ -0,0 +1,487 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Hybrid Quantum Neural Networks\n",
+    "\n",
+    "The example below highlights a hybrid quantum neural network workflow with CUDA-Q and PyTorch where both layers can GPU accelerated to maximise performance."
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "<img src=\"images/hybrid.png\" alt=\"hybrid\" width=\"600\">\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We perform binary classification on the MNIST dataset where data flows through the neural network architecture to the quantum circuit whose output is used to classify hand written digits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install torch==2.2.2\n",
+    "!pip install torchvision==0.17.0\n",
+    "!pip install scikit-learn==1.4.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "\n",
+    "# Import the relevant libraries \n",
+    "\n",
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "import torch\n",
+    "from torch.autograd import Function\n",
+    "from torchvision import datasets, transforms\n",
+    "import torch.optim as optim\n",
+    "import torch.nn as nn\n",
+    "import torchvision\n",
+    "\n",
+    "from sklearn.model_selection import train_test_split\n",
+    "\n",
+    "torch.manual_seed(22)\n",
+    "cudaq.set_random_seed(44)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Set CUDAQ and PyTorch to run on either CPU or GPU.\n",
+    "\n",
+    "device = torch.device('cpu')\n",
+    "cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "#cudaq.set_target(\"nvidia\")\n",
+    "#device = torch.device(\"cuda:0\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def prepare_data(target_digits, sample_count, test_size):\n",
+    "    \"\"\"Load and prepare the MNIST dataset to be used \n",
+    "    \n",
+    "    Args: \n",
+    "        target_digits (list): digits to perform classification of \n",
+    "        sample_count (int): total number of images to be used\n",
+    "        test_size (float): percentage of sample_count to be used as test set, the remainder is the training set\n",
+    "        \n",
+    "    Returns: \n",
+    "        dataset in train, test format with targets \n",
+    "    \n",
+    "    \"\"\"\n",
+    "\n",
+    "    transform = transforms.Compose(\n",
+    "        [transforms.ToTensor(),\n",
+    "         transforms.Normalize((0.1307), (0.3081))])\n",
+    "\n",
+    "    dataset = datasets.MNIST(\"./data\",\n",
+    "                             train=True,\n",
+    "                             download=True,\n",
+    "                             transform=transform)\n",
+    "\n",
+    "    # Filter out the required labels.\n",
+    "    idx = (dataset.targets == target_digits[0]) | (dataset.targets\n",
+    "                                                   == target_digits[1])\n",
+    "    dataset.data = dataset.data[idx]\n",
+    "    dataset.targets = dataset.targets[idx]\n",
+    "\n",
+    "    # Select a subset based on number of datapoints specified by sample_count.\n",
+    "    subset_indices = torch.randperm(dataset.data.size(0))[:sample_count]\n",
+    "\n",
+    "    x = dataset.data[subset_indices].float().unsqueeze(1).to(device)\n",
+    "\n",
+    "    y = dataset.targets[subset_indices].to(device).float().to(device)\n",
+    "\n",
+    "    # Relabel the targets as a 0 or a 1.\n",
+    "    y = torch.where(y == min(target_digits), 0.0, 1.0)\n",
+    "\n",
+    "    x_train, x_test, y_train, y_test = train_test_split(x,\n",
+    "                                                        y,\n",
+    "                                                        test_size=test_size /\n",
+    "                                                        100,\n",
+    "                                                        shuffle=True,\n",
+    "                                                        random_state=42)\n",
+    "\n",
+    "    return x_train, x_test, y_train, y_test"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Classical parameters.\n",
+    "\n",
+    "sample_count = 1000  # Total number of images to use.\n",
+    "target_digits = [5, 6]  # Hand written digits to classify.\n",
+    "test_size = 30  # Percentage of dataset to be used for testing.\n",
+    "classification_threshold = 0.5  # Classification boundary used to measure accuracy.\n",
+    "epochs = 1000  # Number of epochs to train for.\n",
+    "\n",
+    "# Quantum parmeters.\n",
+    "\n",
+    "qubit_count = 1\n",
+    "hamiltonian = spin.z(0)  # Measurement operator.\n",
+    "shift = torch.tensor(torch.pi / 2)  # Magnitude of parameter shift."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "x_train, x_test, y_train, y_test = prepare_data(target_digits, sample_count,\n",
+    "                                                test_size)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Plot some images from the training set to visualise.\n",
+    "if device != 'cpu':\n",
+    "    sample_to_plot = x_train[:10].to(torch.device('cpu'))\n",
+    "else:\n",
+    "    sample_to_plot = x_train[:10]\n",
+    "    \n",
+    "grid_img = torchvision.utils.make_grid(sample_to_plot,\n",
+    "                                       nrow=5,\n",
+    "                                       padding=3,\n",
+    "                                       normalize=True)\n",
+    "plt.imshow(grid_img.permute(1, 2, 0))\n",
+    "plt.axis('off')\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class QuantumFunction(Function):\n",
+    "    \"\"\"Allows the quantum circuit to input data, output expectation values \n",
+    "    and calculate gradients of variational parameters via finite difference\"\"\"\n",
+    "\n",
+    "    def __init__(self, qubit_count: int, hamiltonian: cudaq.SpinOperator):\n",
+    "        \"\"\"Define the quantum circuit in CUDA Quantum\"\"\"\n",
+    "\n",
+    "        @cudaq.kernel\n",
+    "        def kernel(qubit_count: int, thetas: np.ndarray):\n",
+    "\n",
+    "            qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "            ry(thetas[0], qubits[0])\n",
+    "            rx(thetas[1], qubits[0])\n",
+    "\n",
+    "        self.kernel = kernel\n",
+    "        self.qubit_count = qubit_count\n",
+    "        self.hamiltonian = hamiltonian\n",
+    "\n",
+    "    def run(self, theta_vals: torch.tensor) -> torch.tensor:\n",
+    "        \"\"\"Excetute the quantum circuit to output an expectation value\"\"\"\n",
+    "\n",
+    "        #If running on GPU, thetas is a torch.tensor that will live on GPU memory. The observe function calls a .tolist() method on inputs which moves thetas from GPU to CPU.\n",
+    "\n",
+    "        qubit_count = [self.qubit_count for _ in range(theta_vals.shape[0])]\n",
+    "\n",
+    "        results = cudaq.observe(self.kernel, self.hamiltonian, qubit_count,\n",
+    "                                theta_vals)\n",
+    "\n",
+    "        exp_vals = [results[i].expectation() for i in range(len(results))]\n",
+    "        exp_vals = torch.Tensor(exp_vals).to(device)\n",
+    "\n",
+    "        return exp_vals\n",
+    "\n",
+    "    @staticmethod\n",
+    "    def forward(ctx, thetas: torch.tensor, quantum_circuit,\n",
+    "                shift) -> torch.tensor:\n",
+    "\n",
+    "        # Save shift and quantum_circuit in context to use in backward.\n",
+    "        ctx.shift = shift\n",
+    "        ctx.quantum_circuit = quantum_circuit\n",
+    "\n",
+    "        # Calculate expectation value.\n",
+    "        exp_vals = ctx.quantum_circuit.run(thetas).reshape(-1, 1)\n",
+    "\n",
+    "        ctx.save_for_backward(thetas, exp_vals)\n",
+    "\n",
+    "        return exp_vals\n",
+    "\n",
+    "    @staticmethod\n",
+    "    def backward(ctx, grad_output):\n",
+    "        \"\"\"Backward pass computation via finite difference\"\"\"\n",
+    "\n",
+    "        thetas, _ = ctx.saved_tensors\n",
+    "\n",
+    "        gradients = torch.zeros(thetas.shape, device=device)\n",
+    "\n",
+    "        for i in range(thetas.shape[1]):\n",
+    "\n",
+    "            thetas_plus = thetas.clone()\n",
+    "            thetas_plus[:, i] += ctx.shift\n",
+    "            exp_vals_plus = ctx.quantum_circuit.run(thetas_plus)\n",
+    "\n",
+    "            thetas_minus = thetas.clone()\n",
+    "            thetas_minus[:, i] -= ctx.shift\n",
+    "            exp_vals_minus = ctx.quantum_circuit.run(thetas_minus)\n",
+    "\n",
+    "            gradients[:, i] = (exp_vals_plus - exp_vals_minus) / (2 * ctx.shift)\n",
+    "\n",
+    "        gradients = torch.mul(grad_output, gradients)\n",
+    "\n",
+    "        return gradients, None, None"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class QuantumLayer(nn.Module):\n",
+    "    \"\"\"Encapsulates a quantum circuit into a quantum layer adhering PyTorch convention\"\"\"\n",
+    "\n",
+    "    def __init__(self, qubit_count: int, hamiltonian, shift: torch.tensor):\n",
+    "        super(QuantumLayer, self).__init__()\n",
+    "\n",
+    "        self.quantum_circuit = QuantumFunction(qubit_count, hamiltonian)\n",
+    "        self.shift = shift\n",
+    "\n",
+    "    def forward(self, input):\n",
+    "\n",
+    "        result = QuantumFunction.apply(input, self.quantum_circuit, self.shift)\n",
+    "\n",
+    "        return result"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "class Hybrid_QNN(nn.Module):\n",
+    "    \"\"\"Structure of the hybrid neural network with classical fully connected layers and quantum layers\"\"\"\n",
+    "\n",
+    "    def __init__(self):\n",
+    "        super(Hybrid_QNN, self).__init__()\n",
+    "\n",
+    "        self.fc1 = nn.Linear(28 * 28, 256)\n",
+    "        self.fc2 = nn.Linear(256, 128)\n",
+    "        self.dropout = nn.Dropout(0.25)\n",
+    "\n",
+    "        self.fc3 = nn.Linear(128, 64)\n",
+    "        self.fc4 = nn.Linear(64, 32)\n",
+    "        self.fc5 = nn.Linear(32, 2)\n",
+    "        self.dropout = nn.Dropout(0.25)\n",
+    "\n",
+    "        # The 2 outputs from PyTorch fc5 layer feed into the 2 variational gates in the quantum circuit.\n",
+    "        self.quantum = QuantumLayer(qubit_count, hamiltonian, shift)\n",
+    "\n",
+    "    def forward(self, x):\n",
+    "\n",
+    "        x = x.view(-1, 28 * 28)  # Turns images into vectors.\n",
+    "\n",
+    "        x = torch.relu(self.fc1(x))\n",
+    "        x = torch.relu(self.fc2(x))\n",
+    "        x = self.dropout(x)\n",
+    "\n",
+    "        x = torch.relu(self.fc3(x))\n",
+    "        x = torch.relu(self.fc4(x))\n",
+    "        x = torch.relu(self.fc5(x))\n",
+    "        x = self.dropout(x)\n",
+    "\n",
+    "        # Quantum circuit outputs an expectation value which is fed into the sigmoid activation function to perform classification.\n",
+    "        x = torch.sigmoid(self.quantum(x))\n",
+    "\n",
+    "        return x.view(-1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def accuracy_score(y, y_hat):\n",
+    "    return sum((y == (y_hat >= classification_threshold))) / len(y)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "hybrid_model = Hybrid_QNN().to(device)\n",
+    "\n",
+    "optimizer = optim.Adadelta(hybrid_model.parameters(),\n",
+    "                           lr=0.001,\n",
+    "                           weight_decay=0.8)\n",
+    "\n",
+    "loss_function = nn.BCELoss().to(device)\n",
+    "\n",
+    "training_cost = []\n",
+    "testing_cost = []\n",
+    "training_accuracy = []\n",
+    "testing_accuracy = []\n",
+    "\n",
+    "hybrid_model.train()\n",
+    "for epoch in range(epochs):\n",
+    "\n",
+    "    optimizer.zero_grad()\n",
+    "\n",
+    "    y_hat_train = hybrid_model(x_train).to(device)\n",
+    "\n",
+    "    train_cost = loss_function(y_hat_train, y_train).to(device)\n",
+    "\n",
+    "    train_cost.backward()\n",
+    "\n",
+    "    optimizer.step()\n",
+    "\n",
+    "    training_accuracy.append(accuracy_score(y_train, y_hat_train))\n",
+    "    training_cost.append(train_cost.item())\n",
+    "\n",
+    "    hybrid_model.eval()\n",
+    "    with torch.no_grad():\n",
+    "\n",
+    "        y_hat_test = hybrid_model(x_test).to(device)\n",
+    "\n",
+    "        test_cost = loss_function(y_hat_test, y_test).to(device)\n",
+    "\n",
+    "        testing_accuracy.append(accuracy_score(y_test, y_hat_test))\n",
+    "        testing_cost.append(test_cost.item())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA9wAAAHpCAYAAABweDQqAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAACj50lEQVR4nOzdd3hUVf7H8ffMpAeSkF4IJKGETiBAqNZAEBfFihVFRX8sroVVVyxgW7GyrMouiuCirgvKWtgVsQRBkSoR6SW0hJJOEhJIm5nfHwODWQIkIclN+bye5z4zc+beO5+ZnXX45px7jslut9sRERERERERkTplNjqAiIiIiIiISHOkgltERERERESkHqjgFhEREREREakHKrhFRERERERE6oEKbhEREREREZF6oIJbREREREREpB6o4BYRERERERGpByq4RUREREREROqBCm4RERERERGReqCCW0RERERERKQeGF5wz5o1i6ioKDw8PEhISGDdunXn3H/mzJnExsbi6elJZGQkDz/8MCUlJRd0ThEREREREZG65mLkiy9cuJDJkycze/ZsEhISmDlzJklJSezcuZPg4OAz9v/oo494/PHHmTdvHoMHD2bXrl3ceeedmEwmZsyYUatzVsVms3H48GFat26NyWSq0/csIiJSXXa7nWPHjhEeHo7ZbPjfyA2n32cREWkMavT7bDfQgAED7JMmTXI+tlqt9vDwcPv06dOr3H/SpEn2yy67rFLb5MmT7UOGDKn1OauSnp5uB7Rp06ZNm7ZGsaWnp1f7N6w50++zNm3atGlrTFt1fp8N6+EuKytjw4YNTJkyxdlmNptJTExk9erVVR4zePBgPvzwQ9atW8eAAQPYu3cvS5Ys4fbbb6/1OQFKS0spLS11Prbb7QCkp6fj4+NzQe9TRESktgoLC4mMjKR169ZGR2kUTn0O+n0WEREj1eT32bCCOycnB6vVSkhISKX2kJAQduzYUeUxt9xyCzk5OQwdOhS73U5FRQX/93//xxNPPFHrcwJMnz6dZ5999ox2Hx8f/aCLiIjhNHza4dTnoN9nERFpDKrz+9ykLghbvnw5L774In/7299ISUnh008/5csvv+T555+/oPNOmTKFgoIC55aenl5HiUVERERERKSlMqyHOzAwEIvFQmZmZqX2zMxMQkNDqzzm6aef5vbbb+eee+4BoGfP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MBqN4plnnvG06c8xczgc4sCBA+LAgQMCgHjttdfEgQMHRH5+vhCia2Jjs9mEyWQSs2bNEkePHhUbNmwQWq2W04J1A+bnVszRV4/5uWPMz75jfr603pifWXD72ZtvvikSEhKEUqkUEydOFDt37gx0l7odgHaX999/39Omrq5OPPbYYyI8PFxotVpx5513iuLiYq/jnD17VkyfPl1oNBphNBrFk08+KRobG7v5bALn4oTOmHn74osvxMiRI4VKpRJDhw4V77zzjtd+t9stli5dKkwmk1CpVGLatGkiNzfXq015ebm4//77RWhoqNDpdGL27NnC4XB052l0G7vdLhYuXCgSEhKEWq0WgwYNEs8//7zXFBj9OWbfffdduz+3srKyhBBdF5tDhw6JKVOmCJVKJeLi4sSqVau66xT7PeZnCXP01WN+vjTmZ98wP19ab8zPMiGE8H1cnIiIiIiIiIguhfdwExEREREREfkBC24iIiIiIiIiP2DBTUREREREROQHLLiJiIiIiIiI/IAFNxEREREREZEfsOAmIiIiIiIi8gMW3ERERERERER+wIKbiIiIiIiIyA9YcBNRwMlkMmzatCnQ3SAiIqILMD8TXT0W3ET93EMPPQSZTNZmueWWWwLdNSIion6L+ZmobwgKdAeIKPBuueUWvP/++17bVCpVgHpDREREAPMzUV/AEW4igkqlgtls9lrCw8MBSJeTrV27FtOnT4dGo8GgQYPwz3/+0+vzR44cwS9+8QtoNBpERkZizpw5qK6u9mqzbt06jBgxAiqVCjExMViwYIHX/rKyMtx5553QarVITk7G559/7tlXWVmJzMxMREVFQaPRIDk5uc0vIERERH0N8zNR78eCm4gua+nSpZg5cyYOHTqEzMxM3HfffcjJyQEA1NTUICMjA+Hh4dizZw82btyIb775xithr127FvPnz8ecOXNw5MgRfP755xg8eLDX13jppZdwzz334PDhw7j11luRmZmJiooKz9c/fvw4Nm/ejJycHKxduxZGo7H7AkBERNQDMT8T9QKCiPq1rKwsoVAoREhIiNeyYsUKIYQQAMTcuXO9PpOamirmzZsnhBDinXfeEeHh4aK6utqz/1//+peQy+XCYrEIIYSIjY0Vzz//fId9ACBeeOEFz/vq6moBQGzevFkIIcTtt98uZs+e3TUnTERE1AswPxP1DbyHm4hw0003Ye3atV7bIiIiPOtpaWle+9LS0nDw4EEAQE5ODsaMGYOQkBDP/smTJ8PtdiM3NxcymQxFRUWYNm3aJfswevRoz3pISAh0Oh1KSkoAAPPmzcPMmTOxf/9+3HzzzZgxYwYmTZp0RedKRETUWzA/E/V+LLiJCCEhIW0uIesqGo2mU+2Cg4O93stkMrjdbgDA9OnTkZ+fj6+++gpbt27FtGnTMH/+fPzpT3/q8v4SERH1FMzPRL0f7+EmosvauXNnm/fDhg0DAAwbNgyHDh1CTU2NZ/9PP/0EuVyOIUOGICwsDImJicjOzr6qPkRFRSErKwsffvghVq9ejXfeeeeqjkdERNTbMT8T9Xwc4SYiOJ1OWCwWr21BQUGeB59s3LgRKSkpmDJlCj766CPs3r0b7733HgAgMzMTy5cvR1ZWFl588UWUlpbi8ccfx6xZs2AymQAAL774IubOnYvo6GhMnz4dDocDP/30Ex5//PFO9W/ZsmUYP348RowYAafTiS+//NLzCwUREVFfxfxM1Pux4CYibNmyBTExMV7bhgwZghMnTgCQnlC6YcMGPPbYY4iJicH69esxfPhwAIBWq8XXX3+NhQsXYsKECdBqtZg5cyZee+01z7GysrJQX1+PP//5z3jqqadgNBpx1113dbp/SqUSS5YswdmzZ6HRaDB16lRs2LChC86ciIio52J+Jur9ZEIIEehOEFHPJZPJ8Omnn2LGjBmB7goRERE1Y34m6h14DzcRERERERGRH7DgJiIiIiIiIvIDXlJORERERERE5Acc4SYiIiIiIiLyAxbcRERERERERH7AgpuIiIiIiIjID1hwExEREREREfkBC24iIiIiIiIiP2DBTUREREREROQHLLiJiIiIiIiI/IAFNxEREREREZEf/H8rxRwfOwOqAAAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 1000x500 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.figure(figsize=(10, 5))\n",
+    "\n",
+    "plt.subplot(1, 2, 1)\n",
+    "plt.plot(training_cost, label='Train')\n",
+    "plt.plot(testing_cost, label='Test')\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Cost')\n",
+    "plt.legend()\n",
+    "\n",
+    "plt.subplot(1, 2, 2)\n",
+    "plt.plot(training_accuracy, label='Train')\n",
+    "plt.plot(testing_accuracy, label='Test')\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Accuracy')\n",
+    "plt.legend()\n",
+    "\n",
+    "plt.tight_layout()\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/Bloch_sphere.png b/pr-2241/sphinx/examples/python/tutorials/images/Bloch_sphere.png
new file mode 100644
index 0000000000..36d9e393c1
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/Bloch_sphere.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/automatic_batching.png b/pr-2241/sphinx/examples/python/tutorials/images/automatic_batching.png
new file mode 100644
index 0000000000..920d187fdc
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/automatic_batching.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/circsplit.png b/pr-2241/sphinx/examples/python/tutorials/images/circsplit.png
new file mode 100644
index 0000000000..785dda635b
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/circsplit.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/circuit_encoding.png b/pr-2241/sphinx/examples/python/tutorials/images/circuit_encoding.png
new file mode 100644
index 0000000000..20a889f9e6
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/circuit_encoding.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/circuit_pdf.png b/pr-2241/sphinx/examples/python/tutorials/images/circuit_pdf.png
new file mode 100644
index 0000000000..b5c85f495d
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/circuit_pdf.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/deutsch.png b/pr-2241/sphinx/examples/python/tutorials/images/deutsch.png
new file mode 100644
index 0000000000..6790e19328
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/deutsch.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/hsplit.png b/pr-2241/sphinx/examples/python/tutorials/images/hsplit.png
new file mode 100644
index 0000000000..b07d4a7e9a
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/hsplit.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/hybrid.png b/pr-2241/sphinx/examples/python/tutorials/images/hybrid.png
new file mode 100644
index 0000000000..1357c39c96
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/hybrid.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/inverse_qft.png b/pr-2241/sphinx/examples/python/tutorials/images/inverse_qft.png
new file mode 100644
index 0000000000..1a31e0cd12
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/inverse_qft.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/max-cut-illustration.png b/pr-2241/sphinx/examples/python/tutorials/images/max-cut-illustration.png
new file mode 100644
index 0000000000..ad2760b46f
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/max-cut-illustration.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/oracle.png b/pr-2241/sphinx/examples/python/tutorials/images/oracle.png
new file mode 100644
index 0000000000..b29f12bd4c
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/oracle.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/pipeline_simplified.png b/pr-2241/sphinx/examples/python/tutorials/images/pipeline_simplified.png
new file mode 100644
index 0000000000..206be3f032
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/pipeline_simplified.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/qaoa-circuit-layers.png b/pr-2241/sphinx/examples/python/tutorials/images/qaoa-circuit-layers.png
new file mode 100644
index 0000000000..52671468c6
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/qaoa-circuit-layers.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/qaoa-problem-kernel.png b/pr-2241/sphinx/examples/python/tutorials/images/qaoa-problem-kernel.png
new file mode 100644
index 0000000000..c6ccd197df
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/qaoa-problem-kernel.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/qft.png b/pr-2241/sphinx/examples/python/tutorials/images/qft.png
new file mode 100644
index 0000000000..4fde4eeda5
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/qft.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/images/shor_circuit.png b/pr-2241/sphinx/examples/python/tutorials/images/shor_circuit.png
new file mode 100644
index 0000000000..f6d284ebda
Binary files /dev/null and b/pr-2241/sphinx/examples/python/tutorials/images/shor_circuit.png differ
diff --git a/pr-2241/sphinx/examples/python/tutorials/maximum_vertex_weight_clique.ipynb b/pr-2241/sphinx/examples/python/tutorials/maximum_vertex_weight_clique.ipynb
new file mode 100644
index 0000000000..1b25ce1f3f
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/maximum_vertex_weight_clique.ipynb
@@ -0,0 +1,325 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Molecular docking via DC-QAOA\n",
+    "\n",
+    "The data of the clique graph for the molecular docking are taken from this [paper](https://arxiv.org/pdf/2308.04098)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "import numpy as np\n",
+    "\n",
+    "# GPU: Default If an NVIDIA GPU and CUDA runtime libraries are available\n",
+    "#cudaq.set_target('nvidia')\n",
+    "\n",
+    "# CPU\n",
+    "cudaq.set_target('qpp-cpu')\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Edges:  [[0, 1], [0, 2], [0, 4], [0, 5], [1, 2], [1, 3], [1, 5], [2, 3], [2, 4], [3, 4], [3, 5], [4, 5]]\n",
+      "Non-Edges:  [[0, 3], [1, 4], [2, 5]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# The two graphs input from the paper\n",
+    "\n",
+    "# BIG 1\n",
+    "\n",
+    "nodes = [0,1,2,3,4,5]\n",
+    "qubit_num=len(nodes)\n",
+    "edges = [[0,1],[0,2],[0,4],[0,5],[1,2],[1,3],[1,5],[2,3],[2,4],[3,4],[3,5],[4,5]]\n",
+    "non_edges = [[u,v] for u in nodes for v in nodes if u<v and [u,v] not in edges]\n",
+    "print('Edges: ', edges)\n",
+    "print('Non-Edges: ', non_edges)\n",
+    "weights = [0.6686,0.6686,0.6686,0.1453,0.1453,0.1453]\n",
+    "penalty = 6.0\n",
+    "num_layers = 3\n",
+    "\n",
+    "# BIG 2 (More expensive simulation)\n",
+    "\n",
+    "#nodes=[0,1,2,3,4,5,6,7]\n",
+    "#qubit_num=len(nodes)\n",
+    "#edges=[[0,1],[0,2],[0,5],[0,6],[0,7],[1,2],[1,4],[1,6],[1,7],[2,4],[2,5],[2,7],[3,4],[3,5],[3,6],\\\n",
+    "#    [4,5],[4,6],[5,6]]\n",
+    "#non_edges=[[u,v] for u in nodes for v in nodes if u<v and [u,v] not in edges]\n",
+    "#print('Edges: ', edges)\n",
+    "#print('Non-edges: ', non_edges)\n",
+    "#weights=[0.6686,0.6686,0.6886,0.1091,0.0770,0.0770,0.0770,0.0770]\n",
+    "#penalty=8.0\n",
+    "#num_layers=8"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Generate the Hamiltonian\n",
+    "def ham_clique(penalty, nodes, weights, non_edges)-> cudaq.SpinOperator:\n",
+    "    \n",
+    "    spin_ham = 0.0\n",
+    "    for wt,node in zip(weights,nodes):\n",
+    "        #print(wt,node)\n",
+    "        spin_ham += 0.5 * wt * spin.z(node)\n",
+    "        spin_ham -= 0.5 * wt * spin.i(node)\n",
+    "    \n",
+    "    for non_edge in non_edges:\n",
+    "        u,v=(non_edge[0],non_edge[1])\n",
+    "        #print(u,v)\n",
+    "        spin_ham += penalty/4.0 * (spin.z(u)*spin.z(v)-spin.z(u)-spin.z(v)+spin.i(u)*spin.i(v))\n",
+    "    \n",
+    "    return spin_ham   "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Collect coefficients from a spin operator so we can pass them to a kernel\n",
+    "def term_coefficients(ham: cudaq.SpinOperator) -> list[complex]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.get_coefficient()))\n",
+    "    return result\n",
+    "\n",
+    "    # Collect Pauli words from a spin operator so we can pass them to a kernel\n",
+    "def term_words(ham: cudaq.SpinOperator) -> list[str]:\n",
+    "    result = []\n",
+    "    ham.for_each_term(lambda term: result.append(term.to_string(False)))\n",
+    "    return result\n",
+    "    "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def dc_qaoa(qubit_num:int, num_layers:int,thetas:list[float],\\\n",
+    "    coef:list[complex], words:list[cudaq.pauli_word]):\n",
+    "    \n",
+    "    qubits=cudaq.qvector(qubit_num)\n",
+    "    \n",
+    "    h(qubits)\n",
+    "    \n",
+    "    count=0\n",
+    "    for p in range(num_layers):\n",
+    "        \n",
+    "        for i in range(len(coef)):\n",
+    "            exp_pauli(thetas[count]*coef[i].real,qubits,words[i])\n",
+    "            count+=1\n",
+    "        \n",
+    "        for j in range(qubit_num):\n",
+    "            rx(thetas[count],qubits[j])\n",
+    "            count+=1 \n",
+    "        \n",
+    "        for k in range(qubit_num):\n",
+    "            ry(thetas[count],qubits[k])\n",
+    "            count+=1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[1.5+0j] IIZIIZ\n",
+      "[1.5+0j] ZIIZII\n",
+      "[-1.1657+0j] IZIIII\n",
+      "[1.5+0j] IZIIZI\n",
+      "[-1.42735+0j] IIIZII\n",
+      "[3.2791499999999996+0j] IIIIII\n",
+      "[-1.1657+0j] IIZIII\n",
+      "[-1.42735+0j] IIIIIZ\n",
+      "[-1.1657+0j] ZIIIII\n",
+      "[-1.42735+0j] IIIIZI\n",
+      "\n",
+      "[(1.5+0j), (1.5+0j), (-1.1657+0j), (1.5+0j), (-1.42735+0j), (3.2791499999999996+0j), (-1.1657+0j), (-1.42735+0j), (-1.1657+0j), (-1.42735+0j)]\n",
+      "['IIZIIZ', 'ZIIZII', 'IZIIII', 'IZIIZI', 'IIIZII', 'IIIIII', 'IIZIII', 'IIIIIZ', 'ZIIIII', 'IIIIZI']\n"
+     ]
+    }
+   ],
+   "source": [
+    "ham= ham_clique(penalty,nodes,weights,non_edges)\n",
+    "print(ham)\n",
+    "\n",
+    "coef=term_coefficients(ham)\n",
+    "words=term_words(ham)\n",
+    "\n",
+    "print(term_coefficients(ham))\n",
+    "print(term_words(ham))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Total number of parameters:  66\n",
+      "Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064, 0.37118004688049144, -0.03656087558321203, 0.08564174998504231, 0.21639801853794682, 0.11122286088634259, 0.1743727097033635, -0.36518146001762486, -0.15829741539542244, -0.3467434780387345, 0.28043500852894776, -0.09986021299050934, 0.14125225086023052, -0.19141728018199775, -0.11970943368650361, -0.3853063093646483, -0.1112643868789806, 0.3527177454825464, -0.22156160012057186, -0.1418496891385843, 0.32811766468303116, -0.367642000671186, -0.34158180583996006, 0.10196745745501312, 0.29359239180502594, -0.3858537615546677, 0.19366130907065582, 0.24570488114056754, -0.3332307385378807, 0.12287973244618389, 0.007274514934614895, -0.015799547372526146, 0.3578070967202224, -0.39268963055535144, -0.19872246354138554, 0.16668715544467982, -0.13777293592446055, -0.17514665212709513, 0.15350249947988204, 0.32872977428061945, -0.20068831419712105, -0.032919322131134854, -0.19399909325771983, -0.09477141125241506, 0.08210460401106645, 0.21392577760158515, -0.3393568044538389, 0.14615087942938465, 0.03790339186006314, -0.2843250892879255, -0.3151384847055956, -0.19983741137121905, -0.27348611567665115, 0.33457528180906904, 0.14145414847455462, -0.20604220093940323, 0.05410235084309195, 0.04447870918600966, -0.3355714098595045, 0.266806440171265, -0.07436189654442632, -0.2789176729721685, -0.2427508182662484]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Optimizer\n",
+    "\n",
+    "# Specify the optimizer and its initial parameters.\n",
+    "optimizer = cudaq.optimizers.NelderMead()\n",
+    "#optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "np.random.seed(13)\n",
+    "cudaq.set_random_seed(13)\n",
+    "\n",
+    "# if dc_qaoa used\n",
+    "parameter_count=(2*qubit_num+len(coef))*num_layers\n",
+    "\n",
+    "# if qaoa used\n",
+    "# parameter_count=(qubit_num+len(coef))*num_layers\n",
+    "\n",
+    "print('Total number of parameters: ', parameter_count)\n",
+    "optimizer.initial_parameters = np.random.uniform(-np.pi/8 , np.pi/8 ,parameter_count)\n",
+    "print(\"Initial parameters = \", optimizer.initial_parameters)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "optimal_expectation = -2.0057970170760537\n",
+      "optimal_parameters = [2.0617900450255213, -0.008832997414504553, 0.5446745231437978, 0.9170743966952536, 0.5684145055308018, 0.45653992738579674, 0.48765328828009236, 0.08690545932812363, 0.4396413285058074, 0.18459993158979182, -1.309747594917737, 1.2588385005776594, -0.834255663515425, 0.674712608431175, -0.40174553656823186, 0.1936475123928361, 0.11292461472367524, -0.40520422214477836, 0.5249647407525035, -0.8276837818165452, 0.2945660883282474, -0.8060498989662159, 0.08051672267342141, 0.016438756265571293, 1.5245041151262497, 1.4087477995498743, 0.24688680789607903, 2.1121838066265077, 1.1445970943333728, -0.22281558391261153, 0.29034932090910637, -1.0492037973620043, 0.2734013684834806, 0.5265417924961102, 0.5099056677967553, 0.8636684922225737, -0.6164906874232119, -0.42851259141848624, 0.09675272347583658, 0.05697275350531247, -0.7102412317670379, -0.11174687408874051, 0.32505750242276577, -0.4397450017834574, -0.023604090020531092, 2.072436348972407, -0.38357054930488194, 0.13613334013073858, -0.10505045798768743, 2.0359359294549595, -0.24377425227508304, 0.10609870738840588, -0.2073332743736556, 0.07232539343493427, -0.6190529241716675, -0.03799182564866846, 0.17548654124993912, 0.5257077568577536, -0.23376653076971432, 0.3391308272563698, 0.4193139961661264, 0.02390444901420668, 0.2521154835623746, 1.1843328649807838, -0.6609672889772077, -0.2612231428844001]\n"
+     ]
+    }
+   ],
+   "source": [
+    "cost_values=[]\n",
+    "def objective(parameters):\n",
+    "\n",
+    "    cost=cudaq.observe(dc_qaoa, ham, qubit_num, num_layers, parameters,coef,words).expectation()\n",
+    "    cost_values.append(cost)\n",
+    "    return cost\n",
+    "\n",
+    "# Optimize!\n",
+    "optimal_expectation, optimal_parameters = optimizer.optimize(\n",
+    "    dimensions=parameter_count, function=objective)\n",
+    "\n",
+    "print('optimal_expectation =', optimal_expectation)\n",
+    "print('optimal_parameters =', optimal_parameters)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 111000:200000 }\n",
+      "\n",
+      "The MVWCP is given by the partition:  111000\n",
+      "The MVWCP is given by the partition:  111000\n"
+     ]
+    }
+   ],
+   "source": [
+    "shots=200000\n",
+    "\n",
+    "counts = cudaq.sample(dc_qaoa, qubit_num, num_layers, optimal_parameters,coef,words, shots_count=shots)\n",
+    "print(counts)\n",
+    "\n",
+    "print('The MVWCP is given by the partition: ', max(counts, key=lambda x: counts[x]))\n",
+    "\n",
+    "# Alternative\n",
+    "print('The MVWCP is given by the partition: ', counts.most_probable())"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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17/+VZGRkUpISCg3c1GnTh01b97ca1mzZs20f/9+SRf25Up/H2rXrq2srCyv9efOndOxY8f8mi+7jRkzxnP0qFWrVho0aJB+//vfe44ulqe5sArlfl9uTGmcl/PF6Mcff9TSpUs9R42k8jMfX331lbKyspScnOz5t/THH3/U448/rvr160sqXXNBOSqBqKgotW/fXsuWLfMsc7vdWrZsmTp16mRjspIxxmjEiBGaP3++li9frgYNGnitb9++vSpUqOC137t379b+/fs9+92pUydt27bN6w/6+X8Uzv+C7dSpk9c2zo8pTXPXvXt3bdu2TWlpaZ5Hhw4dNHDgQM/P5WUuunTpctEtHb799ltdddVVkqQGDRqodu3aXvuRk5Ojb775xmsuTpw4odTUVM+Y5cuXy+12q2PHjp4xq1evVkFBgWfM0qVL1aRJE1WtWjVo++eP06dPy+n0/uczIiJCbrdbUvmaC6tQ7nc4/J2RLhSj7777Tl9++aWqV6/utb68zMegQYO0detWr39LExMTNWbMGC1ZskRSKZsLn0/dxiXNmTPHuFwuM3v2bLNjxw7z8MMPmypVqnhdmRRuhg0bZuLj483KlSvNoUOHPI/Tp097xgwdOtQkJyeb5cuXm40bN5pOnTqZTp06edafv3y9Z8+eJi0tzSxevNjUrFnzkpevjxkzxuzcudNMnz691F2+finWq9WMKT9zsX79ehMZGWmmTJlivvvuO/Pee++ZmJgY889//tMzZtq0aaZKlSrm008/NVu3bjV33HHHJS/jbtu2rfnmm2/M119/bRo3bux1qe6JEydMQkKCGTRokElPTzdz5swxMTExpepS/pSUFFO3bl3Ppfzz5s0zNWrUME888YRnTFmdi5MnT5rNmzebzZs3G0nmpZdeMps3b/ZcfRWq/V6zZo2JjIw0L774otm5c6eZNGmSLZfyX2k+8vPzza9//WtTr149k5aW5vXvqfVqq7IyH0X92filX16tZkzpmQvKUQC89tprJjk52URFRZnrr7/erFu3zu5IJSLpko933nnHM+bMmTPmd7/7nalataqJiYkxd955pzl06JDXdn744QfTu3dvEx0dbWrUqGEef/xxU1BQ4DVmxYoV5tprrzVRUVGmYcOGXu9RWv2yHJWnufj8889Ny5YtjcvlMk2bNjVvvfWW13q3220mTJhgEhISjMvlMt27dze7d+/2GvPTTz+Z++67z1SuXNnExcWZBx980Jw8edJrzJYtW8yNN95oXC6XqVu3rpk2bVrQ980fOTk5ZuTIkSY5OdlUrFjRNGzY0IwbN87rF15ZnYsVK1Zc8t+HlJQUY0xo9/ujjz4y11xzjYmKijItWrQwCxYsCNp+X86V5mPfvn2X/fd0xYoVnm2Ulfko6s/GL12qHJWWuXAYY7mlKwAAQDnHOUcAAAAWlCMAAAALyhEAAIAF5QgAAMCCcgQAAGBBOQIAALCgHAEAAFhQjgAAACwoRwDKFYfDoU8++cTuGABKMcoRgJAZPHiwHA7HRY/bbrvN7mgA4BFpdwAA5cttt92md955x2uZy+WyKQ0AXIwjRwBCyuVyqXbt2l6PqlWrSvr5I68ZM2aod+/eio6OVsOGDfXxxx97vX7btm3q1q2boqOjVb16dT388MPKzc31GjNr1iy1aNFCLpdLderU0YgRI7zWHz16VHfeeadiYmLUuHFjffbZZ551x48f18CBA1WzZk1FR0ercePGF5U5AGUb5QhAqTJhwgTdfffd2rJliwYOHKh7771XO3fulCSdOnVKvXr1UtWqVbVhwwbNnTtXX375pVf5mTFjhoYPH66HH35Y27Zt02effaZGjRp5vcfkyZN1zz33aOvWrerTp48GDhyoY8eOed5/x44dWrRokXbu3KkZM2aoRo0aoZsAAPYzABAiKSkpJiIiwlSqVMnrMWXKFGOMMZLM0KFDvV7TsWNHM2zYMGOMMW+99ZapWrWqyc3N9axfsGCBcTqdJjMz0xhjTGJiohk3btxlM0gy48eP9zzPzc01ksyiRYuMMcb069fPPPjgg4HZYQBhiXOOAIRU165dNWPGDK9l1apV8/zcqVMnr3WdOnVSWlqaJGnnzp1q06aNKlWq5FnfpUsXud1u7d69Ww6HQwcPHlT37t2vmKF169aenytVqqS4uDhlZWVJkoYNG6a7775bmzZtUs+ePdW/f3917ty5WPsKIDxRjgCEVKVKlS76mCtQoqOjfRpXoUIFr+cOh0Nut1uS1Lt3b/34449auHChli5dqu7du2v48OF68cUXA54XQOnEOUcASpV169Zd9LxZs2aSpGbNmmnLli06deqUZ/2aNWvkdDrVpEkTxcbGqn79+lq2bFmJMtSsWVMpKSn65z//qVdeeUVvvfVWibYHILxw5AhASOXl5SkzM9NrWWRkpOek57lz56pDhw668cYb9d5772n9+vV6++23JUkDBw7UpEmTlJKSoqefflpHjhzRo48+qkGDBikhIUGS9PTTT2vo0KGqVauWevfurZMnT2rNmjV69NFHfco3ceJEtW/fXi1atFBeXp6++OILTzkDUD5QjgCE1OLFi1WnTh2vZU2aNNGuXbsk/Xwl2Zw5c/S73/1OderU0QcffKDmzZtLkmJiYrRkyRKNHDlS1113nWJiYnT33XfrpZde8mwrJSVFZ8+e1csvv6w//OEPqlGjhv7nf/7H53xRUVEaO3asfvjhB0VHR+tXv/qV5syZE4A9BxAuHMYYY3cIAJB+Pvdn/vz56t+/v91RAJRjnHMEAABgQTkCAACw4JwjAKUGn/IDKA04cgQAAGBBOQIAALCgHAEAAFhQjgAAACwoRwAAABaUIwAAAAvKEQAAgAXlCAAAwOL/ASxEkL8STAhjAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import matplotlib.pyplot as plt\n",
+    "\n",
+    "x_values = list(range(len(cost_values)))\n",
+    "y_values = cost_values\n",
+    "\n",
+    "plt.plot(x_values, y_values)\n",
+    "\n",
+    "plt.xlabel(\"Epochs\")\n",
+    "plt.ylabel(\"Cost Value\")\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/noisy_simulations.ipynb b/pr-2241/sphinx/examples/python/tutorials/noisy_simulations.ipynb
new file mode 100644
index 0000000000..40b0834663
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/noisy_simulations.ipynb
@@ -0,0 +1,206 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Noisy Simulation \n",
+    "\n",
+    "Quantum noise can be characterized into coherent and incoherent sources of errors that arise during a computation. Coherent noise is commonly due to systematic errors originating from device miscalibrations, for example, gates implementing a rotation $\\theta + \\epsilon$ instead of $\\theta$.\n",
+    "\n",
+    "Incoherent noise has its origins in quantum states being entangled with the environment due to decoherence. This leads to mixed states which are probability distributions over pure states and are described by employing the density matrix formalism. \n",
+    "\n",
+    "We can model incoherent noise via quantum channels which are linear, completely positive, and trace preserving maps. These maps are called Kraus operators, $\\{ K_i \\}$, which satisfy the condition $\\sum_{i} K_i^\\dagger K_i = \\mathbb{I}$. \n",
+    "\n",
+    "The bit-flip channel flips the qubit with probability $p$ and leaves it unchanged with probability $1-p$. This can be represented by employing Kraus operators: \n",
+    "\n",
+    "$$K_0 = \\sqrt{1-p} \\begin{pmatrix}\n",
+    "    1 & 0 \\\\\n",
+    "    0 & 1\n",
+    "\\end{pmatrix}$$\n",
+    "\n",
+    "$$K_1 = \\sqrt{p} \\begin{pmatrix}\n",
+    "  0 & 1 \\\\\n",
+    "  1 & 0\n",
+    "\\end{pmatrix}$$\n",
+    "\n",
+    "Let's implement the bit-flip channel using CUDA-Q:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "\n",
+    "import numpy as np\n",
+    "\n",
+    "# To model quantum noise, we need to utilize the density matrix simulator target.\n",
+    "cudaq.set_target(\"density-matrix-cpu\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮\n",
+      "q0 : ┤ x ├\n",
+      "     ├───┤\n",
+      "q1 : ┤ x ├\n",
+      "     ╰───╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Let's define a simple kernel that we will add noise to.\n",
+    "qubit_count = 2\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(qubit_count: int):\n",
+    "    qvector = cudaq.qvector(qubit_count)\n",
+    "    x(qvector)\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(kernel, qubit_count))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11:1000 }\n"
+     ]
+    }
+   ],
+   "source": [
+    "# In the ideal noiseless case, we get |11> 100% of the time.\n",
+    "\n",
+    "ideal_counts = cudaq.sample(kernel, qubit_count, shots_count=1000)\n",
+    "ideal_counts.dump()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11:850 10:88 01:56 00:6 }\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First, we will define an out of the box noise channel. In this case,\n",
+    "# we choose depolarization noise. This depolarization will result in\n",
+    "# the qubit state decaying into a mix of the basis states, |0> and |1>,\n",
+    "# with our provided probability.\n",
+    "error_probability = 0.1\n",
+    "depolarization_channel = cudaq.DepolarizationChannel(error_probability)\n",
+    "\n",
+    "# We can also define our own, custom noise channels through\n",
+    "# Kraus operators. Here we will define two operators representing\n",
+    "# bit flip errors.\n",
+    "\n",
+    "# Define the Kraus Error Operator as a complex ndarray.\n",
+    "kraus_0 = np.sqrt(1 - error_probability) * np.array([[1.0, 0.0], [0.0, 1.0]],\n",
+    "                                                    dtype=np.complex128)\n",
+    "kraus_1 = np.sqrt(error_probability) * np.array([[0.0, 1.0], [1.0, 0.0]],\n",
+    "                                                dtype=np.complex128)\n",
+    "\n",
+    "# Add the Kraus Operator to create a quantum channel.\n",
+    "bitflip_channel = cudaq.KrausChannel([kraus_0, kraus_1])\n",
+    "\n",
+    "# Add the two channels to our Noise Model.\n",
+    "noise_model = cudaq.NoiseModel()\n",
+    "\n",
+    "# Apply the depolarization channel to any X-gate on the 0th qubit.\n",
+    "noise_model.add_channel(\"x\", [0], depolarization_channel)\n",
+    "# Apply the bitflip channel to any X-gate on the 1st qubit.\n",
+    "noise_model.add_channel(\"x\", [1], bitflip_channel)\n",
+    "\n",
+    "# Due to the impact of noise, our measurements will no longer be uniformly\n",
+    "# in the |11> state.\n",
+    "noisy_counts = cudaq.sample(kernel,\n",
+    "                            qubit_count,\n",
+    "                            noise_model=noise_model,\n",
+    "                            shots_count=1000)\n",
+    "noisy_counts.dump()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "-0.8666666666666666"
+      ]
+     },
+     "execution_count": 5,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# We can also use noise models with the observe function\n",
+    "\n",
+    "hamiltonian = spin.z(0)\n",
+    "\n",
+    "noisy_result = cudaq.observe(kernel,\n",
+    "                             hamiltonian,\n",
+    "                             qubit_count,\n",
+    "                             noise_model=noise_model)\n",
+    "\n",
+    "noisy_result.expectation()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.6.15 (default, Sep 23 2021, 15:41:43) [GCC]"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/qaoa.ipynb b/pr-2241/sphinx/examples/python/tutorials/qaoa.ipynb
new file mode 100644
index 0000000000..b064182dd6
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/qaoa.ipynb
@@ -0,0 +1,376 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Max-Cut with QAOA\n",
+    "\n",
+    "[Farhi et al.](https://arxiv.org/abs/1411.4028) introduced the quantum approximation optimization algorithm (QAOA) to solve optimization problems like the max cut problem. Before diving into the details of QAOA, we'll first define the max cut problem. \n",
+    "\n",
+    "[Max Cut](https://en.wikipedia.org/wiki/Maximum_cut) is the problem of finding a partition of a graph's nodes into two sets which maximizes the edges between the two sets. Although this problem is relatively easy to solve for graphs with few vertices, this problem is [NP-hard](https://en.wikipedia.org/wiki/NP-hardness#:~:text=7%20References-,Definition,complete%20problem%20G%20to%20H.). The max cut problem has a wide range of applications including [machine learning](https://jmlr.org/papers/volume14/wang13a/wang13a.pdf), [circuit design](https://math.mit.edu/research/highschool/primes/materials/2020/Hong-Lee-Wei.pdf) and [statistical physics](https://www.researchgate.net/publication/262162554_An_Application_of_Combinatorial_Optimization_to_Statistical_Physics_and_Circuit_Layout_Design), among others. Furthermore, the QAOA algorithm presented in this tutorial can be adapted to other related optimization problems with an even wider application field including [portfolio optimization](https://journals.aps.org/prresearch/pdf/10.1103/PhysRevResearch.4.043204) and [job shop scheduling](https://www.sciencedirect.com/science/article/pii/S0377221723002072), just to name a few.\n",
+    "\n",
+    "We take the convention that $G=(V,E)$ represents a graph with vertex set $V\\subseteq \\mathbb{N}$ and edge set $E\\subseteq V\\times V$. We use the terms vertex and node interchangeably.  For this tutorial we assume that the graphs are undirected (that is, $(u,v)$ and $(v,u)$ represent the same edge). Our graphs contain no self loops (i.e., for every vertex $v$, there is no edge $(v,v)$). A *cut* of the graph $G$ is a partition, $(V_0,V_1)$, of the vertex set such that every vertex of $V$ is a member of exactly one of $V_0$ or $V_1$ (i.e., $V_0\\bigcup V_1 = V$ and $V_0\\bigcap V_0=\\emptyset$). The *cut value* for a partition is the sum of the edges with one node in $V_0$ and one node in $V_1$.\n",
+    "\n",
+    "In the images below, we illustrate two cuts of a graph with the dotted lines. Each of these cuts partitions the graph into two disjoint sets. The cut on the left is not optimal, and the cut on the right is the max cut. The cut on the left divides the graph into disjoint sets $\\{1,2\\}$ and $\\{0,3,4\\}$, and that cut contains 3 edges. To more easily visualize the cut, we have colored the vertices in one set of the partition green and the vertices in the other set of the partition gray.\n",
+    "The cut depicted in the diagram on the right divides the graph vertices into two disjoint sets $V_0=\\{0,2\\}$, colored gray, and $V_1=\\{1,3,4\\}$, colored green. The number of edges connecting vertices in the distinct sets is computed by $$\\sum_{\\substack{u \\in V_0; v\\in V_1\\\\ (u,v) \\in E}}1.$$ For the graph on the right, the number of edges in the cut (in this case there are $5$ edges) is maximal, and this value is referred to as the *max cut value*. The partitioning $(V_0,V_1)$  &mdash; and sometimes the set of edges connecting vertices in $V_0$ and $V_1$  &mdash; is referred to as a *max cut of a graph*. Note that the max cut of a graph need not be unique; that is, two distinct partitions may produce the same cut value.\n",
+    " \n",
+    "![](images/max-cut-illustration.png)\n",
+    " \n",
+    "We will use bitstrings to identify vertices in each of the two partitions. For example using the ordering of the vertices, the bitstring `01100` captures the partition in the image above on the left with vertices $1$ and $2$ in $V_1$, and the bitstring `01011` codes the partition in the image on the right with vertices $1$, $3$, and $4$ in $V_1$.\n",
+    "\n",
+    "Let's code our graph data as lists of integers so that we can call these variables when we create the `cudaq.kernel` for QAOA. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import cudaq\n",
+    "from cudaq import spin\n",
+    "from typing import List\n",
+    "\n",
+    "# We'll use the graph below to illustrate how QAOA can be used to\n",
+    "# solve a max cut problem\n",
+    "\n",
+    "#       v1  0--------------0 v2\n",
+    "#           |              | \\\n",
+    "#           |              |  \\\n",
+    "#           |              |   \\\n",
+    "#           |              |    \\\n",
+    "#       v0  0--------------0 v3-- 0 v4\n",
+    "# The max cut solutions are 01011, 10100, 01010, 10101 .\n",
+    "\n",
+    "# First we define the graph nodes (i.e., vertices) and edges as lists of integers so that they can be broadcast into\n",
+    "# a cudaq.kernel.\n",
+    "nodes: List[int] = [0, 1, 2, 3, 4]\n",
+    "edges = [[0, 1], [1, 2], [2, 3], [3, 0], [2, 4], [3, 4]]\n",
+    "edges_src: List[int] = [edges[i][0] for i in range(len(edges))]\n",
+    "edges_tgt: List[int] = [edges[i][1] for i in range(len(edges))]"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "QAOA is a variational algortihm with a particular ansatz. QAOA is made up of a variational quantum circuit (i.e., a kernel that depends on a set of parameter values) and a classical optimizer. The aim of QAOA is to use the classical optimizer to identify parameter values that generate a quantum circuit whose expectation value for a given cost Hamilitonian is minimized. \n",
+    "\n",
+    "What distinguishes QAOA from other variational algorithms is the structure of the quantum circuit. For each vertex in the graph, there is an associated qubit in the circuit. The circuit is initialized in a superposition state. The remainder of the QAOA circuit is made up of blocks (referred to as layers). The more layers there are, the better the approximation the algorithm achieves.\n",
+    "\n",
+    "![diagram of QAOA circuit layers](images/qaoa-circuit-layers.png)\n",
+    "\n",
+    "\n",
+    "\n",
+    "Each layer contains a problem kernel and a mixer kernel. The mixer kernel is composed of parameterized rotation gates applied to each qubit, depicted in green in the image above. The problem kernel encodes the graph edges. The image below shows an example of an graph edge encoded with controlled-X gates and a parameterized rotation gate.\n",
+    "\n",
+    "![diagram of a QAOA problem kernel for a max cut problem](images/qaoa-problem-kernel.png)\n",
+    "\n",
+    "Let's implement the QAOA circuit for our max cut problem in CUDA-Q."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Problem parameters\n",
+    "# The number of qubits we'll need is the same as the number of vertices in our graph\n",
+    "qubit_count: int = len(nodes)\n",
+    "\n",
+    "# We can set the layer count to be any positive integer.  Larger values will create deeper circuits\n",
+    "layer_count: int = 2\n",
+    "\n",
+    "# Each layer of the QAOA kernel contains 2 parameters\n",
+    "parameter_count: int = 2 * layer_count\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def qaoaProblem(qubit_0: cudaq.qubit, qubit_1: cudaq.qubit, alpha: float):\n",
+    "    \"\"\"Build the QAOA gate sequence between two qubits that represent an edge of the graph\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    qubit_0: cudaq.qubit \n",
+    "        Qubit representing the first vertex of an edge\n",
+    "    qubit_1: cudaq.qubit \n",
+    "        Qubit representing the second vertex of an edge\n",
+    "    thetas: List[float]\n",
+    "        Free variable   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.Kernel\n",
+    "        Subcircuit of the problem kernel for Max-Cut of the graph with a given edge\n",
+    "    \"\"\"\n",
+    "    x.ctrl(qubit_0, qubit_1)\n",
+    "    rz(2.0 * alpha, qubit_1)\n",
+    "    x.ctrl(qubit_0, qubit_1)\n",
+    "\n",
+    "\n",
+    "# We now define the kernel_qaoa function which will be the QAOA circuit for our graph\n",
+    "# Since the QAOA circuit for max cut depends on the structure of the graph,\n",
+    "# we'll feed in global concrete variable values into the kernel_qaoa function for the qubit_count, layer_count, edges_src, edges_tgt.\n",
+    "# The types for these variables are restricted to Quake Values (e.g. qubit, int, List[int], ...)\n",
+    "# The thetas plaeholder will be our free parameters\n",
+    "@cudaq.kernel\n",
+    "def kernel_qaoa(qubit_count: int, layer_count: int, edges_src: List[int],\n",
+    "                edges_tgt: List[int], thetas: List[float]):\n",
+    "    \"\"\"Build the QAOA circuit for max cut of the graph with given edges and nodes\n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    qubit_count: int \n",
+    "        Number of qubits in the circuit, which is the same as the number of nodes in our graph\n",
+    "    layer_count : int \n",
+    "        Number of layers in the QAOA kernel\n",
+    "    edges_src: List[int]\n",
+    "        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    edges_tgt: List[int]\n",
+    "        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    thetas: List[float]\n",
+    "        Free variables to be optimized   \n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.Kernel\n",
+    "        QAOA circuit for Max-Cut for max cut of the graph with given edges and nodes\n",
+    "    \"\"\"\n",
+    "    # Let's allocate the qubits\n",
+    "    qreg = cudaq.qvector(qubit_count)\n",
+    "    # And then place the qubits in superposition\n",
+    "    h(qreg)\n",
+    "\n",
+    "    # Each layer has two components: the problem kernel and the mixer\n",
+    "    for i in range(layer_count):\n",
+    "        # Add the problem kernel to each layer\n",
+    "        for edge in range(len(edges_src)):\n",
+    "            qubitu = edges_src[edge]\n",
+    "            qubitv = edges_tgt[edge]\n",
+    "            qaoaProblem(qreg[qubitu], qreg[qubitv], thetas[i])\n",
+    "        # Add the mixer kernel to each layer\n",
+    "        for j in range(qubit_count):\n",
+    "            rx(2.0 * thetas[i + layer_count], qreg[j])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "As mentioned earlier, QAOA is a variational algorithm that aims to minimize a cost function. To apply QAOA to the max cut problem, we assign a binary variable $z_v$ to each vertex $v$. These variables will take on the vales $-1$ or $1$. Notice that an assignment of variable values corresponds to a partition of the graph.  For example, $\\bar z = [-1, 1, -1, 1, 1]$ would partition the graph into two sets: $\\{0,2\\}$ and $\\{1,3,4\\}.$ We can compute the cut value of the graph for an arbirtrary assignment of variable values by the formula: $$C(\\bar{z})= \\frac{1}{2} \\sum_{(u,v)\\in E} (1-z_uz_v),$$ where $E$ is the set of edges of our graph.  Our goal is to find a variable assignment that maximizes $C(\\bar z)$.  Equivalently, we want to find a variable assignment that minimizes $-C(\\bar z)$. Since QAOA identifies minimum values, we have reframed the max cut optimization problem from one of maximization to minimization. Furthermore, we can promote this equation to a matrix equation by replacing $z_uz_v-1$ with Pauli-Z operators acting on qubits associated with nodes $u$ and $v$, respectively, and replacing 1 with the identity matrix. This leads to the reformulation of the problem from one of maximizing $C(\\bar{z})$ to one of minimizing the eigenvalues of $$H= \\frac{1}{2}\\sum_{(u,v)\\in E} (Z_uZ_v-II).$$  \n",
+    "\n",
+    "We can code this Hamiltonian using the `cudaq.spin` operators."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# The problem Hamiltonian\n",
+    "# Define a function to generate the Hamiltonian for a max cut problem using the graph\n",
+    "# with the given edges\n",
+    "\n",
+    "\n",
+    "def hamiltonian_max_cut(edges_src, edges_tgt):\n",
+    "    \"\"\"Hamiltonian for finding the max cut for the graph with given edges and nodes\n",
+    "        \n",
+    "    Parameters\n",
+    "    ----------\n",
+    "    edges_src: List[int]\n",
+    "        List of the first (source) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "    edges_tgt: List[int]\n",
+    "        List of the second (target) node listed in each edge of the graph, when the edges of the graph are listed as pairs of nodes\n",
+    "        \n",
+    "    Returns\n",
+    "    -------\n",
+    "    cudaq.SpinOperator\n",
+    "        Hamiltonian for finding the max cut of the graph with given edges \n",
+    "    \"\"\"\n",
+    "\n",
+    "    hamiltonian = 0\n",
+    "\n",
+    "    for edge in range(len(edges_src)):\n",
+    "\n",
+    "        qubitu = edges_src[edge]\n",
+    "        qubitv = edges_tgt[edge]\n",
+    "        # Add a term to the Hamiltonian for the edge (u,v)\n",
+    "        hamiltonian += 0.5 * (spin.z(qubitu) * spin.z(qubitv) -\n",
+    "                              spin.i(qubitu) * spin.i(qubitv))\n",
+    "\n",
+    "    return hamiltonian"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "To inititiate the QAOA algorithm, we need to identify initial parameters and specify the classical optimization routine."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Initial parameters =  [0.21810696323572243, -0.20613464375211488, 0.2546877639814583, 0.3657985647468064]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Specify the optimizer and its initial parameters.\n",
+    "cudaq.set_random_seed(13)\n",
+    "optimizer = cudaq.optimizers.NelderMead()\n",
+    "np.random.seed(13)\n",
+    "optimizer.initial_parameters = np.random.uniform(-np.pi / 8, np.pi / 8,\n",
+    "                                                 parameter_count)\n",
+    "print(\"Initial parameters = \", optimizer.initial_parameters)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can either use the `observe` primitive or the `vqe` primitive to code up the optimization loop of QAOA."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[0.5+0j] IIZIZ\n",
+      "[0.5+0j] IZZII\n",
+      "[-3+0j] IIIII\n",
+      "[0.5+0j] ZZIII\n",
+      "[0.5+0j] IIIZZ\n",
+      "[0.5+0j] IIZZI\n",
+      "[0.5+0j] ZIIZI\n",
+      "\n",
+      "optimal_expectation = -4.495973826282007\n",
+      "Therefore, the max cut value is at least  4.495973826282007\n",
+      "optimal_parameters = [0.51349181993727, -0.21299416361632417, 0.3250526425808945, 0.886630847343767]\n"
+     ]
+    }
+   ],
+   "source": [
+    "#cudaq.set_target('nvidia')\n",
+    "cudaq.set_target('qpp-cpu')\n",
+    "\n",
+    "# Generate the Hamiltonian for our graph\n",
+    "hamiltonian = hamiltonian_max_cut(edges_src, edges_tgt)\n",
+    "print(hamiltonian)\n",
+    "\n",
+    "# Define the objective, return `<state(params) | H | state(params)>`\n",
+    "# Note that in the `observe` call we list the kernel, the hamiltonian, and then the concrete global variable values of our kernel\n",
+    "# followed by the parameters to be optimized.\n",
+    "\n",
+    "\n",
+    "def objective(parameters):\n",
+    "    return cudaq.observe(kernel_qaoa, hamiltonian, qubit_count, layer_count,\n",
+    "                         edges_src, edges_tgt, parameters).expectation()\n",
+    "\n",
+    "\n",
+    "# Optimize!\n",
+    "optimal_expectation, optimal_parameters = optimizer.optimize(\n",
+    "    dimensions=parameter_count, function=objective)\n",
+    "\n",
+    "# Alternatively we can use the vqe call (just comment out the above code and uncomment the code below)\n",
+    "# optimal_expectation, optimal_parameters = cudaq.vqe(\n",
+    "#    kernel=kernel_qaoa,\n",
+    "#    spin_operator=hamiltonian,\n",
+    "#    argument_mapper=lambda parameter_vector: (qubit_count, layer_count, edges_src, edges_tgt, parameter_vector),\n",
+    "#    optimizer=optimizer,\n",
+    "#    parameter_count=parameter_count)\n",
+    "\n",
+    "print('optimal_expectation =', optimal_expectation)\n",
+    "print('Therefore, the max cut value is at least ', -1 * optimal_expectation)\n",
+    "print('optimal_parameters =', optimal_parameters)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now that we have identified the optimal parameters, we can read out the partitioning(s) that gives us a max cut of the graph using the `sample` primitive."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{ 11111:4 11110:1 01101:2 01010:148 01110:47 01000:3 00110:54 10101:165 00101:2 01011:154 00100:3 01001:41 00000:1 00011:3 01100:8 10011:7 00010:2 01111:2 11011:3 00111:10 11100:7 10001:65 10010:7 10100:144 10110:40 10000:5 10111:3 11000:7 11101:1 11001:59 11010:2 }\n",
+      "\n",
+      "The max cut is given by the partition:  10101\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Sample the circuit using the optimized parameters\n",
+    "# Since our kernel has more than one argument, we need to list the values for each of these variables in order in the `sample` call.\n",
+    "counts = cudaq.sample(kernel_qaoa, qubit_count, layer_count, edges_src,\n",
+    "                      edges_tgt, optimal_parameters)\n",
+    "print(counts)\n",
+    "\n",
+    "# Identify the most likely outcome from the sample\n",
+    "max_cut = max(counts, key=lambda x: counts[x])\n",
+    "print('The max cut is given by the partition: ',\n",
+    "      max(counts, key=lambda x: counts[x]))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/quantum_fourier_transform.ipynb b/pr-2241/sphinx/examples/python/tutorials/quantum_fourier_transform.ipynb
new file mode 100644
index 0000000000..8d836113b3
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/quantum_fourier_transform.ipynb
@@ -0,0 +1,413 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Quantum Fourier Transform "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Classical Fourier transforms aid many areas such as signal processing and data compression. Below, we quantize it to enable Quantum Fourier Transforms (QFT) in CUDA-Q.\n",
+    "\n",
+    "QFT is a key ingredient in Shor's algorithm which is exponentially faster at factoring prime numbers and also plays a vital role in many other interesting quantum algorithms. \n",
+    "\n",
+    "The idea with classical Fourier transforms is to take the problem from the frequency domain, to the time domain where it is easier to solve. This is the same analogy we draw with QFT, where we take the basis state from the computational basis to the Fourier basis. "
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The Quantum Fourier Transform is defined to be the linear operation which takes a basis state, $\\ket{x}$, \n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\text{QFT}\\ket{x}  =   \\frac{1}{\\sqrt{N}}\\sum_{y=0}^{N-1} e^{\\frac{2\\pi ixy}{N}} \\ket{y}\n",
+    "\\tag{1}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "where $n$ is the number of qubits and $N= 2^n$. \n",
+    "\n",
+    "It is convenient to represent states like $\\ket{x}  = \\ket{101}$ in their binary representation which in this case would be $2^2 \\times 1 + 2^1 \\times 0 + 2^0 \\times 1 = \\ket{5}$. \n",
+    "\n",
+    "\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "For the $n=1$ qubit case, we have the following basis states: $\\ket{0}, \\ket{1}$. The QFT on these is as follows: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|0\\rangle &= \\frac{1}{\\sqrt{2}}\\sum_{y=0}^{2-1} e^{\\frac{2\\pi i(0)y}{2}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}\\left(e^0|0\\rangle + e^0|1\\rangle\\right) \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}(|0\\rangle + |1\\rangle) \\\\\n",
+    "&= \\ket{+} \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{2}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|1\\rangle &= \\frac{1}{\\sqrt{2}}\\sum_{y=0}^{2-1} e^{\\frac{2\\pi i(1)y}{2}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}\\left(e^0|0\\rangle + e^{\\pi i}|1\\rangle\\right) \\\\\n",
+    "&= \\frac{1}{\\sqrt{2}}(|0\\rangle - |1\\rangle) \\\\\n",
+    "&= \\ket{-} \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{3}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "             \n",
+    "\n",
+    "To summarize, $\\text{QFT}|0\\rangle = \\ket{+}$ and $\\text{QFT}|1\\rangle = \\ket{-}$ which can be achieved by applying Hadamard gates. \n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "Let us now extend this and see how we can apply this to $n=3$ qubits. \n",
+    "\n",
+    "For $n=3, N = 2^3 = 8$ and we would like to perform $\\text{QFT}|101\\rangle$ which in binary is $2^2 \\times 1 + 2^1 \\times 0 + 2^0 \\times 1 = 5$: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|101\\rangle = \\text{QFT}|5\\rangle &= \\frac{1}{\\sqrt{8}}\\sum_{y=0}^{8-1} e^{\\frac{2\\pi i(5)y}{8}}|y\\rangle \\\\\n",
+    "&= \\frac{1}{\\sqrt{8}} [ e^{0}\\ket{0} + e^{\\frac{5i\\pi (1)}{4}}\\ket{1}  + e^{\\frac{5i\\pi (2)}{4}}\\ket{2} +...++ e^{\\frac{5i\\pi (7)}{4}}\\ket{7} ]   \\\\\n",
+    "&= \\frac{1}{\\sqrt{8}} [ \\ket{000} + e^{\\frac{5i\\pi (1)}{4}}\\ket{001}  + e^{\\frac{5i\\pi (2)}{4}}\\ket{010} +...++ e^{\\frac{5i\\pi (7)}{4}}\\ket{111} ]   \\\\\n",
+    "&=  (0.35+0i) \\ket{000} + (-0.25-0.25i)\\ket{001}  + (0+0.35i)\\ket{010} +...+ (-0.25+0.25i)\\ket{111}    \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{4}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "where we have used the fact that $e^{i\\theta} = \\cos(\\theta) + i\\sin(\\theta).$\n",
+    "\n",
+    "Here, we see how in addition to the Hadamard gates, we need some phase gates to apply the appropriate phases to the basis states. It turns out that the gate we need is the controlled $R_k$ rotation where the $R_k$ gate is denoted by:\n",
+    "\n",
+    "\n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "R_k = \\begin{bmatrix}\n",
+    "1 & 0 \\\\\n",
+    "0 & e^{2\\pi i/ 2^{k}}\n",
+    "\\end{bmatrix}\n",
+    "\\tag{5}\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "\n",
+    "\n",
+    "\n",
+    "Here is a generalized ciruit for a $n$-qubit quantum Fourier transform:"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "\n",
+    "<img src=\"images/qft.png\" alt=\"qft\" width=\"600\">\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Below we show the code for a QFT implementation in CUDA-Q based on the circuit diagram above: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "from typing import List\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform(input_state: List[int]):\n",
+    "    '''Args: \n",
+    "    input_state (list[int]): specifies the input state to be Fourier transformed.  '''\n",
+    "\n",
+    "    qubit_count = len(input_state)\n",
+    "\n",
+    "    # Initialize qubits.\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    # Initialize the quantum circuit to the initial state.\n",
+    "    for i in range(qubit_count):\n",
+    "        if input_state[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮╭───────────╮╭────────────╮                       \n",
+      "q0 : ┤ x ├┤ h ├┤ r1(1.571) ├┤ r1(0.7854) ├───────────────────────\n",
+      "     ╰───╯╰───╯╰─────┬─────╯╰─────┬──────╯╭───╮╭───────────╮     \n",
+      "q1 : ────────────────●────────────┼───────┤ h ├┤ r1(1.571) ├─────\n",
+      "     ╭───╮                        │       ╰───╯╰─────┬─────╯╭───╮\n",
+      "q2 : ┤ x ├────────────────────────●──────────────────●──────┤ h ├\n",
+      "     ╰───╯                                                  ╰───╯\n",
+      "\n",
+      "[ 0.35+0.j   -0.25-0.25j  0.  +0.35j  0.25-0.25j -0.35+0.j    0.25+0.25j\n",
+      " -0.  -0.35j -0.25+0.25j]\n"
+     ]
+    }
+   ],
+   "source": [
+    "#Can be changed to 'nvidia' for single gpu, 'nvidia-mgpu' for multi-GPU or quantum hardware.\n",
+    "cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "# The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.\n",
+    "input_state = [1, 0, 1]\n",
+    "\n",
+    "# Number of decimal points to round up the statevector to.\n",
+    "precision = 2\n",
+    "\n",
+    "# Draw the quantum circuit.\n",
+    "print(cudaq.draw(quantum_fourier_transform, input_state))\n",
+    "\n",
+    "# Print the statevector to the specified precision\n",
+    "statevector = np.array(cudaq.get_state(quantum_fourier_transform, input_state))\n",
+    "print(np.round(statevector, precision))"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can verify that this is the correct answer as above we worked out that: \n",
+    "\n",
+    "$$\n",
+    "\\begin{equation} \n",
+    "\\begin{aligned}\n",
+    "\\text{QFT}|101\\rangle = \\text{QFT}|5\\rangle &= \\frac{1}{\\sqrt{8}}\\sum_{y=0}^{8-1} e^{\\frac{2\\pi i(5)y}{8}}|y\\rangle \\\\\n",
+    "&=  (0.35+0i) \\ket{000} + (-0.25-0.25i)\\ket{001}  + (0+0.35i)\\ket{010} +...+ (-0.25+0.25i)\\ket{111}.   \\\\\n",
+    "\\end{aligned}\n",
+    "\\tag{6}\n",
+    "\\end{equation}\n",
+    "$$\n"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Barring the gates used in the state preparation step, the circuit starts off by implementing a Hadamard gate and then $n-1$ rotations on the zeroth qubit - a total of $n$ gates. This is followed by a Hadamard and $n-2$ conditional rotations on the first qubit which totals to $n -1$ gates. If we continue the series, we get $n + (n-1) + (n-2)... = n(n+1)/2$ gates. Hence, this circuit provides an algorithm with $O(n^2)$ gates for computing the QFT. \n",
+    "\n",
+    "The best classical algorithms for computing fast Fourier transforms on $2^{n}$ elements require $O(n2^{n})$ gates. This means that it requires exponentially more operations to compute the fast Fourier transform on a classical computer than it does to implement the QFT on a quantum computer.\n",
+    "\n",
+    "Why are we not using QFT for real life applications then? The problem lies in quantum measurement. The quantum-Fourier-transformed amplitudes cannot be accessed by quantum measurement. However there are other quantum algorithms that do make use of QFT such as Shor's algorithm. \n",
+    "\n",
+    "One can also invert the QFT where the circuit is executed in reverse with the inverse of each gate. The figure below shows the general $n$-qubit inverse QFT. Why don't you try implementing this in CUDA-Q?\n",
+    "\n",
+    "<img src=\"images/inverse_qft.png\" alt=\"qft\" width=\"600\">\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Quantum Fourier Transform revisited\n",
+    "We provided one implementation of the Quantum Fourier Transform above.  To demonstrate some of the other features of CUDA-Q, let's define a new kernel for the Quantum Fourier Transform, which we'll call `quantum_fourier_transform2`.  Pay attention to how the kernel definition differs from the example above.\n",
+    "\n",
+    " Since the Quantum Fourier Transform is a unitary operator, its inverse is its adjoint.  Therefore, once we have implemented the Quantum Fourier Transform as a kernel in CUDA-Q, we can use the built-in `adjoint` operation to create the Inverse Quantum Fourier Transform."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Define kernels for the Quantum Fourier Transform and the Inverse Quantum Fourier Transform\n",
+    "@cudaq.kernel\n",
+    "def quantum_fourier_transform2(qubits: cudaq.qview):\n",
+    "    '''Args: \n",
+    "    qubits (cudaq.qview): specifies the quantum register to which apply the QFT.'''\n",
+    "    qubit_count = len(qubits)\n",
+    "    # Apply Hadamard gates and controlled rotation gates.\n",
+    "    for i in range(qubit_count):\n",
+    "        h(qubits[i])\n",
+    "        for j in range(i + 1, qubit_count):\n",
+    "            angle = (2 * np.pi) / (2**(j - i + 1))\n",
+    "            cr1(angle, [qubits[j]], qubits[i])\n",
+    "            \n",
+    "@cudaq.kernel\n",
+    "def inverse_qft(qubits: cudaq.qview):\n",
+    "    '''Args: \n",
+    "    qubits (cudaq.qview): specifies the quantum register to which apply the inverse QFT.'''\n",
+    "    cudaq.adjoint(quantum_fourier_transform2, qubits)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let's see that this approach gives us the same results as the section above. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮╭─────────╮╭──────────╮                                      »\n",
+      "q0 : ┤ x ├┤ h ├┤ r1(1.5) ├┤ r1(0.75) ├──────────────────────────────────────»\n",
+      "     ╰───╯╰───╯╰────┬────╯╰────┬─────╯╭───╮╭─────────╮          ╭──────────╮»\n",
+      "q1 : ───────────────●──────────┼──────┤ h ├┤ r1(1.5) ├──────────┤ r1(-1.5) ├»\n",
+      "     ╭───╮                     │      ╰───╯╰────┬────╯╭───╮╭───╮╰────┬─────╯»\n",
+      "q2 : ┤ x ├─────────────────────●────────────────●─────┤ h ├┤ h ├─────●──────»\n",
+      "     ╰───╯                                            ╰───╯╰───╯            »\n",
+      "\n",
+      "################################################################################\n",
+      "\n",
+      "     ╭───────────╮╭──────────╮╭───╮\n",
+      "─────┤ r1(-0.75) ├┤ r1(-1.5) ├┤ h ├\n",
+      "╭───╮╰─────┬─────╯╰────┬─────╯╰───╯\n",
+      "┤ h ├──────┼───────────●───────────\n",
+      "╰───╯      │                       \n",
+      "───────────●───────────────────────\n",
+      "                                   \n",
+      "\n",
+      "[0.+0.j 0.+0.j 0.+0.j 0.+0.j 0.+0.j 1.-0.j 0.-0.j 0.+0.j]\n"
+     ]
+    }
+   ],
+   "source": [
+    "@cudaq.kernel\n",
+    "def verification_example(input_state : List[int]):\n",
+    "    '''Args: \n",
+    "    input_state (list[int]): specifies the input state to be transformed with QFT and the inverse QFT.  '''\n",
+    "    qubit_count = len(input_state)\n",
+    "    # Initialize qubits.\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    # Initialize the quantum circuit to the initial state.\n",
+    "    for i in range(qubit_count):\n",
+    "        if input_state[i] == 1:\n",
+    "            x(qubits[i])\n",
+    "    \n",
+    "    # Apply the quantum Fourier Transform\n",
+    "    quantum_fourier_transform2(qubits)\n",
+    "\n",
+    "    # Apply the inverse quantum Fourier Transform\n",
+    "    inverse_qft(qubits)\n",
+    "\n",
+    "# The state to which the QFT operation is applied to. The zeroth element in the list is the zeroth qubit.\n",
+    "input_state = [1, 0, 1]\n",
+    "\n",
+    "\n",
+    "# Number of decimal points to round up the statevector to.\n",
+    "precision = 2\n",
+    "\n",
+    "\n",
+    "print(cudaq.draw(verification_example, input_state))\n",
+    "\n",
+    "# Print the statevector to the specified precision\n",
+    "statevector = np.array(cudaq.get_state(verification_example, input_state))\n",
+    "print(np.round(statevector, precision)) # The result should be the input state"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a726804916fd397408cbf595ce6fe5f33dcd8b4c)\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/readout_error_mitigation.ipynb b/pr-2241/sphinx/examples/python/tutorials/readout_error_mitigation.ipynb
new file mode 100644
index 0000000000..1d1fee4095
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/readout_error_mitigation.ipynb
@@ -0,0 +1,900 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "5b2ac00e-c7fc-45cc-888e-8c26dabf80d2",
+   "metadata": {},
+   "source": [
+    "# Readout Error Mitigation\n",
+    "\n",
+    "Readout errors are caused by imperfect qubit measurement and are a common source of error in quantum computing. Properly modelling these errors in simulation can give the user tools to understand better what these errors are and how to mitigate them when running on actual quantum devices.\n",
+    "\n",
+    "Readout errors can be mitigated with a confusion matrix $A$. It is a square matrix of size $2^n \\times 2^n$ and tells about the probability of observing the state $|y\\rangle$ given the true state $|x\\rangle$. The confusion matrix characterizes the readout error of the device and is circuit-independent. Once $A$ is estimated, we can compute its pseudoinverse $A^+$ which can be applied to the noisy probability distribution $p_{\\text{noisy}}$ to obtain an adjusted quasi-probability distribution \n",
+    "\n",
+    "$$\n",
+    "p_{\\text{mitigated}} = A^+ p_{\\text{noisy}}\n",
+    "$$\n",
+    "\n",
+    "In this tutorial, we show how to build a confusion matrix with the following approaches.\n",
+    "\n",
+    "- Using a  single qubit model\n",
+    "- Using $k$ local confusion matrices\n",
+    "- A full confusion matrix for each $2^n$ combination\n",
+    "\n",
+    "The last method works well for correcting correlated errors (which affect multiple qubits together). However, it becomes impractical for large numbers of qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "04b58854-7dab-4f1b-8c59-d8b9506bce44",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install pandas==2.2.2\n",
+    "!pip install scipy==1.13.1\n",
+    "!pip install seaborn==0.13.2"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "id": "710a2a46-4e55-4508-a0b7-21969aac6a87",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "import seaborn as sns\n",
+    "import pandas as pd\n",
+    "import itertools\n",
+    "from functools import reduce\n",
+    "from scipy.optimize import minimize\n",
+    "from typing import Union\n",
+    "\n",
+    "sns.set_style(\"dark\")\n",
+    "\n",
+    "cudaq.set_target(\"density-matrix-cpu\")\n",
+    "seed = 42\n",
+    "\n",
+    "cudaq.set_random_seed(seed)\n",
+    "np.random.seed(seed)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8eab761a-0a82-4e20-8cf8-54602cd05d6a",
+   "metadata": {},
+   "source": [
+    "To model the readout error, we apply a bitflip channel on every qubit at the end of the circuit using an Identity gate. The probability of bitflip `probs` can be the same or different for all the qubits.\n",
+    "\n",
+    "<div class=\"alert alert-block alert-success\"><b>Note: </b>\n",
+    "In principle, readout error is applied to the measurement gate but we use the Identity gate because adding a quantum error on the measurement gate is not yet supported. Also, the Identity gate is not present in the <kbd>add_channel</kbd> method, so we model the Identity gate using a rotation gate with an angle of 0.0.\n",
+    "</div>"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "id": "d84bb420-4fab-4c26-919a-7efa8d3a219b",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_noise(n_qubits: int, probs: Union[float, list[float]]):\n",
+    "    \"\"\"\n",
+    "    Creates a noise model with specified probabilities of bit flip errors on each qubit.\n",
+    "\n",
+    "    Args:\n",
+    "        n_qubits (int): The number of qubits in the quantum circuit.\n",
+    "        probs (Union[float, list[float]]): Probabilities of a bit flip error occurring on each qubit.\n",
+    "        If a single probability value is provided, it will be applied to all qubits. If a list of\n",
+    "        probabilities is provided, each qubit will have its own probability.\n",
+    "\n",
+    "    Returns:\n",
+    "        cudaq noise model\n",
+    "    \"\"\"\n",
+    "    noise = cudaq.NoiseModel()\n",
+    "\n",
+    "    if not isinstance(probs, list):\n",
+    "        probs = [probs] * n_qubits\n",
+    "\n",
+    "    for i, p in enumerate(probs):\n",
+    "        bit_flip = cudaq.BitFlipChannel(p)\n",
+    "        noise.add_channel(\"rx\", [i], bit_flip)\n",
+    "\n",
+    "    return noise"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bb4c7a14-1c0c-4fab-a6aa-7174c23baa7f",
+   "metadata": {},
+   "source": [
+    "We define a cudaq kernel which will help create a set of quantum circuits to take measurements of the basis states for $n$ qubits. The kernel takes the number of qubits and the basis state as arguments."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "id": "53e3f450-000f-49b8-ad5c-57aa74461694",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel(n_qubits: int, state_label: list[int]):\n",
+    "    qvector = cudaq.qvector(n_qubits)\n",
+    "    for i, val in enumerate(state_label):\n",
+    "        if val == 1:\n",
+    "            x(qvector[i])\n",
+    "        rx(\n",
+    "            0.0, qvector[i]\n",
+    "        )  # Identity gate at the end on each qubit to model readout error\n",
+    "    mz(qvector)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "95411463-cd1e-499f-baef-d624acc0122c",
+   "metadata": {},
+   "source": [
+    "For the tutorial, we will use the GHZ state on three qubits to test readout error mitigation. The GHZ state on 3 qubits is described as:\n",
+    "\n",
+    "$$\n",
+    "\\frac{|000\\rangle + |111\\rangle}{\\sqrt{2}}\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "id": "c1476028-923d-4f2b-b5fc-39ebcc8cbab9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def ghz_kernel(n_qubits: int):\n",
+    "    qvector = cudaq.qvector(n_qubits)\n",
+    "\n",
+    "    h(qvector[0])\n",
+    "    for i in range(n_qubits - 1):\n",
+    "        cx(qvector[i], qvector[i + 1])\n",
+    "\n",
+    "    # Apply identity gates for readout error mitigation\n",
+    "    for i in range(n_qubits):\n",
+    "        rx(0.0, qvector[i])\n",
+    "\n",
+    "    mz(qvector)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "900d2110-d613-426a-8aa9-6c12b1238536",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Function to draw the confusion matrix\n",
+    "def plot_cmat(mat):\n",
+    "    fig, ax = plt.subplots()\n",
+    "    n = len(mat)\n",
+    "    im2 = ax.matshow(mat, cmap=plt.cm.Reds, vmin=0, vmax=1.0)\n",
+    "    ax.set_yticks(np.arange(n))\n",
+    "    ax.set_xticks(np.arange(n))\n",
+    "    ax.set_yticklabels(n * [\"\"])\n",
+    "    ax.set_xticklabels(n * [\"\"])\n",
+    "    ax.set_title(r\"Confusion Matrix\", fontsize=16)\n",
+    "    ax.set_xlabel(\"Prepared State\")\n",
+    "    ax.xaxis.set_label_position(\"top\")\n",
+    "    ax.set_ylabel(\"Measured State\")\n",
+    "    fig.colorbar(im2, ax=ax)\n",
+    "    plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "032f6898-c953-4d30-a2bf-e8b46ee77c62",
+   "metadata": {},
+   "source": [
+    "It is possible that the adjusted quasi-probability distribution $p_{\\text{mitigated}}$ obtained by application of $A^+$ to $p_{\\text{noisy}}$ may be non-positive. We need to find the closest positive probability distribution in such a case.\n",
+    "\n",
+    " $$ p'' = \\min_{p_{\\rm positive}} \\|p_{\\rm noisy} - p_{\\rm positive}\\|_1$$\n",
+    "\n",
+    "Then, we can draw samples from $p''$."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "9b355dcb-bf80-42a1-ae11-dcc9f11ba1e3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def find_closest_distribution(empirical_dist):\n",
+    "    \"\"\"\n",
+    "    Find the closest distribution to an empirical distribution by minimizing the L1 norm.\n",
+    "\n",
+    "    Args:\n",
+    "        empirical_dist: Empirical distribution that you want to find the closest distribution to.\n",
+    "\n",
+    "    Returns:\n",
+    "        Closest distribution to `empirical_dist`\n",
+    "    \"\"\"\n",
+    "\n",
+    "    def objective(x):\n",
+    "        return np.linalg.norm(empirical_dist - x, ord=1)\n",
+    "\n",
+    "    # Constraint: all elements of p must be positive, and the distribution must sum to 1\n",
+    "    cons = (\n",
+    "        {\"type\": \"ineq\", \"fun\": lambda p: p},\n",
+    "        {\"type\": \"eq\", \"fun\": lambda p: np.sum(p) - 1},\n",
+    "    )\n",
+    "    bnds = [(0, 1) for _ in range(len(empirical_dist))]\n",
+    "    initial_value = np.random.uniform(size=len(empirical_dist))\n",
+    "\n",
+    "    res = minimize(\n",
+    "        objective,\n",
+    "        initial_value,\n",
+    "        method=\"SLSQP\",\n",
+    "        options={\"maxiter\": 1000},\n",
+    "        bounds=bnds,\n",
+    "        constraints=cons,\n",
+    "    )\n",
+    "\n",
+    "    return res.x"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "0ceb5a15-cecf-47ed-b1cc-cea79fa936f7",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def get_counts_from_distribution(n_qubits, size, dist):\n",
+    "    \"\"\"\n",
+    "    Generates samples based on a given distribution and returns the counts of each sample value.\n",
+    "\n",
+    "    Args:\n",
+    "        n_qubits: The number of qubits in the quantum circuit.\n",
+    "        dist: The probability distribution from which samples are drawn.\n",
+    "\n",
+    "    Returns:\n",
+    "        An array of counts for each possible value in the distribution. The array has a length of 2^n_qubits.\n",
+    "    \"\"\"\n",
+    "    samples = np.random.choice(np.arange(2**n_qubits), size=size, p=dist)\n",
+    "    values, counts = np.unique(samples, return_counts=True)\n",
+    "    res = np.zeros(2**n_qubits, dtype=int)\n",
+    "    res[values] = counts\n",
+    "    return res"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1225d4de-fcc8-4a56-846b-44d6a52a272f",
+   "metadata": {},
+   "source": [
+    "Let's run the `ghz_kernel` with the noise model. We will perform two experiments. First, we keep the bitflip probability the same for all the qubits. In the second experiment, we use different bitflip probabilities for qubits."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "53453484-a8d5-416c-8aad-7c982cad7191",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "n_qubits = 3\n",
+    "shots = 1024\n",
+    "\n",
+    "labels = list(map(list, itertools.product([0, 1], repeat=n_qubits)))\n",
+    "states = list(map(lambda label: \"\".join(map(str, label)), labels))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "2d147fe7-ce5e-475c-9014-59d4ff63a644",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "bitflip probability: 0.1\n",
+      "\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'000': 352,\n",
+       " '010': 43,\n",
+       " '111': 367,\n",
+       " '001': 47,\n",
+       " '011': 47,\n",
+       " '100': 54,\n",
+       " '101': 61,\n",
+       " '110': 53}"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "p = 0.1\n",
+    "print(f\"bitflip probability: {p}\\n\")\n",
+    "\n",
+    "noise_1 = get_noise(n_qubits, p)\n",
+    "\n",
+    "ghz_result = cudaq.sample(ghz_kernel, n_qubits, shots_count=shots, noise_model=noise_1)\n",
+    "noisy_dict_1 = dict(list(ghz_result.items()))\n",
+    "\n",
+    "noisy_res_1 = np.array([noisy_dict_1.get(state, 0) for i, state in enumerate(states)])\n",
+    "\n",
+    "noisy_dict_1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "976f13da-277b-4754-9a58-277a5988f739",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "bitflip probability: [0.149816047538945, 0.3802857225639665, 0.292797576724562]\n",
+      "\n"
+     ]
+    },
+    {
+     "data": {
+      "text/plain": [
+       "{'000': 212,\n",
+       " '010': 122,\n",
+       " '111': 189,\n",
+       " '001': 111,\n",
+       " '011': 87,\n",
+       " '100': 78,\n",
+       " '101': 131,\n",
+       " '110': 94}"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "p = list(np.random.uniform(low=0.0, high=0.4, size=n_qubits))\n",
+    "print(f\"bitflip probability: {p}\\n\")\n",
+    "\n",
+    "noise_2 = get_noise(n_qubits, p)\n",
+    "\n",
+    "ghz_result = cudaq.sample(ghz_kernel, n_qubits, shots_count=shots, noise_model=noise_2)\n",
+    "noisy_dict_2 = dict(list(ghz_result.items()))\n",
+    "\n",
+    "noisy_res_2 = np.array([noisy_dict_2.get(state, 0) for i, state in enumerate(states)])\n",
+    "\n",
+    "noisy_dict_2"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1889f50a-f051-4f0e-bace-18477122eafe",
+   "metadata": {},
+   "source": [
+    "## Inverse confusion matrix from single-qubit noise model\n",
+    "\n",
+    "Here we assume that the readout error of each qubit is independent with the same confusion probabilities. Then, the confusion matrix $A_1$ for a single qubit can be defined as\n",
+    "\n",
+    "$$\n",
+    "A_1 = \\begin{bmatrix}\n",
+    "P(0|0) & P(0|1)\\\\\n",
+    "P(1|0) & P(1|1)\n",
+    "\\end{bmatrix}\n",
+    "$$\n",
+    "\n",
+    "where $P(y|x)$ is the probability of observing state $|y\\rangle$ when measuring the true state $|x\\rangle$. Using $A_1$, the full $2^n \\times 2^n$ confusion matrix $A$ can be written as \n",
+    "\n",
+    "$$\n",
+    "A = A_1 \\otimes \\dots \\otimes A_1\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 12,
+   "id": "e6ceb0a9-c2ec-4fcd-bb23-457890a8b57e",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0 becomes {'0': 924, '1': 100}\n",
+      "1 becomes {'0': 104, '1': 920}\n"
+     ]
+    }
+   ],
+   "source": [
+    "single_qubit_labels = [[0], [1]]\n",
+    "single_qubit_states = [\"0\", \"1\"]  # Used for dictionary keys\n",
+    "\n",
+    "# we use noise_1 which has same bitflip probability for all qubits\n",
+    "results = [\n",
+    "    cudaq.sample(kernel, 1, label, shots_count=shots, noise_model=noise_1)\n",
+    "    for label in single_qubit_labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(single_qubit_states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "9f030f99-0ad9-4f89-8d99-a570b3c5e745",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[0.90234375 0.1015625 ]\n",
+      " [0.09765625 0.8984375 ]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Construct confusion matrix for single qubit\n",
+    "\n",
+    "A_1 = np.zeros((2, 2))\n",
+    "for i, state in enumerate(single_qubit_states):\n",
+    "    true_state = int(state, 2)\n",
+    "    for key, val in results[i].items():\n",
+    "        observed_state = int(key, 2)\n",
+    "        A_1[observed_state][true_state] = val / shots\n",
+    "\n",
+    "print(A_1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "cbc4a228-935f-413c-9ad3-b6e26f22e802",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[476   3   0   1  12  19   9 501]\n"
+     ]
+    }
+   ],
+   "source": [
+    "A = reduce(np.kron, [A_1] * n_qubits)  # joint confusion matrix\n",
+    "A_pinv = np.linalg.pinv(A)  # Generate pseudoinverse confusion matrix.\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_1), dtype=int)  # Obtain mitigated counts\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "b65c4657-87f7-44df-b205-7fc6195b95a4",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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Tp1q1woCAAAAaclUmI2KilLBggUlSVu3btUzzzyjMmXKqG3btjpy5IhdKwgAAACkJVNh1tfXV8eOHVNCQoJ+/vln/fvf/5Yk3bp1SxaLJcPnW7lypRo3bqwqVarohRde0N69e9Ms+91336lNmzYKCgpS9erV1apVK61bty4zzQAAAIDBuWTmoDZt2qh///4qWLCgTCaTgoODJUl79uyRn59fhs61fv16hYSEaOzYsapWrZqWLVumbt26aePGjfLx8UlR3sPDQ7169ZKfn59cXV31ww8/aMSIEfLx8VH9+vUz0xwAAAAYVKbCbL9+/VSuXDldvHhRzzzzjNzc3CRJFotF3bt3z9C5lixZonbt2qlt27aSpLFjx+rHH39UaGioevTokaJ8nTp1bH7u0qWL1q1bp507dxJmAQAAHjGZCrOS9Mwzz0iSbt++bd323HPPZegccXFxOnDggF5//XXrNrPZrODgYO3evfuBxyclJen333/X33//rcGDB2foswEAAGB8mQqzCQkJmjt3rlavXq2IiAh9++23KlGihKZNm6ZixYrphRdeSNd5oqKilJCQkGI4gY+Pj06cOJHmcTdu3FCDBg0UFxcns9ms0aNHW8ftAgAA4NGRqQlgc+bM0eeff64hQ4bI1dXVur18+fL69NNP7Va5tOTLl0/r1q3Tp59+qgEDBui9995jfVsAAIBHUKbC7BdffKFx48bp2Wefldn8zykqVKhw3zuq/8vLy0sWi0URERE22yMiIuTr65vmcWazWaVKlVLFihX16quvqmnTppo/f37GGwIAAABDy1SYvXTpkkqWLJlie1JSkuLj49N9Hjc3N1WuXFlhYWHWbYmJiQoLC1ONGjXSfZ7ExETFxcWluzwAAAByhkyNmS1btqx27NihYsWK2WzfuHGjKlasmKFzde3aVcOGDVNgYKCqVq2qZcuWKTY2Vm3atJEkDR06VIULF9agQYMkSfPmzVNgYKBKliypuLg4bd26VV9++aXGjBmTmaYAAADAwDIVZnv37q233npLly5dUlJSkr777jv9/fffWrdunebNm5ehczVr1kyRkZGaMWOGwsPDVbFiRS1cuNA6zODChQs2QxliYmI0duxYXbx4Ublz55afn58++OADNWvWLDNNAQAAgIFlKsw2adJEc+fO1ezZs5UnTx7NmDFDlSpV0ty5czO1qkDHjh3VsWPHVPetWLHC5ucBAwZowIABmak2AAAAcphMrzMbFBSkJUuW2LMuAAAAQIZkagIYAAAA4AzSfWe2du3a2rhxo7y9vVWrVi2ZTKY0y27bts0ulQMAAADuJ91hdvjw4cqfP7/17/cLswAAAEB2SHeYfe6556x/v7tsFgAAAOBImRozW7FixRRv7ZKkqKioDK8zCwAAAGRWpsJsUlJSqtvj4uLk6ur6UBUCAAAA0itDS3MtX75ckmQymbR27VrlzZvXui8xMVHbt2+Xn5+ffWsIAAAApCFDYXbp0qWSku/Mrl692ubNXK6uripevLjGjh1r1woCAAAAaclQmN2yZYskqVOnTpo1a5Y8PDyypFIAAABAemTqDWD/+4pZAAAAwBHSHWZDQkL05ptvKm/evAoJCblv2eHDhz90xQAAAIAHSXeYPXjwoOLj461/TwsvUwAAAEB2SXeYvXdoAcMMAAAA4Awytc4sAAAA4AzSfWe2b9++6T7prFmzMlUZAAAAICPSHWbd3d2zsh4AAABAhmVoNQMAAADAmTBmFgAAAIaV7juzzz33nJYuXSoPDw+1bt36vktwff7553apHAAAAHA/6Q6zTz75pNzc3CRJTZo0ybIKAQAAAOmVqdUMMrKyAQAAAJBV0h1mU7Nv3z4dP35cklS2bFkFBgbapVIAAABAemQqzF68eFEDBw7Url27VKBAAUnS9evXVaNGDU2dOlVFihSxayUBAACA1GRqNYORI0cqPj5e69ev17Zt27Rt2zatX79eSUlJGjlypL3rCAAAAKQqU3dmt2/frtWrV8vPz8+6zc/PT2+//bY6dOhgt8oBAAAA95OpO7OPPfaY4uPjU2xPTExUoUKFHrpSAAAAQHpkKswOGTJE48aN0759+6zb9u3bpwkTJmjYsGF2qxwAAABwP+keZlCrVi2bFyXExMSoXbt2slgskqSEhARZLBaNGDGCdWgBAACQLdIdZkeMGJGV9QAAAAAyLEOvswUAAACcyUO9NEGSbt++rTt37thsy58//8OeFgAAAHigTIXZmJgYTZ48WRs2bNDVq1dT7D906NDD1gsAAAB4oEytZvDBBx/o999/15gxY+Tm5qbx48erX79+KlSokN5//3171xEAAABIVabC7A8//KDRo0eradOmslgsCgoKUu/evTVgwAB99dVX9q4jAAAAkKpMhdlr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",
+      "text/plain": [
+       "<Figure size 800x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(\n",
+    "    {\n",
+    "        \"states\": states,\n",
+    "        \"noisy\": np.around(noisy_res_1 / sum(noisy_res_1), 3),\n",
+    "        \"mitigated_sg\": np.around(mitigated / sum(mitigated), 3),\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "ax = df.plot(x=\"states\", y=[\"noisy\", \"mitigated_sg\"], kind=\"bar\", figsize=(8, 5))\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_sg\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2927e72-98bb-41cf-8e77-35ea9572474a",
+   "metadata": {},
+   "source": [
+    "## Inverse confusion matrix from k local confusion matrices\n",
+    "\n",
+    "This method works under the assumption that the readout errors for different qubits are independent of each other and the confusion matrix $A$ can be factorized into the product of $k$ small local confusion matrices. We consider the special case when $k = n$ for $n$ qubits and different $2 \\times 2$ confusion matrices for each qubit\n",
+    "\n",
+    "$$\n",
+    "A = A_1 \\otimes \\dots \\otimes A_n\n",
+    "$$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "1e8fd13a-e0cf-4139-84ca-d81f7a71baa6",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "000 becomes {'000': 388, '010': 235, '111': 18, '001': 174, '011': 79, '100': 58, '101': 28, '110': 44}\n",
+      "111 becomes {'000': 23, '010': 38, '111': 370, '001': 40, '011': 60, '100': 107, '101': 224, '110': 162}\n"
+     ]
+    }
+   ],
+   "source": [
+    "local_labels = [[0] * n_qubits, [1] * n_qubits]\n",
+    "local_states = [\"0\" * n_qubits, \"1\" * n_qubits]\n",
+    "\n",
+    "results = [\n",
+    "    cudaq.sample(kernel, n_qubits, label, shots_count=shots, noise_model=noise_2)\n",
+    "    for label in local_labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(local_states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0f592fb8-2ded-498e-b4fe-eff6eac74750",
+   "metadata": {},
+   "source": [
+    "The local confusion matrices are generated using the marginal probability distribution for each qubit."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "id": "7fabcc1f-8d9c-42c2-b02a-3ce42c1e34c6",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "counts = [dict(list(results[i].items())) for i, state in enumerate(local_states)]\n",
+    "matrices = []\n",
+    "\n",
+    "for k in range(n_qubits):\n",
+    "    matrix = np.zeros([2, 2], dtype=float)\n",
+    "    marginalized_counts = []\n",
+    "    total_shots = []\n",
+    "    for i in range(2):\n",
+    "        marginal_cts = dict(results[i].get_marginal_counts([k]).items())\n",
+    "        marginalized_counts.append(marginal_cts)\n",
+    "        total_shots.append(sum(marginal_cts.values()))\n",
+    "\n",
+    "    # matrix[i][j] is the probability of counting i for expected j\n",
+    "    for i in range(2):\n",
+    "        for j in range(2):\n",
+    "            matrix[i][j] = marginalized_counts[j].get(str(i), 0) / total_shots[j]\n",
+    "    matrices.append(matrix)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "7f016f9b-3243-42b3-ab59-4d03f7765b82",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[0.85546875 0.15722656]\n",
+      " [0.14453125 0.84277344]]\n",
+      "\n",
+      "[[0.6328125  0.38476562]\n",
+      " [0.3671875  0.61523438]]\n",
+      "\n",
+      "[[0.70800781 0.32226562]\n",
+      " [0.29199219 0.67773438]]\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "for m in matrices:\n",
+    "    print(m)\n",
+    "    print()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "id": "51734299-307f-4081-b8cc-1968ebfc7d52",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[559  -1 -58  32 -28  26 -16 510]\n",
+      "\n",
+      "Corrected for negative counts:\n",
+      "[521   0   0  35   0  22   0 446]\n"
+     ]
+    },
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAe0AAAHACAYAAACPhjATAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAAA9VUlEQVR4nO3deVxVdf7H8fe9CKJiolAuaIs64AIkalrmMmJO5ZZgWuOWW4uplT8dxTLLzKFmstxaLM20LCsVncZtKiudRHJBLTVLM0FDQ1CLRUE4vz8cbt1AvZtcjvf1nMdt4tzzPedzsfrcz+d8z/dYDMMwBAAAKjyrtwMAAACOIWkDAGASJG0AAEyCpA0AgEmQtAEAMAmSNgAAJkHSBgDAJEjaAACYBEkbAACTqOTtAFBxffnll/r3v/+tHTt2KDMzUwUFBQoODtaf/vQnderUSb169VKtWrW8GuOBAwf04osvKjU1VadOnVJxcbFGjx6tMWPGlFsMERERkqT9+/eX2zmdFRsbq6NHj0qSBg0apMmTJ19w3/nz5+uf//ynJMnPz0979+4tlxgdceTIEXXp0kVhYWHasGGDt8MByh1JG6VkZ2dr3Lhx2rx5syQpLCxMbdu2VdWqVZWZmanU1FRt3rxZs2bN0ltvvaUbb7zRK3Hm5eXpgQce0NGjRxUZGan27dvLz89PTZs29Uo8ZvHRRx9pwoQJCggIKPP95cuXe/ycJFvAM0jasPPrr7+qf//+OnTokBo2bKhp06apdevWdvsUFBQoKSlJc+bMUWZmppcilb7++msdPXpUMTExWrp0qdfiWLNmjdfO7azIyEh98803+vTTT3XnnXeWen/Hjh364YcfFBUVpa+//toLEV5c7dq1tWbNGvn7+3s7FMAruKYNO9OmTdOhQ4cUFham9957r1TClqSAgADdc889WrlypRo2bOiFKM/LyMiQJF1//fVei0GSGjVqpEaNGnk1Bkf16dNH0oWr6WXLltntV9H4+/urUaNGuvbaa70dCuAVJG3YpKen69///rckadKkSQoODr7o/qGhoWUm7dWrV+u+++5TmzZtFBkZqc6dO2vSpEk6dOhQmceJjY1VRESEjhw5oi1btmjYsGG66aabFB0drbi4OK1cudJu/5SUFEVERGjixImSpKSkJEVERNheJf748x8NGjRIERERSklJsdv+66+/6qWXXlLPnj3VokULW+v93nvv1axZs1RYWGi3/8XOc+rUKb344ovq3r27brzxRsXExCg+Pl5vvPGGzpw5U2r/ks82aNAgFRYW6vXXX1f37t0VHR2ttm3bavTo0Tp48OAFP9OlhIeHKzIyUl9++aWOHz9u915ubq7Wrl2rOnXqqH379hc8xoEDBzR79mzde++96tChgyIjI9W2bVsNGTKkzK5DQkKCunTpIkk6evSo3Z/V739vc+bMUUREhObMmaOffvpJjz/+uDp16qTmzZsrISFB0vk2e0REhGJjY+3OMW3aNEVERKh///46d+5cqRheeuklRUREKC4uTmfPnnX8FwZUMLTHYfPZZ5+pqKhIV111Van/KDrCMAwlJCRo5cqVqlSpklq3bq2QkBDt2bNHK1as0Nq1azV79mx17NixzPHLly/Xq6++qmbNmqlDhw46evSodu7cqYkTJ+rUqVMaMmSIpPNfFuLi4nT48GHt2LFD1157rVq1auXOR7fJz89X//799d1336lWrVq6+eabbdfyDx06pFdeeUVDhw51qD2bnp6u++67T0ePHlWtWrXUqVMnFRYWKiUlRS+88ILWrl2rhQsXqkaNGqXGFhYW6oEHHlBqaqpat26tRo0aaffu3fr444+VkpKipKQk1a9f36XP2KdPH33zzTdasWKFRo4cadu+du1a5eXlafDgwbJYLBccv3DhQi1btkwNGzZUeHi4rrrqKmVkZCglJUXJycnatWuXJk2aZNu/VatWysvL0/r161W1alXdfvvtF43vxx9/VFxcnPz9/dWyZUsZhqGaNWtedMzEiRO1c+dObd++XTNnztT48eNt723cuFHz5s1TUFCQZs6cqcqVK1/qVwRUXAbwP3/729+M8PBwY/DgwS6Nf/fdd43w8HCjbdu2xt69e23bi4uLjdmzZxvh4eFG69atjaysLLtxnTt3NsLDw43mzZsbGzZssHtv+fLlRnh4uNGqVSsjPz+/zPcmTpxYZjzh4eFGeHj4BeMdOHCgER4ebmzZssW2LSkpyQgPDzdGjBhhFBQU2O1fVFRkpKSkGGfPnnXoPH379jXCw8ONhx56yMjNzbVtz8rKMuLi4ozw8HDj//7v/+zGbNmyxXa83r17Gz///LPtvTNnzhjDhg0zwsPDjSeffPKCn6ssJb/jrVu3Gr/88osRHR1tdO3a1W6fe++914iIiDDS0tKM9PR0Izw83GjatGmpY6WkpBhpaWmlth88eNDo2LGjER4ebuzatcvuvZLjde7c+YIxlvwzEh4ebowfP77U7/lSx0lLSzNat25tREREGJ9//rlhGIaRkZFhtG3b1ggPDzfWrFlzwXMDZkF7HDbZ2dmSpJCQEJfGv/nmm5KkUaNG2c3gtlgsGj16tCIiIvTLL7/ogw8+KHP8wIED1blzZ7tt8fHxatiwoX799Vd98803LsXljBMnTkiSbr311lLVtNVqVZs2bS446/r3tm3bpl27dqlKlSqaNm2aqlatanuvVq1aeuaZZySdn8R27NixUuMtFosSExN19dVX27ZVrlxZjzzyiCTZZva7onr16uratasOHz6sr776SpL0ww8/aMeOHbrpppvUoEGDi45v06ZNmfs0bNhQDz/8sCRp3bp1LscXHBysKVOmOPR7/r0GDRooMTFRhmFowoQJSk9P19ixY3Xy5EkNHDiwzIl3gNmQtOERx44dU1pamiQpLi6u1PsWi0Xx8fGSVOoacok/JuwSJZO8/ngN9nKIioqSdP5e5ZUrV+rUqVMuHackGXbo0EGhoaGl3o+MjFSTJk1UXFxs2/f36tWrpyZNmpTa7qnfxR8npJX8v6MT0Equf7/44ot68sknlZCQoISEBP3nP/+RpAvOX3DELbfcourVq7s09rbbbtPQoUN16tQpxcXFaceOHYqMjLTNfwDMjmvasClZKCUrK8vpsSVJJDg4WEFBQWXuUzLj90IJp169emVuLzleeUwgatu2re6//34tWLBAEydOlMVi0XXXXaeWLVuqS5cuio2NldV66e+6JZ/xYtedr732Wn377bdl/j7q1q1b5piS30VBQYEjH+eCbr75ZtWvX1/r16/X448/rlWrVikoKEh33HHHJcdu2LBBkyZNuugXmpycHJdjCwsLc3msJI0fP16bNm3SgQMHVLVqVc2cOdPpqh2oqKi0YdO8eXNJ0t69e1VUVFTu57/Y5KfLobi4uMzt48eP18cff6zJkyfrjjvuUH5+vlasWKFRo0apX79+ysvLu+yxOfLFwB0Wi0VxcXHKz8/XxIkTlZmZqe7duyswMPCi444fP66xY8fq1KlTGjFihFatWqXt27dr37592r9/vxYsWOB2bJeK4VJ27dqlH3/8UdL5BXi+++47t2MCKgqSNmw6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rZLV+tt34BdeeEEJCQlq2rSpKleurH/961+aNWuWpkyZoqZNm2rfvn168sknVbVqVcXFxSk3N1cPPvig2rVrp3/+8586cuTIJR+kUatWLVmtVq1fv1733Xef/Pz8Su3z4Ycfqm/fvnrrrbfUuHFjW8Wfm5ur3r17a/LkyZKkN998Uw888IDWr1+voKAgLVu2TLfccosSExPVoUMH27G3bdumiRMnavLkyWrdurXS0tL05JNPSpJGjx7tyh8dAGcYgMlMnDjRGDlypGEYhlFcXGx8+eWXRmRkpPHcc8/Z3m/Xrp1x9uxZ25iVK1cat99+u1FcXGzbdvbsWSM6OtrYtGmTbVybNm2MvLw82z7vvvuu0aJFC6OoqKjMWLKysozw8HBj//79hmEYRnp6uhEeHm689dZbdvvddtttxkcffWS37eWXXzbuuecewzAMY+nSpUabNm2MM2fO2J07PDzc2Lt37wV/F++8845x4403GjExMcagQYOMuXPnGmlpabb3S+K52DEMwzCKioqMmJgYY8OGDbZt4eHhxscff2y333333We89tprdttWrlxp3HrrrRc9PgDPoNKGKX3++eeKiYlRYWGhDMNQjx49NGbMGNv74eHhdtexv/32W6Wlpally5Z2xzl79qxde7vkueElYmJilJeXp4yMDIWFhenHH3/U7NmztWvXLp08eVLG/x6Sl5GRofDwcNu4yMhI29/n5eUpLS1NTzzxhK0qlaRz586pevXqkqSDBw8qIiJClStXtjv3pQwYMEB33XWXvvrqK+3atUvr1q3TvHnz9Oqrr+rWW2+94LgTJ05o5syZ+uqrr5SVlaXi4mLl5+frp59+uuj5vv32W+3YsUOvvfaabVtRUZHOnj2r/Px8u98dAM8jacOU2rZtq6efflr+/v665pprVKmS/T/Kf0weeXl5at68uV544YVSx6pVq5bD533ooYcUFhamZ599Vtdcc42Ki4vVo0cP27OhS1StWtXu3JI0bdo03XjjjXb7/b6l7qqgoCDFxsYqNjZWjz32mIYPH37JpD1x4kSdOnVKTzzxhOrVq6eAgADdc889pT7HH+Xl5WnMmDH6y1/+Uuq933/hAHB5kLRhSlWqVNF1113n8P7NmzfX2rVrFRISoqCgoAvut3//fp05c0aBgYGSpJ07d6pq1aqqW7euTp48qUOHDunZZ59V69atJZ2/xnspoaGhuuaaa5Senq5evXqVuU+jRo20atUqnT171pb8du7c6fDnK2GxWNSwYUPt2LFDkmzXsIuKiuz227Fjh5566il16tRJ0vlOwcmTJ+328ff3LzWuWbNmOnTokFO/ewCew+xx+ISePXuqZs2aGjlypLZt26b09HSlpKTo2Wef1bFjx2z7FRQU6IknntCBAwf0xRdfaM6cORo4cKCsVqtq1Kih4OBgvf/++zp8+LCSk5P13HPPOXT+Rx55RK+//roWL16sQ4cOaf/+/Vq+fLltolyPHj1ksVg0efJk27nffPPNix5z3759GjlypNatW6cDBw7o8OHD+vDDD7V8+XLbrPGQkBAFBgZq06ZNOnHihO1WsOuvv17/+te/dPDgQe3atUvjx4+3fVEpERYWpuTkZGVmZur06dOSZJt0N3fuXH3//fc6ePCgVq9erZdeesmxPwgAbiFpwydUqVJF77zzjurVq6fRo0erW7dueuKJJ3T27Fm7yvuWW27RddddpwEDBuixxx5TbGys7Vq51WrVSy+9pD179qhHjx5KTEzUhAkTHDp/37599eyzz2rFihXq2bOnBg0apKSkJNWvX1+SVK1aNb322mv67rvv1Lt3b7300ksaP378RY9Zu3ZthYWF6eWXX1bfvn0VFxenxYsXa8yYMRo5cqQkqVKlSpo8ebLef/99dejQQQ8//LAkafr06Tp9+rTi4uI0YcIEDRo0SCEhIXbHnzhxojZv3qw///nPiouLk3T+/vjXXntN//3vf3X33XerX79+euuttxQWFubQ7wGAeyxGyUwawMclJCTol19+0SuvvOLtUACgTFTaAACYBEkbAACToD0OAIBJUGkDAGASJG0AAEyCpA0AgEmQtAEAMAmSNgAAJkHSBgDAJHwyaRcUFGjOnDkqKCjwdihOM2vsxF2+iLv8mTV2s8btq3w2ac+dO9eU/5CaNXbiLl/EXf7MGrtZ4/a2rVu36qGHHlL79u0VERGhTz755JJjUlJSFBcXp8jISHXt2lUrVqxw+rw+mbQBAHBHXl6eIiIi9NRTTzm0f3p6uh588EG1bdtWq1at0n333afJkydr06ZNTp2X52kDAOCkTp062Z5H74ilS5eqfv36SkhIkCQ1atRI27dv11tvvaUOHTo4fByfrbSrVavm7RBcZtbYibt8EXf5M2vsZo3b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",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# To find the joint pseudoinverse confusion matrix, we can first perform pseudoinverse of the\n",
+    "# local confusion matrices and then do the tensor product\n",
+    "\n",
+    "pinv_confusion_matrices = [np.linalg.pinv(m) for m in matrices]\n",
+    "A_pinv = reduce(np.kron, pinv_confusion_matrices)\n",
+    "\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_2), dtype=int)\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")\n",
+    "\n",
+    "A_joint = reduce(np.kron, matrices)\n",
+    "plot_cmat(A_joint)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "4261d8a3-b701-4939-8219-c0d823d42747",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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iIiIyN04ZWendu3a8fLLL1OyZEkMBgP169cHYM+ePfj6+uZogSIiIiIid5OtMDto0CCqVq3KxYsXeeqpp3BxcQHAZDLRu3fvHC1QRERERORushVmAZ566ikAbt26ZW175pln7r8iEREREZFMytac2dTUVObMmUPDhg2pU6cOZ86cAeDdd9+1LtklIiIiIpLbshVm586dyyeffMKIESNwdna2tlerVo2PPvoox4oTEREREbmXbIXZzz77jIkTJ/L0009jNP55iOrVq3Py5MkcK05ERERE5F6yFWYvXbpExYoV07WnpaWRkpJy30WJiIiIiGRGtsKsv78/O3bsSNe+ceNGAgMDs3y8FStW0LRpU0JCQujQoQN79+69a9+vv/6adu3aERoaSu3atWnTpg2ffvppls8pIiIiIo4vW6sZ9O/fn1deeYVLly6RlpbG119/ze+//86nn37K/Pnzs3Ss9evXEx4ezoQJE6hVqxZLly6lV69ebNy4ES8vr3T93d3d6devH76+vjg7O/Ptt98yevRovLy8aNiwYXYuR0REREQcVLbuzDZv3px58+YRFRVF4cKFmTlzJidOnGDevHnWt4Fl1uLFi+nYsSPt27fH39+fCRMm4OrqSmRkZIb969Wrx+OPP46fnx8VK1ake/fuVK9enZ07d2bnUkRERETEgWV7ndnQ0FAWL158XydPSkriwIED9O3b19pmNBqpX78+u3fv/sf909LS+OWXX/j9998ZPnz4fdUiIiIiIo4n22E2J8TFxZGamppuOoGXl9c9V0W4fv06jRo1IikpCaPRyLhx47J8R1hEREREHF+mw+zDDz/Mxo0b8fT05KGHHsJgMNy177Zt23KkuLspWrQon376KQkJCURFRTFlyhQqVKhAvXr1cvW8IiIiIpK/ZDrMhoWF4ebmZv37vcJsZnl4eGAymYiNjbVpj42Nxdvb+677GY1GKlWqBEBgYCAnTpxgwYIFCrMiIiIiD5hMh9lnnnnG+vd27drlyMldXFwICgoiKiqK5s2bA2CxWIiKiqJLly6ZPo7FYiEpKSlHahIRERERx5Gt1QwCAwPT3U2F23Ngs7rObM+ePVmzZg2ffPIJJ06cYPz48SQmJloD88iRI5k2bZq1//z58/npp584c+YMJ06cYNGiRXz++ec8/fTT2bkUEREREXFg2XoALC0tLcP2pKQk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",
+      "text/plain": [
+       "<Figure size 800x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df = pd.DataFrame(\n",
+    "    {\n",
+    "        \"states\": states,\n",
+    "        \"noisy\": np.around(noisy_res_2 / sum(noisy_res_2), 3),\n",
+    "        \"mitigated_k_local\": np.around(mitigated / sum(mitigated), 3),\n",
+    "    }\n",
+    ")\n",
+    "\n",
+    "ax = df.plot(x=\"states\", y=[\"noisy\", \"mitigated_k_local\"], kind=\"bar\", figsize=(8, 5))\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_k_local\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9329a30d-9224-42b1-9a66-1e87ba7c2674",
+   "metadata": {},
+   "source": [
+    "## Inverse of full confusion matrix\n",
+    "\n",
+    "Here we generate a quantum circuit for each of the basis states of $n$ qubits (i.e., $2^n$ combinations). This gives more accurate readout error mitigation. Since it scales exponentially with the number of qubits, it is only practical for small devices."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 21,
+   "id": "cf6025e8-1755-4c8f-96fa-1b67830d448d",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "000 becomes {'000': 367, '010': 248, '111': 17, '001': 159, '011': 83, '100': 68, '101': 35, '110': 47}\n",
+      "001 becomes {'000': 161, '010': 93, '111': 46, '001': 363, '011': 253, '100': 17, '101': 76, '110': 15}\n",
+      "010 becomes {'000': 234, '010': 378, '111': 27, '001': 100, '011': 150, '100': 36, '101': 25, '110': 74}\n",
+      "011 becomes {'000': 106, '010': 145, '111': 65, '001': 251, '011': 386, '100': 11, '101': 30, '110': 30}\n",
+      "100 becomes {'000': 83, '010': 34, '111': 99, '001': 29, '011': 18, '100': 388, '101': 144, '110': 229}\n",
+      "101 becomes {'000': 22, '010': 13, '111': 247, '001': 70, '011': 43, '100': 163, '101': 371, '110': 95}\n",
+      "110 becomes {'000': 32, '010': 77, '111': 157, '001': 14, '011': 30, '100': 233, '101': 85, '110': 396}\n",
+      "111 becomes {'000': 14, '010': 31, '111': 393, '001': 38, '011': 60, '100': 95, '101': 233, '110': 160}\n"
+     ]
+    }
+   ],
+   "source": [
+    "results = [\n",
+    "    cudaq.sample(kernel, n_qubits, label, shots_count=shots, noise_model=noise_2)\n",
+    "    for label in labels\n",
+    "]\n",
+    "\n",
+    "for i, state in enumerate(states):\n",
+    "    res = dict(list(results[i].items()))\n",
+    "    print(f\"{state} becomes {res}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 22,
+   "id": "28f2b2cb-13d3-4806-852d-06ea91e58c1d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# generate full confusion matrix\n",
+    "A_full = np.zeros((2**n_qubits, 2**n_qubits))\n",
+    "for i, state in enumerate(states):\n",
+    "    true_state = int(state, 2)\n",
+    "    for key, val in results[i].items():\n",
+    "        observed_state = int(key, 2)\n",
+    "        A_full[observed_state][true_state] = val / shots"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 23,
+   "id": "c3b0b80b-63ac-438a-9f3d-a6a3687da167",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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slqtOnfunNN3rapWrZqkS5c4Xa7KSklJsRt7rRWek75cPD///PNl59aqVUsDBw7UvHnztHnzZn3wwQeqU6eOvvnmGy1ZsuSqxy78jIWfuTgl/fv4o169eslqterzzz+X5FhrfNOmTTp//rw6d+6sv/3tb2rQoIECAwNtXzJ++umnaxrz1WRkZOj//u//dPHiRfXq1UsWi0VTpkyx3cIVMDuSNmxuvvlmde3aVZL03HPPXfV8bnp6un744QdJUvXq1W3t7zVr1hQZaxiG4uPjJV1qQZeEm266SZJsMf7et99+a7s5iyOaNGmifv36SZIOHjx41fGtWrWSJG3ZssW2uO33Dhw4oIMHD8pqteq2225zOA5Pqlmzpjp16qSgoCA1a9bModvRnj171jb3jwzD0EcffVTsvMIvUMVdQ+0phQvQTpw4oZ49eyouLk5Dhw7V2bNnNX78+CLX1wNmRNKGnWnTpumWW27RsWPH1K9fP+3YsaPImNzcXK1atUo9e/a0S4jDhg2TJL300kv69ttvbdsNw9BLL72kgwcP6oYbblDfvn2v/QeR1KZNG0nSokWL7M4BHzt2TLGxsTIMo8icTz75RNu3by/SOs/Ly9OWLVskOXbOtWXLlmratKnOnz+v6dOnKycnx/ZeRkaGpk+fLknq0qXLZc9fl4RFixYpMTFR7733nkPjCxfCbdy4Ub/88otte35+vubPn6+kpKRi51WtWlVly5bVqVOnXF7cdzWLFy/Wli1bVL9+fT311FOSpAkTJigqKkp79uyxPQQFMDMWosFO5cqV9e677+rxxx/X119/rf79+6tWrVoKDw9X+fLlderUKe3du1fZ2dkKDAy0VbOS9OCDDyopKUkffvihevfurdtuu812c5WjR48qICBAs2fPLrEng40aNUobN27Ul19+qbvvvluRkZHKyMjQN998o+bNmysqKqpIkvn666+1fPlyValSRY0aNVLVqlWVlZWlPXv2KD09XdWqVdOIESMcOv6cOXM0ePBgffbZZ+rUqZNatmypixcvKjExUZmZmWrcuLEteZtFx44d1bhxY+3fv1933323WrVqpfLly2vv3r365ZdfNHLkSL322mtF5pUtW1bR0dHauHGjevbsqRYtWtjOXc+aNcvtuLZv364FCxaofPnymj9/vu0SuzJlyuiFF15QTEyM3nzzTbVq1Up33XWX28cDvIWkjSKCg4P11ltvafPmzfr444+VlJSkhIQE5eXlKSgoSFFRUerQoYPuu+8+u1udWiwW/eMf/1D79u313nvvaf/+/crJyVFISIh69eqlkSNHlui9ymvXrq2VK1dq3rx5SkxM1Oeff67Q0FA9/PDDGjFihK0z8Hu9evVSQECAdu7cqcOHDysjI0OVKlVSjRo1NHjwYPXt2/eqd+f6/fHXrFmj119/XZ9++qm++OILWa1W3Xrrrbr33ns1aNAgtxddlbQyZcrorbfe0quvvqqNGzcqISFBgYGBioqK0oIFC5SVlVVs0pakZ555RkFBQdqyZYs2btxoa1e7m7QLz2Pn5+dr+vTpql+/vt37NWvWVFxcnB555BE98cQTatCggct3kwO8zWIU1yMEAAClDue0AQAwCZI2AAAmQdIGAMAkSNoAAJgESRsAAJMgaQMAYBIkbQAATIKkDZRSx44dU3h4uEP3OgfgG0jaMJ3Y2FiFh4crPDxcERER6ty5sxYtWnRNH0ZRWqWkpGjChAlq27atIiMj1b59e40ePVpHjhyR5F7iDw8P16effurpkAG4gduYwpTatWunuLg45ebm6ssvv9QzzzyjsmXLatSoUUXG5ubmyt/f3wtRXpKXl2d7ypWn9zts2DDdeuutWrRokW688UadOHFCmzdv1q+//urx4wHwPiptmJK/v79uvPFGhYaGql+/fmrTpo3tGeCxsbF65JFH9PLLL6tt27a65557JEmpqal67LHH1LJlS7Vq1UqjR4/WsWPHbPssnLdo0SLdfvvtat68uaZPn273hLDNmzfrr3/9q1q2bKnWrVtr1KhRSk5Otr1fWNmuW7dOAwYMUGRkpO1xlR988IHuvfdeRUZG6p577tGKFSvsPtPevXvVs2dPRUZGqlevXletjg8fPqzk5GQ99dRTatasmUJDQ9WiRQuNHz9ezZo1kyR16tRJktSzZ0+Fh4dr4MCBtmMNHTpUrVu3VosWLTRgwADt37/ftu/o6GhJ0pgxYxQeHm77WZI+/fRTxcTEKDIyUp06dfLZLgfgDVTauC6UK1fO7pGPhQ+yWLZsmaRLVenw4cPVrFkzrVixQmXKlNFLL72kESNG6F//+petEk9ISFC5cuX01ltv6fjx45oyZYqqVKmi8ePHS5JycnI0dOhQhYeHKzs7W/Pnz9eYMWP04Ycfymr97Tvw7NmzFRsbq4YNG6pcuXL617/+pfnz52v69Olq2LChDh48qGnTpqlChQqKiYlRVlaWRo0apTZt2uif//ynjh07dtUHaVStWlVWq1UbN27U4MGD5efnV2TMBx98oD59+uiNN95Q/fr1bRV/VlaWevbsqalTp0qSXn/9dT300EPauHGjAgMDtWrVKt1xxx2Ki4tTu3btbPvesWOHJk+erKlTp6ply5ZKTk7WtGnTJEljx4515V8dAGcYgMlMnjzZGD16tGEYhlFQUGB89dVXRkREhPHcc8/Z3m/Tpo1x4cIF25y1a9cad999t1FQUGDbduHCBaNJkybGli1bbPNatWplZGdn28a88847RrNmzYz8/PxiY0lPTzfCwsKMQ4cOGYZhGCkpKUZYWJjxxhtv2I276667jI8++shu24svvmg88MADhmEYxsqVK41WrVoZ58+ftzt2WFiYceDAgcv+Lt5++22jadOmRlRUlDFw4EBj0aJFRnJysu39wniutA/DMIz8/HwjKirK2LRpk21bWFiY8cknn9iNGzx4sPHKK6/YbVu7dq1x5513XnH/ADyDShum9MUXXygqKkp5eXkyDEPdunXTuHHjbO+HhYXZncf+9ttvlZycrObNm9vt58KFC3bt7cLnhheKiopSdna2UlNTFRoaqh9//FELFizQnj17dPr0aRn/e0heamqqwsLCbPMiIiJs/zs7O1vJycl68sknbVWpJF28eFGVKlWSJB05ckTh4eEqV66c3bGvpn///rrvvvv09ddfa8+ePdqwYYMWL16sl19+WXfeeedl5506dUrz5s3T119/rfT0dBUUFCgnJ0c///zzFY/37bffateuXXrllVds2/Lz83XhwgXl5OTY/e4AeB5JG6bUunVrPf300ypbtqxuuukmlSlj/0f5j8kjOztbjRs31uzZs4vsq2rVqg4f9+GHH1ZoaKieffZZ3XTTTSooKFC3bt1sz4YuVKFCBbtjS9LMmTPVtGlTu3G/b6m7KjAwUNHR0YqOjtbjjz+u4cOHXzVpT548WWfOnNGTTz6pmjVryt/fXw888ECRz/FH2dnZGjdunP7yl78Uee/3XzgAXBskbZhS+fLldcsttzg8vnHjxlq/fr2Cg4MVGBh42XGHDh3S+fPnFRAQIEnavXu3KlSooBo1auj06dM6evSonn32WbVs2VLS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",
+      "text/plain": [
+       "<Figure size 640x480 with 2 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plot_cmat(A_full)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "id": "507852a8-6715-4802-b6a0-10967d09ed94",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "0.09734490298929"
+      ]
+     },
+     "execution_count": 24,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Distance between full confusion matrix and tensored confusion matrix\n",
+    "np.linalg.norm(A_joint - A_full)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "id": "9e6c3874-2905-4c25-9bf0-22ab27756fed",
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Mitigated counts:\n",
+      "[ 714 -100 -211  152  -49   63   32  422]\n",
+      "\n",
+      "Corrected for negative counts:\n",
+      "[683   0   0  39   0   0   0 302]\n"
+     ]
+    }
+   ],
+   "source": [
+    "A_pinv = np.linalg.pinv(A_full)\n",
+    "mitigated = np.array(np.dot(A_pinv, noisy_res_2), dtype=int)\n",
+    "print(f\"Mitigated counts:\\n{mitigated}\")\n",
+    "\n",
+    "if not np.all(mitigated >= 0):\n",
+    "    positive_dist = find_closest_distribution(mitigated / shots)\n",
+    "    mitigated = get_counts_from_distribution(n_qubits, shots, positive_dist)\n",
+    "    print(f\"\\nCorrected for negative counts:\\n{mitigated}\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "id": "cb109820-5478-4179-84b8-66e6af1008fc",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "iVBORw0KGgoAAAANSUhEUgAAA+kAAAHSCAYAAACQH4o4AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjguNCwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy8fJSN1AAAACXBIWXMAAA9hAAAPYQGoP6dpAAB9xElEQVR4nOzdeVxU1f/H8ffMAG4ouytuiAqCa5bfSM3Ulq9Lmqb5TU39mpammXtoueRaaeaWS5KauYRRlqZWaptlueaWO7lvwOAKCszM7w9/Tc1XNIWBGeH1fDx4yJx77rmfM5cBP/eee47BZrPZBAAAAAAAXM7o6gAAAAAAAMANJOkAAAAAALgJknQAAAAAANwESToAAAAAAG6CJB0AAAAAADdBkg4AAAAAgJsgSQcAAAAAwE2QpAMAAAAA4CZI0gEAAAAAcBMk6QAAAAAAuAm3SNIXL16sxo0bq3r16mrXrp127dp1y7qdO3dW1apVb/rq2bNnLkYMAAAAAIDzebg6gNWrV2vChAkaPXq0atasqYULF6p79+5au3atAgICbqo/ffp0paen219fuHBBrVq10hNPPJGbYQMAAAAA4HQuv5M+f/58tW/fXm3btlVoaKhGjx6tggULKi4uLtP6vr6+CgoKsn/99NNPKliwIEk6AAAAAOCe59IkPS0tTXv37lVUVJS9zGg0KioqSjt27LijNuLi4tS8eXMVLlw4p8IEAAAAACBXuDRJT05OlsViuWlYe0BAgBITE/9x/127dungwYNq165dToUIAAAAAECucfkz6dnxySefqEqVKqpRo8Zd75uUdFk2Ww4EBQAAAADA3xgMUkBA0Tuq69Ik3c/PTyaTSUlJSQ7lSUlJCgwMvO2+KSkp+vLLL/Xyyy9n6dg2m0jSAQAAAABuxaXD3b28vBQREaFNmzbZy6xWqzZt2qTatWvfdt+1a9cqLS1NTz75ZE6HCQAAAABArnD5cPdu3bpp6NChioyMVI0aNbRw4UKlpqaqTZs2kqQhQ4aoRIkSGjhwoMN+n3zyiZo2bSo/Pz9XhA0AAAAAgNO5PElv1qyZzGazpk2bpoSEBIWHh2vevHn24e5nzpyR0eh4wz8+Pl7btm3TBx984IqQAQAAAADIEQabLX8+mZ2YmL8mjouLi9XSpYtkNiepUqXK6t9/sKpVi7xl/cuXL2vu3Pf0ww8bdOnSJZUoUUr9+g3Qgw/Wt9dJSDivWbOm65dffta1a9cUHBysYcNGKiysmiSpfv26mbbdu/fLevbZ55zbQQAAAORpNptNGRnprg4DuCUPD08ZDIZMtxkMUmDgnU0cR5KeD6xf/7XGjh2pQYOiVa1apGJjl+rbb9dp6dI4+fn531Q/PT1dvXp1l5+fnzp37qagoOI6e/aMvL2LqnLlKpKkS5cu6b//7ag6deqqdeu28vX108mTJ1SmTLDKlAmWJCUlOS6j98svP2vixDFatuwzex0AAADgn2RkpCsp6axsNqurQwFuyWAwKiCgpDw8PDPZdudJusuHuyPnLVu2WC1btlbz5jcm2Rs8OFqbNm3UqlVfqHPnrjfV//LLz3Xp0kXNnv2BPDxu/IiUKlXaoc7ixQtVvHgJDRs20l5WunQZhzoBAY4z9G/c+L3q1KlLgg4AAIA7ZrPZdPGiWUajUT4+QTIYXDr3NZApm82qCxeSdPGiWf7+xW95R/1OkKTncenp6Tp4cL86d+5mLzMajapb9wHt3bsr0302bvxBkZE1NHnym9q48Xv5+vrq0UefUMeOXWQymSRJP/30gx544F967bWh+u237QoKCtJTT7XTk08+lWmbZnOSfv55o4YPH+38TgIAACDPslotSk+/Jh+fQHl5FXR1OMAtFS3qq4sXE2W1WmQyZT3V5jJUHnfx4gVZLBb5+zsOa/f3979pffo/nT59St99t15Wq0Vvvz1VXbs+r2XLFmvhwhiHOitWxKls2XJ6553pat36ab377iStWbMq0zbXrFmlwoWL6OGHH3Fe5wAAAJDnWa03hrhnJ+kBcsOfP6N//sxmFT/puInVapOvr5+GDBkuk8mksLBwJSSc19Kli/Tf//b8/zpWhYVV0wsvvCRJqlIlTH/8cUQrVsTp3/9ucVObX375hR577AkVKFAgV/sCAACAvCE7w4eB3OCsn1HupOdxPj6+MplMMpvNDuVms1kBAQGZ7hMYGKiyZcvbh7ZLUvnyFZWUlKT09BszagYEBKpChYoO+5UvX1Hnzp29qb2dO3fo+PFjatGidTZ7AwAAAAB5G0l6Hufp6akqVcK0bdtme5nVatW2bVsUEVEj032qV6+pU6dOOAzTOHHiuAICAuXp6Wmvc/z4MYf9Tpw4ppIlS93U3qpVn6tq1XD7zPAAAABAdhmNBnl4GHPty2jM3Tv5MTFz1LXrs7l6TLgHhrvnAx06dNS4caMUFlZN4eERio1dotTUVDVv3lKSNGbMCAUFFdeLL/aRJLVu3VZxcbGaOnWS2rZ9RidPntCiRfP19NPP2Nt85pln9eKL/9WHH36gxo0f1e+/79UXX3ymIUOGOxz76tUr+vbbderT55Vc6y8AAADyNqPRIB/fwvIw5d49xwyLVRcvpMhqzZ11nP/zn84O//9G/kGSng80afKYLlxI1rx5s2U2Jyk0tIomT54uf/8bw93PnTsro/GvX3AlSpTUO+9M17Rp76hr1/8oMDBI7dp1UMeOXex1wsMjNH78JM2ZM0MLFsxTqVKl9fLLA/XYY/92OPa6dV/LZrOpadMncqezAAAAyPOMRoM8TEb1W7ZDh89fyfHjhRb31tQOtWU0GnItSS9cuLCkwrlyLLgXg81my52fMjeTmHhZ+bPnAAAAwL0jPT1NSUlnFBBQSp6eXpIkDw+j/PyKqPm0H7X39KUcjyGidDF9+XIDJSdfVUbGnc3c3adPT4WGVpaXl5dWrvxcnp6eatWqjbp3f0GSdPbsWb377lvatm2LDAaj6tV7UP37D7bfSIuJmaMff/xeCxYskSRt375Vs2ZN0x9/xMvDw0MVK4Zo5Mhxstlsat++ld5/f6HCwqrZjx8bu0Qff7xEy5d/4XBDDjkns5/VPxkMUmBg0Ttqh7MFpz7Pk9vP6gAAAADuas2aVSpYsJDmzl2gXr36asGCedqy5RdZrVZFRw/QpUuXNH36XE2ZMlOnT5/SiBHRmbaTkZGhYcMGqVat+7Rw4TLNnj1fTz7ZRpJBpUqVVt26D+jLL1c67PPllyvVrFlLEvR7EMPd8zmj0SBfv0IyGU3/XPkOWKwWXUhOzbVhQAAAAIC7qlSpsn0J47Jly+nTT2O1desWSVJ8/BHFxn6uEiVKSpJee220Ondur3379io8PMKhnZSUq7py5YqiouqrTJlgSXJYaalFi9aaNGmC+vbtLy8vLx04sF/x8Yc1ceLk3OgmnIwkPZ8zGg0yGU169YdXFX8xPltthfiEaGLDibn6rA4AAADgripVquzwOiAgUMnJZh09elTFi5ewJ+iSVLFiiLy9i+ro0T9uStKLFfNRs2YtNXBgX9WtW0916z6gxo0fVWBgoCSpYcNGmjLlTf3ww7dq2vRxrVmzUnXq1FWpUqVzvpNwOpJ0SJLiL8Zrn3mfq8MAAAAA8gwPD8d0y2AwKKtTgg0bNlJPP/2Mfv11kzZs+Ebvvz9LU6bMVGRkdXl6eurxx5tr9eqVevjhxvrmm7Xq12+QM7oAF+ABBQAAAADIRRUqVND58+d07txZe9kff8TrypXLqlgx5Jb7VakSps6du2n27A8UElJJ69attW9r2bK1tm7drM8+Wy6LxaKHH34kR/uAnEOSDgAAAAC5qG7degoJqaQ33nhdBw7s1++/79HYsSNVq1Ydhxna/3T69CnNnj1De/bs0tmzZ7R58y86efK4ypf/67n0ChUqKiIiUrNmTVfTpo+rQIGCudklOBHD3QEAAADck0KLe9+TxzEYDJow4R29++5b6tOnh8MSbJkpWLCgjh07qjVrVunSpYsKCAhUmzbt1apVG4d6zZu30u7du9S8+ZNOjRe5i3XS87k/15hsv7J9tp9JD/cPV2zL2LtaPxIAAAC4nczWnjYaDfLxLSwPU+4NDM6wWHXxQopbT5C8YME8ffvtOi1cuMzVoeRLzlonnTvpAAAAAO4pVqtNFy+kyGg05Oox3TVBT0lJ0dmzpxUXF6sePXq5OhxkE0k6AAAAgHuOOyfNuW3KlLe0bt1XatCgEUPd8wCSdAAAAAC4hw0fPkrDh49ydRhwEmZ3BwAAAADATZCkAwAAAADgJkjSAQAAAABwEyTpAAAAAAC4CZJ0AAAAAADcBEk6AAAAAABugiQdAAAAwD3HaDTIw8OYa19GoyFH+7N9+1bVr19Xly9fvm29p59uqdjYJTkaS3bExMxR167P3lHdceNGKTp6YI4fx1ly671nnXQAAAAA9xSj0SB/34IymHIvnbFZMmS+cE1Wqy1H2q9evaY+/3ytvL29JUmrV6/UtGmTtXbtdw713n//QxUqVMipx46JmaMff/xeCxa4b/Kfn5CkAwAAALinGI2GGwl63PNS4sGcP2BgFRnazpPRaMixJN3T01MBAYH/WM/Pzy9Hjg/3QZIOAAAA4N6UeFA6s9PVUWSqT5+eqlQpVEajSWvWrJKnp6d69OilRx99QlOmvKVvv10vf39/vfLKYD344EPavn2rXn75Ra1Z860OHTqg8eNHS5Lq168rSerWrYe6d39BTz/dUu3b/0ft298Y6n3s2FFNnDhGBw7sU+nSZdSv3yD17/+Sxo+fpIYNG0mS3ntvmn744TslJJyTv3+gHnvsCXXr1kMeHh5avXql5s9/3+FYw4aNVLNmLXX58mXNnPmuNm78Xmlp6QoLC1ffvgNUuXIVez8XLVqg2Nglunbtmho3bipf36xfRNi3b68GD+6nDh06qVOnrne1r9Vq1cKFMfrii8904UKyypevqBdf7KN//SvKXuf8+XOaOXOqNm/+RenpaSpfvqIGDBiqiIhInTp1UtOnv6O9e/fo2rVUlS9fUS+88JLuv79elvuTVSTpAAAAAJAD1qz5Us8+21nvv79Q69d/rcmTJ+qHH75Vw4aPqHPnbvr44yUaO3aE4uK+dNivevWaevnlgYqJma0lS+IkSYUKFb6pfYvFoujogSpRoqTmzFmglJQUzZgx5aZ6hQsX1vDhIxUYGKQjRw7rrbfGqXDhwurYsYuaNHlU8fFH9OuvP+vdd9+TJPuQ+9dfH6oCBQpo0qRpKlLEW59//qleeaWXli79VMWK+Wj9+m80f/5cDRgwRDVq1NLatav1yScfq3TpMnf9Xm3btkXDhw9Wr14vq1WrNne9//LlS7Vs2UcaPHiYqlSpqlWrvtCrrw7QokWxKlu2nFJSUtSnT08FBRXXxInvKCAgQAcO7JfNZpUkpaSk6F//ekg9e/aWp6eX1q79UkOHDtCSJXEqWbLkXceTHSTpAAAAAJADQkMrq2vX5yVJnTt30+LFC+Xj46snn3xKktSt2/NaseITHT58yGE/T09PeXt7y2Aw3HYI/JYtv/7/HeA59no9e/ZW//4vOdT7MwZJKlWqtI4fP6b1679Wx45dVKBAQRUqVEgmk4fDsXbu/E379u3VypXfyMvLS5LUp88r+vHH7/Ttt+vVqlUbLV++VM2bt1KLFq3tx966dbPS0tLu6n36/vtvNXbsSL366mtq0uSxu9r3T0uXfqSOHbuoadPHJUm9e7+sHTu2KjZ2qQYOHKpvvlmrCxcuaN68D1WsmI8kKTi4rH3/ypWrOIwQ6NGjl3744Vv99NP3atv2mSzFlFUk6QAAAACQAypVqmz/3mQyqVgxH1WqFGov8/cPkCRduGBW4cJF7rr948ePqXjxkg7JdbVqETfVW7/+a33yyTKdOnVKqakpslgs/3i8w4cPKjU1Vc2bN3Eov379uk6dOilJOnr0j5vuekdGVtf27dvuuA+//75HP/+8UWPGvGkfnn+3rl69osTEBFWvXtOhvHr1mvYLIIcOHVSVKlXtCfr/SklJ0QcfzNWmTRuVlJQoi8Wi69ev69y5s1mKKTtI0gEAAAAgB3h4OKZbBoPBocxguLGsW05NRidJe/bs0htvvK7//ren6tV7UEWKeGv9+q+1bNlHt90vNTVFAQGBmj59zk3bvL2LOi2+0qWDVayYj7788nNFRdW/6T1zlgIFCtx2+8yZ72rLll/10kuvKDi4rAoUKKDXXhuq9PSMHInndlgnHQAAAADcjIeHpywW623rlCtXXufPn5XZnGQv27fvd4c6u3fvUokSJdWlS3eFhVVT2bLldPbsGYc6np6eslotDmVVq4bJbE6SyWRScHBZhy9fX19JUoUKFfX773sd9tu7d89d9dPX11fTps3WqVMn9frrryoj4+6T4iJFvBUYGKTdux0nEdy9e6cqVKgo6cajB4cOHdClSxczbWP37p1q1qylHn74EVWqFCp//wCdPXv6rmNxBpJ0AAAAAHAzpUqVUmpqirZu3awLFy7o2rVrN9W5//56KlMmWGPHjtLhw4e0a9dvev/9WZKk/79Jr7Jly+rcubNat+4rnTp1UsuXL9MPP3zn0E7JkqV15sxpHTp0QBcuXFBaWprq1q2niIjqio4epM2bf9GZM6e1e/dOzZkzU/v337gQ0K5dB3355Rf68ssvdPz4McXEzNEff8TfdV/9/Pw1deosHT9+VKNGDctSov7ss521ePGNCfqOHz+qWbOm69Chg2rX7j+SpKZNH5e/f4Ciowdp167fdOrUSX333Xrt2bNLkhQcXE7ff79Bhw4d0KFDBzV69PAcHeFwOwx3BwAAAHBvCqzyz3XupeP8TfXqNdW6dVuNHBmtixcv2pdg+zuTyaQJEyZr4sQx6tHjOZUuXUa9e/fT0KH95eV1Y3h3/foP65lnntWUKW8pLS1dUVEPqWvX7vrgg7n2dho1aqwfftigvn1f1JUrl+1LsE2aNFVz576n8eNH68KFZPn7B6hWrTry8/OXJDVp8phOnTqpWbOm6fr1NDVq1FitW7fV5s2/3HV/AwICNXXqbPXt21NvvPG6Ro4cK5PJdMf7P/10B125ckUzZryr5GSzKlQI0cSJ76hs2XKSbowWmDJlpmbMmKLBg/vJYrGoQoUQDRgwRJLUt29/TZjwhl588b/y8fFVx45ddPXq1bvuhzMYbDabay4PuFhi4mXlz5478vAwys+viNqvbK995n3ZaivcP1yxLWOVnHxVGRm3H5oDAAAA3In09DQlJZ1RQEApeXremGXcaDTI37egDKbcu+dos2TIfOGay+6u3qldu35T797P6+OPV6hMmWBXh5OvZPaz+ieDQQoMvLNn+bmTDgAAAOCeYrXaZL5wTUajIVeP6Y4J+vfff6vChQspOLicTp48oalTJ6t69Zok6PcwknQAAAAA9xx3TZpzW0rKVc2aNV3nz5+Vj4+v6tZ9QH36vOLqsCRJjz7a4JbbJk2appo1a99ye6dO7XXu3JlMtw0ePEyPPfbvbMfnrkjSAQAAAOAe9e9/t9C//93C1WFkav78JbfcFhQUdNt9J02aessJ5Pz9/bMVl7sjSQcAAAAAOF1wcNks71uyZCknRnJvYQk2AAAAAADchMuT9MWLF6tx48aqXr262rVrp127dt22/qVLlzR69GjVr19fkZGRevzxx/X999/nUrQAAAAAAOQclw53X716tSZMmKDRo0erZs2aWrhwobp37661a9cqICDgpvppaWnq1q2bAgICNHXqVJUoUUKnT59WsWLFXBA9AAAAAADO5dIkff78+Wrfvr3atm0rSRo9erS+++47xcXFqWfPnjfVj4uL08WLF7Vs2TJ5enpKkoKDWVoAAAAAAJA3uGy4e1pamvbu3auoqKi/gjEaFRUVpR07dmS6z4YNG1SrVi298cYbioqKUosWLTR79mxZLJbcChsAAAAAgBzjsiQ9OTlZFovlpmHtAQEBSkxMzHSfEydO6KuvvpLFYtHcuXPVu3dvzZ8/X7NmzcqNkAEAAAC4CaPRIA8PY659GY2GHO3P9u1bVb9+XV2+fPm29Z5+uqViY2+9tJmrxcTMUdeuz95V/ZYtH1P9+nX1ww/f3dE+//se3M2+94J7agk2m82mgIAAjRkzRiaTSZGRkTp37pxiYmLUp08fV4cHAAAAIBcYjQb5+hWSyWjKtWNarBZdSE6V1WrLkfarV6+pzz9fK29vb0nS6tUrNW3aZK1d+51Dvfff/1CFChVy6rFjYuboxx+/14IFuZv8Hz36h+bPf1/jx09SRESkihZlrjHJhUm6n5+fTCaTkpKSHMqTkpIUGBiY6T5BQUHy8PCQyfTXhzEkJEQJCQlKS0uTl5dXjsYMAAAAwPWMRoNMRpNe/eFVxV+Mz/HjhfiEaGLDiTIaDTmWpHt6eiogIPM86O/8/Pxy5PiucOrUSUlSgwYPy2DI2ZEK9xKXJeleXl6KiIjQpk2b1LRpU0mS1WrVpk2b1KlTp0z3qVOnjlatWiWr1Sqj8cZI/aNHjyooKIgEHQAAAMhn4i/Ga595n6vDyFSfPj1VqVKojEaT1qxZJU9PT/Xo0UuPPvqEpkx5S99+u17+/v565ZXBevDBh7R9+1a9/PKLWrPmWx06dEDjx4+WdGMotyR169ZD3bu/oKefbqn27f+j9u1vDCk/duyoJk4cowMH9ql06TLq12+Q+vd/SePHT1LDho0kSe+9N00//PCdEhLOyd8/UI899oS6deshDw8PrV69UvPnv+9wrGHDRqpZs5a6fPmyZs58Vxs3fq+0tHSFhYWrb98Bqly5ir2fixYtUGzsEl27dk2NGzeVr++dXUSIiZljP26DBvdLkjZu3Ko+fXqqcuWq6tdvoL1udPRAeXsX1fDho7J4Nu4tLh3u3q1bNw0dOlSRkZGqUaOGFi5cqNTUVLVp00aSNGTIEJUoUUIDB944Qf/5z3/00Ucfady4cerUqZOOHTumOXPmqHPnzq7sBgAAAADcZM2aL/Xss531/vsLtX7915o8eaJ++OFbNWz4iDp37qaPP16isWNHKC7uS4f9qlevqZdfHqiYmNlasiROklSoUOGb2rdYLIqOHqgSJUpqzpwFSklJ0YwZU26qV7hwYQ0fPlKBgUE6cuSw3nprnAoXLqyOHbuoSZNHFR9/RL/++rPeffc9SbIPuX/99aEqUKCAJk2apiJFvPX555/qlVd6aenST1WsmI/Wr/9G8+fP1YABQ1SjRi2tXbtan3zysUqXLvOP781//tNZpUqV1vjxo/X552vv+r3Ny1yapDdr1kxms1nTpk1TQkKCwsPDNW/ePPtw9zNnztjvmEtSqVKlFBMTowkTJujJJ59UiRIl9Nxzz6lHjx6u6gIAAAAAZCo0tLK6dn1ektS5czctXrxQPj6+evLJpyRJ3bo9rxUrPtHhw4cc9vP09JS3t7cMBsNth8Bv2fKrTp06qenT59jr9ezZW/37v+RQ788YJKlUqdI6fvyY1q//Wh07dlGBAgVVqFAhmUweDsfaufM37du3VytXfmMftdynzyv68cfv9O2369WqVRstX75UzZu3UosWre3H3rp1s9LS0v7xvSlcuLC8vYtK0h0N889PXD5xXKdOnW45vH3RokU3ldWuXVuxsbE5HRYAAAAAZEulSpXt35tMJhUr5qNKlULtZf7+N1a6unDBrMKFi9x1+8ePH1Px4iUdktxq1SJuqrd+/df65JNlOnXqlFJTU2SxWP7xeIcPH1RqaqqaN2/iUH79+nX7s+RHj/6hVq3aOGyPjKyu7du33XVf8BeXJ+kAAAAAkBd5eDimWwaDwaHsz8nScmoyOknas2eX3njjdf33vz1Vr96DKlLEW+vXf61lyz667X6pqSkKCAjU9Olzbtr25x3wnGA0GmWzOb4fGRkZOXY8d0SSDgAAAABuxsPDUxaL9bZ1ypUrr/Pnz8psTrLfld+373eHOrt371KJEiXVpUt3e9nZs2cc6nh6espqtTiUVa0aJrM5SSaTSaVKlc70+BUqVNTvv+/Vv//dwl62d++ef+7cbfj6+ikpKdH+2mKxKD7+iOrUqZutdu8lxn+uAgAAAADITaVKlVJqaoq2bt2sCxcu6Nq1azfVuf/+eipTJlhjx47S4cOHtGvXb3r//VmSpD9XNCtbtqzOnTurdeu+0qlTJ7V8+TL98MN3Du2ULFlaZ86c1qFDB3ThwgWlpaWpbt16ioiorujoQdq8+RedOXNau3fv1Jw5M7V//40LAe3addCXX36hL7/8QsePH1NMzBz98Uf2lsSrU6euNm3aqJ9/3qhjx45q0qSJunLlcrbavNdwJx0AAADAPSnEJyRPHefvqlevqdat22rkyGhdvHjRvgTb35lMJk2YMFkTJ45Rjx7PqXTpMurdu5+GDu0vL68CkqT69R/WM888qylT3lJaWrqioh5S167d9cEHc+3tNGrUWD/8sEF9+76oK1cu25dgmzRpqubOfU/jx4/WhQvJ8vcPUK1adeTn5y9JatLkMZ06dVKzZk3T9etpatSosVq3bqvNm3/Jcr9btGilw4cPaezYkTKZTGrf/tl8dRddkgy2/x3wn08kJl5W/uy5Iw8Po/z8iqj9yvbZXmMy3D9csS1jlZx8VRkZtx+aAwAAANyJ9PQ0JSWdUUBAKXl63phl3Gg0yNevkExGU67FYbFadCE5NUefH3eGXbt+U+/ez+vjj1eoTJlgV4eTr2T2s/ong0EKDLyzZ/m5kw4AAADgnmK12nQhOVVGoyFXj+mOCfr333+rwoULKTi4nE6ePKGpUyerevWaJOj3MJJ0AAAAAPccd02ac1tKylXNmjVd58+flY+Pr+rWfUB9+rzi6rAkSY8+2uCW2yZNmqaaNWvnYjT3DpJ0AAAAALhH/fvfLRxmV3cn8+cvueW2oKCgXIzk3kKSDgAAAABwuuDgsq4O4Z7EEmwAAAAAALgJknQAAAAAbi+fLkqFe4izfkYZ7g4AAADAbZlMHpIMunLlory9fWQw5N6M7sCdstlsunLloiTD///MZh1JOgAAAAC3ZTQa5ecXpOTkBJnNqa4OB7gNg/z8gmQ0Zm/AOkk6AAAAALdWoEAhFS8eLIslw9WhALdkMnlkO0GXSNIBAAAA3AOMRqOMRi9XhwHkOCaOAwAAAADATZCkAwAAAADgJkjSAQAAAABwEyTpAAAAAAC4CZJ0AAAAAADcBEk6AAAAAABugiQdAAAAAAA3QZIOAAAAAICbIEkHAAAAAMBNkKQDAAAAAOAmSNIBAAAAAHATJOkAAAAAALgJknQAAAAAANwESToAAAAAAG6CJB0AAAAAADfh4eoAcGtxcbFaunSRzOYkVapUWf37D1a1apGZ1l29eqXGjx/tUObl5aUNG362v7bZbIqJmaOVKz/T5ctXVL16TQ0dOkx+fuH2OtazVlk2WGQ7Y5OMkrGqUaamJhm8DDnTSQAAAACAHUm6m1q//mvNmDFFgwZFq1q1SMXGLtWAAX21dGmc/Pz8M92nSJEiWrIkzv7aYHBMrBcvXqhPPlmm4cNHqVSpMpo3b5ZeeeUlrV27RpJku2xTxpIMGcON8njcQ7brNlnWWZSxMkOebT1zrrMAAAAAAEkMd3dby5YtVsuWrdW8+ZOqWDFEgwdHq2DBglq16otb7mMwGBQQEGj/8vcPsG+z2Wxavnypnnuuuxo0aKTQ0Mp67bU3lJiYoHXr1kmSrIetklEyPWGSIcAgY2mjTE+YZDtgk81sy/E+AwAAAEB+R5LuhtLT03Xw4H7VrVvPXmY0GlW37gPau3fXLfdLTU1V27Yt1KZNc7366gDFxx+xbzt9+pSSkpJ0//0P2Mu8vb0VERGpHTt23CjIkGRyvANv8LjxvfWk1Um9AwAAAADcCkm6G7p48YIsFov8/R2Htfv7+yspKSnTfcqVK69XX31dEydO1uuvvyGr1aZevf6r8+fPSZLM5hv7+fkFOOzn7x+gxMRESZKhgkG6Kll+schmscmWalPGtxk3Kl5xZg8BAAAAAJnhmfQ8IjKyhiIja9hfV69eUx07Pq3PP/9UPXr0uqM2jEFGmVqaZFlnkeVby42J4+oaZStik5g3DgAAAAByHEm6G/Lx8ZXJZJLZbHYoN5vNCggIuMVejjw8PFS5clWdPHlCkuzPpycnJykwMPBvbSYpMjJCp3VakmSKMMkUYZLtik3yulHHutkqgy9ZOgAAAADkNIa7uyFPT09VqRKmbds228usVqu2bduiiIgat9nzLxaLRfHxh+0JeenSZRQQEKCtW7fY61y9ekV79+5R7dq1b9rf4G2Qwcsg6z6r5CEZKpKkAwAAAEBO4066m+rQoaPGjRulsLBqCg+PUGzsEqWmpqp585aSpDFjRigoqLhefLGPJGn+/PcVEVFdZcoE68qVK1qy5EOdPXtWLVq0lnRjMrh27f6jhQtjVLZsWfsSbIGBQWratKkWfr1QkmTZapEh2CCDp0HWP26smW56xCRDQZJ0AAAAAMhpJOluqkmTx3ThQrLmzZstszlJoaFVNHnydPuw9XPnzspo/GsgxOXLl/Tmm2NlNiepaNFiqlo1TLNnx6hixRB7nY4du+jatWt6663xunLlsqpXr6V3352hAgUK2OvYTttk+dEipUmGAINM/zbJVN2Uex0HAAAAgHzMYLPZ8uUC2ImJl5U/e+7Iw8MoP78iar+yvfaZ92WrrXD/cMW2jFVy8lVlZLBkGwAAAABIksEgBQYWvaO6PJMOAAAAAICbYLj7PcpoNMhozP5z4iYT12kAAAAAwF2QpN+DjEaD/H0LymDi9AEAAABAXuIWWd7ixYsVExOjhIQEhYWF6fXXX1eNGpkvNfbpp58qOjraoczLy0u7d+/OjVDdgtFouJGgxz0vJR7MXmOhTaUmI5wTGAAAAAAgW1yepK9evVoTJkzQ6NGjVbNmTS1cuFDdu3fX2rVrFRAQkOk+3t7eWrt2rf21wZBPlwdLPCid2Zm9NgKrOCcWAAAAAEC2ufyB5Pnz56t9+/Zq27atQkNDNXr0aBUsWFBxcXG33MdgMCgoKMj+FRgYmIsRAwAAAACQM1yapKelpWnv3r2KioqylxmNRkVFRWnHjh233C8lJUWPPPKIHn74YfXq1UuHDh3KjXABAAAAAMhRLk3Sk5OTZbFYbhrWHhAQoMTExEz3qVixosaPH6/33ntPb7/9tmw2mzp06KCzZ8/mRsgAAAAAAOQYlz+Tfrdq166t2rVrO7xu1qyZli1bpldeecV1gQEAAAAAkE0uvZPu5+cnk8mkpKQkh/KkpKQ7fs7c09NT4eHhOn78eE6ECAAAAABArnFpku7l5aWIiAht2rTJXma1WrVp0yaHu+W3Y7FYdPDgQQUFBeVUmAAAAAAA5AqXD3fv1q2bhg4dqsjISNWoUUMLFy5Uamqq2rRpI0kaMmSISpQooYEDB0qSZsyYoVq1aql8+fK6dOmSYmJidPr0abVr186V3QAAAAAAINtcnqQ3a9ZMZrNZ06ZNU0JCgsLDwzVv3jz7cPczZ87IaPzrhv+lS5f0+uuvKyEhQT4+PoqIiNCyZcsUGhrqqi4AAAAAAOAUBpvNZnN1EK6QmHhZ92rPPTyM8vMrIs1pKJ3Zmb3GqreT2s5T+5Xttc+8L1tNhfuHK7ZlrJKTryojw5q9uAAAAAAgjzAYpMDAondU16XPpAMAAAAAgL+QpAMAAAAA4CZI0gEAAAAAcBMk6QAAAAAAuAmSdAAAAAAA3ARJOgAAAAAAboIkHQAAAAAAN0GSDgAAAACAmyBJBwAAAADATZCkAwAAAADgJkjSAQAAAABwEyTpAAAAAAC4CZJ0AAAAAADcBEk6AAAAAABugiQdAAAAAAA3QZIOAAAAAICbIEkHAAAAAGRJXFysnn66pRo3jlKPHl30++977mi/deu+Uv36dRUdPdChPCZmjp59tq2aNq2vJ554RP369dbevTe3+fPPG9WjRxc1bvyQnnjikZvauZd5uDoAAAAAAMC9Z/36rzVjxhQNGhStatUiFRu7VAMG9NXSpXHy8/O/5X5nzpzWzJlTVbNm7Zu2lS1bXv37D1Hp0mV0/fp1xcYu0YABL2nZshXy8/OTJH333Xq9+eY4vfBCb9Wpc78sFovi44/kWD9zG3fSAQAAAAB3bdmyxWrZsrWaN39SFSuGaPDgaBUsWFCrVn1xy30sFoveeOM1de/eU6VLl7lp+2OPPaH776+nMmWCFRJSSX379tfVq1d15MghSVJGRoamTp2sl156Wa1bP61y5cqrYsUQNWnyaI71M7eRpAMAAAAA7kp6eroOHtyvunXr2cuMRqPq1n1Ae/fuuuV+CxbMk6+vv1q0aH1Hx/j888/k7e2t0NAqkqSDB/crIeG8DAajunV7Vq1aPa6BA19WfPzhbPfJXZCkAwAAAADuysWLF2SxWOTv7zis3d/fX0lJSZnus3Pnb1q16nMNHfrabdv+6acf9eijDdS4cZRiY5doypSZ8vX1lSSdPn1KkvTBB3PVpUt3vfnmuypatKj69n1Bly5dzH7H3ABJOgAAAAAgR6WkXNXYsSM0ZMhwe8J9K3Xq1NX8+Us0a9YHqlfvQY0YEa3kZLMkyWq1SZKee+6/atSoicLCwjVs2EgZDAZt2LAup7uRK5g4DgAAAABwV3x8fGUymWQ2mx3KzWazAgICbqp/6tRJnTlzWq++OsBeZrVaJUkPP1xPS5bEqUyZYElSoUKFFBxcVsHBZRUZWV0dOjylVas+V+fO3RQYGChJqlAhxN6Ol5eXSpUqo3Pnzjq9n65Akg4AAAAAuCuenp6qUiVM27ZtVsOGjSTdSLq3bduiNm3a31S/XLkK+vDDZQ5l778/SykpKerXb6CKFy9xy2NZrValpaVJkqpWDZOXl5dOnDiqmjVrSboxmdzZs2dUsmQp53TOxUjSAQAAAAB3rUOHjho3bpTCwqopPDxCsbFLlJqaqubNW0qSxowZoaCg4nrxxT4qUKCAQkJCHfb39i4qSfby1NRUffjhB3rooYYKDAzUhQsX9OmnsUpMTNAjjzSVJBUp4q1WrdoqJmauihcvqZIlS2rJkkWSZK9zryNJBwAAAADctSZNHtOFC8maN2+2zOYkhYZW0eTJ0+Xvf2O4+7lzZ2U03vk0aEajUceOHdWaNat08eIFFSvmo/Dwapo5832FhFSy13vppX4ymUwaM2aErl+/rmrVIjR16iwVK1bM6X10BYPNZrO5OghXSEy8rHu15x4eRvn5FZHmNJTO7MxeY9XbSW3nqf3K9tpn3petpsL9wxXbMlbJyVeVkWHNXlwAAAAAkEcYDFJgYNE7qsuddAAAAACA0xmNBhmNBqe1Z7Xa7LO752Uk6QAAAAAApzIaDfL3LSiDyXkpp82SIfOFa3k+USdJBwAAAAA4ldFouJGgxz0vJR7MfoOBVWRoO09Go4EkHQAAAACALEk8mP15tPKZO59qDwAAAAAA5CiSdAAAAAAA3ARJOgAAAAAAboIkHQAAAAAAN0GSDgAAAACAm3BKkm6xWLRv3z5dvHjRGc0BAAAAAJAvZSlJHzdunJYvXy7pRoLeqVMnPfXUU2rUqJF+/fVXpwYIAAAAAEB+kaUk/auvvlJYWJgk6dtvv9XJkye1Zs0adenSRVOmTHFqgAAAAAAA5BdZStKTk5MVFBQkSfr+++/1xBNPqGLFimrbtq0OHjzo1AABAAAAAMgvspSkBwYG6vDhw7JYLPrxxx/10EMPSZKuXbsmk8nk1AABAAAAAMgvPLKyU5s2bfTKK68oKChIBoNBUVFRkqSdO3cqJCTEqQECAAAAAJBfZClJ79u3rypXrqyzZ8/qiSeekJeXlyTJZDKpR48eTg0QAAAAAID8IktJuiQ98cQTkqTr16/by5566qnsRwQAAAAAQD6VpWfSLRaLZs6cqQYNGqh27do6ceKEJOndd9+1L812NxYvXqzGjRurevXqateunXbt2nVH+3355ZeqWrWqevfufdfHBAAAAADA3WQpSZ81a5Y+++wzDR48WJ6envbyKlWq6JNPPrmrtlavXq0JEybopZde0meffaawsDB1795dSUlJt93v5MmTevPNN1W3bt2sdAEAAAAAALeTpST9888/15gxY/Tkk0/KaPyriapVqyo+Pv6u2po/f77at2+vtm3bKjQ0VKNHj1bBggUVFxd3y30sFosGDRqkvn37qmzZslnpAgAAAAAAbidLSfq5c+dUrly5m8ptNpsyMjLuuJ20tDTt3bvXPju8JBmNRkVFRWnHjh233G/mzJkKCAhQu3bt7i5wAAAAAADcWJYmjgsNDdXWrVtVpkwZh/K1a9cqPDz8jttJTk6WxWJRQECAQ3lAQMAt78hv3bpVn3zyiVasWHHXcQMAAAAA4M6ylKT37t1br776qs6dOyebzaavv/5af/zxh1asWKE5c+Y4O0a7K1euaMiQIRozZoz8/f1z7DgAAAAAALhClpL0pk2bavbs2Zo5c6YKFSqkadOmqVq1apo9e7YeeuihO27Hz89PJpPppknikpKSFBgYeFP9EydO6NSpU+rVq5e9zGq1SpKqVaumtWvXZjoMHwAAAACAe0GW10mvW7eu5s+fn62De3l5KSIiQps2bVLTpk0l3Ui6N23apE6dOt1UPyQkRCtXrnQoe/fdd3X16lUNHz5cJUuWzFY8AAAAAAC4UpaTdGfp1q2bhg4dqsjISNWoUUMLFy5Uamqq2rRpI0kaMmSISpQooYEDB6pAgQKqUqWKw/7FihWTpJvKAQAAAAC419xxkv7AAw9o7dq18vf31/333y+DwXDLups3b77jAJo1ayaz2axp06YpISFB4eHhmjdvnn24+5kzZxyWeQMAAAAAIK+64yQ9Ojpa3t7e9u9vl6TfrU6dOmU6vF2SFi1adNt9J06c6LQ4AAAAAABwpTtO0p966in7938ORQcAAAAAAM6TpXHk4eHhN83ILt1Y9/xu1kkHAAAAAAB/yVKSbrPZMi1PS0uTp6dntgICAAAAACC/uqvZ3T/88ENJksFg0PLly1W4cGH7NqvVqi1btigkJMS5EQIAAAAAkE/cVZK+YMECSTfupC9btsxh1nVPT08FBwdr9OjRTg0QAAAAAID84q6S9A0bNkiSOnfurBkzZsjHxydHggIAAAAAID+6qyT9T/+0LBoAAAAAALh7d5ykT5gwQf369VPhwoU1YcKE29aNjo7OdmAAAAAAAOQ3d5yk//7778rIyLB/fysGgyH7UQEAAAAAkA/dcZL+9yHuDHcHAAAAAMD5srROOgAAAAAAcL47vpPep0+fO250xowZWQoGAAAAAID87I6T9KJFi+ZkHAAAAAAA5Ht3Nbs7AAAAAADIOTyTDgAAAACAm7jjO+lPPfWUFixYIB8fH7Vu3fq2S6199tlnTgkOAAAAAID85I6T9CZNmsjLy0uS1LRp0xwLCAAAAACA/CpLs7vfzUzvAAAAAADgztxxkp6Z3bt368iRI5Kk0NBQRUZGOiUoAAAAAADyoywl6WfPntWAAQO0fft2FStWTJJ06dIl1a5dW1OmTFHJkiWdGiQAAAAAAPlBlmZ3Hz58uDIyMrR69Wpt3rxZmzdv1urVq2Wz2TR8+HBnxwgAAAAAQL6QpTvpW7Zs0bJlyxQSEmIvCwkJ0WuvvaaOHTs6LTgAAAAAAPKTLN1JL1WqlDIyMm4qt1qtKl68eLaDAgAAAAAgP8pSkj548GCNGTNGu3fvtpft3r1b48aN09ChQ50WHAAAAAAA+ckdD3e///77ZTAY7K9TUlLUvn17mUwmSZLFYpHJZNKwYcNYRx0AAAAAgCy44yR92LBhORkHAAAAAAD53h0n6U899VROxgEAAAAAQL6Xpdnd/+769etKT093KPP29s5uswAAAAAA5DtZStJTUlI0adIkrVmzRhcuXLhp+759+7IbFwAAAAAA+U6WZnd/++239csvv2jUqFHy8vLS2LFj1bdvXxUvXlxvvvmms2MEAAAAACBfyFKS/u2332rkyJF6/PHHZTKZVLduXfXu3Vv9+/fXypUrnR0jAAAAAAD5QpaS9IsXL6ps2bKSbjx/fvHiRUnSfffdp61btzovOgAAAAAA8pEsJenBwcE6efKkJCkkJERr1qyRdOMOe9GiRZ0XHQAAAAAA+UiWkvS2bdtq//79kqSePXtq8eLFql69uiZMmKDu3bs7NUAAAAAAAPKLLM3u3rVrV/v3UVFRWr16tX7//XeVK1dOYWFhzooNAAAAAIB8JdvrpEs3hr8HBwc7oykAAAAAAPKtLCfpmzZt0oIFC3TkyBFJUqVKldSlSxdFRUU5LTgAAAAAAPKTLD2TvnjxYj3//PMqUqSInnvuOT333HPy9va2P58OAAAAAADuXpbupM+ZM0fR0dHq1KmTQ3mdOnU0e/ZsdezY0SnBAQAAAADyj8UHCytmfxElpBoV5peu1++7rBoB6ZnW/eKLz7R27ZeKj78xurtq1XC98EJvVasWaa9jNidp1qzp2rz5F125clk1a9ZR//6DVbZsOXudPn166rfftju03apVGw0ePCwHevjPspSkX758WQ0aNLip/KGHHtKkSZOyHRQAAAAAIH9ZfaygJuwoqtH3X1LNgDQtPFBE3b/109oWiQrIpP6OHdvUtOnjql69hry8Cmjx4oUaMKCPFi2KVVBQcdlsNkVHD5KHh4cmTpysIkWKaNmyxXrlld766KPlKlSokL2tli2f0vPPv2B/XbBgwVzoceayNNy9cePG+uabb24qX79+vRo1apTdmAAAAAAA+cz8A4XVvlKK2oakKtTHotH3X1JBD5vi4gtlWn/kyLFq06adKleuqvLlK2jo0Ndktdq0detmSdKJE8e1d+9uDRz4qsLDI1SuXAUNGhSt69eva926rxzaKliwoAICAu1fRYp453h/b+WO76R/+OGH9u8rVaqk2bNna/PmzapVq5YkaefOndq+fbu6devm9CABAAAAAHlXmkXaa/bUC9Wu2suMBimqRJp2JHreURvXr19TRkaGihXzkSSlp98YJl+gQIG/2jQa5eXlpV27flPLlq3t5d98s0Zff71a/v4Beuihhura9XmX3U2/4yR9wYIFDq+LFSumw4cP6/Dhw/ayokWLKi4uTr1793ZagAAAAACAvC35ulEWm0EBBa0O5QEFLYq/7HVHbbz33nQFBgaqbt0HJEnly1dQiRIlNXv2DA0ePEyFChXSxx8v1vnz55SUlGjf79FHn1DJkqUUGBikI0cOadas6Tp+/JjGj3/beR28C3ecpG/YsCEn4wAAAAAAIEsWLVqg9eu/1vTpc+x3zj08PDRu3NuaOHGMmjVrLJPJpPvue0D/+leUbLa/9m3Vqo39+0qVQhUQEKh+/Xrp1KmTKlMmOLe7kvV10v9k+//eGQyGLLexePFixcTEKCEhQWFhYXr99ddVo0aNTOt+/fXXmj17to4fP66MjAyVL19e3bp1U+vWrbN8fAAAAACA6/gVsMpksCnpmuO0aUnXTAr8n7vr/2vJkkVavHiB3n33PYWGVnbYFhYWrgULlujKlStKT0+Xn5+fevToorCwards78/Z4U+ePOGSJD1LE8dJ0ooVK9SyZUvVqFFDNWrUUMuWLbVixYq7bmf16tWaMGGCXnrpJX322WcKCwtT9+7dlZSUlGl9Hx8f9erVSx9//LG++OILtWnTRsOGDdOPP/6Y1a4AAAAAAFzIyyRF+Kdr09m/hrZbbdKmc16qHZj5EmyStHjxQi1cOE+TJk2/beLt7e0tPz8/nThxXAcO7FODBg/fsu6hQwckSQEBgVnoSfZl6U76/PnzNXXqVHXs2FGvvPKKJGnbtm0aNWqULly4oK5du95VW+3bt1fbtm0lSaNHj9Z3332nuLg49ezZ86b69erVc3jdpUsXrVixQtu2bct0WTgAAAAAgPvrVjVFQ3/xUaR/umoEpGvhgSJKzTCoTcVUSdKQIUPk4+Ovnj1fkiR99NECxcTM0ciRY1WqVCn7c+aFChVW4cKFJUkbNqyTr6+vSpQoqfj4w5o6dbIaNHhYDzzwL0nSqVMn9c03a/Wvfz0kHx8fHTlySNOmvaNatercdFc+t2QpSV+0aJFGjRrlMMS8SZMmqly5sqZPn37HSXpaWpr27t2rF174az06o9GoqKgo7dix4x/3t9ls+uWXX/THH39o0KBBd9sNAAAAAICbaFb+mszXjZq2u6gSrhkV7peueY2SFVjoxnD3M2fOKD39r6HvK1bEKT09Xa+9NtShnW7deqh79xs5ZlJSombMmCKzOUkBAYF64onm6tr1eXtdDw8Pbd26WbGxS3XtWqqKFy+hRo0aq0uX7rnQ48xlKUlPSEhQ7dq1byqvXbu2EhIS7rid5ORkWSwWBQQ4Lk0fEBCg+Pj4W+53+fJlNWzYUGlpaTIajRo5cqQeeuihO+8AAAAAAMDtdKqSok5VUjLdtmjRIiUnX1VGxo1E/ZNPVv5je+3adVC7dh1uub1EiZKaMWNu1oLNIVl6Jr18+fJas2bNTeWrV69WhQoVshvTPypSpIhWrFihTz75RP3799fEiRP166+/5vhxAQAAAADISVm6k963b1/1799fW7ZsUZ06dSRJ27dv1y+//KJ33333jtvx8/OTyWS6aZK4pKQkBQbe+iF9o9Go8uXLS5LCw8N15MgRzZ0796bn1QEAAAAAeYfJlOW5zx1YrTZZrbZ/rugCWUrSH3/8cS1fvlzz58/X+vXrJUkhISFavny5qlW79Yx6/8vLy0sRERHatGmTmjZtKkmyWq3atGmTOnXqdMftWK1WpaWl3V0nAAAAAAD3Bu/islgtKlaskFOas1gtupCc6paJ+l0n6enp6RoxYoR69+6tSZMmZTuAbt26aejQoYqMjFSNGjW0cOFCpaamqk2bGwvKDxkyRCVKlNDAgQMlSXPmzFFkZKTKlSuntLQ0ff/99/riiy80atSobMcCAAAAAHBDBX1lMpr06g+vKv7irecvuxMhPiGa2HCijEZD3kjSPT099fXXX6t3795OCaBZs2Yym82aNm2aEhISFB4ernnz5tmHu585c0ZG419DGlJSUjR69GidPXtWBQsWVEhIiN5++201a9bMKfEAAAAAANxT/MV47TPvc3UYOSpLw92bNm2q9evX39V66LfTqVOnWw5vX7RokcPr/v37q3///k45LgAAAAAA7iRLSXr58uU1c+ZMbd++XRERESpUyPG5gOeee84pwQEAAAAAkJ9kKUn/5JNPVLRoUe3Zs0d79uxx2GYwGEjSAQAAAADIgiwl6Rs2bLB/b7PdeNDeYDA4JyIAAAAAAPKpLC8yt3z5crVo0ULVq1dX9erV1aJFCy1fvtyZsQEAAAAAkK9k6U761KlTtWDBAnXq1Em1atWSJP32228aP368Tp8+rX79+jkzRgAAAAAA8oUsJelLly7VmDFj1KJFC3tZkyZNVLVqVY0ZM4YkHQAAAACALMjScPeMjAxFRkbeVB4RESGLxZLtoAAAAAAAyI+ylKS3atVKS5cuvak8NjZWLVu2zHZQAAAAAADkR1ka7i7dWIbtp59+Us2aNSVJu3bt0unTp9W6dWtNmDDBXi86Ojr7UQIAAAAAkA9kKUk/ePCgqlWrJkk6fvy4JMnX11e+vr46ePCgvR7LsgEAAAAAcOeylKQvWrTI2XEAAAAAAJDvZXmddAAAAAAA4Fwk6QAAAAAAuAmSdAAAAAAA3ARJOgAAAAAAboIkHQAAAAAAN0GSDgAAAACAmyBJBwAAAADATZCkAwAAAADgJkjSAQAAAABwEyTpAAAAAAC4CZJ0AAAAAADcBEk6AAAAAABugiQdAAAAAAA3QZIOAAAAAICbIEkHAAAAAMBNkKQDAAAAAOAmSNIBAAAAAHATJOkAAAAAALgJknQAAAAAANwESToAAAAAAG6CJB0AAAAAADfh4eoA8pK4uFgtXbpIZnOSKlWqrP79B6tatchM637xxWdau/ZLxccfkSRVrRquF17o7VDfZrMpJmaOVq78TJcvX1H16jU1aNCrqlixgiTp1xNpem55yUzbX/5YomoEZDi3gwAAAACAHMWddCdZv/5rzZgxRd269VBMzEcKDa2iAQP6KjnZnGn9HTu2qWnTxzV9+mzNmTNfJUqU0IABfZSQcN5eZ/Hihfrkk2UaNChac+cuUKFCBTVgQF9dv35dklS7tKc2tj7v8NWuUoqCi2Souj8JOgAAAADca0jSnWTZssVq2bK1mjd/UhUrhmjw4GgVLFhQq1Z9kWn9kSPHqk2bdqpcuarKl6+goUNfk9Vq09atmyXduIu+fPlSPfdcdzVo0EihoZX12mtvKCkpQT/88J0kyctkUFAhq/3Lt4BV608WUJuQVBkMudVzAAAAAICzkKQ7QXp6ug4e3K+6devZy4xGo+rWfUB79+66ozauX7+mjIwMFSvmI0k6ffqUkpKSdP/9D9jreHt7q1q1SO3enXmbG04V0IU0o9qGpGajNwAAAAAAVyFJd4KLFy/IYrHI39/fodzf319JSUl31MZ7701XYGCg6ta9kZSbzTf28/MLcKjn5+evpKTETNv45Ehh1S+ZppKFrXfbBQAAAACAGyBJdwOLFi3Q+vVfa/z4SSpQoECW2jibYtTGs156ulKKk6MDAAAAAOQWknQn8PHxlclkktnsOEmc2WxWQEDALfa6YcmSRVq8eIGmTJmh0NDK9nJ//xv7JSc73olPTjYrICDwpnbi4gvJ18uqxmWuZ7UbAAAAAAAXI0l3Ak9PT1WpEqZt2zbby6xWq7Zt26KIiBq33G/x4oVauHCeJk2arrCwag7bSpcuo4CAAG3dusVedvXqFf3++x5Vr+7Yps0mfRpfSK0rXpMnZxQAAAAA7lmsk+4kHTp01LhxoxQWVk3h4RGKjV2i1NRUNW/eUpI0ZswIBQUV14sv9pEkffTRAsXEzNHIkWNVqlQp+3PmhQoVVuHChWUwGNSu3X+0cGGMypYtq1KlymjevFkKCAhSw4aNHI79yzkvnbzqoacrJedqnwEAAAAAzkWS7iRNmjymCxeSNW/ebJnNSQoNraLJk6fbh62fO3dWRuNft7lXrIhTenq6XnttqEM73br1UPfuL0iSOnbsomvXrumtt8brypXLql69liZPnnbTc+ufxBdS7cA0VSpmyeFeAgAAAAByEkm6E7Vt+4zatn0m020zZsx1eP3JJyv/sT2DwaDnn39Rzz//4m3rTY66eOdBAgAAAADcFkl6LjEaDTIaDU5py2TiwXMAAAAAyIvcIklfvHixYmJilJCQoLCwML3++uuqUSPzCddiY2O1YsUKHTp0SJIUERGhAQMG3LK+OzAaDfLxLSwPkmsAAAAALhYXF6ulSxfJbE5SpUqV1b//YFWrFplp3fj4I4qJma0DB/br7NkzevnlAWrf/lmHOhaLRR98MFdff71GSUlJCgwMVIsWT2rAgH768zblq7/46LM/CjnsV7/kdcU8wrxa/8vlSfrq1as1YcIEjR49WjVr1tTChQvVvXt3rV27NtPly3799Vc1b95cderUkZeXl+bNm6f//ve/+vLLL1WiRAkX9OCfGY0GeZiM6rdshw6fv5Lt9hpVDdLgx8OcEBkAAACA/GT9+q81Y8YUDRoUrWrVIhUbu1QDBvTV0qVx8vPzv6n+9evXVLp0sB55pKmmT38n0zYXL16oFSs+0fDho1WxYoj27/9dEya8oaAgfz33t3oNSl3XhHp/ParrZbI5u3t5gsuT9Pnz56t9+/Zq27atJGn06NH67rvvFBcXp549e95Uf/LkyQ6vx44dq6+++kqbNm1S69atcyPkLDt8/or2nr6U7XYqBRVxQjQAAAAA8ptlyxarZcvWat78SUnS4MHR2rRpo1at+kKdO3e9qX54eITCwyMkSbNnz8i0zT17dql+/YcVFVVfklSqVGmtX/+1du3aJVX+q56X0aagQlbndigPcun467S0NO3du1dRUVH2MqPRqKioKO3YseOO2khNTVVGRoZ8fHxyKkwAAAAAuOelp6fr4MH9qlu3nr3MaDSqbt0HtHfvriy3GxlZQ9u2bdHx48ckSYcOHdTOnb+pYcOGDvU2n/fSg58G6fFVgRq5pZiSrztnzq68xqV30pOTk2WxWG4a1h4QEKD4+Pg7amPSpEkqXry4Q6IPAAAAAHB08eIFWSwW+fs7Dmv39/fXsWNHs9xup05ddfXqVXXs+LSMRqOsVqtefPElPfnkk9KcSZJuDHV/NPiagr0tOnHFpHd2FlWP7/z08aNmMXWXI5cPd8+OuXPnavXq1frwww9vWjscAAAAAJDzNmz4Rt98s1YjR45VxYqVdOjQAU2b9o7Klw/WU/9fp3n5a/b6VX0zVNU3Q01XBt24u14yzTWBuymXJul+fn4ymUxKSkpyKP9zRsDbiYmJ0dy5czV//nyFhTGJGgAAAADcjo+Pr0wmk8xms0O52WzOdNLuO/Xee9PUsWMXNW36uCSpUqVQnT9/TnPmzNFTT2W+T1lvi/wKWHXsikkPZvnIeZNLBxZ4eXkpIiJCmzZtspdZrVZt2rRJtWvXvuV+77//vt577z3NmzdP1atXz41QAQAAAOCe5unpqSpVwrRt22Z7mdVq1bZtWxQRkfUlra9duyaj0TG1NJmMstluPXv72RSjLlw3KKggE8n9L5cPd+/WrZuGDh2qyMhI1ahRQwsXLlRqaqratGkjSRoyZIhKlCihgQMHSroxxH3atGmaPHmyypQpo4SEBElS4cKFVaQIs54DAAAAwK106NBR48aNUlhYNYWHRyg2dolSU1PVvHlLSdKYMSMUFFRcL77YR9KNyeaOHo23f5+QkKBDhw6oUKHCCg4uK0l66KEG+vDDD1SiRElVrBiigwcPaOnSj/T0009LWqmr6QbN2OOtx8teU2BBq05cMent34qqfFGLGpS67pL3wZ25PElv1qyZzGazpk2bpoSEBIWHh2vevHn24e5nzpxxuCqzbNkypaen6+WXX3Zop0+fPurbt2+uxg4AAAAA95ImTR7ThQvJmjdvtszmJIWGVtHkydPl739juPu5c2cd8q/ExAR169bR/nrp0kVaunSRatWqoxkz5kqS+vcfrPffn63JkycqOTlZgYGBat26rfr16yfNXymTwaaDFzy04g9fXU43qnghqx4qeV39ql+Rlyl3+38vcHmSLkmdOnVSp06dMt22aNEih9cbNmzIjZAAAAAAIE9q2/YZtW37TKbb/ky8/1SqVGlt3Lj1tu0VLlxE/foNVL9+A+1lHh5GeXl5SZIKekgxjyRnM+r8wy2SdAAAAACA6xmNBhmN2V+/3MS6allGkg4AAAAAkNFokI9vYXmQYLsUSToAAAAAQEajQR4mo/ot26HD569kq61GVYM0+HGWys4KknQAAAAAgN3h81e09/SlbLVRKYiVt7KKcQwAAAAAALgJknQAAAAAANwESToAAAAAAG6CJB0AAAAAADdBkg4AAAAAgJsgSQcAAAAAwE2QpAMAAAAA4CZI0gEAAAAAcBMk6QAAAAAAuAmSdAAAAAAA3ARJOgAAAAAAboIkHQAAAAAAN0GSDgAAAACAmyBJBwAAAADATZCkAwAAAADgJkjSAQAAAABwEx6uDgAAAAB5S1xcrJYuXSSzOUmVKlVW//6DVa1aZKZ14+OPKCZmtg4c2K+zZ8/o5ZcHqH37Zx3qLFo0X99//62OHTuqAgUKqHr1GurVq6/Klatgr5OUlKj33puqLVs2KyXlqsqVK6/nnvuvGjVqkpNdBQCn4046AAAAnGb9+q81Y8YUdevWQzExHyk0tIoGDOir5GRzpvWvX7+m0qWD9eKLfRQQEJBpnR07tqtNm3aaM2e+pkyZqYyMDPXv30epqan2OmPHjtTx48c0ceJkLVy4TA0bPqIRI6J18OD+HOknAOQUknQAAAA4zbJli9WyZWs1b/6kKlYM0eDB0SpYsKBWrfoi0/rh4RF66aV+atr0cXl6emVa5513pqtZs5YKCamkypWraNiwUTp37qwOHNhnr7Nnzy61bfuMqlWLVJkywera9Xl5exfVgQMk6QDuLSTpAAAAcIr09HQdPLhfdevWs5cZjUbVrfuA9u7d5bTjXL16RZJUrFgxe1lkZA1t2PCNLl26KKvVqnXrvlJa2nXVrn2f044LALmBZ9IBAADgFBcvXpDFYpG/v79Dub+/v44dO+qUY1itVk2bNlnVq9dUSEiovfyNNyZq5MhoNWvWRCaTSQULFtT48ZMUHFzWKccFgNxCkg4g33D2REa//bZdS5Ys0oED+5SUlKjx4yepYcNGDnXM5iTNmjVdmzf/oitXLqtmzTrq33+wypYtl1PdBIA87Z133lR8/BG99948h/J582bp8uXLevfd9+Tj46sff/xOI0a8qpkz56lSpdBM2wIAd8RwdwD5Qk5MZJSamqrQ0MoaMGBoptttNpuiowfp9OlTmjhxsubPX6ySJUvqlVd6O0x2BAB5hY+Pr0wmk8xmx9+tZrP5lr9L78Y777ypn3/eqGnTZqt48RL28lOnTiouLlbR0SNUt+4Dqly5iv77356qWrWaPv00NtvHBYDcRJIOIF/IiYmMHnzwIfXs2VsPP/xIpttPnDiuvXt3a+DAVxUeHqFy5Spo0KBoXb9+XevWfeW0vgGAu/D09FSVKmHatm2zvcxqtWrbti2KiKiR5XZtNpveeedN/fDDd5o6dZZKly7jsP3atWuSbjz//ncmk1FWqy3LxwUAVyBJB5Dn5dZERpkdV5IKFCjgcFwvLy/t2vVbjh0XAFypQ4eOWrlyhdasWaWjR//QpEkTlJqaqubNW0qSxowZodmzZ9jrp6en69ChAzp06IDS09OVkJCgQ4cO6OTJE/Y6kye/qa+/XqORI8eqcOHCSkpKVFJSoq5fv5Gcly9fQcHBZfX22+P1++97dOrUSS1d+pG2bPlVDRs+nLtvAABkE8+kA8jzcmMio8yUL19BJUqU1OzZMzR48DAVKlRIH3+8WOfPn1NSUmKOHRcAXKlJk8d04UKy5s2bLbM5SaGhVTR58nT5+98Y7n7u3FmHO96JiQnq1q2j/fXSpYu0dOki1apVRzNmzJUkrVjxiSSpb98XHI41bNhINWvWUh4eHnr77amaPXu6hg4doNTUFJUpU1bDh4/Sgw/Wz+kuA4BTkaQDQA7x8PDQuHFva+LEMWrWrLFMJpPuu+8B/etfUbIx+hJAHta27TNq2/aZTLf9mXj/qVSp0tq4cett2/un7ZJUtmw5jRv39p0HCQBuiiQduAVnzwR+J20mJSXqvfemasuWzUpJuapy5crruef+q0aNmuRYP/ODnJ7I6HbCwsK1YMESXblyRenp6fLz81OPHl0UFlYtR48LAACAexPPpAOZyImZwO+kzbFjR+r48WOaOHGyFi5cpoYNH9GIEdE6eHB/jvQzv8ipiYzuhre3t/z8/HTixHEdOLBPDRrwjCSA/MtoNMjDw+iUL6PR4OruAIBTcScdyMTfZwKXpMGDo7Vp00atWvWFOnfuelP98PAIhYdHSJLDZDh32+aePbs0cOCr9rvrXbs+r9jYpTpwYL+qVAlzci/zlw4dOmrcuFEKC6um8PAIxcYuuWkio6Cg4nrxxT6SbkxkdPRovP37PycyKlSosIKDy0qSUlJSdOrUXxMbnTlzSocOHVDRoj4qWbKkJGnDhnXy9fVViRIlFR9/WFOnTlaDBg/rgQf+lZvdBwC3YTQa5ONbWB4m59wryrBYdfFCCrO4A8gzSNKB//HnTOCdO3ezl2V3JvA7bTMysoY2bPhGUVH15e1dVBs2fKO0tOuqXfu+rHcIknJmIqP9+3/Xyy+/aK8zffoUSdK//91Cw4ePknTjEYYZM6bIbE5SQECgnniiubp2fT6nuwsAbstoNMjDZFS/ZTt0+PyVbLUVWtxbUzvUltFoIEkHkGeQpAP/IydmAr/TNt94Y6JGjoxWs2ZNZDKZVLBgQY0fP8l+5xbZ4+yJjOrUqfuPddq166B27TrcXaAAkA8cPn9Fe09fcnUYAOB2SNIBNzJv3ixdvnxZ7777nnx8fPXjj99pxIhXNXPmPFWqFOrq8AAAAADkMJJ04H/kxEzgd9LmqVMnFRcXqw8//FghIZUkSZUrV9HOnb/p009jNXjwsCwdG3fGaDQ4bfIhq9XGsEsAAABkCUk68D/+PhN4w4aNJP01E3ibNu1zrM1r165JksNz0ZJkMhlJ+HIYkxgBAADAXZCkA5nIiZnA/6nN8uUrKDi4rN5+e7xeeqmffHx89cMP32nLll/11ltTXPAu5B9MYgQAAAB3QZIOZCInZgL/pzY9PDz09ttTNXv2dA0dOkCpqSkqU6ashg8fpQcfrJ+Lvc+/mMQIAIDMxcXFaunSRTKbk1SpUmX17z/YvmRsZjZsWKd582bp7NkzCg4uq169+jr8f8ZsTtKsWdO1efMvunLlsmrWrKP+/QerbNlykqRLly4qJmaONm/+RefOnZOvr68aNmyk55/vJW9v7xzvL+BKJOnALTh7JvB/alOSypYtp3Hj3r67QAEAAHLQ+vVfa8aMKRo0KFrVqkUqNnapBgzoq6VL4+Tn539T/d27d2r06OF64YWXFBXVQN98s1bR0YP0wQcfKSQkVDabTdHRg+Th4aGJEyerSJEiWrZssV55pbc++mi5ChUqpMTEBCUmJuill15RxYohOnv2jN5+e4ISExM0duxbLngXgNzjnAcwAQAAAORJy5YtVsuWrdW8+ZOqWDFEgwdHq2DBglq16otM6y9fvkz16j2oZ599ThUqVFSPHr1UpUqY4uJiJUknThzX3r27NXDgqwoPj1C5chU0aFC0rl+/rnXrvpIkhYSEaty4t1W/fkOVKROs++67Xz179tZPP/2ojIyMXOs74Aok6UAWGY0GeXgYnfLlrFnFAQAAnCk9PV0HD+5X3br17GVGo1F16z6gvXt3ZbrPnj27VLfuAw5l9eo9qD17dtvblKQCBQo4tOnl5aVdu367ZSxXr15RkSJF5OHBYGDkbS7/CV+8eLFiYmKUkJCgsLAwvf7666pRo0amdQ8dOqRp06Zp7969OnXqlKKjo9W1a9fcDRgQs4ED7sDZz0empKRo9uzp+vHH73Xx4kWVLl1aTz/9jFq3ftpep0+fnvrtt+0O7bZq1YYlEgHkWRcvXpDFYpG/v+Owdn9/fx07djTTfczmpJuGwfv5+ctsTpJ0Y7LcEiVKavbsGRo8eJgKFSqkjz9erPPnzykpKTHTNi9cuKAFC+apZcunst8pwM25NElfvXq1JkyYoNGjR6tmzZpauHChunfvrrVr12a6HnVqaqqCg4P1xBNPaMKECS6IGLiB2cAB13L285GSNH36FG3fvkWvv/6GSpUqrc2bf9E777ypwMAg1a//sL2tli2f0vPPv2B/XbBgwZzvMADkIR4eHho37m1NnDhGzZo1lslk0n33PaB//StKtkz+K3T16hUNHtxPFSqEqHv3F26uAOQxLk3S58+fr/bt26tt27aSpNGjR+u7775TXFycevbseVP9GjVq2O+yT548OVdjBTLDbOCAa/z9+UhJGjw4Wps2bdSqVV+oc+euN9X/+/ORktSjRy9t2fKr4uJi7XfB9+zZqX//u4Xq1Kkr6cYd8s8//1S//77XIUkvWLCgAgICc7iHAOAefHx8ZTKZZDabHcrNZnOmN9Ukyd8/QMnJjvWTk832FW0kKSwsXAsWLNGVK1eUnp4uPz8/9ejRRWFh1Rz2S0m5qoEDX1bhwkU0fvzbDHVHvuCyZ9LT0tK0d+9eRUVF/RWM0aioqCjt2LHDVWEBANxcTjwfKUmRkTW1ceMPSkg4L5vNpu3bt+rEieN64IF/Oez3zTdr1Lx5E3Xu3F6zZ8/QtWvXnNg7AHAvnp6eqlIlTNu2bbaXWa1Wbdu2RRERmT+iGhlZQ1u3bnEo27LlV0VGVr+prre3t/z8/HTixHEdOLBPDRr8dVH06tUr6t+/jzw8PPTmm+84PMMO5GUuuxSVnJwsi8Vy0xW4gIAAxcfHuygqAIC7y4nnIyWpf//BeuutcXrqqWYymUwyGo0aMmS4atWqY6/z6KNPqGTJUgoMDNKRI4c0a9Z0HT9+TOPHs3QigLyrQ4eOGjdulMLCqik8PEKxsUuUmpqq5s1bSpLGjBmhoKDievHFPpKkdu06qE+fnlq69CNFRdXXunVfaf/+3zVkyF/zd2zYsE6+vr4qUaKk4uMPa+rUyWrQ4GH7hdE/E/Tr169pxIgxunr1iq5evfGIoa+vn0wmUy6/C0DuYbwIAACSPvnkY+3du1sTJ76jkiVLaefO7XrnnbcUGBik+++/cde+Vas29vqVKoUqICBQ/fr10qlTJ1WmTLCrQs8TnD0RYP36dTPdr3fvl+2PPUjSzz9v1Pz57+vIkcPy8vJS7dp1NGECj9QBf9ekyWO6cCFZ8+bNltmcpNDQKpo8ebp9+Pq5c2dlNP41QLd69ZoaOXKc3n//Pc2dO1PBwWU1YcIk+xwgkpSUlKgZM6bIbE5SQECgnniiubp2fd6+/cCB/fr99z2SpGeeae0Qz/LlX6hUqdI52GPAtVyWpPv53bgClpSU5FCelJSkwECe9QMAZC4nno+8fv2a5s6dqfHjJykq6kaiFxpaWYcOHdTSpR/Zk/T/9WcSefLkCZL0bMiJiQA//3ytwz6//PKzJk4co4cfbmwv++679XrzzXF64YXeqlPnflksFsXHH8nZzgL3qLZtn1Hbts9kum3GjLk3lTVu3FSNGze9ZXvt2nVQu3Ydbrm9Tp262rhx690HCuQBLnsm3cvLSxEREdq0aZO9zGq1atOmTapdu7arwgIAuLmceD4yIyNDGRkZMhgMDnWMRqNsNustYzl06IAkMZFcNv19IsCKFUM0eHC0ChYsqFWrvsi0/t8nAqxQoaJ69OilKlXCFBcXa68TEBDo8LVx4/eqU6eu/WJKRkaGpk6drJdeelmtWz+tcuXKq2LFEDVp8miu9BkAgFtxWZIuSd26dVNsbKw+++wzHTlyRKNGjVJqaqratLkxnHDIkCEOs7inpaVp37592rdvn9LS0nTu3Dnt27dPx44dc1UXAAAu0KFDR61cuUJr1qzS0aN/aNKkCTc9Hzl79gx7/XbtOujXX3/W0qUf6dixo4qJmaP9+39X27btJUlFinirVq06eu+9qdq+fatOnz6l1atXau3a1WrY8BFJ0qlTJ7VgwTzt379PZ86c1saN32vs2JGqVauOQkMr5/6bkEfk1ESAf2c2J+nnnzeqefNW9rKDB/crIeG8DAajunV7Vq1aPa6BA19WfPxhJ/QKyF+MRoM8PIxO+TIaDf98QCCPc+kz6c2aNZPZbNa0adOUkJCg8PBwzZs3zz7c/cyZMw7Pt5w/f16tW7e2v/7ggw/0wQcf6IEHHtCiRYtyO3wAgIvkxPORo0eP15w5M/XGG6/r0qVLKlmypHr27KXWrW8sE+rh4aGtWzcrNnaprl1LVfHiJdSoUWN16dI9dzufx+TURIB/t2bNKhUuXEQPP/yIvez06VOSpA8+mKu+ffurZMnSWrbsI/Xt+4KWLv1UxYr5ZKNXQP5hNBrk41tYHibn3PvLsFh18UKKrNZMFkwH8gmXTxzXqVMnderUKdNt/5t4BwcH68CBA7kRFgDAzTn7+ciAgEANGzbylttLlCiZabtwf19++YUee+wJh+Wb/kwAnnvuv2rUqIkkadiwkWrTppk2bFhnvzgD4PaMRoM8TEb1W7ZDh89fyVZbocW9NbVDbRmNBpJ05GsuT9IBAHA2o9HgtCGTVquN/yzmoJyYCPDvdu7coePHj2n06AkO5X+O2qtQIcRe5uXlpVKlyujcubNZ6guQnx0+f0V7T19ydRhAnkCSDgDIUxh6eW/5+0SADRs2kvTXRIBt2rTPdJ8/JwJs3/5Ze9nfJwL8u1WrPlfVquGqXLmKQ3nVqmHy8vLSiRNHVbNmLUk3JpM7e/aMSpYs5ZzOAQCQBSTpAIA8haGX954OHTpq3LhRCgurpvDwCMXGLrlpIsCgoOJ68cU+km5MBNinT08tXfqRoqLqa926r7R//+8aMmSYQ7tXr17Rt9+uU58+r9x0zCJFvNWqVVvFxMxV8eIlVbJkSS1ZcuMxu0ceufVjEQAA5DSSdABAnsTQy3tHTkwEKEnr1n0tm82mpk2fyPS4L73UTyaTSWPGjND169dVrVqEpk6dpWLFiuVcZwEA+Ack6QAAwOWcPRGgJLVq1UatWrW55XYPDw/16fNKpnfaAQBwFZJ0AADg1pw5EaDEZIAAAPdGkg4AANyWsycClJgMEADg3kjSAQCA23LmRIASkwECANwfSToAAHB7TAQIAMgvnDd2DAAAAAAAZAtJOgAAAAAAboIkHQAAAAAAN0GSDgAAAACAmyBJBwAAAADATTC7OwAAThYXF6ulSxfJbE5SpUqV1b//YFWrFnnL+hs2rNO8ebN09uwZBQeXVa9effXgg/Xt22Ni5mj9+q91/vw5eXh4qmrVcPXs2VsREX+1efz4Mb333lTt3r1T6ekZqlQpVD169FKdOnVztK8AAMC5uJMOAIATrV//tWbMmKJu3XooJuYjhYZW0YABfZWcbM60/u7dOzV69HC1aNFKH3ywWA0aNFJ09CDFxx+21ylbtrz69x+ihQuX6b335qlUqVIaMOAlJScn2+sMGdJfFotFU6fOVkzMIoWGVtGQIa8oKSkxx/sMAACchyQdAAAnWrZssVq2bK3mzZ9UxYohGjw4WgULFtSqVV9kWn/58mWqV+9BPfvsc6pQoaJ69OilKlXCFBcXa6/z2GNP6P7766lMmWCFhFRS3779dfXqVR05ckiSdOHCBZ08eVydOnVVaGhllS1bTr169dG1a9cUH38kV/oNAACcgyQdAJDvGeM3yuurMfL6fIg8v3tXBvOx29bfsGGdnn22rRo3jtJzzz2jTZs2SpLS09N18OB+XbhwQc8+21ZNm9ZXs2ZNZLVa9csvP2Xa1p49u3Tw4AHVr19Xhw4dkCTVq/eg9uzZnWn99PR0ff75Z/L29lZoaBVJko+Pj8qVK6+1a79UamqqMjIytGLFp/Lz81fVquFZfVsAAIAL8Ew6ACBfM57cIY/dnyujVjvZ/MrJdOQHef48V2mPviqp2E31/xye/sILLykqqoG++WatoqMH6YMPPlKxYj6yWCwqX76iWrZsrdKly+j69esaNWq4du/eqeTkZPn5+Tm0l5CQoEqVKikxMcFe5ufnL7M5yaHeTz/9qFGjhunatWsKCAjUlCkz5evrK0kyGAx69933FB09SI891lBGo1G+vn6aPHmaihW7uQ8AAMB9cScdAJCvmQ5/L2uFf8la/gHZipVURq2nJZOnTEc3Z1r/Toan16v3L4fh6ffdV1dWq9U+PP1Pmzb9JJvNqsce+/c/xlmnTl3Nn79Es2Z9oHr1HtSIEdH259xtNpveeedN+fn5aebM9zV37kI1aNBIQ4cOUGIiz6QDAHAvIUkHAORf1gwZLpyUNajKX2UGo6xBVWQwH810lz17dqlu3Qccyv4cnu7j4yuTySSz+a9J4tLT07Vr106ZTCb78HRJMpuT9NZb4+Tv76+UlKsO7SUnm+XvH+BQVqhQIQUHl1VkZHVFR4+QyWTSqlWfS5K2bduin3/eqNGjx6tGjVqqWjVMgwa9qgIFCmjNmlVZeWcAAICLMNwdAJB/Xb8qg80qW4GiDsW2gkVlvHI+013M5iT5+fk7lP05PN3T01NVqoRp27bNMplMGjVqmFJTU2U0GtW6dVv78HSbzaZx40arVas2io8/ot27dzm0t2XLr4qMrH7b0K1Wq9LS0iRJ165dkyQZDI7X3g0Gg2w26+3fAwAA4Fa4kw4AgBN16NBRK1euUGJigsaOfVMNGjwso9GkjRt/UHKyWWPGjFD//i8pJeWqOnfupnbtOui337ZLks6cOa2YmDnav/93tW3bXpKUmpqqOXNmas+e3Tp79oz279+n8eNHKzExQY880lSSFBlZQ0WLFtW4cSN16NBBHT9+TDNnTtWZM6cd1lsHAADujzvpAID8q0AR2QxGGa5flu1vxYZrl2+6u/4nf/+Am9Y8//vw9CZNHtOFC8n68MMPZDYnKTS0imbOfF9jxryuVas+17lzZ3X69CklJiaoceMoSTfurEvSsGGD5e3trQkTJikkJFSSZDQadezYUa1Zs0oXL15QsWI+Cg+vppkz31dISCVJkq+vryZPnq65c99Tv369lJGRoYoVQzRhwmRVrlxFAADg3kGSDgDIv4wesvkGy5hwSNbS/z+83GaVMeGQLCGZ34GOjKyhrVu3qH37Z+1l/zs8vW3bZ9S27TMO+/05PH3GjLk6e/asUlKu2LclJiZqwIA+Gjv2TVWrFqnixUvYtxUoUEDjx7/9j10JC6umd96ZcUfdBu41xviN8jj0rXTtsmw+pZVR4ynZ/Mvfsv6GDes0b94snT17RsHBZdWrV1/7qJKMjAzNnfuefvnlJ50+fUpFinirbt0H1KtXXwUGBtnbWLgwRps2/aRDhw7I09NTa9d+l9PdBABJDHcHAORzltCHZTz6i4zHtshw6Zw8fvtEsqTJUv7G5HBDhgzRe+9Nt9dv166Dfv31Zy1d+pGOHTuapeHpJUuWVEhIqP2rbNlykqQyZYIdEnQAf1smMexxpT8yQDaf0vL8ea50/XKm9f9cJrFFi1b64IPFatCgkaKjByk+/rCkG3M4HDy4X126PK8PPvhI48a9rePHj2no0AEO7WRkZOiRR5qodeunc7yPAPB33EkHAORr1uDayrh+RR771krXL8nmU0bpUT2lgjeGu585c0bp6X9Nvla9ek2NHDlO77//nubOnang4LJ3NTzdaDTIaDQ4xGAyGe3/enjc+fVzq9Umq9X2zxWBe9jfl0mUpIxaT8vr7O83lkms+NRN9f++TKIk9ejRS1u2/Kq4uFgNHjxM3t7eevfd9xz2GTBgiHr06KKzZ8+qZMmSkqTu3V+QJK1evTInuwcANyFJBwDke9ZKDZRWqUGm2xYtWqTk5KvKyPgrUW/cuKkaN26aaf3bDU83Gg3y9Sskk9HkUO7nV1kHDhy467gtVosuJKeSqCPv+v9lEi1VmvxVdgfLJHbo0NGhrF69B/XDD9/d8jBXrlyRwWBQ0aLeTggaALKHJB0AgH/w551uZ7RjMpr06g+vKv5ifLbaCvEJ0cSGE2U0GkjSkXc5eZnETA9x/bpmzZqupk0fV5EiJOkAXI8kHQCAWwjyLiBZLSpWrJBT242/GK995n1ObRPA3cvIyNCIEa9KsmnQoFddHQ4ASCJJBwDglooV8pCMJinueSnxYPYbDG0qNRmR/XaA/CIHlkn8U0ZGhl5//VWdPXtW06bN4i46ALdBkg4AwD9JPCid2Zn9dgJZsxy4Kzm0TOKfCfrJk8c1bdoc+fj45mQvAOCusAQbAAAA3Jazl0nMyMjQa68N0YED+zRixFhZrRYlJSUqKSlR6enp9nbOnj2rQ4cO6Ny5s7JYrDp06IAOHTqglJSU3H0DAOQ73EkHAACA23L2MokJCee1ceMPkqRu3Z51ONa0abNVp05dSVJMzGytWbPKvq1bt4431QGAnECSDgAAALfmzGUSS5UqrY0bt/7jMYcPH6Xhw0dlKV4AyA6GuwNuJC4uVk8/3VKNG0epR48u+v33Pbetv2HDOj37bFs1bhyl5557Rps2bcyRtpA1nE/AfX3yycdO/UzxGc1bOJ+ux99Q5Gck6YCb+OabrzRjxhR169ZDMTEfKTS0igYM6HvTDLV/2r17p0aPHq4WLVrpgw8Wq0GDRoqOHqT4+MNav/5rp7WFrOF8Au5r9erVmjr1Had9pviMup7JZJSHR/a/jEYD59MN8DcU+R1JOuAmli5drJYtW6t58ydVsWKIBg+OVsGCBbVq1ReZ1l++fJnq1XtQzz77nCpUqKgePXqpSpUwxcXFatky57WFrOF8Au5r/vz5atXqKad9pviMuk6QdwHJalGxYoXk51ck21/+vgX18cecT1fjbyjyO55JB9xAWlqaDhzYp06dutrLjEaj6tZ9QHv37sp0nz17dqlDh44OZfXqPajvv/9Wx479oc6du2W7rR9++C5rHcrnOJ+A+7JZMrR371517NjFXpadz1R6eroOHtzPZ9RFihXykIwmKe75G0slZkdgFaW3fE8HDuxXp06cT1fhbyhAkg64heTkZFksFvn7+zuU+/v769ixo5nuYzYnyc/Psb6fn7+SkhKd1pbZnHR3HYEkzifgzizXrjj1M3Xx4gU+o+4g8aB0Zme2m3Hm72/OZ9bwNxRguDsAAAAAAG6DJB1wA35+fjKZTDKbHScxMZvNCggIyHQff/+AmyY9SU42KyAg0Glt+ftnXh+3x/kE3JepoLdTP1M+Pr58RvMQZ/7+5nxmDX9DAZJ0wC14eXmpatVwbdu22V5mtVq1bdsWRUTUyHSfyMga2rp1i0PZli2/qnr1GqpSJcwpbUVGVs9ql/I1zifgvgwmD0VERGjLFud8pjw9PfmM5iHO/P3N+cwa/oYCJOmA2/jPfzpq5coVWrNmlY4e/UOTJk1QamqqmjdvKUkaM2aEZs+eYa/frl0H/frrz1q69CMdO3ZUMTFztH//72rbtr06dHBeW8gazifgvrp166YvvvjMaZ8pPqN5izN/fyNr+BuK/M4tJo5bvHixYmJilJCQoLCwML3++uuqUSPzq1uStGbNGk2dOlWnTp1ShQoVNGjQID388MO5GDHgfI8++rjMZrPmzZstszlJoaFVNHnydPvwqnPnzspo/Ou6WvXqNTVy5Di9//57mjt3poKDy2rChEkKCQlVSEioLlxIdkpbyBrOJ+C+mjVrppMnzzjtM9WkyWN8RvMQZ/7+RtbwNxT5ncFms9lcGcDq1as1ZMgQjR49WjVr1tTChQu1du1arV27NtNnRbZv365OnTppwIABeuSRR7Ry5UrNmzdPn376qapUqXLHx01MvKzc6rmHh1F+fkXUfNqP2nv6Urbbe7JmKU37Tx1pTsPsz2RavZ3Udp7ar2yvfeZ92Woq3D9csS1jlZx8VRkZ1uzF5eaceU4jShfTly83yBfvm7vifOYtzjyfTv19K/E7Nwuc/TeUz6jrue1ntFRN6YUf+Nm4S/wNzVvc9vMp3fN/Qw0GKTCw6B3Vdflw9/nz56t9+/Zq27atQkNDNXr0aBUsWFBxcXGZ1v/www/VoEEDPf/886pUqZJeeeUVVatWTR999FEuRw4AAAAAgHO5dLh7Wlqa9u7dqxdeeMFeZjQaFRUVpR07dmS6z2+//aauXbs6lNWvX1/r1q27q2MbDHcdbrZFlC6mQl6mbLdTKcj7xjcla0iehbPXWMCNoTvh/uEq5FEoW01VKFbB/r0r3l9XcMY5DQksIkkymZxzzcxmc+77b7PZZLW6dMBNrnHH8yk595xyPu+OU3/fSvzOzQZn/Q1159+5+enzKbnhZ/T/P5/O/f2df84pf0PzFrf7fEr3/N/QuzmOS4e7nzt3Tg0bNtSyZctUu3Zte/lbb72lLVu2aPny5TftExkZqYkTJ6pFixb2ssWLF2vmzJn6+eefcyVuAAAAAABygsuHuwMAAAAAgBtcmqT7+fnJZDIpKSnJoTwpKUmBgYGZ7hMYGKjExMQ7rg8AAAAAwL3CpUm6l5eXIiIitGnTJnuZ1WrVpk2bHIa//12tWrX0yy+/OJT9/PPPqlWrVk6GCgAAAABAjnP5cPdu3bopNjZWn332mY4cOaJRo0YpNTVVbdq0kSQNGTJEkydPttd/7rnn9OOPP+qDDz7QkSNHNH36dO3Zs0edOnVyVRcAAAAAAHAKl87uLknNmjWT2WzWtGnTlJCQoPDwcM2bN88+fP3MmTMyGv+6llCnTh1NmjRJ7777rt555x1VqFBBM2fOvKs10gEAAAAAcEcund0dAAAAAAD8xeXD3QEAAAAAwA0k6QAAAAAAuAmSdAAAAAAA3ARJOgAAAAAAboIkHQAAAAAAN+HyJdjgPBkZGTp8+LASEhIkSUFBQapUqZI8PT1dHBmcLSMjQ+fPn1fp0qVdHQruQkJCgnbu3KnExERJUmBgoGrWrKmgoCAXRwYAAAB3QZKeB1itVk2dOlVLlizR5cuXHbYVLVpUHTt21Msvv+yw3jzubYcPH9ZTTz2lffv2uToU3IGUlBSNGDFCq1evlsFgkI+PjyTp4sWLstlsat68ud544w0VKlTIxZHCGVJSUrR3717df//9rg4Fd4kLaQAAd0CSngdMmjRJn332mQYOHKj69esrMDBQkpSYmKiffvpJU6dOVXp6ugYPHuziSIH8ady4cdq9e7fmzJmjqKgomUwmSZLFYtGmTZs0ZswYjRs3TmPHjnVxpHCG48eP67nnnuMi2j2EC2n5CxfS7k27du3Sjh07HC6i1a5dWzVq1HBxZHC2ixcv6ttvv1Xr1q1dHYrLGGw2m83VQSB7HnroIU2cOFENGjTIdPuPP/6ooUOH6ueff87lyJBVTz311G23X7t2TUePHiUJuEfcf//9mjNnjurUqZPp9m3btunFF1/Uli1bcjky5IT9+/cz0uUeM3z4cG3dulWvvfbaLS+k3X///VxIyyP4jN5bkpKS1LdvX23fvl2lS5dWQECAvfz06dOqU6eOpk+fbi/HvY/PKHfS84SrV6+qePHit9weFBSk1NTUXIwI2XX48GE1b95cwcHBmW4/f/68jh49mrtBIcusVutt54bw9PSU1WrNxYiQHQ888MBtt1ssllyKBM7y9ddfZ3ohzWQyqX79+ho/frxefPFFknTABUaPHi2r1arVq1crJCTEYVt8fLyGDRum0aNHa9q0aS6KEHfrypUr2dqeH5Ck5wEPPPCA3nrrLb399tvy9/d32GY2mzVp0qR//E8l3EvlypVVo0YNPfvss5lu37dvn5YvX57LUSGrGjVqpBEjRmjcuHGqVq2aw7bff/9do0aN0iOPPOKi6HC30tLS9J///EdVqlTJdPupU6c0c+bMXI4K2cGFtLyFC2l5y48//qjFixfflKBLUkhIiF577TV17tzZBZEhq+rWrSuDwXDL7Tab7bbb8wOS9Dxg9OjR6tmzpxo0aKAqVao4DAM6ePCgKlWqpDlz5rg4StyNOnXq6I8//rjl9iJFiqhu3bq5GBGyY8SIERo4cKDatGkjHx8f+8U0s9msS5cuqX79+hoxYoSLo8SdCgsLU8mSJW/5WMr+/ftJ0u8xXEjLW7iQlrd4eXnd9s7q1atX5eXllYsRIbuKFCmiF198UTVr1sx0+7Fjx/L9/4tI0vOAUqVK6fPPP9ePP/7oMCttjRo11L9/f9WvX5+Z3e8xr7322m23lytXTosWLcqlaJBdPj4+mjdvno4cOaLffvvNYdKbWrVqqVKlSi6OEHejUaNGN62k8Xc+Pj75erKbexEX0vIWLqTlLc2aNdOrr76q6OhoPfjgg/L29pZ0Y0j0pk2bNGHCBLVo0cLFUeJu/Hkx9FajXooVK6b8Pm0aE8cBAABIXEjLI2bPnq2MjAz16dMn0+1nzpzRtGnTNGHChFyODFmRlpamcePGKS4uThaLxf5oSnp6ukwmk55++mkNGzaMu+n3kNjYWF27dk3PPfdcptsTExO1bNmyW36G8wOS9DyEpSnyHs5p/sBSIwAA3N6VK1e0Z88eh/8TRUZG2u+sA3kJSXoewNIUeQ/nNH9hqZG8hYsu96a0tDStW7fupjvptWvXVpMmTbhLBwDINSTpecDLL7+s8+fPa/z48bdcmqJ48eIsTXEP4ZzmLf+0lMj+/fvVuXNnkvQ8gosu955jx46pe/fuOn/+vGrWrOlwYXTnzp0qWbKk3n//fZUvX97FkeJOcdEl/2BodN7DOSVJzxNq166txYsX3zQj7Z/27Nmjzp07a8eOHbkcGbKKc5q3hIWF3dFSIyR19wYuuuQ93bp1U6FChfTWW2/dNHT2ypUrGjJkiK5fv66YmBgXRYi7wUWX/IULo3kP55TZ3fMElqbIezineQtLjeQtrO+a92zfvl3Lly/P9NlWb29v9evXT+3bt3dBZMiKUaNGqUqVKlqxYsUtL7q88cYbXHS5R+zfv/+22+Pj43MpEjgL5/SfkaTnASxNkfdwTvMWlhrJW7jokvcULVpUp06duu262kWLFs3lqJBVXHTJW1q3bi2DwZDp38k/y7kwem/hnP4zkvQ8IDo6WlarVf3797/l0hRDhw51cZS4G5zTvKVly5ZKTU295fbAwMB8/dzVvYaLLnlPu3btNHToUPXu3Vv/+te/FBgYKOnGc5G//PKLZs2apU6dOrk4StwpLrrkLT4+Pho8eLAefPDBTLcfPnxYL774Yi5HhezgnP4zkvQ8wMvLS6NHj9bgwYNZmiKP4JzmLf90x4Yk/d7CRZe8p1+/fipUqJDmzZuniRMn2u/g2Gw2BQYG6vnnn1ePHj1cHCXuFBdd8pbIyEidP39eZcqUyXT75cuXuTB6j+Gc/jMmjssjzGaz4uLiMp3FtE2bNvL393dxhLhbnNO8hfMJ3BtOnDjh8BktW7asiyNCVsydO1cffvihEhMTb7ro0qVLFy663EO++eYbpaSkqFWrVpluv3jxojZs2KCnnnoqlyNDVnFO/xlJeh6wa9cuPf/88ypYsKCioqIcZjHdtGmTrl27pnnz5ql69eoujhR3inOat3A+8x4uuuQvZ86c0bRp0zRhwgRXh4K7xEUXAPcikvQ8oH379goLC9Po0aNvmmTBZrNp5MiROnDggD7++GMXRYi7xTnNWzifeQsXXfIflgPKW7jokrdwPvMezilJep5Qo0YNffbZZ6pUqVKm248cOaKnnnpKu3btyuXIkFWc07yF85m3cNEl71m/fv1tt584cUJvvvkmSXoewUWXvIXzmfdwTpk4Lk8IDAzU7t27b5kA7N692z5pCu4NnNO8hfOZt+zfv18TJkzIdHkYg8GgLl265Ovn6O5FL7300i2XA/pTfl8O6F5yJxddcO/gfOY9nNN/RpKeB3Tv3l2vv/669uzZowcffNBhFtNNmzZp+fLlGjJkiIujxN3gnOYtnM+8hYsueU9QUJBGjhyppk2bZrp93759atOmTS5HhaziokvewvnMezin/4wkPQ/o2LGj/Pz8tGDBAi1dulQWi0WSZDKZFBERoQkTJqhZs2YujhJ3g3Oat3A+8xYuuuQ9ERER2rt37y2T9H/6zyTcCxdd8hbOZ97DOf1nJOl5RLNmzdSsWTOlp6crOTlZkuTn5ydPT08XR4as4pzmLZzPvIOLLnnP888/r5SUlFtuL1eunD788MNcjAjZwUWXvIXzmfdwTv8ZE8cBAJBFXHQB3M/WrVuVkpKihg0bZro9JSVFe/bs0QMPPJDLkSErOJ95D+f0n5GkAwAAAADgJoyuDgAAAAAAANxAkg4AAAAAgJsgSQcAAAAAwE2QpAMAAAAA4CZI0gEAyKdeffVV9e7d+673mz59ulq1apUDEQEAAJJ0AAAAAADcBEuwAQCQx61du1YzZ87UsWPHVKhQIYWHhys8PFwffPCBQ70PP/xQ9erV09tvv61169bp7NmzCgwMVMuWLfXSSy/J09NTn376qaKjox32mzBhgtq0aaNLly7pzTff1Pr165WWlqbIyEgNGzZMYWFhkqT9+/dr3Lhx2rNnjwwGgypUqKDRo0erevXqufZeAADg7jxcHQAAAMg558+f18CBAzV48GA1bdpUV69e1datW9W6dWudOXNGV65c0YQJEyRJPj4+kqQiRYpowoQJKl68uA4ePKjXX39dRYoUUY8ePdSsWTMdOnRIP/74o+bPny9JKlq0qCSpX79+KlCggN5//30VLVpUH3/8sbp06aKvvvpKvr6+GjRokMLDwzVq1CiZTCbt27dPnp6ernljAABwUyTpAADkYQkJCcrIyNCjjz6qMmXKSJKqVq0qSSpYsKDS0tIUFBTksM/fn1MPDg7WH3/8oS+//FI9evRQwYIFVbhwYZlMJof9tm7dql27dmnTpk3y8vKSJA0dOlTr1q3TV199pWeeeUanT59W9+7dValSJUlShQoVcrLrAADck0jSAQDIw8LCwvTggw+qZcuWql+/vurXr6/HH3/cftc8M6tXr9aHH36oEydOKCUlRRkZGfL29r7tcQ4cOKCUlBTVq1fPofzatWs6fvy4JKlbt2567bXX9PnnnysqKkpPPPGEypUrl/1OAgCQh5CkAwCQh5lMJs2fP1/bt2/XTz/9pEWLFmnKlCmKjY3NtP6OHTs0aNAg9e3bV/Xr11fRokX15Zdf2oe238rVq1cVFBSkRYsW3bTtz+Hwffv2VYsWLfT999/rhx9+0LRp0zRlyhQ9+uij2e8oAAB5BEk6AAB5nMFg0H333af77rtPL730kh555BGtW7dOnp6eslqtDnV37Nih0qVLq1evXvay06dPO9TJbL+IiAglJibKZDIpODj4lrFUrFhRFStWVNeuXTVgwADFxcWRpAMA8Dck6QAA5GE7d+7Upk2b9NBDDykgIEA7d+6U2WxWSEiIrl+/ro0bNyo+Pl6+vr4qWrSoypcvrzNnzujLL79U9erV9d1332ndunUObZYpU0YnT57Uvn37VKJECXl7eysqKkq1atXSSy+9pMGDB6tChQo6f/68vv/+ezVt2lSVK1fWW2+9pccff1zBwcE6e/asdu/erccee8xF7wwAAO6JJdgAAMjDjhw5ov9r745tDgqgMAx/+Ru1UFlCYwCVKZjCjZhAoVJYwwAm0AidKYREbhS3UvyJFZzieSY4Od1bfZvNJrfbLW3bZjQaZbFYZD6f5/F4pGmaXK/XvN/v7wTbdrvN4XBI13WZTqcZj8fZ7/c5n89Jkq7r0jRNTqdTXq/Xd4Ktbdvsdrscj8c8n88Mh8NMJpMsl8sMBoOs1+tcLpfc7/f0+/3MZrOsVqv0er0ffwkA6hDpAAAAUMTfrw8AAAAA/ol0AAAAKEKkAwAAQBEiHQAAAIoQ6QAAAFCESAcAAIAiRDoAAAAUIdIBAACgCJEOAAAARYh0AAAAKEKkAwAAQBEiHQAAAIr4ACm10TBc69cHAAAAAElFTkSuQmCC",
+      "text/plain": [
+       "<Figure size 1200x500 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "df[\"mitigated_full\"] = np.around(mitigated / sum(mitigated), 3)\n",
+    "\n",
+    "ax = df.plot(\n",
+    "    x=\"states\",\n",
+    "    y=[\"noisy\", \"mitigated_k_local\", \"mitigated_full\"],\n",
+    "    kind=\"bar\",\n",
+    "    figsize=(12, 5),\n",
+    ")\n",
+    "ax.bar_label(ax.containers[0], labels=df[\"noisy\"])\n",
+    "ax.bar_label(ax.containers[1], labels=df[\"mitigated_k_local\"])\n",
+    "ax.bar_label(ax.containers[2], labels=df[\"mitigated_full\"])\n",
+    "ax.set_ylabel(\"probabilities\")\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/unitary_compilation.ipynb b/pr-2241/sphinx/examples/python/tutorials/unitary_compilation.ipynb
new file mode 100644
index 0000000000..f0b3b1268b
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/unitary_compilation.ipynb
@@ -0,0 +1,1084 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "d60f1e23-2541-4b01-84c8-0aff758061b4",
+   "metadata": {},
+   "source": [
+    "# Compiling Unitaries Using Diffusion Models\n",
+    "\n",
+    "This notebook is based on the work presented in [Quantum circuit synthesis with diffusion models, Florian Fürrutter, Gorka Muñoz-Gil & Hans J. Briegel , Nat. Mach. Intell. **6**, 515–524 (2024)](https://doi.org/10.1038/s42256-024-00831-9)."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4b6a7722-f302-458b-9f90-8493e46d786d",
+   "metadata": {},
+   "source": [
+    "Quantum computing relies on efficiently translating quantum operations into viable physical realizations on existing quantum hardware. Recently, diffusion models — a powerful class of generative models in machine learning — have demonstrated exceptional performance on this task. \n",
+    "\n",
+    "In this tutorial notebook, we will demonstrate how to use this method to synthesize arbitrary unitaries into a `cudaq.kernel`, effectively decomposing them into sequences of quantum gates, a process commonly known as unitary compilation.\n",
+    "\n",
+    "Our focus will be on generating circuits using a pre-trained model. Specifically, we will illustrate how to compile 3-qubit unitaries."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "fef3bf4a-1008-4df8-b6e8-d5357db1f6d5",
+   "metadata": {},
+   "source": [
+    "### Diffusion model pipeline\n",
+    "\n",
+    "Generative diffusion models (DMs) have recently delivered remarkable results across a wide range of applications, from image generation to protein folding. In this work, we leverage DMs to generate quantum circuits based on a user specified unitary matrix and a text prompt that defines the allowed gate set, effectively using DMs as unitary compilers. The method is thoroughly explained in Ref. [(Fürrutter et al., 2024)](https://doi.org/10.1038/s42256-024-00831-9). The following figure  provides an overview of the proposed circuit generation pipeline:\n",
+    "\n",
+    "<figure>\n",
+    "  <img src=\"images/pipeline_simplified.png\" alt=\"Quantum circuit generation pipeline overview\" width=\"70%\"/>\n",
+    "  <figcaption><b>Quantum circuit generation pipeline</b>. Figure adapted from <a href=\"https://doi.org/10.1038/s42256-024-00831-9\">(Fürrutter et al., 2024)</a></figcaption>\n",
+    "</figure>\n",
+    "\n",
+    "The pipeline consists on 3 main components:\n",
+    "\n",
+    "**1) Circuit encoding:** Like any neural network, diffusion models operate with continuous inputs and outputs. However, since the circuits we consider are composed of discrete gates (i.e., with no continuous parameters), we develop a mapping that transforms each gate into a continuous vector. This allows us to represent a given circuit as a three-dimensional tensor, as illustrated. Crucially, this mapping is invertible: when the DM generates continuous tensors, we can apply the inverse map to convert them back into the circuit form. An overview of these steps is provided in the figure below:\n",
+    "\n",
+    "<figure>\n",
+    "  <img src=\"images/circuit_encoding.png\" alt=\"Quantum circuit encoding\" width=\"60%\"/>\n",
+    "  <figcaption><b>Quantum circuit encoding</b>. Figure adapted from <a href=\"https://doi.org/10.1038/s42256-024-00831-9\">(Fürrutter et al., 2024)</a></figcaption>\n",
+    "</figure>\n",
+    "\n",
+    "**2) Conditioning:** The user's input (the set of available gates and the unitary to compile) is also transformed into a continuous tensor by two neural networks. For the gate set description, where the input is a text prompt (e.g., \"Compile using ['x', 'h']\"), we utilize a pre-trained language model. For the unitary, we employ a neural network that is training jointly with the diffusion model.\n",
+    "\n",
+    "**3) Unitary compilation:** The generation procedure follows the typical DM process: the model is given a fully noisy tensor which is iteratively de-noised until reaching a clean sample based on the given conditioning (the desired unitary and gate set). The tensors generated by the DM are then mapped to circuits via the inverse encoding procedure. To learn more about the practical implementation of diffusion models we recommend [this tutorial](https://course.fast.ai/Lessons/lesson9.html). \n",
+    "\n",
+    "In the following we will use `CUDA-Q` and `genQC` to perform all these steps and go from a desired unitary matrix, $U$, to a quantum circuit that we can execute using CUDA-Q. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e1453ad1-e4d4-4e38-9684-fd967bc1a8de",
+   "metadata": {},
+   "source": [
+    "### Setup and compilation"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 24,
+   "id": "f1b7d96a-92d4-46f3-95a6-1d1e46d63240",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.037362Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.036980Z",
+     "iopub.status.idle": "2024-08-27T18:11:38.867336Z",
+     "shell.execute_reply": "2024-08-27T18:11:38.866445Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.037346Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "\u001b[33mWARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv\u001b[0m\u001b[33m\n",
+      "\u001b[0m"
+     ]
+    }
+   ],
+   "source": [
+    "!pip install genQC==0.1.0 -q"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 25,
+   "id": "07d177c6-60fd-497d-ae2b-41e225b56a2d",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.868456Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.868206Z",
+     "iopub.status.idle": "2024-08-27T18:11:38.872654Z",
+     "shell.execute_reply": "2024-08-27T18:11:38.871931Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.868440Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import genQC\n",
+    "from genQC.imports import *\n",
+    "from genQC.pipeline.diffusion_pipeline import DiffusionPipeline\n",
+    "from genQC.inference.export_cudaq import genqc_to_cudaq\n",
+    "import genQC.inference.infer_compilation as infer_comp\n",
+    "import genQC.util as util\n",
+    "\n",
+    "import numpy as np\n",
+    "import torch\n",
+    "\n",
+    "# Fixed seed for reproducibility\n",
+    "torch.manual_seed(0)\n",
+    "np.random.seed(0)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "id": "ccb97524-0f13-49ff-893d-983c572e66c6",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:38.873619Z",
+     "iopub.status.busy": "2024-08-27T18:11:38.873403Z",
+     "iopub.status.idle": "2024-08-27T18:11:39.025224Z",
+     "shell.execute_reply": "2024-08-27T18:11:39.024476Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:38.873603Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[INFO]: Cuda device has a capability of 8.0 (>= 8), allowing tf32 matmul.\n",
+      "cuda\n"
+     ]
+    }
+   ],
+   "source": [
+    "device = util.infer_torch_device()  # Use CUDA if we can\n",
+    "util.MemoryCleaner.purge_mem()  # Clean existing memory allocation\n",
+    "print(device)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "acf7656c-be92-4b36-8c38-d3ff6c1912e3",
+   "metadata": {},
+   "source": [
+    "### Load model"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "0047cbe9-a21c-4c72-a144-7a2929752329",
+   "metadata": {},
+   "source": [
+    "First, we load the pre-trained model weights and setup the DM pipeline.\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 27,
+   "id": "a6b18d03-6976-4eec-9ab0-7b763d73ad17",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:39.026541Z",
+     "iopub.status.busy": "2024-08-27T18:11:39.025956Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.879166Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.878426Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:39.026521Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "543d6667d288478d8d64b8e32c6675f3",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "Fetching 2 files:   0%|          | 0/2 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[INFO]: `genQC.models.unet_qc.QC_Compilation_UNet` instantiated from given config on cuda.\n",
+      "[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder` instantiated from given config on cuda.\n",
+      "[INFO]: `genQC.models.frozen_open_clip.CachedFrozenOpenCLIPEmbedder`. No save_path` provided. No state dict loaded.\n"
+     ]
+    }
+   ],
+   "source": [
+    "pipeline = DiffusionPipeline.from_pretrained(\n",
+    "    \"Floki00/qc_unitary_3qubit\", device)  # Download from Hugging Face\n",
+    "pipeline.scheduler.set_timesteps(40)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bc112d57-71a8-403c-a0a9-d2f7d0eb7492",
+   "metadata": {},
+   "source": [
+    "Set parameters the model was trained on. Note that these are fixed and depend on the pre-trained model."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 28,
+   "id": "3037d98c-16fb-4a7f-bf37-7e9991b6603e",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.880376Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.879966Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.883994Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.883336Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.880352Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "vocab         = {i+1:gate for i, gate in enumerate(pipeline.gate_pool)}  # Gateset used during training, used for decoding\n",
+    "num_of_qubits = 3                                                        # Number of qubits\n",
+    "max_gates     = 12                                                       # Maximum number of gates"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9d7cc1c9-7ddd-4464-98b8-8dbcaa02a53e",
+   "metadata": {},
+   "source": [
+    "### Unitary compilation"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b962aea8-9c46-4795-8b74-bca35900f1ed",
+   "metadata": {},
+   "source": [
+    "Let's start by defining the unitary we want to compile. Note that this model has been trained to compile unitaries that arise from circuits composed of the gates contain in `vocab`. While this is a universal gate set (i.e. can perform universal computation), it can only do so with an infinite number of gates. Because the number of gates in the model is restricted to 12, we can only expect the model to generate unitaries under this constraints. We will consider here the compilation of one of such unitary. Nonetheless, stay tuned for bigger and better models!\n",
+    "\n",
+    "We start by defining our unitary as a `numpy.matrix`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
+   "id": "5107c719-4220-4209-a657-4a9c0766b80a",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.884880Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.884694Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.896385Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.895667Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.884863Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "U = np.matrix([[ 0.70710678,  0.        ,  0.        , 0.        ,  0.70710678,  0.        , 0.        ,  0.        ],\n",
+    "               [ 0.        , -0.70710678,  0.        , 0.        ,  0.        , -0.70710678, 0.        ,  0.        ],\n",
+    "               [-0.70710678,  0.        ,  0.        , 0.        ,  0.70710678,  0.        , 0.        ,  0.        ],\n",
+    "               [ 0.        ,  0.70710678,  0.        , 0.        ,  0.        , -0.70710678, 0.        ,  0.        ],\n",
+    "               [ 0.        ,  0.        ,  0.70710678, 0.        ,  0.        ,  0.        , 0.        ,  0.70710678],\n",
+    "               [ 0.        ,  0.        ,  0.        , 0.70710678,  0.        ,  0.        , 0.70710678,  0.        ],\n",
+    "               [ 0.        ,  0.        , -0.70710678, 0.        ,  0.        ,  0.        , 0.        ,  0.70710678],\n",
+    "               [ 0.        ,  0.        ,  0.        ,-0.70710678,  0.        ,  0.        , 0.70710678,  0.        ]], dtype=np.complex128)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "14954138-f16b-48f6-b35d-5b1ac00cff1e",
+   "metadata": {},
+   "source": [
+    "and check that the matrix is indeed unitary, i.e. $U^{\\dagger} U = U U^{\\dagger} = I$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 30,
+   "id": "57164622-8359-4c58-b4d9-1b64ae603b43",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.897692Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.897368Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.904008Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.903243Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.897677Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "assert np.allclose(U.H @ U, np.identity(2**num_of_qubits)) and np.allclose(\n",
+    "    U @ U.H, np.identity(2**num_of_qubits))  #check if unitary"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c0ba07c5-075a-46ca-9a22-cc758ce33cb9",
+   "metadata": {},
+   "source": [
+    "The loaded model was trained on the gate set `['h', 'cx', 'z', 'x', 'ccx', 'swap']`. Specifically, it was trained to generate circuits using any arbitrary subset of this gate set. Therefore, during inference, we can instruct the model to compile the unitary using any of these subsets. However, it is crucial to follow the prompt structure `Compile using [...]`, as the model was trained with this specific format. For example, let's consider a scenario where we compile the unitary without using the `x` gate:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 31,
+   "id": "0f0d3e85-a22e-4a1b-ad17-b02417e56734",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.905214Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.904884Z",
+     "iopub.status.idle": "2024-08-27T18:11:40.912812Z",
+     "shell.execute_reply": "2024-08-27T18:11:40.911995Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.905195Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "# Notice how the x gate missing from the prompt since this is a restriction we set\n",
+    "prompt = \"Compile using: ['h', 'cx', 'z', 'ccx', 'swap']\""
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "cab3a1e8-a404-4ebb-9a58-251d47eebb4a",
+   "metadata": {},
+   "source": [
+    "Now, we call the diffusion model pipeline to generate encoded circuits based on the specified conditions: `prompt` and `U`. One of the key advantages of this method is that, once the model is trained, sampling new circuits is very fast. Therefore, under the same conditions defined above, we will generate 128 circuits and analyze them in the following sections."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 32,
+   "id": "56edb114-3ef7-455b-b4b8-0e262e7b6316",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:40.913747Z",
+     "iopub.status.busy": "2024-08-27T18:11:40.913584Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.824624Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.823799Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:40.913732Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "# Number of circuits to sample from the trained DM.\n",
+    "samples = 128\n",
+    "\n",
+    "# As the neural network works only with real numbers, we first separate\n",
+    "# the two components and create a 2 dimensional tensor for the magnitude\n",
+    "# of each component:\n",
+    "U_r, U_i = torch.Tensor(np.real(U)), torch.Tensor(np.imag(U))\n",
+    "U_tensor = torch.stack([U_r, U_i], dim=0)\n",
+    "\n",
+    "# Now we generate a tensor representation of the desired quantum circuit using the DM based on the prompt and U. This is also known as inference.\n",
+    "out_tensors = infer_comp.generate_comp_tensors(\n",
+    "    pipeline=pipeline,\n",
+    "    prompt=prompt,\n",
+    "    U=U_tensor,\n",
+    "    samples=samples,\n",
+    "    system_size=\n",
+    "    num_of_qubits,  # Max qubit number allowed by the model (this model is only trained with 3 qubits)\n",
+    "    num_of_qubits=num_of_qubits,\n",
+    "    max_gates=max_gates,\n",
+    "    g=10  # classifier-free-guidance (CFG) scale\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "81f09d75-a960-4456-bdb9-57ef7668864e",
+   "metadata": {},
+   "source": [
+    "Below is an example of a generated tensor which represents a quantum circuit: "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 33,
+   "id": "13c1af73-11bc-46ca-99dd-bccea29f95c1",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.825914Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.825524Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.831202Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.830421Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.825898Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],\n",
+       "        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],\n",
+       "        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])"
+      ]
+     },
+     "execution_count": 33,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "out_tensors[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "5605d0a1-626d-4aa5-8721-0416470215dc",
+   "metadata": {},
+   "source": [
+    "### Convert tensors to CUDA-Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b43d006-1e6a-4911-9283-b5a96eb5cf06",
+   "metadata": {},
+   "source": [
+    "Next, we convert the generated tensors into `cudaq.kernels`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 34,
+   "id": "01efc6f7-8f0f-425f-be58-7fcaf880d0fd",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.832305Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.831956Z",
+     "iopub.status.idle": "2024-08-27T18:11:41.840723Z",
+     "shell.execute_reply": "2024-08-27T18:11:41.839940Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.832289Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "cudaq.set_target('qpp-cpu') # Note that cpu is faster for 3 qubit kernels\n",
+    "\n",
+    "# cudaq.set_target('nvidia') # Set to GPU for larger circuits"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 35,
+   "id": "9d5b9ae5-c11e-413b-af00-4412dc86b48d",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:41.841741Z",
+     "iopub.status.busy": "2024-08-27T18:11:41.841583Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.438113Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.437219Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:41.841726Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "1948691023bb4f03b79174564c1b8223",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/128 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The model generated 1 invalid tensors that does not correspond to circuits.\n"
+     ]
+    }
+   ],
+   "source": [
+    "kernel_list   = []\n",
+    "valid_tensors = []\n",
+    "\n",
+    "invalid_tensors = 0\n",
+    "for out_tensors_i in tqdm(out_tensors):\n",
+    "\n",
+    "    # Use a try-except to catch invalid tensors (if any)\n",
+    "    try:    kernel = genqc_to_cudaq(out_tensors_i, vocab)  # Convert out_tensors to CUDA-Q kernels\n",
+    "    except: kernel = None\n",
+    "        \n",
+    "    if kernel:\n",
+    "        kernel_list.append(kernel)\n",
+    "        valid_tensors.append(out_tensors_i)\n",
+    "    else:\n",
+    "        invalid_tensors += 1 \n",
+    "\n",
+    "print(f\"The model generated {invalid_tensors} invalid tensors that does not correspond to circuits.\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0a5823e6-9189-46b7-974d-43a2a0cad531",
+   "metadata": {},
+   "source": [
+    "For example, the following tensor encoding"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 36,
+   "id": "dc7d35c7-a7cb-4663-8220-b1030e534deb",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.439383Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.438787Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.443973Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.443101Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.439367Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "tensor([[ 5,  3,  0,  0, -5,  3,  3,  0, -5,  0,  0,  0],\n",
+       "        [-5,  0,  0,  6,  5,  0,  0,  3,  5,  0,  0,  0],\n",
+       "        [-5,  0,  1,  6, -5,  0,  0,  0, -5,  0,  0,  0]])"
+      ]
+     },
+     "execution_count": 36,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "valid_tensors[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "47116105-b1e1-454e-80fc-6a03061045f5",
+   "metadata": {},
+   "source": [
+    "corresponds to the following `cudaq.kernel`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 37,
+   "id": "4835c288-b018-49d7-b307-3ff05c2c8c56",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.444990Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.444651Z",
+     "iopub.status.idle": "2024-08-27T18:11:43.569067Z",
+     "shell.execute_reply": "2024-08-27T18:11:43.568320Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.444975Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "     ╭───╮╭───╮        ╭───╮╭───╮     \n",
+      "q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──\n",
+      "     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮\n",
+      "q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├\n",
+      "       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯\n",
+      "q2 : ──●──┤ h ├─╳───●──────────────●──\n",
+      "          ╰───╯                       \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Arbitrary input state to the circuit for plotting\n",
+    "\n",
+    "input_state = [0] * (2**num_of_qubits)\n",
+    "\n",
+    "print(cudaq.draw(kernel_list[0], input_state))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "59809685-5d70-4612-8642-c4e924a1ab6c",
+   "metadata": {},
+   "source": [
+    "### Evaluate generated circuits\n",
+    "\n",
+    "As mentioned earlier, one of the key advantages of using diffusion models (DMs) as a unitary compiler is the ability to rapidly sample many circuits. However, as is common in machine learning, the model has a certain accuracy, meaning not all generated circuits are expected to exactly compile the specified unitary. In this section, we will evaluate how many of the generated circuits are indeed correct and then perform post-selection to identify (at least) one circuit that successfully performs the desired unitary operation."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2685d88b-aceb-4a8c-8404-f744196d34c5",
+   "metadata": {},
+   "source": [
+    "### Simulate kernels"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "f5d1e8ca-3abf-47b4-bbca-932bdff86f94",
+   "metadata": {},
+   "source": [
+    "First, we calculate the unitary matrix $U$ implemented by each of the kernels. The elements of this matrix are defined by the transition amplitudes between the basis states, which can be expressed as:\n",
+    "$$\n",
+    "\\begin{equation}\n",
+    "   \\langle i|kernel|j\\rangle = U_{ij},\n",
+    "\\end{equation}\n",
+    "$$\n",
+    "where $|i\\rangle$ and $|j\\rangle$ are computational basis states (typically in the $z$-basis), with $|n\\rangle$ representing the standard basis vector that has a 1 in the $n$-th position and 0 elsewhere."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 38,
+   "id": "11143924-c33f-4fd5-8f04-422eba9ed5a0",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:43.570028Z",
+     "iopub.status.busy": "2024-08-27T18:11:43.569786Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.873950Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.873023Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:43.570011Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "application/vnd.jupyter.widget-view+json": {
+       "model_id": "fdba942957904d7ea41ce9edeb6b9f48",
+       "version_major": 2,
+       "version_minor": 0
+      },
+      "text/plain": [
+       "  0%|          | 0/127 [00:00<?, ?it/s]"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "N = 2**num_of_qubits\n",
+    "\n",
+    "got_unitaries = np.zeros((len(kernel_list), N, N), dtype=np.complex128)\n",
+    "\n",
+    "for i, kernel in tqdm(enumerate(kernel_list), total=got_unitaries.shape[0]):\n",
+    "    for j in range(N):\n",
+    "        basis_state_j = np.zeros((N), dtype=np.complex128)\n",
+    "        basis_state_j[j] = 1\n",
+    "\n",
+    "        got_unitaries[i, :,\n",
+    "                      j] = np.array(cudaq.get_state(kernel, basis_state_j),\n",
+    "                                    copy=False)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "c5eb62ba-40a6-486c-b307-47b11b9b3226",
+   "metadata": {},
+   "source": [
+    "For example, the circuit printed above corresponds to the following unitary:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "4a471612-a3e4-4bea-9f61-dc823283af95",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.875219Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.874792Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.879735Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.878882Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.875200Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "np.set_printoptions(linewidth=1000)\n",
+    "print(np.round(got_unitaries[0], 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "203def54-bb97-4344-8544-6b1374b3f9a3",
+   "metadata": {},
+   "source": [
+    "### Compare unitaries"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e5241775-2692-4b10-b9ef-a75a3ddb0eb8",
+   "metadata": {},
+   "source": [
+    "Now that we have the unitaries for each of the kernels, we compare them to the user provided unitary matrix, `U`. To do so, we compute the infidelity between the exact unitary and the generated ones. The infidelity is a value between 0 and 1, where 0 indicates that the unitaries are identical (up to a global phase)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "bb4915e8-5a92-4038-ab49-fa67a0a5b668",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.880925Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.880574Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.891293Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.890501Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.880909Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "def infidelity(want_unitary, got_unitary):\n",
+    "    return 1 - np.abs(\n",
+    "        np.trace(np.conj(want_unitary).T @ got_unitary) / 2**num_of_qubits)**2\n",
+    "\n",
+    "\n",
+    "infidelities = np.array(\n",
+    "    [infidelity(U, got_unitary) for got_unitary in got_unitaries])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a2ae9d89-3aab-43db-85cb-2aa6fc494d87",
+   "metadata": {},
+   "source": [
+    "Let's now plot an histogram of the infidelities for our generated circuits:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c8313728-3a69-475b-bf3c-f0a8b8e8324a",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.892419Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.892234Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.982604Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.981724Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.892404Z"
+    }
+   },
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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iEgimJgRERERSQQTMyIiIiKJYGJGREREJBFMzIiIiIgkgokZERERkUQwMSMiIiKSCCZmRERERBLBxIyIiIhIIpiYEREREUkEEzMiIiIiiWBiRkRERCQRTMyIiIiIJIKJGREREZFEMDEjIiIikggmZkREREQSwcSMiIiISCKYmBERERFJhCQTs1u3buGjjz5CxYoVYWNjg9dffx1Hjx5VrxdCYMKECXB1dYWNjQ2CgoJw5cqVUoyYiIiIyHCSS8wePXoEPz8/WFpaYvv27Th//jxmz54Ne3t7dZ1Zs2bhhx9+wKJFi3D48GGUL18ewcHBePbsWSlGTkRERGQYi9IO4GUzZ86Eh4cHIiMj1WVVq1ZV/78QAnPnzsXXX3+Nzp07AwCWLVsGZ2dnbNy4ET179izxmImIiIiMQXIjZps3b0ajRo3QrVs3VKpUCW+++SYWL16sXn/jxg0kJSUhKChIXaZUKtG0aVPExcXl22ZGRgZSU1M1FiIiIiKpkVxidv36dSxcuBDVq1fHjh078Pnnn+OLL77A0qVLAQBJSUkAAGdnZ43tnJ2d1eteFhERAaVSqV48PDyK900QERER6UFyiVlOTg4aNGiA6dOn480338TAgQMxYMAALFq0SO82w8LCoFKp1EtiYqIRIyYiIiIyDsklZq6urqhTp45GWe3atZGQkAAAcHFxAQAkJydr1ElOTlave5lcLodCodBYiIiIiKRGcomZn58fLl26pFF2+fJleHp6AvjvQgAXFxfs3r1bvT41NRWHDx+Gr69vicZKREREZEySuypzxIgRaN68OaZPn47u3bvjn3/+wc8//4yff/4ZACCTyTB8+HBMnToV1atXR9WqVTF+/Hi4ubmhS5cupRs8ERERkQEkl5g1btwYGzZsQFhYGCZPnoyqVati7ty5+PDDD9V1Ro0ahSdPnmDgwIFISUmBv78/YmJiYG1tXYqRExERERlGJoQQum505swZHDlyBO+//756vtbTp08RGhqKzZs3w8bGBl999RU+++wzowdsDKmpqVAqlVCpVJxvRvQK8RqzzeA24md0NEIkRETa0yXv0GuO2dSpUzF+/HjY2tqqy8aOHYuffvoJaWlpSExMxODBg7Fr1y59miciIiIySXolZv/88w9atWoFmUwGAMjKykJkZCSaNGmCu3fv4saNG3BycsL3339v1GCJiIiI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P/OUNW3aFACM9rPyiwrru1yv6rEmkgomZkQmxtraGt27d8e9e/cwderUPOvPnDmDX375Bba2tnj33XeNvn97e3vIZDIkJibmWVepUiXY2Njg+PHjSE9PV5c/evQIQ4cONWi/n376KbKystCtWzcIIV6Ziei9e/dGZmYmJkyYoFG+c+fOfJ8U0LdvX9ja2mLcuHE4d+5cnvXp6enqeWi6KqzvXvSqHmsiKeAcMyITNHv2bBw+fBiTJk3C1q1bERAQAGtra1y+fBmbN2+GEAK///57offX0leFChXQuHFjHDhwAL1790b16tVhZmaG3r17w9PTE4MGDcLs2bPxxhtvoFOnTkhNTcX27dvh6emZ793ytfXWW2/B09MTN2/ehIuLCzp16mTEd1V8Ro0ahfXr12Px4sU4d+4cWrZsicTERKxZswYdO3bEtm3bNOo7OTlh5cqV6NatG9544w289dZbqFWrFjIyMhAfH4/9+/ejefPmiImJ0TmWovou16t6rImkgIkZkQmqVKkSjhw5gjlz5mDjxo346aefkJmZCRcXF7z//vv46quv8Oabbxbb/pcvX44RI0Zg69atUKlUEELA398fnp6eiIiIgIODA6KiorBgwQI4OzujV69emDhxIl577TW995mbQEydOhV9+vRRT86XuvLly2P//v0ICwvDhg0bcPz4cdStWxerV6+GSqXKk5gB/10deeLECXzzzTeIjY3Frl27UL58ebi7u6Nv37746KOP9I6nsL7L9aoeayIpkAkhRGkHQURUEt5++21ER0fj8uXLqFatWmmHU6bxWBPph3PMiMgknD9/HtHR0Wjbti0ThWLGY02kP44vE1GZtmLFCly6dAnLli0DAISHh5dyRGUXjzWR4ZiYEVGZ9vPPP+PPP/+Ep6cnlixZgubNm5d2SGUWjzWR4TjHjIiIiEgiOMeMiIiISCKYmBERERFJBBMzIiIiIolgYkZEREQkEUzMiIiIiCSCiRkRERGRRDAxIyIiIpIIJmZEREREEvF/hgK9PnrrOcMAAAAASUVORK5CYII=",
+      "text/plain": [
+       "<Figure size 700x400 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "plt.figure(figsize=(7, 4))\n",
+    "plt.title(\n",
+    "    f\"Distribution of infidelities for {len(got_unitaries)} generated circuits\",\n",
+    "    fontsize=12)\n",
+    "plt.ylabel(\"Number of circuits\", fontsize=14)\n",
+    "plt.xlabel(\"Unitary infidelity\", fontsize=14)\n",
+    "plt.hist(infidelities, bins=30)\n",
+    "plt.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f1912f6c-e685-4994-bf3a-fe9530dbd513",
+   "metadata": {},
+   "source": [
+    "As we can see, the model generated almost 30 circuits that compile the unitary with an infidelity close or equal to zero! The kernel with the lowest infidelity is:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "656baf92-5a1e-4227-ac1f-67b5f9394310",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.983493Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.983309Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.988444Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.987556Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.983478Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The best kernel has an infidelity of 3.4e-09,\n",
+      "     ╭───╮╭───╮        ╭───╮╭───╮     \n",
+      "q0 : ┤ x ├┤ z ├─────●──┤ z ├┤ z ├──●──\n",
+      "     ╰─┬─╯╰───╯   ╭─┴─╮├───┤╰───╯╭─┴─╮\n",
+      "q1 : ──●────────╳─┤ x ├┤ z ├─────┤ x ├\n",
+      "       │  ╭───╮ │ ╰─┬─╯╰───╯     ╰─┬─╯\n",
+      "q2 : ──●──┤ h ├─╳───●──────────────●──\n",
+      "          ╰───╯                       \n",
+      "\n",
+      "with the unitary:\n",
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "min_index = np.argmin(infidelities)\n",
+    "\n",
+    "print(f\"The best kernel has an infidelity of {infidelities[min_index]:0.2},\")\n",
+    "\n",
+    "input_state = [0] * (2**num_of_qubits)\n",
+    "input_state[0] = 1\n",
+    "print(cudaq.draw(kernel_list[min_index], input_state))\n",
+    "\n",
+    "print(f\"with the unitary:\")\n",
+    "print(np.round(got_unitaries[min_index], 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e724b39-cc63-40c8-8ad0-9d90d94e23bd",
+   "metadata": {},
+   "source": [
+    "which, as we can see, exactly compiled our wanted unitary:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "46d190d6-7bed-4490-a343-bf856190a101",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.989293Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.989114Z",
+     "iopub.status.idle": "2024-08-27T18:11:55.996387Z",
+     "shell.execute_reply": "2024-08-27T18:11:55.995546Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.989278Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[[ 0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [-0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]\n",
+      " [ 0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.    +0.j  0.7071+0.j]\n",
+      " [ 0.    +0.j  0.    +0.j  0.    +0.j -0.7071+0.j  0.    +0.j  0.    +0.j  0.7071+0.j  0.    +0.j]]\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(np.round(U, 4))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f8bf2fe6-07ca-4bfa-a46b-96a91daeb185",
+   "metadata": {},
+   "source": [
+    "### Choosing the circuit you need"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "983dc8c1-f3ae-4d06-ad7a-e57addfc6e74",
+   "metadata": {},
+   "source": [
+    "As we have seen above, we now have almost 30 kernels that compile the desired unitary! This is particularly valuable when dealing with hardware constraints, where, for instance, we might want to avoid using certain qubits or specific gates. One practical example is finding the circuit with the fewest Toffoli gates (also known as `ccx`). In our `vocab` definition above, we identified that `ccx` corresponds to the label 5 in our tokenized tensors. Let's use this information to search for the circuit that minimizes the number of `ccx` gates:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "acb0f4d8-2e8a-4b32-9e37-006571ca2aa5",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:55.997443Z",
+     "iopub.status.busy": "2024-08-27T18:11:55.997033Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.005395Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.004630Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:55.997427Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "The model generated 17 distinct correct circuits.\n",
+      "These circuits have this number of ccx gates: tensor([1, 3, 3, 3, 3, 3, 3, 1, 1, 3, 3, 3, 1, 1, 1, 1, 1])\n"
+     ]
+    }
+   ],
+   "source": [
+    "# First, we remove possible duplicates and only pick distinct circuits\n",
+    "_, idx_unique       = np.unique(np.array(valid_tensors), axis=0, return_index=True)\n",
+    "unique_tensors      = torch.stack(valid_tensors)[idx_unique]\n",
+    "unique_infidelities = infidelities[idx_unique]\n",
+    "unique_kernels      = [kernel_list[idx] for idx in idx_unique]\n",
+    "\n",
+    "# Then, find the correct circuits\n",
+    "idx_correct     = torch.argwhere(torch.tensor(unique_infidelities) < 0.01).flatten()\n",
+    "correct_tensors = unique_tensors[idx_correct]\n",
+    "print(f\"The model generated {correct_tensors.shape[0]} distinct correct circuits.\")\n",
+    "\n",
+    "# Now let's flatten the last two dimensions (related to the actual circuit) and find out how many 5's (i.e. ccx) gates each circuit has:\n",
+    "num_ccx = (correct_tensors.flatten(1,2) == 5).sum(1)\n",
+    "print(\"These circuits have this number of ccx gates:\", num_ccx)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7625aac1-78d8-4ce3-9765-88ae48c92dd3",
+   "metadata": {},
+   "source": [
+    "As we can see, it appears that the diffusion model (DM) requires at least one Toffoli gate to compile the unitary. We can now print a few of these circuits to select the one that best suits our needs, or to study whether there are any interesting patterns the model employs for this specific unitary."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "535501a6-cafb-48e6-b53c-636d7ac5a815",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:56.006584Z",
+     "iopub.status.busy": "2024-08-27T18:11:56.006136Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.013882Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.013117Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:56.006569Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "        ╭───╮╭───╮               \n",
+      "q0 : ───┤ x ├┤ z ├───────●───────\n",
+      "        ╰─┬─╯├───┤╭───╮  │       \n",
+      "q1 : ─╳───●──┤ h ├┤ z ├──┼───────\n",
+      "      │   │  ├───┤╰───╯╭─┴─╮╭───╮\n",
+      "q2 : ─╳───●──┤ h ├─────┤ x ├┤ h ├\n",
+      "             ╰───╯     ╰───╯╰───╯\n",
+      "\n",
+      "     ╭───╮╭───╮             \n",
+      "q0 : ┤ x ├┤ z ├──●──────────\n",
+      "     ╰─┬─╯├───┤╭─┴─╮        \n",
+      "q1 : ──●──┤ h ├┤ x ├─╳──────\n",
+      "       │  ├───┤├───┤ │ ╭───╮\n",
+      "q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├\n",
+      "          ╰───╯╰───╯   ╰───╯\n",
+      "\n",
+      "     ╭───╮╭───╮             \n",
+      "q0 : ┤ x ├┤ z ├──●──────────\n",
+      "     ╰─┬─╯├───┤╭─┴─╮        \n",
+      "q1 : ──●──┤ h ├┤ x ├─╳──────\n",
+      "       │  ├───┤├───┤ │ ╭───╮\n",
+      "q2 : ──●──┤ h ├┤ z ├─╳─┤ h ├\n",
+      "          ╰───╯╰───╯   ╰───╯\n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "# Get the correct kernels\n",
+    "correct_kernels = [unique_kernels[idx] for idx in idx_correct]\n",
+    "\n",
+    "# Get the ones with only one ccx\n",
+    "correct_kernels_ccx1 = [\n",
+    "    correct_kernels[idx] for idx in torch.argwhere(num_ccx == 1).flatten()\n",
+    "]\n",
+    "\n",
+    "# Draw a few of this circuits\n",
+    "for kernel in correct_kernels_ccx1[:3]:\n",
+    "    print(cudaq.draw(kernel, input_state))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "dd32819f-8bb6-4af8-bf69-84b600ba7ad5",
+   "metadata": {
+    "execution": {
+     "iopub.execute_input": "2024-08-27T18:11:56.020863Z",
+     "iopub.status.busy": "2024-08-27T18:11:56.020639Z",
+     "iopub.status.idle": "2024-08-27T18:11:56.027045Z",
+     "shell.execute_reply": "2024-08-27T18:11:56.026361Z",
+     "shell.execute_reply.started": "2024-08-27T18:11:56.020849Z"
+    }
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "CUDA-Q Version latest (https://github.com/NVIDIA/cuda-quantum a1ee37087fbd5c14a31d5de3441f92432d0dca68)\n",
+      "genQC Version 0.1.0\n"
+     ]
+    }
+   ],
+   "source": [
+    "print(cudaq.__version__)\n",
+    "print(\"genQC Version\", genQC.__version__)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "widgets": {
+   "application/vnd.jupyter.widget-state+json": {
+    "state": {},
+    "version_major": 2,
+    "version_minor": 0
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/visualization.ipynb b/pr-2241/sphinx/examples/python/tutorials/visualization.ipynb
new file mode 100644
index 0000000000..518595b0c1
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/visualization.ipynb
@@ -0,0 +1,301 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Visualization\n",
+    "\n",
+    "## Qubit Visualization\n",
+    "\n",
+    "What are the possible states a qubit can be in and how can we build up a visual cue to help us make sense of quantum states and their evolution?\n",
+    "\n",
+    "We know our qubit can have two distinct states: $\\ket{0}$ and $\\ket{1}$. If these were the only two states, we could represent them as two vectors on a one-dimensional line (i.e., the z-axis in the image below). We also know that qubits can be in an equal superposition of states: $\\ket{+}$ and $\\ket{-}$. In order to capture all of the states in equal superposition, we will need a 2D plane (i.e., the $xy$-plane in the image below). If you dive deeper you will learn about the existence of other states that will call for a 3D extension. \n",
+    "\n",
+    "In general, a quantum state can be written in the form $\\ket{\\psi} = \\cos(\\frac{\\theta}{2})\\ket{0}+e^{i\\varphi}\\sin(\\frac{\\theta}{2})\\ket{1}$ where $\\theta$ is a real number between $0$ and $\\pi$ and $\\varphi$ is a real value between $0$ and $2\\pi$.  For example, the minus state, $\\ket{-} = \\frac{1}{\\sqrt{2}}\\ket{0}- \\frac{1}{\\sqrt{2}}\\ket{1}$, can be rewritten as\n",
+    "$$\\ket{-}  = \\cos(\\frac{\\theta}{2})\\ket{0}+e^{i\\varphi}\\sin(\\frac{\\theta}{2})\\ket{1}\\text{ with }\\theta = \\frac{\\pi}{2}\\text{ and }\\varphi = \\pi.$$ \n",
+    "This can be visualized in the image below as a unit vector pointing in the direction of the negative $x$-axis.\n",
+    "\n",
+    "Using spherical coordinates, it is possible to depict all the possible states of a single qubit on a sphere. This is called a Bloch sphere. \n",
+    "\n",
+    "<img src=\"images/Bloch_sphere.png\" alt=\"Bloch Sphere\" width=\"300\" height=\"300\">\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Let us try to showcase the functionality to render such a 3D representation with CUDA-Q. \n",
+    "First, let us define a single-qubit kernel that returns a different state each time. This kernel uses random rotations.\n",
+    "\n",
+    "Note: CUDA-Q uses the [QuTiP](https://qutip.org) library to render Bloch spheres. The following code will throw an error if QuTiP is not installed. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "scrolled": true
+   },
+   "outputs": [],
+   "source": [
+    "# install `qutip` in the current Python kernel. Skip this if `qutip` is already installed.\n",
+    "# `matplotlib` is required for all visualization tasks.\n",
+    "# Make sure to restart your kernel if you execute this!\n",
+    "# In a Jupyter notebook, go to the menu bar > Kernel > Restart Kernel.\n",
+    "# In VSCode, click on the Restart button in the Jupyter toolbar.\n",
+    "\n",
+    "# The '\\' before the '>' operator is so that the shell does not misunderstand\n",
+    "# the '>' qualifier for the bash pipe operation.\n",
+    "\n",
+    "import sys\n",
+    "\n",
+    "try:\n",
+    "    import matplotlib.pyplot as plt\n",
+    "    import qutip\n",
+    "\n",
+    "except ImportError:\n",
+    "    print(\"Tools not found, installing. Please restart your kernel after this is done.\")\n",
+    "    !{sys.executable} -m pip install qutip\\>=5 matplotlib\\>=3.5\n",
+    "    print(\"\\nNew libraries have been installed. Please restart your kernel!\")\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import numpy as np\n",
+    "\n",
+    "## Retry the subsequent cells by setting the target to density matrix simulator.\n",
+    "# cudaq.set_target(\"density-matrix-cpu\")\n",
+    "\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(angles: np.ndarray):\n",
+    "    qubit = cudaq.qubit()\n",
+    "    rz(angles[0], qubit)\n",
+    "    rx(angles[1], qubit)\n",
+    "    rz(angles[2], qubit)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Next, we instantiate a random number generator, so we can get random outputs. We then create 4 random single-qubit states by using `cudaq.add_to_bloch_sphere()` on the output state obtained from the random kernel."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "rng = np.random.default_rng(seed=11)\n",
+    "blochSphereList = []\n",
+    "for _ in range(4):\n",
+    "    angleList = rng.random(3) * 2 * np.pi\n",
+    "    sph = cudaq.add_to_bloch_sphere(cudaq.get_state(kernel, angleList))\n",
+    "    blochSphereList.append(sph)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can display the spheres with `cudaq.show()`. Show the first sphere:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[0])"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can also show multiple Bloch spheres side by side - simply set the `nrows` and `ncols` in the call to `cudaq.show()` accordingly. Make sure to have more spaces than spheres in your list, else it will throw an error! Let us show two spheres in a row:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[:2], nrows=1, ncols=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can show them in a column too, if we want! Simply set the `nrows = 2` and `ncols = 1`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[:2], nrows=2, ncols=1)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Can we show the entire list of 4 Bloch spheres we created? Absolutely!"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cudaq.show(blochSphereList[:], nrows=2, ncols=2)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "What if we had to add multiple vectors to a single Bloch sphere? CUDA-Q uses the [QuTiP](https://www.qutip.org) toolbox to construct Bloch spheres. We can then add multiple states to the same Bloch sphere by passing the sphere object as an argument to `cudaq.add_to_bloch_sphere()`."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import qutip\n",
+    "\n",
+    "rng = np.random.default_rng(seed=47)\n",
+    "blochSphere = qutip.Bloch()\n",
+    "for _ in range(10):\n",
+    "    angleList = rng.random(3) * 2 * np.pi\n",
+    "    sph = cudaq.add_to_bloch_sphere(cudaq.get_state(kernel, angleList), blochSphere)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "This created a single Bloch sphere with 10 random vectors. Let us see how it looks."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "blochSphere.show()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Unfortunately, there is no such handy visualization for multi-qubit states. In particular, a multi-qubit state cannot be visualized as multiple Bloch spheres due to the nature of entanglement that makes quantum computing so powerful. "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Kernel Visualization\n",
+    "\n",
+    "A CUDA-Q kernel can be visualized using the `cudaq.draw` API which returns a string representing the drawing of the execution path, in the specified format. ASCII (default) and LaTeX formats are supported."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel_to_draw():\n",
+    "    q = cudaq.qvector(4)\n",
+    "    h(q)\n",
+    "    x.ctrl(q[0], q[1])\n",
+    "    y.ctrl([q[0], q[1]], q[2])\n",
+    "    z(q[2])\n",
+    "    \n",
+    "    swap(q[0], q[1])\n",
+    "    swap(q[0], q[3])\n",
+    "    swap(q[1], q[2])\n",
+    "\n",
+    "    r1(3.14159, q[0])\n",
+    "    tdg(q[1])\n",
+    "    s(q[2])"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(cudaq.draw(kernel_to_draw))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(cudaq.draw('latex', kernel_to_draw))"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Copy this output string into any LaTeX editor and export it to PDF.\n",
+    "\n",
+    "<img src=\"images/circuit_pdf.png\" alt=\"Circuit in PDF format\" width=\"500\" height=\"250\">"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/vqe.ipynb b/pr-2241/sphinx/examples/python/tutorials/vqe.ipynb
new file mode 100644
index 0000000000..f6c8592354
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/vqe.ipynb
@@ -0,0 +1,229 @@
+{
+ "cells": [
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Variational Quantum Eigensolver"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "A common application of the Variational Quantum Eigensolver (VQE) algorithm is to compute the ground state energy of a molecular system. The code below demonstrates how to perform classical preprocessing for a $H_2$ molecule (i.e. obtain the integrals from a Hartree-Fock computation to build the molecular Hamiltonian), prepare the initial Hartree-Fock state on the quantum register, add the parameterized UCCSD ansatz to the kernel, and select the COBYLA optimizer.  We are then ready to call `cudaq:vqe` to estimate the minimum energy of the system."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install openfermionpyscf==0.5 matplotlib==3.8.4 scipy==1.13.0"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "from scipy.optimize import minimize\n",
+    "import numpy as np\n",
+    "\n",
+    "# Single precision\n",
+    "cudaq.set_target(\"nvidia\")\n",
+    "# Double precision\n",
+    "#cudaq.set_target(\"nvidia-fp64\")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "The problem of interest here is a chain of hydrogen atoms seperated along the z-axis at a fixed interval called the bond distance. \n",
+    "\n",
+    "The interatomic electrostatic forces due to the electrons and protons and the shielding by the neutrons creates a chemical system whose energy can be minimised to find a stable configuration. \n",
+    "\n",
+    "Let us first begin by defining the molecule and other metadata about the problem.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Number of hydrogen atoms.\n",
+    "hydrogen_count = 2\n",
+    "\n",
+    "# Distance between the atoms in Angstroms.\n",
+    "bond_distance = 0.7474\n",
+    "\n",
+    "# Define a linear chain of Hydrogen atoms\n",
+    "geometry = [('H', (0, 0, i * bond_distance)) for i in range(hydrogen_count)]\n",
+    "\n",
+    "hamiltonian, data = cudaq.chemistry.create_molecular_hamiltonian(\n",
+    "    geometry, 'sto-3g', 1, 0)\n",
+    "\n",
+    "electron_count = data.n_electrons\n",
+    "qubit_count = 2 * data.n_orbitals"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We now generate a Unitary Coupled-Cluster Singles and Doubles (UCCSD) ansatz from the template provided by CUDA-Q.  "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "@cudaq.kernel\n",
+    "def kernel(thetas: list[float]):\n",
+    "\n",
+    "    qubits = cudaq.qvector(qubit_count)\n",
+    "\n",
+    "    for i in range(electron_count):\n",
+    "        x(qubits[i])\n",
+    "\n",
+    "    cudaq.kernels.uccsd(qubits, thetas, electron_count, qubit_count)\n",
+    "\n",
+    "\n",
+    "parameter_count = cudaq.kernels.uccsd_num_parameters(electron_count,\n",
+    "                                                     qubit_count)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Using CUDA-Q Optimizers\n",
+    "\n",
+    "We use the builtin optimizers within CUDA-Q for the minimization procedure."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "-1.1371744305855906\n"
+     ]
+    }
+   ],
+   "source": [
+    "optimizer = cudaq.optimizers.COBYLA()\n",
+    "\n",
+    "energy, parameters = cudaq.vqe(kernel,\n",
+    "                               hamiltonian,\n",
+    "                               optimizer,\n",
+    "                               parameter_count=parameter_count)\n",
+    "\n",
+    "print(energy)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Integration with Third-Party Optimizers\n",
+    "\n",
+    "We can also integrate popular libraries like scipy with CUDA-Q. "
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "image/png": "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O3lU7fjPTpdLUtMoU9PflxMGmJqNsJhqPkrj/nvY7PeTL3ALoxdtDaKYp/xw6ijPiXWceHzjpB9OPM7J39vSdzb+3kZxp9Ta8Y1Ns2sjTh0VZOEcdoIQAHiJYRganhjpM7cSAfAcIQAAEMAIQgAAIGARhAAAQMAiCAEAgIBFEAIAAAGLIAQAAAIWQQgAAAQsghAAAAhYBCEAABCwCEIAACBgEYQAAEDAIggBAICARRACAAABiyAEAAAClt3qAvo60zQlSWVlZRZXAgAAOsr957b7z/HWEITaUV5eLklKTU21uBIAANBZ5eXlio6ObvVzw2wvKgU4l8ul/Px8RUZGyjAMr31vWVmZUlNTtX//fkVFRXnte/sSfz9Hfz8/yf/PkfPzff5+jpxf15mmqfLycqWkpMhma70TiBGhdthsNg0aNKjHvj8qKsov/+E+kb+fo7+fn+T/58j5+T5/P0fOr2vaGglyo1kaAAAELIIQAAAIWAQhizgcDj300ENyOBxWl9Jj/P0c/f38JP8/R87P9/n7OXJ+PY9maQAAELAYEQIAAAGLIAQAAAIWQQgAAAQsghAAAAhYBCGLPP3000pPT1doaKiysrK0du1aq0vyit/97ncyDKPZa+TIkVaX1S2ff/65LrnkEqWkpMgwDL377rvNPjdNUw8++KCSk5MVFhamGTNmaPv27dYU2wXtnd+8efNOuaYzZ860ptguWLhwoSZNmqTIyEglJCTo8ssvV15eXrNtampqdNttt2nAgAHq16+fZs+ercLCQosq7ryOnON55513ynW85ZZbLKq4c5555hmNHTvW89C9KVOm6KOPPvJ87uvXr73z8+Vr15KHH35YhmHozjvv9Lxn5TUkCFngH//4h371q1/poYce0tdff61x48bpoosuUlFRkdWlecVpp52mQ4cOeV5ffvml1SV1S2VlpcaNG6enn366xc8feeQRPfXUU3r22We1Zs0aRURE6KKLLlJNTU0vV9o17Z2fJM2cObPZNX3jjTd6scLuWbFihW677TatXr1aS5cuVX19vS688EJVVlZ6trnrrrv0wQcf6K233tKKFSuUn5+vK664wsKqO6cj5yhJN954Y7Pr+Mgjj1hUcecMGjRIDz/8sDZs2KD169fr/PPP12WXXabvvvtOku9fv/bOT/Lda3eydevW6bnnntPYsWObvW/pNTTR6yZPnmzedtttnt8bGhrMlJQUc+HChRZW5R0PPfSQOW7cOKvL6DGSzMWLF3t+d7lcZlJSkvk///M/nvdKSkpMh8NhvvHGGxZU2D0nn59pmubcuXPNyy67zJJ6ekJRUZEpyVyxYoVpmo3XKzg42Hzrrbc822zdutWUZK5atcqqMrvl5HM0TdM899xzzTvuuMO6orysf//+5gsvvOCX1880j5+fafrPtSsvLzczMzPNpUuXNjsnq68hI0K9rK6uThs2bNCMGTM879lsNs2YMUOrVq2ysDLv2b59u1JSUpSRkaGcnBzt27fP6pJ6zO7du1VQUNDsekZHRysrK8tvrqckLV++XAkJCRoxYoRuvfVWHT161OqSuqy0tFSSFBsbK0nasGGD6uvrm13DkSNHKi0tzWev4cnn6Pbaa68pLi5Op59+uu69915VVVVZUV63NDQ0aNGiRaqsrNSUKVP87vqdfH5u/nDtbrvtNv3whz9sdq0k6/8dZNHVXnbkyBE1NDQoMTGx2fuJiYnKzc21qCrvycrK0ssvv6wRI0bo0KFD+v3vf6/p06fr22+/VWRkpNXleV1BQYEktXg93Z/5upkzZ+qKK67QkCFDtHPnTv32t7/VrFmztGrVKgUFBVldXqe4XC7deeedOvvss3X66adLaryGISEhiomJabatr17Dls5Rkq6++moNHjxYKSkp2rx5s/7jP/5DeXl5eueddyystuO2bNmiKVOmqKamRv369dPixYs1evRobdq0yS+uX2vnJ/n+tZOkRYsW6euvv9a6detO+czqfwcJQvCqWbNmeX4eO3assrKyNHjwYL355pu64YYbLKwMXTVnzhzPz2PGjNHYsWM1dOhQLV++XNnZ2RZW1nm33Xabvv32W5/vW2tLa+d40003eX4eM2aMkpOTlZ2drZ07d2ro0KG9XWanjRgxQps2bVJpaanefvttzZ07VytWrLC6LK9p7fxGjx7t89du//79uuOOO7R06VKFhoZaXc4puDXWy+Li4hQUFHRKN3xhYaGSkpIsqqrnxMTEaPjw4dqxY4fVpfQI9zULlOspSRkZGYqLi/O5azp//nx9+OGH+uyzzzRo0CDP+0lJSaqrq1NJSUmz7X3xGrZ2ji3JysqSJJ+5jiEhIRo2bJgmTJighQsXaty4cfrTn/7kN9evtfNria9duw0bNqioqEjjx4+X3W6X3W7XihUr9NRTT8lutysxMdHSa0gQ6mUhISGaMGGCli1b5nnP5XJp2bJlze4H+4uKigrt3LlTycnJVpfSI4YMGaKkpKRm17OsrExr1qzxy+spSQcOHNDRo0d95pqapqn58+dr8eLF+vTTTzVkyJBmn0+YMEHBwcHNrmFeXp727dvnM9ewvXNsyaZNmyTJZ67jyVwul2pra/3i+rXEfX4t8bVrl52drS1btmjTpk2e18SJE5WTk+P52dJr2OPt2DjFokWLTIfDYb788svm999/b950001mTEyMWVBQYHVp3Xb33Xeby5cvN3fv3m2uXLnSnDFjhhkXF2cWFRVZXVqXlZeXmxs3bjQ3btxoSjIff/xxc+PGjebevXtN0zTNhx9+2IyJiTHfe+89c/PmzeZll11mDhkyxKyurra48o5p6/zKy8vNX//61+aqVavM3bt3m5988ok5fvx4MzMz06ypqbG69A659dZbzejoaHP58uXmoUOHPK+qqirPNrfccouZlpZmfvrpp+b69evNKVOmmFOmTLGw6s5p7xx37Nhh/uEPfzDXr19v7t6923zvvffMjIwM85xzzrG48o5ZsGCBuWLFCnP37t3m5s2bzQULFpiGYZj//ve/TdP0/evX1vn5+rVrzckz4ay8hgQhi/z5z38209LSzJCQEHPy5Mnm6tWrrS7JK6666iozOTnZDAkJMQcOHGheddVV5o4dO6wuq1s+++wzU9Ipr7lz55qm2TiF/oEHHjATExNNh8NhZmdnm3l5edYW3QltnV9VVZV54YUXmvHx8WZwcLA5ePBg88Ybb/Sp0N7SuUkyX3rpJc821dXV5i9+8Quzf//+Znh4uPnjH//YPHTokHVFd1J757hv3z7znHPOMWNjY02Hw2EOGzbMvOeee8zS0lJrC++g66+/3hw8eLAZEhJixsfHm9nZ2Z4QZJq+f/3aOj9fv3atOTkIWXkNDdM0zZ4fdwIAAOh76BECAAABiyAEAAACFkEIAAAELIIQAAAIWAQhAAAQsAhCAAAgYBGEAABAwCIIAUA7DMPQu+++a3UZAHoAQQhAnzZv3jwZhnHKa+bMmVaXBsAP2K0uAADaM3PmTL300kvN3nM4HBZVA8CfMCIEoM9zOBxKSkpq9urfv7+kxttWzzzzjGbNmqWwsDBlZGTo7bffbrb/li1bdP755yssLEwDBgzQTTfdpIqKimbbvPjiizrttNPkcDiUnJys+fPnN/v8yJEj+vGPf6zw8HBlZmbq/fff93x27Ngx5eTkKD4+XmFhYcrMzDwluAHomwhCAHzeAw88oNmzZ+ubb75RTk6O5syZo61bt0qSKisrddFFF6l///5at26d3nrrLX3yySfNgs4zzzyj2267TTfddJO2bNmi999/X8OGDWt2jN///ve68sortXnzZl188cXKyclRcXGx5/jff/+9PvroI23dulXPPPOM4uLieu9vAICu65WlXQGgi+bOnWsGBQWZERERzV5//OMfTdNsXHn9lltuabZPVlaWeeutt5qmaZrPP/+82b9/f7OiosLz+f/93/+ZNpvNLCgoME3TNFNSUsz77ruv1Rokmffff7/n94qKClOS+dFHH5mmaZqXXHKJed1113nnhAH0KnqEAPR5P/jBD/TMM880ey82Ntbz85QpU5p9NmXKFG3atEmStHXrVo0bN04RERGez88++2y5XC7l5eXJMAzl5+crOzu7zRrGjh3r+TkiIkJRUVEqKiqSJN16662aPXu2vv76a1144YW6/PLLNXXq1C6dK4DeRRAC0OdFRESccqvKW8LCwjq0XXBwcLPfDcOQy+WSJM2aNUt79+7Vv/71Ly1dulTZ2dm67bbb9Oijj3q9XgDeRY8QAJ+3evXqU34fNWqUJGnUqFH65ptvVFlZ6fl85cqVstlsGjFihCIjI5Wenq5ly5Z1q4b4+HjNnTtXf//73/Xkk0/q+eef79b3AegdjAgB6PNqa2tVUFDQ7D273e5pSH7rrbc0ceJETZs2Ta+99prWrl2rv/71r5KknJwcPfTQQ5o7d65+97vf6fDhw/rlL3+pn/3sZ0pMTJQk/e53v9Mtt9yihIQEzZo1S+Xl5Vq5cqV++ctfdqi+Bx98UBMmTNBpp52m2tpaffjhh54gBqBvIwgB6POWLFmi5OTkZu+NGDFCubm5khpndC1atEi/+MUvlJycrDfeeEOjR4+WJIWHh+vjjz/WHXfcoUmTJik8PFyzZ8/W448/7vmuuXPnqqamRk888YR+/etfKy4uTj/5yU86XF9ISIjuvfde7dmzR2FhYZo+fboWLVrkhTMH0NMM0zRNq4sAgK4yDEOLFy/W5ZdfbnUpAHwQPUIAACBgEYQAAEDAokcIgE/j7j6A7mBECAAABCyCEAAACFgEIQAAELAIQgAAIGARhAAAQMAiCAEAgIBFEAIAAAGLIAQAAAIWQQgAAASs/x+qP0B/2ARgBgAAAABJRU5ErkJggg==",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "# Define a function to minimize\n",
+    "def cost(theta):\n",
+    "\n",
+    "    exp_val = cudaq.observe(kernel, hamiltonian, theta).expectation()\n",
+    "\n",
+    "    return exp_val\n",
+    "\n",
+    "\n",
+    "exp_vals = []\n",
+    "\n",
+    "\n",
+    "def callback(xk):\n",
+    "    exp_vals.append(cost(xk))\n",
+    "\n",
+    "\n",
+    "# Initial variational parameters.\n",
+    "np.random.seed(42)\n",
+    "x0 = np.random.normal(0, np.pi, parameter_count)\n",
+    "\n",
+    "# Use the scipy optimizer to minimize the function of interest\n",
+    "result = minimize(cost,\n",
+    "                  x0,\n",
+    "                  method='COBYLA',\n",
+    "                  callback=callback,\n",
+    "                  options={'maxiter': 40})\n",
+    "\n",
+    "plt.plot(exp_vals)\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Energy')\n",
+    "plt.title('VQE')\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  },
+  "orig_nbformat": 4,
+  "vscode": {
+   "interpreter": {
+    "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+   }
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/examples/python/tutorials/vqe_water_active_space.ipynb b/pr-2241/sphinx/examples/python/tutorials/vqe_water_active_space.ipynb
new file mode 100644
index 0000000000..7b5d0306ee
--- /dev/null
+++ b/pr-2241/sphinx/examples/python/tutorials/vqe_water_active_space.ipynb
@@ -0,0 +1,235 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Water Molecule with Active Space (CPU vs. GPU)\n",
+    "\n",
+    "#### A- Classical simulation as a reference: CCSD"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Install the relevant packages.\n",
+    "!pip install pyscf==2.6.2\n",
+    "!pip install openfermionpyscf==0.5\n",
+    "!pip install matplotlib==3.8.4\n",
+    "!pip install openfermion==1.6.1"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 2,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "converged SCF energy = -75.9839755372789\n",
+      "Total number of electrons =  10\n",
+      "Total number of orbitals =  13\n",
+      "ncore occupied orbitals =  3\n",
+      "E(CCSD) = -75.98508980454675  E_corr = -0.001114267267875617\n",
+      "Total CCSD energy for active space Hamiltonian =  -75.98508980454675 \n",
+      "\n"
+     ]
+    }
+   ],
+   "source": [
+    "from pyscf import gto, scf, mcscf, cc\n",
+    "\n",
+    "geometry ='O 0.1173 0.0 0.0; H -0.4691 0.7570 0.0; H -0.4691 -0.7570 0.0'\n",
+    "mol=gto.M(\n",
+    "    atom = geometry,\n",
+    "    spin = 0,\n",
+    "    charge = 0,\n",
+    "    basis = '631g',\n",
+    ")\n",
+    "\n",
+    "myhf = scf.RHF(mol)\n",
+    "myhf.max_cycle=100\n",
+    "myhf.kernel()\n",
+    "nelec = mol.nelectron\n",
+    "print('Total number of electrons = ', nelec)\n",
+    "norb = myhf.mo_coeff.shape[1]\n",
+    "print('Total number of orbitals = ', norb)\n",
+    "\n",
+    "norb_cas, nele_cas = (4,4)\n",
+    "mycasci = mcscf.CASCI(myhf, norb_cas, nele_cas)\n",
+    "print('ncore occupied orbitals = ', mycasci.ncore)\n",
+    "\n",
+    "frozen = []\n",
+    "frozen += [y for y in range(0,mycasci.ncore)]\n",
+    "frozen += [y for y in range(mycasci.ncore+norb_cas, len(mycasci.mo_coeff))]\n",
+    "mycc = cc.CCSD(myhf,frozen=frozen).run()\n",
+    "print('Total CCSD energy for active space Hamiltonian = ', mycc.e_tot, '\\n')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "#### B- VQE-UCCSD:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[\u001b[38;2;255;000;000mwarning\u001b[0m] Target \u001b[38;2;000;000;255mnvidia-fp64\u001b[0m: \u001b[38;2;000;000;255mThis target is deprecating. Please use the 'nvidia' target with option 'fp64'.\u001b[0m\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "/tmp/ipykernel_23147/4290935201.py:35: ComplexWarning: Casting complex values to real discards the imaginary part\n",
+      "  spin_ham = cudaq.SpinOperator(qubit_hamiltonian)\n"
+     ]
+    },
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "UCCSD-VQE energy =   -75.98415928173183\n",
+      "Pyscf-CCSD energy =  -75.98508980454675\n",
+      "Total number of qubits =  8\n",
+      "Total number of parameters =  26\n",
+      "Total number of terms in the spin hamiltonian =  105\n",
+      "Total elapsed time (s) =  28.929891359000067\n"
+     ]
+    },
+    {
+     "data": {
+      "image/png": "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",
+      "text/plain": [
+       "<Figure size 640x480 with 1 Axes>"
+      ]
+     },
+     "metadata": {},
+     "output_type": "display_data"
+    }
+   ],
+   "source": [
+    "import openfermion\n",
+    "import openfermionpyscf\n",
+    "from openfermion.transforms import jordan_wigner, get_fermion_operator\n",
+    "\n",
+    "import timeit\n",
+    "\n",
+    "\n",
+    "import cudaq\n",
+    "import matplotlib.pyplot as plt\n",
+    "from scipy.optimize import minimize\n",
+    "import numpy as np\n",
+    "\n",
+    "# GPU\n",
+    "cudaq.set_target(\"nvidia-fp64\")\n",
+    "# CPU\n",
+    "#cudaq.set_target(\"qpp-cpu\")\n",
+    "\n",
+    "# 1- Classical pre-processing:\n",
+    "\n",
+    "geometry = [('O', (0.1173,0.0,0.0)), ('H', (-0.4691,0.7570,0.0)), ('H', (-0.4691,-0.7570,0.0))]\n",
+    "basis = '631g'\n",
+    "multiplicity = 1\n",
+    "charge = 0\n",
+    "ncore = 3\n",
+    "norb_cas, nele_cas = (4,4)\n",
+    "\n",
+    "molecule = openfermionpyscf.run_pyscf(openfermion.MolecularData(geometry, basis, multiplicity,charge))\n",
+    "\n",
+    "molecular_hamiltonian = molecule.get_molecular_hamiltonian(\n",
+    "        occupied_indices=range(ncore), active_indices=range(ncore, ncore + norb_cas))\n",
+    "\n",
+    "fermion_hamiltonian = get_fermion_operator(molecular_hamiltonian)\n",
+    "qubit_hamiltonian = jordan_wigner(fermion_hamiltonian)\n",
+    "\n",
+    "spin_ham = cudaq.SpinOperator(qubit_hamiltonian)\n",
+    "\n",
+    "# 2- Quantum computing using UCCSD ansatz\n",
+    "\n",
+    "electron_count = nele_cas\n",
+    "qubit_count = 2*norb_cas\n",
+    "\n",
+    "@cudaq.kernel\n",
+    "def kernel(qubit_num:int, electron_num:int, thetas: list[float]):\n",
+    "        qubits = cudaq.qvector(qubit_num)\n",
+    "\n",
+    "        for i in range(electron_num):\n",
+    "                x(qubits[i])\n",
+    "\n",
+    "        cudaq.kernels.uccsd(qubits, thetas, electron_num, qubit_num)\n",
+    "\n",
+    "parameter_count = cudaq.kernels.uccsd_num_parameters(electron_count,qubit_count)\n",
+    "\n",
+    "# Define a function to minimize\n",
+    "def cost(theta):\n",
+    "\n",
+    "        exp_val = cudaq.observe(kernel, spin_ham, qubit_count, electron_count, theta).expectation()\n",
+    "\n",
+    "        return exp_val\n",
+    "\n",
+    "\n",
+    "exp_vals = []\n",
+    "\n",
+    "def callback(xk):\n",
+    "        exp_vals.append(cost(xk))\n",
+    "\n",
+    "# Initial variational parameters.\n",
+    "np.random.seed(42)\n",
+    "x0 = np.random.normal(0, 1, parameter_count)\n",
+    "\n",
+    "# Use the scipy optimizer to minimize the function of interest\n",
+    "start_time = timeit.default_timer()\n",
+    "result = minimize(cost, x0, method='COBYLA', callback=callback, options={'maxiter': 300})\n",
+    "end_time = timeit.default_timer()\n",
+    "\n",
+    "print('UCCSD-VQE energy =  ', result.fun)\n",
+    "print('Pyscf-CCSD energy = ', mycc.e_tot)\n",
+    "print('Total number of qubits = ', qubit_count)\n",
+    "print('Total number of parameters = ', parameter_count)\n",
+    "print('Total number of terms in the spin hamiltonian = ',spin_ham.get_term_count())\n",
+    "print('Total elapsed time (s) = ', end_time-start_time)\n",
+    "\n",
+    "plt.plot(exp_vals)\n",
+    "plt.xlabel('Epochs')\n",
+    "plt.ylabel('Energy')\n",
+    "plt.title('VQE')\n",
+    "plt.show()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.12"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}
diff --git a/pr-2241/sphinx/index.rst b/pr-2241/sphinx/index.rst
new file mode 100644
index 0000000000..1efc969894
--- /dev/null
+++ b/pr-2241/sphinx/index.rst
@@ -0,0 +1,33 @@
+************
+CUDA-Q
+************
+
+Welcome to the CUDA-Q documentation page!
+
+CUDA-Q streamlines hybrid application development and promotes productivity and scalability
+in quantum computing. It offers a unified programming model designed for a hybrid
+setting |---| that is, CPUs, GPUs, and QPUs working together. CUDA-Q contains support for 
+programming in Python and in C++.
+
+You are browsing the documentation for |version| version of CUDA-Q. You can find documentation for all released versions :doc:`here <versions>`.
+
+**CUDA-Q** is a programming model and toolchain for using quantum acceleration in heterogeneous computing architectures available in C++ and Python.
+
+.. toctree::
+   :caption: Contents
+   :maxdepth: 2
+
+      Quick Start <using/quick_start.rst>
+      Basics <using/basics/basics.rst>
+      Examples <using/examples/examples.rst>
+      Applications <using/tutorials.rst>
+      Backends <using/backends/backends.rst>
+      Installation <using/install/install.rst>
+      Integration <using/integration/integration.rst>
+      Extending <using/extending/extending.rst>
+      Specifications <specification/index.rst>
+      API Reference <api/api.rst>
+      Other Versions <versions.rst>
+
+.. |---|   unicode:: U+2014 .. EM DASH
+   :trim:
\ No newline at end of file
diff --git a/pr-2241/sphinx/releases.rst b/pr-2241/sphinx/releases.rst
new file mode 100644
index 0000000000..6a8a353462
--- /dev/null
+++ b/pr-2241/sphinx/releases.rst
@@ -0,0 +1,130 @@
+************************
+CUDA-Q Releases
+************************
+
+**latest**
+
+The latest version of CUDA-Q is on the main branch of our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__ and is also available as a Docker image. More information about installing the nightly builds can be found :doc:`here <using/install/install>`
+
+- `Docker image (nightly builds) <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/latest>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/main/docs/sphinx/examples>`__
+
+**0.8.0**
+
+The 0.8.0 release adds a range of changes to improve the ease of use and performance with CUDA-Q. 
+The changes listed below highlight some of what we think will be the most useful features and changes 
+to know about. While the listed changes do not capture all of the great contributions, we would like 
+to extend many thanks for every contribution, in particular those from external contributors.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.8.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.8.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.8.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.8.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.8.0>`__.
+
+**0.7.1**
+
+The 0.7.1 release adds simulator optimizations with significant performance improvements and 
+extends their functionalities. The `nvidia-mgpu` backend now supports user customization of the 
+gate fusion level as controlled by the `CUDAQ_MGPU_FUSE` environment variable documented 
+`here <https://nvidia.github.io/cuda-quantum/latest/using/backends/simulators.html>`__.
+It furthermore adds a range of bug fixes and changes the Python wheel installation instructions.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.7.1>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.7.1>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.7.1>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.7.1/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.7.1>`__.
+
+**0.7.0**
+
+The 0.7.0 release adds support for using :doc:`NVIDIA Quantum Cloud <using/backends/nvqc>`,
+giving you access to our most powerful GPU-accelerated simulators even if you don't have an NVIDIA GPU.
+With 0.7.0, we have furthermore greatly increased expressiveness of the Python and C++ language frontends. 
+Check out our `documentation <https://nvidia.github.io/cuda-quantum/latest/using/quick_start.html>`__ 
+to get started with the new Python syntax support we have added, and `follow our blog <https://developer.nvidia.com/cuda-q>`__
+to learn more about the new setup and its performance benefits.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.7.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.7.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.7.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.7.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.7.0>`__.
+
+**0.6.0**
+
+The 0.6.0 release contains improved support for various HPC scenarios. We have added a
+:ref:`plugin infrastructure <distributed-computing-with-mpi>` for connecting CUDA-Q 
+with an existing MPI installation, and we've added a :ref:`new platform target <remote-mqpu-platform>` that distributes workloads across multiple virtual QPUs, 
+each simulated by one or more GPUs.
+
+Starting with 0.6.0, we are now also distributing 
+:ref:`pre-built binaries <install-prebuilt-binaries>` for using CUDA-Q with C++.
+The binaries are built against the `GNU C library <https://www.gnu.org/software/libc/>`__ 
+version 2.28.
+We've added a detailed :doc:`Building from Source <using/install/data_center_install>` guide to build these binaries for older `glibc` versions.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.6.0>`__
+- `C++ installer <https://github.com/NVIDIA/cuda-quantum/releases/0.6.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.6.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.6.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.6.0>`__.
+
+**0.5.0**
+
+With 0.5.0 we have added support for quantum kernel execution on OQC and IQM backends. For more information, see :doc:`using/backends/hardware`.
+CUDA-Q now allows to executing adaptive quantum kernels on quantum hardware backends that support it.
+The 0.5.0 release furthermore improves the tensor network simulation tools and adds a matrix product state simulator, see :doc:`using/backends/simulators`.
+
+Additionally, we are now publishing images for experimental features, which currently includes improved Python language support.
+Please take a look at :doc:`using/install/install` for more information about how to obtain them.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.5.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.5.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.5.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.5.0>`__.
+
+**0.4.1**
+
+The 0.4.1 release adds support for ARM processors in the form of multi-platform Docker images and `aarch64` Python wheels. Additionally, all GPU-based backends are now included in the Python wheels as well as in the Docker image.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.4.1>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.4.1>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/releases/v0.4.1/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/0.4.1>`__.
+
+**0.4.0**
+
+CUDA-Q is now available on PyPI!
+The 0.4.0 release adds support for quantum kernel execution on Quantinuum and IonQ backends. For more information, see :doc:`using/backends/hardware`.
+
+The 0.4.0 PyPI release does not yet include all of the GPU-based backends.
+The fully featured version is available as a Docker image for `linux/amd64` platforms.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Python wheel <https://pypi.org/project/cuda-quantum/0.4.0>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.4.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/0.4.0/docs/sphinx/examples>`__
+
+The full change log can be found `here <https://github.com/NVIDIA/cuda-quantum/releases/tag/0.4.0>`__.
+
+**0.3.0**
+
+The 0.3.0 release of CUDA-Q is available as a Docker image for `linux/amd64` platforms.
+
+- `Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__
+- `Documentation <https://nvidia.github.io/cuda-quantum/0.3.0>`__
+- `Examples <https://github.com/NVIDIA/cuda-quantum/tree/0.3.0/docs/sphinx/examples>`__
diff --git a/pr-2241/sphinx/snippets/cpp/quick_start.cpp b/pr-2241/sphinx/snippets/cpp/quick_start.cpp
new file mode 100644
index 0000000000..0457eda5de
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/quick_start.cpp
@@ -0,0 +1,27 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with: `nvq++ quick_start.cpp && ./a.out`
+// [Begin Documentation]
+#include <cudaq.h>
+
+__qpu__ void kernel(int qubit_count) {
+  cudaq::qvector qubits(qubit_count);
+  h(qubits[0]);
+  for (auto i = 1; i < qubit_count; ++i) {
+    cx(qubits[0], qubits[i]);
+  }
+  mz(qubits);
+}
+
+int main(int argc, char *argv[]) {
+  auto qubit_count = 1 < argc ? atoi(argv[1]) : 2;
+  auto result = cudaq::sample(kernel, qubit_count);
+  result.dump(); // Example: { 11:500 00:500 }
+}
+// [End Documentation]
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/nvqc/nvqc_intro.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/nvqc/nvqc_intro.cpp
new file mode 100644
index 0000000000..d5c19253e4
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/nvqc/nvqc_intro.cpp
@@ -0,0 +1,29 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// [Begin Documentation]
+#include <cudaq.h>
+
+// Define a simple quantum kernel to execute on NVQC.
+struct ghz {
+  // Maximally entangled state between 25 qubits.
+  auto operator()() __qpu__ {
+    constexpr int NUM_QUBITS = 25;
+    cudaq::qvector q(NUM_QUBITS);
+    h(q[0]);
+    for (int i = 0; i < NUM_QUBITS - 1; i++) {
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+    }
+    auto result = mz(q);
+  }
+};
+
+int main() {
+  auto counts = cudaq::sample(ghz{});
+  counts.dump();
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/nvqc/nvqc_mqpu.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/nvqc/nvqc_mqpu.cpp
new file mode 100644
index 0000000000..0c26774f93
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/nvqc/nvqc_mqpu.cpp
@@ -0,0 +1,51 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// [Begin Documentation]
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+#include <cudaq/gradients.h>
+#include <cudaq/optimizers.h>
+#include <iostream>
+
+int main() {
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+
+  auto [ansatz, theta] = cudaq::make_kernel<double>();
+  auto q = ansatz.qalloc();
+  auto r = ansatz.qalloc();
+  ansatz.x(q);
+  ansatz.ry(theta, r);
+  ansatz.x<cudaq::ctrl>(r, q);
+
+  // Run VQE with a gradient-based optimizer.
+  // Delegate cost function and gradient computation across different NVQC-based
+  // QPUs.
+  // Note: this needs to be compiled with `--nvqc-nqpus 3` create 3 virtual
+  // QPUs.
+  cudaq::optimizers::lbfgs optimizer;
+  auto [opt_val, opt_params] = optimizer.optimize(
+      /*dim=*/1, /*opt_function*/ [&](const std::vector<double> &params,
+                                      std::vector<double> &grads) {
+        // Queue asynchronous jobs to do energy evaluations across multiple QPUs
+        auto energy_future =
+            cudaq::observe_async(/*qpu_id=*/0, ansatz, h, params[0]);
+        const double paramShift = M_PI_2;
+        auto plus_future = cudaq::observe_async(/*qpu_id=*/1, ansatz, h,
+                                                params[0] + paramShift);
+        auto minus_future = cudaq::observe_async(/*qpu_id=*/2, ansatz, h,
+                                                 params[0] - paramShift);
+        grads[0] = (plus_future.get().expectation() -
+                    minus_future.get().expectation()) /
+                   2.0;
+        return energy_future.get().expectation();
+      });
+  std::cout << "Minimum energy = " << opt_val << " (expected -1.74886).\n";
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/get_state_async.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/get_state_async.cpp
new file mode 100644
index 0000000000..8fb882e2f0
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/get_state_async.cpp
@@ -0,0 +1,52 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ get_state_async.cpp -o get_state_async.x --target nvidia
+// --target-option mqpu
+// && ./get_state_async.x
+// ```
+#include <cudaq.h>
+#include <cudaq/algorithms/get_state.h>
+int main() {
+  // [Begin Documentation]
+  auto kernelToRun = [](int runtimeParam) __qpu__ {
+    cudaq::qvector q(runtimeParam);
+    h(q[0]);
+    for (int i = 0; i < runtimeParam - 1; ++i)
+      x<cudaq::ctrl>(q[i], q[i + 1]);
+  };
+
+  // Get the quantum_platform singleton
+  auto &platform = cudaq::get_platform();
+
+  // Query the number of QPUs in the system
+  auto num_qpus = platform.num_qpus();
+  printf("Number of QPUs: %zu\n", num_qpus);
+  // We will launch asynchronous tasks
+  // and will store the results immediately as a future
+  // we can query at some later point
+  std::vector<cudaq::async_state_result> stateFutures;
+  for (std::size_t i = 0; i < num_qpus; i++) {
+    stateFutures.emplace_back(
+        cudaq::get_state_async(i, kernelToRun, 5 /*runtimeParam*/));
+  }
+
+  //
+  // Go do other work, asynchronous execution of tasks on-going
+  //
+
+  // Get the results, note future::get() will kick off a wait
+  // if the results are not yet available.
+  for (auto &state : stateFutures) {
+    state.get().dump();
+  }
+  // [End Documentation]
+  return 0;
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/observe_mqpu.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/observe_mqpu.cpp
new file mode 100644
index 0000000000..7c3674d2bd
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/observe_mqpu.cpp
@@ -0,0 +1,40 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ observe_mqpu.cpp -o observe_mqpu.x --target nvidia --target-option mqpu
+// && ./observe_mqpu.x
+// ```
+#include <cudaq.h>
+
+int main() {
+  // [Begin Documentation]
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+
+  // Get the quantum_platform singleton
+  auto &platform = cudaq::get_platform();
+
+  // Query the number of QPUs in the system
+  auto num_qpus = platform.num_qpus();
+  printf("Number of QPUs: %zu\n", num_qpus);
+
+  auto ansatz = [](double theta) __qpu__ {
+    cudaq::qubit q, r;
+    x(q);
+    ry(theta, r);
+    x<cudaq::ctrl>(r, q);
+  };
+
+  double result = cudaq::observe<cudaq::parallel::thread>(ansatz, h, 0.59);
+  printf("Expectation value: %lf\n", result);
+  // [End Documentation]
+  return 0;
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/observe_mqpu_mpi.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/observe_mqpu_mpi.cpp
new file mode 100644
index 0000000000..82d1a49fe0
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/observe_mqpu_mpi.cpp
@@ -0,0 +1,37 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ observe_mqpu_mpi.cpp -o observe_mqpu_mpi.x --target nvidia
+// --target-option mqpu mpirun -np <N> ./observe_mqpu_mpi.x
+// ```
+#include "cudaq.h"
+
+int main() {
+  // [Begin Documentation]
+  cudaq::mpi::initialize();
+  using namespace cudaq::spin;
+  cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                     .21829 * z(0) - 6.125 * z(1);
+
+  auto ansatz = [](double theta) __qpu__ {
+    cudaq::qubit q, r;
+    x(q);
+    ry(theta, r);
+    x<cudaq::ctrl>(r, q);
+  };
+
+  double result = cudaq::observe<cudaq::parallel::mpi>(ansatz, h, 0.59);
+  if (cudaq::mpi::rank() == 0)
+    printf("Expectation value: %lf\n", result);
+  cudaq::mpi::finalize();
+  // [End Documentation]
+
+  return 0;
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/sample_async.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/sample_async.cpp
new file mode 100644
index 0000000000..a5cfaeda9e
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/sample_async.cpp
@@ -0,0 +1,50 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ sample_async.cpp -o sample_async.x --target nvidia --target-option mqpu
+// && ./sample_async.x
+// ```
+#include <cudaq.h>
+
+int main() {
+  // [Begin Documentation]
+  auto kernelToBeSampled = [](int runtimeParam) __qpu__ {
+    cudaq::qvector q(runtimeParam);
+    h(q);
+    mz(q);
+  };
+
+  // Get the quantum_platform singleton
+  auto &platform = cudaq::get_platform();
+
+  // Query the number of QPUs in the system
+  auto num_qpus = platform.num_qpus();
+  printf("Number of QPUs: %zu\n", num_qpus);
+  // We will launch asynchronous sampling tasks
+  // and will store the results immediately as a future
+  // we can query at some later point
+  std::vector<cudaq::async_sample_result> countFutures;
+  for (std::size_t i = 0; i < num_qpus; i++) {
+    countFutures.emplace_back(
+        cudaq::sample_async(i, kernelToBeSampled, 5 /*runtimeParam*/));
+  }
+
+  //
+  // Go do other work, asynchronous execution of sample tasks on-going
+  //
+
+  // Get the results, note future::get() will kick off a wait
+  // if the results are not yet available.
+  for (auto &counts : countFutures) {
+    counts.get().dump();
+  }
+  // [End Documentation]
+  return 0;
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/sample_async_remote.cpp b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/sample_async_remote.cpp
new file mode 100644
index 0000000000..18371c8677
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/cudaq/platform/sample_async_remote.cpp
@@ -0,0 +1,54 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with:
+// ```
+// nvq++ sample_async_remote.cpp -o sample.x \
+//   --target remote-mqpu --remote-mqpu-auto-launch 2
+// ./sample.x
+// ```
+#include <cudaq.h>
+
+int main() {
+  // [Begin Documentation]
+  // Define a kernel to be sampled.
+  auto [kernel, nrControls] = cudaq::make_kernel<int>();
+  auto controls = kernel.qalloc(nrControls);
+  auto targets = kernel.qalloc(2);
+  kernel.h(controls);
+  for (std::size_t tidx = 0; tidx < 2; ++tidx) {
+    kernel.x<cudaq::ctrl>(controls, targets[tidx]);
+  }
+  kernel.mz(controls);
+  kernel.mz(targets);
+
+  // Query the number of QPUs in the system;
+  // The number of QPUs is equal to the number of (auto-)launched server
+  // instances.
+  auto &platform = cudaq::get_platform();
+  auto num_qpus = platform.num_qpus();
+  printf("Number of QPUs: %zu\n", num_qpus);
+
+  // We will launch asynchronous sampling tasks,
+  // and will store the results as a future we can query at some later point.
+  // Each QPU (indexed by an unique Id) is associated with a remote REST server.
+  std::vector<cudaq::async_sample_result> countFutures;
+  for (std::size_t i = 0; i < num_qpus; i++) {
+    countFutures.emplace_back(cudaq::sample_async(
+        /*qpuId=*/i, kernel, /*nrControls=*/i + 1));
+  }
+
+  // Go do other work, asynchronous execution of sample tasks on-going
+  // Get the results, note future::get() will kick off a wait
+  // if the results are not yet available.
+  for (auto &counts : countFutures) {
+    counts.get().dump();
+  }
+  // [End Documentation]
+  return 0;
+}
diff --git a/pr-2241/sphinx/snippets/cpp/using/first_observe.cpp b/pr-2241/sphinx/snippets/cpp/using/first_observe.cpp
new file mode 100644
index 0000000000..2c3977c2e0
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/first_observe.cpp
@@ -0,0 +1,47 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with: `nvq++ first_observe.cpp && ./a.out`
+// [Begin Observe1]
+#include <cudaq.h>
+#include <cudaq/algorithm.h>
+
+#include <iostream>
+
+using namespace cudaq::spin;
+
+__qpu__ void kernel() {
+  cudaq::qubit qubit;
+  h(qubit);
+}
+
+int main() {
+  cudaq::spin_op spin_operator = z(0);
+  // Prints: [1+0j] Z
+  std::cout << spin_operator.to_string() << "\n";
+  // [End Observe1]
+
+  // [Begin Observe2]
+  auto result_0 = cudaq::observe(kernel, spin_operator);
+  // Expectation value of kernel with respect to single `Z` term
+  // should print: 0.0
+  std::cout << "<kernel | spin_operator | kernel> = " << result_0.expectation()
+            << "\n";
+  // [End Observe2]
+
+  // [Begin Observe3]
+  auto result_1 = cudaq::observe(1000, kernel, spin_operator);
+  // Expectation value of kernel with respect to single `Z` term,
+  // but instead of a single deterministic execution of the kernel,
+  // we sample over 1000 shots. We should now print an expectation
+  // value that is close to, but not quite, zero.
+  // Example: 0.025
+  std::cout << "<kernel | spin_operator | kernel> = " << result_1.expectation()
+            << "\n";
+}
+// [End Observe3]
diff --git a/pr-2241/sphinx/snippets/cpp/using/first_sample.cpp b/pr-2241/sphinx/snippets/cpp/using/first_sample.cpp
new file mode 100644
index 0000000000..69aa9bfc23
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/first_sample.cpp
@@ -0,0 +1,52 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// [Begin Documentation]
+#include <cudaq.h>
+#include <iostream>
+
+__qpu__ void kernel(int qubit_count) {
+  // Allocate our qubits.
+  cudaq::qvector qvector(qubit_count);
+  // Place the first qubit in the superposition state.
+  h(qvector[0]);
+  // Loop through the allocated qubits and apply controlled-X,
+  // or CNOT, operations between them.
+  for (auto qubit : cudaq::range(qubit_count - 1)) {
+    x<cudaq::ctrl>(qvector[qubit], qvector[qubit + 1]);
+  }
+  // Measure the qubits.
+  mz(qvector);
+}
+// [End Documentation]
+
+// [Begin Sample1]
+int main() {
+
+  int qubit_count = 2;
+  auto result_0 = cudaq::sample(kernel, /* kernel args */ qubit_count);
+  // Should see a roughly 50/50 distribution between the |00> and
+  // |11> states. Example: {00: 505  11: 495}
+  result_0.dump();
+  // [End Sample1]
+
+  // [Begin Sample2]
+  // With an increased shots count, we will still see the same 50/50
+  // distribution, but now with 10,000 total measurements instead of the default
+  // 1000. Example: {00: 5005  11: 4995}
+  int shots_count = 10000;
+  auto result_1 = cudaq::sample(shots_count, kernel, qubit_count);
+  result_1.dump();
+  // [End Sample2]
+
+  // [Begin Sample3]
+  std::cout << result_1.most_probable() << "\n"; // prints: `00`
+  std::cout << result_1.probability(result_1.most_probable())
+            << "\n"; // prints: `0.5005`
+}
+// [End Sample3]
diff --git a/pr-2241/sphinx/snippets/cpp/using/time.cpp b/pr-2241/sphinx/snippets/cpp/using/time.cpp
new file mode 100644
index 0000000000..ed810b1d77
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/time.cpp
@@ -0,0 +1,42 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// Compile and run with: `nvq++ time.cpp && ./a.out`
+
+#include <chrono>
+#include <cudaq.h>
+#include <iostream>
+
+__qpu__ void kernel(int qubit_count) {
+  // Allocate our qubits.
+  cudaq::qvector qvector(qubit_count);
+  // Place the first qubit in the superposition state.
+  h(qvector[0]);
+  // Loop through the allocated qubits and apply controlled-X,
+  // or CNOT, operations between them.
+  for (auto qubit : cudaq::range(qubit_count - 1)) {
+    x<cudaq::ctrl>(qvector[qubit], qvector[qubit + 1]);
+  }
+  // Measure the qubits.
+  mz(qvector);
+}
+
+// [Begin Time]
+int main(int argc, char *argv[]) {
+  auto qubit_count = 1 < argc ? atoi(argv[1]) : 25;
+  auto shots_count = 1000000;
+  auto start = std::chrono::high_resolution_clock::now();
+
+  // Timing just the sample execution.
+  auto result = cudaq::sample(shots_count, kernel, qubit_count);
+
+  auto stop = std::chrono::high_resolution_clock::now();
+  auto duration = std::chrono::duration<double>(stop - start);
+  std::cout << "It took " << duration.count() << " seconds.\n";
+}
+// [End Time]
diff --git a/pr-2241/sphinx/snippets/cpp/using/two_qubit_custom_op.cpp b/pr-2241/sphinx/snippets/cpp/using/two_qubit_custom_op.cpp
new file mode 100644
index 0000000000..a11644bdaa
--- /dev/null
+++ b/pr-2241/sphinx/snippets/cpp/using/two_qubit_custom_op.cpp
@@ -0,0 +1,38 @@
+/*******************************************************************************
+ * Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                  *
+ * All rights reserved.                                                        *
+ *                                                                             *
+ * This source code and the accompanying materials are made available under    *
+ * the terms of the Apache License 2.0 which accompanies this distribution.    *
+ ******************************************************************************/
+
+// [Begin Docs]
+#include <cudaq.h>
+
+CUDAQ_REGISTER_OPERATION(MyCNOT, 2, 0,
+                         {1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0, 0, 1, 0});
+
+CUDAQ_REGISTER_OPERATION(
+    MyXY, 2, 0,
+    {0, 0, 0, {0, -1}, 0, 0, {0, 1}, 0, 0, {0, -1}, 0, 0, {0, 1}, 0, 0, 0});
+
+__qpu__ void bell_pair() {
+  cudaq::qubit q, r;
+  h(q);
+  MyCNOT(q, r); // MyCNOT(control, target)
+}
+
+__qpu__ void custom_xy_test() {
+  cudaq::qubit q, r;
+  MyXY(q, r);
+  y(r); // undo the prior Y gate on qubit 1
+}
+
+int main() {
+  auto counts = cudaq::sample(bell_pair);
+  counts.dump(); // prints { 11:500 00:500 } (exact numbers will be random)
+
+  counts = cudaq::sample(custom_xy_test);
+  counts.dump(); // prints { 10:1000 }
+}
+// [End Docs]
diff --git a/pr-2241/sphinx/snippets/python/quick_start.py b/pr-2241/sphinx/snippets/python/quick_start.py
new file mode 100644
index 0000000000..657a086bd8
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/quick_start.py
@@ -0,0 +1,28 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# [Begin Documentation]
+import sys
+import cudaq
+
+print(f"Running on target {cudaq.get_target().name}")
+qubit_count = int(sys.argv[1]) if 1 < len(sys.argv) else 2
+
+
+@cudaq.kernel
+def kernel():
+    qubits = cudaq.qvector(qubit_count)
+    h(qubits[0])
+    for i in range(1, qubit_count):
+        x.ctrl(qubits[0], qubits[i])
+    mz(qubits)
+
+
+result = cudaq.sample(kernel)
+print(result)  # Example: { 11:500 00:500 }
+# [End Documentation]
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/nvqc/nvqc_intro.py b/pr-2241/sphinx/snippets/python/using/cudaq/nvqc/nvqc_intro.py
new file mode 100644
index 0000000000..91b9ef5360
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/nvqc/nvqc_intro.py
@@ -0,0 +1,23 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+# [Begin Documentation]
+import cudaq
+
+cudaq.set_target("nvqc")
+num_qubits = 25
+# Define a simple quantum kernel to execute on NVQC.
+kernel = cudaq.make_kernel()
+qubits = kernel.qalloc(num_qubits)
+# Maximally entangled state between 25 qubits.
+kernel.h(qubits[0])
+for i in range(num_qubits - 1):
+    kernel.cx(qubits[i], qubits[i + 1])
+kernel.mz(qubits)
+
+counts = cudaq.sample(kernel)
+print(counts)
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/nvqc/nvqc_mqpu.py b/pr-2241/sphinx/snippets/python/using/cudaq/nvqc/nvqc_mqpu.py
new file mode 100644
index 0000000000..38454615ef
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/nvqc/nvqc_mqpu.py
@@ -0,0 +1,54 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+# [Begin Documentation]
+import cudaq
+from cudaq import spin
+import math
+
+# Use NVQC with 3 virtual QPUs
+cudaq.set_target("nvqc", nqpus=3)
+
+print("Number of QPUs:", cudaq.get_target().num_qpus())
+# Create the parameterized ansatz
+kernel, theta = cudaq.make_kernel(float)
+qreg = kernel.qalloc(2)
+kernel.x(qreg[0])
+kernel.ry(theta, qreg[1])
+kernel.cx(qreg[1], qreg[0])
+
+# Define its spin Hamiltonian.
+hamiltonian = (5.907 - 2.1433 * spin.x(0) * spin.x(1) -
+               2.1433 * spin.y(0) * spin.y(1) + 0.21829 * spin.z(0) -
+               6.125 * spin.z(1))
+
+
+def opt_gradient(parameter_vector):
+    # Evaluate energy and gradient on different remote QPUs
+    # (i.e., concurrent job submissions to NVQC)
+    energy_future = cudaq.observe_async(kernel,
+                                        hamiltonian,
+                                        parameter_vector[0],
+                                        qpu_id=0)
+    plus_future = cudaq.observe_async(kernel,
+                                      hamiltonian,
+                                      parameter_vector[0] + 0.5 * math.pi,
+                                      qpu_id=1)
+    minus_future = cudaq.observe_async(kernel,
+                                       hamiltonian,
+                                       parameter_vector[0] - 0.5 * math.pi,
+                                       qpu_id=2)
+    return (energy_future.get().expectation(), [
+        (plus_future.get().expectation() - minus_future.get().expectation()) /
+        2.0
+    ])
+
+
+optimizer = cudaq.optimizers.LBFGS()
+optimal_value, optimal_parameters = optimizer.optimize(1, opt_gradient)
+print("Ground state energy =", optimal_value)
+print("Optimal parameters =", optimal_parameters)
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/platform/get_state_async.py b/pr-2241/sphinx/snippets/python/using/cudaq/platform/get_state_async.py
new file mode 100644
index 0000000000..ccb9aa85b3
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/platform/get_state_async.py
@@ -0,0 +1,31 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+# [Begin Documentation]
+import cudaq
+
+cudaq.set_target("nvidia", option="mqpu")
+target = cudaq.get_target()
+qpu_count = target.num_qpus()
+print("Number of QPUs:", qpu_count)
+
+
+@cudaq.kernel
+def kernel():
+    qvector = cudaq.qvector(5)
+    # Place qubits in GHZ State
+    h(qvector[0])
+    for qubit in range(4):
+        x.ctrl(qvector[qubit], qvector[qubit + 1])
+
+
+state_futures = []
+for qpu in range(qpu_count):
+    state_futures.append(cudaq.get_state_async(kernel, qpu_id=qpu))
+
+for state in state_futures:
+    print(state.get())
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/platform/observe_mqpu.py b/pr-2241/sphinx/snippets/python/using/cudaq/platform/observe_mqpu.py
new file mode 100644
index 0000000000..dd66535e3f
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/platform/observe_mqpu.py
@@ -0,0 +1,35 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+# [Begin Documentation]
+import cudaq
+from cudaq import spin
+
+cudaq.set_target("nvidia", option="mqpu")
+target = cudaq.get_target()
+num_qpus = target.num_qpus()
+print("Number of QPUs:", num_qpus)
+
+
+# Define spin ansatz.
+@cudaq.kernel
+def kernel(angle: float):
+    qvector = cudaq.qvector(2)
+    x(qvector[0])
+    ry(angle, qvector[1])
+    x.ctrl(qvector[1], qvector[0])
+
+
+# Define spin Hamiltonian.
+hamiltonian = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+    0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+exp_val = cudaq.observe(kernel,
+                        hamiltonian,
+                        0.59,
+                        execution=cudaq.parallel.thread).expectation()
+print("Expectation value: ", exp_val)
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/platform/observe_mqpu_mpi.py b/pr-2241/sphinx/snippets/python/using/cudaq/platform/observe_mqpu_mpi.py
new file mode 100644
index 0000000000..3b4368a8f6
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/platform/observe_mqpu_mpi.py
@@ -0,0 +1,34 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+# [Begin Documentation]
+import cudaq
+from cudaq import spin
+
+cudaq.mpi.initialize()
+cudaq.set_target("nvidia", option="mqpu")
+
+
+# Define spin ansatz.
+@cudaq.kernel
+def kernel(angle: float):
+    qvector = cudaq.qvector(2)
+    x(qvector[0])
+    ry(angle, qvector[1])
+    x.ctrl(qvector[1], qvector[0])
+
+
+# Define spin Hamiltonian.
+hamiltonian = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+    0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+exp_val = cudaq.observe(kernel, hamiltonian, 0.59,
+                        execution=cudaq.parallel.mpi).expectation()
+if cudaq.mpi.rank() == 0:
+    print("Expectation value: ", exp_val)
+
+cudaq.mpi.finalize()
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/platform/sample_async.py b/pr-2241/sphinx/snippets/python/using/cudaq/platform/sample_async.py
new file mode 100644
index 0000000000..da27ff80d3
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/platform/sample_async.py
@@ -0,0 +1,31 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+# [Begin Documentation]
+import cudaq
+
+cudaq.set_target("nvidia", option="mqpu")
+target = cudaq.get_target()
+qpu_count = target.num_qpus()
+print("Number of QPUs:", qpu_count)
+
+
+@cudaq.kernel
+def kernel(qubit_count: int):
+    qvector = cudaq.qvector(qubit_count)
+    # Place qubits in superposition state.
+    h(qvector)
+    # Measure.
+    mz(qvector)
+
+
+count_futures = []
+for qpu in range(qpu_count):
+    count_futures.append(cudaq.sample_async(kernel, 5, qpu_id=qpu))
+
+for counts in count_futures:
+    print(counts.get())
diff --git a/pr-2241/sphinx/snippets/python/using/cudaq/platform/sample_async_remote.py b/pr-2241/sphinx/snippets/python/using/cudaq/platform/sample_async_remote.py
new file mode 100644
index 0000000000..763879ab9c
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/cudaq/platform/sample_async_remote.py
@@ -0,0 +1,71 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+import argparse
+import cudaq
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--backend',
+                        type=str,
+                        required=False,
+                        default="tensornet")
+    parser.add_argument('--servers', type=str, required=False, default='2')
+    args = parser.parse_args()
+
+    # [Begin Documentation]
+    # Specified as program input, e.g.
+    # ```
+    # backend = "tensornet"; servers = "2"
+    # ```
+    backend = args.backend
+    servers = args.servers
+
+    # Define a kernel to be sampled.
+    @cudaq.kernel
+    def kernel(controls_count: int):
+        controls = cudaq.qvector(controls_count)
+        targets = cudaq.qvector(2)
+        # Place controls in superposition state.
+        h(controls)
+        for target in range(2):
+            x.ctrl(controls, targets[target])
+        # Measure.
+        mz(controls)
+        mz(targets)
+
+    # Set the target to execute on and query the number of QPUs in the system;
+    # The number of QPUs is equal to the number of (auto-)launched server instances.
+    cudaq.set_target("remote-mqpu",
+                     backend=backend,
+                     auto_launch=str(servers) if servers.isdigit() else "",
+                     url="" if servers.isdigit() else servers)
+    qpu_count = cudaq.get_target().num_qpus()
+    print("Number of virtual QPUs:", qpu_count)
+
+    # We will launch asynchronous sampling tasks,
+    # and will store the results as a future we can query at some later point.
+    # Each QPU (indexed by an unique Id) is associated with a remote REST server.
+    count_futures = []
+    for i in range(qpu_count):
+
+        result = cudaq.sample_async(kernel, i + 1, qpu_id=i)
+        count_futures.append(result)
+    print("Sampling jobs launched for asynchronous processing.")
+
+    # Go do other work, asynchronous execution of sample tasks on-going.
+    # Get the results, note future::get() will kick off a wait
+    # if the results are not yet available.
+    for idx in range(len(count_futures)):
+        counts = count_futures[idx].get()
+        print(counts)
+        # [End Documentation]
+
+        assert len(counts) == 1 << (idx + 1)
+        for key in counts:
+            assert len(key) == 3 + idx
diff --git a/pr-2241/sphinx/snippets/python/using/examples/cnot_gate.py b/pr-2241/sphinx/snippets/python/using/examples/cnot_gate.py
new file mode 100644
index 0000000000..7cc193a966
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/cnot_gate.py
@@ -0,0 +1,29 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+#[Begin Docs]
+import cudaq
+
+
+@cudaq.kernel
+def kernel():
+    # 2 qubits both initialized to the ground/ zero state.
+    qvector = cudaq.qvector(2)
+
+    x(qvector[0])
+
+    # Controlled-not gate operation.
+    x.ctrl(qvector[0], qvector[1])
+
+    mz(qvector[0])
+    mz(qvector[1])
+
+
+result = cudaq.sample(kernel)
+print(result)
+#[End Docs]
diff --git a/pr-2241/sphinx/snippets/python/using/examples/hadamard_gate.py b/pr-2241/sphinx/snippets/python/using/examples/hadamard_gate.py
new file mode 100644
index 0000000000..3cd1c1b9f6
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/hadamard_gate.py
@@ -0,0 +1,30 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+#[Begin Docs]
+import cudaq
+
+
+@cudaq.kernel
+def kernel():
+    # A single qubit initialized to the ground/ zero state.
+    qubit = cudaq.qubit()
+
+    # Apply Hadamard gate to single qubit to put it in equal superposition.
+    h(qubit)
+
+    # Measurement operator.
+    mz(qubit)
+
+
+result = cudaq.sample(kernel)
+print("Measured |0> with probability " +
+      str(result["0"] / sum(result.values())))
+print("Measured |1> with probability " +
+      str(result["1"] / sum(result.values())))
+#[End Docs]
diff --git a/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py b/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
new file mode 100644
index 0000000000..00cdc6b0b7
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
@@ -0,0 +1,74 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# [Begin prepare]
+import cudaq
+from cudaq import spin
+import numpy as np
+
+if cudaq.num_available_gpus() == 0:
+    print("This example requires a GPU to run. No GPU detected.")
+    exit(0)
+
+np.random.seed(1)
+cudaq.set_target("nvidia", option="mqpu")
+
+qubit_count = 5
+sample_count = 10000
+h = spin.z(0)
+parameter_count = qubit_count
+
+# Below we run a circuit for 10000 different input parameters.
+parameters = np.random.default_rng(13).uniform(low=0,
+                                               high=1,
+                                               size=(sample_count,
+                                                     parameter_count))
+
+kernel, params = cudaq.make_kernel(list)
+
+qubits = kernel.qalloc(qubit_count)
+qubits_list = list(range(qubit_count))
+
+for i in range(qubit_count):
+    kernel.rx(params[i], qubits[i])
+# [End prepare]
+
+# [Begin single]
+import timeit
+
+timeit.timeit(lambda: cudaq.observe(kernel, h, parameters),
+              number=1)  # Single GPU result.
+# [End single]
+
+# [Begin split]
+print('We have', parameters.shape[0],
+      'parameters which we would like to execute')
+
+xi = np.split(
+    parameters,
+    4)  # We split our parameters into 4 arrays since we have 4 GPUs available.
+
+print('We split this into', len(xi), 'batches of', xi[0].shape[0], ',',
+      xi[1].shape[0], ',', xi[2].shape[0], ',', xi[3].shape[0])
+# [End split]
+
+# [Begin multiple]
+# Timing the execution on a single GPU vs 4 GPUs,
+# one will see a 4x performance improvement if 4 GPUs are available.
+
+asyncresults = []
+num_gpus = cudaq.num_available_gpus()
+
+for i in range(len(xi)):
+    for j in range(xi[i].shape[0]):
+        qpu_id = i * num_gpus // len(xi)
+        asyncresults.append(
+            cudaq.observe_async(kernel, h, xi[i][j, :], qpu_id=qpu_id))
+
+result = [res.get() for res in asyncresults]
+# [End multiple]
diff --git a/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/hamiltonian_batching.py b/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/hamiltonian_batching.py
new file mode 100644
index 0000000000..614a3048a3
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/hamiltonian_batching.py
@@ -0,0 +1,49 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+#[Begin Docs]
+import cudaq
+from cudaq import spin
+
+if cudaq.num_available_gpus() == 0:
+    print("This example requires a GPU to run. No GPU detected.")
+    exit(0)
+
+cudaq.set_target("nvidia", option="mqpu")
+cudaq.mpi.initialize()
+
+qubit_count = 15
+term_count = 100000
+
+kernel = cudaq.make_kernel()
+qubits = kernel.qalloc(qubit_count)
+kernel.h(qubits[0])
+for i in range(1, qubit_count):
+    kernel.cx(qubits[0], qubits[i])
+
+# We create a random Hamiltonian
+hamiltonian = cudaq.SpinOperator.random(qubit_count, term_count)
+
+# The observe calls allows us to calculate the expectation value of the Hamiltonian with respect to a specified kernel.
+
+# Single node, single GPU.
+result = cudaq.observe(kernel, hamiltonian)
+result.expectation()
+
+# If we have multiple GPUs/ QPUs available, we can parallelize the workflow with the addition of an argument in the observe call.
+
+# Single node, multi-GPU.
+result = cudaq.observe(kernel, hamiltonian, execution=cudaq.parallel.thread)
+result.expectation()
+
+# Multi-node, multi-GPU.
+result = cudaq.observe(kernel, hamiltonian, execution=cudaq.parallel.mpi)
+result.expectation()
+
+cudaq.mpi.finalize()
+#[End Docs]
diff --git a/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py b/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
new file mode 100644
index 0000000000..70b18a96cb
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
@@ -0,0 +1,40 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# [Begin state]
+import cudaq
+
+
+@cudaq.kernel
+def ghz_state(qubit_count: int):
+    qubits = cudaq.qvector(qubit_count)
+    h(qubits[0])
+    for i in range(1, qubit_count):
+        cx(qubits[0], qubits[i])
+    mz(qubits)
+
+
+def sample_ghz_state(qubit_count, target):
+    """A function that will sample a variable sized GHZ state."""
+    cudaq.set_target(target)
+    result = cudaq.sample(ghz_state, qubit_count, shots_count=1000)
+    return result
+
+
+# [End state]
+
+# [Begin CPU]
+cpu_result = sample_ghz_state(qubit_count=2, target="qpp-cpu")
+cpu_result.dump()
+# [End CPU]
+
+# [Begin GPU]
+if cudaq.num_available_gpus() > 0:
+    gpu_result = sample_ghz_state(qubit_count=25, target="nvidia")
+    gpu_result.dump()
+# [End GPU]
diff --git a/pr-2241/sphinx/snippets/python/using/examples/pauli_x_gate.py b/pr-2241/sphinx/snippets/python/using/examples/pauli_x_gate.py
new file mode 100644
index 0000000000..af56fbabb5
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/pauli_x_gate.py
@@ -0,0 +1,28 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+#[Begin Docs]
+import cudaq
+
+
+@cudaq.kernel
+def kernel():
+    # A single qubit initialized to the ground / zero state.
+    qubit = cudaq.qubit()
+
+    # Apply the Pauli x gate to the qubit.
+    x(qubit)
+
+    # Measurement operator.
+    mz(qubit)
+
+
+# Sample the qubit for 1000 shots to gather statistics.
+result = cudaq.sample(kernel)
+print(result.most_probable())
+#[End Docs]
diff --git a/pr-2241/sphinx/snippets/python/using/examples/two_qubit_custom_op.py b/pr-2241/sphinx/snippets/python/using/examples/two_qubit_custom_op.py
new file mode 100644
index 0000000000..d42feb6e34
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/examples/two_qubit_custom_op.py
@@ -0,0 +1,48 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# fmt: off
+#[Begin Docs]
+import cudaq
+import numpy as np
+
+# Create and test a custom CNOT operation.
+cudaq.register_operation("my_cnot", np.array([1, 0, 0, 0,
+                                              0, 1, 0, 0,
+                                              0, 0, 0, 1,
+                                              0, 0, 1, 0]))
+
+@cudaq.kernel
+def bell_pair():
+    qubits = cudaq.qvector(2)
+    h(qubits[0])
+    my_cnot(qubits[0], qubits[1]) # `my_cnot(control, target)`
+
+
+cudaq.sample(bell_pair).dump() # prints { 11:500 00:500 } (exact numbers will be random)
+
+
+# Construct a custom unitary matrix for X on the first qubit and Y
+# on the second qubit.
+X = np.array([[0,  1 ], [1 , 0]])
+Y = np.array([[0, -1j], [1j, 0]])
+XY = np.kron(X, Y)
+
+# Register the custom operation
+cudaq.register_operation("my_XY", XY)
+
+@cudaq.kernel
+def custom_xy_test():
+    qubits = cudaq.qvector(2)
+    my_XY(qubits[0], qubits[1])
+    y(qubits[1]) # undo the prior Y gate on qubit 1
+
+
+cudaq.sample(custom_xy_test).dump() # prints { 10:1000 }
+#[End Docs]
+# fmt: on
diff --git a/pr-2241/sphinx/snippets/python/using/first_observe.py b/pr-2241/sphinx/snippets/python/using/first_observe.py
new file mode 100644
index 0000000000..a0b1d3caf1
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/first_observe.py
@@ -0,0 +1,32 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+#[Begin Observe1]
+import cudaq
+from cudaq import spin
+
+operator = spin.z(0)
+print(operator)  # prints: [1+0j] Z
+
+
+@cudaq.kernel
+def kernel():
+    qubit = cudaq.qubit()
+    h(qubit)
+    # [End Observe1]
+
+
+#[Begin Observe2]
+result = cudaq.observe(kernel, operator)
+print(result.expectation())  # prints: 0.0
+#[End Observe2]
+
+#[Begin Observe3]
+result = cudaq.observe(kernel, operator, shots_count=1000)
+print(result.expectation())  # prints non-zero value
+#[End Observe3]
diff --git a/pr-2241/sphinx/snippets/python/using/first_sample.py b/pr-2241/sphinx/snippets/python/using/first_sample.py
new file mode 100644
index 0000000000..1e60b16e32
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/first_sample.py
@@ -0,0 +1,93 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+# [Begin Documentation]
+import cudaq
+
+
+# Define our kernel.
+@cudaq.kernel
+def kernel(qubit_count: int):
+    # Allocate our qubits.
+    qvector = cudaq.qvector(qubit_count)
+    # Place the first qubit in the superposition state.
+    h(qvector[0])
+    # Loop through the allocated qubits and apply controlled-X,
+    # or CNOT, operations between them.
+    for qubit in range(qubit_count - 1):
+        x.ctrl(qvector[qubit], qvector[qubit + 1])
+    # Measure the qubits.
+    mz(qvector)
+    # [End Documentation]
+
+
+#[Begin Sample1]
+qubit_count = 2
+print(cudaq.draw(kernel, qubit_count))
+results = cudaq.sample(kernel, qubit_count)
+# Should see a roughly 50/50 distribution between the |00> and
+# |11> states. Example: {00: 505  11: 495}
+print("Measurement distribution:" + str(results))
+#[End Sample1]
+
+#[Begin Sample2]
+# With an increased shots count, we will still see the same 50/50 distribution,
+# but now with 10,000 total measurements instead of the default 1000.
+# Example: {00: 5005  11: 4995}
+results = cudaq.sample(kernel, qubit_count, shots_count=10000)
+print("Measurement distribution:" + str(results))
+#[End Sample2]
+
+#[Begin Sample3]
+most_probable_result = results.most_probable()
+probability = results.probability(most_probable_result)
+print("Most probable result: " + most_probable_result)
+print("Measured with probability " + str(probability), end='\n\n')
+#[End Sample3]
+
+# Parallelize over the various kernels one would like to execute.
+
+
+#[Begin SampleAsync]
+@cudaq.kernel
+def kernel2(qubit_count: int):
+    # Allocate our qubits.
+    qvector = cudaq.qvector(qubit_count)
+    # Place all qubits in a uniform superposition.
+    h(qvector)
+    # Measure the qubits.
+    mz(qvector)
+
+
+num_gpus = cudaq.num_available_gpus()
+if num_gpus > 1:
+    # Set the target to include multiple virtual QPUs.
+    cudaq.set_target("nvidia", option="mqpu")
+    # Asynchronous execution on multiple virtual QPUs, each simulated by an NVIDIA GPU.
+    result_1 = cudaq.sample_async(kernel,
+                                  qubit_count,
+                                  shots_count=1000,
+                                  qpu_id=0)
+    result_2 = cudaq.sample_async(kernel2,
+                                  qubit_count,
+                                  shots_count=1000,
+                                  qpu_id=1)
+else:
+    # Schedule for execution on the same virtual QPU.
+    result_1 = cudaq.sample_async(kernel,
+                                  qubit_count,
+                                  shots_count=1000,
+                                  qpu_id=0)
+    result_2 = cudaq.sample_async(kernel2,
+                                  qubit_count,
+                                  shots_count=1000,
+                                  qpu_id=0)
+
+print("Measurement distribution for kernel:" + str(result_1.get()))
+print("Measurement distribution for kernel2:" + str(result_2.get()))
+#[End SampleAsync]
diff --git a/pr-2241/sphinx/snippets/python/using/time.py b/pr-2241/sphinx/snippets/python/using/time.py
new file mode 100644
index 0000000000..08c3a93f6a
--- /dev/null
+++ b/pr-2241/sphinx/snippets/python/using/time.py
@@ -0,0 +1,39 @@
+# ============================================================================ #
+# Copyright (c) 2022 - 2024 NVIDIA Corporation & Affiliates.                   #
+# All rights reserved.                                                         #
+#                                                                              #
+# This source code and the accompanying materials are made available under     #
+# the terms of the Apache License 2.0 which accompanies this distribution.     #
+# ============================================================================ #
+
+import cudaq
+
+
+@cudaq.kernel
+def kernel(qubit_count: int):
+    qvector = cudaq.qvector(qubit_count)
+    h(qvector[0])
+    for qubit in range(qubit_count - 1):
+        x.ctrl(qvector[qubit], qvector[qubit + 1])
+    mz(qvector)
+
+
+#[Begin Time]
+import sys
+import timeit
+
+# Will time the execution of our sample call.
+code_to_time = 'cudaq.sample(kernel, qubit_count, shots_count=1000000)'
+qubit_count = int(sys.argv[1]) if 1 < len(sys.argv) else 25
+
+# Execute on CPU backend.
+cudaq.set_target('qpp-cpu')
+print('CPU time')  # Example: 27.57462 s.
+print(timeit.timeit(stmt=code_to_time, globals=globals(), number=1))
+
+if cudaq.num_available_gpus() > 0:
+    # Execute on GPU backend.
+    cudaq.set_target('nvidia')
+    print('GPU time')  # Example: 0.773286 s.
+    print(timeit.timeit(stmt=code_to_time, globals=globals(), number=1))
+#[End Time]
diff --git a/pr-2241/sphinx/specification/cudaq.rst b/pr-2241/sphinx/specification/cudaq.rst
new file mode 100644
index 0000000000..e0e87a44e4
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq.rst
@@ -0,0 +1,41 @@
+Language Specification 
+***********************************
+
+NVIDIA CUDA-Q is a programming model in C++ for heterogeneous 
+quantum-classical computing. As such, the model provides primitive types, concepts, syntax, and
+semantics that enable the integration of quantum processing units (QPUs) with
+existing NVIDIA multi-node, multi-GPU parallel programming models and architectures. 
+The language is designed for C++. Extensions to other languages is fully supported 
+via appropriate bindings. 
+
+CUDA-Q implementations are intended to be enabled via library-based language 
+extensions that define quantum code as callables in the classical language being extended. 
+These callables are meant to be compiled with standard compilers and runtimes 
+and run via quantum computer simulators or available physical quantum architectures. The 
+language callables intended for quantum coprocessing must be annotated for 
+compilers and runtimes to process. These annotations should directly enable quantum-specific 
+optimization and transformation for optimal execution on simulators and QPUs. 
+
+The rest of this document will detail all aspects of the language specification - its machine model, 
+primitive types and operations, core concepts and abstractions, and algorithmic primitives. All code 
+specification and demonstrative examples are provided in C++ (the native CUDA-Q classical language). 
+Where possible, bindings for higher-level languages (e.g. Python) will be displayed to aid in understanding.
+
+.. toctree::
+  :numbered:
+  :caption: CUDA-Q
+  :maxdepth: 1
+
+  Machine Model <cudaq/machine_model.rst>
+  Namespace and Standard <cudaq/namespace.rst>
+  Quantum Types <cudaq/types.rst>
+  Quantum Operators <cudaq/operators.rst>
+  Quantum Operations <cudaq/operations.rst>
+  Quantum Kernels <cudaq/kernels.rst>
+  Sub-circuit Synthesis <cudaq/synthesis.rst>
+  Control Flow <cudaq/control_flow.rst>
+  Just-in-Time Kernel Creation <cudaq/dynamic_kernels.rst>
+  Quantum Patterns <cudaq/patterns.rst>
+  Platform <cudaq/platform.rst>
+  Algorithmic Primitives <cudaq/algorithmic_primitives.rst>
+  Example Programs <cudaq/examples.rst>
diff --git a/pr-2241/sphinx/specification/cudaq/algorithmic_primitives.rst b/pr-2241/sphinx/specification/cudaq/algorithmic_primitives.rst
new file mode 100644
index 0000000000..7e8b8240f6
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/algorithmic_primitives.rst
@@ -0,0 +1,637 @@
+Quantum Algorithmic Primitives
+******************************
+**[1]** The general philosophy of the CUDA-Q specification is that quantum 
+device code should be encapsulated as stand-alone callable instances of generic 
+signature, and that operations or primitive algorithms targeting a quantum 
+coprocessor be implemented as adaptors on those callable instances. Adaptors, by 
+definition, are generic functions that take any quantum kernel as input along with 
+the runtime arguments for that kernel. Runtime arguments passed to adaptor functions 
+flow through the adaptor to the provided kernel. This pattern allows general pre- 
+and post-processing around concrete kernel execution. 
+
+.. _cudaq-sample-spec:
+
+:code:`cudaq::sample`
+-------------------------
+**[1]** A common task for near-term quantum execution is to sample the state
+of a given quantum circuit for a specified number of shots (circuit
+executions). The result of this task is typically a mapping of observed
+measurement bit strings to the number of times each was observed. This
+is typically termed the counts dictionary in the community. 
+
+**[2]** The CUDA-Q model enables this functionality via template functions within the
+:code:`cudaq` namespace with the following structure:
+
+.. code-block:: cpp
+
+    template <typename ReturnType>
+    concept HasVoidReturnType = std::is_void_v<ReturnType>;
+
+    // Kernel only
+    template<typename QuantumKernel, typename... Args>
+      requires HasVoidReturnType<QuantumKernel, Args...>
+    sample_result sample(QuantumKernel&& kernel, Args&&... args);
+
+    // Specify shots
+    template<typename QuantumKernel, typename... Args>
+      requires HasVoidReturnType<QuantumKernel, Args...>
+    sample_result sample(std::size_t shots, QuantumKernel&& kernel, Args&&... args);
+
+    // Specify sample options (including shots and noise model)
+    template<typename QuantumKernel, typename... Args>
+      requires HasVoidReturnType<QuantumKernel, Args...>
+    sample_result sample(const sample_options &options,
+                         QuantumKernel&& kernel, Args&&... args);
+
+**[3]** This function takes as input a quantum kernel instance followed by the
+concrete arguments at which the kernel should be invoked. CUDA-Q kernels 
+passed to this function must be entry-point kernels and return :code:`void`. 
+
+**[4]** Overloaded functions exist for specifying the number of shots to sample and the
+noise model to apply.
+
+**[5]** The function returns an instance of the :code:`cudaq::sample_result` type which encapsulates
+the counts dictionary produced by the sampling task. Programmers can
+extract the result information in the following manner: 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      auto bell = []() __qpu__ { ... };
+      
+      // Sample the state generated by bel
+      auto counts = cudaq::sample(bell)
+  
+      // Print to standard out
+      counts.dump();
+  
+      // Fine-grained access to the bits and counts
+      for (auto& [bits, count] : counts) {
+        printf("Observed: %s, %lu\n", bits, count);
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def bell(): 
+       ... 
+    
+    # Sample the state generated by bell
+    counts = cudaq.sample(bell) 
+
+    # Print to standard out
+    counts.dump()
+
+    # Fine-grained access to the bits and counts 
+    for bits, count in counts:
+        print('Observed: {}, {}'.format(bits, count))
+
+
+**[6]** CUDA-Q specifies the following structure for :code:`cudaq::sample_result`:
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      using CountsDictionary = std::unordered_map<std::string, std::size_t>;
+      inline static const std::string GlobalRegisterName = "__global__";
+      class sample_result {
+        public:
+          sample_result() = default;
+          sample_result(const sample_result &);
+          ~sample_result();
+          
+          std::vector<std::string> register_names();
+          
+          std::size_t count(std::string_view bitString,
+                      const std::string_view registerName = GlobalRegisterName);
+          
+          std::vector<std::string>
+          sequential_data(const std::string_view registerName = GlobalRegisterName);
+          
+          CountsDictionary
+          to_map(const std::string_view registerName = GlobalRegisterName);
+          
+          sample_result
+          get_marginal(const std::vector<std::size_t> &&marginalIndices,
+                 const std::string_view registerName = GlobalRegisterName);
+
+          double expectation(const std::string_view registerName == GlobalRegisterName);
+          double probability(std::string_view bitString, const std::string_view registerName == GlobalRegisterName);
+          std::size_t size(const std::string_view registerName == GlobalRegisterName);
+          
+          void dump();
+          void clear();
+
+          CountsDictionary::iterator begin();
+          CountsDictionary::iterator end();
+      };
+    }
+
+**[7]** The :code:`sample_result` type enables one to encode measurement results from a 
+quantum circuit sampling task. It keeps track of a list of sample results, each 
+one corresponding to a measurement action during the sampling process and represented 
+by a unique register name. It also tracks a unique global register, the implicit sampling 
+of the state at the end of circuit execution. The API gives fine-grain access 
+to the measurement results for each register. To illustrate this, observe 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+    auto kernel = []() __qpu__ {
+      cudaq::qubit q;
+      h(q);
+      auto reg1 = mz(q);
+      reset (q);
+      x(q);
+    };
+    cudaq::sample(kernel).dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def kernel():
+       q = cudaq.qubit()
+       h(q)
+       reg1 = mz(q)
+       reset(q)
+       x(q)
+    
+    cudaq.sample(kernel).dump()
+
+should produce 
+
+.. code-block:: bash 
+
+    { 
+      __global__ : { 1:1000 }
+      reg1 : { 0:501 1:499 }
+    }
+
+Here we see that we have measured a qubit in a uniform superposition to a 
+register named :code:`reg1`, and followed it with a reset and the application 
+of an NOT operation. The :code:`sample_result` returned for this sampling 
+tasks contains the default :code:`__global__` register as well as the user 
+specified :code:`reg1` register. 
+
+The contents of the :code:`__global__` register will depend on how your kernel
+is written:
+
+1. If no measurements appear in the kernel, then the :code:`__global__`
+   register is formed with implicit measurements being added for *all* the
+   qubits defined in the kernel, and the measurements all occur at the end of
+   the kernel. The order of the bits in the bitstring corresponds to the qubit
+   allocation order specified in the kernel.  That is - the :code:`[0]` element
+   in the :code:`__global__` bitstring corresponds with the first declared qubit
+   in the kernel. For example,
+
+.. tab:: C++ 
+
+   .. code-block:: cpp
+
+       auto kernel = []() __qpu__ {
+         cudaq::qubit a, b;
+         x(a);
+       };
+       cudaq::sample(kernel).dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel 
+    def kernel():
+        a, b = cudaq.qubit(), cudaq.qubit() 
+        x(a) 
+    
+    cudaq.sample(kernel).dump() 
+
+should produce 
+
+   .. code-block:: bash 
+
+       { 
+         __global__ : { 10:1000 }
+       }
+
+2. Conversely, if any measurements appear in the kernel, then only the measured
+   qubits will appear in the :code:`__global__` register. Similar to #1, the 
+   bitstring corresponds to the qubit allocation order specified in the kernel.
+   Also (again, similar to #1), the values of the sampled qubits always
+   correspond to the values *at the end of the kernel execution*. That is - if a
+   qubit is measured in the middle of a kernel and subsequent operations change
+   the state of the qubit, the qubit will be implicitly re-measured at the end
+   of the kernel, and that re-measured value is the value that will appear in
+   the :code:`__global__` register. For example,
+
+.. tab:: C++ 
+
+   .. code-block:: cpp
+
+       auto kernel = []() __qpu__ {
+         cudaq::qubit a, b;
+         x(a);
+         mz(b);
+         mz(a);
+       };
+       cudaq::sample(kernel).dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel
+    def kernel():
+        a, b = cudaq.qubit(), cudaq.qubit()
+        x(a)
+        mz(b)
+        mz(a)
+
+    cudaq.sample(kernel).dump() 
+  
+should produce 
+
+   .. code-block:: bash 
+
+       { 
+         __global__ : { 10:1000 }
+       }
+
+.. note::
+
+  If you don't specify any measurements in your kernel and allow the :code:`nvq++`
+  compiler to perform passes that introduce ancilla qubits into your kernel, it
+  may be difficult to discern which qubits are the ancilla qubits vs which ones
+  are your qubits. In this case, it is recommended that you provide explicit
+  measurements in your kernel in order to only receive measurements from your
+  qubits and silently discard the measurements from the ancillary qubits.
+
+**[8]** The API exposed by the :code:`sample_result` data type allows one to extract
+the information contained at a variety of levels and for each available 
+register name. One can get the number of times a bit string was observed via 
+:code:`sample_result::count`, extract a `std::unordered_map` representation via 
+:code:`sample_result::to_map`, get a new :code:`sample_result` instance over a subset of 
+measured qubits via :code:`sample_result::get_marginal`, and extract the 
+measurement data as it was produced sequentially (a vector of bit string observations 
+for each shot in the sampling process). One can also compute probabilities and expectation 
+values. 
+
+**[9]** There are specific requirements on input quantum kernels for the use of the
+sample function which must be enforced by compiler implementations. The kernel 
+must be an entry-point kernel that returns :code:`void`.
+
+**[10]** CUDA-Q also provides an asynchronous version of this function 
+(:code:`cudaq::sample_async`) which returns a :code:`sample_async_result`. 
+
+.. code-block:: cpp 
+
+    template<typename QuantumKernel, typename... Args>
+    async_sample_result sample_async(const std::size_t qpu_id, QuantumKernel&& kernel, Args&&... args);
+
+Programmers can asynchronously launch sampling tasks on any :code:`qpu_id`. 
+
+**[11]** The :code:`async_sample_result` wraps a :code:`std::future<sample_result>` and exposes the same 
+:code:`get()` functionality to extract the results after asynchronous execution. 
+
+**[12]** For remote QPU systems with long queue times, the :code:`async_sample_result` type encodes job ID 
+information and can be persisted to file and loaded from file at a later time. After loading from file, 
+and when remote queue jobs are completed, one can invoke :code:`get()` and the results will 
+be retrieved and returned. 
+
+:code:`cudaq::observe`
+-------------------------
+**[1]** A common task in variational algorithms is the computation of the expected
+value of a given observable with respect to a parameterized quantum circuit
+(:math:`\langle H \rangle(𝚹) = \langle \psi(𝚹)|H|\psi(𝚹) \rangle`). 
+
+**[2]** The :code:`cudaq::observe` function is provided to enable one to quickly compute
+this expectation value via execution of the parameterized quantum circuit
+with repeated measurements in the bases of the provided :code:`spin_op` terms. The
+function has the following signature:
+
+.. code-block:: cpp
+  
+    // Kernel only
+    template<typename QuantumKernel, typename... Args>
+    observe_result observe(QuantumKernel&&, cudaq::spin_op&, Args&&... args);
+    
+    // Specify shots
+    template<typename QuantumKernel, typename... Args>
+    observe_result observe(std::size_t shots, QuantumKernel&&, cudaq::spin_op&, Args&&... args);
+
+    // Specify sample options (including shots and noise model)
+    template<typename QuantumKernel, typename... Args>
+    observe_result observe(const cudaq::observe_options &options,
+                          QuantumKernel&&, cudaq::spin_op&, Args&&... args);
+
+**[3]** :code:`cudaq::observe` takes as input an instantiated quantum kernel, the
+:code:`cudaq::spin_op` whose expectation is requested, and the concrete
+arguments used as input to the parameterized quantum kernel. 
+
+**[4]** :code:`cudaq::observe` returns an instance of the :code:`observe_result` type which can be implicitly 
+converted to a :code:`double` expectation value, but also retains all data directly
+generated and used as part of that expectation value computation. The 
+:code:`observe_result` takes on the following form:
+
+.. code-block:: cpp
+
+    class observe_result {
+      public:
+        observe_result(double &e, spin_op &H);
+        observe_result(double &e, spin_op &H, MeasureCounts counts);
+
+        sample_results raw_data() { return data; };
+        operator double();
+        double expectation();
+        
+        template <typename SpinOpType>
+        double expectation(SpinOpType term);
+
+        template <typename SpinOpType>
+        sample_result counts(SpinOpType term);
+        double id_coefficient() 
+        void dump();
+    };
+
+**[5]** The public API for :code:`observe_result` enables one to extract the 
+:code:`sample_result` data for each term in the provided :code:`spin_op`. 
+This return type can be used in the following way.
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+      // I only care about the expected value, discard 
+      // the fine-grain data produced
+      double expVal = cudaq::observe(kernel, spinOp, args...);
+
+      // I require the result with all generated data 
+      auto result = cudaq::observe(kernel, spinOp, args...);
+      auto expVal = result.expectation();
+      auto X0X1Exp = result.expectation(x(0)*x(1));
+      auto X0X1Data = result.counts(x(0)*x(1));
+      result.dump();
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    # I require the result with all generated data 
+    result = cudaq::observe(kernel, spinOp, *args)
+    expVal = result.expectation()
+    X0X1Exp = result.expectation(x(0)*x(1))
+    X0X1Data = result.counts(x(0)*x(1))
+    result.dump()
+
+
+Here is an example of the utility of the :code:`cudaq::observe` function:
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      struct ansatz {
+        auto operator()(double theta) __qpu__ {
+          cudaq::qarray<2> q;
+          x(q[0]);
+          ry(theta, q[1]);
+          x<cudaq::ctrl>(q[1], q[0]);
+        }
+      };
+    
+      int main() {
+        using namespace cudaq::spin; // make it easier to use pauli X,Y,Z below
+    
+        spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                    .21829 * z(0) - 6.125 * z(1);
+    
+        double energy = cudaq::observe(ansatz{}, h, .59);
+        printf("Energy is %lf\n", energy); 
+        return 0;
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def ansatz(theta : float): 
+       q = cudaq.qvector(2)
+       x(q[0])
+       ry(theta, q[1])
+       x.ctrl(q[1], q[0])
+    
+    h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                    .21829 * z(0) - 6.125 * z(1)
+    energy = cudaq.observe(ansatz, h, .59).expectation() 
+    print('Energy is {}'.format(energy))
+
+
+**[5]** There are specific requirements on input quantum kernels for the use of the
+observe function which must be enforced by compiler implementations. The
+kernel must be an entry-point kernel that does not contain any conditional
+or measurement statements.
+
+**[6]** By default on simulation backends, :code:`cudaq::observe` computes the true
+analytic expectation value (i.e. without stochastic noise due to shots-based sampling). 
+If a specific shot count is provided then the returned expectation value will contain some 
+level of statistical noise. Overloaded :code:`observe` functions are provided to 
+specify the number of shots and/or specify the noise model to apply.
+
+**[7]** CUDA-Q also provides an asynchronous version of this function 
+(:code:`cudaq::observe_async`) which returns a :code:`async_observe_result`. 
+
+.. code-block:: cpp 
+
+    template<typename QuantumKernel, typename... Args>
+    async_observe_result observe_async(const std::size_t qpu_id, QuantumKernel&& kernel, cudaq::spin_op&, Args&&... args);
+
+Programmers can asynchronously launch sampling tasks on any :code:`qpu_id`. 
+
+**[8]** For remote QPU systems with long queue times, the :code:`async_observe_result` type encodes job ID 
+information for each execution and can be persisted to file and loaded from file at a later time. After loading from file, 
+and when remote queue jobs are completed, one can invoke :code:`get()` and the results will 
+be retrieved and returned. 
+
+:code:`cudaq::optimizer` (deprecated, functionality moved to CUDA-Q libraries)
+------------------------------------------------------------------------------------
+The primary use case for :code:`cudaq::observe` is to leverage it as
+the core of a broader objective function optimization workflow. 
+:code:`cudaq::observe` produces the expected value of a specified 
+:code:`spin_op` with respect to a given parameterized ansatz at a concrete
+set of parameters, and often programmers will require an extremal value of that expected value 
+at a specific set of concrete parameters. This will directly require
+abstractions for gradient-based and gradient-free optimization strategies. 
+
+The CUDA-Q model provides a :code:`cudaq::optimizer` data type that exposes
+an :code:`optimize()` method that takes as input an 
+:code:`optimizable_function` to optimize and the number of independent
+function dimensions. Implementations are free to implement this abstraction
+in any way that is pertinent, but it is expected that most approaches will
+enable optimization strategy extensibility. For example, programmers should
+be able to instantiate a specific :code:`cudaq::optimizer` sub-type, thereby 
+dictating the underlying optimization algorithm in a type-safe manner. 
+Moreover, the optimizer should expose a public API of pertinent optimizer-specific 
+options that the programmer can customize.
+
+CUDA-Q models the :code:`cudaq::optimizer` as follows:
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      // Encode the optimal value and optimal parameters
+      using optimization_result = std::tuple<double, std::vector<double>>;
+      // Initialized with user specified callable of a specific signature
+      // Clients can query if the function computes gradients or not
+      class optimizable_function {
+        public:
+          template<typename Callable>
+          optimizable_function(Callable&&);
+          bool providesGradients() { return _providesGradients; }
+          double operator()(const std::vector<double> &x, std::vector<double> &dx);
+      };
+      class optimizer {
+        public:
+          virtual bool requiresGradients() = 0;
+          virtual optimization_result optimize(const int dimensions,
+                                              optimizable_function&& opt_function) = 0;
+      }; 
+    }
+
+Here, :code:`optimization_result` should encode the optimal value and optimal
+parameters achieved during the optimization workflow
+(i.e. a :code:`tuple<double, std::vector<double>>`). The optimize method takes
+as input the number of parameters (or dimensions of the objective function),
+and a function-like object (i.e. :code:`std::function` or a lambda, something 
+:code:`optimizable_function` can be constructed from) that takes a 
+:code:`const std::vector<double>&` and :code:`std::vector<double>&` for the
+function input parameters and gradient vector, respectively. The objective
+function must return a double representing the scalar cost for the
+objective function (e.g. the expected value from :code:`cudaq::observe()`).  
+
+Here is an example of how the :code:`cudaq::optimizer` is intended to be used: 
+
+.. code-block:: cpp 
+
+    auto ansatz = [](double theta, double phi) __qpu__ {...};
+    cudaq::spin_op H = ... ;
+  
+    cudaq::optimizers::cobyla optimizer;
+    optimizer.max_eval = 200;
+  
+    auto [opt_energy, opt_params] = optimizer.optimize(
+          2, [&](const std::vector<double> &x, std::vector<double> &grad_vec) {
+            return cudaq::observe(ansatz, H, x[0], x[1]);
+          });
+
+:code:`cudaq::gradient` (deprecated, functionality moved to CUDA-Q libraries)
+-----------------------------------------------------------------------------------
+Typical optimization use cases will require the computation of gradients for the specified
+objective function. The gradient is a vector over all ansatz circuit
+parameters :math:`∂H(𝚹) / ∂𝚹_i`. There are a number of potential strategies for
+computing this gradient vector, but most require additional evaluations
+of the ansatz circuit on the quantum processor. 
+
+To enable true extensibility in gradient strategies, CUDA-Q programmers can
+instantiate custom sub-types of the :code:`cudaq::gradient` type. The :code:`cudaq::gradient`
+type defines a :code:`compute(...)` method that takes a mutable reference to the 
+current gradient vector and is free to update that vector in a strategy-specific way. 
+The method also takes the current evaluation parameter vector, the :code:`cudaq::spin_op` used 
+in the current variational task, and the computed expected value at the given parameters. 
+The gradient strategy type takes the following form:
+
+.. code-block:: cpp
+
+    namespace cudaq {
+      class gradient {
+        public:
+          gradient(std::function<void(std::vector<double>)> &&kernel);
+  
+          template <typename QuantumKernel, typename ArgsMapper>
+          gradient(QuantumKernel &&kernel, ArgsMapper &&argsMapper);
+  
+          virtual void compute(std::vector<double>& x, std::vector<double> &dx,
+                            spin_op& h, double exp_h) = 0;
+          
+          virtual std::vector<double>
+          compute(const std::vector<double> &x,
+                  std::function<double(std::vector<double>)> &func) = 0;
+
+      };
+  
+      // gradient is intended for subclassing
+      class central_difference : public gradient {
+        public:
+          void compute(std::vector<double>& x, std::vector<double> &dx, spin_op& h,
+                  double exp_h) override { ... }
+      };
+    }
+
+The :code:`compute` function can make use of the quantum kernel parameterized ansatz, the 
+:code:`spin_op` for which the expected value is being computed, the
+pre-computed expected value at the current iteration's parameter, and the
+concrete arguments for the given quantum kernel at this iteration.
+
+A non-trivial aspect of the computation of gradients (in an extensible manner)
+is that we model the gradient as a derivative over concrete parameters for the
+circuit ansatz represented as a :code:`std::vector<double>` when the actual
+quantum kernel may be defined with general variadic :code:`Args...` types.
+To address this issue, programmers can provide a default translation
+mechanism for mapping common quantum kernel ansatz functional expressions to a :code:`vector<double>` representation - the 
+:code:`ArgsMapper` callable template type. This type must implement the 
+:code:`std::tuple<Args...>(std::vector<double>&)` callable concept. 
+
+The overall CUDA-Q workflow for leveraging the :code:`cudaq::optimizer`
+will work as follows (here we demonstrate with an ansatz without the
+default :code:`std::vector<double>` signature):
+
+.. code-block:: cpp
+
+    auto deuteron_n3_ansatz = [](double x0, double x1) __qpu__ {
+      cudaq::qarray<3> q;
+      x(q[0]);
+      ry(x0, q[1]);
+      ry(x1, q[2]);
+      x<cudaq::ctrl>(q[2], q[0]);
+      x<vctrl>(q[0], q[1]);
+      ry(-x0, q[1]);
+      x<cudaq::ctrl>(q[0], q[1]);
+      x<cudaq::ctrl>(q[1], q[0]);
+    };
+
+    cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+              .21829 * z(0) - 6.125 * z(1);
+    cudaq::spin_op h3 = h + 9.625 - 9.625 * z(2) - 3.913119 * x(1) * x(2) -
+                3.913119 * y(1) * y(2);
+
+    // The above ansatz takes 2 doubles, not a single std::vector<double>, which 
+    // the gradient type is expecting. So we must provide an ArgsMapper callable type
+    auto argsMapper = [](std::vector<double> x) {return std::make_tuple(x[0],x[1]);};
+
+    // Create the gradient strategy
+    cudaq::gradients::central_difference gradient(deuteron_n3_ansatz, argsMapper);
+
+    // Create the L-BFGS optimizer, requires gradients
+    cudaq::optimizers::lbfgs optimizer;
+
+    // Run the optimization routine. 
+    auto [min_val, opt_params] = optimizer.optimize(
+        2, [&](const std::vector<double>& x, std::vector<double>& grad_vec) {
+          // Compute the cost, here its an energy
+          auto cost = cudaq::observe(deuteron_n3_ansatz, h3, x);
+          
+          // Compute the gradient, results written to the grad_vec reference
+          gradient.compute(x, grad_vec, h3, cost);
+
+          // Return the cost to the optimizer
+          return cost;
+        });
+
+    // Print the results
+    printf("Optimizer found %lf at [%lf,%lf]\n", min_val, opt_params[0], opt_params[1]);
+
diff --git a/pr-2241/sphinx/specification/cudaq/control_flow.rst b/pr-2241/sphinx/specification/cudaq/control_flow.rst
new file mode 100644
index 0000000000..da3120dd74
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/control_flow.rst
@@ -0,0 +1,10 @@
+Control Flow
+************
+**[1]** All classical control flow expressions are inherited from the host language
+(e.g. C++, Python). 
+
+**[2]** Programmers can define quantum kernels using standard loop
+constructs and conditional statements. 
+
+**[3]** Conditional statements on quantum memory and measured :code:`cudaq::qudit` 
+results are permitted. 
diff --git a/pr-2241/sphinx/specification/cudaq/dynamic_kernels.rst b/pr-2241/sphinx/specification/cudaq/dynamic_kernels.rst
new file mode 100644
index 0000000000..8681ad6a62
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/dynamic_kernels.rst
@@ -0,0 +1,163 @@
+Just-in-Time Kernel Creation
+****************************
+
+**[1]** CUDA-Q provides a set of programming abstractions for dynamically constructing
+quantum kernel code at runtime. 
+
+**[2]** The callable :code:`cudaq::kernel_builder` abstraction
+facilitates the dynamic definition of quantum kernels that can optionally
+be parameterized by user-defined input arguments. 
+
+The :code:`kernel_builder` takes the following structure
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      // Type wrapping a value in the kernel IR
+      struct Value;
+      template <typename... Args>
+      class kernel_builder {
+        private:
+          std::vector<Value> arguments;
+
+        public:
+          std::vector<Value>& getArguments();
+          std::string name() const;
+          std::size_t getNumParams() const;
+
+          Value qalloc(std::size_t nQubits = 1);
+          Value qalloc(Value size);
+
+          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>
+          void call(OtherKernelBuilder&& kernelToCall, Values&... args);
+          
+          // General multi-control on a predefined kernel
+          // models cudaq::control(...)
+          template<typename OtherKernelBuilder, typename... Values>
+          void control(OtherKernelBuilder&& kernelToControl, Value& ctrl, Values&... values);
+          
+          // General adjoint on a predefined kernel
+          // models cudaq::adjoint(...)
+          template<typename OtherKernelBuilder, typename... Values>
+          void adjoint(OtherKernelBuilder&& kernelToAdjoint, Values&... values);
+       
+          // The constructed kernel is callable
+          void operator()(Args... args);
+          void operator()(void** argsArray);
+
+          // Enable structured bindings
+          template <std::size_t N>
+          decltype(auto) get() {
+            if constexpr (N == 0)
+              return *this;
+            else
+              return arguments[N - 1];
+          }
+      };
+    }
+
+    /// Enable structured bindings on the kernel_builder type.
+    /// auto [kernel, theta, phi] = std::make_kernel<double,double>();
+    namespace std {
+      template <typename... Args> 
+      struct tuple_size<cudaq::kernel_builder<Args...>>
+        : std::integral_constant<std::size_t, sizeof...(Args) + 1> {};
+
+      template <std::size_t N, typename... Args>
+      struct tuple_element<N, cudaq::kernel_builder<Args...>> {
+        using type = std::conditional_t<N == 0, cudaq::kernel_builder<Args...>,
+                                  cudaq::QuakeValue>;
+      };
+    } // namespace std
+
+    namespace cudaq {
+      kernel_builder<> make_kernel();
+      template<typename... Args>
+      kernel_builder<Args...> make_kernel();
+    }
+
+**[3]** The structure above allows one to leverage the provided factory functions (:code:`make_kernel`)
+to construct an empty CUDA-Q kernel with defined argument signature. 
+
+**[4]** For each type in the signature, the programmer is returned a new :code:`Value` instance which 
+can be leveraged in the construction of the kernel. The intended mechanism for 
+kernel creation and argument value extraction is via standard C++ 
+`structured bindings <https://en.cppreference.com/w/cpp/language/structured_binding>`_.
+
+**[5]** Once the kernel is created, the programmer is free to build up the kernel expression 
+using the exposed API. There are methods for qubit allocation, quantum operation 
+invocation, control and adjoint synthesis, and conditional branching based on 
+`boolean` values. 
+
+Here is a simple example how one might build a CUDA-Q kernel dynamically. 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    auto kernel = cudaq::make_kernel();
+    auto qubits = kernel.qalloc(2);
+    kernel.h(qubits[0]);
+    kernel.x<cudaq::ctrl>(qubits[0], qubits[1]);
+    kernel.mz(qubits);
+    
+    // See algorithmic primitives section for more on sample
+    auto counts = cudaq::sample(kernel);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    kernel = cudaq.make_kernel()
+    qubits = kernel.qalloc(2)
+    kernel.h(qubits[0])
+    kernel.cx(qubits[0], qubits[1])
+    kernel.mz(qubits)
+
+Here is an example demonstrating how one may build a dynamic set of 
+CUDA-Q kernels for executing the standard Hadamard test. 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      auto [xPrep, qubitIn] = cudaq::make_kernel<cudaq::qubit>();
+      xPrep.x(qubitIn);
+
+      // Compute <1|X|1> = 0
+      auto hadamardTest = cudaq::make_kernel();
+      auto q = hadamardTest.qalloc();
+      auto ancilla = hadamardTest.qalloc();
+      hadamardTest.call(xPrep, q);
+      hadamardTest.h(ancilla);
+      hadamardTest.control(xPrep, ancilla, q);
+      hadamardTest.h(ancilla);
+      hadamardTest.mz(ancilla);
+
+      // See algorithmic primitives section for more on sample
+      auto counts = cudaq::sample(hadamardTest);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    xPrep, qubitIn = cudaq.make_kernel(cudaq.qubit)
+
+    # Compute <1|X|1> = 0
+    hadamardTest = cudaq.make_kernel()
+    q = hadamardTest.qalloc()
+    hadamardTest.call(xPrep, q)
+    hadamardTest.h(ancilla)
+    hadamardTest.control(xPrep, ancilla, q)
+    hadamardTest.h(ancilla)
+    hadamardTest.mz(ancilla)
+
+    # See algorithmic primitives section for more on sample
+    counts = cudaq.sample(hadamardTest)
diff --git a/pr-2241/sphinx/specification/cudaq/examples.rst b/pr-2241/sphinx/specification/cudaq/examples.rst
new file mode 100644
index 0000000000..9cc490e035
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/examples.rst
@@ -0,0 +1,270 @@
+
+Example Programs
+****************
+Hello World - Simple Bell State
+-------------------------------
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      #include <cudaq.h>
+
+      struct bell {
+        int operator()(int num_iters) __qpu__ {
+          cudaq::qarray<2> q;
+          int nCorrect = 0;
+          for (int i = 0; i < num_iters; i++) {
+            h(q[0]);
+            x<cudaq::ctrl>(q[0], q[1]);
+            auto results = mz(q);
+            if (results[0] == results[1]) 
+              nCorrect++;
+            
+            reset(q[0]);
+            reset(q[1]);
+          }
+          return nCorrect;
+        }
+      };
+
+      int main() { printf("N Correct = %d\n", bell{}(100)); }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq 
+
+    @cudaq.kernel()
+    def bell(num_iters : int) -> int:
+        q = cudaq.qvector(2)
+        nCorrect = 0
+        for i in range(num_iters):
+            h(q[0])
+            x.ctrl(q[0], q[1])
+            results = mz(q)
+            if results[0] == results[1]:
+               nCorrect = nCorrect + 1
+            
+            reset(q)
+        return nCorrect 
+
+    counts = bell(100)
+    print(f'N Correct = {counts}')
+    assert counts == 100
+
+GHZ State Preparation and Sampling
+----------------------------------
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+  
+      #include <cudaq.h>
+
+      __qpu__ ghz(const int n_qubits) {
+        cudaq::qvector q(n_qubits);
+        h(q[0]);
+        for (int i = 0; i < n_qubits - 1; ++i) 
+          // note use of ctrl modifier
+          x<cudaq::ctrl>(q[i], q[i+1]); 
+        
+        mz(q);
+      }
+
+      int main() {
+        // Sample the state produced by the ghz kernel
+        auto counts = cudaq::sample(ghz, 10);
+        for (auto [bits, count] : counts) {
+          printf("Observed %s %lu times.\n", bits.c_str(), count);
+        }
+        return 0;
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq 
+    
+    @cudaq.kernel
+    def ghz(numQubits:int):
+        qubits = cudaq.qvector(numQubits)
+        h(qubits.front())
+        for i, qubit in enumerate(qubits.front(numQubits - 1)):
+            x.ctrl(qubit, qubits[i + 1])
+    
+    counts = cudaq.sample(ghz, 10)
+    for bits, count : counts:
+        print('Observed {} {} times.'.format(bits, count))
+
+Quantum Phase Estimation
+------------------------
+
+.. tab:: C++ 
+
+  .. literalinclude:: ../../examples/cpp/algorithms/phase_estimation.cpp
+      :language: cpp
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq, numpy as np
+
+    # Compute phase for U |psi> = exp(-2 pi phase) |psi> 
+    # This example will consider U = T, and |psi> = |1>
+    # Define a Inverse Quantum Fourier Transform kernel
+    @cudaq.kernel
+    def iqft(qubits: cudaq.qview):
+        N = qubits.size()
+        for i in range(N // 2):
+            swap(qubits[i], qubits[N - i - 1])
+
+        for i in range(N - 1):
+            h(qubits[i])
+            j = i + 1
+            for y in range(i, -1, -1):
+                r1.ctrl(-np.pi / 2**(j - y), qubits[j], qubits[y])
+
+        h(qubits[N - 1])
+
+
+    # Define the U kernel
+    @cudaq.kernel
+    def tGate(qubit: cudaq.qubit):
+        t(qubit)
+
+
+    # Define the state preparation |psi> kernel
+    @cudaq.kernel
+    def xGate(qubit: cudaq.qubit):
+        x(qubit)
+
+    # General Phase Estimation kernel for single qubit 
+    # eigen states. 
+    @cudaq.kernel
+    def qpe(nC: int, nQ: int, statePrep: Callable[[cudaq.qubit], None],
+            oracle: Callable[[cudaq.qubit], None]):
+        q = cudaq.qvector(nC + nQ)
+        countingQubits = q.front(nC)
+        stateRegister = q.back()
+        statePrep(stateRegister)
+        h(countingQubits)
+        for i in range(nC):
+            for j in range(2**i):
+                cudaq.control(oracle, [countingQubits[i]], stateRegister)
+        iqft(countingQubits)
+        mz(countingQubits)
+
+    # Sample the state to get the phase. 
+    counts = cudaq.sample(qpe, 3, 1, xGate, tGate)
+    assert len(counts) == 1
+    assert '100' in counts
+
+
+Deuteron Binding Energy Parameter Sweep
+---------------------------------------
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+      #include <cudaq.h>
+
+      struct deuteron_n2_ansatz {
+        void operator()(double theta) __qpu__ {
+          cudaq::qarray<2> q;
+          x(q[0]);
+          ry(theta, q[1]);
+          x<cudaq::ctrl>(q[1], q[0]);
+        }
+      };
+
+      int main() {
+        using namespace cudaq::spin;
+        cudaq::spin_op h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) +
+                    .21829 * z(0) - 6.125 * z(1);
+    
+        // Perform parameter sweep for deuteron N=2 Hamiltonian
+        const auto param_space = cudaq::linspace(-M_PI, M_PI, 25);
+        for (const auto& param : param_space) {
+          // KERNEL::observe(...) <==> 
+          // E(params...) = <psi(params...) | H | psi(params...)>
+          double energy_at_param = cudaq::observe(deuteron_n2_ansatz{}, h, param);
+          printf("<H>(%lf) = %lf\n", param, energy_at_param);
+        }
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    import cudaq 
+    from cudaq import spin 
+
+    @cudaq.kernel
+    def ansatz(angle:float):
+        q = cudaq.qvector(2)
+        x(q[0])
+        ry(angle, q[1])
+        x.ctrl(q[1], q[0])
+
+    hamiltonian = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(
+        0) * spin.y(1) + .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+    # Perform parameter sweep for deuteron N=2 Hamiltonian
+    for angle in np.linspace(-np.pi, np.pi, 25):
+         # KERNEL::observe(...) <==> 
+         # E(params...) = <psi(params...) | H | psi(params...)>
+         energyAtParam = cudaq.observe(ansatz, hamiltonian, .59)
+         print('<H>({}) = {}'.format(angle, energyAtParam))
+
+
+Grover's Algorithm
+------------------
+
+.. tab:: C++ 
+
+  .. literalinclude:: ../../examples/cpp/algorithms/grover.cpp
+      :language: cpp
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel 
+    def reflect(qubits: cudaq.qview):
+        ctrls = qubits.front(qubits.size() - 1)
+        last = qubits.back()
+        cudaq.compute_action(lambda: (h(qubits), x(qubits)),
+                              lambda: z.ctrl(ctrls, last))
+
+    @cudaq.kernel
+    def oracle(q: cudaq.qview):
+        z.ctrl(q[0], q[2])
+        z.ctrl(q[1], q[2])
+
+    @cudaq.kernel
+    def grover(N: int, M: int, oracle: Callable[[cudaq.qview], None]):
+        q = cudaq.qvector(N)
+        h(q)
+        for i in range(M):
+            oracle(q)
+            reflect(q)
+        mz(q)
+
+    counts = cudaq.sample(grover, 3, 1, oracle)
+    assert len(counts) == 2
+    assert '101' in counts
+    assert '011' in counts
+
+
+Iterative Phase Estimation
+--------------------------
+
+.. literalinclude:: ../../examples/cpp/other/iterative_qpe.cpp
+    :language: cpp
+    :start-after: [Begin Documentation]
+    :end-before: [End Documentation]
diff --git a/pr-2241/sphinx/specification/cudaq/kernels.rst b/pr-2241/sphinx/specification/cudaq/kernels.rst
new file mode 100644
index 0000000000..b9da04496a
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/kernels.rst
@@ -0,0 +1,362 @@
+Quantum Kernels
+***************
+**[1]** To differentiate between host and quantum device code, the CUDA-Q programming
+model defines the concept of a **quantum kernel**. A quantum kernel is any callable 
+in C++ annotated to indicate compilation and execution on an available quantum coprocessor. 
+
+**[2]** All quantum kernels must be annotated to indicate they are to be compiled for, and executed
+on, a specified quantum coprocessor. CUDA-Q requires the :code:`__qpu__` function
+attribute for quantum kernel declarations. Other language bindings may opt to use other language 
+features to enable function annotation or decoration (e.g. a :code:`@cudaq.kernel()` function 
+decorator in Python). 
+
+**[3]** CUDA-Q specifically differentiates between kernels invoked from host code and those invoked
+from within another quantum kernel. The former are denoted **entry-point**
+quantum kernels, the latter are **pure device** quantum kernels. Entry point kernels can 
+only take classical types as input and return classical output. Pure-device kernels 
+can take quantum types as input.
+
+.. tab:: C++ 
+  
+  .. code-block:: cpp
+  
+      // Entry point lambda kernel
+      auto my_first_entry_point_kernel = [](double x) __qpu__ { ... quantum code ... };
+      
+      // Entry point typed callable kernel
+      struct my_second_entry_point_kernel { 
+        void operator()(double x, std::vector<double> params) __qpu__ { 
+          ... quantum code ...
+        }
+      };
+
+      // Pure device free function kernel
+      __qpu__ void my_first_pure_device_kernel(cudaq::qview<> qubits) {
+         ... quantum code ... 
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def my_first_entry_point_kernel(x : float):
+       ... quantum code ... 
+    
+    @cudaq.kernel()
+    def my_second_entry_point_kernel(x : float, params : list[float]):
+       ... quantum code ... 
+
+    @cudaq.kernel()
+    def my_first_pure_device_kernel(qubits : cudaq.qview):
+       ... quantum code ... 
+    
+**[4]** Quantum kernel function bodies are programmed in a subset of the parent classical language. 
+Kernels can be composed of the following: 
+
+  * Quantum intrinsic operations and measurements
+  * In-scope kernel calls with or without any kernel modifiers (e.g. :code:`cudaq::control`)
+  * Classical control flow constructs from the classical language (:code:`if`, :code:`for`, :code:`while`, etc.)
+  * Stack variable declarations for supported types. 
+  * Arithmetic operations on integer and floating point stack variables
+  * Coherent conditional execution - :code:`if ( boolExprFromQubitMeasurement ) { x (another_qubit); }` 
+  * Syntax for common quantum programming patterns (e.g. compute-action-uncompute).
+
+
+**[5]** CUDA-Q defines a set of allowed types that can be leveraged in quantum kernel 
+function signatures (input and return types), in-function variable declaration or construction, 
+and in variable capture from parent scope. 
+
+The allowed types are as follows: 
+
+  * :code:`T` such that :code:`std::is_arithmetic_v<T> == true`
+  * :code:`std::vector<T>` such that :code:`std::is_arithmetic_v<T> == true`
+  * :code:`std::span<T>` such that :code:`std::is_arithmetic_v<T> == true`
+  * :code:`std::vector<V>` such that type :code:`V` is a valid :code:`std::vector<T>` (possibly recursively)
+  * :code:`struct` types composed of any valid CUDA-Q type.
+  * :code:`std::tuple<Ts...>` such that T is any allowed type.
+  * :code:`std::pair<T,U>` such that T is any allowed type.
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+    struct MyCustomSimpleStruct {
+       int i = 0;
+       int j = 0;
+       std::vector<double> angles;
+    }; 
+
+    // Valid CUDA-Q Types used in Kernels
+    auto kernel = [](int N, bool flag, float angle, std::vector<std::size_t> layers,
+             std::vector<double> parameters, std::vector<std::vector<float>> recursiveVec, 
+             MyCustomSimpleStruct var) __qpu__ { ... }
+    
+    __qpu__ double kernelThatReturns() { 
+       ... 
+       return M_PI_2;
+    }
+    
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    class MySimpleStruct(object):
+        def __init__(self):
+            self.i = 0 
+            self.j = 0
+
+    @cudaq.kernel
+    def kernel(N : int, flag : bool, angle : float, layers : list[int], 
+                parameters : list[float], recursiveList : list[list[float]], 
+                var : MySimpleStruct): ... 
+    
+    @cudaq.kernel 
+    def kernelThatReturns() -> float:
+        ... 
+        return np.pi / 2.0
+
+**[6]** Any variable with an allowed CUDA-Q type can be allocated on the stack within 
+CUDA-Q kernels. Variables of type :code:`std::vector<T>` for any allowed type 
+:code:`T` can only be constructed with known size. Vector-like variables cannot be 
+default constructed and later filled with type :code:`T` data (i.e. no dynamic memory allocation). 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+    // Valid CUDA-Q Types used in Kernels
+    auto kernel = []() __qpu__ {
+      
+      // Not Allowed. 
+      // std::vector<int> i; 
+      // i.push_back(1);
+
+      // Valid variable declarations
+
+      std::vector<int> i(5);
+      i[2] = 3; 
+
+      std::vector<float> f {1.0, 2.0, 3.0};
+
+      int k = 0;
+
+      double pi = 3.1415926
+    };
+    
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel
+    def kernel(): 
+       # Not Allowed 
+       # i = [] 
+       # i.append(1)
+
+       i = [0 for k in range(5)]
+       i[2] = 3 
+
+       f = [1., 2., 3.]
+
+       k = 0 
+
+       pi = 3.1415926
+
+**[7]** All entry-point kernel arguments adhere to pass-by-value semantics. 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    auto kernel = [](int i, std::vector<double> v) __qpu__ {
+       // i == 2, allocate 2 qubits 
+       cudaq::qvector q(i); 
+       // v[1] == 2.0, angle here is 2.0
+       ry(v[1], q[0]);
+
+       // Change the variables, caller does not see this
+       i = 5; 
+       v[0] = 3.0;
+    };
+
+    int k = 2;
+    std::vector<double> d {1.0, 2.0};
+    
+    kernel(k, d);
+
+    // k is still 2, pass by value 
+    // d is still {1.0, 2.0}, pass by value 
+  
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel 
+    def kernel(i : int, v : list[float]): 
+        # i = 2, allocate 2 qubits 
+        q = cudaq.qvector(i)
+        # v[1] == 2.0, angle here is 2.0 
+        ry(v[1], q[0])
+
+        # Change the variables, caller does not see this 
+        i = 5 
+        v[0] = 3.0 
+
+    k, d = 2, [1., 2.]
+    kernel(i, d)
+
+    # k is still 2, pass by value 
+    # d is still {1.0, 2.0}, pass by value 
+
+
+.. FIXME Pass by value vs reference, should we mandate pass by reference for inter-kernel calls
+
+**[8]** CUDA-Q kernel lambdas in C++ can capture variables of allowed type 
+by value. CUDA-Q kernels defined as custom callable types can define non-reference type 
+class members of any allowed type. These member variables can be set with 
+pass-by-value semantics at kernel construction. 
+
+.. tab:: C++ 
+
+  .. code-block:: C++ 
+
+    struct kernel {
+      int i; 
+      float f; 
+
+      void operator()() __qpu__ {
+         cudaq::qvector q(i); 
+         ry(f, q[0]);
+      }
+    };
+
+    kernel{2, 2.2}();
+
+    int i = 2; 
+    double f = 2.2;
+
+    auto kernelLambda = [=]() __qpu__ {
+      // Use captured variables 
+      cudaq::qvector q(i); 
+      ry(f, q[0]);
+      i = 5; 
+      return i; 
+    };
+
+    auto k = kernelLambda(); 
+
+    // Pass by value semantics 
+    assert(k != i);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    i = 2 
+    f = np.pi / 2. 
+
+    @cudaq.kernel
+    def kernel() -> int:
+       # Use captured variables 
+       q = cudaq.qvector(i) 
+       ry(f, q[0])
+
+       i = 5 
+       return i 
+    
+    k = kernel() 
+
+    # Pass by value semantics 
+    assert k != i 
+
+**[9]** All quantum kernel invocations are synchronous calls by default. 
+
+**[10]** CUDA-Q kernels can serve as input to other quantum kernels and invoked by kernel 
+function body code. To support CUDA-Q kernel parameterization on callable quantum kernel 
+code, programmers can leverage standard C++ template definitions or dynamic typing in language bindings such as Python:
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+      __qpu__ void MyStatePrep(cudaq::qview<> qubits) {
+          ... apply state prep operations on qubits ...
+      }
+
+      struct MyGenericAlgorithm {
+        template<typename StatePrep>
+        void operator()(const StatePrep& statePrep) __qpu__ {
+          cudaq::qarray<10> q;
+          statePrep(q);
+          ...
+        }
+      };
+
+      // -or- with placeholder type specifiers
+      struct MyGenericAlgorithm2 {
+        void operator()(const auto& statePrep) __qpu__ {
+          cudaq::qarray<10> q;
+          statePrep(q);
+          ...
+        }
+      };
+
+      void callKernels() {
+
+        MyGenericAlgorithm algorithm;
+        algorithm(MyStatePrep);
+
+        MyGenericAlgorithm2 anotherVersion;
+        anotherVersion(MyStatePrep);
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def MyStatePrep(qubits : cudaq.qview):
+        ... apply state prep operations on qubits ... 
+    
+    @cudaq.kernel()
+    def MyGenericAlgorithm(statePrep : typing.Callable[[cudaq.qview], None]):
+        q = cudaq.qvector(10)
+        statePrep(q)
+        ...
+    
+    MyGenericAlgorithm(MyStatePrep)
+
+CUDA-Q kernel inputs can also be `constrained <https://en.cppreference.com/w/cpp/language/constraints>`_. 
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+
+      // Generic constraint on Kernel Function Signatures
+      template <typename Kernel, typename Signature>
+      concept signature = std::is_convertible_v<Kernel, std::function<Signature>>; 
+
+      // Specialized for taking a single qubit
+      template<typename Kernel>
+      concept takes_qubit = signature<Kernel, void(qubit&)>;
+    }
+
+    struct MyGenericAlgorithmOnQarray {
+      void operator()(cudaq::signature<void(cudaq::qarray&)> auto&& statePrep) __qpu__ {
+        cudaq::qarray<10> q;
+        statePrep(q);
+        ...
+      }
+    };
+
+    struct MyGenericAlgorithmOnQubit {
+      void operator()(cudaq::takes_qubit auto&& statePrep) __qpu__ {
+        cudaq::qarray<10> q;
+        statePrep(q[0]);
+        ...
+      }
+    };
+
+This approach enables the development of generic libraries of quantum 
+algorithms that are parameterized on sub-units of the global circuit representation. 
diff --git a/pr-2241/sphinx/specification/cudaq/machine_model.rst b/pr-2241/sphinx/specification/cudaq/machine_model.rst
new file mode 100644
index 0000000000..e2389c6dfc
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/machine_model.rst
@@ -0,0 +1,59 @@
+Machine Model
+*************
+
+.. role:: raw-html(raw)
+    :format: html 
+
+:raw-html:`<a name="mm1"></a>`
+
+**[1]** CUDA-Q presumes the existence of one or more classical host processors, 
+zero or more NVIDIA graphics processing units (GPUs), and zero or more quantum processing units (QPUs). 
+
+**[2]** Each QPU is composed of a classical quantum control system (distributed FPGAs, GPUs, etc.) 
+and a register of quantum bits (qubits) whose state evolves via signals from the classical control system.
+
+**[3]** The machine model allows for three modes of quantum process parallelism: concurrent execution
+of quantum circuits on independent QPUs, dependent quantum parallelism via
+quantum message passing and inter-QPU entanglement, and QPU thread-level
+parallelism or the ability for concurrent execution of independent quantum
+circuits on a single QPU qubit connectivity fabric. 
+
+**[4]** The model assumes a
+classical memory space for the host processor which inherits the native language memory
+model semantics (e.g. C++ or Python). 
+
+**[5]** The model assumes a classical memory space for each control
+system driving the evolution of the multi-qubit state. This control system
+memory space should enable primitive arithmetic variable declarations,
+stores, and loads, as well as qubit measurement persistence and loading
+for fast-feedback and conditional circuit execution. 
+
+**[6]** The quantum memory
+space on an individual QPU is modeled as an infinite register of 
+qubits and physical connectivity constraints are hidden from the
+programmer. Note that compiler implementations of the CUDA-Q model
+are free to enable developer access to the details of the QPU
+qubit connectivity for the purpose of developing novel placement strategies. 
+
+**[7]** CUDA-Q considers general :math:`D`-level quantum information systems, e.g. qudits. Qudits
+are non-copyable, and can be allocated in chunks, via instantiation of 
+user-level quantum container types. Quantum containers come in two flavors - 
+quantum memory owning and non-owning (views). Moreover, the size of a quantum container 
+can be specified at either compile-time or dynamically at runtime. 
+As all qudits are non-copyable, qudits and containers 
+thereof can only be passed by reference. 
+
+**[8]** Each allocated qudit is unique and if  
+deallocated, is available for subsequent allocation. Deallocation occurs implicitly
+when the qudit goes out of scope. Uncomputation of qudit state should occur 
+automatically via compiler implementations of the CUDA-Q model.
+
+**[9]** The CUDA-Q model considers both remotely hosted QPU execution models as well as
+tightly-coupled quantum-classical architectures. Remotely hosted models
+support batch circuit execution where each circuit may contain simple
+quantum-classical operation integration. Tightly-coupled execution models provide
+streaming instruction execution, measure-reset, and fast-feedback of
+qubit measurement results. This multi-modal execution model directly
+influences the syntax and semantics of quantum kernel expressions
+and their associated host-code context. 
+
diff --git a/pr-2241/sphinx/specification/cudaq/namespace.rst b/pr-2241/sphinx/specification/cudaq/namespace.rst
new file mode 100644
index 0000000000..f20c0c8b94
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/namespace.rst
@@ -0,0 +1,11 @@
+Namespace and Standard
+**********************
+
+**[1]** The CUDA-Q language is a library-based extension for C++. As such, all
+pertinent data structures and library functions exist within the CUDA-Q
+namespace. This namespace is denoted :code:`::cudaq`. 
+
+**[2]** CUDA-Q is a C++ library-based language extension adherent to the `C++20 <https://en.cppreference.com/w/cpp/20>`_
+language specification. Any implementations that require backwards compatibility to previous 
+standards must retain the semantics of the user-facing API (e.g. `SFINAE <https://en.cppreference.com/w/cpp/language/sfinae>`_ 
+instead of `concepts and constraints <https://en.cppreference.com/w/cpp/language/constraints>`_).
\ No newline at end of file
diff --git a/pr-2241/sphinx/specification/cudaq/operations.rst b/pr-2241/sphinx/specification/cudaq/operations.rst
new file mode 100644
index 0000000000..09497945f3
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/operations.rst
@@ -0,0 +1,127 @@
+Quantum Intrinsic Operations
+****************************
+**[1]** To support low-level quantum programming and build foundational
+quantum kernels for large-scale applications, CUDA-Q specifies the *quantum
+intrinsic operation* abstraction for device-specific single-qudit unitary operations. 
+
+**[2]** A quantum intrinsic operation is modeled via a standard free function in the native classical language. It 
+has a unique instruction name and general specified function operands. 
+
+**[3]** These operands can model classical rotation parameters or units of quantum information (e.g. the :code:`cudaq::qudit`).
+The syntax for these operations is 
+
+.. code-block:: cpp 
+
+    void INST_NAME( PARAM...?, cudaq::qudit<N>&...);
+
+where :code:`INST_NAME` is the name of the instruction, :code:`qudit<N>&...` indicates one many
+:code:`cudaq::qudit` instances, and :code:`PARAM...?` indicates optional parameters of 
+floating point type (e.g. :code:`double`, :code:`float`). Quantum intrinsic operations return :code:`void`.
+
+**[4]** All intrinsic operations should start with a base declaration targeting a single :code:`cudaq::qudit`, and overloads
+should be provided that take more than one :code:`cudaq::qudit` instances to model the application
+of that instruction on all provided :code:`cudaq::qudits`, e.g. :code:`void x(cudaq::qubit&)` and
+:code:`x(cudaq::qubit&, cudaq::qubit&, cudaq::qubit&)`, modeling the NOT operation on a single 
+:code:`cudaq::qubit` or on multiple :code:`cudaq::qubit`. 
+
+**[5]** The specific set of quantum intrinsic operations available to the programmer can 
+be platform specific and provided via platform specific header files. 
+
+**[6]** Implementations should provide overloads to support broadcasting of single-qubit
+intrinsic operations across containers of :code:`cudaq::qudit`. For example,
+:code:`x(cudaq::qvector<>&)` should apply a NOT operation on all
+:code:`cudaq::qubit` in the provided :code:`cudaq::qvector`. 
+
+**[7]** Programmers can further modify quantum intrinsic operations via 
+an extra specified template parameter, and CUDA-Q leverages this syntax 
+for synthesizing control and adjoint variants of the operation. Specifically CUDA-Q 
+provides the `cudaq::ctrl`, and `cudaq::adj` type modifiers for synthesizing control and 
+adjoint forms of the operation. For language bindings that do not support template 
+parameterization, implementations may rely on static method calls (e.g. :code:`x.ctrl(q, r)`)
+
+Here is an example of how one might modify an intrinsic operation for multi-control and adjoint operations.
+
+.. tab:: C++ 
+  
+  .. code-block:: cpp 
+
+    cudaq::qubit q, r, s;
+    // Apply T operation
+    t(q);
+    // Apply Tdg operation
+    t<cudaq::adj>(q);
+    // Apply control Hadamard operation
+    h<cudaq::ctrl>(q,r,s);
+    // Error, ctrl requires > 1 qubit operands
+    // h<cudaq::ctrl>(r);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    q, r, s = cudaq.qubit(), cudaq.qubit(), cudaq.qubit()
+    # Apply T operation
+    t(q)
+    # Apply Tdg operation
+    t.adj(q)
+    # Apply control Hadamard operation
+    h.ctrl(q,r,s)
+    # Error, ctrl requires > 1 qubit operands
+    # h.ctrl(r);
+
+Operations on :code:`cudaq::qubit`
+----------------------------------
+The default set of quantum intrinsic operations for the cudaq::qubit type is as follows: 
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      struct base;
+      struct ctrl;
+      struct adj;
+  
+      // Single qubit operations, ctrl / adj variants, and broadcasting
+      template<typename mod = base, typename... QubitArgs>
+      void NAME(QubitArgs&... args) noexcept { ... }
+  
+      template<typename mod = base>
+      void NAME(const qvector& qr) noexcept { ... }
+  
+      template<typename mod = ctrl>
+      void NAME(qvector& ctrls, qubit& target) noexcept { ... }
+ 
+      // Single qubit rotation operations and ctrl / adj variants
+      template <typename mod = base, typename ScalarAngle, typename... QubitArgs> 
+      void ROTATION_NAME(ScalarAngle angle, QubitArgs &...args) noexcept { ... }
+ 
+      bool MEASURE_OP(qubit &q) noexcept;
+      std::vector<bool> MEASURE_OP(qvector &q) noexcept;
+      double measure(cudaq::spin_op & term) noexcept { ... }
+  }
+
+**[1]** For the default implementation of the :code:`cudaq::qubit` intrinsic operations, we let 
+NAME be any operation name in the set :code:`{h, x, y, z, t, s}` and :code:`ROTATION_NAME` be any 
+operation in :code:`{rx, ry, rz, r1 (phase)}`. Implementations may provide appropriate 
+function implementations using the above foundational functions to enable other 
+common operations (e.g. :code:`cnot -> x<cudaq::ctrl>`).
+
+**[2]** Control qubits can be specified with positive or negative polarity. 
+By this we mean that a control qubit can specify that a target operation is 
+applied if the control qubit state is a :code:`|0>` (positive polarity) or :code:`|1>` (negative polarity). 
+By default all control qubits are assumed to convey positive polarity. The 
+syntax for negating the polarity is the not operator preceding the control 
+qubit 
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    x<cudaq::ctrl>(!q, r);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    x.ctrl(~q, r)
+  
+The set of gates that the official CUDA-Q implementation supports can be found in the :doc:`API documentation </api/api>`.
diff --git a/pr-2241/sphinx/specification/cudaq/operators.rst b/pr-2241/sphinx/specification/cudaq/operators.rst
new file mode 100644
index 0000000000..2645b861fe
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/operators.rst
@@ -0,0 +1,81 @@
+Quantum Operators
+*****************
+
+:code:`cudaq::spin_op`
+----------------------
+**[1]** CUDA-Q provides a native :code:`spin_op` data type in the :code:`cudaq` namespace for the
+expression of quantum mechanical spin operators. 
+
+**[2]** The :code:`spin_op` provides an abstraction for a general tensor product of Pauli
+spin operators, and sums thereof:
+
+.. math:: 
+
+    H = \sum_{i=0}^M P_i, P_i = \prod_{j=0}^N \sigma_j^a
+
+for :math:`a = {x,y,z}`, :math:`j` the qubit index, and :math:`N` the number of qubits.
+
+**[3]** The :code:`spin_op` exposes common C++ operator overloads for algebraic expressions. 
+
+**[4]** CUDA-Q defines convenience functions in :code:`cudaq::spin` namespace that produce
+the primitive X, Y, and Z Pauli operators on specified qubit indices
+which can subsequently be used in algebraic expressions to build up
+more complicated Pauli tensor products and their sums.
+
+.. tab:: C++ 
+
+    .. code-block:: cpp
+
+        using namespace cudaq::spin;
+        auto h = 5.907 - 2.1433 * x(0) * x(1) - 2.1433 * y(0) * y(1) + \
+                 .21829 * z(0) - 6.125 * z(1);
+
+.. tab:: Python
+
+    .. code-block:: python 
+
+        from cudaq import spin 
+        h = 5.907 - 2.1433 * spin.x(0) * spin.x(1) - 2.1433 * spin.y(0) * spin.y(1) + \
+                 .21829 * spin.z(0) - 6.125 * spin.z(1)
+
+
+**[5]** The :code:`spin_op` also provides a mechanism for the expression of circuit
+synthesis tasks within quantum kernel code. Specifically, operations
+that encode :math:`N`\ :sup:`th`\ order trotterization of exponentiated :code:`spin_op`
+rotations, e.g. :math:`U = \exp(-i H t)`, where :math:`H` is the provided :code:`spin_op`.
+
+**[6]** The :code:`spin_op` can be created within classical host code and quantum kernel
+code, and can also be passed by value to quantum kernel code from host code. 
+
+The :code:`spin_op` should take on the following structure: 
+
+.. code-block:: cpp
+
+    namespace cudaq {
+    class spin_op {
+      public:
+        spin_op();
+        spin_op(const spin_op&);
+        bool empty() const;
+        std::size_t num_qubits() const;
+        std::size_t num_terms() const;
+        std::complex<double> get_coefficient();
+        bool is_identity() const;
+        void for_each_term(std::function<void(spin_op &)> &&) const;
+        void for_each_pauli(std::function<void(pauli, std::size_t)> &&) const;
+        spin_op& operator=(const spin_op&);
+        spin_op& operator+=(const spin_op&);
+        spin_op& operator-=(const spin_op&);
+        spin_op& operator*=(const spin_op&);
+        bool operator==(const spin_op&);
+        spin_op& operator*=(const double);
+        spin_op& operator*=(const std::complex<double>)
+    };
+
+    namespace spin {
+      spin_op x(const std::size_t);
+      spin_op y(const std::size_t);
+      spin_op z(const std::size_t);
+    }
+  }
+
diff --git a/pr-2241/sphinx/specification/cudaq/patterns.rst b/pr-2241/sphinx/specification/cudaq/patterns.rst
new file mode 100644
index 0000000000..0f96c164b6
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/patterns.rst
@@ -0,0 +1,50 @@
+
+Common Quantum Programming Patterns
+***********************************
+
+Compute-Action-Uncompute
+------------------------
+**[1]** CUDA-Q specifies syntax and semantics to support the compute-action-uncompute
+pattern, :math:`W = U V U \dagger` (here :math:`U` is the compute block, and :math:`V` is the action block).
+
+**[2]** Via special syntax for this pattern CUDA-Q enables compiler implementations to 
+key on circuit optimizations via programmer intent. Specifically, controlled versions of :math:`W` do not produce controlled
+operations of all instructions in :math:`U`, :math:`V`, and :math:`U \dagger`, but instead we are free to only
+control :math:`V`. 
+
+**[3]** The CUDA-Q specification requires the following syntax for this pattern:
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      // Will invoke U V U^dag
+      cudaq::compute_action (
+          [&](){ 
+            /*U_code*/ 
+          }, 
+          [&]() { 
+            /*V_code*/ 
+          } 
+      ); 
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    def computeF():
+       ... 
+    
+    def actionF():
+       ...
+
+    # Can take user-defined functions
+    cudaq.compute_action(computeF, actionF)
+
+    # Can take Pythonic CUDA-Q lambda kernels
+    computeL = lambda : (h(q), x(q), ry(-np.pi, q[0]))
+    cudaq.compute_action(computeL, actionF)
+
+
+**[4]** Compiler implementations must add the uncompute segment
+and optimize on any controlled versions of this block of code. 
\ No newline at end of file
diff --git a/pr-2241/sphinx/specification/cudaq/platform.rst b/pr-2241/sphinx/specification/cudaq/platform.rst
new file mode 100644
index 0000000000..fc44e7f12f
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/platform.rst
@@ -0,0 +1,54 @@
+
+Quantum Platform
+****************
+
+**[1]** CUDA-Q provides an abstraction describing the underlying quantum computing resource(s). 
+The underlying quantum platform can contain one or many quantum processing units (QPUs) each with 
+its own qubit connectivity and noise configuration.
+
+**[2]** CUDA-Q defines a :code:`cudaq::quantum_platform` in an effort to expose relevant system 
+information and enable asynchronous quantum kernel invocations.
+
+**[3]** The :code:`cudaq::quantum_platform` provides an API for querying the number of available 
+quantum processing units (QPUs), with each QPU assigned a logical integer index (:code:`{0,1,2,...}`). 
+
+**[4]** Programmers can specify the ID of the desired QPU and all subsequent CUDA-Q 
+kernel executions will target that QPU.
+
+The :code:`cudaq::quantum_platform`  should take the following structure
+
+.. code-block:: cpp
+
+  namespace cudaq {
+    class quantum_platform {
+    public:
+      quantum_platform();
+      ~quantum_platform();
+ 
+      using QubitEdge = std::pair<std::size_t, std::size_t>;
+      using QubitConnectivity = std::vector<QubitEdge>;
+      std::optional<QubitConnectivity> connectivity();
+
+      std::size_t num_qpus() const;
+      std::size_t get_num_qubits(std::size_t qpu_id = 0) const;
+ 
+      bool is_simulator(std::size_t qpu_id = 0) const;
+      bool is_remote(std::size_t qpuId = 0);
+      bool is_emulated(std::size_t qpuId = 0) const;
+      std::string name() const;
+ 
+      std::size_t get_current_qpu() const ;
+      void set_current_qpu(const std::size_t device_id);
+
+    };
+  }
+
+CUDA-Q provides the following public functions to interact with the current
+:code:`cudaq::quantum_platform`
+
+.. code-block:: cpp
+
+  namespace cudaq {
+    quantum_platform &get_platform() ;
+  }
+
diff --git a/pr-2241/sphinx/specification/cudaq/synthesis.rst b/pr-2241/sphinx/specification/cudaq/synthesis.rst
new file mode 100644
index 0000000000..038151ab8d
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/synthesis.rst
@@ -0,0 +1,106 @@
+Sub-circuit Synthesis
+*********************
+**[1]** Execution of pure device quantum kernels can be modified via explicit intrinsic
+library calls that provide multi-qubit controlled application and adjoint,
+or circuit reversal, semantics. 
+
+**[2]** CUDA-Q defines the following library functions
+for enabling multi-controlled and adjoint operations on a general pure
+device kernel:
+
+.. code-block:: cpp
+
+    template <typename QuantumKernel, typename... Args>
+    void control(QuantumKernel &&kernel,
+                 cudaq::qubit& ctrl_qubit, Args &... args);
+ 
+    template <typename QuantumKernel, typename QuantumRegister, typename... Args>
+      requires(std::ranges::range<QuantumRegister>)
+    void control(QuantumKernel &&kernel,
+                 QuantumRegister& ctrl_qubits, Args &... args);
+ 
+    template <typename QuantumKernel, typename... Args>
+    void adjoint(QuantumKernel &&kernel, Args &... args);
+
+These functions can be leveraged in quantum kernel code in the following way
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      __qpu__ void x_gate(cudaq::qubit& q) { x(q); }
+      
+      struct kernel {
+        void operator() () __qpu__ {
+          cudaq::qarray<3> q;
+          ...
+          // Create Toffoli gate
+          auto ctrl_bits = q.front(2);
+          cudaq::control(x_gate, ctrl_bits, q[2]);
+          ...
+        }
+      };
+      
+      void rx_and_h_gate(double x, cudaq::qubit& q) __qpu__ { rx(x,q); h(q); }
+      
+      __qpu__ kernel(int N) {
+        cudaq::qvector q(N);
+        ...
+        // apply h(q[2]); rx(-pi, q[2]);
+        cudaq::adjoint(rx_and_h_gate{}, M_PI, q[2]);
+        ...
+      }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    @cudaq.kernel()
+    def x_gate(q : cudaq.qubit):
+        x(q)
+    
+    @cudaq.kernel()
+    def kernelTestControl():
+        q = cudaq.qvector(3)
+        ...
+        ctrl_bits = q.front(2)
+        cudaq.control(x_gate, ctrl_bits, q[2])
+        ...
+    
+    @cudaq.kernel()
+    def rx_and_h_gate(x : float, q : cudaq.qubit):
+        rx(x, q)
+        h(q)
+    
+    @cudaq.kernel()
+    def kernelTestAdjoint(N : int):
+        q = cudaq.qvector(N)
+        ...
+        # apply h(q[2]); rx(-pi, q[2])
+        cudaq.adjoint(rx_and_h_gate, np.pi, q[2])
+        ...
+
+
+**[3]** The :code:`cudaq::control(...)` function takes as input an instantiated pure
+device quantum kernel, a std::range of control qubits (:code:`cudaq::qvector`
+or :code:`cudaq::qview`), and the remaining arguments for the kernel itself.
+
+**[4]** Compiler implementations are free to synthesize multi-controlled operations
+using any pertinent synthesis strategy available. Qubits may be aggregated into
+a range of control qubits with or without the use of the :code:`operator!`
+:doc:`negated polarity operator <operations>`.
+
+.. tab:: C++ 
+  
+  .. code-block:: cpp
+
+      cudaq::control(kernel{}, {qubit0, !qubit1}, kernel_arg);
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    cudaq.control(kernel, [qubit0, ~qubit1], kernel_arg)
+  
+**[5]** The :code:`cudaq::adjoint(...)` function takes as input an
+pure device quantum kernel and the remaining arguments for the kernel.
diff --git a/pr-2241/sphinx/specification/cudaq/types.rst b/pr-2241/sphinx/specification/cudaq/types.rst
new file mode 100644
index 0000000000..2a61b8576c
--- /dev/null
+++ b/pr-2241/sphinx/specification/cudaq/types.rst
@@ -0,0 +1,451 @@
+Quantum Types
+*************
+The CUDA-Q language extension provides certain fundamental types that are pertinent
+to quantum-classical computing. These types are provided via defined classical library
+types in C++ in the :code:`cudaq` namespace. 
+
+:code:`cudaq::qudit<Levels>`
+----------------------------
+**[1]** The :code:`cudaq::qudit` models a :math:`D`-level unit of quantum information. The state of
+this system (for :math:`N` qudits) can be described by a :math:`D`\ :sup:`N`\-dimensional vector in
+Hilbert space with the absolute square of all elements summing to 1. 
+
+**[2]** The :code:`cudaq::qudit` encapsulates a unique :code:`std::size_t` modeling the index of the
+qudit in the underlying quantum memory space (assuming an infinite register
+of available qudits). 
+
+**[4]** To adhere to the no-cloning theorem of quantum mechanics,
+the :code:`cudaq::qudit` is non-copyable and non-movable. Therefore, all :code:`cudaq::qudit` 
+instances must be passed by reference, and the no-cloning theorem is satisfied
+at compile-time. 
+
+**[5]** :code:`cudaq::qudit` instances can only be allocated within CUDA-Q quantum
+kernel code and can never be allocated from classical host code.
+
+**[6]** All instantiated :code:`cudaq::qudit` instances start in the :code:`|0>` computational basis 
+state and serve as the primary input argument for quantum intrinsic operations 
+modeling typical logical quantum gate operations.
+
+**[7]** :code:`cudaq::qudit` instances can be negated when leveraged as controls in 
+quantum operation invocations. The mechanism for negation should be via overloading of :code:`qudit<N>::operator!()`.
+
+The :code:`cudaq::qudit` takes on the following structure
+
+.. code-block:: cpp
+
+    template <std::size_t Levels>
+    class qudit {
+      protected: 
+        const std::size_t idx = 0;
+      public:
+        qudit();
+        qudit(const qudit&) = delete;
+        qudit(qudit &&) = delete;
+        std::size_t id() const;
+        static constexpr std::size_t n_levels();
+        qudit<Levels> &operator!(); 
+    };
+
+:code:`cudaq::qubit`
+--------------------
+**[1]** The specification provides a primitive :code:`cudaq::qubit` type which models a
+single quantum bit (:math:`2`-level) in the discrete quantum memory space.
+:code:`cudaq::qubit` is an alias for :code:`cudaq::qudit<2>` 
+
+.. code-block:: cpp
+    
+    namespace cudaq {
+      using qubit = qudit<2>;
+    }
+
+.. tab:: C++ 
+
+  .. code-block:: cpp
+
+      {
+        // Allocate a qubit in the |0> state
+        cudaq::qubit q;
+        // Put the qubit in a superposition of |0> and |1>
+        h(q); // cudaq::h == hadamard, ADL leveraged
+        printf("ID = %lu\n", q.id()); // prints 0
+        cudaq::qubit r;
+        printf("ID = %lu\n", r.id()); // prints 1
+        // qubit out of scope, implicit deallocation
+      }
+      cudaq::qubit q;
+      printf("ID = %lu\n", q.id()); // prints 0 (previous deallocated)
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    # Allocate a qubit in the |0> state
+    q = cudaq.qubit()
+    # Put the qubit in a superposition of |0> and |1>
+    h(q)
+    print("ID = {}".format(q.id())) # prints 0
+    
+    r = cudaq.qubit()
+    print("ID = {}", r.id()) # prints 1
+    # qubits go out of scope, implicit deallocation
+    
+Quantum Containers
+------------------
+**[1]** CUDA-Q specifies abstractions for dealing with groups of :code:`cudaq::qudit` instances in the
+form of familiar C++ containers. 
+
+**[2]** The underlying connectivity of the :code:`cudaq::qudit` instances stored in these containers is opaque to
+the programmer and any logical-to-physical program connectivity mapping should be done by compiler implementations. 
+
+:code:`cudaq::qview<Levels = 2>`
+++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qview<N>` is a non-owning reference to a subset of the discrete quantum memory space, 
+and as such, it is a :code:`std::span`-like C++ range of :code:`cudaq::qudit`.
+
+**[2]** The :code:`cudaq::qview` does not own its elements and can therefore be passed by value or reference. 
+
+**[3]** The :code:`cudaq::qview` is templated on the dimensionality of the contained quantum information unit, 
+and defaults to :math:`2` for qubit systems.
+
+**[4]** The :code:`cudaq::qview` provides an API for individual qubit extraction and sub-register slicing. 
+Programmers can extract the front :math:`N` :code:`qudits`, the back :math:`N` :code:`qudits`, and the 
+inner slice starting at a given index and including user-specified :code:`count` :code:`qudits`.
+
+The :code:`cudaq::qview` should take on the following structure:
+
+.. code-block:: cpp
+    
+    namespace cudaq { 
+      template <std::size_t Levels = 2>
+      class qview {
+        private:
+          std::span<qudit<Levels>> qudits;
+        public:
+          // Construct a span that refers to the qudits in `other`.
+          template <typename R>
+          requires(std::ranges::range<R>)
+          qview(R&& other);
+          qview(const qview& other);
+
+          // Iterator interface.
+          auto begin();
+          auto end();
+
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+
+          // Returns the `[0, count)` qudits.
+          qview<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qview<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+
+
+          // Returns the `[start, start+count)` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+      };
+    }
+
+:code:`cudaq::qvector<Levels = 2>`
+++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qvector<Levels>` is a container of elements from the discrete quantum memory space - a C++ container of :code:`cuda::qudit`.  
+
+**[2]** The :code:`cudaq::qvector` is a dynamically constructed owning container for :code:`cuda::qudit` (:code:`std::vector`-like), 
+and since it owns the quantum memory, it cannot be copied or moved. 
+
+**[3]** The :code:`cudaq::qvector` is templated on the dimensionality of the contained 
+quantum information unit, and defaults to :math:`2` for qubit systems.
+
+**[4]** The :code:`cudaq::qvector` can only be instantiated within CUDA-Q kernels
+
+**[5]** All qudits in the :code:`cudaq::qvector` start in the :code:`|0>` computational basis state. 
+
+**[6]** The :code:`cudaq::qvector` provides an API for individual qubit extraction and sub-register slicing. 
+Programmers can extract the front :math:`N` :code:`qudits`, the back :math:`N` :code:`qudits`, and the 
+inner slice starting at a given index and including user-specified :code:`count` :code:`qudits`.
+
+The :code:`cudaq::qview` should take on the following structure:
+
+.. code-block:: cpp
+    
+    namespace cudaq { 
+      template <std::size_t Levels = 2>
+      class qvector {
+        private:
+          std::vector<qudit<Levels>> qudits;
+
+        public:
+          // Construct a qreg with `size` qudits in the |0> state.
+          qvector(std::size_t size);
+          qvector(const qvector&) = delete;
+
+          // Iterator interface.
+          auto begin();
+          auto end();
+
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+
+          // Returns the `[0, count)` qudits.
+          qview<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qview<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+ 
+          // Returns the `[start, start+count)` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the `{start, start + stride, ...}` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t stride, std::size_t end);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+
+          // Destroys all contained qudits. Postcondition: `size() == 0`.
+          void clear();
+      };
+    }
+
+.. tab:: C++ 
+
+  .. code-block:: cpp 
+
+    // Allocate 20 qubits, std::vector-like semantics
+    cudaq::qvector q(20);
+    // Get first qubit
+    auto first = q.front();
+    // Get first 5 qubits
+    auto first_5 = q.front(5);
+    // Get last qubit 
+    auto last = q.back();
+    // Can loop over qubits with size() method
+    for (int i = 0; i < q.size(); i++) {
+      ... do something with q[i] ...
+    }
+    // Range based for loop supported 
+    for (auto & qb : q) {
+      ... do something with qb ...
+    }
+
+.. tab:: Python 
+
+  .. code-block:: python 
+
+    # Allocate 20 qubits, vector-like semantics
+    q = cudaq.qvector(20)
+    # Get the first qubit 
+    first = q.front()
+    # Get the first 5 qubits 
+    first_5 = q.front(5)
+    # Get the last qubit 
+    last = q.back()
+    # Can loop over qubits with size or len function 
+    for i in range(len(q)):
+      .. do something with q[i] ..
+    # Range based for loop 
+    for qb in q:
+      .. do something with qb .. 
+
+
+:code:`cudaq::qarray<N, Levels = 2>`
+++++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qarray<N, Levels>` (where :code:`N` is an integral constant) is a statically 
+allocated container (:code:`std::array`-like). The utility of this type is in the compile-time 
+knowledge of allocated containers of qudits that may directly enable ahead-of-time quantum 
+optimization and synthesis. 
+
+**[2]** The second template parameter defaults to :math:`2`-level :code:`cudaq::qudit`.
+
+**[3]** The :code:`cudaq::qarray` owns the quantum memory it contains, and therefore cannot be copied or moved.
+
+**[4]** The :code:`cudaq::qarray` can only be instantiated within CUDA-Q kernels
+
+**[5]** All qudits in the :code:`cudaq::qarray` start in the :code:`|0>` computational basis state. 
+
+**[6]** The :code:`cudaq::qarray` provides an API for individual qubit extraction and sub-register slicing. 
+Programmers can extract the front :math:`N` :code:`qudits`, the back :math:`N` :code:`qudits`, and the 
+inner slice starting at a given index and including user-specified :code:`count` :code:`qudits`.
+
+The :code:`cudaq::qarray` should take on the following structure:
+
+.. code-block:: cpp 
+
+    namespace cudaq {
+      template <std::size_t N, std::size_t Levels = 2>
+      class qarray {
+        private:
+          std::array<qudit<Levels>, N> qudits;
+
+        public:
+          // Construct a qreg with `size` qudits in the |0> state.
+          qarray();
+          qarray(const qvector&) = delete;
+          qarray(qarray &&) = delete;
+
+          qarray& operator=(const qarray &) = delete;
+
+          // Iterator interface.
+          auto begin();
+          auto end();
+
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+
+          // Returns the `[0, count)` qudits.
+          qview<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qview<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+
+          // Returns the `[start, start+count)` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the `{start, start + stride, ...}` qudits.
+          qview<Levels>
+          slice(std::size_t start, std::size_t stride, std::size_t end);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+
+          // Destroys all contained qudits. Postcondition: `size() == 0`.
+          void clear();
+      };
+    }
+
+:code:`cudaq::qspan<N, Levels>` (Deprecated. Use :code:`cudaq::qview<Levels>` instead.)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qspan` is a non-owning reference to a part of the discrete quantum
+memory space, a :code:`std::span`-like C++ range of :code:`cudaq::qudit` 
+(see C++ `span <https://en.cppreference.com/w/cpp/container/span>`_). It does not
+own its elements. It takes a single template parameter indicating the levels for 
+the underlying qudits that it stores. This parameter defaults to 2 for qubits. 
+It takes on the following structure:
+
+.. code-block:: cpp
+    
+    namespace cudaq {
+      template <std::size_t Levels = 2>
+      class qspan {
+        private:
+          std::span<qudit<Levels>> qubits;
+        public:
+          // Construct a span that refers to the qudits in `other`.
+          qspan(std::ranges::range<qudit<Levels>> auto& other);
+          qspan(qspan const& other);
+ 
+          // Iterator interface.
+          auto begin();
+          auto end();
+ 
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+ 
+          // Returns the `[0, count)` qudits.
+          qspan<Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qspan<Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+ 
+          // Returns the `[start, start+count)` qudits.
+          qspan<Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+      };
+    }
+
+:code:`cudaq::qreg<N, Levels>` (Deprecated. Use :code:`cudaq::qvector<Levels>` instead.)
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+**[1]** :code:`cudaq::qreg<N, Levels>` models a register of the discrete quantum memory space - a
+C++ container of :code:`cudaq::qudit`.  As a container, it owns its elements and
+their storage. :code:`qreg<dyn, Levels>` is a dynamically allocated container
+(:code:`std::vector`-like, see C++ `vector <https://en.cppreference.com/w/cpp/container/vector>`_).
+:code:`cudaq::qreg<N, Levels>` (where N is an integral
+constant) is a statically allocated container (:code:`std::array`-like, 
+see `array <https://en.cppreference.com/w/cpp/container/array>`_). 
+Its template parameters default to dynamic allocation and :code:`cudaq::qudit<2>`.
+
+.. code-block:: cpp
+
+    namespace cudaq {
+      template <std::size_t N = dyn, std::size_t Levels = 2>
+      class qreg {
+        private:
+          std::conditional_t<
+            N == dyn,
+            std::vector<qudit<Levels>>,
+            std::array<qudit<Levels>, N>
+          > qudits;
+        public:
+          // Construct a qreg with `size` qudits in the |0> state.
+          qreg(std::size_t size) requires (N == dyn);
+          qreg(qreg const&) = delete;
+ 
+          // Iterator interface.
+          auto begin();
+          auto end();
+ 
+          // Returns the qudit at `idx`.
+          qudit<Levels>& operator[](const std::size_t idx);
+ 
+          // Returns the `[0, count)` qudits.
+          qspan<dyn, Levels> front(std::size_t count);
+          // Returns the first qudit.
+          qudit<Levels>& front();
+          // Returns the `[count, size())` qudits.
+          qspan<dyn, Levels> back(std::size_t count);
+          // Returns the last qudit.
+          qudit<Levels>& back();
+ 
+          // Returns the `[start, start+count)` qudits.
+          qspan<dyn, Levels>
+          slice(std::size_t start, std::size_t count);
+
+          // Returns the number of contained qudits.
+          std::size_t size() const;
+ 
+          // Destroys all contained qudits. Postcondition: `size() == 0`.
+          void clear();
+      };
+    } 
+
+:code:`qreg` instances can only be instantiated from within quantum kernels,
+they cannot be instantiated in host code. All qubits in the :code:`qreg` 
+start in the :code:`|0>` computational basis state. 
+
+.. code-block:: cpp
+
+    // Allocate 20 qubits, std::vector-like semantics
+    cudaq::qreg q(20);
+    auto first = q.front();
+    auto first_5 = q.front(5);
+    auto last = q.back();
+    for (int i = 0; i < q.size(); i++) {
+      ... do something with q[i] ...
+    }
+    for (auto & qb : q) {
+      ... do something with qb ...
+    }
+ 
+    // std::array-like semantics
+    cudaq::qreg<5> fiveCompileTimeQubits;
\ No newline at end of file
diff --git a/pr-2241/sphinx/specification/index.rst b/pr-2241/sphinx/specification/index.rst
new file mode 100644
index 0000000000..6895a6de94
--- /dev/null
+++ b/pr-2241/sphinx/specification/index.rst
@@ -0,0 +1,11 @@
+*****************
+Specifications
+*****************
+
+The following specifications for the CUDA-Q programming model and toolchain are available:
+
+.. toctree::
+   :maxdepth: 2
+
+      Language Specification <cudaq.rst>
+      Quake Specification <quake-dialect>
diff --git a/pr-2241/sphinx/specification/quake-dialect.md b/pr-2241/sphinx/specification/quake-dialect.md
new file mode 100644
index 0000000000..0650f71206
--- /dev/null
+++ b/pr-2241/sphinx/specification/quake-dialect.md
@@ -0,0 +1,150 @@
+# Quake Dialect
+
+## General Introduction
+
+The quantum circuit model is the most widely used model of quantum
+computation.  It provides a convenient tool for formulating quantum
+algorithms and an architecture for the physical construction of quantum
+computers.
+
+A _quantum circuit_ represents a computation as a sequence of quantum
+operators applied to quantum data.  In our case, the quantum data is a set
+of quantum bits, or qubits for short.  Physically, a qubit is an object with
+only two distinguishable states, i.e., it is a two-state quantum mechanical
+system such as a spin-1/2 particle.
+
+Conceptually, a _quantum operator_ is an effect that might modify the state
+of a subset of qubits. Most often, this effect is unitary evolution---in
+this case, we say that the operator is a _unitary_.  The number of target
+qubits an operator acts upon is an intrinsic property.
+
+A _quantum instruction_ is the embodiment of a quantum operator when applied
+to a specific subset of qubits.  The number of qubits must be equal to (or
+greater than) the number of target qubits intrinsic to the operator.  If
+greater, the extra qubits are considered controls.
+
+## Motivation
+
+The main motivation behind Quake's value model is to directly expose
+quantum and classical data dependencies for optimization purposes,
+i.e., to represent the dataflow in quantum computations.  In contrast
+to Quake's memory model, which uses memory semantics (quantum
+operators act as side-effects on qubit references), the value model
+uses value semantics, that is quantum operators consume and produce
+values. These values are not truly SSA values, however, as operations
+still have side-effects on the value itself and the value cannot be
+copied.
+
+Let's see an example to clarify the distinction between the models.  Take the
+following Quake implementation of some toy quantum computation:
+
+```cpp
+func.func foo(%veq : !quake.veq<2>) {
+    // Boilerplate to extract each qubit from the vector
+    %c0 = arith.constant 0 : index
+    %c1 = arith.constant 1 : index
+    %q0 = quake.extract_ref %veq[%c0] : (!quake.veq<2>, index) -> !quake.ref
+    %q1 = quake.extract_ref %veq[%c1] : (!quake.veq<2>, index) -> !quake.ref
+
+    // We apply some operators to those extracted qubits
+    // ... bunch of operators using %q0 and %q1 ...
+    quake.h %q0 : (!quake.ref) -> ()
+
+    // We decide to measure the vector
+    %result = quake.mz %veq : (!quake.veq<2>) -> cc.stdvec<i1>
+
+    // And then apply another Hadamard to %q0
+    quake.h %q0 : (!quake.ref) -> ()
+    // ...
+}
+```
+
+Now imagine we want to optimize this code by removing pair of adjacent
+adjoint operators, e.g., if we have a pair Hadamard operations next to each
+other on the same qubit---visually:
+
+```text
+    ┌───┐ ┌───┐         ┌───┐
+   ─┤ H ├─┤ H ├─  =  ───┤ I ├───  =  ─────────────
+    └───┘ └───┘         └───┘
+```
+
+Where `I` is the identity operator. Now note that a naive implementation of
+this optimization for Quake would optimize away both `quake.h` operators
+being applied to `%q0`.  Such an implementation would have missed the fact
+that a measurement is being applied to the vector, `%veq`, which contains
+`%q0`.
+
+Of course it is possible to correctly implement this optimization for Quake.
+However such an implementation would be quite error-prone and require
+complex analyses.  For this reason, Quake has overloaded gates.
+
+In the value model operators consume values and return new values:
+
+```text
+  %q0_1 = quake.op %q0_0 : (!quake.wire) -> !quake.wire
+```
+
+We can visualize the difference between memory and value representation as:
+
+```text
+            Memory                                   Value
+
+        ┌──┐ ┌──┐     ┌──┐                  ┌──┐ %q0_1 ┌──┐     ┌──┐
+   %q0 ─┤  ├─┤  ├─···─┤  ├─ %q0  vs  %q0_0 ─┤  ├───────┤  ├─···─┤  ├─ %q0_Z
+        └──┘ └──┘     └──┘                  └──┘       └──┘     └──┘
+```
+
+If we look at the implementation again, we notice that the problem
+with the naive optimization happens because the Hadamard operators are
+implicitly connected by the same value `%q0`. In value form, all the gates
+are explicitly connected by distinct values, which eliminates the need
+to do further analysis via implicit side-effects.
+The following is the implementation in value form.
+
+```text
+func.func @foo(%array : !quake.qvec<2>) {
+    // Boilerplate to extract each qubit
+    %c0 = arith.constant 0 : index
+    %c1 = arith.constant 1 : index
+    %r0 = quake.extract_ref %array[%c0] : (!quake.qvec<2>, index) -> !quake.qref
+    %r1 = quake.extract_ref %array[%c1] : (!quake.qvec<2>, index) -> !quake.qref
+
+    // Unwrap the quantum references to expose the wires.
+    %q0 = quake.unwrap %r0 : (!quake.qref) -> !quake.wire
+    %q1 = quake.unwrap %r1 : (!quake.qref) -> !quake.wire
+
+    // Misc. operators applied
+    %q0_M = quake.h %q0_L : (!quake.wire) -> !quake.wire
+
+    // Re-wrap the wire to its original source
+    quake.wrap %q0_M to %r0 : !quake.wire, !quake.qref
+    quake.wrap %q1_X to %r1 : !quake.wire, !quake.qref
+
+    // Measure the entire vector of quantum references
+    %result = quake.mz %array : (!quake.qvec<2>) -> !cc.stdvec<i1>
+
+    // Unwrap the wire for qubit 0 again
+    %q0_P = quake.unwrap %r0 : (!quake.qref) -> !quake.wire
+    ...
+    %q0_Z = quake.h %q0_Y : (!quake.wire) -> !quake.wire
+    // Re-wrap the wire back to the original reference
+    quake.wrap %q0_Z to %r0 : !quake.wire, !quake.qref
+    return
+}
+```
+
+In this code we can more straightforwardly see that the Hadamard
+operators cannot cancel each other.  One way of reasoning about this
+is as follows: In value form we need to follow a chain of values to
+know the qubit operators are being applied to, in this example:
+
+```text
+Mmeory                          Value
+    %q0         [%q0_0, %q0_1 ... %q0_L, %q0_M; %q0_P ... %q0_Y, %q0_Z]
+
+```
+
+We know that one Hadamard is applied to `%q0_L` and generates `%q0_M`, and
+the other is applied `%q0_Y` and generates `%q0_Z`.  Hence, there is no
+connection between them---which means they cannot cancel each other out.
diff --git a/pr-2241/sphinx/using/advanced.html b/pr-2241/sphinx/using/advanced.html
new file mode 100644
index 0000000000..d8a05d9e12
--- /dev/null
+++ b/pr-2241/sphinx/using/advanced.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=integration/integration.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/backends/backends.rst b/pr-2241/sphinx/using/backends/backends.rst
new file mode 100644
index 0000000000..56b628e8fd
--- /dev/null
+++ b/pr-2241/sphinx/using/backends/backends.rst
@@ -0,0 +1,36 @@
+CUDA-Q Backends
+**********************
+
+.. toctree::
+   :caption: Backend Targets
+   :maxdepth: 1
+
+      Simulation <simulators.rst>
+      Quantum Hardware <hardware.rst>
+      NVIDIA Quantum Cloud <nvqc.rst>
+      Multi-Processor Platforms <platform.rst>
+
+**The following is a comprehensive list of the available targets in CUDA-Q:**
+
+* :ref:`density-matrix-cpu <default-simulator>`
+* :ref:`ionq <ionq-backend>`
+* :ref:`iqm <iqm-backend>`
+* :ref:`nvidia <nvidia-backend>`
+* :ref:`nvidia-fp64 <nvidia-fp64-backend>`
+* :ref:`nvidia-mgpu <nvidia-mgpu-backend>`
+* :ref:`nvidia-mqpu <mqpu-platform>`
+* :ref:`nvidia-mqpu-fp64 <mqpu-platform>`
+* :doc:`nvqc <nvqc>`
+* :ref:`oqc <oqc-backend>`
+* :ref:`orca <orca-backend>`
+* :ref:`qpp-cpu <qpp-cpu-backend>`
+* :ref:`quantinuum <quantinuum-backend>`
+* :ref:`remote-mqpu <mqpu-platform>`
+* :ref:`stim <stim-backend>`
+* :ref:`tensornet <tensor-backends>`
+* :ref:`tensornet-mps <tensor-backends>`
+
+.. deprecated:: 0.8
+   The `nvidia-fp64`, `nvidia-mgpu`, `nvidia-mqpu`, and `nvidia-mqpu-fp64` targets can be 
+   enabled as extensions of the unified `nvidia` target (see `nvidia` :ref:`target documentation <nvidia-backend>`).
+   These target names might be removed in a future release.
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/backends/hardware.rst b/pr-2241/sphinx/using/backends/hardware.rst
new file mode 100644
index 0000000000..203e0268b1
--- /dev/null
+++ b/pr-2241/sphinx/using/backends/hardware.rst
@@ -0,0 +1,482 @@
+CUDA-Q Hardware Backends
+*********************************
+
+CUDA-Q supports submission to a set of hardware providers. 
+To submit to a hardware backend, you need an account with the respective provider.
+
+
+IonQ
+==================================
+
+.. _ionq-backend:
+
+Setting Credentials
+`````````````````````````
+
+Programmers of CUDA-Q may access the `IonQ Quantum Cloud
+<https://cloud.ionq.com/>`__ from either C++ or Python. Generate
+an API key from your `IonQ account <https://cloud.ionq.com/>`__ and export
+it as an environment variable:
+
+.. code:: bash
+
+  export IONQ_API_KEY="ionq_generated_api_key"
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution in the IonQ Cloud,
+pass the flag ``--target ionq`` to the ``nvq++`` compiler.
+
+.. code:: bash
+
+    nvq++ --target ionq src.cpp
+
+This will take the API key and handle all authentication with, and submission to,
+the IonQ QPU(s). By default, quantum kernel code will be submitted to the IonQ
+simulator.
+
+.. note:: 
+
+    A "target" in :code:`cudaq` refers to a quantum compute provider, such as :code:`ionq`.
+    However, IonQ's documentation uses the term "target" to refer to specific QPU's themselves.
+
+To execute your kernels on a QPU, pass the ``--ionq-machine`` flag to the ``nvq++`` compiler
+to specify which machine to submit quantum kernels to:
+
+.. code:: bash
+
+    nvq++ --target ionq --ionq-machine qpu.aria-1 src.cpp ...
+
+where ``qpu.aria-1`` is an example of a physical QPU.
+
+A list of available QPUs can be found `in the API documentation
+<https://docs.ionq.com/#tag/jobs>`__. To see which backends are available 
+with your subscription login to your `IonQ account <https://cloud.ionq.com/jobs>`__.
+
+To emulate the IonQ machine locally, without submitting through the cloud,
+you can also pass the ``--emulate`` flag to ``nvq++``. This will emit any target 
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target ionq src.cpp
+
+To see a complete example for using IonQ's backends, take a look at our :doc:`C++ examples <../examples/examples>`.
+
+Submission from Python
+`````````````````````````
+
+The target to which quantum kernels are submitted 
+can be controlled with the ``cudaq::set_target()`` function.
+
+.. code:: python
+
+    cudaq.set_target('ionq')
+
+By default, quantum kernel code will be submitted to the IonQ
+simulator.
+
+.. note:: 
+
+    A "target" in :code:`cudaq` refers to a quantum compute provider, such as :code:`ionq`.
+    However, IonQ's documentation uses the term "target" to refer to specific QPU's themselves.
+
+To specify which IonQ QPU to use, set the :code:`qpu` parameter.
+
+.. code:: python
+
+    cudaq.set_target("ionq", qpu="qpu.aria-1")
+
+where ``qpu.aria-1`` is an example of a physical QPU.
+
+A list of available QPUs can be found `in the API documentation
+<https://docs.ionq.com/#tag/jobs>`__. To see which backends are available 
+with your subscription login to your `IonQ account <https://cloud.ionq.com/jobs>`__.
+
+To emulate the IonQ machine locally, without submitting through the cloud,
+you can also set the ``emulate`` flag to ``True``. This will emit any target 
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: python
+
+    cudaq.set_target('ionq', emulate=True)
+
+The number of shots for a kernel execution can be set through
+the ``shots_count`` argument to ``cudaq.sample`` or ``cudaq.observe``. By default,
+the ``shots_count`` is set to 1000.
+
+.. code:: python
+
+    cudaq.sample(kernel, shots_count=10000)
+
+To see a complete example for using IonQ's backends, take a look at our :doc:`Python examples <../examples/examples>`.
+
+
+IQM
+==================================
+
+.. _iqm-backend:
+
+Support for submissions to IQM is currently under development. 
+In particular, two-qubit gates can only be performed on adjacent qubits. For more information, we refer to the respective hardware documentation.
+Support for automatically injecting the necessary operations during compilation to execute arbitrary multi-qubit gates will be added in future versions.
+
+Setting Credentials
+`````````````````````````
+
+Programmers of CUDA-Q may access the IQM Server from either C++ or Python. Following the `quick start guide <https://iqm-finland.github.io/cortex-cli/readme.html#using-cortex-cli>`__, install `iqm-cortex-cli` and login to initialize the tokens file.
+The path to the tokens file can either be passed explicitly via an environment variable or it will be loaded automatically if located in
+the default location :code:`~/.cache/iqm-cortex-cli/tokens.json`.
+
+.. code:: bash
+
+    export IQM_TOKENS_FILE="path/to/tokens.json"
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution on an IQM Server,
+pass the ``--target iqm`` flag to the ``nvq++`` compiler, along with a specified ``--iqm-machine``.
+
+.. note::
+    The ``--iqm-machine`` is  a mandatory argument. This provided architecture must match
+    the device architecture that the program has been compiled against. The hardware architecture for a
+    specific IQM Server may be checked  via `https://<IQM server>/cocos/quantum-architecture`.
+
+.. code:: bash
+
+    nvq++ --target iqm --iqm-machine Adonis src.cpp
+
+Once the binary for a specific IQM QPU architecture is compiled, it can be executed against any IQM Server with the same QPU architecture:
+
+.. code:: bash
+
+    nvq++ --target iqm --iqm-machine Adonis src.cpp -o program
+    IQM_SERVER_URL="https://demo.qc.iqm.fi/cocos" ./program
+
+    # Executing the same program against an IQM Server with a different underlying QPU
+    # architecture will result in an error.
+    IQM_SERVER_URL="https://<Apollo IQM Server>/cocos" ./program
+
+To emulate the IQM machine locally, without submitting to the IQM Server,
+you can also pass the ``--emulate`` flag to ``nvq++``. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target iqm --iqm-machine Adonis src.cpp
+
+To see a complete example for using IQM server backends, take a look at our :doc:`C++ examples <../examples/examples>`.
+
+Submission from Python
+`````````````````````````
+
+The target to which quantum kernels are submitted
+can be controlled with the ``cudaq::set_target()`` function.
+
+.. code:: python
+
+    cudaq.set_target("iqm", url="https://<IQM Server>/cocos", **{"qpu-architecture": "Adonis"})
+
+To emulate the IQM Server locally, without submitting to the IQM Server,
+you can also set the ``emulate`` flag to ``True``. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.
+
+.. code:: python
+
+    cudaq.set_target('iqm', emulate=True)
+
+The number of shots for a kernel execution can be set through
+the ``shots_count`` argument to ``cudaq.sample`` or ``cudaq.observe``. By default,
+the ``shots_count`` is set to 1000.
+
+.. code:: python
+
+    cudaq.sample(kernel, shots_count=10000)
+
+To see a complete example for using IQM server backends, take a look at our :doc:`Python examples<../examples/examples>`.
+
+OQC
+==================================
+
+.. _oqc-backend:
+
+`Oxford Quantum Circuits <https://oxfordquantumcircuits.com/>`__ (OQC) is currently providing CUDA-Q integration for multiple Quantum Processing Unit types.
+The 8 qubit ring topology Lucy device and the 32 qubit Kagome lattice topology Toshiko device are both supported via machine options described below.
+
+Setting Credentials
+`````````````````````````
+
+In order to use the OQC devices you will need to register.
+Registration is achieved by contacting oqc_qcaas_support@oxfordquantumcircuits.com
+
+Once registered you will be able to authenticate with your ``email`` and ``password``
+
+There are three environment variables that the OQC target will look for during configuration:
+
+1. ``OQC_URL``
+2. ``OQC_EMAIL``
+3. ``OQC_PASSWORD`` - is mandatory
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution on the OQC platform, provide the flag ``--target oqc`` to the ``nvq++`` compiler.
+
+Users may provide their :code:`email` and :code:`url` as extra arguments
+
+.. code:: bash
+
+    nvq++ --target oqc --oqc-email <email> --oqc-url <url> src.cpp -o executable
+
+Where both environment variables and extra arguments are supplied, precedent is given to the extra arguments.
+To run the output, provide the runtime loaded variables and invoke the pre-built executable
+
+.. code:: bash
+
+   OQC_PASSWORD=<password> ./executable
+
+To emulate the OQC device locally, without submitting through the OQC QCaaS services, you can pass the ``--emulate`` flag to ``nvq++``.
+This will emit any target specific compiler warnings and diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target oqc src.cpp -o executable
+
+
+.. note::
+
+    The oqc target supports a ``--oqc-machine`` option.
+    The default is the 8 qubit Lucy device.
+    You can set this to be either ``toshiko`` or ``lucy`` via this flag.
+
+.. note::
+
+    The OQC quantum assembly toolchain (qat) which is used to compile and execute instructions can be found on github as `oqc-community/qat <https://github.com/oqc-community/qat>`__
+
+Submission from Python
+`````````````````````````
+
+To set which OQC URL, set the :code:`url` parameter.
+To set which OQC email, set the :code:`email` parameter.
+To set which OQC machine, set the :code:`machine` parameter.
+
+.. code:: python
+
+    import os
+    import cudaq
+    # ...
+    os.environ['OQC_PASSWORD'] = password
+    cudaq.set_target("oqc", url=url, machine="lucy")
+
+You can then execute a kernel against the platform using the OQC Lucy device
+
+.. code:: python
+
+    kernel = cudaq.make_kernel()
+    qvec = kernel.qalloc(2)
+    kernel.h(qvec[0])
+    kernel.x(qvec[1])
+    kernel.cx(qvec[0], qvec[1])
+    kernel.mz(qvec)
+    str(cudaq.sample(kernel=kernel, shots_count=1000))
+
+
+ORCA Computing
+==================================
+
+.. _orca-backend:
+
+ORCA Computing's PT Series implement the boson sampling model of quantum computation, in which 
+multiple single photons are interfered with each other within a network of beam splitters, and 
+photon detectors measure where the photons leave this network. This process is implemented within 
+a time-bin interferometer (TBI) architecture where photons are created in different time-bins 
+and interfered within a network of delay lines. This can be represented by a circuit diagram, 
+like the one below, where this illustration example corresponds to 4 photons in 8 modes sent into 
+alternating time-bins in a circuit composed of two delay lines in series.
+
+.. image:: ../examples/images/orca_tbi.png
+   :width: 400px
+   :align: center
+
+
+Setting Credentials
+```````````````````
+
+Programmers of CUDA-Q may access the ORCA API from either C++ or Python. There is an environment 
+variable ``ORCA_ACCESS_URL`` that can be set so that the ORCA target can look for it during 
+configuration.
+
+.. code:: bash
+
+  export ORCA_ACCESS_URL="https://<ORCA API Server>"
+
+Submission from C++
+`````````````````````````
+
+To execute a boson sampling experiment on the ORCA platform, provide the flag 
+``--target orca`` to the ``nvq++`` compiler. You should then pass the ``--orca-url`` flag set with 
+the previously set environment variable ``$ORCA_ACCESS_URL`` or an :code:`url`.
+
+.. code:: bash
+
+    nvq++ --target orca --orca-url $ORCA_ACCESS_URL src.cpp -o executable
+
+or
+
+.. code:: bash
+
+    nvq++ --target orca --orca-url <url> src.cpp -o executable
+
+To run the output, invoke the executable
+
+.. code:: bash
+
+   ./executable
+
+
+To see a complete example for using ORCA server backends, take a look at our :doc:`C++ examples <../examples/hardware_providers>`.
+
+Submission from Python
+`````````````````````````
+
+To set which ORCA URL to be used, set the :code:`url` parameter.
+
+.. code:: python
+
+    import os
+    import cudaq
+    # ...
+    orca_url = os.getenv("ORCA_ACCESS_URL", "http://localhost/sample")
+
+    cudaq.set_target("orca", url=orca_url)
+
+
+You can then execute a time-bin boson sampling experiment against the platform using an ORCA device.
+
+.. code:: python
+
+    bs_angles = [np.pi / 3, np.pi / 6]
+    input_state = [1, 1, 1]
+    loop_lengths = [1]
+    counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles)
+
+To see a complete example for using ORCA's backends, take a look at our :doc:`Python examples <../examples/hardware_providers>`.
+
+Quantinuum
+==================================
+
+.. _quantinuum-backend:
+
+Setting Credentials
+```````````````````
+
+Programmers of CUDA-Q may access the Quantinuum API from either
+C++ or Python. Quantinuum requires a credential configuration file. 
+The configuration file can be generated as follows, replacing
+the ``email`` and ``credentials`` in the first line with your Quantinuum
+account details.
+
+.. code:: bash
+
+    # You may need to run: `apt-get update && apt-get install curl jq`
+    curl -X POST -H "Content Type: application/json" \
+        -d '{ "email":"<your_alias>@email.com","password":"<your_password>" }' \
+        https://qapi.quantinuum.com/v1/login > $HOME/credentials.json
+    id_token=`cat $HOME/credentials.json | jq -r '."id-token"'`
+    refresh_token=`cat $HOME/credentials.json | jq -r '."refresh-token"'`
+    echo "key: $id_token" >> $HOME/.quantinuum_config
+    echo "refresh: $refresh_token" >> $HOME/.quantinuum_config
+
+The path to the configuration can be specified as an environment variable:
+
+.. code:: bash
+
+    export CUDAQ_QUANTINUUM_CREDENTIALS=$HOME/.quantinuum_config
+
+
+Submission from C++
+`````````````````````````
+
+To target quantum kernel code for execution in the Quantinuum backends,
+pass the flag ``--target quantinuum`` to the ``nvq++`` compiler. CUDA-Q will 
+authenticate via the Quantinuum REST API using the credential in your configuration file.
+By default, quantum kernel code will be submitted to the Quantinuum syntax checker.
+Submission to the syntax checker merely validates the program; the kernels are not executed.
+
+.. code:: bash
+
+    nvq++ --target quantinuum src.cpp ...
+
+To execute your kernels, pass the ``--quantinuum-machine`` flag to the ``nvq++`` compiler
+to specify which machine to submit quantum kernels to:
+
+.. code:: bash
+
+    nvq++ --target quantinuum --quantinuum-machine H1-2 src.cpp ...
+
+where ``H1-2`` is an example of a physical QPU. Hardware specific
+emulators may be accessed by appending an ``E`` to the end (e.g, ``H1-2E``). For 
+access to the syntax checker for the provided machine, you may append an ``SC`` 
+to the end (e.g, ``H1-1SC``).
+
+For a comprehensive list of available machines, login to your `Quantinuum user account <https://um.qapi.quantinuum.com/user>`__ 
+and navigate to the "Account" tab, where you should find a table titled "Machines".
+
+To emulate the Quantinuum machine locally, without submitting through the cloud,
+you can also pass the ``--emulate`` flag to ``nvq++``. This will emit any target 
+specific compiler warnings and diagnostics, before running a noise free emulation.
+
+.. code:: bash
+
+    nvq++ --emulate --target quantinuum src.cpp
+
+To see a complete example for using Quantinuum's backends, take a look at our :doc:`C++ examples <../examples/examples>`.
+
+
+Submission from Python
+`````````````````````````
+
+The target to which quantum kernels are submitted 
+can be controlled with the ``cudaq::set_target()`` function.
+
+.. code:: python
+
+    cudaq.set_target('quantinuum')
+
+By default, quantum kernel code will be submitted to the Quantinuum syntax checker.
+Submission to the syntax checker merely validates the program; the kernels are not executed.
+
+To execute your kernels, specify which machine to submit quantum kernels to
+by setting the :code:`machine` parameter of the target.
+
+.. code:: python
+
+    cudaq.set_target('quantinuum', machine='H1-2')
+
+where ``H1-2`` is an example of a physical QPU. Hardware specific
+emulators may be accessed by appending an ``E`` to the end (e.g, ``H1-2E``). For 
+access to the syntax checker for the provided machine, you may append an ``SC`` 
+to the end (e.g, ``H1-1SC``).
+
+For a comprehensive list of available machines, login to your `Quantinuum user account <https://um.qapi.quantinuum.com/user>`__ 
+and navigate to the "Account" tab, where you should find a table titled "Machines".
+
+To emulate the Quantinuum machine locally, without submitting through the cloud,
+you can also set the ``emulate`` flag to ``True``. This will emit any target 
+specific compiler warnings and diagnostics, before running a noise free emulation.
+
+.. code:: python
+
+    cudaq.set_target('quantinuum', emulate=True)
+
+The number of shots for a kernel execution can be set through
+the ``shots_count`` argument to ``cudaq.sample`` or ``cudaq.observe``. By default,
+the ``shots_count`` is set to 1000.
+
+.. code:: python 
+
+    cudaq.sample(kernel, shots_count=10000)
+
+To see a complete example for using Quantinuum's backends, take a look at our :doc:`Python examples <../examples/examples>`.
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/backends/nvqc.rst b/pr-2241/sphinx/using/backends/nvqc.rst
new file mode 100644
index 0000000000..05ff706697
--- /dev/null
+++ b/pr-2241/sphinx/using/backends/nvqc.rst
@@ -0,0 +1,256 @@
+NVIDIA Quantum Cloud
+---------------------
+NVIDIA Quantum Cloud (NVQC) offers universal access to the world’s most powerful computing platform, 
+for every quantum researcher to do their life’s work.
+To learn more about NVQC visit this `link <https://www.nvidia.com/en-us/solutions/quantum-computing/cloud>`__. 
+
+Apply for early access `here <https://developer.nvidia.com/quantum-cloud-early-access-join>`__. 
+Access to the Quantum Cloud early access program requires an NVIDIA Developer account.
+
+Quick Start
++++++++++++
+Once you have been approved for an early access to NVQC, you will be able to follow these instructions to use it.
+
+1. Follow the instructions in your NVQC Early Access welcome email to obtain an API Key for NVQC. 
+You can also find the instructions `here <https://developer.nvidia.com/quantum-cloud-early-access-members>`__ (link available only for approved users)
+
+2. Set the environment variable `NVQC_API_KEY` to the API Key obtained above.
+
+ .. code-block:: console
+
+    export NVQC_API_KEY=<your NVQC API key>
+
+You may wish to persist that environment variable between bash sessions, e.g., by adding it to your `$HOME/.bashrc` file.
+
+3. Run your first NVQC example
+
+The following is a typical CUDA-Q kernel example. 
+By selecting the `nvqc` target, the quantum circuit simulation will run on NVQC in the cloud, rather than running locally.
+
+
+.. tab:: Python
+    
+    .. literalinclude:: ../../snippets/python/using/cudaq/nvqc/nvqc_intro.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+    .. code-block:: console
+        
+        [2024-03-14 19:26:31.438] Submitting jobs to NVQC service with 1 GPU(s). Max execution time: 3600 seconds (excluding queue wait time).
+
+        ================ NVQC Device Info ================
+        GPU Device Name: "NVIDIA H100 80GB HBM3"
+        CUDA Driver Version / Runtime Version: 12.2 / 11.8
+        Total global memory (GB): 79.1
+        Memory Clock Rate (MHz): 2619.000
+        GPU Clock Rate (MHz): 1980.000
+        ==================================================
+        { 1111111111111111111111111:486 0000000000000000000000000:514 }
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/nvqc/nvqc_intro.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+
+    The code above is saved in `nvqc_intro.cpp` and compiled with the following command, targeting the :code:`nvqc` platform
+
+    .. code-block:: console
+
+        nvq++ nvqc_intro.cpp -o nvqc_intro.x --target nvqc 
+        ./nvqc_intro.x
+
+        [2024-03-14 19:25:05.545] Submitting jobs to NVQC service with 1 GPU(s). Max execution time: 3600 seconds (excluding queue wait time).
+
+        ================ NVQC Device Info ================
+        GPU Device Name: "NVIDIA H100 80GB HBM3"
+        CUDA Driver Version / Runtime Version: 12.2 / 11.8
+        Total global memory (GB): 79.1
+        Memory Clock Rate (MHz): 2619.000
+        GPU Clock Rate (MHz): 1980.000
+        ==================================================
+        { 
+        __global__ : { 1111111111111111111111111:487 0000000000000000000000000:513 }
+        result : { 1111111111111111111111111:487 0000000000000000000000000:513 }
+        }
+
+
+Simulator Backend Selection
+++++++++++++++++++++++++++++
+
+NVQC hosts all CUDA-Q simulator backends (see :doc:`simulators`). 
+You may use the NVQC `backend` (Python) or `--nvqc-backend` (C++) option to select the simulator to be used by the service.
+
+For example, to request the `tensornet` simulator backend, the user can do the following for C++ or Python.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        cudaq.set_target("nvqc", backend="tensornet")
+
+.. tab:: C++
+    
+    .. code-block:: console
+
+        nvq++ nvqc_sample.cpp -o nvqc_sample.x --target nvqc --nvqc-backend tensornet
+
+
+.. note::
+
+  By default, the single-GPU single-precision `custatevec-fp32` simulator backend will be selected if backend information is not specified.
+
+Multiple GPUs
++++++++++++++
+
+Some CUDA-Q simulator backends are capable of multi-GPU distribution as detailed in :doc:`simulators`.
+For example, the `nvidia-mgpu` backend can partition and distribute state vector simulation to multiple GPUs to simulate 
+a larger number of qubits, whose state vector size grows beyond the memory size of a single GPU.
+
+To select a specific number of GPUs on the NVQC managed service, the following `ngpus` (Python) or `--nvqc-ngpus` (C++) option can be used.
+
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        cudaq.set_target("nvqc", backend="nvidia-mgpu", ngpus=4)
+
+.. tab:: C++
+
+    .. code-block:: console
+
+        nvq++ nvqc_sample.cpp -o nvqc_sample.x --target nvqc --nvqc-backend nvidia-mgpu --nvqc-ngpus 4
+
+
+.. note::
+
+    If your NVQC subscription does not contain service instances that have the specified number of GPUs, 
+    you may encounter the following error.
+
+    .. code-block:: console
+        
+        Unable to find NVQC deployment with 16 GPUs.
+        Available deployments have {1, 2, 4, 8} GPUs.
+        Please check your `ngpus` value (Python) or `--nvqc-ngpus` value (C++).
+
+.. note::
+
+    Not all simulator backends are capable of utilizing multiple GPUs. 
+    When requesting a multiple-GPU service with a single-GPU simulator backend, 
+    you might encounter the following log message:
+
+    .. code-block:: console
+        
+        The requested backend simulator (custatevec-fp32) is not capable of using all 4 GPUs requested.
+        Only one GPU will be used for simulation.
+        Please refer to CUDA-Q documentation for a list of multi-GPU capable simulator backends.
+
+    Consider removing the `ngpus` value (Python) or `--nvqc-ngpus` value (C++) to use the default of 1 GPU 
+    if you don't need to use a multi-GPU backend to better utilize NVQC resources.
+
+    Please refer to the table below for a list of backend simulator names along with its multi-GPU capability.
+
+    .. list-table:: Simulator Backends
+        :widths: 20 50 10 10
+        :header-rows: 1
+
+        *   - Name
+            - Description
+            - GPU Accelerated 
+            - Multi-GPU 
+        *   - `qpp`
+            - CPU-only state vector simulator
+            - no
+            - no
+        *   - `dm`
+            - CPU-only density matrix simulator
+            - no
+            - no
+        *   - `custatevec-fp32`
+            - Single-precision `cuStateVec` simulator
+            - yes
+            - no
+        *   - `custatevec-fp64`
+            - Double-precision `cuStateVec` simulator
+            - yes
+            - no
+        *   - `tensornet`
+            - Double-precision `cuTensorNet` full tensor network contraction simulator
+            - yes
+            - yes
+        *   - `tensornet-mps`
+            - Double-precision `cuTensorNet` matrix-product state simulator
+            - yes
+            - no
+        *   - `nvidia-mgpu`
+            - Double-precision `cuStateVec` multi-GPU simulator
+            - yes
+            - yes
+    
+
+Multiple QPUs Asynchronous Execution
++++++++++++++++++++++++++++++++++++++
+
+NVQC provides scalable QPU virtualization services, whereby clients
+can submit asynchronous jobs simultaneously to NVQC. These jobs are
+handled by a pool of service worker instances.
+
+For example, in the following code snippet, using the `nqpus` (Python) or `--nvqc-nqpus` (C++) configuration option,
+the user instantiates 3 virtual QPU instances to submit simulation jobs to NVQC
+calculating the expectation value along with parameter-shift gradients simultaneously.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/nvqc/nvqc_mqpu.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/nvqc/nvqc_mqpu.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+
+    The code above is saved in `nvqc_vqe.cpp` and compiled with the following command, targeting the :code:`nvqc` platform with 3 virtual QPUs.
+
+    .. code-block:: console
+
+        nvq++ nvqc_vqe.cpp -o nvqc_vqe.x --target nvqc --nvqc-nqpus 3 
+        ./nvqc_vqe.x
+
+
+.. note::
+
+    The NVQC managed-service has a pool of worker instances processing incoming requests on a 
+    first-come-first-serve basis. Thus, the attainable speedup using multiple virtual QPUs vs. 
+    sequential execution on a single QPU depends on the NVQC service load. For example, 
+    if the number of free workers is greater than the number of requested virtual QPUs, a linear
+    (ideal) speedup could be achieved. On the other hand, if all the service workers are busy, 
+    multi-QPU distribution may not deliver any substantial speedup.  
+
+FAQ
+++++
+
+1. How do I get more information about my NVQC API submission?
+
+The environment variable `NVQC_LOG_LEVEL` can be used to turn on and off
+certain logs. There are three levels:
+
+- Info (`info`): basic information about NVQC is logged to the console. This is the default.
+
+- Off (`off` or `0`): disable all NVQC logging.
+
+- Trace: (`trace`): log additional information for each NVQC job execution (including timing)
+
+2. I want to persist my API key to a configuration file.
+
+You may persist your NVQC API Key to a credential configuration file in lieu of 
+using the `NVQC_API_KEY` environment variable. 
+The configuration file can be generated as follows, replacing
+the `api_key` value with your NVQC API Key.
+
+.. code:: bash
+
+    echo "key: <api_key>" >> $HOME/.nvqc_config
+
diff --git a/pr-2241/sphinx/using/backends/platform.rst b/pr-2241/sphinx/using/backends/platform.rst
new file mode 100644
index 0000000000..18753617c9
--- /dev/null
+++ b/pr-2241/sphinx/using/backends/platform.rst
@@ -0,0 +1,341 @@
+Multi-Processor Platforms
+---------------------------------------------------
+The CUDA-Q machine model elucidates the various devices considered in the 
+broader quantum-classical compute node context. Programmers will have one or many 
+host CPUs, zero or many NVIDIA GPUs, a classical QPU control space, and the
+quantum register itself. Moreover, the :doc:`specification </specification/cudaq/platform>`
+notes that the underlying platform may expose multiple QPUs. In the near-term,
+this will be unlikely with physical QPU instantiations, but the availability of
+GPU-based circuit simulators on NVIDIA multi-GPU architectures does give one an
+opportunity to think about programming such a multi-QPU architecture in the near-term.
+CUDA-Q starts by enabling one to query information about the underlying quantum
+platform via the :code:`quantum_platform` abstraction. This type exposes a
+:code:`num_qpus()` method that can be used to query the number of available
+QPUs for asynchronous CUDA-Q kernel and :code:`cudaq::` function invocations.
+Each available QPU is assigned a logical index, and programmers can launch
+specific asynchronous function invocations targeting a desired QPU.
+
+.. _mqpu-platform:
+
+NVIDIA `MQPU` Platform
+++++++++++++++++++++++
+
+In the multi-QPU mode (:code:`mqpu` option), the NVIDIA target provides a simulated QPU for every available NVIDIA GPU on the underlying system. 
+Each QPU is simulated via a `cuStateVec` simulator backend as defined by the NVIDIA target. For more information about using multiple GPUs 
+to simulate each virtual QPU, or using a different backend for virtual QPUs, please see :ref:`remote MQPU platform <remote-mqpu-platform>`.
+This target enables asynchronous parallel execution of quantum kernel tasks.
+
+Here is a simple example demonstrating its usage.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/sample_async.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/sample_async.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+
+    One can specify the target multi-QPU architecture with the :code:`--target` flag:
+    
+    .. code-block:: console
+
+        nvq++ sample_async.cpp --target nvidia --target-option mqpu
+        ./a.out
+
+CUDA-Q exposes asynchronous versions of the default :code:`cudaq` algorithmic
+primitive functions like :code:`sample`, :code:`observe`, and :code:`get_state` 
+(e.g., :code:`sample_async` function in the above code snippets).
+
+Depending on the number of GPUs available on the system, the :code:`nvidia` multi-QPU platform will create the same number of virtual QPU instances.
+For example, on a system with 4 GPUs, the above code will distribute the four sampling tasks among those :code:`GPUEmulatedQPU` instances.
+
+The results might look like the following 4 different random samplings:
+
+.. code-block:: console
+  
+    Number of QPUs: 4
+    { 10011:28 01100:28 ... }
+    { 10011:37 01100:25 ... }
+    { 10011:29 01100:25 ... }
+    { 10011:33 01100:30 ... }
+
+.. note::
+
+  By default, the :code:`nvidia` multi-QPU platform will utilize all available GPUs (number of QPUs instances is equal to the number of GPUs).
+  To specify the number QPUs to be instantiated, one can set the :code:`CUDAQ_MQPU_NGPUS` environment variable.
+  For example, use :code:`export CUDAQ_MQPU_NGPUS=2` to specify that only 2 QPUs (GPUs) are needed.
+
+Since the underlying :code:`GPUEmulatedQPU` is a simulator backend, we can also retrieve the state vector from each
+QPU via the :code:`cudaq::get_state_async` (C++) or :code:`cudaq.get_state_async` (Python) as shown in the bellow code snippets.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/get_state_async.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/get_state_async.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+
+    One can specify the target multi-QPU architecture with the :code:`--target` flag:
+    
+    .. code-block:: console
+
+        nvq++ get_state_async.cpp --target nvidia --target-option mqpu
+        ./a.out
+
+.. deprecated:: 0.8
+    The :code:`nvidia-mqpu` and :code:`nvidia-mqpu-fp64` targets, which are equivalent to the multi-QPU options `mgpu,fp32` and `mgpu,fp64`, respectively, of the :code:`nvidia` target, are deprecated and will be removed in a future release.
+
+Parallel distribution mode
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The CUDA-Q :code:`nvidia` multi-QPU platform supports two modes of parallel distribution of expectation value computation:
+
+* MPI: distribute the expectation value computations across available MPI ranks and GPUs for each Hamiltonian term.
+* Thread: distribute the expectation value computations among available GPUs via standard C++ threads (each thread handles one GPU).
+
+For instance, if all GPUs are available on a single node, thread-based parallel distribution 
+(:code:`cudaq::parallel::thread` in C++ or :code:`cudaq.parallel.thread` in Python, as shown in the above example) is sufficient.
+On the other hand, if one wants to distribute the tasks across GPUs on multiple nodes, e.g., on a compute cluster, MPI distribution mode
+should be used.
+
+An example of MPI distribution mode usage in both C++ and Python is given below:
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/observe_mqpu_mpi.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+    .. code-block:: console
+
+        mpiexec -np <N> python3 file.py
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/observe_mqpu_mpi.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+    .. code-block:: console
+
+        nvq++ file.cpp --target nvidia --target-option mqpu
+        mpiexec -np <N> a.out
+
+In the above example, the parallel distribution mode was set to :code:`mpi` using :code:`cudaq::parallel::mpi` in C++ or :code:`cudaq.parallel.mpi` in Python.
+CUDA-Q provides MPI utility functions to initialize, finalize, or query (rank, size, etc.) the MPI runtime. 
+Last but not least, the compiled executable (C++) or Python script needs to be launched with an appropriate MPI command, 
+e.g., :code:`mpiexec`, :code:`mpirun`, :code:`srun`, etc.
+
+Remote `MQPU` Platform
++++++++++++++++++++++++++++
+
+.. _remote-mqpu-platform:
+
+As shown in the above examples, the multi-QPU NVIDIA platform enables
+multi-QPU distribution whereby each QPU is simulated by a :ref:`single NVIDIA GPU <cuQuantum single-GPU>`.
+To run multi-QPU workloads on different simulator backends, one can use the :code:`remote-mqpu` platform,
+which encapsulates simulated QPUs as independent HTTP REST server instances. 
+The following code illustrates how to launch asynchronous sampling tasks on multiple virtual QPUs, 
+each simulated by a `tensornet` simulator backend.
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/sample_async_remote.py
+        :language: python
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/sample_async_remote.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+    The code above is saved in `sample_async.cpp` and compiled with the following command, targeting the :code:`remote-mqpu` platform:
+
+    .. code-block:: console
+
+        nvq++ sample_async.cpp -o sample_async.x --target remote-mqpu --remote-mqpu-backend tensornet --remote-mqpu-auto-launch 2
+        ./sample_async.x
+
+In the above code snippets, the :code:`remote-mqpu` platform was used in the auto-launch mode,
+whereby a specific number of server instances, i.e., virtual QPUs, are launched on the local machine
+in the background. The remote QPU daemon service, :code:`cudaq-qpud`, will also be shut down automatically
+at the end of the session.
+
+.. note:: 
+    By default, auto launching daemon services do not support MPI parallelism.
+    Hence, using the `nvidia-mgpu` backend to simulate each virtual QPU requires 
+    manually launching each server instance. How to do that is explained in the rest of this section.
+
+.. _custom_remote_qpud_launch:
+
+To customize how many and which GPUs are used for simulating each virtual QPU, one can launch each server manually.
+For instance, on a machine with 8 NVIDIA GPUs, one may wish to partition those GPUs into
+4 virtual QPU instances, each manages 2 GPUs. To do so, first launch a :code:`cudaq-qpud` server for each virtual QPU:
+
+.. tab:: Python
+
+     .. See scripts/validate_wheel.sh for examples of how similar commands are run automatically during release validation.
+
+     .. code-block:: bash
+         
+         # Use cudaq-qpud.py wrapper script to automatically find dependencies for the Python wheel configuration.
+         cudaq_location=`python3 -m pip show cuda-quantum | grep -e 'Location: .*$'`
+         qpud_py="${cudaq_location#Location: }/bin/cudaq-qpud.py"
+         CUDA_VISIBLE_DEVICES=0,1 mpiexec -np 2 python3 "$qpud_py" --port <QPU 1 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=2,3 mpiexec -np 2 python3 "$qpud_py" --port <QPU 2 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=4,5 mpiexec -np 2 python3 "$qpud_py" --port <QPU 3 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=6,7 mpiexec -np 2 python3 "$qpud_py" --port <QPU 4 TCP/IP port number>
+
+.. tab:: C++
+     
+     .. code-block:: bash
+         
+         # It is assumed that your $LD_LIBRARY_PATH is able to find all the necessary dependencies.
+         CUDA_VISIBLE_DEVICES=0,1 mpiexec -np 2 cudaq-qpud --port <QPU 1 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=2,3 mpiexec -np 2 cudaq-qpud --port <QPU 2 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=4,5 mpiexec -np 2 cudaq-qpud --port <QPU 3 TCP/IP port number>
+         CUDA_VISIBLE_DEVICES=6,7 mpiexec -np 2 cudaq-qpud --port <QPU 4 TCP/IP port number>
+
+
+In the above code snippet, four :code:`nvidia-mgpu` daemons are started in MPI context via the :code:`mpiexec` launcher.
+This activates MPI runtime environment required by the :code:`nvidia-mgpu` backend. Each QPU daemon is assigned a unique 
+TCP/IP port number via the :code:`--port` command-line option. The :code:`CUDA_VISIBLE_DEVICES` environment variable restricts the GPU devices 
+that each QPU daemon sees so that it targets specific GPUs. 
+
+With these invocations, each virtual QPU is locally addressable at the URL `localhost:<port>`. 
+
+.. warning:: 
+
+    There is no authentication required to communicate with this server app. 
+    Hence, please make sure to either (1) use a non-public TCP/IP port for internal use or 
+    (2) use firewalls or other security mechanisms to manage user access. 
+
+User code can then target these QPUs for multi-QPU workloads, such as asynchronous sample or observe shown above for the multi-QPU NVIDIA platform platform.
+
+.. tab:: Python
+
+     .. code:: python 
+
+        cudaq.set_target("remote-mqpu", url="localhost:<port1>,localhost:<port2>,localhost:<port3>,localhost:<port4>", backend="nvidia-mgpu")
+        
+.. tab:: C++
+
+    .. code-block:: console
+
+        nvq++ distributed.cpp --target remote-mqpu --remote-mqpu-url localhost:<port1>,localhost:<port2>,localhost:<port3>,localhost:<port4> --remote-mqpu-backend nvidia-mgpu
+    
+
+Each URL is treated as an independent QPU, hence the number of QPUs (:code:`num_qpus()`) is equal to the number of URLs provided. 
+The multi-node multi-GPU simulator backend (:code:`nvidia-mgpu`) is requested via the :code:`--remote-mqpu-backend` command-line option.
+
+.. note:: 
+
+    The requested backend (:code:`nvidia-mgpu`) will be executed inside the context of the QPU daemon service, thus 
+    inherits its GPU resource allocation (two GPUs per backend simulator instance). 
+
+Supported Kernel Arguments
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The platform serializes kernel invocation to QPU daemons via REST APIs. 
+Please refer to the `Open API Docs <../../openapi.html>`_  for the latest API information.
+Runtime arguments are serialized into a flat memory buffer (`args` field of the request JSON). 
+For more information about argument type serialization, please see :ref:`the table below <type_serialization_table>`.
+
+When using a remote backend to simulate each virtual QPU, 
+by default, we currently do not support passing complex data structures, 
+such as nested vectors or class objects, or other kernels as arguments to the entry point kernels.
+These type limitations only apply to the **entry-point** kernel and not when passing arguments
+to other quantum kernels.
+
+Support for the full range of argument types within CUDA-Q can be enabled by compiling the 
+code with the :code:`--enable-mlir` option. This flag forces quantum kernels to be compiled with 
+the CUDA-Q MLIR-based compiler. As a result, runtime arguments can be resolved by the CUDA 
+Quantum compiler infrastructure to support wider range of argument types. However, certain
+language constructs within quantum kernels may not yet be fully supported.
+
+.. _type_serialization_table:
+
+.. list-table:: Kernel argument serialization
+   :widths: 50 50 50
+   :header-rows: 1
+
+   * - Data type
+     - Example
+     - Serialization
+   * -  Trivial type (occupies a contiguous memory area)
+     -  `int`, `std::size_t`, `double`, etc.
+     - Byte data (via `memcpy`)
+   * - `std::vector` of trivial type
+     - `std::vector<int>`, `std::vector<double>`, etc. 
+     - Total vector size in bytes as a 64-bit integer followed by serialized data of all vector elements.
+   * - `cudaq::pauli_word`
+     - `cudaq::pauli_word("IXIZ")`
+     - Same as `std::vector<char>`: total vector size in bytes as a 64-bit integer followed by serialized data of all characters.
+   * - Single-level nested `std::vector` of supported `std::vector` types
+     - `std::vector<std::vector<int>>`, `std::vector<cudaq::pauli_word>`, etc. 
+     - Number of top-level elements (as a 64-bit integer) followed sizes in bytes of element vectors (as a contiguous array of 64-bit integers) then serialized data of the inner vectors.
+     
+For CUDA-Q kernels that return a value, the remote platform supports returning simple data types of 
+`bool`, integral (e.g., `int` or `std::size_t`), and floating-point types (`float` or `double`) 
+when MLIR-based compilation is enabled (:code:`--enable-mlir`).
+
+Accessing Simulated Quantum State
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The remote `MQPU` platform supports accessing simulator backend's state vector via the 
+`cudaq::get_state` (C++) or `cudaq.get_state` (Python) APIs, similar to local simulator backends.
+
+State data can be retrieved as a full state vector or as individual basis states' amplitudes.
+The later is designed for large quantum states, which incurred data transfer overheads.
+
+.. tab:: Python
+
+    .. code:: python 
+        
+        state = cudaq.get_state(kernel)
+        amplitudes = state.amplitudes(['0000', '1111'])
+        
+.. tab:: C++
+
+    .. code-block:: cpp
+        
+        auto state = cudaq::get_state(kernel)
+        auto amplitudes = state.amplitudes({{0, 0, 0, 0}, {1, 1, 1, 1}});
+
+In the above example, the amplitudes of the two requested states are returned.
+
+For C++ quantum kernels [*]_ compiled with the CUDA-Q MLIR-based compiler and Python kernels,
+state accessor is evaluated in a just-in-time/on-demand manner, and hence can be customize to
+users' need.
+
+For instance, in the above amplitude access example, if the state vector is very large, e.g.,
+multi-GPU distributed state vectors or tensor-network encoded quantum states, the full state vector
+will not be retrieved when `get_state` is called. Instead, when the `amplitudes` accessor is called,
+a specific amplitude calculation request will be sent to the server. 
+Thus, only the amplitudes of those basis states will be computed and returned. 
+
+Similarly, for state overlap calculation, if deferred state evaluation is available (Python/MLIR-based compiler)
+for both of the operand quantum states, a custom overlap calculation request will be constructed and sent to the server.
+Only the final overlap result will be returned, thereby eliminating back-and-forth state data transfers. 
+
+.. [*] Only C++ quantum kernels whose names are available via run-time type information (RTTI) are supported.
+    For example, quantum kernels expressed as named `struct` are supported but not standalone functions.
+    Kernels that do not have deferred state evaluation support will perform synchronous `get_state`, whereby the full state
+    vector is returned from the server immediately.   
diff --git a/pr-2241/sphinx/using/backends/simulators.rst b/pr-2241/sphinx/using/backends/simulators.rst
new file mode 100644
index 0000000000..dab80d3243
--- /dev/null
+++ b/pr-2241/sphinx/using/backends/simulators.rst
@@ -0,0 +1,517 @@
+CUDA-Q Simulation Backends
+*********************************
+
+.. _nvidia-backend:
+
+The simulation backends that are currently available in CUDA-Q are as follows.
+
+State Vector Simulators
+==================================
+
+The :code:`nvidia` target provides a state vector simulator accelerated with 
+the :code:`cuStateVec` library. 
+
+The :code:`nvidia` target supports multiple configurable options.
+
+Features 
++++++++++
+
+* Floating-point precision configuration 
+
+The floating point precision of the state vector data can be configured to either 
+double (`fp64`) or single (`fp32`) precision. This option can be chosen for the optimal performance and accuracy.
+
+
+* Distributed simulation
+
+The :code:`nvidia` target supports distributing state vector simulations to multiple GPUs and multiple nodes (`mgpu` :ref:`distribution <nvidia-mgpu-backend>`)
+and multi-QPU (`mqpu` :ref:`platform <mqpu-platform>`) distribution whereby each QPU is simulated via a single-GPU simulator instance.
+
+
+* Host CPU memory utilization 
+
+Host CPU memory can be leveraged in addition to GPU memory to accommodate the state vector 
+(i.e., maximizing the number of qubits to be simulated).
+
+.. _cuQuantum single-GPU:
+
+
+Single-GPU 
+++++++++++++++++++++++++++++++++++
+
+To execute a program on the :code:`nvidia` target, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target nvidia
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('nvidia')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target nvidia program.cpp [...] -o program.x
+        ./program.x
+
+.. _nvidia-fp64-backend:
+
+By default, this will leverage :code:`FP32` floating point types for the simulation. To 
+switch to :code:`FP64`, specify the :code:`--target-option fp64` `nvq++` command line option for `C++` and `Python` or 
+use `cudaq.set_target('nvidia', option='fp64')` for Python in-source target modification instead. 
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target nvidia --target-option fp64
+
+    The precision of the :code:`nvidia` target can also be modified in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('nvidia', option='fp64')
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target nvidia --target-option fp64 program.cpp [...] -o program.x
+        ./program.x
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU and CUDA runtime libraries. If you do not have these dependencies installed, you may encounter an error stating `Invalid simulator requested`. See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+
+In the single-GPU mode, the :code:`nvidia` target provides the following
+environment variable options. Any environment variables must be set prior to
+setting the target.
+
+.. list-table:: **Environment variable options supported in single-GPU mode**
+  :widths: 20 30 50
+
+  * - Option
+    - Value
+    - Description
+  * - ``CUDAQ_FUSION_MAX_QUBITS``
+    - positive integer
+    - The max number of qubits used for gate fusion. The default value is `4`.
+  * - ``CUDAQ_FUSION_DIAGONAL_GATE_MAX_QUBITS``
+    - integer greater than or equal to -1
+    - The max number of qubits used for diagonal gate fusion. The default value is set to `-1` and the fusion size will be automatically adjusted for the better performance. If 0, the gate fusion for diagonal gates is disabled.
+  * - ``CUDAQ_FUSION_NUM_HOST_THREADS``
+    - positive integer
+    - Number of CPU threads used for circuit processing. The default value is `8`.
+  * - ``CUDAQ_MAX_CPU_MEMORY_GB``
+    - non-negative integer, or `NONE`
+    - CPU memory size (in GB) allowed for state-vector migration. `NONE` means unlimited (up to physical memory constraints). Default is 0 (disabled). 
+  * - ``CUDAQ_MAX_GPU_MEMORY_GB``
+    - positive integer, or `NONE`
+    - GPU memory (in GB) allowed for on-device state-vector allocation. As the state-vector size exceeds this limit, host memory will be utilized for migration. `NONE` means unlimited (up to physical memory constraints). This is the default. 
+
+.. deprecated:: 0.8
+    The :code:`nvidia-fp64` targets, which is equivalent setting the `fp64` option on the :code:`nvidia` target, 
+    is deprecated and will be removed in a future release.
+
+.. _nvidia-mgpu-backend:
+
+Multi-node multi-GPU
+++++++++++++++++++++++++++++++++++
+
+The NVIDIA target also provides a state vector simulator accelerated with 
+the :code:`cuStateVec` library with support for Multi-Node, Multi-GPU distribution of the 
+state vector, in addition to a single GPU.
+
+The multi-node multi-GPU simulator expects to run within an MPI context.
+To execute a program on the multi-node multi-GPU NVIDIA target, use the following commands 
+(adjust the value of the :code:`-np` flag as needed to reflect available GPU resources on your system):
+
+.. tab:: Python
+
+    Double precision simulation:
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 program.py [...] --target nvidia --target-option fp64,mgpu
+
+    Single precision simulation:
+    
+    .. code:: bash 
+
+        mpiexec -np 2 python3 program.py [...] --target nvidia --target-option fp32,mgpu
+
+    .. note::
+
+      If you installed CUDA-Q via :code:`pip`, you will need to install the necessary MPI dependencies separately;
+      please follow the instructions for installing dependencies in the `Project Description <https://pypi.org/project/cuda-quantum/#description>`__.
+
+    In addition to using MPI in the simulator, you can use it in your application code by installing `mpi4py <https://mpi4py.readthedocs.io/>`__, and 
+    invoking the program with the command
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 -m mpi4py program.py [...] --target nvidia --target-option fp64,mgpu
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('nvidia', option='mgpu,fp64')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+    .. note::
+        
+        * The order of the option settings are interchangeable.
+          For example, `cudaq.set_target('nvidia', option='mgpu,fp64')` is equivalent to `cudaq.set_target('nvidia', option='fp64,mgpu')`.
+
+        * The `nvidia` target has single-precision as the default setting. Thus, using `option='mgpu'` implies that `option='mgpu,fp32'`.  
+
+.. tab:: C++
+
+    Double precision simulation:
+
+    .. code:: bash 
+
+        nvq++ --target nvidia  --target-option mgpu,fp64 program.cpp [...] -o program.x
+        mpiexec -np 2 ./program.x
+
+    Single precision simulation:
+
+    .. code:: bash 
+
+        nvq++ --target nvidia  --target-option mgpu,fp32 program.cpp [...] -o program.x
+        mpiexec -np 2 ./program.x
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU, CUDA runtime libraries, as well as an MPI installation. If you do not have these dependencies installed, you may encounter either an error stating `invalid simulator requested` (missing CUDA libraries), or an error along the lines of `failed to launch kernel` (missing MPI installation). See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+  
+  The number of processes and nodes should be always power-of-2. 
+
+  Host-device state vector migration is also supported in the multi-node multi-GPU configuration. 
+
+
+In addition to those environment variable options supported in the single-GPU mode,
+the :code:`nvidia` target provides the following environment variable options particularly for 
+the multi-node multi-GPU configuration. Any environment variables must be set
+prior to setting the target.
+
+.. list-table:: **Additional environment variable options for multi-node multi-GPU mode**
+  :widths: 20 30 50
+
+  * - Option
+    - Value
+    - Description
+  * - ``CUDAQ_MGPU_LIB_MPI``
+    - string
+    - The shared library name for inter-process communication. The default value is `libmpi.so`.
+  * - ``CUDAQ_MGPU_COMM_PLUGIN_TYPE``
+    - `AUTO`, `EXTERNAL`, `OpenMPI`, or `MPICH` 
+    - Selecting :code:`cuStateVec` `CommPlugin` for inter-process communication. The default is `AUTO`. If `EXTERNAL` is selected, `CUDAQ_MGPU_LIB_MPI` should point to an implementation of :code:`cuStateVec` `CommPlugin` interface.
+  * - ``CUDAQ_MGPU_NQUBITS_THRESH``
+    - positive integer
+    - The qubit count threshold where state vector distribution is activated. Below this threshold, simulation is performed as independent (non-distributed) tasks across all MPI processes for optimal performance. Default is 25. 
+  * - ``CUDAQ_MGPU_FUSE``
+    - positive integer
+    - The max number of qubits used for gate fusion. The default value is `6` if there are more than one MPI processes or `4` otherwise.
+  * - ``CUDAQ_MGPU_P2P_DEVICE_BITS``
+    - positive integer
+    - Specify the number of GPUs that can communicate by using GPUDirect P2P. Default value is 0 (P2P communication is disabled).
+  * - ``CUDAQ_GPU_FABRIC``
+    - `MNNVL`, `NVL`, or `NONE`
+    - Automatically set the number of P2P device bits based on the total number of processes when multi-node NVLink (`MNNVL`) is selected; or the number of processes per node when NVLink (`NVL`) is selected; or disable P2P (with `NONE`). 
+  * - ``CUDAQ_GLOBAL_INDEX_BITS``
+    - comma-separated list of positive integers
+    - Specify the inter-node network structure (faster to slower). For example, assuming a 8 nodes, 4 GPUs/node simulation whereby network communication is faster, this `CUDAQ_GLOBAL_INDEX_BITS` environment variable can be set to `3,2`. The first `3` represents **8** nodes with fast communication and the second `2` represents **4** 8-node groups in those total 32 nodes. Default is an empty list (no customization based on network structure of the cluster).
+  * - ``CUDAQ_HOST_DEVICE_MIGRATION_LEVEL``
+    - positive integer
+    - Specify host-device memory migration w.r.t. the network structure. 
+
+.. deprecated:: 0.8
+    The :code:`nvidia-mgpu` target, which is equivalent to the multi-node multi-GPU double-precision option (`mgpu,fp64`) of the :code:`nvidia`
+    is deprecated and will be removed in a future release.
+
+The above configuration options of the :code:`nvidia` backend 
+can be tuned to reduce your simulation runtimes. One of the
+performance improvements is to fuse multiple gates together during runtime. For
+example, :code:`x(qubit0)` and :code:`x(qubit1)` can be fused together into a
+single 4x4 matrix operation on the state vector rather than 2 separate 2x2
+matrix operations on the state vector. This fusion reduces memory bandwidth on
+the GPU because the state vector is transferred into and out of memory fewer
+times. By default, up to 4 gates are fused together for single-GPU simulations,
+and up to 6 gates are fused together for multi-GPU simulations. The number of
+gates fused can **significantly** affect performance of some circuits, so users
+can override the default fusion level by setting the setting `CUDAQ_MGPU_FUSE`
+environment variable to another integer value as shown below.
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        CUDAQ_MGPU_FUSE=5 mpiexec -np 2 python3 program.py [...] --target nvidia --target-option mgpu,fp64
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target nvidia --target-option mgpu,fp64 program.cpp [...] -o program.x
+        CUDAQ_MGPU_FUSE=5 mpiexec -np 2 ./program.x
+
+.. _OpenMP CPU-only:
+
+OpenMP CPU-only
+++++++++++++++++++++++++++++++++++
+
+.. _qpp-cpu-backend:
+
+This target provides a state vector simulator based on the CPU-only, OpenMP threaded `Q++ <https://github.com/softwareqinc/qpp>`_ library.
+This is the default target when running on CPU-only systems.
+
+To execute a program on the :code:`qpp-cpu` target even if a GPU-accelerated backend is available, 
+use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target qpp-cpu
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('qpp-cpu')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target qpp-cpu program.cpp [...] -o program.x
+        ./program.x
+
+
+Clifford-Only Simulation (CPU)
+++++++++++++++++++++++++++++++++++
+
+.. _stim-backend:
+
+This target provides a fast simulator for circuits containing *only* Clifford
+gates. Any non-Clifford gates (such as T gates and Toffoli gates) are not
+supported. This simulator is based on the `Stim <https://github.com/quantumlib/Stim>`_
+library.
+
+To execute a program on the :code:`stim` target, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target stim
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('stim')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target stim program.cpp [...] -o program.x
+        ./program.x
+
+
+Tensor Network Simulators
+==================================
+
+.. _tensor-backends:
+
+CUDA-Q provides a couple of tensor-network simulator targets accelerated with 
+the :code:`cuTensorNet` library. 
+These backends are available for use from both C++ and Python.
+
+Tensor network simulators are suitable for large-scale simulation of certain classes of quantum circuits involving many qubits beyond the memory limit of state vector based simulators. For example, computing the expectation value of a Hamiltonian via :code:`cudaq::observe` can be performed efficiently, thanks to :code:`cuTensorNet` contraction optimization capability. On the other hand, conditional circuits, i.e., those with mid-circuit measurements or reset, despite being supported by both backends, may result in poor performance. 
+
+Multi-node multi-GPU
++++++++++++++++++++++++++++++++++++
+
+The :code:`tensornet` backend represents quantum states and circuits as tensor networks in an exact form (no approximation). 
+Measurement samples and expectation values are computed via tensor network contractions. 
+This backend supports multi-node, multi-GPU distribution of tensor operations required to evaluate and simulate the circuit.
+
+To execute a program on the :code:`tensornet` target using a *single GPU*, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target tensornet
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('tensornet')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target tensornet program.cpp [...] -o program.x
+        ./program.x
+
+If you have *multiple GPUs* available on your system, you can use MPI to automatically distribute parallelization across the visible GPUs. 
+
+.. note::
+
+  If you installed the CUDA-Q Python wheels, distribution across multiple GPUs is currently not supported for this backend.
+  We will add support for it in future releases. For more information, see this `GitHub issue <https://github.com/NVIDIA/cuda-quantum/issues/920>`__.
+
+Use the following commands to enable distribution across multiple GPUs (adjust the value of the :code:`-np` flag as needed to reflect available GPU resources on your system):
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 program.py [...] --target tensornet
+
+    In addition to using MPI in the simulator, you can use it in your application code by installing `mpi4py <https://mpi4py.readthedocs.io/>`__, and 
+    invoking the program with the command
+
+    .. code:: bash 
+
+        mpiexec -np 2 python3 -m mpi4py program.py [...] --target tensornet
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target tensornet program.cpp [...] -o program.x
+        mpiexec -np 2 ./program.x
+
+.. note::
+
+  If the `CUTENSORNET_COMM_LIB` environment variable is not set, MPI parallelization on the :code:`tensornet` backend may fail.
+  If you are using a CUDA-Q container, this variable is pre-configured and no additional setup is needed. If you are customizing your installation or have built CUDA-Q from source, please follow the instructions for `activating the distributed interface <https://docs.nvidia.com/cuda/cuquantum/latest/getting-started/index.html#from-nvidia-devzone>`__ for the `cuTensorNet` library. This requires 
+  :ref:`installing CUDA development dependencies <additional-cuda-tools>`, and setting the `CUTENSORNET_COMM_LIB`
+  environment variable to the newly built `libcutensornet_distributed_interface_mpi.so` library.
+
+Specific aspects of the simulation can be configured by setting the following of environment variables:
+
+* **`CUDA_VISIBLE_DEVICES=X`**: Makes the process only see GPU X on multi-GPU nodes. Each MPI process must only see its own dedicated GPU. For example, if you run 8 MPI processes on a DGX system with 8 GPUs, each MPI process should be assigned its own dedicated GPU via `CUDA_VISIBLE_DEVICES` when invoking `mpiexec` (or `mpirun`) commands. 
+* **`OMP_PLACES=cores`**: Set this environment variable to improve CPU parallelization.
+* **`OMP_NUM_THREADS=X`**: To enable CPU parallelization, set X to `NUMBER_OF_CORES_PER_NODE/NUMBER_OF_GPUS_PER_NODE`.
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU and CUDA runtime libraries. 
+  If you do not have these dependencies installed, you may encounter an error stating `Invalid simulator requested`. 
+  See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+
+.. note::
+
+  Setting random seed, via :code:`cudaq::set_random_seed`, is not supported for this backend due to a limitation of the :code:`cuTensorNet` library. This will be fixed in future release once this feature becomes available.
+
+
+Matrix product state 
++++++++++++++++++++++++++++++++++++
+
+The :code:`tensornet-mps` backend is based on the matrix product state (MPS) representation of the state vector/wave function, exploiting the sparsity in the tensor network via tensor decomposition techniques such as QR and SVD. As such, this backend is an approximate simulator, whereby the number of singular values may be truncated to keep the MPS size tractable. 
+The :code:`tensornet-mps` backend only supports single-GPU simulation. Its approximate nature allows the :code:`tensornet-mps` backend to handle a large number of qubits for certain classes of quantum circuits on a relatively small memory footprint.
+
+To execute a program on the :code:`tensornet-mps` target, use the following commands:
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        python3 program.py [...] --target tensornet-mps
+
+    The target can also be defined in the application code by calling
+
+    .. code:: python 
+
+        cudaq.set_target('tensornet-mps')
+
+    If a target is set in the application code, this target will override the :code:`--target` command line flag given during program invocation.
+
+.. tab:: C++
+
+    .. code:: bash 
+
+        nvq++ --target tensornet-mps program.cpp [...] -o program.x
+        ./program.x
+
+Specific aspects of the simulation can be configured by defining the following environment variables:
+
+* **`CUDAQ_MPS_MAX_BOND=X`**: The maximum number of singular values to keep (fixed extent truncation). Default: 64.
+* **`CUDAQ_MPS_ABS_CUTOFF=X`**: The cutoff for the largest singular value during truncation. Eigenvalues that are smaller will be trimmed out. Default: 1e-5.
+* **`CUDAQ_MPS_RELATIVE_CUTOFF=X`**: The cutoff for the maximal singular value relative to the largest eigenvalue. Eigenvalues that are smaller than this fraction of the largest singular value will be trimmed out. Default: 1e-5
+* **`CUDAQ_MPS_SVD_ALGO=X`**: The SVD algorithm to use. Valid values are: `GESVD` (QR algorithm), `GESVDJ` (Jacobi method), `GESVDP` (`polar decomposition <https://epubs.siam.org/doi/10.1137/090774999>`__), `GESVDR` (`randomized methods <https://epubs.siam.org/doi/10.1137/090771806>`__). Default: `GESVDJ`.
+
+.. note:: 
+
+  This backend requires an NVIDIA GPU and CUDA runtime libraries. 
+  If you do not have these dependencies installed, you may encounter an error stating `Invalid simulator requested`. 
+  See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
+
+.. note::
+
+  Setting random seed, via :code:`cudaq::set_random_seed`, is not supported for this backend due to a limitation of the :code:`cuTensorNet` library. This will be fixed in future release once this feature becomes available.
+
+.. note::
+    The parallelism of Jacobi method (the default `CUDAQ_MPS_SVD_ALGO` setting) gives GPU better performance on small and medium size matrices.
+    If you expect a large number of singular values (e.g., increasing the `CUDAQ_MPS_MAX_BOND` setting), please adjust the `CUDAQ_MPS_SVD_ALGO` setting accordingly.  
+
+Default Simulator
+==================================
+
+.. _default-simulator:
+
+If no explicit target is set, i.e., if the code is compiled without any :code:`--target` flags, then CUDA-Q makes a default choice for the simulator.
+
+If an NVIDIA GPU and CUDA runtime libraries are available, the default target is set to `nvidia`. This will utilize the :ref:`cuQuantum single-GPU state vector simulator <cuQuantum single-GPU>`.  
+On CPU-only systems, the default target is set to `qpp-cpu` which uses the :ref:`OpenMP CPU-only simulator <OpenMP CPU-only>`.
+
+The default simulator can be overridden by the environment variable `CUDAQ_DEFAULT_SIMULATOR`. If no target is explicitly specified and the environment variable has a valid value, then it will take effect.
+This environment variable can be set to any non-hardware backend. Any invalid value is ignored.
+
+For CUDA-Q Python API, the environment variable at the time when `cudaq` module is imported is relevant, not the value of the environment variable at the time when the simulator is invoked.
+
+For example,
+
+.. tab:: Python
+
+    .. code:: bash 
+
+        CUDAQ_DEFAULT_SIMULATOR=density-matrix-cpu python3 program.py [...]
+        
+.. tab:: C++
+
+    .. code:: bash 
+
+        CUDAQ_DEFAULT_SIMULATOR=density-matrix-cpu nvq++ program.cpp [...] -o program.x
+        ./program.x
+
+This will use the density matrix simulator target.
+
+
+.. note:: 
+
+    To use targets that require an NVIDIA GPU and CUDA runtime libraries, the dependencies must be installed, else you may encounter an error stating `Invalid simulator requested`. See the section :ref:`dependencies-and-compatibility` for more information about how to install dependencies.
diff --git a/pr-2241/sphinx/using/basics/basics.rst b/pr-2241/sphinx/using/basics/basics.rst
new file mode 100644
index 0000000000..308ba7492c
--- /dev/null
+++ b/pr-2241/sphinx/using/basics/basics.rst
@@ -0,0 +1,11 @@
+CUDA-Q Basics
+*******************
+
+.. toctree::
+   :caption: Contents
+   :maxdepth: 2
+
+      What is a CUDA-Q Kernel? <kernel_intro.rst>
+      Building your first CUDA-Q Program <build_kernel.rst>
+      Running your first CUDA-Q Program <run_kernel.rst>
+      Troubleshooting <troubleshooting.rst>
diff --git a/pr-2241/sphinx/using/basics/build_kernel.rst b/pr-2241/sphinx/using/basics/build_kernel.rst
new file mode 100644
index 0000000000..08a8d9f9cc
--- /dev/null
+++ b/pr-2241/sphinx/using/basics/build_kernel.rst
@@ -0,0 +1,30 @@
+Building your first CUDA-Q Program
+-----------------------------------------
+
+.. tab:: Python
+
+  We can define our quantum kernel as a typical Python function, with the additional use of the
+  `@cudaq.kernel` decorator. Let's begin with a simple GHZ-state example, producing a state of
+  maximal entanglement amongst an allocated set of qubits. 
+  
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+      :language: python
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+.. tab:: C++
+
+  We can define our quantum kernel as we do any other typed callable in C++, through the use of the
+  `__qpu__` annotation. For the following example, we will define a kernel for a simple GHZ-state as
+  a standard free function.
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+      :language: cpp
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+This kernel function can accept any number of arguments, allowing for flexibility in the construction
+of the quantum program. In this case, the `qubit_count` argument allows us to dynamically control the
+number of qubits allocated to the kernel. As we will see in further :doc:`examples <../examples/examples>`,
+we could also use these arguments to control various parameters of the gates themselves, such as rotation
+angles.
diff --git a/pr-2241/sphinx/using/basics/kernel_intro.rst b/pr-2241/sphinx/using/basics/kernel_intro.rst
new file mode 100644
index 0000000000..aaafcea8a5
--- /dev/null
+++ b/pr-2241/sphinx/using/basics/kernel_intro.rst
@@ -0,0 +1,28 @@
+What is a CUDA-Q kernel?
+-------------------------------
+
+Quantum kernels are defined as functions that are executed on a quantum processing unit (QPU) or
+a simulated QPU. They generalize quantum circuits and provide a new abstraction for quantum programming.
+Quantum kernels can be combined with classical functions to create quantum-classical applications
+that can be executed on a heterogeneous system of QPUs, GPUs, and CPUs to solve real-world problems.
+
+**What’s the difference between a quantum kernel and a quantum circuit?**
+
+Every quantum circuit is a kernel, but not every quantum kernel is a circuit. For instance, a quantum
+kernel can be built up from other kernels, allowing us to interpret a large quantum program as a sequence
+of subroutines or subcircuits.  
+
+Moreover, since quantum kernels are functions, there is more expressibility available compared to a
+standard quantum circuit. We can not only parameterize the kernel, but can also contain classical control
+flow statements (`if`, `for`, `while`, etc.), and classical computations such as additions, multiplication, etc.
+Conditional statements on quantum memory and qubit measurements can be included in quantum kernels to enable 
+dynamic circuits and fast feedback, particularly useful for quantum error correction. To learn more about what
+language constructs are supported within quantum kernels, take a look at the CUDA-Q 
+:doc:`specification <../../specification/cudaq/kernels>`.
+
+**How do I build and run a quantum kernel?**
+
+Once a quantum kernel has been defined in a program, it may be called as a typical function, or can be executed
+using the `sample` or `observe` primitives.
+
+Let’s take a closer look at how to build and execute a quantum kernel with CUDA-Q.
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/basics/run_kernel.rst b/pr-2241/sphinx/using/basics/run_kernel.rst
new file mode 100644
index 0000000000..37a82cf3b4
--- /dev/null
+++ b/pr-2241/sphinx/using/basics/run_kernel.rst
@@ -0,0 +1,258 @@
+Running your first CUDA-Q Program
+----------------------------------------
+
+Now that you have defined your first quantum kernel, let's look at different options for how to execute it.
+In CUDA-Q, quantum circuits are stored as quantum kernels. For estimating the probability distribution of 
+a measured quantum state in a circuit, we use the ``sample`` function call, and for computing the
+expectation value of a quantum state with a given observable, we use the ``observe`` function call.
+
+Sample
+++++++++
+
+Quantum states collapse upon measurement and hence need to be sampled many times to gather statistics. The CUDA-Q `sample` call enables this.
+
+.. tab:: Python
+
+  The :func:`cudaq.sample` method takes a kernel and its arguments as inputs, and returns a :class:`cudaq.SampleResult`.
+
+.. tab:: C++
+
+  The `cudaq::sample` method takes a kernel and its arguments as inputs, and returns a `cudaq::SampleResult`.
+
+This result dictionary contains the distribution of measured states for the system.
+
+Continuing with the GHZ kernel defined in :doc:`Building Your First CUDA-Q Program <build_kernel>`,
+we will set the concrete value of our `qubit_count` to be two.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin Sample1]
+        :end-before: [End Sample1]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+        :language: cpp
+        :start-after: [Begin Sample1]
+        :end-before: [End Sample1]
+
+The code above can be run like any other program:
+
+.. tab:: Python
+
+  Assuming the program is saved in the file `sample.py`, we can execute is with the command
+
+  .. code-block:: console
+
+      python3 sample.py
+
+.. tab:: C++
+
+  Assuming the program is saved in the file `sample.cpp`, we can now compile this file with the `nvq++` toolchain, and then run the compiled executable.
+
+  .. code-block:: console
+
+      nvq++ sample.cpp
+      ./a.out
+
+By default, `sample` produces an ensemble of 1000 shots. This can be changed by specifying an integer argument
+for the `shots_count`.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin Sample2]
+        :end-before: [End Sample2]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+        :language: cpp
+        :start-after: [Begin Sample2]
+        :end-before: [End Sample2]
+
+Note that there is a subtle difference between how sample is executed with the target device set to a simulator or with the target device set to a QPU. When run on a simulator, the quantum state is built once and then sampled repeatedly, where the number of samples is defined by `shots_count`. When executed on quantum hardware, the quantum state collapses upon measurement and hence needs to be rebuilt every time to collect a sample.
+
+A variety of methods can be used to extract useful information from a `SampleResult`. For example,
+to return the most probable measurement and its respective probability:
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin Sample3]
+        :end-before: [End Sample3]
+
+  See the :doc:`API specification <../../../api/languages/python_api>` for further information.
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_sample.cpp
+        :language: cpp
+        :start-after: [Begin Sample3]
+        :end-before: [End Sample3]
+
+  See the :doc:`API specification <../../../api/languages/cpp_api>` for further information.
+
+Sampling a distribution can be a time intensive task. An asynchronous version of sample exists and can be useful to parallelize your application. Asynchronous programming is a technique that enables your program to start a potentially long-running task and still be able to be responsive to other events while that task runs, rather than having to wait until that task has finished. Once that task has finished, your program is presented with the result.
+
+Asynchronous execution allows to easily parallelize execution of multiple kernels on a multi-processor platform. Such a platform
+is available, for example, by choosing the target `nvidia-mqpu`:
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_sample.py
+        :language: python
+        :start-after: [Begin SampleAsync]
+        :end-before: [End SampleAsync]
+
+.. note::
+
+  This kind of parallelization is most effective
+  if you actually have multiple QPU or CPU available. Otherwise, the 
+  sampling will still have to execute sequentially due to resource constraints. 
+
+More information about parallelizing execution can be found at :doc:`../backends/platform` page.
+
+Observe
++++++++++
+
+The observe function allows us to calculate expectation values for a defined quantum operator, that is the value of :math:`\bra{\psi}H\ket{\psi}`, where :math:`H` is the desired operator and :math:`\ket{\psi}` is the quantum state after executing a given kernel. 
+
+.. tab:: Python
+
+  The :func:`cudaq.observe` method takes a kernel and its arguments as inputs, along with a :class:`cudaq.SpinOperator`.
+
+  Using the `cudaq.spin` module, operators may be defined as a linear combination of Pauli strings. Functions, such
+  as :func:`cudaq.spin.i`, :func:`cudaq.spin.x`, :func:`cudaq.spin.y`, :func:`cudaq.spin.z` may be used to construct more
+  complex spin Hamiltonians on multiple qubits.
+
+.. tab:: C++
+
+  The `cudaq::observe` method takes a kernel and its arguments as inputs, along with a `cudaq::spin_op`.
+
+  Within the `cudaq::spin` namespace, operators may be defined as a linear combination of Pauli strings. Functions, such
+  as `cudaq::spin::i`, `cudaq::spin::x`, `cudaq::spin::y`, `cudaq::spin::z` may be used to construct more
+  complex spin Hamiltonians on multiple qubits.
+
+Below is an example of a spin operator object consisting of a `Z(0)` operator, or a Pauli Z-operator on the qubit zero. 
+This is followed by the construction of a kernel with a single qubit in an equal superposition. 
+The Hamiltonian is printed to confirm it has been constructed properly.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_observe.py
+        :language: python
+        :start-after: [Begin Observe1]
+        :end-before: [End Observe1]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_observe.cpp
+        :language: cpp
+        :start-after: [Begin Observe1]
+        :end-before: [End Observe1]
+
+The `observe` function takes a kernel, any kernel arguments, and a spin operator as inputs and produces an `ObserveResult` object.
+The expectation value can be printed using the `expectation` method. 
+
+.. note:: 
+  
+  It is important to exclude a measurement in the kernel, otherwise the expectation value will be determined from a collapsed 
+  classical state. For this example, the expected result of 0.0 is produced.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_observe.py
+        :language: python
+        :start-after: [Begin Observe2]
+        :end-before: [End Observe2]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_observe.cpp
+        :language: cpp
+        :start-after: [Begin Observe2]
+        :end-before: [End Observe2]
+
+Unlike `sample`, the default `shots_count` for `observe` is 1. This result is deterministic and equivalent to the
+expectation value in the limit of infinite shots.  To produce an approximate expectation value from sampling, `shots_count` can
+be specified to any integer.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/first_observe.py
+        :language: python
+        :start-after: [Begin Observe3]
+        :end-before: [End Observe3]
+
+.. tab:: C++
+
+  .. literalinclude:: ../../snippets/cpp/using/first_observe.cpp
+        :language: cpp
+        :start-after: [Begin Observe3]
+        :end-before: [End Observe3]
+
+Similar to `sample_async` above, observe also supports asynchronous execution. 
+More information about parallelizing execution can be found at 
+:doc:`../backends/platform` page.
+
+Running on a GPU
+++++++++++++++++++
+
+.. tab:: Python
+
+  Using :func:`cudaq.set_target`, different targets can be specified for kernel execution.
+
+.. tab:: C++
+
+  Using the `--target` argument to `nvq++`, different targets can be specified for kernel execution.
+
+If a local GPU is detected, the target will default to `nvidia`. Otherwise, the CPU-based simulation
+target, `qpp-cpu`,  will be selected.
+  
+We will demonstrate the benefits of using a GPU by sampling our GHZ kernel with 25 qubits and a
+`shots_count` of 1 million. Using a GPU accelerates this task by more than 35x. To learn about
+all of the available targets and ways to accelerate kernel execution, visit the
+:doc:`Backends <../backends/backends>` page.
+
+.. tab:: Python
+
+  .. literalinclude:: ../../snippets/python/using/time.py
+        :language: python
+        :start-after: [Begin Time]
+        :end-before: [End Time]
+
+.. tab:: C++
+
+  To compare the performance, we can create a simple timing script that isolates just the call
+  to `cudaq::sample`. We are still using the same GHZ kernel as earlier, but the following
+  modification made to the main function:
+
+  .. literalinclude:: ../../snippets/cpp/using/time.cpp
+    :language: cpp
+    :start-after: [Begin Time]
+    :end-before: [End Time]
+
+  First we execute on the CPU backend:
+
+  .. code:: console
+
+    nvq++ --target=qpp-cpu sample.cpp
+    ./a.out
+  
+  seeing an output of the order:
+  ``It took 22.8337 seconds.``
+
+  Now we can execute on the GPU enabled backend:
+
+  .. code:: console
+
+    nvq++ --target=nvidia sample.cpp
+    ./a.out
+
+  seeing an output of the order:
+  ``It took 3.18988 seconds.``
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/basics/troubleshooting.rst b/pr-2241/sphinx/using/basics/troubleshooting.rst
new file mode 100644
index 0000000000..608e7086f6
--- /dev/null
+++ b/pr-2241/sphinx/using/basics/troubleshooting.rst
@@ -0,0 +1,41 @@
+Troubleshooting
+-----------------
+
+Debugging and Verbose Simulation Output
++++++++++++++++++++++++++++++++++++++++++
+
+One helpful mechanism of debugging CUDA-Q simulation execution is
+the :code:`CUDAQ_LOG_LEVEL` environment variable. For any CUDA-Q
+executable, just prepend this and turn it on:
+
+.. tab:: Python
+
+  .. code-block:: bash
+
+      CUDAQ_LOG_LEVEL=info python3 file.py
+
+.. tab:: C++
+
+    .. code-block:: bash
+
+      CUDAQ_LOG_LEVEL=info ./a.out
+
+Similarly, one may write the IR to their console or to a file before remote
+submission. This may be done through the :code:`CUDAQ_DUMP_JIT_IR` environment
+variable. For any CUDA-Q executable, just prepend as follows:
+
+.. tab:: Python
+
+  .. code-block:: bash
+
+      CUDAQ_DUMP_JIT_IR=1 python3 file.py
+      # or
+      CUDAQ_DUMP_JIT_IR=<output_filename> python3 file.py
+
+.. tab:: C++
+
+  .. code-block:: bash
+
+      CUDAQ_DUMP_JIT_IR=1 ./a.out
+      # or
+      CUDAQ_DUMP_JIT_IR=<output_filename> ./a.out
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/cpp.html b/pr-2241/sphinx/using/cpp.html
new file mode 100644
index 0000000000..e469576d37
--- /dev/null
+++ b/pr-2241/sphinx/using/cpp.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=examples/examples.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/cudaq.html b/pr-2241/sphinx/using/cudaq.html
new file mode 100644
index 0000000000..cb0b9e3428
--- /dev/null
+++ b/pr-2241/sphinx/using/cudaq.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=basics/basics.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/cudaq/generic_functions.html b/pr-2241/sphinx/using/cudaq/generic_functions.html
new file mode 100644
index 0000000000..ae4fa6447a
--- /dev/null
+++ b/pr-2241/sphinx/using/cudaq/generic_functions.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=../basics/run_kernel.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/cudaq/kernel.html b/pr-2241/sphinx/using/cudaq/kernel.html
new file mode 100644
index 0000000000..17adbfb423
--- /dev/null
+++ b/pr-2241/sphinx/using/cudaq/kernel.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=../basics/kernel_intro.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/cudaq/variational.html b/pr-2241/sphinx/using/cudaq/variational.html
new file mode 100644
index 0000000000..f8aa0402ec
--- /dev/null
+++ b/pr-2241/sphinx/using/cudaq/variational.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=../examples/vqe.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/cudaq/verbose_out.html b/pr-2241/sphinx/using/cudaq/verbose_out.html
new file mode 100644
index 0000000000..1bed458ae7
--- /dev/null
+++ b/pr-2241/sphinx/using/cudaq/verbose_out.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=../basics/troubleshooting.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/examples/bernstein_vazirani.rst b/pr-2241/sphinx/using/examples/bernstein_vazirani.rst
new file mode 100644
index 0000000000..fe6139529d
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/bernstein_vazirani.rst
@@ -0,0 +1,23 @@
+Bernstein-Vazirani
+--------------------------------
+
+The Bernstein-Vazirani algorithm aims to identify the bitstring encoded in a given function. 
+
+For the original source of this algorithm, see 
+`this publication <https://epubs.siam.org/doi/10.1137/S0097539796300921>`__.
+
+In this example, we generate a random bitstring and encode it into an inner-product oracle, 
+and define a kernel for the Bernstein-Vazirani algorithm.  Then, we simulate the kernel and return the most probable bitstring from its execution.
+
+
+If all goes well, the state measured with the highest probability should be our hidden bitstring!
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/bernstein_vazirani.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/bernstein_vazirani.cpp
+      :language: cpp
diff --git a/pr-2241/sphinx/using/examples/cuquantum.rst b/pr-2241/sphinx/using/examples/cuquantum.rst
new file mode 100644
index 0000000000..1eefb5f103
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/cuquantum.rst
@@ -0,0 +1,30 @@
+Simulations with cuQuantum
+-----------------------------------
+
+CUDA-Q provides support for cuQuantum-accelerated state vector and tensor network 
+simulations. Let's take a look at an example that is too large for a standard CPU-only simulator, but 
+can be trivially simulated via a NVIDIA GPU-accelerated backend:
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/cuquantum_backends.py
+      :language: python
+
+   Here we generate a GHZ state on 28 qubits. The built-in cuQuantum state vector
+   backend is selected by default if a local GPU is present. Alternatively, the
+   target may be manually set through the `cudaq.set_target("nvidia")` command.
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/cuquantum_backends.cpp
+      :language: cpp
+
+   Here we generate a GHZ state on 28 qubits. To run with the built-in cuQuantum state 
+   vector support, we pass the :code:`--target nvidia` flag at compile time:
+
+   .. code:: bash 
+
+      nvq++ --target nvidia cuquantum_backends.cpp -o ghz.x
+      ./ghz.x
+
+   Alternatively, we can set the environment variable `CUDAQ_DEFAULT_SIMULATOR` to `nvidia`.
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/examples/examples.rst b/pr-2241/sphinx/using/examples/examples.rst
new file mode 100644
index 0000000000..2c35b360a3
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/examples.rst
@@ -0,0 +1,21 @@
+*************************
+CUDA-Q by Example
+*************************
+
+Examples that illustrate how to use CUDA-Q for application development are available in C++ and Python.
+
+.. toctree::
+   :maxdepth: 1
+
+      Introduction <introduction.rst>
+      Quantum Operations <quantum_operations.rst>
+      Visualization <../../examples/python/tutorials/visualization.ipynb>
+      Computing Expectation Values <expectation_values.rst>
+      Multi-Control Synthesis <multi_control.rst>
+      Multi-GPU Workflows <multi_gpu_workflows.rst>
+      Bernstein-Vazirani <bernstein_vazirani.rst>
+      Variational Quantum Eigensolver <vqe.rst>
+      Quantum Approximate Optimization Algorithm <qaoa.rst>
+      Simulations with cuQuantum <cuquantum.rst>
+      Noisy Simulation <noisy_simulation.rst>
+      Using Quantum Hardware Providers <hardware_providers.rst>
diff --git a/pr-2241/sphinx/using/examples/expectation_values.rst b/pr-2241/sphinx/using/examples/expectation_values.rst
new file mode 100644
index 0000000000..f9b6e996b9
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/expectation_values.rst
@@ -0,0 +1,82 @@
+Computing Expectation Values
+-----------------------------
+
+CUDA-Q provides generic library functions enabling one to compute expectation values 
+of quantum spin operators with respect to a parameterized CUDA-Q kernel. Let's take a look 
+at an example of this:
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/expectation_values.py
+      :language: python
+
+   Here we define a parameterized CUDA-Q kernel that takes an angle, `theta`, as a single
+   input. This angle becomes the argument of a single `ry` rotation.
+
+   We define a Hamiltonian operator via the CUDA-Q `cudaq.SpinOperator` type.
+
+   CUDA-Q provides a generic function `cudaq.observe`. This function takes as input three
+   arguments. The first two argument are a parameterized kernel and the `cudaq.SpinOperator` whose
+   expectation value we wish to compute. The final arguments are the runtime parameters at which we
+   evaluate the parameterized kernel.
+
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/expectation_values.cpp
+      :language: cpp
+
+   Here we define a parameterized CUDA-Q kernel, a callable type named :code:`ansatz` that takes as 
+   input a single angle :code:`theta`. This angle becomes the argument of a single :code:`ry` rotation. 
+
+   In host code, we define a Hamiltonian operator via the CUDA-Q :code:`spin_op` type. 
+   CUDA-Q provides a generic function :code:`cudaq::observe`. This function takes as input three terms. 
+   The first two terms are a parameterized kernel and the :code:`spin_op` whose expectation value we wish to compute.
+   The last term contains the runtime parameters at which we evaluate the parameterized kernel. 
+
+   The return type of this function is an :code:`cudaq::observe_result` which contains all the data 
+   from the execution, but is trivially convertible to a double, resulting in the expectation value we are interested in. 
+
+   To compile and execute this code, we run the following:
+
+   .. code:: bash 
+
+      nvq++ expectation_values.cpp -o exp_vals.x 
+      ./exp_vals.x 
+
+
+Parallelizing across Multiple Processors
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:doc:`multi-processor platforms <../backends/platform>` page.
+
+
+One typical use case of :doc:`multi-processor platforms <../backends/platform>` is to distribute the
+expectation value computations of a multi-term Hamiltonian across multiple virtual QPUs.
+
+The following shows an example using the :code:`nvidia-mqpu` platform:
+
+.. tab:: Python
+
+    .. literalinclude:: ../../snippets/python/using/cudaq/platform/observe_mqpu.py
+        :language: python
+        :start-after: [Begin Documentation]
+
+.. tab:: C++
+
+    .. literalinclude:: ../../snippets/cpp/using/cudaq/platform/observe_mqpu.cpp
+        :language: cpp
+        :start-after: [Begin Documentation]
+        :end-before: [End Documentation]
+
+
+    One can then target the :code:`nvidia-mqpu` platform by executing the following commands:
+
+    .. code-block:: console
+
+        nvq++ observe_mqpu.cpp -target nvidia-mqpu
+        ./a.out
+
+In the above code snippets, since the Hamiltonian contains four non-identity terms, there are four quantum circuits that need to be executed
+in order to compute the expectation value of that Hamiltonian and given the quantum state prepared by the ansatz kernel. When the :code:`nvidia-mqpu` platform
+is selected, these circuits will be distributed across all available QPUs. The final expectation value result is computed from all QPU execution results.
diff --git a/pr-2241/sphinx/using/examples/hardware_providers.rst b/pr-2241/sphinx/using/examples/hardware_providers.rst
new file mode 100644
index 0000000000..53e21e83e1
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/hardware_providers.rst
@@ -0,0 +1,101 @@
+Using Quantum Hardware Providers
+-----------------------------------
+
+CUDA-Q contains support for using a set of hardware providers (IonQ, IQM, OQC, ORCA Computing and Quantinuum). 
+For more information about executing quantum kernels on different hardware backends, please take a look
+at :doc:`hardware <../backends/hardware>`.
+
+IonQ
+==================================
+
+The following code illustrates how to run kernels on IonQ's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/ionq.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/ionq.cpp
+      :language: cpp
+
+IQM
+==================================
+
+The following code illustrates how to run kernels on IQM's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/iqm.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/iqm.cpp
+      :language: cpp
+
+OQC
+==================================
+
+The following code illustrates how to run kernels on OQC's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/oqc.py
+      :language: python
+
+ORCA Computing
+==================================
+
+The following code illustrates how to run kernels on ORCA Computing's backends.
+
+ORCA Computing's PT Series implement the boson sampling model of quantum computation, in which 
+multiple photons are interfered with each other within a network of beam splitters, and photon 
+detectors measure where the photons leave this network.
+
+The following image shows the schematic of a Time Bin Interferometer (TBI) boson sampling experiment 
+that runs on ORCA Computing's backends. A TBI uses optical delay lines with reconfigurable coupling 
+parameters. A TBI can be represented by a circuit diagram, like the one below, where this 
+illustration example corresponds to 4 photons in 8 modes sent into alternating time-bins in a circuit 
+composed of two delay lines in series. 
+
+.. image:: ./images/orca_tbi.png
+   :width: 400px
+   :align: center
+
+The parameters needed to define the time bin interferometer are the the input state, the loop 
+lengths, beam splitter angles, and optionally the phase shifter angles, and the number of samples.
+The *input state* is the initial state of the photons in the time bin interferometer, 
+the left-most entry corresponds to the first mode entering the loop.
+The *loop lengths* are the lengths of the different loops in the time bin interferometer.
+The *beam splitter angles* and the phase shifter angles are controllable
+parameters of the time bin interferometer.
+
+This experiment is performed on ORCA's backends by the code below.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/orca.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/orca.cpp
+      :language: cpp
+      
+Quantinuum
+==================================
+
+The following code illustrates how to run kernels on Quantinuum's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/providers/quantinuum.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/providers/quantinuum.cpp
+      :language: cpp
+
diff --git a/pr-2241/sphinx/using/examples/images/orca_tbi.png b/pr-2241/sphinx/using/examples/images/orca_tbi.png
new file mode 100644
index 0000000000..10907b1aa0
Binary files /dev/null and b/pr-2241/sphinx/using/examples/images/orca_tbi.png differ
diff --git a/pr-2241/sphinx/using/examples/introduction.rst b/pr-2241/sphinx/using/examples/introduction.rst
new file mode 100644
index 0000000000..a12fb6cdad
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/introduction.rst
@@ -0,0 +1,42 @@
+Introduction
+--------------------------------
+
+Welcome to CUDA-Q! On this page we will illustrate CUDA-Q with several examples. 
+
+.. tab:: Python
+
+   We're going to take a look at how to construct quantum programs through CUDA-Q's `Kernel` API.
+
+   When you create a `Kernel` and invoke its methods, a quantum program is constructed that can then be executed by calling, for example, `cudaq::sample`. Let's take a closer look!
+
+   .. literalinclude:: ../../examples/python/intro.py
+      :language: python
+
+.. tab:: C++
+
+   We're going to take a look at how to construct quantum programs using CUDA-Q kernels.
+
+   CUDA-Q kernels are any typed callable in the language that is annotated with the :code:`__qpu__` attribute. Let's take a look at a very 
+   simple "Hello World" example, specifically a CUDA-Q kernel that prepares a GHZ state on a programmer-specified number of qubits. 
+
+   .. literalinclude:: ../../examples/cpp/basics/static_kernel.cpp
+      :language: cpp
+
+   Here we see that we can define a custom :code:`struct` that is templated on a :code:`size_t` parameter. 
+   Our kernel expression is free to use this template parameter in the allocation of a 
+   compile-time-known register of qubits. Within the kernel, we are free to apply various quantum operations, 
+   like a Hadamard on qubit 0 :code:`h(q[0])`. Controlled operations are **modifications** of single-qubit 
+   operations, like the :code:`x<cudaq::ctrl>(q[0],q[1])` operation which implements a controlled-X gate. We 
+   can measure single qubits or entire registers. 
+
+   In this example we are interested in sampling the final state produced by this CUDA-Q kernel. 
+   To do so, we leverage the generic :code:`cudaq::sample` function, which returns a data type 
+   encoding the qubit measurement strings and the corresponding number of times that string 
+   was observed (here the default number of shots is used, :code:`1000`).
+
+   The following example illustrates how to compile and execute this code.
+
+   .. code:: bash 
+
+      nvq++ static_kernel.cpp -o ghz.x
+      ./ghz.x
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/examples/multi_control.rst b/pr-2241/sphinx/using/examples/multi_control.rst
new file mode 100644
index 0000000000..ae8123cf44
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/multi_control.rst
@@ -0,0 +1,32 @@
+Multi-control Synthesis 
+-------------------------
+
+Now let's take a look at how CUDA-Q allows one to control a general unitary 
+on an arbitrary number of control qubits. 
+
+.. tab:: Python
+
+   Our first option is to describe our general unitary by another pre-defined
+   CUDA-Q kernel. 
+
+   .. literalinclude:: ../../examples/python/multi_controlled_operations.py
+      :language: python
+      :start-after: [Begin OptionA]
+      :end-before: [End OptionA]
+
+   Alternatively, one may pass multiple arguments for control qubits or vectors
+   to any controlled operation.
+
+   .. literalinclude:: ../../examples/python/multi_controlled_operations.py
+      :language: python
+      :start-after: [Begin OptionB]
+      :end-before: [End OptionB]
+
+
+.. tab:: C++ 
+
+   For this scenario, our general unitary can be described by another pre-defined 
+   CUDA-Q kernel expression. 
+
+   .. literalinclude:: ../../examples/cpp/basics/multi_controlled_operations.cpp
+      :language: cpp
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/examples/multi_gpu_workflows.rst b/pr-2241/sphinx/using/examples/multi_gpu_workflows.rst
new file mode 100644
index 0000000000..d6ce73bac3
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/multi_gpu_workflows.rst
@@ -0,0 +1,155 @@
+Multi-GPU Workflows
+===================
+
+There are many backends available with CUDA-Q which enable seamless
+switching between GPUs, QPUs and CPUs and also allow for workflows
+involving multiple architectures working in tandem.
+
+Available Targets
+-------------------
+
+-  **`qpp-cpu`**: The QPP based CPU backend which is multithreaded to
+   maximize the usage of available cores on your system.
+
+-  **`nvidia`**: GPU-accelerated state-vector based backend which accelerates quantum circuit
+   simulation on NVIDIA GPUs powered by cuQuantum.
+
+-  **`nvidia-mgpu`**: Allows for scaling circuit simulation on multiple GPUs.
+
+-  **`nvidia-mqpu`**: Enables users to program workflows utilizing
+   multiple virtual quantum processors in parallel, where each QPU is simulated by the `nvidia` backend.
+
+-  **`remote-mqpu`**: Enables users to program workflows utilizing
+   multiple virtual quantum processors in parallel, where the backend used to simulate each QPU is configurable.
+
+Please see :doc:`../backends/backends` for a full list of all available backends. 
+Below we explore how to effectively utilize multiple CUDA-Q targets with the same GHZ state preparation code
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
+    :language: python
+    :start-after: [Begin state]
+    :end-before: [End state]
+
+You can execute the code by running a statevector simulator on your CPU:
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
+    :language: python
+    :start-after: [Begin CPU]
+    :end-before: [End CPU]
+
+.. parsed-literal::
+
+    { 00:475 11:525 }
+
+You will notice a speedup of up to **2500x** in executing the circuit below on
+NVIDIA GPUs vs CPUs:
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/multiple_targets.py
+    :language: python
+    :start-after: [Begin GPU]
+    :end-before: [End GPU]
+
+.. parsed-literal::
+
+    { 0000000000000000000000000:510 1111111111111111111111111:490 }
+
+If one incrementally increases the qubit count, we
+reach a limit where the memory required is beyond the capabilities of a
+single GPU: A :math:`n` qubit quantum state has :math:`2^n` complex amplitudes, each
+of which require 8 bytes of memory to store. Hence the total memory
+required to store a :math:`n` qubit quantum state is :math:`8` bytes
+:math:`\times 2^n`. For :math:`n = 30` qubits, this is roughly :math:`8`
+GB but for :math:`n = 40`, this exponentially increases to 8700 GB.
+
+
+Parallelization across Multiple Processors
+---------------------------------------------
+
+The ``nvidia-mgpu`` target allows for memory from additional
+GPUs to be pooled enabling qubit counts to be scaled.
+Execution on the ``nvidia-mgpu`` backend is enabled via ``mpirun``. Users
+need to create a ``.py`` file with their code and run the command below
+in terminal:
+
+``mpirun -np 4 python3 test.py``
+
+where 4 is the number of GPUs one has access to and ``test`` is the file
+name chosen.
+
+The ``nvidia-mqpu`` target uses a statevector simulator to simulate execution 
+on each virtual QPU.
+The ``remote-mqpu`` platform allows to freely configure what backend is used 
+for each platform QPU. 
+For more information about the different platform targets, please take a look at
+:doc:`../backends/platform`.
+
+Batching Hamiltonian Terms
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Expectation value computations of multi-term Hamiltonians can be
+asynchronously processed via the ``mqpu`` platform.
+
+.. image:: ../../examples/python/tutorials/images/hsplit.png
+
+For workflows involving multiple GPUs, save the code below in a
+``filename.py`` file and execute via:
+``mpirun -np n python3 filename.py`` where ``n`` is an integer
+specifying the number of GPUs you have access to.
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/hamiltonian_batching.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    mpi is initialized?  True
+    rank 0 num_ranks 1
+
+
+Circuit Batching
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Execution of parameterized circuits with different parameters can be
+executed asynchronously via the ``mqpu`` platform.
+
+.. image:: ../../examples/python/tutorials/images/circsplit.png
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin prepare]
+    :end-before: [End prepare]
+
+Let's time the execution on single GPU.
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin single]
+    :end-before: [End single]
+
+.. parsed-literal::
+
+    31.7 s ± 990 ms per loop (mean ± std. dev. of 7 runs, 1 loop each)
+
+Now let's try to time multi GPU run.
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin split]
+    :end-before: [End split]
+
+.. parsed-literal::
+
+    We have 10000 parameters which we would like to execute
+    We split this into 4 batches of 2500 , 2500 , 2500 , 2500
+
+
+.. literalinclude:: ../../snippets/python/using/examples/multi_gpu_workflows/circuit_batching.py
+    :language: python
+    :start-after: [Begin multiple]
+    :end-before: [End multiple]
+
+.. parsed-literal::
+
+    85.3 ms ± 2.36 ms per loop (mean ± std. dev. of 7 runs, 10 loops each)
+
diff --git a/pr-2241/sphinx/using/examples/noisy_simulation.rst b/pr-2241/sphinx/using/examples/noisy_simulation.rst
new file mode 100644
index 0000000000..bf008500a5
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/noisy_simulation.rst
@@ -0,0 +1,65 @@
+Noisy Simulation
+-----------------
+
+CUDA-Q makes it simple to model noise within the simulation of your quantum program.
+Let's take a look at the various built-in noise models we support, before concluding with a brief example of a custom noise model constructed from user-defined Kraus Operators.
+
+The following code illustrates how to run a simulation with depolarization noise.
+
+.. tab:: Python
+   
+   .. literalinclude:: ../../examples/python/noise_depolarization.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_depolarization.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with amplitude damping noise.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_amplitude_damping.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_amplitude_damping.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with bit-flip noise.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_bit_flip.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_bit_flip.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with phase-flip noise.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_phase_flip.py
+      :language: python
+
+.. tab:: C++
+
+    .. literalinclude:: ../../examples/cpp/basics/noise_phase_flip.cpp
+      :language: cpp
+
+The following code illustrates how to run a simulation with a custom noise model.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/noise_kraus_operator.py
+      :language: python
+
+.. tab:: C++
+
+   .. literalinclude:: ../../examples/cpp/basics/noise_modeling.cpp
+      :language: cpp
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/examples/qaoa.rst b/pr-2241/sphinx/using/examples/qaoa.rst
new file mode 100644
index 0000000000..de1db8d4df
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/qaoa.rst
@@ -0,0 +1,22 @@
+Quantum Approximate Optimization Algorithm
+-------------------------------------------
+
+.. tab:: Python
+
+   Let's now see how we can implement the Quantum Approximate Optimization Algorithm (QAOA) to compute the Max-Cut of a rectangular graph by leveraging 
+   `cudaq:vqe`. For more on the QAOA algorithm and the Max-Cut problem, refer to 
+   `this paper <https://arxiv.org/abs/1411.4028>`__.
+
+   .. literalinclude:: ../../examples/python/qaoa_maxcut.py
+      :language: python
+
+.. tab:: C++
+
+   Let's now see how we can implement the Quantum Approximate Optimization Algorithm (QAOA) to compute the Max-Cut of a rectangular graph
+   For more on the QAOA algorithm and the Max-Cut problem, refer to 
+   `this paper <https://arxiv.org/abs/1411.4028>`__.
+
+   .. literalinclude:: ../../examples/cpp/algorithms/qaoa_maxcut.cpp
+      :language: cpp
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/examples/quantum_operations.rst b/pr-2241/sphinx/using/examples/quantum_operations.rst
new file mode 100644
index 0000000000..3ce35eb098
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/quantum_operations.rst
@@ -0,0 +1,175 @@
+Quantum Computing 101
+======================
+
+The fundamental unit of classical information storage, processing and
+transmission is the bit. Analogously, we define its quantum counterpart,
+a quantum bit or simply the qubit.
+
+Classical bits are transistor elements whose states can be altered to
+perform computations. Similarly qubits too have physical realizations
+within superconducting materials, ion-traps and photonic systems. We
+shall not concern ourselves with specific qubit architectures but rather
+think of them as systems which obey the laws of quantum mechanics and
+the mathematical language physicists have developed to describe the
+theory: linear algebra.
+
+Quantum States
+-----------------------------
+
+Information storage scales linearly if bits have a single state. Access
+to multiple states, namely a 0 and a 1 allows for information encoding
+to scale logarithmically. Similarly we define a qubit to have the states
+:math:`\ket{0}` and :math:`\ket{1}` in Dirac notation where:
+
+.. math:: \ket{0} = \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix}
+
+.. math:: \ket{1} = \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}
+
+Rather than just the two states each classical bit can be in,
+quantum theory allows one to explore linear combinations of states,
+also called superpositions:
+
+.. math::   \ket{\psi} = \alpha\ket{0} + \beta\ket{1} 
+
+where :math:`\alpha` and :math:`\beta` :math:`\in \mathbb{C}`. It is
+important to note that this is still the state of one qubit; 
+although we have two kets, they both represent a
+superposition state of one qubit.
+
+If we have two classical bits, the possible states we could encode
+information in would be 00, 01, 10 and 11. Correspondingly, multiple
+qubits can be combined and the possible combinations of their states
+used to process information.
+
+A two qubit system has four computational basis states:
+:math:`\ket{00}, \ket{01}, \ket{10}, \ket{11}`.
+
+More generally, the quantum state of a :math:`n` qubit system is written
+as a sum of :math:`2^n` possible basis states where the coefficients
+track the probability of the system collapsing into that state if a
+measurement is applied.
+
+For :math:`n = 500`, :math:`2^n \approx 10^{150}` which is greater than
+the number of atoms in the universe. Storing the complex numbers
+associated with :math:`2^{500}` amplitudes would not be feasible using
+bits and classical computations but nature seems to only require 500
+qubits to do so. The art of quantum computation is thus to build quantum
+systems that we can manipulate with fine precision such that evolving a
+large statevector can be offloaded onto a quantum computer.
+
+
+Quantum Gates
+-----------------------------
+
+We can manipulate the state of a qubit via quantum gates. 
+For example, the Pauli X gate allows us to flip the state of the qubit:
+
+.. math::  X \ket{0} = \ket{1} 
+
+.. math::  \begin{bmatrix} 0 & 1 \\ 1 & 0 \end{bmatrix} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} = \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix} 
+
+.. literalinclude:: ../../snippets/python/using/examples/pauli_x_gate.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    { 1:1000 }
+
+The Hadamard gate allows us to put the qubit in an equal superposition
+state:
+
+.. math::  H \ket{0} =  \tfrac{1}{\sqrt{2}} \ket{0} + \tfrac{1}{\sqrt{2}} \ket{1}  \equiv \ket{+}
+
+.. math:: \tfrac{1}{\sqrt{2}}\begin{bmatrix} 1 & 1 \\ 1 & -1 \end{bmatrix} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} = \tfrac{1}{\sqrt{2}} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} + \tfrac{1}{\sqrt{2}} \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}. 
+
+The probability of finding the qubit in the :math:`\ket{0}` or :math:`\ket{1}` state is hence
+:math:`\lvert \tfrac{1}{\sqrt{2}} \rvert ^2 = \tfrac{1}{2}`. Lets verify
+this with some code:
+
+.. literalinclude:: ../../snippets/python/using/examples/hadamard_gate.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    { 0:502 1:498 }
+
+For a qubit in a superposition state, quantum gates
+act linearly:
+
+.. math::    X (\alpha\ket{0} + \beta\ket{1}) = \alpha\ket{1} + \beta\ket{0} 
+
+As we evolve quantum states via quantum gates, the normalization
+condition requires that the sum of modulus squared of amplitudes must
+equal 1 at all times:
+
+.. math::   \ket{\psi} = \alpha\ket{0} + \beta\ket{1},          |\alpha|^2 + |\beta|^2 = 1. 
+
+This is to adhere to the conservation of probabilities which translates
+to a constraint on types of quantum gates we can define.
+For a general quantum state :math:`\ket{\psi}`, upholding the
+normalization condition requires quantum gates to be unitary, that is
+:math:`U^{\dagger}U = U^{*^{T}}U = \mathbb{I}`.
+
+Just like the single-qubit gates above, we can define 
+multi-qubit gates to act on multiple-qubits.
+The controlled-NOT or CNOT gate, for example, acts on 2 qubits: the control qubit and
+the target qubit. Its effect is to flip the target if the control is in
+the excited :math:`\ket{1}` state.
+
+.. literalinclude:: ../../snippets/python/using/examples/cnot_gate.py
+    :language: python
+    :start-after: [Begin Docs]
+    :end-before: [End Docs]
+
+.. parsed-literal::
+
+    { 11:1000 }
+    
+
+The CNOT gate in matrix notation is represented as
+
+.. math::  CNOT \equiv \begin{bmatrix} 1 & 0 & 0 & 0 \\ 0 & 1 & 0 & 0 \\ 0 & 0 & 0 & 1 \\ 0 & 0 & 1 & 0 \end{bmatrix} 
+
+and one can check that :math:`CNOT^\dagger CNOT = \mathbb{I}`.
+Its effect on the computational basis states is:
+
+.. math::  CNOT\ket{00} = \ket{00} 
+
+.. math::  CNOT\ket{01} = \ket{01} 
+
+.. math::  CNOT\ket{10} = \ket{11} 
+
+.. math::  CNOT\ket{11} = \ket{10} 
+
+For a full list of gates supported in CUDA-Q see :doc:`../../api/default_ops`. 
+
+Measurements
+-----------------------------
+
+Quantum theory is probabilistic and hence requires statistical inference
+to derive observations. Prior to measurement, the state of a qubit is
+all possible combinations of :math:`\alpha` and :math:`\beta` and upon
+measurement, wavefunction collapse yields either a classical 0 or 1.
+
+The mathematical theory devised to explain quantum phenomena tells us
+that the probability of observing the qubit in the state
+:math:`\ket{0}` or :math:`\ket{1}`, yielding a classical 0 or 1, is
+:math:`\lvert \alpha \rvert ^2` or :math:`\lvert \beta \rvert ^2`, respectively. 
+
+As we see in the example of the Hadamard gate above,
+the result 0 or 1 each is yielded roughly 50% of the times as predicted 
+by the postulate stated above thus proving the theory.
+
+Classically, we cannot encode information within states such as 00 + 11
+but quantum mechanics allows us to write linear superpositions
+
+.. math::   \ket{\psi} = \alpha_{00}\ket{00} + \alpha_{01}\ket{01} + \alpha_{10}\ket{10} + \alpha_{11}\ket{11}
+
+where the probability of measuring :math:`x = 00, 01, 10, 11` occurs
+with probability :math:`\lvert \alpha_{x} \rvert ^2` with the
+normalization condition that
+:math:`\sum_{x \in \{ 0,1 \}^2} \lvert \alpha_{x} \rvert ^2 = 1`.
diff --git a/pr-2241/sphinx/using/examples/vqe.rst b/pr-2241/sphinx/using/examples/vqe.rst
new file mode 100644
index 0000000000..08b0e5755c
--- /dev/null
+++ b/pr-2241/sphinx/using/examples/vqe.rst
@@ -0,0 +1,29 @@
+Variational Quantum Eigensolver
+--------------------------------
+
+The Variational Quantum Eigensolver (VQE) algorithm, originally proposed in
+`this publication <https://arxiv.org/abs/1304.3061>`__, 
+is a hybrid algorithm that can make use of both quantum and classical resources.
+
+Let's take a look at how we can use CUDA-Q's built-in `vqe` module to run our own custom VQE routines! 
+Given a parameterized quantum kernel, a system spin Hamiltonian, and one of CUDA-Q's optimizers, 
+`cudaq.vqe` will find and return the optimal set of parameters that minimize the energy, <Z>, of the system.
+
+The code block below represents the contents of a file titled `simple_vqe.py`. 
+
+.. tab:: Python
+
+   .. literalinclude:: ../../examples/python/simple_vqe.py
+      :language: python
+
+.. tab:: C++
+   
+   .. literalinclude:: ../../examples/cpp/algorithms/vqe_h2.cpp
+      :language: cpp
+
+Let's look at a more advanced variation of the previous example.
+
+As an alternative to `cudaq.vqe`, we can also use the `cudaq.optimizers` suite on its own to write custom variational algorithm routines. Much of this can be slightly modified for use with third-party optimizers, such as `scipy`.
+
+.. literalinclude:: ../../examples/python/advanced_vqe.py
+   :language: python
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/extending/_noise.rst b/pr-2241/sphinx/using/extending/_noise.rst
new file mode 100644
index 0000000000..0ff2132811
--- /dev/null
+++ b/pr-2241/sphinx/using/extending/_noise.rst
@@ -0,0 +1,114 @@
+Noise Modeling with CUDA-Q
+********************************
+
+CUDA-Q models incoherent noise via quantum channels, linear 
+completely-positive and trace-preserving (CPTP) maps. Specifically 
+CUDA-Q requires the definition of a quantum channel via Kraus operators
+that satisfy the CPTP condition (:math:`\sum_i K_i^\dagger K_i = \mathbf{I}`). 
+
+Noise channels are composed of a list of Kraus operators and can be 
+assigned for application after the application of a quantum operation. These 
+channels can be stacked - multiple noise processes can be appended 
+for a given quantum operation. These channels are specified to be applied to 
+one or many qubits for a given operation. A Kraus channel should be able to 
+be applied to a single qubit operation, or a multi-qubit, controlled operation. 
+
+These channels transform the underlying density matrix representation of the quantum 
+state in the following way 
+
+.. math::
+
+    \rho_{new} = \sum_i K_i \rho K_i^\dagger. 
+
+Design 
+------
+
+To model this in CUDA-Q, we put forward :code:`cudaq::kraus_op`, :code:`cudaq::kraus_channel`, 
+and :code:`cudaq::noise_model`. 
+
+A :code:`cudaq::kraus_op` encapsulates a :code:`vector` of :code:`complex` 
+data modeling a 1-D flatten representation of a matrix with row-major ordering. It 
+can be constructed from a :code:`vector` of data or an :code:`initializer_list` of data.
+
+A :code:`cudaq::kraus_channel` encapsulates a :code:`vector` of :code:`kraus_op` instances that 
+make up the quantum channel. The size of a :code:`kraus_channel` 
+is the number of :code:`kraus_ops` it contains. :code:`kraus_channel` instances can be constructed 
+from a variadic list of :code:`initializer_list` that enables :code:`kraus_op` construction in place. 
+It can also be constructed directly from a vector of :code:`kraus_ops`. The 
+constructor should validate the completeness (CPTP) relation. 
+
+A :code:`cudaq::noise_model` encapsulates a mapping of quantum operation names to a 
+vector of :code:`kraus_channel` that is to be applied after invocation of that 
+quantum operation. A :code:`noise_model` can be constructed with a nullary constructor, and 
+:code:`kraus_channels` can be added via :code:`add_channel` and :code:`add_all_qubit_channel` methods with 
+the operation given as a string or as a template argument. 
+The operation name or the template type specifies the quantum operation the channel applies to 
+(e.g. :code:`model.add_channel\<cudaq::types::h\>(channel)` or :code:`model.add_channel("h", channel)`). 
+Clients (e.g. simulator backends) can retrieve the :code:`kraus_channel` to 
+apply to the simulated state via a :code:`noise_model::get_channel(...)` call. 
+
+When adding an error channel to a noise model for a quantum operation
+we can assign the noise channel to instances of that operation on specific qubit operands or 
+to any occurrence of the operation, regardless of which qubits it acts on. 
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        # Add a noise channel to z gate on qubit 0
+        noise.add_channel('z', [0], noise_channel)
+        # Add a noise channel to x gate, regardless of qubit operands. 
+        noise.add_all_qubit_channel('x', noise_channel)
+
+
+.. tab:: C++
+
+    .. code-block:: cpp
+        
+        // Add a noise channel to z gate on qubit 0
+        noise.add_channel("z", {0}, noise_channel);
+        // Add a noise channel to x gate, regardless of qubit operands. 
+        noise.add_all_qubit_channel("x", noise_channel)
+
+In addition to static noise channels, users can also define a noise channel as a 
+callback function, which returns a concrete channel definition in terms of Kraus matrices 
+depending on the gate operands and gate parameters if any.
+
+.. tab:: Python
+
+    .. code-block:: python
+
+        # Noise channel callback function
+        def noise_cb(qubits, params):
+           # Construct a channel based on specific operands and parameters
+           ...
+           return noise_channel 
+        
+        # Add a dynamic noise channel to the 'rx' gate.
+        noise.add_channel('rx', noise_cb)
+
+
+.. tab:: C++
+
+    .. code-block:: cpp
+        
+        // Add a dynamic noise channel to the 'rx' gate.
+        noise.add_channel("rx",
+            [](const auto &qubits, const auto &params) -> cudaq::kraus_channel {
+                // Construct a channel based on specific operands and parameters
+                ...
+                return noiseChannel;
+            });
+
+
+Noise models can be constructed via the :code:`cudaq::noise_model` and specified for 
+execution via a public :code:`cudaq::set_noise(cudaq::noise_model&)` function. This function 
+should forward the :code:`noise_model` to the current :code:`quantum_platform` which can attach it 
+to the current :code:`ExecutionContext` and retrieved by backend simulators. The
+:code:`noise_model` must stay in scope in order to be successfully used by the
+backend simulators, and you must call :code:`cudaq::unset_noise()` when you are
+done with the noise model.
+
+The :code:`kraus_op` matrix data assumes a LSB qubit ordering. 
+
+To get started with noise modeling in CUDA-Q, take a look at the :doc:`/using/examples`.
diff --git a/pr-2241/sphinx/using/extending/cudaq_ir.rst b/pr-2241/sphinx/using/extending/cudaq_ir.rst
new file mode 100644
index 0000000000..070f6369f2
--- /dev/null
+++ b/pr-2241/sphinx/using/extending/cudaq_ir.rst
@@ -0,0 +1,260 @@
+Working with the CUDA-Q IR
+********************************
+Let's see the output of :code:`nvq++` in verbose mode. Consider a simple code like the one below, saved to file :code:`simple.cpp`.
+
+.. code-block:: console 
+
+    #include <cudaq.h>
+
+    struct ghz {
+      void operator()(int N) __qpu__ {
+        cudaq::qvector q(N);
+        h(q[0]);
+        for (int i = 0; i < N - 1; i++) {
+          x<cudaq::ctrl>(q[i], q[i + 1]);
+        }
+        mz(q);
+      }
+    };
+
+    int main() { ... }
+
+ We see the following output from :code:`nvq++` verbose mode (up to some absolute paths).
+
+.. code-block:: console 
+
+    $ nvq++ simple.cpp -v --save-temps
+    
+    cudaq-quake --emit-llvm-file simple.cpp -o simple.qke
+    cudaq-opt --pass-pipeline=builtin.module(canonicalize,lambda-lifting,canonicalize,apply-op-specialization,kernel-execution,inline{default-pipeline=func.func(indirect-to-direct-calls)},func.func(quake-add-metadata),device-code-loader{use-quake=1},expand-measurements,func.func(lower-to-cfg),canonicalize,cse) simple.qke -o simple.qke.LpsXpu
+    cudaq-translate --convert-to=qir simple.qke.LpsXpu -o simple.ll.p3De4L
+    fixup-linkage.pl simple.qke simple.ll
+    llc --relocation-model=pic --filetype=obj -O2 simple.ll.p3De4L -o simple.qke.o
+    llc --relocation-model=pic --filetype=obj -O2 simple.ll -o simple.classic.o
+    clang++ -L/usr/lib/gcc/x86_64-linux-gnu/12 -L/usr/lib64 -L/lib/x86_64-linux-gnu -L/lib64 -L/usr/lib/x86_64-linux-gnu -L/lib -L/usr/lib -L/usr/local/cuda/lib64/stubs -r simple.qke.o simple.classic.o -o simple.o
+    clang++ -Wl,-rpath,lib -Llib -L/usr/lib/gcc/x86_64-linux-gnu/12 -L/usr/lib64 -L/lib/x86_64-linux-gnu -L/lib64 -L/usr/lib/x86_64-linux-gnu -L/lib -L/usr/lib -L/usr/local/cuda/lib64/stubs simple.o -lcudaq -lcudaq-common -lcudaq-mlir-runtime -lcudaq-builder -lcudaq-ensmallen -lcudaq-nlopt -lcudaq-spin -lcudaq-em-default -lcudaq-platform-default -lnvqir -lnvqir-qpp
+
+This workflow orchestration is represented in the figure below: 
+
+.. image:: ../../_static/nvqpp_workflow.png
+
+We start by mapping CUDA-Q C++ kernel representations (structs, lambdas, and free functions) 
+to the Quake dialect. Since we added :code:`--save-temps`, 
+we can look at the IR code that was produced. The base Quake file, :code:`simple.qke`, contains the following: 
+
+.. code-block:: console 
+
+    module attributes {qtx.mangled_name_map = {__nvqpp__mlirgen__ghz = "_ZN3ghzclEi"}} {
+        func.func @__nvqpp__mlirgen__ghz(%arg0: i32) attributes {"cudaq-entrypoint", "cudaq-kernel"} {
+           %alloca = memref.alloca() : memref<i32>
+           memref.store %arg0, %alloca[] : memref<i32>
+           %0 = memref.load %alloca[] : memref<i32>
+           %1 = arith.extsi %0 : i32 to i64
+           %2 = quake.alloca(%1 : i64) !quake.veq<?>
+           %c0_i32 = arith.constant 0 : i32
+           %3 = arith.extsi %c0_i32 : i32 to i64
+           %4 = quake.extract_ref %2[%3] : (!quake.veq<?>, i64) -> !quake.ref
+           quake.h %4 : (!quake.ref) -> ()
+           cc.scope {
+            %c0_i32_0 = arith.constant 0 : i32
+            %alloca_1 = memref.alloca() : memref<i32>
+            memref.store %c0_i32_0, %alloca_1[] : memref<i32>
+            cc.loop while {
+                %6 = memref.load %alloca_1[] : memref<i32>
+                %7 = memref.load %alloca[] : memref<i32>
+                %c1_i32 = arith.constant 1 : i32
+                %8 = arith.subi %7, %c1_i32 : i32
+                %9 = arith.cmpi slt, %6, %8 : i32
+                cc.condition %9
+            } do {
+              cc.scope {
+                %6 = memref.load %alloca_1[] : memref<i32>
+                %7 = arith.extsi %6 : i32 to i64
+                %8 = quake.extract_ref %2[%7] : (!quake.veq<?>, i64) -> !quake.ref
+                %9 = memref.load %alloca_1[] : memref<i32>
+                %c1_i32 = arith.constant 1 : i32
+                %10 = arith.addi %9, %c1_i32 : i32
+                %11 = arith.extsi %10 : i32 to i64
+                %12 = quake.extract_ref %2[%11] : (!quake.veq<?>, i64) -> !quake.ref
+                quake.x [%8] %12 : (!quake.ref, !quake.ref) -> ()
+              }
+              cc.continue
+            } step {
+                %6 = memref.load %alloca_1[] : memref<i32>
+                %c1_i32 = arith.constant 1 : i32
+                %7 = arith.addi %6, %c1_i32 : i32
+                memref.store %7, %alloca_1[] : memref<i32>
+            }
+            }
+            %5 = quake.mz %2 : (!quake.veq<?>) -> !cc.stdvec<i1>
+            return
+        }
+    }
+
+This base Quake file is unoptimized and unchanged. It is produced by the 
+:code:`cudaq-quake` tool, which also allows us to output the full LLVM IR representation 
+for the code. This LLVM IR is classical-only, and is directly produced by :code:`clang++` 
+code-generation. The LLVM IR file :code:`simple.ll` contains the CUDA-Q kernel 
+:code:`operator()(Args...)` LLVM function, with a mangled name. Ultimately, we 
+want to replace this function with our own MLIR-generated function. 
+
+Next, the :code:`cudaq-opt` tool is invoked on the :code:`simple.qke` file. This runs an
+MLIR pass pipeline that canonicalizes and optimizes the code. It will also process quantum 
+lambdas, lift those lambdas to functions, and synthesis adjoint and controlled versions of 
+CUDA-Q kernel functions if necessary. The most important pass that this step applies is the 
+:code:`kernel-execution` pass, which synthesizes a new entry point LLVM function with the 
+same name and signature as the original :code:`operator()(Args...)` call function in the 
+classical :code:`simple.ll` file. We also extract all Quake code representations as strings
+and register them with the CUDA-Q runtime for runtime IR introspection. 
+
+After :code:`cudaq-opt`, the :code:`cudaq-translate` tool is used to lower the transformed 
+Quake representation to an LLVM IR representation, specifically the QIR. We finish by lowering 
+this representation to object code via standard LLVM tools (e.g. :code:`llc`), and merge all 
+object files into a single object file, ensuring that our new mangled :code:`operator()(Args...)` 
+call is injected first, thereby overwriting the original. Finally, based on user compile flags, 
+we configure the link line with specific libraries that implement the :code:`quantum_platform` 
+(here the :code:`libcudaq-platform-default.so`) and NVQIR circuit simulator backend (the 
+:code:`libnvqir-qpp.so` Q++ CPU-only simulation backend). These latter libraries are controlled 
+via the :code:`--platform` and :code:`--target` compiler flags. 
+
+.. image:: ../../_static/dialects.png
+
+The above figure demonstrate the MLIR dialects involved and the overall workflow mapping 
+high-level language constructs to lower-level MLIR dialect code, and ultimately LLVM IR. 
+
+CUDA-Q also provides value-semantics form of Quake for static circuit
+representation. This dialect directly enables robust circuit 
+optimizations via data-flow analysis of the representative circuit. This dialect 
+is typically produced just-in-time when the structure of the circuit is fully known. 
+
+You will notice that there are a number of CUDA-Q executable tools installed as part 
+of this open beta release. These tools are directly related to the generation, 
+processing, optimization, and lowering of the core :code:`nvq++` compiler representations.
+The tools available are 
+
+1. :code:`cudaq-quake` - Lower C++ to Quake, can also output classical LLVM IR file
+2. :code:`cudaq-opt` - Process Quake with various MLIR Passes
+3. :code:`cudaq-translate` - Lower Quake to external representations like QIR
+
+CUDA-Q and :code:`nvq++` rely on Quake for the core quantum intermediate representation.
+Quake represents an IR closer to the CUDA-Q source language and models qubits and
+quantum instructions via memory semantics. Quake can be fully dynamic and in
+that sense represents a quantum circuit template or generator. With runtime 
+arguments fully specified, Quake code can be used to generate or synthesize
+a fully known quantum circuit. The value semantics form of Quake can thus be
+used as a representation for fully known
+or synthesized quantum circuits. Its utility, therefore, lies in its ability to 
+optimize quantum code. It departs from the memory semantics model of Quake and 
+expresses the flow of quantum information explicitly as MLIR values.
+This approach makes it easier for finding circuit patterns and leveraging it for common 
+optimization tasks. 
+
+To demonstrate how these tools work together, let's take the simple GHZ CUDA-Q 
+program and lower the kernel from C++ to Quake, synthesize that Quake code, 
+and produce QIR. Recall the code snippet for the kernel
+
+.. code-block:: cpp 
+
+    // Define a quantum kernel
+    struct ghz {
+      auto operator()() __qpu__ {
+        cudaq::qarray<5> q;
+        h(q[0]);
+        for (int i = 0; i < 4; i++) 
+          x<cudaq::ctrl>(q[i], q[i + 1]);
+        mz(q);
+      }
+    };
+
+Using the toolchain, we can lower this directly to QIR,
+
+.. code-block:: console
+
+    cudaq-quake simple.cpp | cudaq-opt --canonicalize | cudaq-translate --convert-to=qir 
+
+which prints: 
+
+.. code-block:: console 
+
+    ; ModuleID = 'LLVMDialectModule'
+    source_filename = "LLVMDialectModule"
+    target datalayout = "e-m:e-p270:32:32-p271:32:32-p272:64:64-i64:64-f80:128-n8:16:32:64-S128"
+    target triple = "x86_64-unknown-linux-gnu"
+
+    %Array = type opaque
+    %Qubit = type opaque
+    %Result = type opaque
+
+    declare void @invokeWithControlQubits(i64, void (%Array*, %Qubit*)*, ...) local_unnamed_addr
+
+    declare void @__quantum__qis__x__ctl(%Array*, %Qubit*)
+
+    declare %Result* @__quantum__qis__mz(%Qubit*) local_unnamed_addr
+
+    declare void @__quantum__rt__qubit_release_array(%Array*) local_unnamed_addr
+
+    declare i64 @__quantum__rt__array_get_size_1d(%Array*) local_unnamed_addr
+
+    declare void @__quantum__qis__h(%Qubit*) local_unnamed_addr
+
+    declare i8* @__quantum__rt__array_get_element_ptr_1d(%Array*, i64) local_unnamed_addr
+
+    declare %Array* @__quantum__rt__qubit_allocate_array(i64) local_unnamed_addr
+
+    define void @__nvqpp__mlirgen__ghz(i32 %0) local_unnamed_addr {
+      %2 = sext i32 %0 to i64
+      %3 = tail call %Array* @__quantum__rt__qubit_allocate_array(i64 %2)
+      %4 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 0)
+      %5 = bitcast i8* %4 to %Qubit**
+      %6 = load %Qubit*, %Qubit** %5, align 8
+      tail call void @__quantum__qis__h(%Qubit* %6)
+      %7 = add i32 %0, -1
+      %8 = icmp sgt i32 %7, 0
+      br i1 %8, label %.lr.ph.preheader, label %._crit_edge
+
+    .lr.ph.preheader:                                 ; preds = %1
+      %wide.trip.count = zext i32 %7 to i64
+      br label %.lr.ph
+
+    .lr.ph:                                           ; preds = %.lr.ph.preheader, %.lr.ph
+      %indvars.iv = phi i64 [ 0, %.lr.ph.preheader ], [ %indvars.iv.next, %.lr.ph ]
+      %9 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 %indvars.iv)
+      %10 = bitcast i8* %9 to %Qubit**
+      %11 = load %Qubit*, %Qubit** %10, align 8
+      %indvars.iv.next = add nuw nsw i64 %indvars.iv, 1
+      %12 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 %indvars.iv.next)
+      %13 = bitcast i8* %12 to %Qubit**
+      %14 = load %Qubit*, %Qubit** %13, align 8
+      tail call void (i64, void (%Array*, %Qubit*)*, ...) @invokeWithControlQubits(i64 1, void (%Array*, %Qubit*)* nonnull @__quantum__qis__x__ctl, %Qubit* %11, %Qubit* %14)
+      %exitcond.not = icmp eq i64 %indvars.iv.next, %wide.trip.count
+      br i1 %exitcond.not, label %._crit_edge, label %.lr.ph
+
+    ._crit_edge:                                      ; preds = %.lr.ph, %1
+      %15 = tail call i64 @__quantum__rt__array_get_size_1d(%Array* %3)
+      %16 = icmp sgt i64 %15, 0
+      br i1 %16, label %.lr.ph3, label %._crit_edge4
+
+    .lr.ph3:                                          ; preds = %._crit_edge, %.lr.ph3
+      %17 = phi i64 [ %22, %.lr.ph3 ], [ 0, %._crit_edge ]
+      %18 = tail call i8* @__quantum__rt__array_get_element_ptr_1d(%Array* %3, i64 %17)
+      %19 = bitcast i8* %18 to %Qubit**
+      %20 = load %Qubit*, %Qubit** %19, align 8
+      %21 = tail call %Result* @__quantum__qis__mz(%Qubit* %20)
+      %22 = add nuw nsw i64 %17, 1
+      %exitcond5.not = icmp eq i64 %22, %15
+      br i1 %exitcond5.not, label %._crit_edge4, label %.lr.ph3
+
+    ._crit_edge4:                                     ; preds = %.lr.ph3, %._crit_edge
+      tail call void @__quantum__rt__qubit_release_array(%Array* %3)
+      ret void
+    }
+
+    !llvm.module.flags = !{!0}
+
+    !0 = !{i32 2, !"Debug Info Version", i32 3}
+
+
+Note that the results of each tool can be piped to further tools, creating a
+composable pipeline of compiler lowering tools. 
+
+
diff --git a/pr-2241/sphinx/using/extending/extending.rst b/pr-2241/sphinx/using/extending/extending.rst
new file mode 100644
index 0000000000..fd755f7969
--- /dev/null
+++ b/pr-2241/sphinx/using/extending/extending.rst
@@ -0,0 +1,9 @@
+Extending CUDA-Q
+****************************
+
+.. toctree::
+  :maxdepth: 1
+
+  Create a new NVQIR Simulator <nvqir_simulator.rst>
+  Working with CUDA-Q IR <cudaq_ir.rst>
+  Create an MLIR Pass for CUDA-Q <mlir_pass.rst>
diff --git a/pr-2241/sphinx/using/extending/mlir_pass.rst b/pr-2241/sphinx/using/extending/mlir_pass.rst
new file mode 100644
index 0000000000..8d61325ea1
--- /dev/null
+++ b/pr-2241/sphinx/using/extending/mlir_pass.rst
@@ -0,0 +1,97 @@
+Create your own CUDA-Q Compiler Pass 
+******************************************
+
+The CUDA-Q IR can be transformed, analyzed, or optimized 
+using standard MLIR patterns and tools. CUDA-Q provides a registration 
+mechanism for the :code:`cudaq-opt` tool that allows one to create, load, and 
+use custom MLIR passes on Quake code. 
+
+CUDA-Q MLIR Passes can only be created within an existing CUDA-Q 
+development environment. Therefore, you must clone the repository and add your 
+Pass code as part of the existing CUDA-Q CMake system. 
+
+As an example, clone the repository and add the following directory structure 
+under :code:`lib`, :code:`lib/Plugins/MyCustomPlugin/`. Within this directory create a 
+:code:`CMakeLists.txt` file and a :code:`MyCustomPlugin.cpp` file. In the CMake file, 
+add the following: 
+
+.. code:: cmake 
+
+    add_llvm_pass_plugin(MyCustomPlugin MyCustomPlugin.cpp)
+
+Creating a CUDA-Q IR pass starts with the implementation of an 
+:code:`mlir::OperationPass`. A full discussion of the MLIR Pass infrastructure 
+is beyond the scope of this document; please see 
+`MLIR Passes <https://mlir.llvm.org/docs/PassManagement>`_. To create such 
+a pass, start with the following template in the :code:`MyCustomPlugin.cpp` file:
+
+.. code:: cpp 
+    
+    #include "cudaq/Optimizer/Dialect/Quake/QuakeDialect.h"
+    #include "cudaq/Optimizer/Dialect/Quake/QuakeOps.h"
+    #include "cudaq/Support/Plugin.h"
+    #include "mlir/Rewrite/FrozenRewritePatternSet.h"
+    #include "mlir/Transforms/DialectConversion.h"
+
+    // Here is an example MLIR Pass that one can write externally and 
+    // use via the cudaq-opt tool, with the --load-cudaq-plugin flag. 
+    // The pass here is simple, replace Hadamard operations with S operations. 
+
+    using namespace mlir;
+
+    namespace {
+
+    struct ReplaceH : public OpRewritePattern<quake::HOp> {
+      using OpRewritePattern::OpRewritePattern;
+      LogicalResult matchAndRewrite(quake::HOp hOp,
+                                    PatternRewriter &rewriter) const override {
+        rewriter.replaceOpWithNewOp<quake::SOp>(
+            hOp, hOp.isAdj(), hOp.getParameters(), hOp.getControls(),
+            hOp.getTargets());
+        return success();
+      }
+    };
+
+    class CustomPassPlugin
+        : public PassWrapper<CustomPassPlugin, OperationPass<func::FuncOp>> {
+    public:
+      MLIR_DEFINE_EXPLICIT_INTERNAL_INLINE_TYPE_ID(CustomPassPlugin)
+  
+      llvm::StringRef getArgument() const override { return "cudaq-custom-pass"; }
+
+      void runOnOperation() override {
+        auto circuit = getOperation();
+        auto ctx = circuit.getContext();
+
+        RewritePatternSet patterns(ctx);
+        patterns.insert<ReplaceH>(ctx);
+        ConversionTarget target(*ctx);
+        target.addLegalDialect<quake::QuakeDialect>();
+        target.addIllegalOp<quake::HOp>();
+        if (failed(applyPartialConversion(circuit, target, std::move(patterns)))) {
+          circuit.emitOpError("simple pass failed");
+          signalPassFailure();
+        }
+      }
+    };
+
+    } // namespace
+
+    CUDAQ_REGISTER_MLIR_PASS(CustomPassPlugin)
+
+This example serves as a very simple template for creating custom MLIR 
+Passes that analyze the CUDA-Q Quake representation and perform 
+some general transformation. In this example, we create a rewrite pattern 
+that replaces :code:`Hadamard` operations with :code:`S` operations. 
+
+Ensure that :code:`add_subdirectory(Plugins)` is in the :code:`lib/CMakeLists.txt` file, 
+and also that there is a :code:`lib/Plugins/CMakeLists.txt` file that adds your 
+plugin directory with :code:`add_subdirectory`.
+
+Then build CUDA-Q and you will have a :code:`MyCustomPlugin.so` plugin library 
+in the install. You can load the plugin and use it with :code:`cudaq-opt` as follows: 
+
+.. code:: bash 
+
+    cudaq-opt --load-cudaq-plugin MyCustomPlugin.so file.qke -cudaq-custom-pass
+
diff --git a/pr-2241/sphinx/using/extending/nvqir_simulator.rst b/pr-2241/sphinx/using/extending/nvqir_simulator.rst
new file mode 100644
index 0000000000..899d2989c6
--- /dev/null
+++ b/pr-2241/sphinx/using/extending/nvqir_simulator.rst
@@ -0,0 +1,172 @@
+Extending CUDA-Q with a new Simulator
+*******************************************
+
+Backend circuit simulation in CUDA-Q is enabled via the 
+NVQIR library (:code:`libnvqir`). CUDA-Q code is ultimately lowered 
+to the LLVM IR in a manner that is adherent to the `QIR specification <https://qir-alliance.org>`_.
+NVQIR provides function implementations for the various declared functions 
+in the specification, which in turn delegate to an extensible simulation 
+architecture. 
+
+The primary extension point for NVQIR is the :code:`CircuitSimulator` class. This class
+exposes an API that enables qubit allocation and deallocation, quantum operation 
+invocation, and measurement and sampling. Subtypes of this class are free to 
+override these methods to affect simulation of the quantum code in any 
+simulation-strategy-specific manner (e.g., state vector, tensor network, etc.). Moreover, 
+subtypes are free to implement simulators that leverage classical accelerated computing. 
+
+In this document, we'll detail this simulator interface and walk through how to extend it for new types of simulation. 
+
+:code:`CircuitSimulator`
+------------------------
+
+The :code:`CircuitSimulator` type is defined in :code:`runtime/nvqir/CircuitSimulator.h`. It
+exposes a public API to `libnvqir` that is immediately subclassed in the :code:`CircuitSimulatorBase` 
+type. This type is templated on the floating point type used in the simulator's computations (e.g. :code:`double,float`).
+This templated type handles a lot of the base functionality required for allocating and deallocated qubits, 
+as well as measurement, sampling, and observation under a number of execution contexts. 
+This is the type that downstream simulation developers should extend. 
+
+The actual definition of the quantum state data structure, and its overall evolution are 
+left as tasks for :code:`CircuitSimulatorBase` subclasses. Examples of simulation subtypes can be found 
+in :code:`runtime/nvqir/qpp/QppCircuitSimulator.cpp` or :code:`runtime/nvqir/custatevec/CuStateVecCircuitSimulator.cpp`.
+The :code:`QppCircuitSimulator` models the state vector using the `Q++ <https://github.com/softwareqinc/qpp>`_ library, which 
+leverages the :code:`Eigen::Matrix` type and OpenMP threading for matrix-vector operations. 
+The :code:`CuStateVecCircuitSimulator` type models the state vector on an NVIDIA GPU device 
+by leveraging the cuQuantum library. 
+
+The key methods that need to be overridden by subtypes of :code:`CircuitSimulatorBase` are as follows:
+
+.. list-table:: Required Circuit Simulator Subtype Method Overrides
+
+    * - Method Name 
+      - Method Arguments
+      - Method Description
+    * - :code:`addQubitToState`
+      - :code:`void` 
+      - Add a qubit to the underlying state representation.
+    * - :code:`addQubitsToState`
+      - :code:`nQubits : std::size_t` 
+      - Add the specified number of qubits to the underlying state representation.
+    * - :code:`resetQubit`
+      - :code:`qubitIdx : std::size_t`
+      - Reset the state of the qubit at the given index to :code:`|0>`
+    * - :code:`resetQubitStateImpl`
+      - :code:`void` 
+      - Clear the entire state representation (reset to 0 qubits).
+    * - :code:`applyGate`
+      - :code:`task : GateApplicationTask`
+      - Apply the specified gate described by the :code:`GateApplicationTask`. This type encodes the control and target qubit indices, optional rotational parameters, and the gate matrix data. 
+    * - :code:`measureQubit`
+      - :code:`qubitIdx : std::size_t -> bool` (returns bit result as bool)
+      - Measure the qubit, produce a bit result, collapse the state.
+    * - :code:`sample`
+      - :code`qubitIdxs : std::vector<std::size_t>, shots : int`
+      - Sample the current multi-qubit state on the provided qubit indices over a certain number of shots
+    * - :code:`name`
+      - :code:`void`
+      - Return the name of this CircuitSimulator, must be the same as the name used in :code:`nvq++ -qpu NAME ...`
+
+To extend a subtype class, you will need to create a new :code:`cpp` implementation file with the same name as your 
+subtype class name. In this file, you will subclass the :code:`CircuitSimulatorBase<FloatType>` and implement the methods in 
+the above table. Finally, the subclass must be registered with the NVQIR library so that it 
+can be picked up and used when a user specifies :code:`nvq++ --target mySimulator ...` from the command line (or :code:`cudaq.set_target('mySimulator')` in Python.)
+Type registration can be performed with a provided NVQIR macro, 
+
+.. code:: cpp 
+
+    NVQIR_REGISTER_SIMULATOR(MySimulatorClassName, mySimulator)
+
+where :code:`MySimulatorClassName` is the name of your subtype, and :code:`mySimulator` is the 
+same name as what :code:`MySimulatorClassName::name()` returns, and what you desire the 
+:code:`-qpu NAME` name to be. 
+
+A further requirement is that the code be compiled into its own standalone shared library 
+with name :code:`libnvqir-NAME.{so,dylib}`, where NAME is the 
+same name as what :code:`MySimulatorClassName::name()` returns, and what you desire the 
+:code:`-qpu NAME` name to be. You will also need to create a :code:`NAME.config` file that 
+contains the following contents 
+
+.. code:: bash 
+
+    NVQIR_SIMULATION_BACKEND="NAME"
+
+The library must be installed in :code:`$CUDA_QUANTUM_PATH/lib` and the configuration file 
+must be installed to :code:`$CUDA_QUANTUM_PATH/platforms`.
+
+Let's see this in action 
+------------------------
+
+CUDA-Q provides some CMake utilities to make the creation of your new simulation library 
+easier. Specifically, by using :code:`find_package(NVQIR)`, you'll get access to a :code:`nvqir_add_backend` function
+that will automate much of the boilerplate for creating your library and configuration file.
+
+Let's assume you want a simulation subtype named :code:`MySimulator`. You can create a folder or 
+repository for this code called :code:`my-simulator` and add :code:`MySimulator.cpp` and 
+:code:`CMakeLists.txt` files. Fill the CMake file with the following: 
+
+.. code:: cmake 
+
+    cmake_minimum_required(VERSION 3.24 FATAL_ERROR)
+    project(DemoCreateNVQIRBackend VERSION 1.0.0 LANGUAGES CXX)
+    find_package(NVQIR REQUIRED)
+    nvqir_add_backend(MySimulator MySimulator.cpp "")
+
+and then fill out your :code:`MySimulator.cpp` file with your subtype implementation. For example, 
+
+.. code:: cpp
+
+    #include "CircuitSimulator.h"
+
+    namespace {
+
+      class MySimulator : public nvqir::CircuitSimulatorBase<double> {
+
+      protected:
+        /// @brief Grow the state vector by one qubit.
+        void addQubitToState() override { ... }
+
+        /// @brief Grow the state vector by `count` qubit.
+        void addQubitsToState(std::size_t count) override { ... }
+
+        /// @brief Reset the qubit state.
+        void resetQubitStateImpl() override { ... }
+
+        /// @brief Apply the given gate
+        void applyGate(const GateApplicationTask &task) override { ... }
+
+      public:
+        MySimulator() = default;
+        virtual ~MySimulator() = default;
+        
+        bool measureQubit(std::size_t qubitIdx) override { ... }
+
+        void resetQubit(std::size_t &qubitIdx) override { ... }
+
+        cudaq::SampleResult sample(std::vector<std::size_t> &measuredBits,
+                              int shots) override { ... }
+
+        const std::string_view name() const override { return "MySimulator"; }
+      
+      };
+
+    } // namespace
+
+    /// Register this Simulator with NVQIR.
+    NVQIR_REGISTER_SIMULATOR(MySimulator)
+
+To build, install, and use this simulation backend, run the following from the top-level of :code:`my-simulator`:
+
+.. code:: bash 
+
+    export CUDA_QUANTUM_PATH=/path/to/cuda_quantum/install
+    mkdir build && cd build 
+    cmake .. -G Ninja -DNVQIR_DIR="$CUDA_QUANTUM_PATH/lib/cmake/nvqir"
+    ninja install 
+
+Then given any CUDA-Q source file, you can compile and target your backend simulator with the following: 
+
+.. code:: bash 
+
+    nvq++ file.cpp --target MySimulator 
+    ./a.out 
diff --git a/pr-2241/sphinx/using/install/data_center_install.rst b/pr-2241/sphinx/using/install/data_center_install.rst
new file mode 100644
index 0000000000..b73cc94640
--- /dev/null
+++ b/pr-2241/sphinx/using/install/data_center_install.rst
@@ -0,0 +1,472 @@
+Installation from Source
+=========================
+
+In most cases, you should not need to build CUDA-Q from source. For the
+best experience, we recommend using a container runtime to avoid conflicts with
+other software tools installed on the system. Note that `Singularity
+<https://docs.sylabs.io/guides/2.6/user-guide/faq.html#what-is-so-special-about-singularity>`__
+or `Docker rootless mode <https://docs.docker.com/engine/security/rootless/>`__
+address common issue or concerns that are often the motivation for
+avoiding the use of containers. Singularity, for example, can be installed 
+in a user folder and its installation does not require admin permissions; see
+:ref:`this section <install-singularity-image>` for more detailed instructions 
+on how to do that. Our installation guide also contains instructions for how to 
+:ref:`connect an IDE <local-development-with-vscode>` to a running container.
+
+If you do not want use a container runtime, we also provide pre-built binaries
+for using CUDA-Q with C++, and Python wheels for using CUDA-Q with Python. 
+These binaries and wheels are built following the instructions 
+in this guide and should work for you as long as your system meets the compatibility 
+requirements listed under :ref:`Prerequisites <compatibility-prebuilt-binaries>`. 
+To install the pre-built binaries, please follow the instructions 
+:ref:`here <install-prebuilt-binaries>`. To install the Python wheels, please 
+follow the instructions :ref:`here <install-python-wheels>`.
+
+If your system is not listed as supported by our official packages, e.g. because you would 
+like to use CUDA-Q on an operating system that uses an older C standard library, 
+please follow this guide carefully without skipping any steps to build and install
+CUDA-Q from source. The rest of this guide details system requirements 
+during the build and after installation, and walks through the installation steps.
+
+.. note::
+
+  CUDA-Q contains some components that are only included as
+  pre-built binaries and not part of our open source repository. We are working on
+  either open-sourcing these components or making them available as separate downloads
+  in the future. Even without these components, almost all features of CUDA-Q
+  will be enabled in a source build, though some pieces may be less performant. 
+  At this time, the :ref:`multi-GPU state vector simulator <nvidia-mgpu-backend>` 
+  backend will not be included if you build CUDA-Q from source.
+
+
+.. _compatibility-prebuilt-binaries:
+
+Prerequisites
+++++++++++++++++++++++++++++++++++++
+
+The following pre-requisites need to be satisfied both on the build system and
+on the host system, that is the system where the built CUDA-Q binaries
+will be installed and used.
+
+- Linux operating system. The instructions in this guide have been validated
+  with the `AlmaLinux 8 image <https://hub.docker.com/u/almalinux>`__ that
+  serves as the base image for the `manylinux_2_28 image
+  <https://github.com/pypa/manylinux>`__, and should work for the operating
+  systems CentOS 8, Debian 11 and 12, Fedora 38, OpenSUSE/SLED/SLES 15.5, RHEL 8
+  and 9, Rocky 8 and 9, and Ubuntu 22.04. Other operating systems may work, but
+  have not been tested.
+- `Bash <https://www.gnu.org/software/bash/>`__ shell. The CUDA-Q 
+  build, install and run scripts expect to use `/bin/bash`.
+- `GNU C library <https://www.gnu.org/software/libc/>`__. 
+  Make sure that the version on the host system is the same one
+  or newer than the version on the build system. Our own builds
+  use version 2.28.
+- CPU with either x86-64 (x86-64-v3 architecture and newer) or ARM64
+  (ARM v8-A architecture and newer). Other architectures may work but are not tested and may require
+  adjustments to the build instructions.
+- Needed **only on the host** system: NVIDIA GPU with Volta, Turing, Ampere, Ada, or
+  Hopper architecture and `Compute Capability
+  <https://developer.nvidia.com/cuda-gpus>`__ 7+. Make sure you have the latest
+  `drivers <https://www.nvidia.com/download/index.aspx>`__ installed for your
+  GPU, and double check that the driver version listed by the `nvidia-smi`
+  command is 470.57.02 or newer. You do *not* need to have a GPU available on the
+  build system; the CUDA compiler needed for the build can be installed and used
+  without a GPU.
+
+We strongly recommend using a virtual environment for the build that includes
+*only* the tools and dependencies listed in this guide. If you have additional
+software installed, you will need to make sure that the build is linking against
+the correct libraries and versions.
+
+
+Build Dependencies
+++++++++++++++++++++++++++++++++++++
+
+In addition to the prerequisites listed above, you will need to install the
+following prerequisites in your build environment prior to proceeding with 
+the build as described in the subsequent sections:
+
+- Python version 3.8 or newer: If you intend to build CUDA-Q with Python
+  support, make sure the Python version on the build system matches the version
+  on the host system. If you intend to only build the C++ support for
+  CUDA-Q, the Python interpreter is required only for some of the 
+  LLVM build scripts and the Python version used for the build does not have 
+  to match the version on the host system.
+- Common tools: `wget`, `git`, `unzip`. The commands in the rest of this guide assume
+  that these tools are present on the build system, but they can be replaced by
+  other alternatives (such as, for example, manually going to a web page and
+  downloading a file/folder).
+
+The above prerequisites are no longer needed once CUDA-Q is built and 
+do not need to be present on the host system.
+
+.. note::
+
+  The CUDA-Q build scripts and the commands listed in the rest of this 
+  document assume you are using `bash` as the shell for your build.
+
+In addition to installing the needed build dependencies listed above, make sure
+to set the following environment variables prior to proceeding:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>InstallLocations]
+    :end-before: [<InstallLocations]
+
+These environment variables *must* be set during the build. We strongly
+recommend that their value is set to a path that does *not* already exist; 
+this will ensure that these components are built/installed as needed when
+building CUDA-Q.
+The configured paths can be chosen freely, but the paths specified during the
+build are also where the corresponding libraries will be installed on the 
+host system. We are working on making this more flexible in the future.
+
+.. note::
+
+  Please do **not** set `LLVM_INSTALL_PREFIX` to an existing directory;
+  To avoid compatibility issues, it is important to use the same compiler
+  to build the LLVM/MLIR dependencies from source as is later used to 
+  build CUDA-Q itself.
+
+.. note::
+
+  If you are setting the `CURL_INSTALL_PREFIX` variable to an existing 
+  CURL installation (not recommended), please make sure the command 
+  `curl --version` lists HTTP and HTTPS as supported protocols. If these 
+  protocols are not listed, please instead set the `CURL_INSTALL_PREFIX` 
+  variable to a path that does *not* exist. In that case, a suitable 
+  library will be automatically built from source as part of
+  building CUDA-Q.
+
+If you deviate from the instructions below for installing one of the
+dependencies and instead install it, for example, via package manager, you will
+need to make sure that the installation path matches the path you set for the
+corresponding environment variable(s).
+
+CUDA
+~~~~~~~~~~
+
+Building CUDA-Q requires a full installation of the CUDA toolkit.
+**You can install the CUDA toolkit and use the CUDA compiler without having a GPU.**
+The instructions are tested using version 11.8, but any CUDA 11 or 12 version
+should work, as long as the CUDA runtime version on the host system matches the 
+CUDA version used for the build, and the installed driver on the host 
+system supports that CUDA version. We recommend using the latest CUDA version
+that is supported by the driver on the host system.
+
+Download a suitable `CUDA version <https://developer.nvidia.com/cuda-toolkit-archive>`__
+following the installation guide for your platform in the online documentation
+linked on that page.
+
+Within the tested AlmaLinux 8 environment, for example, the following commands
+install CUDA 11.8:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAInstall]
+    :end-before: [<CUDAInstall]
+
+Toolchain
+~~~~~~~~~~
+
+The compiler toolchain used for the build must be a supported 
+`CUDA host compiler <https://docs.nvidia.com/cuda/cuda-compiler-driver-nvcc/index.html#supported-host-compilers>`__
+for the installed CUDA version.
+The following instructions have been tested with `GCC-11 <https://gcc.gnu.org/index.html>`__.
+Other toolchains may be supported but have not been tested.
+
+Within the tested AlmaLinux 8 environment, for example, the following commands
+install GCC 11:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>gccInstall]
+    :end-before: [<gccInstall]
+
+Independent on which compiler toolchain you installed, set the following
+environment variables to point to the respective compilers on your build system:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>ToolchainConfiguration]
+    :end-before: [<ToolchainConfiguration]
+
+- The variables `CC` and `CXX` *must* be set for the CUDA-Q build.
+- To use GPU-acceleration in CUDA-Q, make sure to set `CUDACXX` to 
+  your CUDA compiler, and `CUDAHOSTCXX` to the CUDA compatible host 
+  compiler you are using. If the CUDA compiler is not found when building
+  CUDA-Q, some components and backends will be omitted automatically 
+  during the build.
+
+
+Building CUDA-Q
+++++++++++++++++++++++++++++++++++++
+
+This installation guide has been written for a specific version/commit of CUDA-Q. 
+Make sure to obtain the source code for that version. 
+Clone the CUDA-Q `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__ and
+checkout the appropriate branch, tag, or commit. 
+Note that the build scripts assume that they are run from within a git repository, 
+and merely downloading the source code as ZIP archive hence will not work.
+
+Please follow the instructions in the respective subsection(s) to build the necessary 
+components for using CUDA-Q from C++ and/or Python.
+After the build, check that the GPU-accelerated components have been built by confirming
+that the file `nvidia.config` exists in the `$CUDAQ_INSTALL_PREFIX/targets` folder.
+We also recommend checking the build log printed to the console to confirm that all desired 
+components have been built. 
+
+.. note::
+
+  The CUDA-Q build will compile or omit optional components automatically depending
+  on whether the necessary pre-requisites are found in the build environment.
+  If you see a message that a component has been skipped, and/or the CUDA compiler
+  is not properly detected, make sure you followed the 
+  instructions for installing the necessary prerequisites and build dependencies, 
+  and have set the necessary environment variables as described in this document.
+
+.. _cudaq-python-from-source:
+
+Python Support
++++++++++++++++++++++++++++++++
+
+The most convenient way to enable Python support within CUDA-Q is to build 
+a `wheel <https://pythonwheels.com/>`__ that can then easily be installed
+using `pip`. To ensure the wheel can be installed on the host system, make sure to
+use the same Python version for the build as the one that is installed on the host system.
+To build a CUDA-Q Python wheel, you will need to install the following additional 
+Python-specific tools:
+
+- Python development headers: The development headers for your Python version are installed
+  in the way as you installed Python itself. If you installed Python via the package manager
+  for your system, you may need to install an additional package to get the development headers.
+  The package name is usually your python version followed by either a `-dev` or `-devel` suffix.
+  If you are using a `Conda environment <https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-python.html>`__,
+  the necessary headers should already be installed.
+- Pip package manager: Make sure the `pip` module is enable for your Python version.
+  We refer to the Python `documentation <https://pip.pypa.io/en/stable/installation/>`__ for
+  more information about installing/enabling `pip`.
+- Python modules: Install the additional modules `numpy`, `build`, `auditwheel`, and `patchelf` for your
+  Python version, e.g. `python3 -m pip install numpy build auditwheel patchelf`.
+
+From within the folder where you cloned the CUDA-Q repository, run the following
+command to build the CUDA-Q Python wheel:
+
+.. literalinclude:: ../../../../docker/build/assets.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumPythonBuild]
+    :end-before: [<CUDAQuantumPythonBuild]
+
+.. note::
+
+  A version identifier will be automatically assigned to the wheel based on the commit
+  history. You can manually override this detection to give a more descriptive identifier
+  by setting the environment variable `SETUPTOOLS_SCM_PRETEND_VERSION` to the desired
+  value before building the wheel.
+
+After the initial build, `auditwheel <https://github.com/pypa/auditwheel>`__ is used to 
+include dependencies in the wheel, if necessary, and correctly label the wheel.
+We recommend not including the CUDA runtime libraries and instead install them separately
+on the host system following the instructions in the next section. The following 
+command builds the final wheel, not including CUDA dependencies: 
+
+.. literalinclude:: ../../../../docker/build/assets.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumWheel]
+    :end-before: [<CUDAQuantumWheel]
+
+The command above will create a new wheel in the `wheelhouse` folder. This wheel can be
+installed on any `compatible platform <https://packaging.python.org/en/latest/specifications/platform-compatibility-tags/>`__.
+
+.. note::
+  You can confirm that the wheel is indeed compatible with your host platform by 
+  checking that the wheel tag (i.e. the file name ending of the `.whl` file) is listed under
+  "Compatible Tags" when running the command `python3 -m pip debug --verbose` on the host.
+
+.. _cudaq-cpp-from-source:
+
+C++ Support
++++++++++++++++++++++++++++++++
+
+From within the folder where you cloned the CUDA-Q repository, run the following
+command to build CUDA-Q:
+
+.. literalinclude:: ../../../../docker/build/assets.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumCppBuild]
+    :end-before: [<CUDAQuantumCppBuild]
+
+Note that `lld` is primarily needed when the build or host system does not already
+have an existing default linker on its path; CUDA-Q supports the same linkers as
+`clang` does.
+
+To easily migrate the built binaries to the host system, we recommend creating a
+`self-extracting archive <https://makeself.io/>`__. To do so, download the 
+`makeself script(s) <https://github.com/megastep/makeself>`__ and move the necessary 
+files to install into a separate folder using the command
+
+.. literalinclude:: ../../../../docker/release/installer.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumAssets]
+    :end-before: [<CUDAQuantumAssets]
+
+You can then create a self-extracting archive with the command
+
+.. code-block:: bash
+
+    ./makeself.sh --gzip --sha256 --license cuda_quantum_assets/cudaq/LICENSE \
+        cuda_quantum_assets install_cuda_quantum.$(uname -m) \
+        "CUDA-Q toolkit for heterogeneous quantum-classical workflows" \
+        bash cudaq/migrate_assets.sh -t /opt/nvidia/cudaq
+
+Installation on the Host
+++++++++++++++++++++++++++++++++++++
+
+Make sure your host system satisfies the `Prerequisites`_ listed above.
+
+- To use CUDA-Q with Python, you should have a working
+  Python installation on the host system, including the `pip` package manager.
+- To use CUDA-Q with C++, you should make sure that you have the necessary development
+  headers of the C standard library installed. You can check this by searching for
+  `features.h`, commonly found in `/usr/include/`. You can install the necessary headers
+  via package manager (usually the package name is called something like `glibc-devel`
+  or `libc6-devel`). These headers are also included with any installation of GCC.
+
+To use CUDA-Q with Python, you should have a working
+Python installation on the host system, including the `pip` package manager.
+
+If you followed the instructions for building the 
+:ref:`CUDA-Q Python wheel <cudaq-python-from-source>`,
+copy the built `.whl` file to the host system, and install it using `pip`; e.g.
+
+.. code-block:: bash
+
+    pip install cuda_quantum*.whl
+
+To install the necessary CUDA and MPI dependencies for some of the components, 
+you can either follow the instructions on `PyPI.org <https://pypi.org/project/cuda-quantum/>`__, 
+replacing `pip install cuda-quantum` with the command above, or you can follow the
+instructions in the remaining sections of this document to customize and better
+optimize them for your host system.
+
+If you followed the instructions for building the 
+:ref:`CUDA-Q C++ tools <cudaq-cpp-from-source>`,
+copy the `install_cuda_quantum` file that you created to the host system, 
+and install it by running the commands
+
+.. code-block:: bash
+
+    sudo bash install_cuda_quantum.$(uname -m) --accept
+    . /opt/nvidia/cudaq/set_env.sh
+
+This will extract the built assets and move them to the correct locations.
+The `set_env.sh` script in `/opt/nvidia/cudaq` defines the necessary environment
+variables to use CUDA-Q. To avoid having to set them manually every time a 
+new shell is opened, we highly recommend adding the following lines to
+the `/etc/profile` file:
+
+.. code-block:: bash
+
+    if [ -f /opt/nvidia/cudaq/set_env.sh ];
+      . /opt/nvidia/cudaq/set_env.sh
+    fi
+
+.. note::
+  CUDA-Q as built following the instructions above includes and uses the LLVM
+  C++ standard library. This will not interfere with any other C++ standard library
+  you may have on your system. Pre-built external libraries, you may want to use with 
+  CUDA-Q, such as specific optimizers for example, have a C API to ensure compatibility
+  across different versions of the C++ standard library and will work with CUDA-Q without 
+  issues. The same is true for all distributed CUDA libraries. To build you own CUDA 
+  libraries that can be used with CUDA-Q, please take a look at :doc:`../integration/cuda_gpu`.
+
+The remaining sections in this document list additional runtime dependencies 
+that are not included in the migrated assets and are needed to use some of the 
+CUDA-Q features and components.
+
+CUDA Runtime Libraries
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To use GPU-acceleration in CUDA-Q you will need to install the necessary 
+CUDA runtime libraries. Their version (at least the version major) needs to match the version
+used for the build. While not necessary, we recommend installing 
+the complete CUDA toolkit like you did for the CUDA-Q build.
+If you prefer to only install the minimal set of runtime libraries, the following 
+commands, for example, install the necessary packages for the AlmaLinux 8 environment:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>CUDARTInstall]
+    :end-before: [<CUDARTInstall]
+
+MPI
+~~~~~~
+
+To work with all CUDA-Q backends, a CUDA-aware MPI installation is required. 
+If you do not have an existing CUDA-aware MPI installation, you can build one from 
+source. To do so, in addition to the CUDA runtime libraries listed above 
+you will need to install the CUDA runtime development package 
+(`cuda-cudart-devel-${version_suffix}` or `cuda-cudart-dev-${version_suffix}`, 
+depending on your distribution).
+
+The following commands build a sufficient CUDA-aware OpenMPI installation.
+To make best use of MPI, we recommend a more fully featured installation including
+additional configurations that fit your host system.
+The commands below assume you have the necessary prerequisites for the OpenMPI build
+installed on the build system. Within the tested AlmaLinux 8 environment, for example,
+the packages `autoconf`, `libtool`, `flex`, and `make` need to be installed.
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>OpenMPIBuild]
+    :end-before: [<OpenMPIBuild]
+
+Confirm that you have a suitable MPI implementation installed. For OpenMPI and MPICH,
+for example, this can be done by compiling and running the following program:
+
+.. literalinclude:: ../../../../docker/test/installer/mpi_cuda_check.cpp
+    :language: cpp
+
+.. note::
+
+  If you are encountering an error similar to "The value of the MCA parameter `plm_rsh_agent` 
+  was set to a path that could not be found", please make sure you have an SSH Client installed
+  or update the MCA parameter to another suitable agent.
+  MPI uses `SSH <https://en.wikipedia.org/wiki/Secure_Shell>`__ or
+  `RSH <https://en.wikipedia.org/wiki/Remote_Shell>`__ to communicate with each node
+  unless another resource manager, such as
+  `SLURM <https://slurm.schedmd.com/overview.html>`__, is used. 
+
+Different MPI implementations are supported via a plugin infrastructure in CUDA-Q.
+Once you have a CUDA-aware MPI installation on your host system, you can 
+configure CUDA-Q to use it by activating the necessary plugin.
+Plugins for OpenMPI and MPICH are included in CUDA-Q and can be activated by
+setting the environment variable `MPI_PATH` to the MPI installation folder 
+and then running the command
+
+.. code-block:: bash
+
+    bash "${CUDA_QUANTUM_PATH}/distributed_interfaces/activate_custom_mpi.sh"
+
+.. note::
+
+  To activate the MPI plugin for the Python support, replace `${CUDA_QUANTUM_PATH}`
+  with the path that is listed under "Location" when you run the command
+  `pip show cuda-quantum`.
+
+If you use a different MPI implementation than OpenMPI or MPICH, you will need to 
+implement the necessary plugin interface yourself prior to activating the plugin 
+with the command above.
+
+.. TODO:
+  For more information about building and activating a custom MPI plugin, see ...
diff --git a/pr-2241/sphinx/using/install/install.rst b/pr-2241/sphinx/using/install/install.rst
new file mode 100644
index 0000000000..ad3e59decb
--- /dev/null
+++ b/pr-2241/sphinx/using/install/install.rst
@@ -0,0 +1,11 @@
+Installation Guide
+*******************************************
+
+.. _install-cuda-quantum:
+
+.. toctree::
+  :caption: Contents
+  :maxdepth: 1
+
+  Local Installation <local_installation.rst>
+  Data Center Installation <data_center_install.rst>
diff --git a/pr-2241/sphinx/using/install/local_installation.rst b/pr-2241/sphinx/using/install/local_installation.rst
new file mode 100644
index 0000000000..695dc6de72
--- /dev/null
+++ b/pr-2241/sphinx/using/install/local_installation.rst
@@ -0,0 +1,921 @@
+Local Installation
+===================
+
+Introduction
+-------------------
+
+This guide walks through how to :ref:`install CUDA-Q <install-cuda-quantum>` on your system, and how to set up :ref:`VS Code for local development <local-development-with-vscode>`.
+The section on :ref:`connecting to a remote host <connect-to-remote>` contains some
+guidance for application development on a remote host where CUDA-Q is installed.
+
+The following sections contain instructions for how to install CUDA-Q on your machine using
+
+- :ref:`Docker <install-docker-image>`: A fully featured CUDA-Q installation including all C++ and Python tools is available as a `Docker <https://docs.docker.com/get-started/overview/>`__ image.
+- :ref:`Singularity <install-singularity-image>`: A `Singularity <https://docs.sylabs.io/guides/latest/user-guide/introduction.html>`__ container can easily be created based on our Docker images. 
+- :ref:`PyPI <install-python-wheels>`: Additionally, we distribute pre-built Python wheels via `PyPI <https://pypi.org>`__.
+- :ref:`Pre-built binaries <install-prebuilt-binaries>`: We also provide pre-built C++ binaries, bundled as `self-extracting archive <https://makeself.io/>`__, that work across a range of Linux operating systems.
+
+If you would like to build CUDA-Q from source to deploy on an HPC system without relying on a container runtime, please follow the instructions for :doc:`data_center_install`. 
+If, on the other hand, you want to contribute to the development of CUDA-Q itself and hence want to 
+build a custom version of CUDA-Q from source, follow the instructions on the 
+`CUDA-Q GitHub repository <https://github.com/NVIDIA/cuda-quantum/blob/main/Building.md>`__ instead.
+
+If you are unsure which option suits you best, we recommend using our :ref:`Docker image <install-docker-image>` to develop your applications in a controlled environment that does not depend on, or interfere with, other software
+that is installed on your system.
+
+.. _install-docker-image:
+
+Docker
+++++++++++++++++++++++++++++++++++++
+
+To download and use our Docker images, you will need to install and launch the Docker engine. 
+If you do not already have Docker installed on your system, you can get it by downloading and installing `Docker Desktop <https://docs.docker.com/get-docker/>`_. 
+If you do not have the necessary administrator permissions to install software on your machine,
+take a look at the section below on how to use `Singularity`_ instead.
+
+Docker images for all CUDA-Q releases are available on the `NGC Container Registry`_.
+In addition to publishing `stable releases <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__, 
+we also publish Docker images whenever we update certain branches on our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`_.
+These images are published in our `nightly channel on NGC <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum/tags>`__.
+To download the latest version on the main branch of our GitHub repository, for example, use the command
+
+.. code-block:: console
+
+    docker pull nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+.. _NGC Container Registry: https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum
+
+Early prototypes for features we are considering can be tried out by using the image tags starting 
+with `experimental`. The `README` in the `/home/cudaq` folder in the container gives more details 
+about the feature. We welcome and appreciate your feedback about these early prototypes; 
+how popular they are will help inform whether we should include them in future releases.
+
+Once you have downloaded an image, the container can be run using the command
+
+.. code-block:: console
+
+    docker run -it --name cuda-quantum nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+Replace the image name and/or tag in the command above, if necessary, with the one you want to use.
+This will give you terminal access to the created container. To enable support 
+for GPU-accelerated backends, you will need to pass the :code:`--gpus` flag when launching
+the container, for example:
+
+.. code-block:: console
+
+    docker run -it --gpus all --name cuda-quantum nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+.. note:: 
+
+  This command will fail if you do not have a suitable NVIDIA GPU available, or if your driver 
+  version is insufficient. To improve compatibility with older drivers, you may need to install the 
+  `NVIDIA container toolkit`_.
+
+.. _NVIDIA container toolkit: https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html
+
+You can stop and exit the container by typing the command :code:`exit`. If you did not specify
+:code:`--rm` flag when launching the container, the container still exists after exiting, as well as any 
+changes you made in it. You can get back to it using
+the command :code:`docker start -i cuda-quantum`. 
+You can delete an existing container and any changes you made using :code:`docker rm -v cuda-quantum`.
+
+When working with Docker images, the files inside the container are not visible outside the container environment. 
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+please take a look at the section on :ref:`Development with VS Code <docker-in-vscode>`.
+
+Alternatively, it is possible, but not recommended, to launch an SSH server inside the container environment and connect an IDE using SSH. To do so, make sure you have generated a suitable RSA key pair; if your `~/.ssh/` folder does not already contain the files `id_rsa.pub` and `id.rsa`,
+follow the instructions for generating a new SSH key on `this page <https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent>`__.
+You can then launch the container and connect to it via SSH by executing the following commands:
+
+.. code-block:: console
+
+    docker run -itd --gpus all --name cuda-quantum -p 2222:22 nvcr.io/nvidia/nightly/cuda-quantum:latest
+    docker exec cuda-quantum bash -c "sudo apt-get install -y --no-install-recommends openssh-server"
+    docker exec cuda-quantum bash -c "sudo sed -i -E "s/#?\s*UsePAM\s+.+/UsePAM yes/g" /etc/ssh/sshd_config"
+    docker cp ~/.ssh/id_rsa.pub cuda-quantum:/home/cudaq/.ssh/authorized_keys
+    docker exec -d cuda-quantum bash -c "sudo -E /usr/sbin/sshd -D"
+    ssh cudaq@localhost -p 2222 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o GlobalKnownHostsFile=/dev/null
+
+
+.. _install-singularity-image:
+
+Singularity
+++++++++++++++++++++++++++++++++++++
+
+You can use `Singularity <https://github.com/sylabs/singularity>`__ to run a CUDA-Q container in a folder without needing administrator permissions.
+If you do not already have Singularity installed, you can build a relocatable installation from source. 
+To do so on Linux or WSL, make sure you have the `necessary prerequisites <https://docs.sylabs.io/guides/4.0/user-guide/quick_start.html#prerequisites>`__ installed, download a suitable version of the `go toolchain <https://docs.sylabs.io/guides/4.0/user-guide/quick_start.html#install-go>`__, and make sure the `go` binaries are on your :code:`PATH`. You can then build Singularity with the commands
+
+.. code-block:: console
+
+    wget https://github.com/sylabs/singularity/releases/download/v4.0.1/singularity-ce-4.0.1.tar.gz
+    tar -xzf singularity-ce-4.0.1.tar.gz singularity-ce-4.0.1/ && rm singularity-ce-4.0.1.tar.gz && cd singularity-ce-4.0.1/
+    ./mconfig --without-suid --prefix="$HOME/.local/singularity"
+    make -C ./builddir && make -C ./builddir install && cd .. && rm -rf singularity-ce-4.0.1/
+    echo 'PATH="$PATH:$HOME/.local/singularity/bin/"' >> ~/.profile && source ~/.profile
+
+For more information about using Singularity on other systems, take a look at the `admin guide <https://docs.sylabs.io/guides/4.0/admin-guide/installation.html#installation-on-windows-or-mac>`__.
+
+Once you have singularity installed, create a file `cuda-quantum.def` with the following content:
+
+.. code-block:: console
+
+    Bootstrap: docker
+    From: nvcr.io/nvidia/nightly/cuda-quantum:latest
+
+    %runscript
+        mount devpts /dev/pts -t devpts
+        cp -r /home/cudaq/* .
+        bash
+
+Replace the image name and/or tag in the `From` line, if necessary, with the one you want to use;
+In addition to publishing `stable releases <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags>`__, 
+we also publish Docker images whenever we update certain branches on our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`_.
+These images are published in our `nightly channel on NGC <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum/tags>`__.
+Early prototypes for features we are considering can be tried out by using the image tags starting 
+with `experimental`. We welcome and appreciate your feedback about these early prototypes; 
+how popular they are will help inform whether we should include them in future releases.
+
+You can then create a CUDA-Q container by running the following commands:
+
+.. code-block:: console
+
+    singularity build --fakeroot cuda-quantum.sif cuda-quantum.def
+    singularity run --writable --fakeroot cuda-quantum.sif
+
+In addition to the files in your current folder, you should now
+see a `README` file, as well as examples and tutorials.
+To enable support for GPU-accelerated backends, you will need to pass the
+the :code:`--nv` flag when running the container:
+
+.. code-block:: console
+
+    singularity run --writable --fakeroot --nv cuda-quantum.sif
+    nvidia-smi
+
+The output of the command above lists the GPUs that are visible and accessible in the container environment.
+
+.. note:: 
+
+  If you do not see any GPUs listed in the output of `nvidia-smi`, 
+  it means the container environment is unable to access a suitable NVIDIA GPU. 
+  This can happen if your driver version is insufficient, or if you are 
+  working on WSL. To improve compatibility with older drivers, or to enable GPU support
+  on WSL, please install the `NVIDIA container toolkit`_, and update the singularity configuration 
+  to set `use nvidia-container-cli` to `yes` and configure the correct `nvidia-container-cli path`. 
+  The two commands below use `sed` to do that:
+
+  .. code-block:: console
+
+    sed -i 's/use nvidia-container-cli = no/use nvidia-container-cli = yes/' "$HOME/.local/singularity/etc/singularity/singularity.conf"
+    sed -i 's/# nvidia-container-cli path =/nvidia-container-cli path = \/usr\/bin\/nvidia-container-cli/' "$HOME/.local/singularity/etc/singularity/singularity.conf"
+
+You can exit the container environment by typing the command :code:`exit`.
+Any changes you made will still be visible after you exit the container, and you can re-enable the 
+container environment at any time using the `run` command above.
+
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+please take a look at the section on :ref:`Development with VS Code <singularity-in-vscode>`.
+
+
+.. _install-python-wheels:
+
+Python wheels
+++++++++++++++++++++++++++++++++++++
+
+CUDA-Q Python wheels are available on `PyPI.org <https://pypi.org/project/cuda-quantum>`__. 
+Installation instructions can be found in the `project description <https://pypi.org/project/cuda-quantum/#description>`__.
+For more information about available versions and documentation,
+see :doc:`../../releases`.
+
+There are currently no source distributions available on PyPI, but you can download the 
+source code for the latest version of the CUDA-Q Python wheels from our 
+`GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__. 
+The source code for previous versions can be downloaded from the respective 
+`GitHub Release <https://github.com/NVIDIA/cuda-quantum/releases>`__.
+
+At this time, wheels are distributed for Linux operating systems only. 
+If your platform is not :ref:`officially supported <dependencies-and-compatibility>` and
+`pip` does not find a compatible wheel to install, you can build your own 
+wheel from source following the instructions here: :doc:`data_center_install`.
+
+To build the CUDA-Q Python API for the purpose of contributing to
+our `GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__,
+follow the instructions for 
+`Setting up your Environment <https://github.com/NVIDIA/cuda-quantum/blob/main/Dev_Setup.md>`__, 
+and then run the following commands in the repository root:
+
+.. code-block:: console
+
+    bash scripts/install_prerequisites.sh
+    pip install . --user
+
+.. _install-prebuilt-binaries:
+
+Pre-built binaries
+++++++++++++++++++++++++++++++++++++
+
+Starting with the 0.6.0 release, we provide pre-built binaries for using 
+CUDA-Q with C++. Support for using CUDA-Q with Python can be installed 
+side-by-side with the pre-built binaries for C++ by following the instructions on 
+`PyPI.org <https://pypi.org/project/cuda-quantum>`__.
+The pre-built binaries work across a range of Linux operating systems listed 
+under :ref:`dependencies-and-compatibility`. 
+
+Before installing our pre-built binaries, please make sure that your 
+operating system is using the `GNU C library <https://www.gnu.org/software/libc/>`__ 
+version 2.28 or newer. You can confirm this by checking the output of the command 
+`ldd --version`. If this command does not exist, or shows an older version than 2.28, 
+please double check that your operating system is listed as 
+:ref:`supported <dependencies-and-compatibility>`. If you use an operating system
+with an older GNU C library version, you will need to build the installer from 
+source following the instructions in :doc:`data_center_install`.
+
+You can download the `install_cuda_quantum` file for your processor architecture from
+the assets of the respective `GitHub release <https://github.com/NVIDIA/cuda-quantum/releases>`__. 
+The installer is a `self-extracting archive <https://makeself.io/>`__ that contains the 
+pre-built binaries as well as a script to move them to the correct locations. You will need
+`bash`, `tar`, and `gzip` (usually already installed on most Linux distributions) to run 
+the installer.
+The installation location of CUDA-Q is not currently configurable and using the installer
+hence requires admin privileges on the system. We may revise that in the future; please see and
+upvote the corresponding `GitHub issue <https://github.com/NVIDIA/cuda-quantum/issues/1075>`__.
+
+To install CUDA-Q, execute the command
+
+.. literalinclude:: ../../../../docker/test/installer/linux.Dockerfile
+    :language: bash
+    :dedent:
+    :start-after: [>CUDAQuantumInstall]
+    :end-before: [<CUDAQuantumInstall]
+
+.. note:: 
+
+  To use GPU-accelerated backends, you will need to install the necessary CUDA runtime libraries. 
+  For more information see the corresponding section on 
+  :ref:`Additional CUDA Tools <cuda-dependencies-prebuilt-binaries>`.
+
+The installation ensures that the necessary environment variables for
+using the CUDA-Q toolchain are set upon login for all POSIX shells.
+Confirm that the `nvq++` command is found. If it is not, please make sure 
+to set the environment variables defined by the `set_env.sh` script in the 
+CUDA-Q installation folder (usually `/usr/local/cudaq` or `/opt/nvidia/cudaq`).
+
+If an MPI installation is available in the directory defined by `MPI_PATH`, 
+the installer automatically enables MPI support in CUDA-Q.
+If you do not have MPI installed on your system, you can simply
+leave that path empty, and CUDA-Q will be installed without MPI support.
+If you install MPI at a later point in time, you can activate the MPI support in CUDA 
+Quantum by setting the `MPI_PATH` variable to its installation location and 
+executing the commands
+
+.. code-block:: console
+
+    MPI_PATH=/usr/local/openmpi # update this path as needed
+    bash "${CUDA_QUANTUM_PATH}/distributed_interfaces/activate_custom_mpi.sh"
+
+.. note::
+
+  Please make sure that you have the necessary development headers of the C standard 
+  library installed. You can check this by searching for `features.h`, commonly found
+  in `/usr/include/`. You can install the necessary headers via package manager 
+  (usually the package name is called something like `glibc-devel` or `libc6-dev`). 
+  These headers are also included with any installation of GCC.
+
+.. _local-development-with-vscode:
+
+Development with VS Code
+------------------------------------
+
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+we recommend using `VS Code <https://code.visualstudio.com/>`_. VS Code provides a seamless
+development experience on all platforms, and is also available without installation via web browser. 
+This sections describes how to connect VS Code to a running container on your machine.
+The section on :ref:`connecting to a remote host <connect-to-remote>` contains information on
+how to set up your development environment when accessing CUDA-Q on a remote host instead.
+
+.. _docker-in-vscode:
+
+Using a Docker container
+++++++++++++++++++++++++++++++++++++++++
+
+Before connecting VS Code, open a terminal/shell, 
+and start the CUDA-Q Docker container following the 
+instructions in the :ref:`section above <install-docker-image>`. 
+
+If you have a local installation of `VS Code <https://code.visualstudio.com/>`_ 
+you can connect to the running container using the  
+`Dev Containers <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`__ extension. If you want to use VS Code in the web browser, please follow the instructions
+in the section `Developing with Remote Tunnels`_ instead.
+
+.. |:spellcheck-disable:| replace:: \
+.. |:spellcheck-enable:| replace:: \
+
+After installing the
+`Dev Containers <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers>`__ extension, launch VS Code, open the Command Palette with `Ctrl+Shift+P`, and enter 
+|:spellcheck-disable:|"Dev Containers: Attach to Running Container"|:spellcheck-enable:|.
+You should see and select the running `cuda-quantum` container in the list. 
+After the window reloaded, enter "File: Open Folder" in the Command Palette to open the `/home/cudaq/` folder.
+
+To run the examples, open the Command Palette and enter "View: Show Terminal"
+to launch an integrated terminal. You are now all set to 
+:ref:`get started <post-installation>` with CUDA-Q development.
+
+.. _singularity-in-vscode:
+
+Using a Singularity container
+++++++++++++++++++++++++++++++++++++++++
+
+If you have a GitHub or Microsoft account, we recommend that you connect 
+to a CUDA-Q container using tunnels. To do so, launch a CUDA-Q Singularity 
+container following the instructions in the :ref:`section above <install-singularity-image>`,
+and then follow the instructions in the section `Developing with Remote Tunnels`_.
+
+If you cannot use tunnels, you need a local installation of 
+`VS Code <https://code.visualstudio.com/>`_ and you need to install 
+the `Remote - SSH <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`__ extension. 
+Make sure you also have a suitable SSH key pair; if your `~/.ssh/` folder does not already contain
+the files `id_rsa.pub` and `id.rsa`, follow the instructions for generating a new SSH key on 
+`this page <https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent>`__.
+
+To connect VS Code to a running CUDA-Q container, 
+the most convenient setup is to install and run an SSH server 
+in the Singularity container. Open a terminal/shell in a separate window,
+and enter the following commands to create a suitable sandbox:
+
+.. code-block:: console
+
+    singularity build --sandbox cuda-quantum-sandbox cuda-quantum.sif
+    singularity exec --writable --fakeroot cuda-quantum-sandbox \
+      apt-get install -y --no-install-recommends openssh-server
+    cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
+
+You can launch this sandbox by entering the commands below. Please see the `Singularity`_ section above
+for more information about how to get the `cuda-quantum.sif` image, and how to enable GPU-acceleration
+with the `--nv` flag.
+
+.. code-block:: console
+
+    singularity run --writable --fakeroot --nv --network-args="portmap=22:2222/tcp" cuda-quantum-sandbox
+    /usr/sbin/sshd -D -p 2222 -E sshd_output.txt
+
+.. note::
+
+  Make sure to use a free port. You can check if the SSH server is ready and listening
+  by looking at the log in `sshd_output.txt`. If the port is already in use, you can 
+  replace the number `2222` by any free TCP port in the range `1025-65535` in all
+  commands.
+
+Entering `Ctrl+C` followed by `exit` will stop the running container. You can re-start
+it at any time by entering the two commands above. While the container is running,
+open the Command Palette in VS Code with `Ctrl+Shift+P`, enter "Remote-SSH: Add new
+SSH Host", and enter the following SSH command:
+
+.. code-block:: console
+
+    ssh root@localhost -p 2222 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o GlobalKnownHostsFile=/dev/null
+
+.. note::
+
+  If you are working on Windows and are building and running the Singularity container in WSL,
+  make sure to copy the used SSH keys to the Windows partition, such that VS Code can connect with 
+  the expected key. Alternatively, add the used public key to the `/root/.ssh/authorized_keys` file in 
+  the Singularity container.
+
+You can then connect to the host by opening the Command Palette, entering
+"Remote SSH: Connect Current Window to Host", and choosing the newly created host.
+After the window reloaded, enter "File: Open Folder" in the 
+Command Palette to open the desired folder.
+
+To run the examples, open the Command Palette and enter "View: Show Terminal"
+to launch an integrated terminal. You are now all set to 
+:ref:`get started <post-installation>` with CUDA-Q development.
+
+
+.. _connect-to-remote:
+
+Connecting to a Remote Host
+------------------------------------
+
+Depending on the setup on the remote host, there are a couple of different options 
+for developing CUDA-Q applications.
+
+- If a CUDA-Q container is running on the remote host,
+  and you have a GitHub or Microsoft account, take a look at
+  `Developing with Remote Tunnels`_. This works for both Docker
+  and Singularity containers on the remote host, and should also
+  work for other containers.
+- If you cannot use tunnels, or if you want to work with an
+  existing CUDA-Q installation without using a container, 
+  take a look at `Remote Access via SSH`_ instead.
+
+.. _connect-vscode-via-tunnel:
+
+Developing with Remote Tunnels
+++++++++++++++++++++++++++++++++++++
+
+`Remote access via tunnel <https://code.visualstudio.com/blogs/2022/12/07/remote-even-better>`__
+can easily be enabled with the `VS Code CLI <https://code.visualstudio.com/docs/editor/command-line>`__.
+This allows to connect either a local installation of `VS Code <https://code.visualstudio.com/>`_, 
+or the `VS Code Web UI <https://vscode.dev/>`__, to a running CUDA-Q container on the same or a different machine. 
+
+Creating a secure connection requires authenticating with the same GitHub or Microsoft account on each end.
+Once authenticated, an SSH connection over the tunnel provides end-to-end encryption. To download the VS Code CLI, if necessary, and create a tunnel, execute the 
+following command in the running CUDA-Q container,
+and follow the instructions to authenticate:
+
+.. code-block:: console
+
+    vscode-setup tunnel --name cuda-quantum-remote --accept-server-license-terms
+
+You can then either `open VS Code in a web browser <https://vscode.dev/tunnel/cuda-quantum-remote/home/cudaq/>`__, or connect a local installation of VS Code.
+To connect a local installation of VS Code, make sure you have the 
+`Remote - Tunnels <https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server>`__ extension installed,
+then open the Command Palette with `Ctrl+Shift+P`, enter "Remote Tunnels: Connect to Tunnel", 
+and enter `cuda-quantum-remote`. After the window reloaded, enter "File: Open Folder" in the Command Palette 
+to open the `/home/cudaq/` folder.
+
+You should see a pop up asking if you want to install the recommended extensions. Selecting to install them will
+configure VS Code with extensions for working with C++, Python, and Jupyter.
+You can always see the list of recommended extensions that aren't installed yet by clicking on the "Extensions" icon in the sidebar and navigating to the "Recommended" tab.
+
+Remote Access via SSH
+++++++++++++++++++++++++++++++++++++
+
+To facilitate application development with, for example, debugging, code completion, hover information, and so on, 
+you can connect a local installation of `VS Code <https://code.visualstudio.com/>`_ to a remote host via SSH. 
+
+.. note:: 
+
+  For the best user experience, we recommend to launch a CUDA-Q container on the remote host, 
+  and then connect :ref:`VS Code using tunnels <connect-vscode-via-tunnel>`.
+  If a connection via tunnel is not possible, this section describes using SSH instead.
+
+To do so, make sure you have `Remote - SSH <https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh>`__ extension installed.
+Open the Command Palette with `Ctrl+Shift+P`, enter "Remote-SSH: Add new
+SSH Host", and enter the SSH command to connect to your account on the remote host.
+You can then connect to the host by opening the Command Palette, entering
+"Remote SSH: Connect Current Window to Host", and choosing the newly created host.
+
+When prompted, choose Linux as the operating system, and enter your
+password. After the window reloaded, enter "File: Open Folder" in the 
+Command Palette to open the desired folder. Our GitHub repository contains
+a folder with VS Code configurations including a list of recommended extensions for
+working with CUDA-Q; you can copy `these configurations <https://github.com/NVIDIA/cuda-quantum/tree/main/docker/release/config/.vscode>`__ into the a folder named `.vscode` in your workspace to use them.
+
+If you want to work with an existing CUDA-Q installation on the remote host, you are all set.
+Alternatively, you can use Singularity to build and run a container following the instructions in 
+:ref:`this section <install-singularity-image>`. Once the `cuda-quantum.sif` image is built and 
+available in your home directory on the remote host, you can update your VS Code configuration 
+to enable/improve completion, hover information, and other development tools within the container.
+
+To do so, open the Command Palette and enter "Remote-SSH: Open SSH Configuration File". 
+Add a new entry to that file with the command to launch the container, and edit the configuration 
+of the remote host, titled `remote-host` in the snippets below, to add a new identifier:
+
+.. code-block:: console
+
+    Host cuda-quantum~*
+      RemoteCommand singularity run --writable --fakeroot --nv ~/cuda-quantum.sif
+      RequestTTY yes
+
+    Host remote-host cuda-quantum~remote-host
+      HostName ...
+      ...
+
+You will need to edit a couple of VS Code setting to make use of the newly defined remote command;
+open the Command Palette, enter "Preferences: Open User Settings (JSON)", and add or update the 
+following configurations:
+
+.. code-block:: console
+
+    "remote.SSH.enableRemoteCommand": true,
+    "remote.SSH.useLocalServer": true,
+    "remote.SSH.remoteServerListenOnSocket": false,
+    "remote.SSH.connectTimeout": 120,
+    "remote.SSH.serverInstallPath": {
+        "cuda-quantum~remote-host": "~/.vscode-container/cuda-quantum",
+    },
+
+After saving the changes, you should now be able to select `cuda-quantum~remote-host` as the host
+when connecting via SSH, which will launch the CUDA-Q container and connect VS Code to it.
+
+.. note::
+
+  If the connection to `cuda-quantum~remote-host` fails, you may need to specify the full
+  path to the `singularity` executable on the remote host, since environment variables, 
+  and specifically the configured `PATH` may be different during launch than in your user account.
+
+DGX Cloud
+--------------------------------
+
+If you are using `DGX Cloud <https://www.nvidia.com/en-us/data-center/dgx-cloud/>`__, 
+you can easily use it to run CUDA-Q applications.
+While submitting jobs to DGX Cloud directly from within CUDA-Q is not (yet) supported,
+you can use the NGC CLI to launch and interact with workloads in DGX Cloud.
+The following sections detail how to do that, and how to connect JupyterLab and/or VS Code
+to a running CUDA-Q job in DGX Cloud.
+
+.. _dgx-cloud-setup:
+
+Get Started
++++++++++++++++++++++++++++++++
+
+To get started with DGX Cloud, you can 
+`request access here <https://www.nvidia.com/en-us/data-center/dgx-cloud/trial/>`__.
+Once you have access, `sign in <https://ngc.nvidia.com/signin>`__ to your account,
+and `generate an API key <https://ngc.nvidia.com/setup/api-key>`__. 
+`Install the NGC CLI <https://ngc.nvidia.com/setup/installers/cli>`__
+and configure it with 
+
+.. code-block:: console
+
+    ngc config set
+
+entering the API key you just generated when prompted, and configure other settings as appropriate.
+
+.. note::
+
+  The rest of this section assumes you have CLI version 3.33.0. If you 
+  have an older version installed, you can upgrade to the latest version using the command
+
+  .. code-block:: console
+
+      ngc version upgrade 3.33.0
+  
+  See also the `NGC CLI documentation <https://docs.ngc.nvidia.com/cli/index.html>`__
+  for more information about available commands.
+
+You can see all information about available compute resources and ace instances
+with the command 
+
+.. code-block:: console
+
+    ngc base-command ace list
+
+Confirm that you can submit a job with the command
+
+.. code-block:: console
+
+    ngc base-command job run \
+      --name Job-001 --total-runtime 60s \
+      --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \
+      --ace <ace_name> --instance <instance_name> \
+      --commandline 'echo "Hello from DGX Cloud!"'
+
+replacing `<ace_name>` and `<instance_name>` with the name of the ace and instance you want 
+to execute the job on.
+You should now see that job listed when you run the command
+
+.. code-block:: console
+
+    ngc base-command job list
+
+Once it has completed you can download the job results using the command
+
+.. code-block:: console
+
+    ngc base-command result download <job_id>
+
+replacing `<job_id>` with the id of the job you just submitted.
+You should see a new folder named `<job_id>` with the job log that contains 
+the output "Hello from DGX Cloud!".
+
+For more information about how to use the NGC CLI to interact with DGX Cloud, 
+we refer to the `NGC CLI documentation <https://docs.ngc.nvidia.com/cli/index.html>`__.
+
+Use JupyterLab
++++++++++++++++++++++++++++++++
+
+Once you can :ref:`run jobs on DGX Cloud <dgx-cloud-setup>`, you can launch an interactive job 
+to use CUDA-Q with `JupyterLab <https://jupyterlab.readthedocs.io/en/latest/>`__ 
+running on DGX Cloud:
+
+.. code-block:: console
+
+    ngc base-command job run \
+      --name Job-interactive-001 --total-runtime 600s \
+      --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \
+      --ace <ace_name> --instance <instance_name> \
+      --port 8888 --commandline 'jupyter-lab-setup <my-custom-token> --port=8888'
+
+Replace `<my-custom-token>` in the command above with a custom token that you can freely choose.
+You will use this token to authenticate with JupyterLab;
+Go to the `job portal <https://bc.ngc.nvidia.com/jobs>`__, click on the job you just launched, and click on the link
+under |:spellcheck-disable:|"URL/Hostname"|:spellcheck-enable:| in Service Mapped Ports. 
+
+.. note::
+
+  It may take a couple of minutes for DGX Cloud to launch and for the URL to become active, even after it appears in the Service Mapped Ports section;
+  if you encounter a "404: Not Found" error, be patient and try again in a couple of minutes.
+
+Once this URL opens, you should see the JupyterLab authentication page; enter the 
+token you selected above to get access to the running CUDA-Q container.
+On the left you should see a folder with tutorials. Happy coding!
+
+Use VS Code
++++++++++++++++++++++++++++++++
+
+Once you can :ref:`run jobs on DGX Cloud <dgx-cloud-setup>`, you can launch an interactive job 
+to use CUDA-Q with a local installation of `VS Code <https://code.visualstudio.com/>`_, 
+or the `VS Code Web UI <https://vscode.dev/>`__, running on DGX Cloud:
+
+.. code-block:: console
+
+    ngc base-command job run \
+      --name Job-interactive-001 --total-runtime 600s \
+      --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \
+      --ace <ace_name> --instance <instance_name> \
+      --commandline 'vscode-setup tunnel --name cuda-quantum-dgx --accept-server-license-terms'
+
+Go to the `job portal <https://bc.ngc.nvidia.com/jobs>`__, click on the job you just launched, and select the "Log"
+tab. Once the job is running, you should see instructions there for how to connect to the device the job is running on.
+These instructions include a link to open and the code to enter on that page; follow the instructions to authenticate. 
+Once you have authenticated, you can either 
+`open VS Code in a web browser <https://vscode.dev/tunnel/cuda-quantum-dgx/home/cudaq/>`__, 
+or connect a local installation of VS Code.
+To connect a local installation of VS Code, make sure you have the 
+`Remote - Tunnels <https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server>`__ extension installed,
+then open the Command Palette with `Ctrl+Shift+P`, enter "Remote Tunnels: Connect to Tunnel", 
+and enter `cuda-quantum-remote`. After the window reloaded, enter "File: Open Folder" in the Command Palette 
+to open the `/home/cudaq/` folder.
+
+You should see a pop up asking if you want to install the recommended extensions. Selecting to install them will
+configure VS Code with extensions for working with C++, Python, and Jupyter.
+You can always see the list of recommended extensions that aren't installed yet by clicking on the "Extensions" icon in the sidebar and navigating to the "Recommended" tab.
+
+If you enter "View: Show Explorer" in the Command Palette, you should see a folder with tutorials and examples
+to help you get started. Take a look at `Next Steps`_ to dive into CUDA-Q development.
+
+.. _additional-cuda-tools:
+
+Additional CUDA Tools
+------------------------------------
+
+CUDA-Q makes use of GPU-acceleration in certain backends and components. 
+Depending on how you installed CUDA-Q, you may need to install 
+certain CUDA libraries separately to take advantage of these.
+
+Installation via PyPI
+++++++++++++++++++++++++++++++++++++
+
+If you installed CUDA-Q via `PyPI <https://pypi.org/project/cuda-quantum>`__, please follow the installation instructions there to install the necessary CUDA dependencies.
+
+Installation In Container Images
+++++++++++++++++++++++++++++++++++++
+
+If you are using the CUDA-Q container image, the image already contains all necessary runtime libraries to use all CUDA-Q components. To take advantage of GPU-acceleration, make sure
+to enable GPU support when you launch the container, that is pass the `--gpus all` flag when launching 
+the container with Docker and the `--nv` flag when launching the container with Singularity.
+
+Note that the image does not contain all development dependencies for CUDA, such as, for example the `nvcc` compiler. You can install all CUDA development dependencies by running the command 
+
+.. code-block:: console
+
+    sudo apt-get install cuda-toolkit-11.8
+
+inside the container. Most Python packages that use GPU-acceleration, such as for example `CuPy <https://cupy.dev>`__, require an existing CUDA installation. After installing the `cuda-toolkit-11.8` you can install CuPy with the command
+
+.. code-block:: console
+
+    python3 -m pip install cupy-cuda11x
+
+.. _cuda-dependencies-prebuilt-binaries:
+
+Installing Pre-built Binaries
+++++++++++++++++++++++++++++++++++++
+
+If you installed pre-built binaries for CUDA-Q, you will need to install 
+the necessary CUDA 11 runtime libraries to use GPU-acceleration in CUDA-Q. 
+If you prefer to only install the minimal set of runtime libraries, the following 
+commands, for example, install the necessary packages for RHEL 8:
+
+.. literalinclude:: ../../../../scripts/configure_build.sh
+    :language: bash
+    :dedent:
+    :start-after: [>CUDARTInstall]
+    :end-before: [<CUDARTInstall]
+
+More detailed instructions for your platform can be found in the online documentation
+linked for that `CUDA version <https://developer.nvidia.com/cuda-toolkit-archive>`__. 
+Please make sure to install CUDA version 11.8, and confirm that your 
+`GPU driver <https://www.nvidia.com/download/index.aspx>`__ supports that version.
+While the above packages are sufficient to use GPU-acceleration within CUDA-Q, 
+we recommend installing the complete CUDA toolkit (`cuda-toolkit-11-8`) that also 
+includes the `nvcc` compiler.
+
+.. _distributed-computing-with-mpi:
+
+Distributed Computing with MPI
+------------------------------------
+
+CUDA-Q supports the Message Passing Interface (MPI) parallelism via a plugin interface.
+It is possible to activate or replace such an MPI plugin without re-installing or re-compiling CUDA-Q.
+MPI calls via CUDA-Q API for C++ and Python will be delegated to the currently activated plugin at runtime.
+
+.. tab:: Built-in MPI Support
+
+  The :ref:`CUDA-Q Docker image <install-docker-image>` is shipped with a pre-built MPI plugin based on an 
+  optimized OpenMPI installation included in the image. No action is required to use this plugin. 
+  We recommend using this plugin unless the container host has an existing MPI implementation other than OpenMPI.
+
+  If you are not using the Docker image, or are using the image on a system that has a
+  vendor-optimized MPI library pre-installed, please follow the instructions in the "Custom MPI Support" tab 
+  to enable MPI support.
+
+.. tab:: Custom MPI Support
+
+  If you are not using the Docker image, or are using the image on a system that has a
+  vendor-optimized MPI library pre-installed, CUDA-Q can be configured to use the local MPI installation by
+  manually activating a suitable plugin post-installation.
+  To do so, 
+
+  - Make sure the environment variable `CUDA_QUANTUM_PATH` points to the CUDA-Q installation directory. 
+    If you installed CUDA-Q using the `installer <install-prebuilt-binaries>`, or if you are using the CUDA-Q 
+    container image, this variable should already be defined. If you installed the CUDA-Q 
+    `Python wheels <install-python-wheels>`, set this variable to the directory listed under "Location" when you run the 
+    command `pip show cuda-quantum`.
+
+  - Set the environment variable `MPI_PATH` to the location of your MPI installation. In particular, `${MPI_PATH}/include` 
+    is expected to contain the `mpi.h` header and `${MPI_PATH}/lib64` or `${MPI_PATH}/lib` is expected to contain `libmpi.so`.
+
+  - Execute the following command to complete the activation:
+
+    .. code-block:: console
+
+        bash $CUDA_QUANTUM_PATH/distributed_interfaces/activate_custom_mpi.sh
+
+  .. note::
+
+    HPC data centers often have a vendor-optimized MPI library pre-installed on their system. 
+    If you are using our container images, installing that MPI implementation in the container 
+    and manually activating the plugin following the steps above ensure the best performance,
+    and guarantee compatibility when MPI injection into a container occurs. 
+
+  Manually activating an MPI plugin replaces any existing plugin; After the initial activation, the newly built 
+  `libcudaq_distributed_interface_mpi.so` in the installation directory will subsequently always be used to 
+  handle CUDA-Q MPI calls.
+
+  .. note::
+
+    Executing the activation script from the CUDA-Q installation directory requires *write* permissions to that directory.
+    If you do not have the necessary permissions, copy the `distributed_interfaces` sub-directory to a local location and execute the 
+    activation script from there.
+
+    In this scenario, since the activated plugin (`libcudaq_distributed_interface_mpi.so`) is outside the CUDA-Q installation,
+    you must set the environment variable `$CUDAQ_MPI_COMM_LIB` to the path of that shared library.
+    This is done automatically when executing that activation script, but you may wish to persist that environment variable 
+    between bash sessions, e.g., by adding it to the `.bashrc` file.
+
+.. _updating-cuda-quantum:
+
+Updating CUDA-Q
+--------------------------------
+
+If you installed the CUDA-Q Python wheels, you can update to the latest release
+by running the command 
+
+.. code-block:: console
+
+    python3 -m pip install --upgrade cuda-quantum
+
+If you previously installed the CUDA-Q pre-built binaries, you should first uninstall your 
+current CUDA-Q installation before installing the new version using the installer. 
+To uninstall your current CUDA-Q version, run the command
+
+.. code-block:: console
+
+    sudo bash "${CUDA_QUANTUM_PATH}/uninstall.sh" -y
+
+The `uninstall.sh` script is generated during installation, and will remove all files 
+and folders that were created as part of the installation, whether they were modified 
+in the meantime or not. It does not remove any additional files that existed prior 
+to the installation or that you have added to the installation location since then. 
+You can then download and install the new version of CUDA-Q following the
+instructions :ref:`above <install-prebuilt-binaries>`.
+
+.. _dependencies-and-compatibility:
+
+Dependencies and Compatibility
+--------------------------------
+
+CUDA-Q can be used to compile and run quantum programs on a CPU-only system, but a GPU is highly recommended and necessary to use the GPU-based simulators, see also :doc:`../backends/simulators`.
+
+The supported CPUs include x86_64 (x86-64-v3 architecture and newer) and ARM64 (ARM v8-A architecture and newer).
+
+.. note:: 
+
+  Some of the components included in the CUDA-Q Python wheels depend on an existing CUDA installation on your system. For more information about installing the CUDA-Q Python wheels, take a look at :ref:`this section <install-python-wheels>`.
+
+The following table summarizes the required components.
+
+.. list-table:: Supported Systems
+    :widths: 30 50
+    :header-rows: 0
+
+    * - CPU architectures
+      - x86_64, ARM64
+    * - Operating System
+      - Linux
+    * - Tested Distributions
+      - CentOS 8; Debian 11, 12; Fedora 38; OpenSUSE/SLED/SLES 15.5; RHEL 8, 9; Rocky 8, 9; Ubuntu 22.04
+    * - Python versions
+      - 3.8+
+
+.. list-table:: Requirements for GPU Simulation
+    :widths: 30 50
+    :header-rows: 0
+
+    * - GPU Architectures
+      - Volta, Turing, Ampere, Ada, Hopper
+    * - NVIDIA GPU with Compute Capability
+      - 7.0+
+    * - CUDA
+      - 11.x (Driver 470.57.02+), 12.x (Driver 525.60.13+)
+
+Detailed information about supported drivers for different CUDA versions and be found `here <https://docs.nvidia.com/deploy/cuda-compatibility/>`__.
+
+
+.. _post-installation:
+
+Next Steps
+----------
+
+You can now compile and/or run the C++ and Python examples using the terminal.
+To open a terminal in VS Code, open the Command Palette with `Ctrl+Shift+P` and 
+enter "View: Show Terminal".
+
+.. image:: ../../_static/getToWork.png 
+
+The CUDA-Q image contains a folder with examples and tutorials in the :code:`/home/cudaq` directory. 
+These examples are provided to get you started with CUDA-Q and understanding 
+the programming and execution model. 
+If you are not using a container image, you can find these examples on our 
+`GitHub repository <https://github.com/NVIDIA/cuda-quantum>`__.
+
+Let's start by running a simple program to validate your installation.
+The samples contain an implementation of a 
+`Bernstein-Vazirani algorithm <https://en.wikipedia.org/wiki/Bernstein%E2%80%93Vazirani_algorithm>`__. 
+To run the example, execute the command:
+
+.. tab:: Python
+
+  .. code-block:: console
+
+      python examples/python/bernstein_vazirani.py --size 5
+
+.. tab:: C++
+
+  .. code-block:: console
+
+      nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp && ./a.out
+
+This will execute the program on the :ref:`default simulator <default-simulator>`, which will use GPU-acceleration if 
+a suitable GPU has been detected. To confirm that the GPU acceleration works, you can 
+increase the size of the secret string, and pass the target as a command line argument:
+
+.. tab:: Python
+
+  .. code-block:: console
+
+      python examples/python/bernstein_vazirani.py --size 25 --target nvidia
+
+.. tab:: C++
+
+  .. code-block:: console
+
+      nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp -DSIZE=25 --target nvidia && ./a.out
+
+This program should complete fairly quickly. Depending on the available memory on your GPU,
+you can set the size of the secret string to up to 28-32 when running on the `nvidia` target. 
+
+.. note::
+
+  If you get an error that the CUDA driver version is insufficient or no GPU has been detected,
+  check that you have enabled GPU support when launching the container by passing the `--gpus all` flag
+  (for :ref:`Docker <install-docker-image>`) or the `--nv` flag (for :ref:`Singularity <install-singularity-image>`).
+  If you are not running a container, you can execute the command `nvidia-smi` to confirm your setup;
+  if the command is unknown or fails, you do not have a GPU or do not have a driver installed. If the command
+  succeeds, please confirm that your CUDA and driver version matches the 
+  :ref:`supported versions <dependencies-and-compatibility>`.
+
+Let's compare that to using only your CPU:
+
+.. tab:: Python
+
+  .. code-block:: console
+
+      python examples/python/bernstein_vazirani.py --size 25 --target qpp-cpu
+
+.. tab:: C++
+
+  .. code-block:: console
+
+      nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp -DSIZE=25 --target qpp-cpu && ./a.out
+
+When you execute this command, the program simply seems to hang; that is because it takes
+a long time for the CPU-only backend to simulate 28+ qubits! Cancel the execution with `Ctrl+C`.
+
+You are now all set to start developing quantum applications using CUDA-Q!
+Please proceed to :doc:`Basics <../basics/basics>` for an introduction
+to the fundamental features of CUDA-Q.
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/integration/cmake_app.rst b/pr-2241/sphinx/using/integration/cmake_app.rst
new file mode 100644
index 0000000000..d54a761284
--- /dev/null
+++ b/pr-2241/sphinx/using/integration/cmake_app.rst
@@ -0,0 +1,39 @@
+CUDA-Q and CMake
+**********************
+
+CUDA-Q provides a full compiler toolchain for building 
+out quantum-classical applications. Since most C++ projects 
+provide some sort of integration with CMake, it becomes imperative 
+for our toolchain to integrate well with the CMake build system. 
+
+CUDA-Q provides CMake configuration files that allow downstream 
+application developers to create hybrid quantum-classical source code 
+and build it with the typical CMake workflow, which will natively 
+leverage :code:`nvq++` for compilation of CUDA-Q source files. 
+
+To see how this works, let's create a trivial example. Suppose we have 
+a folder named :code:`myCudaQApp` and within that folder we have 
+a simple CUDA-Q source file, like `ghz.cpp`. With a local 
+CUDA-Q installation present on the system, we can create the 
+following top-level :code:`CMakeLists.txt` file to build this file with 
+:code:`nvq++`:
+
+.. code:: bash 
+
+    cmake_minimum_required(VERSION 3.24 FATAL_ERROR)
+    project(myCudaQApp LANGUAGES CXX)
+    find_package(CUDAQ REQUIRED)
+    add_executable(ghz_exe ghz.cpp)
+
+To configure and build this file, all we need to do is execute the following from the top level of the :code:`myCudaQApp` folder:
+
+.. code:: bash 
+
+    mkdir build && cd build 
+    cmake .. -G Ninja -DCUDAQ_DIR="$CUDA_QUANTUM_PATH/lib/cmake/cudaq"
+    ninja
+    ./ghz_exe 
+
+Notice that by running the :code:`ninja` command with :code:`--verbose`, you'll see that 
+:code:`nvq++` was used to compile and link the executable. 
+
diff --git a/pr-2241/sphinx/using/integration/cuda_gpu.rst b/pr-2241/sphinx/using/integration/cuda_gpu.rst
new file mode 100644
index 0000000000..4ad7c09f89
--- /dev/null
+++ b/pr-2241/sphinx/using/integration/cuda_gpu.rst
@@ -0,0 +1,114 @@
+Using CUDA and CUDA-Q in a Project
+****************************************
+
+It may be the case that a project that uses CUDA-Q kernels may also
+want to use CUDA code to do computation on a GPU.  This is possible by using
+both the CUDA Toolkit and CUDA-Q tools. More about programming GPUs
+in CUDA can be found in the `Quick Start Guide
+<https://docs.nvidia.com/cuda/cuda-quick-start-guide/index.html>`__.
+
+Once the `nvcc` compiler is installed, it is possible to write
+CUDA kernels and have them execute on the system GPU. See NVIDIA's `An
+Easy Introduction to CUDA C and C++
+<https://developer.nvidia.com/blog/easy-introduction-cuda-c-and-c/>`__
+for more information on getting started with CUDA.
+
+CUDA code uses a unique syntax and is, typically, saved in a file with
+the extension `.cu`. For our example, assume we have written our
+CUDA code in the file `my_proj.cu`.
+
+CUDA-Q code is a library-based extension of C++ and uses
+standard conforming C++ syntax. Typically, a quantum kernel would be
+saved in a file with the `.cpp` extension. Again for our
+example, let's assume that we've written quantum kernels and saved
+them in the file `my_proj_quantum.cpp`.
+
+By default, CUDA-Q uses C++ 20 and builds source code against the 
+LLVM C++ standard library (`libc++`). To create a CUDA library that 
+can link against CUDA-Q code, make sure to define an API that does 
+not rely on C++ data structures that rely on a specific C++ toolchain
+for all functions intended to be called from CUDA-Q (see also 
+:ref:`clike-shim`). For example, if you define a CUDA kernel in `my_proj.cu`
+
+.. code-block:: cpp
+
+    template <typename CudaDataType>
+    __global__ void cudaSetFirstNElements(CudaDataType *sv, const CudaDataType *__restrict__ sv2, int64_t N) {
+    int64_t i = static_cast<int64_t>(blockIdx.x) * blockDim.x + threadIdx.x;
+        if (i < N) {
+            sv[i].x = sv2[i].x;
+            sv[i].y = sv2[i].y;
+        } else {
+            sv[i].x = 0.0;
+            sv[i].y = 0.0;
+        }
+    }
+
+define the following template and all desired template specializations
+
+.. code-block:: cpp
+
+    template <typename CudaDataType>
+    void setFirstNElements(uint32_t n_blocks, 
+                           int32_t threads_per_block, 
+                           void *newDeviceStateVector, 
+                           void *deviceStateVector,
+                           std::size_t previousStateDimension) {
+        cudaSetFirstNElements<<<n_blocks, threads_per_block>>>(
+            reinterpret_cast<CudaDataType *>(newDeviceStateVector),
+            reinterpret_cast<CudaDataType *>(deviceStateVector),
+            previousStateDimension);
+    }
+
+    template void
+    setFirstNElements<cuFloatComplex>(uint32_t n_blocks, 
+                                      int32_t threads_per_block, 
+                                      void *newDeviceStateVector, 
+                                      void *deviceStateVector,
+                                      std::size_t previousStateDimension);
+
+    template void
+    setFirstNElements<cuDoubleComplex>(uint32_t n_blocks, 
+                                       int32_t threads_per_block, 
+                                       void *newDeviceStateVector, 
+                                       void *deviceStateVector,
+                                       std::size_t previousStateDimension);
+
+Create the corresponding header file `my_proj.h` declaring the `setFirstNElements`
+template. You can then call `setFirstNElements` from within `my_proj_quantum.cpp`
+by including `my_proj.h`, for example
+
+.. code-block:: cpp
+
+    #include "cuComplex.h"
+    #include "cuda_runtime.h"
+    #include "device_launch_parameters.h"
+    #include "my_proj.h"
+
+    using namespace my_kernels; // the namespace where you defined setFirstNElements
+
+    int main () {
+        const uint32_t n_blocks = 10;
+        const uint32_t threads_per_block = 5;
+
+        void *deviceStateVector;
+        cudaMalloc((void **)&deviceStateVector, 2 * sizeof(cuDoubleComplex));
+        // ...
+        void *newDeviceStateVector;
+        cudaMalloc((void **)&newDeviceStateVector, 2 * sizeof(cuDoubleComplex));
+        setFirstNElements<cuDoubleComplex>(n_blocks, threads_per_block,
+                                           newDeviceStateVector, deviceStateVector,
+                                           2);
+        return 0;
+    }
+
+To get an executable, compile the code with
+
+.. code-block:: bash
+
+    nvcc -c -std=c++17 -Xcompiler -fPIC my_proj.cu -o my_proj.o
+    nvq++ my_proj_quantum.cpp my_proj.o -I"${CUDA_HOME}/include/" -L"${CUDA_HOME}/lib64" -lcudart -o my_executable
+
+Above, :code:`nvq++` is used for the link step and will make sure the CUDA-Q
+runtime libraries are linked correctly to the executable program.
+The CUDA runtime is explicitly added to this command.
diff --git a/pr-2241/sphinx/using/integration/integration.rst b/pr-2241/sphinx/using/integration/integration.rst
new file mode 100644
index 0000000000..ce6d6ab094
--- /dev/null
+++ b/pr-2241/sphinx/using/integration/integration.rst
@@ -0,0 +1,11 @@
+Integration with other Software Tools
+**************************************
+
+.. toctree::
+  :maxdepth: 1
+
+  Downstream CMake Integration <cmake_app.rst>
+  Combining CUDA with CUDA-Q <cuda_gpu.rst>
+  Integrating with Third-Party Libraries <libraries.rst>
+
+Information about customizing or extending the CUDA-Q toolchain can be found in :doc:`../extending/extending`.
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/integration/libraries.rst b/pr-2241/sphinx/using/integration/libraries.rst
new file mode 100644
index 0000000000..0e7c7c6fcd
--- /dev/null
+++ b/pr-2241/sphinx/using/integration/libraries.rst
@@ -0,0 +1,226 @@
+Integrating with Third-Party Libraries
+****************************************
+
+CUDA-Q enables easily integrating quantum kernels with existing state-of-the-art tools
+for classical computing and high performance computing. While quantum kernels are expressed 
+in Python or C++, quantum hardware backends only support a very limited set of classical 
+instructions. Correspondingly, only a select set of libraries and functions that are 
+directly supported by the CUDA-Q compiler can be called from within quantum kernels.
+Code that is not marked as kernel code, on the other hand, can be used to invoke the 
+defined quantum kernels as well as any classical tools and libraries. CUDA-Q provides 
+a complete toolset to build complex applications running on multi-processor systems involving
+CPUs, GPUs and QPUs. 
+
+In Python, integration with any third-party Python package is handled
+automatically without any need for additional configuration. For C++, the rest of this
+document outlines how to integration with libraries that are compile with a different 
+compiler than `nvq++`.
+
+
+Calling a CUDA-Q library from C++
+--------------------------------------
+
+The CUDA-Q compiler is a fully-featured C++ compiler able to process arbitrary C++ code outside
+of quantum kernels. In fact, the CUDA-Q installation includes and invokes a custom-built Clang 
+compiler under the hood. In general, it hence is not necessary to use a different compiler to 
+compile C++ host code that calls into quantum kernels; the host code is compiled along with 
+the quantum kernels into a single library or executable by the CUDA-Q toolchain.
+
+If you would still like to create a library that can be included in libraries and executables 
+built with a different toolchain, you can configure `nvq++` to include and encapsulate all its
+C++ dependencies, such that the CUDA-Q library only depends on C libraries. For example, 
+if you have a file `quantum_kernel.cpp` containing 
+
+.. code:: C++
+
+    #include "cudaq.h"
+    #include <iostream>
+    #include <sstream>
+
+    namespace quantum {
+
+    __qpu__ void bell() {
+      cudaq::qvector qs(2);
+      h(qs[0]);
+      cnot(qs[0], qs[1]);
+      mz(qs);
+    }
+
+    // Usually, one would probably return something like
+    // the most probably value in the distribution rather
+    // than the string dump. However, the bell kernel here
+    // has a 50/50 chance of returning 00 or 11.
+    const char* bell_distribution() {
+      auto dist = cudaq::sample(bell);
+
+      std::stringbuf buffer;
+      std::ostream os(&buffer);
+      dist.dump(os);
+      auto sample_results = buffer.str();
+
+      char* ptr = new char[sample_results.size() + 1];
+      strcpy(ptr, sample_results.c_str());
+      return ptr;
+    }
+
+    } // namespace quantum
+
+you can create such a library with the command
+
+.. code:: bash
+
+    nvq++ quantum_kernel.cpp -shared -static-libstdc++ -fPIC -o libquantum_kernel.so
+
+To use this library in a project built with an external toolchain, define a suitable 
+header file `quantum_kernel.h` containing
+
+.. code:: C++
+
+    namespace quantum {
+      const char* bell_distribution();
+    }
+
+and include it in your project. For example, if `external.cpp` contains
+
+.. code:: C++ 
+
+    #include <iostream>
+    #include "quantum_kernel.h"
+
+    int main () {
+      // some code
+      auto bell_dist = quantum::bell_distribution();
+      std::cout << bell_dist << std::endl;
+      delete[] bell_dist;
+      // more code
+      return 0;
+    }
+
+you can compile it with `g++` and link it with the built `libquantum_kernel.so` library
+using the command
+
+.. code:: bash
+
+    g++ external.cpp -lquantum_kernel -L"$(pwd)" -Wl,-rpath="$(pwd)" -I"$(pwd)"
+
+Note that the API defined in `quantum_kernel.h` does not depend on any data types that 
+rely on the specific implementation of the C++ standard library. For example, we return a 
+`const char*` instead of a `std::string` value. This is important to ensure that the data 
+is handled correctly regardless of which C++ standard library is used. If you include
+data types that depend on a specific C++ ABI, the linker should detect this incompatibility
+and should generate an error. See the section :ref:`clike-shim` below to learn more about 
+what to watch out for when defining an API to interface between libraries that are built 
+with different compilers. 
+
+
+Calling an C++ library from CUDA-Q
+--------------------------------------
+
+CUDA-Q comes with a complete C++ toolchain, and is configured to use its own C++ standard
+library by default. When calling a third-party library from within a CUDA-Q application,
+the quantum kernels and the surrounding application code are compiled with the `nvq++` compiler, 
+whereas the third-party library may be compiled with a different toolchain. 
+For most widely distributed libraries, this will work out of the box. The exception are 
+third-party libraries that are pre-compiled (opposed to being header-only libraries) 
+and dynamically depend on a different C++ standard library than CUDA-Q uses. 
+This is the case for a library `third_party_library.so` if `libstdc++.so` is listed 
+in the output of the command
+
+.. code:: bash
+
+    ldd third_party_library.so
+
+To use such a library with CUDA-Q, you have to install the static version of the 
+library. The `nvq++` compiler can be configured to link a static library 
+`libexternal_library.a` instead of the shared one with the same flags as GCC/Clang:
+
+.. code:: bash
+
+    nvq++ my_code.cpp -Wl,-Bstatic -lexternal_library -Wl,-Bdynamic ...
+
+If the compilation fails due to undefined symbols during linking, then `libexternal_library.a`
+does not include the C++ standard library components it depends on. In this case, you can create a 
+suitable static library that contains the external library as well as its `libstdc++` dependencies
+by combining `libexternal_library.a` and `libstdc++.a` into a single flattened archive.
+For example, if the external library is built with GCC and located in `/usr/lib`,
+the following commands create a suitable archive using the GNU archiver:
+
+.. code:: bash
+
+    ar cruT libexternal_library_complete.a /usr/lib/libexternal_library.a "$(g++ -print-file-name=libstdc++.a)"
+    echo -e 'create libexternal_library_complete.a\naddlib libexternal_library_complete.a\nsave\nend' | ar -M
+
+The above commands create a new static library `libexternal_library_complete.a` in the current directory. 
+To use it, adjust the `nvq++` command accordingly:
+
+.. code:: bash
+
+    nvq++ my_code.cpp -L. -Wl,-Bstatic -lexternal_library_complete -Wl,-Bdynamic ...
+
+.. note::
+
+  If the third-party library functions you are calling from your CUDA-Q code 
+  consume or produce data types that explicitly depend on the C++ standard library implementation,
+  a small shim is needed to properly encapsulate these dependencies, as described in
+  :ref:`clike-shim`.
+
+
+.. _clike-shim:
+
+Interfacing between binaries compiled with a different toolchains
+---------------------------------------------------------------------
+
+To avoid incompatibilities between different C++ implementations, 
+two binaries built using a different C++ compiler should be careful when passing data types between them
+that rely on a specific C++ implementation. While primitive data types can be passed without
+issues, attempting to pass a string, for example, will result in a linking failure; a `char*` must 
+be passed instead of a string.
+
+Most other data types, including templated types, can be passed as long as their alignment matches.
+While different compilers generally align data differently, it is possible to force a particular 
+alignment when defining the data type or value. For example, if we define a struct
+
+.. code:: C++
+
+    #pragma pack(push, 4)
+    template <typename ScalarType>
+    struct Entry {
+      bool is_integral;
+      ScalarType value;
+    };
+    #pragma pack(pop)
+
+the `pragma` directives ensure that each item will be 4-byte aligned, regardless of the 
+default setting that can differ between compilers.
+
+Even function pointers can usually be passed, as long as their argument and return types can be passed.
+When using templated functions and data types, the header file should only include their declaration as well 
+as explicit instantiation for all valid template arguments. For example,
+
+.. code:: C++
+
+    template <typename CudaDataType>
+    void initializeDeviceStateVector(uint32_t n_blocks, 
+                                    int32_t threads_per_block, 
+                                    void *deviceStateVector,
+                                    std::size_t stateDimension) {
+      cudaInitializeDeviceStateVector<<<n_blocks, threads_per_block>>>(
+        reinterpret_cast<CudaDataType *>(deviceStateVector), stateDimension);
+    }
+
+    template void
+    initializeDeviceStateVector<cuFloatComplex>(uint32_t n_blocks, 
+                                    int32_t threads_per_block, 
+                                    void *deviceStateVector,
+                                    std::size_t stateDimension);
+
+    template void
+    initializeDeviceStateVector<cuDoubleComplex>(uint32_t n_blocks, 
+                                    int32_t threads_per_block, 
+                                    void *deviceStateVector,
+                                    std::size_t stateDimension);
+
+The most cumbersome aspect when libraries built with different toolchains are combined into a single executable
+is exception handling. Since the handling relies on a specific ABI, an thrown exception is not necessarily 
+recognized as such in a library that uses a different ABI implementation. While matching the exception type 
+may not work as expected, a catch-all will reliably catch any thrown exception. 
diff --git a/pr-2241/sphinx/using/python.html b/pr-2241/sphinx/using/python.html
new file mode 100644
index 0000000000..e469576d37
--- /dev/null
+++ b/pr-2241/sphinx/using/python.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=examples/examples.html"></head></html>
\ No newline at end of file
diff --git a/pr-2241/sphinx/using/quick_start.rst b/pr-2241/sphinx/using/quick_start.rst
new file mode 100644
index 0000000000..0e88f40ea4
--- /dev/null
+++ b/pr-2241/sphinx/using/quick_start.rst
@@ -0,0 +1,130 @@
+Quick Start
+===================
+
+**NVIDIA CUDA-Q**
+
+CUDA-Q streamlines hybrid application development and promotes productivity and scalability
+in quantum computing. It offers a unified programming model designed for a hybrid
+setting |---| that is, CPUs, GPUs, and QPUs working together. CUDA-Q contains support for 
+programming in Python and in C++. Learn more about the `key benefits of CUDA-Q <https://developer.nvidia.com/cuda-q>`_.
+
+This Quick Start page guides you through installing CUDA-Q and running your first program.
+If you have already installed and configured CUDA-Q, or if you are using our 
+`Docker image <https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum>`_, you can move directly to our
+:doc:`Basics Section <basics/basics>`. More information about working with containers and Docker alternatives can be 
+found in our complete :doc:`Installation Guide <install/install>`.
+
+Install CUDA-Q
+----------------------------
+
+.. tab:: Python
+
+   To develop CUDA-Q applications using Python, 
+   please follow the instructions for `installing CUDA-Q <https://pypi.org/project/cuda-quantum/>`_ from PyPI. 
+   If you have an NVIDIA GPU, make sure to also follow the instructions for enabling GPU-acceleration.
+
+   .. include:: ../../../python/README.md
+      :parser: myst_parser.sphinx_
+      :start-after: (Begin complete install)
+      :end-before: (End complete install)
+
+   Once you completed the installation, please follow the instructions
+   :ref:`below <validate-installation>` to run your first CUDA-Q program!
+
+.. tab:: C++
+
+   To develop CUDA-Q applications using C++, please make sure you have a C++ toolchain installed
+   that supports C++20, for example `g++` version 11 or newer.
+   Download the `install_cuda_quantum` file for your processor architecture from
+   the assets of the respective `GitHub release <https://github.com/NVIDIA/cuda-quantum/releases>`__; that is the file with the `aarch64` extension for ARM processors, and the one with `x86_64` for, e.g., Intel and AMD processors.
+
+   To install CUDA-Q, execute the commands
+
+   .. code-block:: bash
+
+      sudo -E bash install_cuda_quantum.$(uname -m) --accept 
+      . /etc/profile
+
+   If you have an NVIDIA GPU, please also install the `CUDA Toolkit <https://developer.nvidia.com/cuda-downloads>`__ to enable GPU-acceleration within CUDA-Q.
+
+   Please see the complete :ref:`installation guide <install-prebuilt-binaries>` for more details, including
+
+   - a list of :ref:`supported operating systems <dependencies-and-compatibility>`, 
+   - instructions on how to :ref:`enable MPI parallelization <distributed-computing-with-mpi>` within CUDA-Q, and
+   - information about :ref:`updating CUDA-Q <updating-cuda-quantum>`.
+
+   Once you completed the installation, please follow the instructions
+   :ref:`below <validate-installation>` to run your first CUDA-Q program!   
+
+.. |---|   unicode:: U+2014 .. EM DASH
+   :trim:
+
+.. _validate-installation:
+
+Validate your Installation
+----------------------------
+
+Let's run a simple program to validate your installation.
+The quantum kernel in the following program creates and measures the state 
+:math:`(|00\rangle + |11\rangle) / \sqrt{2}`. That means each kernel execution should 
+either yield `00` or `11`. The program samples, meaning it executes, the kernel 1000 times
+and prints how many times each output was measured. On average, the values `00` and `11`
+should be observed around 500 times each.
+
+.. tab:: Python
+
+   Create a file titled `program.py`, containing the following code:
+
+   .. literalinclude:: /snippets/python/quick_start.py
+      :language: python
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+   Run this program as you do any other Python program, for example:
+
+   .. code-block:: console
+
+      python3 program.py
+
+.. tab:: C++
+
+   Create a file titled `program.cpp`, containing the following code:
+
+   .. literalinclude:: /snippets/cpp/quick_start.cpp
+      :language: cpp
+      :start-after: [Begin Documentation]
+      :end-before: [End Documentation]
+
+   Compile the program using the `nvq++` compiler and run the built application with the following command:
+
+   .. code-block:: console
+
+      nvq++ program.cpp -o program.x && ./program.x
+
+If you have an NVIDIA GPU the program uses GPU acceleration by default.
+To confirm that this works as expected and to see the effects of GPU acceleration, you can 
+increase the numbers of qubits the program uses to 28 and
+compare the time to execute the program on the 
+`nvidia` target (:ref:`GPU-accelerated statevector simulator <cuQuantum single-GPU>`) to the time when setting the target to `qpp-cpu` (:ref:`OpenMP parallelized CPU-only statevector simulator <OpenMP CPU-only>`):
+
+.. tab:: Python
+
+   .. code-block:: console
+
+      python3 program.py 28 --target nvidia
+
+.. tab:: C++
+
+   .. code-block:: console
+
+      nvq++ program.cpp -o program.x --target nvidia && ./program.x 28
+
+When you change the target to `qpp-cpu`, the program simply seems to hang; that is because it takes a long time for the CPU-only backend to simulate 28+ qubits! Cancel the execution with `Ctrl+C`.
+
+For more information about enabling GPU-acceleration, please see
+our complete :ref:`Installation Guide <additional-cuda-tools>`.
+For further information on available targets, see :doc:`Backends <backends/backends>`.
+
+You are now all set to start developing quantum applications using CUDA-Q!
+Please proceed to :doc:`Basics <basics/basics>` for an introduction
+to the fundamental features of CUDA-Q.
diff --git a/pr-2241/sphinx/using/tutorials.rst b/pr-2241/sphinx/using/tutorials.rst
new file mode 100644
index 0000000000..ad45c8b48f
--- /dev/null
+++ b/pr-2241/sphinx/using/tutorials.rst
@@ -0,0 +1,24 @@
+*************************
+CUDA-Q Tutorials
+*************************
+
+Tutorials that give an in depth view of CUDA-Q and its applications in Python.
+
+.. nbgallery::
+
+    /examples/python/tutorials/afqmc.ipynb
+    /examples/python/tutorials/deutschs_algorithm.ipynb
+    /examples/python/tutorials/quantum_fourier_transform.ipynb
+    /examples/python/tutorials/cost_minimization.ipynb
+    /examples/python/tutorials/vqe.ipynb
+    /examples/python/tutorials/qaoa.ipynb
+    /examples/python/tutorials/hadamard_test.ipynb
+    /examples/python/tutorials/hybrid_qnns.ipynb
+    /examples/python/tutorials/maximum_vertex_weight_clique.ipynb
+    /examples/python/tutorials/noisy_simulations.ipynb
+    /examples/python/tutorials/readout_error_mitigation.ipynb
+    /examples/python/tutorials/vqe_water_active_space.ipynb
+    /examples/python/tutorials/Divisive_clustering.ipynb
+    /examples/python/tutorials/H2-MRQKS.ipynb
+    /examples/python/tutorials/Shors.ipynb
+    /examples/python/tutorials/unitary_compilation.ipynb
diff --git a/pr-2241/sphinx/versions.rst b/pr-2241/sphinx/versions.rst
new file mode 100644
index 0000000000..9394f5a52e
--- /dev/null
+++ b/pr-2241/sphinx/versions.rst
@@ -0,0 +1,6 @@
+************************
+CUDA-Q Versions
+************************
+
+.. include:: releases.rst
+    :start-line: 4
diff --git a/pr-2241/using/backends/backends.html b/pr-2241/using/backends/backends.html
new file mode 100644
index 0000000000..5e8ca7168b
--- /dev/null
+++ b/pr-2241/using/backends/backends.html
@@ -0,0 +1,688 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Backends &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="CUDA-Q Simulation Backends" href="simulators.html" />
+    <link rel="prev" title="Compiling Unitaries Using Diffusion Models" href="../../examples/python/tutorials/unitary_compilation.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">CUDA-Q Backends</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/backends/backends.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../../examples/python/tutorials/unitary_compilation.html" class="btn btn-neutral float-left" title="Compiling Unitaries Using Diffusion Models" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="simulators.html" class="btn btn-neutral float-right" title="CUDA-Q Simulation Backends" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-backends">
+<h1>CUDA-Q Backends<a class="headerlink" href="#cuda-q-backends" title="Permalink to this heading">¶</a></h1>
+<div class="toctree-wrapper compound">
+<p class="caption" role="heading"><span class="caption-text">Backend Targets</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="simulators.html">   Simulation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hardware.html">   Quantum Hardware</a></li>
+<li class="toctree-l1"><a class="reference internal" href="nvqc.html">   NVIDIA Quantum Cloud</a></li>
+<li class="toctree-l1"><a class="reference internal" href="platform.html">   Multi-Processor Platforms</a></li>
+</ul>
+</div>
+<p><strong>The following is a comprehensive list of the available targets in CUDA-Q:</strong></p>
+<ul class="simple">
+<li><p><a class="reference internal" href="simulators.html#id3"><span class="std std-ref">density-matrix-cpu</span></a></p></li>
+<li><p><a class="reference internal" href="hardware.html#ionq-backend"><span class="std std-ref">ionq</span></a></p></li>
+<li><p><a class="reference internal" href="hardware.html#iqm-backend"><span class="std std-ref">iqm</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#nvidia-backend"><span class="std std-ref">nvidia</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#nvidia-fp64-backend"><span class="std std-ref">nvidia-fp64</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#nvidia-mgpu-backend"><span class="std std-ref">nvidia-mgpu</span></a></p></li>
+<li><p><a class="reference internal" href="platform.html#mqpu-platform"><span class="std std-ref">nvidia-mqpu</span></a></p></li>
+<li><p><a class="reference internal" href="platform.html#mqpu-platform"><span class="std std-ref">nvidia-mqpu-fp64</span></a></p></li>
+<li><p><a class="reference internal" href="nvqc.html"><span class="doc">nvqc</span></a></p></li>
+<li><p><a class="reference internal" href="hardware.html#oqc-backend"><span class="std std-ref">oqc</span></a></p></li>
+<li><p><a class="reference internal" href="hardware.html#orca-backend"><span class="std std-ref">orca</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#qpp-cpu-backend"><span class="std std-ref">qpp-cpu</span></a></p></li>
+<li><p><a class="reference internal" href="hardware.html#quantinuum-backend"><span class="std std-ref">quantinuum</span></a></p></li>
+<li><p><a class="reference internal" href="platform.html#mqpu-platform"><span class="std std-ref">remote-mqpu</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#stim-backend"><span class="std std-ref">stim</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#tensor-backends"><span class="std std-ref">tensornet</span></a></p></li>
+<li><p><a class="reference internal" href="simulators.html#tensor-backends"><span class="std std-ref">tensornet-mps</span></a></p></li>
+</ul>
+<div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 0.8: </span>The <code class="code docutils literal notranslate"><span class="pre">nvidia-fp64</span></code>, <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code>, <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code>, and <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu-fp64</span></code> targets can be
+enabled as extensions of the unified <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target (see <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> <a class="reference internal" href="simulators.html#nvidia-backend"><span class="std std-ref">target documentation</span></a>).
+These target names might be removed in a future release.</p>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../../examples/python/tutorials/unitary_compilation.html" class="btn btn-neutral float-left" title="Compiling Unitaries Using Diffusion Models" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="simulators.html" class="btn btn-neutral float-right" title="CUDA-Q Simulation Backends" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/backends/hardware.html b/pr-2241/using/backends/hardware.html
new file mode 100644
index 0000000000..d733d156c0
--- /dev/null
+++ b/pr-2241/using/backends/hardware.html
@@ -0,0 +1,1015 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Hardware Backends &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="NVIDIA Quantum Cloud" href="nvqc.html" />
+    <link rel="prev" title="CUDA-Q Simulation Backends" href="simulators.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="backends.html">   Backends</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="backends.html">CUDA-Q Backends</a></li>
+      <li class="breadcrumb-item active">CUDA-Q Hardware Backends</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/backends/hardware.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="simulators.html" class="btn btn-neutral float-left" title="CUDA-Q Simulation Backends" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="nvqc.html" class="btn btn-neutral float-right" title="NVIDIA Quantum Cloud" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-hardware-backends">
+<h1>CUDA-Q Hardware Backends<a class="headerlink" href="#cuda-q-hardware-backends" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q supports submission to a set of hardware providers.
+To submit to a hardware backend, you need an account with the respective provider.</p>
+<section id="ionq">
+<h2>IonQ<a class="headerlink" href="#ionq" title="Permalink to this heading">¶</a></h2>
+<section id="setting-credentials">
+<span id="ionq-backend"></span><h3>Setting Credentials<a class="headerlink" href="#setting-credentials" title="Permalink to this heading">¶</a></h3>
+<p>Programmers of CUDA-Q may access the <a class="reference external" href="https://cloud.ionq.com/">IonQ Quantum Cloud</a> from either C++ or Python. Generate
+an API key from your <a class="reference external" href="https://cloud.ionq.com/">IonQ account</a> and export
+it as an environment variable:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">IONQ_API_KEY</span><span class="o">=</span><span class="s2">&quot;ionq_generated_api_key&quot;</span>
+</pre></div>
+</div>
+</section>
+<section id="submission-from-c">
+<h3>Submission from C++<a class="headerlink" href="#submission-from-c" title="Permalink to this heading">¶</a></h3>
+<p>To target quantum kernel code for execution in the IonQ Cloud,
+pass the flag <code class="docutils literal notranslate"><span class="pre">--target</span> <span class="pre">ionq</span></code> to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>ionq<span class="w"> </span>src.cpp
+</pre></div>
+</div>
+<p>This will take the API key and handle all authentication with, and submission to,
+the IonQ QPU(s). By default, quantum kernel code will be submitted to the IonQ
+simulator.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>A “target” in <code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> refers to a quantum compute provider, such as <code class="code docutils literal notranslate"><span class="pre">ionq</span></code>.
+However, IonQ’s documentation uses the term “target” to refer to specific QPU’s themselves.</p>
+</div>
+<p>To execute your kernels on a QPU, pass the <code class="docutils literal notranslate"><span class="pre">--ionq-machine</span></code> flag to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler
+to specify which machine to submit quantum kernels to:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>ionq<span class="w"> </span>--ionq-machine<span class="w"> </span>qpu.aria-1<span class="w"> </span>src.cpp<span class="w"> </span>...
+</pre></div>
+</div>
+<p>where <code class="docutils literal notranslate"><span class="pre">qpu.aria-1</span></code> is an example of a physical QPU.</p>
+<p>A list of available QPUs can be found <a class="reference external" href="https://docs.ionq.com/#tag/jobs">in the API documentation</a>. To see which backends are available
+with your subscription login to your <a class="reference external" href="https://cloud.ionq.com/jobs">IonQ account</a>.</p>
+<p>To emulate the IonQ machine locally, without submitting through the cloud,
+you can also pass the <code class="docutils literal notranslate"><span class="pre">--emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">nvq++</span></code>. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--emulate<span class="w"> </span>--target<span class="w"> </span>ionq<span class="w"> </span>src.cpp
+</pre></div>
+</div>
+<p>To see a complete example for using IonQ’s backends, take a look at our <a class="reference internal" href="../examples/examples.html"><span class="doc">C++ examples</span></a>.</p>
+</section>
+<section id="submission-from-python">
+<h3>Submission from Python<a class="headerlink" href="#submission-from-python" title="Permalink to this heading">¶</a></h3>
+<p>The target to which quantum kernels are submitted
+can be controlled with the <code class="docutils literal notranslate"><span class="pre">cudaq::set_target()</span></code> function.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;ionq&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>By default, quantum kernel code will be submitted to the IonQ
+simulator.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>A “target” in <code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> refers to a quantum compute provider, such as <code class="code docutils literal notranslate"><span class="pre">ionq</span></code>.
+However, IonQ’s documentation uses the term “target” to refer to specific QPU’s themselves.</p>
+</div>
+<p>To specify which IonQ QPU to use, set the <code class="code docutils literal notranslate"><span class="pre">qpu</span></code> parameter.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;ionq&quot;</span><span class="p">,</span> <span class="n">qpu</span><span class="o">=</span><span class="s2">&quot;qpu.aria-1&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>where <code class="docutils literal notranslate"><span class="pre">qpu.aria-1</span></code> is an example of a physical QPU.</p>
+<p>A list of available QPUs can be found <a class="reference external" href="https://docs.ionq.com/#tag/jobs">in the API documentation</a>. To see which backends are available
+with your subscription login to your <a class="reference external" href="https://cloud.ionq.com/jobs">IonQ account</a>.</p>
+<p>To emulate the IonQ machine locally, without submitting through the cloud,
+you can also set the <code class="docutils literal notranslate"><span class="pre">emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">True</span></code>. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;ionq&#39;</span><span class="p">,</span> <span class="n">emulate</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>The number of shots for a kernel execution can be set through
+the <code class="docutils literal notranslate"><span class="pre">shots_count</span></code> argument to <code class="docutils literal notranslate"><span class="pre">cudaq.sample</span></code> or <code class="docutils literal notranslate"><span class="pre">cudaq.observe</span></code>. By default,
+the <code class="docutils literal notranslate"><span class="pre">shots_count</span></code> is set to 1000.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">10000</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>To see a complete example for using IonQ’s backends, take a look at our <a class="reference internal" href="../examples/examples.html"><span class="doc">Python examples</span></a>.</p>
+</section>
+</section>
+<section id="iqm">
+<h2>IQM<a class="headerlink" href="#iqm" title="Permalink to this heading">¶</a></h2>
+<p id="iqm-backend">Support for submissions to IQM is currently under development.
+In particular, two-qubit gates can only be performed on adjacent qubits. For more information, we refer to the respective hardware documentation.
+Support for automatically injecting the necessary operations during compilation to execute arbitrary multi-qubit gates will be added in future versions.</p>
+<section id="id1">
+<h3>Setting Credentials<a class="headerlink" href="#id1" title="Permalink to this heading">¶</a></h3>
+<p>Programmers of CUDA-Q may access the IQM Server from either C++ or Python. Following the <a class="reference external" href="https://iqm-finland.github.io/cortex-cli/readme.html#using-cortex-cli">quick start guide</a>, install <code class="code docutils literal notranslate"><span class="pre">iqm-cortex-cli</span></code> and login to initialize the tokens file.
+The path to the tokens file can either be passed explicitly via an environment variable or it will be loaded automatically if located in
+the default location <code class="code docutils literal notranslate"><span class="pre">~/.cache/iqm-cortex-cli/tokens.json</span></code>.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">IQM_TOKENS_FILE</span><span class="o">=</span><span class="s2">&quot;path/to/tokens.json&quot;</span>
+</pre></div>
+</div>
+</section>
+<section id="id2">
+<h3>Submission from C++<a class="headerlink" href="#id2" title="Permalink to this heading">¶</a></h3>
+<p>To target quantum kernel code for execution on an IQM Server,
+pass the <code class="docutils literal notranslate"><span class="pre">--target</span> <span class="pre">iqm</span></code> flag to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler, along with a specified <code class="docutils literal notranslate"><span class="pre">--iqm-machine</span></code>.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The <code class="docutils literal notranslate"><span class="pre">--iqm-machine</span></code> is  a mandatory argument. This provided architecture must match
+the device architecture that the program has been compiled against. The hardware architecture for a
+specific IQM Server may be checked  via <code class="code docutils literal notranslate"><span class="pre">https://&lt;IQM</span> <span class="pre">server&gt;/cocos/quantum-architecture</span></code>.</p>
+</div>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>iqm<span class="w"> </span>--iqm-machine<span class="w"> </span>Adonis<span class="w"> </span>src.cpp
+</pre></div>
+</div>
+<p>Once the binary for a specific IQM QPU architecture is compiled, it can be executed against any IQM Server with the same QPU architecture:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>iqm<span class="w"> </span>--iqm-machine<span class="w"> </span>Adonis<span class="w"> </span>src.cpp<span class="w"> </span>-o<span class="w"> </span>program
+<span class="nv">IQM_SERVER_URL</span><span class="o">=</span><span class="s2">&quot;https://demo.qc.iqm.fi/cocos&quot;</span><span class="w"> </span>./program
+
+<span class="c1"># Executing the same program against an IQM Server with a different underlying QPU</span>
+<span class="c1"># architecture will result in an error.</span>
+<span class="nv">IQM_SERVER_URL</span><span class="o">=</span><span class="s2">&quot;https://&lt;Apollo IQM Server&gt;/cocos&quot;</span><span class="w"> </span>./program
+</pre></div>
+</div>
+<p>To emulate the IQM machine locally, without submitting to the IQM Server,
+you can also pass the <code class="docutils literal notranslate"><span class="pre">--emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">nvq++</span></code>. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--emulate<span class="w"> </span>--target<span class="w"> </span>iqm<span class="w"> </span>--iqm-machine<span class="w"> </span>Adonis<span class="w"> </span>src.cpp
+</pre></div>
+</div>
+<p>To see a complete example for using IQM server backends, take a look at our <a class="reference internal" href="../examples/examples.html"><span class="doc">C++ examples</span></a>.</p>
+</section>
+<section id="id3">
+<h3>Submission from Python<a class="headerlink" href="#id3" title="Permalink to this heading">¶</a></h3>
+<p>The target to which quantum kernels are submitted
+can be controlled with the <code class="docutils literal notranslate"><span class="pre">cudaq::set_target()</span></code> function.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;iqm&quot;</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="s2">&quot;https://&lt;IQM Server&gt;/cocos&quot;</span><span class="p">,</span> <span class="o">**</span><span class="p">{</span><span class="s2">&quot;qpu-architecture&quot;</span><span class="p">:</span> <span class="s2">&quot;Adonis&quot;</span><span class="p">})</span>
+</pre></div>
+</div>
+<p>To emulate the IQM Server locally, without submitting to the IQM Server,
+you can also set the <code class="docutils literal notranslate"><span class="pre">emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">True</span></code>. This will emit any target
+specific compiler diagnostics, before running a noise free emulation.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;iqm&#39;</span><span class="p">,</span> <span class="n">emulate</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>The number of shots for a kernel execution can be set through
+the <code class="docutils literal notranslate"><span class="pre">shots_count</span></code> argument to <code class="docutils literal notranslate"><span class="pre">cudaq.sample</span></code> or <code class="docutils literal notranslate"><span class="pre">cudaq.observe</span></code>. By default,
+the <code class="docutils literal notranslate"><span class="pre">shots_count</span></code> is set to 1000.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">10000</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>To see a complete example for using IQM server backends, take a look at our <a class="reference internal" href="../examples/examples.html"><span class="doc">Python examples</span></a>.</p>
+</section>
+</section>
+<section id="oqc">
+<h2>OQC<a class="headerlink" href="#oqc" title="Permalink to this heading">¶</a></h2>
+<p id="oqc-backend"><a class="reference external" href="https://oxfordquantumcircuits.com/">Oxford Quantum Circuits</a> (OQC) is currently providing CUDA-Q integration for multiple Quantum Processing Unit types.
+The 8 qubit ring topology Lucy device and the 32 qubit Kagome lattice topology Toshiko device are both supported via machine options described below.</p>
+<section id="id4">
+<h3>Setting Credentials<a class="headerlink" href="#id4" title="Permalink to this heading">¶</a></h3>
+<p>In order to use the OQC devices you will need to register.
+Registration is achieved by contacting <a class="reference external" href="mailto:oqc_qcaas_support&#37;&#52;&#48;oxfordquantumcircuits&#46;com">oqc_qcaas_support<span>&#64;</span>oxfordquantumcircuits<span>&#46;</span>com</a></p>
+<p>Once registered you will be able to authenticate with your <code class="docutils literal notranslate"><span class="pre">email</span></code> and <code class="docutils literal notranslate"><span class="pre">password</span></code></p>
+<p>There are three environment variables that the OQC target will look for during configuration:</p>
+<ol class="arabic simple">
+<li><p><code class="docutils literal notranslate"><span class="pre">OQC_URL</span></code></p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">OQC_EMAIL</span></code></p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">OQC_PASSWORD</span></code> - is mandatory</p></li>
+</ol>
+</section>
+<section id="id5">
+<h3>Submission from C++<a class="headerlink" href="#id5" title="Permalink to this heading">¶</a></h3>
+<p>To target quantum kernel code for execution on the OQC platform, provide the flag <code class="docutils literal notranslate"><span class="pre">--target</span> <span class="pre">oqc</span></code> to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler.</p>
+<p>Users may provide their <code class="code docutils literal notranslate"><span class="pre">email</span></code> and <code class="code docutils literal notranslate"><span class="pre">url</span></code> as extra arguments</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>oqc<span class="w"> </span>--oqc-email<span class="w"> </span>&lt;email&gt;<span class="w"> </span>--oqc-url<span class="w"> </span>&lt;url&gt;<span class="w"> </span>src.cpp<span class="w"> </span>-o<span class="w"> </span>executable
+</pre></div>
+</div>
+<p>Where both environment variables and extra arguments are supplied, precedent is given to the extra arguments.
+To run the output, provide the runtime loaded variables and invoke the pre-built executable</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">OQC_PASSWORD</span><span class="o">=</span>&lt;password&gt;<span class="w"> </span>./executable
+</pre></div>
+</div>
+<p>To emulate the OQC device locally, without submitting through the OQC QCaaS services, you can pass the <code class="docutils literal notranslate"><span class="pre">--emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">nvq++</span></code>.
+This will emit any target specific compiler warnings and diagnostics, before running a noise free emulation.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--emulate<span class="w"> </span>--target<span class="w"> </span>oqc<span class="w"> </span>src.cpp<span class="w"> </span>-o<span class="w"> </span>executable
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The oqc target supports a <code class="docutils literal notranslate"><span class="pre">--oqc-machine</span></code> option.
+The default is the 8 qubit Lucy device.
+You can set this to be either <code class="docutils literal notranslate"><span class="pre">toshiko</span></code> or <code class="docutils literal notranslate"><span class="pre">lucy</span></code> via this flag.</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The OQC quantum assembly toolchain (qat) which is used to compile and execute instructions can be found on github as <a class="reference external" href="https://github.com/oqc-community/qat">oqc-community/qat</a></p>
+</div>
+</section>
+<section id="id6">
+<h3>Submission from Python<a class="headerlink" href="#id6" title="Permalink to this heading">¶</a></h3>
+<p>To set which OQC URL, set the <code class="code docutils literal notranslate"><span class="pre">url</span></code> parameter.
+To set which OQC email, set the <code class="code docutils literal notranslate"><span class="pre">email</span></code> parameter.
+To set which OQC machine, set the <code class="code docutils literal notranslate"><span class="pre">machine</span></code> parameter.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="c1"># ...</span>
+<span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;OQC_PASSWORD&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">password</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;oqc&quot;</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="n">url</span><span class="p">,</span> <span class="n">machine</span><span class="o">=</span><span class="s2">&quot;lucy&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>You can then execute a kernel against the platform using the OQC Lucy device</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">kernel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+<span class="n">qvec</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">h</span><span class="p">(</span><span class="n">qvec</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="n">qvec</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">cx</span><span class="p">(</span><span class="n">qvec</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qvec</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">mz</span><span class="p">(</span><span class="n">qvec</span><span class="p">)</span>
+<span class="nb">str</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="o">=</span><span class="n">kernel</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">))</span>
+</pre></div>
+</div>
+</section>
+</section>
+<section id="orca-computing">
+<h2>ORCA Computing<a class="headerlink" href="#orca-computing" title="Permalink to this heading">¶</a></h2>
+<p id="orca-backend">ORCA Computing’s PT Series implement the boson sampling model of quantum computation, in which
+multiple single photons are interfered with each other within a network of beam splitters, and
+photon detectors measure where the photons leave this network. This process is implemented within
+a time-bin interferometer (TBI) architecture where photons are created in different time-bins
+and interfered within a network of delay lines. This can be represented by a circuit diagram,
+like the one below, where this illustration example corresponds to 4 photons in 8 modes sent into
+alternating time-bins in a circuit composed of two delay lines in series.</p>
+<a class="reference internal image-reference" href="../../_images/orca_tbi.png"><img alt="../../_images/orca_tbi.png" class="align-center" src="../../_images/orca_tbi.png" style="width: 400px;" /></a>
+<section id="id7">
+<h3>Setting Credentials<a class="headerlink" href="#id7" title="Permalink to this heading">¶</a></h3>
+<p>Programmers of CUDA-Q may access the ORCA API from either C++ or Python. There is an environment
+variable <code class="docutils literal notranslate"><span class="pre">ORCA_ACCESS_URL</span></code> that can be set so that the ORCA target can look for it during
+configuration.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">ORCA_ACCESS_URL</span><span class="o">=</span><span class="s2">&quot;https://&lt;ORCA API Server&gt;&quot;</span>
+</pre></div>
+</div>
+</section>
+<section id="id8">
+<h3>Submission from C++<a class="headerlink" href="#id8" title="Permalink to this heading">¶</a></h3>
+<p>To execute a boson sampling experiment on the ORCA platform, provide the flag
+<code class="docutils literal notranslate"><span class="pre">--target</span> <span class="pre">orca</span></code> to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler. You should then pass the <code class="docutils literal notranslate"><span class="pre">--orca-url</span></code> flag set with
+the previously set environment variable <code class="docutils literal notranslate"><span class="pre">$ORCA_ACCESS_URL</span></code> or an <code class="code docutils literal notranslate"><span class="pre">url</span></code>.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>orca<span class="w"> </span>--orca-url<span class="w"> </span><span class="nv">$ORCA_ACCESS_URL</span><span class="w"> </span>src.cpp<span class="w"> </span>-o<span class="w"> </span>executable
+</pre></div>
+</div>
+<p>or</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>orca<span class="w"> </span>--orca-url<span class="w"> </span>&lt;url&gt;<span class="w"> </span>src.cpp<span class="w"> </span>-o<span class="w"> </span>executable
+</pre></div>
+</div>
+<p>To run the output, invoke the executable</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>./executable
+</pre></div>
+</div>
+<p>To see a complete example for using ORCA server backends, take a look at our <a class="reference internal" href="../examples/hardware_providers.html"><span class="doc">C++ examples</span></a>.</p>
+</section>
+<section id="id9">
+<h3>Submission from Python<a class="headerlink" href="#id9" title="Permalink to this heading">¶</a></h3>
+<p>To set which ORCA URL to be used, set the <code class="code docutils literal notranslate"><span class="pre">url</span></code> parameter.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">os</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="c1"># ...</span>
+<span class="n">orca_url</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s2">&quot;ORCA_ACCESS_URL&quot;</span><span class="p">,</span> <span class="s2">&quot;http://localhost/sample&quot;</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;orca&quot;</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="n">orca_url</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>You can then execute a time-bin boson sampling experiment against the platform using an ORCA device.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">bs_angles</span> <span class="o">=</span> <span class="p">[</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">3</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">6</span><span class="p">]</span>
+<span class="n">input_state</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span>
+<span class="n">loop_lengths</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">]</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">orca</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">input_state</span><span class="p">,</span> <span class="n">loop_lengths</span><span class="p">,</span> <span class="n">bs_angles</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>To see a complete example for using ORCA’s backends, take a look at our <a class="reference internal" href="../examples/hardware_providers.html"><span class="doc">Python examples</span></a>.</p>
+</section>
+</section>
+<section id="quantinuum">
+<h2>Quantinuum<a class="headerlink" href="#quantinuum" title="Permalink to this heading">¶</a></h2>
+<section id="quantinuum-backend">
+<span id="id10"></span><h3>Setting Credentials<a class="headerlink" href="#quantinuum-backend" title="Permalink to this heading">¶</a></h3>
+<p>Programmers of CUDA-Q may access the Quantinuum API from either
+C++ or Python. Quantinuum requires a credential configuration file.
+The configuration file can be generated as follows, replacing
+the <code class="docutils literal notranslate"><span class="pre">email</span></code> and <code class="docutils literal notranslate"><span class="pre">credentials</span></code> in the first line with your Quantinuum
+account details.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># You may need to run: `apt-get update &amp;&amp; apt-get install curl jq`</span>
+curl<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Content Type: application/json&quot;</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>-d<span class="w"> </span><span class="s1">&#39;{ &quot;email&quot;:&quot;&lt;your_alias&gt;@email.com&quot;,&quot;password&quot;:&quot;&lt;your_password&gt;&quot; }&#39;</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>https://qapi.quantinuum.com/v1/login<span class="w"> </span>&gt;<span class="w"> </span><span class="nv">$HOME</span>/credentials.json
+<span class="nv">id_token</span><span class="o">=</span><span class="sb">`</span>cat<span class="w"> </span><span class="nv">$HOME</span>/credentials.json<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;.&quot;id-token&quot;&#39;</span><span class="sb">`</span>
+<span class="nv">refresh_token</span><span class="o">=</span><span class="sb">`</span>cat<span class="w"> </span><span class="nv">$HOME</span>/credentials.json<span class="w"> </span><span class="p">|</span><span class="w"> </span>jq<span class="w"> </span>-r<span class="w"> </span><span class="s1">&#39;.&quot;refresh-token&quot;&#39;</span><span class="sb">`</span>
+<span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;key: </span><span class="nv">$id_token</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span><span class="nv">$HOME</span>/.quantinuum_config
+<span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;refresh: </span><span class="nv">$refresh_token</span><span class="s2">&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span><span class="nv">$HOME</span>/.quantinuum_config
+</pre></div>
+</div>
+<p>The path to the configuration can be specified as an environment variable:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">CUDAQ_QUANTINUUM_CREDENTIALS</span><span class="o">=</span><span class="nv">$HOME</span>/.quantinuum_config
+</pre></div>
+</div>
+</section>
+<section id="id11">
+<h3>Submission from C++<a class="headerlink" href="#id11" title="Permalink to this heading">¶</a></h3>
+<p>To target quantum kernel code for execution in the Quantinuum backends,
+pass the flag <code class="docutils literal notranslate"><span class="pre">--target</span> <span class="pre">quantinuum</span></code> to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler. CUDA-Q will
+authenticate via the Quantinuum REST API using the credential in your configuration file.
+By default, quantum kernel code will be submitted to the Quantinuum syntax checker.
+Submission to the syntax checker merely validates the program; the kernels are not executed.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>quantinuum<span class="w"> </span>src.cpp<span class="w"> </span>...
+</pre></div>
+</div>
+<p>To execute your kernels, pass the <code class="docutils literal notranslate"><span class="pre">--quantinuum-machine</span></code> flag to the <code class="docutils literal notranslate"><span class="pre">nvq++</span></code> compiler
+to specify which machine to submit quantum kernels to:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>quantinuum<span class="w"> </span>--quantinuum-machine<span class="w"> </span>H1-2<span class="w"> </span>src.cpp<span class="w"> </span>...
+</pre></div>
+</div>
+<p>where <code class="docutils literal notranslate"><span class="pre">H1-2</span></code> is an example of a physical QPU. Hardware specific
+emulators may be accessed by appending an <code class="docutils literal notranslate"><span class="pre">E</span></code> to the end (e.g, <code class="docutils literal notranslate"><span class="pre">H1-2E</span></code>). For
+access to the syntax checker for the provided machine, you may append an <code class="docutils literal notranslate"><span class="pre">SC</span></code>
+to the end (e.g, <code class="docutils literal notranslate"><span class="pre">H1-1SC</span></code>).</p>
+<p>For a comprehensive list of available machines, login to your <a class="reference external" href="https://um.qapi.quantinuum.com/user">Quantinuum user account</a>
+and navigate to the “Account” tab, where you should find a table titled “Machines”.</p>
+<p>To emulate the Quantinuum machine locally, without submitting through the cloud,
+you can also pass the <code class="docutils literal notranslate"><span class="pre">--emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">nvq++</span></code>. This will emit any target
+specific compiler warnings and diagnostics, before running a noise free emulation.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--emulate<span class="w"> </span>--target<span class="w"> </span>quantinuum<span class="w"> </span>src.cpp
+</pre></div>
+</div>
+<p>To see a complete example for using Quantinuum’s backends, take a look at our <a class="reference internal" href="../examples/examples.html"><span class="doc">C++ examples</span></a>.</p>
+</section>
+<section id="id12">
+<h3>Submission from Python<a class="headerlink" href="#id12" title="Permalink to this heading">¶</a></h3>
+<p>The target to which quantum kernels are submitted
+can be controlled with the <code class="docutils literal notranslate"><span class="pre">cudaq::set_target()</span></code> function.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;quantinuum&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>By default, quantum kernel code will be submitted to the Quantinuum syntax checker.
+Submission to the syntax checker merely validates the program; the kernels are not executed.</p>
+<p>To execute your kernels, specify which machine to submit quantum kernels to
+by setting the <code class="code docutils literal notranslate"><span class="pre">machine</span></code> parameter of the target.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;quantinuum&#39;</span><span class="p">,</span> <span class="n">machine</span><span class="o">=</span><span class="s1">&#39;H1-2&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>where <code class="docutils literal notranslate"><span class="pre">H1-2</span></code> is an example of a physical QPU. Hardware specific
+emulators may be accessed by appending an <code class="docutils literal notranslate"><span class="pre">E</span></code> to the end (e.g, <code class="docutils literal notranslate"><span class="pre">H1-2E</span></code>). For
+access to the syntax checker for the provided machine, you may append an <code class="docutils literal notranslate"><span class="pre">SC</span></code>
+to the end (e.g, <code class="docutils literal notranslate"><span class="pre">H1-1SC</span></code>).</p>
+<p>For a comprehensive list of available machines, login to your <a class="reference external" href="https://um.qapi.quantinuum.com/user">Quantinuum user account</a>
+and navigate to the “Account” tab, where you should find a table titled “Machines”.</p>
+<p>To emulate the Quantinuum machine locally, without submitting through the cloud,
+you can also set the <code class="docutils literal notranslate"><span class="pre">emulate</span></code> flag to <code class="docutils literal notranslate"><span class="pre">True</span></code>. This will emit any target
+specific compiler warnings and diagnostics, before running a noise free emulation.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;quantinuum&#39;</span><span class="p">,</span> <span class="n">emulate</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>The number of shots for a kernel execution can be set through
+the <code class="docutils literal notranslate"><span class="pre">shots_count</span></code> argument to <code class="docutils literal notranslate"><span class="pre">cudaq.sample</span></code> or <code class="docutils literal notranslate"><span class="pre">cudaq.observe</span></code>. By default,
+the <code class="docutils literal notranslate"><span class="pre">shots_count</span></code> is set to 1000.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">10000</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>To see a complete example for using Quantinuum’s backends, take a look at our <a class="reference internal" href="../examples/examples.html"><span class="doc">Python examples</span></a>.</p>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="simulators.html" class="btn btn-neutral float-left" title="CUDA-Q Simulation Backends" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="nvqc.html" class="btn btn-neutral float-right" title="NVIDIA Quantum Cloud" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/backends/nvqc.html b/pr-2241/using/backends/nvqc.html
new file mode 100644
index 0000000000..f526d2159f
--- /dev/null
+++ b/pr-2241/using/backends/nvqc.html
@@ -0,0 +1,1018 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>NVIDIA Quantum Cloud &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Multi-Processor Platforms" href="platform.html" />
+    <link rel="prev" title="CUDA-Q Hardware Backends" href="hardware.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="backends.html">   Backends</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="backends.html">CUDA-Q Backends</a></li>
+      <li class="breadcrumb-item active">NVIDIA Quantum Cloud</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/backends/nvqc.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="hardware.html" class="btn btn-neutral float-left" title="CUDA-Q Hardware Backends" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="platform.html" class="btn btn-neutral float-right" title="Multi-Processor Platforms" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="nvidia-quantum-cloud">
+<h1>NVIDIA Quantum Cloud<a class="headerlink" href="#nvidia-quantum-cloud" title="Permalink to this heading">¶</a></h1>
+<p>NVIDIA Quantum Cloud (NVQC) offers universal access to the world’s most powerful computing platform,
+for every quantum researcher to do their life’s work.
+To learn more about NVQC visit this <a class="reference external" href="https://www.nvidia.com/en-us/solutions/quantum-computing/cloud">link</a>.</p>
+<p>Apply for early access <a class="reference external" href="https://developer.nvidia.com/quantum-cloud-early-access-join">here</a>.
+Access to the Quantum Cloud early access program requires an NVIDIA Developer account.</p>
+<section id="quick-start">
+<h2>Quick Start<a class="headerlink" href="#quick-start" title="Permalink to this heading">¶</a></h2>
+<p>Once you have been approved for an early access to NVQC, you will be able to follow these instructions to use it.</p>
+<p>1. Follow the instructions in your NVQC Early Access welcome email to obtain an API Key for NVQC.
+You can also find the instructions <a class="reference external" href="https://developer.nvidia.com/quantum-cloud-early-access-members">here</a> (link available only for approved users)</p>
+<ol class="arabic simple" start="2">
+<li><p>Set the environment variable <code class="code docutils literal notranslate"><span class="pre">NVQC_API_KEY</span></code> to the API Key obtained above.</p></li>
+</ol>
+<blockquote>
+<div><div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">export NVQC_API_KEY=&lt;your NVQC API key&gt;</span>
+</pre></div>
+</div>
+</div></blockquote>
+<p>You may wish to persist that environment variable between bash sessions, e.g., by adding it to your <code class="code docutils literal notranslate"><span class="pre">$HOME/.bashrc</span></code> file.</p>
+<ol class="arabic simple" start="3">
+<li><p>Run your first NVQC example</p></li>
+</ol>
+<p>The following is a typical CUDA-Q kernel example.
+By selecting the <code class="code docutils literal notranslate"><span class="pre">nvqc</span></code> target, the quantum circuit simulation will run on NVQC in the cloud, rather than running locally.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvqc&quot;</span><span class="p">)</span>
+<span class="n">num_qubits</span> <span class="o">=</span> <span class="mi">25</span>
+<span class="c1"># Define a simple quantum kernel to execute on NVQC.</span>
+<span class="n">kernel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+<span class="n">qubits</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="n">num_qubits</span><span class="p">)</span>
+<span class="c1"># Maximally entangled state between 25 qubits.</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">num_qubits</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+    <span class="n">kernel</span><span class="o">.</span><span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">[2024-03-14 19:26:31.438] Submitting jobs to NVQC service with 1 GPU(s). Max execution time: 3600 seconds (excluding queue wait time).</span>
+
+<span class="go">================ NVQC Device Info ================</span>
+<span class="go">GPU Device Name: &quot;NVIDIA H100 80GB HBM3&quot;</span>
+<span class="go">CUDA Driver Version / Runtime Version: 12.2 / 11.8</span>
+<span class="go">Total global memory (GB): 79.1</span>
+<span class="go">Memory Clock Rate (MHz): 2619.000</span>
+<span class="go">GPU Clock Rate (MHz): 1980.000</span>
+<span class="go">==================================================</span>
+<span class="go">{ 1111111111111111111111111:486 0000000000000000000000000:514 }</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// Define a simple quantum kernel to execute on NVQC.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Maximally entangled state between 25 qubits.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">constexpr</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">NUM_QUBITS</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">25</span><span class="p">;</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">NUM_QUBITS</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">NUM_QUBITS</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The code above is saved in <code class="code docutils literal notranslate"><span class="pre">nvqc_intro.cpp</span></code> and compiled with the following command, targeting the <code class="code docutils literal notranslate"><span class="pre">nvqc</span></code> platform</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ nvqc_intro.cpp -o nvqc_intro.x --target nvqc</span>
+<span class="go">./nvqc_intro.x</span>
+
+<span class="go">[2024-03-14 19:25:05.545] Submitting jobs to NVQC service with 1 GPU(s). Max execution time: 3600 seconds (excluding queue wait time).</span>
+
+<span class="go">================ NVQC Device Info ================</span>
+<span class="go">GPU Device Name: &quot;NVIDIA H100 80GB HBM3&quot;</span>
+<span class="go">CUDA Driver Version / Runtime Version: 12.2 / 11.8</span>
+<span class="go">Total global memory (GB): 79.1</span>
+<span class="go">Memory Clock Rate (MHz): 2619.000</span>
+<span class="go">GPU Clock Rate (MHz): 1980.000</span>
+<span class="go">==================================================</span>
+<span class="go">{</span>
+<span class="go">__global__ : { 1111111111111111111111111:487 0000000000000000000000000:513 }</span>
+<span class="go">result : { 1111111111111111111111111:487 0000000000000000000000000:513 }</span>
+<span class="go">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="simulator-backend-selection">
+<h2>Simulator Backend Selection<a class="headerlink" href="#simulator-backend-selection" title="Permalink to this heading">¶</a></h2>
+<p>NVQC hosts all CUDA-Q simulator backends (see <a class="reference internal" href="simulators.html"><span class="doc">CUDA-Q Simulation Backends</span></a>).
+You may use the NVQC <code class="code docutils literal notranslate"><span class="pre">backend</span></code> (Python) or <code class="code docutils literal notranslate"><span class="pre">--nvqc-backend</span></code> (C++) option to select the simulator to be used by the service.</p>
+<p>For example, to request the <code class="code docutils literal notranslate"><span class="pre">tensornet</span></code> simulator backend, the user can do the following for C++ or Python.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvqc&quot;</span><span class="p">,</span> <span class="n">backend</span><span class="o">=</span><span class="s2">&quot;tensornet&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ nvqc_sample.cpp -o nvqc_sample.x --target nvqc --nvqc-backend tensornet</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>By default, the single-GPU single-precision <code class="code docutils literal notranslate"><span class="pre">custatevec-fp32</span></code> simulator backend will be selected if backend information is not specified.</p>
+</div>
+</section>
+<section id="multiple-gpus">
+<h2>Multiple GPUs<a class="headerlink" href="#multiple-gpus" title="Permalink to this heading">¶</a></h2>
+<p>Some CUDA-Q simulator backends are capable of multi-GPU distribution as detailed in <a class="reference internal" href="simulators.html"><span class="doc">CUDA-Q Simulation Backends</span></a>.
+For example, the <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> backend can partition and distribute state vector simulation to multiple GPUs to simulate
+a larger number of qubits, whose state vector size grows beyond the memory size of a single GPU.</p>
+<p>To select a specific number of GPUs on the NVQC managed service, the following <code class="code docutils literal notranslate"><span class="pre">ngpus</span></code> (Python) or <code class="code docutils literal notranslate"><span class="pre">--nvqc-ngpus</span></code> (C++) option can be used.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvqc&quot;</span><span class="p">,</span> <span class="n">backend</span><span class="o">=</span><span class="s2">&quot;nvidia-mgpu&quot;</span><span class="p">,</span> <span class="n">ngpus</span><span class="o">=</span><span class="mi">4</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ nvqc_sample.cpp -o nvqc_sample.x --target nvqc --nvqc-backend nvidia-mgpu --nvqc-ngpus 4</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If your NVQC subscription does not contain service instances that have the specified number of GPUs,
+you may encounter the following error.</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">Unable to find NVQC deployment with 16 GPUs.</span>
+<span class="go">Available deployments have {1, 2, 4, 8} GPUs.</span>
+<span class="go">Please check your `ngpus` value (Python) or `--nvqc-ngpus` value (C++).</span>
+</pre></div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Not all simulator backends are capable of utilizing multiple GPUs.
+When requesting a multiple-GPU service with a single-GPU simulator backend,
+you might encounter the following log message:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">The requested backend simulator (custatevec-fp32) is not capable of using all 4 GPUs requested.</span>
+<span class="go">Only one GPU will be used for simulation.</span>
+<span class="go">Please refer to CUDA-Q documentation for a list of multi-GPU capable simulator backends.</span>
+</pre></div>
+</div>
+<p>Consider removing the <code class="code docutils literal notranslate"><span class="pre">ngpus</span></code> value (Python) or <code class="code docutils literal notranslate"><span class="pre">--nvqc-ngpus</span></code> value (C++) to use the default of 1 GPU
+if you don’t need to use a multi-GPU backend to better utilize NVQC resources.</p>
+<p>Please refer to the table below for a list of backend simulator names along with its multi-GPU capability.</p>
+<table class="docutils align-default" id="id1">
+<caption><span class="caption-text">Simulator Backends</span><a class="headerlink" href="#id1" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col style="width: 22%" />
+<col style="width: 56%" />
+<col style="width: 11%" />
+<col style="width: 11%" />
+</colgroup>
+<thead>
+<tr class="row-odd"><th class="head"><p>Name</p></th>
+<th class="head"><p>Description</p></th>
+<th class="head"><p>GPU Accelerated</p></th>
+<th class="head"><p>Multi-GPU</p></th>
+</tr>
+</thead>
+<tbody>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">qpp</span></code></p></td>
+<td><p>CPU-only state vector simulator</p></td>
+<td><p>no</p></td>
+<td><p>no</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">dm</span></code></p></td>
+<td><p>CPU-only density matrix simulator</p></td>
+<td><p>no</p></td>
+<td><p>no</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">custatevec-fp32</span></code></p></td>
+<td><p>Single-precision <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> simulator</p></td>
+<td><p>yes</p></td>
+<td><p>no</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">custatevec-fp64</span></code></p></td>
+<td><p>Double-precision <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> simulator</p></td>
+<td><p>yes</p></td>
+<td><p>no</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">tensornet</span></code></p></td>
+<td><p>Double-precision <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> full tensor network contraction simulator</p></td>
+<td><p>yes</p></td>
+<td><p>yes</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">tensornet-mps</span></code></p></td>
+<td><p>Double-precision <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> matrix-product state simulator</p></td>
+<td><p>yes</p></td>
+<td><p>no</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code></p></td>
+<td><p>Double-precision <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> multi-GPU simulator</p></td>
+<td><p>yes</p></td>
+<td><p>yes</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</section>
+<section id="multiple-qpus-asynchronous-execution">
+<h2>Multiple QPUs Asynchronous Execution<a class="headerlink" href="#multiple-qpus-asynchronous-execution" title="Permalink to this heading">¶</a></h2>
+<p>NVQC provides scalable QPU virtualization services, whereby clients
+can submit asynchronous jobs simultaneously to NVQC. These jobs are
+handled by a pool of service worker instances.</p>
+<p>For example, in the following code snippet, using the <code class="code docutils literal notranslate"><span class="pre">nqpus</span></code> (Python) or <code class="code docutils literal notranslate"><span class="pre">--nvqc-nqpus</span></code> (C++) configuration option,
+the user instantiates 3 virtual QPU instances to submit simulation jobs to NVQC
+calculating the expectation value along with parameter-shift gradients simultaneously.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+<span class="kn">import</span> <span class="nn">math</span>
+
+<span class="c1"># Use NVQC with 3 virtual QPUs</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvqc&quot;</span><span class="p">,</span> <span class="n">nqpus</span><span class="o">=</span><span class="mi">3</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Number of QPUs:&quot;</span><span class="p">,</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span><span class="o">.</span><span class="n">num_qpus</span><span class="p">())</span>
+<span class="c1"># Create the parameterized ansatz</span>
+<span class="n">kernel</span><span class="p">,</span> <span class="n">theta</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">float</span><span class="p">)</span>
+<span class="n">qreg</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="n">qreg</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span> <span class="n">qreg</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">cx</span><span class="p">(</span><span class="n">qreg</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qreg</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+<span class="c1"># Define its spin Hamiltonian.</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="p">(</span><span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span>
+               <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">0.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span>
+               <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">))</span>
+
+
+<span class="k">def</span> <span class="nf">opt_gradient</span><span class="p">(</span><span class="n">parameter_vector</span><span class="p">):</span>
+    <span class="c1"># Evaluate energy and gradient on different remote QPUs</span>
+    <span class="c1"># (i.e., concurrent job submissions to NVQC)</span>
+    <span class="n">energy_future</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                                        <span class="n">hamiltonian</span><span class="p">,</span>
+                                        <span class="n">parameter_vector</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span>
+                                        <span class="n">qpu_id</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+    <span class="n">plus_future</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                                      <span class="n">hamiltonian</span><span class="p">,</span>
+                                      <span class="n">parameter_vector</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span>
+                                      <span class="n">qpu_id</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+    <span class="n">minus_future</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                                       <span class="n">hamiltonian</span><span class="p">,</span>
+                                       <span class="n">parameter_vector</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">-</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">math</span><span class="o">.</span><span class="n">pi</span><span class="p">,</span>
+                                       <span class="n">qpu_id</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
+    <span class="k">return</span> <span class="p">(</span><span class="n">energy_future</span><span class="o">.</span><span class="n">get</span><span class="p">()</span><span class="o">.</span><span class="n">expectation</span><span class="p">(),</span> <span class="p">[</span>
+        <span class="p">(</span><span class="n">plus_future</span><span class="o">.</span><span class="n">get</span><span class="p">()</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span> <span class="o">-</span> <span class="n">minus_future</span><span class="o">.</span><span class="n">get</span><span class="p">()</span><span class="o">.</span><span class="n">expectation</span><span class="p">())</span> <span class="o">/</span>
+        <span class="mf">2.0</span>
+    <span class="p">])</span>
+
+
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">LBFGS</span><span class="p">()</span>
+<span class="n">optimal_value</span><span class="p">,</span> <span class="n">optimal_parameters</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">opt_gradient</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Ground state energy =&quot;</span><span class="p">,</span> <span class="n">optimal_value</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Optimal parameters =&quot;</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/gradients.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/optimizers.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">                     </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">theta</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">make_kernel</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">q</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ansatz</span><span class="p">.</span><span class="n">qalloc</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">r</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ansatz</span><span class="p">.</span><span class="n">qalloc</span><span class="p">();</span>
+<span class="w">  </span><span class="n">ansatz</span><span class="p">.</span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">ansatz</span><span class="p">.</span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">ansatz</span><span class="p">.</span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">r</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Run VQE with a gradient-based optimizer.</span>
+<span class="w">  </span><span class="c1">// Delegate cost function and gradient computation across different NVQC-based</span>
+<span class="w">  </span><span class="c1">// QPUs.</span>
+<span class="w">  </span><span class="c1">// Note: this needs to be compiled with `--nvqc-nqpus 3` create 3 virtual</span>
+<span class="w">  </span><span class="c1">// QPUs.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">optimizers</span><span class="o">::</span><span class="n">lbfgs</span><span class="w"> </span><span class="n">optimizer</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">opt_val</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">optimizer</span><span class="p">.</span><span class="n">optimize</span><span class="p">(</span>
+<span class="w">      </span><span class="cm">/*dim=*/</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="cm">/*opt_function*/</span><span class="w"> </span><span class="p">[</span><span class="o">&amp;</span><span class="p">](</span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">params</span><span class="p">,</span>
+<span class="w">                                      </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">grads</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="c1">// Queue asynchronous jobs to do energy evaluations across multiple QPUs</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">energy_future</span><span class="w"> </span><span class="o">=</span>
+<span class="w">            </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe_async</span><span class="p">(</span><span class="cm">/*qpu_id=*/</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="n">params</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">        </span><span class="k">const</span><span class="w"> </span><span class="kt">double</span><span class="w"> </span><span class="n">paramShift</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">M_PI_2</span><span class="p">;</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">plus_future</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe_async</span><span class="p">(</span><span class="cm">/*qpu_id=*/</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">h</span><span class="p">,</span>
+<span class="w">                                                </span><span class="n">params</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="n">paramShift</span><span class="p">);</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">minus_future</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe_async</span><span class="p">(</span><span class="cm">/*qpu_id=*/</span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">h</span><span class="p">,</span>
+<span class="w">                                                 </span><span class="n">params</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">paramShift</span><span class="p">);</span>
+<span class="w">        </span><span class="n">grads</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="n">plus_future</span><span class="p">.</span><span class="n">get</span><span class="p">().</span><span class="n">expectation</span><span class="p">()</span><span class="w"> </span><span class="o">-</span>
+<span class="w">                    </span><span class="n">minus_future</span><span class="p">.</span><span class="n">get</span><span class="p">().</span><span class="n">expectation</span><span class="p">())</span><span class="w"> </span><span class="o">/</span>
+<span class="w">                   </span><span class="mf">2.0</span><span class="p">;</span>
+<span class="w">        </span><span class="k">return</span><span class="w"> </span><span class="n">energy_future</span><span class="p">.</span><span class="n">get</span><span class="p">().</span><span class="n">expectation</span><span class="p">();</span>
+<span class="w">      </span><span class="p">});</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;Minimum energy = &quot;</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">opt_val</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot; (expected -1.74886).</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The code above is saved in <code class="code docutils literal notranslate"><span class="pre">nvqc_vqe.cpp</span></code> and compiled with the following command, targeting the <code class="code docutils literal notranslate"><span class="pre">nvqc</span></code> platform with 3 virtual QPUs.</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ nvqc_vqe.cpp -o nvqc_vqe.x --target nvqc --nvqc-nqpus 3</span>
+<span class="go">./nvqc_vqe.x</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The NVQC managed-service has a pool of worker instances processing incoming requests on a
+first-come-first-serve basis. Thus, the attainable speedup using multiple virtual QPUs vs.
+sequential execution on a single QPU depends on the NVQC service load. For example,
+if the number of free workers is greater than the number of requested virtual QPUs, a linear
+(ideal) speedup could be achieved. On the other hand, if all the service workers are busy,
+multi-QPU distribution may not deliver any substantial speedup.</p>
+</div>
+</section>
+<section id="faq">
+<h2>FAQ<a class="headerlink" href="#faq" title="Permalink to this heading">¶</a></h2>
+<ol class="arabic simple">
+<li><p>How do I get more information about my NVQC API submission?</p></li>
+</ol>
+<p>The environment variable <code class="code docutils literal notranslate"><span class="pre">NVQC_LOG_LEVEL</span></code> can be used to turn on and off
+certain logs. There are three levels:</p>
+<ul class="simple">
+<li><p>Info (<code class="code docutils literal notranslate"><span class="pre">info</span></code>): basic information about NVQC is logged to the console. This is the default.</p></li>
+<li><p>Off (<code class="code docutils literal notranslate"><span class="pre">off</span></code> or <code class="code docutils literal notranslate"><span class="pre">0</span></code>): disable all NVQC logging.</p></li>
+<li><p>Trace: (<code class="code docutils literal notranslate"><span class="pre">trace</span></code>): log additional information for each NVQC job execution (including timing)</p></li>
+</ul>
+<ol class="arabic simple" start="2">
+<li><p>I want to persist my API key to a configuration file.</p></li>
+</ol>
+<p>You may persist your NVQC API Key to a credential configuration file in lieu of
+using the <code class="code docutils literal notranslate"><span class="pre">NVQC_API_KEY</span></code> environment variable.
+The configuration file can be generated as follows, replacing
+the <code class="code docutils literal notranslate"><span class="pre">api_key</span></code> value with your NVQC API Key.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;key: &lt;api_key&gt;&quot;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span><span class="nv">$HOME</span>/.nvqc_config
+</pre></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="hardware.html" class="btn btn-neutral float-left" title="CUDA-Q Hardware Backends" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="platform.html" class="btn btn-neutral float-right" title="Multi-Processor Platforms" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/backends/platform.html b/pr-2241/using/backends/platform.html
new file mode 100644
index 0000000000..e3750adf6f
--- /dev/null
+++ b/pr-2241/using/backends/platform.html
@@ -0,0 +1,1176 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Multi-Processor Platforms &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Installation Guide" href="../install/install.html" />
+    <link rel="prev" title="NVIDIA Quantum Cloud" href="nvqc.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="backends.html">   Backends</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="backends.html">CUDA-Q Backends</a></li>
+      <li class="breadcrumb-item active">Multi-Processor Platforms</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/backends/platform.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="nvqc.html" class="btn btn-neutral float-left" title="NVIDIA Quantum Cloud" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../install/install.html" class="btn btn-neutral float-right" title="Installation Guide" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="multi-processor-platforms">
+<h1>Multi-Processor Platforms<a class="headerlink" href="#multi-processor-platforms" title="Permalink to this heading">¶</a></h1>
+<p>The CUDA-Q machine model elucidates the various devices considered in the
+broader quantum-classical compute node context. Programmers will have one or many
+host CPUs, zero or many NVIDIA GPUs, a classical QPU control space, and the
+quantum register itself. Moreover, the <a class="reference internal" href="../../specification/cudaq/platform.html"><span class="doc">specification</span></a>
+notes that the underlying platform may expose multiple QPUs. In the near-term,
+this will be unlikely with physical QPU instantiations, but the availability of
+GPU-based circuit simulators on NVIDIA multi-GPU architectures does give one an
+opportunity to think about programming such a multi-QPU architecture in the near-term.
+CUDA-Q starts by enabling one to query information about the underlying quantum
+platform via the <code class="code docutils literal notranslate"><span class="pre">quantum_platform</span></code> abstraction. This type exposes a
+<code class="code docutils literal notranslate"><span class="pre">num_qpus()</span></code> method that can be used to query the number of available
+QPUs for asynchronous CUDA-Q kernel and <code class="code docutils literal notranslate"><span class="pre">cudaq::</span></code> function invocations.
+Each available QPU is assigned a logical index, and programmers can launch
+specific asynchronous function invocations targeting a desired QPU.</p>
+<section id="nvidia-mqpu-platform">
+<span id="mqpu-platform"></span><h2>NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform<a class="headerlink" href="#nvidia-mqpu-platform" title="Permalink to this heading">¶</a></h2>
+<p>In the multi-QPU mode (<code class="code docutils literal notranslate"><span class="pre">mqpu</span></code> option), the NVIDIA target provides a simulated QPU for every available NVIDIA GPU on the underlying system.
+Each QPU is simulated via a <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> simulator backend as defined by the NVIDIA target. For more information about using multiple GPUs
+to simulate each virtual QPU, or using a different backend for virtual QPUs, please see <a class="reference internal" href="#id1"><span class="std std-ref">remote MQPU platform</span></a>.
+This target enables asynchronous parallel execution of quantum kernel tasks.</p>
+<p>Here is a simple example demonstrating its usage.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+<span class="n">target</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span>
+<span class="n">qpu_count</span> <span class="o">=</span> <span class="n">target</span><span class="o">.</span><span class="n">num_qpus</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Number of QPUs:&quot;</span><span class="p">,</span> <span class="n">qpu_count</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="c1"># Place qubits in superposition state.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+    <span class="c1"># Measure.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="n">count_futures</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="k">for</span> <span class="n">qpu</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qpu_count</span><span class="p">):</span>
+    <span class="n">count_futures</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">qpu</span><span class="p">))</span>
+
+<span class="k">for</span> <span class="n">counts</span> <span class="ow">in</span> <span class="n">count_futures</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="o">.</span><span class="n">get</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernelToBeSampled</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">int</span><span class="w"> </span><span class="n">runtimeParam</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">runtimeParam</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Get the quantum_platform singleton</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">platform</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">get_platform</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Query the number of QPUs in the system</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">num_qpus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">platform</span><span class="p">.</span><span class="n">num_qpus</span><span class="p">();</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Number of QPUs: %zu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// We will launch asynchronous sampling tasks</span>
+<span class="w">  </span><span class="c1">// and will store the results immediately as a future</span>
+<span class="w">  </span><span class="c1">// we can query at some later point</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">async_sample_result</span><span class="o">&gt;</span><span class="w"> </span><span class="n">countFutures</span><span class="p">;</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">countFutures</span><span class="p">.</span><span class="n">emplace_back</span><span class="p">(</span>
+<span class="w">        </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_async</span><span class="p">(</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">kernelToBeSampled</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="w"> </span><span class="cm">/*runtimeParam*/</span><span class="p">));</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="c1">//</span>
+<span class="w">  </span><span class="c1">// Go do other work, asynchronous execution of sample tasks on-going</span>
+<span class="w">  </span><span class="c1">//</span>
+
+<span class="w">  </span><span class="c1">// Get the results, note future::get() will kick off a wait</span>
+<span class="w">  </span><span class="c1">// if the results are not yet available.</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">counts</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">countFutures</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">counts</span><span class="p">.</span><span class="n">get</span><span class="p">().</span><span class="n">dump</span><span class="p">();</span>
+<span class="w">  </span><span class="p">}</span>
+</pre></div>
+</div>
+<p>One can specify the target multi-QPU architecture with the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> flag:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ sample_async.cpp --target nvidia --target-option mqpu</span>
+<span class="go">./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>CUDA-Q exposes asynchronous versions of the default <code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> algorithmic
+primitive functions like <code class="code docutils literal notranslate"><span class="pre">sample</span></code>, <code class="code docutils literal notranslate"><span class="pre">observe</span></code>, and <code class="code docutils literal notranslate"><span class="pre">get_state</span></code>
+(e.g., <code class="code docutils literal notranslate"><span class="pre">sample_async</span></code> function in the above code snippets).</p>
+<p>Depending on the number of GPUs available on the system, the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> multi-QPU platform will create the same number of virtual QPU instances.
+For example, on a system with 4 GPUs, the above code will distribute the four sampling tasks among those <code class="code docutils literal notranslate"><span class="pre">GPUEmulatedQPU</span></code> instances.</p>
+<p>The results might look like the following 4 different random samplings:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">Number of QPUs: 4</span>
+<span class="go">{ 10011:28 01100:28 ... }</span>
+<span class="go">{ 10011:37 01100:25 ... }</span>
+<span class="go">{ 10011:29 01100:25 ... }</span>
+<span class="go">{ 10011:33 01100:30 ... }</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>By default, the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> multi-QPU platform will utilize all available GPUs (number of QPUs instances is equal to the number of GPUs).
+To specify the number QPUs to be instantiated, one can set the <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MQPU_NGPUS</span></code> environment variable.
+For example, use <code class="code docutils literal notranslate"><span class="pre">export</span> <span class="pre">CUDAQ_MQPU_NGPUS=2</span></code> to specify that only 2 QPUs (GPUs) are needed.</p>
+</div>
+<p>Since the underlying <code class="code docutils literal notranslate"><span class="pre">GPUEmulatedQPU</span></code> is a simulator backend, we can also retrieve the state vector from each
+QPU via the <code class="code docutils literal notranslate"><span class="pre">cudaq::get_state_async</span></code> (C++) or <code class="code docutils literal notranslate"><span class="pre">cudaq.get_state_async</span></code> (Python) as shown in the bellow code snippets.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+<span class="n">target</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span>
+<span class="n">qpu_count</span> <span class="o">=</span> <span class="n">target</span><span class="o">.</span><span class="n">num_qpus</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Number of QPUs:&quot;</span><span class="p">,</span> <span class="n">qpu_count</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span>
+    <span class="c1"># Place qubits in GHZ State</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="k">for</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">4</span><span class="p">):</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+
+
+<span class="n">state_futures</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="k">for</span> <span class="n">qpu</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qpu_count</span><span class="p">):</span>
+    <span class="n">state_futures</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_state_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">qpu</span><span class="p">))</span>
+
+<span class="k">for</span> <span class="n">state</span> <span class="ow">in</span> <span class="n">state_futures</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">state</span><span class="o">.</span><span class="n">get</span><span class="p">())</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernelToRun</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">int</span><span class="w"> </span><span class="n">runtimeParam</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">runtimeParam</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">runtimeParam</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Get the quantum_platform singleton</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">platform</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">get_platform</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Query the number of QPUs in the system</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">num_qpus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">platform</span><span class="p">.</span><span class="n">num_qpus</span><span class="p">();</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Number of QPUs: %zu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// We will launch asynchronous tasks</span>
+<span class="w">  </span><span class="c1">// and will store the results immediately as a future</span>
+<span class="w">  </span><span class="c1">// we can query at some later point</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">async_state_result</span><span class="o">&gt;</span><span class="w"> </span><span class="n">stateFutures</span><span class="p">;</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">stateFutures</span><span class="p">.</span><span class="n">emplace_back</span><span class="p">(</span>
+<span class="w">        </span><span class="n">cudaq</span><span class="o">::</span><span class="n">get_state_async</span><span class="p">(</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">kernelToRun</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="w"> </span><span class="cm">/*runtimeParam*/</span><span class="p">));</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="c1">//</span>
+<span class="w">  </span><span class="c1">// Go do other work, asynchronous execution of tasks on-going</span>
+<span class="w">  </span><span class="c1">//</span>
+
+<span class="w">  </span><span class="c1">// Get the results, note future::get() will kick off a wait</span>
+<span class="w">  </span><span class="c1">// if the results are not yet available.</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">state</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">stateFutures</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">state</span><span class="p">.</span><span class="n">get</span><span class="p">().</span><span class="n">dump</span><span class="p">();</span>
+<span class="w">  </span><span class="p">}</span>
+</pre></div>
+</div>
+<p>One can specify the target multi-QPU architecture with the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> flag:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ get_state_async.cpp --target nvidia --target-option mqpu</span>
+<span class="go">./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 0.8: </span>The <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code> and <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu-fp64</span></code> targets, which are equivalent to the multi-QPU options <code class="code docutils literal notranslate"><span class="pre">mgpu,fp32</span></code> and <code class="code docutils literal notranslate"><span class="pre">mgpu,fp64</span></code>, respectively, of the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target, are deprecated and will be removed in a future release.</p>
+</div>
+<section id="parallel-distribution-mode">
+<h3>Parallel distribution mode<a class="headerlink" href="#parallel-distribution-mode" title="Permalink to this heading">¶</a></h3>
+<p>The CUDA-Q <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> multi-QPU platform supports two modes of parallel distribution of expectation value computation:</p>
+<ul class="simple">
+<li><p>MPI: distribute the expectation value computations across available MPI ranks and GPUs for each Hamiltonian term.</p></li>
+<li><p>Thread: distribute the expectation value computations among available GPUs via standard C++ threads (each thread handles one GPU).</p></li>
+</ul>
+<p>For instance, if all GPUs are available on a single node, thread-based parallel distribution
+(<code class="code docutils literal notranslate"><span class="pre">cudaq::parallel::thread</span></code> in C++ or <code class="code docutils literal notranslate"><span class="pre">cudaq.parallel.thread</span></code> in Python, as shown in the above example) is sufficient.
+On the other hand, if one wants to distribute the tasks across GPUs on multiple nodes, e.g., on a compute cluster, MPI distribution mode
+should be used.</p>
+<p>An example of MPI distribution mode usage in both C++ and Python is given below:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">initialize</span><span class="p">()</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+
+
+<span class="c1"># Define spin ansatz.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angle</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="c1"># Define spin Hamiltonian.</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span>
+    <span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+
+<span class="n">exp_val</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="mf">0.59</span><span class="p">,</span>
+                        <span class="n">execution</span><span class="o">=</span><span class="n">cudaq</span><span class="o">.</span><span class="n">parallel</span><span class="o">.</span><span class="n">mpi</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="k">if</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">rank</span><span class="p">()</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Expectation value: &quot;</span><span class="p">,</span> <span class="n">exp_val</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">finalize</span><span class="p">()</span>
+</pre></div>
+</div>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">mpiexec -np &lt;N&gt; python3 file.py</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">initialize</span><span class="p">();</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">                     </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">ansatz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">;</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">r</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="kt">double</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">parallel</span><span class="o">::</span><span class="n">mpi</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="mf">0.59</span><span class="p">);</span>
+<span class="w">  </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">rank</span><span class="p">()</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Expectation value: %lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">result</span><span class="p">);</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">finalize</span><span class="p">();</span>
+</pre></div>
+</div>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ file.cpp --target nvidia --target-option mqpu</span>
+<span class="go">mpiexec -np &lt;N&gt; a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>In the above example, the parallel distribution mode was set to <code class="code docutils literal notranslate"><span class="pre">mpi</span></code> using <code class="code docutils literal notranslate"><span class="pre">cudaq::parallel::mpi</span></code> in C++ or <code class="code docutils literal notranslate"><span class="pre">cudaq.parallel.mpi</span></code> in Python.
+CUDA-Q provides MPI utility functions to initialize, finalize, or query (rank, size, etc.) the MPI runtime.
+Last but not least, the compiled executable (C++) or Python script needs to be launched with an appropriate MPI command,
+e.g., <code class="code docutils literal notranslate"><span class="pre">mpiexec</span></code>, <code class="code docutils literal notranslate"><span class="pre">mpirun</span></code>, <code class="code docutils literal notranslate"><span class="pre">srun</span></code>, etc.</p>
+</section>
+</section>
+<section id="remote-mqpu-platform">
+<h2>Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform<a class="headerlink" href="#remote-mqpu-platform" title="Permalink to this heading">¶</a></h2>
+<p id="id1">As shown in the above examples, the multi-QPU NVIDIA platform enables
+multi-QPU distribution whereby each QPU is simulated by a <a class="reference internal" href="simulators.html#cuquantum-single-gpu"><span class="std std-ref">single NVIDIA GPU</span></a>.
+To run multi-QPU workloads on different simulator backends, one can use the <code class="code docutils literal notranslate"><span class="pre">remote-mqpu</span></code> platform,
+which encapsulates simulated QPUs as independent HTTP REST server instances.
+The following code illustrates how to launch asynchronous sampling tasks on multiple virtual QPUs,
+each simulated by a <code class="code docutils literal notranslate"><span class="pre">tensornet</span></code> simulator backend.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span>    <span class="c1"># Specified as program input, e.g.</span>
+    <span class="c1"># ```</span>
+    <span class="c1"># backend = &quot;tensornet&quot;; servers = &quot;2&quot;</span>
+    <span class="c1"># ```</span>
+    <span class="n">backend</span> <span class="o">=</span> <span class="n">args</span><span class="o">.</span><span class="n">backend</span>
+    <span class="n">servers</span> <span class="o">=</span> <span class="n">args</span><span class="o">.</span><span class="n">servers</span>
+
+    <span class="c1"># Define a kernel to be sampled.</span>
+    <span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+    <span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">controls_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+        <span class="n">controls</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">controls_count</span><span class="p">)</span>
+        <span class="n">targets</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+        <span class="c1"># Place controls in superposition state.</span>
+        <span class="n">h</span><span class="p">(</span><span class="n">controls</span><span class="p">)</span>
+        <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">2</span><span class="p">):</span>
+            <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">controls</span><span class="p">,</span> <span class="n">targets</span><span class="p">[</span><span class="n">target</span><span class="p">])</span>
+        <span class="c1"># Measure.</span>
+        <span class="n">mz</span><span class="p">(</span><span class="n">controls</span><span class="p">)</span>
+        <span class="n">mz</span><span class="p">(</span><span class="n">targets</span><span class="p">)</span>
+
+    <span class="c1"># Set the target to execute on and query the number of QPUs in the system;</span>
+    <span class="c1"># The number of QPUs is equal to the number of (auto-)launched server instances.</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;remote-mqpu&quot;</span><span class="p">,</span>
+                     <span class="n">backend</span><span class="o">=</span><span class="n">backend</span><span class="p">,</span>
+                     <span class="n">auto_launch</span><span class="o">=</span><span class="nb">str</span><span class="p">(</span><span class="n">servers</span><span class="p">)</span> <span class="k">if</span> <span class="n">servers</span><span class="o">.</span><span class="n">isdigit</span><span class="p">()</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+                     <span class="n">url</span><span class="o">=</span><span class="s2">&quot;&quot;</span> <span class="k">if</span> <span class="n">servers</span><span class="o">.</span><span class="n">isdigit</span><span class="p">()</span> <span class="k">else</span> <span class="n">servers</span><span class="p">)</span>
+    <span class="n">qpu_count</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span><span class="o">.</span><span class="n">num_qpus</span><span class="p">()</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Number of virtual QPUs:&quot;</span><span class="p">,</span> <span class="n">qpu_count</span><span class="p">)</span>
+
+    <span class="c1"># We will launch asynchronous sampling tasks,</span>
+    <span class="c1"># and will store the results as a future we can query at some later point.</span>
+    <span class="c1"># Each QPU (indexed by an unique Id) is associated with a remote REST server.</span>
+    <span class="n">count_futures</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qpu_count</span><span class="p">):</span>
+
+        <span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">i</span><span class="p">)</span>
+        <span class="n">count_futures</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Sampling jobs launched for asynchronous processing.&quot;</span><span class="p">)</span>
+
+    <span class="c1"># Go do other work, asynchronous execution of sample tasks on-going.</span>
+    <span class="c1"># Get the results, note future::get() will kick off a wait</span>
+    <span class="c1"># if the results are not yet available.</span>
+    <span class="k">for</span> <span class="n">idx</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">count_futures</span><span class="p">)):</span>
+        <span class="n">counts</span> <span class="o">=</span> <span class="n">count_futures</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+        <span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="c1">// Define a kernel to be sampled.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">nrControls</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">make_kernel</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">controls</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">kernel</span><span class="p">.</span><span class="n">qalloc</span><span class="p">(</span><span class="n">nrControls</span><span class="p">);</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">targets</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">kernel</span><span class="p">.</span><span class="n">qalloc</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="w">  </span><span class="n">kernel</span><span class="p">.</span><span class="n">h</span><span class="p">(</span><span class="n">controls</span><span class="p">);</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">tidx</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">tidx</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">tidx</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">kernel</span><span class="p">.</span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">controls</span><span class="p">,</span><span class="w"> </span><span class="n">targets</span><span class="p">[</span><span class="n">tidx</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="n">kernel</span><span class="p">.</span><span class="n">mz</span><span class="p">(</span><span class="n">controls</span><span class="p">);</span>
+<span class="w">  </span><span class="n">kernel</span><span class="p">.</span><span class="n">mz</span><span class="p">(</span><span class="n">targets</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Query the number of QPUs in the system;</span>
+<span class="w">  </span><span class="c1">// The number of QPUs is equal to the number of (auto-)launched server</span>
+<span class="w">  </span><span class="c1">// instances.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">platform</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">get_platform</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">num_qpus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">platform</span><span class="p">.</span><span class="n">num_qpus</span><span class="p">();</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Number of QPUs: %zu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// We will launch asynchronous sampling tasks,</span>
+<span class="w">  </span><span class="c1">// and will store the results as a future we can query at some later point.</span>
+<span class="w">  </span><span class="c1">// Each QPU (indexed by an unique Id) is associated with a remote REST server.</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">async_sample_result</span><span class="o">&gt;</span><span class="w"> </span><span class="n">countFutures</span><span class="p">;</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">countFutures</span><span class="p">.</span><span class="n">emplace_back</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_async</span><span class="p">(</span>
+<span class="w">        </span><span class="cm">/*qpuId=*/</span><span class="n">i</span><span class="p">,</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="cm">/*nrControls=*/</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">));</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="c1">// Go do other work, asynchronous execution of sample tasks on-going</span>
+<span class="w">  </span><span class="c1">// Get the results, note future::get() will kick off a wait</span>
+<span class="w">  </span><span class="c1">// if the results are not yet available.</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">counts</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">countFutures</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">counts</span><span class="p">.</span><span class="n">get</span><span class="p">().</span><span class="n">dump</span><span class="p">();</span>
+<span class="w">  </span><span class="p">}</span>
+</pre></div>
+</div>
+<p>The code above is saved in <code class="code docutils literal notranslate"><span class="pre">sample_async.cpp</span></code> and compiled with the following command, targeting the <code class="code docutils literal notranslate"><span class="pre">remote-mqpu</span></code> platform:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ sample_async.cpp -o sample_async.x --target remote-mqpu --remote-mqpu-backend tensornet --remote-mqpu-auto-launch 2</span>
+<span class="go">./sample_async.x</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>In the above code snippets, the <code class="code docutils literal notranslate"><span class="pre">remote-mqpu</span></code> platform was used in the auto-launch mode,
+whereby a specific number of server instances, i.e., virtual QPUs, are launched on the local machine
+in the background. The remote QPU daemon service, <code class="code docutils literal notranslate"><span class="pre">cudaq-qpud</span></code>, will also be shut down automatically
+at the end of the session.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>By default, auto launching daemon services do not support MPI parallelism.
+Hence, using the <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> backend to simulate each virtual QPU requires
+manually launching each server instance. How to do that is explained in the rest of this section.</p>
+</div>
+<p id="custom-remote-qpud-launch">To customize how many and which GPUs are used for simulating each virtual QPU, one can launch each server manually.
+For instance, on a machine with 8 NVIDIA GPUs, one may wish to partition those GPUs into
+4 virtual QPU instances, each manages 2 GPUs. To do so, first launch a <code class="code docutils literal notranslate"><span class="pre">cudaq-qpud</span></code> server for each virtual QPU:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># Use cudaq-qpud.py wrapper script to automatically find dependencies for the Python wheel configuration.</span>
+<span class="nv">cudaq_location</span><span class="o">=</span><span class="sb">`</span>python3<span class="w"> </span>-m<span class="w"> </span>pip<span class="w"> </span>show<span class="w"> </span>cuda-quantum<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-e<span class="w"> </span><span class="s1">&#39;Location: .*$&#39;</span><span class="sb">`</span>
+<span class="nv">qpud_py</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">cudaq_location</span><span class="p">#Location: </span><span class="si">}</span><span class="s2">/bin/cudaq-qpud.py&quot;</span>
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">0</span>,1<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$qpud_py</span><span class="s2">&quot;</span><span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">1</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">2</span>,3<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$qpud_py</span><span class="s2">&quot;</span><span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">2</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">4</span>,5<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$qpud_py</span><span class="s2">&quot;</span><span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">3</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">6</span>,7<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$qpud_py</span><span class="s2">&quot;</span><span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">4</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># It is assumed that your $LD_LIBRARY_PATH is able to find all the necessary dependencies.</span>
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">0</span>,1<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>cudaq-qpud<span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">1</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">2</span>,3<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>cudaq-qpud<span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">2</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">4</span>,5<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>cudaq-qpud<span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">3</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+<span class="nv">CUDA_VISIBLE_DEVICES</span><span class="o">=</span><span class="m">6</span>,7<span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>cudaq-qpud<span class="w"> </span>--port<span class="w"> </span>&lt;QPU<span class="w"> </span><span class="m">4</span><span class="w"> </span>TCP/IP<span class="w"> </span>port<span class="w"> </span>number&gt;
+</pre></div>
+</div>
+</div>
+</div>
+<p>In the above code snippet, four <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> daemons are started in MPI context via the <code class="code docutils literal notranslate"><span class="pre">mpiexec</span></code> launcher.
+This activates MPI runtime environment required by the <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> backend. Each QPU daemon is assigned a unique
+TCP/IP port number via the <code class="code docutils literal notranslate"><span class="pre">--port</span></code> command-line option. The <code class="code docutils literal notranslate"><span class="pre">CUDA_VISIBLE_DEVICES</span></code> environment variable restricts the GPU devices
+that each QPU daemon sees so that it targets specific GPUs.</p>
+<p>With these invocations, each virtual QPU is locally addressable at the URL <code class="code docutils literal notranslate"><span class="pre">localhost:&lt;port&gt;</span></code>.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>There is no authentication required to communicate with this server app.
+Hence, please make sure to either (1) use a non-public TCP/IP port for internal use or
+(2) use firewalls or other security mechanisms to manage user access.</p>
+</div>
+<p>User code can then target these QPUs for multi-QPU workloads, such as asynchronous sample or observe shown above for the multi-QPU NVIDIA platform platform.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--5-input--1" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;remote-mqpu&quot;</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="s2">&quot;localhost:&lt;port1&gt;,localhost:&lt;port2&gt;,localhost:&lt;port3&gt;,localhost:&lt;port4&gt;&quot;</span><span class="p">,</span> <span class="n">backend</span><span class="o">=</span><span class="s2">&quot;nvidia-mgpu&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--5-input--2" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ distributed.cpp --target remote-mqpu --remote-mqpu-url localhost:&lt;port1&gt;,localhost:&lt;port2&gt;,localhost:&lt;port3&gt;,localhost:&lt;port4&gt; --remote-mqpu-backend nvidia-mgpu</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Each URL is treated as an independent QPU, hence the number of QPUs (<code class="code docutils literal notranslate"><span class="pre">num_qpus()</span></code>) is equal to the number of URLs provided.
+The multi-node multi-GPU simulator backend (<code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code>) is requested via the <code class="code docutils literal notranslate"><span class="pre">--remote-mqpu-backend</span></code> command-line option.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The requested backend (<code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code>) will be executed inside the context of the QPU daemon service, thus
+inherits its GPU resource allocation (two GPUs per backend simulator instance).</p>
+</div>
+<section id="supported-kernel-arguments">
+<h3>Supported Kernel Arguments<a class="headerlink" href="#supported-kernel-arguments" title="Permalink to this heading">¶</a></h3>
+<p>The platform serializes kernel invocation to QPU daemons via REST APIs.
+Please refer to the <a class="reference external" href="../../openapi.html">Open API Docs</a>  for the latest API information.
+Runtime arguments are serialized into a flat memory buffer (<code class="code docutils literal notranslate"><span class="pre">args</span></code> field of the request JSON).
+For more information about argument type serialization, please see <a class="reference internal" href="#type-serialization-table"><span class="std std-ref">the table below</span></a>.</p>
+<p>When using a remote backend to simulate each virtual QPU,
+by default, we currently do not support passing complex data structures,
+such as nested vectors or class objects, or other kernels as arguments to the entry point kernels.
+These type limitations only apply to the <strong>entry-point</strong> kernel and not when passing arguments
+to other quantum kernels.</p>
+<p>Support for the full range of argument types within CUDA-Q can be enabled by compiling the
+code with the <code class="code docutils literal notranslate"><span class="pre">--enable-mlir</span></code> option. This flag forces quantum kernels to be compiled with
+the CUDA-Q MLIR-based compiler. As a result, runtime arguments can be resolved by the CUDA
+Quantum compiler infrastructure to support wider range of argument types. However, certain
+language constructs within quantum kernels may not yet be fully supported.</p>
+<span id="type-serialization-table"></span><table class="docutils align-default" id="id4">
+<caption><span class="caption-text">Kernel argument serialization</span><a class="headerlink" href="#id4" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col style="width: 33%" />
+<col style="width: 33%" />
+<col style="width: 33%" />
+</colgroup>
+<thead>
+<tr class="row-odd"><th class="head"><p>Data type</p></th>
+<th class="head"><p>Example</p></th>
+<th class="head"><p>Serialization</p></th>
+</tr>
+</thead>
+<tbody>
+<tr class="row-even"><td><p>Trivial type (occupies a contiguous memory area)</p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">int</span></code>, <code class="code docutils literal notranslate"><span class="pre">std::size_t</span></code>, <code class="code docutils literal notranslate"><span class="pre">double</span></code>, etc.</p></td>
+<td><p>Byte data (via <code class="code docutils literal notranslate"><span class="pre">memcpy</span></code>)</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">std::vector</span></code> of trivial type</p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">std::vector&lt;int&gt;</span></code>, <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;double&gt;</span></code>, etc.</p></td>
+<td><p>Total vector size in bytes as a 64-bit integer followed by serialized data of all vector elements.</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">cudaq::pauli_word</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">cudaq::pauli_word(&quot;IXIZ&quot;)</span></code></p></td>
+<td><p>Same as <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;char&gt;</span></code>: total vector size in bytes as a 64-bit integer followed by serialized data of all characters.</p></td>
+</tr>
+<tr class="row-odd"><td><p>Single-level nested <code class="code docutils literal notranslate"><span class="pre">std::vector</span></code> of supported <code class="code docutils literal notranslate"><span class="pre">std::vector</span></code> types</p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">std::vector&lt;std::vector&lt;int&gt;&gt;</span></code>, <code class="code docutils literal notranslate"><span class="pre">std::vector&lt;cudaq::pauli_word&gt;</span></code>, etc.</p></td>
+<td><p>Number of top-level elements (as a 64-bit integer) followed sizes in bytes of element vectors (as a contiguous array of 64-bit integers) then serialized data of the inner vectors.</p></td>
+</tr>
+</tbody>
+</table>
+<p>For CUDA-Q kernels that return a value, the remote platform supports returning simple data types of
+<code class="code docutils literal notranslate"><span class="pre">bool</span></code>, integral (e.g., <code class="code docutils literal notranslate"><span class="pre">int</span></code> or <code class="code docutils literal notranslate"><span class="pre">std::size_t</span></code>), and floating-point types (<code class="code docutils literal notranslate"><span class="pre">float</span></code> or <code class="code docutils literal notranslate"><span class="pre">double</span></code>)
+when MLIR-based compilation is enabled (<code class="code docutils literal notranslate"><span class="pre">--enable-mlir</span></code>).</p>
+</section>
+<section id="accessing-simulated-quantum-state">
+<h3>Accessing Simulated Quantum State<a class="headerlink" href="#accessing-simulated-quantum-state" title="Permalink to this heading">¶</a></h3>
+<p>The remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> platform supports accessing simulator backend’s state vector via the
+<code class="code docutils literal notranslate"><span class="pre">cudaq::get_state</span></code> (C++) or <code class="code docutils literal notranslate"><span class="pre">cudaq.get_state</span></code> (Python) APIs, similar to local simulator backends.</p>
+<p>State data can be retrieved as a full state vector or as individual basis states’ amplitudes.
+The later is designed for large quantum states, which incurred data transfer overheads.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--6-input--1" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">state</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="n">amplitudes</span> <span class="o">=</span> <span class="n">state</span><span class="o">.</span><span class="n">amplitudes</span><span class="p">([</span><span class="s1">&#39;0000&#39;</span><span class="p">,</span> <span class="s1">&#39;1111&#39;</span><span class="p">])</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--6-input--2" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">auto</span><span class="w"> </span><span class="n">state</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">get_state</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="k">auto</span><span class="w"> </span><span class="n">amplitudes</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">state</span><span class="p">.</span><span class="n">amplitudes</span><span class="p">({{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">}});</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>In the above example, the amplitudes of the two requested states are returned.</p>
+<p>For C++ quantum kernels <a class="footnote-reference brackets" href="#id3" id="id2" role="doc-noteref"><span class="fn-bracket">[</span>*<span class="fn-bracket">]</span></a> compiled with the CUDA-Q MLIR-based compiler and Python kernels,
+state accessor is evaluated in a just-in-time/on-demand manner, and hence can be customize to
+users’ need.</p>
+<p>For instance, in the above amplitude access example, if the state vector is very large, e.g.,
+multi-GPU distributed state vectors or tensor-network encoded quantum states, the full state vector
+will not be retrieved when <code class="code docutils literal notranslate"><span class="pre">get_state</span></code> is called. Instead, when the <code class="code docutils literal notranslate"><span class="pre">amplitudes</span></code> accessor is called,
+a specific amplitude calculation request will be sent to the server.
+Thus, only the amplitudes of those basis states will be computed and returned.</p>
+<p>Similarly, for state overlap calculation, if deferred state evaluation is available (Python/MLIR-based compiler)
+for both of the operand quantum states, a custom overlap calculation request will be constructed and sent to the server.
+Only the final overlap result will be returned, thereby eliminating back-and-forth state data transfers.</p>
+<aside class="footnote-list brackets">
+<aside class="footnote brackets" id="id3" role="note">
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id2">*</a><span class="fn-bracket">]</span></span>
+<p>Only C++ quantum kernels whose names are available via run-time type information (RTTI) are supported.
+For example, quantum kernels expressed as named <code class="code docutils literal notranslate"><span class="pre">struct</span></code> are supported but not standalone functions.
+Kernels that do not have deferred state evaluation support will perform synchronous <code class="code docutils literal notranslate"><span class="pre">get_state</span></code>, whereby the full state
+vector is returned from the server immediately.</p>
+</aside>
+</aside>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="nvqc.html" class="btn btn-neutral float-left" title="NVIDIA Quantum Cloud" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../install/install.html" class="btn btn-neutral float-right" title="Installation Guide" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/backends/simulators.html b/pr-2241/using/backends/simulators.html
new file mode 100644
index 0000000000..d9cebf79d4
--- /dev/null
+++ b/pr-2241/using/backends/simulators.html
@@ -0,0 +1,1113 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Simulation Backends &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="CUDA-Q Hardware Backends" href="hardware.html" />
+    <link rel="prev" title="CUDA-Q Backends" href="backends.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="backends.html">   Backends</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="backends.html">CUDA-Q Backends</a></li>
+      <li class="breadcrumb-item active">CUDA-Q Simulation Backends</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/backends/simulators.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="backends.html" class="btn btn-neutral float-left" title="CUDA-Q Backends" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hardware.html" class="btn btn-neutral float-right" title="CUDA-Q Hardware Backends" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-simulation-backends">
+<h1>CUDA-Q Simulation Backends<a class="headerlink" href="#cuda-q-simulation-backends" title="Permalink to this heading">¶</a></h1>
+<p id="nvidia-backend">The simulation backends that are currently available in CUDA-Q are as follows.</p>
+<section id="state-vector-simulators">
+<h2>State Vector Simulators<a class="headerlink" href="#state-vector-simulators" title="Permalink to this heading">¶</a></h2>
+<p>The <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target provides a state vector simulator accelerated with
+the <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> library.</p>
+<p>The <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target supports multiple configurable options.</p>
+<section id="features">
+<h3>Features<a class="headerlink" href="#features" title="Permalink to this heading">¶</a></h3>
+<ul class="simple">
+<li><p>Floating-point precision configuration</p></li>
+</ul>
+<p>The floating point precision of the state vector data can be configured to either
+double (<code class="code docutils literal notranslate"><span class="pre">fp64</span></code>) or single (<code class="code docutils literal notranslate"><span class="pre">fp32</span></code>) precision. This option can be chosen for the optimal performance and accuracy.</p>
+<ul class="simple">
+<li><p>Distributed simulation</p></li>
+</ul>
+<p>The <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target supports distributing state vector simulations to multiple GPUs and multiple nodes (<code class="code docutils literal notranslate"><span class="pre">mgpu</span></code> <a class="reference internal" href="#nvidia-mgpu-backend"><span class="std std-ref">distribution</span></a>)
+and multi-QPU (<code class="code docutils literal notranslate"><span class="pre">mqpu</span></code> <a class="reference internal" href="platform.html#mqpu-platform"><span class="std std-ref">platform</span></a>) distribution whereby each QPU is simulated via a single-GPU simulator instance.</p>
+<ul class="simple">
+<li><p>Host CPU memory utilization</p></li>
+</ul>
+<p>Host CPU memory can be leveraged in addition to GPU memory to accommodate the state vector
+(i.e., maximizing the number of qubits to be simulated).</p>
+</section>
+<section id="single-gpu">
+<span id="cuquantum-single-gpu"></span><h3>Single-GPU<a class="headerlink" href="#single-gpu" title="Permalink to this heading">¶</a></h3>
+<p>To execute a program on the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target, use the following commands:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>nvidia
+</pre></div>
+</div>
+<p>The target can also be defined in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;nvidia&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If a target is set in the application code, this target will override the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> command line flag given during program invocation.</p>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<p id="nvidia-fp64-backend">By default, this will leverage <code class="code docutils literal notranslate"><span class="pre">FP32</span></code> floating point types for the simulation. To
+switch to <code class="code docutils literal notranslate"><span class="pre">FP64</span></code>, specify the <code class="code docutils literal notranslate"><span class="pre">--target-option</span> <span class="pre">fp64</span></code> <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> command line option for <code class="code docutils literal notranslate"><span class="pre">C++</span></code> and <code class="code docutils literal notranslate"><span class="pre">Python</span></code> or
+use <code class="code docutils literal notranslate"><span class="pre">cudaq.set_target('nvidia',</span> <span class="pre">option='fp64')</span></code> for Python in-source target modification instead.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>fp64
+</pre></div>
+</div>
+<p>The precision of the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target can also be modified in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;nvidia&#39;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s1">&#39;fp64&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>fp64<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This backend requires an NVIDIA GPU and CUDA runtime libraries. If you do not have these dependencies installed, you may encounter an error stating <code class="code docutils literal notranslate"><span class="pre">Invalid</span> <span class="pre">simulator</span> <span class="pre">requested</span></code>. See the section <a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility"><span class="std std-ref">Dependencies and Compatibility</span></a> for more information about how to install dependencies.</p>
+</div>
+<p>In the single-GPU mode, the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target provides the following
+environment variable options. Any environment variables must be set prior to
+setting the target.</p>
+<table class="docutils align-default" id="id4">
+<caption><span class="caption-text"><strong>Environment variable options supported in single-GPU mode</strong></span><a class="headerlink" href="#id4" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col style="width: 20%" />
+<col style="width: 30%" />
+<col style="width: 50%" />
+</colgroup>
+<tbody>
+<tr class="row-odd"><td><p>Option</p></td>
+<td><p>Value</p></td>
+<td><p>Description</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_FUSION_MAX_QUBITS</span></code></p></td>
+<td><p>positive integer</p></td>
+<td><p>The max number of qubits used for gate fusion. The default value is <code class="code docutils literal notranslate"><span class="pre">4</span></code>.</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_FUSION_DIAGONAL_GATE_MAX_QUBITS</span></code></p></td>
+<td><p>integer greater than or equal to -1</p></td>
+<td><p>The max number of qubits used for diagonal gate fusion. The default value is set to <code class="code docutils literal notranslate"><span class="pre">-1</span></code> and the fusion size will be automatically adjusted for the better performance. If 0, the gate fusion for diagonal gates is disabled.</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_FUSION_NUM_HOST_THREADS</span></code></p></td>
+<td><p>positive integer</p></td>
+<td><p>Number of CPU threads used for circuit processing. The default value is <code class="code docutils literal notranslate"><span class="pre">8</span></code>.</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MAX_CPU_MEMORY_GB</span></code></p></td>
+<td><p>non-negative integer, or <code class="code docutils literal notranslate"><span class="pre">NONE</span></code></p></td>
+<td><p>CPU memory size (in GB) allowed for state-vector migration. <code class="code docutils literal notranslate"><span class="pre">NONE</span></code> means unlimited (up to physical memory constraints). Default is 0 (disabled).</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MAX_GPU_MEMORY_GB</span></code></p></td>
+<td><p>positive integer, or <code class="code docutils literal notranslate"><span class="pre">NONE</span></code></p></td>
+<td><p>GPU memory (in GB) allowed for on-device state-vector allocation. As the state-vector size exceeds this limit, host memory will be utilized for migration. <code class="code docutils literal notranslate"><span class="pre">NONE</span></code> means unlimited (up to physical memory constraints). This is the default.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 0.8: </span>The <code class="code docutils literal notranslate"><span class="pre">nvidia-fp64</span></code> targets, which is equivalent setting the <code class="code docutils literal notranslate"><span class="pre">fp64</span></code> option on the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target,
+is deprecated and will be removed in a future release.</p>
+</div>
+</section>
+<section id="multi-node-multi-gpu">
+<span id="nvidia-mgpu-backend"></span><h3>Multi-node multi-GPU<a class="headerlink" href="#multi-node-multi-gpu" title="Permalink to this heading">¶</a></h3>
+<p>The NVIDIA target also provides a state vector simulator accelerated with
+the <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> library with support for Multi-Node, Multi-GPU distribution of the
+state vector, in addition to a single GPU.</p>
+<p>The multi-node multi-GPU simulator expects to run within an MPI context.
+To execute a program on the multi-node multi-GPU NVIDIA target, use the following commands
+(adjust the value of the <code class="code docutils literal notranslate"><span class="pre">-np</span></code> flag as needed to reflect available GPU resources on your system):</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<p>Double precision simulation:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>fp64,mgpu
+</pre></div>
+</div>
+<p>Single precision simulation:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>fp32,mgpu
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you installed CUDA-Q via <code class="code docutils literal notranslate"><span class="pre">pip</span></code>, you will need to install the necessary MPI dependencies separately;
+please follow the instructions for installing dependencies in the <a class="reference external" href="https://pypi.org/project/cuda-quantum/#description">Project Description</a>.</p>
+</div>
+<p>In addition to using MPI in the simulator, you can use it in your application code by installing <a class="reference external" href="https://mpi4py.readthedocs.io/">mpi4py</a>, and
+invoking the program with the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span>-m<span class="w"> </span>mpi4py<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>fp64,mgpu
+</pre></div>
+</div>
+<p>The target can also be defined in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;nvidia&#39;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s1">&#39;mgpu,fp64&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If a target is set in the application code, this target will override the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> command line flag given during program invocation.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<ul class="simple">
+<li><p>The order of the option settings are interchangeable.
+For example, <code class="code docutils literal notranslate"><span class="pre">cudaq.set_target('nvidia',</span> <span class="pre">option='mgpu,fp64')</span></code> is equivalent to <code class="code docutils literal notranslate"><span class="pre">cudaq.set_target('nvidia',</span> <span class="pre">option='fp64,mgpu')</span></code>.</p></li>
+<li><p>The <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target has single-precision as the default setting. Thus, using <code class="code docutils literal notranslate"><span class="pre">option='mgpu'</span></code> implies that <code class="code docutils literal notranslate"><span class="pre">option='mgpu,fp32'</span></code>.</p></li>
+</ul>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<p>Double precision simulation:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w">  </span>--target-option<span class="w"> </span>mgpu,fp64<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>./program.x
+</pre></div>
+</div>
+<p>Single precision simulation:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w">  </span>--target-option<span class="w"> </span>mgpu,fp32<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This backend requires an NVIDIA GPU, CUDA runtime libraries, as well as an MPI installation. If you do not have these dependencies installed, you may encounter either an error stating <code class="code docutils literal notranslate"><span class="pre">invalid</span> <span class="pre">simulator</span> <span class="pre">requested</span></code> (missing CUDA libraries), or an error along the lines of <code class="code docutils literal notranslate"><span class="pre">failed</span> <span class="pre">to</span> <span class="pre">launch</span> <span class="pre">kernel</span></code> (missing MPI installation). See the section <a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility"><span class="std std-ref">Dependencies and Compatibility</span></a> for more information about how to install dependencies.</p>
+<p>The number of processes and nodes should be always power-of-2.</p>
+<p>Host-device state vector migration is also supported in the multi-node multi-GPU configuration.</p>
+</div>
+<p>In addition to those environment variable options supported in the single-GPU mode,
+the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target provides the following environment variable options particularly for
+the multi-node multi-GPU configuration. Any environment variables must be set
+prior to setting the target.</p>
+<table class="docutils align-default" id="id5">
+<caption><span class="caption-text"><strong>Additional environment variable options for multi-node multi-GPU mode</strong></span><a class="headerlink" href="#id5" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col style="width: 20%" />
+<col style="width: 30%" />
+<col style="width: 50%" />
+</colgroup>
+<tbody>
+<tr class="row-odd"><td><p>Option</p></td>
+<td><p>Value</p></td>
+<td><p>Description</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MGPU_LIB_MPI</span></code></p></td>
+<td><p>string</p></td>
+<td><p>The shared library name for inter-process communication. The default value is <code class="code docutils literal notranslate"><span class="pre">libmpi.so</span></code>.</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MGPU_COMM_PLUGIN_TYPE</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">AUTO</span></code>, <code class="code docutils literal notranslate"><span class="pre">EXTERNAL</span></code>, <code class="code docutils literal notranslate"><span class="pre">OpenMPI</span></code>, or <code class="code docutils literal notranslate"><span class="pre">MPICH</span></code></p></td>
+<td><p>Selecting <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> <code class="code docutils literal notranslate"><span class="pre">CommPlugin</span></code> for inter-process communication. The default is <code class="code docutils literal notranslate"><span class="pre">AUTO</span></code>. If <code class="code docutils literal notranslate"><span class="pre">EXTERNAL</span></code> is selected, <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MGPU_LIB_MPI</span></code> should point to an implementation of <code class="code docutils literal notranslate"><span class="pre">cuStateVec</span></code> <code class="code docutils literal notranslate"><span class="pre">CommPlugin</span></code> interface.</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MGPU_NQUBITS_THRESH</span></code></p></td>
+<td><p>positive integer</p></td>
+<td><p>The qubit count threshold where state vector distribution is activated. Below this threshold, simulation is performed as independent (non-distributed) tasks across all MPI processes for optimal performance. Default is 25.</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MGPU_FUSE</span></code></p></td>
+<td><p>positive integer</p></td>
+<td><p>The max number of qubits used for gate fusion. The default value is <code class="code docutils literal notranslate"><span class="pre">6</span></code> if there are more than one MPI processes or <code class="code docutils literal notranslate"><span class="pre">4</span></code> otherwise.</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_MGPU_P2P_DEVICE_BITS</span></code></p></td>
+<td><p>positive integer</p></td>
+<td><p>Specify the number of GPUs that can communicate by using GPUDirect P2P. Default value is 0 (P2P communication is disabled).</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_GPU_FABRIC</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">MNNVL</span></code>, <code class="code docutils literal notranslate"><span class="pre">NVL</span></code>, or <code class="code docutils literal notranslate"><span class="pre">NONE</span></code></p></td>
+<td><p>Automatically set the number of P2P device bits based on the total number of processes when multi-node NVLink (<code class="code docutils literal notranslate"><span class="pre">MNNVL</span></code>) is selected; or the number of processes per node when NVLink (<code class="code docutils literal notranslate"><span class="pre">NVL</span></code>) is selected; or disable P2P (with <code class="code docutils literal notranslate"><span class="pre">NONE</span></code>).</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_GLOBAL_INDEX_BITS</span></code></p></td>
+<td><p>comma-separated list of positive integers</p></td>
+<td><p>Specify the inter-node network structure (faster to slower). For example, assuming a 8 nodes, 4 GPUs/node simulation whereby network communication is faster, this <code class="code docutils literal notranslate"><span class="pre">CUDAQ_GLOBAL_INDEX_BITS</span></code> environment variable can be set to <code class="code docutils literal notranslate"><span class="pre">3,2</span></code>. The first <code class="code docutils literal notranslate"><span class="pre">3</span></code> represents <strong>8</strong> nodes with fast communication and the second <code class="code docutils literal notranslate"><span class="pre">2</span></code> represents <strong>4</strong> 8-node groups in those total 32 nodes. Default is an empty list (no customization based on network structure of the cluster).</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">CUDAQ_HOST_DEVICE_MIGRATION_LEVEL</span></code></p></td>
+<td><p>positive integer</p></td>
+<td><p>Specify host-device memory migration w.r.t. the network structure.</p></td>
+</tr>
+</tbody>
+</table>
+<div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 0.8: </span>The <code class="code docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> target, which is equivalent to the multi-node multi-GPU double-precision option (<code class="code docutils literal notranslate"><span class="pre">mgpu,fp64</span></code>) of the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code>
+is deprecated and will be removed in a future release.</p>
+</div>
+<p>The above configuration options of the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> backend
+can be tuned to reduce your simulation runtimes. One of the
+performance improvements is to fuse multiple gates together during runtime. For
+example, <code class="code docutils literal notranslate"><span class="pre">x(qubit0)</span></code> and <code class="code docutils literal notranslate"><span class="pre">x(qubit1)</span></code> can be fused together into a
+single 4x4 matrix operation on the state vector rather than 2 separate 2x2
+matrix operations on the state vector. This fusion reduces memory bandwidth on
+the GPU because the state vector is transferred into and out of memory fewer
+times. By default, up to 4 gates are fused together for single-GPU simulations,
+and up to 6 gates are fused together for multi-GPU simulations. The number of
+gates fused can <strong>significantly</strong> affect performance of some circuits, so users
+can override the default fusion level by setting the setting <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MGPU_FUSE</span></code>
+environment variable to another integer value as shown below.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_MGPU_FUSE</span><span class="o">=</span><span class="m">5</span><span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>mgpu,fp64
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>--target-option<span class="w"> </span>mgpu,fp64<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+<span class="nv">CUDAQ_MGPU_FUSE</span><span class="o">=</span><span class="m">5</span><span class="w"> </span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>./program.x
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="openmp-cpu-only">
+<span id="id1"></span><h3>OpenMP CPU-only<a class="headerlink" href="#openmp-cpu-only" title="Permalink to this heading">¶</a></h3>
+<p id="qpp-cpu-backend">This target provides a state vector simulator based on the CPU-only, OpenMP threaded <a class="reference external" href="https://github.com/softwareqinc/qpp">Q++</a> library.
+This is the default target when running on CPU-only systems.</p>
+<p>To execute a program on the <code class="code docutils literal notranslate"><span class="pre">qpp-cpu</span></code> target even if a GPU-accelerated backend is available,
+use the following commands:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>qpp-cpu
+</pre></div>
+</div>
+<p>The target can also be defined in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;qpp-cpu&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If a target is set in the application code, this target will override the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> command line flag given during program invocation.</p>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>qpp-cpu<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="clifford-only-simulation-cpu">
+<h3>Clifford-Only Simulation (CPU)<a class="headerlink" href="#clifford-only-simulation-cpu" title="Permalink to this heading">¶</a></h3>
+<p id="stim-backend">This target provides a fast simulator for circuits containing <em>only</em> Clifford
+gates. Any non-Clifford gates (such as T gates and Toffoli gates) are not
+supported. This simulator is based on the <a class="reference external" href="https://github.com/quantumlib/Stim">Stim</a>
+library.</p>
+<p>To execute a program on the <code class="code docutils literal notranslate"><span class="pre">stim</span></code> target, use the following commands:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--5-input--1" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>stim
+</pre></div>
+</div>
+<p>The target can also be defined in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;stim&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If a target is set in the application code, this target will override the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> command line flag given during program invocation.</p>
+</div>
+<input class="tab-input" id="tab-set--5-input--2" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>stim<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+</section>
+<section id="tensor-network-simulators">
+<h2>Tensor Network Simulators<a class="headerlink" href="#tensor-network-simulators" title="Permalink to this heading">¶</a></h2>
+<p id="tensor-backends">CUDA-Q provides a couple of tensor-network simulator targets accelerated with
+the <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> library.
+These backends are available for use from both C++ and Python.</p>
+<p>Tensor network simulators are suitable for large-scale simulation of certain classes of quantum circuits involving many qubits beyond the memory limit of state vector based simulators. For example, computing the expectation value of a Hamiltonian via <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> can be performed efficiently, thanks to <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> contraction optimization capability. On the other hand, conditional circuits, i.e., those with mid-circuit measurements or reset, despite being supported by both backends, may result in poor performance.</p>
+<section id="id2">
+<h3>Multi-node multi-GPU<a class="headerlink" href="#id2" title="Permalink to this heading">¶</a></h3>
+<p>The <code class="code docutils literal notranslate"><span class="pre">tensornet</span></code> backend represents quantum states and circuits as tensor networks in an exact form (no approximation).
+Measurement samples and expectation values are computed via tensor network contractions.
+This backend supports multi-node, multi-GPU distribution of tensor operations required to evaluate and simulate the circuit.</p>
+<p>To execute a program on the <code class="code docutils literal notranslate"><span class="pre">tensornet</span></code> target using a <em>single GPU</em>, use the following commands:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--6-input--1" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>tensornet
+</pre></div>
+</div>
+<p>The target can also be defined in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;tensornet&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If a target is set in the application code, this target will override the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> command line flag given during program invocation.</p>
+</div>
+<input class="tab-input" id="tab-set--6-input--2" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>tensornet<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<p>If you have <em>multiple GPUs</em> available on your system, you can use MPI to automatically distribute parallelization across the visible GPUs.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you installed the CUDA-Q Python wheels, distribution across multiple GPUs is currently not supported for this backend.
+We will add support for it in future releases. For more information, see this <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/issues/920">GitHub issue</a>.</p>
+</div>
+<p>Use the following commands to enable distribution across multiple GPUs (adjust the value of the <code class="code docutils literal notranslate"><span class="pre">-np</span></code> flag as needed to reflect available GPU resources on your system):</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--7-input--1" name="tab-set--7" type="radio"><label class="tab-label" for="tab-set--7-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>tensornet
+</pre></div>
+</div>
+<p>In addition to using MPI in the simulator, you can use it in your application code by installing <a class="reference external" href="https://mpi4py.readthedocs.io/">mpi4py</a>, and
+invoking the program with the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>python3<span class="w"> </span>-m<span class="w"> </span>mpi4py<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>tensornet
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--7-input--2" name="tab-set--7" type="radio"><label class="tab-label" for="tab-set--7-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>tensornet<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+mpiexec<span class="w"> </span>-np<span class="w"> </span><span class="m">2</span><span class="w"> </span>./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If the <code class="code docutils literal notranslate"><span class="pre">CUTENSORNET_COMM_LIB</span></code> environment variable is not set, MPI parallelization on the <code class="code docutils literal notranslate"><span class="pre">tensornet</span></code> backend may fail.
+If you are using a CUDA-Q container, this variable is pre-configured and no additional setup is needed. If you are customizing your installation or have built CUDA-Q from source, please follow the instructions for <a class="reference external" href="https://docs.nvidia.com/cuda/cuquantum/latest/getting-started/index.html#from-nvidia-devzone">activating the distributed interface</a> for the <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> library. This requires
+<a class="reference internal" href="../install/local_installation.html#additional-cuda-tools"><span class="std std-ref">installing CUDA development dependencies</span></a>, and setting the <code class="code docutils literal notranslate"><span class="pre">CUTENSORNET_COMM_LIB</span></code>
+environment variable to the newly built <code class="code docutils literal notranslate"><span class="pre">libcutensornet_distributed_interface_mpi.so</span></code> library.</p>
+</div>
+<p>Specific aspects of the simulation can be configured by setting the following of environment variables:</p>
+<ul class="simple">
+<li><p><strong>`CUDA_VISIBLE_DEVICES=X`</strong>: Makes the process only see GPU X on multi-GPU nodes. Each MPI process must only see its own dedicated GPU. For example, if you run 8 MPI processes on a DGX system with 8 GPUs, each MPI process should be assigned its own dedicated GPU via <code class="code docutils literal notranslate"><span class="pre">CUDA_VISIBLE_DEVICES</span></code> when invoking <code class="code docutils literal notranslate"><span class="pre">mpiexec</span></code> (or <code class="code docutils literal notranslate"><span class="pre">mpirun</span></code>) commands.</p></li>
+<li><p><strong>`OMP_PLACES=cores`</strong>: Set this environment variable to improve CPU parallelization.</p></li>
+<li><p><strong>`OMP_NUM_THREADS=X`</strong>: To enable CPU parallelization, set X to <code class="code docutils literal notranslate"><span class="pre">NUMBER_OF_CORES_PER_NODE/NUMBER_OF_GPUS_PER_NODE</span></code>.</p></li>
+</ul>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This backend requires an NVIDIA GPU and CUDA runtime libraries.
+If you do not have these dependencies installed, you may encounter an error stating <code class="code docutils literal notranslate"><span class="pre">Invalid</span> <span class="pre">simulator</span> <span class="pre">requested</span></code>.
+See the section <a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility"><span class="std std-ref">Dependencies and Compatibility</span></a> for more information about how to install dependencies.</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Setting random seed, via <code class="code docutils literal notranslate"><span class="pre">cudaq::set_random_seed</span></code>, is not supported for this backend due to a limitation of the <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> library. This will be fixed in future release once this feature becomes available.</p>
+</div>
+</section>
+<section id="matrix-product-state">
+<h3>Matrix product state<a class="headerlink" href="#matrix-product-state" title="Permalink to this heading">¶</a></h3>
+<p>The <code class="code docutils literal notranslate"><span class="pre">tensornet-mps</span></code> backend is based on the matrix product state (MPS) representation of the state vector/wave function, exploiting the sparsity in the tensor network via tensor decomposition techniques such as QR and SVD. As such, this backend is an approximate simulator, whereby the number of singular values may be truncated to keep the MPS size tractable.
+The <code class="code docutils literal notranslate"><span class="pre">tensornet-mps</span></code> backend only supports single-GPU simulation. Its approximate nature allows the <code class="code docutils literal notranslate"><span class="pre">tensornet-mps</span></code> backend to handle a large number of qubits for certain classes of quantum circuits on a relatively small memory footprint.</p>
+<p>To execute a program on the <code class="code docutils literal notranslate"><span class="pre">tensornet-mps</span></code> target, use the following commands:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--8-input--1" name="tab-set--8" type="radio"><label class="tab-label" for="tab-set--8-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>--target<span class="w"> </span>tensornet-mps
+</pre></div>
+</div>
+<p>The target can also be defined in the application code by calling</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;tensornet-mps&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If a target is set in the application code, this target will override the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> command line flag given during program invocation.</p>
+</div>
+<input class="tab-input" id="tab-set--8-input--2" name="tab-set--8" type="radio"><label class="tab-label" for="tab-set--8-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>tensornet-mps<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<p>Specific aspects of the simulation can be configured by defining the following environment variables:</p>
+<ul class="simple">
+<li><p><strong>`CUDAQ_MPS_MAX_BOND=X`</strong>: The maximum number of singular values to keep (fixed extent truncation). Default: 64.</p></li>
+<li><p><strong>`CUDAQ_MPS_ABS_CUTOFF=X`</strong>: The cutoff for the largest singular value during truncation. Eigenvalues that are smaller will be trimmed out. Default: 1e-5.</p></li>
+<li><p><strong>`CUDAQ_MPS_RELATIVE_CUTOFF=X`</strong>: The cutoff for the maximal singular value relative to the largest eigenvalue. Eigenvalues that are smaller than this fraction of the largest singular value will be trimmed out. Default: 1e-5</p></li>
+<li><p><strong>`CUDAQ_MPS_SVD_ALGO=X`</strong>: The SVD algorithm to use. Valid values are: <code class="code docutils literal notranslate"><span class="pre">GESVD</span></code> (QR algorithm), <code class="code docutils literal notranslate"><span class="pre">GESVDJ</span></code> (Jacobi method), <code class="code docutils literal notranslate"><span class="pre">GESVDP</span></code> (<a class="reference external" href="https://epubs.siam.org/doi/10.1137/090774999">polar decomposition</a>), <code class="code docutils literal notranslate"><span class="pre">GESVDR</span></code> (<a class="reference external" href="https://epubs.siam.org/doi/10.1137/090771806">randomized methods</a>). Default: <code class="code docutils literal notranslate"><span class="pre">GESVDJ</span></code>.</p></li>
+</ul>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This backend requires an NVIDIA GPU and CUDA runtime libraries.
+If you do not have these dependencies installed, you may encounter an error stating <code class="code docutils literal notranslate"><span class="pre">Invalid</span> <span class="pre">simulator</span> <span class="pre">requested</span></code>.
+See the section <a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility"><span class="std std-ref">Dependencies and Compatibility</span></a> for more information about how to install dependencies.</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Setting random seed, via <code class="code docutils literal notranslate"><span class="pre">cudaq::set_random_seed</span></code>, is not supported for this backend due to a limitation of the <code class="code docutils literal notranslate"><span class="pre">cuTensorNet</span></code> library. This will be fixed in future release once this feature becomes available.</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The parallelism of Jacobi method (the default <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MPS_SVD_ALGO</span></code> setting) gives GPU better performance on small and medium size matrices.
+If you expect a large number of singular values (e.g., increasing the <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MPS_MAX_BOND</span></code> setting), please adjust the <code class="code docutils literal notranslate"><span class="pre">CUDAQ_MPS_SVD_ALGO</span></code> setting accordingly.</p>
+</div>
+</section>
+</section>
+<section id="default-simulator">
+<h2>Default Simulator<a class="headerlink" href="#default-simulator" title="Permalink to this heading">¶</a></h2>
+<p id="id3">If no explicit target is set, i.e., if the code is compiled without any <code class="code docutils literal notranslate"><span class="pre">--target</span></code> flags, then CUDA-Q makes a default choice for the simulator.</p>
+<p>If an NVIDIA GPU and CUDA runtime libraries are available, the default target is set to <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code>. This will utilize the <a class="reference internal" href="#cuquantum-single-gpu"><span class="std std-ref">cuQuantum single-GPU state vector simulator</span></a>.
+On CPU-only systems, the default target is set to <code class="code docutils literal notranslate"><span class="pre">qpp-cpu</span></code> which uses the <a class="reference internal" href="#openmp-cpu-only"><span class="std std-ref">OpenMP CPU-only simulator</span></a>.</p>
+<p>The default simulator can be overridden by the environment variable <code class="code docutils literal notranslate"><span class="pre">CUDAQ_DEFAULT_SIMULATOR</span></code>. If no target is explicitly specified and the environment variable has a valid value, then it will take effect.
+This environment variable can be set to any non-hardware backend. Any invalid value is ignored.</p>
+<p>For CUDA-Q Python API, the environment variable at the time when <code class="code docutils literal notranslate"><span class="pre">cudaq</span></code> module is imported is relevant, not the value of the environment variable at the time when the simulator is invoked.</p>
+<p>For example,</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--9-input--1" name="tab-set--9" type="radio"><label class="tab-label" for="tab-set--9-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_DEFAULT_SIMULATOR</span><span class="o">=</span>density-matrix-cpu<span class="w"> </span>python3<span class="w"> </span>program.py<span class="w"> </span><span class="o">[</span>...<span class="o">]</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--9-input--2" name="tab-set--9" type="radio"><label class="tab-label" for="tab-set--9-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_DEFAULT_SIMULATOR</span><span class="o">=</span>density-matrix-cpu<span class="w"> </span>nvq++<span class="w"> </span>program.cpp<span class="w"> </span><span class="o">[</span>...<span class="o">]</span><span class="w"> </span>-o<span class="w"> </span>program.x
+./program.x
+</pre></div>
+</div>
+</div>
+</div>
+<p>This will use the density matrix simulator target.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>To use targets that require an NVIDIA GPU and CUDA runtime libraries, the dependencies must be installed, else you may encounter an error stating <code class="code docutils literal notranslate"><span class="pre">Invalid</span> <span class="pre">simulator</span> <span class="pre">requested</span></code>. See the section <a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility"><span class="std std-ref">Dependencies and Compatibility</span></a> for more information about how to install dependencies.</p>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="backends.html" class="btn btn-neutral float-left" title="CUDA-Q Backends" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hardware.html" class="btn btn-neutral float-right" title="CUDA-Q Hardware Backends" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/basics/basics.html b/pr-2241/using/basics/basics.html
new file mode 100644
index 0000000000..dd00120b12
--- /dev/null
+++ b/pr-2241/using/basics/basics.html
@@ -0,0 +1,671 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Basics &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="What is a CUDA-Q kernel?" href="kernel_intro.html" />
+    <link rel="prev" title="Quick Start" href="../quick_start.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">CUDA-Q Basics</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/basics/basics.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../quick_start.html" class="btn btn-neutral float-left" title="Quick Start" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="kernel_intro.html" class="btn btn-neutral float-right" title="What is a CUDA-Q kernel?" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-basics">
+<h1>CUDA-Q Basics<a class="headerlink" href="#cuda-q-basics" title="Permalink to this heading">¶</a></h1>
+<div class="toctree-wrapper compound">
+<p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l1"><a class="reference internal" href="build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l1"><a class="reference internal" href="run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../quick_start.html" class="btn btn-neutral float-left" title="Quick Start" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="kernel_intro.html" class="btn btn-neutral float-right" title="What is a CUDA-Q kernel?" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/basics/build_kernel.html b/pr-2241/using/basics/build_kernel.html
new file mode 100644
index 0000000000..77a473edff
--- /dev/null
+++ b/pr-2241/using/basics/build_kernel.html
@@ -0,0 +1,708 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Building your first CUDA-Q Program &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Running your first CUDA-Q Program" href="run_kernel.html" />
+    <link rel="prev" title="What is a CUDA-Q kernel?" href="kernel_intro.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="basics.html">   Basics</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="basics.html">CUDA-Q Basics</a></li>
+      <li class="breadcrumb-item active">Building your first CUDA-Q Program</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/basics/build_kernel.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="kernel_intro.html" class="btn btn-neutral float-left" title="What is a CUDA-Q kernel?" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="run_kernel.html" class="btn btn-neutral float-right" title="Running your first CUDA-Q Program" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="building-your-first-cuda-q-program">
+<h1>Building your first CUDA-Q Program<a class="headerlink" href="#building-your-first-cuda-q-program" title="Permalink to this heading">¶</a></h1>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<p>We can define our quantum kernel as a typical Python function, with the additional use of the
+<code class="code docutils literal notranslate"><span class="pre">&#64;cudaq.kernel</span></code> decorator. Let’s begin with a simple GHZ-state example, producing a state of
+maximal entanglement amongst an allocated set of qubits.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+
+<span class="c1"># Define our kernel.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="c1"># Allocate our qubits.</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="c1"># Place the first qubit in the superposition state.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="c1"># Loop through the allocated qubits and apply controlled-X,</span>
+    <span class="c1"># or CNOT, operations between them.</span>
+    <span class="k">for</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+    <span class="c1"># Measure the qubits.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<p>We can define our quantum kernel as we do any other typed callable in C++, through the use of the
+<code class="code docutils literal notranslate"><span class="pre">__qpu__</span></code> annotation. For the following example, we will define a kernel for a simple GHZ-state as
+a standard free function.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">kernel</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Allocate our qubits.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// Place the first qubit in the superposition state.</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="c1">// Loop through the allocated qubits and apply controlled-X,</span>
+<span class="w">  </span><span class="c1">// or CNOT, operations between them.</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="n">qubit</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">))</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span><span class="w"> </span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="c1">// Measure the qubits.</span>
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>This kernel function can accept any number of arguments, allowing for flexibility in the construction
+of the quantum program. In this case, the <code class="code docutils literal notranslate"><span class="pre">qubit_count</span></code> argument allows us to dynamically control the
+number of qubits allocated to the kernel. As we will see in further <a class="reference internal" href="../examples/examples.html"><span class="doc">examples</span></a>,
+we could also use these arguments to control various parameters of the gates themselves, such as rotation
+angles.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="kernel_intro.html" class="btn btn-neutral float-left" title="What is a CUDA-Q kernel?" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="run_kernel.html" class="btn btn-neutral float-right" title="Running your first CUDA-Q Program" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/basics/kernel_intro.html b/pr-2241/using/basics/kernel_intro.html
new file mode 100644
index 0000000000..e3093ea8a4
--- /dev/null
+++ b/pr-2241/using/basics/kernel_intro.html
@@ -0,0 +1,674 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>What is a CUDA-Q kernel? &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Building your first CUDA-Q Program" href="build_kernel.html" />
+    <link rel="prev" title="CUDA-Q Basics" href="basics.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="basics.html">   Basics</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="basics.html">CUDA-Q Basics</a></li>
+      <li class="breadcrumb-item active">What is a CUDA-Q kernel?</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/basics/kernel_intro.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="basics.html" class="btn btn-neutral float-left" title="CUDA-Q Basics" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="build_kernel.html" class="btn btn-neutral float-right" title="Building your first CUDA-Q Program" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="what-is-a-cuda-q-kernel">
+<h1>What is a CUDA-Q kernel?<a class="headerlink" href="#what-is-a-cuda-q-kernel" title="Permalink to this heading">¶</a></h1>
+<p>Quantum kernels are defined as functions that are executed on a quantum processing unit (QPU) or
+a simulated QPU. They generalize quantum circuits and provide a new abstraction for quantum programming.
+Quantum kernels can be combined with classical functions to create quantum-classical applications
+that can be executed on a heterogeneous system of QPUs, GPUs, and CPUs to solve real-world problems.</p>
+<p><strong>What’s the difference between a quantum kernel and a quantum circuit?</strong></p>
+<p>Every quantum circuit is a kernel, but not every quantum kernel is a circuit. For instance, a quantum
+kernel can be built up from other kernels, allowing us to interpret a large quantum program as a sequence
+of subroutines or subcircuits.</p>
+<p>Moreover, since quantum kernels are functions, there is more expressibility available compared to a
+standard quantum circuit. We can not only parameterize the kernel, but can also contain classical control
+flow statements (<code class="code docutils literal notranslate"><span class="pre">if</span></code>, <code class="code docutils literal notranslate"><span class="pre">for</span></code>, <code class="code docutils literal notranslate"><span class="pre">while</span></code>, etc.), and classical computations such as additions, multiplication, etc.
+Conditional statements on quantum memory and qubit measurements can be included in quantum kernels to enable
+dynamic circuits and fast feedback, particularly useful for quantum error correction. To learn more about what
+language constructs are supported within quantum kernels, take a look at the CUDA-Q
+<a class="reference internal" href="../../specification/cudaq/kernels.html"><span class="doc">specification</span></a>.</p>
+<p><strong>How do I build and run a quantum kernel?</strong></p>
+<p>Once a quantum kernel has been defined in a program, it may be called as a typical function, or can be executed
+using the <code class="code docutils literal notranslate"><span class="pre">sample</span></code> or <code class="code docutils literal notranslate"><span class="pre">observe</span></code> primitives.</p>
+<p>Let’s take a closer look at how to build and execute a quantum kernel with CUDA-Q.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="basics.html" class="btn btn-neutral float-left" title="CUDA-Q Basics" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="build_kernel.html" class="btn btn-neutral float-right" title="Building your first CUDA-Q Program" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/basics/run_kernel.html b/pr-2241/using/basics/run_kernel.html
new file mode 100644
index 0000000000..22eca39852
--- /dev/null
+++ b/pr-2241/using/basics/run_kernel.html
@@ -0,0 +1,995 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Running your first CUDA-Q Program &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Troubleshooting" href="troubleshooting.html" />
+    <link rel="prev" title="Building your first CUDA-Q Program" href="build_kernel.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="basics.html">   Basics</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="basics.html">CUDA-Q Basics</a></li>
+      <li class="breadcrumb-item active">Running your first CUDA-Q Program</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/basics/run_kernel.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="build_kernel.html" class="btn btn-neutral float-left" title="Building your first CUDA-Q Program" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="troubleshooting.html" class="btn btn-neutral float-right" title="Troubleshooting" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="running-your-first-cuda-q-program">
+<h1>Running your first CUDA-Q Program<a class="headerlink" href="#running-your-first-cuda-q-program" title="Permalink to this heading">¶</a></h1>
+<p>Now that you have defined your first quantum kernel, let’s look at different options for how to execute it.
+In CUDA-Q, quantum circuits are stored as quantum kernels. For estimating the probability distribution of
+a measured quantum state in a circuit, we use the <code class="docutils literal notranslate"><span class="pre">sample</span></code> function call, and for computing the
+expectation value of a quantum state with a given observable, we use the <code class="docutils literal notranslate"><span class="pre">observe</span></code> function call.</p>
+<section id="sample">
+<h2>Sample<a class="headerlink" href="#sample" title="Permalink to this heading">¶</a></h2>
+<p>Quantum states collapse upon measurement and hence need to be sampled many times to gather statistics. The CUDA-Q <code class="code docutils literal notranslate"><span class="pre">sample</span></code> call enables this.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<p>The <a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample" title="cudaq.sample"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.sample()</span></code></a> method takes a kernel and its arguments as inputs, and returns a <a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult" title="cudaq.SampleResult"><code class="xref py py-class docutils literal notranslate"><span class="pre">cudaq.SampleResult</span></code></a>.</p>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code> method takes a kernel and its arguments as inputs, and returns a <code class="code docutils literal notranslate"><span class="pre">cudaq::SampleResult</span></code>.</p>
+</div>
+</div>
+<p>This result dictionary contains the distribution of measured states for the system.</p>
+<p>Continuing with the GHZ kernel defined in <a class="reference internal" href="build_kernel.html"><span class="doc">Building Your First CUDA-Q Program</span></a>,
+we will set the concrete value of our <code class="code docutils literal notranslate"><span class="pre">qubit_count</span></code> to be two.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">2</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">))</span>
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">)</span>
+<span class="c1"># Should see a roughly 50/50 distribution between the |00&gt; and</span>
+<span class="c1"># |11&gt; states. Example: {00: 505  11: 495}</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measurement distribution:&quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">results</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">qubit_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result_0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="cm">/* kernel args */</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// Should see a roughly 50/50 distribution between the |00&gt; and</span>
+<span class="w">  </span><span class="c1">// |11&gt; states. Example: {00: 505  11: 495}</span>
+<span class="w">  </span><span class="n">result_0</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The code above can be run like any other program:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<p>Assuming the program is saved in the file <code class="code docutils literal notranslate"><span class="pre">sample.py</span></code>, we can execute is with the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python3 sample.py</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<p>Assuming the program is saved in the file <code class="code docutils literal notranslate"><span class="pre">sample.cpp</span></code>, we can now compile this file with the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> toolchain, and then run the compiled executable.</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ sample.cpp</span>
+<span class="go">./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>By default, <code class="code docutils literal notranslate"><span class="pre">sample</span></code> produces an ensemble of 1000 shots. This can be changed by specifying an integer argument
+for the <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># With an increased shots count, we will still see the same 50/50 distribution,</span>
+<span class="c1"># but now with 10,000 total measurements instead of the default 1000.</span>
+<span class="c1"># Example: {00: 5005  11: 4995}</span>
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">10000</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measurement distribution:&quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">results</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="c1">// With an increased shots count, we will still see the same 50/50</span>
+<span class="w">  </span><span class="c1">// distribution, but now with 10,000 total measurements instead of the default</span>
+<span class="w">  </span><span class="c1">// 1000. Example: {00: 5005  11: 4995}</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">shots_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">10000</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result_1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">shots_count</span><span class="p">,</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">);</span>
+<span class="w">  </span><span class="n">result_1</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Note that there is a subtle difference between how sample is executed with the target device set to a simulator or with the target device set to a QPU. When run on a simulator, the quantum state is built once and then sampled repeatedly, where the number of samples is defined by <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code>. When executed on quantum hardware, the quantum state collapses upon measurement and hence needs to be rebuilt every time to collect a sample.</p>
+<p>A variety of methods can be used to extract useful information from a <code class="code docutils literal notranslate"><span class="pre">SampleResult</span></code>. For example,
+to return the most probable measurement and its respective probability:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">most_probable_result</span> <span class="o">=</span> <span class="n">results</span><span class="o">.</span><span class="n">most_probable</span><span class="p">()</span>
+<span class="n">probability</span> <span class="o">=</span> <span class="n">results</span><span class="o">.</span><span class="n">probability</span><span class="p">(</span><span class="n">most_probable_result</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Most probable result: &quot;</span> <span class="o">+</span> <span class="n">most_probable_result</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measured with probability &quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">probability</span><span class="p">),</span> <span class="n">end</span><span class="o">=</span><span class="s1">&#39;</span><span class="se">\n\n</span><span class="s1">&#39;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>See the <a class="reference internal" href="../../api/languages/python_api.html"><span class="doc">API specification</span></a> for further information.</p>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">result_1</span><span class="p">.</span><span class="n">most_probable</span><span class="p">()</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">// prints: `00`</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">result_1</span><span class="p">.</span><span class="n">probability</span><span class="p">(</span><span class="n">result_1</span><span class="p">.</span><span class="n">most_probable</span><span class="p">())</span>
+<span class="w">            </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span><span class="w"> </span><span class="c1">// prints: `0.5005`</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>See the <a class="reference internal" href="../../api/languages/cpp_api.html"><span class="doc">API specification</span></a> for further information.</p>
+</div>
+</div>
+<p>Sampling a distribution can be a time intensive task. An asynchronous version of sample exists and can be useful to parallelize your application. Asynchronous programming is a technique that enables your program to start a potentially long-running task and still be able to be responsive to other events while that task runs, rather than having to wait until that task has finished. Once that task has finished, your program is presented with the result.</p>
+<p>Asynchronous execution allows to easily parallelize execution of multiple kernels on a multi-processor platform. Such a platform
+is available, for example, by choosing the target <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code>:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--5-input--1" name="tab-set--5" type="radio"><label class="tab-label" for="tab-set--5-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel2</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="c1"># Allocate our qubits.</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="c1"># Place all qubits in a uniform superposition.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+    <span class="c1"># Measure the qubits.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="n">num_gpus</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">num_available_gpus</span><span class="p">()</span>
+<span class="k">if</span> <span class="n">num_gpus</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+    <span class="c1"># Set the target to include multiple virtual QPUs.</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+    <span class="c1"># Asynchronous execution on multiple virtual QPUs, each simulated by an NVIDIA GPU.</span>
+    <span class="n">result_1</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                                  <span class="n">qubit_count</span><span class="p">,</span>
+                                  <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">,</span>
+                                  <span class="n">qpu_id</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+    <span class="n">result_2</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel2</span><span class="p">,</span>
+                                  <span class="n">qubit_count</span><span class="p">,</span>
+                                  <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">,</span>
+                                  <span class="n">qpu_id</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+<span class="k">else</span><span class="p">:</span>
+    <span class="c1"># Schedule for execution on the same virtual QPU.</span>
+    <span class="n">result_1</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                                  <span class="n">qubit_count</span><span class="p">,</span>
+                                  <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">,</span>
+                                  <span class="n">qpu_id</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+    <span class="n">result_2</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel2</span><span class="p">,</span>
+                                  <span class="n">qubit_count</span><span class="p">,</span>
+                                  <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">,</span>
+                                  <span class="n">qpu_id</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measurement distribution for kernel:&quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">result_1</span><span class="o">.</span><span class="n">get</span><span class="p">()))</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measurement distribution for kernel2:&quot;</span> <span class="o">+</span> <span class="nb">str</span><span class="p">(</span><span class="n">result_2</span><span class="o">.</span><span class="n">get</span><span class="p">()))</span>
+</pre></div>
+</div>
+</div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This kind of parallelization is most effective
+if you actually have multiple QPU or CPU available. Otherwise, the
+sampling will still have to execute sequentially due to resource constraints.</p>
+</div>
+<p>More information about parallelizing execution can be found at <a class="reference internal" href="../backends/platform.html"><span class="doc">Multi-Processor Platforms</span></a> page.</p>
+</section>
+<section id="observe">
+<h2>Observe<a class="headerlink" href="#observe" title="Permalink to this heading">¶</a></h2>
+<p>The observe function allows us to calculate expectation values for a defined quantum operator, that is the value of <span class="math notranslate nohighlight">\(\bra{\psi}H\ket{\psi}\)</span>, where <span class="math notranslate nohighlight">\(H\)</span> is the desired operator and <span class="math notranslate nohighlight">\(\ket{\psi}\)</span> is the quantum state after executing a given kernel.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--6-input--1" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--1">Python</label><div class="tab-content docutils">
+<p>The <a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe" title="cudaq.observe"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.observe()</span></code></a> method takes a kernel and its arguments as inputs, along with a <a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator" title="cudaq.SpinOperator"><code class="xref py py-class docutils literal notranslate"><span class="pre">cudaq.SpinOperator</span></code></a>.</p>
+<p>Using the <code class="code docutils literal notranslate"><span class="pre">cudaq.spin</span></code> module, operators may be defined as a linear combination of Pauli strings. Functions, such
+as <a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i" title="cudaq.spin.i"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.spin.i()</span></code></a>, <a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x" title="cudaq.spin.x"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.spin.x()</span></code></a>, <a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y" title="cudaq.spin.y"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.spin.y()</span></code></a>, <a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z" title="cudaq.spin.z"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.spin.z()</span></code></a> may be used to construct more
+complex spin Hamiltonians on multiple qubits.</p>
+</div>
+<input class="tab-input" id="tab-set--6-input--2" name="tab-set--6" type="radio"><label class="tab-label" for="tab-set--6-input--2">C++</label><div class="tab-content docutils">
+<p>The <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code> method takes a kernel and its arguments as inputs, along with a <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code>.</p>
+<p>Within the <code class="code docutils literal notranslate"><span class="pre">cudaq::spin</span></code> namespace, operators may be defined as a linear combination of Pauli strings. Functions, such
+as <code class="code docutils literal notranslate"><span class="pre">cudaq::spin::i</span></code>, <code class="code docutils literal notranslate"><span class="pre">cudaq::spin::x</span></code>, <code class="code docutils literal notranslate"><span class="pre">cudaq::spin::y</span></code>, <code class="code docutils literal notranslate"><span class="pre">cudaq::spin::z</span></code> may be used to construct more
+complex spin Hamiltonians on multiple qubits.</p>
+</div>
+</div>
+<p>Below is an example of a spin operator object consisting of a <code class="code docutils literal notranslate"><span class="pre">Z(0)</span></code> operator, or a Pauli Z-operator on the qubit zero.
+This is followed by the construction of a kernel with a single qubit in an equal superposition.
+The Hamiltonian is printed to confirm it has been constructed properly.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--7-input--1" name="tab-set--7" type="radio"><label class="tab-label" for="tab-set--7-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="n">operator</span> <span class="o">=</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">operator</span><span class="p">)</span>  <span class="c1"># prints: [1+0j] Z</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--7-input--2" name="tab-set--7" type="radio"><label class="tab-label" for="tab-set--7-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+
+<span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">kernel</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">qubit</span><span class="p">;</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">spin_operator</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// Prints: [1+0j] Z</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">spin_operator</span><span class="p">.</span><span class="n">to_string</span><span class="p">()</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The <code class="code docutils literal notranslate"><span class="pre">observe</span></code> function takes a kernel, any kernel arguments, and a spin operator as inputs and produces an <code class="code docutils literal notranslate"><span class="pre">ObserveResult</span></code> object.
+The expectation value can be printed using the <code class="code docutils literal notranslate"><span class="pre">expectation</span></code> method.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>It is important to exclude a measurement in the kernel, otherwise the expectation value will be determined from a collapsed
+classical state. For this example, the expected result of 0.0 is produced.</p>
+</div>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--8-input--1" name="tab-set--8" type="radio"><label class="tab-label" for="tab-set--8-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">operator</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">())</span>  <span class="c1"># prints: 0.0</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--8-input--2" name="tab-set--8" type="radio"><label class="tab-label" for="tab-set--8-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result_0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">spin_operator</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// Expectation value of kernel with respect to single `Z` term</span>
+<span class="w">  </span><span class="c1">// should print: 0.0</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;&lt;kernel | spin_operator | kernel&gt; = &quot;</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">result_0</span><span class="p">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="w">            </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Unlike <code class="code docutils literal notranslate"><span class="pre">sample</span></code>, the default <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code> for <code class="code docutils literal notranslate"><span class="pre">observe</span></code> is 1. This result is deterministic and equivalent to the
+expectation value in the limit of infinite shots.  To produce an approximate expectation value from sampling, <code class="code docutils literal notranslate"><span class="pre">shots_count</span></code> can
+be specified to any integer.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--9-input--1" name="tab-set--9" type="radio"><label class="tab-label" for="tab-set--9-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">operator</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">())</span>  <span class="c1"># prints non-zero value</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--9-input--2" name="tab-set--9" type="radio"><label class="tab-label" for="tab-set--9-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result_1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="mi">1000</span><span class="p">,</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">spin_operator</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// Expectation value of kernel with respect to single `Z` term,</span>
+<span class="w">  </span><span class="c1">// but instead of a single deterministic execution of the kernel,</span>
+<span class="w">  </span><span class="c1">// we sample over 1000 shots. We should now print an expectation</span>
+<span class="w">  </span><span class="c1">// value that is close to, but not quite, zero.</span>
+<span class="w">  </span><span class="c1">// Example: 0.025</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;&lt;kernel | spin_operator | kernel&gt; = &quot;</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">result_1</span><span class="p">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="w">            </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Similar to <code class="code docutils literal notranslate"><span class="pre">sample_async</span></code> above, observe also supports asynchronous execution.
+More information about parallelizing execution can be found at
+<a class="reference internal" href="../backends/platform.html"><span class="doc">Multi-Processor Platforms</span></a> page.</p>
+</section>
+<section id="running-on-a-gpu">
+<h2>Running on a GPU<a class="headerlink" href="#running-on-a-gpu" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--10-input--1" name="tab-set--10" type="radio"><label class="tab-label" for="tab-set--10-input--1">Python</label><div class="tab-content docutils">
+<p>Using <a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target" title="cudaq.set_target"><code class="xref py py-func docutils literal notranslate"><span class="pre">cudaq.set_target()</span></code></a>, different targets can be specified for kernel execution.</p>
+</div>
+<input class="tab-input" id="tab-set--10-input--2" name="tab-set--10" type="radio"><label class="tab-label" for="tab-set--10-input--2">C++</label><div class="tab-content docutils">
+<p>Using the <code class="code docutils literal notranslate"><span class="pre">--target</span></code> argument to <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code>, different targets can be specified for kernel execution.</p>
+</div>
+</div>
+<p>If a local GPU is detected, the target will default to <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code>. Otherwise, the CPU-based simulation
+target, <code class="code docutils literal notranslate"><span class="pre">qpp-cpu</span></code>,  will be selected.</p>
+<p>We will demonstrate the benefits of using a GPU by sampling our GHZ kernel with 25 qubits and a
+<code class="code docutils literal notranslate"><span class="pre">shots_count</span></code> of 1 million. Using a GPU accelerates this task by more than 35x. To learn about
+all of the available targets and ways to accelerate kernel execution, visit the
+<a class="reference internal" href="../backends/backends.html"><span class="doc">Backends</span></a> page.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--11-input--1" name="tab-set--11" type="radio"><label class="tab-label" for="tab-set--11-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">sys</span>
+<span class="kn">import</span> <span class="nn">timeit</span>
+
+<span class="c1"># Will time the execution of our sample call.</span>
+<span class="n">code_to_time</span> <span class="o">=</span> <span class="s1">&#39;cudaq.sample(kernel, qubit_count, shots_count=1000000)&#39;</span>
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="k">if</span> <span class="mi">1</span> <span class="o">&lt;</span> <span class="nb">len</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">)</span> <span class="k">else</span> <span class="mi">25</span>
+
+<span class="c1"># Execute on CPU backend.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;qpp-cpu&#39;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;CPU time&#39;</span><span class="p">)</span>  <span class="c1"># Example: 27.57462 s.</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">timeit</span><span class="o">.</span><span class="n">timeit</span><span class="p">(</span><span class="n">stmt</span><span class="o">=</span><span class="n">code_to_time</span><span class="p">,</span> <span class="nb">globals</span><span class="o">=</span><span class="nb">globals</span><span class="p">(),</span> <span class="n">number</span><span class="o">=</span><span class="mi">1</span><span class="p">))</span>
+
+<span class="k">if</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">num_available_gpus</span><span class="p">()</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+    <span class="c1"># Execute on GPU backend.</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;nvidia&#39;</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;GPU time&#39;</span><span class="p">)</span>  <span class="c1"># Example: 0.773286 s.</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">timeit</span><span class="o">.</span><span class="n">timeit</span><span class="p">(</span><span class="n">stmt</span><span class="o">=</span><span class="n">code_to_time</span><span class="p">,</span> <span class="nb">globals</span><span class="o">=</span><span class="nb">globals</span><span class="p">(),</span> <span class="n">number</span><span class="o">=</span><span class="mi">1</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--11-input--2" name="tab-set--11" type="radio"><label class="tab-label" for="tab-set--11-input--2">C++</label><div class="tab-content docutils">
+<p>To compare the performance, we can create a simple timing script that isolates just the call
+to <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code>. We are still using the same GHZ kernel as earlier, but the following
+modification made to the main function:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">argc</span><span class="p">,</span><span class="w"> </span><span class="kt">char</span><span class="w"> </span><span class="o">*</span><span class="n">argv</span><span class="p">[])</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">qubit_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">argc</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="n">atoi</span><span class="p">(</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="mi">25</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">shots_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1000000</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">start</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">chrono</span><span class="o">::</span><span class="n">high_resolution_clock</span><span class="o">::</span><span class="n">now</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Timing just the sample execution.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">shots_count</span><span class="p">,</span><span class="w"> </span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">stop</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">chrono</span><span class="o">::</span><span class="n">high_resolution_clock</span><span class="o">::</span><span class="n">now</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">duration</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">chrono</span><span class="o">::</span><span class="n">duration</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="p">(</span><span class="n">stop</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">start</span><span class="p">);</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;It took &quot;</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">duration</span><span class="p">.</span><span class="n">count</span><span class="p">()</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot; seconds.</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>First we execute on the CPU backend:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ --target=qpp-cpu sample.cpp</span>
+<span class="go">./a.out</span>
+</pre></div>
+</div>
+<p>seeing an output of the order:
+<code class="docutils literal notranslate"><span class="pre">It</span> <span class="pre">took</span> <span class="pre">22.8337</span> <span class="pre">seconds.</span></code></p>
+<p>Now we can execute on the GPU enabled backend:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ --target=nvidia sample.cpp</span>
+<span class="go">./a.out</span>
+</pre></div>
+</div>
+<p>seeing an output of the order:
+<code class="docutils literal notranslate"><span class="pre">It</span> <span class="pre">took</span> <span class="pre">3.18988</span> <span class="pre">seconds.</span></code></p>
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="build_kernel.html" class="btn btn-neutral float-left" title="Building your first CUDA-Q Program" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="troubleshooting.html" class="btn btn-neutral float-right" title="Troubleshooting" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/basics/troubleshooting.html b/pr-2241/using/basics/troubleshooting.html
new file mode 100644
index 0000000000..d35cd1decf
--- /dev/null
+++ b/pr-2241/using/basics/troubleshooting.html
@@ -0,0 +1,692 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Troubleshooting &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="CUDA-Q by Example" href="../examples/examples.html" />
+    <link rel="prev" title="Running your first CUDA-Q Program" href="run_kernel.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="basics.html">   Basics</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="basics.html">CUDA-Q Basics</a></li>
+      <li class="breadcrumb-item active">Troubleshooting</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/basics/troubleshooting.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="run_kernel.html" class="btn btn-neutral float-left" title="Running your first CUDA-Q Program" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../examples/examples.html" class="btn btn-neutral float-right" title="CUDA-Q by Example" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="troubleshooting">
+<h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this heading">¶</a></h1>
+<section id="debugging-and-verbose-simulation-output">
+<h2>Debugging and Verbose Simulation Output<a class="headerlink" href="#debugging-and-verbose-simulation-output" title="Permalink to this heading">¶</a></h2>
+<p>One helpful mechanism of debugging CUDA-Q simulation execution is
+the <code class="code docutils literal notranslate"><span class="pre">CUDAQ_LOG_LEVEL</span></code> environment variable. For any CUDA-Q
+executable, just prepend this and turn it on:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_LOG_LEVEL</span><span class="o">=</span>info<span class="w"> </span>python3<span class="w"> </span>file.py
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_LOG_LEVEL</span><span class="o">=</span>info<span class="w"> </span>./a.out
+</pre></div>
+</div>
+</div>
+</div>
+<p>Similarly, one may write the IR to their console or to a file before remote
+submission. This may be done through the <code class="code docutils literal notranslate"><span class="pre">CUDAQ_DUMP_JIT_IR</span></code> environment
+variable. For any CUDA-Q executable, just prepend as follows:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_DUMP_JIT_IR</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>python3<span class="w"> </span>file.py
+<span class="c1"># or</span>
+<span class="nv">CUDAQ_DUMP_JIT_IR</span><span class="o">=</span>&lt;output_filename&gt;<span class="w"> </span>python3<span class="w"> </span>file.py
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_DUMP_JIT_IR</span><span class="o">=</span><span class="m">1</span><span class="w"> </span>./a.out
+<span class="c1"># or</span>
+<span class="nv">CUDAQ_DUMP_JIT_IR</span><span class="o">=</span>&lt;output_filename&gt;<span class="w"> </span>./a.out
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="run_kernel.html" class="btn btn-neutral float-left" title="Running your first CUDA-Q Program" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../examples/examples.html" class="btn btn-neutral float-right" title="CUDA-Q by Example" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/bernstein_vazirani.html b/pr-2241/using/examples/bernstein_vazirani.html
new file mode 100644
index 0000000000..f5011cd3f7
--- /dev/null
+++ b/pr-2241/using/examples/bernstein_vazirani.html
@@ -0,0 +1,831 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Bernstein-Vazirani &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Variational Quantum Eigensolver" href="vqe.html" />
+    <link rel="prev" title="Multi-GPU Workflows" href="multi_gpu_workflows.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Bernstein-Vazirani</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/bernstein_vazirani.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="multi_gpu_workflows.html" class="btn btn-neutral float-left" title="Multi-GPU Workflows" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="vqe.html" class="btn btn-neutral float-right" title="Variational Quantum Eigensolver" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="bernstein-vazirani">
+<h1>Bernstein-Vazirani<a class="headerlink" href="#bernstein-vazirani" title="Permalink to this heading">¶</a></h1>
+<p>The Bernstein-Vazirani algorithm aims to identify the bitstring encoded in a given function.</p>
+<p>For the original source of this algorithm, see
+<a class="reference external" href="https://epubs.siam.org/doi/10.1137/S0097539796300921">this publication</a>.</p>
+<p>In this example, we generate a random bitstring and encode it into an inner-product oracle,
+and define a kernel for the Bernstein-Vazirani algorithm.  Then, we simulate the kernel and return the most probable bitstring from its execution.</p>
+<p>If all goes well, the state measured with the highest probability should be our hidden bitstring!</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">random</span>
+
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+
+<span class="k">def</span> <span class="nf">random_bits</span><span class="p">(</span><span class="n">length</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">bitset</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">length</span><span class="p">):</span>
+        <span class="n">bitset</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">))</span>
+    <span class="k">return</span> <span class="n">bitset</span>
+
+
+<span class="c1"># If you have a NVIDIA GPU you can use this example to see</span>
+<span class="c1"># that the GPU-accelerated backends can easily handle a</span>
+<span class="c1"># larger number of qubits compared the CPU-only backend.</span>
+
+<span class="c1"># Depending on the available memory on your GPU, you can</span>
+<span class="c1"># set the number of qubits to around 30 qubits, and un-comment</span>
+<span class="c1"># the `cudaq.set_target(nvidia)` line.</span>
+
+<span class="c1"># Note: Without setting the target to the `nvidia` backend,</span>
+<span class="c1"># there will be a noticeable decrease in simulation performance.</span>
+<span class="c1"># This is because the CPU-only backend has difficulty handling</span>
+<span class="c1"># 30+ qubit simulations.</span>
+
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">5</span>  <span class="c1"># set to around 30 qubits for `nvidia` target</span>
+<span class="c1"># ```</span>
+<span class="c1"># cudaq.set_target(&quot;nvidia&quot;)</span>
+<span class="c1"># ```</span>
+
+<span class="c1"># Generate a random, hidden bitstring for the oracle</span>
+<span class="c1"># to encode. Note: we define the bitstring here so</span>
+<span class="c1"># as to be able to return it for verification.</span>
+<span class="n">hidden_bits</span> <span class="o">=</span> <span class="n">random_bits</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">oracle</span><span class="p">(</span><span class="n">register</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qview</span><span class="p">,</span> <span class="n">auxillary_qubit</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">,</span>
+           <span class="n">hidden_bits</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+    <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">bit</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">hidden_bits</span><span class="p">):</span>
+        <span class="k">if</span> <span class="n">bit</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="c1"># apply a `cx` gate with the current qubit as</span>
+            <span class="c1"># the control and the auxillary qubit as the target.</span>
+            <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">register</span><span class="p">[</span><span class="n">index</span><span class="p">],</span> <span class="n">auxillary_qubit</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">bernstein_vazirani</span><span class="p">(</span><span class="n">hidden_bits</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]):</span>
+    <span class="c1"># Allocate the specified number of qubits - this</span>
+    <span class="c1"># corresponds to the length of the hidden bitstring.</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">hidden_bits</span><span class="p">))</span>
+    <span class="c1"># Allocate an extra auxillary qubit.</span>
+    <span class="n">auxillary_qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+    <span class="c1"># Prepare the auxillary qubit.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">auxillary_qubit</span><span class="p">)</span>
+    <span class="n">z</span><span class="p">(</span><span class="n">auxillary_qubit</span><span class="p">)</span>
+
+    <span class="c1"># Place the rest of the register in a superposition state.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+    <span class="c1"># Query the oracle.</span>
+    <span class="n">oracle</span><span class="p">(</span><span class="n">qubits</span><span class="p">,</span> <span class="n">auxillary_qubit</span><span class="p">,</span> <span class="n">hidden_bits</span><span class="p">)</span>
+
+    <span class="c1"># Apply another set of Hadamards to the register.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+    <span class="c1"># Apply measurement gates to just the `qubits`</span>
+    <span class="c1"># (excludes the auxillary qubit).</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+
+<span class="nb">print</span><span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="n">bernstein_vazirani</span><span class="p">,</span> <span class="n">hidden_bits</span><span class="p">))</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">bernstein_vazirani</span><span class="p">,</span> <span class="n">hidden_bits</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;encoded bitstring = </span><span class="si">{</span><span class="n">hidden_bits</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;measured state = </span><span class="si">{</span><span class="n">result</span><span class="o">.</span><span class="n">most_probable</span><span class="p">()</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span>
+    <span class="sa">f</span><span class="s2">&quot;Were we successful? </span><span class="si">{</span><span class="s1">&#39;&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">([</span><span class="nb">str</span><span class="p">(</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="ow">in</span><span class="w"> </span><span class="n">hidden_bits</span><span class="p">])</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">most_probable</span><span class="p">()</span><span class="si">}</span><span class="s2">&quot;</span>
+<span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+
+<span class="c1">// If you have a NVIDIA GPU you can use this example to see</span>
+<span class="c1">// that the GPU-accelerated backends can easily handle a</span>
+<span class="c1">// larger number of qubits compared the CPU-only backend.</span>
+
+<span class="c1">// Depending on the available memory on your GPU, you can</span>
+<span class="c1">// set the number of qubits to around 30 qubits, and set the</span>
+<span class="c1">// `--target=nvidia` from the command line.</span>
+
+<span class="c1">// Note: Without setting the target to the `nvidia` backend,</span>
+<span class="c1">// there will be a noticeable decrease in simulation performance.</span>
+<span class="c1">// This is because the CPU-only backend has difficulty handling</span>
+<span class="c1">// 30+ qubit simulations.</span>
+
+<span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="n">random_bitstring</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="n">vector_of_bits</span><span class="p">;</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="c1">// Populate our vector of bits with random binary</span>
+<span class="w">    </span><span class="c1">// values (base 2).</span>
+<span class="w">    </span><span class="n">vector_of_bits</span><span class="p">.</span><span class="n">push_back</span><span class="p">(</span><span class="n">rand</span><span class="p">()</span><span class="w"> </span><span class="o">%</span><span class="w"> </span><span class="mi">2</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="n">vector_of_bits</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">oracle</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qview</span><span class="o">&lt;&gt;</span><span class="w"> </span><span class="n">qvector</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">auxillary_qubit</span><span class="p">,</span>
+<span class="w">                    </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">hidden_bitstring</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">hidden_bitstring</span><span class="p">.</span><span class="n">size</span><span class="p">();</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">hidden_bitstring</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
+<span class="w">      </span><span class="c1">// Apply a `cx` gate with the current qubit as</span>
+<span class="w">      </span><span class="c1">// the control and the auxillary qubit as the target.</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">auxillary_qubit</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">bernstein_vazirani</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">hidden_bitstring</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Allocate the specified number of qubits - this</span>
+<span class="w">  </span><span class="c1">// corresponds to the length of the hidden bitstring.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">qvector</span><span class="p">(</span><span class="n">hidden_bitstring</span><span class="p">.</span><span class="n">size</span><span class="p">());</span>
+<span class="w">  </span><span class="c1">// Allocate an extra auxillary qubit.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">auxillary_qubit</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Prepare the auxillary qubit.</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">auxillary_qubit</span><span class="p">);</span>
+<span class="w">  </span><span class="n">z</span><span class="p">(</span><span class="n">auxillary_qubit</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Place the rest of the qubits in a superposition state.</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Query the oracle.</span>
+<span class="w">  </span><span class="n">oracle</span><span class="p">(</span><span class="n">qvector</span><span class="p">,</span><span class="w"> </span><span class="n">auxillary_qubit</span><span class="p">,</span><span class="w"> </span><span class="n">hidden_bitstring</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Apply another set of Hadamards to the qubits.</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Apply measurement gates to just the `qubits`</span>
+<span class="w">  </span><span class="c1">// (excludes the auxillary qubit).</span>
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Note: this algorithm will require an additional ancillary qubit.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">qubit_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">5</span><span class="p">;</span><span class="w"> </span><span class="c1">// set to around 30 qubits for `nvidia` target</span>
+
+<span class="w">  </span><span class="c1">// Generate a bitstring to encode and recover with our algorithm.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">hidden_bitstring</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">random_bitstring</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">bernstein_vazirani</span><span class="p">,</span><span class="w"> </span><span class="n">hidden_bitstring</span><span class="p">);</span>
+<span class="w">  </span><span class="n">result</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;Encoded bitstring = &quot;</span><span class="p">;</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="n">bit</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">hidden_bitstring</span><span class="p">)</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">bit</span><span class="p">;</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;Measured bitstring = &quot;</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">result</span><span class="p">.</span><span class="n">most_probable</span><span class="p">()</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
+
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="multi_gpu_workflows.html" class="btn btn-neutral float-left" title="Multi-GPU Workflows" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="vqe.html" class="btn btn-neutral float-right" title="Variational Quantum Eigensolver" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/cuquantum.html b/pr-2241/using/examples/cuquantum.html
new file mode 100644
index 0000000000..278dcb23bf
--- /dev/null
+++ b/pr-2241/using/examples/cuquantum.html
@@ -0,0 +1,748 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Simulations with cuQuantum &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Noisy Simulation" href="noisy_simulation.html" />
+    <link rel="prev" title="Quantum Approximate Optimization Algorithm" href="qaoa.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Simulations with cuQuantum</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/cuquantum.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="qaoa.html" class="btn btn-neutral float-left" title="Quantum Approximate Optimization Algorithm" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="noisy_simulation.html" class="btn btn-neutral float-right" title="Noisy Simulation" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="simulations-with-cuquantum">
+<h1>Simulations with cuQuantum<a class="headerlink" href="#simulations-with-cuquantum" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q provides support for cuQuantum-accelerated state vector and tensor network
+simulations. Let’s take a look at an example that is too large for a standard CPU-only simulator, but
+can be trivially simulated via a NVIDIA GPU-accelerated backend:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># This example is meant to demonstrate the cuQuantum</span>
+<span class="c1"># GPU-accelerated backends and their ability to easily handle</span>
+<span class="c1"># a larger number of qubits compared the CPU-only backend.</span>
+<span class="c1">#</span>
+<span class="c1"># This will take a noticeably longer time to execute on</span>
+<span class="c1"># CPU-only backends.</span>
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">5</span>
+<span class="c1"># We can set a larger `qubit_count` if running on a GPU backend.</span>
+<span class="c1"># qubit_count = 28</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+    <span class="k">for</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span> <span class="o">-</span> <span class="mi">1</span><span class="p">):</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">100</span><span class="p">)</span>
+
+<span class="k">if</span> <span class="p">(</span><span class="ow">not</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">is_initialized</span><span class="p">())</span> <span class="ow">or</span> <span class="p">(</span><span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">rank</span><span class="p">()</span> <span class="o">==</span> <span class="mi">0</span><span class="p">):</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Here we generate a GHZ state on 28 qubits. The built-in cuQuantum state vector
+backend is selected by default if a local GPU is present. Alternatively, the
+target may be manually set through the <code class="code docutils literal notranslate"><span class="pre">cudaq.set_target(&quot;nvidia&quot;)</span></code> command.</p>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ cuquantum_backends.cpp -o dyn.x --target nvidia &amp;&amp; ./dyn.x</span>
+<span class="c1">// ```</span>
+
+<span class="c1">// This example is meant to demonstrate the cuQuantum</span>
+<span class="c1">// GPU-accelerated backends and their ability to easily handle</span>
+<span class="c1">// a larger number of qubits compared the CPU-only backend.</span>
+
+<span class="c1">// On CPU-only backends, this seems to hang, i.e., it takes a long</span>
+<span class="c1">// time to handle this number of qubits.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// Define a quantum kernel with a runtime parameter</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()(</span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">N</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">    </span><span class="c1">// Dynamically sized vector of qubits</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="n">N</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">shots_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1024</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="mi">1024</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">shots_count</span><span class="p">,</span><span class="w"> </span><span class="n">ghz</span><span class="p">{},</span><span class="w"> </span><span class="mi">28</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">is_initialized</span><span class="p">()</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">rank</span><span class="p">()</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">    </span><span class="c1">// Fine grain access to the bits and counts</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Observed: %s, %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">.</span><span class="n">data</span><span class="p">(),</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Here we generate a GHZ state on 28 qubits. To run with the built-in cuQuantum state
+vector support, we pass the <code class="code docutils literal notranslate"><span class="pre">--target</span> <span class="pre">nvidia</span></code> flag at compile time:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>--target<span class="w"> </span>nvidia<span class="w"> </span>cuquantum_backends.cpp<span class="w"> </span>-o<span class="w"> </span>ghz.x
+./ghz.x
+</pre></div>
+</div>
+<p>Alternatively, we can set the environment variable <code class="code docutils literal notranslate"><span class="pre">CUDAQ_DEFAULT_SIMULATOR</span></code> to <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code>.</p>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="qaoa.html" class="btn btn-neutral float-left" title="Quantum Approximate Optimization Algorithm" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="noisy_simulation.html" class="btn btn-neutral float-right" title="Noisy Simulation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/examples.html b/pr-2241/using/examples/examples.html
new file mode 100644
index 0000000000..805cce55ea
--- /dev/null
+++ b/pr-2241/using/examples/examples.html
@@ -0,0 +1,671 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q by Example &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Introduction" href="introduction.html" />
+    <link rel="prev" title="Troubleshooting" href="../basics/troubleshooting.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">CUDA-Q by Example</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/examples.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../basics/troubleshooting.html" class="btn btn-neutral float-left" title="Troubleshooting" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="introduction.html" class="btn btn-neutral float-right" title="Introduction" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-by-example">
+<h1>CUDA-Q by Example<a class="headerlink" href="#cuda-q-by-example" title="Permalink to this heading">¶</a></h1>
+<p>Examples that illustrate how to use CUDA-Q for application development are available in C++ and Python.</p>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a></li>
+<li class="toctree-l1"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a></li>
+<li class="toctree-l1"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l1"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a></li>
+<li class="toctree-l1"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l1"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l1"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l1"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a></li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../basics/troubleshooting.html" class="btn btn-neutral float-left" title="Troubleshooting" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="introduction.html" class="btn btn-neutral float-right" title="Introduction" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/expectation_values.html b/pr-2241/using/examples/expectation_values.html
new file mode 100644
index 0000000000..6e12f77e47
--- /dev/null
+++ b/pr-2241/using/examples/expectation_values.html
@@ -0,0 +1,816 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Computing Expectation Values &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Multi-control Synthesis" href="multi_control.html" />
+    <link rel="prev" title="Visualization" href="../../examples/python/tutorials/visualization.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Computing Expectation Values</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/expectation_values.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../../examples/python/tutorials/visualization.html" class="btn btn-neutral float-left" title="Visualization" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="multi_control.html" class="btn btn-neutral float-right" title="Multi-control Synthesis" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="computing-expectation-values">
+<h1>Computing Expectation Values<a class="headerlink" href="#computing-expectation-values" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q provides generic library functions enabling one to compute expectation values
+of quantum spin operators with respect to a parameterized CUDA-Q kernel. Let’s take a look
+at an example of this:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># The example here shows a simple use case for the `cudaq::observe``</span>
+<span class="c1"># function in computing expected values of provided spin operators.</span>
+
+<span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">theta</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="n">spin_operator</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span>
+    <span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+
+<span class="c1"># Pre-computed angle that minimizes the energy expectation of the `spin_operator`.</span>
+<span class="n">angle</span> <span class="o">=</span> <span class="mf">0.59</span>
+
+<span class="n">energy</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">spin_operator</span><span class="p">,</span> <span class="n">angle</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Energy is </span><span class="si">{</span><span class="n">energy</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Here we define a parameterized CUDA-Q kernel that takes an angle, <code class="code docutils literal notranslate"><span class="pre">theta</span></code>, as a single
+input. This angle becomes the argument of a single <code class="code docutils literal notranslate"><span class="pre">ry</span></code> rotation.</p>
+<p>We define a Hamiltonian operator via the CUDA-Q <code class="code docutils literal notranslate"><span class="pre">cudaq.SpinOperator</span></code> type.</p>
+<p>CUDA-Q provides a generic function <code class="code docutils literal notranslate"><span class="pre">cudaq.observe</span></code>. This function takes as input three
+arguments. The first two argument are a parameterized kernel and the <code class="code docutils literal notranslate"><span class="pre">cudaq.SpinOperator</span></code> whose
+expectation value we wish to compute. The final arguments are the runtime parameters at which we
+evaluate the parameterized kernel.</p>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ expectation_values.cpp -o d2.x &amp;&amp; ./d2.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+
+<span class="c1">// The example here shows a simple use case for the `cudaq::observe`</span>
+<span class="c1">// function in computing expected values of provided spin_ops.</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">ansatz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()(</span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// Build up your spin op algebraically</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">                     </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Observe takes the kernel, the spin_op, and the concrete</span>
+<span class="w">  </span><span class="c1">// parameters for the kernel</span>
+<span class="w">  </span><span class="kt">double</span><span class="w"> </span><span class="n">energy</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">{},</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="mf">.59</span><span class="p">);</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Energy is %lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">energy</span><span class="p">);</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Here we define a parameterized CUDA-Q kernel, a callable type named <code class="code docutils literal notranslate"><span class="pre">ansatz</span></code> that takes as
+input a single angle <code class="code docutils literal notranslate"><span class="pre">theta</span></code>. This angle becomes the argument of a single <code class="code docutils literal notranslate"><span class="pre">ry</span></code> rotation.</p>
+<p>In host code, we define a Hamiltonian operator via the CUDA-Q <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> type.
+CUDA-Q provides a generic function <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code>. This function takes as input three terms.
+The first two terms are a parameterized kernel and the <code class="code docutils literal notranslate"><span class="pre">spin_op</span></code> whose expectation value we wish to compute.
+The last term contains the runtime parameters at which we evaluate the parameterized kernel.</p>
+<p>The return type of this function is an <code class="code docutils literal notranslate"><span class="pre">cudaq::observe_result</span></code> which contains all the data
+from the execution, but is trivially convertible to a double, resulting in the expectation value we are interested in.</p>
+<p>To compile and execute this code, we run the following:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>expectation_values.cpp<span class="w"> </span>-o<span class="w"> </span>exp_vals.x
+./exp_vals.x
+</pre></div>
+</div>
+</div>
+</div>
+<section id="parallelizing-across-multiple-processors">
+<h2>Parallelizing across Multiple Processors<a class="headerlink" href="#parallelizing-across-multiple-processors" title="Permalink to this heading">¶</a></h2>
+<p><a class="reference internal" href="../backends/platform.html"><span class="doc">multi-processor platforms</span></a> page.</p>
+<p>One typical use case of <a class="reference internal" href="../backends/platform.html"><span class="doc">multi-processor platforms</span></a> is to distribute the
+expectation value computations of a multi-term Hamiltonian across multiple virtual QPUs.</p>
+<p>The following shows an example using the <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code> platform:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+<span class="n">target</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span>
+<span class="n">num_qpus</span> <span class="o">=</span> <span class="n">target</span><span class="o">.</span><span class="n">num_qpus</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Number of QPUs:&quot;</span><span class="p">,</span> <span class="n">num_qpus</span><span class="p">)</span>
+
+
+<span class="c1"># Define spin ansatz.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angle</span><span class="p">:</span> <span class="nb">float</span><span class="p">):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angle</span><span class="p">,</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="c1"># Define spin Hamiltonian.</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span>
+    <span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+
+<span class="n">exp_val</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span>
+                        <span class="n">hamiltonian</span><span class="p">,</span>
+                        <span class="mf">0.59</span><span class="p">,</span>
+                        <span class="n">execution</span><span class="o">=</span><span class="n">cudaq</span><span class="o">.</span><span class="n">parallel</span><span class="o">.</span><span class="n">thread</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Expectation value: &quot;</span><span class="p">,</span> <span class="n">exp_val</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5.907</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">2.1433</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">                     </span><span class="mf">.21829</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">6.125</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Get the quantum_platform singleton</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="n">platform</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">get_platform</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Query the number of QPUs in the system</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">num_qpus</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">platform</span><span class="p">.</span><span class="n">num_qpus</span><span class="p">();</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Number of QPUs: %zu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">num_qpus</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">ansatz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[](</span><span class="kt">double</span><span class="w"> </span><span class="n">theta</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">;</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">ry</span><span class="p">(</span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">r</span><span class="p">,</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="kt">double</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">observe</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">parallel</span><span class="o">::</span><span class="kr">thread</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">h</span><span class="p">,</span><span class="w"> </span><span class="mf">0.59</span><span class="p">);</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Expectation value: %lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">result</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>One can then target the <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code> platform by executing the following commands:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ observe_mqpu.cpp -target nvidia-mqpu</span>
+<span class="go">./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>In the above code snippets, since the Hamiltonian contains four non-identity terms, there are four quantum circuits that need to be executed
+in order to compute the expectation value of that Hamiltonian and given the quantum state prepared by the ansatz kernel. When the <code class="code docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code> platform
+is selected, these circuits will be distributed across all available QPUs. The final expectation value result is computed from all QPU execution results.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../../examples/python/tutorials/visualization.html" class="btn btn-neutral float-left" title="Visualization" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="multi_control.html" class="btn btn-neutral float-right" title="Multi-control Synthesis" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/hardware_providers.html b/pr-2241/using/examples/hardware_providers.html
new file mode 100644
index 0000000000..86d09327e6
--- /dev/null
+++ b/pr-2241/using/examples/hardware_providers.html
@@ -0,0 +1,1288 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Using Quantum Hardware Providers &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="CUDA-Q Tutorials" href="../tutorials.html" />
+    <link rel="prev" title="Noisy Simulation" href="noisy_simulation.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Using Quantum Hardware Providers</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/hardware_providers.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="noisy_simulation.html" class="btn btn-neutral float-left" title="Noisy Simulation" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../tutorials.html" class="btn btn-neutral float-right" title="CUDA-Q Tutorials" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="using-quantum-hardware-providers">
+<h1>Using Quantum Hardware Providers<a class="headerlink" href="#using-quantum-hardware-providers" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q contains support for using a set of hardware providers (IonQ, IQM, OQC, ORCA Computing and Quantinuum).
+For more information about executing quantum kernels on different hardware backends, please take a look
+at <a class="reference internal" href="../backends/hardware.html"><span class="doc">hardware</span></a>.</p>
+<section id="ionq">
+<h2>IonQ<a class="headerlink" href="#ionq" title="Permalink to this heading">¶</a></h2>
+<p>The following code illustrates how to run kernels on IonQ’s backends.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># You only have to set the target once! No need to redefine it</span>
+<span class="c1"># for every execution call on your kernel.</span>
+<span class="c1"># To use different targets in the same file, you must update</span>
+<span class="c1"># it via another call to `cudaq.set_target()`</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;ionq&quot;</span><span class="p">)</span>
+
+
+<span class="c1"># Create the kernel we&#39;d like to execute on IonQ.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="c1"># Note: All qubits will be measured at the end upon performing</span>
+<span class="c1"># the sampling. You may encounter a pre-flight error on IonQ</span>
+<span class="c1"># backends if you include explicit measurements.</span>
+
+<span class="c1"># Execute on IonQ and print out the results.</span>
+
+<span class="c1"># Option A:</span>
+<span class="c1"># By using the asynchronous `cudaq.sample_async`, the remaining</span>
+<span class="c1"># classical code will be executed while the job is being handled</span>
+<span class="c1"># by IonQ. This is ideal when submitting via a queue over</span>
+<span class="c1"># the cloud.</span>
+<span class="n">async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># ... more classical code to run ...</span>
+
+<span class="c1"># We can either retrieve the results later in the program with</span>
+<span class="c1"># ```</span>
+<span class="c1"># async_counts = async_results.get()</span>
+<span class="c1"># ```</span>
+<span class="c1"># or we can also write the job reference (`async_results`) to</span>
+<span class="c1"># a file and load it later or from a different process.</span>
+<span class="n">file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span>
+<span class="n">file</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">async_results</span><span class="p">))</span>
+<span class="n">file</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+<span class="c1"># We can later read the file content and retrieve the job</span>
+<span class="c1"># information and results.</span>
+<span class="n">same_file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;r&quot;</span><span class="p">)</span>
+<span class="n">retrieved_async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">AsyncSampleResult</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">same_file</span><span class="o">.</span><span class="n">read</span><span class="p">()))</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">retrieved_async_results</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+
+<span class="c1"># Option B:</span>
+<span class="c1"># By using the synchronous `cudaq.sample`, the execution of</span>
+<span class="c1"># any remaining classical code in the file will occur only</span>
+<span class="c1"># after the job has been returned from IonQ.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ --target ionq ionq.cpp -o out.x &amp;&amp; ./out.x</span>
+<span class="c1">// ```</span>
+<span class="c1">// This will submit the job to the IonQ ideal simulator target (default).</span>
+<span class="c1">// Alternatively, we can enable hardware noise model simulation by specifying</span>
+<span class="c1">// the `--ionq-noise-model`, e.g.,</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ --target ionq --ionq-machine simulator --ionq-noise-model aria-1</span>
+<span class="c1">// ionq.cpp -o out.x &amp;&amp; ./out.x</span>
+<span class="c1">// ```</span>
+<span class="c1">// where we set the noise model to mimic the &#39;aria-1&#39; hardware device.</span>
+<span class="c1">// Please refer to your IonQ Cloud dashboard for the list of simulator noise</span>
+<span class="c1">// models.</span>
+<span class="c1">// Note: `--ionq-machine simulator` is  optional since &#39;simulator&#39; is the</span>
+<span class="c1">// default configuration if not provided. Assumes a valid set of credentials</span>
+<span class="c1">// have been stored.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;fstream&gt;</span>
+
+<span class="c1">// Define a simple quantum kernel to execute on IonQ.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Maximally entangled state between 5 qubits.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">4</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Submit to IonQ asynchronously (e.g., continue executing</span>
+<span class="w">  </span><span class="c1">// code in the file until the job has been returned).</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">future</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_async</span><span class="p">(</span><span class="n">ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="c1">// ... classical code to execute in the meantime ...</span>
+
+<span class="w">  </span><span class="c1">// Can write the future to file:</span>
+<span class="w">  </span><span class="p">{</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">ofstream</span><span class="w"> </span><span class="n">out</span><span class="p">(</span><span class="s">&quot;saveMe.json&quot;</span><span class="p">);</span>
+<span class="w">    </span><span class="n">out</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">future</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="c1">// Then come back and read it in later.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">async_result</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_result</span><span class="o">&gt;</span><span class="w"> </span><span class="n">readIn</span><span class="p">;</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">ifstream</span><span class="w"> </span><span class="n">in</span><span class="p">(</span><span class="s">&quot;saveMe.json&quot;</span><span class="p">);</span>
+<span class="w">  </span><span class="n">in</span><span class="w"> </span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">readIn</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Get the results of the read in future.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">async_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">readIn</span><span class="p">.</span><span class="n">get</span><span class="p">();</span>
+<span class="w">  </span><span class="n">async_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// OR: Submit to IonQ synchronously (e.g., wait for the job</span>
+<span class="w">  </span><span class="c1">// result to be returned before proceeding).</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="iqm">
+<h2>IQM<a class="headerlink" href="#iqm" title="Permalink to this heading">¶</a></h2>
+<p>The following code illustrates how to run kernels on IQM’s backends.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># You only have to set the target once! No need to redefine it</span>
+<span class="c1"># for every execution call on your kernel.</span>
+<span class="c1"># To use different targets in the same file, you must update</span>
+<span class="c1"># it via another call to `cudaq.set_target()`</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;iqm&quot;</span><span class="p">,</span>
+                 <span class="n">url</span><span class="o">=</span><span class="s2">&quot;http://localhost/cocos&quot;</span><span class="p">,</span>
+                 <span class="o">**</span><span class="p">{</span><span class="s2">&quot;qpu-architecture&quot;</span><span class="p">:</span> <span class="s2">&quot;Adonis&quot;</span><span class="p">})</span>
+
+<span class="c1"># Adonis QPU architecture:</span>
+<span class="c1">#       QB1</span>
+<span class="c1">#        |</span>
+<span class="c1"># QB2 - QB3 - QB4</span>
+<span class="c1">#        |</span>
+<span class="c1">#       QB5</span>
+
+
+<span class="c1"># Create the kernel we&#39;d like to execute on IQM.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">5</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>  <span class="c1"># QB3</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="c1"># Execute on IQM Server and print out the results.</span>
+
+<span class="c1"># Option A:</span>
+<span class="c1"># By using the asynchronous `cudaq.sample_async`, the remaining</span>
+<span class="c1"># classical code will be executed while the job is being handled</span>
+<span class="c1"># by IQM Server. This is ideal when submitting via a queue over</span>
+<span class="c1"># the cloud.</span>
+<span class="n">async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># ... more classical code to run ...</span>
+
+<span class="c1"># We can either retrieve the results later in the program with</span>
+<span class="c1"># ```</span>
+<span class="c1"># async_counts = async_results.get()</span>
+<span class="c1"># ```</span>
+<span class="c1"># or we can also write the job reference (`async_results`) to</span>
+<span class="c1"># a file and load it later or from a different process.</span>
+<span class="n">file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span>
+<span class="n">file</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">async_results</span><span class="p">))</span>
+<span class="n">file</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+<span class="c1"># We can later read the file content and retrieve the job</span>
+<span class="c1"># information and results.</span>
+<span class="n">same_file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;r&quot;</span><span class="p">)</span>
+<span class="n">retrieved_async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">AsyncSampleResult</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">same_file</span><span class="o">.</span><span class="n">read</span><span class="p">()))</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">retrieved_async_results</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+
+<span class="c1"># Option B:</span>
+<span class="c1"># By using the synchronous `cudaq.sample`, the execution of</span>
+<span class="c1"># any remaining classical code in the file will occur only</span>
+<span class="c1"># after the job has been returned from IQM Server.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ --target iqm iqm.cpp --iqm-machine Adonis -o out.x &amp;&amp; ./out.x</span>
+<span class="c1">// ```</span>
+<span class="c1">// Assumes a valid set of credentials have been stored.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;fstream&gt;</span>
+
+<span class="c1">// Define a simple quantum kernel to execute on IQM Server.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">adonis_ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Maximally entangled state between 5 qubits on Adonis QPU.</span>
+<span class="w">  </span><span class="c1">//       QB1</span>
+<span class="w">  </span><span class="c1">//        |</span>
+<span class="w">  </span><span class="c1">// QB2 - QB3 - QB4</span>
+<span class="w">  </span><span class="c1">//        |</span>
+<span class="w">  </span><span class="c1">//       QB5</span>
+
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="c1">// Note that the CUDA-Q compiler will automatically generate the</span>
+<span class="w">    </span><span class="c1">// necessary instructions to swap qubits to satisfy the required</span>
+<span class="w">    </span><span class="c1">// connectivity constraints for the Adonis QPU. In this program, that means</span>
+<span class="w">    </span><span class="c1">// that despite QB1 not being physically connected to QB2, the user can</span>
+<span class="w">    </span><span class="c1">// still perform joint operations q[0] and q[1] because the compiler will</span>
+<span class="w">    </span><span class="c1">// automatically (and transparently) inject the necessary swap instructions</span>
+<span class="w">    </span><span class="c1">// to execute the user&#39;s program without the user having to worry about the</span>
+<span class="w">    </span><span class="c1">// physical constraints.</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">4</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Submit to IQM Server asynchronously. E.g, continue executing</span>
+<span class="w">  </span><span class="c1">// code in the file until the job has been returned.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">future</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_async</span><span class="p">(</span><span class="n">adonis_ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="c1">// ... classical code to execute in the meantime ...</span>
+
+<span class="w">  </span><span class="c1">// Can write the future to file:</span>
+<span class="w">  </span><span class="p">{</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">ofstream</span><span class="w"> </span><span class="n">out</span><span class="p">(</span><span class="s">&quot;saveMe.json&quot;</span><span class="p">);</span>
+<span class="w">    </span><span class="n">out</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">future</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="c1">// Then come back and read it in later.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">async_result</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_result</span><span class="o">&gt;</span><span class="w"> </span><span class="n">readIn</span><span class="p">;</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">ifstream</span><span class="w"> </span><span class="n">in</span><span class="p">(</span><span class="s">&quot;saveMe.json&quot;</span><span class="p">);</span>
+<span class="w">  </span><span class="n">in</span><span class="w"> </span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">readIn</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Get the results of the read in future.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">async_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">readIn</span><span class="p">.</span><span class="n">get</span><span class="p">();</span>
+<span class="w">  </span><span class="n">async_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// OR: Submit to IQM Server synchronously. E.g, wait for the job</span>
+<span class="w">  </span><span class="c1">// result to be returned before proceeding.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">adonis_ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="oqc">
+<h2>OQC<a class="headerlink" href="#oqc" title="Permalink to this heading">¶</a></h2>
+<p>The following code illustrates how to run kernels on OQC’s backends.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># You only have to set the target once! No need to redefine it</span>
+<span class="c1"># for every execution call on your kernel.</span>
+<span class="c1"># To use different targets in the same file, you must update</span>
+<span class="c1"># it via another call to `cudaq.set_target()`</span>
+
+<span class="c1"># To use the OQC target you will need to set the following environment variables</span>
+<span class="c1"># OQC_URL</span>
+<span class="c1"># OQC_EMAIL</span>
+<span class="c1"># OQC_PASSWORD</span>
+<span class="c1"># To setup an account, contact oqc_qcaas_support@oxfordquantumcircuits.com</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;oqc&quot;</span><span class="p">)</span>
+
+
+<span class="c1"># Create the kernel we&#39;d like to execute on OQC.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">[</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">]]</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="c1"># Option A:</span>
+<span class="c1"># By using the asynchronous `cudaq.sample_async`, the remaining</span>
+<span class="c1"># classical code will be executed while the job is being handled</span>
+<span class="c1"># by OQC. This is ideal when submitting via a queue over</span>
+<span class="c1"># the cloud.</span>
+<span class="n">async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># ... more classical code to run ...</span>
+
+<span class="c1"># We can either retrieve the results later in the program with</span>
+<span class="c1"># ```</span>
+<span class="c1"># async_counts = async_results.get()</span>
+<span class="c1"># ```</span>
+<span class="c1"># or we can also write the job reference (`async_results`) to</span>
+<span class="c1"># a file and load it later or from a different process.</span>
+<span class="n">file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span>
+<span class="n">file</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">async_results</span><span class="p">))</span>
+<span class="n">file</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+<span class="c1"># We can later read the file content and retrieve the job</span>
+<span class="c1"># information and results.</span>
+<span class="n">same_file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;r&quot;</span><span class="p">)</span>
+<span class="n">retrieved_async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">AsyncSampleResult</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">same_file</span><span class="o">.</span><span class="n">read</span><span class="p">()))</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">retrieved_async_results</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+
+<span class="c1"># Option B:</span>
+<span class="c1"># By using the synchronous `cudaq.sample`, the execution of</span>
+<span class="c1"># any remaining classical code in the file will occur only</span>
+<span class="c1"># after the job has been returned from OQC.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="orca-computing">
+<h2>ORCA Computing<a class="headerlink" href="#orca-computing" title="Permalink to this heading">¶</a></h2>
+<p>The following code illustrates how to run kernels on ORCA Computing’s backends.</p>
+<p>ORCA Computing’s PT Series implement the boson sampling model of quantum computation, in which
+multiple photons are interfered with each other within a network of beam splitters, and photon
+detectors measure where the photons leave this network.</p>
+<p>The following image shows the schematic of a Time Bin Interferometer (TBI) boson sampling experiment
+that runs on ORCA Computing’s backends. A TBI uses optical delay lines with reconfigurable coupling
+parameters. A TBI can be represented by a circuit diagram, like the one below, where this
+illustration example corresponds to 4 photons in 8 modes sent into alternating time-bins in a circuit
+composed of two delay lines in series.</p>
+<a class="reference internal image-reference" href="../../_images/orca_tbi.png"><img alt="../../_images/orca_tbi.png" class="align-center" src="../../_images/orca_tbi.png" style="width: 400px;" /></a>
+<p>The parameters needed to define the time bin interferometer are the the input state, the loop
+lengths, beam splitter angles, and optionally the phase shifter angles, and the number of samples.
+The <em>input state</em> is the initial state of the photons in the time bin interferometer,
+the left-most entry corresponds to the first mode entering the loop.
+The <em>loop lengths</em> are the lengths of the different loops in the time bin interferometer.
+The <em>beam splitter angles</em> and the phase shifter angles are controllable
+parameters of the time bin interferometer.</p>
+<p>This experiment is performed on ORCA’s backends by the code below.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">os</span>
+<span class="c1"># You only have to set the target once! No need to redefine it</span>
+<span class="c1"># for every execution call on your kernel.</span>
+<span class="c1"># To use different targets in the same file, you must update</span>
+<span class="c1"># it via another call to `cudaq.set_target()`</span>
+
+<span class="c1"># To use the ORCA Computing target you will need to set the ORCA_ACCESS_URL</span>
+<span class="c1"># environment variable or pass a URL.</span>
+<span class="n">orca_url</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s2">&quot;ORCA_ACCESS_URL&quot;</span><span class="p">,</span> <span class="s2">&quot;http://localhost/sample&quot;</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;orca&quot;</span><span class="p">,</span> <span class="n">url</span><span class="o">=</span><span class="n">orca_url</span><span class="p">)</span>
+
+<span class="c1"># A time-bin boson sampling experiment: An input state of 4 indistinguishable</span>
+<span class="c1"># photons mixed with 4 vacuum states across 8 time bins (modes) enter the</span>
+<span class="c1"># time bin interferometer (TBI). The interferometer is composed of two loops</span>
+<span class="c1"># each with a beam splitter (and optionally with a corresponding phase</span>
+<span class="c1"># shifter). Each photon can either be stored in a loop to interfere with the</span>
+<span class="c1"># next photon or exit the loop to be measured. Since there are 8 time bins</span>
+<span class="c1"># and 2 loops, there is a total of 14 beam splitters (and optionally 14 phase</span>
+<span class="c1"># shifters) in the interferometer, which is the number of controllable</span>
+<span class="c1"># parameters.</span>
+
+<span class="c1"># half of 8 time bins is filled with a single photon and the other half is</span>
+<span class="c1"># filled with the vacuum state (empty)</span>
+<span class="n">input_state</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">]</span>
+
+<span class="c1"># The time bin interferometer in this example has two loops, each of length 1</span>
+<span class="n">loop_lengths</span> <span class="o">=</span> <span class="p">[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">]</span>
+
+<span class="c1"># Calculate the number of beam splitters and phase shifters</span>
+<span class="n">n_beam_splitters</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">loop_lengths</span><span class="p">)</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">input_state</span><span class="p">)</span> <span class="o">-</span> <span class="nb">sum</span><span class="p">(</span><span class="n">loop_lengths</span><span class="p">)</span>
+
+<span class="c1"># beam splitter angles</span>
+<span class="n">bs_angles</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">linspace</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">8</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mi">3</span><span class="p">,</span> <span class="n">n_beam_splitters</span><span class="p">)</span>
+
+<span class="c1"># Optionally, we can also specify the phase shifter angles, if the system</span>
+<span class="c1"># includes phase shifters</span>
+<span class="c1"># ```</span>
+<span class="c1"># ps_angles = np.linspace(np.pi / 6, np.pi / 3, n_beam_splitters)</span>
+<span class="c1"># ```</span>
+
+<span class="c1"># we can also set number of requested samples</span>
+<span class="n">n_samples</span> <span class="o">=</span> <span class="mi">10000</span>
+
+<span class="c1"># By using the synchronous `cudaq.orca.sample`, the execution of</span>
+<span class="c1"># any remaining classical code in the file will occur only</span>
+<span class="c1"># after the job has been returned from ORCA Server.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">orca</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">input_state</span><span class="p">,</span> <span class="n">loop_lengths</span><span class="p">,</span> <span class="n">bs_angles</span><span class="p">,</span> <span class="n">n_samples</span><span class="p">)</span>
+
+<span class="c1"># If the system includes phase shifters, the phase shifter angles can be</span>
+<span class="c1"># included in the call</span>
+<span class="c1"># ```</span>
+<span class="c1"># counts = cudaq.orca.sample(input_state, loop_lengths, bs_angles, ps_angles,</span>
+<span class="c1">#                            n_samples)</span>
+<span class="c1"># ```</span>
+
+<span class="c1"># Print the results</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ --target orca --orca-url $ORCA_ACCESS_URL orca.cpp -o out.x &amp;&amp; ./out.x</span>
+<span class="c1">// ```</span>
+<span class="c1">// To use the ORCA Computing target you will need to set the ORCA_ACCESS_URL</span>
+<span class="c1">// environment variable or pass the URL to the `--orca-url` flag.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq/orca.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq.h&quot;</span>
+
+<span class="c1">// define helper function to generate linear spaced vectors</span>
+<span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">T</span><span class="o">&gt;</span>
+<span class="kt">void</span><span class="w"> </span><span class="n">linear_spaced_vector</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">T</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">xs</span><span class="p">,</span><span class="w"> </span><span class="n">T</span><span class="w"> </span><span class="n">min</span><span class="p">,</span><span class="w"> </span><span class="n">T</span><span class="w"> </span><span class="n">max</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">N</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">T</span><span class="w"> </span><span class="n">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="n">max</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">min</span><span class="p">)</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="k">static_cast</span><span class="o">&lt;</span><span class="n">T</span><span class="o">&gt;</span><span class="p">(</span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
+<span class="w">  </span><span class="k">typename</span><span class="w"> </span><span class="nc">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">T</span><span class="o">&gt;::</span><span class="n">iterator</span><span class="w"> </span><span class="n">x</span><span class="p">;</span>
+<span class="w">  </span><span class="n">T</span><span class="w"> </span><span class="n">val</span><span class="p">;</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="n">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">xs</span><span class="p">.</span><span class="n">begin</span><span class="p">(),</span><span class="w"> </span><span class="n">val</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">min</span><span class="p">;</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="n">xs</span><span class="p">.</span><span class="n">end</span><span class="p">();</span><span class="w"> </span><span class="o">++</span><span class="n">x</span><span class="p">,</span><span class="w"> </span><span class="n">val</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="n">h</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="o">*</span><span class="n">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">val</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// A time-bin boson sampling experiment: An input state of 4 indistinguishable</span>
+<span class="w">  </span><span class="c1">// photons mixed with 4 vacuum states across 8 time bins (modes) enter the</span>
+<span class="w">  </span><span class="c1">// time bin interferometer (TBI). The interferometer is composed of two loops</span>
+<span class="w">  </span><span class="c1">// each with a beam splitter (and optionally with a corresponding phase</span>
+<span class="w">  </span><span class="c1">// shifter). Each photon can either be stored in a loop to interfere with the</span>
+<span class="w">  </span><span class="c1">// next photon or exit the loop to be measured. Since there are 8 time bins</span>
+<span class="w">  </span><span class="c1">// and 2 loops, there is a total of 14 beam splitters (and optionally 14 phase</span>
+<span class="w">  </span><span class="c1">// shifters) in the interferometer, which is the number of controllable</span>
+<span class="w">  </span><span class="c1">// parameters.</span>
+
+<span class="w">  </span><span class="c1">// half of 8 time bins is filled with a single photon and the other half is</span>
+<span class="w">  </span><span class="c1">// filled with the vacuum state (empty)</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="w"> </span><span class="n">input_state</span><span class="p">{</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// The time bin interferometer in this example has two loops, each of length 1</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="w"> </span><span class="n">loop_lengths</span><span class="p">{</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// helper variables to calculate the number of beam splitters and phase</span>
+<span class="w">  </span><span class="c1">// shifters needed in the TBI</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">sum_loop_lengths</span><span class="p">{</span><span class="n">std</span><span class="o">::</span><span class="n">accumulate</span><span class="p">(</span>
+<span class="w">      </span><span class="n">loop_lengths</span><span class="p">.</span><span class="n">begin</span><span class="p">(),</span><span class="w"> </span><span class="n">loop_lengths</span><span class="p">.</span><span class="n">end</span><span class="p">(),</span><span class="w"> </span><span class="k">static_cast</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="p">(</span><span class="mi">0</span><span class="p">))};</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">n_loops</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">loop_lengths</span><span class="p">.</span><span class="n">size</span><span class="p">();</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">n_modes</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">input_state</span><span class="p">.</span><span class="n">size</span><span class="p">();</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">n_beam_splitters</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">n_loops</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">n_modes</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">sum_loop_lengths</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// beam splitter angles (created as a linear spaced vector of angles)</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">bs_angles</span><span class="p">(</span><span class="n">n_beam_splitters</span><span class="p">);</span>
+<span class="w">  </span><span class="n">linear_spaced_vector</span><span class="p">(</span><span class="n">bs_angles</span><span class="p">,</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">8</span><span class="p">,</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="n">n_beam_splitters</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Optionally, we can also specify the phase shifter angles (created as a</span>
+<span class="w">  </span><span class="c1">// linear spaced vector of angles), if the system includes phase shifters</span>
+<span class="w">  </span><span class="c1">// ```</span>
+<span class="w">  </span><span class="c1">// std::vector&lt;double&gt; ps_angles(n_beam_splitters);</span>
+<span class="w">  </span><span class="c1">// linear_spaced_vector(ps_angles, M_PI / 6, M_PI / 3, n_beam_splitters);</span>
+<span class="w">  </span><span class="c1">// ```</span>
+
+<span class="w">  </span><span class="c1">// we can also set number of requested samples</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">n_samples</span><span class="p">{</span><span class="mi">10000</span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Submit to ORCA synchronously (e.g., wait for the job result to be returned</span>
+<span class="w">  </span><span class="c1">// before proceeding with the rest of the execution).</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span>
+<span class="w">      </span><span class="n">cudaq</span><span class="o">::</span><span class="n">orca</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">input_state</span><span class="p">,</span><span class="w"> </span><span class="n">loop_lengths</span><span class="p">,</span><span class="w"> </span><span class="n">bs_angles</span><span class="p">,</span><span class="w"> </span><span class="n">n_samples</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// If the system includes phase shifters, the phase shifter angles can be</span>
+<span class="w">  </span><span class="c1">// included in the call</span>
+
+<span class="w">  </span><span class="c1">// ```</span>
+<span class="w">  </span><span class="c1">// auto counts = cudaq::orca::sample(input_state, loop_lengths, bs_angles,</span>
+<span class="w">  </span><span class="c1">//                                   ps_angles, n_samples);</span>
+<span class="w">  </span><span class="c1">// ```</span>
+
+<span class="w">  </span><span class="c1">// Print the results</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+<section id="quantinuum">
+<h2>Quantinuum<a class="headerlink" href="#quantinuum" title="Permalink to this heading">¶</a></h2>
+<p>The following code illustrates how to run kernels on Quantinuum’s backends.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># You only have to set the target once! No need to redefine it</span>
+<span class="c1"># for every execution call on your kernel.</span>
+<span class="c1"># By default, we will submit to the Quantinuum syntax checker.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;quantinuum&quot;</span><span class="p">)</span>
+
+
+<span class="c1"># Create the kernel we&#39;d like to execute on Quantinuum.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="c1"># Submit to Quantinuum&#39;s endpoint and confirm the program is valid.</span>
+
+<span class="c1"># Option A:</span>
+<span class="c1"># By using the synchronous `cudaq.sample`, the execution of</span>
+<span class="c1"># any remaining classical code in the file will occur only</span>
+<span class="c1"># after the job has been executed by the Quantinuum service.</span>
+<span class="c1"># We will use the synchronous call to submit to the syntax</span>
+<span class="c1"># checker to confirm the validity of the program.</span>
+<span class="n">syntax_check</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="k">if</span> <span class="p">(</span><span class="n">syntax_check</span><span class="p">):</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Syntax check passed! Kernel is ready for submission.&quot;</span><span class="p">)</span>
+
+<span class="c1"># Now we can update the target to the Quantinuum emulator and</span>
+<span class="c1"># execute our program.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;quantinuum&quot;</span><span class="p">,</span> <span class="n">machine</span><span class="o">=</span><span class="s2">&quot;H1-2E&quot;</span><span class="p">)</span>
+
+<span class="c1"># Option B:</span>
+<span class="c1"># By using the asynchronous `cudaq.sample_async`, the remaining</span>
+<span class="c1"># classical code will be executed while the job is being handled</span>
+<span class="c1"># by Quantinuum. This is ideal when submitting via a queue over</span>
+<span class="c1"># the cloud.</span>
+<span class="n">async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="c1"># ... more classical code to run ...</span>
+
+<span class="c1"># We can either retrieve the results later in the program with</span>
+<span class="c1"># ```</span>
+<span class="c1"># async_counts = async_results.get()</span>
+<span class="c1"># ```</span>
+<span class="c1"># or we can also write the job reference (`async_results`) to</span>
+<span class="c1"># a file and load it later or from a different process.</span>
+<span class="n">file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span>
+<span class="n">file</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">async_results</span><span class="p">))</span>
+<span class="n">file</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
+
+<span class="c1"># We can later read the file content and retrieve the job</span>
+<span class="c1"># information and results.</span>
+<span class="n">same_file</span> <span class="o">=</span> <span class="nb">open</span><span class="p">(</span><span class="s2">&quot;future.txt&quot;</span><span class="p">,</span> <span class="s2">&quot;r&quot;</span><span class="p">)</span>
+<span class="n">retrieved_async_results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">AsyncSampleResult</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">same_file</span><span class="o">.</span><span class="n">read</span><span class="p">()))</span>
+
+<span class="n">counts</span> <span class="o">=</span> <span class="n">retrieved_async_results</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ --target quantinuum --quantinuum-machine H1-2E quantinuum.cpp -o out.x</span>
+<span class="c1">// ./out.x</span>
+<span class="c1">// ```</span>
+<span class="c1">// Assumes a valid set of credentials have been stored.</span>
+<span class="c1">// To first confirm the correctness of the program locally,</span>
+<span class="c1">// Add a --emulate to the `nvq++` command above.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;fstream&gt;</span>
+
+<span class="c1">// Define a simple quantum kernel to execute on Quantinuum.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Maximally entangled state between 5 qubits.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">q</span><span class="p">(</span><span class="mi">5</span><span class="p">);</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">4</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Submit to Quantinuum asynchronously (e.g., continue executing</span>
+<span class="w">  </span><span class="c1">// code in the file until the job has been returned).</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">future</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_async</span><span class="p">(</span><span class="n">ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="c1">// ... classical code to execute in the meantime ...</span>
+
+<span class="w">  </span><span class="c1">// Can write the future to file:</span>
+<span class="w">  </span><span class="p">{</span>
+<span class="w">    </span><span class="n">std</span><span class="o">::</span><span class="n">ofstream</span><span class="w"> </span><span class="n">out</span><span class="p">(</span><span class="s">&quot;saveMe.json&quot;</span><span class="p">);</span>
+<span class="w">    </span><span class="n">out</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">future</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="c1">// Then come back and read it in later.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">async_result</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample_result</span><span class="o">&gt;</span><span class="w"> </span><span class="n">readIn</span><span class="p">;</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">ifstream</span><span class="w"> </span><span class="n">in</span><span class="p">(</span><span class="s">&quot;saveMe.json&quot;</span><span class="p">);</span>
+<span class="w">  </span><span class="n">in</span><span class="w"> </span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="n">readIn</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Get the results of the read in future.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">async_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">readIn</span><span class="p">.</span><span class="n">get</span><span class="p">();</span>
+<span class="w">  </span><span class="n">async_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// OR: Submit to Quantinuum synchronously (e.g., wait for the job</span>
+<span class="w">  </span><span class="c1">// result to be returned before proceeding).</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz</span><span class="p">{});</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="noisy_simulation.html" class="btn btn-neutral float-left" title="Noisy Simulation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../tutorials.html" class="btn btn-neutral float-right" title="CUDA-Q Tutorials" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/introduction.html b/pr-2241/using/examples/introduction.html
new file mode 100644
index 0000000000..3d6e1990ae
--- /dev/null
+++ b/pr-2241/using/examples/introduction.html
@@ -0,0 +1,761 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Introduction &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Quantum Computing 101" href="quantum_operations.html" />
+    <link rel="prev" title="CUDA-Q by Example" href="examples.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Introduction</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/introduction.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="examples.html" class="btn btn-neutral float-left" title="CUDA-Q by Example" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="quantum_operations.html" class="btn btn-neutral float-right" title="Quantum Computing 101" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="introduction">
+<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h1>
+<p>Welcome to CUDA-Q! On this page we will illustrate CUDA-Q with several examples.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<p>We’re going to take a look at how to construct quantum programs through CUDA-Q’s <code class="code docutils literal notranslate"><span class="pre">Kernel</span></code> API.</p>
+<p>When you create a <code class="code docutils literal notranslate"><span class="pre">Kernel</span></code> and invoke its methods, a quantum program is constructed that can then be executed by calling, for example, <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code>. Let’s take a closer look!</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+
+<span class="c1"># We begin by defining the `Kernel` that we will construct our</span>
+<span class="c1"># program with.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+<span class="w">    </span><span class="sd">&#39;&#39;&#39;</span>
+<span class="sd">    This is our first CUDA-Q kernel.</span>
+<span class="sd">    &#39;&#39;&#39;</span>
+    <span class="c1"># Next, we can allocate a single qubit to the kernel via `qubit()`.</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+    <span class="c1"># Now we can begin adding instructions to apply to this qubit!</span>
+    <span class="c1"># Here we&#39;ll just add every non-parameterized</span>
+    <span class="c1"># single qubit gate that is supported by CUDA-Q.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">y</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">z</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">t</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">s</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+    <span class="c1"># Next, we add a measurement to the kernel so that we can sample</span>
+    <span class="c1"># the measurement results on our simulator!</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Finally, we can execute this kernel on the state vector simulator</span>
+<span class="c1"># by calling `cudaq.sample`. This will execute the provided kernel</span>
+<span class="c1"># `shots_count` number of times and return the sampled distribution</span>
+<span class="c1"># as a `cudaq.SampleResult` dictionary.</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+
+<span class="c1"># Now let&#39;s take a look at the `SampleResult` we&#39;ve gotten back!</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<p>We’re going to take a look at how to construct quantum programs using CUDA-Q kernels.</p>
+<p>CUDA-Q kernels are any typed callable in the language that is annotated with the <code class="code docutils literal notranslate"><span class="pre">__qpu__</span></code> attribute. Let’s take a look at a very
+simple “Hello World” example, specifically a CUDA-Q kernel that prepares a GHZ state on a programmer-specified number of qubits.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ static_kernel.cpp -o ghz.x &amp;&amp; ./ghz.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// Define a CUDA-Q kernel that is fully specified</span>
+<span class="c1">// at compile time via templates.</span>
+<span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">N</span><span class="o">&gt;</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">    </span><span class="c1">// Compile-time sized array like std::array</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="n">N</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">N</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ghz</span><span class="o">&lt;</span><span class="mi">10</span><span class="o">&gt;</span><span class="p">{};</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">is_initialized</span><span class="p">()</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">mpi</span><span class="o">::</span><span class="n">rank</span><span class="p">()</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">    </span><span class="c1">// Fine grain access to the bits and counts</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Observed: %s, %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">.</span><span class="n">data</span><span class="p">(),</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Here we see that we can define a custom <code class="code docutils literal notranslate"><span class="pre">struct</span></code> that is templated on a <code class="code docutils literal notranslate"><span class="pre">size_t</span></code> parameter.
+Our kernel expression is free to use this template parameter in the allocation of a
+compile-time-known register of qubits. Within the kernel, we are free to apply various quantum operations,
+like a Hadamard on qubit 0 <code class="code docutils literal notranslate"><span class="pre">h(q[0])</span></code>. Controlled operations are <strong>modifications</strong> of single-qubit
+operations, like the <code class="code docutils literal notranslate"><span class="pre">x&lt;cudaq::ctrl&gt;(q[0],q[1])</span></code> operation which implements a controlled-X gate. We
+can measure single qubits or entire registers.</p>
+<p>In this example we are interested in sampling the final state produced by this CUDA-Q kernel.
+To do so, we leverage the generic <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code> function, which returns a data type
+encoding the qubit measurement strings and the corresponding number of times that string
+was observed (here the default number of shots is used, <code class="code docutils literal notranslate"><span class="pre">1000</span></code>).</p>
+<p>The following example illustrates how to compile and execute this code.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>static_kernel.cpp<span class="w"> </span>-o<span class="w"> </span>ghz.x
+./ghz.x
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="examples.html" class="btn btn-neutral float-left" title="CUDA-Q by Example" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="quantum_operations.html" class="btn btn-neutral float-right" title="Quantum Computing 101" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/multi_control.html b/pr-2241/using/examples/multi_control.html
new file mode 100644
index 0000000000..99caad51af
--- /dev/null
+++ b/pr-2241/using/examples/multi_control.html
@@ -0,0 +1,763 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Multi-control Synthesis &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Multi-GPU Workflows" href="multi_gpu_workflows.html" />
+    <link rel="prev" title="Computing Expectation Values" href="expectation_values.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Multi-control Synthesis</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/multi_control.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="expectation_values.html" class="btn btn-neutral float-left" title="Computing Expectation Values" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="multi_gpu_workflows.html" class="btn btn-neutral float-right" title="Multi-GPU Workflows" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="multi-control-synthesis">
+<h1>Multi-control Synthesis<a class="headerlink" href="#multi-control-synthesis" title="Permalink to this heading">¶</a></h1>
+<p>Now let’s take a look at how CUDA-Q allows one to control a general unitary
+on an arbitrary number of control qubits.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<p>Our first option is to describe our general unitary by another pre-defined
+CUDA-Q kernel.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># A kernel that performs an X-gate on a provided qubit.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">x_kernel</span><span class="p">(</span><span class="n">qubit</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">):</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># A kernel that will call `x_kernel` as a controlled operation.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">control_vector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">target</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">control_vector</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">target</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">control_vector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">control</span><span class="p">(</span><span class="n">x_kernel</span><span class="p">,</span> <span class="n">control_vector</span><span class="p">,</span> <span class="n">target</span><span class="p">)</span>
+
+
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">results</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Alternatively, one may pass multiple arguments for control qubits or vectors
+to any controlled operation.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">([</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">]],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">2</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+
+<span class="n">results</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">results</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<p>For this scenario, our general unitary can be described by another pre-defined
+CUDA-Q kernel expression.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ multi_controlled_operations.cpp -o ccnot.x &amp;&amp; ./ccnot.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+
+<span class="c1">// Here we demonstrate how one might apply multi-controlled</span>
+<span class="c1">// operations on a general CUDA-Q kernel.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ApplyX</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">q</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span><span class="w"> </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">ccnot_test</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// constrain the signature of the incoming kernel</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">takes_qubit</span><span class="w"> </span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="n">apply_x</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">qs</span><span class="p">(</span><span class="mi">3</span><span class="p">);</span>
+
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">qs</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="c1">// Control U (apply_x) on the first two qubits of</span>
+<span class="w">    </span><span class="c1">// the allocated register.</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">control</span><span class="p">(</span><span class="n">apply_x</span><span class="p">,</span><span class="w"> </span><span class="n">qs</span><span class="p">.</span><span class="n">front</span><span class="p">(</span><span class="mi">2</span><span class="p">),</span><span class="w"> </span><span class="n">qs</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// We can achieve the same thing as above via</span>
+<span class="w">  </span><span class="c1">// a lambda expression.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">ccnot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="mi">3</span><span class="p">);</span>
+
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ccnot</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Fine grain access to the bits and counts</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Observed: %s, %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">.</span><span class="n">data</span><span class="p">(),</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ccnot_test</span><span class="p">{},</span><span class="w"> </span><span class="n">ApplyX</span><span class="p">{});</span>
+
+<span class="w">  </span><span class="c1">// Fine grain access to the bits and counts</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="o">&amp;</span><span class="p">[</span><span class="n">bits</span><span class="p">,</span><span class="w"> </span><span class="n">count</span><span class="p">]</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">counts2</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Observed: %s, %lu</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">bits</span><span class="p">.</span><span class="n">data</span><span class="p">(),</span><span class="w"> </span><span class="n">count</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="expectation_values.html" class="btn btn-neutral float-left" title="Computing Expectation Values" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="multi_gpu_workflows.html" class="btn btn-neutral float-right" title="Multi-GPU Workflows" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/multi_gpu_workflows.html b/pr-2241/using/examples/multi_gpu_workflows.html
new file mode 100644
index 0000000000..d8b0f5b5e1
--- /dev/null
+++ b/pr-2241/using/examples/multi_gpu_workflows.html
@@ -0,0 +1,875 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Multi-GPU Workflows &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Bernstein-Vazirani" href="bernstein_vazirani.html" />
+    <link rel="prev" title="Multi-control Synthesis" href="multi_control.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Multi-GPU Workflows</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/multi_gpu_workflows.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="multi_control.html" class="btn btn-neutral float-left" title="Multi-control Synthesis" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="bernstein_vazirani.html" class="btn btn-neutral float-right" title="Bernstein-Vazirani" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="multi-gpu-workflows">
+<h1>Multi-GPU Workflows<a class="headerlink" href="#multi-gpu-workflows" title="Permalink to this heading">¶</a></h1>
+<p>There are many backends available with CUDA-Q which enable seamless
+switching between GPUs, QPUs and CPUs and also allow for workflows
+involving multiple architectures working in tandem.</p>
+<section id="available-targets">
+<h2>Available Targets<a class="headerlink" href="#available-targets" title="Permalink to this heading">¶</a></h2>
+<ul class="simple">
+<li><p><strong>`qpp-cpu`</strong>: The QPP based CPU backend which is multithreaded to
+maximize the usage of available cores on your system.</p></li>
+<li><p><strong>`nvidia`</strong>: GPU-accelerated state-vector based backend which accelerates quantum circuit
+simulation on NVIDIA GPUs powered by cuQuantum.</p></li>
+<li><p><strong>`nvidia-mgpu`</strong>: Allows for scaling circuit simulation on multiple GPUs.</p></li>
+<li><p><strong>`nvidia-mqpu`</strong>: Enables users to program workflows utilizing
+multiple virtual quantum processors in parallel, where each QPU is simulated by the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> backend.</p></li>
+<li><p><strong>`remote-mqpu`</strong>: Enables users to program workflows utilizing
+multiple virtual quantum processors in parallel, where the backend used to simulate each QPU is configurable.</p></li>
+</ul>
+<p>Please see <a class="reference internal" href="../backends/backends.html"><span class="doc">CUDA-Q Backends</span></a> for a full list of all available backends.
+Below we explore how to effectively utilize multiple CUDA-Q targets with the same GHZ state preparation code</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">ghz_state</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">):</span>
+        <span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+
+<span class="k">def</span> <span class="nf">sample_ghz_state</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">,</span> <span class="n">target</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;A function that will sample a variable sized GHZ state.&quot;&quot;&quot;</span>
+    <span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="n">target</span><span class="p">)</span>
+    <span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">ghz_state</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">shots_count</span><span class="o">=</span><span class="mi">1000</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">result</span>
+
+
+</pre></div>
+</div>
+<p>You can execute the code by running a statevector simulator on your CPU:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">cpu_result</span> <span class="o">=</span> <span class="n">sample_ghz_state</span><span class="p">(</span><span class="n">qubit_count</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">target</span><span class="o">=</span><span class="s2">&quot;qpp-cpu&quot;</span><span class="p">)</span>
+<span class="n">cpu_result</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">{</span> <span class="mi">00</span><span class="p">:</span><span class="mi">475</span> <span class="mi">11</span><span class="p">:</span><span class="mi">525</span> <span class="p">}</span>
+</pre></div>
+</div>
+<p>You will notice a speedup of up to <strong>2500x</strong> in executing the circuit below on
+NVIDIA GPUs vs CPUs:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">num_available_gpus</span><span class="p">()</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+    <span class="n">gpu_result</span> <span class="o">=</span> <span class="n">sample_ghz_state</span><span class="p">(</span><span class="n">qubit_count</span><span class="o">=</span><span class="mi">25</span><span class="p">,</span> <span class="n">target</span><span class="o">=</span><span class="s2">&quot;nvidia&quot;</span><span class="p">)</span>
+    <span class="n">gpu_result</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">{</span> <span class="mi">0000000000000000000000000</span><span class="p">:</span><span class="mi">510</span> <span class="mi">1111111111111111111111111</span><span class="p">:</span><span class="mi">490</span> <span class="p">}</span>
+</pre></div>
+</div>
+<p>If one incrementally increases the qubit count, we
+reach a limit where the memory required is beyond the capabilities of a
+single GPU: A <span class="math notranslate nohighlight">\(n\)</span> qubit quantum state has <span class="math notranslate nohighlight">\(2^n\)</span> complex amplitudes, each
+of which require 8 bytes of memory to store. Hence the total memory
+required to store a <span class="math notranslate nohighlight">\(n\)</span> qubit quantum state is <span class="math notranslate nohighlight">\(8\)</span> bytes
+<span class="math notranslate nohighlight">\(\times 2^n\)</span>. For <span class="math notranslate nohighlight">\(n = 30\)</span> qubits, this is roughly <span class="math notranslate nohighlight">\(8\)</span>
+GB but for <span class="math notranslate nohighlight">\(n = 40\)</span>, this exponentially increases to 8700 GB.</p>
+</section>
+<section id="parallelization-across-multiple-processors">
+<h2>Parallelization across Multiple Processors<a class="headerlink" href="#parallelization-across-multiple-processors" title="Permalink to this heading">¶</a></h2>
+<p>The <code class="docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> target allows for memory from additional
+GPUs to be pooled enabling qubit counts to be scaled.
+Execution on the <code class="docutils literal notranslate"><span class="pre">nvidia-mgpu</span></code> backend is enabled via <code class="docutils literal notranslate"><span class="pre">mpirun</span></code>. Users
+need to create a <code class="docutils literal notranslate"><span class="pre">.py</span></code> file with their code and run the command below
+in terminal:</p>
+<p><code class="docutils literal notranslate"><span class="pre">mpirun</span> <span class="pre">-np</span> <span class="pre">4</span> <span class="pre">python3</span> <span class="pre">test.py</span></code></p>
+<p>where 4 is the number of GPUs one has access to and <code class="docutils literal notranslate"><span class="pre">test</span></code> is the file
+name chosen.</p>
+<p>The <code class="docutils literal notranslate"><span class="pre">nvidia-mqpu</span></code> target uses a statevector simulator to simulate execution
+on each virtual QPU.
+The <code class="docutils literal notranslate"><span class="pre">remote-mqpu</span></code> platform allows to freely configure what backend is used
+for each platform QPU.
+For more information about the different platform targets, please take a look at
+<a class="reference internal" href="../backends/platform.html"><span class="doc">Multi-Processor Platforms</span></a>.</p>
+<section id="batching-hamiltonian-terms">
+<h3>Batching Hamiltonian Terms<a class="headerlink" href="#batching-hamiltonian-terms" title="Permalink to this heading">¶</a></h3>
+<p>Expectation value computations of multi-term Hamiltonians can be
+asynchronously processed via the <code class="docutils literal notranslate"><span class="pre">mqpu</span></code> platform.</p>
+<img alt="../../_images/hsplit.png" src="../../_images/hsplit.png" />
+<p>For workflows involving multiple GPUs, save the code below in a
+<code class="docutils literal notranslate"><span class="pre">filename.py</span></code> file and execute via:
+<code class="docutils literal notranslate"><span class="pre">mpirun</span> <span class="pre">-np</span> <span class="pre">n</span> <span class="pre">python3</span> <span class="pre">filename.py</span></code> where <code class="docutils literal notranslate"><span class="pre">n</span></code> is an integer
+specifying the number of GPUs you have access to.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="k">if</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">num_available_gpus</span><span class="p">()</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;This example requires a GPU to run. No GPU detected.&quot;</span><span class="p">)</span>
+    <span class="n">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">initialize</span><span class="p">()</span>
+
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">15</span>
+<span class="n">term_count</span> <span class="o">=</span> <span class="mi">100000</span>
+
+<span class="n">kernel</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">()</span>
+<span class="n">qubits</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+<span class="n">kernel</span><span class="o">.</span><span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">):</span>
+    <span class="n">kernel</span><span class="o">.</span><span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+
+<span class="c1"># We create a random Hamiltonian</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">SpinOperator</span><span class="o">.</span><span class="n">random</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">,</span> <span class="n">term_count</span><span class="p">)</span>
+
+<span class="c1"># The observe calls allows us to calculate the expectation value of the Hamiltonian with respect to a specified kernel.</span>
+
+<span class="c1"># Single node, single GPU.</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">)</span>
+<span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+<span class="c1"># If we have multiple GPUs/ QPUs available, we can parallelize the workflow with the addition of an argument in the observe call.</span>
+
+<span class="c1"># Single node, multi-GPU.</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">execution</span><span class="o">=</span><span class="n">cudaq</span><span class="o">.</span><span class="n">parallel</span><span class="o">.</span><span class="n">thread</span><span class="p">)</span>
+<span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+<span class="c1"># Multi-node, multi-GPU.</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">execution</span><span class="o">=</span><span class="n">cudaq</span><span class="o">.</span><span class="n">parallel</span><span class="o">.</span><span class="n">mpi</span><span class="p">)</span>
+<span class="n">result</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">mpi</span><span class="o">.</span><span class="n">finalize</span><span class="p">()</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>mpi is initialized?  True
+rank 0 num_ranks 1
+</pre></div>
+</div>
+</section>
+<section id="circuit-batching">
+<h3>Circuit Batching<a class="headerlink" href="#circuit-batching" title="Permalink to this heading">¶</a></h3>
+<p>Execution of parameterized circuits with different parameters can be
+executed asynchronously via the <code class="docutils literal notranslate"><span class="pre">mqpu</span></code> platform.</p>
+<img alt="../../_images/circsplit.png" src="../../_images/circsplit.png" />
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="k">if</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">num_available_gpus</span><span class="p">()</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;This example requires a GPU to run. No GPU detected.&quot;</span><span class="p">)</span>
+    <span class="n">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s2">&quot;nvidia&quot;</span><span class="p">,</span> <span class="n">option</span><span class="o">=</span><span class="s2">&quot;mqpu&quot;</span><span class="p">)</span>
+
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="mi">5</span>
+<span class="n">sample_count</span> <span class="o">=</span> <span class="mi">10000</span>
+<span class="n">h</span> <span class="o">=</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span>
+<span class="n">parameter_count</span> <span class="o">=</span> <span class="n">qubit_count</span>
+
+<span class="c1"># Below we run a circuit for 10000 different input parameters.</span>
+<span class="n">parameters</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">default_rng</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="n">low</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
+                                               <span class="n">high</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
+                                               <span class="n">size</span><span class="o">=</span><span class="p">(</span><span class="n">sample_count</span><span class="p">,</span>
+                                                     <span class="n">parameter_count</span><span class="p">))</span>
+
+<span class="n">kernel</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">make_kernel</span><span class="p">(</span><span class="nb">list</span><span class="p">)</span>
+
+<span class="n">qubits</span> <span class="o">=</span> <span class="n">kernel</span><span class="o">.</span><span class="n">qalloc</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+<span class="n">qubits_list</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">))</span>
+
+<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+    <span class="n">kernel</span><span class="o">.</span><span class="n">rx</span><span class="p">(</span><span class="n">params</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+</pre></div>
+</div>
+<p>Let’s time the execution on single GPU.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">timeit</span>
+
+<span class="n">timeit</span><span class="o">.</span><span class="n">timeit</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">h</span><span class="p">,</span> <span class="n">parameters</span><span class="p">),</span>
+              <span class="n">number</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>  <span class="c1"># Single GPU result.</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>31.7 s ± 990 ms per loop (mean ± std. dev. of 7 runs, 1 loop each)
+</pre></div>
+</div>
+<p>Now let’s try to time multi GPU run.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="nb">print</span><span class="p">(</span><span class="s1">&#39;We have&#39;</span><span class="p">,</span> <span class="n">parameters</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span>
+      <span class="s1">&#39;parameters which we would like to execute&#39;</span><span class="p">)</span>
+
+<span class="n">xi</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">split</span><span class="p">(</span>
+    <span class="n">parameters</span><span class="p">,</span>
+    <span class="mi">4</span><span class="p">)</span>  <span class="c1"># We split our parameters into 4 arrays since we have 4 GPUs available.</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="s1">&#39;We split this into&#39;</span><span class="p">,</span> <span class="nb">len</span><span class="p">(</span><span class="n">xi</span><span class="p">),</span> <span class="s1">&#39;batches of&#39;</span><span class="p">,</span> <span class="n">xi</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span>
+      <span class="n">xi</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">xi</span><span class="p">[</span><span class="mi">2</span><span class="p">]</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="s1">&#39;,&#39;</span><span class="p">,</span> <span class="n">xi</span><span class="p">[</span><span class="mi">3</span><span class="p">]</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">We</span> <span class="n">have</span> <span class="mi">10000</span> <span class="n">parameters</span> <span class="n">which</span> <span class="n">we</span> <span class="n">would</span> <span class="n">like</span> <span class="n">to</span> <span class="n">execute</span>
+<span class="n">We</span> <span class="n">split</span> <span class="n">this</span> <span class="n">into</span> <span class="mi">4</span> <span class="n">batches</span> <span class="n">of</span> <span class="mi">2500</span> <span class="p">,</span> <span class="mi">2500</span> <span class="p">,</span> <span class="mi">2500</span> <span class="p">,</span> <span class="mi">2500</span>
+</pre></div>
+</div>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Timing the execution on a single GPU vs 4 GPUs,</span>
+<span class="c1"># one will see a 4x performance improvement if 4 GPUs are available.</span>
+
+<span class="n">asyncresults</span> <span class="o">=</span> <span class="p">[]</span>
+<span class="n">num_gpus</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">num_available_gpus</span><span class="p">()</span>
+
+<span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">xi</span><span class="p">)):</span>
+    <span class="k">for</span> <span class="n">j</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">xi</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]):</span>
+        <span class="n">qpu_id</span> <span class="o">=</span> <span class="n">i</span> <span class="o">*</span> <span class="n">num_gpus</span> <span class="o">//</span> <span class="nb">len</span><span class="p">(</span><span class="n">xi</span><span class="p">)</span>
+        <span class="n">asyncresults</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+            <span class="n">cudaq</span><span class="o">.</span><span class="n">observe_async</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">h</span><span class="p">,</span> <span class="n">xi</span><span class="p">[</span><span class="n">i</span><span class="p">][</span><span class="n">j</span><span class="p">,</span> <span class="p">:],</span> <span class="n">qpu_id</span><span class="o">=</span><span class="n">qpu_id</span><span class="p">))</span>
+
+<span class="n">result</span> <span class="o">=</span> <span class="p">[</span><span class="n">res</span><span class="o">.</span><span class="n">get</span><span class="p">()</span> <span class="k">for</span> <span class="n">res</span> <span class="ow">in</span> <span class="n">asyncresults</span><span class="p">]</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>85.3 ms ± 2.36 ms per loop (mean ± std. dev. of 7 runs, 10 loops each)
+</pre></div>
+</div>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="multi_control.html" class="btn btn-neutral float-left" title="Multi-control Synthesis" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="bernstein_vazirani.html" class="btn btn-neutral float-right" title="Bernstein-Vazirani" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/noisy_simulation.html b/pr-2241/using/examples/noisy_simulation.html
new file mode 100644
index 0000000000..e238e8a7c5
--- /dev/null
+++ b/pr-2241/using/examples/noisy_simulation.html
@@ -0,0 +1,1234 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Noisy Simulation &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Using Quantum Hardware Providers" href="hardware_providers.html" />
+    <link rel="prev" title="Simulations with cuQuantum" href="cuquantum.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Noisy Simulation</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/noisy_simulation.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cuquantum.html" class="btn btn-neutral float-left" title="Simulations with cuQuantum" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hardware_providers.html" class="btn btn-neutral float-right" title="Using Quantum Hardware Providers" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="noisy-simulation">
+<h1>Noisy Simulation<a class="headerlink" href="#noisy-simulation" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q makes it simple to model noise within the simulation of your quantum program.
+Let’s take a look at the various built-in noise models we support, before concluding with a brief example of a custom noise model constructed from user-defined Kraus Operators.</p>
+<p>The following code illustrates how to run a simulation with depolarization noise.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># Set the target to our density matrix simulator.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;density-matrix-cpu&#39;</span><span class="p">)</span>
+
+<span class="c1"># CUDA-Q supports several different models of noise. In this</span>
+<span class="c1"># case, we will examine the modeling of depolarization noise. This</span>
+<span class="c1"># depolarization will result in the qubit state decaying into a mix</span>
+<span class="c1"># of the basis states, |0&gt; and |1&gt;, with a user provided probability.</span>
+
+<span class="c1"># We will begin by defining an empty noise model that we will add</span>
+<span class="c1"># our depolarization channel to.</span>
+<span class="n">noise</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+<span class="c1"># We define a depolarization channel setting the probability</span>
+<span class="c1"># of the qubit state being scrambled to `1.0`.</span>
+<span class="n">depolarization</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">DepolarizationChannel</span><span class="p">(</span><span class="mf">1.0</span><span class="p">)</span>
+
+<span class="c1"># We will apply the channel to any Y-gate on qubit 0. In other words,</span>
+<span class="c1"># for each Y-gate on our qubit, the qubit will have a `1.0`</span>
+<span class="c1"># probability of decaying into a mixed state.</span>
+<span class="n">noise</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s1">&#39;y&#39;</span><span class="p">,</span> <span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">depolarization</span><span class="p">)</span>
+
+
+<span class="c1"># Now we define our simple kernel function and allocate</span>
+<span class="c1"># a qubit to it.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="c1"># First we apply a Y-gate to the qubit.</span>
+    <span class="c1"># This will bring it to the |1&gt; state, where it will remain</span>
+    <span class="c1"># with a probability of `1 - p = 0.0`.</span>
+    <span class="n">y</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Without noise, the qubit should still be in the |1&gt; state.</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="n">counts</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+
+<span class="c1"># With noise, the measurements should be a roughly 50/50</span>
+<span class="c1"># mix between the |0&gt; and |1&gt; states.</span>
+<span class="n">noisy_counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise</span><span class="p">)</span>
+<span class="n">noisy_counts</span><span class="o">.</span><span class="n">dump</span><span class="p">()</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ noise_depolarization.cpp --target density-matrix-cpu -o dyn.x</span>
+<span class="c1">// &amp;&amp; ./dyn.x</span>
+<span class="c1">// ```</span>
+<span class="c1">//</span>
+<span class="c1">// Note: You must set the target to a density matrix backend for the noise</span>
+<span class="c1">// to successfully impact the system.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// CUDA-Q supports several different models of noise. In this</span>
+<span class="c1">// case, we will examine the modeling of depolarization noise. This</span>
+<span class="c1">// depolarization will result in the qubit state decaying into a mix</span>
+<span class="c1">// of the basis states, |0&gt; and |1&gt;, with a user-provided probability.</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// We will begin by defining an empty noise model that we will add</span>
+<span class="w">  </span><span class="c1">// our depolarization channel to.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">noise_model</span><span class="w"> </span><span class="n">noise</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// We define a depolarization channel setting the probability of the</span>
+<span class="w">  </span><span class="c1">// qubit state being scrambled to `1.0`.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">depolarization_channel</span><span class="w"> </span><span class="n">depolarization</span><span class="p">(</span><span class="mf">1.</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// We will apply the channel to any Y-gate on qubit 0. In other words,</span>
+<span class="w">  </span><span class="c1">// for each Y-gate on our qubit, the qubit will have a `1.0`</span>
+<span class="w">  </span><span class="c1">// probability of decaying into a mixed state.</span>
+<span class="w">  </span><span class="n">noise</span><span class="p">.</span><span class="n">add_channel</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">types</span><span class="o">::</span><span class="n">y</span><span class="o">&gt;</span><span class="p">({</span><span class="mi">0</span><span class="p">},</span><span class="w"> </span><span class="n">depolarization</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Our kernel will apply a Y-gate to qubit 0.</span>
+<span class="w">  </span><span class="c1">// This will bring the qubit to the |1&gt; state, where it will remain</span>
+<span class="w">  </span><span class="c1">// with a probability of `1 - p = 0.0`.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">y</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Now let&#39;s set the noise and we&#39;re ready to run the simulation!</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">set_noise</span><span class="p">(</span><span class="n">noise</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// With noise, the measurements should be a roughly 50/50</span>
+<span class="w">  </span><span class="c1">// mix between the |0&gt; and |1&gt; states.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noisy_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noisy_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// To confirm this, we can run the simulation again without noise.</span>
+<span class="w">  </span><span class="c1">// Without noise, the qubit should still be in the |1&gt; state.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">unset_noise</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noiseless_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noiseless_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The following code illustrates how to run a simulation with amplitude damping noise.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># Set the target to our density matrix simulator.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;density-matrix-cpu&#39;</span><span class="p">)</span>
+
+<span class="c1"># CUDA-Q supports several different models of noise. In this case,</span>
+<span class="c1"># we will examine the modeling of energy dissipation within our system</span>
+<span class="c1"># via environmental interactions. The result of this &quot;amplitude damping&quot;</span>
+<span class="c1"># is to return the qubit to the |0&gt; state with a user-specified probability.</span>
+
+<span class="c1"># We will begin by defining an empty noise model that we will add</span>
+<span class="c1"># our damping channel to.</span>
+<span class="n">noise</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+<span class="c1"># We define an amplitude damping channel setting to `1.0` the</span>
+<span class="c1"># probability of the qubit</span>
+<span class="c1"># decaying to the ground state.</span>
+<span class="n">amplitude_damping</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">AmplitudeDampingChannel</span><span class="p">(</span><span class="mf">1.0</span><span class="p">)</span>
+
+<span class="c1"># We will apply this channel to any Hadamard gate on the qubit.</span>
+<span class="c1"># In other words, after each Hadamard on the qubit, there will be a</span>
+<span class="c1"># probability of `1.0` that the qubit decays back to the ground state.</span>
+<span class="n">noise</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s1">&#39;h&#39;</span><span class="p">,</span> <span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">amplitude_damping</span><span class="p">)</span>
+
+
+<span class="c1"># Now we define our simple kernel function and allocate a qubit.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="c1"># Then we apply a Hadamard gate to the qubit.</span>
+    <span class="c1"># This will bring it to `1/sqrt(2) (|0&gt; + |1&gt;)`, where it will remain</span>
+    <span class="c1"># with a probability of `1 - p = 0.0`.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="c1"># Measure.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Now we&#39;re ready to run the noisy simulation of our kernel.</span>
+<span class="c1"># Note: We must pass the noise model to sample via keyword.</span>
+<span class="n">noisy_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noisy_result</span><span class="p">)</span>
+
+<span class="c1"># Our results should show all measurements in the |0&gt; state, indicating</span>
+<span class="c1"># that the noise has successfully impacted the system.</span>
+
+<span class="c1"># To confirm this, we can run the simulation again without noise.</span>
+<span class="c1"># The qubit will now have a 50/50 mix of measurements between</span>
+<span class="c1"># |0&gt; and |1&gt;.</span>
+<span class="n">noiseless_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noiseless_result</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ noise_amplitude_damping.cpp --target density-matrix-cpu -o dyn.x</span>
+<span class="c1">// &amp;&amp; ./dyn.x</span>
+<span class="c1">// ```</span>
+<span class="c1">//</span>
+<span class="c1">// Note: You must set the target to a density matrix backend for the noise</span>
+<span class="c1">// to successfully impact the system.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// CUDA-Q supports several different models of noise. In this case,</span>
+<span class="c1">// we will examine the modeling of energy dissipation within our system</span>
+<span class="c1">// via environmental interactions. The result of this &quot;amplitude damping&quot;</span>
+<span class="c1">// is to return the qubit to the |0&gt; state with a user-specified probability.</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// We will begin by defining an empty noise model that we will add</span>
+<span class="w">  </span><span class="c1">// our damping channel to.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">noise_model</span><span class="w"> </span><span class="n">noise</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// We define an amplitude damping channel setting the probability of</span>
+<span class="w">  </span><span class="c1">// the qubit decaying to the ground state to `1.0`.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">amplitude_damping_channel</span><span class="w"> </span><span class="n">ad</span><span class="p">(</span><span class="mf">1.</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// We will apply this channel to any Hadamard gate on the qubit.</span>
+<span class="w">  </span><span class="c1">// In other words, after each Hadamard on the qubit, there will be a</span>
+<span class="w">  </span><span class="c1">// probability of `1.0` that the qubit decays back to ground.</span>
+<span class="w">  </span><span class="n">noise</span><span class="p">.</span><span class="n">add_channel</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">types</span><span class="o">::</span><span class="n">h</span><span class="o">&gt;</span><span class="p">({</span><span class="mi">0</span><span class="p">},</span><span class="w"> </span><span class="n">ad</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// The Hadamard gate here will bring the qubit to `1/sqrt(2) (|0&gt; + |1&gt;)`,</span>
+<span class="w">  </span><span class="c1">// where it will remain with a probability of `1 - p = 0.0`.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Now let&#39;s set the noise and we&#39;re ready to run the simulation!</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">set_noise</span><span class="p">(</span><span class="n">noise</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Our results should show all measurements in the |0&gt; state, indicating</span>
+<span class="w">  </span><span class="c1">// that the noise has successfully impacted the system.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noisy_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noisy_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// To confirm this, we can run the simulation again without noise.</span>
+<span class="w">  </span><span class="c1">// The qubit will now have a 50/50 mix of measurements between</span>
+<span class="w">  </span><span class="c1">// |0&gt; and |1&gt;.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">unset_noise</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noiseless_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noiseless_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The following code illustrates how to run a simulation with bit-flip noise.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># Set the target to our density matrix simulator.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;density-matrix-cpu&#39;</span><span class="p">)</span>
+
+<span class="c1"># CUDA-Q supports several different models of noise. In this case,</span>
+<span class="c1"># we will examine the modeling of decoherence of the qubit state. This</span>
+<span class="c1"># will occur from &quot;bit flip&quot; errors, wherein the qubit has a user-specified</span>
+<span class="c1"># probability of undergoing an X-180 rotation.</span>
+
+<span class="c1"># We will begin by defining an empty noise model that we will add</span>
+<span class="c1"># these decoherence channels to.</span>
+<span class="n">noise</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+<span class="c1"># We define a bit-flip channel setting to `1.0` probability of the</span>
+<span class="c1"># qubit flipping 180 degrees about the X axis.</span>
+<span class="n">bit_flip</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">BitFlipChannel</span><span class="p">(</span><span class="mf">1.0</span><span class="p">)</span>
+<span class="c1"># We will apply this channel to any X gate on the qubit, giving each X-gate</span>
+<span class="c1"># a probability of `1.0` of undergoing an extra X-gate.</span>
+<span class="n">noise</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s1">&#39;x&#39;</span><span class="p">,</span> <span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">bit_flip</span><span class="p">)</span>
+
+
+<span class="c1"># Now we define our simple kernel function and allocate a register</span>
+<span class="c1"># of qubits to it.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="c1"># Apply an X-gate to the qubit.</span>
+    <span class="c1"># It will remain in the |1&gt; state with a probability of `1 - p = 0.0`.</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="c1"># Measure.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Now we&#39;re ready to run the noisy simulation of our kernel.</span>
+<span class="c1"># Note: We must pass the noise model to sample via keyword.</span>
+<span class="n">noisy_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noisy_result</span><span class="p">)</span>
+
+<span class="c1"># Our results should show all measurements in the |0&gt; state, indicating</span>
+<span class="c1"># that the noise has successfully impacted the system.</span>
+
+<span class="c1"># To confirm this, we can run the simulation again without noise.</span>
+<span class="c1"># We should now see the qubit in the |1&gt; state.</span>
+<span class="n">noiseless_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noiseless_result</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ noise_bit_flip.cpp --target density-matrix-cpu -o dyn.x</span>
+<span class="c1">// &amp;&amp; ./dyn.x</span>
+<span class="c1">// ```</span>
+<span class="c1">//</span>
+<span class="c1">// Note: You must set the target to a density matrix backend for the noise</span>
+<span class="c1">// to successfully impact the system.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// CUDA-Q supports several different models of noise. In this case,</span>
+<span class="c1">// we will examine the modeling of decoherence of the qubit state. This</span>
+<span class="c1">// will occur from &quot;bit flip&quot; errors, wherein the qubit has a user-specified</span>
+<span class="c1">// probability of undergoing an X-180 rotation.</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// We will begin by defining an empty noise model that we will add</span>
+<span class="w">  </span><span class="c1">// these decoherence channels to.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">noise_model</span><span class="w"> </span><span class="n">noise</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// We define a bit-flip channel setting the probability of the</span>
+<span class="w">  </span><span class="c1">// qubit flipping 180 degrees about the X axis to `1.0`.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">bit_flip_channel</span><span class="w"> </span><span class="n">bf</span><span class="p">(</span><span class="mf">1.</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// We will apply this channel to any X gate on the qubit, giving each X-gate</span>
+<span class="w">  </span><span class="c1">// a probability of `1.0` of undergoing an extra X-gate.</span>
+<span class="w">  </span><span class="n">noise</span><span class="p">.</span><span class="n">add_channel</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">types</span><span class="o">::</span><span class="n">x</span><span class="o">&gt;</span><span class="p">({</span><span class="mi">0</span><span class="p">},</span><span class="w"> </span><span class="n">bf</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// After the X-gate, the qubit will remain in the |1&gt; state with a probability</span>
+<span class="w">  </span><span class="c1">// of `1 - p = 0.0`.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Now let&#39;s set the noise and we&#39;re ready to run the simulation!</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">set_noise</span><span class="p">(</span><span class="n">noise</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Our results should show all measurements in the |0&gt; state, indicating</span>
+<span class="w">  </span><span class="c1">// that the noise has successfully impacted the system.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noisy_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noisy_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// To confirm this, we can run the simulation again without noise.</span>
+<span class="w">  </span><span class="c1">// We should now see the qubit in the |1&gt; state.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">unset_noise</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noiseless_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noiseless_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The following code illustrates how to run a simulation with phase-flip noise.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="c1"># Set the target to our density matrix simulator.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;density-matrix-cpu&#39;</span><span class="p">)</span>
+
+<span class="c1"># CUDA-Q supports several different models of noise. In this</span>
+<span class="c1"># case, we will examine the modeling of decoherence of the qubit phase.</span>
+<span class="c1"># This will occur from &quot;phase flip&quot; errors, wherein the qubit has a</span>
+<span class="c1"># user-specified probability of undergoing a Z-180 rotation.</span>
+
+<span class="c1"># We will begin by defining an empty noise model that we will add</span>
+<span class="c1"># our phase flip channel to.</span>
+<span class="n">noise</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+<span class="c1"># We define a phase-flip channel setting to `1.0` the probability of the qubit</span>
+<span class="c1"># undergoing a phase rotation of 180 degrees (π).</span>
+<span class="n">phase_flip</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">PhaseFlipChannel</span><span class="p">(</span><span class="mf">1.0</span><span class="p">)</span>
+<span class="c1"># We will apply this channel to any Z gate on the qubit.</span>
+<span class="c1"># In other words, after each Z gate on qubit 0, there will be a</span>
+<span class="c1"># probability of `1.0` that the qubit undergoes an extra</span>
+<span class="c1"># Z rotation.</span>
+<span class="n">noise</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s1">&#39;z&#39;</span><span class="p">,</span> <span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">phase_flip</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="c1"># Single qubit initialized to the |0&gt; state.</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="c1"># Place qubit in superposition state.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="c1"># Rotate the phase around Z by 180 degrees (π).</span>
+    <span class="n">z</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="c1"># Apply another Hadamard and measure.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Without noise, we&#39;d expect the qubit to end in the |1&gt;</span>
+<span class="c1"># state due to the phase rotation between the two Hadamard</span>
+<span class="c1"># gates.</span>
+<span class="n">noiseless_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noiseless_result</span><span class="p">)</span>
+
+<span class="c1"># With noise, our Z-gate will effectively cancel out due</span>
+<span class="c1"># to the presence of a phase flip error on the gate with a</span>
+<span class="c1"># probability of `1.0`. This will put us back in the |0&gt; state.</span>
+<span class="n">noisy_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noisy_result</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ noise_phase_flip.cpp --target density-matrix-cpu -o dyn.x</span>
+<span class="c1">// &amp;&amp; ./dyn.x</span>
+<span class="c1">// ```</span>
+<span class="c1">//</span>
+<span class="c1">// Note: You must set the target to a density matrix backend for the noise</span>
+<span class="c1">// to successfully impact the system.</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="c1">// CUDA-Q supports several different models of noise. In this</span>
+<span class="c1">// case, we will examine the modeling of decoherence of the qubit phase.</span>
+<span class="c1">// This will occur from &quot;phase flip&quot; errors, wherein the qubit has a</span>
+<span class="c1">// user-specified probability of undergoing a Z-180 rotation.</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="c1">// We will begin by defining an empty noise model that we will add</span>
+<span class="w">  </span><span class="c1">// our phase flip channel to.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">noise_model</span><span class="w"> </span><span class="n">noise</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// We define a phase-flip channel setting the probability of the</span>
+<span class="w">  </span><span class="c1">// qubit undergoing a phase rotation of 180 degrees (π) to `1.0`.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">phase_flip_channel</span><span class="w"> </span><span class="n">pf</span><span class="p">(</span><span class="mf">1.</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// We will apply this channel to any Z gate on the qubit.</span>
+<span class="w">  </span><span class="c1">// In other words, after each Z gate on qubit 0, there will be a</span>
+<span class="w">  </span><span class="c1">// probability of `1.0` that the qubit undergoes an extra</span>
+<span class="w">  </span><span class="c1">// Z rotation.</span>
+<span class="w">  </span><span class="n">noise</span><span class="p">.</span><span class="n">add_channel</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">types</span><span class="o">::</span><span class="n">z</span><span class="o">&gt;</span><span class="p">({</span><span class="mi">0</span><span class="p">},</span><span class="w"> </span><span class="n">pf</span><span class="p">);</span>
+
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">kernel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="c1">// Place qubit in superposition state.</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="c1">// Rotate on Z by 180 degrees.</span>
+<span class="w">    </span><span class="n">z</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="c1">// Apply another Hadamard.</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Now let&#39;s set the noise and we&#39;re ready to run the simulation!</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">set_noise</span><span class="p">(</span><span class="n">noise</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// With noise, our Z-gate will effectively cancel out due</span>
+<span class="w">  </span><span class="c1">// to the presence of a phase-flip error on the gate with a</span>
+<span class="w">  </span><span class="c1">// probability of `1.0`. This will put us back in the |0&gt; state.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noisy_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noisy_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// To confirm this, we can run the simulation again without noise.</span>
+<span class="w">  </span><span class="c1">// Without noise, we&#39;d expect the qubit to end in the |1&gt; state due</span>
+<span class="w">  </span><span class="c1">// to the phase rotation between the two Hadamard gates.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">unset_noise</span><span class="p">();</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">noiseless_counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">);</span>
+<span class="w">  </span><span class="n">noiseless_counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>The following code illustrates how to run a simulation with a custom noise model.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--4-input--1" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># Set the target to our density matrix simulator.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_target</span><span class="p">(</span><span class="s1">&#39;density-matrix-cpu&#39;</span><span class="p">)</span>
+
+<span class="c1"># CUDA-Q supports custom noise models through the definition of</span>
+<span class="c1"># `KrausChannel`&#39;s. In this case, we will define a set of `KrausOperator`&#39;s</span>
+<span class="c1"># that  affect the same noise as the `AmplitudeDampingChannel`. This</span>
+<span class="c1"># channel will model the energy dissipation within our system via</span>
+<span class="c1"># environmental interactions. With a variable probability, it will</span>
+<span class="c1"># return the qubit to the |0&gt; state.</span>
+
+<span class="c1"># We will begin by defining an empty noise model that we will add</span>
+<span class="c1"># our Kraus Channel to.</span>
+<span class="n">noise</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">NoiseModel</span><span class="p">()</span>
+
+
+<span class="c1"># We will define our Kraus Operators within functions, as to</span>
+<span class="c1"># allow for easy control over the noise probability.</span>
+<span class="k">def</span> <span class="nf">kraus_operators</span><span class="p">(</span><span class="n">probability</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;See Nielsen, Chuang Chapter 8.3.5 for definition source.&quot;&quot;&quot;</span>
+    <span class="n">kraus_0</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">],</span> <span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="mi">1</span> <span class="o">-</span> <span class="n">probability</span><span class="p">)]],</span>
+                       <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+    <span class="n">kraus_1</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mi">0</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">sqrt</span><span class="p">(</span><span class="n">probability</span><span class="p">)],</span> <span class="p">[</span><span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">]],</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">complex128</span><span class="p">)</span>
+    <span class="k">return</span> <span class="p">[</span><span class="n">kraus_0</span><span class="p">,</span> <span class="n">kraus_1</span><span class="p">]</span>
+
+
+<span class="c1"># We manually define an amplitude damping channel setting to `1.0`</span>
+<span class="c1"># the probability of the qubit decaying to the ground state.</span>
+<span class="n">amplitude_damping</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">KrausChannel</span><span class="p">(</span><span class="n">kraus_operators</span><span class="p">(</span><span class="mf">1.0</span><span class="p">))</span>
+
+<span class="c1"># We will apply this channel to any Hadamard gate on the qubit.</span>
+<span class="c1"># In other words, after each Hadamard on the qubit, there will be a</span>
+<span class="c1"># probability of `1.0` that the qubit decays back to ground.</span>
+<span class="n">noise</span><span class="o">.</span><span class="n">add_channel</span><span class="p">(</span><span class="s1">&#39;h&#39;</span><span class="p">,</span> <span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">amplitude_damping</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+    <span class="c1"># Then we apply a Hadamard gate to the qubit.</span>
+    <span class="c1"># This will bring it to `1/sqrt(2) (|0&gt; + |1&gt;)`, where it will remain</span>
+    <span class="c1"># with a probability of `1 - p = 0.0`.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+    <span class="c1"># Measure.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Now we&#39;re ready to run the noisy simulation of our kernel.</span>
+<span class="c1"># Note: We must pass the noise model to sample via keyword.</span>
+<span class="n">noisy_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span> <span class="n">noise_model</span><span class="o">=</span><span class="n">noise</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noisy_result</span><span class="p">)</span>
+
+<span class="c1"># Our results should show all measurements in the |0&gt; state, indicating</span>
+<span class="c1"># that the noise has successfully impacted the system.</span>
+
+<span class="c1"># To confirm this, we can run the simulation again without noise.</span>
+<span class="c1"># The qubit will now have a 50/50 mix of measurements between</span>
+<span class="c1"># |0&gt; and |1&gt;.</span>
+<span class="n">noiseless_result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">noiseless_result</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--4-input--2" name="tab-set--4" type="radio"><label class="tab-label" for="tab-set--4-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ noise_modeling.cpp --target density-matrix-cpu -o noise.x &amp;&amp; ./noise.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq.h&quot;</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Define a  kernel</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">xgate</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[]()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">};</span>
+
+<span class="w">  </span><span class="c1">// Run noise-less simulation</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">xgate</span><span class="p">);</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Create a depolarizing Kraus channel made up of two Kraus operators.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">kraus_channel</span><span class="w"> </span><span class="n">depol</span><span class="p">({</span><span class="n">cudaq</span><span class="o">::</span><span class="n">complex</span><span class="p">{</span><span class="mf">0.99498743710662</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.99498743710662</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">}},</span>
+
+<span class="w">                             </span><span class="p">{</span><span class="n">cudaq</span><span class="o">::</span><span class="n">complex</span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.05773502691896258</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.05773502691896258</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">}},</span>
+
+<span class="w">                             </span><span class="p">{</span><span class="n">cudaq</span><span class="o">::</span><span class="n">complex</span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">-0.05773502691896258</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.05773502691896258</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">}},</span>
+
+<span class="w">                             </span><span class="p">{</span><span class="n">cudaq</span><span class="o">::</span><span class="n">complex</span><span class="p">{</span><span class="mf">0.05773502691896258</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">0.0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">},</span>
+<span class="w">                              </span><span class="p">{</span><span class="mf">-0.05773502691896258</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">}});</span>
+
+<span class="w">  </span><span class="c1">// Create the noise model</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">noise_model</span><span class="w"> </span><span class="n">noise</span><span class="p">;</span>
+<span class="w">  </span><span class="c1">// Add the Kraus channel to the x operation on qubit 0.</span>
+<span class="w">  </span><span class="n">noise</span><span class="p">.</span><span class="n">add_channel</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">types</span><span class="o">::</span><span class="n">x</span><span class="o">&gt;</span><span class="p">({</span><span class="mi">0</span><span class="p">},</span><span class="w"> </span><span class="n">depol</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Set the noise model</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">set_noise</span><span class="p">(</span><span class="n">noise</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Run the noisy simulation</span>
+<span class="w">  </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">xgate</span><span class="p">);</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="c1">// Unset the noise model when done. This is not necessary in this case, but it</span>
+<span class="w">  </span><span class="c1">// is good practice in order to avoid interference with future simulations.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">unset_noise</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cuquantum.html" class="btn btn-neutral float-left" title="Simulations with cuQuantum" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="hardware_providers.html" class="btn btn-neutral float-right" title="Using Quantum Hardware Providers" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/qaoa.html b/pr-2241/using/examples/qaoa.html
new file mode 100644
index 0000000000..25e021bd12
--- /dev/null
+++ b/pr-2241/using/examples/qaoa.html
@@ -0,0 +1,833 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quantum Approximate Optimization Algorithm &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Simulations with cuQuantum" href="cuquantum.html" />
+    <link rel="prev" title="Variational Quantum Eigensolver" href="vqe.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Quantum Approximate Optimization Algorithm</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/qaoa.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="vqe.html" class="btn btn-neutral float-left" title="Variational Quantum Eigensolver" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cuquantum.html" class="btn btn-neutral float-right" title="Simulations with cuQuantum" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-approximate-optimization-algorithm">
+<h1>Quantum Approximate Optimization Algorithm<a class="headerlink" href="#quantum-approximate-optimization-algorithm" title="Permalink to this heading">¶</a></h1>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<p>Let’s now see how we can implement the Quantum Approximate Optimization Algorithm (QAOA) to compute the Max-Cut of a rectangular graph by leveraging
+<code class="code docutils literal notranslate"><span class="pre">cudaq:vqe</span></code>. For more on the QAOA algorithm and the Max-Cut problem, refer to
+<a class="reference external" href="https://arxiv.org/abs/1411.4028">this paper</a>.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+
+<span class="c1"># Here we build up a kernel for QAOA with `p` layers, with each layer</span>
+<span class="c1"># containing the alternating set of unitaries corresponding to the problem</span>
+<span class="c1"># and the mixer Hamiltonians. The algorithm leverages the VQE algorithm</span>
+<span class="c1"># to compute the Max-Cut of a rectangular graph illustrated below.</span>
+
+<span class="c1">#       v0  0---------------------0 v1</span>
+<span class="c1">#           |                     |</span>
+<span class="c1">#           |                     |</span>
+<span class="c1">#           |                     |</span>
+<span class="c1">#           |                     |</span>
+<span class="c1">#       v3  0---------------------0 v2</span>
+<span class="c1"># The Max-Cut for this problem is 0101 or 1010.</span>
+
+<span class="c1"># The problem Hamiltonian</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span> \
+       <span class="o">+</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span> <span class="o">+</span> <span class="mf">0.5</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span>
+
+<span class="c1"># Problem parameters.</span>
+<span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">4</span>
+<span class="n">layer_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">2</span>
+<span class="n">parameter_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">2</span> <span class="o">*</span> <span class="n">layer_count</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel_qaoa</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">layer_count</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">thetas</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;QAOA ansatz for Max-Cut&quot;&quot;&quot;</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+
+    <span class="c1"># Create superposition</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qvector</span><span class="p">)</span>
+
+    <span class="c1"># Loop over the layers</span>
+    <span class="k">for</span> <span class="n">layer</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">layer_count</span><span class="p">):</span>
+        <span class="c1"># Loop over the qubits</span>
+        <span class="c1"># Problem unitary</span>
+        <span class="k">for</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+            <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[(</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">%</span> <span class="n">qubit_count</span><span class="p">])</span>
+            <span class="n">rz</span><span class="p">(</span><span class="mf">2.0</span> <span class="o">*</span> <span class="n">thetas</span><span class="p">[</span><span class="n">layer</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[(</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">%</span> <span class="n">qubit_count</span><span class="p">])</span>
+            <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[(</span><span class="n">qubit</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">%</span> <span class="n">qubit_count</span><span class="p">])</span>
+
+        <span class="c1"># Mixer unitary</span>
+        <span class="k">for</span> <span class="n">qubit</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">):</span>
+            <span class="n">rx</span><span class="p">(</span><span class="mf">2.0</span> <span class="o">*</span> <span class="n">thetas</span><span class="p">[</span><span class="n">layer</span> <span class="o">+</span> <span class="n">layer_count</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="n">qubit</span><span class="p">])</span>
+
+
+<span class="c1"># Specify the optimizer and its initial parameters. Make it repeatable.</span>
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_random_seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">COBYLA</span><span class="p">()</span>
+<span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>
+<span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">random</span><span class="o">.</span><span class="n">uniform</span><span class="p">(</span><span class="o">-</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">8.0</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">pi</span> <span class="o">/</span> <span class="mf">8.0</span><span class="p">,</span>
+                                                 <span class="n">parameter_count</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Initial parameters = &quot;</span><span class="p">,</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">initial_parameters</span><span class="p">)</span>
+
+
+<span class="c1"># Define the objective, return `&lt;state(params) | H | state(params)&gt;`</span>
+<span class="k">def</span> <span class="nf">objective</span><span class="p">(</span><span class="n">parameters</span><span class="p">):</span>
+    <span class="k">return</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span><span class="n">kernel_qaoa</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">layer_count</span><span class="p">,</span>
+                         <span class="n">parameters</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+
+
+<span class="c1"># Optimize!</span>
+<span class="n">optimal_expectation</span><span class="p">,</span> <span class="n">optimal_parameters</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span>
+    <span class="n">dimensions</span><span class="o">=</span><span class="n">parameter_count</span><span class="p">,</span> <span class="n">function</span><span class="o">=</span><span class="n">objective</span><span class="p">)</span>
+
+<span class="c1"># Print the optimized value and its parameters</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Optimal value = &quot;</span><span class="p">,</span> <span class="n">optimal_expectation</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Optimal parameters = &quot;</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">)</span>
+
+<span class="c1"># Sample the circuit using the optimized parameters</span>
+<span class="n">counts</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel_qaoa</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">,</span> <span class="n">layer_count</span><span class="p">,</span> <span class="n">optimal_parameters</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">counts</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<p>Let’s now see how we can implement the Quantum Approximate Optimization Algorithm (QAOA) to compute the Max-Cut of a rectangular graph
+For more on the QAOA algorithm and the Max-Cut problem, refer to
+<a class="reference external" href="https://arxiv.org/abs/1411.4028">this paper</a>.</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/gradients.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/optimizers.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/spin_op.h&gt;</span>
+
+<span class="c1">// Here we build up a CUDA-Q kernel for QAOA with p layers, with each</span>
+<span class="c1">// layer containing the alternating set of unitaries corresponding to the</span>
+<span class="c1">// problem and the mixer Hamiltonians. The algorithm leverages the CUDA-Q</span>
+<span class="c1">// VQE support to compute the Max-Cut of a rectangular graph illustrated below.</span>
+<span class="c1">//</span>
+<span class="c1">//        v0  0---------------------0 v1</span>
+<span class="c1">//            |                     |</span>
+<span class="c1">//            |                     |</span>
+<span class="c1">//            |                     |</span>
+<span class="c1">//            |                     |</span>
+<span class="c1">//        v3  0---------------------0 v2</span>
+<span class="c1">// The Max-Cut for this problem is 0101 or 1010.</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">ansatz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">theta</span><span class="p">,</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span>
+<span class="w">                  </span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_layers</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">);</span>
+
+<span class="w">    </span><span class="c1">// Prepare the initial state by superposition</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+
+<span class="w">    </span><span class="c1">// Loop over all the layers</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_layers</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="c1">// Problem Hamiltonian</span>
+<span class="w">      </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">j</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">        </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">j</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[(</span><span class="n">j</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">%</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">]);</span>
+<span class="w">        </span><span class="n">rz</span><span class="p">(</span><span class="mf">2.0</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">theta</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[(</span><span class="n">j</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">%</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">]);</span>
+<span class="w">        </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">j</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[(</span><span class="n">j</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">%</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">]);</span>
+<span class="w">      </span><span class="p">}</span>
+
+<span class="w">      </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">j</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">j</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="c1">// Mixer Hamiltonian</span>
+<span class="w">        </span><span class="n">rx</span><span class="p">(</span><span class="mf">2.0</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">theta</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="n">n_layers</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">j</span><span class="p">]);</span>
+<span class="w">      </span><span class="p">}</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">cudaq</span><span class="o">::</span><span class="nn">spin</span><span class="p">;</span>
+
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">set_random_seed</span><span class="p">(</span><span class="mi">13</span><span class="p">);</span><span class="w"> </span><span class="c1">// set for repeatability</span>
+
+<span class="w">  </span><span class="c1">// Problem Hamiltonian</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">Hp</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0.5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">0.5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="o">+</span>
+<span class="w">                            </span><span class="mf">0.5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">3</span><span class="p">)</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">0.5</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">z</span><span class="p">(</span><span class="mi">3</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Problem parameters</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_qubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">4</span><span class="p">;</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_layers</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_params</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">n_layers</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Instantiate the optimizer</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">optimizers</span><span class="o">::</span><span class="n">cobyla</span><span class="w"> </span><span class="n">optimizer</span><span class="p">;</span><span class="w"> </span><span class="c1">// gradient-free COBYLA</span>
+
+<span class="w">  </span><span class="c1">// Set initial values for the optimization parameters</span>
+<span class="w">  </span><span class="n">optimizer</span><span class="p">.</span><span class="n">initial_parameters</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">random_vector</span><span class="p">(</span>
+<span class="w">      </span><span class="o">-</span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.0</span><span class="p">,</span><span class="w"> </span><span class="n">M_PI</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="mf">8.0</span><span class="p">,</span><span class="w"> </span><span class="n">n_params</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">mt19937</span><span class="o">::</span><span class="n">default_seed</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Call the optimizer</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">opt_val</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">]</span><span class="w"> </span><span class="o">=</span>
+<span class="w">      </span><span class="n">cudaq</span><span class="o">::</span><span class="n">vqe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">{},</span><span class="w"> </span><span class="n">Hp</span><span class="p">,</span><span class="w"> </span><span class="n">optimizer</span><span class="p">,</span><span class="w"> </span><span class="n">n_params</span><span class="p">,</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span><span class="w"> </span><span class="n">n_layers</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Print the optimized value and the parameters</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Optimal value = %.16lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">opt_val</span><span class="p">);</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Optimal params = (%.16lf, %.16lf, %.16lf, %.16lf) </span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span>
+<span class="w">         </span><span class="n">opt_params</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">opt_params</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span><span class="w"> </span><span class="n">opt_params</span><span class="p">[</span><span class="mi">3</span><span class="p">]);</span>
+
+<span class="w">  </span><span class="c1">// Sample the circuit using optimized parameters</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">counts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">ansatz</span><span class="p">{},</span><span class="w"> </span><span class="n">opt_params</span><span class="p">,</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span><span class="w"> </span><span class="n">n_layers</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Dump the states and the counts</span>
+<span class="w">  </span><span class="n">counts</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span>
+
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="vqe.html" class="btn btn-neutral float-left" title="Variational Quantum Eigensolver" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cuquantum.html" class="btn btn-neutral float-right" title="Simulations with cuQuantum" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/quantum_operations.html b/pr-2241/using/examples/quantum_operations.html
new file mode 100644
index 0000000000..c9dc94afba
--- /dev/null
+++ b/pr-2241/using/examples/quantum_operations.html
@@ -0,0 +1,849 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quantum Computing 101 &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Visualization" href="../../examples/python/tutorials/visualization.html" />
+    <link rel="prev" title="Introduction" href="introduction.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Quantum Computing 101</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/quantum_operations.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="introduction.html" class="btn btn-neutral float-left" title="Introduction" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../examples/python/tutorials/visualization.html" class="btn btn-neutral float-right" title="Visualization" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quantum-computing-101">
+<h1>Quantum Computing 101<a class="headerlink" href="#quantum-computing-101" title="Permalink to this heading">¶</a></h1>
+<p>The fundamental unit of classical information storage, processing and
+transmission is the bit. Analogously, we define its quantum counterpart,
+a quantum bit or simply the qubit.</p>
+<p>Classical bits are transistor elements whose states can be altered to
+perform computations. Similarly qubits too have physical realizations
+within superconducting materials, ion-traps and photonic systems. We
+shall not concern ourselves with specific qubit architectures but rather
+think of them as systems which obey the laws of quantum mechanics and
+the mathematical language physicists have developed to describe the
+theory: linear algebra.</p>
+<section id="quantum-states">
+<h2>Quantum States<a class="headerlink" href="#quantum-states" title="Permalink to this heading">¶</a></h2>
+<p>Information storage scales linearly if bits have a single state. Access
+to multiple states, namely a 0 and a 1 allows for information encoding
+to scale logarithmically. Similarly we define a qubit to have the states
+<span class="math notranslate nohighlight">\(\ket{0}\)</span> and <span class="math notranslate nohighlight">\(\ket{1}\)</span> in Dirac notation where:</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}\ket{0} = \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix}\end{split}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}\ket{1} = \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}\end{split}\]</div>
+<p>Rather than just the two states each classical bit can be in,
+quantum theory allows one to explore linear combinations of states,
+also called superpositions:</p>
+<div class="math notranslate nohighlight">
+\[\ket{\psi} = \alpha\ket{0} + \beta\ket{1}\]</div>
+<p>where <span class="math notranslate nohighlight">\(\alpha\)</span> and <span class="math notranslate nohighlight">\(\beta\)</span> <span class="math notranslate nohighlight">\(\in \mathbb{C}\)</span>. It is
+important to note that this is still the state of one qubit;
+although we have two kets, they both represent a
+superposition state of one qubit.</p>
+<p>If we have two classical bits, the possible states we could encode
+information in would be 00, 01, 10 and 11. Correspondingly, multiple
+qubits can be combined and the possible combinations of their states
+used to process information.</p>
+<p>A two qubit system has four computational basis states:
+<span class="math notranslate nohighlight">\(\ket{00}, \ket{01}, \ket{10}, \ket{11}\)</span>.</p>
+<p>More generally, the quantum state of a <span class="math notranslate nohighlight">\(n\)</span> qubit system is written
+as a sum of <span class="math notranslate nohighlight">\(2^n\)</span> possible basis states where the coefficients
+track the probability of the system collapsing into that state if a
+measurement is applied.</p>
+<p>For <span class="math notranslate nohighlight">\(n = 500\)</span>, <span class="math notranslate nohighlight">\(2^n \approx 10^{150}\)</span> which is greater than
+the number of atoms in the universe. Storing the complex numbers
+associated with <span class="math notranslate nohighlight">\(2^{500}\)</span> amplitudes would not be feasible using
+bits and classical computations but nature seems to only require 500
+qubits to do so. The art of quantum computation is thus to build quantum
+systems that we can manipulate with fine precision such that evolving a
+large statevector can be offloaded onto a quantum computer.</p>
+</section>
+<section id="quantum-gates">
+<h2>Quantum Gates<a class="headerlink" href="#quantum-gates" title="Permalink to this heading">¶</a></h2>
+<p>We can manipulate the state of a qubit via quantum gates.
+For example, the Pauli X gate allows us to flip the state of the qubit:</p>
+<div class="math notranslate nohighlight">
+\[X \ket{0} = \ket{1}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}\begin{bmatrix} 0 &amp; 1 \\ 1 &amp; 0 \end{bmatrix} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} = \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}\end{split}\]</div>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="c1"># A single qubit initialized to the ground / zero state.</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+    <span class="c1"># Apply the Pauli x gate to the qubit.</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+    <span class="c1"># Measurement operator.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="c1"># Sample the qubit for 1000 shots to gather statistics.</span>
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">most_probable</span><span class="p">())</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">{</span> <span class="mi">1</span><span class="p">:</span><span class="mi">1000</span> <span class="p">}</span>
+</pre></div>
+</div>
+<p>The Hadamard gate allows us to put the qubit in an equal superposition
+state:</p>
+<div class="math notranslate nohighlight">
+\[H \ket{0} =  \tfrac{1}{\sqrt{2}} \ket{0} + \tfrac{1}{\sqrt{2}} \ket{1}  \equiv \ket{+}\]</div>
+<div class="math notranslate nohighlight">
+\[\begin{split}\tfrac{1}{\sqrt{2}}\begin{bmatrix} 1 &amp; 1 \\ 1 &amp; -1 \end{bmatrix} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} = \tfrac{1}{\sqrt{2}} \begin{bmatrix} 1 \\ 0 \\ \end{bmatrix} + \tfrac{1}{\sqrt{2}} \begin{bmatrix} 0 \\ 1 \\ \end{bmatrix}.\end{split}\]</div>
+<p>The probability of finding the qubit in the <span class="math notranslate nohighlight">\(\ket{0}\)</span> or <span class="math notranslate nohighlight">\(\ket{1}\)</span> state is hence
+<span class="math notranslate nohighlight">\(\lvert \tfrac{1}{\sqrt{2}} \rvert ^2 = \tfrac{1}{2}\)</span>. Lets verify
+this with some code:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="c1"># A single qubit initialized to the ground/ zero state.</span>
+    <span class="n">qubit</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qubit</span><span class="p">()</span>
+
+    <span class="c1"># Apply Hadamard gate to single qubit to put it in equal superposition.</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+    <span class="c1"># Measurement operator.</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubit</span><span class="p">)</span>
+
+
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measured |0&gt; with probability &quot;</span> <span class="o">+</span>
+      <span class="nb">str</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;0&quot;</span><span class="p">]</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">values</span><span class="p">())))</span>
+<span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Measured |1&gt; with probability &quot;</span> <span class="o">+</span>
+      <span class="nb">str</span><span class="p">(</span><span class="n">result</span><span class="p">[</span><span class="s2">&quot;1&quot;</span><span class="p">]</span> <span class="o">/</span> <span class="nb">sum</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">values</span><span class="p">())))</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">{</span> <span class="mi">0</span><span class="p">:</span><span class="mi">502</span> <span class="mi">1</span><span class="p">:</span><span class="mi">498</span> <span class="p">}</span>
+</pre></div>
+</div>
+<p>For a qubit in a superposition state, quantum gates
+act linearly:</p>
+<div class="math notranslate nohighlight">
+\[X (\alpha\ket{0} + \beta\ket{1}) = \alpha\ket{1} + \beta\ket{0}\]</div>
+<p>As we evolve quantum states via quantum gates, the normalization
+condition requires that the sum of modulus squared of amplitudes must
+equal 1 at all times:</p>
+<div class="math notranslate nohighlight">
+\[\ket{\psi} = \alpha\ket{0} + \beta\ket{1},          |\alpha|^2 + |\beta|^2 = 1.\]</div>
+<p>This is to adhere to the conservation of probabilities which translates
+to a constraint on types of quantum gates we can define.
+For a general quantum state <span class="math notranslate nohighlight">\(\ket{\psi}\)</span>, upholding the
+normalization condition requires quantum gates to be unitary, that is
+<span class="math notranslate nohighlight">\(U^{\dagger}U = U^{*^{T}}U = \mathbb{I}\)</span>.</p>
+<p>Just like the single-qubit gates above, we can define
+multi-qubit gates to act on multiple-qubits.
+The controlled-NOT or CNOT gate, for example, acts on 2 qubits: the control qubit and
+the target qubit. Its effect is to flip the target if the control is in
+the excited <span class="math notranslate nohighlight">\(\ket{1}\)</span> state.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="c1"># 2 qubits both initialized to the ground/ zero state.</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+    <span class="c1"># Controlled-not gate operation.</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+
+
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>
+</pre></div>
+</div>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">{</span> <span class="mi">11</span><span class="p">:</span><span class="mi">1000</span> <span class="p">}</span>
+</pre></div>
+</div>
+<p>The CNOT gate in matrix notation is represented as</p>
+<div class="math notranslate nohighlight">
+\[\begin{split}CNOT \equiv \begin{bmatrix} 1 &amp; 0 &amp; 0 &amp; 0 \\ 0 &amp; 1 &amp; 0 &amp; 0 \\ 0 &amp; 0 &amp; 0 &amp; 1 \\ 0 &amp; 0 &amp; 1 &amp; 0 \end{bmatrix}\end{split}\]</div>
+<p>and one can check that <span class="math notranslate nohighlight">\(CNOT^\dagger CNOT = \mathbb{I}\)</span>.
+Its effect on the computational basis states is:</p>
+<div class="math notranslate nohighlight">
+\[CNOT\ket{00} = \ket{00}\]</div>
+<div class="math notranslate nohighlight">
+\[CNOT\ket{01} = \ket{01}\]</div>
+<div class="math notranslate nohighlight">
+\[CNOT\ket{10} = \ket{11}\]</div>
+<div class="math notranslate nohighlight">
+\[CNOT\ket{11} = \ket{10}\]</div>
+<p>For a full list of gates supported in CUDA-Q see <a class="reference internal" href="../../api/default_ops.html"><span class="doc">Quantum Operations</span></a>.</p>
+</section>
+<section id="measurements">
+<h2>Measurements<a class="headerlink" href="#measurements" title="Permalink to this heading">¶</a></h2>
+<p>Quantum theory is probabilistic and hence requires statistical inference
+to derive observations. Prior to measurement, the state of a qubit is
+all possible combinations of <span class="math notranslate nohighlight">\(\alpha\)</span> and <span class="math notranslate nohighlight">\(\beta\)</span> and upon
+measurement, wavefunction collapse yields either a classical 0 or 1.</p>
+<p>The mathematical theory devised to explain quantum phenomena tells us
+that the probability of observing the qubit in the state
+<span class="math notranslate nohighlight">\(\ket{0}\)</span> or <span class="math notranslate nohighlight">\(\ket{1}\)</span>, yielding a classical 0 or 1, is
+<span class="math notranslate nohighlight">\(\lvert \alpha \rvert ^2\)</span> or <span class="math notranslate nohighlight">\(\lvert \beta \rvert ^2\)</span>, respectively.</p>
+<p>As we see in the example of the Hadamard gate above,
+the result 0 or 1 each is yielded roughly 50% of the times as predicted
+by the postulate stated above thus proving the theory.</p>
+<p>Classically, we cannot encode information within states such as 00 + 11
+but quantum mechanics allows us to write linear superpositions</p>
+<div class="math notranslate nohighlight">
+\[\ket{\psi} = \alpha_{00}\ket{00} + \alpha_{01}\ket{01} + \alpha_{10}\ket{10} + \alpha_{11}\ket{11}\]</div>
+<p>where the probability of measuring <span class="math notranslate nohighlight">\(x = 00, 01, 10, 11\)</span> occurs
+with probability <span class="math notranslate nohighlight">\(\lvert \alpha_{x} \rvert ^2\)</span> with the
+normalization condition that
+<span class="math notranslate nohighlight">\(\sum_{x \in \{ 0,1 \}^2} \lvert \alpha_{x} \rvert ^2 = 1\)</span>.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="introduction.html" class="btn btn-neutral float-left" title="Introduction" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../examples/python/tutorials/visualization.html" class="btn btn-neutral float-right" title="Visualization" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/examples/vqe.html b/pr-2241/using/examples/vqe.html
new file mode 100644
index 0000000000..3aa484161b
--- /dev/null
+++ b/pr-2241/using/examples/vqe.html
@@ -0,0 +1,912 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Variational Quantum Eigensolver &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Quantum Approximate Optimization Algorithm" href="qaoa.html" />
+    <link rel="prev" title="Bernstein-Vazirani" href="bernstein_vazirani.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="examples.html">   Examples</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="examples.html">CUDA-Q by Example</a></li>
+      <li class="breadcrumb-item active">Variational Quantum Eigensolver</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/examples/vqe.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="bernstein_vazirani.html" class="btn btn-neutral float-left" title="Bernstein-Vazirani" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="qaoa.html" class="btn btn-neutral float-right" title="Quantum Approximate Optimization Algorithm" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="variational-quantum-eigensolver">
+<h1>Variational Quantum Eigensolver<a class="headerlink" href="#variational-quantum-eigensolver" title="Permalink to this heading">¶</a></h1>
+<p>The Variational Quantum Eigensolver (VQE) algorithm, originally proposed in
+<a class="reference external" href="https://arxiv.org/abs/1304.3061">this publication</a>,
+is a hybrid algorithm that can make use of both quantum and classical resources.</p>
+<p>Let’s take a look at how we can use CUDA-Q’s built-in <code class="code docutils literal notranslate"><span class="pre">vqe</span></code> module to run our own custom VQE routines!
+Given a parameterized quantum kernel, a system spin Hamiltonian, and one of CUDA-Q’s optimizers,
+<code class="code docutils literal notranslate"><span class="pre">cudaq.vqe</span></code> will find and return the optimal set of parameters that minimize the energy, &lt;Z&gt;, of the system.</p>
+<p>The code block below represents the contents of a file titled <code class="code docutils literal notranslate"><span class="pre">simple_vqe.py</span></code>.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+
+<span class="c1"># We begin by defining the spin Hamiltonian for the system that we are working</span>
+<span class="c1"># with. This is achieved through the use of `cudaq.SpinOperator`&#39;s, which allow</span>
+<span class="c1"># for the convenient creation of complex Hamiltonians out of Pauli spin operators.</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span>
+    <span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+
+
+<span class="c1"># Next, using the `cudaq.Kernel`, we define the variational quantum circuit</span>
+<span class="c1"># that we&#39;d like to use as an ansatz.</span>
+<span class="c1"># Create a kernel that takes a list of floats as a function argument.</span>
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angles</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+    <span class="c1"># Allocate 2 qubits.</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="c1"># Apply an `ry` gate that is parameterized by the first value</span>
+    <span class="c1"># of our `angles`.</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="c1"># Note: the kernel must not contain measurement instructions.</span>
+
+
+<span class="c1"># The last thing we need is to pick an optimizer from the suite of `cudaq.optimizers`.</span>
+<span class="c1"># We can optionally tune this optimizer through its initial parameters, iterations,</span>
+<span class="c1"># optimization bounds, etc. before passing it to `cudaq.vqe`.</span>
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">COBYLA</span><span class="p">()</span>
+<span class="c1"># optimizer.max_iterations = ...</span>
+<span class="c1"># optimizer...</span>
+
+<span class="c1"># Finally, we pass all of that into `cudaq.vqe`, and it will automatically run our</span>
+<span class="c1"># optimization loop, returning a tuple of the minimized eigenvalue of our `spin_operator`</span>
+<span class="c1"># and the list of optimal variational parameters.</span>
+
+<span class="n">energy</span><span class="p">,</span> <span class="n">parameter</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">vqe</span><span class="p">(</span>
+    <span class="n">kernel</span><span class="o">=</span><span class="n">kernel</span><span class="p">,</span>
+    <span class="n">spin_operator</span><span class="o">=</span><span class="n">hamiltonian</span><span class="p">,</span>
+    <span class="n">optimizer</span><span class="o">=</span><span class="n">optimizer</span><span class="p">,</span>
+    <span class="c1"># list of parameters has length of 1:</span>
+    <span class="n">parameter_count</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">minimized &lt;H&gt; = </span><span class="si">{</span><span class="nb">round</span><span class="p">(</span><span class="n">energy</span><span class="p">,</span><span class="mi">16</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;optimal theta = </span><span class="si">{</span><span class="nb">round</span><span class="p">(</span><span class="n">parameter</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="mi">16</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// nvq++ vqe_h2.cpp -o vqe.x &amp;&amp; ./vqe.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/algorithm.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/builder.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/gradients.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq/optimizers.h&gt;</span>
+
+<span class="c1">// Here we build up a CUDA-Q kernel with N layers and each</span>
+<span class="c1">// layer containing an arrangement of random SO(4) rotations. The algorithm</span>
+<span class="c1">// leverages the CUDA-Q VQE support to compute the ground state of the</span>
+<span class="c1">// Hydrogen atom.</span>
+
+<span class="c1">// The SO4 random entangler written as a CUDA-Q kernel free function</span>
+<span class="c1">// since this is a pure-device quantum kernel</span>
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">so4</span><span class="p">(</span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qubit</span><span class="w"> </span><span class="o">&amp;</span><span class="n">r</span><span class="p">,</span>
+<span class="w">                 </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">thetas</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">r</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">3</span><span class="p">],</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">r</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">4</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="n">ry</span><span class="p">(</span><span class="n">thetas</span><span class="p">[</span><span class="mi">5</span><span class="p">],</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">,</span><span class="w"> </span><span class="n">r</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">r</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="c1">// The SO4 fabric CUDA-Q kernel. Keeps track of simple</span>
+<span class="c1">// arithmetic class members controlling the number of qubits and</span>
+<span class="c1">// entangling layers.</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">so4_fabric</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="nf">operator</span><span class="p">()(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">params</span><span class="p">,</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span>
+<span class="w">                  </span><span class="kt">int</span><span class="w"> </span><span class="n">n_layers</span><span class="p">)</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="n">q</span><span class="p">(</span><span class="n">n_qubits</span><span class="p">);</span>
+
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">x</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+
+<span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="n">block_size</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="w">    </span><span class="kt">int</span><span class="w"> </span><span class="n">counter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_layers</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="c1">// first layer of so4 blocks (even)</span>
+<span class="w">      </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">;</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">subq</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">slice</span><span class="p">(</span><span class="n">k</span><span class="p">,</span><span class="w"> </span><span class="n">block_size</span><span class="p">);</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">so4_params</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">slice_vector</span><span class="p">(</span><span class="n">params</span><span class="p">,</span><span class="w"> </span><span class="n">counter</span><span class="p">,</span><span class="w"> </span><span class="mi">6</span><span class="p">);</span>
+<span class="w">        </span><span class="n">so4</span><span class="p">(</span><span class="n">subq</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">subq</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">so4_params</span><span class="p">);</span>
+<span class="w">        </span><span class="n">counter</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="mi">6</span><span class="p">;</span>
+<span class="w">      </span><span class="p">}</span>
+
+<span class="w">      </span><span class="c1">// second layer of so4 blocks (odd)</span>
+<span class="w">      </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="n">block_size</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">;</span><span class="w"> </span><span class="n">k</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">subq</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">q</span><span class="p">.</span><span class="n">slice</span><span class="p">(</span><span class="n">k</span><span class="p">,</span><span class="w"> </span><span class="n">block_size</span><span class="p">);</span>
+<span class="w">        </span><span class="k">auto</span><span class="w"> </span><span class="n">so4_params</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">slice_vector</span><span class="p">(</span><span class="n">params</span><span class="p">,</span><span class="w"> </span><span class="n">counter</span><span class="p">,</span><span class="w"> </span><span class="mi">6</span><span class="p">);</span>
+<span class="w">        </span><span class="n">so4</span><span class="p">(</span><span class="n">subq</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">subq</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="w"> </span><span class="n">so4_params</span><span class="p">);</span>
+<span class="w">        </span><span class="n">counter</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="mi">6</span><span class="p">;</span>
+<span class="w">      </span><span class="p">}</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// Read in the spin op from file</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="n">h2_data</span><span class="p">{</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">-0.10647701149499994</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0454063328691</span><span class="p">,</span><span class="w">      </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0454063328691</span><span class="p">,</span><span class="w">      </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0454063328691</span><span class="p">,</span><span class="w">      </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0454063328691</span><span class="p">,</span><span class="w">      </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.170280101353</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.120200490713</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.168335986252</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mf">0.165606823582</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">-0.22004130022499996</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.165606823582</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mf">0.174072892497</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mf">0.17028010135300004</span><span class="p">,</span><span class="w">  </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mf">0.120200490713</span><span class="p">,</span><span class="w">       </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mf">-0.22004130022499999</span><span class="p">,</span><span class="w"> </span><span class="mf">0.0</span><span class="p">,</span>
+<span class="w">                              </span><span class="mi">15</span><span class="p">};</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">spin_op</span><span class="w"> </span><span class="n">H</span><span class="p">(</span><span class="n">h2_data</span><span class="p">,</span><span class="w"> </span><span class="cm">/*nQubits*/</span><span class="w"> </span><span class="mi">4</span><span class="p">);</span>
+<span class="w">  </span><span class="c1">// For 8 qubits, 36 parameters per layer</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">n_layers</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="n">n_qubits</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">H</span><span class="p">.</span><span class="n">num_qubits</span><span class="p">(),</span><span class="w"> </span><span class="n">block_size</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="n">p_counter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">n_blocks_per_layer</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="p">(</span><span class="n">n_qubits</span><span class="w"> </span><span class="o">/</span><span class="w"> </span><span class="n">block_size</span><span class="p">)</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">n_params</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">n_layers</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="mi">6</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">n_blocks_per_layer</span><span class="p">;</span>
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;%d qubit Hamiltonian -&gt; %d parameters</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span><span class="w"> </span><span class="n">n_params</span><span class="p">);</span>
+
+<span class="w">  </span><span class="c1">// Define the initial parameters and ansatz.</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">init_params</span><span class="w"> </span><span class="o">=</span>
+<span class="w">      </span><span class="n">cudaq</span><span class="o">::</span><span class="n">random_vector</span><span class="p">(</span><span class="mi">-1</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="n">n_params</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">mt19937</span><span class="o">::</span><span class="n">default_seed</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">so4_fabric</span><span class="w"> </span><span class="n">ansatz</span><span class="p">;</span>
+
+<span class="w">  </span><span class="c1">// Run VQE.</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">optimizers</span><span class="o">::</span><span class="n">lbfgs</span><span class="w"> </span><span class="n">optimizer</span><span class="p">;</span>
+<span class="w">  </span><span class="n">optimizer</span><span class="p">.</span><span class="n">initial_parameters</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">init_params</span><span class="p">;</span>
+<span class="w">  </span><span class="n">optimizer</span><span class="p">.</span><span class="n">max_eval</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">20</span><span class="p">;</span>
+<span class="w">  </span><span class="n">optimizer</span><span class="p">.</span><span class="n">max_line_search_trials</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">10</span><span class="p">;</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">gradients</span><span class="o">::</span><span class="n">central_difference</span><span class="w"> </span><span class="n">gradient</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="p">[</span><span class="n">opt_val</span><span class="p">,</span><span class="w"> </span><span class="n">opt_params</span><span class="p">]</span><span class="w"> </span><span class="o">=</span>
+<span class="w">      </span><span class="n">cudaq</span><span class="o">::</span><span class="n">vqe</span><span class="p">(</span><span class="n">ansatz</span><span class="p">,</span><span class="w"> </span><span class="n">gradient</span><span class="p">,</span><span class="w"> </span><span class="n">H</span><span class="p">,</span><span class="w"> </span><span class="n">optimizer</span><span class="p">,</span><span class="w"> </span><span class="n">n_params</span><span class="p">,</span><span class="w"> </span><span class="n">n_qubits</span><span class="p">,</span><span class="w"> </span><span class="n">n_layers</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Optimal value = %.16lf</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">opt_val</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>Let’s look at a more advanced variation of the previous example.</p>
+<p>As an alternative to <code class="code docutils literal notranslate"><span class="pre">cudaq.vqe</span></code>, we can also use the <code class="code docutils literal notranslate"><span class="pre">cudaq.optimizers</span></code> suite on its own to write custom variational algorithm routines. Much of this can be slightly modified for use with third-party optimizers, such as <code class="code docutils literal notranslate"><span class="pre">scipy</span></code>.</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">cudaq</span>
+<span class="kn">from</span> <span class="nn">cudaq</span> <span class="kn">import</span> <span class="n">spin</span>
+
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span><span class="p">,</span> <span class="n">Tuple</span>
+
+<span class="c1"># We will be optimizing over a custom objective function that takes a vector</span>
+<span class="c1"># of parameters as input and returns either the cost as a single float,</span>
+<span class="c1"># or a tuple of (cost, gradient_vector) depending on the optimizer used.</span>
+
+<span class="c1"># In this example, we will use the spin Hamiltonian and ansatz from `simple_vqe.py`</span>
+<span class="c1"># and find the `angles` that minimize the expectation value of the system.</span>
+<span class="n">hamiltonian</span> <span class="o">=</span> <span class="mf">5.907</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">x</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">-</span> <span class="mf">2.1433</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span>
+    <span class="mi">0</span><span class="p">)</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">y</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="mf">.21829</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">-</span> <span class="mf">6.125</span> <span class="o">*</span> <span class="n">spin</span><span class="o">.</span><span class="n">z</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">(</span><span class="n">angles</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">]):</span>
+    <span class="n">qvector</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
+    <span class="n">x</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="n">ry</span><span class="p">(</span><span class="n">angles</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+    <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qvector</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">qvector</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+
+
+<span class="c1"># Define the optimizer that we&#39;d like to use.</span>
+<span class="n">optimizer</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">optimizers</span><span class="o">.</span><span class="n">Adam</span><span class="p">()</span>
+
+<span class="c1"># Since we&#39;ll be using a gradient-based optimizer, we can leverage the</span>
+<span class="c1"># CUDA-Q gradient helper class to automatically compute the gradient</span>
+<span class="c1"># vector for us. The use of this class for gradient calculations is</span>
+<span class="c1"># purely optional and can be replaced with your own custom gradient</span>
+<span class="c1"># routine.</span>
+<span class="n">gradient</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">gradients</span><span class="o">.</span><span class="n">CentralDifference</span><span class="p">()</span>
+
+
+<span class="k">def</span> <span class="nf">objective_function</span><span class="p">(</span><span class="n">parameter_vector</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">],</span>
+                       <span class="n">hamiltonian</span><span class="o">=</span><span class="n">hamiltonian</span><span class="p">,</span>
+                       <span class="n">gradient_strategy</span><span class="o">=</span><span class="n">gradient</span><span class="p">,</span>
+                       <span class="n">kernel</span><span class="o">=</span><span class="n">kernel</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">float</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">float</span><span class="p">]]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Note: the objective function may also take extra arguments, provided they</span>
+<span class="sd">    are passed into the function as default arguments in python.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+
+    <span class="c1"># Call `cudaq.observe` on the spin operator and ansatz at the</span>
+    <span class="c1"># optimizer provided parameters. This will allow us to easily</span>
+    <span class="c1"># extract the expectation value of the entire system in the</span>
+    <span class="c1"># z-basis.</span>
+
+    <span class="c1"># We define the call to `cudaq.observe` here as a lambda to</span>
+    <span class="c1"># allow it to be passed into the gradient strategy as a</span>
+    <span class="c1"># function. If you were using a gradient-free optimizer,</span>
+    <span class="c1"># you could purely define `cost = cudaq.observe().expectation()`.</span>
+    <span class="n">get_result</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">parameter_vector</span><span class="p">:</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">observe</span><span class="p">(</span>
+        <span class="n">kernel</span><span class="p">,</span> <span class="n">hamiltonian</span><span class="p">,</span> <span class="n">parameter_vector</span><span class="p">)</span><span class="o">.</span><span class="n">expectation</span><span class="p">()</span>
+    <span class="c1"># `cudaq.observe` returns a `cudaq.ObserveResult` that holds the</span>
+    <span class="c1"># counts dictionary and the `expectation`.</span>
+    <span class="n">cost</span> <span class="o">=</span> <span class="n">get_result</span><span class="p">(</span><span class="n">parameter_vector</span><span class="p">)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;&lt;H&gt; = </span><span class="si">{</span><span class="n">cost</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+    <span class="c1"># Compute the gradient vector using `cudaq.gradients.STRATEGY.compute()`.</span>
+    <span class="n">gradient_vector</span> <span class="o">=</span> <span class="n">gradient_strategy</span><span class="o">.</span><span class="n">compute</span><span class="p">(</span><span class="n">parameter_vector</span><span class="p">,</span> <span class="n">get_result</span><span class="p">,</span>
+                                                <span class="n">cost</span><span class="p">)</span>
+
+    <span class="c1"># Return the (cost, gradient_vector) tuple.</span>
+    <span class="k">return</span> <span class="n">cost</span><span class="p">,</span> <span class="n">gradient_vector</span>
+
+
+<span class="n">cudaq</span><span class="o">.</span><span class="n">set_random_seed</span><span class="p">(</span><span class="mi">13</span><span class="p">)</span>  <span class="c1"># make repeatable</span>
+<span class="n">energy</span><span class="p">,</span> <span class="n">parameter</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">optimize</span><span class="p">(</span><span class="n">dimensions</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
+                                       <span class="n">function</span><span class="o">=</span><span class="n">objective_function</span><span class="p">)</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">minimized &lt;H&gt; = </span><span class="si">{</span><span class="nb">round</span><span class="p">(</span><span class="n">energy</span><span class="p">,</span><span class="mi">16</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;optimal theta = </span><span class="si">{</span><span class="nb">round</span><span class="p">(</span><span class="n">parameter</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="mi">16</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="bernstein_vazirani.html" class="btn btn-neutral float-left" title="Bernstein-Vazirani" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="qaoa.html" class="btn btn-neutral float-right" title="Quantum Approximate Optimization Algorithm" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/extending/cudaq_ir.html b/pr-2241/using/extending/cudaq_ir.html
new file mode 100644
index 0000000000..06b8e818ce
--- /dev/null
+++ b/pr-2241/using/extending/cudaq_ir.html
@@ -0,0 +1,890 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Working with the CUDA-Q IR &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Create your own CUDA-Q Compiler Pass" href="mlir_pass.html" />
+    <link rel="prev" title="Extending CUDA-Q with a new Simulator" href="nvqir_simulator.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="extending.html">   Extending</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="extending.html">Extending CUDA-Q</a></li>
+      <li class="breadcrumb-item active">Working with the CUDA-Q IR</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/extending/cudaq_ir.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="nvqir_simulator.html" class="btn btn-neutral float-left" title="Extending CUDA-Q with a new Simulator" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="mlir_pass.html" class="btn btn-neutral float-right" title="Create your own CUDA-Q Compiler Pass" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="working-with-the-cuda-q-ir">
+<h1>Working with the CUDA-Q IR<a class="headerlink" href="#working-with-the-cuda-q-ir" title="Permalink to this heading">¶</a></h1>
+<p>Let’s see the output of <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> in verbose mode. Consider a simple code like the one below, saved to file <code class="code docutils literal notranslate"><span class="pre">simple.cpp</span></code>.</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">   #</span>include<span class="w"> </span>&lt;cudaq.h&gt;
+
+<span class="go">   struct ghz {</span>
+<span class="go">     void operator()(int N) __qpu__ {</span>
+<span class="go">       cudaq::qvector q(N);</span>
+<span class="go">       h(q[0]);</span>
+<span class="go">       for (int i = 0; i &lt; N - 1; i++) {</span>
+<span class="go">         x&lt;cudaq::ctrl&gt;(q[i], q[i + 1]);</span>
+<span class="go">       }</span>
+<span class="go">       mz(q);</span>
+<span class="go">     }</span>
+<span class="go">   };</span>
+
+<span class="go">   int main() { ... }</span>
+
+<span class="go">We see the following output from :code:`nvq++` verbose mode (up to some absolute paths).</span>
+</pre></div>
+</div>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>nvq++<span class="w"> </span>simple.cpp<span class="w"> </span>-v<span class="w"> </span>--save-temps
+
+<span class="go">cudaq-quake --emit-llvm-file simple.cpp -o simple.qke</span>
+<span class="go">cudaq-opt --pass-pipeline=builtin.module(canonicalize,lambda-lifting,canonicalize,apply-op-specialization,kernel-execution,inline{default-pipeline=func.func(indirect-to-direct-calls)},func.func(quake-add-metadata),device-code-loader{use-quake=1},expand-measurements,func.func(lower-to-cfg),canonicalize,cse) simple.qke -o simple.qke.LpsXpu</span>
+<span class="go">cudaq-translate --convert-to=qir simple.qke.LpsXpu -o simple.ll.p3De4L</span>
+<span class="go">fixup-linkage.pl simple.qke simple.ll</span>
+<span class="go">llc --relocation-model=pic --filetype=obj -O2 simple.ll.p3De4L -o simple.qke.o</span>
+<span class="go">llc --relocation-model=pic --filetype=obj -O2 simple.ll -o simple.classic.o</span>
+<span class="go">clang++ -L/usr/lib/gcc/x86_64-linux-gnu/12 -L/usr/lib64 -L/lib/x86_64-linux-gnu -L/lib64 -L/usr/lib/x86_64-linux-gnu -L/lib -L/usr/lib -L/usr/local/cuda/lib64/stubs -r simple.qke.o simple.classic.o -o simple.o</span>
+<span class="go">clang++ -Wl,-rpath,lib -Llib -L/usr/lib/gcc/x86_64-linux-gnu/12 -L/usr/lib64 -L/lib/x86_64-linux-gnu -L/lib64 -L/usr/lib/x86_64-linux-gnu -L/lib -L/usr/lib -L/usr/local/cuda/lib64/stubs simple.o -lcudaq -lcudaq-common -lcudaq-mlir-runtime -lcudaq-builder -lcudaq-ensmallen -lcudaq-nlopt -lcudaq-spin -lcudaq-em-default -lcudaq-platform-default -lnvqir -lnvqir-qpp</span>
+</pre></div>
+</div>
+<p>This workflow orchestration is represented in the figure below:</p>
+<img alt="../../_images/nvqpp_workflow.png" src="../../_images/nvqpp_workflow.png" />
+<p>We start by mapping CUDA-Q C++ kernel representations (structs, lambdas, and free functions)
+to the Quake dialect. Since we added <code class="code docutils literal notranslate"><span class="pre">--save-temps</span></code>,
+we can look at the IR code that was produced. The base Quake file, <code class="code docutils literal notranslate"><span class="pre">simple.qke</span></code>, contains the following:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">module attributes {qtx.mangled_name_map = {__nvqpp__mlirgen__ghz = &quot;_ZN3ghzclEi&quot;}} {</span>
+<span class="go">    func.func @__nvqpp__mlirgen__ghz(%arg0: i32) attributes {&quot;cudaq-entrypoint&quot;, &quot;cudaq-kernel&quot;} {</span>
+<span class="gp">       %</span><span class="nv">alloca</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.alloca<span class="o">()</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="go">       memref.store %arg0, %alloca[] : memref&lt;i32&gt;</span>
+<span class="gp">       %</span><span class="nv">0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.load<span class="w"> </span>%alloca<span class="o">[]</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="gp">       %</span><span class="nv">1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.extsi<span class="w"> </span>%0<span class="w"> </span>:<span class="w"> </span>i32<span class="w"> </span>to<span class="w"> </span>i64
+<span class="gp">       %</span><span class="nv">2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>quake.alloca<span class="o">(</span>%1<span class="w"> </span>:<span class="w"> </span>i64<span class="o">)</span><span class="w"> </span>!quake.veq&lt;?&gt;
+<span class="gp">       %</span><span class="nv">c0_i32</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.constant<span class="w"> </span><span class="m">0</span><span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">       %</span><span class="nv">3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.extsi<span class="w"> </span>%c0_i32<span class="w"> </span>:<span class="w"> </span>i32<span class="w"> </span>to<span class="w"> </span>i64
+<span class="gp">       %</span><span class="nv">4</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>quake.extract_ref<span class="w"> </span>%2<span class="o">[</span>%3<span class="o">]</span><span class="w"> </span>:<span class="w"> </span><span class="o">(</span>!quake.veq&lt;?&gt;,<span class="w"> </span>i64<span class="o">)</span><span class="w"> </span>-&gt;<span class="w"> </span>!quake.ref
+<span class="go">       quake.h %4 : (!quake.ref) -&gt; ()</span>
+<span class="go">       cc.scope {</span>
+<span class="gp">        %</span><span class="nv">c0_i32_0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.constant<span class="w"> </span><span class="m">0</span><span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">        %</span><span class="nv">alloca_1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.alloca<span class="o">()</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="go">        memref.store %c0_i32_0, %alloca_1[] : memref&lt;i32&gt;</span>
+<span class="go">        cc.loop while {</span>
+<span class="gp">            %</span><span class="nv">6</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.load<span class="w"> </span>%alloca_1<span class="o">[]</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="gp">            %</span><span class="nv">7</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.load<span class="w"> </span>%alloca<span class="o">[]</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="gp">            %</span><span class="nv">c1_i32</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.constant<span class="w"> </span><span class="m">1</span><span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">            %</span><span class="nv">8</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.subi<span class="w"> </span>%7,<span class="w"> </span>%c1_i32<span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">            %</span><span class="nv">9</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.cmpi<span class="w"> </span>slt,<span class="w"> </span>%6,<span class="w"> </span>%8<span class="w"> </span>:<span class="w"> </span>i32
+<span class="go">            cc.condition %9</span>
+<span class="go">        } do {</span>
+<span class="go">          cc.scope {</span>
+<span class="gp">            %</span><span class="nv">6</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.load<span class="w"> </span>%alloca_1<span class="o">[]</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="gp">            %</span><span class="nv">7</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.extsi<span class="w"> </span>%6<span class="w"> </span>:<span class="w"> </span>i32<span class="w"> </span>to<span class="w"> </span>i64
+<span class="gp">            %</span><span class="nv">8</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>quake.extract_ref<span class="w"> </span>%2<span class="o">[</span>%7<span class="o">]</span><span class="w"> </span>:<span class="w"> </span><span class="o">(</span>!quake.veq&lt;?&gt;,<span class="w"> </span>i64<span class="o">)</span><span class="w"> </span>-&gt;<span class="w"> </span>!quake.ref
+<span class="gp">            %</span><span class="nv">9</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.load<span class="w"> </span>%alloca_1<span class="o">[]</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="gp">            %</span><span class="nv">c1_i32</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.constant<span class="w"> </span><span class="m">1</span><span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">            %</span><span class="nv">10</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.addi<span class="w"> </span>%9,<span class="w"> </span>%c1_i32<span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">            %</span><span class="nv">11</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.extsi<span class="w"> </span>%10<span class="w"> </span>:<span class="w"> </span>i32<span class="w"> </span>to<span class="w"> </span>i64
+<span class="gp">            %</span><span class="nv">12</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>quake.extract_ref<span class="w"> </span>%2<span class="o">[</span>%11<span class="o">]</span><span class="w"> </span>:<span class="w"> </span><span class="o">(</span>!quake.veq&lt;?&gt;,<span class="w"> </span>i64<span class="o">)</span><span class="w"> </span>-&gt;<span class="w"> </span>!quake.ref
+<span class="go">            quake.x [%8] %12 : (!quake.ref, !quake.ref) -&gt; ()</span>
+<span class="go">          }</span>
+<span class="go">          cc.continue</span>
+<span class="go">        } step {</span>
+<span class="gp">            %</span><span class="nv">6</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>memref.load<span class="w"> </span>%alloca_1<span class="o">[]</span><span class="w"> </span>:<span class="w"> </span>memref&lt;i32&gt;
+<span class="gp">            %</span><span class="nv">c1_i32</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.constant<span class="w"> </span><span class="m">1</span><span class="w"> </span>:<span class="w"> </span>i32
+<span class="gp">            %</span><span class="nv">7</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>arith.addi<span class="w"> </span>%6,<span class="w"> </span>%c1_i32<span class="w"> </span>:<span class="w"> </span>i32
+<span class="go">            memref.store %7, %alloca_1[] : memref&lt;i32&gt;</span>
+<span class="go">        }</span>
+<span class="go">        }</span>
+<span class="gp">        %</span><span class="nv">5</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>quake.mz<span class="w"> </span>%2<span class="w"> </span>:<span class="w"> </span><span class="o">(</span>!quake.veq&lt;?&gt;<span class="o">)</span><span class="w"> </span>-&gt;<span class="w"> </span>!cc.stdvec&lt;i1&gt;
+<span class="go">        return</span>
+<span class="go">    }</span>
+<span class="go">}</span>
+</pre></div>
+</div>
+<p>This base Quake file is unoptimized and unchanged. It is produced by the
+<code class="code docutils literal notranslate"><span class="pre">cudaq-quake</span></code> tool, which also allows us to output the full LLVM IR representation
+for the code. This LLVM IR is classical-only, and is directly produced by <code class="code docutils literal notranslate"><span class="pre">clang++</span></code>
+code-generation. The LLVM IR file <code class="code docutils literal notranslate"><span class="pre">simple.ll</span></code> contains the CUDA-Q kernel
+<code class="code docutils literal notranslate"><span class="pre">operator()(Args...)</span></code> LLVM function, with a mangled name. Ultimately, we
+want to replace this function with our own MLIR-generated function.</p>
+<p>Next, the <code class="code docutils literal notranslate"><span class="pre">cudaq-opt</span></code> tool is invoked on the <code class="code docutils literal notranslate"><span class="pre">simple.qke</span></code> file. This runs an
+MLIR pass pipeline that canonicalizes and optimizes the code. It will also process quantum
+lambdas, lift those lambdas to functions, and synthesis adjoint and controlled versions of
+CUDA-Q kernel functions if necessary. The most important pass that this step applies is the
+<code class="code docutils literal notranslate"><span class="pre">kernel-execution</span></code> pass, which synthesizes a new entry point LLVM function with the
+same name and signature as the original <code class="code docutils literal notranslate"><span class="pre">operator()(Args...)</span></code> call function in the
+classical <code class="code docutils literal notranslate"><span class="pre">simple.ll</span></code> file. We also extract all Quake code representations as strings
+and register them with the CUDA-Q runtime for runtime IR introspection.</p>
+<p>After <code class="code docutils literal notranslate"><span class="pre">cudaq-opt</span></code>, the <code class="code docutils literal notranslate"><span class="pre">cudaq-translate</span></code> tool is used to lower the transformed
+Quake representation to an LLVM IR representation, specifically the QIR. We finish by lowering
+this representation to object code via standard LLVM tools (e.g. <code class="code docutils literal notranslate"><span class="pre">llc</span></code>), and merge all
+object files into a single object file, ensuring that our new mangled <code class="code docutils literal notranslate"><span class="pre">operator()(Args...)</span></code>
+call is injected first, thereby overwriting the original. Finally, based on user compile flags,
+we configure the link line with specific libraries that implement the <code class="code docutils literal notranslate"><span class="pre">quantum_platform</span></code>
+(here the <code class="code docutils literal notranslate"><span class="pre">libcudaq-platform-default.so</span></code>) and NVQIR circuit simulator backend (the
+<code class="code docutils literal notranslate"><span class="pre">libnvqir-qpp.so</span></code> Q++ CPU-only simulation backend). These latter libraries are controlled
+via the <code class="code docutils literal notranslate"><span class="pre">--platform</span></code> and <code class="code docutils literal notranslate"><span class="pre">--target</span></code> compiler flags.</p>
+<img alt="../../_images/dialects.png" src="../../_images/dialects.png" />
+<p>The above figure demonstrate the MLIR dialects involved and the overall workflow mapping
+high-level language constructs to lower-level MLIR dialect code, and ultimately LLVM IR.</p>
+<p>CUDA-Q also provides value-semantics form of Quake for static circuit
+representation. This dialect directly enables robust circuit
+optimizations via data-flow analysis of the representative circuit. This dialect
+is typically produced just-in-time when the structure of the circuit is fully known.</p>
+<p>You will notice that there are a number of CUDA-Q executable tools installed as part
+of this open beta release. These tools are directly related to the generation,
+processing, optimization, and lowering of the core <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> compiler representations.
+The tools available are</p>
+<ol class="arabic simple">
+<li><p><code class="code docutils literal notranslate"><span class="pre">cudaq-quake</span></code> - Lower C++ to Quake, can also output classical LLVM IR file</p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">cudaq-opt</span></code> - Process Quake with various MLIR Passes</p></li>
+<li><p><code class="code docutils literal notranslate"><span class="pre">cudaq-translate</span></code> - Lower Quake to external representations like QIR</p></li>
+</ol>
+<p>CUDA-Q and <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> rely on Quake for the core quantum intermediate representation.
+Quake represents an IR closer to the CUDA-Q source language and models qubits and
+quantum instructions via memory semantics. Quake can be fully dynamic and in
+that sense represents a quantum circuit template or generator. With runtime
+arguments fully specified, Quake code can be used to generate or synthesize
+a fully known quantum circuit. The value semantics form of Quake can thus be
+used as a representation for fully known
+or synthesized quantum circuits. Its utility, therefore, lies in its ability to
+optimize quantum code. It departs from the memory semantics model of Quake and
+expresses the flow of quantum information explicitly as MLIR values.
+This approach makes it easier for finding circuit patterns and leveraging it for common
+optimization tasks.</p>
+<p>To demonstrate how these tools work together, let’s take the simple GHZ CUDA-Q
+program and lower the kernel from C++ to Quake, synthesize that Quake code,
+and produce QIR. Recall the code snippet for the kernel</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Define a quantum kernel</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">ghz</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="k">operator</span><span class="p">()()</span><span class="w"> </span><span class="n">__qpu__</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qarray</span><span class="o">&lt;</span><span class="mi">5</span><span class="o">&gt;</span><span class="w"> </span><span class="n">q</span><span class="p">;</span>
+<span class="w">    </span><span class="n">h</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">    </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">4</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="o">++</span><span class="p">)</span>
+<span class="w">      </span><span class="n">x</span><span class="o">&lt;</span><span class="n">cudaq</span><span class="o">::</span><span class="n">ctrl</span><span class="o">&gt;</span><span class="p">(</span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="p">],</span><span class="w"> </span><span class="n">q</span><span class="p">[</span><span class="n">i</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">    </span><span class="n">mz</span><span class="p">(</span><span class="n">q</span><span class="p">);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+</pre></div>
+</div>
+<p>Using the toolchain, we can lower this directly to QIR,</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">cudaq-quake simple.cpp | cudaq-opt --canonicalize | cudaq-translate --convert-to=qir</span>
+</pre></div>
+</div>
+<p>which prints:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">; ModuleID = &#39;LLVMDialectModule&#39;</span>
+<span class="go">source_filename = &quot;LLVMDialectModule&quot;</span>
+<span class="go">target datalayout = &quot;e-m:e-p270:32:32-p271:32:32-p272:64:64-i64:64-f80:128-n8:16:32:64-S128&quot;</span>
+<span class="go">target triple = &quot;x86_64-unknown-linux-gnu&quot;</span>
+
+<span class="gp">%</span><span class="nv">Array</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">type</span><span class="w"> </span>opaque
+<span class="gp">%</span><span class="nv">Qubit</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">type</span><span class="w"> </span>opaque
+<span class="gp">%</span><span class="nv">Result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">type</span><span class="w"> </span>opaque
+
+<span class="go">declare void @invokeWithControlQubits(i64, void (%Array*, %Qubit*)*, ...) local_unnamed_addr</span>
+
+<span class="go">declare void @__quantum__qis__x__ctl(%Array*, %Qubit*)</span>
+
+<span class="go">declare %Result* @__quantum__qis__mz(%Qubit*) local_unnamed_addr</span>
+
+<span class="go">declare void @__quantum__rt__qubit_release_array(%Array*) local_unnamed_addr</span>
+
+<span class="go">declare i64 @__quantum__rt__array_get_size_1d(%Array*) local_unnamed_addr</span>
+
+<span class="go">declare void @__quantum__qis__h(%Qubit*) local_unnamed_addr</span>
+
+<span class="go">declare i8* @__quantum__rt__array_get_element_ptr_1d(%Array*, i64) local_unnamed_addr</span>
+
+<span class="go">declare %Array* @__quantum__rt__qubit_allocate_array(i64) local_unnamed_addr</span>
+
+<span class="go">define void @__nvqpp__mlirgen__ghz(i32 %0) local_unnamed_addr {</span>
+<span class="gp">  %</span><span class="nv">2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>sext<span class="w"> </span>i32<span class="w"> </span>%0<span class="w"> </span>to<span class="w"> </span>i64
+<span class="gp">  %</span><span class="nv">3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>%Array*<span class="w"> </span>@__quantum__rt__qubit_allocate_array<span class="o">(</span>i64<span class="w"> </span>%2<span class="o">)</span>
+<span class="gp">  %</span><span class="nv">4</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>i8*<span class="w"> </span>@__quantum__rt__array_get_element_ptr_1d<span class="o">(</span>%Array*<span class="w"> </span>%3,<span class="w"> </span>i64<span class="w"> </span><span class="m">0</span><span class="o">)</span>
+<span class="gp">  %</span><span class="nv">5</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>bitcast<span class="w"> </span>i8*<span class="w"> </span>%4<span class="w"> </span>to<span class="w"> </span>%Qubit**
+<span class="gp">  %</span><span class="nv">6</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>load<span class="w"> </span>%Qubit*,<span class="w"> </span>%Qubit**<span class="w"> </span>%5,<span class="w"> </span>align<span class="w"> </span><span class="m">8</span>
+<span class="go">  tail call void @__quantum__qis__h(%Qubit* %6)</span>
+<span class="gp">  %</span><span class="nv">7</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>add<span class="w"> </span>i32<span class="w"> </span>%0,<span class="w"> </span>-1
+<span class="gp">  %</span><span class="nv">8</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>icmp<span class="w"> </span>sgt<span class="w"> </span>i32<span class="w"> </span>%7,<span class="w"> </span><span class="m">0</span>
+<span class="go">  br i1 %8, label %.lr.ph.preheader, label %._crit_edge</span>
+
+<span class="go">.lr.ph.preheader:                                 ; preds = %1</span>
+<span class="gp">  %</span>wide.trip.count<span class="w"> </span><span class="o">=</span><span class="w"> </span>zext<span class="w"> </span>i32<span class="w"> </span>%7<span class="w"> </span>to<span class="w"> </span>i64
+<span class="go">  br label %.lr.ph</span>
+
+<span class="go">.lr.ph:                                           ; preds = %.lr.ph.preheader, %.lr.ph</span>
+<span class="gp">  %</span>indvars.iv<span class="w"> </span><span class="o">=</span><span class="w"> </span>phi<span class="w"> </span>i64<span class="w"> </span><span class="o">[</span><span class="w"> </span><span class="m">0</span>,<span class="w"> </span>%.lr.ph.preheader<span class="w"> </span><span class="o">]</span>,<span class="w"> </span><span class="o">[</span><span class="w"> </span>%indvars.iv.next,<span class="w"> </span>%.lr.ph<span class="w"> </span><span class="o">]</span>
+<span class="gp">  %</span><span class="nv">9</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>i8*<span class="w"> </span>@__quantum__rt__array_get_element_ptr_1d<span class="o">(</span>%Array*<span class="w"> </span>%3,<span class="w"> </span>i64<span class="w"> </span>%indvars.iv<span class="o">)</span>
+<span class="gp">  %</span><span class="nv">10</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>bitcast<span class="w"> </span>i8*<span class="w"> </span>%9<span class="w"> </span>to<span class="w"> </span>%Qubit**
+<span class="gp">  %</span><span class="nv">11</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>load<span class="w"> </span>%Qubit*,<span class="w"> </span>%Qubit**<span class="w"> </span>%10,<span class="w"> </span>align<span class="w"> </span><span class="m">8</span>
+<span class="gp">  %</span>indvars.iv.next<span class="w"> </span><span class="o">=</span><span class="w"> </span>add<span class="w"> </span>nuw<span class="w"> </span>nsw<span class="w"> </span>i64<span class="w"> </span>%indvars.iv,<span class="w"> </span><span class="m">1</span>
+<span class="gp">  %</span><span class="nv">12</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>i8*<span class="w"> </span>@__quantum__rt__array_get_element_ptr_1d<span class="o">(</span>%Array*<span class="w"> </span>%3,<span class="w"> </span>i64<span class="w"> </span>%indvars.iv.next<span class="o">)</span>
+<span class="gp">  %</span><span class="nv">13</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>bitcast<span class="w"> </span>i8*<span class="w"> </span>%12<span class="w"> </span>to<span class="w"> </span>%Qubit**
+<span class="gp">  %</span><span class="nv">14</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>load<span class="w"> </span>%Qubit*,<span class="w"> </span>%Qubit**<span class="w"> </span>%13,<span class="w"> </span>align<span class="w"> </span><span class="m">8</span>
+<span class="go">  tail call void (i64, void (%Array*, %Qubit*)*, ...) @invokeWithControlQubits(i64 1, void (%Array*, %Qubit*)* nonnull @__quantum__qis__x__ctl, %Qubit* %11, %Qubit* %14)</span>
+<span class="gp">  %</span>exitcond.not<span class="w"> </span><span class="o">=</span><span class="w"> </span>icmp<span class="w"> </span>eq<span class="w"> </span>i64<span class="w"> </span>%indvars.iv.next,<span class="w"> </span>%wide.trip.count
+<span class="go">  br i1 %exitcond.not, label %._crit_edge, label %.lr.ph</span>
+
+<span class="go">._crit_edge:                                      ; preds = %.lr.ph, %1</span>
+<span class="gp">  %</span><span class="nv">15</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>i64<span class="w"> </span>@__quantum__rt__array_get_size_1d<span class="o">(</span>%Array*<span class="w"> </span>%3<span class="o">)</span>
+<span class="gp">  %</span><span class="nv">16</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>icmp<span class="w"> </span>sgt<span class="w"> </span>i64<span class="w"> </span>%15,<span class="w"> </span><span class="m">0</span>
+<span class="go">  br i1 %16, label %.lr.ph3, label %._crit_edge4</span>
+
+<span class="go">.lr.ph3:                                          ; preds = %._crit_edge, %.lr.ph3</span>
+<span class="gp">  %</span><span class="nv">17</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>phi<span class="w"> </span>i64<span class="w"> </span><span class="o">[</span><span class="w"> </span>%22,<span class="w"> </span>%.lr.ph3<span class="w"> </span><span class="o">]</span>,<span class="w"> </span><span class="o">[</span><span class="w"> </span><span class="m">0</span>,<span class="w"> </span>%._crit_edge<span class="w"> </span><span class="o">]</span>
+<span class="gp">  %</span><span class="nv">18</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>i8*<span class="w"> </span>@__quantum__rt__array_get_element_ptr_1d<span class="o">(</span>%Array*<span class="w"> </span>%3,<span class="w"> </span>i64<span class="w"> </span>%17<span class="o">)</span>
+<span class="gp">  %</span><span class="nv">19</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>bitcast<span class="w"> </span>i8*<span class="w"> </span>%18<span class="w"> </span>to<span class="w"> </span>%Qubit**
+<span class="gp">  %</span><span class="nv">20</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>load<span class="w"> </span>%Qubit*,<span class="w"> </span>%Qubit**<span class="w"> </span>%19,<span class="w"> </span>align<span class="w"> </span><span class="m">8</span>
+<span class="gp">  %</span><span class="nv">21</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>tail<span class="w"> </span>call<span class="w"> </span>%Result*<span class="w"> </span>@__quantum__qis__mz<span class="o">(</span>%Qubit*<span class="w"> </span>%20<span class="o">)</span>
+<span class="gp">  %</span><span class="nv">22</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>add<span class="w"> </span>nuw<span class="w"> </span>nsw<span class="w"> </span>i64<span class="w"> </span>%17,<span class="w"> </span><span class="m">1</span>
+<span class="gp">  %</span>exitcond5.not<span class="w"> </span><span class="o">=</span><span class="w"> </span>icmp<span class="w"> </span>eq<span class="w"> </span>i64<span class="w"> </span>%22,<span class="w"> </span>%15
+<span class="go">  br i1 %exitcond5.not, label %._crit_edge4, label %.lr.ph3</span>
+
+<span class="go">._crit_edge4:                                     ; preds = %.lr.ph3, %._crit_edge</span>
+<span class="go">  tail call void @__quantum__rt__qubit_release_array(%Array* %3)</span>
+<span class="go">  ret void</span>
+<span class="go">}</span>
+
+<span class="go">!llvm.module.flags = !{!0}</span>
+
+<span class="go">!0 = !{i32 2, !&quot;Debug Info Version&quot;, i32 3}</span>
+</pre></div>
+</div>
+<p>Note that the results of each tool can be piped to further tools, creating a
+composable pipeline of compiler lowering tools.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="nvqir_simulator.html" class="btn btn-neutral float-left" title="Extending CUDA-Q with a new Simulator" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="mlir_pass.html" class="btn btn-neutral float-right" title="Create your own CUDA-Q Compiler Pass" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/extending/extending.html b/pr-2241/using/extending/extending.html
new file mode 100644
index 0000000000..4da9955696
--- /dev/null
+++ b/pr-2241/using/extending/extending.html
@@ -0,0 +1,661 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Extending CUDA-Q &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Extending CUDA-Q with a new Simulator" href="nvqir_simulator.html" />
+    <link rel="prev" title="Integrating with Third-Party Libraries" href="../integration/libraries.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Extending CUDA-Q</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/extending/extending.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../integration/libraries.html" class="btn btn-neutral float-left" title="Integrating with Third-Party Libraries" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="nvqir_simulator.html" class="btn btn-neutral float-right" title="Extending CUDA-Q with a new Simulator" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="extending-cuda-q">
+<h1>Extending CUDA-Q<a class="headerlink" href="#extending-cuda-q" title="Permalink to this heading">¶</a></h1>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="nvqir_simulator.html">Create a new NVQIR Simulator</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l1"><a class="reference internal" href="mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../integration/libraries.html" class="btn btn-neutral float-left" title="Integrating with Third-Party Libraries" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="nvqir_simulator.html" class="btn btn-neutral float-right" title="Extending CUDA-Q with a new Simulator" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/extending/mlir_pass.html b/pr-2241/using/extending/mlir_pass.html
new file mode 100644
index 0000000000..f7a29fcbfd
--- /dev/null
+++ b/pr-2241/using/extending/mlir_pass.html
@@ -0,0 +1,739 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Create your own CUDA-Q Compiler Pass &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Specifications" href="../../specification/index.html" />
+    <link rel="prev" title="Working with the CUDA-Q IR" href="cudaq_ir.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="extending.html">   Extending</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="extending.html">Extending CUDA-Q</a></li>
+      <li class="breadcrumb-item active">Create your own CUDA-Q Compiler Pass</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/extending/mlir_pass.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cudaq_ir.html" class="btn btn-neutral float-left" title="Working with the CUDA-Q IR" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../specification/index.html" class="btn btn-neutral float-right" title="Specifications" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="create-your-own-cuda-q-compiler-pass">
+<h1>Create your own CUDA-Q Compiler Pass<a class="headerlink" href="#create-your-own-cuda-q-compiler-pass" title="Permalink to this heading">¶</a></h1>
+<p>The CUDA-Q IR can be transformed, analyzed, or optimized
+using standard MLIR patterns and tools. CUDA-Q provides a registration
+mechanism for the <code class="code docutils literal notranslate"><span class="pre">cudaq-opt</span></code> tool that allows one to create, load, and
+use custom MLIR passes on Quake code.</p>
+<p>CUDA-Q MLIR Passes can only be created within an existing CUDA-Q
+development environment. Therefore, you must clone the repository and add your
+Pass code as part of the existing CUDA-Q CMake system.</p>
+<p>As an example, clone the repository and add the following directory structure
+under <code class="code docutils literal notranslate"><span class="pre">lib</span></code>, <code class="code docutils literal notranslate"><span class="pre">lib/Plugins/MyCustomPlugin/</span></code>. Within this directory create a
+<code class="code docutils literal notranslate"><span class="pre">CMakeLists.txt</span></code> file and a <code class="code docutils literal notranslate"><span class="pre">MyCustomPlugin.cpp</span></code> file. In the CMake file,
+add the following:</p>
+<div class="highlight-cmake notranslate"><div class="highlight"><pre><span></span><span class="nb">add_llvm_pass_plugin</span><span class="p">(</span><span class="s">MyCustomPlugin</span><span class="w"> </span><span class="s">MyCustomPlugin.cpp</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Creating a CUDA-Q IR pass starts with the implementation of an
+<code class="code docutils literal notranslate"><span class="pre">mlir::OperationPass</span></code>. A full discussion of the MLIR Pass infrastructure
+is beyond the scope of this document; please see
+<a class="reference external" href="https://mlir.llvm.org/docs/PassManagement">MLIR Passes</a>. To create such
+a pass, start with the following template in the <code class="code docutils literal notranslate"><span class="pre">MyCustomPlugin.cpp</span></code> file:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq/Optimizer/Dialect/Quake/QuakeDialect.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq/Optimizer/Dialect/Quake/QuakeOps.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq/Support/Plugin.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;mlir/Rewrite/FrozenRewritePatternSet.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;mlir/Transforms/DialectConversion.h&quot;</span>
+
+<span class="c1">// Here is an example MLIR Pass that one can write externally and</span>
+<span class="c1">// use via the cudaq-opt tool, with the --load-cudaq-plugin flag.</span>
+<span class="c1">// The pass here is simple, replace Hadamard operations with S operations.</span>
+
+<span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">mlir</span><span class="p">;</span>
+
+<span class="k">namespace</span><span class="w"> </span><span class="p">{</span>
+
+<span class="k">struct</span><span class="w"> </span><span class="nc">ReplaceH</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="k">public</span><span class="w"> </span><span class="n">OpRewritePattern</span><span class="o">&lt;</span><span class="n">quake</span><span class="o">::</span><span class="n">HOp</span><span class="o">&gt;</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">using</span><span class="w"> </span><span class="n">OpRewritePattern</span><span class="o">::</span><span class="n">OpRewritePattern</span><span class="p">;</span>
+<span class="w">  </span><span class="n">LogicalResult</span><span class="w"> </span><span class="nf">matchAndRewrite</span><span class="p">(</span><span class="n">quake</span><span class="o">::</span><span class="n">HOp</span><span class="w"> </span><span class="n">hOp</span><span class="p">,</span>
+<span class="w">                                </span><span class="n">PatternRewriter</span><span class="w"> </span><span class="o">&amp;</span><span class="n">rewriter</span><span class="p">)</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">rewriter</span><span class="p">.</span><span class="n">replaceOpWithNewOp</span><span class="o">&lt;</span><span class="n">quake</span><span class="o">::</span><span class="n">SOp</span><span class="o">&gt;</span><span class="p">(</span>
+<span class="w">        </span><span class="n">hOp</span><span class="p">,</span><span class="w"> </span><span class="n">hOp</span><span class="p">.</span><span class="n">isAdj</span><span class="p">(),</span><span class="w"> </span><span class="n">hOp</span><span class="p">.</span><span class="n">getParameters</span><span class="p">(),</span><span class="w"> </span><span class="n">hOp</span><span class="p">.</span><span class="n">getControls</span><span class="p">(),</span>
+<span class="w">        </span><span class="n">hOp</span><span class="p">.</span><span class="n">getTargets</span><span class="p">());</span>
+<span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="n">success</span><span class="p">();</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="k">class</span><span class="w"> </span><span class="nc">CustomPassPlugin</span>
+<span class="w">    </span><span class="o">:</span><span class="w"> </span><span class="k">public</span><span class="w"> </span><span class="n">PassWrapper</span><span class="o">&lt;</span><span class="n">CustomPassPlugin</span><span class="p">,</span><span class="w"> </span><span class="n">OperationPass</span><span class="o">&lt;</span><span class="n">func</span><span class="o">::</span><span class="n">FuncOp</span><span class="o">&gt;&gt;</span><span class="w"> </span><span class="p">{</span>
+<span class="k">public</span><span class="o">:</span>
+<span class="w">  </span><span class="n">MLIR_DEFINE_EXPLICIT_INTERNAL_INLINE_TYPE_ID</span><span class="p">(</span><span class="n">CustomPassPlugin</span><span class="p">)</span>
+
+<span class="w">  </span><span class="n">llvm</span><span class="o">::</span><span class="n">StringRef</span><span class="w"> </span><span class="n">getArgument</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="s">&quot;cudaq-custom-pass&quot;</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">  </span><span class="kt">void</span><span class="w"> </span><span class="n">runOnOperation</span><span class="p">()</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">circuit</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">getOperation</span><span class="p">();</span>
+<span class="w">    </span><span class="k">auto</span><span class="w"> </span><span class="n">ctx</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">circuit</span><span class="p">.</span><span class="n">getContext</span><span class="p">();</span>
+
+<span class="w">    </span><span class="n">RewritePatternSet</span><span class="w"> </span><span class="nf">patterns</span><span class="p">(</span><span class="n">ctx</span><span class="p">);</span>
+<span class="w">    </span><span class="n">patterns</span><span class="p">.</span><span class="n">insert</span><span class="o">&lt;</span><span class="n">ReplaceH</span><span class="o">&gt;</span><span class="p">(</span><span class="n">ctx</span><span class="p">);</span>
+<span class="w">    </span><span class="n">ConversionTarget</span><span class="w"> </span><span class="nf">target</span><span class="p">(</span><span class="o">*</span><span class="n">ctx</span><span class="p">);</span>
+<span class="w">    </span><span class="n">target</span><span class="p">.</span><span class="n">addLegalDialect</span><span class="o">&lt;</span><span class="n">quake</span><span class="o">::</span><span class="n">QuakeDialect</span><span class="o">&gt;</span><span class="p">();</span>
+<span class="w">    </span><span class="n">target</span><span class="p">.</span><span class="n">addIllegalOp</span><span class="o">&lt;</span><span class="n">quake</span><span class="o">::</span><span class="n">HOp</span><span class="o">&gt;</span><span class="p">();</span>
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">failed</span><span class="p">(</span><span class="n">applyPartialConversion</span><span class="p">(</span><span class="n">circuit</span><span class="p">,</span><span class="w"> </span><span class="n">target</span><span class="p">,</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">move</span><span class="p">(</span><span class="n">patterns</span><span class="p">))))</span><span class="w"> </span><span class="p">{</span>
+<span class="w">      </span><span class="n">circuit</span><span class="p">.</span><span class="n">emitOpError</span><span class="p">(</span><span class="s">&quot;simple pass failed&quot;</span><span class="p">);</span>
+<span class="w">      </span><span class="n">signalPassFailure</span><span class="p">();</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="p">};</span>
+
+<span class="p">}</span><span class="w"> </span><span class="c1">// namespace</span>
+
+<span class="n">CUDAQ_REGISTER_MLIR_PASS</span><span class="p">(</span><span class="n">CustomPassPlugin</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>This example serves as a very simple template for creating custom MLIR
+Passes that analyze the CUDA-Q Quake representation and perform
+some general transformation. In this example, we create a rewrite pattern
+that replaces <code class="code docutils literal notranslate"><span class="pre">Hadamard</span></code> operations with <code class="code docutils literal notranslate"><span class="pre">S</span></code> operations.</p>
+<p>Ensure that <code class="code docutils literal notranslate"><span class="pre">add_subdirectory(Plugins)</span></code> is in the <code class="code docutils literal notranslate"><span class="pre">lib/CMakeLists.txt</span></code> file,
+and also that there is a <code class="code docutils literal notranslate"><span class="pre">lib/Plugins/CMakeLists.txt</span></code> file that adds your
+plugin directory with <code class="code docutils literal notranslate"><span class="pre">add_subdirectory</span></code>.</p>
+<p>Then build CUDA-Q and you will have a <code class="code docutils literal notranslate"><span class="pre">MyCustomPlugin.so</span></code> plugin library
+in the install. You can load the plugin and use it with <code class="code docutils literal notranslate"><span class="pre">cudaq-opt</span></code> as follows:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cudaq-opt<span class="w"> </span>--load-cudaq-plugin<span class="w"> </span>MyCustomPlugin.so<span class="w"> </span>file.qke<span class="w"> </span>-cudaq-custom-pass
+</pre></div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cudaq_ir.html" class="btn btn-neutral float-left" title="Working with the CUDA-Q IR" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../../specification/index.html" class="btn btn-neutral float-right" title="Specifications" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/extending/nvqir_simulator.html b/pr-2241/using/extending/nvqir_simulator.html
new file mode 100644
index 0000000000..0d06d53370
--- /dev/null
+++ b/pr-2241/using/extending/nvqir_simulator.html
@@ -0,0 +1,815 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Extending CUDA-Q with a new Simulator &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Working with the CUDA-Q IR" href="cudaq_ir.html" />
+    <link rel="prev" title="Extending CUDA-Q" href="extending.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="extending.html">   Extending</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="extending.html">Extending CUDA-Q</a></li>
+      <li class="breadcrumb-item active">Extending CUDA-Q with a new Simulator</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/extending/nvqir_simulator.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="extending.html" class="btn btn-neutral float-left" title="Extending CUDA-Q" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cudaq_ir.html" class="btn btn-neutral float-right" title="Working with the CUDA-Q IR" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="extending-cuda-q-with-a-new-simulator">
+<h1>Extending CUDA-Q with a new Simulator<a class="headerlink" href="#extending-cuda-q-with-a-new-simulator" title="Permalink to this heading">¶</a></h1>
+<p>Backend circuit simulation in CUDA-Q is enabled via the
+NVQIR library (<code class="code docutils literal notranslate"><span class="pre">libnvqir</span></code>). CUDA-Q code is ultimately lowered
+to the LLVM IR in a manner that is adherent to the <a class="reference external" href="https://qir-alliance.org">QIR specification</a>.
+NVQIR provides function implementations for the various declared functions
+in the specification, which in turn delegate to an extensible simulation
+architecture.</p>
+<p>The primary extension point for NVQIR is the <code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code> class. This class
+exposes an API that enables qubit allocation and deallocation, quantum operation
+invocation, and measurement and sampling. Subtypes of this class are free to
+override these methods to affect simulation of the quantum code in any
+simulation-strategy-specific manner (e.g., state vector, tensor network, etc.). Moreover,
+subtypes are free to implement simulators that leverage classical accelerated computing.</p>
+<p>In this document, we’ll detail this simulator interface and walk through how to extend it for new types of simulation.</p>
+<section id="circuitsimulator">
+<h2><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code><a class="headerlink" href="#circuitsimulator" title="Permalink to this heading">¶</a></h2>
+<p>The <code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code> type is defined in <code class="code docutils literal notranslate"><span class="pre">runtime/nvqir/CircuitSimulator.h</span></code>. It
+exposes a public API to <code class="code docutils literal notranslate"><span class="pre">libnvqir</span></code> that is immediately subclassed in the <code class="code docutils literal notranslate"><span class="pre">CircuitSimulatorBase</span></code>
+type. This type is templated on the floating point type used in the simulator’s computations (e.g. <code class="code docutils literal notranslate"><span class="pre">double,float</span></code>).
+This templated type handles a lot of the base functionality required for allocating and deallocated qubits,
+as well as measurement, sampling, and observation under a number of execution contexts.
+This is the type that downstream simulation developers should extend.</p>
+<p>The actual definition of the quantum state data structure, and its overall evolution are
+left as tasks for <code class="code docutils literal notranslate"><span class="pre">CircuitSimulatorBase</span></code> subclasses. Examples of simulation subtypes can be found
+in <code class="code docutils literal notranslate"><span class="pre">runtime/nvqir/qpp/QppCircuitSimulator.cpp</span></code> or <code class="code docutils literal notranslate"><span class="pre">runtime/nvqir/custatevec/CuStateVecCircuitSimulator.cpp</span></code>.
+The <code class="code docutils literal notranslate"><span class="pre">QppCircuitSimulator</span></code> models the state vector using the <a class="reference external" href="https://github.com/softwareqinc/qpp">Q++</a> library, which
+leverages the <code class="code docutils literal notranslate"><span class="pre">Eigen::Matrix</span></code> type and OpenMP threading for matrix-vector operations.
+The <code class="code docutils literal notranslate"><span class="pre">CuStateVecCircuitSimulator</span></code> type models the state vector on an NVIDIA GPU device
+by leveraging the cuQuantum library.</p>
+<p>The key methods that need to be overridden by subtypes of <code class="code docutils literal notranslate"><span class="pre">CircuitSimulatorBase</span></code> are as follows:</p>
+<table class="docutils align-default" id="id1">
+<caption><span class="caption-text">Required Circuit Simulator Subtype Method Overrides</span><a class="headerlink" href="#id1" title="Permalink to this table">¶</a></caption>
+<tbody>
+<tr class="row-odd"><td><p>Method Name</p></td>
+<td><p>Method Arguments</p></td>
+<td><p>Method Description</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">addQubitToState</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">void</span></code></p></td>
+<td><p>Add a qubit to the underlying state representation.</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">addQubitsToState</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">nQubits</span> <span class="pre">:</span> <span class="pre">std::size_t</span></code></p></td>
+<td><p>Add the specified number of qubits to the underlying state representation.</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">resetQubit</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">qubitIdx</span> <span class="pre">:</span> <span class="pre">std::size_t</span></code></p></td>
+<td><p>Reset the state of the qubit at the given index to <code class="code docutils literal notranslate"><span class="pre">|0&gt;</span></code></p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">resetQubitStateImpl</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">void</span></code></p></td>
+<td><p>Clear the entire state representation (reset to 0 qubits).</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">applyGate</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">task</span> <span class="pre">:</span> <span class="pre">GateApplicationTask</span></code></p></td>
+<td><p>Apply the specified gate described by the <code class="code docutils literal notranslate"><span class="pre">GateApplicationTask</span></code>. This type encodes the control and target qubit indices, optional rotational parameters, and the gate matrix data.</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">measureQubit</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">qubitIdx</span> <span class="pre">:</span> <span class="pre">std::size_t</span> <span class="pre">-&gt;</span> <span class="pre">bool</span></code> (returns bit result as bool)</p></td>
+<td><p>Measure the qubit, produce a bit result, collapse the state.</p></td>
+</tr>
+<tr class="row-even"><td><p><code class="code docutils literal notranslate"><span class="pre">sample</span></code></p></td>
+<td><p>:code`qubitIdxs : std::vector&lt;std::size_t&gt;, shots : int`</p></td>
+<td><p>Sample the current multi-qubit state on the provided qubit indices over a certain number of shots</p></td>
+</tr>
+<tr class="row-odd"><td><p><code class="code docutils literal notranslate"><span class="pre">name</span></code></p></td>
+<td><p><code class="code docutils literal notranslate"><span class="pre">void</span></code></p></td>
+<td><p>Return the name of this CircuitSimulator, must be the same as the name used in <code class="code docutils literal notranslate"><span class="pre">nvq++</span> <span class="pre">-qpu</span> <span class="pre">NAME</span> <span class="pre">...</span></code></p></td>
+</tr>
+</tbody>
+</table>
+<p>To extend a subtype class, you will need to create a new <code class="code docutils literal notranslate"><span class="pre">cpp</span></code> implementation file with the same name as your
+subtype class name. In this file, you will subclass the <code class="code docutils literal notranslate"><span class="pre">CircuitSimulatorBase&lt;FloatType&gt;</span></code> and implement the methods in
+the above table. Finally, the subclass must be registered with the NVQIR library so that it
+can be picked up and used when a user specifies <code class="code docutils literal notranslate"><span class="pre">nvq++</span> <span class="pre">--target</span> <span class="pre">mySimulator</span> <span class="pre">...</span></code> from the command line (or <code class="code docutils literal notranslate"><span class="pre">cudaq.set_target('mySimulator')</span></code> in Python.)
+Type registration can be performed with a provided NVQIR macro,</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="n">NVQIR_REGISTER_SIMULATOR</span><span class="p">(</span><span class="n">MySimulatorClassName</span><span class="p">,</span><span class="w"> </span><span class="n">mySimulator</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>where <code class="code docutils literal notranslate"><span class="pre">MySimulatorClassName</span></code> is the name of your subtype, and <code class="code docutils literal notranslate"><span class="pre">mySimulator</span></code> is the
+same name as what <code class="code docutils literal notranslate"><span class="pre">MySimulatorClassName::name()</span></code> returns, and what you desire the
+<code class="code docutils literal notranslate"><span class="pre">-qpu</span> <span class="pre">NAME</span></code> name to be.</p>
+<p>A further requirement is that the code be compiled into its own standalone shared library
+with name <code class="code docutils literal notranslate"><span class="pre">libnvqir-NAME.{so,dylib}</span></code>, where NAME is the
+same name as what <code class="code docutils literal notranslate"><span class="pre">MySimulatorClassName::name()</span></code> returns, and what you desire the
+<code class="code docutils literal notranslate"><span class="pre">-qpu</span> <span class="pre">NAME</span></code> name to be. You will also need to create a <code class="code docutils literal notranslate"><span class="pre">NAME.config</span></code> file that
+contains the following contents</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">NVQIR_SIMULATION_BACKEND</span><span class="o">=</span><span class="s2">&quot;NAME&quot;</span>
+</pre></div>
+</div>
+<p>The library must be installed in <code class="code docutils literal notranslate"><span class="pre">$CUDA_QUANTUM_PATH/lib</span></code> and the configuration file
+must be installed to <code class="code docutils literal notranslate"><span class="pre">$CUDA_QUANTUM_PATH/platforms</span></code>.</p>
+</section>
+<section id="let-s-see-this-in-action">
+<h2>Let’s see this in action<a class="headerlink" href="#let-s-see-this-in-action" title="Permalink to this heading">¶</a></h2>
+<p>CUDA-Q provides some CMake utilities to make the creation of your new simulation library
+easier. Specifically, by using <code class="code docutils literal notranslate"><span class="pre">find_package(NVQIR)</span></code>, you’ll get access to a <code class="code docutils literal notranslate"><span class="pre">nvqir_add_backend</span></code> function
+that will automate much of the boilerplate for creating your library and configuration file.</p>
+<p>Let’s assume you want a simulation subtype named <code class="code docutils literal notranslate"><span class="pre">MySimulator</span></code>. You can create a folder or
+repository for this code called <code class="code docutils literal notranslate"><span class="pre">my-simulator</span></code> and add <code class="code docutils literal notranslate"><span class="pre">MySimulator.cpp</span></code> and
+<code class="code docutils literal notranslate"><span class="pre">CMakeLists.txt</span></code> files. Fill the CMake file with the following:</p>
+<div class="highlight-cmake notranslate"><div class="highlight"><pre><span></span><span class="nb">cmake_minimum_required</span><span class="p">(</span><span class="s">VERSION</span><span class="w"> </span><span class="s">3.24</span><span class="w"> </span><span class="s">FATAL_ERROR</span><span class="p">)</span>
+<span class="nb">project</span><span class="p">(</span><span class="s">DemoCreateNVQIRBackend</span><span class="w"> </span><span class="s">VERSION</span><span class="w"> </span><span class="s">1.0.0</span><span class="w"> </span><span class="s">LANGUAGES</span><span class="w"> </span><span class="s">CXX</span><span class="p">)</span>
+<span class="nb">find_package</span><span class="p">(</span><span class="s">NVQIR</span><span class="w"> </span><span class="s">REQUIRED</span><span class="p">)</span>
+<span class="nb">nvqir_add_backend</span><span class="p">(</span><span class="s">MySimulator</span><span class="w"> </span><span class="s">MySimulator.cpp</span><span class="w"> </span><span class="s2">&quot;&quot;</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>and then fill out your <code class="code docutils literal notranslate"><span class="pre">MySimulator.cpp</span></code> file with your subtype implementation. For example,</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;CircuitSimulator.h&quot;</span>
+
+<span class="k">namespace</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">MySimulator</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="k">public</span><span class="w"> </span><span class="n">nvqir</span><span class="o">::</span><span class="n">CircuitSimulatorBase</span><span class="o">&lt;</span><span class="kt">double</span><span class="o">&gt;</span><span class="w"> </span><span class="p">{</span>
+
+<span class="w">  </span><span class="k">protected</span><span class="o">:</span>
+<span class="w">    </span><span class="c1">/// @brief Grow the state vector by one qubit.</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">addQubitToState</span><span class="p">()</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="c1">/// @brief Grow the state vector by `count` qubit.</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">addQubitsToState</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">count</span><span class="p">)</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="c1">/// @brief Reset the qubit state.</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">resetQubitStateImpl</span><span class="p">()</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="c1">/// @brief Apply the given gate</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="n">applyGate</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="n">GateApplicationTask</span><span class="w"> </span><span class="o">&amp;</span><span class="n">task</span><span class="p">)</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">  </span><span class="k">public</span><span class="o">:</span>
+<span class="w">    </span><span class="n">MySimulator</span><span class="p">()</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">default</span><span class="p">;</span>
+<span class="w">    </span><span class="k">virtual</span><span class="w"> </span><span class="o">~</span><span class="n">MySimulator</span><span class="p">()</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">default</span><span class="p">;</span>
+
+<span class="w">    </span><span class="kt">bool</span><span class="w"> </span><span class="nf">measureQubit</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">qubitIdx</span><span class="p">)</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="nf">resetQubit</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="o">&amp;</span><span class="n">qubitIdx</span><span class="p">)</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="n">cudaq</span><span class="o">::</span><span class="n">SampleResult</span><span class="w"> </span><span class="nf">sample</span><span class="p">(</span><span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="o">&gt;</span><span class="w"> </span><span class="o">&amp;</span><span class="n">measuredBits</span><span class="p">,</span>
+<span class="w">                          </span><span class="kt">int</span><span class="w"> </span><span class="n">shots</span><span class="p">)</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">string_view</span><span class="w"> </span><span class="nf">name</span><span class="p">()</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="k">override</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="s">&quot;MySimulator&quot;</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
+
+<span class="w">  </span><span class="p">};</span>
+
+<span class="p">}</span><span class="w"> </span><span class="c1">// namespace</span>
+
+<span class="c1">/// Register this Simulator with NVQIR.</span>
+<span class="n">NVQIR_REGISTER_SIMULATOR</span><span class="p">(</span><span class="n">MySimulator</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>To build, install, and use this simulation backend, run the following from the top-level of <code class="code docutils literal notranslate"><span class="pre">my-simulator</span></code>:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">CUDA_QUANTUM_PATH</span><span class="o">=</span>/path/to/cuda_quantum/install
+mkdir<span class="w"> </span>build<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>build
+cmake<span class="w"> </span>..<span class="w"> </span>-G<span class="w"> </span>Ninja<span class="w"> </span>-DNVQIR_DIR<span class="o">=</span><span class="s2">&quot;</span><span class="nv">$CUDA_QUANTUM_PATH</span><span class="s2">/lib/cmake/nvqir&quot;</span>
+ninja<span class="w"> </span>install
+</pre></div>
+</div>
+<p>Then given any CUDA-Q source file, you can compile and target your backend simulator with the following:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>file.cpp<span class="w"> </span>--target<span class="w"> </span>MySimulator
+./a.out
+</pre></div>
+</div>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="extending.html" class="btn btn-neutral float-left" title="Extending CUDA-Q" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cudaq_ir.html" class="btn btn-neutral float-right" title="Working with the CUDA-Q IR" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/install/data_center_install.html b/pr-2241/using/install/data_center_install.html
new file mode 100644
index 0000000000..8214ad349b
--- /dev/null
+++ b/pr-2241/using/install/data_center_install.html
@@ -0,0 +1,1155 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Installation from Source &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Integration with other Software Tools" href="../integration/integration.html" />
+    <link rel="prev" title="Local Installation" href="local_installation.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="install.html">   Installation</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="install.html">Installation Guide</a></li>
+      <li class="breadcrumb-item active">Installation from Source</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/install/data_center_install.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="local_installation.html" class="btn btn-neutral float-left" title="Local Installation" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../integration/integration.html" class="btn btn-neutral float-right" title="Integration with other Software Tools" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="installation-from-source">
+<h1>Installation from Source<a class="headerlink" href="#installation-from-source" title="Permalink to this heading">¶</a></h1>
+<p>In most cases, you should not need to build CUDA-Q from source. For the
+best experience, we recommend using a container runtime to avoid conflicts with
+other software tools installed on the system. Note that <a class="reference external" href="https://docs.sylabs.io/guides/2.6/user-guide/faq.html#what-is-so-special-about-singularity">Singularity</a>
+or <a class="reference external" href="https://docs.docker.com/engine/security/rootless/">Docker rootless mode</a>
+address common issue or concerns that are often the motivation for
+avoiding the use of containers. Singularity, for example, can be installed
+in a user folder and its installation does not require admin permissions; see
+<a class="reference internal" href="local_installation.html#install-singularity-image"><span class="std std-ref">this section</span></a> for more detailed instructions
+on how to do that. Our installation guide also contains instructions for how to
+<a class="reference internal" href="local_installation.html#local-development-with-vscode"><span class="std std-ref">connect an IDE</span></a> to a running container.</p>
+<p>If you do not want use a container runtime, we also provide pre-built binaries
+for using CUDA-Q with C++, and Python wheels for using CUDA-Q with Python.
+These binaries and wheels are built following the instructions
+in this guide and should work for you as long as your system meets the compatibility
+requirements listed under <a class="reference internal" href="#compatibility-prebuilt-binaries"><span class="std std-ref">Prerequisites</span></a>.
+To install the pre-built binaries, please follow the instructions
+<a class="reference internal" href="local_installation.html#install-prebuilt-binaries"><span class="std std-ref">here</span></a>. To install the Python wheels, please
+follow the instructions <a class="reference internal" href="local_installation.html#install-python-wheels"><span class="std std-ref">here</span></a>.</p>
+<p>If your system is not listed as supported by our official packages, e.g. because you would
+like to use CUDA-Q on an operating system that uses an older C standard library,
+please follow this guide carefully without skipping any steps to build and install
+CUDA-Q from source. The rest of this guide details system requirements
+during the build and after installation, and walks through the installation steps.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>CUDA-Q contains some components that are only included as
+pre-built binaries and not part of our open source repository. We are working on
+either open-sourcing these components or making them available as separate downloads
+in the future. Even without these components, almost all features of CUDA-Q
+will be enabled in a source build, though some pieces may be less performant.
+At this time, the <a class="reference internal" href="../backends/simulators.html#nvidia-mgpu-backend"><span class="std std-ref">multi-GPU state vector simulator</span></a>
+backend will not be included if you build CUDA-Q from source.</p>
+</div>
+<section id="prerequisites">
+<span id="compatibility-prebuilt-binaries"></span><h2>Prerequisites<a class="headerlink" href="#prerequisites" title="Permalink to this heading">¶</a></h2>
+<p>The following pre-requisites need to be satisfied both on the build system and
+on the host system, that is the system where the built CUDA-Q binaries
+will be installed and used.</p>
+<ul class="simple">
+<li><p>Linux operating system. The instructions in this guide have been validated
+with the <a class="reference external" href="https://hub.docker.com/u/almalinux">AlmaLinux 8 image</a> that
+serves as the base image for the <a class="reference external" href="https://github.com/pypa/manylinux">manylinux_2_28 image</a>, and should work for the operating
+systems CentOS 8, Debian 11 and 12, Fedora 38, OpenSUSE/SLED/SLES 15.5, RHEL 8
+and 9, Rocky 8 and 9, and Ubuntu 22.04. Other operating systems may work, but
+have not been tested.</p></li>
+<li><p><a class="reference external" href="https://www.gnu.org/software/bash/">Bash</a> shell. The CUDA-Q
+build, install and run scripts expect to use <code class="code docutils literal notranslate"><span class="pre">/bin/bash</span></code>.</p></li>
+<li><p><a class="reference external" href="https://www.gnu.org/software/libc/">GNU C library</a>.
+Make sure that the version on the host system is the same one
+or newer than the version on the build system. Our own builds
+use version 2.28.</p></li>
+<li><p>CPU with either x86-64 (x86-64-v3 architecture and newer) or ARM64
+(ARM v8-A architecture and newer). Other architectures may work but are not tested and may require
+adjustments to the build instructions.</p></li>
+<li><p>Needed <strong>only on the host</strong> system: NVIDIA GPU with Volta, Turing, Ampere, Ada, or
+Hopper architecture and <a class="reference external" href="https://developer.nvidia.com/cuda-gpus">Compute Capability</a> 7+. Make sure you have the latest
+<a class="reference external" href="https://www.nvidia.com/download/index.aspx">drivers</a> installed for your
+GPU, and double check that the driver version listed by the <code class="code docutils literal notranslate"><span class="pre">nvidia-smi</span></code>
+command is 470.57.02 or newer. You do <em>not</em> need to have a GPU available on the
+build system; the CUDA compiler needed for the build can be installed and used
+without a GPU.</p></li>
+</ul>
+<p>We strongly recommend using a virtual environment for the build that includes
+<em>only</em> the tools and dependencies listed in this guide. If you have additional
+software installed, you will need to make sure that the build is linking against
+the correct libraries and versions.</p>
+</section>
+<section id="build-dependencies">
+<h2>Build Dependencies<a class="headerlink" href="#build-dependencies" title="Permalink to this heading">¶</a></h2>
+<p>In addition to the prerequisites listed above, you will need to install the
+following prerequisites in your build environment prior to proceeding with
+the build as described in the subsequent sections:</p>
+<ul class="simple">
+<li><p>Python version 3.8 or newer: If you intend to build CUDA-Q with Python
+support, make sure the Python version on the build system matches the version
+on the host system. If you intend to only build the C++ support for
+CUDA-Q, the Python interpreter is required only for some of the
+LLVM build scripts and the Python version used for the build does not have
+to match the version on the host system.</p></li>
+<li><p>Common tools: <code class="code docutils literal notranslate"><span class="pre">wget</span></code>, <code class="code docutils literal notranslate"><span class="pre">git</span></code>, <code class="code docutils literal notranslate"><span class="pre">unzip</span></code>. The commands in the rest of this guide assume
+that these tools are present on the build system, but they can be replaced by
+other alternatives (such as, for example, manually going to a web page and
+downloading a file/folder).</p></li>
+</ul>
+<p>The above prerequisites are no longer needed once CUDA-Q is built and
+do not need to be present on the host system.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The CUDA-Q build scripts and the commands listed in the rest of this
+document assume you are using <code class="code docutils literal notranslate"><span class="pre">bash</span></code> as the shell for your build.</p>
+</div>
+<p>In addition to installing the needed build dependencies listed above, make sure
+to set the following environment variables prior to proceeding:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">CUDAQ_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/cudaq
+<span class="nb">export</span><span class="w"> </span><span class="nv">CUQUANTUM_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/cuquantum
+<span class="nb">export</span><span class="w"> </span><span class="nv">CUTENSOR_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/cutensor
+<span class="nb">export</span><span class="w"> </span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/llvm
+<span class="nb">export</span><span class="w"> </span><span class="nv">BLAS_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/blas
+<span class="nb">export</span><span class="w"> </span><span class="nv">ZLIB_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/zlib
+<span class="nb">export</span><span class="w"> </span><span class="nv">OPENSSL_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/openssl
+<span class="nb">export</span><span class="w"> </span><span class="nv">CURL_INSTALL_PREFIX</span><span class="o">=</span>/usr/local/curl
+</pre></div>
+</div>
+<p>These environment variables <em>must</em> be set during the build. We strongly
+recommend that their value is set to a path that does <em>not</em> already exist;
+this will ensure that these components are built/installed as needed when
+building CUDA-Q.
+The configured paths can be chosen freely, but the paths specified during the
+build are also where the corresponding libraries will be installed on the
+host system. We are working on making this more flexible in the future.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Please do <strong>not</strong> set <code class="code docutils literal notranslate"><span class="pre">LLVM_INSTALL_PREFIX</span></code> to an existing directory;
+To avoid compatibility issues, it is important to use the same compiler
+to build the LLVM/MLIR dependencies from source as is later used to
+build CUDA-Q itself.</p>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you are setting the <code class="code docutils literal notranslate"><span class="pre">CURL_INSTALL_PREFIX</span></code> variable to an existing
+CURL installation (not recommended), please make sure the command
+<code class="code docutils literal notranslate"><span class="pre">curl</span> <span class="pre">--version</span></code> lists HTTP and HTTPS as supported protocols. If these
+protocols are not listed, please instead set the <code class="code docutils literal notranslate"><span class="pre">CURL_INSTALL_PREFIX</span></code>
+variable to a path that does <em>not</em> exist. In that case, a suitable
+library will be automatically built from source as part of
+building CUDA-Q.</p>
+</div>
+<p>If you deviate from the instructions below for installing one of the
+dependencies and instead install it, for example, via package manager, you will
+need to make sure that the installation path matches the path you set for the
+corresponding environment variable(s).</p>
+<section id="cuda">
+<h3>CUDA<a class="headerlink" href="#cuda" title="Permalink to this heading">¶</a></h3>
+<p>Building CUDA-Q requires a full installation of the CUDA toolkit.
+<strong>You can install the CUDA toolkit and use the CUDA compiler without having a GPU.</strong>
+The instructions are tested using version 11.8, but any CUDA 11 or 12 version
+should work, as long as the CUDA runtime version on the host system matches the
+CUDA version used for the build, and the installed driver on the host
+system supports that CUDA version. We recommend using the latest CUDA version
+that is supported by the driver on the host system.</p>
+<p>Download a suitable <a class="reference external" href="https://developer.nvidia.com/cuda-toolkit-archive">CUDA version</a>
+following the installation guide for your platform in the online documentation
+linked on that page.</p>
+<p>Within the tested AlmaLinux 8 environment, for example, the following commands
+install CUDA 11.8:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDA_VERSION</span><span class="o">=</span><span class="m">11</span>.8
+<span class="nv">CUDA_DOWNLOAD_URL</span><span class="o">=</span>https://developer.download.nvidia.com/compute/cuda/repos
+<span class="c1"># Go to the url above, set the variables below to a suitable distribution</span>
+<span class="c1"># and subfolder for your platform, and uncomment the line below.</span>
+<span class="c1"># DISTRIBUTION=rhel8 CUDA_ARCH_FOLDER=x86_64</span>
+
+dnf<span class="w"> </span>config-manager<span class="w"> </span>--add-repo<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDA_DOWNLOAD_URL</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">DISTRIBUTION</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">CUDA_ARCH_FOLDER</span><span class="si">}</span><span class="s2">/cuda-</span><span class="si">${</span><span class="nv">DISTRIBUTION</span><span class="si">}</span><span class="s2">.repo&quot;</span>
+dnf<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>--nobest<span class="w"> </span>--setopt<span class="o">=</span><span class="nv">install_weak_deps</span><span class="o">=</span>False<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>cuda-toolkit-<span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="si">${</span><span class="nv">CUDA_VERSION</span><span class="si">}</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>tr<span class="w"> </span>.<span class="w"> </span>-<span class="k">)</span>
+</pre></div>
+</div>
+</section>
+<section id="toolchain">
+<h3>Toolchain<a class="headerlink" href="#toolchain" title="Permalink to this heading">¶</a></h3>
+<p>The compiler toolchain used for the build must be a supported
+<a class="reference external" href="https://docs.nvidia.com/cuda/cuda-compiler-driver-nvcc/index.html#supported-host-compilers">CUDA host compiler</a>
+for the installed CUDA version.
+The following instructions have been tested with <a class="reference external" href="https://gcc.gnu.org/index.html">GCC-11</a>.
+Other toolchains may be supported but have not been tested.</p>
+<p>Within the tested AlmaLinux 8 environment, for example, the following commands
+install GCC 11:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">GCC_VERSION</span><span class="o">=</span><span class="m">11</span>
+dnf<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>--nobest<span class="w"> </span>--setopt<span class="o">=</span><span class="nv">install_weak_deps</span><span class="o">=</span>False<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>gcc-toolset-<span class="si">${</span><span class="nv">GCC_VERSION</span><span class="si">}</span>
+<span class="c1"># Enabling the toolchain globally is only needed for debug builds</span>
+<span class="c1"># to ensure that the correct assembler is picked to process debug symbols.</span>
+<span class="nv">enable_script</span><span class="o">=</span><span class="sb">`</span>find<span class="w"> </span>/<span class="w"> </span>-path<span class="w"> </span><span class="s1">&#39;*gcc*&#39;</span><span class="w"> </span>-path<span class="w"> </span><span class="s1">&#39;*&#39;</span><span class="nv">$GCC_VERSIONS</span><span class="s1">&#39;*&#39;</span><span class="w"> </span>-name<span class="w"> </span><span class="nb">enable</span><span class="sb">`</span>
+<span class="k">if</span><span class="w"> </span><span class="o">[</span><span class="w"> </span>-n<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$enable_script</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">]</span><span class="p">;</span><span class="w"> </span><span class="k">then</span>
+<span class="w">    </span>.<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$enable_script</span><span class="s2">&quot;</span>
+<span class="k">fi</span>
+</pre></div>
+</div>
+<p>Independent on which compiler toolchain you installed, set the following
+environment variables to point to the respective compilers on your build system:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">export</span><span class="w"> </span><span class="nv">GCC_TOOLCHAIN</span><span class="o">=</span>/opt/rh/gcc-toolset-11/root/usr/
+<span class="nb">export</span><span class="w"> </span><span class="nv">CXX</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">GCC_TOOLCHAIN</span><span class="si">}</span><span class="s2">/bin/g++&quot;</span>
+<span class="nb">export</span><span class="w"> </span><span class="nv">CC</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">GCC_TOOLCHAIN</span><span class="si">}</span><span class="s2">/bin/gcc&quot;</span>
+<span class="nb">export</span><span class="w"> </span><span class="nv">CUDACXX</span><span class="o">=</span>/usr/local/cuda/bin/nvcc
+<span class="nb">export</span><span class="w"> </span><span class="nv">CUDAHOSTCXX</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">GCC_TOOLCHAIN</span><span class="si">}</span><span class="s2">/bin/g++&quot;</span>
+</pre></div>
+</div>
+<ul class="simple">
+<li><p>The variables <code class="code docutils literal notranslate"><span class="pre">CC</span></code> and <code class="code docutils literal notranslate"><span class="pre">CXX</span></code> <em>must</em> be set for the CUDA-Q build.</p></li>
+<li><p>To use GPU-acceleration in CUDA-Q, make sure to set <code class="code docutils literal notranslate"><span class="pre">CUDACXX</span></code> to
+your CUDA compiler, and <code class="code docutils literal notranslate"><span class="pre">CUDAHOSTCXX</span></code> to the CUDA compatible host
+compiler you are using. If the CUDA compiler is not found when building
+CUDA-Q, some components and backends will be omitted automatically
+during the build.</p></li>
+</ul>
+</section>
+</section>
+<section id="building-cuda-q">
+<h2>Building CUDA-Q<a class="headerlink" href="#building-cuda-q" title="Permalink to this heading">¶</a></h2>
+<p>This installation guide has been written for a specific version/commit of CUDA-Q.
+Make sure to obtain the source code for that version.
+Clone the CUDA-Q <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a> and
+checkout the appropriate branch, tag, or commit.
+Note that the build scripts assume that they are run from within a git repository,
+and merely downloading the source code as ZIP archive hence will not work.</p>
+<p>Please follow the instructions in the respective subsection(s) to build the necessary
+components for using CUDA-Q from C++ and/or Python.
+After the build, check that the GPU-accelerated components have been built by confirming
+that the file <code class="code docutils literal notranslate"><span class="pre">nvidia.config</span></code> exists in the <code class="code docutils literal notranslate"><span class="pre">$CUDAQ_INSTALL_PREFIX/targets</span></code> folder.
+We also recommend checking the build log printed to the console to confirm that all desired
+components have been built.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The CUDA-Q build will compile or omit optional components automatically depending
+on whether the necessary pre-requisites are found in the build environment.
+If you see a message that a component has been skipped, and/or the CUDA compiler
+is not properly detected, make sure you followed the
+instructions for installing the necessary prerequisites and build dependencies,
+and have set the necessary environment variables as described in this document.</p>
+</div>
+</section>
+<section id="python-support">
+<span id="cudaq-python-from-source"></span><h2>Python Support<a class="headerlink" href="#python-support" title="Permalink to this heading">¶</a></h2>
+<p>The most convenient way to enable Python support within CUDA-Q is to build
+a <a class="reference external" href="https://pythonwheels.com/">wheel</a> that can then easily be installed
+using <code class="code docutils literal notranslate"><span class="pre">pip</span></code>. To ensure the wheel can be installed on the host system, make sure to
+use the same Python version for the build as the one that is installed on the host system.
+To build a CUDA-Q Python wheel, you will need to install the following additional
+Python-specific tools:</p>
+<ul class="simple">
+<li><p>Python development headers: The development headers for your Python version are installed
+in the way as you installed Python itself. If you installed Python via the package manager
+for your system, you may need to install an additional package to get the development headers.
+The package name is usually your python version followed by either a <code class="code docutils literal notranslate"><span class="pre">-dev</span></code> or <code class="code docutils literal notranslate"><span class="pre">-devel</span></code> suffix.
+If you are using a <a class="reference external" href="https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-python.html">Conda environment</a>,
+the necessary headers should already be installed.</p></li>
+<li><p>Pip package manager: Make sure the <code class="code docutils literal notranslate"><span class="pre">pip</span></code> module is enable for your Python version.
+We refer to the Python <a class="reference external" href="https://pip.pypa.io/en/stable/installation/">documentation</a> for
+more information about installing/enabling <code class="code docutils literal notranslate"><span class="pre">pip</span></code>.</p></li>
+<li><p>Python modules: Install the additional modules <code class="code docutils literal notranslate"><span class="pre">numpy</span></code>, <code class="code docutils literal notranslate"><span class="pre">build</span></code>, <code class="code docutils literal notranslate"><span class="pre">auditwheel</span></code>, and <code class="code docutils literal notranslate"><span class="pre">patchelf</span></code> for your
+Python version, e.g. <code class="code docutils literal notranslate"><span class="pre">python3</span> <span class="pre">-m</span> <span class="pre">pip</span> <span class="pre">install</span> <span class="pre">numpy</span> <span class="pre">build</span> <span class="pre">auditwheel</span> <span class="pre">patchelf</span></code>.</p></li>
+</ul>
+<p>From within the folder where you cloned the CUDA-Q repository, run the following
+command to build the CUDA-Q Python wheel:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">LLVM_PROJECTS</span><span class="o">=</span><span class="s1">&#39;clang;flang;lld;mlir;python-bindings;openmp;runtimes&#39;</span><span class="w"> </span><span class="se">\</span>
+bash<span class="w"> </span>scripts/install_prerequisites.sh<span class="w"> </span>-t<span class="w"> </span>llvm<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+<span class="nv">CC</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$LLVM_INSTALL_PREFIX</span><span class="s2">/bin/clang&quot;</span><span class="w"> </span><span class="se">\</span>
+<span class="nv">CXX</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$LLVM_INSTALL_PREFIX</span><span class="s2">/bin/clang++&quot;</span><span class="w"> </span><span class="se">\</span>
+<span class="nv">FC</span><span class="o">=</span><span class="s2">&quot;</span><span class="nv">$LLVM_INSTALL_PREFIX</span><span class="s2">/bin/flang-new&quot;</span><span class="w"> </span><span class="se">\</span>
+python3<span class="w"> </span>-m<span class="w"> </span>build<span class="w"> </span>--wheel
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>A version identifier will be automatically assigned to the wheel based on the commit
+history. You can manually override this detection to give a more descriptive identifier
+by setting the environment variable <code class="code docutils literal notranslate"><span class="pre">SETUPTOOLS_SCM_PRETEND_VERSION</span></code> to the desired
+value before building the wheel.</p>
+</div>
+<p>After the initial build, <a class="reference external" href="https://github.com/pypa/auditwheel">auditwheel</a> is used to
+include dependencies in the wheel, if necessary, and correctly label the wheel.
+We recommend not including the CUDA runtime libraries and instead install them separately
+on the host system following the instructions in the next section. The following
+command builds the final wheel, not including CUDA dependencies:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_WHEEL</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span>find<span class="w"> </span>.<span class="w"> </span>-name<span class="w"> </span><span class="s1">&#39;cuda_quantum*.whl&#39;</span><span class="k">)</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+<span class="nv">MANYLINUX_PLATFORM</span><span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="si">${</span><span class="nv">CUDAQ_WHEEL</span><span class="si">}</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>-o<span class="w"> </span><span class="s1">&#39;[a-z]*linux_[^\.]*&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span>-re<span class="w"> </span><span class="s1">&#39;s/^linux_/manylinux_2_28_/&#39;</span><span class="k">)</span><span class="s2">&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+<span class="nv">LD_LIBRARY_PATH</span><span class="o">=</span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LD_LIBRARY_PATH</span><span class="si">}</span><span class="s2">:</span><span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span><span class="s2">/_skbuild/lib&quot;</span><span class="w"> </span><span class="se">\ </span>
+python3<span class="w"> </span>-m<span class="w"> </span>auditwheel<span class="w"> </span>-v<span class="w"> </span>repair<span class="w"> </span><span class="si">${</span><span class="nv">CUDAQ_WHEEL</span><span class="si">}</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--plat<span class="w"> </span><span class="si">${</span><span class="nv">MANYLINUX_PLATFORM</span><span class="si">}</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcublas.so.11<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcublasLt.so.11<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcusolver.so.11<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcutensor.so.2<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcutensornet.so.2<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcustatevec.so.1<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libcudart.so.11.0<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libnvToolsExt.so.1<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--exclude<span class="w"> </span>libnvidia-ml.so.1
+</pre></div>
+</div>
+<p>The command above will create a new wheel in the <code class="code docutils literal notranslate"><span class="pre">wheelhouse</span></code> folder. This wheel can be
+installed on any <a class="reference external" href="https://packaging.python.org/en/latest/specifications/platform-compatibility-tags/">compatible platform</a>.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>You can confirm that the wheel is indeed compatible with your host platform by
+checking that the wheel tag (i.e. the file name ending of the <code class="code docutils literal notranslate"><span class="pre">.whl</span></code> file) is listed under
+“Compatible Tags” when running the command <code class="code docutils literal notranslate"><span class="pre">python3</span> <span class="pre">-m</span> <span class="pre">pip</span> <span class="pre">debug</span> <span class="pre">--verbose</span></code> on the host.</p>
+</div>
+</section>
+<section id="c-support">
+<span id="cudaq-cpp-from-source"></span><h2>C++ Support<a class="headerlink" href="#c-support" title="Permalink to this heading">¶</a></h2>
+<p>From within the folder where you cloned the CUDA-Q repository, run the following
+command to build CUDA-Q:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDAQ_ENABLE_STATIC_LINKING</span><span class="o">=</span>TRUE<span class="w"> </span><span class="se">\</span>
+<span class="nv">CUDAQ_REQUIRE_OPENMP</span><span class="o">=</span>TRUE<span class="w"> </span><span class="se">\</span>
+<span class="nv">CUDAQ_WERROR</span><span class="o">=</span>TRUE<span class="w"> </span><span class="se">\</span>
+<span class="nv">CUDAQ_PYTHON_SUPPORT</span><span class="o">=</span>OFF<span class="w"> </span><span class="se">\</span>
+<span class="nv">LLVM_PROJECTS</span><span class="o">=</span><span class="s1">&#39;clang;flang;lld;mlir;openmp;runtimes&#39;</span><span class="w"> </span><span class="se">\</span>
+bash<span class="w"> </span>scripts/build_cudaq.sh<span class="w"> </span>-t<span class="w"> </span>llvm<span class="w"> </span>-v
+</pre></div>
+</div>
+<p>Note that <code class="code docutils literal notranslate"><span class="pre">lld</span></code> is primarily needed when the build or host system does not already
+have an existing default linker on its path; CUDA-Q supports the same linkers as
+<code class="code docutils literal notranslate"><span class="pre">clang</span></code> does.</p>
+<p>To easily migrate the built binaries to the host system, we recommend creating a
+<a class="reference external" href="https://makeself.io/">self-extracting archive</a>. To do so, download the
+<a class="reference external" href="https://github.com/megastep/makeself">makeself script(s)</a> and move the necessary
+files to install into a separate folder using the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mkdir<span class="w"> </span>-p<span class="w"> </span>cuda_quantum_assets/llvm/bin<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mkdir<span class="w"> </span>-p<span class="w"> </span>cuda_quantum_assets/llvm/lib<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mkdir<span class="w"> </span>-p<span class="w"> </span>cuda_quantum_assets/llvm/include<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/bin/&quot;</span>clang*<span class="w"> </span>cuda_quantum_assets/llvm/bin/<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span>cuda_quantum_assets/llvm/bin/clang-format*<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/bin/&quot;</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/bin/llc&quot;</span><span class="w"> </span>cuda_quantum_assets/llvm/bin/llc<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/bin/lld&quot;</span><span class="w"> </span>cuda_quantum_assets/llvm/bin/lld<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/bin/ld.lld&quot;</span><span class="w"> </span>cuda_quantum_assets/llvm/bin/ld.lld<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/lib/&quot;</span>*<span class="w"> </span>cuda_quantum_assets/llvm/lib/<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">LLVM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/include/&quot;</span>*<span class="w"> </span>cuda_quantum_assets/llvm/include/<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUTENSOR_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>cuda_quantum_assets<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUQUANTUM_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>cuda_quantum_assets<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDAQ_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">/build_config.xml&quot;</span><span class="w"> </span>cuda_quantum_assets/build_config.xml<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="se">\</span>
+mv<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDAQ_INSTALL_PREFIX</span><span class="si">}</span><span class="s2">&quot;</span><span class="w"> </span>cuda_quantum_assets
+</pre></div>
+</div>
+<p>You can then create a self-extracting archive with the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>./makeself.sh<span class="w"> </span>--gzip<span class="w"> </span>--sha256<span class="w"> </span>--license<span class="w"> </span>cuda_quantum_assets/cudaq/LICENSE<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>cuda_quantum_assets<span class="w"> </span>install_cuda_quantum.<span class="k">$(</span>uname<span class="w"> </span>-m<span class="k">)</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span><span class="s2">&quot;CUDA-Q toolkit for heterogeneous quantum-classical workflows&quot;</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>bash<span class="w"> </span>cudaq/migrate_assets.sh<span class="w"> </span>-t<span class="w"> </span>/opt/nvidia/cudaq
+</pre></div>
+</div>
+</section>
+<section id="installation-on-the-host">
+<h2>Installation on the Host<a class="headerlink" href="#installation-on-the-host" title="Permalink to this heading">¶</a></h2>
+<p>Make sure your host system satisfies the <a class="reference internal" href="#prerequisites">Prerequisites</a> listed above.</p>
+<ul class="simple">
+<li><p>To use CUDA-Q with Python, you should have a working
+Python installation on the host system, including the <code class="code docutils literal notranslate"><span class="pre">pip</span></code> package manager.</p></li>
+<li><p>To use CUDA-Q with C++, you should make sure that you have the necessary development
+headers of the C standard library installed. You can check this by searching for
+<code class="code docutils literal notranslate"><span class="pre">features.h</span></code>, commonly found in <code class="code docutils literal notranslate"><span class="pre">/usr/include/</span></code>. You can install the necessary headers
+via package manager (usually the package name is called something like <code class="code docutils literal notranslate"><span class="pre">glibc-devel</span></code>
+or <code class="code docutils literal notranslate"><span class="pre">libc6-devel</span></code>). These headers are also included with any installation of GCC.</p></li>
+</ul>
+<p>To use CUDA-Q with Python, you should have a working
+Python installation on the host system, including the <code class="code docutils literal notranslate"><span class="pre">pip</span></code> package manager.</p>
+<p>If you followed the instructions for building the
+<a class="reference internal" href="#cudaq-python-from-source"><span class="std std-ref">CUDA-Q Python wheel</span></a>,
+copy the built <code class="code docutils literal notranslate"><span class="pre">.whl</span></code> file to the host system, and install it using <code class="code docutils literal notranslate"><span class="pre">pip</span></code>; e.g.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>pip<span class="w"> </span>install<span class="w"> </span>cuda_quantum*.whl
+</pre></div>
+</div>
+<p>To install the necessary CUDA and MPI dependencies for some of the components,
+you can either follow the instructions on <a class="reference external" href="https://pypi.org/project/cuda-quantum/">PyPI.org</a>,
+replacing <code class="code docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">cuda-quantum</span></code> with the command above, or you can follow the
+instructions in the remaining sections of this document to customize and better
+optimize them for your host system.</p>
+<p>If you followed the instructions for building the
+<a class="reference internal" href="#cudaq-cpp-from-source"><span class="std std-ref">CUDA-Q C++ tools</span></a>,
+copy the <code class="code docutils literal notranslate"><span class="pre">install_cuda_quantum</span></code> file that you created to the host system,
+and install it by running the commands</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>bash<span class="w"> </span>install_cuda_quantum.<span class="k">$(</span>uname<span class="w"> </span>-m<span class="k">)</span><span class="w"> </span>--accept
+.<span class="w"> </span>/opt/nvidia/cudaq/set_env.sh
+</pre></div>
+</div>
+<p>This will extract the built assets and move them to the correct locations.
+The <code class="code docutils literal notranslate"><span class="pre">set_env.sh</span></code> script in <code class="code docutils literal notranslate"><span class="pre">/opt/nvidia/cudaq</span></code> defines the necessary environment
+variables to use CUDA-Q. To avoid having to set them manually every time a
+new shell is opened, we highly recommend adding the following lines to
+the <code class="code docutils literal notranslate"><span class="pre">/etc/profile</span></code> file:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="k">if</span><span class="w"> </span><span class="o">[</span><span class="w"> </span>-f<span class="w"> </span>/opt/nvidia/cudaq/set_env.sh<span class="w"> </span><span class="o">]</span><span class="p">;</span>
+<span class="w">  </span>.<span class="w"> </span>/opt/nvidia/cudaq/set_env.sh
+<span class="k">fi</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>CUDA-Q as built following the instructions above includes and uses the LLVM
+C++ standard library. This will not interfere with any other C++ standard library
+you may have on your system. Pre-built external libraries, you may want to use with
+CUDA-Q, such as specific optimizers for example, have a C API to ensure compatibility
+across different versions of the C++ standard library and will work with CUDA-Q without
+issues. The same is true for all distributed CUDA libraries. To build you own CUDA
+libraries that can be used with CUDA-Q, please take a look at <a class="reference internal" href="../integration/cuda_gpu.html"><span class="doc">Using CUDA and CUDA-Q in a Project</span></a>.</p>
+</div>
+<p>The remaining sections in this document list additional runtime dependencies
+that are not included in the migrated assets and are needed to use some of the
+CUDA-Q features and components.</p>
+<section id="cuda-runtime-libraries">
+<h3>CUDA Runtime Libraries<a class="headerlink" href="#cuda-runtime-libraries" title="Permalink to this heading">¶</a></h3>
+<p>To use GPU-acceleration in CUDA-Q you will need to install the necessary
+CUDA runtime libraries. Their version (at least the version major) needs to match the version
+used for the build. While not necessary, we recommend installing
+the complete CUDA toolkit like you did for the CUDA-Q build.
+If you prefer to only install the minimal set of runtime libraries, the following
+commands, for example, install the necessary packages for the AlmaLinux 8 environment:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDA_VERSION</span><span class="o">=</span><span class="m">11</span>.8
+<span class="nv">CUDA_DOWNLOAD_URL</span><span class="o">=</span>https://developer.download.nvidia.com/compute/cuda/repos
+<span class="c1"># Go to the url above, set the variables below to a suitable distribution</span>
+<span class="c1"># and subfolder for your platform, and uncomment the line below.</span>
+<span class="c1"># DISTRIBUTION=rhel8 CUDA_ARCH_FOLDER=x86_64</span>
+
+<span class="nv">version_suffix</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="si">${</span><span class="nv">CUDA_VERSION</span><span class="si">}</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>tr<span class="w"> </span>.<span class="w"> </span>-<span class="k">)</span>
+dnf<span class="w"> </span>config-manager<span class="w"> </span>--add-repo<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDA_DOWNLOAD_URL</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">DISTRIBUTION</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">CUDA_ARCH_FOLDER</span><span class="si">}</span><span class="s2">/cuda-</span><span class="si">${</span><span class="nv">DISTRIBUTION</span><span class="si">}</span><span class="s2">.repo&quot;</span>
+dnf<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>--nobest<span class="w"> </span>--setopt<span class="o">=</span><span class="nv">install_weak_deps</span><span class="o">=</span>False<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>cuda-nvtx-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span><span class="w"> </span>cuda-cudart-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>libcusolver-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span><span class="w"> </span>libcublas-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span>
+</pre></div>
+</div>
+</section>
+<section id="mpi">
+<h3>MPI<a class="headerlink" href="#mpi" title="Permalink to this heading">¶</a></h3>
+<p>To work with all CUDA-Q backends, a CUDA-aware MPI installation is required.
+If you do not have an existing CUDA-aware MPI installation, you can build one from
+source. To do so, in addition to the CUDA runtime libraries listed above
+you will need to install the CUDA runtime development package
+(<code class="code docutils literal notranslate"><span class="pre">cuda-cudart-devel-${version_suffix}</span></code> or <code class="code docutils literal notranslate"><span class="pre">cuda-cudart-dev-${version_suffix}</span></code>,
+depending on your distribution).</p>
+<p>The following commands build a sufficient CUDA-aware OpenMPI installation.
+To make best use of MPI, we recommend a more fully featured installation including
+additional configurations that fit your host system.
+The commands below assume you have the necessary prerequisites for the OpenMPI build
+installed on the build system. Within the tested AlmaLinux 8 environment, for example,
+the packages <code class="code docutils literal notranslate"><span class="pre">autoconf</span></code>, <code class="code docutils literal notranslate"><span class="pre">libtool</span></code>, <code class="code docutils literal notranslate"><span class="pre">flex</span></code>, and <code class="code docutils literal notranslate"><span class="pre">make</span></code> need to be installed.</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">OPENMPI_VERSION</span><span class="o">=</span><span class="m">4</span>.1.4
+<span class="nv">OPENMPI_DOWNLOAD_URL</span><span class="o">=</span>https://github.com/open-mpi/ompi
+
+wget<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">OPENMPI_DOWNLOAD_URL</span><span class="si">}</span><span class="s2">/archive/v</span><span class="si">${</span><span class="nv">OPENMPI_VERSION</span><span class="si">}</span><span class="s2">.tar.gz&quot;</span><span class="w"> </span>-O<span class="w"> </span>/tmp/openmpi.tar.gz
+mkdir<span class="w"> </span>-p<span class="w"> </span>~/.openmpi-src<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span>tar<span class="w"> </span>xf<span class="w"> </span>/tmp/openmpi.tar.gz<span class="w"> </span>--strip-components<span class="w"> </span><span class="m">1</span><span class="w"> </span>-C<span class="w"> </span>~/.openmpi-src
+rm<span class="w"> </span>-rf<span class="w"> </span>/tmp/openmpi.tar.gz<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>~/.openmpi-src
+./autogen.pl<span class="w"> </span>
+<span class="nv">LDFLAGS</span><span class="o">=</span>-Wl,--as-needed<span class="w"> </span>./configure<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--prefix<span class="o">=</span>/usr/local/openmpi<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--disable-getpwuid<span class="w"> </span>--disable-static<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--disable-debug<span class="w"> </span>--disable-mem-debug<span class="w"> </span>--disable-event-debug<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--disable-mem-profile<span class="w"> </span>--disable-memchecker<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--without-verbs<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>--with-cuda<span class="o">=</span>/usr/local/cuda
+make<span class="w"> </span>-j<span class="k">$(</span>nproc<span class="k">)</span><span class="w"> </span>
+make<span class="w"> </span>-j<span class="k">$(</span>nproc<span class="k">)</span><span class="w"> </span>install
+<span class="nb">cd</span><span class="w"> </span>-<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span>rm<span class="w"> </span>-rf<span class="w"> </span>~/.openmpi-src
+</pre></div>
+</div>
+<p>Confirm that you have a suitable MPI implementation installed. For OpenMPI and MPICH,
+for example, this can be done by compiling and running the following program:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="c1">// Compile and run with:</span>
+<span class="c1">// ```</span>
+<span class="c1">// mpic++ mpi_cuda_check.cpp -o check.x &amp;&amp; mpiexec -np 1 ./check.x</span>
+<span class="c1">// ```</span>
+
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;mpi.h&quot;</span>
+<span class="cp">#if __has_include(&quot;mpi-ext.h&quot;)</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;mpi-ext.h&quot;</span>
+<span class="cp">#endif</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;stdio.h&gt;</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">argc</span><span class="p">,</span><span class="w"> </span><span class="kt">char</span><span class="w"> </span><span class="o">*</span><span class="n">argv</span><span class="p">[])</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">MPI_Init</span><span class="p">(</span><span class="o">&amp;</span><span class="n">argc</span><span class="p">,</span><span class="w"> </span><span class="o">&amp;</span><span class="n">argv</span><span class="p">);</span>
+<span class="w">  </span><span class="kt">int</span><span class="w"> </span><span class="n">exit_code</span><span class="p">;</span>
+<span class="w">  </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">MPIX_Query_cuda_support</span><span class="p">())</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;CUDA-aware MPI installation.</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">);</span>
+<span class="w">    </span><span class="n">exit_code</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;Missing CUDA support.</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">);</span>
+<span class="w">    </span><span class="n">exit_code</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="n">MPI_Finalize</span><span class="p">();</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="n">exit_code</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you are encountering an error similar to “The value of the MCA parameter <code class="code docutils literal notranslate"><span class="pre">plm_rsh_agent</span></code>
+was set to a path that could not be found”, please make sure you have an SSH Client installed
+or update the MCA parameter to another suitable agent.
+MPI uses <a class="reference external" href="https://en.wikipedia.org/wiki/Secure_Shell">SSH</a> or
+<a class="reference external" href="https://en.wikipedia.org/wiki/Remote_Shell">RSH</a> to communicate with each node
+unless another resource manager, such as
+<a class="reference external" href="https://slurm.schedmd.com/overview.html">SLURM</a>, is used.</p>
+</div>
+<p>Different MPI implementations are supported via a plugin infrastructure in CUDA-Q.
+Once you have a CUDA-aware MPI installation on your host system, you can
+configure CUDA-Q to use it by activating the necessary plugin.
+Plugins for OpenMPI and MPICH are included in CUDA-Q and can be activated by
+setting the environment variable <code class="code docutils literal notranslate"><span class="pre">MPI_PATH</span></code> to the MPI installation folder
+and then running the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>bash<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDA_QUANTUM_PATH</span><span class="si">}</span><span class="s2">/distributed_interfaces/activate_custom_mpi.sh&quot;</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>To activate the MPI plugin for the Python support, replace <code class="code docutils literal notranslate"><span class="pre">${CUDA_QUANTUM_PATH}</span></code>
+with the path that is listed under “Location” when you run the command
+<code class="code docutils literal notranslate"><span class="pre">pip</span> <span class="pre">show</span> <span class="pre">cuda-quantum</span></code>.</p>
+</div>
+<p>If you use a different MPI implementation than OpenMPI or MPICH, you will need to
+implement the necessary plugin interface yourself prior to activating the plugin
+with the command above.</p>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="local_installation.html" class="btn btn-neutral float-left" title="Local Installation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../integration/integration.html" class="btn btn-neutral float-right" title="Integration with other Software Tools" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/install/install.html b/pr-2241/using/install/install.html
new file mode 100644
index 0000000000..2ca6820da1
--- /dev/null
+++ b/pr-2241/using/install/install.html
@@ -0,0 +1,661 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Installation Guide &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Local Installation" href="local_installation.html" />
+    <link rel="prev" title="Multi-Processor Platforms" href="../backends/platform.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Installation Guide</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/install/install.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../backends/platform.html" class="btn btn-neutral float-left" title="Multi-Processor Platforms" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="local_installation.html" class="btn btn-neutral float-right" title="Local Installation" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="installation-guide">
+<h1>Installation Guide<a class="headerlink" href="#installation-guide" title="Permalink to this heading">¶</a></h1>
+<div class="toctree-wrapper compound" id="install-cuda-quantum">
+<p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="local_installation.html">Local Installation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="data_center_install.html">Data Center Installation</a></li>
+</ul>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../backends/platform.html" class="btn btn-neutral float-left" title="Multi-Processor Platforms" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="local_installation.html" class="btn btn-neutral float-right" title="Local Installation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/install/local_installation.html b/pr-2241/using/install/local_installation.html
new file mode 100644
index 0000000000..a39be6e933
--- /dev/null
+++ b/pr-2241/using/install/local_installation.html
@@ -0,0 +1,1424 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Local Installation &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Installation from Source" href="data_center_install.html" />
+    <link rel="prev" title="Installation Guide" href="install.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="install.html">   Installation</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="install.html">Installation Guide</a></li>
+      <li class="breadcrumb-item active">Local Installation</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/install/local_installation.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="install.html" class="btn btn-neutral float-left" title="Installation Guide" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="data_center_install.html" class="btn btn-neutral float-right" title="Installation from Source" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="local-installation">
+<h1>Local Installation<a class="headerlink" href="#local-installation" title="Permalink to this heading">¶</a></h1>
+<section id="introduction">
+<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h2>
+<p>This guide walks through how to <a class="reference internal" href="install.html#install-cuda-quantum"><span class="std std-ref">install CUDA-Q</span></a> on your system, and how to set up <a class="reference internal" href="#local-development-with-vscode"><span class="std std-ref">VS Code for local development</span></a>.
+The section on <a class="reference internal" href="#connect-to-remote"><span class="std std-ref">connecting to a remote host</span></a> contains some
+guidance for application development on a remote host where CUDA-Q is installed.</p>
+<p>The following sections contain instructions for how to install CUDA-Q on your machine using</p>
+<ul class="simple">
+<li><p><a class="reference internal" href="#install-docker-image"><span class="std std-ref">Docker</span></a>: A fully featured CUDA-Q installation including all C++ and Python tools is available as a <a class="reference external" href="https://docs.docker.com/get-started/overview/">Docker</a> image.</p></li>
+<li><p><a class="reference internal" href="#install-singularity-image"><span class="std std-ref">Singularity</span></a>: A <a class="reference external" href="https://docs.sylabs.io/guides/latest/user-guide/introduction.html">Singularity</a> container can easily be created based on our Docker images.</p></li>
+<li><p><a class="reference internal" href="#install-python-wheels"><span class="std std-ref">PyPI</span></a>: Additionally, we distribute pre-built Python wheels via <a class="reference external" href="https://pypi.org">PyPI</a>.</p></li>
+<li><p><a class="reference internal" href="#install-prebuilt-binaries"><span class="std std-ref">Pre-built binaries</span></a>: We also provide pre-built C++ binaries, bundled as <a class="reference external" href="https://makeself.io/">self-extracting archive</a>, that work across a range of Linux operating systems.</p></li>
+</ul>
+<p>If you would like to build CUDA-Q from source to deploy on an HPC system without relying on a container runtime, please follow the instructions for <a class="reference internal" href="data_center_install.html"><span class="doc">Installation from Source</span></a>.
+If, on the other hand, you want to contribute to the development of CUDA-Q itself and hence want to
+build a custom version of CUDA-Q from source, follow the instructions on the
+<a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/blob/main/Building.md">CUDA-Q GitHub repository</a> instead.</p>
+<p>If you are unsure which option suits you best, we recommend using our <a class="reference internal" href="#install-docker-image"><span class="std std-ref">Docker image</span></a> to develop your applications in a controlled environment that does not depend on, or interfere with, other software
+that is installed on your system.</p>
+<section id="docker">
+<span id="install-docker-image"></span><h3>Docker<a class="headerlink" href="#docker" title="Permalink to this heading">¶</a></h3>
+<p>To download and use our Docker images, you will need to install and launch the Docker engine.
+If you do not already have Docker installed on your system, you can get it by downloading and installing <a class="reference external" href="https://docs.docker.com/get-docker/">Docker Desktop</a>.
+If you do not have the necessary administrator permissions to install software on your machine,
+take a look at the section below on how to use <a class="reference internal" href="#singularity">Singularity</a> instead.</p>
+<p>Docker images for all CUDA-Q releases are available on the <a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum">NGC Container Registry</a>.
+In addition to publishing <a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">stable releases</a>,
+we also publish Docker images whenever we update certain branches on our <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a>.
+These images are published in our <a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum/tags">nightly channel on NGC</a>.
+To download the latest version on the main branch of our GitHub repository, for example, use the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">docker pull nvcr.io/nvidia/nightly/cuda-quantum:latest</span>
+</pre></div>
+</div>
+<p>Early prototypes for features we are considering can be tried out by using the image tags starting
+with <code class="code docutils literal notranslate"><span class="pre">experimental</span></code>. The <code class="code docutils literal notranslate"><span class="pre">README</span></code> in the <code class="code docutils literal notranslate"><span class="pre">/home/cudaq</span></code> folder in the container gives more details
+about the feature. We welcome and appreciate your feedback about these early prototypes;
+how popular they are will help inform whether we should include them in future releases.</p>
+<p>Once you have downloaded an image, the container can be run using the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">docker run -it --name cuda-quantum nvcr.io/nvidia/nightly/cuda-quantum:latest</span>
+</pre></div>
+</div>
+<p>Replace the image name and/or tag in the command above, if necessary, with the one you want to use.
+This will give you terminal access to the created container. To enable support
+for GPU-accelerated backends, you will need to pass the <code class="code docutils literal notranslate"><span class="pre">--gpus</span></code> flag when launching
+the container, for example:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">docker run -it --gpus all --name cuda-quantum nvcr.io/nvidia/nightly/cuda-quantum:latest</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This command will fail if you do not have a suitable NVIDIA GPU available, or if your driver
+version is insufficient. To improve compatibility with older drivers, you may need to install the
+<a class="reference external" href="https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html">NVIDIA container toolkit</a>.</p>
+</div>
+<p>You can stop and exit the container by typing the command <code class="code docutils literal notranslate"><span class="pre">exit</span></code>. If you did not specify
+<code class="code docutils literal notranslate"><span class="pre">--rm</span></code> flag when launching the container, the container still exists after exiting, as well as any
+changes you made in it. You can get back to it using
+the command <code class="code docutils literal notranslate"><span class="pre">docker</span> <span class="pre">start</span> <span class="pre">-i</span> <span class="pre">cuda-quantum</span></code>.
+You can delete an existing container and any changes you made using <code class="code docutils literal notranslate"><span class="pre">docker</span> <span class="pre">rm</span> <span class="pre">-v</span> <span class="pre">cuda-quantum</span></code>.</p>
+<p>When working with Docker images, the files inside the container are not visible outside the container environment.
+To facilitate application development with, for example, debugging, code completion, hover information, and so on,
+please take a look at the section on <a class="reference internal" href="#docker-in-vscode"><span class="std std-ref">Development with VS Code</span></a>.</p>
+<p>Alternatively, it is possible, but not recommended, to launch an SSH server inside the container environment and connect an IDE using SSH. To do so, make sure you have generated a suitable RSA key pair; if your <code class="code docutils literal notranslate"><span class="pre">~/.ssh/</span></code> folder does not already contain the files <code class="code docutils literal notranslate"><span class="pre">id_rsa.pub</span></code> and <code class="code docutils literal notranslate"><span class="pre">id.rsa</span></code>,
+follow the instructions for generating a new SSH key on <a class="reference external" href="https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent">this page</a>.
+You can then launch the container and connect to it via SSH by executing the following commands:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">docker run -itd --gpus all --name cuda-quantum -p 2222:22 nvcr.io/nvidia/nightly/cuda-quantum:latest</span>
+<span class="go">docker exec cuda-quantum bash -c &quot;sudo apt-get install -y --no-install-recommends openssh-server&quot;</span>
+<span class="go">docker exec cuda-quantum bash -c &quot;sudo sed -i -E &quot;s/#?\s*UsePAM\s+.+/UsePAM yes/g&quot; /etc/ssh/sshd_config&quot;</span>
+<span class="go">docker cp ~/.ssh/id_rsa.pub cuda-quantum:/home/cudaq/.ssh/authorized_keys</span>
+<span class="go">docker exec -d cuda-quantum bash -c &quot;sudo -E /usr/sbin/sshd -D&quot;</span>
+<span class="go">ssh cudaq@localhost -p 2222 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o GlobalKnownHostsFile=/dev/null</span>
+</pre></div>
+</div>
+</section>
+<section id="singularity">
+<span id="install-singularity-image"></span><h3>Singularity<a class="headerlink" href="#singularity" title="Permalink to this heading">¶</a></h3>
+<p>You can use <a class="reference external" href="https://github.com/sylabs/singularity">Singularity</a> to run a CUDA-Q container in a folder without needing administrator permissions.
+If you do not already have Singularity installed, you can build a relocatable installation from source.
+To do so on Linux or WSL, make sure you have the <a class="reference external" href="https://docs.sylabs.io/guides/4.0/user-guide/quick_start.html#prerequisites">necessary prerequisites</a> installed, download a suitable version of the <a class="reference external" href="https://docs.sylabs.io/guides/4.0/user-guide/quick_start.html#install-go">go toolchain</a>, and make sure the <code class="code docutils literal notranslate"><span class="pre">go</span></code> binaries are on your <code class="code docutils literal notranslate"><span class="pre">PATH</span></code>. You can then build Singularity with the commands</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">wget https://github.com/sylabs/singularity/releases/download/v4.0.1/singularity-ce-4.0.1.tar.gz</span>
+<span class="go">tar -xzf singularity-ce-4.0.1.tar.gz singularity-ce-4.0.1/ &amp;&amp; rm singularity-ce-4.0.1.tar.gz &amp;&amp; cd singularity-ce-4.0.1/</span>
+<span class="go">./mconfig --without-suid --prefix=&quot;$HOME/.local/singularity&quot;</span>
+<span class="go">make -C ./builddir &amp;&amp; make -C ./builddir install &amp;&amp; cd .. &amp;&amp; rm -rf singularity-ce-4.0.1/</span>
+<span class="go">echo &#39;PATH=&quot;$PATH:$HOME/.local/singularity/bin/&quot;&#39; &gt;&gt; ~/.profile &amp;&amp; source ~/.profile</span>
+</pre></div>
+</div>
+<p>For more information about using Singularity on other systems, take a look at the <a class="reference external" href="https://docs.sylabs.io/guides/4.0/admin-guide/installation.html#installation-on-windows-or-mac">admin guide</a>.</p>
+<p>Once you have singularity installed, create a file <code class="code docutils literal notranslate"><span class="pre">cuda-quantum.def</span></code> with the following content:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">Bootstrap: docker</span>
+<span class="go">From: nvcr.io/nvidia/nightly/cuda-quantum:latest</span>
+
+<span class="gp">%</span>runscript
+<span class="go">    mount devpts /dev/pts -t devpts</span>
+<span class="go">    cp -r /home/cudaq/* .</span>
+<span class="go">    bash</span>
+</pre></div>
+</div>
+<p>Replace the image name and/or tag in the <code class="code docutils literal notranslate"><span class="pre">From</span></code> line, if necessary, with the one you want to use;
+In addition to publishing <a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum/tags">stable releases</a>,
+we also publish Docker images whenever we update certain branches on our <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a>.
+These images are published in our <a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/nightly/containers/cuda-quantum/tags">nightly channel on NGC</a>.
+Early prototypes for features we are considering can be tried out by using the image tags starting
+with <code class="code docutils literal notranslate"><span class="pre">experimental</span></code>. We welcome and appreciate your feedback about these early prototypes;
+how popular they are will help inform whether we should include them in future releases.</p>
+<p>You can then create a CUDA-Q container by running the following commands:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">singularity build --fakeroot cuda-quantum.sif cuda-quantum.def</span>
+<span class="go">singularity run --writable --fakeroot cuda-quantum.sif</span>
+</pre></div>
+</div>
+<p>In addition to the files in your current folder, you should now
+see a <code class="code docutils literal notranslate"><span class="pre">README</span></code> file, as well as examples and tutorials.
+To enable support for GPU-accelerated backends, you will need to pass the
+the <code class="code docutils literal notranslate"><span class="pre">--nv</span></code> flag when running the container:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">singularity run --writable --fakeroot --nv cuda-quantum.sif</span>
+<span class="go">nvidia-smi</span>
+</pre></div>
+</div>
+<p>The output of the command above lists the GPUs that are visible and accessible in the container environment.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you do not see any GPUs listed in the output of <code class="code docutils literal notranslate"><span class="pre">nvidia-smi</span></code>,
+it means the container environment is unable to access a suitable NVIDIA GPU.
+This can happen if your driver version is insufficient, or if you are
+working on WSL. To improve compatibility with older drivers, or to enable GPU support
+on WSL, please install the <a class="reference external" href="https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html">NVIDIA container toolkit</a>, and update the singularity configuration
+to set <code class="code docutils literal notranslate"><span class="pre">use</span> <span class="pre">nvidia-container-cli</span></code> to <code class="code docutils literal notranslate"><span class="pre">yes</span></code> and configure the correct <code class="code docutils literal notranslate"><span class="pre">nvidia-container-cli</span> <span class="pre">path</span></code>.
+The two commands below use <code class="code docutils literal notranslate"><span class="pre">sed</span></code> to do that:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sed -i &#39;s/use nvidia-container-cli = no/use nvidia-container-cli = yes/&#39; &quot;$HOME/.local/singularity/etc/singularity/singularity.conf&quot;</span>
+<span class="go">sed -i &#39;s/# nvidia-container-cli path =/nvidia-container-cli path = \/usr\/bin\/nvidia-container-cli/&#39; &quot;$HOME/.local/singularity/etc/singularity/singularity.conf&quot;</span>
+</pre></div>
+</div>
+</div>
+<p>You can exit the container environment by typing the command <code class="code docutils literal notranslate"><span class="pre">exit</span></code>.
+Any changes you made will still be visible after you exit the container, and you can re-enable the
+container environment at any time using the <code class="code docutils literal notranslate"><span class="pre">run</span></code> command above.</p>
+<p>To facilitate application development with, for example, debugging, code completion, hover information, and so on,
+please take a look at the section on <a class="reference internal" href="#singularity-in-vscode"><span class="std std-ref">Development with VS Code</span></a>.</p>
+</section>
+<section id="python-wheels">
+<span id="install-python-wheels"></span><h3>Python wheels<a class="headerlink" href="#python-wheels" title="Permalink to this heading">¶</a></h3>
+<p>CUDA-Q Python wheels are available on <a class="reference external" href="https://pypi.org/project/cuda-quantum">PyPI.org</a>.
+Installation instructions can be found in the <a class="reference external" href="https://pypi.org/project/cuda-quantum/#description">project description</a>.
+For more information about available versions and documentation,
+see <a class="reference internal" href="../../releases.html"><span class="doc">CUDA-Q Releases</span></a>.</p>
+<p>There are currently no source distributions available on PyPI, but you can download the
+source code for the latest version of the CUDA-Q Python wheels from our
+<a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a>.
+The source code for previous versions can be downloaded from the respective
+<a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases">GitHub Release</a>.</p>
+<p>At this time, wheels are distributed for Linux operating systems only.
+If your platform is not <a class="reference internal" href="#dependencies-and-compatibility"><span class="std std-ref">officially supported</span></a> and
+<code class="code docutils literal notranslate"><span class="pre">pip</span></code> does not find a compatible wheel to install, you can build your own
+wheel from source following the instructions here: <a class="reference internal" href="data_center_install.html"><span class="doc">Installation from Source</span></a>.</p>
+<p>To build the CUDA-Q Python API for the purpose of contributing to
+our <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a>,
+follow the instructions for
+<a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/blob/main/Dev_Setup.md">Setting up your Environment</a>,
+and then run the following commands in the repository root:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">bash scripts/install_prerequisites.sh</span>
+<span class="go">pip install . --user</span>
+</pre></div>
+</div>
+</section>
+<section id="pre-built-binaries">
+<span id="install-prebuilt-binaries"></span><h3>Pre-built binaries<a class="headerlink" href="#pre-built-binaries" title="Permalink to this heading">¶</a></h3>
+<p>Starting with the 0.6.0 release, we provide pre-built binaries for using
+CUDA-Q with C++. Support for using CUDA-Q with Python can be installed
+side-by-side with the pre-built binaries for C++ by following the instructions on
+<a class="reference external" href="https://pypi.org/project/cuda-quantum">PyPI.org</a>.
+The pre-built binaries work across a range of Linux operating systems listed
+under <a class="reference internal" href="#dependencies-and-compatibility"><span class="std std-ref">Dependencies and Compatibility</span></a>.</p>
+<p>Before installing our pre-built binaries, please make sure that your
+operating system is using the <a class="reference external" href="https://www.gnu.org/software/libc/">GNU C library</a>
+version 2.28 or newer. You can confirm this by checking the output of the command
+<code class="code docutils literal notranslate"><span class="pre">ldd</span> <span class="pre">--version</span></code>. If this command does not exist, or shows an older version than 2.28,
+please double check that your operating system is listed as
+<a class="reference internal" href="#dependencies-and-compatibility"><span class="std std-ref">supported</span></a>. If you use an operating system
+with an older GNU C library version, you will need to build the installer from
+source following the instructions in <a class="reference internal" href="data_center_install.html"><span class="doc">Installation from Source</span></a>.</p>
+<p>You can download the <code class="code docutils literal notranslate"><span class="pre">install_cuda_quantum</span></code> file for your processor architecture from
+the assets of the respective <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases">GitHub release</a>.
+The installer is a <a class="reference external" href="https://makeself.io/">self-extracting archive</a> that contains the
+pre-built binaries as well as a script to move them to the correct locations. You will need
+<code class="code docutils literal notranslate"><span class="pre">bash</span></code>, <code class="code docutils literal notranslate"><span class="pre">tar</span></code>, and <code class="code docutils literal notranslate"><span class="pre">gzip</span></code> (usually already installed on most Linux distributions) to run
+the installer.
+The installation location of CUDA-Q is not currently configurable and using the installer
+hence requires admin privileges on the system. We may revise that in the future; please see and
+upvote the corresponding <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/issues/1075">GitHub issue</a>.</p>
+<p>To install CUDA-Q, execute the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">MPI_PATH</span><span class="o">=</span>/usr/local/openmpi<span class="w"> </span><span class="se">\</span>
+sudo<span class="w"> </span>-E<span class="w"> </span>bash<span class="w"> </span>install_cuda_quantum.<span class="k">$(</span>uname<span class="w"> </span>-m<span class="k">)</span><span class="w"> </span>--accept<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span>.<span class="w"> </span>/etc/profile
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>To use GPU-accelerated backends, you will need to install the necessary CUDA runtime libraries.
+For more information see the corresponding section on
+<a class="reference internal" href="#cuda-dependencies-prebuilt-binaries"><span class="std std-ref">Additional CUDA Tools</span></a>.</p>
+</div>
+<p>The installation ensures that the necessary environment variables for
+using the CUDA-Q toolchain are set upon login for all POSIX shells.
+Confirm that the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> command is found. If it is not, please make sure
+to set the environment variables defined by the <code class="code docutils literal notranslate"><span class="pre">set_env.sh</span></code> script in the
+CUDA-Q installation folder (usually <code class="code docutils literal notranslate"><span class="pre">/usr/local/cudaq</span></code> or <code class="code docutils literal notranslate"><span class="pre">/opt/nvidia/cudaq</span></code>).</p>
+<p>If an MPI installation is available in the directory defined by <code class="code docutils literal notranslate"><span class="pre">MPI_PATH</span></code>,
+the installer automatically enables MPI support in CUDA-Q.
+If you do not have MPI installed on your system, you can simply
+leave that path empty, and CUDA-Q will be installed without MPI support.
+If you install MPI at a later point in time, you can activate the MPI support in CUDA
+Quantum by setting the <code class="code docutils literal notranslate"><span class="pre">MPI_PATH</span></code> variable to its installation location and
+executing the commands</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">MPI_PATH=/usr/local/openmpi # update this path as needed</span>
+<span class="go">bash &quot;${CUDA_QUANTUM_PATH}/distributed_interfaces/activate_custom_mpi.sh&quot;</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Please make sure that you have the necessary development headers of the C standard
+library installed. You can check this by searching for <code class="code docutils literal notranslate"><span class="pre">features.h</span></code>, commonly found
+in <code class="code docutils literal notranslate"><span class="pre">/usr/include/</span></code>. You can install the necessary headers via package manager
+(usually the package name is called something like <code class="code docutils literal notranslate"><span class="pre">glibc-devel</span></code> or <code class="code docutils literal notranslate"><span class="pre">libc6-dev</span></code>).
+These headers are also included with any installation of GCC.</p>
+</div>
+</section>
+</section>
+<section id="development-with-vs-code">
+<span id="local-development-with-vscode"></span><h2>Development with VS Code<a class="headerlink" href="#development-with-vs-code" title="Permalink to this heading">¶</a></h2>
+<p>To facilitate application development with, for example, debugging, code completion, hover information, and so on,
+we recommend using <a class="reference external" href="https://code.visualstudio.com/">VS Code</a>. VS Code provides a seamless
+development experience on all platforms, and is also available without installation via web browser.
+This sections describes how to connect VS Code to a running container on your machine.
+The section on <a class="reference internal" href="#connect-to-remote"><span class="std std-ref">connecting to a remote host</span></a> contains information on
+how to set up your development environment when accessing CUDA-Q on a remote host instead.</p>
+<section id="using-a-docker-container">
+<span id="docker-in-vscode"></span><h3>Using a Docker container<a class="headerlink" href="#using-a-docker-container" title="Permalink to this heading">¶</a></h3>
+<p>Before connecting VS Code, open a terminal/shell,
+and start the CUDA-Q Docker container following the
+instructions in the <a class="reference internal" href="#install-docker-image"><span class="std std-ref">section above</span></a>.</p>
+<p>If you have a local installation of <a class="reference external" href="https://code.visualstudio.com/">VS Code</a>
+you can connect to the running container using the
+<a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers">Dev Containers</a> extension. If you want to use VS Code in the web browser, please follow the instructions
+in the section <a class="reference internal" href="#developing-with-remote-tunnels">Developing with Remote Tunnels</a> instead.</p>
+<p>After installing the
+<a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers">Dev Containers</a> extension, launch VS Code, open the Command Palette with <code class="code docutils literal notranslate"><span class="pre">Ctrl+Shift+P</span></code>, and enter
+”Dev Containers: Attach to Running Container”.
+You should see and select the running <code class="code docutils literal notranslate"><span class="pre">cuda-quantum</span></code> container in the list.
+After the window reloaded, enter “File: Open Folder” in the Command Palette to open the <code class="code docutils literal notranslate"><span class="pre">/home/cudaq/</span></code> folder.</p>
+<p>To run the examples, open the Command Palette and enter “View: Show Terminal”
+to launch an integrated terminal. You are now all set to
+<a class="reference internal" href="#post-installation"><span class="std std-ref">get started</span></a> with CUDA-Q development.</p>
+</section>
+<section id="using-a-singularity-container">
+<span id="singularity-in-vscode"></span><h3>Using a Singularity container<a class="headerlink" href="#using-a-singularity-container" title="Permalink to this heading">¶</a></h3>
+<p>If you have a GitHub or Microsoft account, we recommend that you connect
+to a CUDA-Q container using tunnels. To do so, launch a CUDA-Q Singularity
+container following the instructions in the <a class="reference internal" href="#install-singularity-image"><span class="std std-ref">section above</span></a>,
+and then follow the instructions in the section <a class="reference internal" href="#developing-with-remote-tunnels">Developing with Remote Tunnels</a>.</p>
+<p>If you cannot use tunnels, you need a local installation of
+<a class="reference external" href="https://code.visualstudio.com/">VS Code</a> and you need to install
+the <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh">Remote - SSH</a> extension.
+Make sure you also have a suitable SSH key pair; if your <code class="code docutils literal notranslate"><span class="pre">~/.ssh/</span></code> folder does not already contain
+the files <code class="code docutils literal notranslate"><span class="pre">id_rsa.pub</span></code> and <code class="code docutils literal notranslate"><span class="pre">id.rsa</span></code>, follow the instructions for generating a new SSH key on
+<a class="reference external" href="https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent">this page</a>.</p>
+<p>To connect VS Code to a running CUDA-Q container,
+the most convenient setup is to install and run an SSH server
+in the Singularity container. Open a terminal/shell in a separate window,
+and enter the following commands to create a suitable sandbox:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">singularity build --sandbox cuda-quantum-sandbox cuda-quantum.sif</span>
+<span class="go">singularity exec --writable --fakeroot cuda-quantum-sandbox \</span>
+<span class="go">  apt-get install -y --no-install-recommends openssh-server</span>
+<span class="go">cat ~/.ssh/id_rsa.pub &gt;&gt; ~/.ssh/authorized_keys</span>
+</pre></div>
+</div>
+<p>You can launch this sandbox by entering the commands below. Please see the <a class="reference internal" href="#singularity">Singularity</a> section above
+for more information about how to get the <code class="code docutils literal notranslate"><span class="pre">cuda-quantum.sif</span></code> image, and how to enable GPU-acceleration
+with the <code class="code docutils literal notranslate"><span class="pre">--nv</span></code> flag.</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">singularity run --writable --fakeroot --nv --network-args=&quot;portmap=22:2222/tcp&quot; cuda-quantum-sandbox</span>
+<span class="go">/usr/sbin/sshd -D -p 2222 -E sshd_output.txt</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Make sure to use a free port. You can check if the SSH server is ready and listening
+by looking at the log in <code class="code docutils literal notranslate"><span class="pre">sshd_output.txt</span></code>. If the port is already in use, you can
+replace the number <code class="code docutils literal notranslate"><span class="pre">2222</span></code> by any free TCP port in the range <code class="code docutils literal notranslate"><span class="pre">1025-65535</span></code> in all
+commands.</p>
+</div>
+<p>Entering <code class="code docutils literal notranslate"><span class="pre">Ctrl+C</span></code> followed by <code class="code docutils literal notranslate"><span class="pre">exit</span></code> will stop the running container. You can re-start
+it at any time by entering the two commands above. While the container is running,
+open the Command Palette in VS Code with <code class="code docutils literal notranslate"><span class="pre">Ctrl+Shift+P</span></code>, enter “Remote-SSH: Add new
+SSH Host”, and enter the following SSH command:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ssh root@localhost -p 2222 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o GlobalKnownHostsFile=/dev/null</span>
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you are working on Windows and are building and running the Singularity container in WSL,
+make sure to copy the used SSH keys to the Windows partition, such that VS Code can connect with
+the expected key. Alternatively, add the used public key to the <code class="code docutils literal notranslate"><span class="pre">/root/.ssh/authorized_keys</span></code> file in
+the Singularity container.</p>
+</div>
+<p>You can then connect to the host by opening the Command Palette, entering
+“Remote SSH: Connect Current Window to Host”, and choosing the newly created host.
+After the window reloaded, enter “File: Open Folder” in the
+Command Palette to open the desired folder.</p>
+<p>To run the examples, open the Command Palette and enter “View: Show Terminal”
+to launch an integrated terminal. You are now all set to
+<a class="reference internal" href="#post-installation"><span class="std std-ref">get started</span></a> with CUDA-Q development.</p>
+</section>
+</section>
+<section id="connecting-to-a-remote-host">
+<span id="connect-to-remote"></span><h2>Connecting to a Remote Host<a class="headerlink" href="#connecting-to-a-remote-host" title="Permalink to this heading">¶</a></h2>
+<p>Depending on the setup on the remote host, there are a couple of different options
+for developing CUDA-Q applications.</p>
+<ul class="simple">
+<li><p>If a CUDA-Q container is running on the remote host,
+and you have a GitHub or Microsoft account, take a look at
+<a class="reference internal" href="#developing-with-remote-tunnels">Developing with Remote Tunnels</a>. This works for both Docker
+and Singularity containers on the remote host, and should also
+work for other containers.</p></li>
+<li><p>If you cannot use tunnels, or if you want to work with an
+existing CUDA-Q installation without using a container,
+take a look at <a class="reference internal" href="#remote-access-via-ssh">Remote Access via SSH</a> instead.</p></li>
+</ul>
+<section id="developing-with-remote-tunnels">
+<span id="connect-vscode-via-tunnel"></span><h3>Developing with Remote Tunnels<a class="headerlink" href="#developing-with-remote-tunnels" title="Permalink to this heading">¶</a></h3>
+<p><a class="reference external" href="https://code.visualstudio.com/blogs/2022/12/07/remote-even-better">Remote access via tunnel</a>
+can easily be enabled with the <a class="reference external" href="https://code.visualstudio.com/docs/editor/command-line">VS Code CLI</a>.
+This allows to connect either a local installation of <a class="reference external" href="https://code.visualstudio.com/">VS Code</a>,
+or the <a class="reference external" href="https://vscode.dev/">VS Code Web UI</a>, to a running CUDA-Q container on the same or a different machine.</p>
+<p>Creating a secure connection requires authenticating with the same GitHub or Microsoft account on each end.
+Once authenticated, an SSH connection over the tunnel provides end-to-end encryption. To download the VS Code CLI, if necessary, and create a tunnel, execute the
+following command in the running CUDA-Q container,
+and follow the instructions to authenticate:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">vscode-setup tunnel --name cuda-quantum-remote --accept-server-license-terms</span>
+</pre></div>
+</div>
+<p>You can then either <a class="reference external" href="https://vscode.dev/tunnel/cuda-quantum-remote/home/cudaq/">open VS Code in a web browser</a>, or connect a local installation of VS Code.
+To connect a local installation of VS Code, make sure you have the
+<a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server">Remote - Tunnels</a> extension installed,
+then open the Command Palette with <code class="code docutils literal notranslate"><span class="pre">Ctrl+Shift+P</span></code>, enter “Remote Tunnels: Connect to Tunnel”,
+and enter <code class="code docutils literal notranslate"><span class="pre">cuda-quantum-remote</span></code>. After the window reloaded, enter “File: Open Folder” in the Command Palette
+to open the <code class="code docutils literal notranslate"><span class="pre">/home/cudaq/</span></code> folder.</p>
+<p>You should see a pop up asking if you want to install the recommended extensions. Selecting to install them will
+configure VS Code with extensions for working with C++, Python, and Jupyter.
+You can always see the list of recommended extensions that aren’t installed yet by clicking on the “Extensions” icon in the sidebar and navigating to the “Recommended” tab.</p>
+</section>
+<section id="remote-access-via-ssh">
+<h3>Remote Access via SSH<a class="headerlink" href="#remote-access-via-ssh" title="Permalink to this heading">¶</a></h3>
+<p>To facilitate application development with, for example, debugging, code completion, hover information, and so on,
+you can connect a local installation of <a class="reference external" href="https://code.visualstudio.com/">VS Code</a> to a remote host via SSH.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>For the best user experience, we recommend to launch a CUDA-Q container on the remote host,
+and then connect <a class="reference internal" href="#connect-vscode-via-tunnel"><span class="std std-ref">VS Code using tunnels</span></a>.
+If a connection via tunnel is not possible, this section describes using SSH instead.</p>
+</div>
+<p>To do so, make sure you have <a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh">Remote - SSH</a> extension installed.
+Open the Command Palette with <code class="code docutils literal notranslate"><span class="pre">Ctrl+Shift+P</span></code>, enter “Remote-SSH: Add new
+SSH Host”, and enter the SSH command to connect to your account on the remote host.
+You can then connect to the host by opening the Command Palette, entering
+“Remote SSH: Connect Current Window to Host”, and choosing the newly created host.</p>
+<p>When prompted, choose Linux as the operating system, and enter your
+password. After the window reloaded, enter “File: Open Folder” in the
+Command Palette to open the desired folder. Our GitHub repository contains
+a folder with VS Code configurations including a list of recommended extensions for
+working with CUDA-Q; you can copy <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/tree/main/docker/release/config/.vscode">these configurations</a> into the a folder named <code class="code docutils literal notranslate"><span class="pre">.vscode</span></code> in your workspace to use them.</p>
+<p>If you want to work with an existing CUDA-Q installation on the remote host, you are all set.
+Alternatively, you can use Singularity to build and run a container following the instructions in
+<a class="reference internal" href="#install-singularity-image"><span class="std std-ref">this section</span></a>. Once the <code class="code docutils literal notranslate"><span class="pre">cuda-quantum.sif</span></code> image is built and
+available in your home directory on the remote host, you can update your VS Code configuration
+to enable/improve completion, hover information, and other development tools within the container.</p>
+<p>To do so, open the Command Palette and enter “Remote-SSH: Open SSH Configuration File”.
+Add a new entry to that file with the command to launch the container, and edit the configuration
+of the remote host, titled <code class="code docutils literal notranslate"><span class="pre">remote-host</span></code> in the snippets below, to add a new identifier:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">Host cuda-quantum~*</span>
+<span class="go">  RemoteCommand singularity run --writable --fakeroot --nv ~/cuda-quantum.sif</span>
+<span class="go">  RequestTTY yes</span>
+
+<span class="go">Host remote-host cuda-quantum~remote-host</span>
+<span class="go">  HostName ...</span>
+<span class="go">  ...</span>
+</pre></div>
+</div>
+<p>You will need to edit a couple of VS Code setting to make use of the newly defined remote command;
+open the Command Palette, enter “Preferences: Open User Settings (JSON)”, and add or update the
+following configurations:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">&quot;remote.SSH.enableRemoteCommand&quot;: true,</span>
+<span class="go">&quot;remote.SSH.useLocalServer&quot;: true,</span>
+<span class="go">&quot;remote.SSH.remoteServerListenOnSocket&quot;: false,</span>
+<span class="go">&quot;remote.SSH.connectTimeout&quot;: 120,</span>
+<span class="go">&quot;remote.SSH.serverInstallPath&quot;: {</span>
+<span class="go">    &quot;cuda-quantum~remote-host&quot;: &quot;~/.vscode-container/cuda-quantum&quot;,</span>
+<span class="go">},</span>
+</pre></div>
+</div>
+<p>After saving the changes, you should now be able to select <code class="code docutils literal notranslate"><span class="pre">cuda-quantum~remote-host</span></code> as the host
+when connecting via SSH, which will launch the CUDA-Q container and connect VS Code to it.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If the connection to <code class="code docutils literal notranslate"><span class="pre">cuda-quantum~remote-host</span></code> fails, you may need to specify the full
+path to the <code class="code docutils literal notranslate"><span class="pre">singularity</span></code> executable on the remote host, since environment variables,
+and specifically the configured <code class="code docutils literal notranslate"><span class="pre">PATH</span></code> may be different during launch than in your user account.</p>
+</div>
+</section>
+</section>
+<section id="dgx-cloud">
+<h2>DGX Cloud<a class="headerlink" href="#dgx-cloud" title="Permalink to this heading">¶</a></h2>
+<p>If you are using <a class="reference external" href="https://www.nvidia.com/en-us/data-center/dgx-cloud/">DGX Cloud</a>,
+you can easily use it to run CUDA-Q applications.
+While submitting jobs to DGX Cloud directly from within CUDA-Q is not (yet) supported,
+you can use the NGC CLI to launch and interact with workloads in DGX Cloud.
+The following sections detail how to do that, and how to connect JupyterLab and/or VS Code
+to a running CUDA-Q job in DGX Cloud.</p>
+<section id="get-started">
+<span id="dgx-cloud-setup"></span><h3>Get Started<a class="headerlink" href="#get-started" title="Permalink to this heading">¶</a></h3>
+<p>To get started with DGX Cloud, you can
+<a class="reference external" href="https://www.nvidia.com/en-us/data-center/dgx-cloud/trial/">request access here</a>.
+Once you have access, <a class="reference external" href="https://ngc.nvidia.com/signin">sign in</a> to your account,
+and <a class="reference external" href="https://ngc.nvidia.com/setup/api-key">generate an API key</a>.
+<a class="reference external" href="https://ngc.nvidia.com/setup/installers/cli">Install the NGC CLI</a>
+and configure it with</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc config set</span>
+</pre></div>
+</div>
+<p>entering the API key you just generated when prompted, and configure other settings as appropriate.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>The rest of this section assumes you have CLI version 3.33.0. If you
+have an older version installed, you can upgrade to the latest version using the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc version upgrade 3.33.0</span>
+</pre></div>
+</div>
+<p>See also the <a class="reference external" href="https://docs.ngc.nvidia.com/cli/index.html">NGC CLI documentation</a>
+for more information about available commands.</p>
+</div>
+<p>You can see all information about available compute resources and ace instances
+with the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc base-command ace list</span>
+</pre></div>
+</div>
+<p>Confirm that you can submit a job with the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc base-command job run \</span>
+<span class="go">  --name Job-001 --total-runtime 60s \</span>
+<span class="go">  --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \</span>
+<span class="go">  --ace &lt;ace_name&gt; --instance &lt;instance_name&gt; \</span>
+<span class="go">  --commandline &#39;echo &quot;Hello from DGX Cloud!&quot;&#39;</span>
+</pre></div>
+</div>
+<p>replacing <code class="code docutils literal notranslate"><span class="pre">&lt;ace_name&gt;</span></code> and <code class="code docutils literal notranslate"><span class="pre">&lt;instance_name&gt;</span></code> with the name of the ace and instance you want
+to execute the job on.
+You should now see that job listed when you run the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc base-command job list</span>
+</pre></div>
+</div>
+<p>Once it has completed you can download the job results using the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc base-command result download &lt;job_id&gt;</span>
+</pre></div>
+</div>
+<p>replacing <code class="code docutils literal notranslate"><span class="pre">&lt;job_id&gt;</span></code> with the id of the job you just submitted.
+You should see a new folder named <code class="code docutils literal notranslate"><span class="pre">&lt;job_id&gt;</span></code> with the job log that contains
+the output “Hello from DGX Cloud!”.</p>
+<p>For more information about how to use the NGC CLI to interact with DGX Cloud,
+we refer to the <a class="reference external" href="https://docs.ngc.nvidia.com/cli/index.html">NGC CLI documentation</a>.</p>
+</section>
+<section id="use-jupyterlab">
+<h3>Use JupyterLab<a class="headerlink" href="#use-jupyterlab" title="Permalink to this heading">¶</a></h3>
+<p>Once you can <a class="reference internal" href="#dgx-cloud-setup"><span class="std std-ref">run jobs on DGX Cloud</span></a>, you can launch an interactive job
+to use CUDA-Q with <a class="reference external" href="https://jupyterlab.readthedocs.io/en/latest/">JupyterLab</a>
+running on DGX Cloud:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc base-command job run \</span>
+<span class="go">  --name Job-interactive-001 --total-runtime 600s \</span>
+<span class="go">  --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \</span>
+<span class="go">  --ace &lt;ace_name&gt; --instance &lt;instance_name&gt; \</span>
+<span class="go">  --port 8888 --commandline &#39;jupyter-lab-setup &lt;my-custom-token&gt; --port=8888&#39;</span>
+</pre></div>
+</div>
+<p>Replace <code class="code docutils literal notranslate"><span class="pre">&lt;my-custom-token&gt;</span></code> in the command above with a custom token that you can freely choose.
+You will use this token to authenticate with JupyterLab;
+Go to the <a class="reference external" href="https://bc.ngc.nvidia.com/jobs">job portal</a>, click on the job you just launched, and click on the link
+under ”URL/Hostname” in Service Mapped Ports.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>It may take a couple of minutes for DGX Cloud to launch and for the URL to become active, even after it appears in the Service Mapped Ports section;
+if you encounter a “404: Not Found” error, be patient and try again in a couple of minutes.</p>
+</div>
+<p>Once this URL opens, you should see the JupyterLab authentication page; enter the
+token you selected above to get access to the running CUDA-Q container.
+On the left you should see a folder with tutorials. Happy coding!</p>
+</section>
+<section id="use-vs-code">
+<h3>Use VS Code<a class="headerlink" href="#use-vs-code" title="Permalink to this heading">¶</a></h3>
+<p>Once you can <a class="reference internal" href="#dgx-cloud-setup"><span class="std std-ref">run jobs on DGX Cloud</span></a>, you can launch an interactive job
+to use CUDA-Q with a local installation of <a class="reference external" href="https://code.visualstudio.com/">VS Code</a>,
+or the <a class="reference external" href="https://vscode.dev/">VS Code Web UI</a>, running on DGX Cloud:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">ngc base-command job run \</span>
+<span class="go">  --name Job-interactive-001 --total-runtime 600s \</span>
+<span class="go">  --image nvcr.io/nvidia/nightly/cuda-quantum:latest --result /results \</span>
+<span class="go">  --ace &lt;ace_name&gt; --instance &lt;instance_name&gt; \</span>
+<span class="go">  --commandline &#39;vscode-setup tunnel --name cuda-quantum-dgx --accept-server-license-terms&#39;</span>
+</pre></div>
+</div>
+<p>Go to the <a class="reference external" href="https://bc.ngc.nvidia.com/jobs">job portal</a>, click on the job you just launched, and select the “Log”
+tab. Once the job is running, you should see instructions there for how to connect to the device the job is running on.
+These instructions include a link to open and the code to enter on that page; follow the instructions to authenticate.
+Once you have authenticated, you can either
+<a class="reference external" href="https://vscode.dev/tunnel/cuda-quantum-dgx/home/cudaq/">open VS Code in a web browser</a>,
+or connect a local installation of VS Code.
+To connect a local installation of VS Code, make sure you have the
+<a class="reference external" href="https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server">Remote - Tunnels</a> extension installed,
+then open the Command Palette with <code class="code docutils literal notranslate"><span class="pre">Ctrl+Shift+P</span></code>, enter “Remote Tunnels: Connect to Tunnel”,
+and enter <code class="code docutils literal notranslate"><span class="pre">cuda-quantum-remote</span></code>. After the window reloaded, enter “File: Open Folder” in the Command Palette
+to open the <code class="code docutils literal notranslate"><span class="pre">/home/cudaq/</span></code> folder.</p>
+<p>You should see a pop up asking if you want to install the recommended extensions. Selecting to install them will
+configure VS Code with extensions for working with C++, Python, and Jupyter.
+You can always see the list of recommended extensions that aren’t installed yet by clicking on the “Extensions” icon in the sidebar and navigating to the “Recommended” tab.</p>
+<p>If you enter “View: Show Explorer” in the Command Palette, you should see a folder with tutorials and examples
+to help you get started. Take a look at <a class="reference internal" href="#next-steps">Next Steps</a> to dive into CUDA-Q development.</p>
+</section>
+</section>
+<section id="additional-cuda-tools">
+<span id="id7"></span><h2>Additional CUDA Tools<a class="headerlink" href="#additional-cuda-tools" title="Permalink to this heading">¶</a></h2>
+<p>CUDA-Q makes use of GPU-acceleration in certain backends and components.
+Depending on how you installed CUDA-Q, you may need to install
+certain CUDA libraries separately to take advantage of these.</p>
+<section id="installation-via-pypi">
+<h3>Installation via PyPI<a class="headerlink" href="#installation-via-pypi" title="Permalink to this heading">¶</a></h3>
+<p>If you installed CUDA-Q via <a class="reference external" href="https://pypi.org/project/cuda-quantum">PyPI</a>, please follow the installation instructions there to install the necessary CUDA dependencies.</p>
+</section>
+<section id="installation-in-container-images">
+<h3>Installation In Container Images<a class="headerlink" href="#installation-in-container-images" title="Permalink to this heading">¶</a></h3>
+<p>If you are using the CUDA-Q container image, the image already contains all necessary runtime libraries to use all CUDA-Q components. To take advantage of GPU-acceleration, make sure
+to enable GPU support when you launch the container, that is pass the <code class="code docutils literal notranslate"><span class="pre">--gpus</span> <span class="pre">all</span></code> flag when launching
+the container with Docker and the <code class="code docutils literal notranslate"><span class="pre">--nv</span></code> flag when launching the container with Singularity.</p>
+<p>Note that the image does not contain all development dependencies for CUDA, such as, for example the <code class="code docutils literal notranslate"><span class="pre">nvcc</span></code> compiler. You can install all CUDA development dependencies by running the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sudo apt-get install cuda-toolkit-11.8</span>
+</pre></div>
+</div>
+<p>inside the container. Most Python packages that use GPU-acceleration, such as for example <a class="reference external" href="https://cupy.dev">CuPy</a>, require an existing CUDA installation. After installing the <code class="code docutils literal notranslate"><span class="pre">cuda-toolkit-11.8</span></code> you can install CuPy with the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python3 -m pip install cupy-cuda11x</span>
+</pre></div>
+</div>
+</section>
+<section id="installing-pre-built-binaries">
+<span id="cuda-dependencies-prebuilt-binaries"></span><h3>Installing Pre-built Binaries<a class="headerlink" href="#installing-pre-built-binaries" title="Permalink to this heading">¶</a></h3>
+<p>If you installed pre-built binaries for CUDA-Q, you will need to install
+the necessary CUDA 11 runtime libraries to use GPU-acceleration in CUDA-Q.
+If you prefer to only install the minimal set of runtime libraries, the following
+commands, for example, install the necessary packages for RHEL 8:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nv">CUDA_VERSION</span><span class="o">=</span><span class="m">11</span>.8
+<span class="nv">CUDA_DOWNLOAD_URL</span><span class="o">=</span>https://developer.download.nvidia.com/compute/cuda/repos
+<span class="c1"># Go to the url above, set the variables below to a suitable distribution</span>
+<span class="c1"># and subfolder for your platform, and uncomment the line below.</span>
+<span class="c1"># DISTRIBUTION=rhel8 CUDA_ARCH_FOLDER=x86_64</span>
+
+<span class="nv">version_suffix</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="si">${</span><span class="nv">CUDA_VERSION</span><span class="si">}</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>tr<span class="w"> </span>.<span class="w"> </span>-<span class="k">)</span>
+dnf<span class="w"> </span>config-manager<span class="w"> </span>--add-repo<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDA_DOWNLOAD_URL</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">DISTRIBUTION</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">CUDA_ARCH_FOLDER</span><span class="si">}</span><span class="s2">/cuda-</span><span class="si">${</span><span class="nv">DISTRIBUTION</span><span class="si">}</span><span class="s2">.repo&quot;</span>
+dnf<span class="w"> </span>install<span class="w"> </span>-y<span class="w"> </span>--nobest<span class="w"> </span>--setopt<span class="o">=</span><span class="nv">install_weak_deps</span><span class="o">=</span>False<span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>cuda-nvtx-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span><span class="w"> </span>cuda-cudart-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span><span class="w"> </span><span class="se">\</span>
+<span class="w">    </span>libcusolver-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span><span class="w"> </span>libcublas-<span class="si">${</span><span class="nv">version_suffix</span><span class="si">}</span>
+</pre></div>
+</div>
+<p>More detailed instructions for your platform can be found in the online documentation
+linked for that <a class="reference external" href="https://developer.nvidia.com/cuda-toolkit-archive">CUDA version</a>.
+Please make sure to install CUDA version 11.8, and confirm that your
+<a class="reference external" href="https://www.nvidia.com/download/index.aspx">GPU driver</a> supports that version.
+While the above packages are sufficient to use GPU-acceleration within CUDA-Q,
+we recommend installing the complete CUDA toolkit (<code class="code docutils literal notranslate"><span class="pre">cuda-toolkit-11-8</span></code>) that also
+includes the <code class="code docutils literal notranslate"><span class="pre">nvcc</span></code> compiler.</p>
+</section>
+</section>
+<section id="distributed-computing-with-mpi">
+<span id="id8"></span><h2>Distributed Computing with MPI<a class="headerlink" href="#distributed-computing-with-mpi" title="Permalink to this heading">¶</a></h2>
+<p>CUDA-Q supports the Message Passing Interface (MPI) parallelism via a plugin interface.
+It is possible to activate or replace such an MPI plugin without re-installing or re-compiling CUDA-Q.
+MPI calls via CUDA-Q API for C++ and Python will be delegated to the currently activated plugin at runtime.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Built-in MPI Support</label><div class="tab-content docutils">
+<p>The <a class="reference internal" href="#install-docker-image"><span class="std std-ref">CUDA-Q Docker image</span></a> is shipped with a pre-built MPI plugin based on an
+optimized OpenMPI installation included in the image. No action is required to use this plugin.
+We recommend using this plugin unless the container host has an existing MPI implementation other than OpenMPI.</p>
+<p>If you are not using the Docker image, or are using the image on a system that has a
+vendor-optimized MPI library pre-installed, please follow the instructions in the “Custom MPI Support” tab
+to enable MPI support.</p>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">Custom MPI Support</label><div class="tab-content docutils">
+<p>If you are not using the Docker image, or are using the image on a system that has a
+vendor-optimized MPI library pre-installed, CUDA-Q can be configured to use the local MPI installation by
+manually activating a suitable plugin post-installation.
+To do so,</p>
+<ul>
+<li><p>Make sure the environment variable <code class="code docutils literal notranslate"><span class="pre">CUDA_QUANTUM_PATH</span></code> points to the CUDA-Q installation directory.
+If you installed CUDA-Q using the <code class="code docutils literal notranslate"><span class="pre">installer</span> <span class="pre">&lt;install-prebuilt-binaries&gt;</span></code>, or if you are using the CUDA-Q
+container image, this variable should already be defined. If you installed the CUDA-Q
+<code class="code docutils literal notranslate"><span class="pre">Python</span> <span class="pre">wheels</span> <span class="pre">&lt;install-python-wheels&gt;</span></code>, set this variable to the directory listed under “Location” when you run the
+command <code class="code docutils literal notranslate"><span class="pre">pip</span> <span class="pre">show</span> <span class="pre">cuda-quantum</span></code>.</p></li>
+<li><p>Set the environment variable <code class="code docutils literal notranslate"><span class="pre">MPI_PATH</span></code> to the location of your MPI installation. In particular, <code class="code docutils literal notranslate"><span class="pre">${MPI_PATH}/include</span></code>
+is expected to contain the <code class="code docutils literal notranslate"><span class="pre">mpi.h</span></code> header and <code class="code docutils literal notranslate"><span class="pre">${MPI_PATH}/lib64</span></code> or <code class="code docutils literal notranslate"><span class="pre">${MPI_PATH}/lib</span></code> is expected to contain <code class="code docutils literal notranslate"><span class="pre">libmpi.so</span></code>.</p></li>
+<li><p>Execute the following command to complete the activation:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">bash $CUDA_QUANTUM_PATH/distributed_interfaces/activate_custom_mpi.sh</span>
+</pre></div>
+</div>
+</li>
+</ul>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>HPC data centers often have a vendor-optimized MPI library pre-installed on their system.
+If you are using our container images, installing that MPI implementation in the container
+and manually activating the plugin following the steps above ensure the best performance,
+and guarantee compatibility when MPI injection into a container occurs.</p>
+</div>
+<p>Manually activating an MPI plugin replaces any existing plugin; After the initial activation, the newly built
+<code class="code docutils literal notranslate"><span class="pre">libcudaq_distributed_interface_mpi.so</span></code> in the installation directory will subsequently always be used to
+handle CUDA-Q MPI calls.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Executing the activation script from the CUDA-Q installation directory requires <em>write</em> permissions to that directory.
+If you do not have the necessary permissions, copy the <code class="code docutils literal notranslate"><span class="pre">distributed_interfaces</span></code> sub-directory to a local location and execute the
+activation script from there.</p>
+<p>In this scenario, since the activated plugin (<code class="code docutils literal notranslate"><span class="pre">libcudaq_distributed_interface_mpi.so</span></code>) is outside the CUDA-Q installation,
+you must set the environment variable <code class="code docutils literal notranslate"><span class="pre">$CUDAQ_MPI_COMM_LIB</span></code> to the path of that shared library.
+This is done automatically when executing that activation script, but you may wish to persist that environment variable
+between bash sessions, e.g., by adding it to the <code class="code docutils literal notranslate"><span class="pre">.bashrc</span></code> file.</p>
+</div>
+</div>
+</div>
+</section>
+<section id="updating-cuda-q">
+<span id="updating-cuda-quantum"></span><h2>Updating CUDA-Q<a class="headerlink" href="#updating-cuda-q" title="Permalink to this heading">¶</a></h2>
+<p>If you installed the CUDA-Q Python wheels, you can update to the latest release
+by running the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python3 -m pip install --upgrade cuda-quantum</span>
+</pre></div>
+</div>
+<p>If you previously installed the CUDA-Q pre-built binaries, you should first uninstall your
+current CUDA-Q installation before installing the new version using the installer.
+To uninstall your current CUDA-Q version, run the command</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">sudo bash &quot;${CUDA_QUANTUM_PATH}/uninstall.sh&quot; -y</span>
+</pre></div>
+</div>
+<p>The <code class="code docutils literal notranslate"><span class="pre">uninstall.sh</span></code> script is generated during installation, and will remove all files
+and folders that were created as part of the installation, whether they were modified
+in the meantime or not. It does not remove any additional files that existed prior
+to the installation or that you have added to the installation location since then.
+You can then download and install the new version of CUDA-Q following the
+instructions <a class="reference internal" href="#install-prebuilt-binaries"><span class="std std-ref">above</span></a>.</p>
+</section>
+<section id="dependencies-and-compatibility">
+<span id="id9"></span><h2>Dependencies and Compatibility<a class="headerlink" href="#dependencies-and-compatibility" title="Permalink to this heading">¶</a></h2>
+<p>CUDA-Q can be used to compile and run quantum programs on a CPU-only system, but a GPU is highly recommended and necessary to use the GPU-based simulators, see also <a class="reference internal" href="../backends/simulators.html"><span class="doc">CUDA-Q Simulation Backends</span></a>.</p>
+<p>The supported CPUs include x86_64 (x86-64-v3 architecture and newer) and ARM64 (ARM v8-A architecture and newer).</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>Some of the components included in the CUDA-Q Python wheels depend on an existing CUDA installation on your system. For more information about installing the CUDA-Q Python wheels, take a look at <a class="reference internal" href="#install-python-wheels"><span class="std std-ref">this section</span></a>.</p>
+</div>
+<p>The following table summarizes the required components.</p>
+<table class="docutils align-default" id="id10">
+<caption><span class="caption-text">Supported Systems</span><a class="headerlink" href="#id10" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col style="width: 38%" />
+<col style="width: 63%" />
+</colgroup>
+<tbody>
+<tr class="row-odd"><td><p>CPU architectures</p></td>
+<td><p>x86_64, ARM64</p></td>
+</tr>
+<tr class="row-even"><td><p>Operating System</p></td>
+<td><p>Linux</p></td>
+</tr>
+<tr class="row-odd"><td><p>Tested Distributions</p></td>
+<td><p>CentOS 8; Debian 11, 12; Fedora 38; OpenSUSE/SLED/SLES 15.5; RHEL 8, 9; Rocky 8, 9; Ubuntu 22.04</p></td>
+</tr>
+<tr class="row-even"><td><p>Python versions</p></td>
+<td><p>3.8+</p></td>
+</tr>
+</tbody>
+</table>
+<table class="docutils align-default" id="id11">
+<caption><span class="caption-text">Requirements for GPU Simulation</span><a class="headerlink" href="#id11" title="Permalink to this table">¶</a></caption>
+<colgroup>
+<col style="width: 38%" />
+<col style="width: 63%" />
+</colgroup>
+<tbody>
+<tr class="row-odd"><td><p>GPU Architectures</p></td>
+<td><p>Volta, Turing, Ampere, Ada, Hopper</p></td>
+</tr>
+<tr class="row-even"><td><p>NVIDIA GPU with Compute Capability</p></td>
+<td><p>7.0+</p></td>
+</tr>
+<tr class="row-odd"><td><p>CUDA</p></td>
+<td><p>11.x (Driver 470.57.02+), 12.x (Driver 525.60.13+)</p></td>
+</tr>
+</tbody>
+</table>
+<p>Detailed information about supported drivers for different CUDA versions and be found <a class="reference external" href="https://docs.nvidia.com/deploy/cuda-compatibility/">here</a>.</p>
+</section>
+<section id="next-steps">
+<span id="post-installation"></span><h2>Next Steps<a class="headerlink" href="#next-steps" title="Permalink to this heading">¶</a></h2>
+<p>You can now compile and/or run the C++ and Python examples using the terminal.
+To open a terminal in VS Code, open the Command Palette with <code class="code docutils literal notranslate"><span class="pre">Ctrl+Shift+P</span></code> and
+enter “View: Show Terminal”.</p>
+<img alt="../../_images/getToWork.png" src="../../_images/getToWork.png" />
+<p>The CUDA-Q image contains a folder with examples and tutorials in the <code class="code docutils literal notranslate"><span class="pre">/home/cudaq</span></code> directory.
+These examples are provided to get you started with CUDA-Q and understanding
+the programming and execution model.
+If you are not using a container image, you can find these examples on our
+<a class="reference external" href="https://github.com/NVIDIA/cuda-quantum">GitHub repository</a>.</p>
+<p>Let’s start by running a simple program to validate your installation.
+The samples contain an implementation of a
+<a class="reference external" href="https://en.wikipedia.org/wiki/Bernstein%E2%80%93Vazirani_algorithm">Bernstein-Vazirani algorithm</a>.
+To run the example, execute the command:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python examples/python/bernstein_vazirani.py --size 5</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp &amp;&amp; ./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>This will execute the program on the <a class="reference internal" href="../backends/simulators.html#id3"><span class="std std-ref">default simulator</span></a>, which will use GPU-acceleration if
+a suitable GPU has been detected. To confirm that the GPU acceleration works, you can
+increase the size of the secret string, and pass the target as a command line argument:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python examples/python/bernstein_vazirani.py --size 25 --target nvidia</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp -DSIZE=25 --target nvidia &amp;&amp; ./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>This program should complete fairly quickly. Depending on the available memory on your GPU,
+you can set the size of the secret string to up to 28-32 when running on the <code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target.</p>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If you get an error that the CUDA driver version is insufficient or no GPU has been detected,
+check that you have enabled GPU support when launching the container by passing the <code class="code docutils literal notranslate"><span class="pre">--gpus</span> <span class="pre">all</span></code> flag
+(for <a class="reference internal" href="#install-docker-image"><span class="std std-ref">Docker</span></a>) or the <code class="code docutils literal notranslate"><span class="pre">--nv</span></code> flag (for <a class="reference internal" href="#install-singularity-image"><span class="std std-ref">Singularity</span></a>).
+If you are not running a container, you can execute the command <code class="code docutils literal notranslate"><span class="pre">nvidia-smi</span></code> to confirm your setup;
+if the command is unknown or fails, you do not have a GPU or do not have a driver installed. If the command
+succeeds, please confirm that your CUDA and driver version matches the
+<a class="reference internal" href="#dependencies-and-compatibility"><span class="std std-ref">supported versions</span></a>.</p>
+</div>
+<p>Let’s compare that to using only your CPU:</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--3-input--1" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python examples/python/bernstein_vazirani.py --size 25 --target qpp-cpu</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--3-input--2" name="tab-set--3" type="radio"><label class="tab-label" for="tab-set--3-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ examples/cpp/algorithms/bernstein_vazirani.cpp -DSIZE=25 --target qpp-cpu &amp;&amp; ./a.out</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>When you execute this command, the program simply seems to hang; that is because it takes
+a long time for the CPU-only backend to simulate 28+ qubits! Cancel the execution with <code class="code docutils literal notranslate"><span class="pre">Ctrl+C</span></code>.</p>
+<p>You are now all set to start developing quantum applications using CUDA-Q!
+Please proceed to <a class="reference internal" href="../basics/basics.html"><span class="doc">Basics</span></a> for an introduction
+to the fundamental features of CUDA-Q.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="install.html" class="btn btn-neutral float-left" title="Installation Guide" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="data_center_install.html" class="btn btn-neutral float-right" title="Installation from Source" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/integration/cmake_app.html b/pr-2241/using/integration/cmake_app.html
new file mode 100644
index 0000000000..42211a52d0
--- /dev/null
+++ b/pr-2241/using/integration/cmake_app.html
@@ -0,0 +1,684 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q and CMake &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Using CUDA and CUDA-Q in a Project" href="cuda_gpu.html" />
+    <link rel="prev" title="Integration with other Software Tools" href="integration.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="integration.html">   Integration</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="integration.html">Integration with other Software Tools</a></li>
+      <li class="breadcrumb-item active">CUDA-Q and CMake</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/integration/cmake_app.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="integration.html" class="btn btn-neutral float-left" title="Integration with other Software Tools" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cuda_gpu.html" class="btn btn-neutral float-right" title="Using CUDA and CUDA-Q in a Project" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-and-cmake">
+<h1>CUDA-Q and CMake<a class="headerlink" href="#cuda-q-and-cmake" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q provides a full compiler toolchain for building
+out quantum-classical applications. Since most C++ projects
+provide some sort of integration with CMake, it becomes imperative
+for our toolchain to integrate well with the CMake build system.</p>
+<p>CUDA-Q provides CMake configuration files that allow downstream
+application developers to create hybrid quantum-classical source code
+and build it with the typical CMake workflow, which will natively
+leverage <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> for compilation of CUDA-Q source files.</p>
+<p>To see how this works, let’s create a trivial example. Suppose we have
+a folder named <code class="code docutils literal notranslate"><span class="pre">myCudaQApp</span></code> and within that folder we have
+a simple CUDA-Q source file, like <code class="code docutils literal notranslate"><span class="pre">ghz.cpp</span></code>. With a local
+CUDA-Q installation present on the system, we can create the
+following top-level <code class="code docutils literal notranslate"><span class="pre">CMakeLists.txt</span></code> file to build this file with
+<code class="code docutils literal notranslate"><span class="pre">nvq++</span></code>:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>cmake_minimum_required<span class="o">(</span>VERSION<span class="w"> </span><span class="m">3</span>.24<span class="w"> </span>FATAL_ERROR<span class="o">)</span>
+project<span class="o">(</span>myCudaQApp<span class="w"> </span>LANGUAGES<span class="w"> </span>CXX<span class="o">)</span>
+find_package<span class="o">(</span>CUDAQ<span class="w"> </span>REQUIRED<span class="o">)</span>
+add_executable<span class="o">(</span>ghz_exe<span class="w"> </span>ghz.cpp<span class="o">)</span>
+</pre></div>
+</div>
+<p>To configure and build this file, all we need to do is execute the following from the top level of the <code class="code docutils literal notranslate"><span class="pre">myCudaQApp</span></code> folder:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>mkdir<span class="w"> </span>build<span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="nb">cd</span><span class="w"> </span>build
+cmake<span class="w"> </span>..<span class="w"> </span>-G<span class="w"> </span>Ninja<span class="w"> </span>-DCUDAQ_DIR<span class="o">=</span><span class="s2">&quot;</span><span class="nv">$CUDA_QUANTUM_PATH</span><span class="s2">/lib/cmake/cudaq&quot;</span>
+ninja
+./ghz_exe
+</pre></div>
+</div>
+<p>Notice that by running the <code class="code docutils literal notranslate"><span class="pre">ninja</span></code> command with <code class="code docutils literal notranslate"><span class="pre">--verbose</span></code>, you’ll see that
+<code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> was used to compile and link the executable.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="integration.html" class="btn btn-neutral float-left" title="Integration with other Software Tools" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cuda_gpu.html" class="btn btn-neutral float-right" title="Using CUDA and CUDA-Q in a Project" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/integration/cuda_gpu.html b/pr-2241/using/integration/cuda_gpu.html
new file mode 100644
index 0000000000..125fbd988b
--- /dev/null
+++ b/pr-2241/using/integration/cuda_gpu.html
@@ -0,0 +1,752 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Using CUDA and CUDA-Q in a Project &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Integrating with Third-Party Libraries" href="libraries.html" />
+    <link rel="prev" title="CUDA-Q and CMake" href="cmake_app.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="integration.html">   Integration</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="integration.html">Integration with other Software Tools</a></li>
+      <li class="breadcrumb-item active">Using CUDA and CUDA-Q in a Project</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/integration/cuda_gpu.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cmake_app.html" class="btn btn-neutral float-left" title="CUDA-Q and CMake" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="libraries.html" class="btn btn-neutral float-right" title="Integrating with Third-Party Libraries" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="using-cuda-and-cuda-q-in-a-project">
+<h1>Using CUDA and CUDA-Q in a Project<a class="headerlink" href="#using-cuda-and-cuda-q-in-a-project" title="Permalink to this heading">¶</a></h1>
+<p>It may be the case that a project that uses CUDA-Q kernels may also
+want to use CUDA code to do computation on a GPU.  This is possible by using
+both the CUDA Toolkit and CUDA-Q tools. More about programming GPUs
+in CUDA can be found in the <a class="reference external" href="https://docs.nvidia.com/cuda/cuda-quick-start-guide/index.html">Quick Start Guide</a>.</p>
+<p>Once the <code class="code docutils literal notranslate"><span class="pre">nvcc</span></code> compiler is installed, it is possible to write
+CUDA kernels and have them execute on the system GPU. See NVIDIA’s <a class="reference external" href="https://developer.nvidia.com/blog/easy-introduction-cuda-c-and-c/">An
+Easy Introduction to CUDA C and C++</a>
+for more information on getting started with CUDA.</p>
+<p>CUDA code uses a unique syntax and is, typically, saved in a file with
+the extension <code class="code docutils literal notranslate"><span class="pre">.cu</span></code>. For our example, assume we have written our
+CUDA code in the file <code class="code docutils literal notranslate"><span class="pre">my_proj.cu</span></code>.</p>
+<p>CUDA-Q code is a library-based extension of C++ and uses
+standard conforming C++ syntax. Typically, a quantum kernel would be
+saved in a file with the <code class="code docutils literal notranslate"><span class="pre">.cpp</span></code> extension. Again for our
+example, let’s assume that we’ve written quantum kernels and saved
+them in the file <code class="code docutils literal notranslate"><span class="pre">my_proj_quantum.cpp</span></code>.</p>
+<p>By default, CUDA-Q uses C++ 20 and builds source code against the
+LLVM C++ standard library (<code class="code docutils literal notranslate"><span class="pre">libc++</span></code>). To create a CUDA library that
+can link against CUDA-Q code, make sure to define an API that does
+not rely on C++ data structures that rely on a specific C++ toolchain
+for all functions intended to be called from CUDA-Q (see also
+<a class="reference internal" href="libraries.html#clike-shim"><span class="std std-ref">Interfacing between binaries compiled with a different toolchains</span></a>). For example, if you define a CUDA kernel in <code class="code docutils literal notranslate"><span class="pre">my_proj.cu</span></code></p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">CudaDataType</span><span class="o">&gt;</span>
+<span class="n">__global__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">cudaSetFirstNElements</span><span class="p">(</span><span class="n">CudaDataType</span><span class="w"> </span><span class="o">*</span><span class="n">sv</span><span class="p">,</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="n">CudaDataType</span><span class="w"> </span><span class="o">*</span><span class="n">__restrict__</span><span class="w"> </span><span class="n">sv2</span><span class="p">,</span><span class="w"> </span><span class="kt">int64_t</span><span class="w"> </span><span class="n">N</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="kt">int64_t</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">static_cast</span><span class="o">&lt;</span><span class="kt">int64_t</span><span class="o">&gt;</span><span class="p">(</span><span class="n">blockIdx</span><span class="p">.</span><span class="n">x</span><span class="p">)</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="n">blockDim</span><span class="p">.</span><span class="n">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="n">threadIdx</span><span class="p">.</span><span class="n">x</span><span class="p">;</span>
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">N</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">sv</span><span class="p">[</span><span class="n">i</span><span class="p">].</span><span class="n">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">sv2</span><span class="p">[</span><span class="n">i</span><span class="p">].</span><span class="n">x</span><span class="p">;</span>
+<span class="w">        </span><span class="n">sv</span><span class="p">[</span><span class="n">i</span><span class="p">].</span><span class="n">y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">sv2</span><span class="p">[</span><span class="n">i</span><span class="p">].</span><span class="n">y</span><span class="p">;</span>
+<span class="w">    </span><span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">sv</span><span class="p">[</span><span class="n">i</span><span class="p">].</span><span class="n">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0.0</span><span class="p">;</span>
+<span class="w">        </span><span class="n">sv</span><span class="p">[</span><span class="n">i</span><span class="p">].</span><span class="n">y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0.0</span><span class="p">;</span>
+<span class="w">    </span><span class="p">}</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>define the following template and all desired template specializations</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">CudaDataType</span><span class="o">&gt;</span>
+<span class="kt">void</span><span class="w"> </span><span class="n">setFirstNElements</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="p">,</span>
+<span class="w">                       </span><span class="kt">int32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                       </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">newDeviceStateVector</span><span class="p">,</span>
+<span class="w">                       </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                       </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">previousStateDimension</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cudaSetFirstNElements</span><span class="o">&lt;&lt;&lt;</span><span class="n">n_blocks</span><span class="p">,</span><span class="w"> </span><span class="n">threads_per_block</span><span class="o">&gt;&gt;&gt;</span><span class="p">(</span>
+<span class="w">        </span><span class="k">reinterpret_cast</span><span class="o">&lt;</span><span class="n">CudaDataType</span><span class="w"> </span><span class="o">*&gt;</span><span class="p">(</span><span class="n">newDeviceStateVector</span><span class="p">),</span>
+<span class="w">        </span><span class="k">reinterpret_cast</span><span class="o">&lt;</span><span class="n">CudaDataType</span><span class="w"> </span><span class="o">*&gt;</span><span class="p">(</span><span class="n">deviceStateVector</span><span class="p">),</span>
+<span class="w">        </span><span class="n">previousStateDimension</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="k">template</span><span class="w"> </span><span class="kt">void</span>
+<span class="n">setFirstNElements</span><span class="o">&lt;</span><span class="n">cuFloatComplex</span><span class="o">&gt;</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="p">,</span>
+<span class="w">                                  </span><span class="kt">int32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                                  </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">newDeviceStateVector</span><span class="p">,</span>
+<span class="w">                                  </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                                  </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">previousStateDimension</span><span class="p">);</span>
+
+<span class="k">template</span><span class="w"> </span><span class="kt">void</span>
+<span class="n">setFirstNElements</span><span class="o">&lt;</span><span class="n">cuDoubleComplex</span><span class="o">&gt;</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="p">,</span>
+<span class="w">                                   </span><span class="kt">int32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                                   </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">newDeviceStateVector</span><span class="p">,</span>
+<span class="w">                                   </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                                   </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">previousStateDimension</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Create the corresponding header file <code class="code docutils literal notranslate"><span class="pre">my_proj.h</span></code> declaring the <code class="code docutils literal notranslate"><span class="pre">setFirstNElements</span></code>
+template. You can then call <code class="code docutils literal notranslate"><span class="pre">setFirstNElements</span></code> from within <code class="code docutils literal notranslate"><span class="pre">my_proj_quantum.cpp</span></code>
+by including <code class="code docutils literal notranslate"><span class="pre">my_proj.h</span></code>, for example</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cuComplex.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cuda_runtime.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;device_launch_parameters.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;my_proj.h&quot;</span>
+
+<span class="k">using</span><span class="w"> </span><span class="k">namespace</span><span class="w"> </span><span class="nn">my_kernels</span><span class="p">;</span><span class="w"> </span><span class="c1">// the namespace where you defined setFirstNElements</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="w"> </span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">10</span><span class="p">;</span>
+<span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">5</span><span class="p">;</span>
+
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">;</span>
+<span class="w">    </span><span class="n">cudaMalloc</span><span class="p">((</span><span class="kt">void</span><span class="w"> </span><span class="o">**</span><span class="p">)</span><span class="o">&amp;</span><span class="n">deviceStateVector</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">sizeof</span><span class="p">(</span><span class="n">cuDoubleComplex</span><span class="p">));</span>
+<span class="w">    </span><span class="c1">// ...</span>
+<span class="w">    </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">newDeviceStateVector</span><span class="p">;</span>
+<span class="w">    </span><span class="n">cudaMalloc</span><span class="p">((</span><span class="kt">void</span><span class="w"> </span><span class="o">**</span><span class="p">)</span><span class="o">&amp;</span><span class="n">newDeviceStateVector</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">sizeof</span><span class="p">(</span><span class="n">cuDoubleComplex</span><span class="p">));</span>
+<span class="w">    </span><span class="n">setFirstNElements</span><span class="o">&lt;</span><span class="n">cuDoubleComplex</span><span class="o">&gt;</span><span class="p">(</span><span class="n">n_blocks</span><span class="p">,</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                                       </span><span class="n">newDeviceStateVector</span><span class="p">,</span><span class="w"> </span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                                       </span><span class="mi">2</span><span class="p">);</span>
+<span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>To get an executable, compile the code with</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvcc<span class="w"> </span>-c<span class="w"> </span>-std<span class="o">=</span>c++17<span class="w"> </span>-Xcompiler<span class="w"> </span>-fPIC<span class="w"> </span>my_proj.cu<span class="w"> </span>-o<span class="w"> </span>my_proj.o
+nvq++<span class="w"> </span>my_proj_quantum.cpp<span class="w"> </span>my_proj.o<span class="w"> </span>-I<span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDA_HOME</span><span class="si">}</span><span class="s2">/include/&quot;</span><span class="w"> </span>-L<span class="s2">&quot;</span><span class="si">${</span><span class="nv">CUDA_HOME</span><span class="si">}</span><span class="s2">/lib64&quot;</span><span class="w"> </span>-lcudart<span class="w"> </span>-o<span class="w"> </span>my_executable
+</pre></div>
+</div>
+<p>Above, <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> is used for the link step and will make sure the CUDA-Q
+runtime libraries are linked correctly to the executable program.
+The CUDA runtime is explicitly added to this command.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cmake_app.html" class="btn btn-neutral float-left" title="CUDA-Q and CMake" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="libraries.html" class="btn btn-neutral float-right" title="Integrating with Third-Party Libraries" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/integration/integration.html b/pr-2241/using/integration/integration.html
new file mode 100644
index 0000000000..9bd7d82998
--- /dev/null
+++ b/pr-2241/using/integration/integration.html
@@ -0,0 +1,662 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Integration with other Software Tools &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="CUDA-Q and CMake" href="cmake_app.html" />
+    <link rel="prev" title="Installation from Source" href="../install/data_center_install.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Integration with other Software Tools</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/integration/integration.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../install/data_center_install.html" class="btn btn-neutral float-left" title="Installation from Source" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cmake_app.html" class="btn btn-neutral float-right" title="CUDA-Q and CMake" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="integration-with-other-software-tools">
+<h1>Integration with other Software Tools<a class="headerlink" href="#integration-with-other-software-tools" title="Permalink to this heading">¶</a></h1>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l1"><a class="reference internal" href="cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l1"><a class="reference internal" href="libraries.html">Integrating with Third-Party Libraries</a></li>
+</ul>
+</div>
+<p>Information about customizing or extending the CUDA-Q toolchain can be found in <a class="reference internal" href="../extending/extending.html"><span class="doc">Extending CUDA-Q</span></a>.</p>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../install/data_center_install.html" class="btn btn-neutral float-left" title="Installation from Source" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="cmake_app.html" class="btn btn-neutral float-right" title="CUDA-Q and CMake" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/integration/libraries.html b/pr-2241/using/integration/libraries.html
new file mode 100644
index 0000000000..6109fc35eb
--- /dev/null
+++ b/pr-2241/using/integration/libraries.html
@@ -0,0 +1,845 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Integrating with Third-Party Libraries &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
+        <script src="../../_static/jquery.js"></script>
+        <script src="../../_static/underscore.js"></script>
+        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../../_static/doctools.js"></script>
+        <script src="../../_static/sphinx_highlight.js"></script>
+        <script src="../../_static/tabs.js"></script>
+        <script src="../../_static/clipboard.min.js"></script>
+        <script src="../../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../genindex.html" />
+    <link rel="search" title="Search" href="../../search.html" />
+    <link rel="next" title="Extending CUDA-Q" href="../extending/extending.html" />
+    <link rel="prev" title="Using CUDA and CUDA-Q in a Project" href="cuda_gpu.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="reference internal" href="integration.html">   Integration</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="integration.html">Integration with other Software Tools</a></li>
+      <li class="breadcrumb-item active">Integrating with Third-Party Libraries</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../../_sources/using/integration/libraries.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="cuda_gpu.html" class="btn btn-neutral float-left" title="Using CUDA and CUDA-Q in a Project" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../extending/extending.html" class="btn btn-neutral float-right" title="Extending CUDA-Q" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="integrating-with-third-party-libraries">
+<h1>Integrating with Third-Party Libraries<a class="headerlink" href="#integrating-with-third-party-libraries" title="Permalink to this heading">¶</a></h1>
+<p>CUDA-Q enables easily integrating quantum kernels with existing state-of-the-art tools
+for classical computing and high performance computing. While quantum kernels are expressed
+in Python or C++, quantum hardware backends only support a very limited set of classical
+instructions. Correspondingly, only a select set of libraries and functions that are
+directly supported by the CUDA-Q compiler can be called from within quantum kernels.
+Code that is not marked as kernel code, on the other hand, can be used to invoke the
+defined quantum kernels as well as any classical tools and libraries. CUDA-Q provides
+a complete toolset to build complex applications running on multi-processor systems involving
+CPUs, GPUs and QPUs.</p>
+<p>In Python, integration with any third-party Python package is handled
+automatically without any need for additional configuration. For C++, the rest of this
+document outlines how to integration with libraries that are compile with a different
+compiler than <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code>.</p>
+<section id="calling-a-cuda-q-library-from-c">
+<h2>Calling a CUDA-Q library from C++<a class="headerlink" href="#calling-a-cuda-q-library-from-c" title="Permalink to this heading">¶</a></h2>
+<p>The CUDA-Q compiler is a fully-featured C++ compiler able to process arbitrary C++ code outside
+of quantum kernels. In fact, the CUDA-Q installation includes and invokes a custom-built Clang
+compiler under the hood. In general, it hence is not necessary to use a different compiler to
+compile C++ host code that calls into quantum kernels; the host code is compiled along with
+the quantum kernels into a single library or executable by the CUDA-Q toolchain.</p>
+<p>If you would still like to create a library that can be included in libraries and executables
+built with a different toolchain, you can configure <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> to include and encapsulate all its
+C++ dependencies, such that the CUDA-Q library only depends on C libraries. For example,
+if you have a file <code class="code docutils literal notranslate"><span class="pre">quantum_kernel.cpp</span></code> containing</p>
+<div class="highlight-C++ notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;cudaq.h&quot;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;sstream&gt;</span>
+
+<span class="k">namespace</span><span class="w"> </span><span class="nn">quantum</span><span class="w"> </span><span class="p">{</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">bell</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">qs</span><span class="p">(</span><span class="mi">2</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">qs</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">cnot</span><span class="p">(</span><span class="n">qs</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">qs</span><span class="p">[</span><span class="mi">1</span><span class="p">]);</span>
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">qs</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="c1">// Usually, one would probably return something like</span>
+<span class="c1">// the most probably value in the distribution rather</span>
+<span class="c1">// than the string dump. However, the bell kernel here</span>
+<span class="c1">// has a 50/50 chance of returning 00 or 11.</span>
+<span class="k">const</span><span class="w"> </span><span class="kt">char</span><span class="o">*</span><span class="w"> </span><span class="n">bell_distribution</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">dist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">bell</span><span class="p">);</span>
+
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">stringbuf</span><span class="w"> </span><span class="n">buffer</span><span class="p">;</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">ostream</span><span class="w"> </span><span class="nf">os</span><span class="p">(</span><span class="o">&amp;</span><span class="n">buffer</span><span class="p">);</span>
+<span class="w">  </span><span class="n">dist</span><span class="p">.</span><span class="n">dump</span><span class="p">(</span><span class="n">os</span><span class="p">);</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">sample_results</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">buffer</span><span class="p">.</span><span class="n">str</span><span class="p">();</span>
+
+<span class="w">  </span><span class="kt">char</span><span class="o">*</span><span class="w"> </span><span class="n">ptr</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="kt">char</span><span class="p">[</span><span class="n">sample_results</span><span class="p">.</span><span class="n">size</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">];</span>
+<span class="w">  </span><span class="n">strcpy</span><span class="p">(</span><span class="n">ptr</span><span class="p">,</span><span class="w"> </span><span class="n">sample_results</span><span class="p">.</span><span class="n">c_str</span><span class="p">());</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="n">ptr</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="p">}</span><span class="w"> </span><span class="c1">// namespace quantum</span>
+</pre></div>
+</div>
+<p>you can create such a library with the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>quantum_kernel.cpp<span class="w"> </span>-shared<span class="w"> </span>-static-libstdc++<span class="w"> </span>-fPIC<span class="w"> </span>-o<span class="w"> </span>libquantum_kernel.so
+</pre></div>
+</div>
+<p>To use this library in a project built with an external toolchain, define a suitable
+header file <code class="code docutils literal notranslate"><span class="pre">quantum_kernel.h</span></code> containing</p>
+<div class="highlight-C++ notranslate"><div class="highlight"><pre><span></span><span class="k">namespace</span><span class="w"> </span><span class="nn">quantum</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">const</span><span class="w"> </span><span class="kt">char</span><span class="o">*</span><span class="w"> </span><span class="nf">bell_distribution</span><span class="p">();</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>and include it in your project. For example, if <code class="code docutils literal notranslate"><span class="pre">external.cpp</span></code> contains</p>
+<div class="highlight-C++ notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;iostream&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&quot;quantum_kernel.h&quot;</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="w"> </span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="c1">// some code</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">bell_dist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">quantum</span><span class="o">::</span><span class="n">bell_distribution</span><span class="p">();</span>
+<span class="w">  </span><span class="n">std</span><span class="o">::</span><span class="n">cout</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">bell_dist</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n">std</span><span class="o">::</span><span class="n">endl</span><span class="p">;</span>
+<span class="w">  </span><span class="k">delete</span><span class="p">[]</span><span class="w"> </span><span class="n">bell_dist</span><span class="p">;</span>
+<span class="w">  </span><span class="c1">// more code</span>
+<span class="w">  </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>you can compile it with <code class="code docutils literal notranslate"><span class="pre">g++</span></code> and link it with the built <code class="code docutils literal notranslate"><span class="pre">libquantum_kernel.so</span></code> library
+using the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>g++<span class="w"> </span>external.cpp<span class="w"> </span>-lquantum_kernel<span class="w"> </span>-L<span class="s2">&quot;</span><span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span><span class="s2">&quot;</span><span class="w"> </span>-Wl,-rpath<span class="o">=</span><span class="s2">&quot;</span><span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span><span class="s2">&quot;</span><span class="w"> </span>-I<span class="s2">&quot;</span><span class="k">$(</span><span class="nb">pwd</span><span class="k">)</span><span class="s2">&quot;</span>
+</pre></div>
+</div>
+<p>Note that the API defined in <code class="code docutils literal notranslate"><span class="pre">quantum_kernel.h</span></code> does not depend on any data types that
+rely on the specific implementation of the C++ standard library. For example, we return a
+<code class="code docutils literal notranslate"><span class="pre">const</span> <span class="pre">char*</span></code> instead of a <code class="code docutils literal notranslate"><span class="pre">std::string</span></code> value. This is important to ensure that the data
+is handled correctly regardless of which C++ standard library is used. If you include
+data types that depend on a specific C++ ABI, the linker should detect this incompatibility
+and should generate an error. See the section <a class="reference internal" href="#clike-shim"><span class="std std-ref">Interfacing between binaries compiled with a different toolchains</span></a> below to learn more about
+what to watch out for when defining an API to interface between libraries that are built
+with different compilers.</p>
+</section>
+<section id="calling-an-c-library-from-cuda-q">
+<h2>Calling an C++ library from CUDA-Q<a class="headerlink" href="#calling-an-c-library-from-cuda-q" title="Permalink to this heading">¶</a></h2>
+<p>CUDA-Q comes with a complete C++ toolchain, and is configured to use its own C++ standard
+library by default. When calling a third-party library from within a CUDA-Q application,
+the quantum kernels and the surrounding application code are compiled with the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> compiler,
+whereas the third-party library may be compiled with a different toolchain.
+For most widely distributed libraries, this will work out of the box. The exception are
+third-party libraries that are pre-compiled (opposed to being header-only libraries)
+and dynamically depend on a different C++ standard library than CUDA-Q uses.
+This is the case for a library <code class="code docutils literal notranslate"><span class="pre">third_party_library.so</span></code> if <code class="code docutils literal notranslate"><span class="pre">libstdc++.so</span></code> is listed
+in the output of the command</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ldd<span class="w"> </span>third_party_library.so
+</pre></div>
+</div>
+<p>To use such a library with CUDA-Q, you have to install the static version of the
+library. The <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> compiler can be configured to link a static library
+<code class="code docutils literal notranslate"><span class="pre">libexternal_library.a</span></code> instead of the shared one with the same flags as GCC/Clang:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>my_code.cpp<span class="w"> </span>-Wl,-Bstatic<span class="w"> </span>-lexternal_library<span class="w"> </span>-Wl,-Bdynamic<span class="w"> </span>...
+</pre></div>
+</div>
+<p>If the compilation fails due to undefined symbols during linking, then <code class="code docutils literal notranslate"><span class="pre">libexternal_library.a</span></code>
+does not include the C++ standard library components it depends on. In this case, you can create a
+suitable static library that contains the external library as well as its <code class="code docutils literal notranslate"><span class="pre">libstdc++</span></code> dependencies
+by combining <code class="code docutils literal notranslate"><span class="pre">libexternal_library.a</span></code> and <code class="code docutils literal notranslate"><span class="pre">libstdc++.a</span></code> into a single flattened archive.
+For example, if the external library is built with GCC and located in <code class="code docutils literal notranslate"><span class="pre">/usr/lib</span></code>,
+the following commands create a suitable archive using the GNU archiver:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>ar<span class="w"> </span>cruT<span class="w"> </span>libexternal_library_complete.a<span class="w"> </span>/usr/lib/libexternal_library.a<span class="w"> </span><span class="s2">&quot;</span><span class="k">$(</span>g++<span class="w"> </span>-print-file-name<span class="o">=</span>libstdc++.a<span class="k">)</span><span class="s2">&quot;</span>
+<span class="nb">echo</span><span class="w"> </span>-e<span class="w"> </span><span class="s1">&#39;create libexternal_library_complete.a\naddlib libexternal_library_complete.a\nsave\nend&#39;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>ar<span class="w"> </span>-M
+</pre></div>
+</div>
+<p>The above commands create a new static library <code class="code docutils literal notranslate"><span class="pre">libexternal_library_complete.a</span></code> in the current directory.
+To use it, adjust the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> command accordingly:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>nvq++<span class="w"> </span>my_code.cpp<span class="w"> </span>-L.<span class="w"> </span>-Wl,-Bstatic<span class="w"> </span>-lexternal_library_complete<span class="w"> </span>-Wl,-Bdynamic<span class="w"> </span>...
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>If the third-party library functions you are calling from your CUDA-Q code
+consume or produce data types that explicitly depend on the C++ standard library implementation,
+a small shim is needed to properly encapsulate these dependencies, as described in
+<a class="reference internal" href="#clike-shim"><span class="std std-ref">Interfacing between binaries compiled with a different toolchains</span></a>.</p>
+</div>
+</section>
+<section id="interfacing-between-binaries-compiled-with-a-different-toolchains">
+<span id="clike-shim"></span><h2>Interfacing between binaries compiled with a different toolchains<a class="headerlink" href="#interfacing-between-binaries-compiled-with-a-different-toolchains" title="Permalink to this heading">¶</a></h2>
+<p>To avoid incompatibilities between different C++ implementations,
+two binaries built using a different C++ compiler should be careful when passing data types between them
+that rely on a specific C++ implementation. While primitive data types can be passed without
+issues, attempting to pass a string, for example, will result in a linking failure; a <code class="code docutils literal notranslate"><span class="pre">char*</span></code> must
+be passed instead of a string.</p>
+<p>Most other data types, including templated types, can be passed as long as their alignment matches.
+While different compilers generally align data differently, it is possible to force a particular
+alignment when defining the data type or value. For example, if we define a struct</p>
+<div class="highlight-C++ notranslate"><div class="highlight"><pre><span></span><span class="cp">#pragma pack(push, 4)</span>
+<span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">ScalarType</span><span class="o">&gt;</span>
+<span class="k">struct</span><span class="w"> </span><span class="nc">Entry</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="kt">bool</span><span class="w"> </span><span class="n">is_integral</span><span class="p">;</span>
+<span class="w">  </span><span class="n">ScalarType</span><span class="w"> </span><span class="n">value</span><span class="p">;</span>
+<span class="p">};</span>
+<span class="cp">#pragma pack(pop)</span>
+</pre></div>
+</div>
+<p>the <code class="code docutils literal notranslate"><span class="pre">pragma</span></code> directives ensure that each item will be 4-byte aligned, regardless of the
+default setting that can differ between compilers.</p>
+<p>Even function pointers can usually be passed, as long as their argument and return types can be passed.
+When using templated functions and data types, the header file should only include their declaration as well
+as explicit instantiation for all valid template arguments. For example,</p>
+<div class="highlight-C++ notranslate"><div class="highlight"><pre><span></span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">typename</span><span class="w"> </span><span class="nc">CudaDataType</span><span class="o">&gt;</span>
+<span class="kt">void</span><span class="w"> </span><span class="n">initializeDeviceStateVector</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="p">,</span>
+<span class="w">                                </span><span class="kt">int32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                                </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                                </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">stateDimension</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaInitializeDeviceStateVector</span><span class="o">&lt;&lt;&lt;</span><span class="n">n_blocks</span><span class="p">,</span><span class="w"> </span><span class="n">threads_per_block</span><span class="o">&gt;&gt;&gt;</span><span class="p">(</span>
+<span class="w">    </span><span class="k">reinterpret_cast</span><span class="o">&lt;</span><span class="n">CudaDataType</span><span class="w"> </span><span class="o">*&gt;</span><span class="p">(</span><span class="n">deviceStateVector</span><span class="p">),</span><span class="w"> </span><span class="n">stateDimension</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="k">template</span><span class="w"> </span><span class="kt">void</span>
+<span class="n">initializeDeviceStateVector</span><span class="o">&lt;</span><span class="n">cuFloatComplex</span><span class="o">&gt;</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="p">,</span>
+<span class="w">                                </span><span class="kt">int32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                                </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                                </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">stateDimension</span><span class="p">);</span>
+
+<span class="k">template</span><span class="w"> </span><span class="kt">void</span>
+<span class="n">initializeDeviceStateVector</span><span class="o">&lt;</span><span class="n">cuDoubleComplex</span><span class="o">&gt;</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">n_blocks</span><span class="p">,</span>
+<span class="w">                                </span><span class="kt">int32_t</span><span class="w"> </span><span class="n">threads_per_block</span><span class="p">,</span>
+<span class="w">                                </span><span class="kt">void</span><span class="w"> </span><span class="o">*</span><span class="n">deviceStateVector</span><span class="p">,</span>
+<span class="w">                                </span><span class="n">std</span><span class="o">::</span><span class="kt">size_t</span><span class="w"> </span><span class="n">stateDimension</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>The most cumbersome aspect when libraries built with different toolchains are combined into a single executable
+is exception handling. Since the handling relies on a specific ABI, an thrown exception is not necessarily
+recognized as such in a library that uses a different ABI implementation. While matching the exception type
+may not work as expected, a catch-all will reliably catch any thrown exception.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="cuda_gpu.html" class="btn btn-neutral float-left" title="Using CUDA and CUDA-Q in a Project" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../extending/extending.html" class="btn btn-neutral float-right" title="Extending CUDA-Q" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/quick_start.html b/pr-2241/using/quick_start.html
new file mode 100644
index 0000000000..162ebe4406
--- /dev/null
+++ b/pr-2241/using/quick_start.html
@@ -0,0 +1,817 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Quick Start &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+        <script>window.MathJax = {"tex": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true}, "options": {"ignoreHtmlClass": "tex2jax_ignore|mathjax_ignore|document", "processHtmlClass": "tex2jax_process|mathjax_process|math|output_area"}}</script>
+        <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="CUDA-Q Basics" href="basics/basics.html" />
+    <link rel="prev" title="CUDA-Q" href="../index.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="tutorials.html">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Quick Start</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/using/quick_start.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="../index.html" class="btn btn-neutral float-left" title="CUDA-Q" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="basics/basics.html" class="btn btn-neutral float-right" title="CUDA-Q Basics" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="quick-start">
+<h1>Quick Start<a class="headerlink" href="#quick-start" title="Permalink to this heading">¶</a></h1>
+<p><strong>NVIDIA CUDA-Q</strong></p>
+<p>CUDA-Q streamlines hybrid application development and promotes productivity and scalability
+in quantum computing. It offers a unified programming model designed for a hybrid
+setting—that is, CPUs, GPUs, and QPUs working together. CUDA-Q contains support for
+programming in Python and in C++. Learn more about the <a class="reference external" href="https://developer.nvidia.com/cuda-q">key benefits of CUDA-Q</a>.</p>
+<p>This Quick Start page guides you through installing CUDA-Q and running your first program.
+If you have already installed and configured CUDA-Q, or if you are using our
+<a class="reference external" href="https://catalog.ngc.nvidia.com/orgs/nvidia/teams/quantum/containers/cuda-quantum">Docker image</a>, you can move directly to our
+<a class="reference internal" href="basics/basics.html"><span class="doc">Basics Section</span></a>. More information about working with containers and Docker alternatives can be
+found in our complete <a class="reference internal" href="install/install.html"><span class="doc">Installation Guide</span></a>.</p>
+<section id="install-cuda-q">
+<h2>Install CUDA-Q<a class="headerlink" href="#install-cuda-q" title="Permalink to this heading">¶</a></h2>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--0-input--1" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--1">Python</label><div class="tab-content docutils">
+<p>To develop CUDA-Q applications using Python,
+please follow the instructions for <a class="reference external" href="https://pypi.org/project/cuda-quantum/">installing CUDA-Q</a> from PyPI.
+If you have an NVIDIA GPU, make sure to also follow the instructions for enabling GPU-acceleration.</p>
+<p>CUDA-Q does not require a GPU to use, but some components are GPU-accelerated.</p>
+<p>Getting started with CUDA-Q on <code class="docutils literal notranslate"><span class="pre">x86_64</span></code> platforms simply requires
+<code class="docutils literal notranslate"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">cuda-quantum</span></code>. If you have an NVIDIA GPU on your host system, you
+will be able to use it without any further installation steps.</p>
+<p>However, if you want to perform multi-GPU simulations, or if you are using
+<code class="docutils literal notranslate"><span class="pre">aarch64</span></code>/<code class="docutils literal notranslate"><span class="pre">arm64</span></code> processors, additional components must be installed.
+We recommend using <a class="reference external" href="https://docs.conda.io/en/latest/">Conda</a> to do so.
+If you are not already using Conda,
+you can install a minimal version following the instructions
+<a class="reference external" href="https://docs.anaconda.com/miniconda/">here</a>. The
+following commands will create and activate a complete environment for CUDA-Q
+with all its dependencies:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">conda create -y -n cuda-quantum python=3.10 pip</span>
+<span class="go">conda install -y -n cuda-quantum -c &quot;nvidia/label/cuda-11.8.0&quot; cuda</span>
+<span class="go">conda install -y -n cuda-quantum -c conda-forge mpi4py openmpi cxx-compiler</span>
+<span class="go">conda env config vars set -n cuda-quantum LD_LIBRARY_PATH=&quot;$CONDA_PREFIX/envs/cuda-quantum/lib:$LD_LIBRARY_PATH&quot;</span>
+<span class="go">conda env config vars set -n cuda-quantum MPI_PATH=$CONDA_PREFIX/envs/cuda-quantum</span>
+<span class="go">conda run -n cuda-quantum pip install cuda-quantum</span>
+<span class="go">conda activate cuda-quantum</span>
+<span class="go">source $CONDA_PREFIX/lib/python3.10/site-packages/distributed_interfaces/activate_custom_mpi.sh</span>
+</pre></div>
+</div>
+<p>You must configure MPI by setting the following environment variables:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">export OMPI_MCA_opal_cuda_support=true OMPI_MCA_btl=&#39;^openib&#39;</span>
+</pre></div>
+</div>
+<p><em>If you do not set these variables you may encounter a segmentation fault.</em></p>
+<p><strong>Important</strong>: It is <em>not</em> sufficient to set these variable within the Conda
+environment, like the commands above do for <code class="docutils literal notranslate"><span class="pre">LD_LIBRARY_PATH</span></code>. To avoid having
+to set them every time you launch a new shell, we recommend adding them to
+<code class="docutils literal notranslate"><span class="pre">~/.profile</span></code> (create the file if it does not exist), and to <code class="docutils literal notranslate"><span class="pre">~/.bash_profile</span></code> or
+<code class="docutils literal notranslate"><span class="pre">~/.bash_login</span></code> if such a file exists.</p>
+<p>Once you completed the installation, please follow the instructions
+<a class="reference internal" href="#validate-installation"><span class="std std-ref">below</span></a> to run your first CUDA-Q program!</p>
+</div>
+<input class="tab-input" id="tab-set--0-input--2" name="tab-set--0" type="radio"><label class="tab-label" for="tab-set--0-input--2">C++</label><div class="tab-content docutils">
+<p>To develop CUDA-Q applications using C++, please make sure you have a C++ toolchain installed
+that supports C++20, for example <code class="code docutils literal notranslate"><span class="pre">g++</span></code> version 11 or newer.
+Download the <code class="code docutils literal notranslate"><span class="pre">install_cuda_quantum</span></code> file for your processor architecture from
+the assets of the respective <a class="reference external" href="https://github.com/NVIDIA/cuda-quantum/releases">GitHub release</a>; that is the file with the <code class="code docutils literal notranslate"><span class="pre">aarch64</span></code> extension for ARM processors, and the one with <code class="code docutils literal notranslate"><span class="pre">x86_64</span></code> for, e.g., Intel and AMD processors.</p>
+<p>To install CUDA-Q, execute the commands</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>-E<span class="w"> </span>bash<span class="w"> </span>install_cuda_quantum.<span class="k">$(</span>uname<span class="w"> </span>-m<span class="k">)</span><span class="w"> </span>--accept
+.<span class="w"> </span>/etc/profile
+</pre></div>
+</div>
+<p>If you have an NVIDIA GPU, please also install the <a class="reference external" href="https://developer.nvidia.com/cuda-downloads">CUDA Toolkit</a> to enable GPU-acceleration within CUDA-Q.</p>
+<p>Please see the complete <a class="reference internal" href="install/local_installation.html#install-prebuilt-binaries"><span class="std std-ref">installation guide</span></a> for more details, including</p>
+<ul class="simple">
+<li><p>a list of <a class="reference internal" href="install/local_installation.html#dependencies-and-compatibility"><span class="std std-ref">supported operating systems</span></a>,</p></li>
+<li><p>instructions on how to <a class="reference internal" href="install/local_installation.html#distributed-computing-with-mpi"><span class="std std-ref">enable MPI parallelization</span></a> within CUDA-Q, and</p></li>
+<li><p>information about <a class="reference internal" href="install/local_installation.html#updating-cuda-quantum"><span class="std std-ref">updating CUDA-Q</span></a>.</p></li>
+</ul>
+<p>Once you completed the installation, please follow the instructions
+<a class="reference internal" href="#validate-installation"><span class="std std-ref">below</span></a> to run your first CUDA-Q program!</p>
+</div>
+</div>
+</section>
+<section id="validate-your-installation">
+<span id="validate-installation"></span><h2>Validate your Installation<a class="headerlink" href="#validate-your-installation" title="Permalink to this heading">¶</a></h2>
+<p>Let’s run a simple program to validate your installation.
+The quantum kernel in the following program creates and measures the state
+<span class="math notranslate nohighlight">\((|00\rangle + |11\rangle) / \sqrt{2}\)</span>. That means each kernel execution should
+either yield <code class="code docutils literal notranslate"><span class="pre">00</span></code> or <code class="code docutils literal notranslate"><span class="pre">11</span></code>. The program samples, meaning it executes, the kernel 1000 times
+and prints how many times each output was measured. On average, the values <code class="code docutils literal notranslate"><span class="pre">00</span></code> and <code class="code docutils literal notranslate"><span class="pre">11</span></code>
+should be observed around 500 times each.</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--1-input--1" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--1">Python</label><div class="tab-content docutils">
+<p>Create a file titled <code class="code docutils literal notranslate"><span class="pre">program.py</span></code>, containing the following code:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">sys</span>
+<span class="kn">import</span> <span class="nn">cudaq</span>
+
+<span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Running on target </span><span class="si">{</span><span class="n">cudaq</span><span class="o">.</span><span class="n">get_target</span><span class="p">()</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<span class="n">qubit_count</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="k">if</span> <span class="mi">1</span> <span class="o">&lt;</span> <span class="nb">len</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">)</span> <span class="k">else</span> <span class="mi">2</span>
+
+
+<span class="nd">@cudaq</span><span class="o">.</span><span class="n">kernel</span>
+<span class="k">def</span> <span class="nf">kernel</span><span class="p">():</span>
+    <span class="n">qubits</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">qvector</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">)</span>
+    <span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+    <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="n">qubit_count</span><span class="p">):</span>
+        <span class="n">x</span><span class="o">.</span><span class="n">ctrl</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
+    <span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">)</span>
+
+
+<span class="n">result</span> <span class="o">=</span> <span class="n">cudaq</span><span class="o">.</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">)</span>
+<span class="nb">print</span><span class="p">(</span><span class="n">result</span><span class="p">)</span>  <span class="c1"># Example: { 11:500 00:500 }</span>
+</pre></div>
+</div>
+<p>Run this program as you do any other Python program, for example:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python3 program.py</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--1-input--2" name="tab-set--1" type="radio"><label class="tab-label" for="tab-set--1-input--2">C++</label><div class="tab-content docutils">
+<p>Create a file titled <code class="code docutils literal notranslate"><span class="pre">program.cpp</span></code>, containing the following code:</p>
+<div class="highlight-cpp notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;cudaq.h&gt;</span>
+
+<span class="n">__qpu__</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">kernel</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="n">cudaq</span><span class="o">::</span><span class="n">qvector</span><span class="w"> </span><span class="nf">qubits</span><span class="p">(</span><span class="n">qubit_count</span><span class="p">);</span>
+<span class="w">  </span><span class="n">h</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+<span class="w">  </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="k">auto</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="n">i</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="n">i</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="n">cx</span><span class="p">(</span><span class="n">qubits</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="w"> </span><span class="n">qubits</span><span class="p">[</span><span class="n">i</span><span class="p">]);</span>
+<span class="w">  </span><span class="p">}</span>
+<span class="w">  </span><span class="n">mz</span><span class="p">(</span><span class="n">qubits</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="kt">int</span><span class="w"> </span><span class="n">main</span><span class="p">(</span><span class="kt">int</span><span class="w"> </span><span class="n">argc</span><span class="p">,</span><span class="w"> </span><span class="kt">char</span><span class="w"> </span><span class="o">*</span><span class="n">argv</span><span class="p">[])</span><span class="w"> </span><span class="p">{</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">qubit_count</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="n">argc</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="n">atoi</span><span class="p">(</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="mi">2</span><span class="p">;</span>
+<span class="w">  </span><span class="k">auto</span><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">cudaq</span><span class="o">::</span><span class="n">sample</span><span class="p">(</span><span class="n">kernel</span><span class="p">,</span><span class="w"> </span><span class="n">qubit_count</span><span class="p">);</span>
+<span class="w">  </span><span class="n">result</span><span class="p">.</span><span class="n">dump</span><span class="p">();</span><span class="w"> </span><span class="c1">// Example: { 11:500 00:500 }</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Compile the program using the <code class="code docutils literal notranslate"><span class="pre">nvq++</span></code> compiler and run the built application with the following command:</p>
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ program.cpp -o program.x &amp;&amp; ./program.x</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>If you have an NVIDIA GPU the program uses GPU acceleration by default.
+To confirm that this works as expected and to see the effects of GPU acceleration, you can
+increase the numbers of qubits the program uses to 28 and
+compare the time to execute the program on the
+<code class="code docutils literal notranslate"><span class="pre">nvidia</span></code> target (<a class="reference internal" href="backends/simulators.html#cuquantum-single-gpu"><span class="std std-ref">GPU-accelerated statevector simulator</span></a>) to the time when setting the target to <code class="code docutils literal notranslate"><span class="pre">qpp-cpu</span></code> (<a class="reference internal" href="backends/simulators.html#openmp-cpu-only"><span class="std std-ref">OpenMP parallelized CPU-only statevector simulator</span></a>):</p>
+<div class="tab-set docutils">
+<input checked="True" class="tab-input" id="tab-set--2-input--1" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--1">Python</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">python3 program.py 28 --target nvidia</span>
+</pre></div>
+</div>
+</div>
+<input class="tab-input" id="tab-set--2-input--2" name="tab-set--2" type="radio"><label class="tab-label" for="tab-set--2-input--2">C++</label><div class="tab-content docutils">
+<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="go">nvq++ program.cpp -o program.x --target nvidia &amp;&amp; ./program.x 28</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>When you change the target to <code class="code docutils literal notranslate"><span class="pre">qpp-cpu</span></code>, the program simply seems to hang; that is because it takes a long time for the CPU-only backend to simulate 28+ qubits! Cancel the execution with <code class="code docutils literal notranslate"><span class="pre">Ctrl+C</span></code>.</p>
+<p>For more information about enabling GPU-acceleration, please see
+our complete <a class="reference internal" href="install/local_installation.html#additional-cuda-tools"><span class="std std-ref">Installation Guide</span></a>.
+For further information on available targets, see <a class="reference internal" href="backends/backends.html"><span class="doc">Backends</span></a>.</p>
+<p>You are now all set to start developing quantum applications using CUDA-Q!
+Please proceed to <a class="reference internal" href="basics/basics.html"><span class="doc">Basics</span></a> for an introduction
+to the fundamental features of CUDA-Q.</p>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="../index.html" class="btn btn-neutral float-left" title="CUDA-Q" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="basics/basics.html" class="btn btn-neutral float-right" title="CUDA-Q Basics" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/using/tutorials.html b/pr-2241/using/tutorials.html
new file mode 100644
index 0000000000..0dc179c3d9
--- /dev/null
+++ b/pr-2241/using/tutorials.html
@@ -0,0 +1,724 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+  <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>CUDA-Q Tutorials &mdash; NVIDIA CUDA-Q  documentation</title>
+      <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/tabs.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/copybutton.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/cudaq_override.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/sg_gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/nbsphinx-gallery.css" type="text/css" />
+      <link rel="stylesheet" href="../_static/_static/cudaq_override.css" type="text/css" />
+  <!--[if lt IE 9]>
+    <script src="../_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+  
+        <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script>
+        <script src="../_static/jquery.js"></script>
+        <script src="../_static/underscore.js"></script>
+        <script src="../_static/_sphinx_javascript_frameworks_compat.js"></script>
+        <script src="../_static/doctools.js"></script>
+        <script src="../_static/sphinx_highlight.js"></script>
+        <script src="../_static/tabs.js"></script>
+        <script src="../_static/clipboard.min.js"></script>
+        <script src="../_static/copybutton.js"></script>
+        <script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
+        <script src="https://cdn.jsdelivr.net/npm/@jupyter-widgets/html-manager@^1.0.1/dist/embed-amd.js"></script>
+    <script src="../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../genindex.html" />
+    <link rel="search" title="Search" href="../search.html" />
+    <link rel="next" title="Quantum Enhanced Auxiliary Field Quantum Monte Carlo" href="../examples/python/tutorials/afqmc.html" />
+    <link rel="prev" title="Using Quantum Hardware Providers" href="examples/hardware_providers.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #76b900" > 
+
+          
+          
+          <a href="../index.html" class="icon icon-home">
+            NVIDIA CUDA-Q
+          </a>
+              <div class="version">
+                amd64-pr-2241
+              </div>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+
+  <style>
+    /* Sidebar header (and topbar for mobile) */
+    .wy-side-nav-search, .wy-nav-top {
+      background: #76b900;
+    }
+
+    .wy-side-nav-search a:link, .wy-nav-top a:link {
+      color: #fff;
+    }
+    .wy-side-nav-search a:visited, .wy-nav-top a:visited {
+      color: #fff;
+    }
+    .wy-side-nav-search a:hover, .wy-nav-top a:hover {
+      color: #fff;
+    }
+
+    .wy-menu-vertical a:link, .wy-menu-vertical a:visited {
+      color: #d9d9d9
+    }
+
+    .wy-menu-vertical a:active {
+      background-color: #76b900
+    }
+
+    .wy-side-nav-search>div.version {
+      color: rgba(0, 0, 0, 0.3)
+    }
+
+    /* override table width restrictions */
+    .wy-table-responsive table td, .wy-table-responsive table th {
+        white-space: normal;
+    }
+
+    .wy-table-responsive {
+        margin-bottom: 24px;
+        max-width: 100%;
+        overflow: visible;
+    }
+  </style>
+  
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Contents</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="quick_start.html">   Quick Start</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="quick_start.html#install-cuda-q">Install CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="quick_start.html#validate-your-installation">Validate your Installation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="basics/basics.html">   Basics</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="basics/kernel_intro.html">   What is a CUDA-Q Kernel?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="basics/build_kernel.html">   Building your first CUDA-Q Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="basics/run_kernel.html">   Running your first CUDA-Q Program</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="basics/run_kernel.html#sample">Sample</a></li>
+<li class="toctree-l3"><a class="reference internal" href="basics/run_kernel.html#observe">Observe</a></li>
+<li class="toctree-l3"><a class="reference internal" href="basics/run_kernel.html#running-on-a-gpu">Running on a GPU</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="basics/troubleshooting.html">   Troubleshooting</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="basics/troubleshooting.html#debugging-and-verbose-simulation-output">Debugging and Verbose Simulation Output</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="examples/examples.html">   Examples</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="examples/introduction.html">   Introduction</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/quantum_operations.html">   Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/quantum_operations.html#quantum-states">Quantum States</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/quantum_operations.html#quantum-gates">Quantum Gates</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/quantum_operations.html#measurements">Measurements</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/visualization.html">   Visualization</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Qubit-Visualization">Qubit Visualization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/visualization.html#Kernel-Visualization">Kernel Visualization</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/expectation_values.html">   Computing Expectation Values</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/expectation_values.html#parallelizing-across-multiple-processors">Parallelizing across Multiple Processors</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/multi_control.html">   Multi-Control Synthesis</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/multi_gpu_workflows.html">   Multi-GPU Workflows</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/multi_gpu_workflows.html#available-targets">Available Targets</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/multi_gpu_workflows.html#parallelization-across-multiple-processors">Parallelization across Multiple Processors</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="examples/multi_gpu_workflows.html#batching-hamiltonian-terms">Batching Hamiltonian Terms</a></li>
+<li class="toctree-l4"><a class="reference internal" href="examples/multi_gpu_workflows.html#circuit-batching">Circuit Batching</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="examples/bernstein_vazirani.html">   Bernstein-Vazirani</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/vqe.html">   Variational Quantum Eigensolver</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/qaoa.html">   Quantum Approximate Optimization Algorithm</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/cuquantum.html">   Simulations with cuQuantum</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/noisy_simulation.html">   Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="examples/hardware_providers.html">   Using Quantum Hardware Providers</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#ionq">IonQ</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#iqm">IQM</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#oqc">OQC</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#orca-computing">ORCA Computing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="examples/hardware_providers.html#quantinuum">Quantinuum</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">   Applications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/afqmc.html">Quantum Enhanced Auxiliary Field Quantum Monte Carlo</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Hamiltonian-preparation-for-VQE">Hamiltonian preparation for VQE</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Run-VQE-with-CUDA-Q">Run VQE with CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Auxiliary-Field-Quantum-Monte-Carlo-(AFQMC)">Auxiliary Field Quantum Monte Carlo (AFQMC)</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-molecular-Hamiltonian">Preparation of the molecular Hamiltonian</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Preparation-of-the-trial-wave-function">Preparation of the trial wave function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/afqmc.html#Setup-of-the-AFQMC-parameters">Setup of the AFQMC parameters</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">Deutsch’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#XOR-\oplus">XOR <span class="math notranslate nohighlight">\(\oplus\)</span></a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-oracles">Quantum oracles</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Phase-oracle">Phase oracle</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Quantum-parallelism">Quantum parallelism</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html#Deutschs'-Algorithm:">Deutschs’ Algorithm:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">Quantum Fourier Transform</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html#Quantum-Fourier-Transform-revisited">Quantum Fourier Transform revisited</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">Cost Minimization</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe.html">Variational Quantum Eigensolver</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Using-CUDA-Q-Optimizers">Using CUDA-Q Optimizers</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe.html#Integration-with-Third-Party-Optimizers">Integration with Third-Party Optimizers</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/qaoa.html">Max-Cut with QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">Hadamard Test and Application</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Numerical-result-as-a-reference:">Numerical result as a reference:</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Using-observe-algorithmic-primitive-to-compute-the-expectation-value-for-ancilla-qubits.">Using <code class="docutils literal notranslate"><span class="pre">observe</span></code> algorithmic primitive to compute the expectation value for ancilla qubits.</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/hadamard_test.html#Use-multi-GPUs-to-compute-multiple-Hadamard-test-in-parallel">Use multi-GPUs to compute multiple Hadamard test in parallel</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html">Hybrid Quantum Neural Networks</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html">Molecular docking via DC-QAOA</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">Noisy Simulation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html">Readout Error Mitigation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-single-qubit-noise-model">Inverse confusion matrix from single-qubit noise model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-confusion-matrix-from-k-local-confusion-matrices">Inverse confusion matrix from k local confusion matrices</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html#Inverse-of-full-confusion-matrix">Inverse of full confusion matrix</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html">Water Molecule with Active Space (CPU vs. GPU)</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#A--Classical-simulation-as-a-reference:-CCSD">A- Classical simulation as a reference: CCSD</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html#B--VQE-UCCSD:">B- VQE-UCCSD:</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html">Divisive Clustering With Coresets Using CUDA-Q</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Data-preprocessing">Data preprocessing</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Quantum-functions">Quantum functions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Divisive-Clustering-Function">Divisive Clustering Function</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#QAOA-Implementation">QAOA Implementation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html#Scaling-simulations-with-CUDA-Q">Scaling simulations with CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">Multi-Reference Quantum Krylov Algorithm (H2 Example)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/Shors.html">Factoring Integers With Shor’s Algorithm</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Shor's-algorithm">Shor’s algorithm</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-classically">Solving the order-finding problem classically</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Solving-the-order-finding-problem-with-a-quantum-algorithm">Solving the order-finding problem with a quantum algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Determining-the-order-from-the-measurement-results-of-the-phase-kernel">Determining the order from the measurement results of the phase kernel</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../examples/python/tutorials/Shors.html#Postscript">Postscript</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html">Compiling Unitaries Using Diffusion Models</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Diffusion-model-pipeline">Diffusion model pipeline</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Setup-and-compilation">Setup and compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Load-model">Load model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Unitary-compilation">Unitary compilation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Convert-tensors-to-CUDA-Q">Convert tensors to CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Evaluate-generated-circuits">Evaluate generated circuits</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Simulate-kernels">Simulate kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Compare-unitaries">Compare unitaries</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html#Choosing-the-circuit-you-need">Choosing the circuit you need</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="backends/backends.html">   Backends</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="backends/simulators.html">   Simulation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/simulators.html#state-vector-simulators">State Vector Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#features">Features</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#single-gpu">Single-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#multi-node-multi-gpu">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#openmp-cpu-only">OpenMP CPU-only</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#clifford-only-simulation-cpu">Clifford-Only Simulation (CPU)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/simulators.html#tensor-network-simulators">Tensor Network Simulators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#id2">Multi-node multi-GPU</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/simulators.html#matrix-product-state">Matrix product state</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/simulators.html#default-simulator">Default Simulator</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="backends/hardware.html">   Quantum Hardware</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#ionq">IonQ</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#setting-credentials">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#submission-from-c">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#submission-from-python">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#iqm">IQM</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id1">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id2">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id3">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#oqc">OQC</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id4">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id5">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id6">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#orca-computing">ORCA Computing</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id7">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id8">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id9">Submission from Python</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/hardware.html#quantinuum">Quantinuum</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#quantinuum-backend">Setting Credentials</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id11">Submission from C++</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/hardware.html#id12">Submission from Python</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="backends/nvqc.html">   NVIDIA Quantum Cloud</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#quick-start">Quick Start</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#simulator-backend-selection">Simulator Backend Selection</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#multiple-gpus">Multiple GPUs</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#multiple-qpus-asynchronous-execution">Multiple QPUs Asynchronous Execution</a></li>
+<li class="toctree-l3"><a class="reference internal" href="backends/nvqc.html#faq">FAQ</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="backends/platform.html">   Multi-Processor Platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="backends/platform.html#nvidia-mqpu-platform">NVIDIA <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/platform.html#parallel-distribution-mode">Parallel distribution mode</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="backends/platform.html#remote-mqpu-platform">Remote <code class="code docutils literal notranslate"><span class="pre">MQPU</span></code> Platform</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="backends/platform.html#supported-kernel-arguments">Supported Kernel Arguments</a></li>
+<li class="toctree-l4"><a class="reference internal" href="backends/platform.html#accessing-simulated-quantum-state">Accessing Simulated Quantum State</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="install/install.html">   Installation</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="install/local_installation.html">Local Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#introduction">Introduction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#docker">Docker</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#singularity">Singularity</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#python-wheels">Python wheels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#pre-built-binaries">Pre-built binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#development-with-vs-code">Development with VS Code</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#using-a-docker-container">Using a Docker container</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#using-a-singularity-container">Using a Singularity container</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#connecting-to-a-remote-host">Connecting to a Remote Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#developing-with-remote-tunnels">Developing with Remote Tunnels</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#remote-access-via-ssh">Remote Access via SSH</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#dgx-cloud">DGX Cloud</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#get-started">Get Started</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#use-jupyterlab">Use JupyterLab</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#use-vs-code">Use VS Code</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#additional-cuda-tools">Additional CUDA Tools</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#installation-via-pypi">Installation via PyPI</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#installation-in-container-images">Installation In Container Images</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/local_installation.html#installing-pre-built-binaries">Installing Pre-built Binaries</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#distributed-computing-with-mpi">Distributed Computing with MPI</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#updating-cuda-q">Updating CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#dependencies-and-compatibility">Dependencies and Compatibility</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/local_installation.html#next-steps">Next Steps</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="install/data_center_install.html">Data Center Installation</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#prerequisites">Prerequisites</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#build-dependencies">Build Dependencies</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#cuda">CUDA</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#toolchain">Toolchain</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#building-cuda-q">Building CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#python-support">Python Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#c-support">C++ Support</a></li>
+<li class="toctree-l3"><a class="reference internal" href="install/data_center_install.html#installation-on-the-host">Installation on the Host</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#cuda-runtime-libraries">CUDA Runtime Libraries</a></li>
+<li class="toctree-l4"><a class="reference internal" href="install/data_center_install.html#mpi">MPI</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="integration/integration.html">   Integration</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="integration/cmake_app.html">Downstream CMake Integration</a></li>
+<li class="toctree-l2"><a class="reference internal" href="integration/cuda_gpu.html">Combining CUDA with CUDA-Q</a></li>
+<li class="toctree-l2"><a class="reference internal" href="integration/libraries.html">Integrating with Third-Party Libraries</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="integration/libraries.html#calling-a-cuda-q-library-from-c">Calling a CUDA-Q library from C++</a></li>
+<li class="toctree-l3"><a class="reference internal" href="integration/libraries.html#calling-an-c-library-from-cuda-q">Calling an C++ library from CUDA-Q</a></li>
+<li class="toctree-l3"><a class="reference internal" href="integration/libraries.html#interfacing-between-binaries-compiled-with-a-different-toolchains">Interfacing between binaries compiled with a different toolchains</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="extending/extending.html">   Extending</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="extending/nvqir_simulator.html">Create a new NVQIR Simulator</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="extending/nvqir_simulator.html#circuitsimulator"><code class="code docutils literal notranslate"><span class="pre">CircuitSimulator</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="extending/nvqir_simulator.html#let-s-see-this-in-action">Let’s see this in action</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="extending/cudaq_ir.html">Working with CUDA-Q IR</a></li>
+<li class="toctree-l2"><a class="reference internal" href="extending/mlir_pass.html">Create an MLIR Pass for CUDA-Q</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../specification/index.html">   Specifications</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../specification/cudaq.html">   Language Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/machine_model.html">1. Machine Model</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/namespace.html">2. Namespace and Standard</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/types.html">3. Quantum Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qudit-levels">3.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::qudit&lt;Levels&gt;</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#cudaq-qubit">3.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/types.html#quantum-containers">3.3. Quantum Containers</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operators.html">4. Quantum Operators</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operators.html#cudaq-spin-op">4.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::spin_op</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/operations.html">5. Quantum Operations</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/operations.html#operations-on-cudaq-qubit">5.1. Operations on <code class="code docutils literal notranslate"><span class="pre">cudaq::qubit</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/kernels.html">6. Quantum Kernels</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/synthesis.html">7. Sub-circuit Synthesis</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/control_flow.html">8. Control Flow</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/dynamic_kernels.html">9. Just-in-Time Kernel Creation</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/patterns.html">10. Quantum Patterns</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/patterns.html#compute-action-uncompute">10.1. Compute-Action-Uncompute</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/platform.html">11. Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html">12. Algorithmic Primitives</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-sample">12.1. <code class="code docutils literal notranslate"><span class="pre">cudaq::sample</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-observe">12.2. <code class="code docutils literal notranslate"><span class="pre">cudaq::observe</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-optimizer-deprecated-functionality-moved-to-cuda-q-libraries">12.3. <code class="code docutils literal notranslate"><span class="pre">cudaq::optimizer</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/algorithmic_primitives.html#cudaq-gradient-deprecated-functionality-moved-to-cuda-q-libraries">12.4. <code class="code docutils literal notranslate"><span class="pre">cudaq::gradient</span></code> (deprecated, functionality moved to CUDA-Q libraries)</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/cudaq/examples.html">13. Example Programs</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#hello-world-simple-bell-state">13.1. Hello World - Simple Bell State</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#ghz-state-preparation-and-sampling">13.2. GHZ State Preparation and Sampling</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#quantum-phase-estimation">13.3. Quantum Phase Estimation</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#deuteron-binding-energy-parameter-sweep">13.4. Deuteron Binding Energy Parameter Sweep</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#grover-s-algorithm">13.5. Grover’s Algorithm</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../specification/cudaq/examples.html#iterative-phase-estimation">13.6. Iterative Phase Estimation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../specification/quake-dialect.html">   Quake Specification</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#general-introduction">General Introduction</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../specification/quake-dialect.html#motivation">Motivation</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../api/api.html">   API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/cpp_api.html">C++ API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#operators">Operators</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#quantum">Quantum</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#common">Common</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#noise-modeling">Noise Modeling</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#kernel-builder">Kernel Builder</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#algorithms">Algorithms</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#platform">Platform</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#utilities">Utilities</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/cpp_api.html#namespaces">Namespaces</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/languages/python_api.html">Python API</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#program-construction">Program Construction</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.make_kernel"><code class="docutils literal notranslate"><span class="pre">make_kernel()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernel"><code class="docutils literal notranslate"><span class="pre">PyKernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Kernel"><code class="docutils literal notranslate"><span class="pre">Kernel</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.PyKernelDecorator"><code class="docutils literal notranslate"><span class="pre">PyKernelDecorator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.kernel"><code class="docutils literal notranslate"><span class="pre">kernel()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#kernel-execution">Kernel Execution</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.sample_async"><code class="docutils literal notranslate"><span class="pre">sample_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe"><code class="docutils literal notranslate"><span class="pre">observe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.observe_async"><code class="docutils literal notranslate"><span class="pre">observe_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state"><code class="docutils literal notranslate"><span class="pre">get_state()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_state_async"><code class="docutils literal notranslate"><span class="pre">get_state_async()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.vqe"><code class="docutils literal notranslate"><span class="pre">vqe()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.draw"><code class="docutils literal notranslate"><span class="pre">draw()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.translate"><code class="docutils literal notranslate"><span class="pre">translate()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#backend-configuration">Backend Configuration</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.has_target"><code class="docutils literal notranslate"><span class="pre">has_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_target"><code class="docutils literal notranslate"><span class="pre">get_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.get_targets"><code class="docutils literal notranslate"><span class="pre">get_targets()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_target"><code class="docutils literal notranslate"><span class="pre">set_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.reset_target"><code class="docutils literal notranslate"><span class="pre">reset_target()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_noise"><code class="docutils literal notranslate"><span class="pre">set_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.unset_noise"><code class="docutils literal notranslate"><span class="pre">unset_noise()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.initialize_cudaq"><code class="docutils literal notranslate"><span class="pre">initialize_cudaq()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.num_available_gpus"><code class="docutils literal notranslate"><span class="pre">num_available_gpus()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.set_random_seed"><code class="docutils literal notranslate"><span class="pre">set_random_seed()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#data-types">Data Types</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SimulationPrecision"><code class="docutils literal notranslate"><span class="pre">SimulationPrecision</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Target"><code class="docutils literal notranslate"><span class="pre">Target</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.State"><code class="docutils literal notranslate"><span class="pre">State</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.Tensor"><code class="docutils literal notranslate"><span class="pre">Tensor</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.QuakeValue"><code class="docutils literal notranslate"><span class="pre">QuakeValue</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qubit"><code class="docutils literal notranslate"><span class="pre">qubit</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qreg"><code class="docutils literal notranslate"><span class="pre">qreg</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.qvector"><code class="docutils literal notranslate"><span class="pre">qvector</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ComplexMatrix"><code class="docutils literal notranslate"><span class="pre">ComplexMatrix</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SpinOperator"><code class="docutils literal notranslate"><span class="pre">SpinOperator</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.i"><code class="docutils literal notranslate"><span class="pre">spin.i()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.x"><code class="docutils literal notranslate"><span class="pre">spin.x()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.y"><code class="docutils literal notranslate"><span class="pre">spin.y()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.spin.z"><code class="docutils literal notranslate"><span class="pre">spin.z()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.SampleResult"><code class="docutils literal notranslate"><span class="pre">SampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncSampleResult"><code class="docutils literal notranslate"><span class="pre">AsyncSampleResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.ObserveResult"><code class="docutils literal notranslate"><span class="pre">ObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncObserveResult"><code class="docutils literal notranslate"><span class="pre">AsyncObserveResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.AsyncStateResult"><code class="docutils literal notranslate"><span class="pre">AsyncStateResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.OptimizationResult"><code class="docutils literal notranslate"><span class="pre">OptimizationResult</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#optimizers">Optimizers</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#gradients">Gradients</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#noisy-simulation">Noisy Simulation</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#mpi-submodule">MPI Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.initialize"><code class="docutils literal notranslate"><span class="pre">initialize()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.rank"><code class="docutils literal notranslate"><span class="pre">rank()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.num_ranks"><code class="docutils literal notranslate"><span class="pre">num_ranks()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.all_gather"><code class="docutils literal notranslate"><span class="pre">all_gather()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.broadcast"><code class="docutils literal notranslate"><span class="pre">broadcast()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.mpi.finalize"><code class="docutils literal notranslate"><span class="pre">finalize()</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/languages/python_api.html#orca-submodule">ORCA Submodule</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/languages/python_api.html#cudaq.orca.sample"><code class="docutils literal notranslate"><span class="pre">sample()</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../api/default_ops.html">Quantum Operations</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#unitary-operations-on-qubits">Unitary Operations on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#x"><code class="code docutils literal notranslate"><span class="pre">x</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#y"><code class="code docutils literal notranslate"><span class="pre">y</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#z"><code class="code docutils literal notranslate"><span class="pre">z</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#h"><code class="code docutils literal notranslate"><span class="pre">h</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#r1"><code class="code docutils literal notranslate"><span class="pre">r1</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rx"><code class="code docutils literal notranslate"><span class="pre">rx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#ry"><code class="code docutils literal notranslate"><span class="pre">ry</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#rz"><code class="code docutils literal notranslate"><span class="pre">rz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#s"><code class="code docutils literal notranslate"><span class="pre">s</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#t"><code class="code docutils literal notranslate"><span class="pre">t</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#swap"><code class="code docutils literal notranslate"><span class="pre">swap</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#u3"><code class="code docutils literal notranslate"><span class="pre">u3</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#adjoint-and-controlled-operations">Adjoint and Controlled Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#measurements-on-qubits">Measurements on Qubits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mz"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#mx"><code class="code docutils literal notranslate"><span class="pre">mx</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#my"><code class="code docutils literal notranslate"><span class="pre">my</span></code></a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#user-defined-custom-operations">User-Defined Custom Operations</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../api/default_ops.html#photonic-operations-on-qudits">Photonic Operations on Qudits</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#plus"><code class="code docutils literal notranslate"><span class="pre">plus</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#phase-shift"><code class="code docutils literal notranslate"><span class="pre">phase_shift</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#beam-splitter"><code class="code docutils literal notranslate"><span class="pre">beam_splitter</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="../api/default_ops.html#id1"><code class="code docutils literal notranslate"><span class="pre">mz</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../versions.html">   Other Versions</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #76b900" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../index.html">NVIDIA CUDA-Q</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">CUDA-Q Tutorials</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="../_sources/using/tutorials.rst.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
+        <a href="examples/hardware_providers.html" class="btn btn-neutral float-left" title="Using Quantum Hardware Providers" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../examples/python/tutorials/afqmc.html" class="btn btn-neutral float-right" title="Quantum Enhanced Auxiliary Field Quantum Monte Carlo" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+  </div>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+             
+  <section id="cuda-q-tutorials">
+<h1>CUDA-Q Tutorials<a class="headerlink" href="#cuda-q-tutorials" title="Permalink to this heading">¶</a></h1>
+<p>Tutorials that give an in depth view of CUDA-Q and its applications in Python.</p>
+<div class="toctree-wrapper compound">
+<div class="nbsphinx-gallery">
+<a class="reference internal" href="../examples/python/tutorials/afqmc.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Quantum Enhanced Auxiliary Field Quantum Monte Carlo</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/deutschs_algorithm.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Deutsch’s Algorithm</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/quantum_fourier_transform.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Quantum Fourier Transform</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/cost_minimization.html">
+  <div><img alt="" src="../_images/examples_python_tutorials_cost_minimization_9_1.png"></div>
+  <div>Cost Minimization</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/vqe.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Variational Quantum Eigensolver</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/qaoa.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Max-Cut with QAOA</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/hadamard_test.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Hadamard Test and Application</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/hybrid_qnns.html"None>
+  <div><img alt="" src="../_images/hybrid.png"></div>
+  <div>Hybrid Quantum Neural Networks</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/maximum_vertex_weight_clique.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Molecular docking via DC-QAOA</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/noisy_simulations.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Noisy Simulation</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/readout_error_mitigation.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Readout Error Mitigation</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/vqe_water_active_space.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Water Molecule with Active Space (CPU vs. GPU)</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/Divisive_clustering.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Divisive Clustering With Coresets Using CUDA-Q</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/H2-MRQKS.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Multi-Reference Quantum Krylov Algorithm (H2 Example)</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/Shors.html">
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Factoring Integers With Shor’s Algorithm</div>
+</a>
+<a class="reference internal" href="../examples/python/tutorials/unitary_compilation.html"None>
+  <div><img alt="" src="../_static/cuda_quantum_icon.svg"></div>
+  <div>Compiling Unitaries Using Diffusion Models</div>
+</a>
+</div>
+</div>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="examples/hardware_providers.html" class="btn btn-neutral float-left" title="Using Quantum Hardware Providers" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="../examples/python/tutorials/afqmc.html" class="btn btn-neutral float-right" title="Quantum Enhanced Auxiliary Field Quantum Monte Carlo" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, NVIDIA Corporation &amp; Affiliates.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+   
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(false);
+      });
+  </script>  
+
+  <style>
+  a:link, a:visited {
+    color: #76b900;
+  }
+
+  a:hover {
+    color: #8c0;
+  }
+
+  .rst-content dl:not(.docutils) dt {
+    background: rgba(118, 185, 0, 0.1);
+    color: rgba(59,93,0,1);
+    border-top: solid 3px rgba(59,93,0,1);
+  }
+  </style>
+  
+
+</body>
+</html>
\ No newline at end of file
diff --git a/pr-2241/versions.html b/pr-2241/versions.html
new file mode 100644
index 0000000000..a0856505a1
--- /dev/null
+++ b/pr-2241/versions.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="refresh" content="0; url=../latest/releases.html"></head></html>
\ No newline at end of file